Método IUIAutomation3::AddTextEditTextChangedEventHandler (uiautomationclient.h)

Artículo
03/13/2024

Registra un método que controla los eventos de edición de texto mediante programación.

Nota Antes de implementar un controlador de eventos, debe estar familiarizado con los problemas de subprocesos descritos en Descripción de los problemas de subprocesos.

Sintaxis

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

Parámetros

[in] element

Tipo: IUIAutomationElement*

Puntero al elemento Automatización de la interfaz de usuario asociado al controlador de eventos.

[in] scope

Tipo: TreeScope

Ámbito de eventos que se va a controlar; es decir, si se va a controlar el propio elemento o sus antecesores y descendientes.

[in] textEditChangeType

Tipo: TextEditChangeType

Tipo de cambio específico que se va a escuchar. Los clientes se registran para cada tipo de cambio de edición de texto por separado, de modo que el sistema Automatización de la interfaz de usuario pueda comprobar los agentes de escucha registrados en tiempo de ejecución y evitar generar eventos para determinados cambios de edición de texto cuando no haya agentes de escucha.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntero a una solicitud de caché o NULL si no se desea almacenar en caché.

[in] handler

Tipo: IUIAutomationTextEditTextChangedEventHandler*

Puntero al objeto que controla el evento de edición de texto mediante programación.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Un cliente Automatización de la interfaz de usuario no debe usar varios subprocesos para agregar o quitar controladores de eventos. El comportamiento inesperado puede dar lugar si se agrega o quita un controlador de eventos mientras se agrega o quita otro en el mismo proceso de cliente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationclient.h (include UIAutomation.h)