Método ITextServices::TxGetText (textserv.h)

Artigo
08/26/2023

Retorna todo o texto sem formatação Unicode no controle como um BSTR.

Sintaxe

HRESULT TxGetText(
  BSTR *pbstrText
);

Parâmetros

pbstrText

Tipo: BSTR *

O texto sem formatação Unicode.

Valor retornado

Tipo: HRESULT

Se o texto for retornado com êxito no argumento de saída, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos HRESULT . Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_INVALIDARG	Ponteiro BSTR inválido passado.
E_OUTOFMEMORY	Não foi possível alocar memória para cópia do texto.

Comentários

O host (chamador) assume a propriedade do BSTR retornado.

Outras maneiras de recuperar dados de texto sem formatação são usar WM_GETTEXT ou o método GetText do TOM (Text Object Model).

Se não houver texto no controle , o BSTR será alocado e 0x000D será retornado nele.

O texto retornado não será necessariamente encerrado em nulo.

Requisitos


Cliente mínimo com suporte	Windows Vista [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	textserv.h
DLL	Msftedit.dll