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.
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.
| Exception | Condition |
|---|---|
| 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:
virtual void OnPaint(PaintEventArgs^ e) override
{
__super::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";
}
Available since 2.0