EM_SETTEXTMODE mensagem

Define o modo de texto ou o nível de desfazer de um controle de edição avançado. A mensagem falhará se o controle contiver qualquer 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 seguintes valores 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 a funcionalidade de edição avançada padrão. O modo de rich text é a configuração padrão.

Especifique um dos seguintes valores para definir o parâmetro de nível de 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 suporta várias operações de desfazer. Esta é 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 seguintes valores 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 só permite 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 entre no controle. Por exemplo, use esse valor se um controle Rich Edit precisar ser restrito ao texto ANSI.
TM_MULTICODEPAGE	O controle permite várias páginas de código e texto Unicode no controle. Esta é a configuração padrão.

lParam

Este parâmetro não é utilizado; tem de ser zero.

Valor de retorno

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

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

Observações

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 rich text, como Rich Text Format (RTF) ou objetos incorporados 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 simples, por outro lado, não precisam do marcador padrão de fim de documento, por isso 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 string vazia ("").

Requerimentos

Ver também

EM_GETTEXTMODE

EM_SETUNDOLIMIT

MODO DE TEXTO

WM_SETTEXT