This documentation is archived and is not being maintained.

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)

public enum HorizontalAlignment

Member nameDescription
LeftThe object or text is aligned on the left of the control element.
RightThe object or text is aligned on the right of the control element.
CenterThe object or text is aligned in the center of the control element.

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

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.

		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;							

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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

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