WebPartZoneBase.LayoutOrientation プロパティ

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

プロパティ値

ゾーン内のコントロールの配置方法を決定する Orientation 値。 既定の向きは Verticalです。

例外

例

次のコード例は、WebPartZone コントロールでのLayoutOrientation プロパティの宣言型およびプログラムによる使用を示しています。 分離コード ソース ファイルや、このコードのゾーンを含む .aspx ページなど、完全なコード例については、 WebPartZoneBase クラスの概要を参照してください。

LayoutOrientation プロパティには、宣言型マークアップで値が割り当てられていることに注意してください。 この値は、ページをブラウザーに読み込んだ後の WebPartZone1に影響します。 ゾーン内の Web パーツ コントロールは水平方向にレンダリングされます。

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

[ レイアウトの向きの切り替え ] ボタンをクリックすると、ゾーンの向きを変更できます。 方向を切り替えるコードは、部分クラスの次のコード例で発生します。

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

注釈

LayoutOrientation プロパティは、Web パーツ コントロールをゾーン内に配置する方法に関します。 既定の Vertical 方向では、各コントロールの ZoneIndex 値に従って、コントロールが上から下に配置されてレンダリングされます。 Horizontal方向では、コントロールはゾーンの幅に応じて並べて配置されます。

Internet Explorer は、 WebPart コントロールの高さと、コントロールを含むゾーンの高さに影響を与える可能性があります。 Internet Explorer は、Web ページを互換モード (以前のブラウザー バージョンとの下位互換性) または標準モード (ページ内に DOCTYPE 宣言が存在することによって決定されます) でレンダリングします。 これらのモードの詳細については、DHTML compatMode プロパティを参照してください。 Internet Explorer が標準モードでページをレンダリングする場合、一部のシナリオでは、セルの HTML マークアップが <td height="100%">されている場合でも、テーブル内のセルのサイズが変更されません。 その結果、 WebPart コントロールとその包含ゾーンがレンダリングされ、コントロールがゾーンの高さ全体に拡大されないようにします。

この種類のレンダリングは、2 つのケースで発生します。

• ゾーンの LayoutOrientation プロパティが Vertical に設定されていて、ゾーンの高さを明示的に設定する場合。 コントロールがゾーンの高さ全体を塗りつぶせるようにするには、水平ゾーンの高さを指定しないでください。

• ゾーンの LayoutOrientation プロパティが Horizontal に設定されていて、ゾーンの高さ (または含まれているコントロール) を明示的に設定しない場合。 コントロールがゾーンの高さを完全に満たすようにするには、ゾーンの高さを設定するか、垂直ゾーン内のコントロールの高さを設定します。

このトピックのコード例では、 LayoutOrientation プロパティの通常の使用方法を示します。 高さに関連するレンダリングの問題とその回避方法を示すコード例については、 Height プロパティを参照してください。

こちらもご覧ください

• Orientation
• Height
• ASP.NET Web パーツ コントロール