A newer version of this page is available. Switch to the current version.

XtraTabControl.CustomDrawTabHeader Event

Allows you to custom paint tabs.

Namespace: DevExpress.XtraTab

Assembly: DevExpress.XtraEditors.v19.1.dll

Declaration

[DXCategory("Appearance")]
public event TabHeaderCustomDrawEventHandler CustomDrawTabHeader

Event Data

The CustomDrawTabHeader event's data class is DevExpress.XtraTab.TabHeaderCustomDrawEventArgs.

Remarks

The CustomDrawTabHeader event fires repeatedly for each tab. You can identify the currently processed tab from the event’s TabHeaderInfo parameter. To paint custom information, use the methods provided by the Cache or Graphics event parameter.

When you handle the CustomDrawTabHeader event, you can invoke the default rendering of the current tab or its individual elements with the following methods:

  • DefaultDraw - Performs the default rendering of the tab (including all its elements)
  • DefaultDrawBackground - Performs the default rendering of the tab’s background.
  • DefaultDrawButtons - Performs the default rendering of the tab’s close button.
  • DefaultDrawImage - Performs the default rendering of the tab’s image ( XtraTabPage.ImageOptions)
  • DefaultDrawText - Performs the default rendering of the tab’s text (XtraTabPage.Text).

Set the Handled event parameter to true to indicate that you have handled the CustomDrawTabHeader event and no default painting is required after your event handler is completed. If the event’s Handled parameter is set to false (the default value), the default painting mechanism will automatically be invoked after your custom draw event handler is completed. The default painting mechanism overrides all rendering you may have performed previously.

See Also