WebPartZoneBase.LayoutOrientation プロパティ

.NET Framework クラス ライブラリ リファレンス

WebPartZoneBase.LayoutOrientation プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ゾーン内でコントロールを縦と横のどちらの方式で並べるかを指定する値を取得または設定します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 LayoutOrientation As Orientation

Visual Basic (使用法)

Dim instance As WebPartZoneBase
Dim value As Orientation

value = instance.LayoutOrientation

instance.LayoutOrientation = value

C#

public virtual Orientation LayoutOrientation { get;
 set; }

C++

public:
virtual property Orientation LayoutOrientation {
    Orientation get ();
    void set (Orientation value);
}

J#

/** @property */
public Orientation get_LayoutOrientation ()

/** @property */
public void set_LayoutOrientation (Orientation
 value)

JScript

public function get LayoutOrientation
 () : Orientation

public function set LayoutOrientation
 (value : Orientation)

プロパティ値
ゾーン内でコントロールを並べる方式を決定する Orientation 値。既定の方向は Vertical です。

例外

例外の種類	条件
ArgumentOutOfRangeException	値が、列挙された Orientation 値ではありません。

解説

LayoutOrientation プロパティでは、ゾーン内の Web パーツ コントロールのレイアウト方法を指定します。既定の Vertical 方向の場合、コントロールは、各コントロールの ZoneIndex 値に従って、上から下に表示されます。Horizontal 方向の場合、コントロールは、ゾーンの幅の範囲内で横に並べられます。

使用例

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

LayoutOrientation プロパティは、宣言型マークアップで割り当てる値を持っています。この値は、ブラウザにページを読み込んだ後、WebPartZone1 に反映されます。ゾーン内の Web パーツ コントロールは、横に並べて表示されます。

Visual Basic

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

C#

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

[Toggle Layout Orientation] ボタンをクリックして、ゾーンの方向を変更できます。方向を切り替えるコードは、部分クラスから抜粋した次のコード例にあります。

Visual Basic

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 

C#

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);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartZoneBase クラス
WebPartZoneBase メンバ
System.Web.UI.WebControls.WebParts 名前空間
Orientation 列挙体
その他の技術情報
ASP.NET Web パーツ ページ