WebPartChrome::CreateWebPartChromeStyle Method
Creates the style object that supplies style attributes for each WebPart control rendered by the WebPartChrome object.
Assembly: System.Web (in System.Web.dll)
protected: virtual Style^ CreateWebPartChromeStyle( WebPart^ webPart, PartChromeType chromeType )
Parameters
- webPart
- Type: System.Web.UI.WebControls.WebParts::WebPart
The control that is currently being rendered.
- chromeType
- Type: System.Web.UI.WebControls.WebParts::PartChromeType
The type of chrome for a particular control; one of the PartChromeType enumeration values.
Return Value
Type: System.Web.UI.WebControls::StyleA Style that contains style attributes for the webPart.
| Exception | Condition |
|---|---|
| ArgumentNullException | webPart is nullptr. |
| ArgumentOutOfRangeException | chromeType is not one of the PartChromeType enumeration values. |
The CreateWebPartChromeStyle method creates a Style object that is used by the WebPartChrome object to render a WebPart control. The default method creates style attributes based on the PartChromeType property value of the WebPart control referenced in the webPart parameter.
A special situation occurs when a WebPart control is selected. If the page is in a page display mode where controls can be selected, and the current control is actually selected, the default CreateWebPartChromeStyle method also merges the style information of the control with the style information from the SelectedPartChromeStyle property.
Notes to Inheritors:If you inherit from the WebPartChrome class, you can optionally override the CreateWebPartChromeStyle method, and merge the style information from the base method with custom style attributes that you want to add. For a demonstration, see the code in the Example section.
This code example demonstrates use of the CreateWebPartChromeStyle method. For the full code required to run the example, see the Example section of the WebPartChrome class overview topic.
The following section from the code example demonstrates how to override the CreateWebPartChromeStyle method. Notice that it first retrieves the style information created by the base method, and then modifies the style information by changing the font used for the WebPart control being rendered.
If you load the Web page in a browser, you can see that the font used in the WebPart controls is the one specified in the overridden CreateWebPartChromeStyle method.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.