Método ITextRangeProvider::GetText (uiautomationcore.h)

Artículo
08/26/2023

Recupera el texto sin formato del intervalo.

Sintaxis

HRESULT GetText(
  [in]          int  maxLength,
  [out, retval] BSTR *pRetVal
);

Parámetros

[in] maxLength

Tipo: int

Longitud máxima de la cadena que se debe devolver. Use -1 si no se requiere ningún límite.

[out, retval] pRetVal

Tipo: BSTR*

Recibe el texto sin formato del intervalo de texto, posiblemente truncado con la longitud máxima especificada. 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

ITextRangeProvider::GetText recupera texto oculto y visible.

Si maxLength es mayor que la longitud del intervalo de texto del autor de la llamada, la cadena devuelta será el texto sin formato del intervalo de texto.

ITextRangeProvider::GetText no se verá afectado por el orden de los puntos de conexión en el flujo de texto; siempre devolverá el texto entre los puntos de conexión inicial y final del intervalo de texto en el orden de flujo de texto lógico.

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)