WebZone.PartChromeStyle プロパティ

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

WebZone.PartChromeStyle プロパティ

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

ゾーンによって格納される Web パーツ コントロールの境界線に適用されるスタイル特性を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 PartChromeStyle As Style

Visual Basic (使用法)

Dim instance As WebZone
Dim value As Style

value = instance.PartChromeStyle

C#

public Style PartChromeStyle { get; }

C++

public:
property Style^ PartChromeStyle {
    Style^ get ();
}

J#

/** @property */
public Style get_PartChromeStyle ()

JScript

public function get PartChromeStyle
 () : Style

プロパティ値
ゾーンによって格納される Web パーツ コントロールの周囲を囲む境界線のスタイル属性を含む Style。

解説

Web パーツ コントロールには、PartStyle プロパティを使って Web パーツ コントロール自体の境界線を定義できます。コントロールを含んだゾーンには、コントロールの周囲に外側の境界線を追加できます。ゾーンの各 Web パーツ コントロールの周囲に配置できる外側の境界線は、PartChromeStyle プロパティで決定されます。このプロパティは、PartStyle オブジェクト内に含まれるプロパティの属性を取り消すことはできず、それらのプロパティにマージされるか追加されます。これにより、ゾーンに含まれる各 Web パーツ コントロールに共通の一貫した境界線を提供できるようになります。

重要 :
PartChromeStyle スタイルの設定は、主に、ゾーンに含まれるコントロールの周囲に配置できる外側の境界線に適用されますが、BackColor などのプロパティによって参照される Style オブジェクトに追加のプロパティを設定すると、ブラウザはこれらのスタイル属性を、ゾーンの表示に使用されるテーブルのすべてのサブ要素に適用すると解釈します。したがって、PartChromeStyle プロパティによって参照されるスタイル オブジェクトを BackColor プロパティに対して設定すると、WebPart コントロール上で、PartStyle プロパティによって参照されるオブジェクトの BackColor プロパティを設定するのと同じ結果になります。

使用例

PartChromeStyle プロパティを使用して、ゾーンに含まれるWeb パーツ コントロールの外側の境界線にスタイル属性を設定する方法を示すコード例を次に示します。

Visual Basic

<%@ page language="VB" %>
<script runat="server">
  Sub cal1_SelectionChanged(ByVal sender As
 Object, _
                            ByVal e As EventArgs)
    WebPartZone1.PartChromeStyle.BorderColor = System.Drawing.Color.Red
    WebPartZone1.PartChromeStyle.BorderWidth = 4
  End Sub
</script>
<html>
<head id="Head1" runat="server">
  
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server"
 />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar 
            ID="cal1" 
            Runat="server" 
            Title="My Calendar" 
            OnSelectionChanged="cal1_SelectionChanged"
 
            BorderColor="#00cc99" 
            BorderWidth="2" />
          <asp:Literal ID="literal1" Runat="server"
 >
            <h2>Favorite Links</h2>
            <a href="http://www.microsoft.com">Microsoft</a>
            <br />
            <a href="http://msdn.microsoft.com">MSDN</a>
          </asp:Literal>
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

C#

<%@ page language="C#" %>
<script runat="server">

  void cal1_SelectionChanged(object sender, EventArgs e)
  {
    WebPartZone1.PartChromeStyle.BorderColor = System.Drawing.Color.Red;
    WebPartZone1.PartChromeStyle.BorderWidth = 4;
  }
</script>
<html>
<head id="Head1" runat="server">
  
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server"
 />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar 
            ID="cal1" 
            Runat="server" 
            Title="My Calendar" 
            OnSelectionChanged="cal1_SelectionChanged" 
            BorderColor="#00cc99" 
            BorderWidth="2" />
          <asp:Literal ID="literal1" Runat="server" >
            <h2>Favorite Links</h2>
            <a href="http://www.microsoft.com">Microsoft</a>
            <br />
            <a href="http://msdn.microsoft.com">MSDN</a>
          </asp:Literal>
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

ブラウザでそのページを最初に読み込んだとき、ページの宣言型マークアップに設定されているとおり、上側のコントロールに 2 ピクセルの幅を持つ緑色の独自の境界線が表示されます。ユーザーがカレンダーをクリックすると、プログラムによってゾーンの両方のコントロールの境界線が赤色に変わり、境界線の幅が 4 ピクセルに設定されますが、上側のコントロールの緑色の内側の境界線は変わりません。

プラットフォーム

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

参照

関連項目
WebZone クラス
WebZone メンバ
System.Web.UI.WebControls.WebParts 名前空間
Style クラス
PartChromeType
PartStyle
その他の技術情報
ASP.NET Web パーツ ページ