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

Confira também

Conceitual

ITextServices

OleFlushClipboard

Outros recursos

Referência

SetText

WM_SETTEXT

Controles de edição avançada sem janelas