Share via


función TextRange_GetText (uiautomationcoreapi.h)

Nota Esta función está en desuso. En su lugar, las aplicaciones cliente deben usar las interfaces del Modelo de objetos componentes (COM) de Microsoft Automatización de la interfaz de usuario.
 
Devuelve el texto de un intervalo de texto, hasta un número especificado de caracteres.

Sintaxis

HRESULT TextRange_GetText(
  [in]  HUIATEXTRANGE hobj,
  [in]  int           maxLength,
  [out] BSTR          *pRetVal
);

Parámetros

[in] hobj

Tipo: HUIATEXTRANGE

Objeto de intervalo de texto.

[in] maxLength

Tipo: int

Número de caracteres que se van a devolver, empezando por el carácter en el punto de conexión inicial del intervalo de texto.

[out] pRetVal

Tipo: BSTR*

Cuando esta función vuelve, este parámetro contiene un puntero al texto devuelto. Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o si un valor de error de lo contrario.

Comentarios

Si maxLength es -1, se devuelve todo el texto dentro del intervalo de texto. Si maxLength es mayor que la longitud del intervalo de texto, la cadena devuelta contiene todo el texto del intervalo de texto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationcoreapi.h
Library Uiautomationcore.lib
Archivo DLL Uiautomationcore.dll