EM_SETPASSWORDCHAR Message

Platforms

Windows 95: Supported.
Windows 98: Supported.
Windows NT: Requires Windows NT 3.1 or later.
Windows 2000: Supported.
Windows CE: Requires Windows CE 1.0 or later.

Description & Usage

The EM_SETPASSWORDCHAR message sets the password character used by an edit control. This characters appears in place of each character entered into the edit control, in order to hide its contents. As the name implies, this is typically done to hide a password entered into the control. This message can also be used to tell an edit control not to use such a password character, instead telling it to actually display its contents.

Return Value

EM_SETPASSWORDCHAR does not return a meaningful value.

Visual Basic-Specific Issues

None.

Parameters

wParam: The ASCII code of the character to use as the new password character. If this is 0, then the edit control will no longer use a password character.
lParam: Not used -- set to 0.

Constant Definitions

Const EM_SETPASSWORDCHAR = &HCC

Example

' This code is licensed according to the terms and conditions listed here.

' Declarations and such needed for the example:
' (Copy them to the (declarations) section of a module.)
Public Declare Function SendMessage Lib "user32.dll" Alias "SendMessageA" (ByVal hWnd _
	As Long, ByVal Msg As Long, wParam As Any, lParam As Any) As Long
Public Const EM_SETPASSWORDCHAR = &HCC

' Have edit control Text1 use a dash character to hide the password.
Dim retval As Long  ' meaningless return value

retval = SendMessage(Text1.hWnd, EM_SETPASSWORDCHAR, ByVal CLng(Asc("-")), ByVal CLng(0))