Compartir a través de


Método ITextProvider::GetSelection (uiautomationcore.h)

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] SAFEARRAY **pRetVal
);

Parámetros

[out, retval] pRetVal

Tipo: SAFEARRAY**

Recibe la dirección de una matriz de punteros a las interfaces ITextRangeProvider de los intervalos de texto, uno para cada intervalo de texto seleccionado. Este parámetro se pasa sin inicializar.

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

Para los proveedores de automatización de la interfaz de usuario que admiten la selección de texto, el proveedor debe implementar este método y también devolver un valor ITextProvider::SupportedTextSelection .

Si el control contiene solo un intervalo de texto seleccionado, la matriz pRetVal debe contener un único intervalo de texto.

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

Si el control no contiene texto seleccionado o si el control no contiene un punto de inserción de texto, establezca pRetVal en NULL.

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado uiautomationcore.h (incluir UIAutomation.h)

Consulte también

Procedimientos recomendados para usar matrices seguras

Conceptual

ITextProvider

ITextRangeProvider

Referencia

Información general sobre proveedores de UI Automation