WebZone.PartChromeStyle Propriedade

  • Referência

Definição

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

Obtém as características de estilo que se aplicam às bordas dos controles de Web Parts contidos por uma zona.

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

Valor da propriedade

Style

Um Style que contém atributos de estilo para as bordas que envolvem controles de Web Parts contidos por uma zona.

Atributos
PersistenceModeAttribute

Exemplos

O exemplo de código a seguir demonstra o uso da PartChromeStyle propriedade para definir atributos de estilo para as bordas externas dos controles de Web Parts contidos em uma zona.

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

Observe que quando você carrega a página pela primeira vez em um navegador, o controle superior tem sua própria borda verde com uma largura de 2 pixels, conforme definido na marcação declarativa da página. Depois que um usuário clica no calendário, a página altera programaticamente as bordas de ambos os controles na zona para vermelho e define sua largura de borda como 4 pixels, mas o controle superior mantém sua borda interna verde original.

Comentários

Um controle de Web Parts pode ter sua própria borda, definida na PartStyle propriedade . A zona que contém o controle pode adicionar uma borda externa adicional ao redor do controle. A borda externa que uma zona pode colocar em torno de cada um de seus controles de Web Parts é determinada pela PartChromeStyle propriedade . Essa propriedade não cancela os atributos de propriedade contidos no PartStyle objeto; ela é mesclada ou adicionada a elas. Ele permite que uma zona forneça uma borda comum e consistente para cada um dos controles de Web Parts que ela contém.

Importante

Embora as PartChromeStyle configurações de estilo se apliquem principalmente à borda externa que uma zona pode definir em torno dos controles que ela contém, se você definir propriedades adicionais no Style objeto referenciado pela propriedade, como BackColor, o navegador interpretará esses atributos de estilo como aplicando a todos os subconjuntos da tabela usados para renderizar uma zona. Portanto, definir a BackColor propriedade para o objeto de estilo referenciado pela PartChromeStyle propriedade tem o mesmo efeito em um WebPart controle que definir a BackColor propriedade no objeto referenciado pela PartStyle propriedade .

Aplica-se a

Confira também