ButtonRenderer.DrawButton Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 ein Schaltflächen-Steuerelement.

Überlädt

DrawButton(Graphics, Rectangle, PushButtonState)	Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen.
DrawButton(Graphics, Rectangle, Boolean, PushButtonState)	Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen sowie mit einem optionalen Fokusrechteck.
DrawButton(Graphics, Rectangle, Image, Rectangle, Boolean, PushButtonState)	Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Bild sowie mit einem optionalen Fokusrechteck.
DrawButton(Graphics, Rectangle, String, Font, Boolean, PushButtonState)	Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Text sowie mit einem optionalen Fokusrechteck.
DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Boolean, PushButtonState)	Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Text und der angegebenen Textformatierung sowie mit einem optionalen Fokusrechteck.
DrawButton(Graphics, Rectangle, String, Font, Image, Rectangle, Boolean, PushButtonState)	Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Text und Bild sowie mit einem optionalen Fokusrechteck.
DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, PushButtonState)	Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen sowie mit dem angegebenen Text, der angegebenen Textformatierung, dem angegebenen Bild und mit einem optionalen Fokusrechteck.

DrawButton(Graphics, Rectangle, PushButtonState)

Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen.

public:
 static void DrawButton(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::Windows::Forms::VisualStyles::PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, System.Windows.Forms.VisualStyles.PushButtonState state);

static member DrawButton : System.Drawing.Graphics * System.Drawing.Rectangle * System.Windows.Forms.VisualStyles.PushButtonState -> unit

Public Shared Sub DrawButton (g As Graphics, bounds As Rectangle, state As PushButtonState)

Parameter

g: Graphics

Die zum Zeichnen der Schaltfläche verwendete Graphics.

bounds: Rectangle

Das Rectangle, das die Begrenzungen der Schaltfläche angibt.

state: PushButtonState

Einer der PushButtonState-Werte, der den visuellen Zustand der Schaltfläche angibt.

Hinweise

Wenn visuelle Stile im Betriebssystem aktiviert sind und visuelle Stile auf die aktuelle Anwendung angewendet werden, zeichnet diese Methode die Schaltfläche mit dem aktuellen visuellen Stil. Andernfalls wird die Schaltfläche im klassischen Windows-Stil gezeichnet.

Gilt für:

DrawButton(Graphics, Rectangle, Boolean, PushButtonState)

Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawButton(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, bool focused, System::Windows::Forms::VisualStyles::PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

static member DrawButton : System.Drawing.Graphics * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.PushButtonState -> unit

Public Shared Sub DrawButton (g As Graphics, bounds As Rectangle, focused As Boolean, state As PushButtonState)

Parameter

g: Graphics

Die zum Zeichnen der Schaltfläche verwendete Graphics.

bounds: Rectangle

Das Rectangle, das die Begrenzungen der Schaltfläche angibt.

focused: Boolean

true, um ein Fokusrechteck auf der Schaltfläche zu zeichnen, andernfalls false.

state: PushButtonState

Einer der PushButtonState-Werte, der den visuellen Zustand der Schaltfläche angibt.

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, Image, Rectangle, Boolean, PushButtonState)

Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Bild sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawButton(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::Drawing::Image ^ image, System::Drawing::Rectangle imageBounds, bool focused, System::Windows::Forms::VisualStyles::PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

static member DrawButton : System.Drawing.Graphics * System.Drawing.Rectangle * System.Drawing.Image * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.PushButtonState -> unit

Public Shared Sub DrawButton (g As Graphics, bounds As Rectangle, image As Image, imageBounds As Rectangle, focused As Boolean, state As PushButtonState)

Parameter

g: Graphics

Die zum Zeichnen der Schaltfläche verwendete Graphics.

bounds: Rectangle

Das Rectangle, das die Begrenzungen der Schaltfläche angibt.

image: Image

Das Image, das auf der Schaltfläche gezeichnet werden soll.

imageBounds: Rectangle

Das Rectangle, das die Dimensionen von image darstellt.

focused: Boolean

true, um ein Fokusrechteck auf der Schaltfläche zu zeichnen, andernfalls false.

state: PushButtonState

Einer der PushButtonState-Werte, der den visuellen Zustand der Schaltfläche angibt.

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, Boolean, PushButtonState)

Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Text sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawButton(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ buttonText, System::Drawing::Font ^ font, bool focused, System::Windows::Forms::VisualStyles::PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string buttonText, System.Drawing.Font font, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? buttonText, System.Drawing.Font? font, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

static member DrawButton : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * bool * System.Windows.Forms.VisualStyles.PushButtonState -> unit

Public Shared Sub DrawButton (g As Graphics, bounds As Rectangle, buttonText As String, font As Font, focused As Boolean, state As PushButtonState)

Parameter

g: Graphics

Die zum Zeichnen der Schaltfläche verwendete Graphics.

bounds: Rectangle

Das Rectangle, das die Begrenzungen der Schaltfläche angibt.

buttonText: String

Das String, das auf der Schaltfläche gezeichnet werden soll.

font: Font

Der Font, der auf die buttonText angewendet werden soll.

focused: Boolean

true, um ein Fokusrechteck auf der Schaltfläche zu zeichnen, andernfalls false.

state: PushButtonState

Einer der PushButtonState-Werte, der den visuellen Zustand der Schaltfläche angibt.

Beispiele

Im folgenden Codebeispiel wird die -Methode in der DrawButton(Graphics, Rectangle, String, Font, Boolean, PushButtonState) Methode eines benutzerdefinierten Steuerelements OnPaint verwendet, um eine Schaltfläche in dem Zustand zu zeichnen, der durch die Position des Mauszeigers bestimmt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ButtonRenderer-Klasse bereitgestellt wird.

    // Draw the large or small button, depending on the current state.
protected:
    virtual void OnPaint(PaintEventArgs^ e) override
    {
        __super::OnPaint(e);

        // Draw the smaller pressed button image
        if (state == PushButtonState::Pressed)
        {
            // Set the background color to the parent if visual styles
            // are disabled, because DrawParentBackground will only paint
            // over the control background if visual styles are enabled.
            if (Application::RenderWithVisualStyles)
            {
                this->BackColor = Color::Azure;
            }
            else
            {
                this->BackColor = this->Parent->BackColor;
            }


            // If you comment out the call to DrawParentBackground,
            // the background of the control will still be visible
            // outside the pressed button, if visual styles are enabled.
            ButtonRenderer::DrawParentBackground(e->Graphics,
                ClientRectangle, this);
            ButtonRenderer::DrawButton(e->Graphics, ClickRectangle,
                this->Text, this->Font, true, state);
        }

        // Draw the bigger unpressed button image.
        else
        {
            ButtonRenderer::DrawButton(e->Graphics, ClientRectangle,
                this->Text, this->Font, false, state);
        }
    }

    // Draw the smaller pressed button image.
protected:
    virtual void OnMouseDown(MouseEventArgs^ e) override
    {
        __super::OnMouseDown(e);
        this->Text = "Clicked!";
        state = PushButtonState::Pressed;
        Invalidate();
    }

    // Draw the button in the hot state.
protected:
    virtual void OnMouseEnter(EventArgs^ e) override
    {
        __super::OnMouseEnter(e);
        this->Text = "Click here";
        state = PushButtonState::Hot;
        Invalidate();
    }

    // Draw the button in the unpressed state.
protected:
    virtual void OnMouseLeave(EventArgs^ e) override
    {
        __super::OnMouseLeave(e);
        this->Text = "Click here";
        state = PushButtonState::Normal;
        Invalidate();
    }

// Draw the large or small button, depending on the current state.
protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);

    // Draw the smaller pressed button image
    if (state == PushButtonState.Pressed)
    {
        // Set the background color to the parent if visual styles  
        // are disabled, because DrawParentBackground will only paint  
        // over the control background if visual styles are enabled.
        this.BackColor = Application.RenderWithVisualStyles ?
            Color.Azure : this.Parent.BackColor;

        // If you comment out the call to DrawParentBackground, 
        // the background of the control will still be visible 
        // outside the pressed button, if visual styles are enabled.
        ButtonRenderer.DrawParentBackground(e.Graphics,
            ClientRectangle, this);
        ButtonRenderer.DrawButton(e.Graphics, ClickRectangle,
            this.Text, this.Font, true, state);
    }

    // Draw the bigger unpressed button image.
    else
    {
        ButtonRenderer.DrawButton(e.Graphics, ClientRectangle,
            this.Text, this.Font, false, state);
    }
}

// Draw the smaller pressed button image.
protected override void OnMouseDown(MouseEventArgs e)
{
    base.OnMouseDown(e);
    this.Text = "Clicked!";
    state = PushButtonState.Pressed;
    Invalidate();
}

// Draw the button in the hot state. 
protected override void OnMouseEnter(EventArgs e)
{
    base.OnMouseEnter(e);
    this.Text = "Click here";
    state = PushButtonState.Hot;
    Invalidate();
}

// Draw the button in the unpressed state.
protected override void OnMouseLeave(EventArgs e)
{
    base.OnMouseLeave(e);
    this.Text = "Click here";
    state = PushButtonState.Normal;
    Invalidate();
}

' Draw the large or small button, depending on the current state.
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
    MyBase.OnPaint(e)

    ' Draw the smaller pressed button image.
    If state = PushButtonState.Pressed Then
        ' Set the background color to the parent if visual styles  
        ' are disabled, because DrawParentBackground will only paint  
        ' over the control background if visual styles are enabled.
        If Application.RenderWithVisualStyles Then
            Me.BackColor = Color.Azure
        Else
            Me.BackColor = Me.Parent.BackColor
        End If

        ' If you comment out the call to DrawParentBackground,   
        ' the background of the control will still be visible 
        ' outside the pressed button, if visual styles are enabled.
        ButtonRenderer.DrawParentBackground(e.Graphics, _
            Me.ClientRectangle, Me)
        ButtonRenderer.DrawButton(e.Graphics, ClickRectangle, _
            Me.Text, Me.Font, True, state)

    ' Draw the bigger unpressed button image.
    Else
        ButtonRenderer.DrawButton(e.Graphics, Me.ClientRectangle, _
            Me.Text, Me.Font, False, state)
    End If
End Sub

' Draw the smaller pressed button image.
Protected Overrides Sub OnMouseDown(ByVal e As MouseEventArgs)
    MyBase.OnMouseDown(e)
    With Me
        .Text = "Clicked!"
        .state = PushButtonState.Pressed
    End With
    Invalidate()
End Sub

' Draw the button in the hot state. 
Protected Overrides Sub OnMouseEnter(ByVal e As EventArgs)
    MyBase.OnMouseEnter(e)
    With Me
        .Text = "Click here"
        .state = PushButtonState.Hot
    End With
    Invalidate()
End Sub

' Draw the button in the unpressed state.
Protected Overrides Sub OnMouseLeave(ByVal e As EventArgs)
    MyBase.OnMouseLeave(e)
    With Me
        .Text = "Click here"
        .state = PushButtonState.Normal
    End With
    Invalidate()
End Sub

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Boolean, PushButtonState)

Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Text und der angegebenen Textformatierung sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawButton(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ buttonText, System::Drawing::Font ^ font, System::Windows::Forms::TextFormatFlags flags, bool focused, System::Windows::Forms::VisualStyles::PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string buttonText, System.Drawing.Font font, System.Windows.Forms.TextFormatFlags flags, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? buttonText, System.Drawing.Font? font, System.Windows.Forms.TextFormatFlags flags, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

static member DrawButton : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * System.Windows.Forms.TextFormatFlags * bool * System.Windows.Forms.VisualStyles.PushButtonState -> unit

Public Shared Sub DrawButton (g As Graphics, bounds As Rectangle, buttonText As String, font As Font, flags As TextFormatFlags, focused As Boolean, state As PushButtonState)

Parameter

g: Graphics

Die zum Zeichnen der Schaltfläche verwendete Graphics.

bounds: Rectangle

Das Rectangle, das die Begrenzungen der Schaltfläche angibt.

buttonText: String

Das String, das auf der Schaltfläche gezeichnet werden soll.

font: Font

Der Font, der auf die buttonText angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte, die auf buttonText angewendet werden sollen.

focused: Boolean

true, um ein Fokusrechteck auf der Schaltfläche zu zeichnen, andernfalls false.

state: PushButtonState

Einer der PushButtonState-Werte, der den visuellen Zustand der Schaltfläche angibt.

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, Image, Rectangle, Boolean, PushButtonState)

Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen, mit dem angegebenen Text und Bild sowie mit einem optionalen Fokusrechteck.

public:
 static void DrawButton(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ buttonText, System::Drawing::Font ^ font, System::Drawing::Image ^ image, System::Drawing::Rectangle imageBounds, bool focused, System::Windows::Forms::VisualStyles::PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string buttonText, System.Drawing.Font font, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? buttonText, System.Drawing.Font? font, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

static member DrawButton : System.Drawing.Graphics * System.Drawing.Rectangle * string * System.Drawing.Font * System.Drawing.Image * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.PushButtonState -> unit

Public Shared Sub DrawButton (g As Graphics, bounds As Rectangle, buttonText As String, font As Font, image As Image, imageBounds As Rectangle, focused As Boolean, state As PushButtonState)

Parameter

g: Graphics

Die zum Zeichnen der Schaltfläche verwendete Graphics.

bounds: Rectangle

Das Rectangle, das die Begrenzungen der Schaltfläche angibt.

buttonText: String

Das String, das auf der Schaltfläche gezeichnet werden soll.

font: Font

Der Font, der auf die buttonText angewendet werden soll.

image: Image

Das Image, das auf der Schaltfläche gezeichnet werden soll.

imageBounds: Rectangle

Das Rectangle, das die Dimensionen von image darstellt.

focused: Boolean

true, um ein Fokusrechteck auf der Schaltfläche zu zeichnen, andernfalls false.

state: PushButtonState

Einer der PushButtonState-Werte, der den visuellen Zustand der Schaltfläche angibt.

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, PushButtonState)

Zeichnet ein Schaltflächen-Steuerelement im angegebenen Zustand und innerhalb der angegebenen Begrenzungen sowie mit dem angegebenen Text, der angegebenen Textformatierung, dem angegebenen Bild und mit einem optionalen Fokusrechteck.

public:
 static void DrawButton(System::Drawing::Graphics ^ g, System::Drawing::Rectangle bounds, System::String ^ buttonText, System::Drawing::Font ^ font, System::Windows::Forms::TextFormatFlags flags, System::Drawing::Image ^ image, System::Drawing::Rectangle imageBounds, bool focused, System::Windows::Forms::VisualStyles::PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string buttonText, System.Drawing.Font font, System.Windows.Forms.TextFormatFlags flags, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

public static void DrawButton (System.Drawing.Graphics g, System.Drawing.Rectangle bounds, string? buttonText, System.Drawing.Font? font, System.Windows.Forms.TextFormatFlags flags, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.PushButtonState state);

static member DrawButton : 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.PushButtonState -> unit

Public Shared Sub DrawButton (g As Graphics, bounds As Rectangle, buttonText As String, font As Font, flags As TextFormatFlags, image As Image, imageBounds As Rectangle, focused As Boolean, state As PushButtonState)

Parameter

g: Graphics

Die zum Zeichnen der Schaltfläche verwendete Graphics.

bounds: Rectangle

Das Rectangle, das die Begrenzungen der Schaltfläche angibt.

buttonText: String

Das String, das auf der Schaltfläche gezeichnet werden soll.

font: Font

Der Font, der auf die buttonText angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte, die auf buttonText angewendet werden sollen.

image: Image

Das Image, das auf der Schaltfläche gezeichnet werden soll.

imageBounds: Rectangle

Das Rectangle, das die Dimensionen von image darstellt.

focused: Boolean

true, um ein Fokusrechteck auf der Schaltfläche zu zeichnen, andernfalls false.

state: PushButtonState

Einer der PushButtonState-Werte, der den visuellen Zustand der Schaltfläche angibt.

Hinweise

Gilt für:

Freigeben über

ButtonRenderer.DrawButton Methode

Definition

Überlädt

DrawButton(Graphics, Rectangle, PushButtonState)

Parameter

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, Boolean, PushButtonState)

Parameter

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, Image, Rectangle, Boolean, PushButtonState)

Parameter

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, Boolean, PushButtonState)

Parameter

Beispiele

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Boolean, PushButtonState)

Parameter

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, Image, Rectangle, Boolean, PushButtonState)

Parameter

Hinweise

Gilt für:

DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, PushButtonState)

Parameter

Hinweise

Gilt für:

Zusätzliche Ressourcen