WebPartChrome.CreateWebPartChromeStyle(WebPart, PartChromeType) 方法

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

创建样式对象，该对象为 WebPart 对象呈现的每个 WebPartChrome 控件提供样式特性。

protected:
 virtual System::Web::UI::WebControls::Style ^ CreateWebPartChromeStyle(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Web::UI::WebControls::WebParts::PartChromeType chromeType);
protected virtual System.Web.UI.WebControls.Style CreateWebPartChromeStyle (System.Web.UI.WebControls.WebParts.WebPart webPart, System.Web.UI.WebControls.WebParts.PartChromeType chromeType);
abstract member CreateWebPartChromeStyle : System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.PartChromeType -> System.Web.UI.WebControls.Style
override this.CreateWebPartChromeStyle : System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.PartChromeType -> System.Web.UI.WebControls.Style
Protected Overridable Function CreateWebPartChromeStyle (webPart As WebPart, chromeType As PartChromeType) As Style

参数

webPart
WebPart

当前正在呈现的控件。

chromeType
PartChromeType

特定控件的 chrome 类型；PartChromeType 枚举值之一。

返回

Style

包含 webPart 的样式特性的 Style。

例外

ArgumentNullException

webPart 为 null。

ArgumentOutOfRangeException

chromeType 不是 PartChromeType 枚举值之一。

示例

此代码示例演示如何使用 CreateWebPartChromeStyle 方法。 有关运行示例所需的完整代码，请参阅类概述主题的示例 WebPartChrome 部分。

代码示例中的以下部分演示如何重写 CreateWebPartChromeStyle 方法。 请注意，它首先检索基方法创建的样式信息，然后通过更改用于正在呈现的控件的 WebPart 字体来修改样式信息。

protected override Style CreateWebPartChromeStyle(WebPart part, 
  PartChromeType chromeType)
{
  Style finalStyle = new Style();
  finalStyle.CopyFrom(base.CreateWebPartChromeStyle(part, chromeType));
  finalStyle.Font.Name = "Verdana";
  return finalStyle;
}

Protected Overrides Function CreateWebPartChromeStyle _
  (ByVal part As WebPart, ByVal chromeType As PartChromeType) As Style

  Dim finalStyle As New Style()
  finalStyle.CopyFrom(MyBase.CreateWebPartChromeStyle(Part, chromeType))
  finalStyle.Font.Name = "Verdana"
  Return finalStyle
End Function

如果在浏览器中加载网页，可以看到控件中使用的 WebPart 字体是在重写 CreateWebPartChromeStyle 方法中指定的字体。

注解

方法 CreateWebPartChromeStyle 创建一个 Style 对象，该对象使用该 WebPartChrome 对象来呈现 WebPart 控件。 默认方法基于 PartChromeType 参数中引用的控件的 WebPart 属性值创建样式特性 webPart 。

选择控件时 WebPart 会出现特殊情况。 如果页面处于可以选择控件的页面显示模式，并且实际选择了当前控件，则默认 CreateWebPartChromeStyle 方法还会将控件的样式信息与 属性中的样式信息 SelectedPartChromeStyle 合并。

继承者说明

如果继承自 WebPartChrome 类，可以选择重写 CreateWebPartChromeStyle(WebPart, PartChromeType) 方法，并将基方法中的样式信息与要添加的自定义样式属性合并。 有关演示，请参阅示例部分中的代码。

适用于

另请参阅