Compartilhar via


EM_SETTEXTMODE mensagem

Define o modo de texto ou o nível de desfazer de um controle de edição avançada. A mensagem falhará se o controle contiver texto.

Parâmetros

wParam

Um ou mais valores do tipo de enumeração TEXTMODE . Os valores especificam as novas configurações para o modo de texto do controle e os parâmetros de nível de desfazer.

Especifique um dos valores a seguir para definir o parâmetro de modo de texto. Se você não especificar um valor de modo de texto, o modo de texto permanecerá em sua configuração atual.

Valor Significado
TM_PLAINTEXT Indica o modo de texto sem formatação, no qual o controle é semelhante a um controle de edição padrão. Para obter mais informações sobre o modo de texto sem formatação, consulte a seção Comentários a seguir.
TM_RICHTEXT Indica o modo rich text, no qual o controle tem funcionalidade de edição avançada padrão. O modo rich text é a configuração padrão.

Especifique um dos valores a seguir para definir o parâmetro de nível desfazer. Se você não especificar um valor de nível de desfazer, o nível de desfazer permanecerá em sua configuração atual.

Valor Significado
TM_SINGLELEVELUNDO O controle permite que o usuário desfaça apenas a última ação que pode ser desfeita.
TM_MULTILEVELUNDO O controle dá suporte a várias operações de desfazer. Essa é a configuração padrão. Use a mensagem EM_SETUNDOLIMIT para definir o número máximo de ações de desfazer.

Especifique um dos valores a seguir para definir o parâmetro de página de código. Se você não especificar um valor de página de código, a página de código permanecerá em sua configuração atual.

Valor Significado
TM_SINGLECODEPAGE O controle permite apenas o teclado em inglês e um teclado correspondente ao conjunto de caracteres padrão. Por exemplo, você pode ter grego e inglês. Observe que isso impede que o texto Unicode insira o controle. Por exemplo, use esse valor se um controle de Edição Avançada precisar ser restrito ao texto ANSI.
TM_MULTICODEPAGE O controle permite várias páginas de código e texto Unicode no controle. Essa é a configuração padrão.

lParam

Esse parâmetro não é usado; deve ser zero.

Valor retornado

Se a mensagem for bem-sucedida, o valor retornado será zero.

Se a mensagem falhar, o valor retornado será um valor diferente de zero.

Comentários

No modo rich text, um controle de edição avançada tem funcionalidade de edição avançada padrão. No entanto, no modo de texto sem formatação, o controle é semelhante a um controle de edição padrão:

  • O texto em um controle de texto sem formatação pode ter apenas um formato (como Negrito, 10pt Arial).
  • O usuário não pode colar formatos de rich text, como RTF (Rich Text Format) ou objetos inseridos em um controle de texto sem formatação.
  • Os controles de modo rich text sempre têm um marcador de fim de documento padrão ou retorno de carro, para formatar parágrafos. Os controles de texto sem formatação, por outro lado, não precisam do marcador padrão de fim de documento, portanto, ele é omitido.

O controle não deve conter texto quando recebe a mensagem EM_SETTEXTMODE . Para garantir que não haja texto, envie uma mensagem WM_SETTEXT com uma cadeia de caracteres vazia ("").

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]
Cabeçalho
Richedit.h

Confira também

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT