EM_SETPASSWORDCHAR Nachricht

Legt das Kennwortzeichen für ein Bearbeitungssteuerelement fest oder entfernt es. Wenn ein Kennwortzeichen festgelegt ist, wird dieses Zeichen anstelle der vom Benutzer eingegebenen Zeichen angezeigt. Sie können diese Nachricht entweder an ein Bearbeitungssteuerelement oder ein Rich-Edit-Steuerelement senden.

Parameter

wParam

Das Zeichen, das anstelle der vom Benutzer eingegebenen Zeichen angezeigt werden soll. Wenn dieser Parameter null ist, entfernt das Steuerelement das aktuelle Kennwortzeichen und zeigt die vom Benutzer eingegebenen Zeichen an.

lParam

Dieser Parameter wird nicht verwendet.

Rückgabewert

Diese Meldung gibt keinen Wert zurück.

Bemerkungen

Wenn ein Bearbeitungssteuerelement die EM_SETPASSWORDCHAR-Meldung empfängt, zeichnet das Steuerelement alle sichtbaren Zeichen mithilfe des durch den wParam-Parameter angegebenen Zeichens neu. Wenn wParam null ist, zeichnet das Steuerelement alle sichtbaren Zeichen mit den vom Benutzer eingegebenen Zeichen neu.

Wenn ein Bearbeitungssteuerelement mit der ES_PASSWORD-Formatvorlage erstellt wird, wird das Standardkennwortzeichen auf ein Sternchen (*) festgelegt. Wenn ein Bearbeitungssteuerelement ohne das ES_PASSWORD-Format erstellt wird, gibt es kein Kennwortzeichen. Die ES_PASSWORD wird entfernt, wenn eine EM_SETPASSWORDCHAR Nachricht gesendet wird, wobei der wParam-Parameter auf null festgelegt ist.

Bearbeiten von Steuerelementen: Mehrline-Bearbeitungssteuerelemente unterstützen den Kennwortstil oder nachrichten nicht.

Rich Edit: Unterstützt in Microsoft Rich Edit 2.0 und höher. Sowohl einzeilige als auch mehrzeilige Bearbeitungssteuerelemente unterstützen den Kennwortstil und nachrichten. Informationen zur Kompatibilität von Rich-Edit-Versionen mit den verschiedenen Systemversionen finden Sie unter Informationen zu Rich Edit-Steuerelementen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen)

Siehe auch

EM_GETPASSWORDCHAR