windowsforms-devexpress-dot-xtraeditors-dot-repository-dot-repositoryitemtextedit-05d0b6ad.md
Gets or sets the password character that appears instead of actual characters.
Namespace : DevExpress.XtraEditors.Repository
Assembly : DevExpress.XtraEditors.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[DefaultValue('\0')]
[DXCategory("Behavior")]
public virtual char PasswordChar { get; set; }
<DXCategory("Behavior")>
<DefaultValue(vbNullChar)>
Public Overridable Property PasswordChar As Char
| Type | Default | Description |
|---|---|---|
| Char | '\0' |
A character that appears instead of actual characters.
|
You can mask the actual users’ input in a text editor in two ways:
Set the RepositoryItemTextEdit.UseSystemPasswordChar property to true. An editor will mask its text as follows:
Set the PasswordChar property to any valid character. This character will mask the editor’s text.
Users cannot copy or cut text from an editor in password mode; the TextEdit.Cut and TextEdit.Copy methods will do nothing.
The MemoEdit and MemoExEdit editors, and editors without text input, do not support input masks.
The code sample below illustrates how to turn on/off the password mask.
buttonEdit1.ButtonClick += ButtonEdit1_ButtonClick;
private void ButtonEdit1_ButtonClick(object sender, DevExpress.XtraEditors.Controls.ButtonPressedEventArgs e)
{
ButtonEdit edit = sender as ButtonEdit;
edit.Properties.PasswordChar = (edit.Properties.PasswordChar == '*') ? '\0' : '*';
}
Private buttonEdit1.ButtonClick += AddressOf ButtonEdit1_ButtonClick
Private Sub ButtonEdit1_ButtonClick(ByVal sender As Object, ByVal e As DevExpress.XtraEditors.Controls.ButtonPressedEventArgs)
Dim edit As ButtonEdit = TryCast(sender, ButtonEdit)
edit.Properties.PasswordChar = If(edit.Properties.PasswordChar = "*"c, ControlChars.NullChar, "*"c)
End Sub
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PasswordChar property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.
winforms-mvvm-expenses-app/CS/MVVMExpenses/Views/LoginView.cs#L17
InitializeComponent();
PasswordTextEdit.Properties.PasswordChar = '*';
}
winforms-mvvm-expenses-app/VB/MVVMExpenses/Views/LoginView.vb#L20
InitializeComponent()
PasswordTextEdit.Properties.PasswordChar = "*"c
End Sub
See Also