HorizontalAlignment Enumeration (System.Windows.Forms)

Microsoft Developer Network

HorizontalAlignment Enumeration

.NET Framework Class Library

HorizontalAlignment Enumeration

Specifies how an object or text in a control is horizontally aligned relative to an element of the control.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic (Declaration)

<ComVisibleAttribute(True)> _
Public Enumeration HorizontalAlignment

Visual Basic (Usage)

Dim instance As HorizontalAlignment

[ComVisibleAttribute(true)]
public enum HorizontalAlignment

Visual C++

[ComVisibleAttribute(true)]
public enum class HorizontalAlignment

JScript

public enum HorizontalAlignment

Members

	Member name	Description
	Left	The object or text is aligned on the left of the control element.
	Right	The object or text is aligned on the right of the control element.
	Center	The object or text is aligned in the center of the control element.

Remarks

This enumeration is used in numerous classes. A partial list of these classes is CheckedListBox, ColumnHeader, ComboBox, ControlPaint, Label, ListBox, Control, RichTextBox, and TextBox.

Examples

This example shows how to use the HorizontalAlignment enumeration to align the text to the left, right, or in the center of a control element. First, create a TextBox with a specific size, and add a text string to it. Then, use the enumeration member Center to align the text in the center of the TextBox. The example assumes that you have created a Form named Form1 and a TextBox named textBox1.

Visual Basic

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    ' Add a text string to the TextBox.
    TextBox1.Text = "Hello World!"

    ' Set the size of the TextBox.
    TextBox1.AutoSize = False
    TextBox1.Size = New Size(Width, Height/3)

    ' Align the text in the center of the control element. 
    TextBox1.TextAlign = HorizontalAlignment.Center
End Sub

        private void Form1_Load(object sender, System.EventArgs e)
        {
            // Add a text string to the TextBox.
            textBox1.Text = "Hello World!";
            
            // Set the size of the TextBox.
            textBox1.AutoSize = false;
            textBox1.Size = new Size(Width, Height/3);
            
            // Align the text in the center of the control element. 
            textBox1.TextAlign = HorizontalAlignment.Center;                            
        }

Visual C++

private:
   void Form1_Load( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Add a text String* to the TextBox.
      textBox1->Text = "Hello World!";

      // Set the size of the TextBox.
      textBox1->AutoSize = false;
      textBox1->Size = System::Drawing::Size( Width, Height / 3 );

      // Align the text in the center of the control element.
      textBox1->TextAlign = HorizontalAlignment::Center;
   }

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

Reference

System.Windows.Forms Namespace