Freigeben über


TabRenderer.DrawTabItem Methode

Definition

Zeichnet eine Registerkarte, die zum Auswählen einer Seite im Registerkarten-Steuerelement verwendet wird.

Überlädt

DrawTabItem(Graphics, Rectangle, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen.

DrawTabItem(Graphics, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen sowie mit einem optionalen Fokusrechteck.

DrawTabItem(Graphics, Rectangle, String, Font, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen sowie mit dem angegebenen Text.

DrawTabItem(Graphics, Rectangle, Image, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Bild sowie mit einem optionalen Fokusrechteck.

DrawTabItem(Graphics, Rectangle, String, Font, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text sowie mit einem optionalen Fokusrechteck.

DrawTabItem(Graphics, Rectangle, String, Font, TextFormatFlags, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text und der angegebenen Textformatierung sowie mit einem optionalen Fokusrechteck.

DrawTabItem(Graphics, Rectangle, String, Font, Image, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text und Bild sowie mit einem optionalen Fokusrechteck.

DrawTabItem(Graphics, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text, der angegebenen Textformatierung, dem angegebenen Bild sowie mit einem optionalen Fokusrechteck.

DrawTabItem(Graphics, Rectangle, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für

DrawTabItem(Graphics, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, bool focused, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, focused As Boolean, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

focused
Boolean

true, um ein Fokusrechteck zu zeichnen, andernfalls false.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für

DrawTabItem(Graphics, Rectangle, String, Font, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen sowie mit dem angegebenen Text.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ tabItemText, System::Drawing::Font ^ font, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string tabItemText, System.Drawing.Font font, System.Windows.Forms.VisualStyles.TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? tabItemText, System.Drawing.Font? font, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, tabItemText As String, font As Font, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

tabItemText
String

Die String, die auf der Registerkarte gezeichnet werden soll.

font
Font

Der Font, der auf die tabItemText angewendet werden soll.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für

DrawTabItem(Graphics, Rectangle, Image, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Bild sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::Drawing::Image ^ image, System::Drawing::Rectangle imageRectangle, bool focused, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, System.Drawing.Image image, System.Drawing.Rectangle imageRectangle, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * System.Drawing.Image * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, image As Image, imageRectangle As Rectangle, focused As Boolean, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

image
Image

Die Image, die auf der Registerkarte gezeichnet werden soll.

imageRectangle
Rectangle

Das Rectangle, das die Begrenzungen des image angibt.

focused
Boolean

true, um ein Fokusrechteck zu zeichnen, andernfalls false.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für

DrawTabItem(Graphics, Rectangle, String, Font, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ tabItemText, System::Drawing::Font ^ font, bool focused, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string tabItemText, System.Drawing.Font font, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? tabItemText, System.Drawing.Font? font, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * bool * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, tabItemText As String, font As Font, focused As Boolean, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

tabItemText
String

Die String, die auf der Registerkarte gezeichnet werden soll.

font
Font

Der Font, der auf die tabItemText angewendet werden soll.

focused
Boolean

true, um ein Fokusrechteck zu zeichnen, andernfalls false.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Beispiele

Im folgenden Codebeispiel wird die Methode in der DrawTabItem(Graphics, Rectangle, String, Font, Boolean, TabItemState) Methode eines benutzerdefinierten Steuerelements OnPaint verwendet, um ein Registerkartenelement zu zeichnen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TabRenderer Klasse bereitgestellt wird.

    // 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";
    }
// 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";
}
' Draw the tab page and the tab items.
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
    MyBase.OnPaint(e)

    If Not TabRenderer.IsSupported Then
        Me.Parent.Text = "CustomTabControl Disabled"
        Return
    End If

    TabRenderer.DrawTabPage(e.Graphics, tabPageRectangle)
    TabRenderer.DrawTabItem(e.Graphics, tabItemRectangle1, _
        tab1Text, Me.Font, tab1Focused, tab1State)
    TabRenderer.DrawTabItem(e.Graphics, tabItemRectangle2, _
        tab2Text, Me.Font, tab2Focused, tab2State)
    Me.Parent.Text = "CustomTabControl Enabled"
End Sub

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für

DrawTabItem(Graphics, Rectangle, String, Font, TextFormatFlags, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text und der angegebenen Textformatierung sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ tabItemText, System::Drawing::Font ^ font, System::Windows::Forms::TextFormatFlags flags, bool focused, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string tabItemText, System.Drawing.Font font, System.Windows.Forms.TextFormatFlags flags, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? tabItemText, System.Drawing.Font? font, System.Windows.Forms.TextFormatFlags flags, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * System.Windows.Forms.TextFormatFlags * bool * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, tabItemText As String, font As Font, flags As TextFormatFlags, focused As Boolean, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

tabItemText
String

Die String, die auf der Registerkarte gezeichnet werden soll.

font
Font

Der Font, der auf die tabItemText angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

focused
Boolean

true, um ein Fokusrechteck zu zeichnen, andernfalls false.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für

DrawTabItem(Graphics, Rectangle, String, Font, Image, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text und Bild sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ tabItemText, System::Drawing::Font ^ font, System::Drawing::Image ^ image, System::Drawing::Rectangle imageRectangle, bool focused, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string tabItemText, System.Drawing.Font font, System.Drawing.Image image, System.Drawing.Rectangle imageRectangle, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? tabItemText, System.Drawing.Font? font, System.Drawing.Image image, System.Drawing.Rectangle imageRectangle, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * System.Drawing.Image * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, tabItemText As String, font As Font, image As Image, imageRectangle As Rectangle, focused As Boolean, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

tabItemText
String

Die String, die auf der Registerkarte gezeichnet werden soll.

font
Font

Der Font, der auf die tabItemText angewendet werden soll.

image
Image

Die Image, die auf der Registerkarte gezeichnet werden soll.

imageRectangle
Rectangle

Das Rectangle, das die Begrenzungen des image angibt.

focused
Boolean

true, um ein Fokusrechteck zu zeichnen, andernfalls false.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für

DrawTabItem(Graphics, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, TabItemState)

Zeichnet eine Registerkarte im angegebenen Zustand und mit den angegebenen Begrenzungen, dem angegebenen Text, der angegebenen Textformatierung, dem angegebenen Bild sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawTabItem(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ tabItemText, System::Drawing::Font ^ font, System::Windows::Forms::TextFormatFlags flags, System::Drawing::Image ^ image, System::Drawing::Rectangle imageRectangle, bool focused, System::Windows::Forms::VisualStyles::TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string tabItemText, System.Drawing.Font font, System.Windows.Forms.TextFormatFlags flags, System.Drawing.Image image, System.Drawing.Rectangle imageRectangle, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
public static void DrawTabItem (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? tabItemText, System.Drawing.Font? font, System.Windows.Forms.TextFormatFlags flags, System.Drawing.Image image, System.Drawing.Rectangle imageRectangle, bool focused, System.Windows.Forms.VisualStyles.TabItemState state);
static member DrawTabItem : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * System.Windows.Forms.TextFormatFlags * System.Drawing.Image * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.TabItemState -> unit
Public Shared Sub DrawTabItem (g As Graphics, bounds As Rectangle, tabItemText As String, font As Font, flags As TextFormatFlags, image As Image, imageRectangle As Rectangle, focused As Boolean, state As TabItemState)

Parameter

g
Graphics

Die zum Zeichnen der Registerkarte verwendete Graphics-Klasse.

bounds
Rectangle

Das Rectangle, das die Begrenzungen der Registerkarte angibt.

tabItemText
String

Die String, die auf der Registerkarte gezeichnet werden soll.

font
Font

Der Font, der auf die tabItemText angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

image
Image

Die Image, die auf der Registerkarte gezeichnet werden soll.

imageRectangle
Rectangle

Das Rectangle, das die Begrenzungen des image angibt.

focused
Boolean

true, um ein Fokusrechteck zu zeichnen, andernfalls false.

state
TabItemState

Einer der TabItemState-Werte, der den visuellen Zustand der Registerkarte angibt.

Ausnahmen

Das Betriebssystem unterstützt keine visuellen Stile.

- oder -

Visuelle Stile wurden durch den Benutzer im Betriebssystem deaktiviert.

- oder -

Visuelle Stile werden nicht auf den Clientbereich der Anwendungsfenster angewendet.

Hinweise

Bevor Sie diese Methode aufrufen, sollten Sie überprüfen, ob die IsSupported Eigenschaft zurückgegeben wird true.

Gilt für