Share via


EM_SETPASSWORDCHAR

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message sets or removes a password character displayed in a single-line edit control when the user types text. When a password character is set, that character is displayed in place of each character the user types.

Syntax

EM_SETPASSWORDCHAR 
    wParam = (WPARAM)(UINT) ch; 
    lParam = 0;

Parameters

  • ch
    Specifies the character to be displayed in place of the character typed by the user. If this parameter is zero, the characters typed by the user are displayed.
  • lParam
    Not used; set to 0.

Return Value

None.

Remarks

When the EM_SETPASSWORDCHAR message is received by an edit control, the edit control redraws all visible characters by using the character specified by the ch parameter.

If the edit control is created with the ES_PASSWORD style, the default password character is set to an asterisk (*). This style is removed if an EM_SETPASSWORDCHAR message is sent with the ch parameter set to zero.

Requirements

Header windows.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

EM_GETPASSWORDCHAR
Edit Boxes Messages

Concepts

Control Styles