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

Artigo
08/26/2023

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)