Compartir a través de

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

  • Artículo

Recupera una colección de intervalos de texto que representa el texto seleccionado actualmente en un control basado en texto.

Sintaxis

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

Parámetros

[out, retval] ranges

Tipo: IUIAutomationTextRangeArray**

Recibe un puntero a la colección de intervalos de 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 control admite la selección de varios intervalos de texto no contiguos, la colección ranges recibe un intervalo de texto para cada intervalo seleccionado.

Si el control contiene solo un intervalo de texto seleccionado, la colección ranges recibe un único intervalo de texto.

Si el control contiene un punto de inserción de texto pero no se selecciona texto, la colección ranges recibe un intervalo de texto degenerado (vacío) en la posición del punto de inserción de texto.

Si el control no contiene un punto de inserción de texto o no admite la selección de texto, los intervalos se establecen en NULL.

Use la propiedad IUIAutomationTextPattern::SupportedTextSelection para comprobar si un control admite la selección de 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