X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/0085ce493764aeb971cb312126cf46184fcc6916..300b44a9336a9610fef256afb412e8fb6b51840f:/wxPython/src/gtk/_core.py diff --git a/wxPython/src/gtk/_core.py b/wxPython/src/gtk/_core.py index 94a9352223..71ef20270f 100644 --- a/wxPython/src/gtk/_core.py +++ b/wxPython/src/gtk/_core.py @@ -102,6 +102,7 @@ CENTRE_ON_SCREEN = _core_.CENTRE_ON_SCREEN CENTER_ON_SCREEN = _core_.CENTER_ON_SCREEN CLIP_CHILDREN = _core_.CLIP_CHILDREN CLIP_SIBLINGS = _core_.CLIP_SIBLINGS +WINDOW_STYLE_MASK = _core_.WINDOW_STYLE_MASK ALWAYS_SHOW_SB = _core_.ALWAYS_SHOW_SB RETAINED = _core_.RETAINED BACKINGSTORE = _core_.BACKINGSTORE @@ -115,8 +116,6 @@ LB_MULTIPLE = _core_.LB_MULTIPLE LB_EXTENDED = _core_.LB_EXTENDED LB_OWNERDRAW = _core_.LB_OWNERDRAW LB_HSCROLL = _core_.LB_HSCROLL -PROCESS_ENTER = _core_.PROCESS_ENTER -PASSWORD = _core_.PASSWORD CB_SIMPLE = _core_.CB_SIMPLE CB_DROPDOWN = _core_.CB_DROPDOWN CB_SORT = _core_.CB_SORT @@ -132,7 +131,6 @@ 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 FLOOD_BORDER = _core_.FLOOD_BORDER ODDEVEN_RULE = _core_.ODDEVEN_RULE @@ -148,6 +146,8 @@ YES = _core_.YES NO = _core_.NO NO_DEFAULT = _core_.NO_DEFAULT YES_DEFAULT = _core_.YES_DEFAULT +APPLY = _core_.APPLY +CLOSE = _core_.CLOSE ICON_EXCLAMATION = _core_.ICON_EXCLAMATION ICON_HAND = _core_.ICON_HAND ICON_QUESTION = _core_.ICON_QUESTION @@ -191,14 +191,18 @@ ID_REDO = _core_.ID_REDO ID_HELP = _core_.ID_HELP ID_PRINT = _core_.ID_PRINT ID_PRINT_SETUP = _core_.ID_PRINT_SETUP +ID_PAGE_SETUP = _core_.ID_PAGE_SETUP ID_PREVIEW = _core_.ID_PREVIEW ID_ABOUT = _core_.ID_ABOUT ID_HELP_CONTENTS = _core_.ID_HELP_CONTENTS ID_HELP_COMMANDS = _core_.ID_HELP_COMMANDS ID_HELP_PROCEDURES = _core_.ID_HELP_PROCEDURES ID_HELP_CONTEXT = _core_.ID_HELP_CONTEXT +ID_HELP_INDEX = _core_.ID_HELP_INDEX +ID_HELP_SEARCH = _core_.ID_HELP_SEARCH ID_CLOSE_ALL = _core_.ID_CLOSE_ALL ID_PREFERENCES = _core_.ID_PREFERENCES +ID_EDIT = _core_.ID_EDIT ID_CUT = _core_.ID_CUT ID_COPY = _core_.ID_COPY ID_PASTE = _core_.ID_PASTE @@ -218,6 +222,7 @@ ID_VIEW_SORTDATE = _core_.ID_VIEW_SORTDATE ID_VIEW_SORTNAME = _core_.ID_VIEW_SORTNAME ID_VIEW_SORTSIZE = _core_.ID_VIEW_SORTSIZE ID_VIEW_SORTTYPE = _core_.ID_VIEW_SORTTYPE +ID_FILE = _core_.ID_FILE ID_FILE1 = _core_.ID_FILE1 ID_FILE2 = _core_.ID_FILE2 ID_FILE3 = _core_.ID_FILE3 @@ -269,27 +274,6 @@ ID_ZOOM_OUT = _core_.ID_ZOOM_OUT ID_UNDELETE = _core_.ID_UNDELETE ID_REVERT_TO_SAVED = _core_.ID_REVERT_TO_SAVED ID_HIGHEST = _core_.ID_HIGHEST -OPEN = _core_.OPEN -SAVE = _core_.SAVE -HIDE_READONLY = _core_.HIDE_READONLY -OVERWRITE_PROMPT = _core_.OVERWRITE_PROMPT -FILE_MUST_EXIST = _core_.FILE_MUST_EXIST -MULTIPLE = _core_.MULTIPLE -CHANGE_DIR = _core_.CHANGE_DIR -ACCEL_ALT = _core_.ACCEL_ALT -ACCEL_CTRL = _core_.ACCEL_CTRL -ACCEL_SHIFT = _core_.ACCEL_SHIFT -ACCEL_NORMAL = _core_.ACCEL_NORMAL -PD_AUTO_HIDE = _core_.PD_AUTO_HIDE -PD_APP_MODAL = _core_.PD_APP_MODAL -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 MB_DOCKABLE = _core_.MB_DOCKABLE NO_FULL_REPAINT_ON_RESIZE = _core_.NO_FULL_REPAINT_ON_RESIZE @@ -347,7 +331,7 @@ EXPAND = _core_.EXPAND SHAPED = _core_.SHAPED FIXED_MINSIZE = _core_.FIXED_MINSIZE TILE = _core_.TILE -ADJUST_MINSIZE = _core_.ADJUST_MINSIZE +ADJUST_MINSIZE = 0 BORDER_DEFAULT = _core_.BORDER_DEFAULT BORDER_NONE = _core_.BORDER_NONE BORDER_STATIC = _core_.BORDER_STATIC @@ -429,8 +413,6 @@ WXK_CONTROL = _core_.WXK_CONTROL WXK_MENU = _core_.WXK_MENU WXK_PAUSE = _core_.WXK_PAUSE WXK_CAPITAL = _core_.WXK_CAPITAL -WXK_PRIOR = _core_.WXK_PRIOR -WXK_NEXT = _core_.WXK_NEXT WXK_END = _core_.WXK_END WXK_HOME = _core_.WXK_HOME WXK_LEFT = _core_.WXK_LEFT @@ -499,9 +481,7 @@ WXK_NUMPAD_LEFT = _core_.WXK_NUMPAD_LEFT WXK_NUMPAD_UP = _core_.WXK_NUMPAD_UP WXK_NUMPAD_RIGHT = _core_.WXK_NUMPAD_RIGHT WXK_NUMPAD_DOWN = _core_.WXK_NUMPAD_DOWN -WXK_NUMPAD_PRIOR = _core_.WXK_NUMPAD_PRIOR WXK_NUMPAD_PAGEUP = _core_.WXK_NUMPAD_PAGEUP -WXK_NUMPAD_NEXT = _core_.WXK_NUMPAD_NEXT WXK_NUMPAD_PAGEDOWN = _core_.WXK_NUMPAD_PAGEDOWN WXK_NUMPAD_END = _core_.WXK_NUMPAD_END WXK_NUMPAD_BEGIN = _core_.WXK_NUMPAD_BEGIN @@ -538,6 +518,11 @@ WXK_SPECIAL17 = _core_.WXK_SPECIAL17 WXK_SPECIAL18 = _core_.WXK_SPECIAL18 WXK_SPECIAL19 = _core_.WXK_SPECIAL19 WXK_SPECIAL20 = _core_.WXK_SPECIAL20 +WXK_PRIOR = WXK_PAGEUP +WXK_NEXT = WXK_PAGEDOWN +WXK_NUMPAD_PRIOR = WXK_NUMPAD_PAGEUP +WXK_NUMPAD_NEXT = WXK_NUMPAD_PAGEDOWN + PAPER_NONE = _core_.PAPER_NONE PAPER_LETTER = _core_.PAPER_LETTER PAPER_LEGAL = _core_.PAPER_LEGAL @@ -691,6 +676,9 @@ MOD_ALL = _core_.MOD_ALL UPDATE_UI_NONE = _core_.UPDATE_UI_NONE UPDATE_UI_RECURSE = _core_.UPDATE_UI_RECURSE UPDATE_UI_FROMIDLE = _core_.UPDATE_UI_FROMIDLE +Layout_Default = _core_.Layout_Default +Layout_LeftToRight = _core_.Layout_LeftToRight +Layout_RightToLeft = _core_.Layout_RightToLeft #--------------------------------------------------------------------------- class Object(object): @@ -715,14 +703,22 @@ class Object(object): Deletes the C++ object this Python object is a proxy for. """ - val = _core_.Object_Destroy(*args, **kwargs) - args[0].thisown = 0 - return val + args[0].this.own(False) + return _core_.Object_Destroy(*args, **kwargs) + + def IsSameAs(*args, **kwargs): + """ + IsSameAs(self, Object p) -> bool -Object_swigregister = _core_.Object_swigregister -Object_swigregister(Object) + For wx.Objects that use C++ reference counting internally, this method + can be used to determine if two objects are referencing the same data + object. + """ + return _core_.Object_IsSameAs(*args, **kwargs) + + ClassName = property(GetClassName,doc="See `GetClassName`") +_core_.Object_swigregister(Object) _wxPySetDictionary = _core_._wxPySetDictionary -_wxPyFixStockObjects = _core_._wxPyFixStockObjects cvar = _core_.cvar EmptyString = cvar.EmptyString @@ -746,6 +742,7 @@ BITMAP_TYPE_PICT = _core_.BITMAP_TYPE_PICT BITMAP_TYPE_ICON = _core_.BITMAP_TYPE_ICON BITMAP_TYPE_ANI = _core_.BITMAP_TYPE_ANI BITMAP_TYPE_IFF = _core_.BITMAP_TYPE_IFF +BITMAP_TYPE_TGA = _core_.BITMAP_TYPE_TGA BITMAP_TYPE_MACCURSOR = _core_.BITMAP_TYPE_MACCURSOR BITMAP_TYPE_ANY = _core_.BITMAP_TYPE_ANY CURSOR_NONE = _core_.CURSOR_NONE @@ -804,7 +801,7 @@ class Size(object): __del__ = lambda self : None; def __eq__(*args, **kwargs): """ - __eq__(self, Size sz) -> bool + __eq__(self, PyObject other) -> bool Test for equality of wx.Size objects. """ @@ -812,9 +809,9 @@ class Size(object): def __ne__(*args, **kwargs): """ - __ne__(self, Size sz) -> bool + __ne__(self, PyObject other) -> bool - Test for inequality. + Test for inequality of wx.Size objects. """ return _core_.Size___ne__(*args, **kwargs) @@ -852,6 +849,22 @@ class Size(object): """ return _core_.Size_DecTo(*args, **kwargs) + def IncBy(*args, **kwargs): + """IncBy(self, int dx, int dy)""" + return _core_.Size_IncBy(*args, **kwargs) + + def DecBy(*args, **kwargs): + """DecBy(self, int dx, int dy)""" + return _core_.Size_DecBy(*args, **kwargs) + + def Scale(*args, **kwargs): + """ + Scale(self, float xscale, float yscale) + + Scales the dimensions of this object by the given factors. + """ + return _core_.Size_Scale(*args, **kwargs) + def Set(*args, **kwargs): """ Set(self, int w, int h) @@ -914,8 +927,7 @@ class Size(object): __safe_for_unpickling__ = True def __reduce__(self): return (wx.Size, self.Get()) -Size_swigregister = _core_.Size_swigregister -Size_swigregister(Size) +_core_.Size_swigregister(Size) #--------------------------------------------------------------------------- @@ -940,7 +952,7 @@ class RealPoint(object): __del__ = lambda self : None; def __eq__(*args, **kwargs): """ - __eq__(self, RealPoint pt) -> bool + __eq__(self, PyObject other) -> bool Test for equality of wx.RealPoint objects. """ @@ -948,7 +960,7 @@ class RealPoint(object): def __ne__(*args, **kwargs): """ - __ne__(self, RealPoint pt) -> bool + __ne__(self, PyObject other) -> bool Test for inequality of wx.RealPoint objects. """ @@ -999,8 +1011,7 @@ class RealPoint(object): __safe_for_unpickling__ = True def __reduce__(self): return (wx.RealPoint, self.Get()) -RealPoint_swigregister = _core_.RealPoint_swigregister -RealPoint_swigregister(RealPoint) +_core_.RealPoint_swigregister(RealPoint) #--------------------------------------------------------------------------- @@ -1025,7 +1036,7 @@ class Point(object): __del__ = lambda self : None; def __eq__(*args, **kwargs): """ - __eq__(self, Point pt) -> bool + __eq__(self, PyObject other) -> bool Test for equality of wx.Point objects. """ @@ -1033,7 +1044,7 @@ class Point(object): def __ne__(*args, **kwargs): """ - __ne__(self, Point pt) -> bool + __ne__(self, PyObject other) -> bool Test for inequality of wx.Point objects. """ @@ -1100,8 +1111,7 @@ class Point(object): __safe_for_unpickling__ = True def __reduce__(self): return (wx.Point, self.Get()) -Point_swigregister = _core_.Point_swigregister -Point_swigregister(Point) +_core_.Point_swigregister(Point) #--------------------------------------------------------------------------- @@ -1190,6 +1200,22 @@ class Rect(object): """SetBottomRight(self, Point p)""" return _core_.Rect_SetBottomRight(*args, **kwargs) + def GetTopRight(*args, **kwargs): + """GetTopRight(self) -> Point""" + return _core_.Rect_GetTopRight(*args, **kwargs) + + def SetTopRight(*args, **kwargs): + """SetTopRight(self, Point p)""" + return _core_.Rect_SetTopRight(*args, **kwargs) + + def GetBottomLeft(*args, **kwargs): + """GetBottomLeft(self) -> Point""" + return _core_.Rect_GetBottomLeft(*args, **kwargs) + + def SetBottomLeft(*args, **kwargs): + """SetBottomLeft(self, Point p)""" + return _core_.Rect_SetBottomLeft(*args, **kwargs) + def GetLeft(*args, **kwargs): """GetLeft(self) -> int""" return _core_.Rect_GetLeft(*args, **kwargs) @@ -1316,35 +1342,51 @@ class Rect(object): def __eq__(*args, **kwargs): """ - __eq__(self, Rect rect) -> bool + __eq__(self, PyObject other) -> bool - Test for equality. + Test for equality of wx.Rect objects. """ return _core_.Rect___eq__(*args, **kwargs) def __ne__(*args, **kwargs): """ - __ne__(self, Rect rect) -> bool + __ne__(self, PyObject other) -> bool - Test for inequality. + Test for inequality of wx.Rect objects. """ return _core_.Rect___ne__(*args, **kwargs) - def InsideXY(*args, **kwargs): + def ContainsXY(*args, **kwargs): + """ + ContainsXY(self, int x, int y) -> bool + + Return True if the point is inside the rect. """ - InsideXY(self, int x, int y) -> bool + return _core_.Rect_ContainsXY(*args, **kwargs) - Return True if the point is (not strcitly) inside the rect. + def Contains(*args, **kwargs): """ - return _core_.Rect_InsideXY(*args, **kwargs) + Contains(self, Point pt) -> bool - def Inside(*args, **kwargs): + Return True if the point is inside the rect. """ - Inside(self, Point pt) -> bool + return _core_.Rect_Contains(*args, **kwargs) - Return True if the point is (not strcitly) inside the rect. + def ContainsRect(*args, **kwargs): """ - return _core_.Rect_Inside(*args, **kwargs) + ContainsRect(self, Rect rect) -> bool + + Returns ``True`` if the given rectangle is completely inside this + rectangle or touches its boundary. + """ + return _core_.Rect_ContainsRect(*args, **kwargs) + + #Inside = wx._deprecated(Contains, "Use `Contains` instead.") + #InsideXY = wx._deprecated(ContainsXY, "Use `ContainsXY` instead.") + #InsideRect = wx._deprecated(ContainsRect, "Use `ContainsRect` instead.") + Inside = Contains + InsideXY = ContainsXY + InsideRect = ContainsRect def Intersects(*args, **kwargs): """ @@ -1399,8 +1441,22 @@ class Rect(object): __safe_for_unpickling__ = True def __reduce__(self): return (wx.Rect, self.Get()) -Rect_swigregister = _core_.Rect_swigregister -Rect_swigregister(Rect) + Bottom = property(GetBottom,SetBottom,doc="See `GetBottom` and `SetBottom`") + BottomRight = property(GetBottomRight,SetBottomRight,doc="See `GetBottomRight` and `SetBottomRight`") + BottomLeft = property(GetBottomLeft,SetBottomLeft,doc="See `GetBottomLeft` and `SetBottomLeft`") + Height = property(GetHeight,SetHeight,doc="See `GetHeight` and `SetHeight`") + Left = property(GetLeft,SetLeft,doc="See `GetLeft` and `SetLeft`") + Position = property(GetPosition,SetPosition,doc="See `GetPosition` and `SetPosition`") + Right = property(GetRight,SetRight,doc="See `GetRight` and `SetRight`") + Size = property(GetSize,SetSize,doc="See `GetSize` and `SetSize`") + Top = property(GetTop,SetTop,doc="See `GetTop` and `SetTop`") + TopLeft = property(GetTopLeft,SetTopLeft,doc="See `GetTopLeft` and `SetTopLeft`") + TopRight = property(GetTopRight,SetTopRight,doc="See `GetTopRight` and `SetTopRight`") + Width = property(GetWidth,SetWidth,doc="See `GetWidth` and `SetWidth`") + X = property(GetX,SetX,doc="See `GetX` and `SetX`") + Y = property(GetY,SetY,doc="See `GetY` and `SetY`") + Empty = property(IsEmpty,doc="See `IsEmpty`") +_core_.Rect_swigregister(Rect) def RectPP(*args, **kwargs): """ @@ -1453,6 +1509,8 @@ class Point2D(object): Create a w.Point2D object. """ _core_.Point2D_swiginit(self,_core_.new_Point2D(*args, **kwargs)) + __swig_destroy__ = _core_.delete_Point2D + __del__ = lambda self : None; def GetFloor(*args, **kwargs): """ GetFloor() -> (x,y) @@ -1533,17 +1591,17 @@ class Point2D(object): def __eq__(*args, **kwargs): """ - __eq__(self, Point2D pt) -> bool + __eq__(self, PyObject other) -> bool - Test for equality + Test for equality of wx.Point2D objects. """ return _core_.Point2D___eq__(*args, **kwargs) def __ne__(*args, **kwargs): """ - __ne__(self, Point2D pt) -> bool + __ne__(self, PyObject other) -> bool - Test for inequality + Test for inequality of wx.Point2D objects. """ return _core_.Point2D___ne__(*args, **kwargs) @@ -1574,8 +1632,11 @@ class Point2D(object): __safe_for_unpickling__ = True def __reduce__(self): return (wx.Point2D, self.Get()) -Point2D_swigregister = _core_.Point2D_swigregister -Point2D_swigregister(Point2D) + Floor = property(GetFloor,doc="See `GetFloor`") + Rounded = property(GetRounded,doc="See `GetRounded`") + VectorAngle = property(GetVectorAngle,SetVectorAngle,doc="See `GetVectorAngle` and `SetVectorAngle`") + VectorLength = property(GetVectorLength,SetVectorLength,doc="See `GetVectorLength` and `SetVectorLength`") +_core_.Point2D_swigregister(Point2D) def Point2DCopy(*args, **kwargs): """ @@ -1597,6 +1658,327 @@ def Point2DFromPoint(*args, **kwargs): #--------------------------------------------------------------------------- +Inside = _core_.Inside +OutLeft = _core_.OutLeft +OutRight = _core_.OutRight +OutTop = _core_.OutTop +OutBottom = _core_.OutBottom +class Rect2D(object): + """ + wx.Rect2D is a rectangle, with position and size, in a 2D coordinate system + with floating point component values. + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self, wxDouble x=0.0, wxDouble y=0.0, wxDouble w=0.0, wxDouble h=0.0) -> Rect2D + + wx.Rect2D is a rectangle, with position and size, in a 2D coordinate system + with floating point component values. + """ + _core_.Rect2D_swiginit(self,_core_.new_Rect2D(*args, **kwargs)) + __swig_destroy__ = _core_.delete_Rect2D + __del__ = lambda self : None; + def GetPosition(*args, **kwargs): + """GetPosition(self) -> Point2D""" + return _core_.Rect2D_GetPosition(*args, **kwargs) + + def GetSize(*args, **kwargs): + """GetSize(self) -> Size""" + return _core_.Rect2D_GetSize(*args, **kwargs) + + def GetLeft(*args, **kwargs): + """GetLeft(self) -> wxDouble""" + return _core_.Rect2D_GetLeft(*args, **kwargs) + + def SetLeft(*args, **kwargs): + """SetLeft(self, wxDouble n)""" + return _core_.Rect2D_SetLeft(*args, **kwargs) + + def MoveLeftTo(*args, **kwargs): + """MoveLeftTo(self, wxDouble n)""" + return _core_.Rect2D_MoveLeftTo(*args, **kwargs) + + def GetTop(*args, **kwargs): + """GetTop(self) -> wxDouble""" + return _core_.Rect2D_GetTop(*args, **kwargs) + + def SetTop(*args, **kwargs): + """SetTop(self, wxDouble n)""" + return _core_.Rect2D_SetTop(*args, **kwargs) + + def MoveTopTo(*args, **kwargs): + """MoveTopTo(self, wxDouble n)""" + return _core_.Rect2D_MoveTopTo(*args, **kwargs) + + def GetBottom(*args, **kwargs): + """GetBottom(self) -> wxDouble""" + return _core_.Rect2D_GetBottom(*args, **kwargs) + + def SetBottom(*args, **kwargs): + """SetBottom(self, wxDouble n)""" + return _core_.Rect2D_SetBottom(*args, **kwargs) + + def MoveBottomTo(*args, **kwargs): + """MoveBottomTo(self, wxDouble n)""" + return _core_.Rect2D_MoveBottomTo(*args, **kwargs) + + def GetRight(*args, **kwargs): + """GetRight(self) -> wxDouble""" + return _core_.Rect2D_GetRight(*args, **kwargs) + + def SetRight(*args, **kwargs): + """SetRight(self, wxDouble n)""" + return _core_.Rect2D_SetRight(*args, **kwargs) + + def MoveRightTo(*args, **kwargs): + """MoveRightTo(self, wxDouble n)""" + return _core_.Rect2D_MoveRightTo(*args, **kwargs) + + def GetLeftTop(*args, **kwargs): + """GetLeftTop(self) -> Point2D""" + return _core_.Rect2D_GetLeftTop(*args, **kwargs) + + def SetLeftTop(*args, **kwargs): + """SetLeftTop(self, Point2D pt)""" + return _core_.Rect2D_SetLeftTop(*args, **kwargs) + + def MoveLeftTopTo(*args, **kwargs): + """MoveLeftTopTo(self, Point2D pt)""" + return _core_.Rect2D_MoveLeftTopTo(*args, **kwargs) + + def GetLeftBottom(*args, **kwargs): + """GetLeftBottom(self) -> Point2D""" + return _core_.Rect2D_GetLeftBottom(*args, **kwargs) + + def SetLeftBottom(*args, **kwargs): + """SetLeftBottom(self, Point2D pt)""" + return _core_.Rect2D_SetLeftBottom(*args, **kwargs) + + def MoveLeftBottomTo(*args, **kwargs): + """MoveLeftBottomTo(self, Point2D pt)""" + return _core_.Rect2D_MoveLeftBottomTo(*args, **kwargs) + + def GetRightTop(*args, **kwargs): + """GetRightTop(self) -> Point2D""" + return _core_.Rect2D_GetRightTop(*args, **kwargs) + + def SetRightTop(*args, **kwargs): + """SetRightTop(self, Point2D pt)""" + return _core_.Rect2D_SetRightTop(*args, **kwargs) + + def MoveRightTopTo(*args, **kwargs): + """MoveRightTopTo(self, Point2D pt)""" + return _core_.Rect2D_MoveRightTopTo(*args, **kwargs) + + def GetRightBottom(*args, **kwargs): + """GetRightBottom(self) -> Point2D""" + return _core_.Rect2D_GetRightBottom(*args, **kwargs) + + def SetRightBottom(*args, **kwargs): + """SetRightBottom(self, Point2D pt)""" + return _core_.Rect2D_SetRightBottom(*args, **kwargs) + + def MoveRightBottomTo(*args, **kwargs): + """MoveRightBottomTo(self, Point2D pt)""" + return _core_.Rect2D_MoveRightBottomTo(*args, **kwargs) + + def GetCentre(*args, **kwargs): + """GetCentre(self) -> Point2D""" + return _core_.Rect2D_GetCentre(*args, **kwargs) + + def SetCentre(*args, **kwargs): + """SetCentre(self, Point2D pt)""" + return _core_.Rect2D_SetCentre(*args, **kwargs) + + def MoveCentreTo(*args, **kwargs): + """MoveCentreTo(self, Point2D pt)""" + return _core_.Rect2D_MoveCentreTo(*args, **kwargs) + + def GetOutcode(*args, **kwargs): + """GetOutcode(self, Point2D pt) -> int""" + return _core_.Rect2D_GetOutcode(*args, **kwargs) + + def Contains(*args, **kwargs): + """Contains(self, Point2D pt) -> bool""" + return _core_.Rect2D_Contains(*args, **kwargs) + + def ContainsRect(*args, **kwargs): + """ContainsRect(self, Rect2D rect) -> bool""" + return _core_.Rect2D_ContainsRect(*args, **kwargs) + + def IsEmpty(*args, **kwargs): + """IsEmpty(self) -> bool""" + return _core_.Rect2D_IsEmpty(*args, **kwargs) + + def HaveEqualSize(*args, **kwargs): + """HaveEqualSize(self, Rect2D rect) -> bool""" + return _core_.Rect2D_HaveEqualSize(*args, **kwargs) + + def Inset(*args): + """ + Inset(self, wxDouble x, wxDouble y) + Inset(self, wxDouble left, wxDouble top, wxDouble right, wxDouble bottom) + """ + return _core_.Rect2D_Inset(*args) + + def Offset(*args, **kwargs): + """Offset(self, Point2D pt)""" + return _core_.Rect2D_Offset(*args, **kwargs) + + def ConstrainTo(*args, **kwargs): + """ConstrainTo(self, Rect2D rect)""" + return _core_.Rect2D_ConstrainTo(*args, **kwargs) + + def Interpolate(*args, **kwargs): + """Interpolate(self, int widthfactor, int heightfactor) -> Point2D""" + return _core_.Rect2D_Interpolate(*args, **kwargs) + + def Intersect(*args, **kwargs): + """Intersect(self, Rect2D otherRect)""" + return _core_.Rect2D_Intersect(*args, **kwargs) + + def CreateIntersection(*args, **kwargs): + """CreateIntersection(self, Rect2D otherRect) -> Rect2D""" + return _core_.Rect2D_CreateIntersection(*args, **kwargs) + + def Intersects(*args, **kwargs): + """Intersects(self, Rect2D rect) -> bool""" + return _core_.Rect2D_Intersects(*args, **kwargs) + + def Union(*args, **kwargs): + """Union(self, Rect2D otherRect)""" + return _core_.Rect2D_Union(*args, **kwargs) + + def CreateUnion(*args, **kwargs): + """CreateUnion(self, Rect2D otherRect) -> Rect2D""" + return _core_.Rect2D_CreateUnion(*args, **kwargs) + + def Scale(*args): + """ + Scale(self, wxDouble f) + Scale(self, int num, int denum) + """ + return _core_.Rect2D_Scale(*args) + + def __eq__(*args, **kwargs): + """ + __eq__(self, PyObject other) -> bool + + Test for equality of wx.Rect2D objects. + """ + return _core_.Rect2D___eq__(*args, **kwargs) + + def __ne__(*args, **kwargs): + """ + __ne__(self, PyObject other) -> bool + + Test for inequality of wx.Rect2D objects. + """ + return _core_.Rect2D___ne__(*args, **kwargs) + + x = property(_core_.Rect2D_x_get, _core_.Rect2D_x_set) + y = property(_core_.Rect2D_y_get, _core_.Rect2D_y_set) + width = property(_core_.Rect2D_width_get, _core_.Rect2D_width_set) + height = property(_core_.Rect2D_height_get, _core_.Rect2D_height_set) + def Set(*args, **kwargs): + """Set(self, wxDouble x=0, wxDouble y=0, wxDouble width=0, wxDouble height=0)""" + return _core_.Rect2D_Set(*args, **kwargs) + + def Get(*args, **kwargs): + """ + Get() -> (x,y, width, height) + + Return x, y, width and height y properties as a tuple. + """ + return _core_.Rect2D_Get(*args, **kwargs) + + def __str__(self): return str(self.Get()) + def __repr__(self): return 'wx.Rect2D'+str(self.Get()) + def __len__(self): return len(self.Get()) + def __getitem__(self, index): return self.Get()[index] + def __setitem__(self, index, val): + if index == 0: self.x = val + elif index == 1: self.y = val + elif index == 2: self.width = val + elif index == 3: self.height = val + else: raise IndexError + def __nonzero__(self): return self.Get() != (0.0, 0.0, 0.0, 0.0) + __safe_for_unpickling__ = True + def __reduce__(self): return (wx.Rect2D, self.Get()) + +_core_.Rect2D_swigregister(Rect2D) + +class Position(object): + """Proxy of C++ Position class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """__init__(self, int row=0, int col=0) -> Position""" + _core_.Position_swiginit(self,_core_.new_Position(*args, **kwargs)) + __swig_destroy__ = _core_.delete_Position + __del__ = lambda self : None; + def GetRow(*args, **kwargs): + """GetRow(self) -> int""" + return _core_.Position_GetRow(*args, **kwargs) + + def GetColumn(*args, **kwargs): + """GetColumn(self) -> int""" + return _core_.Position_GetColumn(*args, **kwargs) + + def GetCol(*args, **kwargs): + """GetCol(self) -> int""" + return _core_.Position_GetCol(*args, **kwargs) + + def SetRow(*args, **kwargs): + """SetRow(self, int row)""" + return _core_.Position_SetRow(*args, **kwargs) + + def SetColumn(*args, **kwargs): + """SetColumn(self, int column)""" + return _core_.Position_SetColumn(*args, **kwargs) + + def SetCol(*args, **kwargs): + """SetCol(self, int column)""" + return _core_.Position_SetCol(*args, **kwargs) + + def __eq__(*args, **kwargs): + """ + __eq__(self, PyObject other) -> bool + + Test for equality of wx.Position objects. + """ + return _core_.Position___eq__(*args, **kwargs) + + def __ne__(*args, **kwargs): + """ + __ne__(self, PyObject other) -> bool + + Test for inequality of wx.Position objects. + """ + return _core_.Position___ne__(*args, **kwargs) + + def __add__(*args): + """ + __add__(self, Position p) -> Position + __add__(self, Size s) -> Position + """ + return _core_.Position___add__(*args) + + def __sub__(*args): + """ + __sub__(self, Position p) -> Position + __sub__(self, Size s) -> Position + """ + return _core_.Position___sub__(*args) + + row = property(GetRow,SetRow) + col = property(GetCol,SetCol) +_core_.Position_swigregister(Position) + +#--------------------------------------------------------------------------- + FromStart = _core_.FromStart FromCurrent = _core_.FromCurrent FromEnd = _core_.FromEnd @@ -1673,8 +2055,7 @@ class InputStream(object): """TellI(self) -> long""" return _core_.InputStream_TellI(*args, **kwargs) -InputStream_swigregister = _core_.InputStream_swigregister -InputStream_swigregister(InputStream) +_core_.InputStream_swigregister(InputStream) DefaultPosition = cvar.DefaultPosition DefaultSize = cvar.DefaultSize @@ -1691,8 +2072,7 @@ class OutputStream(object): """LastWrite(self) -> size_t""" return _core_.OutputStream_LastWrite(*args, **kwargs) -OutputStream_swigregister = _core_.OutputStream_swigregister -OutputStream_swigregister(OutputStream) +_core_.OutputStream_swigregister(OutputStream) #--------------------------------------------------------------------------- @@ -1706,14 +2086,16 @@ class FSFile(Object): DateTime modif) -> FSFile """ _core_.FSFile_swiginit(self,_core_.new_FSFile(*args, **kwargs)) - self.thisown = 0 # It will normally be deleted by the user of the wx.FileSystem - __swig_destroy__ = _core_.delete_FSFile __del__ = lambda self : None; def GetStream(*args, **kwargs): """GetStream(self) -> InputStream""" return _core_.FSFile_GetStream(*args, **kwargs) + def DetachStream(*args, **kwargs): + """DetachStream(self)""" + return _core_.FSFile_DetachStream(*args, **kwargs) + def GetMimeType(*args, **kwargs): """GetMimeType(self) -> String""" return _core_.FSFile_GetMimeType(*args, **kwargs) @@ -1730,16 +2112,21 @@ class FSFile(Object): """GetModificationTime(self) -> DateTime""" return _core_.FSFile_GetModificationTime(*args, **kwargs) -FSFile_swigregister = _core_.FSFile_swigregister -FSFile_swigregister(FSFile) + Anchor = property(GetAnchor,doc="See `GetAnchor`") + Location = property(GetLocation,doc="See `GetLocation`") + MimeType = property(GetMimeType,doc="See `GetMimeType`") + ModificationTime = property(GetModificationTime,doc="See `GetModificationTime`") + Stream = property(GetStream,doc="See `GetStream`") +_core_.FSFile_swigregister(FSFile) class CPPFileSystemHandler(object): """Proxy of C++ CPPFileSystemHandler class""" thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') def __init__(self): raise AttributeError, "No constructor defined" __repr__ = _swig_repr -CPPFileSystemHandler_swigregister = _core_.CPPFileSystemHandler_swigregister -CPPFileSystemHandler_swigregister(CPPFileSystemHandler) + __swig_destroy__ = _core_.delete_CPPFileSystemHandler + __del__ = lambda self : None; +_core_.CPPFileSystemHandler_swigregister(CPPFileSystemHandler) class FileSystemHandler(CPPFileSystemHandler): """Proxy of C++ FileSystemHandler class""" @@ -1748,7 +2135,7 @@ class FileSystemHandler(CPPFileSystemHandler): def __init__(self, *args, **kwargs): """__init__(self) -> FileSystemHandler""" _core_.FileSystemHandler_swiginit(self,_core_.new_FileSystemHandler(*args, **kwargs)) - self._setCallbackInfo(self, FileSystemHandler) + FileSystemHandler._setCallbackInfo(self, self, FileSystemHandler) def _setCallbackInfo(*args, **kwargs): """_setCallbackInfo(self, PyObject self, PyObject _class)""" @@ -1790,8 +2177,12 @@ class FileSystemHandler(CPPFileSystemHandler): """GetMimeTypeFromExt(self, String location) -> String""" return _core_.FileSystemHandler_GetMimeTypeFromExt(*args, **kwargs) -FileSystemHandler_swigregister = _core_.FileSystemHandler_swigregister -FileSystemHandler_swigregister(FileSystemHandler) + Anchor = property(GetAnchor,doc="See `GetAnchor`") + LeftLocation = property(GetLeftLocation,doc="See `GetLeftLocation`") + MimeTypeFromExt = property(GetMimeTypeFromExt,doc="See `GetMimeTypeFromExt`") + Protocol = property(GetProtocol,doc="See `GetProtocol`") + RightLocation = property(GetRightLocation,doc="See `GetRightLocation`") +_core_.FileSystemHandler_swigregister(FileSystemHandler) class FileSystem(Object): """Proxy of C++ FileSystem class""" @@ -1827,6 +2218,11 @@ class FileSystem(Object): return _core_.FileSystem_AddHandler(*args, **kwargs) AddHandler = staticmethod(AddHandler) + def RemoveHandler(*args, **kwargs): + """RemoveHandler(CPPFileSystemHandler handler) -> CPPFileSystemHandler""" + return _core_.FileSystem_RemoveHandler(*args, **kwargs) + + RemoveHandler = staticmethod(RemoveHandler) def CleanUpHandlers(*args, **kwargs): """CleanUpHandlers()""" return _core_.FileSystem_CleanUpHandlers(*args, **kwargs) @@ -1842,13 +2238,17 @@ class FileSystem(Object): return _core_.FileSystem_URLToFileName(*args, **kwargs) URLToFileName = staticmethod(URLToFileName) -FileSystem_swigregister = _core_.FileSystem_swigregister -FileSystem_swigregister(FileSystem) + Path = property(GetPath,doc="See `GetPath`") +_core_.FileSystem_swigregister(FileSystem) def FileSystem_AddHandler(*args, **kwargs): """FileSystem_AddHandler(CPPFileSystemHandler handler)""" return _core_.FileSystem_AddHandler(*args, **kwargs) +def FileSystem_RemoveHandler(*args, **kwargs): + """FileSystem_RemoveHandler(CPPFileSystemHandler handler) -> CPPFileSystemHandler""" + return _core_.FileSystem_RemoveHandler(*args, **kwargs) + def FileSystem_CleanUpHandlers(*args): """FileSystem_CleanUpHandlers()""" return _core_.FileSystem_CleanUpHandlers(*args) @@ -1876,8 +2276,7 @@ class InternetFSHandler(CPPFileSystemHandler): """OpenFile(self, FileSystem fs, String location) -> FSFile""" return _core_.InternetFSHandler_OpenFile(*args, **kwargs) -InternetFSHandler_swigregister = _core_.InternetFSHandler_swigregister -InternetFSHandler_swigregister(InternetFSHandler) +_core_.InternetFSHandler_swigregister(InternetFSHandler) class ZipFSHandler(CPPFileSystemHandler): """Proxy of C++ ZipFSHandler class""" @@ -1902,8 +2301,7 @@ class ZipFSHandler(CPPFileSystemHandler): """FindNext(self) -> String""" return _core_.ZipFSHandler_FindNext(*args, **kwargs) -ZipFSHandler_swigregister = _core_.ZipFSHandler_swigregister -ZipFSHandler_swigregister(ZipFSHandler) +_core_.ZipFSHandler_swigregister(ZipFSHandler) def __wxMemoryFSHandler_AddFile_wxImage(*args, **kwargs): @@ -1963,8 +2361,7 @@ class MemoryFSHandler(CPPFileSystemHandler): """FindNext(self) -> String""" return _core_.MemoryFSHandler_FindNext(*args, **kwargs) -MemoryFSHandler_swigregister = _core_.MemoryFSHandler_swigregister -MemoryFSHandler_swigregister(MemoryFSHandler) +_core_.MemoryFSHandler_swigregister(MemoryFSHandler) def MemoryFSHandler_RemoveFile(*args, **kwargs): """MemoryFSHandler_RemoveFile(String filename)""" @@ -1973,6 +2370,8 @@ def MemoryFSHandler_RemoveFile(*args, **kwargs): IMAGE_ALPHA_TRANSPARENT = _core_.IMAGE_ALPHA_TRANSPARENT IMAGE_ALPHA_THRESHOLD = _core_.IMAGE_ALPHA_THRESHOLD IMAGE_ALPHA_OPAQUE = _core_.IMAGE_ALPHA_OPAQUE +IMAGE_QUALITY_NORMAL = _core_.IMAGE_QUALITY_NORMAL +IMAGE_QUALITY_HIGH = _core_.IMAGE_QUALITY_HIGH #--------------------------------------------------------------------------- class ImageHandler(Object): @@ -2004,6 +2403,10 @@ class ImageHandler(Object): """CanRead(self, String name) -> bool""" return _core_.ImageHandler_CanRead(*args, **kwargs) + def CanReadStream(*args, **kwargs): + """CanReadStream(self, InputStream stream) -> bool""" + return _core_.ImageHandler_CanReadStream(*args, **kwargs) + def SetName(*args, **kwargs): """SetName(self, String name)""" return _core_.ImageHandler_SetName(*args, **kwargs) @@ -2020,8 +2423,11 @@ class ImageHandler(Object): """SetMimeType(self, String mimetype)""" return _core_.ImageHandler_SetMimeType(*args, **kwargs) -ImageHandler_swigregister = _core_.ImageHandler_swigregister -ImageHandler_swigregister(ImageHandler) + Extension = property(GetExtension,SetExtension,doc="See `GetExtension` and `SetExtension`") + MimeType = property(GetMimeType,SetMimeType,doc="See `GetMimeType` and `SetMimeType`") + Name = property(GetName,SetName,doc="See `GetName` and `SetName`") + Type = property(GetType,SetType,doc="See `GetType` and `SetType`") +_core_.ImageHandler_swigregister(ImageHandler) class PyImageHandler(ImageHandler): """ @@ -2086,8 +2492,7 @@ class PyImageHandler(ImageHandler): """_SetSelf(self, PyObject self)""" return _core_.PyImageHandler__SetSelf(*args, **kwargs) -PyImageHandler_swigregister = _core_.PyImageHandler_swigregister -PyImageHandler_swigregister(PyImageHandler) +_core_.PyImageHandler_swigregister(PyImageHandler) class ImageHistogram(object): """Proxy of C++ ImageHistogram class""" @@ -2140,8 +2545,7 @@ class ImageHistogram(object): """ return _core_.ImageHistogram_GetCountColour(*args, **kwargs) -ImageHistogram_swigregister = _core_.ImageHistogram_swigregister -ImageHistogram_swigregister(ImageHistogram) +_core_.ImageHistogram_swigregister(ImageHistogram) def ImageHistogram_MakeKey(*args, **kwargs): """ @@ -2170,8 +2574,7 @@ class Image_RGBValue(object): red = property(_core_.Image_RGBValue_red_get, _core_.Image_RGBValue_red_set) green = property(_core_.Image_RGBValue_green_get, _core_.Image_RGBValue_green_set) blue = property(_core_.Image_RGBValue_blue_get, _core_.Image_RGBValue_blue_set) -Image_RGBValue_swigregister = _core_.Image_RGBValue_swigregister -Image_RGBValue_swigregister(Image_RGBValue) +_core_.Image_RGBValue_swigregister(Image_RGBValue) class Image_HSVValue(object): """ @@ -2192,8 +2595,7 @@ class Image_HSVValue(object): hue = property(_core_.Image_HSVValue_hue_get, _core_.Image_HSVValue_hue_set) saturation = property(_core_.Image_HSVValue_saturation_get, _core_.Image_HSVValue_saturation_set) value = property(_core_.Image_HSVValue_value_get, _core_.Image_HSVValue_value_set) -Image_HSVValue_swigregister = _core_.Image_HSVValue_swigregister -Image_HSVValue_swigregister(Image_HSVValue) +_core_.Image_HSVValue_swigregister(Image_HSVValue) class Image(Object): """ @@ -2248,20 +2650,61 @@ class Image(Object): Destroys the image data. """ - val = _core_.Image_Destroy(*args, **kwargs) - args[0].thisown = 0 - return val + args[0].this.own(False) + return _core_.Image_Destroy(*args, **kwargs) def Scale(*args, **kwargs): """ - Scale(self, int width, int height) -> Image + Scale(self, int width, int height, int quality=IMAGE_QUALITY_NORMAL) -> Image Returns a scaled version of the image. This is also useful for scaling bitmaps in general as the only other way to scale bitmaps is to blit a - `wx.MemoryDC` into another `wx.MemoryDC`. + `wx.MemoryDC` into another `wx.MemoryDC`. The ``quality`` parameter + specifies what method to use for resampling the image. It can be + either wx.IMAGE_QUALITY_NORMAL, which uses the normal default scaling + method of pixel replication, or wx.IMAGE_QUALITY_HIGH which uses + bicubic and box averaging resampling methods for upsampling and + downsampling respectively. """ return _core_.Image_Scale(*args, **kwargs) + def ResampleBox(*args, **kwargs): + """ResampleBox(self, int width, int height) -> Image""" + return _core_.Image_ResampleBox(*args, **kwargs) + + def ResampleBicubic(*args, **kwargs): + """ResampleBicubic(self, int width, int height) -> Image""" + return _core_.Image_ResampleBicubic(*args, **kwargs) + + def Blur(*args, **kwargs): + """ + Blur(self, int radius) -> Image + + Blurs the image in both horizontal and vertical directions by the + specified pixel ``radius``. This should not be used when using a + single mask colour for transparency. + """ + return _core_.Image_Blur(*args, **kwargs) + + def BlurHorizontal(*args, **kwargs): + """ + BlurHorizontal(self, int radius) -> Image + + Blurs the image in the horizontal direction only. This should not be + used when using a single mask colour for transparency. + + """ + return _core_.Image_BlurHorizontal(*args, **kwargs) + + def BlurVertical(*args, **kwargs): + """ + BlurVertical(self, int radius) -> Image + + Blurs the image in the vertical direction only. This should not be + used when using a single mask colour for transparency. + """ + return _core_.Image_BlurVertical(*args, **kwargs) + def ShrinkBy(*args, **kwargs): """ ShrinkBy(self, int xFactor, int yFactor) -> Image @@ -2272,7 +2715,7 @@ class Image(Object): def Rescale(*args, **kwargs): """ - Rescale(self, int width, int height) -> Image + Rescale(self, int width, int height, int quality=IMAGE_QUALITY_NORMAL) -> Image Changes the size of the image in-place by scaling it: after a call to this function, the image will have the given width and height. @@ -2536,14 +2979,15 @@ class Image(Object): """ return _core_.Image_LoadMimeStream(*args, **kwargs) - def Ok(*args, **kwargs): + def IsOk(*args, **kwargs): """ - Ok(self) -> bool + IsOk(self) -> bool Returns true if image data is present. """ - return _core_.Image_Ok(*args, **kwargs) + return _core_.Image_IsOk(*args, **kwargs) + Ok = IsOk def GetWidth(*args, **kwargs): """ GetWidth(self) -> int @@ -2665,11 +3109,23 @@ class Image(Object): return _core_.Image_SetAlphaData(*args, **kwargs) def GetAlphaBuffer(*args, **kwargs): - """GetAlphaBuffer(self) -> PyObject""" + """ + GetAlphaBuffer(self) -> PyObject + + Returns a writable Python buffer object that is pointing at the Alpha + data buffer inside the wx.Image. You need to ensure that you do not + use this buffer object after the image has been destroyed. + """ return _core_.Image_GetAlphaBuffer(*args, **kwargs) def SetAlphaBuffer(*args, **kwargs): - """SetAlphaBuffer(self, buffer alpha)""" + """ + SetAlphaBuffer(self, buffer alpha) + + Sets the internal image alpha pointer to point at a Python buffer + object. This can save making an extra copy of the data but you must + ensure that the buffer object lives as long as the wx.Image does. + """ return _core_.Image_SetAlphaBuffer(*args, **kwargs) def SetMaskColour(*args, **kwargs): @@ -2909,9 +3365,17 @@ class Image(Object): return _core_.Image_HSVtoRGB(*args, **kwargs) HSVtoRGB = staticmethod(HSVtoRGB) - def __nonzero__(self): return self.Ok() -Image_swigregister = _core_.Image_swigregister -Image_swigregister(Image) + def __nonzero__(self): return self.IsOk() + AlphaBuffer = property(GetAlphaBuffer,SetAlphaBuffer,doc="See `GetAlphaBuffer` and `SetAlphaBuffer`") + AlphaData = property(GetAlphaData,SetAlphaData,doc="See `GetAlphaData` and `SetAlphaData`") + Data = property(GetData,SetData,doc="See `GetData` and `SetData`") + DataBuffer = property(GetDataBuffer,SetDataBuffer,doc="See `GetDataBuffer` and `SetDataBuffer`") + Height = property(GetHeight,doc="See `GetHeight`") + MaskBlue = property(GetMaskBlue,doc="See `GetMaskBlue`") + MaskGreen = property(GetMaskGreen,doc="See `GetMaskGreen`") + MaskRed = property(GetMaskRed,doc="See `GetMaskRed`") + Width = property(GetWidth,doc="See `GetWidth`") +_core_.Image_swigregister(Image) def ImageFromMime(*args, **kwargs): """ @@ -3055,6 +3519,40 @@ def Image_HSVtoRGB(*args, **kwargs): """ return _core_.Image_HSVtoRGB(*args, **kwargs) + +def _ImageFromBuffer(*args, **kwargs): + """_ImageFromBuffer(int width, int height, buffer data, buffer alpha=None) -> Image""" + return _core_._ImageFromBuffer(*args, **kwargs) +def ImageFromBuffer(width, height, dataBuffer, alphaBuffer=None): + """ + Creates a `wx.Image` from the data in dataBuffer. The dataBuffer + parameter must be a Python object that implements the buffer interface, + such as a string, array, etc. The dataBuffer object is expected to + contain a series of RGB bytes and be width*height*3 bytes long. A buffer + object can optionally be supplied for the image's alpha channel data, and + it is expected to be width*height bytes long. + + The wx.Image will be created with its data and alpha pointers initialized + to the memory address pointed to by the buffer objects, thus saving the + time needed to copy the image data from the buffer object to the wx.Image. + While this has advantages, it also has the shoot-yourself-in-the-foot + risks associated with sharing a C pointer between two objects. + + To help alleviate the risk a reference to the data and alpha buffer + objects are kept with the wx.Image, so that they won't get deleted until + after the wx.Image is deleted. However please be aware that it is not + guaranteed that an object won't move its memory buffer to a new location + when it needs to resize its contents. If that happens then the wx.Image + will end up referring to an invalid memory location and could cause the + application to crash. Therefore care should be taken to not manipulate + the objects used for the data and alpha buffers in a way that would cause + them to change size. + """ + image = _core_._ImageFromBuffer(width, height, dataBuffer, alphaBuffer) + image._buffer = dataBuffer + image._alpha = alphaBuffer + return image + def InitAllImageHandlers(): """ The former functionality of InitAllImageHanders is now done internal to @@ -3062,6 +3560,7 @@ def InitAllImageHandlers(): """ pass +IMAGE_RESOLUTION_NONE = _core_.IMAGE_RESOLUTION_NONE IMAGE_RESOLUTION_INCHES = _core_.IMAGE_RESOLUTION_INCHES IMAGE_RESOLUTION_CM = _core_.IMAGE_RESOLUTION_CM PNG_TYPE_COLOUR = _core_.PNG_TYPE_COLOUR @@ -3087,8 +3586,7 @@ class BMPHandler(ImageHandler): A `wx.ImageHandler` for \*.bmp bitmap files. """ _core_.BMPHandler_swiginit(self,_core_.new_BMPHandler(*args, **kwargs)) -BMPHandler_swigregister = _core_.BMPHandler_swigregister -BMPHandler_swigregister(BMPHandler) +_core_.BMPHandler_swigregister(BMPHandler) NullImage = cvar.NullImage IMAGE_OPTION_FILENAME = cvar.IMAGE_OPTION_FILENAME IMAGE_OPTION_BMP_FORMAT = cvar.IMAGE_OPTION_BMP_FORMAT @@ -3117,8 +3615,7 @@ class ICOHandler(BMPHandler): A `wx.ImageHandler` for \*.ico icon files. """ _core_.ICOHandler_swiginit(self,_core_.new_ICOHandler(*args, **kwargs)) -ICOHandler_swigregister = _core_.ICOHandler_swigregister -ICOHandler_swigregister(ICOHandler) +_core_.ICOHandler_swigregister(ICOHandler) class CURHandler(ICOHandler): """A `wx.ImageHandler` for \*.cur cursor files.""" @@ -3131,8 +3628,7 @@ class CURHandler(ICOHandler): A `wx.ImageHandler` for \*.cur cursor files. """ _core_.CURHandler_swiginit(self,_core_.new_CURHandler(*args, **kwargs)) -CURHandler_swigregister = _core_.CURHandler_swigregister -CURHandler_swigregister(CURHandler) +_core_.CURHandler_swigregister(CURHandler) class ANIHandler(CURHandler): """A `wx.ImageHandler` for \*.ani animated cursor files.""" @@ -3145,8 +3641,7 @@ class ANIHandler(CURHandler): A `wx.ImageHandler` for \*.ani animated cursor files. """ _core_.ANIHandler_swiginit(self,_core_.new_ANIHandler(*args, **kwargs)) -ANIHandler_swigregister = _core_.ANIHandler_swigregister -ANIHandler_swigregister(ANIHandler) +_core_.ANIHandler_swigregister(ANIHandler) class PNGHandler(ImageHandler): """A `wx.ImageHandler` for PNG image files.""" @@ -3159,8 +3654,7 @@ class PNGHandler(ImageHandler): A `wx.ImageHandler` for PNG image files. """ _core_.PNGHandler_swiginit(self,_core_.new_PNGHandler(*args, **kwargs)) -PNGHandler_swigregister = _core_.PNGHandler_swigregister -PNGHandler_swigregister(PNGHandler) +_core_.PNGHandler_swigregister(PNGHandler) class GIFHandler(ImageHandler): """A `wx.ImageHandler` for GIF image files.""" @@ -3173,8 +3667,7 @@ class GIFHandler(ImageHandler): A `wx.ImageHandler` for GIF image files. """ _core_.GIFHandler_swiginit(self,_core_.new_GIFHandler(*args, **kwargs)) -GIFHandler_swigregister = _core_.GIFHandler_swigregister -GIFHandler_swigregister(GIFHandler) +_core_.GIFHandler_swigregister(GIFHandler) class PCXHandler(ImageHandler): """A `wx.ImageHandler` for PCX imager files.""" @@ -3187,8 +3680,7 @@ class PCXHandler(ImageHandler): A `wx.ImageHandler` for PCX imager files. """ _core_.PCXHandler_swiginit(self,_core_.new_PCXHandler(*args, **kwargs)) -PCXHandler_swigregister = _core_.PCXHandler_swigregister -PCXHandler_swigregister(PCXHandler) +_core_.PCXHandler_swigregister(PCXHandler) class JPEGHandler(ImageHandler): """A `wx.ImageHandler` for JPEG/JPG image files.""" @@ -3201,8 +3693,7 @@ class JPEGHandler(ImageHandler): A `wx.ImageHandler` for JPEG/JPG image files. """ _core_.JPEGHandler_swiginit(self,_core_.new_JPEGHandler(*args, **kwargs)) -JPEGHandler_swigregister = _core_.JPEGHandler_swigregister -JPEGHandler_swigregister(JPEGHandler) +_core_.JPEGHandler_swigregister(JPEGHandler) class PNMHandler(ImageHandler): """A `wx.ImageHandler` for PNM image files.""" @@ -3215,8 +3706,7 @@ class PNMHandler(ImageHandler): A `wx.ImageHandler` for PNM image files. """ _core_.PNMHandler_swiginit(self,_core_.new_PNMHandler(*args, **kwargs)) -PNMHandler_swigregister = _core_.PNMHandler_swigregister -PNMHandler_swigregister(PNMHandler) +_core_.PNMHandler_swigregister(PNMHandler) class XPMHandler(ImageHandler): """A `wx.ImageHandler` for XPM image.""" @@ -3229,8 +3719,7 @@ class XPMHandler(ImageHandler): A `wx.ImageHandler` for XPM image. """ _core_.XPMHandler_swiginit(self,_core_.new_XPMHandler(*args, **kwargs)) -XPMHandler_swigregister = _core_.XPMHandler_swigregister -XPMHandler_swigregister(XPMHandler) +_core_.XPMHandler_swigregister(XPMHandler) class TIFFHandler(ImageHandler): """A `wx.ImageHandler` for TIFF image files.""" @@ -3243,8 +3732,20 @@ class TIFFHandler(ImageHandler): A `wx.ImageHandler` for TIFF image files. """ _core_.TIFFHandler_swiginit(self,_core_.new_TIFFHandler(*args, **kwargs)) -TIFFHandler_swigregister = _core_.TIFFHandler_swigregister -TIFFHandler_swigregister(TIFFHandler) +_core_.TIFFHandler_swigregister(TIFFHandler) + +class TGAHandler(ImageHandler): + """A `wx.ImageHandler` for TGA image files.""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self) -> TGAHandler + + A `wx.ImageHandler` for TGA image files. + """ + _core_.TGAHandler_swiginit(self,_core_.new_TGAHandler(*args, **kwargs)) +_core_.TGAHandler_swigregister(TGAHandler) QUANTIZE_INCLUDE_WINDOWS_COLOURS = _core_.QUANTIZE_INCLUDE_WINDOWS_COLOURS QUANTIZE_FILL_DESTINATION_IMAGE = _core_.QUANTIZE_FILL_DESTINATION_IMAGE @@ -3264,8 +3765,7 @@ class Quantize(object): return _core_.Quantize_Quantize(*args, **kwargs) Quantize = staticmethod(Quantize) -Quantize_swigregister = _core_.Quantize_swigregister -Quantize_swigregister(Quantize) +_core_.Quantize_swigregister(Quantize) def Quantize_Quantize(*args, **kwargs): """ @@ -3286,6 +3786,8 @@ class EvtHandler(Object): def __init__(self, *args, **kwargs): """__init__(self) -> EvtHandler""" _core_.EvtHandler_swiginit(self,_core_.new_EvtHandler(*args, **kwargs)) + self._setOORInfo(self) + def GetNextHandler(*args, **kwargs): """GetNextHandler(self) -> EvtHandler""" return _core_.EvtHandler_GetNextHandler(*args, **kwargs) @@ -3327,13 +3829,13 @@ class EvtHandler(Object): return _core_.EvtHandler_Connect(*args, **kwargs) def Disconnect(*args, **kwargs): - """Disconnect(self, int id, int lastId=-1, wxEventType eventType=wxEVT_NULL) -> bool""" + """Disconnect(self, int id, int lastId=-1, EventType eventType=wxEVT_NULL) -> bool""" return _core_.EvtHandler_Disconnect(*args, **kwargs) def _setOORInfo(*args, **kwargs): """_setOORInfo(self, PyObject _self, bool incref=True)""" val = _core_.EvtHandler__setOORInfo(*args, **kwargs) - args[0].thisown = 0 + args[0].this.own(False) return val def Bind(self, event, handler, source=None, id=wx.ID_ANY, id2=wx.ID_ANY): @@ -3375,8 +3877,10 @@ class EvtHandler(Object): id = source.GetId() return event.Unbind(self, id, id2) -EvtHandler_swigregister = _core_.EvtHandler_swigregister -EvtHandler_swigregister(EvtHandler) + EvtHandlerEnabled = property(GetEvtHandlerEnabled,SetEvtHandlerEnabled,doc="See `GetEvtHandlerEnabled` and `SetEvtHandlerEnabled`") + NextHandler = property(GetNextHandler,SetNextHandler,doc="See `GetNextHandler` and `SetNextHandler`") + PreviousHandler = property(GetPreviousHandler,SetPreviousHandler,doc="See `GetPreviousHandler` and `SetPreviousHandler`") +_core_.EvtHandler_swigregister(EvtHandler) #--------------------------------------------------------------------------- @@ -3409,6 +3913,15 @@ class PyEventBinder(object): success += target.Disconnect(id1, id2, et) return success != 0 + def _getEvtType(self): + """ + Make it easy to get to the default wxEventType typeID for this + event binder. + """ + return self.evtType[0] + + typeId = property(_getEvtType) + def __call__(self, *args): """ @@ -3451,8 +3964,9 @@ EVENT_PROPAGATE_NONE = _core_.EVENT_PROPAGATE_NONE EVENT_PROPAGATE_MAX = _core_.EVENT_PROPAGATE_MAX def NewEventType(*args): - """NewEventType() -> wxEventType""" + """NewEventType() -> EventType""" return _core_.NewEventType(*args) +wxEVT_ANY = _core_.wxEVT_ANY wxEVT_NULL = _core_.wxEVT_NULL wxEVT_FIRST = _core_.wxEVT_FIRST wxEVT_USER_FIRST = _core_.wxEVT_USER_FIRST @@ -3531,7 +4045,6 @@ wxEVT_CLOSE_WINDOW = _core_.wxEVT_CLOSE_WINDOW wxEVT_END_SESSION = _core_.wxEVT_END_SESSION wxEVT_QUERY_END_SESSION = _core_.wxEVT_QUERY_END_SESSION wxEVT_ACTIVATE_APP = _core_.wxEVT_ACTIVATE_APP -wxEVT_POWER = _core_.wxEVT_POWER wxEVT_ACTIVATE = _core_.wxEVT_ACTIVATE wxEVT_CREATE = _core_.wxEVT_CREATE wxEVT_DESTROY = _core_.wxEVT_DESTROY @@ -3539,6 +4052,7 @@ wxEVT_SHOW = _core_.wxEVT_SHOW wxEVT_ICONIZE = _core_.wxEVT_ICONIZE wxEVT_MAXIMIZE = _core_.wxEVT_MAXIMIZE wxEVT_MOUSE_CAPTURE_CHANGED = _core_.wxEVT_MOUSE_CAPTURE_CHANGED +wxEVT_MOUSE_CAPTURE_LOST = _core_.wxEVT_MOUSE_CAPTURE_LOST wxEVT_PAINT = _core_.wxEVT_PAINT wxEVT_ERASE_BACKGROUND = _core_.wxEVT_ERASE_BACKGROUND wxEVT_NC_PAINT = _core_.wxEVT_NC_PAINT @@ -3562,6 +4076,9 @@ wxEVT_UPDATE_UI = _core_.wxEVT_UPDATE_UI wxEVT_SIZING = _core_.wxEVT_SIZING wxEVT_MOVING = _core_.wxEVT_MOVING wxEVT_HIBERNATE = _core_.wxEVT_HIBERNATE +wxEVT_COMMAND_TEXT_COPY = _core_.wxEVT_COMMAND_TEXT_COPY +wxEVT_COMMAND_TEXT_CUT = _core_.wxEVT_COMMAND_TEXT_CUT +wxEVT_COMMAND_TEXT_PASTE = _core_.wxEVT_COMMAND_TEXT_PASTE wxEVT_COMMAND_LEFT_CLICK = _core_.wxEVT_COMMAND_LEFT_CLICK wxEVT_COMMAND_LEFT_DCLICK = _core_.wxEVT_COMMAND_LEFT_DCLICK wxEVT_COMMAND_RIGHT_CLICK = _core_.wxEVT_COMMAND_RIGHT_CLICK @@ -3584,7 +4101,7 @@ EVT_ERASE_BACKGROUND = wx.PyEventBinder( wxEVT_ERASE_BACKGROUND ) EVT_CHAR = wx.PyEventBinder( wxEVT_CHAR ) EVT_KEY_DOWN = wx.PyEventBinder( wxEVT_KEY_DOWN ) EVT_KEY_UP = wx.PyEventBinder( wxEVT_KEY_UP ) -EVT_HOTKEY = wx.PyEventBinder( wxEVT_HOTKEY, 1) +EVT_HOTKEY = wx.PyEventBinder( wxEVT_HOTKEY, 1) EVT_CHAR_HOOK = wx.PyEventBinder( wxEVT_CHAR_HOOK ) EVT_MENU_OPEN = wx.PyEventBinder( wxEVT_MENU_OPEN ) EVT_MENU_CLOSE = wx.PyEventBinder( wxEVT_MENU_CLOSE ) @@ -3595,7 +4112,7 @@ EVT_KILL_FOCUS = wx.PyEventBinder( wxEVT_KILL_FOCUS ) EVT_CHILD_FOCUS = wx.PyEventBinder( wxEVT_CHILD_FOCUS ) EVT_ACTIVATE = wx.PyEventBinder( wxEVT_ACTIVATE ) EVT_ACTIVATE_APP = wx.PyEventBinder( wxEVT_ACTIVATE_APP ) -EVT_HIBERNATE = wx.PyEventBinder( wxEVT_HIBERNATE ) +EVT_HIBERNATE = wx.PyEventBinder( wxEVT_HIBERNATE ) EVT_END_SESSION = wx.PyEventBinder( wxEVT_END_SESSION ) EVT_QUERY_END_SESSION = wx.PyEventBinder( wxEVT_QUERY_END_SESSION ) EVT_DROP_FILES = wx.PyEventBinder( wxEVT_DROP_FILES ) @@ -3612,6 +4129,7 @@ EVT_WINDOW_CREATE = wx.PyEventBinder( wxEVT_CREATE ) EVT_WINDOW_DESTROY = wx.PyEventBinder( wxEVT_DESTROY ) EVT_SET_CURSOR = wx.PyEventBinder( wxEVT_SET_CURSOR ) EVT_MOUSE_CAPTURE_CHANGED = wx.PyEventBinder( wxEVT_MOUSE_CAPTURE_CHANGED ) +EVT_MOUSE_CAPTURE_LOST = wx.PyEventBinder( wxEVT_MOUSE_CAPTURE_LOST ) EVT_LEFT_DOWN = wx.PyEventBinder( wxEVT_LEFT_DOWN ) EVT_LEFT_UP = wx.PyEventBinder( wxEVT_LEFT_UP ) @@ -3644,11 +4162,11 @@ EVT_MOUSE_EVENTS = wx.PyEventBinder([ wxEVT_LEFT_DOWN, # Scrolling from wxWindow (sent to wxScrolledWindow) -EVT_SCROLLWIN = wx.PyEventBinder([ wxEVT_SCROLLWIN_TOP, +EVT_SCROLLWIN = wx.PyEventBinder([ wxEVT_SCROLLWIN_TOP, wxEVT_SCROLLWIN_BOTTOM, wxEVT_SCROLLWIN_LINEUP, wxEVT_SCROLLWIN_LINEDOWN, - wxEVT_SCROLLWIN_PAGEUP, + wxEVT_SCROLLWIN_PAGEUP, wxEVT_SCROLLWIN_PAGEDOWN, wxEVT_SCROLLWIN_THUMBTRACK, wxEVT_SCROLLWIN_THUMBRELEASE, @@ -3664,14 +4182,14 @@ EVT_SCROLLWIN_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLLWIN_THUMBTRACK ) EVT_SCROLLWIN_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLLWIN_THUMBRELEASE ) # Scrolling from wx.Slider and wx.ScrollBar -EVT_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP, - wxEVT_SCROLL_BOTTOM, - wxEVT_SCROLL_LINEUP, - wxEVT_SCROLL_LINEDOWN, - wxEVT_SCROLL_PAGEUP, - wxEVT_SCROLL_PAGEDOWN, - wxEVT_SCROLL_THUMBTRACK, - wxEVT_SCROLL_THUMBRELEASE, +EVT_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP, + wxEVT_SCROLL_BOTTOM, + wxEVT_SCROLL_LINEUP, + wxEVT_SCROLL_LINEDOWN, + wxEVT_SCROLL_PAGEUP, + wxEVT_SCROLL_PAGEDOWN, + wxEVT_SCROLL_THUMBTRACK, + wxEVT_SCROLL_THUMBRELEASE, wxEVT_SCROLL_CHANGED, ]) @@ -3685,15 +4203,15 @@ EVT_SCROLL_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLL_THUMBTRACK ) EVT_SCROLL_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLL_THUMBRELEASE ) EVT_SCROLL_CHANGED = wx.PyEventBinder( wxEVT_SCROLL_CHANGED ) EVT_SCROLL_ENDSCROLL = EVT_SCROLL_CHANGED - + # Scrolling from wx.Slider and wx.ScrollBar, with an id -EVT_COMMAND_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP, - wxEVT_SCROLL_BOTTOM, - wxEVT_SCROLL_LINEUP, - wxEVT_SCROLL_LINEDOWN, - wxEVT_SCROLL_PAGEUP, - wxEVT_SCROLL_PAGEDOWN, - wxEVT_SCROLL_THUMBTRACK, +EVT_COMMAND_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP, + wxEVT_SCROLL_BOTTOM, + wxEVT_SCROLL_LINEUP, + wxEVT_SCROLL_LINEDOWN, + wxEVT_SCROLL_PAGEUP, + wxEVT_SCROLL_PAGEDOWN, + wxEVT_SCROLL_THUMBTRACK, wxEVT_SCROLL_THUMBRELEASE, wxEVT_SCROLL_CHANGED, ], 1) @@ -3746,6 +4264,9 @@ EVT_UPDATE_UI_RANGE = wx.PyEventBinder( wxEVT_UPDATE_UI, 2) EVT_CONTEXT_MENU = wx.PyEventBinder( wxEVT_CONTEXT_MENU ) +EVT_TEXT_CUT = wx.PyEventBinder( wxEVT_COMMAND_TEXT_CUT ) +EVT_TEXT_COPY = wx.PyEventBinder( wxEVT_COMMAND_TEXT_COPY ) +EVT_TEXT_PASTE = wx.PyEventBinder( wxEVT_COMMAND_TEXT_PASTE ) #--------------------------------------------------------------------------- @@ -3763,7 +4284,7 @@ class Event(Object): __del__ = lambda self : None; def SetEventType(*args, **kwargs): """ - SetEventType(self, wxEventType typ) + SetEventType(self, EventType typ) Sets the specific type of the event. """ @@ -3771,7 +4292,7 @@ class Event(Object): def GetEventType(*args, **kwargs): """ - GetEventType(self) -> wxEventType + GetEventType(self) -> EventType Returns the identifier of the given event type, such as ``wxEVT_COMMAND_BUTTON_CLICKED``. @@ -3836,14 +4357,13 @@ class Event(Object): """ 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. - + This method can be used inside an event handler to control whether + further event handlers bound to this event will be called after the + current one returns. Without Skip() (or equivalently if Skip(False) is + used), the event will not be processed any more. If Skip(True) is + called, the event processing system continues searching for a further + handler function for this event, even though it has been processed + already in the current handler. """ return _core_.Event_Skip(*args, **kwargs) @@ -3890,8 +4410,12 @@ class Event(Object): """Clone(self) -> Event""" return _core_.Event_Clone(*args, **kwargs) -Event_swigregister = _core_.Event_swigregister -Event_swigregister(Event) + EventObject = property(GetEventObject,SetEventObject,doc="See `GetEventObject` and `SetEventObject`") + EventType = property(GetEventType,SetEventType,doc="See `GetEventType` and `SetEventType`") + Id = property(GetId,SetId,doc="See `GetId` and `SetId`") + Skipped = property(GetSkipped,doc="See `GetSkipped`") + Timestamp = property(GetTimestamp,SetTimestamp,doc="See `GetTimestamp` and `SetTimestamp`") +_core_.Event_swigregister(Event) #--------------------------------------------------------------------------- @@ -3914,8 +4438,7 @@ class PropagationDisabler(object): _core_.PropagationDisabler_swiginit(self,_core_.new_PropagationDisabler(*args, **kwargs)) __swig_destroy__ = _core_.delete_PropagationDisabler __del__ = lambda self : None; -PropagationDisabler_swigregister = _core_.PropagationDisabler_swigregister -PropagationDisabler_swigregister(PropagationDisabler) +_core_.PropagationDisabler_swigregister(PropagationDisabler) class PropagateOnce(object): """ @@ -3936,8 +4459,7 @@ class PropagateOnce(object): _core_.PropagateOnce_swiginit(self,_core_.new_PropagateOnce(*args, **kwargs)) __swig_destroy__ = _core_.delete_PropagateOnce __del__ = lambda self : None; -PropagateOnce_swigregister = _core_.PropagateOnce_swigregister -PropagateOnce_swigregister(PropagateOnce) +_core_.PropagateOnce_swigregister(PropagateOnce) #--------------------------------------------------------------------------- @@ -3951,7 +4473,7 @@ class CommandEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType commandType=wxEVT_NULL, int winid=0) -> CommandEvent + __init__(self, EventType commandType=wxEVT_NULL, int winid=0) -> CommandEvent This event class contains information about command events, which originate from a variety of simple controls, as well as menus and @@ -4025,7 +4547,7 @@ class CommandEvent(Event): def GetInt(*args, **kwargs): """ - GetInt(self) -> long + GetInt(self) -> int Returns the integer identifier corresponding to a listbox, choice or radiobox selection (only if the event was a selection, not a @@ -4056,8 +4578,13 @@ class CommandEvent(Event): """Clone(self) -> Event""" return _core_.CommandEvent_Clone(*args, **kwargs) -CommandEvent_swigregister = _core_.CommandEvent_swigregister -CommandEvent_swigregister(CommandEvent) + ClientData = property(GetClientData,SetClientData,doc="See `GetClientData` and `SetClientData`") + ClientObject = property(GetClientObject,SetClientObject,doc="See `GetClientObject` and `SetClientObject`") + ExtraLong = property(GetExtraLong,SetExtraLong,doc="See `GetExtraLong` and `SetExtraLong`") + Int = property(GetInt,SetInt,doc="See `GetInt` and `SetInt`") + Selection = property(GetSelection,doc="See `GetSelection`") + String = property(GetString,SetString,doc="See `GetString` and `SetString`") +_core_.CommandEvent_swigregister(CommandEvent) #--------------------------------------------------------------------------- @@ -4072,7 +4599,7 @@ class NotifyEvent(CommandEvent): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType commandType=wxEVT_NULL, int winid=0) -> NotifyEvent + __init__(self, EventType commandType=wxEVT_NULL, int winid=0) -> NotifyEvent An instance of this class (or one of its derived classes) is sent from a control when the control's state is being changed and the control @@ -4112,8 +4639,7 @@ class NotifyEvent(CommandEvent): """ return _core_.NotifyEvent_IsAllowed(*args, **kwargs) -NotifyEvent_swigregister = _core_.NotifyEvent_swigregister -NotifyEvent_swigregister(NotifyEvent) +_core_.NotifyEvent_swigregister(NotifyEvent) #--------------------------------------------------------------------------- @@ -4121,14 +4647,14 @@ class ScrollEvent(CommandEvent): """ A scroll event holds information about events sent from stand-alone scrollbars and sliders. Note that scrolled windows do not send - instnaces of this event class, but send the `wx.ScrollWinEvent` + instances of this event class, but send the `wx.ScrollWinEvent` instead. """ thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType commandType=wxEVT_NULL, int winid=0, int pos=0, + __init__(self, EventType commandType=wxEVT_NULL, int winid=0, int pos=0, int orient=0) -> ScrollEvent """ _core_.ScrollEvent_swiginit(self,_core_.new_ScrollEvent(*args, **kwargs)) @@ -4157,8 +4683,9 @@ class ScrollEvent(CommandEvent): """SetPosition(self, int pos)""" return _core_.ScrollEvent_SetPosition(*args, **kwargs) -ScrollEvent_swigregister = _core_.ScrollEvent_swigregister -ScrollEvent_swigregister(ScrollEvent) + Orientation = property(GetOrientation,SetOrientation,doc="See `GetOrientation` and `SetOrientation`") + Position = property(GetPosition,SetPosition,doc="See `GetPosition` and `SetPosition`") +_core_.ScrollEvent_swigregister(ScrollEvent) #--------------------------------------------------------------------------- @@ -4171,7 +4698,7 @@ class ScrollWinEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType commandType=wxEVT_NULL, int pos=0, int orient=0) -> ScrollWinEvent + __init__(self, EventType commandType=wxEVT_NULL, int pos=0, int orient=0) -> ScrollWinEvent A wx.ScrollWinEvent holds information about scrolling and is sent from scrolling windows. @@ -4204,8 +4731,9 @@ class ScrollWinEvent(Event): """SetPosition(self, int pos)""" return _core_.ScrollWinEvent_SetPosition(*args, **kwargs) -ScrollWinEvent_swigregister = _core_.ScrollWinEvent_swigregister -ScrollWinEvent_swigregister(ScrollWinEvent) + Orientation = property(GetOrientation,SetOrientation,doc="See `GetOrientation` and `SetOrientation`") + Position = property(GetPosition,SetPosition,doc="See `GetPosition` and `SetPosition`") +_core_.ScrollWinEvent_swigregister(ScrollWinEvent) #--------------------------------------------------------------------------- @@ -4240,7 +4768,7 @@ class MouseEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType mouseType=wxEVT_NULL) -> MouseEvent + __init__(self, EventType mouseType=wxEVT_NULL) -> MouseEvent Constructs a wx.MouseEvent. Valid event types are: @@ -4590,6 +5118,16 @@ class MouseEvent(Event): """ return _core_.MouseEvent_GetWheelDelta(*args, **kwargs) + def GetWheelAxis(*args, **kwargs): + """ + GetWheelAxis(self) -> int + + Gets the axis the wheel operation concerns, 0 being the y axis as on + most mouse wheels, 1 is the x axis for things like MightyMouse scrolls + or horizontal trackpad scrolling. + """ + return _core_.MouseEvent_GetWheelAxis(*args, **kwargs) + def GetLinesPerAction(*args, **kwargs): """ GetLinesPerAction(self) -> int @@ -4620,8 +5158,15 @@ class MouseEvent(Event): m_wheelRotation = property(_core_.MouseEvent_m_wheelRotation_get, _core_.MouseEvent_m_wheelRotation_set) m_wheelDelta = property(_core_.MouseEvent_m_wheelDelta_get, _core_.MouseEvent_m_wheelDelta_set) m_linesPerAction = property(_core_.MouseEvent_m_linesPerAction_get, _core_.MouseEvent_m_linesPerAction_set) -MouseEvent_swigregister = _core_.MouseEvent_swigregister -MouseEvent_swigregister(MouseEvent) + Button = property(GetButton,doc="See `GetButton`") + LinesPerAction = property(GetLinesPerAction,doc="See `GetLinesPerAction`") + LogicalPosition = property(GetLogicalPosition,doc="See `GetLogicalPosition`") + Position = property(GetPosition,doc="See `GetPosition`") + WheelDelta = property(GetWheelDelta,doc="See `GetWheelDelta`") + WheelRotation = property(GetWheelRotation,doc="See `GetWheelRotation`") + X = property(GetX,doc="See `GetX`") + Y = property(GetY,doc="See `GetY`") +_core_.MouseEvent_swigregister(MouseEvent) #--------------------------------------------------------------------------- @@ -4682,8 +5227,10 @@ class SetCursorEvent(Event): """ return _core_.SetCursorEvent_HasCursor(*args, **kwargs) -SetCursorEvent_swigregister = _core_.SetCursorEvent_swigregister -SetCursorEvent_swigregister(SetCursorEvent) + Cursor = property(GetCursor,SetCursor,doc="See `GetCursor` and `SetCursor`") + X = property(GetX,doc="See `GetX`") + Y = property(GetY,doc="See `GetY`") +_core_.SetCursorEvent_swigregister(SetCursorEvent) #--------------------------------------------------------------------------- @@ -4754,7 +5301,7 @@ class KeyEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType eventType=wxEVT_NULL) -> KeyEvent + __init__(self, EventType eventType=wxEVT_NULL) -> KeyEvent Construct a new `wx.KeyEvent`. Valid event types are: * @@ -4850,7 +5397,6 @@ class KeyEvent(Event): """ return _core_.KeyEvent_GetKeyCode(*args, **kwargs) - KeyCode = GetKeyCode def GetUnicodeKey(*args, **kwargs): """ GetUnicodeKey(self) -> int @@ -4861,6 +5407,15 @@ class KeyEvent(Event): return _core_.KeyEvent_GetUnicodeKey(*args, **kwargs) GetUniChar = GetUnicodeKey + def SetUnicodeKey(*args, **kwargs): + """ + SetUnicodeKey(self, int uniChar) + + Set the Unicode value of the key event, but only if this is a Unicode + build of wxPython. + """ + return _core_.KeyEvent_SetUnicodeKey(*args, **kwargs) + def GetRawKeyCode(*args, **kwargs): """ GetRawKeyCode(self) -> unsigned int @@ -4926,8 +5481,15 @@ class KeyEvent(Event): m_scanCode = property(_core_.KeyEvent_m_scanCode_get, _core_.KeyEvent_m_scanCode_set) m_rawCode = property(_core_.KeyEvent_m_rawCode_get, _core_.KeyEvent_m_rawCode_set) m_rawFlags = property(_core_.KeyEvent_m_rawFlags_get, _core_.KeyEvent_m_rawFlags_set) -KeyEvent_swigregister = _core_.KeyEvent_swigregister -KeyEvent_swigregister(KeyEvent) + KeyCode = property(GetKeyCode,doc="See `GetKeyCode`") + Modifiers = property(GetModifiers,doc="See `GetModifiers`") + Position = property(GetPosition,doc="See `GetPosition`") + RawKeyCode = property(GetRawKeyCode,doc="See `GetRawKeyCode`") + RawKeyFlags = property(GetRawKeyFlags,doc="See `GetRawKeyFlags`") + UnicodeKey = property(GetUnicodeKey,SetUnicodeKey,doc="See `GetUnicodeKey` and `SetUnicodeKey`") + X = property(GetX,doc="See `GetX`") + Y = property(GetY,doc="See `GetY`") +_core_.KeyEvent_swigregister(KeyEvent) #--------------------------------------------------------------------------- @@ -4981,8 +5543,9 @@ class SizeEvent(Event): m_size = property(_core_.SizeEvent_m_size_get, _core_.SizeEvent_m_size_set) m_rect = property(_core_.SizeEvent_m_rect_get, _core_.SizeEvent_m_rect_set) -SizeEvent_swigregister = _core_.SizeEvent_swigregister -SizeEvent_swigregister(SizeEvent) + Rect = property(GetRect,SetRect,doc="See `GetRect` and `SetRect`") + Size = property(GetSize,SetSize,doc="See `GetSize` and `SetSize`") +_core_.SizeEvent_swigregister(SizeEvent) #--------------------------------------------------------------------------- @@ -5023,8 +5586,9 @@ class MoveEvent(Event): m_pos = property(GetPosition, SetPosition) m_rect = property(GetRect, SetRect) -MoveEvent_swigregister = _core_.MoveEvent_swigregister -MoveEvent_swigregister(MoveEvent) + Position = property(GetPosition,SetPosition,doc="See `GetPosition` and `SetPosition`") + Rect = property(GetRect,SetRect,doc="See `GetRect` and `SetRect`") +_core_.MoveEvent_swigregister(MoveEvent) #--------------------------------------------------------------------------- @@ -5049,8 +5613,7 @@ class PaintEvent(Event): def __init__(self, *args, **kwargs): """__init__(self, int Id=0) -> PaintEvent""" _core_.PaintEvent_swiginit(self,_core_.new_PaintEvent(*args, **kwargs)) -PaintEvent_swigregister = _core_.PaintEvent_swigregister -PaintEvent_swigregister(PaintEvent) +_core_.PaintEvent_swigregister(PaintEvent) class NcPaintEvent(Event): """Proxy of C++ NcPaintEvent class""" @@ -5059,8 +5622,7 @@ class NcPaintEvent(Event): def __init__(self, *args, **kwargs): """__init__(self, int winid=0) -> NcPaintEvent""" _core_.NcPaintEvent_swiginit(self,_core_.new_NcPaintEvent(*args, **kwargs)) -NcPaintEvent_swigregister = _core_.NcPaintEvent_swigregister -NcPaintEvent_swigregister(NcPaintEvent) +_core_.NcPaintEvent_swigregister(NcPaintEvent) #--------------------------------------------------------------------------- @@ -5095,8 +5657,8 @@ class EraseEvent(Event): """ return _core_.EraseEvent_GetDC(*args, **kwargs) -EraseEvent_swigregister = _core_.EraseEvent_swigregister -EraseEvent_swigregister(EraseEvent) + DC = property(GetDC,doc="See `GetDC`") +_core_.EraseEvent_swigregister(EraseEvent) #--------------------------------------------------------------------------- @@ -5115,7 +5677,7 @@ class FocusEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType type=wxEVT_NULL, int winid=0) -> FocusEvent + __init__(self, EventType type=wxEVT_NULL, int winid=0) -> FocusEvent Constructor """ @@ -5136,16 +5698,21 @@ class FocusEvent(Event): """SetWindow(self, Window win)""" return _core_.FocusEvent_SetWindow(*args, **kwargs) -FocusEvent_swigregister = _core_.FocusEvent_swigregister -FocusEvent_swigregister(FocusEvent) + Window = property(GetWindow,SetWindow,doc="See `GetWindow` and `SetWindow`") +_core_.FocusEvent_swigregister(FocusEvent) #--------------------------------------------------------------------------- class ChildFocusEvent(CommandEvent): """ - wx.ChildFocusEvent notifies the parent that a child has received the - focus. Unlike `wx.FocusEvent` it is propagated up the window - heirarchy. + A child focus event is sent to a (parent-)window when one of its child + windows gains focus, so that the window could restore the focus back + to its corresponding child if it loses it now and regains later. + + Notice that child window is the direct child of the window receiving + the event, and so may not be the actual widget recieving focus if it + is further down the containment heirarchy. Use `wx.Window.FindFocus` + to get the widget that is actually receiving focus. """ thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') __repr__ = _swig_repr @@ -5160,12 +5727,13 @@ class ChildFocusEvent(CommandEvent): """ GetWindow(self) -> Window - The window which has just received the focus. + The window, or (grand)parent of the window which has just received the + focus. """ return _core_.ChildFocusEvent_GetWindow(*args, **kwargs) -ChildFocusEvent_swigregister = _core_.ChildFocusEvent_swigregister -ChildFocusEvent_swigregister(ChildFocusEvent) + Window = property(GetWindow,doc="See `GetWindow`") +_core_.ChildFocusEvent_swigregister(ChildFocusEvent) #--------------------------------------------------------------------------- @@ -5190,7 +5758,7 @@ class ActivateEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType type=wxEVT_NULL, bool active=True, int Id=0) -> ActivateEvent + __init__(self, EventType type=wxEVT_NULL, bool active=True, int Id=0) -> ActivateEvent Constructor """ @@ -5204,8 +5772,8 @@ class ActivateEvent(Event): """ return _core_.ActivateEvent_GetActive(*args, **kwargs) -ActivateEvent_swigregister = _core_.ActivateEvent_swigregister -ActivateEvent_swigregister(ActivateEvent) + Active = property(GetActive,doc="See `GetActive`") +_core_.ActivateEvent_swigregister(ActivateEvent) #--------------------------------------------------------------------------- @@ -5226,8 +5794,7 @@ class InitDialogEvent(Event): Constructor """ _core_.InitDialogEvent_swiginit(self,_core_.new_InitDialogEvent(*args, **kwargs)) -InitDialogEvent_swigregister = _core_.InitDialogEvent_swigregister -InitDialogEvent_swigregister(InitDialogEvent) +_core_.InitDialogEvent_swigregister(InitDialogEvent) #--------------------------------------------------------------------------- @@ -5244,7 +5811,7 @@ class MenuEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType type=wxEVT_NULL, int winid=0, Menu menu=None) -> MenuEvent + __init__(self, EventType type=wxEVT_NULL, int winid=0, Menu menu=None) -> MenuEvent Constructor """ @@ -5277,8 +5844,9 @@ class MenuEvent(Event): """ return _core_.MenuEvent_GetMenu(*args, **kwargs) -MenuEvent_swigregister = _core_.MenuEvent_swigregister -MenuEvent_swigregister(MenuEvent) + Menu = property(GetMenu,doc="See `GetMenu`") + MenuId = property(GetMenuId,doc="See `GetMenuId`") +_core_.MenuEvent_swigregister(MenuEvent) #--------------------------------------------------------------------------- @@ -5309,7 +5877,7 @@ class CloseEvent(Event): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType type=wxEVT_NULL, int winid=0) -> CloseEvent + __init__(self, EventType type=wxEVT_NULL, int winid=0) -> CloseEvent Constructor. """ @@ -5367,8 +5935,8 @@ class CloseEvent(Event): """ return _core_.CloseEvent_CanVeto(*args, **kwargs) -CloseEvent_swigregister = _core_.CloseEvent_swigregister -CloseEvent_swigregister(CloseEvent) + LoggingOff = property(GetLoggingOff,SetLoggingOff,doc="See `GetLoggingOff` and `SetLoggingOff`") +_core_.CloseEvent_swigregister(CloseEvent) #--------------------------------------------------------------------------- @@ -5391,8 +5959,8 @@ class ShowEvent(Event): """GetShow(self) -> bool""" return _core_.ShowEvent_GetShow(*args, **kwargs) -ShowEvent_swigregister = _core_.ShowEvent_swigregister -ShowEvent_swigregister(ShowEvent) + Show = property(GetShow,SetShow,doc="See `GetShow` and `SetShow`") +_core_.ShowEvent_swigregister(ShowEvent) #--------------------------------------------------------------------------- @@ -5420,8 +5988,7 @@ class IconizeEvent(Event): """ return _core_.IconizeEvent_Iconized(*args, **kwargs) -IconizeEvent_swigregister = _core_.IconizeEvent_swigregister -IconizeEvent_swigregister(IconizeEvent) +_core_.IconizeEvent_swigregister(IconizeEvent) #--------------------------------------------------------------------------- @@ -5436,8 +6003,7 @@ class MaximizeEvent(Event): An EVT_MAXIMIZE event is sent when a frame is maximized or restored. """ _core_.MaximizeEvent_swiginit(self,_core_.new_MaximizeEvent(*args, **kwargs)) -MaximizeEvent_swigregister = _core_.MaximizeEvent_swigregister -MaximizeEvent_swigregister(MaximizeEvent) +_core_.MaximizeEvent_swigregister(MaximizeEvent) #--------------------------------------------------------------------------- @@ -5484,8 +6050,10 @@ class DropFilesEvent(Event): """ return _core_.DropFilesEvent_GetFiles(*args, **kwargs) -DropFilesEvent_swigregister = _core_.DropFilesEvent_swigregister -DropFilesEvent_swigregister(DropFilesEvent) + Files = property(GetFiles,doc="See `GetFiles`") + NumberOfFiles = property(GetNumberOfFiles,doc="See `GetNumberOfFiles`") + Position = property(GetPosition,doc="See `GetPosition`") +_core_.DropFilesEvent_swigregister(DropFilesEvent) #--------------------------------------------------------------------------- @@ -5744,8 +6312,11 @@ class UpdateUIEvent(CommandEvent): return _core_.UpdateUIEvent_GetMode(*args, **kwargs) GetMode = staticmethod(GetMode) -UpdateUIEvent_swigregister = _core_.UpdateUIEvent_swigregister -UpdateUIEvent_swigregister(UpdateUIEvent) + Checked = property(GetChecked,Check,doc="See `GetChecked`") + Enabled = property(GetEnabled,Enable,doc="See `GetEnabled`") + Shown = property(GetShown,Show,doc="See `GetShown`") + Text = property(GetText,SetText,doc="See `GetText` and `SetText`") +_core_.UpdateUIEvent_swigregister(UpdateUIEvent) def UpdateUIEvent_SetUpdateInterval(*args, **kwargs): """ @@ -5856,8 +6427,7 @@ class SysColourChangedEvent(Event): Constructor """ _core_.SysColourChangedEvent_swiginit(self,_core_.new_SysColourChangedEvent(*args, **kwargs)) -SysColourChangedEvent_swigregister = _core_.SysColourChangedEvent_swigregister -SysColourChangedEvent_swigregister(SysColourChangedEvent) +_core_.SysColourChangedEvent_swigregister(SysColourChangedEvent) #--------------------------------------------------------------------------- @@ -5889,8 +6459,49 @@ class MouseCaptureChangedEvent(Event): """ return _core_.MouseCaptureChangedEvent_GetCapturedWindow(*args, **kwargs) -MouseCaptureChangedEvent_swigregister = _core_.MouseCaptureChangedEvent_swigregister -MouseCaptureChangedEvent_swigregister(MouseCaptureChangedEvent) + CapturedWindow = property(GetCapturedWindow,doc="See `GetCapturedWindow`") +_core_.MouseCaptureChangedEvent_swigregister(MouseCaptureChangedEvent) + +#--------------------------------------------------------------------------- + +class MouseCaptureLostEvent(Event): + """ + A mouse capture lost event is sent to a window that obtained mouse + capture, which was subsequently loss due to "external" event, for + example when a dialog box is shown or if another application captures + the mouse. + + If this happens, this event is sent to all windows that are on the + capture stack (i.e. a window that called `wx.Window.CaptureMouse`, but + didn't call `wx.Window.ReleaseMouse` yet). The event is *not* sent + if the capture changes because of a call to CaptureMouse or + ReleaseMouse. + + This event is currently emitted under Windows only. + + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self, int winid=0) -> MouseCaptureLostEvent + + A mouse capture lost event is sent to a window that obtained mouse + capture, which was subsequently loss due to "external" event, for + example when a dialog box is shown or if another application captures + the mouse. + + If this happens, this event is sent to all windows that are on the + capture stack (i.e. a window that called `wx.Window.CaptureMouse`, but + didn't call `wx.Window.ReleaseMouse` yet). The event is *not* sent + if the capture changes because of a call to CaptureMouse or + ReleaseMouse. + + This event is currently emitted under Windows only. + + """ + _core_.MouseCaptureLostEvent_swiginit(self,_core_.new_MouseCaptureLostEvent(*args, **kwargs)) +_core_.MouseCaptureLostEvent_swigregister(MouseCaptureLostEvent) #--------------------------------------------------------------------------- @@ -5906,8 +6517,7 @@ class DisplayChangedEvent(Event): def __init__(self, *args, **kwargs): """__init__(self) -> DisplayChangedEvent""" _core_.DisplayChangedEvent_swiginit(self,_core_.new_DisplayChangedEvent(*args, **kwargs)) -DisplayChangedEvent_swigregister = _core_.DisplayChangedEvent_swigregister -DisplayChangedEvent_swigregister(DisplayChangedEvent) +_core_.DisplayChangedEvent_swigregister(DisplayChangedEvent) #--------------------------------------------------------------------------- @@ -5940,8 +6550,8 @@ class PaletteChangedEvent(Event): """GetChangedWindow(self) -> Window""" return _core_.PaletteChangedEvent_GetChangedWindow(*args, **kwargs) -PaletteChangedEvent_swigregister = _core_.PaletteChangedEvent_swigregister -PaletteChangedEvent_swigregister(PaletteChangedEvent) + ChangedWindow = property(GetChangedWindow,SetChangedWindow,doc="See `GetChangedWindow` and `SetChangedWindow`") +_core_.PaletteChangedEvent_swigregister(PaletteChangedEvent) #--------------------------------------------------------------------------- @@ -5973,8 +6583,8 @@ class QueryNewPaletteEvent(Event): """GetPaletteRealized(self) -> bool""" return _core_.QueryNewPaletteEvent_GetPaletteRealized(*args, **kwargs) -QueryNewPaletteEvent_swigregister = _core_.QueryNewPaletteEvent_swigregister -QueryNewPaletteEvent_swigregister(QueryNewPaletteEvent) + PaletteRealized = property(GetPaletteRealized,SetPaletteRealized,doc="See `GetPaletteRealized` and `SetPaletteRealized`") +_core_.QueryNewPaletteEvent_swigregister(QueryNewPaletteEvent) #--------------------------------------------------------------------------- @@ -6081,8 +6691,9 @@ class NavigationKeyEvent(Event): IsForward = _core_.NavigationKeyEvent_IsForward WinChange = _core_.NavigationKeyEvent_WinChange FromTab = _core_.NavigationKeyEvent_FromTab -NavigationKeyEvent_swigregister = _core_.NavigationKeyEvent_swigregister -NavigationKeyEvent_swigregister(NavigationKeyEvent) + CurrentFocus = property(GetCurrentFocus,SetCurrentFocus,doc="See `GetCurrentFocus` and `SetCurrentFocus`") + Direction = property(GetDirection,SetDirection,doc="See `GetDirection` and `SetDirection`") +_core_.NavigationKeyEvent_swigregister(NavigationKeyEvent) #--------------------------------------------------------------------------- @@ -6109,8 +6720,8 @@ class WindowCreateEvent(CommandEvent): """ return _core_.WindowCreateEvent_GetWindow(*args, **kwargs) -WindowCreateEvent_swigregister = _core_.WindowCreateEvent_swigregister -WindowCreateEvent_swigregister(WindowCreateEvent) + Window = property(GetWindow,doc="See `GetWindow`") +_core_.WindowCreateEvent_swigregister(WindowCreateEvent) class WindowDestroyEvent(CommandEvent): """ @@ -6149,8 +6760,8 @@ class WindowDestroyEvent(CommandEvent): """ return _core_.WindowDestroyEvent_GetWindow(*args, **kwargs) -WindowDestroyEvent_swigregister = _core_.WindowDestroyEvent_swigregister -WindowDestroyEvent_swigregister(WindowDestroyEvent) + Window = property(GetWindow,doc="See `GetWindow`") +_core_.WindowDestroyEvent_swigregister(WindowDestroyEvent) #--------------------------------------------------------------------------- @@ -6163,7 +6774,7 @@ class ContextMenuEvent(CommandEvent): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, wxEventType type=wxEVT_NULL, int winid=0, Point pt=DefaultPosition) -> ContextMenuEvent + __init__(self, EventType type=wxEVT_NULL, int winid=0, Point pt=DefaultPosition) -> ContextMenuEvent Constructor. """ @@ -6185,8 +6796,8 @@ class ContextMenuEvent(CommandEvent): """ return _core_.ContextMenuEvent_SetPosition(*args, **kwargs) -ContextMenuEvent_swigregister = _core_.ContextMenuEvent_swigregister -ContextMenuEvent_swigregister(ContextMenuEvent) + Position = property(GetPosition,SetPosition,doc="See `GetPosition` and `SetPosition`") +_core_.ContextMenuEvent_swigregister(ContextMenuEvent) #--------------------------------------------------------------------------- @@ -6289,8 +6900,7 @@ class IdleEvent(Event): return _core_.IdleEvent_CanSend(*args, **kwargs) CanSend = staticmethod(CanSend) -IdleEvent_swigregister = _core_.IdleEvent_swigregister -IdleEvent_swigregister(IdleEvent) +_core_.IdleEvent_swigregister(IdleEvent) def IdleEvent_SetMode(*args, **kwargs): """ @@ -6340,6 +6950,31 @@ def IdleEvent_CanSend(*args, **kwargs): #--------------------------------------------------------------------------- +class ClipboardTextEvent(CommandEvent): + """ + A Clipboard Text event is sent when a window intercepts a text + copy/cut/paste message, i.e. the user has cut/copied/pasted data + from/into a text control via ctrl-C/X/V, ctrl/shift-del/insert, a + popup menu command, etc. NOTE : under windows these events are *NOT* + generated automatically for a Rich Edit text control. + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self, EventType type=wxEVT_NULL, int winid=0) -> ClipboardTextEvent + + A Clipboard Text event is sent when a window intercepts a text + copy/cut/paste message, i.e. the user has cut/copied/pasted data + from/into a text control via ctrl-C/X/V, ctrl/shift-del/insert, a + popup menu command, etc. NOTE : under windows these events are *NOT* + generated automatically for a Rich Edit text control. + """ + _core_.ClipboardTextEvent_swiginit(self,_core_.new_ClipboardTextEvent(*args, **kwargs)) +_core_.ClipboardTextEvent_swigregister(ClipboardTextEvent) + +#--------------------------------------------------------------------------- + class PyEvent(Event): """ wx.PyEvent can be used as a base class for implementing custom event @@ -6354,7 +6989,7 @@ class PyEvent(Event): thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') __repr__ = _swig_repr def __init__(self, *args, **kwargs): - """__init__(self, int winid=0, wxEventType eventType=wxEVT_NULL) -> PyEvent""" + """__init__(self, int winid=0, EventType eventType=wxEVT_NULL) -> PyEvent""" _core_.PyEvent_swiginit(self,_core_.new_PyEvent(*args, **kwargs)) self._SetSelf(self) @@ -6368,8 +7003,7 @@ class PyEvent(Event): """_GetSelf(self) -> PyObject""" return _core_.PyEvent__GetSelf(*args, **kwargs) -PyEvent_swigregister = _core_.PyEvent_swigregister -PyEvent_swigregister(PyEvent) +_core_.PyEvent_swigregister(PyEvent) class PyCommandEvent(CommandEvent): """ @@ -6386,7 +7020,7 @@ class PyCommandEvent(CommandEvent): thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') __repr__ = _swig_repr def __init__(self, *args, **kwargs): - """__init__(self, wxEventType eventType=wxEVT_NULL, int id=0) -> PyCommandEvent""" + """__init__(self, EventType eventType=wxEVT_NULL, int id=0) -> PyCommandEvent""" _core_.PyCommandEvent_swiginit(self,_core_.new_PyCommandEvent(*args, **kwargs)) self._SetSelf(self) @@ -6400,8 +7034,7 @@ class PyCommandEvent(CommandEvent): """_GetSelf(self) -> PyObject""" return _core_.PyCommandEvent__GetSelf(*args, **kwargs) -PyCommandEvent_swigregister = _core_.PyCommandEvent_swigregister -PyCommandEvent_swigregister(PyCommandEvent) +_core_.PyCommandEvent_swigregister(PyCommandEvent) class DateEvent(CommandEvent): """ @@ -6413,7 +7046,7 @@ class DateEvent(CommandEvent): thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') __repr__ = _swig_repr def __init__(self, *args, **kwargs): - """__init__(self, Window win, DateTime dt, wxEventType type) -> DateEvent""" + """__init__(self, Window win, DateTime dt, EventType type) -> DateEvent""" _core_.DateEvent_swiginit(self,_core_.new_DateEvent(*args, **kwargs)) def GetDate(*args, **kwargs): """ @@ -6432,16 +7065,35 @@ class DateEvent(CommandEvent): """ return _core_.DateEvent_SetDate(*args, **kwargs) -DateEvent_swigregister = _core_.DateEvent_swigregister -DateEvent_swigregister(DateEvent) + Date = property(GetDate,SetDate,doc="See `GetDate` and `SetDate`") +_core_.DateEvent_swigregister(DateEvent) wxEVT_DATE_CHANGED = _core_.wxEVT_DATE_CHANGED EVT_DATE_CHANGED = wx.PyEventBinder( wxEVT_DATE_CHANGED, 1 ) -#--------------------------------------------------------------------------- - -PYAPP_ASSERT_SUPPRESS = _core_.PYAPP_ASSERT_SUPPRESS -PYAPP_ASSERT_EXCEPTION = _core_.PYAPP_ASSERT_EXCEPTION +class EventBlocker(EvtHandler): + """Helper class to temporarily disable event handling for a window.""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self, Window win, EventType type=wxEVT_ANY) -> EventBlocker + + Helper class to temporarily disable event handling for a window. + """ + _core_.EventBlocker_swiginit(self,_core_.new_EventBlocker(*args, **kwargs)) + __swig_destroy__ = _core_.delete_EventBlocker + __del__ = lambda self : None; + def Block(*args, **kwargs): + """Block(self, EventType type)""" + return _core_.EventBlocker_Block(*args, **kwargs) + +_core_.EventBlocker_swigregister(EventBlocker) + +#--------------------------------------------------------------------------- + +PYAPP_ASSERT_SUPPRESS = _core_.PYAPP_ASSERT_SUPPRESS +PYAPP_ASSERT_EXCEPTION = _core_.PYAPP_ASSERT_EXCEPTION PYAPP_ASSERT_DIALOG = _core_.PYAPP_ASSERT_DIALOG PYAPP_ASSERT_LOG = _core_.PYAPP_ASSERT_LOG PRINT_WINDOWS = _core_.PRINT_WINDOWS @@ -6460,13 +7112,12 @@ class PyApp(EvtHandler): Create a new application object, starting the bootstrap process. """ _core_.PyApp_swiginit(self,_core_.new_PyApp(*args, **kwargs)) - self._setCallbackInfo(self, PyApp, False) - self._setOORInfo(self, False) + self._setOORInfo(self, False);PyApp._setCallbackInfo(self, self, PyApp) __swig_destroy__ = _core_.delete_PyApp __del__ = lambda self : None; def _setCallbackInfo(*args, **kwargs): - """_setCallbackInfo(self, PyObject self, PyObject _class, bool incref)""" + """_setCallbackInfo(self, PyObject self, PyObject _class, bool incref=False)""" return _core_.PyApp__setCallbackInfo(*args, **kwargs) def GetAppName(*args, **kwargs): @@ -6600,6 +7251,14 @@ class PyApp(EvtHandler): """ return _core_.PyApp_Exit(*args, **kwargs) + def GetLayoutDirection(*args, **kwargs): + """ + GetLayoutDirection(self) -> int + + Return the layout direction for the current locale. + """ + return _core_.PyApp_GetLayoutDirection(*args, **kwargs) + def ExitMainLoop(*args, **kwargs): """ ExitMainLoop(self) @@ -6693,7 +7352,7 @@ class PyApp(EvtHandler): def SetUseBestVisual(*args, **kwargs): """ - SetUseBestVisual(self, bool flag) + SetUseBestVisual(self, bool flag, bool forceTrueColour=False) Set whether the app should try to use the best available visual on systems where more than one is available, (Sun, SGI, XFree86 4, etc.) @@ -6800,8 +7459,40 @@ class PyApp(EvtHandler): return _core_.PyApp_GetComCtl32Version(*args, **kwargs) GetComCtl32Version = staticmethod(GetComCtl32Version) -PyApp_swigregister = _core_.PyApp_swigregister -PyApp_swigregister(PyApp) + def IsDisplayAvailable(*args, **kwargs): + """ + IsDisplayAvailable() -> bool + + Tests if it is possible to create a GUI in the current environment. + This will mean different things on the different platforms. + + * On X Windows systems this function will return ``False`` if it is + not able to open a connection to the X display, which can happen + if $DISPLAY is not set, or is not set correctly. + + * On Mac OS X a ``False`` return value will mean that wx is not + able to access the window manager, which can happen if logged in + remotely or if running from the normal version of python instead + of the framework version, (i.e., pythonw.) + + * On MS Windows... + + """ + return _core_.PyApp_IsDisplayAvailable(*args, **kwargs) + + IsDisplayAvailable = staticmethod(IsDisplayAvailable) + AppName = property(GetAppName,SetAppName,doc="See `GetAppName` and `SetAppName`") + AssertMode = property(GetAssertMode,SetAssertMode,doc="See `GetAssertMode` and `SetAssertMode`") + ClassName = property(GetClassName,SetClassName,doc="See `GetClassName` and `SetClassName`") + ExitOnFrameDelete = property(GetExitOnFrameDelete,SetExitOnFrameDelete,doc="See `GetExitOnFrameDelete` and `SetExitOnFrameDelete`") + LayoutDirection = property(GetLayoutDirection,doc="See `GetLayoutDirection`") + PrintMode = property(GetPrintMode,SetPrintMode,doc="See `GetPrintMode` and `SetPrintMode`") + TopWindow = property(GetTopWindow,SetTopWindow,doc="See `GetTopWindow` and `SetTopWindow`") + Traits = property(GetTraits,doc="See `GetTraits`") + UseBestVisual = property(GetUseBestVisual,SetUseBestVisual,doc="See `GetUseBestVisual` and `SetUseBestVisual`") + VendorName = property(GetVendorName,SetVendorName,doc="See `GetVendorName` and `SetVendorName`") + Active = property(IsActive) +_core_.PyApp_swigregister(PyApp) def PyApp_IsMainLoopRunning(*args): """ @@ -6861,6 +7552,27 @@ def PyApp_GetComCtl32Version(*args): """ return _core_.PyApp_GetComCtl32Version(*args) +def PyApp_IsDisplayAvailable(*args): + """ + PyApp_IsDisplayAvailable() -> bool + + Tests if it is possible to create a GUI in the current environment. + This will mean different things on the different platforms. + + * On X Windows systems this function will return ``False`` if it is + not able to open a connection to the X display, which can happen + if $DISPLAY is not set, or is not set correctly. + + * On Mac OS X a ``False`` return value will mean that wx is not + able to access the window manager, which can happen if logged in + remotely or if running from the normal version of python instead + of the framework version, (i.e., pythonw.) + + * On MS Windows... + + """ + return _core_.PyApp_IsDisplayAvailable(*args) + #--------------------------------------------------------------------------- @@ -6988,7 +7700,7 @@ class PyOnDemandOutputWindow: style=wx.TE_MULTILINE|wx.TE_READONLY) self.text.AppendText(st) self.frame.Show(True) - EVT_CLOSE(self.frame, self.OnCloseWindow) + self.frame.Bind(wx.EVT_CLOSE, self.OnCloseWindow) def OnCloseWindow(self, event): @@ -7030,7 +7742,7 @@ class PyOnDemandOutputWindow: #---------------------------------------------------------------------- _defRedirect = (wx.Platform == '__WXMSW__' or wx.Platform == '__WXMAC__') - + class App(wx.PyApp): """ The ``wx.App`` class represents the application and is used to: @@ -7064,7 +7776,7 @@ class App(wx.PyApp): :param redirect: Should ``sys.stdout`` and ``sys.stderr`` be redirected? Defaults to True on Windows and Mac, False - otherwise. If `filename` is None then output will be + otherwise. If ``filename`` is None then output will be redirected to a window that pops up as needed. (You can control what kind of window is created for the output by resetting the class variable ``outputWindowClass`` to a @@ -7088,22 +7800,26 @@ class App(wx.PyApp): initialization to ensure that the system, toolkit and wxWidgets are fully initialized. """ + wx.PyApp.__init__(self) - if wx.Platform == "__WXMAC__": - try: - import MacOS - if not MacOS.WMAvailable(): - print """\ -This program needs access to the screen. Please run with 'pythonw', -not 'python', and only when you are logged in on the main display of -your Mac.""" - _sys.exit(1) - except SystemExit: - raise - except: - pass + # make sure we can create a GUI + if not self.IsDisplayAvailable(): + + if wx.Platform == "__WXMAC__": + msg = """This program needs access to the screen. +Please run with 'pythonw', not 'python', and only when you are logged +in on the main display of your Mac.""" + + elif wx.Platform == "__WXGTK__": + msg ="Unable to access the X Display, is $DISPLAY set properly?" + else: + msg = "Unable to create GUI" + # TODO: more description is needed for wxMSW... + + raise SystemExit(msg) + # This has to be done before OnInit self.SetUseBestVisual(useBestVisual) @@ -7129,18 +7845,30 @@ your Mac.""" # Use Python's install prefix as the default wx.StandardPaths.Get().SetInstallPrefix(_sys.prefix) + # Until the new native control for wxMac is up to par, still use the generic one. + wx.SystemOptions.SetOptionInt("mac.listctrl.always_use_generic", 1) + # This finishes the initialization of wxWindows and then calls # the OnInit that should be present in the derived class self._BootstrapApp() + def OnPreInit(self): + """ + Things that must be done after _BootstrapApp has done its + thing, but would be nice if they were already done by the time + that OnInit is called. + """ + wx.StockGDI._initStockObjects() + + def __del__(self, destroy=wx.PyApp.__del__): self.RestoreStdio() # Just in case the MainLoop was overridden destroy(self) def Destroy(self): + self.this.own(False) wx.PyApp.Destroy(self) - self.thisown = 0 def SetTopWindow(self, frame): """Set the \"main\" top level window""" @@ -7306,8 +8034,7 @@ class EventLoop(object): return _core_.EventLoop_SetActive(*args, **kwargs) SetActive = staticmethod(SetActive) -EventLoop_swigregister = _core_.EventLoop_swigregister -EventLoop_swigregister(EventLoop) +_core_.EventLoop_swigregister(EventLoop) def EventLoop_GetActive(*args): """EventLoop_GetActive() -> EventLoop""" @@ -7326,11 +8053,15 @@ class EventLoopActivator(object): _core_.EventLoopActivator_swiginit(self,_core_.new_EventLoopActivator(*args, **kwargs)) __swig_destroy__ = _core_.delete_EventLoopActivator __del__ = lambda self : None; -EventLoopActivator_swigregister = _core_.EventLoopActivator_swigregister -EventLoopActivator_swigregister(EventLoopActivator) +_core_.EventLoopActivator_swigregister(EventLoopActivator) #--------------------------------------------------------------------------- +ACCEL_ALT = _core_.ACCEL_ALT +ACCEL_CTRL = _core_.ACCEL_CTRL +ACCEL_SHIFT = _core_.ACCEL_SHIFT +ACCEL_NORMAL = _core_.ACCEL_NORMAL +ACCEL_CMD = _core_.ACCEL_CMD class AcceleratorEntry(object): """ A class used to define items in an `wx.AcceleratorTable`. wxPython @@ -7360,6 +8091,16 @@ class AcceleratorEntry(object): """ return _core_.AcceleratorEntry_Set(*args, **kwargs) + def Create(*args, **kwargs): + """ + Create(String str) -> AcceleratorEntry + + Create accelerator corresponding to the specified string, or None if + it coulnd't be parsed. + """ + return _core_.AcceleratorEntry_Create(*args, **kwargs) + + Create = staticmethod(Create) def GetFlags(*args, **kwargs): """ GetFlags(self) -> int @@ -7384,8 +8125,42 @@ class AcceleratorEntry(object): """ return _core_.AcceleratorEntry_GetCommand(*args, **kwargs) -AcceleratorEntry_swigregister = _core_.AcceleratorEntry_swigregister -AcceleratorEntry_swigregister(AcceleratorEntry) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _core_.AcceleratorEntry_IsOk(*args, **kwargs) + + def ToString(*args, **kwargs): + """ + ToString(self) -> String + + Returns a string representation for the this accelerator. The string + is formatted using the - format where maybe a + hyphen-separed list of "shift|alt|ctrl" + + """ + return _core_.AcceleratorEntry_ToString(*args, **kwargs) + + def FromString(*args, **kwargs): + """ + FromString(self, String str) -> bool + + Returns true if the given string correctly initialized this object. + """ + return _core_.AcceleratorEntry_FromString(*args, **kwargs) + + Command = property(GetCommand,doc="See `GetCommand`") + Flags = property(GetFlags,doc="See `GetFlags`") + KeyCode = property(GetKeyCode,doc="See `GetKeyCode`") +_core_.AcceleratorEntry_swigregister(AcceleratorEntry) + +def AcceleratorEntry_Create(*args, **kwargs): + """ + AcceleratorEntry_Create(String str) -> AcceleratorEntry + + Create accelerator corresponding to the specified string, or None if + it coulnd't be parsed. + """ + return _core_.AcceleratorEntry_Create(*args, **kwargs) class AcceleratorTable(Object): """ @@ -7408,17 +8183,18 @@ class AcceleratorTable(Object): _core_.AcceleratorTable_swiginit(self,_core_.new_AcceleratorTable(*args, **kwargs)) __swig_destroy__ = _core_.delete_AcceleratorTable __del__ = lambda self : None; - def Ok(*args, **kwargs): - """Ok(self) -> bool""" - return _core_.AcceleratorTable_Ok(*args, **kwargs) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _core_.AcceleratorTable_IsOk(*args, **kwargs) -AcceleratorTable_swigregister = _core_.AcceleratorTable_swigregister -AcceleratorTable_swigregister(AcceleratorTable) + Ok = IsOk +_core_.AcceleratorTable_swigregister(AcceleratorTable) +def GetAccelFromString(label): + entry = AcceleratorEntry() + entry.FromString(label) + return entry -def GetAccelFromString(*args, **kwargs): - """GetAccelFromString(String label) -> AcceleratorEntry""" - return _core_.GetAccelFromString(*args, **kwargs) #--------------------------------------------------------------------------- class VisualAttributes(object): @@ -7434,11 +8210,22 @@ class VisualAttributes(object): _core_.VisualAttributes_swiginit(self,_core_.new_VisualAttributes(*args, **kwargs)) __swig_destroy__ = _core_.delete_VisualAttributes __del__ = lambda self : None; - font = property(_core_.VisualAttributes_font_get, _core_.VisualAttributes_font_set) - colFg = property(_core_.VisualAttributes_colFg_get, _core_.VisualAttributes_colFg_set) - colBg = property(_core_.VisualAttributes_colBg_get, _core_.VisualAttributes_colBg_set) -VisualAttributes_swigregister = _core_.VisualAttributes_swigregister -VisualAttributes_swigregister(VisualAttributes) + def _get_font(*args, **kwargs): + """_get_font(self) -> Font""" + return _core_.VisualAttributes__get_font(*args, **kwargs) + + def _get_colFg(*args, **kwargs): + """_get_colFg(self) -> Colour""" + return _core_.VisualAttributes__get_colFg(*args, **kwargs) + + def _get_colBg(*args, **kwargs): + """_get_colBg(self) -> Colour""" + return _core_.VisualAttributes__get_colBg(*args, **kwargs) + + font = property(_get_font) + colFg = property(_get_colFg) + colBg = property(_get_colBg) +_core_.VisualAttributes_swigregister(VisualAttributes) NullAcceleratorTable = cvar.NullAcceleratorTable PanelNameStr = cvar.PanelNameStr @@ -7500,9 +8287,8 @@ class Window(EvtHandler): Returns True if the window has either been successfully deleted, or it has been added to the list of windows pending real deletion. """ - val = _core_.Window_Destroy(*args, **kwargs) - args[0].thisown = 0 - return val + args[0].this.own(False) + return _core_.Window_Destroy(*args, **kwargs) def DestroyChildren(*args, **kwargs): """ @@ -7625,6 +8411,32 @@ class Window(EvtHandler): return _core_.Window_PrevControlId(*args, **kwargs) PrevControlId = staticmethod(PrevControlId) + def GetLayoutDirection(*args, **kwargs): + """ + GetLayoutDirection(self) -> int + + Get the layout direction (LTR or RTL) for this window. Returns + ``wx.Layout_Default`` if layout direction is not supported. + """ + return _core_.Window_GetLayoutDirection(*args, **kwargs) + + def SetLayoutDirection(*args, **kwargs): + """ + SetLayoutDirection(self, int dir) + + Set the layout direction (LTR or RTL) for this window. + """ + return _core_.Window_SetLayoutDirection(*args, **kwargs) + + def AdjustForLayoutDirection(*args, **kwargs): + """ + AdjustForLayoutDirection(self, int x, int width, int widthTotal) -> int + + Mirror coordinates for RTL layout if this window uses it and if the + mirroring is not done automatically like Win32. + """ + return _core_.Window_AdjustForLayoutDirection(*args, **kwargs) + def SetSize(*args, **kwargs): """ SetSize(self, Size size) @@ -7687,21 +8499,22 @@ class Window(EvtHandler): """ return _core_.Window_MoveXY(*args, **kwargs) - def SetBestFittingSize(*args, **kwargs): + def SetInitialSize(*args, **kwargs): """ - SetBestFittingSize(self, Size size=DefaultSize) + SetInitialSize(self, Size size=DefaultSize) A 'Smart' SetSize that will fill in default size components with the window's *best size* values. Also set's the minsize for use with sizers. """ - return _core_.Window_SetBestFittingSize(*args, **kwargs) + return _core_.Window_SetInitialSize(*args, **kwargs) + SetBestFittingSize = wx._deprecated(SetInitialSize, 'Use `SetInitialSize`') def Raise(*args, **kwargs): """ Raise(self) Raises the window to the top of the window hierarchy. In current - version of wxWidgets this works both for manage and child windows. + version of wxWidgets this works both for managed and child windows. """ return _core_.Window_Raise(*args, **kwargs) @@ -7710,7 +8523,7 @@ class Window(EvtHandler): Lower(self) Lowers the window to the bottom of the window hierarchy. In current - version of wxWidgets this works both for manage and child windows. + version of wxWidgets this works both for managed and child windows. """ return _core_.Window_Lower(*args, **kwargs) @@ -7754,7 +8567,10 @@ class Window(EvtHandler): """ GetPosition(self) -> Point - Get the window's position. + Get the window's position. Notice that the position is in client + coordinates for child windows and screen coordinates for the top level + ones, use `GetScreenPosition` if you need screen coordinates for all + kinds of windows. """ return _core_.Window_GetPosition(*args, **kwargs) @@ -7762,10 +8578,38 @@ class Window(EvtHandler): """ GetPositionTuple() -> (x,y) - Get the window's position. + Get the window's position. Notice that the position is in client + coordinates for child windows and screen coordinates for the top level + ones, use `GetScreenPosition` if you need screen coordinates for all + kinds of windows. """ return _core_.Window_GetPositionTuple(*args, **kwargs) + def GetScreenPosition(*args, **kwargs): + """ + GetScreenPosition(self) -> Point + + Get the position of the window in screen coordinantes. + """ + return _core_.Window_GetScreenPosition(*args, **kwargs) + + def GetScreenPositionTuple(*args, **kwargs): + """ + GetScreenPositionTuple() -> (x,y) + + Get the position of the window in screen coordinantes. + """ + return _core_.Window_GetScreenPositionTuple(*args, **kwargs) + + def GetScreenRect(*args, **kwargs): + """ + GetScreenRect(self) -> Rect + + Returns the size and position of the window in screen coordinantes as + a `wx.Rect` object. + """ + return _core_.Window_GetScreenRect(*args, **kwargs) + def GetSize(*args, **kwargs): """ GetSize(self) -> Size @@ -7786,7 +8630,7 @@ class Window(EvtHandler): """ GetRect(self) -> Rect - Returns the size and position of the window as a wx.Rect object. + Returns the size and position of the window as a `wx.Rect` object. """ return _core_.Window_GetRect(*args, **kwargs) @@ -7872,29 +8716,23 @@ class Window(EvtHandler): """ return _core_.Window_CacheBestSize(*args, **kwargs) - def GetBestFittingSize(*args, **kwargs): + def GetEffectiveMinSize(*args, **kwargs): """ - GetBestFittingSize(self) -> Size + GetEffectiveMinSize(self) -> Size This function will merge the window's best size into the window's minimum size, giving priority to the min size components, and returns the results. """ - return _core_.Window_GetBestFittingSize(*args, **kwargs) - - def GetAdjustedBestSize(*args, **kwargs): - """ - GetAdjustedBestSize(self) -> Size + return _core_.Window_GetEffectiveMinSize(*args, **kwargs) - This method is similar to GetBestSize, except in one - thing. GetBestSize should return the minimum untruncated size of the - window, while this method will return the largest of BestSize and any - user specified minimum size. ie. it is the minimum size the window - should currently be drawn at, not the minimal size it can possibly - tolerate. - """ - return _core_.Window_GetAdjustedBestSize(*args, **kwargs) + GetBestFittingSize = wx._deprecated(GetEffectiveMinSize, 'Use `GetEffectiveMinSize` instead.') + def GetAdjustedBestSize(self): + s = self.GetBestSize() + return wx.Size(max(s.width, self.GetMinWidth()), + max(s.height, self.GetMinHeight())) + GetAdjustedBestSize = wx._deprecated(GetAdjustedBestSize, 'Use `GetEffectiveMinSize` instead.') def Center(*args, **kwargs): """ @@ -8080,6 +8918,14 @@ class Window(EvtHandler): """ return _core_.Window_GetVirtualSizeTuple(*args, **kwargs) + def GetWindowBorderSize(*args, **kwargs): + """ + GetWindowBorderSize(self) -> Size + + Return the size of the left/right and top/bottom borders. + """ + return _core_.Window_GetWindowBorderSize(*args, **kwargs) + def GetBestVirtualSize(*args, **kwargs): """ GetBestVirtualSize(self) -> Size @@ -8142,9 +8988,31 @@ class Window(EvtHandler): IsEnabled(self) -> bool Returns true if the window is enabled for input, false otherwise. + This method takes into account the enabled state of parent windows up + to the top-level window. """ return _core_.Window_IsEnabled(*args, **kwargs) + def IsThisEnabled(*args, **kwargs): + """ + IsThisEnabled(self) -> bool + + Returns the internal enabled state independent of the parent(s) state, + i.e. the state in which the window would be if all of its parents are + enabled. Use `IsEnabled` to get the effective window state. + """ + return _core_.Window_IsThisEnabled(*args, **kwargs) + + def IsShownOnScreen(*args, **kwargs): + """ + IsShownOnScreen(self) -> bool + + Returns ``True`` if the window is physically visible on the screen, + i.e. it is shown and all its parents up to the toplevel window are + shown as well. + """ + return _core_.Window_IsShownOnScreen(*args, **kwargs) + def SetWindowStyleFlag(*args, **kwargs): """ SetWindowStyleFlag(self, long style) @@ -8183,6 +9051,15 @@ class Window(EvtHandler): """ return _core_.Window_IsRetained(*args, **kwargs) + def ToggleWindowStyle(*args, **kwargs): + """ + ToggleWindowStyle(self, int flag) -> bool + + Turn the flag on if it had been turned off before and vice versa, + returns True if the flag is turned on by this function call. + """ + return _core_.Window_ToggleWindowStyle(*args, **kwargs) + def SetExtraStyle(*args, **kwargs): """ SetExtraStyle(self, long exStyle) @@ -8201,6 +9078,14 @@ class Window(EvtHandler): """ return _core_.Window_GetExtraStyle(*args, **kwargs) + def HasExtraStyle(*args, **kwargs): + """ + HasExtraStyle(self, int exFlag) -> bool + + Returns ``True`` if the given extra flag is set. + """ + return _core_.Window_HasExtraStyle(*args, **kwargs) + def MakeModal(*args, **kwargs): """ MakeModal(self, bool modal=True) @@ -8270,6 +9155,14 @@ class Window(EvtHandler): """ return _core_.Window_AcceptsFocus(*args, **kwargs) + def CanAcceptFocus(*args, **kwargs): + """ + CanAcceptFocus(self) -> bool + + Can this window have focus right now? + """ + return _core_.Window_CanAcceptFocus(*args, **kwargs) + def AcceptsFocusFromKeyboard(*args, **kwargs): """ AcceptsFocusFromKeyboard(self) -> bool @@ -8280,37 +9173,32 @@ class Window(EvtHandler): """ return _core_.Window_AcceptsFocusFromKeyboard(*args, **kwargs) - def GetDefaultItem(*args, **kwargs): - """ - GetDefaultItem(self) -> Window - - Get the default child of this parent, i.e. the one which is activated - by pressing such as the OK button on a wx.Dialog. + def CanAcceptFocusFromKeyboard(*args, **kwargs): """ - return _core_.Window_GetDefaultItem(*args, **kwargs) + CanAcceptFocusFromKeyboard(self) -> bool - def SetDefaultItem(*args, **kwargs): + Can this window be assigned focus from keyboard right now? """ - SetDefaultItem(self, Window child) -> Window + return _core_.Window_CanAcceptFocusFromKeyboard(*args, **kwargs) - Set this child as default, return the old default. - """ - return _core_.Window_SetDefaultItem(*args, **kwargs) + def SetCanFocus(*args, **kwargs): + """SetCanFocus(self, bool canFocus)""" + return _core_.Window_SetCanFocus(*args, **kwargs) - def SetTmpDefaultItem(*args, **kwargs): + def NavigateIn(*args, **kwargs): """ - SetTmpDefaultItem(self, Window win) + NavigateIn(self, int flags=NavigationKeyEvent.IsForward) -> bool - Set this child as temporary default + Navigates inside this window. """ - return _core_.Window_SetTmpDefaultItem(*args, **kwargs) + return _core_.Window_NavigateIn(*args, **kwargs) def Navigate(*args, **kwargs): """ Navigate(self, int flags=NavigationKeyEvent.IsForward) -> bool - Does keyboard navigation from this window to another, by sending a - `wx.NavigationKeyEvent`. + Does keyboard navigation starting from this window to another. This is + equivalient to self.GetParent().NavigateIn(). """ return _core_.Window_Navigate(*args, **kwargs) @@ -8366,6 +9254,14 @@ class Window(EvtHandler): """ return _core_.Window_GetGrandParent(*args, **kwargs) + def GetTopLevelParent(*args, **kwargs): + """ + GetTopLevelParent(self) -> Window + + Returns the first frame or dialog in this window's parental hierarchy. + """ + return _core_.Window_GetTopLevelParent(*args, **kwargs) + def IsTopLevel(*args, **kwargs): """ IsTopLevel(self) -> bool @@ -8407,6 +9303,14 @@ class Window(EvtHandler): """ return _core_.Window_RemoveChild(*args, **kwargs) + def SetDoubleBuffered(*args, **kwargs): + """ + SetDoubleBuffered(self, bool on) + + Currently wxGTK2 only. + """ + return _core_.Window_SetDoubleBuffered(*args, **kwargs) + def FindWindowById(*args, **kwargs): """ FindWindowById(self, long winid) -> Window @@ -8437,14 +9341,16 @@ class Window(EvtHandler): SetEventHandler(self, EvtHandler handler) Sets the event handler for this window. An event handler is an object - that is capable of processing the events sent to a window. By default, - the window is its own event handler, but an application may wish to - substitute another, for example to allow central implementation of - event-handling for a variety of different window classes. + that is capable of processing the events sent to a window. (In other + words, is able to dispatch the events to handler function.) By + default, the window is its own event handler, but an application may + wish to substitute another, for example to allow central + implementation of event-handling for a variety of different window + classes. It is usually better to use `wx.Window.PushEventHandler` since this sets up a chain of event handlers, where an event not handled by one event - handler is handed to the next one in the chain. + handler is handed off to the next one in the chain. """ return _core_.Window_SetEventHandler(*args, **kwargs) @@ -8454,15 +9360,19 @@ class Window(EvtHandler): Pushes this event handler onto the event handler stack for the window. An event handler is an object that is capable of processing the events - sent to a window. By default, the window is its own event handler, but - an application may wish to substitute another, for example to allow - central implementation of event-handling for a variety of different - window classes. + sent to a window. (In other words, is able to dispatch the events to a + handler function.) By default, the window is its own event handler, + but an application may wish to substitute another, for example to + allow central implementation of event-handling for a variety of + different window classes. wx.Window.PushEventHandler allows an application to set up a chain of event handlers, where an event not handled by one event handler is - handed to the next one in the chain. Use `wx.Window.PopEventHandler` to - remove the event handler. + handed to the next one in the chain. Use `wx.Window.PopEventHandler` + to remove the event handler. Ownership of the handler is *not* given + to the window, so you should be sure to pop the handler before the + window is destroyed and either let PopEventHandler destroy it, or call + its Destroy method yourself. """ return _core_.Window_PushEventHandler(*args, **kwargs) @@ -8472,7 +9382,7 @@ class Window(EvtHandler): Removes and returns the top-most event handler on the event handler stack. If deleteHandler is True then the wx.EvtHandler object will be - destroyed after it is popped. + destroyed after it is popped, and ``None`` will be returned instead. """ return _core_.Window_PopEventHandler(*args, **kwargs) @@ -8481,7 +9391,7 @@ class Window(EvtHandler): RemoveEventHandler(self, EvtHandler handler) -> bool Find the given handler in the event handler chain and remove (but not - delete) it from the event handler chain, return True if it was found + delete) it from the event handler chain, returns True if it was found and False otherwise (this also results in an assert failure so this function should only be called when the handler is supposed to be there.) @@ -8669,7 +9579,13 @@ class Window(EvtHandler): mouse and when the mouse is released the capture returns to the window which had had captured it previously and it is only really released if there were no previous window. In particular, this means that you must - release the mouse as many times as you capture it. + release the mouse as many times as you capture it, unless the window + receives the `wx.MouseCaptureLostEvent` event. + + Any application which captures the mouse in the beginning of some + operation *must* handle `wx.MouseCaptureLostEvent` and cancel this + operation when it receives the event. The event handler must not + recapture mouse. """ return _core_.Window_CaptureMouse(*args, **kwargs) @@ -8725,7 +9641,7 @@ class Window(EvtHandler): window instead of waiting for the EVT_PAINT event to happen, (normally this would usually only happen when the flow of control returns to the event loop.) Notice that this function doesn't refresh the window and - does nothing if the window has been already repainted. Use Refresh + does nothing if the window has been already repainted. Use `Refresh` first if you want to immediately redraw the window (or some portion of it) unconditionally. """ @@ -8758,6 +9674,16 @@ class Window(EvtHandler): """ return _core_.Window_Freeze(*args, **kwargs) + def IsFrozen(*args, **kwargs): + """ + IsFrozen(self) -> bool + + Returns ``True`` if the window has been frozen and not thawed yet. + + :see: `Freeze` and `Thaw` + """ + return _core_.Window_IsFrozen(*args, **kwargs) + def Thaw(*args, **kwargs): """ Thaw(self) @@ -8778,6 +9704,17 @@ class Window(EvtHandler): """ return _core_.Window_PrepareDC(*args, **kwargs) + def IsDoubleBuffered(*args, **kwargs): + """ + IsDoubleBuffered(self) -> bool + + Returns ``True`` if the window contents is double-buffered by the + system, i.e. if any drawing done on the window is really done on a + temporary backing surface and transferred to the screen all at once + later. + """ + return _core_.Window_IsDoubleBuffered(*args, **kwargs) + def GetUpdateRegion(*args, **kwargs): """ GetUpdateRegion(self) -> Region @@ -9160,6 +10097,10 @@ class Window(EvtHandler): """ return _core_.Window_PopupMenu(*args, **kwargs) + def HasMultiplePages(*args, **kwargs): + """HasMultiplePages(self) -> bool""" + return _core_.Window_HasMultiplePages(*args, **kwargs) + def GetHandle(*args, **kwargs): """ GetHandle(self) -> long @@ -9306,7 +10247,7 @@ class Window(EvtHandler): Sets the help text to be used as context-sensitive help for this window. Note that the text is actually stored by the current - wxHelpProvider implementation, and not in the window object itself. + `wx.HelpProvider` implementation, and not in the window object itself. """ return _core_.Window_SetHelpText(*args, **kwargs) @@ -9319,13 +10260,25 @@ class Window(EvtHandler): """ return _core_.Window_SetHelpTextForId(*args, **kwargs) + def GetHelpTextAtPoint(*args, **kwargs): + """ + GetHelpTextAtPoint(self, Point pt, wxHelpEvent::Origin origin) -> String + + Get the help string associated with the given position in this window. + + Notice that pt may be invalid if event origin is keyboard or unknown + and this method should return the global window help text then + + """ + return _core_.Window_GetHelpTextAtPoint(*args, **kwargs) + def GetHelpText(*args, **kwargs): """ GetHelpText(self) -> String Gets the help text to be used as context-sensitive help for this window. Note that the text is actually stored by the current - wxHelpProvider implementation, and not in the window object itself. + `wx.HelpProvider` implementation, and not in the window object itself. """ return _core_.Window_GetHelpText(*args, **kwargs) @@ -9532,6 +10485,32 @@ class Window(EvtHandler): """ return _core_.Window_ShouldInheritColours(*args, **kwargs) + def CanSetTransparent(*args, **kwargs): + """ + CanSetTransparent(self) -> bool + + Returns ``True`` if the platform supports setting the transparency for + this window. Note that this method will err on the side of caution, + so it is possible that this will return ``False`` when it is in fact + possible to set the transparency. + + NOTE: On X-windows systems the X server must have the composite + extension loaded, and there must be a composite manager program (such + as xcompmgr) running. + """ + return _core_.Window_CanSetTransparent(*args, **kwargs) + + def SetTransparent(*args, **kwargs): + """ + SetTransparent(self, byte alpha) -> bool + + Attempt to set the transparency of this window to the ``alpha`` value, + returns True on success. The ``alpha`` value is an integer in the + range of 0 to 255, where 0 is fully transparent and 255 is fully + opaque. + """ + return _core_.Window_SetTransparent(*args, **kwargs) + def PostCreate(self, pre): """ Phase 3 of the 2-phase create @@ -9541,15 +10520,77 @@ class Window(EvtHandler): self.thisown = pre.thisown pre.thisown = 0 if hasattr(self, '_setOORInfo'): - self._setOORInfo(self) + try: + self._setOORInfo(self) + except TypeError: + pass if hasattr(self, '_setCallbackInfo'): - self._setCallbackInfo(self, self.__class__) + try: + self._setCallbackInfo(self, pre.__class__) + except TypeError: + pass def SendSizeEvent(self): - self.GetEventhandler().ProcessEvent(wx.SizeEvent((-1,-1))) - -Window_swigregister = _core_.Window_swigregister -Window_swigregister(Window) + self.GetEventHandler().ProcessEvent(wx.SizeEvent((-1,-1))) + + AcceleratorTable = property(GetAcceleratorTable,SetAcceleratorTable,doc="See `GetAcceleratorTable` and `SetAcceleratorTable`") + AutoLayout = property(GetAutoLayout,SetAutoLayout,doc="See `GetAutoLayout` and `SetAutoLayout`") + BackgroundColour = property(GetBackgroundColour,SetBackgroundColour,doc="See `GetBackgroundColour` and `SetBackgroundColour`") + BackgroundStyle = property(GetBackgroundStyle,SetBackgroundStyle,doc="See `GetBackgroundStyle` and `SetBackgroundStyle`") + EffectiveMinSize = property(GetEffectiveMinSize,doc="See `GetEffectiveMinSize`") + BestSize = property(GetBestSize,doc="See `GetBestSize`") + BestVirtualSize = property(GetBestVirtualSize,doc="See `GetBestVirtualSize`") + Border = property(GetBorder,doc="See `GetBorder`") + Caret = property(GetCaret,SetCaret,doc="See `GetCaret` and `SetCaret`") + CharHeight = property(GetCharHeight,doc="See `GetCharHeight`") + CharWidth = property(GetCharWidth,doc="See `GetCharWidth`") + Children = property(GetChildren,doc="See `GetChildren`") + ClientAreaOrigin = property(GetClientAreaOrigin,doc="See `GetClientAreaOrigin`") + ClientRect = property(GetClientRect,SetClientRect,doc="See `GetClientRect` and `SetClientRect`") + ClientSize = property(GetClientSize,SetClientSize,doc="See `GetClientSize` and `SetClientSize`") + Constraints = property(GetConstraints,SetConstraints,doc="See `GetConstraints` and `SetConstraints`") + ContainingSizer = property(GetContainingSizer,SetContainingSizer,doc="See `GetContainingSizer` and `SetContainingSizer`") + Cursor = property(GetCursor,SetCursor,doc="See `GetCursor` and `SetCursor`") + DefaultAttributes = property(GetDefaultAttributes,doc="See `GetDefaultAttributes`") + DropTarget = property(GetDropTarget,SetDropTarget,doc="See `GetDropTarget` and `SetDropTarget`") + EventHandler = property(GetEventHandler,SetEventHandler,doc="See `GetEventHandler` and `SetEventHandler`") + ExtraStyle = property(GetExtraStyle,SetExtraStyle,doc="See `GetExtraStyle` and `SetExtraStyle`") + Font = property(GetFont,SetFont,doc="See `GetFont` and `SetFont`") + ForegroundColour = property(GetForegroundColour,SetForegroundColour,doc="See `GetForegroundColour` and `SetForegroundColour`") + GrandParent = property(GetGrandParent,doc="See `GetGrandParent`") + TopLevelParent = property(GetTopLevelParent,doc="See `GetTopLevelParent`") + Handle = property(GetHandle,doc="See `GetHandle`") + HelpText = property(GetHelpText,SetHelpText,doc="See `GetHelpText` and `SetHelpText`") + Id = property(GetId,SetId,doc="See `GetId` and `SetId`") + Label = property(GetLabel,SetLabel,doc="See `GetLabel` and `SetLabel`") + LayoutDirection = property(GetLayoutDirection,SetLayoutDirection,doc="See `GetLayoutDirection` and `SetLayoutDirection`") + MaxHeight = property(GetMaxHeight,doc="See `GetMaxHeight`") + MaxSize = property(GetMaxSize,SetMaxSize,doc="See `GetMaxSize` and `SetMaxSize`") + MaxWidth = property(GetMaxWidth,doc="See `GetMaxWidth`") + MinHeight = property(GetMinHeight,doc="See `GetMinHeight`") + MinSize = property(GetMinSize,SetMinSize,doc="See `GetMinSize` and `SetMinSize`") + MinWidth = property(GetMinWidth,doc="See `GetMinWidth`") + Name = property(GetName,SetName,doc="See `GetName` and `SetName`") + Parent = property(GetParent,doc="See `GetParent`") + Position = property(GetPosition,SetPosition,doc="See `GetPosition` and `SetPosition`") + Rect = property(GetRect,SetRect,doc="See `GetRect` and `SetRect`") + ScreenPosition = property(GetScreenPosition,doc="See `GetScreenPosition`") + ScreenRect = property(GetScreenRect,doc="See `GetScreenRect`") + Size = property(GetSize,SetSize,doc="See `GetSize` and `SetSize`") + Sizer = property(GetSizer,SetSizer,doc="See `GetSizer` and `SetSizer`") + ThemeEnabled = property(GetThemeEnabled,SetThemeEnabled,doc="See `GetThemeEnabled` and `SetThemeEnabled`") + ToolTip = property(GetToolTip,SetToolTip,doc="See `GetToolTip` and `SetToolTip`") + UpdateClientRect = property(GetUpdateClientRect,doc="See `GetUpdateClientRect`") + UpdateRegion = property(GetUpdateRegion,doc="See `GetUpdateRegion`") + Validator = property(GetValidator,SetValidator,doc="See `GetValidator` and `SetValidator`") + VirtualSize = property(GetVirtualSize,SetVirtualSize,doc="See `GetVirtualSize` and `SetVirtualSize`") + WindowStyle = property(GetWindowStyle,SetWindowStyle,doc="See `GetWindowStyle` and `SetWindowStyle`") + WindowStyleFlag = property(GetWindowStyleFlag,SetWindowStyleFlag,doc="See `GetWindowStyleFlag` and `SetWindowStyleFlag`") + WindowVariant = property(GetWindowVariant,SetWindowVariant,doc="See `GetWindowVariant` and `SetWindowVariant`") + Shown = property(IsShown,Show,doc="See `IsShown` and `Show`") + Enabled = property(IsEnabled,Enable,doc="See `IsEnabled` and `Enable`") + TopLevel = property(IsTopLevel,doc="See `IsTopLevel`") +_core_.Window_swigregister(Window) def PreWindow(*args, **kwargs): """ @@ -9738,8 +10779,8 @@ class Validator(EvtHandler): return _core_.Validator_SetBellOnError(*args, **kwargs) SetBellOnError = staticmethod(SetBellOnError) -Validator_swigregister = _core_.Validator_swigregister -Validator_swigregister(Validator) + Window = property(GetWindow,SetWindow,doc="See `GetWindow` and `SetWindow`") +_core_.Validator_swigregister(Validator) def Validator_IsSilent(*args): """Validator_IsSilent() -> bool""" @@ -9756,16 +10797,13 @@ class PyValidator(Validator): def __init__(self, *args, **kwargs): """__init__(self) -> PyValidator""" _core_.PyValidator_swiginit(self,_core_.new_PyValidator(*args, **kwargs)) - - self._setCallbackInfo(self, PyValidator, 1) - self._setOORInfo(self) + self._setOORInfo(self);PyValidator._setCallbackInfo(self, self, PyValidator) def _setCallbackInfo(*args, **kwargs): - """_setCallbackInfo(self, PyObject self, PyObject _class, int incref=True)""" + """_setCallbackInfo(self, PyObject self, PyObject _class, int incref=1)""" return _core_.PyValidator__setCallbackInfo(*args, **kwargs) -PyValidator_swigregister = _core_.PyValidator_swigregister -PyValidator_swigregister(PyValidator) +_core_.PyValidator_swigregister(PyValidator) #--------------------------------------------------------------------------- @@ -9779,7 +10817,10 @@ class Menu(EvtHandler): self._setOORInfo(self) def Append(*args, **kwargs): - """Append(self, int id, String text, String help=EmptyString, int kind=ITEM_NORMAL) -> MenuItem""" + """ + Append(self, int id, String text=EmptyString, String help=EmptyString, + int kind=ITEM_NORMAL) -> MenuItem + """ return _core_.Menu_Append(*args, **kwargs) def AppendSeparator(*args, **kwargs): @@ -9798,6 +10839,10 @@ class Menu(EvtHandler): """AppendMenu(self, int id, String text, Menu submenu, String help=EmptyString) -> MenuItem""" return _core_.Menu_AppendMenu(*args, **kwargs) + def AppendSubMenu(*args, **kwargs): + """AppendSubMenu(self, Menu submenu, String text, String help=EmptyString) -> MenuItem""" + return _core_.Menu_AppendSubMenu(*args, **kwargs) + def AppendItem(*args, **kwargs): """AppendItem(self, MenuItem item) -> MenuItem""" return _core_.Menu_AppendItem(*args, **kwargs) @@ -9816,7 +10861,7 @@ class Menu(EvtHandler): def Insert(*args, **kwargs): """ - Insert(self, size_t pos, int id, String text, String help=EmptyString, + Insert(self, size_t pos, int id, String text=EmptyString, String help=EmptyString, int kind=ITEM_NORMAL) -> MenuItem """ return _core_.Menu_Insert(*args, **kwargs) @@ -9838,7 +10883,10 @@ class Menu(EvtHandler): return _core_.Menu_InsertMenu(*args, **kwargs) def Prepend(*args, **kwargs): - """Prepend(self, int id, String text, String help=EmptyString, int kind=ITEM_NORMAL) -> MenuItem""" + """ + Prepend(self, int id, String text=EmptyString, String help=EmptyString, + int kind=ITEM_NORMAL) -> MenuItem + """ return _core_.Menu_Prepend(*args, **kwargs) def PrependSeparator(*args, **kwargs): @@ -9861,9 +10909,15 @@ class Menu(EvtHandler): """Remove(self, int id) -> MenuItem""" return _core_.Menu_Remove(*args, **kwargs) - def RemoveItem(*args, **kwargs): + def RemoveItem(self, item): """RemoveItem(self, MenuItem item) -> MenuItem""" - return _core_.Menu_RemoveItem(*args, **kwargs) + #// The return object is always the parameter, so return that + #// proxy instead of the new one + val = _core_.Menu_RemoveItem(self, item) + item.this.own(val.this.own()) + val.this.disown() + return item + def Delete(*args, **kwargs): """Delete(self, int id) -> bool""" @@ -9879,29 +10933,16 @@ class Menu(EvtHandler): Deletes the C++ object this Python object is a proxy for. """ - val = _core_.Menu_Destroy(*args, **kwargs) - args[0].thisown = 0 - return val + args[0].this.own(False) + return _core_.Menu_Destroy(*args, **kwargs) def DestroyId(*args, **kwargs): - """ - DestroyId(self, int id) -> bool - - Deletes the C++ object this Python object is a proxy for. - """ - val = _core_.Menu_DestroyId(*args, **kwargs) - args[0].thisown = 0 - return val + """DestroyId(self, int id) -> bool""" + return _core_.Menu_DestroyId(*args, **kwargs) def DestroyItem(*args, **kwargs): - """ - DestroyItem(self, MenuItem item) -> bool - - Deletes the C++ object this Python object is a proxy for. - """ - val = _core_.Menu_DestroyItem(*args, **kwargs) - args[0].thisown = 0 - return val + """DestroyItem(self, MenuItem item) -> bool""" + return _core_.Menu_DestroyItem(*args, **kwargs) def GetMenuItemCount(*args, **kwargs): """GetMenuItemCount(self) -> size_t""" @@ -10011,8 +11052,16 @@ class Menu(EvtHandler): """GetParent(self) -> Menu""" return _core_.Menu_GetParent(*args, **kwargs) -Menu_swigregister = _core_.Menu_swigregister -Menu_swigregister(Menu) + EventHandler = property(GetEventHandler,SetEventHandler,doc="See `GetEventHandler` and `SetEventHandler`") + HelpString = property(GetHelpString,SetHelpString,doc="See `GetHelpString` and `SetHelpString`") + InvokingWindow = property(GetInvokingWindow,SetInvokingWindow,doc="See `GetInvokingWindow` and `SetInvokingWindow`") + MenuBar = property(GetMenuBar,doc="See `GetMenuBar`") + MenuItemCount = property(GetMenuItemCount,doc="See `GetMenuItemCount`") + MenuItems = property(GetMenuItems,doc="See `GetMenuItems`") + Parent = property(GetParent,SetParent,doc="See `GetParent` and `SetParent`") + Style = property(GetStyle,doc="See `GetStyle`") + Title = property(GetTitle,SetTitle,doc="See `GetTitle` and `SetTitle`") +_core_.Menu_swigregister(Menu) DefaultValidator = cvar.DefaultValidator #--------------------------------------------------------------------------- @@ -10126,6 +11175,10 @@ class MenuBar(Window): """Detach(self)""" return _core_.MenuBar_Detach(*args, **kwargs) + def UpdateMenus(*args, **kwargs): + """UpdateMenus(self)""" + return _core_.MenuBar_UpdateMenus(*args, **kwargs) + def SetAutoWindowMenu(*args, **kwargs): """SetAutoWindowMenu(bool enable)""" return _core_.MenuBar_SetAutoWindowMenu(*args, **kwargs) @@ -10136,8 +11189,22 @@ class MenuBar(Window): return _core_.MenuBar_GetAutoWindowMenu(*args, **kwargs) GetAutoWindowMenu = staticmethod(GetAutoWindowMenu) -MenuBar_swigregister = _core_.MenuBar_swigregister -MenuBar_swigregister(MenuBar) + def GetMenus(self): + """Return a list of (menu, label) items for the menus in the MenuBar. """ + return [(self.GetMenu(i), self.GetLabelTop(i)) + for i in range(self.GetMenuCount())] + + def SetMenus(self, items): + """Clear and add new menus to the MenuBar from a list of (menu, label) items. """ + for i in range(self.GetMenuCount()-1, -1, -1): + self.Remove(i) + for m, l in items: + self.Append(m, l) + + Frame = property(GetFrame,doc="See `GetFrame`") + MenuCount = property(GetMenuCount,doc="See `GetMenuCount`") + Menus = property(GetMenus,SetMenus,doc="See `GetMenus` and `SetMenus`") +_core_.MenuBar_swigregister(MenuBar) def MenuBar_SetAutoWindowMenu(*args, **kwargs): """MenuBar_SetAutoWindowMenu(bool enable)""" @@ -10155,13 +11222,14 @@ class MenuItem(Object): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, Menu parentMenu=None, int id=ID_ANY, String text=EmptyString, + __init__(self, Menu parentMenu=None, int id=ID_SEPARATOR, String text=EmptyString, String help=EmptyString, int kind=ITEM_NORMAL, Menu subMenu=None) -> MenuItem """ _core_.MenuItem_swiginit(self,_core_.new_MenuItem(*args, **kwargs)) __swig_destroy__ = _core_.delete_MenuItem __del__ = lambda self : None; + def Destroy(self): pass def GetMenu(*args, **kwargs): """GetMenu(self) -> Menu""" return _core_.MenuItem_GetMenu(*args, **kwargs) @@ -10332,8 +11400,21 @@ class MenuItem(Object): """ResetOwnerDrawn(self)""" return _core_.MenuItem_ResetOwnerDrawn(*args, **kwargs) -MenuItem_swigregister = _core_.MenuItem_swigregister -MenuItem_swigregister(MenuItem) + Accel = property(GetAccel,SetAccel,doc="See `GetAccel` and `SetAccel`") + BackgroundColour = property(GetBackgroundColour,SetBackgroundColour,doc="See `GetBackgroundColour` and `SetBackgroundColour`") + Bitmap = property(GetBitmap,SetBitmap,doc="See `GetBitmap` and `SetBitmap`") + DisabledBitmap = property(GetDisabledBitmap,SetDisabledBitmap,doc="See `GetDisabledBitmap` and `SetDisabledBitmap`") + Font = property(GetFont,SetFont,doc="See `GetFont` and `SetFont`") + Help = property(GetHelp,SetHelp,doc="See `GetHelp` and `SetHelp`") + Id = property(GetId,SetId,doc="See `GetId` and `SetId`") + Kind = property(GetKind,SetKind,doc="See `GetKind` and `SetKind`") + Label = property(GetLabel,doc="See `GetLabel`") + MarginWidth = property(GetMarginWidth,SetMarginWidth,doc="See `GetMarginWidth` and `SetMarginWidth`") + Menu = property(GetMenu,SetMenu,doc="See `GetMenu` and `SetMenu`") + SubMenu = property(GetSubMenu,SetSubMenu,doc="See `GetSubMenu` and `SetSubMenu`") + Text = property(GetText,SetText,doc="See `GetText` and `SetText`") + TextColour = property(GetTextColour,SetTextColour,doc="See `GetTextColour` and `SetTextColour`") +_core_.MenuItem_swigregister(MenuItem) def MenuItem_GetLabelFromText(*args, **kwargs): """MenuItem_GetLabelFromText(String text) -> String""" @@ -10376,6 +11457,22 @@ class Control(Window): """ return _core_.Control_Create(*args, **kwargs) + def GetAlignment(*args, **kwargs): + """ + GetAlignment(self) -> int + + Get the control alignment (left/right/centre, top/bottom/centre) + """ + return _core_.Control_GetAlignment(*args, **kwargs) + + def GetLabelText(*args, **kwargs): + """ + GetLabelText(self) -> String + + Get just the text of the label, without mnemonic characters ('&') + """ + return _core_.Control_GetLabelText(*args, **kwargs) + def Command(*args, **kwargs): """ Command(self, CommandEvent event) @@ -10387,14 +11484,15 @@ class Control(Window): """ return _core_.Control_Command(*args, **kwargs) - def GetLabel(*args, **kwargs): + def RemoveMnemonics(*args, **kwargs): """ - GetLabel(self) -> String + RemoveMnemonics(String str) -> String - Return a control's text. + removes the mnemonics characters """ - return _core_.Control_GetLabel(*args, **kwargs) + return _core_.Control_RemoveMnemonics(*args, **kwargs) + RemoveMnemonics = staticmethod(RemoveMnemonics) def GetClassDefaultAttributes(*args, **kwargs): """ GetClassDefaultAttributes(int variant=WINDOW_VARIANT_NORMAL) -> VisualAttributes @@ -10413,8 +11511,9 @@ class Control(Window): return _core_.Control_GetClassDefaultAttributes(*args, **kwargs) GetClassDefaultAttributes = staticmethod(GetClassDefaultAttributes) -Control_swigregister = _core_.Control_swigregister -Control_swigregister(Control) + Alignment = property(GetAlignment,doc="See `GetAlignment`") + LabelText = property(GetLabelText,doc="See `GetLabelText`") +_core_.Control_swigregister(Control) ControlNameStr = cvar.ControlNameStr def PreControl(*args, **kwargs): @@ -10426,6 +11525,14 @@ def PreControl(*args, **kwargs): val = _core_.new_PreControl(*args, **kwargs) return val +def Control_RemoveMnemonics(*args, **kwargs): + """ + Control_RemoveMnemonics(String str) -> String + + removes the mnemonics characters + """ + return _core_.Control_RemoveMnemonics(*args, **kwargs) + def Control_GetClassDefaultAttributes(*args, **kwargs): """ Control_GetClassDefaultAttributes(int variant=WINDOW_VARIANT_NORMAL) -> VisualAttributes @@ -10614,8 +11721,22 @@ class ItemContainer(object): """ return _core_.ItemContainer_Select(*args, **kwargs) -ItemContainer_swigregister = _core_.ItemContainer_swigregister -ItemContainer_swigregister(ItemContainer) + def GetItems(self): + """Return a list of the strings in the control""" + return [self.GetString(i) for i in xrange(self.GetCount())] + + def SetItems(self, items): + """Clear and set the strings in the control from a list""" + self.Clear() + for i in items: + self.Append(i) + + Count = property(GetCount,doc="See `GetCount`") + Items = property(GetItems,SetItems,doc="See `GetItems` and `SetItems`") + Selection = property(GetSelection,SetSelection,doc="See `GetSelection` and `SetSelection`") + StringSelection = property(GetStringSelection,SetStringSelection,doc="See `GetStringSelection` and `SetStringSelection`") + Strings = property(GetStrings,doc="See `GetStrings`") +_core_.ItemContainer_swigregister(ItemContainer) #--------------------------------------------------------------------------- @@ -10628,18 +11749,236 @@ class ControlWithItems(Control,ItemContainer): thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') def __init__(self): raise AttributeError, "No constructor defined" __repr__ = _swig_repr -ControlWithItems_swigregister = _core_.ControlWithItems_swigregister -ControlWithItems_swigregister(ControlWithItems) +_core_.ControlWithItems_swigregister(ControlWithItems) #--------------------------------------------------------------------------- +class SizerFlags(object): + """ + Normally, when you add an item to a sizer via `wx.Sizer.Add`, you have + to specify a lot of flags and parameters which can be unwieldy. This + is where wx.SizerFlags comes in: it allows you to specify all + parameters using the named methods instead. For example, instead of:: + + sizer.Add(ctrl, 0, wx.EXPAND | wx.ALL, 10) + + you can now write:: + + sizer.AddF(ctrl, wx.SizerFlags().Expand().Border(wx.ALL, 10)) + + This is more readable and also allows you to create wx.SizerFlags + objects which can be reused for several sizer items.:: + + flagsExpand = wx.SizerFlags(1) + flagsExpand.Expand().Border(wx.ALL, 10) + sizer.AddF(ctrl1, flagsExpand) + sizer.AddF(ctrl2, flagsExpand) + + Note that by specification, all methods of wx.SizerFlags return the + wx.SizerFlags object itself allowing chaining multiple method calls + like in the examples above. + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self, int proportion=0) -> SizerFlags + + Constructs the flags object with the specified proportion. + """ + _core_.SizerFlags_swiginit(self,_core_.new_SizerFlags(*args, **kwargs)) + __swig_destroy__ = _core_.delete_SizerFlags + __del__ = lambda self : None; + def Proportion(*args, **kwargs): + """ + Proportion(self, int proportion) -> SizerFlags + + Sets the item's proportion value. + """ + return _core_.SizerFlags_Proportion(*args, **kwargs) + + def Align(*args, **kwargs): + """ + Align(self, int alignment) -> SizerFlags + + Sets the item's alignment + """ + return _core_.SizerFlags_Align(*args, **kwargs) + + def Expand(*args, **kwargs): + """ + Expand(self) -> SizerFlags + + Sets the wx.EXPAND flag, which will cause the item to be expanded to + fill as much space as it is given by the sizer. + """ + return _core_.SizerFlags_Expand(*args, **kwargs) + + def Centre(*args, **kwargs): + """ + Centre(self) -> SizerFlags + + Same as `Center` for those with an alternate dialect of English. + """ + return _core_.SizerFlags_Centre(*args, **kwargs) + + def Center(*args, **kwargs): + """ + Center(self) -> SizerFlags + + Sets the centering alignment flags. + """ + return _core_.SizerFlags_Center(*args, **kwargs) + + def Left(*args, **kwargs): + """ + Left(self) -> SizerFlags + + Aligns the object to the left, a shortcut for calling + Align(wx.ALIGN_LEFT) + """ + return _core_.SizerFlags_Left(*args, **kwargs) + + def Right(*args, **kwargs): + """ + Right(self) -> SizerFlags + + Aligns the object to the right, a shortcut for calling + Align(wx.ALIGN_RIGHT) + """ + return _core_.SizerFlags_Right(*args, **kwargs) + + def Top(*args, **kwargs): + """ + Top(self) -> SizerFlags + + Aligns the object to the top of the available space, a shortcut for + calling Align(wx.ALIGN_TOP) + """ + return _core_.SizerFlags_Top(*args, **kwargs) + + def Bottom(*args, **kwargs): + """ + Bottom(self) -> SizerFlags + + Aligns the object to the bottom of the available space, a shortcut for + calling Align(wx.ALIGN_BOTTOM) + """ + return _core_.SizerFlags_Bottom(*args, **kwargs) + + def Shaped(*args, **kwargs): + """ + Shaped(self) -> SizerFlags + + Sets the wx.SHAPED flag. + """ + return _core_.SizerFlags_Shaped(*args, **kwargs) + + def FixedMinSize(*args, **kwargs): + """ + FixedMinSize(self) -> SizerFlags + + Sets the wx.FIXED_MINSIZE flag. + """ + return _core_.SizerFlags_FixedMinSize(*args, **kwargs) + + def Border(*args, **kwargs): + """ + Border(self, int direction=ALL, int borderInPixels=-1) -> SizerFlags + + Sets the border of the item in the direction(s) or sides given by the + direction parameter. If the borderInPixels value is not given then + the default border size (see `GetDefaultBorder`) will be used. + """ + return _core_.SizerFlags_Border(*args, **kwargs) + + def DoubleBorder(*args, **kwargs): + """ + DoubleBorder(self, int direction=ALL) -> SizerFlags + + Sets the border in the given direction to twice the default border + size. + """ + return _core_.SizerFlags_DoubleBorder(*args, **kwargs) + + def TripleBorder(*args, **kwargs): + """ + TripleBorder(self, int direction=ALL) -> SizerFlags + + Sets the border in the given direction to three times the default + border size. + """ + return _core_.SizerFlags_TripleBorder(*args, **kwargs) + + def HorzBorder(*args, **kwargs): + """ + HorzBorder(self) -> SizerFlags + + Sets the left and right borders to the default border size. + """ + return _core_.SizerFlags_HorzBorder(*args, **kwargs) + + def DoubleHorzBorder(*args, **kwargs): + """ + DoubleHorzBorder(self) -> SizerFlags + + Sets the left and right borders to twice the default border size. + """ + return _core_.SizerFlags_DoubleHorzBorder(*args, **kwargs) + + def GetDefaultBorder(*args, **kwargs): + """ + GetDefaultBorder() -> int + + Returns the default border size used by the other border methods + """ + return _core_.SizerFlags_GetDefaultBorder(*args, **kwargs) + + GetDefaultBorder = staticmethod(GetDefaultBorder) + def GetProportion(*args, **kwargs): + """ + GetProportion(self) -> int + + Returns the proportion value to be used in the sizer item. + """ + return _core_.SizerFlags_GetProportion(*args, **kwargs) + + def GetFlags(*args, **kwargs): + """ + GetFlags(self) -> int + + Returns the flags value to be used in the sizer item. + """ + return _core_.SizerFlags_GetFlags(*args, **kwargs) + + def GetBorderInPixels(*args, **kwargs): + """ + GetBorderInPixels(self) -> int + + Returns the border value in pixels to be used in the sizer item. + """ + return _core_.SizerFlags_GetBorderInPixels(*args, **kwargs) + +_core_.SizerFlags_swigregister(SizerFlags) + +def SizerFlags_GetDefaultBorder(*args): + """ + SizerFlags_GetDefaultBorder() -> int + + Returns the default border size used by the other border methods + """ + return _core_.SizerFlags_GetDefaultBorder(*args) + class SizerItem(Object): """ The wx.SizerItem class is used to track the position, size and other - attributes of each item managed by a `wx.Sizer`. In normal usage user - code should never need to deal directly with a wx.SizerItem, but - custom classes derived from `wx.PySizer` will probably need to use the - collection of wx.SizerItems held by wx.Sizer when calculating layout. + attributes of each item managed by a `wx.Sizer`. It is not usually + necessary to use this class because the sizer elements can also be + identified by their positions or window or sizer references but + sometimes it may be more convenient to use wx.SizerItem directly. + Also, custom classes derived from `wx.PySizer` will probably need to + use the collection of wx.SizerItems held by wx.Sizer when calculating + layout. :see: `wx.Sizer`, `wx.GBSizerItem` """ @@ -10849,14 +12188,6 @@ class SizerItem(Object): """ return _core_.SizerItem_GetWindow(*args, **kwargs) - def SetWindow(*args, **kwargs): - """ - SetWindow(self, Window window) - - Set the window to be managed by this sizer item. - """ - return _core_.SizerItem_SetWindow(*args, **kwargs) - def GetSizer(*args, **kwargs): """ GetSizer(self) -> Sizer @@ -10865,6 +12196,22 @@ class SizerItem(Object): """ return _core_.SizerItem_GetSizer(*args, **kwargs) + def GetSpacer(*args, **kwargs): + """ + GetSpacer(self) -> Size + + Get the size of the spacer managed by this sizer item. + """ + return _core_.SizerItem_GetSpacer(*args, **kwargs) + + def SetWindow(*args, **kwargs): + """ + SetWindow(self, Window window) + + Set the window to be managed by this sizer item. + """ + return _core_.SizerItem_SetWindow(*args, **kwargs) + def SetSizer(*args, **kwargs): """ SetSizer(self, Sizer sizer) @@ -10873,21 +12220,41 @@ class SizerItem(Object): """ return _core_.SizerItem_SetSizer(*args, **kwargs) - def GetSpacer(*args, **kwargs): + def SetSpacer(*args, **kwargs): """ - GetSpacer(self) -> Size + SetSpacer(self, Size size) - Get the size of the spacer managed by this sizer item. + Set the size of the spacer to be managed by this sizer item. """ - return _core_.SizerItem_GetSpacer(*args, **kwargs) + return _core_.SizerItem_SetSpacer(*args, **kwargs) - def SetSpacer(*args, **kwargs): + SetWindow = wx._deprecated(SetWindow, "Use `AssignWindow` instead.") + SetSizer = wx._deprecated(SetSizer, "Use `AssignSizer` instead.") + SetSpacer = wx._deprecated(SetSpacer, "Use `AssignSpacer` instead.") + + def AssignWindow(*args, **kwargs): """ - SetSpacer(self, Size size) + AssignWindow(self, Window window) + + Set the window to be managed by this sizer item. + """ + return _core_.SizerItem_AssignWindow(*args, **kwargs) + + def AssignSizer(*args, **kwargs): + """ + AssignSizer(self, Sizer sizer) + + Set the subsizer to be managed by this sizer item. + """ + return _core_.SizerItem_AssignSizer(*args, **kwargs) + + def AssignSpacer(*args, **kwargs): + """ + AssignSpacer(self, Size size) Set the size of the spacer to be managed by this sizer item. """ - return _core_.SizerItem_SetSpacer(*args, **kwargs) + return _core_.SizerItem_AssignSpacer(*args, **kwargs) def Show(*args, **kwargs): """ @@ -10932,8 +12299,20 @@ class SizerItem(Object): """ return _core_.SizerItem_SetUserData(*args, **kwargs) -SizerItem_swigregister = _core_.SizerItem_swigregister -SizerItem_swigregister(SizerItem) + Border = property(GetBorder,SetBorder,doc="See `GetBorder` and `SetBorder`") + Flag = property(GetFlag,SetFlag,doc="See `GetFlag` and `SetFlag`") + MinSize = property(GetMinSize,doc="See `GetMinSize`") + MinSizeWithBorder = property(GetMinSizeWithBorder,doc="See `GetMinSizeWithBorder`") + Position = property(GetPosition,doc="See `GetPosition`") + Proportion = property(GetProportion,SetProportion,doc="See `GetProportion` and `SetProportion`") + Ratio = property(GetRatio,SetRatio,doc="See `GetRatio` and `SetRatio`") + Rect = property(GetRect,doc="See `GetRect`") + Size = property(GetSize,doc="See `GetSize`") + Sizer = property(GetSizer,AssignSizer,doc="See `GetSizer` and `AssignSizer`") + Spacer = property(GetSpacer,AssignSpacer,doc="See `GetSpacer` and `AssignSpacer`") + UserData = property(GetUserData,SetUserData,doc="See `GetUserData` and `SetUserData`") + Window = property(GetWindow,AssignWindow,doc="See `GetWindow` and `AssignWindow`") +_core_.SizerItem_swigregister(SizerItem) def SizerItemWindow(*args, **kwargs): """ @@ -10970,8 +12349,8 @@ class Sizer(Object): wx.Sizer is the abstract base class used for laying out subwindows in a window. You cannot use wx.Sizer directly; instead, you will have to use one of the sizer classes derived from it such as `wx.BoxSizer`, - `wx.StaticBoxSizer`, `wx.NotebookSizer`, `wx.GridSizer`, `wx.FlexGridSizer` - and `wx.GridBagSizer`. + `wx.StaticBoxSizer`, `wx.GridSizer`, `wx.FlexGridSizer` and + `wx.GridBagSizer`. The concept implemented by sizers in wxWidgets is closely related to layout tools in other GUI toolkits, such as Java's AWT, the GTK @@ -11013,6 +12392,15 @@ class Sizer(Object): """ return _core_.Sizer_Add(*args, **kwargs) + def AddF(*args, **kwargs): + """ + AddF(self, item, wx.SizerFlags flags) -> wx.SizerItem + + Similar to `Add` but uses the `wx.SizerFlags` convenience class for + setting the various flags, options and borders. + """ + return _core_.Sizer_AddF(*args, **kwargs) + def Insert(*args, **kwargs): """ Insert(self, int before, item, int proportion=0, int flag=0, int border=0, @@ -11023,6 +12411,15 @@ class Sizer(Object): """ return _core_.Sizer_Insert(*args, **kwargs) + def InsertF(*args, **kwargs): + """ + InsertF(self, int before, item, wx.SizerFlags flags) -> wx.SizerItem + + Similar to `Insert`, but uses the `wx.SizerFlags` convenience class + for setting the various flags, options and borders. + """ + return _core_.Sizer_InsertF(*args, **kwargs) + def Prepend(*args, **kwargs): """ Prepend(self, item, int proportion=0, int flag=0, int border=0, @@ -11033,6 +12430,15 @@ class Sizer(Object): """ return _core_.Sizer_Prepend(*args, **kwargs) + def PrependF(*args, **kwargs): + """ + PrependF(self, item, wx.SizerFlags flags) -> wx.SizerItem + + Similar to `Prepend` but uses the `wx.SizerFlags` convenience class + for setting the various flags, options and borders. + """ + return _core_.Sizer_PrependF(*args, **kwargs) + def Remove(*args, **kwargs): """ Remove(self, item) -> bool @@ -11060,7 +12466,7 @@ class Sizer(Object): def GetItem(*args, **kwargs): """ - GetItem(self, item) -> wx.SizerItem + GetItem(self, item, recursive=False) -> wx.SizerItem Returns the `wx.SizerItem` which holds the *item* given. The *item* parameter can be either a window, a sizer, or the zero-based index of @@ -11072,6 +12478,57 @@ class Sizer(Object): """_SetItemMinSize(self, PyObject item, Size size)""" return _core_.Sizer__SetItemMinSize(*args, **kwargs) + def _ReplaceWin(*args, **kwargs): + """_ReplaceWin(self, Window oldwin, Window newwin, bool recursive=False) -> bool""" + return _core_.Sizer__ReplaceWin(*args, **kwargs) + + def _ReplaceSizer(*args, **kwargs): + """_ReplaceSizer(self, Sizer oldsz, Sizer newsz, bool recursive=False) -> bool""" + return _core_.Sizer__ReplaceSizer(*args, **kwargs) + + def _ReplaceItem(*args, **kwargs): + """_ReplaceItem(self, size_t index, SizerItem newitem) -> bool""" + return _core_.Sizer__ReplaceItem(*args, **kwargs) + + def Replace(self, olditem, item, recursive=False): + """ + Detaches the given ``olditem`` from the sizer and replaces it with + ``item`` which can be a window, sizer, or `wx.SizerItem`. The + detached child is destroyed only if it is not a window, (because + windows are owned by their parent, not the sizer.) The + ``recursive`` parameter can be used to search for the given + element recursivly in subsizers. + + This method does not cause any layout or resizing to take place, + call `Layout` to do so. + + Returns ``True`` if the child item was found and removed. + """ + if isinstance(olditem, wx.Window): + return self._ReplaceWin(olditem, item, recursive) + elif isinstance(olditem, wx.Sizer): + return self._ReplaceSizer(olditem, item, recursive) + elif isinstance(olditem, int): + return self._ReplaceItem(olditem, item) + else: + raise TypeError("Expected Window, Sizer, or integer for first parameter.") + + def SetContainingWindow(*args, **kwargs): + """ + SetContainingWindow(self, Window window) + + Set (or unset) the window this sizer is used in. + """ + return _core_.Sizer_SetContainingWindow(*args, **kwargs) + + def GetContainingWindow(*args, **kwargs): + """ + GetContainingWindow(self) -> Window + + Get the window this sizer is used in. + """ + return _core_.Sizer_GetContainingWindow(*args, **kwargs) + def SetItemMinSize(self, item, *args): """ SetItemMinSize(self, item, Size size) @@ -11123,6 +12580,50 @@ class Sizer(Object): item = (item, ) self.Add(*item) + def AddSpacer(self, *args, **kw): + """AddSpacer(int size) --> SizerItem + + Add a spacer that is (size,size) pixels. + """ + if args and type(args[0]) == int: + return self.Add( (args[0],args[0] ), 0) + else: # otherwise stay compatible with old AddSpacer + return self.Add(*args, **kw) + def PrependSpacer(self, *args, **kw): + """PrependSpacer(int size) --> SizerItem + + Prepend a spacer that is (size, size) pixels.""" + if args and type(args[0]) == int: + return self.Prepend( (args[0],args[0] ), 0) + else: # otherwise stay compatible with old PrependSpacer + return self.Prepend(*args, **kw) + def InsertSpacer(self, index, *args, **kw): + """InsertSpacer(int index, int size) --> SizerItem + + Insert a spacer at position index that is (size, size) pixels.""" + if args and type(args[0]) == int: + return self.Insert( index, (args[0],args[0] ), 0) + else: # otherwise stay compatible with old InsertSpacer + return self.Insert(index, *args, **kw) + + + def AddStretchSpacer(self, prop=1): + """AddStretchSpacer(int prop=1) --> SizerItem + + Add a stretchable spacer.""" + return self.Add((0,0), prop) + def PrependStretchSpacer(self, prop=1): + """PrependStretchSpacer(int prop=1) --> SizerItem + + Prepend a stretchable spacer.""" + return self.Prepend((0,0), prop) + def InsertStretchSpacer(self, index, prop=1): + """InsertStretchSpacer(int index, int prop=1) --> SizerItem + + Insert a stretchable spacer.""" + return self.Insert(index, (0,0), prop) + + # for backwards compatibility only, please do not use in new code def AddWindow(self, *args, **kw): """Compatibility alias for `Add`.""" @@ -11130,9 +12631,6 @@ class Sizer(Object): def AddSizer(self, *args, **kw): """Compatibility alias for `Add`.""" return self.Add(*args, **kw) - def AddSpacer(self, *args, **kw): - """Compatibility alias for `Add`.""" - return self.Add(*args, **kw) def PrependWindow(self, *args, **kw): """Compatibility alias for `Prepend`.""" @@ -11140,9 +12638,6 @@ class Sizer(Object): def PrependSizer(self, *args, **kw): """Compatibility alias for `Prepend`.""" return self.Prepend(*args, **kw) - def PrependSpacer(self, *args, **kw): - """Compatibility alias for `Prepend`.""" - return self.Prepend(*args, **kw) def InsertWindow(self, *args, **kw): """Compatibility alias for `Insert`.""" @@ -11150,9 +12645,6 @@ class Sizer(Object): def InsertSizer(self, *args, **kw): """Compatibility alias for `Insert`.""" return self.Insert(*args, **kw) - def InsertSpacer(self, *args, **kw): - """Compatibility alias for `Insert`.""" - return self.Insert(*args, **kw) def RemoveWindow(self, *args, **kw): """Compatibility alias for `Remove`.""" @@ -11369,8 +12861,12 @@ class Sizer(Object): """ return _core_.Sizer_ShowItems(*args, **kwargs) -Sizer_swigregister = _core_.Sizer_swigregister -Sizer_swigregister(Sizer) + Children = property(GetChildren,doc="See `GetChildren`") + ContainingWindow = property(GetContainingWindow,SetContainingWindow,doc="See `GetContainingWindow` and `SetContainingWindow`") + MinSize = property(GetMinSize,SetMinSize,doc="See `GetMinSize` and `SetMinSize`") + Position = property(GetPosition,doc="See `GetPosition`") + Size = property(GetSize,doc="See `GetSize`") +_core_.Sizer_swigregister(Sizer) class PySizer(Sizer): """ @@ -11424,14 +12920,13 @@ class PySizer(Sizer): class. """ _core_.PySizer_swiginit(self,_core_.new_PySizer(*args, **kwargs)) - self._setCallbackInfo(self, PySizer);self._setOORInfo(self) + self._setOORInfo(self);PySizer._setCallbackInfo(self, self, PySizer) def _setCallbackInfo(*args, **kwargs): """_setCallbackInfo(self, PyObject self, PyObject _class)""" return _core_.PySizer__setCallbackInfo(*args, **kwargs) -PySizer_swigregister = _core_.PySizer_swigregister -PySizer_swigregister(PySizer) +_core_.PySizer_swigregister(PySizer) #--------------------------------------------------------------------------- @@ -11472,8 +12967,12 @@ class BoxSizer(Sizer): """ return _core_.BoxSizer_SetOrientation(*args, **kwargs) -BoxSizer_swigregister = _core_.BoxSizer_swigregister -BoxSizer_swigregister(BoxSizer) + def IsVertical(*args, **kwargs): + """IsVertical(self) -> bool""" + return _core_.BoxSizer_IsVertical(*args, **kwargs) + + Orientation = property(GetOrientation,SetOrientation,doc="See `GetOrientation` and `SetOrientation`") +_core_.BoxSizer_swigregister(BoxSizer) #--------------------------------------------------------------------------- @@ -11505,8 +13004,8 @@ class StaticBoxSizer(BoxSizer): """ return _core_.StaticBoxSizer_GetStaticBox(*args, **kwargs) -StaticBoxSizer_swigregister = _core_.StaticBoxSizer_swigregister -StaticBoxSizer_swigregister(StaticBoxSizer) + StaticBox = property(GetStaticBox,doc="See `GetStaticBox`") +_core_.StaticBoxSizer_swigregister(StaticBoxSizer) #--------------------------------------------------------------------------- @@ -11624,8 +13123,11 @@ class GridSizer(Sizer): cols = (nitems + rows - 1) / rows return (rows, cols) -GridSizer_swigregister = _core_.GridSizer_swigregister -GridSizer_swigregister(GridSizer) + Cols = property(GetCols,SetCols,doc="See `GetCols` and `SetCols`") + HGap = property(GetHGap,SetHGap,doc="See `GetHGap` and `SetHGap`") + Rows = property(GetRows,SetRows,doc="See `GetRows` and `SetRows`") + VGap = property(GetVGap,SetVGap,doc="See `GetVGap` and `SetVGap`") +_core_.GridSizer_swigregister(GridSizer) #--------------------------------------------------------------------------- @@ -11757,8 +13259,6 @@ class FlexGridSizer(GridSizer): ========================== ================================================= Note that this method does not trigger relayout. - - """ return _core_.FlexGridSizer_SetNonFlexibleGrowMode(*args, **kwargs) @@ -11791,8 +13291,11 @@ class FlexGridSizer(GridSizer): """ return _core_.FlexGridSizer_GetColWidths(*args, **kwargs) -FlexGridSizer_swigregister = _core_.FlexGridSizer_swigregister -FlexGridSizer_swigregister(FlexGridSizer) + ColWidths = property(GetColWidths,doc="See `GetColWidths`") + FlexibleDirection = property(GetFlexibleDirection,SetFlexibleDirection,doc="See `GetFlexibleDirection` and `SetFlexibleDirection`") + NonFlexibleGrowMode = property(GetNonFlexibleGrowMode,SetNonFlexibleGrowMode,doc="See `GetNonFlexibleGrowMode` and `SetNonFlexibleGrowMode`") + RowHeights = property(GetRowHeights,doc="See `GetRowHeights`") +_core_.FlexGridSizer_swigregister(FlexGridSizer) class StdDialogButtonSizer(BoxSizer): """ @@ -11859,8 +13362,12 @@ class StdDialogButtonSizer(BoxSizer): """GetHelpButton(self) -> wxButton""" return _core_.StdDialogButtonSizer_GetHelpButton(*args, **kwargs) -StdDialogButtonSizer_swigregister = _core_.StdDialogButtonSizer_swigregister -StdDialogButtonSizer_swigregister(StdDialogButtonSizer) + AffirmativeButton = property(GetAffirmativeButton,SetAffirmativeButton,doc="See `GetAffirmativeButton` and `SetAffirmativeButton`") + ApplyButton = property(GetApplyButton,doc="See `GetApplyButton`") + CancelButton = property(GetCancelButton,SetCancelButton,doc="See `GetCancelButton` and `SetCancelButton`") + HelpButton = property(GetHelpButton,doc="See `GetHelpButton`") + NegativeButton = property(GetNegativeButton,SetNegativeButton,doc="See `GetNegativeButton` and `SetNegativeButton`") +_core_.StdDialogButtonSizer_swigregister(StdDialogButtonSizer) #--------------------------------------------------------------------------- @@ -11904,11 +13411,19 @@ class GBPosition(object): return _core_.GBPosition_SetCol(*args, **kwargs) def __eq__(*args, **kwargs): - """__eq__(self, GBPosition other) -> bool""" + """ + __eq__(self, PyObject other) -> bool + + Compare GBPosition for equality. + """ return _core_.GBPosition___eq__(*args, **kwargs) def __ne__(*args, **kwargs): - """__ne__(self, GBPosition other) -> bool""" + """ + __ne__(self, PyObject other) -> bool + + Compare GBPosition for inequality. + """ return _core_.GBPosition___ne__(*args, **kwargs) def Set(*args, **kwargs): @@ -11935,8 +13450,7 @@ class GBPosition(object): row = property(GetRow, SetRow) col = property(GetCol, SetCol) -GBPosition_swigregister = _core_.GBPosition_swigregister -GBPosition_swigregister(GBPosition) +_core_.GBPosition_swigregister(GBPosition) class GBSpan(object): """ @@ -11977,11 +13491,19 @@ class GBSpan(object): return _core_.GBSpan_SetColspan(*args, **kwargs) def __eq__(*args, **kwargs): - """__eq__(self, GBSpan other) -> bool""" + """ + __eq__(self, PyObject other) -> bool + + Compare wxGBSpan for equality. + """ return _core_.GBSpan___eq__(*args, **kwargs) def __ne__(*args, **kwargs): - """__ne__(self, GBSpan other) -> bool""" + """ + __ne__(self, PyObject other) -> bool + + Compare GBSpan for inequality. + """ return _core_.GBSpan___ne__(*args, **kwargs) def Set(*args, **kwargs): @@ -12008,8 +13530,7 @@ class GBSpan(object): rowspan = property(GetRowspan, SetRowspan) colspan = property(GetColspan, SetColspan) -GBSpan_swigregister = _core_.GBSpan_swigregister -GBSpan_swigregister(GBSpan) +_core_.GBSpan_swigregister(GBSpan) class GBSizerItem(SizerItem): """ @@ -12115,8 +13636,11 @@ class GBSizerItem(SizerItem): """ return _core_.GBSizerItem_SetGBSizer(*args, **kwargs) -GBSizerItem_swigregister = _core_.GBSizerItem_swigregister -GBSizerItem_swigregister(GBSizerItem) + EndPos = property(GetEndPos,doc="See `GetEndPos`") + GBSizer = property(GetGBSizer,SetGBSizer,doc="See `GetGBSizer` and `SetGBSizer`") + Pos = property(GetPos,SetPos,doc="See `GetPos` and `SetPos`") + Span = property(GetSpan,SetSpan,doc="See `GetSpan` and `SetSpan`") +_core_.GBSizerItem_swigregister(GBSizerItem) DefaultSpan = cvar.DefaultSpan def GBSizerItemWindow(*args, **kwargs): @@ -12273,6 +13797,16 @@ class GridBagSizer(FlexGridSizer): """ return _core_.GridBagSizer_FindItem(*args) + def GetItem(self, item): + gbsi = None + si = wx.FlexGridSizer.GetItem(self, item) + if not si: + return None + if type(item) is not int: + gbsi = self.FindItem(item) + if gbsi: return gbsi + return si + def FindItemAtPosition(*args, **kwargs): """ FindItemAtPosition(self, GBPosition pos) -> GBSizerItem @@ -12318,8 +13852,7 @@ class GridBagSizer(FlexGridSizer): """ return _core_.GridBagSizer_CheckForIntersectionPos(*args, **kwargs) -GridBagSizer_swigregister = _core_.GridBagSizer_swigregister -GridBagSizer_swigregister(GridBagSizer) +_core_.GridBagSizer_swigregister(GridBagSizer) #--------------------------------------------------------------------------- @@ -12528,8 +14061,15 @@ class IndividualLayoutConstraint(Object): """ return _core_.IndividualLayoutConstraint_GetEdge(*args, **kwargs) -IndividualLayoutConstraint_swigregister = _core_.IndividualLayoutConstraint_swigregister -IndividualLayoutConstraint_swigregister(IndividualLayoutConstraint) + Done = property(GetDone,SetDone,doc="See `GetDone` and `SetDone`") + Margin = property(GetMargin,SetMargin,doc="See `GetMargin` and `SetMargin`") + MyEdge = property(GetMyEdge,doc="See `GetMyEdge`") + OtherEdge = property(GetOtherEdge,doc="See `GetOtherEdge`") + OtherWindow = property(GetOtherWindow,doc="See `GetOtherWindow`") + Percent = property(GetPercent,doc="See `GetPercent`") + Relationship = property(GetRelationship,SetRelationship,doc="See `GetRelationship` and `SetRelationship`") + Value = property(GetValue,SetValue,doc="See `GetValue` and `SetValue`") +_core_.IndividualLayoutConstraint_swigregister(IndividualLayoutConstraint) class LayoutConstraints(Object): """ @@ -12586,8 +14126,7 @@ class LayoutConstraints(Object): """AreSatisfied(self) -> bool""" return _core_.LayoutConstraints_AreSatisfied(*args, **kwargs) -LayoutConstraints_swigregister = _core_.LayoutConstraints_swigregister -LayoutConstraints_swigregister(LayoutConstraints) +_core_.LayoutConstraints_swigregister(LayoutConstraints) #---------------------------------------------------------------------------- @@ -12621,6 +14160,24 @@ if RELEASE_VERSION != _core_.RELEASE_VERSION: import warnings warnings.warn("wxPython/wxWidgets release number mismatch") + +def version(): + """Returns a string containing version and port info""" + ctype = wx.USE_UNICODE and 'unicode' or 'ansi' + if wx.Platform == '__WXMSW__': + port = 'msw' + elif wx.Platform == '__WXMAC__': + port = 'mac' + elif wx.Platform == '__WXGTK__': + port = 'gtk' + if 'gtk2' in wx.PlatformInfo: + port = 'gtk2' + else: + port = '?' + + return "%s (%s-%s)" % (wx.VERSION_STRING, port, ctype) + + #---------------------------------------------------------------------------- # Set wxPython's default string<-->unicode conversion encoding from @@ -12640,7 +14197,10 @@ if default == 'ascii': import locale import codecs try: - default = locale.getdefaultlocale()[1] + if hasattr(locale, 'getpreferredencoding'): + default = locale.getpreferredencoding() + else: + default = locale.getdefaultlocale()[1] codecs.lookup(default) except (ValueError, LookupError, TypeError): default = _sys.getdefaultencoding() @@ -12718,7 +14278,7 @@ def CallAfter(callable, *args, **kw): method calls from non-GUI threads. Any extra positional or keyword args are passed on to the callable when it is called. - :see: `wx.FutureCall` + :see: `wx.CallLater` """ app = wx.GetApp() assert app is not None, 'No wx.App created yet' @@ -12737,7 +14297,7 @@ def CallAfter(callable, *args, **kw): #---------------------------------------------------------------------------- -class FutureCall: +class CallLater: """ A convenience class for `wx.Timer`, that calls the given callable object once after the given amount of milliseconds, passing any @@ -12748,7 +14308,7 @@ class FutureCall: then there is no need to hold a reference to this object. It will hold a reference to itself while the timer is running (the timer has a reference to self.Notify) but the cycle will be broken when - the timer completes, automatically cleaning up the wx.FutureCall + the timer completes, automatically cleaning up the wx.CallLater object. :see: `wx.CallAfter` @@ -12834,7 +14394,12 @@ class FutureCall: # if it wasn't restarted, then cleanup wx.CallAfter(self.Stop) + Interval = property(GetInterval) + Result = property(GetResult) + +class FutureCall(CallLater): + """A compatibility alias for `CallLater`.""" #---------------------------------------------------------------------------- # Control which items in this module should be documented by epydoc. @@ -12847,7 +14412,7 @@ class FutureCall: class __DocFilter: """ A filter for epydoc that only allows non-Ptr classes and - fucntions, in order to reduce the clutter in the API docs. + functions, in order to reduce the clutter in the API docs. """ def __init__(self, globals): self._globals = globals @@ -12855,10 +14420,22 @@ class __DocFilter: def __call__(self, name): import types obj = self._globals.get(name, None) + + # only document classes and function if type(obj) not in [type, types.ClassType, types.FunctionType, types.BuiltinFunctionType]: return False + + # skip other things that are private or will be documented as part of somethign else if name.startswith('_') or name.startswith('EVT') or name.endswith('_swigregister') or name.endswith('Ptr') : return False + + # skip functions that are duplicates of static functions in a class + if name.find('_') != -1: + cls = self._globals.get(name.split('_')[0], None) + methname = name.split('_')[1] + if hasattr(cls, methname) and type(getattr(cls, methname)) is types.FunctionType: + return False + return True #---------------------------------------------------------------------------- @@ -12871,11 +14448,6 @@ from _windows import * from _controls import * from _misc import * - -# Fixup the stock objects since they can't be used yet. (They will be -# restored in wx.PyApp.OnInit.) -_core_._wxPyFixStockObjects() - #---------------------------------------------------------------------------- #----------------------------------------------------------------------------