UseSystemPasswordChar Property (TextBoxCell)

Gets or sets a value that indicates whether the operating system-supplied password character should be used.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<DefaultValueAttribute()>
<SRDescriptionAttribute("Indicates whether the text should appear as the default password character.")>
<SRCategoryAttribute("Behavior")>
Public Property UseSystemPasswordChar As Boolean

Dim instance As TextBoxCell
Dim value As Boolean
 
instance.UseSystemPasswordChar = value
 
value = instance.UseSystemPasswordChar

[DefaultValue()]
[SRDescription("Indicates whether the text should appear as the default password character.")]
[SRCategory("Behavior")]
public bool UseSystemPasswordChar {get; set;}

Property Value

true to use the system password character; otherwise, false. The default is false.

Remarks

The UseSystemPasswordChar property determines whether user-supplied input should be displayed in the cell as multiple occurrences of a password character defined by the operating system. This property has precedence over PasswordChar.

Important:
As a security consideration, the TextBoxCell disables cut and copy operations on password-protected strings.

Example

The following code example shows some important TextBoxCell properties. The cell cannot display the text completely so an ellipsis string "......" is displayed. When you enter edit mode, the text is selected because the HighlightText property is true. If you delete the original text and input some text, only 10 characters are allowed because the MaxLength is 10. The upper case text is converted to lower case. This example is part of a larger example available for the TextBoxCell class.

private void Form1_Load(object sender, EventArgs e)
        {
            TextBoxCell textBoxCell1 = new TextBoxCell();
            //If the text cannot display completely, a '......' string is shown at the end, hover over the cell, the whole 
text is shown in a tooltip.
            textBoxCell1.Ellipsis = MultiRowEllipsisMode.EllipsisEnd;
            textBoxCell1.EllipsisString = "......";
            //Enter the edit mode, the text is selected.
            textBoxCell1.HighlightText = true;
            textBoxCell1.Value = "DELETE THIS STRING TO INPUT, ONLY 10 CHARACTERS ALLOWED";
            textBoxCell1.MaxLength = 10;
            //The value is cast to lower case.
            textBoxCell1.CharacterCasing = CharacterCasing.Lower;

            TextBoxCell textBoxCell2 = new TextBoxCell();
            //Input text in textBoxCell2, it is treated as a password, always displays '#'.
            textBoxCell2.PasswordChar = '#';
            textBoxCell2.UseSystemPasswordChar = false;
            textBoxCell2.Value = "12345";

            Template template1 = Template.CreateGridTemplate(new Cell[] { textBoxCell1, textBoxCell2 }, 160,
                AutoGenerateGridTemplateStyles.ColumnHeader | 
AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);

            gcMultiRow1.Template = template1;
            gcMultiRow1.RowCount = 3;
        }

VB.NET

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim textBoxCell1 As New TextBoxCell()
        'If the text cannot display completely, a '......' string is shown at the end, hover over the cell, the whole text 
is shown in a tooltip.
        textBoxCell1.Ellipsis = MultiRowEllipsisMode.EllipsisEnd
        textBoxCell1.EllipsisString = "......"
        'Enter edit mode, the text is selected.
        textBoxCell1.HighlightText = True
        textBoxCell1.Value = "DELETE THIS STRING TO INPUT, ONLY 10 CHARACTERS ALLOWED"
        textBoxCell1.MaxLength = 10
        'The value is cast to lower case.
        textBoxCell1.CharacterCasing = CharacterCasing.Lower

        Dim textBoxCell2 As New TextBoxCell()
        'Input text in textBoxCell2, it is treated as a password, always displays '#'.
        textBoxCell2.PasswordChar = "#"c
        textBoxCell2.UseSystemPasswordChar = False
        textBoxCell2.Value = "12345"

        Dim template1 As Template = Template.CreateGridTemplate(New Cell() {textBoxCell1, textBoxCell2})

        gcMultiRow1.Template = template1
        gcMultiRow1.RowCount = 3
    End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

TextBoxCell Class
TextBoxCell Members