WebZone.PartChromeStyle Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft Stileigenschaften ab, die auf die Rahmen der in einer Zone enthaltenen Webparts-Steuerelemente angewendet werden.

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

Eigenschaftswert

Style

Ein Style mit Stilattributen für die Rahmen, mit denen die in einer Zone enthaltenen Webparts-Steuerelemente eingefasst werden.

Attribute
PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der PartChromeStyle Eigenschaft zum Festlegen von Formatattributen für die äußeren Rahmen von Webparts Steuerelementen in einer Zone veranschaulicht.

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

Beachten Sie, dass beim ersten Laden der Seite in einem Browser das obere Steuerelement einen eigenen grünen Rahmen mit einer Breite von 2 Pixeln aufweist, wie im deklarativen Markup für die Seite festgelegt. Nachdem ein Benutzer auf den Kalender geklickt hat, ändert die Seite programmgesteuert die Rahmen beider Steuerelemente in rot, und legt die Rahmenbreite auf 4 Pixel fest, aber das obere Steuerelement behält seinen ursprünglichen grünen inneren Rahmen.

Hinweise

Ein Webparts-Steuerelement kann einen eigenen Rahmen haben, der in der PartStyle Eigenschaft definiert ist. Die Zone, die das Steuerelement enthält, kann einen zusätzlichen äußeren Rahmen um das Steuerelement hinzufügen. Der äußere Rahmen, den eine Zone um die einzelnen Webparts Steuerelemente platzieren kann, wird durch die PartChromeStyle Eigenschaft bestimmt. Diese Eigenschaft bricht die im PartStyle Objekt enthaltenen Eigenschaftsattribute nicht ab. Sie wird mit diesen zusammengeführt oder hinzugefügt. Es ermöglicht eine Zone, einen gemeinsamen und konsistenten Rahmen für jede der Webparts Steuerelemente bereitzustellen, die sie enthält.

Wichtig

Obwohl die PartChromeStyle Formatvorlageneinstellungen hauptsächlich auf den äußeren Rahmen angewendet werden, den eine Zone um die enthaltenen Steuerelemente festlegen kann, wenn Sie zusätzliche Eigenschaften für das Objekt festlegen, auf das Style durch die Eigenschaft verwiesen wird, z BackColor. B. interpretiert der Browser diese Formatattribute so, dass sie auf alle Unterelemente der Tabelle angewendet werden, die zum Rendern einer Zone verwendet werden. Daher hat das Festlegen der BackColor Eigenschaft für das von der PartChromeStyle Eigenschaft referenzierte Formatobjekt dieselbe Auswirkung auf ein WebPart Steuerelement wie das Festlegen der BackColor Eigenschaft auf das Objekt, auf das durch die PartStyle Eigenschaft verwiesen wird.

Gilt für

Siehe auch