ButtonRenderer.DrawButton Метод

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Рисует элемент управления "Кнопка".

Перегрузки

DrawButton(Graphics, Rectangle, PushButtonState)	Рисует элемент управления "Кнопка" в заданном состоянии и с заданными границами.
DrawButton(Graphics, Rectangle, Boolean, PushButtonState)	Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами и с дополнительно указываемым прямоугольником фокуса.
DrawButton(Graphics, Rectangle, Image, Rectangle, Boolean, PushButtonState)	Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным изображением и с дополнительно указываемым прямоугольником фокуса.
DrawButton(Graphics, Rectangle, String, Font, Boolean, PushButtonState)	Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным текстом и с дополнительно указываемым прямоугольником фокуса.
DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Boolean, PushButtonState)	Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным текстом и форматированием текста, а также с дополнительно указываемым прямоугольником фокуса.
DrawButton(Graphics, Rectangle, String, Font, Image, Rectangle, Boolean, PushButtonState)	Рисует элемент управления "Кнопка" в заданном состоянии, с заданными границами, текстом, изображением и (при необходимости) прямоугольником фокуса.
DrawButton(Graphics, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, PushButtonState)	Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным текстом и форматированием текста, с заданным изображением, а также с дополнительно указываемым прямоугольником фокуса.

DrawButton(Graphics, Rectangle, PushButtonState)

Рисует элемент управления "Кнопка" в заданном состоянии и с заданными границами.

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)

Параметры

g: Graphics

Graphics используется для рисования кнопки.

bounds: Rectangle

Rectangle указывает границы кнопки.

state: PushButtonState

Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.

Если стили визуальных элементов включены в операционной системе и применяются к текущему приложению, этот метод нарисует кнопку с текущим стилем визуального элемента. В противном случае кнопка будет рисоваться в классическом стиле Windows.

Применяется к

DrawButton(Graphics, Rectangle, Boolean, PushButtonState)

Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами и с дополнительно указываемым прямоугольником фокуса.

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)

Параметры

g: Graphics

Graphics используется для рисования кнопки.

bounds: Rectangle

Rectangle указывает границы кнопки.

focused: Boolean

Укажите значение true, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false — в противном случае.

state: PushButtonState

Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.

Применяется к

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

Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным изображением и с дополнительно указываемым прямоугольником фокуса.

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)

Параметры

g: Graphics

Graphics используется для рисования кнопки.

bounds: Rectangle

Rectangle указывает границы кнопки.

image: Image

Объект Image для отрисовки на кнопке.

imageBounds: Rectangle

Прямоугольник Rectangle, представляющий размеры объекта image.

focused: Boolean

Укажите значение true, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false — в противном случае.

state: PushButtonState

Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.

Применяется к

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

Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным текстом и с дополнительно указываемым прямоугольником фокуса.

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)

Параметры

g: Graphics

Graphics используется для рисования кнопки.

bounds: Rectangle

Rectangle указывает границы кнопки.

buttonText: String

Объект String для отрисовки на кнопке.

font: Font

Снимок Font, применяемый к диапазонам buttonText.

focused: Boolean

Укажите значение true, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false — в противном случае.

state: PushButtonState

Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.

Примеры

В следующем примере кода метод в методе пользовательского элемента управления OnPaint используется DrawButton(Graphics, Rectangle, String, Font, Boolean, PushButtonState) для рисования кнопки в состоянии, определяемом расположением указателя мыши. Этот пример входит в состав более крупного примера использования класса ButtonRenderer.

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

Применяется к

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

Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным текстом и форматированием текста, а также с дополнительно указываемым прямоугольником фокуса.

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)

Параметры

g: Graphics

Graphics используется для рисования кнопки.

bounds: Rectangle

Rectangle указывает границы кнопки.

buttonText: String

Объект String для отрисовки на кнопке.

font: Font

Снимок Font, применяемый к диапазонам buttonText.

flags: TextFormatFlags

Битовая комбинация значений TextFormatFlags, которую необходимо применить к тексту buttonText.

focused: Boolean

Укажите значение true, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false — в противном случае.

state: PushButtonState

Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.

Применяется к

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

Рисует элемент управления "Кнопка" в заданном состоянии, с заданными границами, текстом, изображением и (при необходимости) прямоугольником фокуса.

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)

Параметры

g: Graphics

Graphics используется для рисования кнопки.

bounds: Rectangle

Rectangle указывает границы кнопки.

buttonText: String

Объект String для отрисовки на кнопке.

font: Font

Снимок Font, применяемый к диапазонам buttonText.

image: Image

Объект Image для отрисовки на кнопке.

imageBounds: Rectangle

Прямоугольник Rectangle, представляющий размеры объекта image.

focused: Boolean

Укажите значение true, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false — в противном случае.

state: PushButtonState

Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.

Применяется к

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

Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным текстом и форматированием текста, с заданным изображением, а также с дополнительно указываемым прямоугольником фокуса.

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)

Параметры

g: Graphics

Graphics используется для рисования кнопки.

bounds: Rectangle

Rectangle указывает границы кнопки.

buttonText: String

Объект String для отрисовки на кнопке.

font: Font

Снимок Font, применяемый к диапазонам buttonText.

flags: TextFormatFlags

Битовая комбинация значений TextFormatFlags, которую необходимо применить к тексту buttonText.

image: Image

Объект Image для отрисовки на кнопке.

imageBounds: Rectangle

Прямоугольник Rectangle, представляющий размеры объекта image.

focused: Boolean

Укажите значение true, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false — в противном случае.

state: PushButtonState

Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.

Применяется к

ButtonRenderer.DrawButton Метод

Определение

Перегрузки

DrawButton(Graphics, Rectangle, PushButtonState)

Параметры

Комментарии

Применяется к

DrawButton(Graphics, Rectangle, Boolean, PushButtonState)

Параметры

Комментарии

Применяется к

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

Параметры

Комментарии

Применяется к

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

Параметры

Примеры

Комментарии

Применяется к

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

Параметры

Комментарии

Применяется к

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

Параметры

Комментарии

Применяется к

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

Параметры

Комментарии

Применяется к

Обратная связь

Дополнительные ресурсы