CoreTextEditContext Класс

Определение

Пространство имен:

Windows.UI.Text.Core

Основной объект, используемый элементами управления текстовым вводом для взаимодействия с сервером ввода текста.

public ref class CoreTextEditContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContext

Public NotInheritable Class CoreTextEditContext

Наследование

Object Platform::Object IInspectable CoreTextEditContext

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Чтобы получить объект этого типа, вызовите CoreTextServicesManager.CreateEditContext.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1511	10586	NotifyFocusLeaveCompleted

Свойства

InputPaneDisplayPolicy	Возвращает или задает значение, указывающее, должна ли область ввода отображаться автоматически при попадании фокуса в элемент управления текстовым вводом. Значение по умолчанию — Автоматически, указывающее, что область ввода будет отображаться автоматически. Значение Manual указывает, что ваше приложение будет отвечать за отображение и скрытие области ввода с помощью InputPane.TryShow и TryHide.
InputScope	Возвращает или задает значение, указывающее входной область элемента управления текстовым вводом.
IsReadOnly	Возвращает или задает значение, указывающее, является ли элемент управления редактированием редактируемым.
Name	Возвращает или задает описательное имя элемента управления текстовым вводом. Платформа приложений обычно использует такие свойства, как "name" или "id" для идентификации элемента управления, поэтому рекомендуется задать это свойство соответствующим образом на сервере текстового ввода, чтобы обработчики ввода могли лучше сохранять контекст ввода и предоставлять лучшие предложения.

Методы

NotifyFocusEnter()	Уведомляет сервер ввода текста о том, что фокус вошел в элемент управления текстовым вводом.
NotifyFocusLeave()	Уведомляет сервер ввода текста о том, что фокус покинул элемент управления текстовым вводом.
NotifyLayoutChanged()	Уведомляет сервер ввода текста о том, что макет текста внутри элемента управления вводом текста изменился.
NotifySelectionChanged(CoreTextRange)	Уведомляет сервер текстового ввода о любых изменениях, которые элемент управления вводом текста должен внести в диапазон выделения. Это важно для синхронизации внутреннего состояния элемента управления и внутреннего состояния сервера.
NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)	Уведомляет сервер ввода текста о любых изменениях, которые элемент управления вводом текста должен внести в текст. Это важно для синхронизации внутреннего состояния элемента управления и внутреннего состояния сервера. Так как изменение текста также может повлиять на диапазон выделения, метод принимает диапазон выделения в качестве параметра.

События

CompositionCompleted	Происходит после завершения композиции.
CompositionStarted	Происходит при запуске композиции.
FocusRemoved	Происходит при принудительном удалении фокуса из элемента управления вводом текста. Приложение должно обработать это событие, чтобы соответствующим образом удалить фокус для элемента управления вводом текста.
FormatUpdating	Происходит, когда серверу ввода текста необходимо применить другой формат к определенному диапазону текста. Обычно это происходит во время композиции.
LayoutRequested	Происходит, когда серверу ввода текста необходимо получить ограничивающий прямоугольник диапазона текста и самого элемента управления текстовым вводом. Приложение должно обработать это событие и вернуть запрошенные геометрические сведения.
NotifyFocusLeaveCompleted	Происходит после того, как фокус покинул элемент управления вводом текста.
SelectionRequested	Происходит, когда серверу ввода текста требуется получить диапазон текста, представляющий текущий выделенный текст в элементе управления текстовым вводом. Приложение должно обработать это событие и вернуть запрошенный диапазон.
SelectionUpdating	Происходит, когда серверу ввода текста необходимо изменить диапазон текста, выделенный в элементе управления вводом текста. Это событие может быть результатом того, что обработчику ввода требуется выделить текст или переместить курсор. Элемент управления текстовым вводом должен соответствующим образом задать диапазон выделения.
TextRequested	Происходит, когда серверу ввода текста требуется получить диапазон текста из элемента управления текстовым вводом. Приложение должно обработать это событие и вернуть запрошенный диапазон.
TextUpdating	Происходит, когда серверу ввода текста необходимо изменить текст внутри элемента управления вводом текста. Это событие может быть результатом ключевого события, например вставки одного символа, или результатом обработки, выполненной обработчиком ввода, например автоматической коррекции и прогнозирования. При обработке события элемент управления вводом текста должен заменить диапазон новым текстом, предоставленным сервером, а также переместить курсор в конец нового текста.

См. также раздел

• Пример пользовательского элемента управления для редактирования