TabRenderer.DrawTabItem Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
.