WebZone.PartChromeStyle Eigenschaft

Referenz

Definition

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

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Das folgende Codebeispiel veranschaulicht die Verwendung der PartChromeStyle -Eigenschaft zum Festlegen von Stilattributen für die äußeren Rahmen von Webparts-Steuerelementen, die in einer Zone enthalten sind.

<%@ 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 das obere Steuerelement beim ersten Laden der Seite in einem Browser über einen eigenen grünen Rahmen mit einer Breite von 2 Pixeln verfügt, wie im deklarativen Markup für die Seite festgelegt. Nachdem ein Benutzer auf den Kalender geklickt hat, ändert die Seite programmgesteuert die Ränder beider Steuerelemente in der Zone in Rot und legt deren Rahmenbreite auf 4 Pixel fest, aber das obere Steuerelement behält seinen ursprünglichen grünen inneren Rahmen bei.

Hinweise

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

Wichtig

Obwohl die PartChromeStyle Stileinstellungen in erster Linie auf den äußeren Rahmen angewendet werden, den eine Zone um die enthaltenen Steuerelemente herum festlegen kann, interpretiert der Browser diese Stilattribute, wenn Sie zusätzliche Eigenschaften für das Objekt festlegen, auf das Style von der -Eigenschaft verwiesen wird, z BackColor. B. , so interpretiert der Browser diese Stilattribute 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 Stilobjekt, auf das von der PartChromeStyle -Eigenschaft verwiesen wird, die gleiche Auswirkung auf ein WebPart Steuerelement wie das Festlegen der BackColor -Eigenschaft für das Objekt, auf das von der PartStyle -Eigenschaft verwiesen wird.

Gilt für:

Freigeben über