CharacterCasing Enumeration
Specifies the case of characters in a TextBox control.
[Visual Basic] <Serializable> Public Enum CharacterCasing [C#] [Serializable] public enum CharacterCasing [C++] [Serializable] __value public enum CharacterCasing [JScript] public Serializable enum CharacterCasing
Remarks
Use the members of this enumeration to set the value of the CharacterCasing property of the TextBox control.
Members
| Member name | Description |
|---|---|
| Lower | Converts all characters to lowercase. |
| Normal | The case of characters is left unchanged. |
| Upper | Converts all characters to uppercase. |
Example
The following example creates a TextBox control that is used to accept a password. This example uses the CharacterCasing property to change all characters typed to uppercase and the MaxLength property to restrict the password length to eight characters. This example also uses the TextAlign property to center the password in the TextBox control.
[Visual Basic] Public Sub CreateMyPasswordTextBox() ' Create an instance of the TextBox control. Dim textBox1 As New TextBox() ' Set the maximum length of text in the control to eight. textBox1.MaxLength = 8 ' Assign the asterisk to be the password character. textBox1.PasswordChar = "*"c ' Change all text entered to be lowercase. textBox1.CharacterCasing = CharacterCasing.Lower ' Align the text in the center of the TextBox control. textBox1.TextAlign = HorizontalAlignment.Center End Sub [C#] public void CreateMyPasswordTextBox() { // Create an instance of the TextBox control. TextBox textBox1 = new TextBox(); // Set the maximum length of text in the control to eight. textBox1.MaxLength = 8; // Assign the asterisk to be the password character. textBox1.PasswordChar = '*'; // Change all text entered to be lowercase. textBox1.CharacterCasing = CharacterCasing.Lower; // Align the text in the center of the TextBox control. textBox1.TextAlign = HorizontalAlignment.Center; } [C++] public: void CreateMyPasswordTextBox() { // Create an instance of the TextBox control. TextBox* textBox1 = new TextBox(); // Set the maximum length of text in the control to eight. textBox1->MaxLength = 8; // Assign the asterisk to be the password character. textBox1->PasswordChar = '*'; // Change all text entered to be lowercase. textBox1->CharacterCasing = CharacterCasing::Lower; // Align the text in the center of the TextBox control. textBox1->TextAlign = HorizontalAlignment::Center; } [JScript] public function CreateMyPasswordTextBox() { // Create an instance of the TextBox control. textBox1 = new TextBox(); // Set the maximum length of text in the control to eight. textBox1.MaxLength = 8; // Assign the asterisk to be the password character. textBox1.PasswordChar = '*'; // Change all text entered to be lowercase. textBox1.CharacterCasing = CharacterCasing.Lower; // Align the text in the center of the TextBox control. textBox1.TextAlign = HorizontalAlignment.Center; }
Requirements
Namespace: System.Windows.Forms
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)