Método IUIAutomation6::RemoveActiveTextPositionChangedEventHandler (uiautomationclient.h)

Quita un controlador de eventos cambiado de posición de texto activo.

Importante

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

Sintaxis

HRESULT RemoveActiveTextPositionChangedEventHandler(
  [in] IUIAutomationElement                               *element,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Parámetros

[in] element

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

[in] handler

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

Valor devuelto

Este método no devuelve ningún valor.

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 de texto activa se indica mediante un evento de navegación dentro o entre elementos de texto de solo lectura (como exploradores web, documentos de formato de documento portátil (PDF) 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 divergen 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 del siguiente elemento 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 Automatización de la interfaz de usuario clientes 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.

Es posible que un evento se entregue a un controlador de eventos después de cancelar la suscripción del controlador, si el evento se recibe simultáneamente con la solicitud de cancelar la suscripción del evento. El procedimiento recomendado es seguir el estándar Modelo de objetos componentes (COM) y evitar destruir el objeto del controlador de eventos hasta que su recuento de referencias haya alcanzado cero. La destrucción de un controlador de eventos inmediatamente después de cancelar la suscripción de eventos puede provocar una infracción de acceso si un evento se entrega en tiempo de espera.

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

IUIAutomation6::AddActiveTextPositionChangedEventHandler, interfaz IUIAutomation6