WebZone.PartChromeStyle Eigenschaft

Definition

Ruft Stileigenschaften ab, die auf die Rahmen der in einer Zone enthaltenen Webparts-Steuerelemente angewendet werden.Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

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; }
member this.PartChromeStyle : System.Web.UI.WebControls.Style
Public ReadOnly Property PartChromeStyle As Style

Eigenschaftswert

Ein Style mit Stilattributen für die Rahmen, mit denen die in einer Zone enthaltenen Webparts-Steuerelemente eingefasst werden.A Style that contains style attributes for the borders that surround Web Parts controls contained by a zone.

Attribute

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der PartChromeStyle-Eigenschaft, um Stil Attribute für die äußeren Rahmen Webparts Steuerelemente festzulegen, die in einer-Zone enthalten sind.The following code example demonstrates the use of the PartChromeStyle property to set style attributes for the outer borders of Web Parts controls contained in a zone.

<%@ 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 hat, wie im deklarativen Markup für die Seite festgelegt.Note that when you first load the page in a browser, the upper control has its own green border with a width of 2 pixels, as set in the declarative markup for the page. Nachdem ein Benutzer auf den Kalender geklickt hat, ändert die Seite Programm gesteuert die Rahmen beider Steuerelemente in der Zone in rot und legt die Rahmenbreite auf 4 Pixel fest, aber das obere Steuerelement behält seinen ursprünglichen grünen inneren Rahmen bei.After a user clicks the calendar, the page programmatically changes the borders of both controls in the zone to red, and sets their border width to 4 pixels, yet the upper control retains its original green inner border.

Hinweise

Ein Webparts Steuerelement kann über einen eigenen Rahmen verfügen, der in der PartStyle-Eigenschaft definiert ist.A Web Parts control can have its own border, defined in the PartStyle property. Die Zone, die das Steuerelement enthält, kann einen zusätzlichen äußeren Rahmen um das Steuerelement hinzufügen.The zone that contains the control can add an additional outer border around the control. Der äußere Rahmen, den eine Zone um die einzelnen Webparts Steuerelemente herum platzieren kann, wird durch die PartChromeStyle-Eigenschaft bestimmt.The outer border that a zone can place around each of its Web Parts controls is determined by the PartChromeStyle property. Mit dieser Eigenschaft werden die Eigenschafts Attribute, die im PartStyle Objekt enthalten sind, nicht abgebrochen. Es wird zusammengeführt oder zu diesen hinzugefügt.This property does not cancel out the property attributes contained in the PartStyle object; it is merged with or added to them. Dadurch kann eine Zone einen gemeinsamen und konsistenten Rahmen für jede der Webparts darin enthaltenen Steuerelemente bereitstellen.It enables a zone to provide a common and consistent border for each of the Web Parts controls it contains.

Wichtig

Obwohl die PartChromeStyle Stileinstellungen hauptsächlich auf den äußeren Rahmen zutreffen, den eine Zone um die darin enthaltenen Steuerelemente festlegen kann, wenn Sie zusätzliche Eigenschaften für das Style Objekt festlegen, auf das von der-Eigenschaft verwiesen wird, z. b. BackColor, interpretiert der Browser diese Stil Attribute als Anwendung auf alle untergeordneten Elemente der Tabelle, die zum Renderingvorgang verwendet wird.Although the PartChromeStyle style settings apply primarily to the outer border that a zone can set around the controls it contains, if you set additional properties on the Style object referenced by the property, such as BackColor, the browser interprets those style attributes as applying to all the sub-elements of the table used to render a zone. Daher hat das Festlegen der BackColor-Eigenschaft für das Style-Objekt, auf das die PartChromeStyle-Eigenschaft verweist, dieselbe Auswirkung auf ein WebPart-Steuerelement wie das Festlegen der BackColor-Eigenschaft für das Objekt, auf das die PartStyle-Eigenschaft verweist.Hence, setting the BackColor property for the style object referenced by the PartChromeStyle property has the same effect on a WebPart control as setting the BackColor property on the object referenced by the PartStyle property.

Gilt für:

Siehe auch