Compartilhar via


função TextRange_GetText (uiautomationcoreapi.h)

Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Component Object Model) do Microsoft Automação da Interface do Usuário.
 
Retorna o texto em um intervalo de texto, até um número especificado de caracteres.

Sintaxe

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

Parâmetros

[in] hobj

Tipo: HUIATEXTRANGE

Um objeto de intervalo de texto.

[in] maxLength

Tipo: int

O número de caracteres a serem retornados, começando com o caractere no ponto de extremidade inicial do intervalo de texto.

[out] pRetVal

Tipo: BSTR*

Quando essa função retorna, esse parâmetro contém um ponteiro para o texto retornado. Este parâmetro é passado não inicializado.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro caso contrário.

Comentários

Se maxLength for -1, todo o texto dentro do intervalo de texto será retornado. Se maxLength for maior que o comprimento do intervalo de texto, a cadeia de caracteres retornada conterá todo o texto no intervalo de texto.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationcoreapi.h
Biblioteca Uiautomationcore.lib
DLL Uiautomationcore.dll