WebPartZoneBase.CreateWebPartChrome Method

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Enables derived zones to substitute a custom WebPartChrome object to change the appearance of WebPart controls in a zone.

C#

protected virtual System.Web.UI.WebControls.WebParts.WebPartChrome CreateWebPartChrome();

Returns

WebPartChrome

A WebPartChrome that determines how WebPart controls in a zone are rendered.

Remarks

Web Parts chrome refers to the peripheral user interface (UI) elements that frame each WebPart control in a zone. The chrome for a WebPart control includes its border, its title bar, and the icons, title text, and verbs menu that appear within the title bar. The appearance of the chrome is set at the zone level, and applies to all WebPart controls in a zone.

Important

The WebPartChrome object affects the entire rendering of the WebPart controls, not merely their chrome elements.

To use the CreateWebPartChrome method, you must create a custom WebPartChrome object to define the appearance of the chrome for Web Parts controls in a zone. You must also create a custom zone that inherits from the WebPartZoneBase class and overrides the CreateWebPartChrome method to be able to substitute your custom chrome object and apply it to the controls in the zone.

Applies to

See also

• WebPartChrome
• ASP.NET Web Parts Controls