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

Define todo o texto no controle .

Sintaxe

HRESULT TxSetText(
  [in] LPCWSTR pszText
);

Parâmetros

[in] pszText

Tipo: LPCTSTR

A cadeia de caracteres que substituirá o texto atual.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK.

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

Código de retorno	Descrição
E_FAIL	Não foi possível atualizar o texto.

Comentários

Esse método deve ser usado com cuidado; essencialmente reinicializa o objeto de serviços de texto com alguns novos dados. Todos os dados anteriores e informações de formatação serão perdidos, incluindo informações de desfazer.

Se os dados anteriores tiverem sido copiados para a área de transferência, esses dados serão renderizados completamente para a área de transferência (por meio de OleFlushClipboard) antes de serem descartados.

Esse método não dá suporte a Desfazer.

Duas abordagens alternativas para definir o texto são WM_SETTEXT e SetText.

Requisitos

Requisito	Valor
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