Export (0) Print
Expand All

TabRenderer.DrawTabItem Method (Graphics, Rectangle, String, Font, Boolean, TabItemState)

Draws a tab in the specified state and bounds, with the specified text, and with an optional focus rectangle.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public static void DrawTabItem(
	Graphics g,
	Rectangle bounds,
	string tabItemText,
	Font font,
	bool focused,
	TabItemState state
)

Parameters

g
Type: System.Drawing.Graphics

The Graphics used to draw the tab.

bounds
Type: System.Drawing.Rectangle

The Rectangle that specifies the bounds of the tab.

tabItemText
Type: System.String

The String to draw in the tab.

font
Type: System.Drawing.Font

The Font to apply to tabItemText.

focused
Type: System.Boolean

true to draw a focus rectangle; otherwise, false.

state
Type: System.Windows.Forms.VisualStyles.TabItemState

One of the TabItemState values that specifies the visual state of the tab.

ExceptionCondition
InvalidOperationException

The operating system does not support visual styles.

-or-

Visual styles are disabled by the user in the operating system.

-or-

Visual styles are not applied to the client area of application windows.

Before calling this method, you should verify that the IsSupported property returns true.

The following code example uses the DrawTabItem(Graphics, Rectangle, String, Font, Boolean, TabItemState) method in a custom control's OnPaint method to draw a tab item. This code example is part of a larger example provided for the TabRenderer class.

// Draw the tab page and the tab items. 
protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);

    if (!TabRenderer.IsSupported)
    {
        this.Parent.Text = "CustomTabControl Disabled";
        return;
    }

    TabRenderer.DrawTabPage(e.Graphics, tabPageRectangle);
    TabRenderer.DrawTabItem(e.Graphics, tabItemRectangle1,
        tab1Text, this.Font, tab1Focused, tab1State);
    TabRenderer.DrawTabItem(e.Graphics, tabItemRectangle2,
        tab2Text, this.Font, tab2Focused, tab2State);

    this.Parent.Text = "CustomTabControl Enabled";
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft