Compartir a través de

Método IUIAutomationTextPattern::GetVisibleRanges (uiautomationclient.h)

  • Artículo

Recupera una matriz de intervalos de texto separados de un control basado en texto donde cada intervalo de texto representa un intervalo contiguo de texto visible.

Sintaxis

HRESULT GetVisibleRanges(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

Parámetros

[out, retval] ranges

Tipo: IUIAutomationTextRangeArray**

Recibe un puntero a la colección de intervalos de texto visibles dentro del control basado en texto.

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

Si el texto visible consta de un intervalo contiguo de texto, la matriz de intervalos contendrá un único intervalo de texto que representa todo el texto visible.

Si el texto visible consta de varios intervalos de texto separados, la matriz de intervalos contendrá un intervalo de texto para cada intervalo visible, empezando por el primer intervalo visible y finalizando con el último intervalo visible. Los intervalos separados de texto visible pueden producirse cuando el contenido de un control basado en texto está parcialmente oculto por una ventana superpuesta u otro objeto, o cuando un control basado en texto con varias páginas o columnas tiene contenido que se desplaza parcialmente fuera de la vista.

IUIAutomationTextPattern::GetVisibleRanges recupera un intervalo de texto degenerado (vacío) si no hay texto visible, si todo el texto se desplaza fuera de la vista o si el control basado en texto no contiene texto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationTextPattern

compatibilidad de Automatización de la interfaz de usuario con contenido textual