Compartilhar via


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

Recupera o texto sem formatação do intervalo.

Sintaxe

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

Parâmetros

[in] maxLength

Tipo: int

O tamanho máximo da cadeia de caracteres a ser retornada. Use -1 se não for necessário nenhum limite.

[out, retval] pRetVal

Tipo: BSTR*

Recebe o texto sem formatação do intervalo de texto, possivelmente truncado no comprimento máximo especificado. Este parâmetro é passado não inicializado.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

ITextRangeProvider::GetText recupera texto oculto e visível.

Se maxLength for maior que o comprimento do intervalo de texto do chamador, a cadeia de caracteres retornada será o texto sem formatação do intervalo de texto.

ITextRangeProvider::GetText não será afetado pela ordem dos pontos de extremidade no fluxo de texto; ele sempre retornará o texto entre os pontos de extremidade inicial e final do intervalo de texto na ordem de fluxo de texto lógico.

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (include UIAutomation.h)

Confira também

Conceitual

ITextProvider

ITextRangeProvider

Referência

Visão Geral dos Provedores de Automação de Interface do Usuário