CEdit::SetPasswordChar

Rufen Sie diese Funktion auf, um ein Kennwortzeichen festzulegen oder zu entfernen, das in einem Bearbeitungssteuerelement angezeigt wird, wenn Benutzer Text.

void SetPasswordChar(
   TCHAR ch 
);

Parameter

  • ch
    Gibt das statt an des Zeichens angezeigt werden, Zeichen, das vom Benutzer eingegeben werden.Wenn ch 0 ist, werden die tatsächlichen Zeichen, die vom Benutzer eingegeben werden, angezeigt.

Hinweise

Wenn ein Kennwortzeichen festgelegt ist, wird dieses Zeichen für jedes Zeichen der Eingabe angezeigt.

Diese Memberfunktion hat keine Auswirkungen auf ein mehrzeiliges Bearbeitungssteuerelement.

Wenn die SetPasswordChar-Memberfunktion aufgerufen wird, zeichnet CEdit alle sichtbaren Zeichen neu, die das Zeichen verwenden, das von ch angegeben wird.

Wenn das Bearbeitungssteuerelement mit dem ES_PASSWORD Format erstellt wird, wird Standardkennwortzeichen auf ein Sternchen (*) festgelegt.Dieses Format wird entfernt, wenn SetPasswordChar mit ch aufgerufen wird, der auf 0 festgelegt ist.

Weitere Informationen finden Sie unter EM_SETPASSWORDCHAR in Windows SDK.

Beispiel

// Turn off the password mode.
m_myEdit.SetPasswordChar(0);
ASSERT(!(m_myEdit.GetStyle() & ES_PASSWORD));

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CEdit-Klasse

Hierarchien-Diagramm

CEdit::GetPasswordChar