// Name: button.h
// Purpose: interface of wxButton
// Author: wxWidgets team
-// RCS-ID: $Id$
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
@style{wxBU_BOTTOM}
Aligns the label to the bottom of the button. Windows and GTK+ only.
@style{wxBU_EXACTFIT}
- Creates the button as small as possible instead of making it of the
- standard size (which is the default behaviour ).
+ By default, all buttons are made of at least the standard button size,
+ even if their contents is small enough to fit into a smaller size. This
+ is done for consistency as most platforms use buttons of the same size
+ in the native dialogs, but can be overridden by specifying this flag.
+ If it is given, the button will be made just big enough for its
+ contents. Notice that under MSW the button will still have at least the
+ standard height, even with this style, if it has a non-empty label.
@style{wxBU_NOTEXT}
Disables the display of the text label in the button even if it has one
or its id is one of the standard stock ids with an associated label:
bitmap but uses a standard id would display a label too.
@style{wxBORDER_NONE}
Creates a button without border. This is currently implemented in MSW,
- GTK2 and OSX/Carbon ports but in the latter only applies to buttons
- with bitmaps and using bitmap of one of the standard sizes only, namely
- 128*128, 48*48, 24*24 or 16*16. In all the other cases wxBORDER_NONE is
- ignored under OSX.
+ GTK2 and OSX/Cocoa and OSX/Carbon ports but in the latter only applies
+ to buttons with bitmaps and using bitmap of one of the standard sizes
+ only, namely 128*128, 48*48, 24*24 or 16*16. In all the other cases
+ wxBORDER_NONE is ignored under OSX/Carbon (these restrictions don't
+ exist in OSX/Cocoa however).
@endStyleTable
@beginEventEmissionTable{wxCommandEvent}
@event{EVT_BUTTON(id, func)}
- Process a @c wxEVT_COMMAND_BUTTON_CLICKED event, when the button is clicked.
+ Process a @c wxEVT_BUTTON event, when the button is clicked.
@endEventTable
@library{wxcore}
@category{ctrl}
- @appearance{button.png}
+ @appearance{button}
@see wxBitmapButton
*/