ControlPaint Class

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides methods used to paint common Windows controls and their elements. This class cannot be inherited.

public ref class ControlPaint sealed

public ref class ControlPaint abstract sealed

public sealed class ControlPaint

public static class ControlPaint

type ControlPaint = class

Public NotInheritable Class ControlPaint

Public Class ControlPaint

Inheritance: Object
ControlPaint

Examples

The following code example uses one of the ControlPaint constructors to draw a flat Button control.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   Button^ button1;
   Button^ button2;

public:
   Form1()
   {
      button1 = gcnew Button;
      button2 = gcnew Button;
      this->button2->Location = Point(0,button1->Height + 10);
      this->Click += gcnew EventHandler( this, &Form1::button2_Click );
      this->Controls->Add( this->button1 );
      this->Controls->Add( this->button2 );
   }


private:

   void button2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Draws a flat button on button1.
      ControlPaint::DrawButton( System::Drawing::Graphics::FromHwnd( button1->Handle ), 0, 0, button1->Width, button1->Height, ButtonState::Flat );
   }

};


[STAThread]
void main()
{
   Application::Run( gcnew Form1 );
}

using System;
using System.Drawing;
using System.Windows.Forms;

public class Form1 : Form
{
    private Button _button1 = new Button();
    private Button _button2 = new Button();

    [STAThread]
    static void Main()
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        _button2.Location = new Point(0, _button1.Height + 10);
        this.Click += Button2_Click;
        this.Controls.Add(_button1);
        this.Controls.Add(_button2);
    }

    private void Button2_Click(object sender, System.EventArgs e)
    {
        // Draws a flat button on button1.
        ControlPaint.DrawButton(
            System.Drawing.Graphics.FromHwnd(_button1.Handle), 0, 0,
            _button1.Width, _button1.Height,
            ButtonState.Flat);
    }

}

Imports System.Drawing
Imports System.Windows.Forms

    Public Class Form1
        Inherits System.Windows.Forms.Form

        Private button1 As System.Windows.Forms.Button = New Button
        Private button2 As System.Windows.Forms.Button = New Button

        <System.STAThreadAttribute()>  _
        Public Shared Sub Main()
            System.Windows.Forms.Application.Run(New Form1)
        End Sub

        Public Sub New()
            Me.button2.Location = New Point(0, button1.Height + 10)
            AddHandler Me.button2.Click, AddressOf Me.button2_Click
            Me.Controls.Add(Me.button1)
            Me.Controls.Add(Me.button2)
        End Sub

        Private Sub button2_Click(sender As Object, e As System.EventArgs)
            ' Draws a flat button on button1.
            ControlPaint.DrawButton(System.Drawing.Graphics.FromHwnd(button1.Handle), 0, 0, button1.Width, button1.Height, ButtonState.Flat)
        End Sub
End Class

Remarks

The methods contained in the ControlPaint class enable you to draw your own controls or elements of controls. You can control the drawing of your own controls if the UserPaint bit is set to true for the control. You can get or set the style bits by calling the GetStyle or SetStyle methods. You can set multiple style bits for any control. The ControlStyles enumeration members can be combined with bitwise operations.

Properties

ContrastControlDark

Gets the color to use as the ControlDark color.

Methods

CreateHBitmap16Bit(Bitmap, Color)	Creates a 16-bit color bitmap.
CreateHBitmapColorMask(Bitmap, IntPtr)	Creates a Win32 `HBITMAP` out of the image.
CreateHBitmapTransparencyMask(Bitmap)	Creates a color mask for the specified bitmap that indicates which color should be displayed as transparent.
Dark(Color)	Creates a new dark color object for the control from the specified color.
Dark(Color, Single)	Creates a new dark color object for the control from the specified color and darkens it by the specified percentage.
DarkDark(Color)	Creates a new dark color object for the control from the specified color.
DrawBorder(Graphics, Rectangle, Color, ButtonBorderStyle)	Draws a border with the specified style and color, on the specified graphics surface, and within the specified bounds on a button-style control.
DrawBorder(Graphics, Rectangle, Color, Int32, ButtonBorderStyle, Color, Int32, ButtonBorderStyle, Color, Int32, ButtonBorderStyle, Color, Int32, ButtonBorderStyle)	Draws a border on a button-style control with the specified styles, colors, and border widths; on the specified graphics surface; and within the specified bounds.
DrawBorder3D(Graphics, Int32, Int32, Int32, Int32)	Draws a three-dimensional style border on the specified graphics surface and within the specified bounds on a control.
DrawBorder3D(Graphics, Int32, Int32, Int32, Int32, Border3DStyle)	Draws a three-dimensional style border with the specified style, on the specified graphics surface, and within the specified bounds on a control.
DrawBorder3D(Graphics, Int32, Int32, Int32, Int32, Border3DStyle, Border3DSide)	Draws a three-dimensional style border with the specified style, on the specified graphics surface and side, and within the specified bounds on a control.
DrawBorder3D(Graphics, Rectangle)	Draws a three-dimensional style border on the specified graphics surface and within the specified bounds on a control.
DrawBorder3D(Graphics, Rectangle, Border3DStyle)	Draws a three-dimensional style border with the specified style, on the specified graphics surface, and within the specified bounds on a control.
DrawBorder3D(Graphics, Rectangle, Border3DStyle, Border3DSide)	Draws a three-dimensional style border with the specified style, on the specified graphics surface and sides, and within the specified bounds on a control.
DrawButton(Graphics, Int32, Int32, Int32, Int32, ButtonState)	Draws a button control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawButton(Graphics, Rectangle, ButtonState)	Draws a button control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawCaptionButton(Graphics, Int32, Int32, Int32, Int32, CaptionButton, ButtonState)	Draws the specified caption button control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawCaptionButton(Graphics, Rectangle, CaptionButton, ButtonState)	Draws the specified caption button control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawCheckBox(Graphics, Int32, Int32, Int32, Int32, ButtonState)	Draws a check box control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawCheckBox(Graphics, Rectangle, ButtonState)	Draws a check box control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawComboButton(Graphics, Int32, Int32, Int32, Int32, ButtonState)	Draws a drop-down button on a combo box control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawComboButton(Graphics, Rectangle, ButtonState)	Draws a drop-down button on a combo box control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawContainerGrabHandle(Graphics, Rectangle)	Draws a container control grab handle glyph on the specified graphics surface and within the specified bounds.
DrawFocusRectangle(Graphics, Rectangle)	Draws a focus rectangle on the specified graphics surface and within the specified bounds.
DrawFocusRectangle(Graphics, Rectangle, Color, Color)	Draws a focus rectangle on the specified graphics surface and within the specified bounds.
DrawGrabHandle(Graphics, Rectangle, Boolean, Boolean)	Draws a standard selection grab handle glyph on the specified graphics surface, within the specified bounds, and in the specified state and style.
DrawGrid(Graphics, Rectangle, Size, Color)	Draws a grid of one-pixel dots with the specified spacing, within the specified bounds, on the specified graphics surface, and in the specified color.
DrawImageDisabled(Graphics, Image, Int32, Int32, Color)	Draws the specified image in a disabled state.
DrawLockedFrame(Graphics, Rectangle, Boolean)	Draws a locked selection frame on the screen within the specified bounds and on the specified graphics surface. Specifies whether to draw the frame with the primary selected colors.
DrawMenuGlyph(Graphics, Int32, Int32, Int32, Int32, MenuGlyph)	Draws the specified menu glyph on a menu item control with the specified bounds and on the specified surface.
DrawMenuGlyph(Graphics, Int32, Int32, Int32, Int32, MenuGlyph, Color, Color)	Draws the specified menu glyph on a menu item control within the specified coordinates, height, and width on the specified surface, replacing White with the color specified in the `backColor` parameter and replacing Black with the color specified in the `foreColor` parameter.
DrawMenuGlyph(Graphics, Rectangle, MenuGlyph)	Draws the specified menu glyph on a menu item control within the specified bounds and on the specified surface.
DrawMenuGlyph(Graphics, Rectangle, MenuGlyph, Color, Color)	Draws the specified menu glyph on a menu item control within the specified bounds and on the specified surface, replacing White with the color specified in the `backColor` parameter and replacing Black with the color specified in the `foreColor` parameter.
DrawMixedCheckBox(Graphics, Int32, Int32, Int32, Int32, ButtonState)	Draws a three-state check box control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawMixedCheckBox(Graphics, Rectangle, ButtonState)	Draws a three-state check box control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawRadioButton(Graphics, Int32, Int32, Int32, Int32, ButtonState)	Draws a radio button control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawRadioButton(Graphics, Rectangle, ButtonState)	Draws a radio button control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawReversibleFrame(Rectangle, Color, FrameStyle)	Draws a reversible frame on the screen within the specified bounds, with the specified background color, and in the specified state.
DrawReversibleLine(Point, Point, Color)	Draws a reversible line on the screen within the specified starting and ending points and with the specified background color.
DrawScrollButton(Graphics, Int32, Int32, Int32, Int32, ScrollButton, ButtonState)	Draws the specified scroll button on a scroll bar control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawScrollButton(Graphics, Rectangle, ScrollButton, ButtonState)	Draws the specified scroll button on a scroll bar control in the specified state, on the specified graphics surface, and within the specified bounds.
DrawSelectionFrame(Graphics, Boolean, Rectangle, Rectangle, Color)	Draws a standard selection frame in the specified state, on the specified graphics surface, with the specified inner and outer dimensions, and with the specified background color.
DrawSizeGrip(Graphics, Color, Int32, Int32, Int32, Int32)	Draws a size grip on a form with the specified bounds and background color and on the specified graphics surface.
DrawSizeGrip(Graphics, Color, Rectangle)	Draws a size grip on a form with the specified bounds and background color and on the specified graphics surface.
DrawStringDisabled(Graphics, String, Font, Color, RectangleF, StringFormat)	Draws the specified string in a disabled state on the specified graphics surface; within the specified bounds; and in the specified font, color, and format.
DrawStringDisabled(IDeviceContext, String, Font, Color, Rectangle, TextFormatFlags)	Draws the specified string in a disabled state on the specified graphics surface, within the specified bounds, and in the specified font, color, and format, using the specified GDI-based TextRenderer.
DrawVisualStyleBorder(Graphics, Rectangle)	Draws a border in the style appropriate for disabled items.
FillReversibleRectangle(Rectangle, Color)	Draws a filled, reversible rectangle on the screen.
Light(Color)	Creates a new light color object for the control from the specified color.
Light(Color, Single)	Creates a new light color object for the control from the specified color and lightens it by the specified percentage.
LightLight(Color)	Creates a new light color object for the control from the specified color.

Applies to

Jaa