Compartilhar via


EM_SETPASSWORDCHAR mensagem

Define ou remove o caractere de senha de um controle de edição. Quando um caractere de senha é definido, esse caractere é exibido no lugar dos caracteres digitados pelo usuário. Você pode enviar essa mensagem para um controle de edição ou um controle de edição avançada.

Parâmetros

wParam

O caractere a ser exibido no lugar dos caracteres digitados pelo usuário. Se esse parâmetro for zero, o controle removerá o caractere de senha atual e exibirá os caracteres digitado pelo usuário.

lParam

Este parâmetro não é usado.

Valor retornado

Esta mensagem não retorna um valor.

Comentários

Quando um controle de edição recebe a mensagem EM_SETPASSWORDCHAR , o controle redesenha todos os caracteres visíveis usando o caractere especificado pelo parâmetro wParam . Se wParam for zero, o controle redesenhará todos os caracteres visíveis usando os caracteres digitado pelo usuário.

Se um controle de edição for criado com o estilo ES_PASSWORD , o caractere de senha padrão será definido como um asterisco (*). Se um controle de edição for criado sem o estilo ES_PASSWORD , não haverá nenhum caractere de senha. O estilo ES_PASSWORD será removido se uma mensagem de EM_SETPASSWORDCHAR for enviada com o parâmetro wParam definido como zero.

Editar controles: Os controles de edição de várias linhas não dão suporte ao estilo ou mensagens de senha.

Edição avançada: Com suporte no Microsoft Rich Edit 2.0 e posterior. Os controles de edição de linha única e de várias linhas dão suporte ao estilo de senha e às mensagens. Para obter informações sobre a compatibilidade de versões de edição avançada com as várias versões do sistema, consulte Sobre controles de edição avançada.

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
Winuser.h (inclua Windows.h)

Confira também

EM_GETPASSWORDCHAR