WebZone.PartChromeStyle Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает характеристики стиля, применяемые к границам элементов управления веб-частей, содержащихся в зоне.
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
Значение свойства
Объект, Style содержащий атрибуты стиля для границ, которые окружают элементы управления веб-частей, содержащиеся в зоне.
- Атрибуты
Примеры
В следующем примере кода показано использование PartChromeStyle свойства для задания атрибутов стиля для внешних границ элементов управления веб-частей, содержащихся в зоне.
<%@ 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>
Обратите внимание, что при первой загрузке страницы в браузере верхний элемент управления имеет собственную зеленую границу с шириной 2 пикселя, как указано в декларативной разметке страницы. Когда пользователь щелкает календарь, страница программно изменяет границы обоих элементов управления в зоне на красный и задает ширину границы на 4 пикселя, но верхний элемент управления сохраняет исходную зеленую внутреннюю границу.
Комментарии
Элемент управления веб-частей может иметь собственную границу, определенную в свойстве PartStyle . Зона, содержащая элемент управления, может добавить дополнительную внешнюю границу вокруг элемента управления. Внешняя граница, которую зона может размещать вокруг каждого из элементов управления веб-частей, определяется свойством PartChromeStyle . Это свойство не отменяет атрибуты свойства, содержащиеся в объекте PartStyle ; он объединяется с ними или добавляется к ним. Она позволяет зоне предоставлять общую и согласованную границу для каждого элемента управления веб-частей, содержащихся в ней.
Это важно
PartChromeStyle Хотя параметры стиля применяются главным образом к внешней границе, которую зона может задать вокруг элементов управления, содержащихся в ней, если задать дополнительные свойства Style объекта, на который ссылается свойство, напримерBackColor, браузер интерпретирует эти атрибуты стиля как применение ко всем вложенным элементам таблицы, используемой для отрисовки зоны. Таким образом, установка свойства для объекта стиля, на который PartChromeStyle ссылается свойство, имеет то же влияние на WebPart элемент управления, что и установка BackColorBackColor свойства для объекта, на который PartStyle ссылается свойство.