X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/093d3ff1f77c9ff8c1b66ebf43464429c583b044..1721a8c028d3b6a553634c632117fbfac102a30e:/wxPython/src/msw/_core.py diff --git a/wxPython/src/msw/_core.py b/wxPython/src/msw/_core.py index b6045c7d53..cf4f48ee81 100644 --- a/wxPython/src/msw/_core.py +++ b/wxPython/src/msw/_core.py @@ -121,20 +121,12 @@ RA_HORIZONTAL = _core_.RA_HORIZONTAL RA_VERTICAL = _core_.RA_VERTICAL RA_SPECIFY_ROWS = _core_.RA_SPECIFY_ROWS RA_SPECIFY_COLS = _core_.RA_SPECIFY_COLS +RA_USE_CHECKBOX = _core_.RA_USE_CHECKBOX RB_GROUP = _core_.RB_GROUP RB_SINGLE = _core_.RB_SINGLE -SL_HORIZONTAL = _core_.SL_HORIZONTAL -SL_VERTICAL = _core_.SL_VERTICAL -SL_AUTOTICKS = _core_.SL_AUTOTICKS -SL_LABELS = _core_.SL_LABELS -SL_LEFT = _core_.SL_LEFT -SL_TOP = _core_.SL_TOP -SL_RIGHT = _core_.SL_RIGHT -SL_BOTTOM = _core_.SL_BOTTOM -SL_BOTH = _core_.SL_BOTH -SL_SELRANGE = _core_.SL_SELRANGE SB_HORIZONTAL = _core_.SB_HORIZONTAL SB_VERTICAL = _core_.SB_VERTICAL +RB_USE_CHECKBOX = _core_.RB_USE_CHECKBOX ST_SIZEGRIP = _core_.ST_SIZEGRIP ST_NO_AUTORESIZE = _core_.ST_NO_AUTORESIZE FLOOD_SURFACE = _core_.FLOOD_SURFACE @@ -288,6 +280,8 @@ PD_CAN_ABORT = _core_.PD_CAN_ABORT PD_ELAPSED_TIME = _core_.PD_ELAPSED_TIME PD_ESTIMATED_TIME = _core_.PD_ESTIMATED_TIME PD_REMAINING_TIME = _core_.PD_REMAINING_TIME +PD_SMOOTH = _core_.PD_SMOOTH +PD_CAN_SKIP = _core_.PD_CAN_SKIP DD_NEW_DIR_BUTTON = _core_.DD_NEW_DIR_BUTTON DD_DEFAULT_STYLE = _core_.DD_DEFAULT_STYLE MENU_TEAROFF = _core_.MENU_TEAROFF @@ -1200,9 +1194,24 @@ class Rect(object): """ Inflate(self, int dx, int dy) -> Rect - Increase the rectangle size by dx in x direction and dy in y - direction. Both (or one of) parameters may be negative to decrease the - rectangle size. + Increases the size of the rectangle. + + The left border is moved farther left and the right border is moved + farther right by ``dx``. The upper border is moved farther up and the + bottom border is moved farther down by ``dy``. (Note the the width and + height of the rectangle thus change by ``2*dx`` and ``2*dy``, + respectively.) If one or both of ``dx`` and ``dy`` are negative, the + opposite happens: the rectangle size decreases in the respective + direction. + + The change is made to the rectangle inplace, if instead you need a + copy that is inflated, preserving the original then make the copy + first:: + + copy = wx.Rect(*original) + copy.Inflate(10,15) + + """ return _core_.Rect_Inflate(*args, **kwargs) @@ -1210,9 +1219,9 @@ class Rect(object): """ Deflate(self, int dx, int dy) -> Rect - Decrease the rectangle size by dx in x direction and dy in y - direction. Both (or one of) parameters may be negative to increase the - rectngle size. This method is the opposite of Inflate. + Decrease the rectangle size. This method is the opposite of `Inflate` + in that Deflate(a,b) is equivalent to Inflate(-a,-b). Please refer to + `Inflate` for a full description. """ return _core_.Rect_Deflate(*args, **kwargs) @@ -3274,7 +3283,18 @@ class Event(Object): return _core_.Event_IsCommandEvent(*args, **kwargs) def Skip(*args, **kwargs): - """Skip(self, bool skip=True)""" + """ + Skip(self, bool skip=True) + + Called by an event handler, it controls whether additional event + handlers bound to this event will be called after the current event + handler returns. Skip(false) (the default setting) will prevent + additional event handlers from being called and control will be + returned to the sender of the event immediately after the current + handler has finished. Skip(True) will cause the event processing + system to continue searching for a handler function for this event. + + """ return _core_.Event_Skip(*args, **kwargs) def GetSkipped(*args, **kwargs): @@ -3940,8 +3960,9 @@ class MoveEvent(Event): """SetPosition(self, Point pos)""" return _core_.MoveEvent_SetPosition(*args, **kwargs) - m_pos = property(_core_.MoveEvent_m_pos_get, _core_.MoveEvent_m_pos_set) - m_rect = property(_core_.MoveEvent_m_rect_get, _core_.MoveEvent_m_rect_set) + m_pos = property(GetPosition, SetPosition) + m_rect = property(GetRect, SetRect) + class MoveEventPtr(MoveEvent): def __init__(self, this): @@ -5284,6 +5305,12 @@ def SetDefaultPyEncoding(*args, **kwargs): Sets the encoding that wxPython will use when it needs to convert a Python string or unicode object to or from a wxString. + + The default encoding is the value of ``locale.getdefaultlocale()[1]`` + but please be aware that the default encoding within the same locale + may be slightly different on different platforms. For example, please + see http://www.alanwood.net/demos/charsetdiffs.html for differences + between the common latin/roman encodings. """ return _core_.SetDefaultPyEncoding(*args, **kwargs) @@ -6023,11 +6050,18 @@ class Window(EvtHandler): Sets the position and size of the window in pixels. The sizeFlags parameter indicates the interpretation of the other params if they are - -1. wx.SIZE_AUTO*: a -1 indicates that a class-specific default - shoudl be used. wx.SIZE_USE_EXISTING: existing dimensions should be - used if -1 values are supplied. wxSIZE_ALLOW_MINUS_ONE: allow - dimensions of -1 and less to be interpreted as real dimensions, not - default values. + equal to -1. + + ======================== ====================================== + wx.SIZE_AUTO A -1 indicates that a class-specific + default should be used. + wx.SIZE_USE_EXISTING Axisting dimensions should be used if + -1 values are supplied. + wxSIZE_ALLOW_MINUS_ONE Allow dimensions of -1 and less to be + interpreted as real dimensions, not + default values. + ======================== ====================================== + """ return _core_.Window_SetDimensions(*args, **kwargs) @@ -7087,7 +7121,7 @@ class Window(EvtHandler): def RefreshRect(*args, **kwargs): """ - RefreshRect(self, Rect rect) + RefreshRect(self, Rect rect, bool eraseBackground=True) Redraws the contents of the given rectangle: the area inside it will be repainted. This is the same as Refresh but has a nicer syntax. @@ -7326,6 +7360,21 @@ class Window(EvtHandler): """ return _core_.Window_GetBackgroundStyle(*args, **kwargs) + def HasTransparentBackground(*args, **kwargs): + """ + HasTransparentBackground(self) -> bool + + Returns True if this window's background is transparent (as, for + example, for `wx.StaticText`) and should show the parent window's + background. + + This method is mostly used internally by the library itself and you + normally shouldn't have to call it. You may, however, have to override + it in your custom control classes to ensure that background is painted + correctly. + """ + return _core_.Window_HasTransparentBackground(*args, **kwargs) + def SetCursor(*args, **kwargs): """ SetCursor(self, Cursor cursor) -> bool @@ -9672,7 +9721,7 @@ class Sizer(Object): def GetChildren(*args, **kwargs): """ - GetChildren(sefl) -> list + GetChildren(self) -> list Returns a list of all the `wx.SizerItem` objects managed by the sizer. """ @@ -9759,7 +9808,7 @@ class PySizer(Sizer): When `Layout` is called it first calls `CalcMin` followed by `RecalcSizes` so you can optimize a bit by saving the results of - `CalcMin` and resuing them in `RecalcSizes`. + `CalcMin` and reusing them in `RecalcSizes`. :see: `wx.SizerItem`, `wx.Sizer.GetChildren` @@ -10167,6 +10216,82 @@ class FlexGridSizerPtr(FlexGridSizer): self.__class__ = FlexGridSizer _core_.FlexGridSizer_swigregister(FlexGridSizerPtr) +class StdDialogButtonSizer(BoxSizer): + """ + A special sizer that knows how to order and position standard buttons + in order to conform to the current platform's standards. You simply + need to add each `wx.Button` to the sizer, and be sure to create the + buttons using the standard ID's. Then call `Finalize` and the sizer + will take care of the rest. + + """ + def __repr__(self): + return "<%s.%s; proxy of C++ wxStdDialogButtonSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,) + def __init__(self, *args, **kwargs): + """__init__(self) -> StdDialogButtonSizer""" + newobj = _core_.new_StdDialogButtonSizer(*args, **kwargs) + self.this = newobj.this + self.thisown = 1 + del newobj.thisown + def AddButton(*args, **kwargs): + """ + AddButton(self, wxButton button) + + Use this to add the buttons to this sizer. Do not use the `Add` + method in the base class. + """ + return _core_.StdDialogButtonSizer_AddButton(*args, **kwargs) + + def Finalise(*args, **kwargs): + """ + Finalise(self) + + This funciton needs to be called after all the buttons have been added + to the sizer. It will reorder them and position them in a platform + specifc manner. + """ + return _core_.StdDialogButtonSizer_Finalise(*args, **kwargs) + + def SetAffirmativeButton(*args, **kwargs): + """SetAffirmativeButton(self, wxButton button)""" + return _core_.StdDialogButtonSizer_SetAffirmativeButton(*args, **kwargs) + + def SetNegativeButton(*args, **kwargs): + """SetNegativeButton(self, wxButton button)""" + return _core_.StdDialogButtonSizer_SetNegativeButton(*args, **kwargs) + + def SetCancelButton(*args, **kwargs): + """SetCancelButton(self, wxButton button)""" + return _core_.StdDialogButtonSizer_SetCancelButton(*args, **kwargs) + + def GetAffirmativeButton(*args, **kwargs): + """GetAffirmativeButton(self) -> wxButton""" + return _core_.StdDialogButtonSizer_GetAffirmativeButton(*args, **kwargs) + + def GetApplyButton(*args, **kwargs): + """GetApplyButton(self) -> wxButton""" + return _core_.StdDialogButtonSizer_GetApplyButton(*args, **kwargs) + + def GetNegativeButton(*args, **kwargs): + """GetNegativeButton(self) -> wxButton""" + return _core_.StdDialogButtonSizer_GetNegativeButton(*args, **kwargs) + + def GetCancelButton(*args, **kwargs): + """GetCancelButton(self) -> wxButton""" + return _core_.StdDialogButtonSizer_GetCancelButton(*args, **kwargs) + + def GetHelpButton(*args, **kwargs): + """GetHelpButton(self) -> wxButton""" + return _core_.StdDialogButtonSizer_GetHelpButton(*args, **kwargs) + + +class StdDialogButtonSizerPtr(StdDialogButtonSizer): + def __init__(self, this): + self.this = this + if not hasattr(self,"thisown"): self.thisown = 0 + self.__class__ = StdDialogButtonSizer +_core_.StdDialogButtonSizer_swigregister(StdDialogButtonSizerPtr) + #--------------------------------------------------------------------------- class GBPosition(object): @@ -10968,7 +11093,13 @@ if RELEASE_VERSION != _core_.RELEASE_VERSION: #---------------------------------------------------------------------------- -# Set the default string conversion encoding from the locale +# Set the default string<-->unicode conversion encoding from the +# locale. This encoding is used when string or unicode objects need +# to be converted in order to pass them to wxWidgets. Please be aware +# that the default encoding within the same locale may be slightly +# different on different platforms. For example, please see +# http://www.alanwood.net/demos/charsetdiffs.html for differences +# between the common latin/roman encodings. import locale default = locale.getdefaultlocale()[1] if default: