ButtonState Enum


Specifies the appearance of a button.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

public enum class ButtonState
public enum ButtonState
type ButtonState = 
Public Enum ButtonState


All 18176

All flags except Normal are set.

Checked 1024

The button has a checked or latched appearance. Use this appearance to show that a toggle button has been pressed.

Flat 16384

The button has a flat, two-dimensional appearance.

Inactive 256

The button is inactive (grayed).

Normal 0

The button has its normal appearance (three-dimensional).

Pushed 512

The button appears pressed.


In this example, you use the ButtonState enumeration as a parameter to the method DrawButton to specify the state of button1. To run the example, create two buttons, button1 and button2. Then replace the button2_Click method with the example code. Click button2 to redraw button1 and change its state to Flat.

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 );

private void Button2_Click(object sender, System.EventArgs e)
    // Draws a flat button on button1.
        System.Drawing.Graphics.FromHwnd(_button1.Handle), 0, 0, 
        _button1.Width, _button1.Height,

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


This enumeration represents the different states of a button. The default state is Normal.

Applies to

See also