WebZone.PartChromeStyle プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

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

public:
 property System::Web::UI::WebControls::Style ^ PartChromeStyle { System::Web::UI::WebControls::Style ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.Style PartChromeStyle { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.PartChromeStyle : System.Web.UI.WebControls.Style
Public ReadOnly Property PartChromeStyle As Style

プロパティ値

Style

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

属性
PersistenceModeAttribute

例

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

<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void cal1_SelectionChanged(object sender, EventArgs e)
  {
    WebPartZone1.PartChromeStyle.BorderColor = System.Drawing.Color.Red;
    WebPartZone1.PartChromeStyle.BorderWidth = 4;
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Favorite Links</title>
</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>

<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Favorite Links</title>
</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 ピクセルに設定しますが、上のコントロールは元の緑色の内側の境界線を保持します。

注釈

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

重要

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

適用対象

こちらもご覧ください