Partager via


ButtonRenderer.DrawButton Méthode

Définition

Dessine un contrôle bouton.

Surcharges

DrawButton(Graphics, Rectangle, PushButtonState)

Dessine un contrôle bouton dans l'état et les limites spécifiés.

DrawButton(Graphics, Rectangle, Boolean, PushButtonState)

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec un rectangle de focus facultatif.

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec l'image spécifiée et un rectangle de focus facultatif.

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte spécifié et un rectangle de focus facultatif.

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte et la mise en forme du texte spécifiés et un rectangle de focus facultatif.

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte et l'image spécifiés et un rectangle de focus facultatif.

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte, la mise en forme du texte et l'image spécifiés et un rectangle de focus facultatif.

DrawButton(Graphics, Rectangle, PushButtonState)

Dessine un contrôle bouton dans l'état et les limites spécifiés.

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)

Paramètres

g
Graphics

Graphics utilisé pour dessiner le bouton.

bounds
Rectangle

Rectangle qui spécifie les limites du bouton.

state
PushButtonState

Une des valeurs PushButtonState qui spécifie l'état visuel du bouton.

Remarques

Si les styles visuels sont activés dans le système d’exploitation et que les styles visuels sont appliqués à l’application actuelle, cette méthode dessine le bouton avec le style visuel actuel. Sinon, il dessine le bouton avec le style Windows classique.

S’applique à

DrawButton(Graphics, Rectangle, Boolean, PushButtonState)

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec un rectangle de focus facultatif.

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)

Paramètres

g
Graphics

Graphics utilisé pour dessiner le bouton.

bounds
Rectangle

Rectangle qui spécifie les limites du bouton.

focused
Boolean

true pour dessiner un rectangle de focus sur le bouton ; sinon false.

state
PushButtonState

Une des valeurs PushButtonState qui spécifie l'état visuel du bouton.

Remarques

Si les styles visuels sont activés dans le système d’exploitation et que les styles visuels sont appliqués à l’application actuelle, cette méthode dessine le bouton avec le style visuel actuel. Sinon, il dessine le bouton avec le style Windows classique.

S’applique à

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec l'image spécifiée et un rectangle de focus facultatif.

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)

Paramètres

g
Graphics

Graphics utilisé pour dessiner le bouton.

bounds
Rectangle

Rectangle qui spécifie les limites du bouton.

image
Image

Image à dessiner sur le bouton.

imageBounds
Rectangle

Rectangle qui représente les dimensions de image.

focused
Boolean

true pour dessiner un rectangle de focus sur le bouton ; sinon false.

state
PushButtonState

Une des valeurs PushButtonState qui spécifie l'état visuel du bouton.

Remarques

Si les styles visuels sont activés dans le système d’exploitation et que les styles visuels sont appliqués à l’application actuelle, cette méthode dessine le bouton avec le style visuel actuel. Sinon, il dessine le bouton avec le style Windows classique.

S’applique à

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte spécifié et un rectangle de focus facultatif.

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)

Paramètres

g
Graphics

Graphics utilisé pour dessiner le bouton.

bounds
Rectangle

Rectangle qui spécifie les limites du bouton.

buttonText
String

String à dessiner sur le bouton.

font
Font

Font à appliquer aux buttonText.

focused
Boolean

true pour dessiner un rectangle de focus sur le bouton ; sinon false.

state
PushButtonState

Une des valeurs PushButtonState qui spécifie l'état visuel du bouton.

Exemples

L’exemple de code suivant utilise la DrawButton(Graphics, Rectangle, String, Font, Boolean, PushButtonState) méthode dans la méthode d’un OnPaint contrôle personnalisé pour dessiner un bouton dans l’état déterminé par l’emplacement du pointeur de la souris. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ButtonRenderer classe .

    // 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

Remarques

Si les styles visuels sont activés dans le système d’exploitation et que les styles visuels sont appliqués à l’application actuelle, cette méthode dessine le bouton avec le style visuel actuel. Sinon, il dessine le bouton avec le style Windows classique.

S’applique à

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte et la mise en forme du texte spécifiés et un rectangle de focus facultatif.

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)

Paramètres

g
Graphics

Graphics utilisé pour dessiner le bouton.

bounds
Rectangle

Rectangle qui spécifie les limites du bouton.

buttonText
String

String à dessiner sur le bouton.

font
Font

Font à appliquer aux buttonText.

flags
TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags à appliquer à buttonText.

focused
Boolean

true pour dessiner un rectangle de focus sur le bouton ; sinon false.

state
PushButtonState

Une des valeurs PushButtonState qui spécifie l'état visuel du bouton.

Remarques

Si les styles visuels sont activés dans le système d’exploitation et que les styles visuels sont appliqués à l’application actuelle, cette méthode dessine le bouton avec le style visuel actuel. Sinon, il dessine le bouton avec le style Windows classique.

S’applique à

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte et l'image spécifiés et un rectangle de focus facultatif.

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)

Paramètres

g
Graphics

Graphics utilisé pour dessiner le bouton.

bounds
Rectangle

Rectangle qui spécifie les limites du bouton.

buttonText
String

String à dessiner sur le bouton.

font
Font

Font à appliquer aux buttonText.

image
Image

Image à dessiner sur le bouton.

imageBounds
Rectangle

Rectangle qui représente les dimensions de image.

focused
Boolean

true pour dessiner un rectangle de focus sur le bouton ; sinon false.

state
PushButtonState

Une des valeurs PushButtonState qui spécifie l'état visuel du bouton.

Remarques

Si les styles visuels sont activés dans le système d’exploitation et que les styles visuels sont appliqués à l’application actuelle, cette méthode dessine le bouton avec le style visuel actuel. Sinon, il dessine le bouton avec le style Windows classique.

S’applique à

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

Dessine un contrôle bouton dans l'état et les limites spécifiés, avec le texte, la mise en forme du texte et l'image spécifiés et un rectangle de focus facultatif.

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)

Paramètres

g
Graphics

Graphics utilisé pour dessiner le bouton.

bounds
Rectangle

Rectangle qui spécifie les limites du bouton.

buttonText
String

String à dessiner sur le bouton.

font
Font

Font à appliquer aux buttonText.

flags
TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags à appliquer à buttonText.

image
Image

Image à dessiner sur le bouton.

imageBounds
Rectangle

Rectangle qui représente les dimensions de image.

focused
Boolean

true pour dessiner un rectangle de focus sur le bouton ; sinon false.

state
PushButtonState

Une des valeurs PushButtonState qui spécifie l'état visuel du bouton.

Remarques

Si les styles visuels sont activés dans le système d’exploitation et que les styles visuels sont appliqués à l’application actuelle, cette méthode dessine le bouton avec le style visuel actuel. Sinon, il dessine le bouton avec le style Windows classique.

S’applique à