Skip to main content
.NET Framework Class Library
Panel..::.HorizontalAlign Property

Gets or sets the horizontal alignment of the contents within the panel.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Syntax
Public Overridable Property HorizontalAlign As HorizontalAlign
public virtual HorizontalAlign HorizontalAlign { get; set; }
public:
virtual property HorizontalAlign HorizontalAlign {
	HorizontalAlign get ();
	void set (HorizontalAlign value);
}
abstract HorizontalAlign : HorizontalAlign with get, set
override HorizontalAlign : HorizontalAlign with get, set
<asp:Panel HorizontalAlign="HorizontalAlign" />

Property Value

Type: System.Web.UI.WebControls..::.HorizontalAlign
One of the HorizontalAlign values. The default is NotSet.
Exceptions
ExceptionCondition
ArgumentOutOfRangeException

The horizontal alignment is not one of the HorizontalAlign values.

Remarks

Use this property to specify the alignment of the elements in the Panel.

Examples

The following example illustrates how to right-align or left-align the controls within the Panel.

NoteNote

The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Page Code Model.


<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Panel Example</title>
<script language="VB" runat="server">

    Sub Page_Load(sender As Object, e As EventArgs)
       Dim l As New Label()
       l.Text = "This panel contains a label control."
       Panel1.Controls.Add(l)
    End Sub

    Sub Button1_Click(sender As Object, e As EventArgs)
       If Panel1.HorizontalAlign = HorizontalAlign.Left Then
          Panel1.HorizontalAlign = HorizontalAlign.Right
          Button1.Text = "Left justify text within Panel"
       Else
          Panel1.HorizontalAlign = HorizontalAlign.Left
          Button1.Text = "Right justify text within Panel"
       End If
    End Sub

    </script>

 </head>
 <body>
    <h3>Panel Example</h3>
    <form id="form1" runat="server">

       <asp:Panel id="Panel1" Height="200" Width="100" BackColor="Gainsboro"
            Wrap="True" HorizontalAlign="Right" runat="server"/>

       <br />
       <asp:Button id="Button1" OnClick="Button1_Click"
            Text="Left justify text within panel" runat="server"/>

    </form>
 </body>
 </html>
    


<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Panel Example</title>
<script language="C#" runat="server">

    void Page_Load(Object sender, EventArgs e) {
       Label l = new Label();
       l.Text = "This panel contains a label control.";
       Panel1.Controls.Add(l);
    }

    void Button1_Click(Object sender, EventArgs e) {
       if (Panel1.HorizontalAlign == HorizontalAlign.Left) {
          Panel1.HorizontalAlign = HorizontalAlign.Right;
          Button1.Text = "Left justify text within Panel";
       } 
       else {
          Panel1.HorizontalAlign = HorizontalAlign.Left;
          Button1.Text = "Right justify text within Panel";
       }
    }
    </script>

 </head>
 <body>
    <h3>Panel Example</h3>
    <form id="form1" runat="server">

       <asp:Panel id="Panel1" Height="200" Width="100" BackColor="Gainsboro"
            Wrap="True" HorizontalAlign="Right" runat="server"/>

       <br />
       <asp:Button id="Button1" OnClick="Button1_Click"
            Text="Left justify text within panel" runat="server"/>

    </form>
 </body>
 </html>
    

Version Information

.NET Framework

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

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.