Compartir a través de

Función UiaRaiseTextEditTextChangedEvent (uiautomationcoreapi.h)

  • Artículo

Llamado por un proveedor para notificar al núcleo de Microsoft Automatización de la interfaz de usuario que un control de texto ha cambiado mediante programación texto.

Sintaxis

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

Parámetros

[in] pProvider

Tipo: IRawElementProviderSimple*

Nodo de proveedor donde se produjo el cambio de texto.

[in] textEditChangeType

Tipo: TextEditChangeType

Tipo de cambio de edición de texto que se produjo.

[in] pChangedData

Tipo: SAFEARRAY*

Datos del evento. Debe ser asignable como var de tipo VT_BSTR.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se trata de una función auxiliar para proveedores que implementan ITextEditProvider y están generando los eventos necesarios del patrón. Siga las instrucciones que se indican en TextEdit Control Pattern (Patrón de control TextEdit) que describe cuándo generar los eventos y qué carga deben pasar los eventos a Automatización de la interfaz de usuario.

Si no hay clientes que escuchan un tipo de cambio determinado, no se genera ningún evento.

Los datos del evento deben contener cargas diferentes para cada tipo de cambio (por TextEditChangeType):

  • TextEditChangeType_AutoCorrect: pChangedData debe ser la nueva cadena corregida.
  • TextEditChangeType_Composition: pChangedData debe ser la cadena actualizada en la composición (solo la parte que cambió).
  • TextEditChangeType_CompositionFinalized: pChangedData debe ser la cadena finalizada de la composición completada (esto puede estar vacío si se canceló o eliminó la composición).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado uiautomationcoreapi.h
Library Uiautomationcore.lib
Archivo DLL Uiautomationcore.dll

Consulte también

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

Patrón de control TextEdit