WebZone.PartChromeStyle Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Obtém características de estilo que se aplicam às fronteiras dos controlos Web Parts contidas 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 de Propriedade

Style

A Style que contém atributos de estilo para as bordas que rodeiam os controlos Web Parts contidos por uma zona.

Atributos
PersistenceModeAttribute

Exemplos

O exemplo de código seguinte demonstra a utilização da PartChromeStyle propriedade para definir atributos de estilo para as bordas exteriores dos controlos Web Parts contidos numa 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>

Note que, quando carrega a página pela primeira vez num navegador, o controlo superior tem a sua própria borda verde com uma largura de 2 píxeis, conforme definido na marcação declarativa da página. Depois de o utilizador clicar no calendário, a página altera programaticamente as bordas de ambos os controlos da zona para vermelho e define a largura da borda para 4 píxeis, mas o controlo superior mantém a sua borda interior verde original.

Observações

Um controlo de Web Parts pode ter a sua própria borda, definida na PartStyle propriedade. A zona que contém o controlo pode adicionar uma fronteira exterior adicional em redor do controlo. A fronteira exterior que uma zona pode colocar em torno de cada um dos seus controlos de Web Parts é determinada pela propriedade PartChromeStyle . Esta propriedade não anula os atributos contidos no PartStyle objeto; é fundida ou adicionada a eles. Permite que uma zona forneça uma fronteira comum e consistente para cada um dos controlos Web Parts que contém.

Importante

Embora as PartChromeStyle definições de estilo se apliquem principalmente à borda exterior que uma zona pode definir em torno dos controlos que contém, se definir propriedades adicionais no Style objeto referenciado pela propriedade, como BackColor, o navegador interpreta esses atributos de estilo como aplicando-se a todos os subelementos da tabela usada para renderizar uma zona. Assim, definir a BackColor propriedade para o objeto estilo referenciado pela PartChromeStyle propriedade tem o mesmo efeito num WebPart controlo que definir a BackColor propriedade no objeto referenciado pela PartStyle propriedade.

Aplica-se a

Ver também