EM_SETPASSWORDCHAR message

  • Article

Définit ou supprime le caractère de mot de passe d’un contrôle d’édition. Lorsqu’un caractère de mot de passe est défini, ce caractère est affiché à la place des caractères tapés par l’utilisateur. Vous pouvez envoyer ce message à un contrôle d’édition ou à un contrôle d’édition enrichi.

Paramètres

wParam

Caractère à afficher à la place des caractères tapés par l’utilisateur. Si ce paramètre est égal à zéro, le contrôle supprime le caractère de mot de passe actuel et affiche les caractères tapés par l’utilisateur.

lParam

Ce paramètre n'est pas utilisé.

Valeur retournée

Ce message ne retourne pas de valeur.

Notes

Lorsqu’un contrôle d’édition reçoit le message EM_SETPASSWORDCHAR , le contrôle redessine tous les caractères visibles à l’aide du caractère spécifié par le paramètre wParam . Si wParam est égal à zéro, le contrôle redessine tous les caractères visibles à l’aide des caractères tapés par l’utilisateur.

Si un contrôle d’édition est créé avec le style ES_PASSWORD , le caractère de mot de passe par défaut est défini sur un astérisque (*). Si un contrôle d’édition est créé sans le style ES_PASSWORD , il n’y a pas de caractère de mot de passe. Le style ES_PASSWORD est supprimé si un message EM_SETPASSWORDCHAR est envoyé avec le paramètre wParam défini sur zéro.

Modifier les contrôles : Les contrôles d’édition multiligne ne prennent pas en charge le style ou les messages de mot de passe.

Édition enrichie : Pris en charge dans Microsoft Rich Edit 2.0 et versions ultérieures. Les contrôles d’édition monoligne et multiligne prennent en charge le style de mot de passe et les messages. Pour plus d’informations sur la compatibilité des versions d’édition enrichie avec les différentes versions du système, consultez À propos des contrôles d’édition enrichi.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2003 [applications de bureau uniquement]
En-tête
Winuser.h (inclure Windows.h)

Voir aussi

EM_GETPASSWORDCHAR