Функция UiaRaiseTextEditTextChangedEvent (uiautomationcoreapi.h)

Вызывается поставщиком для уведомления ядра Microsoft модель автоматизации пользовательского интерфейса о том, что текстовый элемент управления изменил текст программным способом.

Синтаксис

HRESULT UiaRaiseTextEditTextChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] TextEditChangeType        textEditChangeType,
  [in] SAFEARRAY                 *pChangedData
);

Параметры

[in] pProvider

Тип: IRawElementProviderSimple*

Узел поставщика, в котором произошло изменение текста.

[in] textEditChangeType

Тип: TextEditChangeType

Тип изменения текста, которое произошло.

[in] pChangedData

Тип: SAFEARRAY*

Данные события. Должен быть назначен как VAR типа VT_BSTR.

Возвращаемое значение

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Это вспомогающая функция для поставщиков, которые реализуют ITextEditProvider и создают необходимые события шаблона. Следуйте указаниям, приведенным в статье Шаблон элемента управления TextEdit, в котором описывается, когда следует вызывать события и какие полезные данные события должны передавать в модель автоматизации пользовательского интерфейса.

Если клиенты не прослушивают определенный тип изменений, событие не создается.

Данные события должны содержать различные полезные данные для каждого типа изменения (для TextEditChangeType):

• TextEditChangeType_AutoCorrect: pChangedData должна быть новой исправленной строкой .
• TextEditChangeType_Composition: pChangedData должна быть обновленной строкой в композиции (только измененной частью).
• TextEditChangeType_CompositionFinalized: pChangedData должна быть завершенной строкой завершенной композиции (она может быть пустой, если композиция была отменена или удалена).

Требования

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

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

Шаблон элемента управления TextEdit