ButtonRenderer.DrawButton Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

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

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

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

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

S’applique à

ButtonRenderer.DrawButton Méthode

Définition

Surcharges

DrawButton(Graphics, Rectangle, PushButtonState)

Paramètres

Remarques

S’applique à

DrawButton(Graphics, Rectangle, Boolean, PushButtonState)

Paramètres

Remarques

S’applique à

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

Paramètres

Remarques

S’applique à

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

Paramètres

Exemples

Remarques

S’applique à

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

Paramètres

Remarques

S’applique à

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

Paramètres

Remarques

S’applique à

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

Paramètres

Remarques

S’applique à

Commentaires

Ressources supplémentaires