Sdílet prostřednictvím

WebPartZoneBase.LayoutOrientation Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá nebo nastaví hodnotu, která označuje, zda ovládací prvky v zóně jsou uspořádány svisle nebo vodorovně.

public:
 virtual property System::Web::UI::WebControls::Orientation LayoutOrientation { System::Web::UI::WebControls::Orientation get(); void set(System::Web::UI::WebControls::Orientation value); };
public virtual System.Web.UI.WebControls.Orientation LayoutOrientation { get; set; }
member this.LayoutOrientation : System.Web.UI.WebControls.Orientation with get, set
Public Overridable Property LayoutOrientation As Orientation

Hodnota vlastnosti

Orientation

Hodnota Orientation , která určuje uspořádání ovládacích prvků v zóně. Výchozí orientace je Vertical.

Výjimky

ArgumentOutOfRangeException

Hodnota není jednou z výčtových Orientation hodnot.

Příklady

Následující příklad kódu ukazuje deklarativní a programové použití LayoutOrientation vlastnosti WebPartZone ovládacího prvku. Úplný příklad kódu, včetně zdrojového souboru kódu na pozadí a stránky .aspx, která obsahuje zónu v tomto kódu, najdete v přehledu WebPartZoneBase třídy.

Všimněte si, že LayoutOrientation vlastnost má přiřazenou hodnotu v deklarativním kódu. Tato hodnota má vliv na WebPartZone1načtení stránky do prohlížeče. Ovládací prvky webových částí v zóně jsou vykresleny vodorovně.

<asp:WebPartZone 
  ID="WebPartZone1" 
  Runat="server"
  LayoutOrientation="Vertical" >
  <EditVerb Text="Edit WebPart" />
  <SelectedPartChromeStyle BackColor="LightBlue" />
  <ZoneTemplate>
    <asp:BulletedList 
      ID="BulletedList1" 
      Runat="server"
      DisplayMode="HyperLink" 
      Title="Favorite Links" >
      <asp:ListItem Value="http://msdn.microsoft.com">
        MSDN
      </asp:ListItem>
      <asp:ListItem Value="http://www.asp.net">
        ASP.NET
      </asp:ListItem>
      <asp:ListItem Value="http://www.msn.com">
        MSN
      </asp:ListItem>
    </asp:BulletedList>
    <asp:Calendar ID="Calendar1" Runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</asp:WebPartZone>

<asp:WebPartZone 
  ID="WebPartZone1" 
  Runat="server"
  LayoutOrientation="Vertical" >
  <EditVerb Text="Edit WebPart" />
  <SelectedPartChromeStyle BackColor="LightBlue" />
  <ZoneTemplate>
    <asp:BulletedList 
      ID="BulletedList1" 
      Runat="server"
      DisplayMode="HyperLink" 
      Title="Favorite Links" >
      <asp:ListItem Value="http://msdn.microsoft.com">
        MSDN
      </asp:ListItem>
      <asp:ListItem Value="http://www.asp.net">
        ASP.NET
      </asp:ListItem>
      <asp:ListItem Value="http://www.msn.com">
        MSN
      </asp:ListItem>
    </asp:BulletedList>
    <asp:Calendar ID="Calendar1" Runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</asp:WebPartZone>

Orientaci zóny můžete změnit kliknutím na tlačítko Přepnout orientaci rozložení . Kód pro přepnutí orientace se vyskytuje v následujícím příkladu kódu z částečné třídy.

protected void Button2_Click(object sender, EventArgs e)
{
  if (WebPartZone1.LayoutOrientation == Orientation.Vertical)
    WebPartZone1.LayoutOrientation = Orientation.Horizontal;
  else
    WebPartZone1.LayoutOrientation = Orientation.Vertical;
  Page_Load(sender, e);
}

Protected Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs) 
  If WebPartZone1.LayoutOrientation = Orientation.Vertical Then
      WebPartZone1.LayoutOrientation = Orientation.Horizontal
  Else
      WebPartZone1.LayoutOrientation = Orientation.Vertical
  End If
  Page_Load(sender, e)
End Sub

Poznámky

Vlastnost LayoutOrientation se týká rozložení ovládacích prvků webových částí v zóně. Při výchozí Vertical orientaci se ovládací prvky vykreslují v uspořádání shora dolů podle ZoneIndex hodnoty každého ovládacího prvku. Horizontal Při orientaci jsou ovládací prvky uspořádány vedle sebe, v závislosti na šířce zóny.

Internet Explorer může ovlivnit výšku WebPart ovládacího prvku a výšku zóny, která ho obsahuje. Internet Explorer vykresluje webové stránky buď v režimu kompatibility (zpětně kompatibilní s předchozími verzemi prohlížeče), nebo ve standardním režimu (určeném přítomností DOCTYPE deklarace na stránce). Informace o těchto režimech naleznete v DHTML CompatMode vlastnost. Když Internet Explorer vykreslí stránku v režimu standardů, v některých scénářích nezmění velikost buněk v tabulkách, i když je kód HTML buňky .<td height="100%"> V důsledku toho WebPart jsou ovládací prvky a jejich obsahující zóna vykresleny tak, aby se ovládací prvky neroztahovaly do celé výšky zóny.

K tomuto typu vykreslování dochází ve dvou případech.

  • Když je vlastnost zóny LayoutOrientation nastavená na Verticalhodnotu a explicitně nastavíte výšku zóny. Pokud chcete ovládacím prvkům povolit vyplnění celé výšky zóny, nezadávejte výšku vodorovné zóny.

  • Pokud je vlastnost zóny LayoutOrientation nastavená na Horizontalhodnotu a nenastavíte explicitně výšku zóny (nebo obsažených ovládacích prvků). Pokud chcete ovládacím prvkům povolit vyplnění celé výšky zóny, nastavte výšku zóny nebo ovládacích prvků ve svislé zóně.

Příklad kódu v tomto tématu ukazuje normální použití LayoutOrientation vlastnosti . Příklad kódu, který ukazuje problém s vykreslováním souvisejícím s výškou a jak ho obejít, najdete ve Height vlastnosti .

Platí pro

Viz také