Compartir a través de

Método IUIAutomationEventHandlerGroup::AddActiveTextPositionChangedEventHandler (uiautomationclient.h)

  • Artículo

Registra un método (en un grupo de controladores de eventos) que controla cuando cambia la posición del texto activo.

Importante Los clientes de Microsoft Automatización de la interfaz de usuario deben usar los métodos de grupo de controladores para registrar agentes de escucha de eventos en lugar de métodos de registro de eventos individuales definidos en los distintos espacios de nombres IUIAutomation.

 

Sintaxis

HRESULT AddActiveTextPositionChangedEventHandler(
  [in] TreeScope                                          scope,
  [in] IUIAutomationCacheRequest                          *cacheRequest,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Parámetros

[in] scope

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

[in] cacheRequest

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

[in] handler

Puntero al objeto que controla el evento de cambio de posición de texto activo.

Valor devuelto

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

Comentarios

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

La posición del texto activo se indica mediante un evento de navegación dentro o entre elementos de texto de solo lectura (como exploradores web, documentos pdf) portables o documentos EPUB ) mediante marcadores (o identificadores de fragmentos para hacer referencia a una ubicación dentro de un recurso). Algunos ejemplos son:

  • Navegar a un marcador dentro de la misma página web
  • Navegar a un marcador en una página web diferente
  • Activación de un vínculo a una ubicación diferente dentro del mismo PDF
  • Activación de un vínculo a una ubicación diferente dentro de la misma EPUB
Use este controlador de eventos para sincronizar la ubicación visual del marcador o destino con la ubicación de foco en un elemento de texto de solo lectura, que puede diverge al usar marcadores o identificadores de fragmento.

Por ejemplo, cuando se invoca un mismo delimitador de página (<a href=”#C4”>Jump to Chapter 4</a> ... <h1><a name="C4">Chapter 4</a></h1>), se actualiza la ubicación visual, pero el Automatización de la interfaz de usuario cliente permanece en la ubicación original. Esto da como resultado acciones como la lectura de texto o mover los comandos de elemento siguiente a partir de la ubicación original, no la nueva ubicación.

Del mismo modo, la activación de un nuevo URI de página (con un identificador de fragmento: (<a href=”www.blah.com#C4”>Jump to Chapter 4</a>)) carga la nueva página y salta al marcador especificado, pero deja los clientes Automatización de la interfaz de usuario en la parte superior de la página.

Para los elementos de texto editables, como los controles Editar y Edición enriquecida , puede escuchar un evento SelectionChanged.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1809 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server, versión 1709 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationEventHandlerGroup