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řádané 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 za kódem 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í revize. Tato hodnota se týká WebPartZone1po načtení stránky do prohlížeče. Ovládací prvky Webové části v zóně se vykreslí 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>

Pokud chcete změnit orientaci zóny, můžete kliknout 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á toho, jak jsou Webové části ovládací prvky rozloženy v zóně. S výchozí Vertical orientací se ovládací prvky vykreslují v uspořádání shora dolů podle ZoneIndex hodnoty každého ovládacího prvku. Horizontal S orientací 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á ji obsahuje. Internet Explorer vykresluje webové stránky buď v režimu kompatibility (zpětně kompatibilní s předchozími verzemi prohlížeče), nebo v režimu standardů (určeném DOCTYPE přítomností 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 nemění velikost buněk v tabulkách, i když je <td height="100%">kód HTML buňky . Výsledkem je, že ovládací prvky a jejich obsahující zónu se vykreslují tak, WebPart aby se ovládací prvky nepřetahovaly na úplnou výšku zóny.

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

  • Když je vlastnost zóny LayoutOrientation nastavená na Verticala 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 Horizontala explicitně nenastavíte výšku zóny (nebo ovládacích prvků obsažených). 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 v Height vlastnosti.

Platí pro

Viz také