WebZone.PartChromeStyle Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um Style que contém atributos de estilo para as bordas que envolvem controles de Web Parts contidos por uma zona.
- Atributos
Exemplos
O exemplo de código a seguir demonstra o uso da propriedade para definir atributos de PartChromeStyle 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 eles. 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 subelementos 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 .