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) |
Рисует элемент управления "Кнопка" в указанном состоянии, с заданными границами, с заданным текстом и форматированием текста, с заданным изображением, а также с дополнительно указываемым прямоугольником фокуса. |
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)
Параметры
- 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)
Параметры
- focused
- Boolean
Укажите значение true
, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false
— в противном случае.
- state
- PushButtonState
Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.
Комментарии
Если стили визуальных элементов включены в операционной системе и применяются к текущему приложению, этот метод нарисует кнопку с текущим стилем визуального элемента. В противном случае кнопка будет рисоваться в классическом стиле Windows.
Применяется к
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)
Параметры
- focused
- Boolean
Укажите значение true
, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false
— в противном случае.
- state
- PushButtonState
Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.
Комментарии
Если стили визуальных элементов включены в операционной системе и применяются к текущему приложению, этот метод нарисует кнопку с текущим стилем визуального элемента. В противном случае кнопка будет рисоваться в классическом стиле Windows.
Применяется к
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)
Параметры
- 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
Комментарии
Если стили визуальных элементов включены в операционной системе и применяются к текущему приложению, этот метод нарисует кнопку с текущим стилем визуального элемента. В противном случае кнопка будет рисоваться в классическом стиле Windows.
Применяется к
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)
Параметры
- flags
- TextFormatFlags
Битовая комбинация значений TextFormatFlags, которую необходимо применить к тексту buttonText
.
- focused
- Boolean
Укажите значение true
, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false
— в противном случае.
- state
- PushButtonState
Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.
Комментарии
Если стили визуальных элементов включены в операционной системе и применяются к текущему приложению, этот метод нарисует кнопку с текущим стилем визуального элемента. В противном случае кнопка будет рисоваться в классическом стиле Windows.
Применяется к
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)
Параметры
- focused
- Boolean
Укажите значение true
, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false
— в противном случае.
- state
- PushButtonState
Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.
Комментарии
Если стили визуальных элементов включены в операционной системе и применяются к текущему приложению, этот метод нарисует кнопку с текущим стилем визуального элемента. В противном случае кнопка будет рисоваться в классическом стиле Windows.
Применяется к
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)
Параметры
- flags
- TextFormatFlags
Битовая комбинация значений TextFormatFlags, которую необходимо применить к тексту buttonText
.
- focused
- Boolean
Укажите значение true
, чтобы нарисовать на кнопке прямоугольник фокуса, и значение false
— в противном случае.
- state
- PushButtonState
Одно из значений PushButtonState, с помощью которого задается видимое состояние кнопки.
Комментарии
Если стили визуальных элементов включены в операционной системе и применяются к текущему приложению, этот метод нарисует кнопку с текущим стилем визуального элемента. В противном случае кнопка будет рисоваться в классическом стиле Windows.