]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/src/_button.i
GetBestFittingSize --> GetEffectiveMinSize
[wxWidgets.git] / wxPython / src / _button.i
index e1168470fdb6edb18d06714d7a4f0a287afb152c..d29dd2c2a3bc4900db73ab13b5e426c6f5bce542 100644 (file)
@@ -24,65 +24,12 @@ enum {
     wxBU_RIGHT,
     wxBU_BOTTOM,
 
+    wxBU_ALIGN_MASK,
+
     wxBU_EXACTFIT,
     wxBU_AUTODRAW,
 };
 
-// enum wxStockItemID
-// {
-//     wxSTOCK_NONE = 0,
-//     wxSTOCK_ADD,
-//     wxSTOCK_APPLY,
-//     wxSTOCK_BOLD,
-//     wxSTOCK_CANCEL,
-//     wxSTOCK_CLEAR,
-//     wxSTOCK_CLOSE,
-//     wxSTOCK_COPY,
-//     wxSTOCK_CUT,
-//     wxSTOCK_DELETE,
-//     wxSTOCK_FIND,
-//     wxSTOCK_FIND_AND_REPLACE,
-//     wxSTOCK_GO_BACK,
-//     wxSTOCK_GO_DOWN,
-//     wxSTOCK_GO_FORWARD,
-//     wxSTOCK_GO_UP,
-//     wxSTOCK_HELP,
-//     wxSTOCK_HOME,
-//     wxSTOCK_INDENT,
-//     wxSTOCK_INDEX,
-//     wxSTOCK_ITALIC,
-//     wxSTOCK_JUSTIFY_CENTER,
-//     wxSTOCK_JUSTIFY_FILL,
-//     wxSTOCK_JUSTIFY_LEFT,
-//     wxSTOCK_JUSTIFY_RIGHT,
-//     wxSTOCK_NEW,
-//     wxSTOCK_NO,
-//     wxSTOCK_OK,
-//     wxSTOCK_OPEN,
-//     wxSTOCK_PASTE,
-//     wxSTOCK_PREFERENCES,
-//     wxSTOCK_PRINT,
-//     wxSTOCK_PRINT_PREVIEW,
-//     wxSTOCK_PROPERTIES,
-//     wxSTOCK_QUIT,
-//     wxSTOCK_REDO,
-//     wxSTOCK_REFRESH,
-//     wxSTOCK_REMOVE,
-//     wxSTOCK_REVERT_TO_SAVED,
-//     wxSTOCK_SAVE,
-//     wxSTOCK_SAVE_AS,
-//     wxSTOCK_STOP,
-//     wxSTOCK_UNDELETE,
-//     wxSTOCK_UNDERLINE,
-//     wxSTOCK_UNDO,
-//     wxSTOCK_UNINDENT,
-//     wxSTOCK_YES,
-//     wxSTOCK_ZOOM_100,
-//     wxSTOCK_ZOOM_FIT,
-//     wxSTOCK_ZOOM_IN,
-//     wxSTOCK_ZOOM_OUT
-// };
-
 //---------------------------------------------------------------------------
 
 DocStr(wxButton,
@@ -112,7 +59,6 @@ Events
 
 :see: `wx.BitmapButton`
 ");
-//, `wx.StockButton`
 
 
 MustHaveApp(wxButton);
@@ -133,92 +79,73 @@ public:
                  long style = 0,
                  const wxValidator& validator = wxDefaultValidator,
                  const wxString& name = wxPyButtonNameStr),
-        "Create and show a button.", "");
+        "Create and show a button.  The preferred way to create standard
+buttons is to use a standard ID and an empty label.  In this case
+wxWigets will automatically use a stock label that coresponds to the
+ID given.  In additon, the button will be decorated with stock icons
+under GTK+ 2.", "
+
+The stock IDs and coresponding labels are
+
+    =====================   ======================
+    wx.ID_ADD               'Add'
+    wx.ID_APPLY             '\&Apply'
+    wx.ID_BOLD              '\&Bold'
+    wx.ID_CANCEL            '\&Cancel'
+    wx.ID_CLEAR             '\&Clear'
+    wx.ID_CLOSE             '\&Close'
+    wx.ID_COPY              '\&Copy'
+    wx.ID_CUT               'Cu\&t'
+    wx.ID_DELETE            '\&Delete'
+    wx.ID_FIND              '\&Find'
+    wx.ID_REPLACE           'Find and rep\&lace'
+    wx.ID_BACKWARD          '\&Back'
+    wx.ID_DOWN              '\&Down'
+    wx.ID_FORWARD           '\&Forward'
+    wx.ID_UP                '\&Up'
+    wx.ID_HELP              '\&Help'
+    wx.ID_HOME              '\&Home'
+    wx.ID_INDENT            'Indent'
+    wx.ID_INDEX             '\&Index'
+    wx.ID_ITALIC            '\&Italic'
+    wx.ID_JUSTIFY_CENTER    'Centered'
+    wx.ID_JUSTIFY_FILL      'Justified'
+    wx.ID_JUSTIFY_LEFT      'Align Left'
+    wx.ID_JUSTIFY_RIGHT     'Align Right'
+    wx.ID_NEW               '\&New'
+    wx.ID_NO                '\&No'
+    wx.ID_OK                '\&OK'
+    wx.ID_OPEN              '\&Open'
+    wx.ID_PASTE             '\&Paste'
+    wx.ID_PREFERENCES       '\&Preferences'
+    wx.ID_PRINT             '\&Print'
+    wx.ID_PREVIEW           'Print previe\&w'
+    wx.ID_PROPERTIES        '\&Properties'
+    wx.ID_EXIT              '\&Quit'
+    wx.ID_REDO              '\&Redo'
+    wx.ID_REFRESH           'Refresh'
+    wx.ID_REMOVE            'Remove'
+    wx.ID_REVERT_TO_SAVED   'Revert to Saved'
+    wx.ID_SAVE              '\&Save'
+    wx.ID_SAVEAS            'Save \&As...'
+    wx.ID_STOP              '\&Stop'
+    wx.ID_UNDELETE          'Undelete'
+    wx.ID_UNDERLINE         '\&Underline'
+    wx.ID_UNDO              '\&Undo'
+    wx.ID_UNINDENT          '\&Unindent'
+    wx.ID_YES               '\&Yes'
+    wx.ID_ZOOM_100          '\&Actual Size'
+    wx.ID_ZOOM_FIT          'Zoom to \&Fit'
+    wx.ID_ZOOM_IN           'Zoom \&In'
+    wx.ID_ZOOM_OUT          'Zoom \&Out'
+    =====================   ======================
+");
 
     DocCtorStrName(
         wxButton(),
         "Precreate a Button for 2-phase creation.", "",
         PreButton);
 
-//     DocCtorStrName(
-//         wxButton(wxWindow *parent, wxWindowID id,
-//                  wxStockItemID stock,
-//                  const wxString& descriptiveLabel = wxPyEmptyString,
-//                  const wxPoint& pos = wxDefaultPosition,
-//                  long style = 0,
-//                  const wxValidator& validator = wxDefaultValidator,
-//                  const wxString& name = wxButtonNameStr),
-//         "Used to create a stock `wx.Button`.  Stock buttons are commonly used
-// buttons such as OK or Cancel. They have standard label and dimensions
-// and may have different appearance on some platforms (e.g. GTK+ 2
-// decorates them with icons). Using this from is the preferred way of
-// creating standard buttons.", "
-
-//     :param stock: The stock ID of the button to create. One of the following:
-
-//             ============================
-//              ``wx.STOCK_NONE``
-//              ``wx.STOCK_ADD``
-//              ``wx.STOCK_APPLY``
-//              ``wx.STOCK_BOLD``
-//              ``wx.STOCK_CANCEL``
-//              ``wx.STOCK_CLEAR``
-//              ``wx.STOCK_CLOSE``
-//              ``wx.STOCK_COPY``
-//              ``wx.STOCK_CUT``
-//              ``wx.STOCK_DELETE``
-//              ``wx.STOCK_FIND``
-//              ``wx.STOCK_FIND_AND_REPLACE``
-//              ``wx.STOCK_GO_BACK``
-//              ``wx.STOCK_GO_DOWN``
-//              ``wx.STOCK_GO_FORWARD``
-//              ``wx.STOCK_GO_UP``
-//              ``wx.STOCK_HELP``
-//              ``wx.STOCK_HOME``
-//              ``wx.STOCK_INDENT``
-//              ``wx.STOCK_INDEX``
-//              ``wx.STOCK_ITALIC``
-//              ``wx.STOCK_JUSTIFY_CENTER``
-//              ``wx.STOCK_JUSTIFY_FILL``
-//              ``wx.STOCK_JUSTIFY_LEFT``
-//              ``wx.STOCK_JUSTIFY_RIGHT``
-//              ``wx.STOCK_NEW``
-//              ``wx.STOCK_NO``
-//              ``wx.STOCK_OK``
-//              ``wx.STOCK_OPEN``
-//              ``wx.STOCK_PASTE``
-//              ``wx.STOCK_PREFERENCES``
-//              ``wx.STOCK_PRINT``
-//              ``wx.STOCK_PRINT_PREVIEW``
-//              ``wx.STOCK_PROPERTIES``
-//              ``wx.STOCK_QUIT``
-//              ``wx.STOCK_REDO``
-//              ``wx.STOCK_REFRESH``
-//              ``wx.STOCK_REMOVE``
-//              ``wx.STOCK_REVERT_TO_SAVED``
-//              ``wx.STOCK_SAVE``
-//              ``wx.STOCK_SAVE_AS``
-//              ``wx.STOCK_STOP``
-//              ``wx.STOCK_UNDELETE``
-//              ``wx.STOCK_UNDERLINE``
-//              ``wx.STOCK_UNDO``
-//              ``wx.STOCK_UNINDENT``
-//              ``wx.STOCK_YES``
-//              ``wx.STOCK_ZOOM_100``
-//              ``wx.STOCK_ZOOM_FIT``
-//              ``wx.STOCK_ZOOM_IN``
-//              ``wx.STOCK_ZOOM_OUT``
-//             ============================
-
-
-//     :param descriptiveLabel: Optional label to be used on platforms
-// where standard buttons have descriptive rather than generic
-// labels. Mac is one such platforms, well-behaved Mac apps should use
-// descriptive labels (e.g. \"Save\" and \"Don't Save\" instead of \"OK\"
-// and \"Cancel\"). This argument is ignored on other platforms.",
-//         StockButton);
-
-    
     // Turn it back on again
     %typemap(out) wxButton* { $result = wxPyMake_wxObject($1, $owner); }
 
@@ -344,6 +271,10 @@ public:
         wxBitmap , GetBitmapSelected(),
         "Returns the bitmap for the selected state.", "");
     
+    DocDeclStr(
+        wxBitmap , GetBitmapHover(),
+        "Returns the bitmap used when the mouse is over the button, may be invalid.", "");
+   
 
     DocDeclStr(
         void , SetBitmapDisabled(const wxBitmap& bitmap),
@@ -364,11 +295,25 @@ public:
         void , SetBitmapLabel(const wxBitmap& bitmap),
         "Sets the bitmap label for the button.  This is the bitmap used for the
 unselected state, and for all other states if no other bitmaps are provided.", "");
-    
 
+    
+    DocDeclStr(
+        void , SetBitmapHover(const wxBitmap& hover),
+        "Sets the bitmap to be shown when the mouse is over the button.  This function
+is new since wxWidgets version 2.7.0 and the hover bitmap is currently only
+supported in wxMSW.", "");
+    
     void SetMargins(int x, int y);
     int GetMarginX() const;
     int GetMarginY() const;
+    
+    %property(BitmapDisabled, GetBitmapDisabled, SetBitmapDisabled, doc="See `GetBitmapDisabled` and `SetBitmapDisabled`");
+    %property(BitmapFocus, GetBitmapFocus, SetBitmapFocus, doc="See `GetBitmapFocus` and `SetBitmapFocus`");
+    %property(BitmapHover, GetBitmapHover, SetBitmapHover, doc="See `GetBitmapHover` and `SetBitmapHover`");
+    %property(BitmapLabel, GetBitmapLabel, SetBitmapLabel, doc="See `GetBitmapLabel` and `SetBitmapLabel`");
+    %property(BitmapSelected, GetBitmapSelected, SetBitmapSelected, doc="See `GetBitmapSelected` and `SetBitmapSelected`");
+    %property(MarginX, GetMarginX, doc="See `GetMarginX`");
+    %property(MarginY, GetMarginY, doc="See `GetMarginY`");
 };