Panel.HorizontalAlign Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 virtual property System::Web::UI::WebControls::HorizontalAlign HorizontalAlign { System::Web::UI::WebControls::HorizontalAlign get(); void set(System::Web::UI::WebControls::HorizontalAlign value); };

[System.ComponentModel.Bindable(true)]
public virtual System.Web.UI.WebControls.HorizontalAlign HorizontalAlign { get; set; }

public virtual System.Web.UI.WebControls.HorizontalAlign HorizontalAlign { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.HorizontalAlign : System.Web.UI.WebControls.HorizontalAlign with get, set

member this.HorizontalAlign : System.Web.UI.WebControls.HorizontalAlign with get, set

Public Overridable Property HorizontalAlign As HorizontalAlign

Property Value

HorizontalAlign

One of the HorizontalAlign values. The default is NotSet.

Attributes: BindableAttribute

Exceptions

ArgumentOutOfRangeException

The horizontal alignment is not one of the HorizontalAlign values.

Examples

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

Note

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 Forms Page Code Model.

ASP.NET (C#)

<%@ 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>

<%@ 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>

Remarks

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

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via