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

Artículo
08/26/2023

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)