wxPython/src/_button.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _button.i
   3 // Purpose:     SWIG interface defs for wxButton, wxBitmapButton
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     10-June-1998
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 2003 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 // Not a %module
  14
  15
  16 //---------------------------------------------------------------------------
  17 %newgroup;
  18
  19 MAKE_CONST_WXSTRING(ButtonNameStr);
  20
  21 enum {
  22     wxBU_LEFT,
  23     wxBU_TOP,
  24     wxBU_RIGHT,
  25     wxBU_BOTTOM,
  26
  27     wxBU_EXACTFIT,
  28     wxBU_AUTODRAW,
  29 };
  30
  31 //---------------------------------------------------------------------------
  32
  33 DocStr(wxButton,
  34 "A button is a control that contains a text string, and is one of the most
  35 common elements of a GUI.  It may be placed on a dialog box or panel, or
  36 indeed almost any other window.", "
  37
  38 Window Styles
  39 -------------
  40     ==============   ==========================================
  41     wx.BU_LEFT       Left-justifies the label. WIN32 only.
  42     wx.BU_TOP        Aligns the label to the top of the button.
  43                      WIN32 only.
  44     wx.BU_RIGHT      Right-justifies the bitmap label. WIN32 only.
  45     wx.BU_BOTTOM     Aligns the label to the bottom of the button.
  46                      WIN32 only.
  47     wx.BU_EXACTFIT   Creates the button as small as possible
  48                      instead of making it of the standard size
  49                      (which is the default behaviour.)
  50     ==============   ==========================================
  51
  52 Events
  53 ------
  54     ============     ==========================================
  55     EVT_BUTTON       Sent when the button is clicked.
  56     ============     ==========================================
  57
  58 :see: `wx.BitmapButton`
  59 ");
  60
  61 class wxButton : public wxControl
  62 {
  63 public:
  64     %pythonAppend wxButton         "self._setOORInfo(self)"
  65     %pythonAppend wxButton()       ""
  66
  67
  68     DocCtorStr(
  69         wxButton(wxWindow* parent, wxWindowID id, const wxString& label,
  70                  const wxPoint& pos = wxDefaultPosition,
  71                  const wxSize& size = wxDefaultSize,
  72                  long style = 0,
  73                  const wxValidator& validator = wxDefaultValidator,
  74                  const wxString& name = wxPyButtonNameStr),
  75         "Create and show a button.", "");
  76
  77     DocCtorStrName(
  78         wxButton(),
  79         "Precreate a Button for 2-phase creation.", "",
  80         PreButton);
  81
  82     DocDeclStr(
  83         bool , Create(wxWindow* parent, wxWindowID id, const wxString& label,
  84                       const wxPoint& pos = wxDefaultPosition,
  85                       const wxSize& size = wxDefaultSize,
  86                       long style = 0,
  87                       const wxValidator& validator = wxDefaultValidator,
  88                       const wxString& name = wxPyButtonNameStr),
  89         "Acutally create the GUI Button for 2-phase creation.", "");
  90
  91
  92
  93     DocDeclStr(
  94         void , SetDefault(),
  95         "This sets the button to be the default item for the panel or dialog box.", "");
  96
  97
  98     DocDeclStr(
  99         static wxSize , GetDefaultSize(),
 100         "Returns the default button size for this platform.", "");
 101
 102     static wxVisualAttributes
 103     GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
 104 };
 105
 106
 107
 108 //---------------------------------------------------------------------------
 109
 110
 111 DocStr(wxBitmapButton,
 112 "A Button that contains a bitmap.  A bitmap button can be supplied with a
 113 single bitmap, and wxWidgets will draw all button states using this bitmap. If
 114 the application needs more control, additional bitmaps for the selected state,
 115 unpressed focused state, and greyed-out state may be supplied.", "
 116
 117 Window Styles
 118 -------------
 119     ==============  =============================================
 120     wx.BU_AUTODRAW  If this is specified, the button will be drawn
 121                     automatically using the label bitmap only,
 122                     providing a 3D-look border. If this style is
 123                     not specified, the button will be drawn
 124                     without borders and using all provided
 125                     bitmaps. WIN32 only.
 126     wx.BU_LEFT      Left-justifies the label. WIN32 only.
 127     wx.BU_TOP       Aligns the label to the top of the button. WIN32
 128                     only.
 129     wx.BU_RIGHT     Right-justifies the bitmap label. WIN32 only.
 130     wx.BU_BOTTOM    Aligns the label to the bottom of the
 131                     button. WIN32 only.
 132     wx.BU_EXACTFIT  Creates the button as small as possible
 133                     instead of making it of the standard size
 134                     (which is the default behaviour.)
 135     ==============  =============================================
 136
 137 Events
 138 ------
 139      ===========   ==================================
 140      EVT_BUTTON    Sent when the button is clicked.
 141      ===========   ==================================
 142
 143 :see: `wx.Button`, `wx.Bitmap`
 144 ");
 145
 146 class wxBitmapButton : public wxButton
 147 {
 148 public:
 149     %pythonAppend wxBitmapButton         "self._setOORInfo(self)"
 150     %pythonAppend wxBitmapButton()       ""
 151
 152     DocCtorStr(
 153         wxBitmapButton(wxWindow* parent, wxWindowID id, const wxBitmap& bitmap,
 154                        const wxPoint& pos = wxDefaultPosition,
 155                        const wxSize& size = wxDefaultSize,
 156                        long style = wxBU_AUTODRAW,
 157                        const wxValidator& validator = wxDefaultValidator,
 158                        const wxString& name = wxPyButtonNameStr),
 159         "Create and show a button with a bitmap for the label.", "");
 160
 161     DocCtorStrName(
 162         wxBitmapButton(),
 163         "Precreate a BitmapButton for 2-phase creation.", "",
 164         PreBitmapButton);
 165
 166     DocDeclStr(
 167         bool , Create(wxWindow* parent, wxWindowID id, const wxBitmap& bitmap,
 168                 const wxPoint& pos = wxDefaultPosition,
 169                 const wxSize& size = wxDefaultSize,
 170                 long style = wxBU_AUTODRAW,
 171                 const wxValidator& validator = wxDefaultValidator,
 172                       const wxString& name = wxPyButtonNameStr),
 173         "Acutally create the GUI BitmapButton for 2-phase creation.", "");
 174
 175
 176     DocDeclStr(
 177         wxBitmap , GetBitmapLabel(),
 178         "Returns the label bitmap (the one passed to the constructor).", "");
 179
 180     DocDeclStr(
 181         wxBitmap , GetBitmapDisabled(),
 182         "Returns the bitmap for the disabled state.", "");
 183
 184     DocDeclStr(
 185         wxBitmap , GetBitmapFocus(),
 186         "Returns the bitmap for the focused state.", "");
 187
 188
 189     DocDeclStr(
 190         wxBitmap , GetBitmapSelected(),
 191         "Returns the bitmap for the selected state.", "");
 192
 193
 194     DocDeclStr(
 195         void , SetBitmapDisabled(const wxBitmap& bitmap),
 196         "Sets the bitmap for the disabled button appearance.", "");
 197
 198
 199     DocDeclStr(
 200         void , SetBitmapFocus(const wxBitmap& bitmap),
 201         "Sets the bitmap for the button appearance when it has the keyboard focus.", "");
 202
 203
 204     DocDeclStr(
 205         void , SetBitmapSelected(const wxBitmap& bitmap),
 206         "Sets the bitmap for the selected (depressed) button appearance.", "");
 207
 208
 209     DocDeclStr(
 210         void , SetBitmapLabel(const wxBitmap& bitmap),
 211         "Sets the bitmap label for the button.  This is the bitmap used for the
 212 unselected state, and for all other states if no other bitmaps are provided.", "");
 213
 214
 215     void SetMargins(int x, int y);
 216     int GetMarginX() const;
 217     int GetMarginY() const;
 218 };
 219
 220
 221 //---------------------------------------------------------------------------