ID_ABORT = _core_.ID_ABORT
ID_RETRY = _core_.ID_RETRY
ID_IGNORE = _core_.ID_IGNORE
+ID_ADD = _core_.ID_ADD
+ID_REMOVE = _core_.ID_REMOVE
+ID_UP = _core_.ID_UP
+ID_DOWN = _core_.ID_DOWN
+ID_HOME = _core_.ID_HOME
+ID_REFRESH = _core_.ID_REFRESH
+ID_STOP = _core_.ID_STOP
+ID_INDEX = _core_.ID_INDEX
+ID_BOLD = _core_.ID_BOLD
+ID_ITALIC = _core_.ID_ITALIC
+ID_JUSTIFY_CENTER = _core_.ID_JUSTIFY_CENTER
+ID_JUSTIFY_FILL = _core_.ID_JUSTIFY_FILL
+ID_JUSTIFY_RIGHT = _core_.ID_JUSTIFY_RIGHT
+ID_JUSTIFY_LEFT = _core_.ID_JUSTIFY_LEFT
+ID_UNDERLINE = _core_.ID_UNDERLINE
+ID_INDENT = _core_.ID_INDENT
+ID_UNINDENT = _core_.ID_UNINDENT
+ID_ZOOM_100 = _core_.ID_ZOOM_100
+ID_ZOOM_FIT = _core_.ID_ZOOM_FIT
+ID_ZOOM_IN = _core_.ID_ZOOM_IN
+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
BORDER_SUNKEN = _core_.BORDER_SUNKEN
BORDER_DOUBLE = _core_.BORDER_DOUBLE
BORDER_MASK = _core_.BORDER_MASK
+BG_STYLE_SYSTEM = _core_.BG_STYLE_SYSTEM
+BG_STYLE_COLOUR = _core_.BG_STYLE_COLOUR
+BG_STYLE_CUSTOM = _core_.BG_STYLE_CUSTOM
DEFAULT = _core_.DEFAULT
DECORATIVE = _core_.DECORATIVE
ROMAN = _core_.ROMAN
Inflate(self, int dx, int dy) -> Rect
Increase the rectangle size by dx in x direction and dy in y
- direction. Both or one of) parameters may be negative to decrease the
+ direction. Both (or one of) parameters may be negative to decrease the
rectangle size.
"""
return _core_.Rect_Inflate(*args, **kwargs)
Deflate(self, int dx, int dy) -> Rect
Decrease the rectangle size by dx in x direction and dy in y
- direction. Both or one of) parameters may be negative to increase the
+ direction. Both (or one of) parameters may be negative to increase the
rectngle size. This method is the opposite of Inflate.
"""
return _core_.Rect_Deflate(*args, **kwargs)
"""
Intersect(self, Rect rect) -> Rect
- Return the intersectsion of this rectangle and rect.
+ Returns the intersectsion of this rectangle and rect.
"""
return _core_.Rect_Intersect(*args, **kwargs)
+ def Union(*args, **kwargs):
+ """
+ Union(self, Rect rect) -> Rect
+
+ Returns the union of this rectangle and rect.
+ """
+ return _core_.Rect_Union(*args, **kwargs)
+
def __add__(*args, **kwargs):
"""
__add__(self, Rect rect) -> Rect
val.thisown = 1
return val
+def RectS(*args, **kwargs):
+ """
+ RectS(Size size) -> Rect
+
+ Create a new Rect from a size only.
+ """
+ val = _core_.new_RectS(*args, **kwargs)
+ val.thisown = 1
+ return val
+
def IntersectRect(*args, **kwargs):
"""
self.this = newobj.this
self.thisown = 1
del newobj.thisown
+ def __del__(self, destroy=_core_.delete_InputStream):
+ """__del__(self)"""
+ try:
+ if self.thisown: destroy(self)
+ except: pass
+
def close(*args, **kwargs):
"""close(self)"""
return _core_.InputStream_close(*args, **kwargs)
self.this = newobj.this
self.thisown = 1
del newobj.thisown
+ self.thisown = 0 # It will normally be deleted by the user of the wxFileSystem
+
def __del__(self, destroy=_core_.delete_FSFile):
"""__del__(self)"""
try:
return _core_.FileSystem_FileNameToURL(*args, **kwargs)
FileNameToURL = staticmethod(FileNameToURL)
+ def URLToFileName(*args, **kwargs):
+ """URLToFileName(String url) -> String"""
+ return _core_.FileSystem_URLToFileName(*args, **kwargs)
+
+ URLToFileName = staticmethod(URLToFileName)
class FileSystemPtr(FileSystem):
def __init__(self, this):
"""FileSystem_FileNameToURL(String filename) -> String"""
return _core_.FileSystem_FileNameToURL(*args, **kwargs)
-
def FileSystem_URLToFileName(*args, **kwargs):
"""FileSystem_URLToFileName(String url) -> String"""
return _core_.FileSystem_URLToFileName(*args, **kwargs)
+
class InternetFSHandler(CPPFileSystemHandler):
def __repr__(self):
return "<%s.%s; proxy of C++ wxInternetFSHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
def __wxMemoryFSHandler_AddFile_Data(*args, **kwargs):
"""__wxMemoryFSHandler_AddFile_Data(String filename, PyObject data)"""
return _core_.__wxMemoryFSHandler_AddFile_Data(*args, **kwargs)
-def MemoryFSHandler_AddFile(filename, a, b=''):
- if isinstance(a, wx.Image):
- __wxMemoryFSHandler_AddFile_wxImage(filename, a, b)
- elif isinstance(a, wx.Bitmap):
- __wxMemoryFSHandler_AddFile_wxBitmap(filename, a, b)
- elif type(a) == str:
- __wxMemoryFSHandler_AddFile_Data(filename, a)
- else: raise TypeError, 'wx.Image, wx.Bitmap or string expected'
+def MemoryFSHandler_AddFile(filename, dataItem, imgType=-1):
+ """
+ Add 'file' to the memory filesystem. The dataItem parameter can
+ either be a `wx.Bitmap`, `wx.Image` or a string that can contain
+ arbitrary data. If a bitmap or image is used then the imgType
+ parameter should specify what kind of image file it should be
+ written as, wx.BITMAP_TYPE_PNG, etc.
+ """
+ if isinstance(dataItem, wx.Image):
+ __wxMemoryFSHandler_AddFile_wxImage(filename, dataItem, imgType)
+ elif isinstance(dataItem, wx.Bitmap):
+ __wxMemoryFSHandler_AddFile_wxBitmap(filename, dataItem, imgType)
+ elif type(dataItem) == str:
+ __wxMemoryFSHandler_AddFile_Data(filename, dataItem)
+ else:
+ raise TypeError, 'wx.Image, wx.Bitmap or string expected'
class MemoryFSHandler(CPPFileSystemHandler):
def __repr__(self):
"""
return _core_.Image_FindFirstUnusedColour(*args, **kwargs)
+ def ConvertAlphaToMask(*args, **kwargs):
+ """
+ ConvertAlphaToMask(self, byte threshold=128) -> bool
+
+ If the image has alpha channel, this method converts it to mask. All pixels
+ with alpha value less than ``threshold`` are replaced with mask colour and the
+ alpha channel is removed. Mask colour is chosen automatically using
+ `FindFirstUnusedColour`.
+
+ If the image image doesn't have alpha channel, ConvertAlphaToMask does
+ nothing.
+ """
+ return _core_.Image_ConvertAlphaToMask(*args, **kwargs)
+
+ def ConvertColourToAlpha(*args, **kwargs):
+ """
+ ConvertColourToAlpha(self, unsigned char r, unsigned char g, unsigned char b) -> bool
+
+ This method converts an image where the original alpha information is
+ only available as a shades of a colour (actually shades of grey)
+ typically when you draw anti-aliased text into a bitmap. The DC
+ drawing routines draw grey values on the black background although
+ they actually mean to draw white with differnt alpha values. This
+ method reverses it, assuming a black (!) background and white text.
+ The method will then fill up the whole image with the colour given.
+ """
+ return _core_.Image_ConvertColourToAlpha(*args, **kwargs)
+
def SetMaskFromImage(*args, **kwargs):
"""SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool"""
return _core_.Image_SetMaskFromImage(*args, **kwargs)
GetImageExtWildcard = staticmethod(GetImageExtWildcard)
def ConvertToBitmap(*args, **kwargs):
- """ConvertToBitmap(self) -> Bitmap"""
+ """ConvertToBitmap(self, int depth=-1) -> Bitmap"""
return _core_.Image_ConvertToBitmap(*args, **kwargs)
def ConvertToMonoBitmap(*args, **kwargs):
val.thisown = 1
return val
+def ImageFromDataWithAlpha(*args, **kwargs):
+ """ImageFromDataWithAlpha(int width, int height, unsigned char data, unsigned char alpha) -> Image"""
+ val = _core_.new_ImageFromDataWithAlpha(*args, **kwargs)
+ val.thisown = 1
+ return val
+
def Image_CanRead(*args, **kwargs):
"""Image_CanRead(String name) -> bool"""
return _core_.Image_CanRead(*args, **kwargs)
"""
return _core_.PyApp_WakeUpIdle(*args, **kwargs)
+ def IsMainLoopRunning(*args, **kwargs):
+ """
+ IsMainLoopRunning() -> bool
+
+ Returns True if we're running the main loop, i.e. if the events can
+ currently be dispatched.
+ """
+ return _core_.PyApp_IsMainLoopRunning(*args, **kwargs)
+
+ IsMainLoopRunning = staticmethod(IsMainLoopRunning)
def MainLoop(*args, **kwargs):
"""
MainLoop(self) -> int
self.__class__ = PyApp
_core_.PyApp_swigregister(PyAppPtr)
+def PyApp_IsMainLoopRunning(*args, **kwargs):
+ """
+ PyApp_IsMainLoopRunning() -> bool
+
+ Returns True if we're running the main loop, i.e. if the events can
+ currently be dispatched.
+ """
+ return _core_.PyApp_IsMainLoopRunning(*args, **kwargs)
+
def PyApp_GetMacSupportPCMenuShortcuts(*args, **kwargs):
"""PyApp_GetMacSupportPCMenuShortcuts() -> bool"""
return _core_.PyApp_GetMacSupportPCMenuShortcuts(*args, **kwargs)
Return a reference to the current wx.App object.
"""
return _core_.GetApp(*args, **kwargs)
+
+def SetDefaultPyEncoding(*args, **kwargs):
+ """
+ SetDefaultPyEncoding(string encoding)
+
+ Sets the encoding that wxPython will use when it needs to convert a
+ Python string or unicode object to or from a wxString.
+ """
+ return _core_.SetDefaultPyEncoding(*args, **kwargs)
+
+def GetDefaultPyEncoding(*args, **kwargs):
+ """
+ GetDefaultPyEncoding() -> string
+
+ Gets the current encoding that wxPython will use when it needs to
+ convert a Python string or unicode object to or from a wxString.
+ """
+ return _core_.GetDefaultPyEncoding(*args, **kwargs)
#----------------------------------------------------------------------
class PyOnDemandOutputWindow:
if redirect:
self.RedirectStdio(filename)
+ # Use Python's install prefix as the default
+ wx.StandardPaths.Get().SetInstallPrefix(_sys.prefix)
+
# This finishes the initialization of wxWindows and then calls
# the OnInit that should be present in the derived class
self._BootstrapApp()
#---------------------------------------------------------------------------
+class EventLoop(object):
+ def __repr__(self):
+ return "<%s.%s; proxy of C++ wxEventLoop instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
+ def __init__(self, *args, **kwargs):
+ """__init__(self) -> EventLoop"""
+ newobj = _core_.new_EventLoop(*args, **kwargs)
+ self.this = newobj.this
+ self.thisown = 1
+ del newobj.thisown
+ def __del__(self, destroy=_core_.delete_EventLoop):
+ """__del__(self)"""
+ try:
+ if self.thisown: destroy(self)
+ except: pass
+
+ def Run(*args, **kwargs):
+ """Run(self) -> int"""
+ return _core_.EventLoop_Run(*args, **kwargs)
+
+ def Exit(*args, **kwargs):
+ """Exit(self, int rc=0)"""
+ return _core_.EventLoop_Exit(*args, **kwargs)
+
+ def Pending(*args, **kwargs):
+ """Pending(self) -> bool"""
+ return _core_.EventLoop_Pending(*args, **kwargs)
+
+ def Dispatch(*args, **kwargs):
+ """Dispatch(self) -> bool"""
+ return _core_.EventLoop_Dispatch(*args, **kwargs)
+
+ def IsRunning(*args, **kwargs):
+ """IsRunning(self) -> bool"""
+ return _core_.EventLoop_IsRunning(*args, **kwargs)
+
+ def GetActive(*args, **kwargs):
+ """GetActive() -> EventLoop"""
+ return _core_.EventLoop_GetActive(*args, **kwargs)
+
+ GetActive = staticmethod(GetActive)
+ def SetActive(*args, **kwargs):
+ """SetActive(EventLoop loop)"""
+ return _core_.EventLoop_SetActive(*args, **kwargs)
+
+ SetActive = staticmethod(SetActive)
+
+class EventLoopPtr(EventLoop):
+ def __init__(self, this):
+ self.this = this
+ if not hasattr(self,"thisown"): self.thisown = 0
+ self.__class__ = EventLoop
+_core_.EventLoop_swigregister(EventLoopPtr)
+
+def EventLoop_GetActive(*args, **kwargs):
+ """EventLoop_GetActive() -> EventLoop"""
+ return _core_.EventLoop_GetActive(*args, **kwargs)
+
+def EventLoop_SetActive(*args, **kwargs):
+ """EventLoop_SetActive(EventLoop loop)"""
+ return _core_.EventLoop_SetActive(*args, **kwargs)
+
+#---------------------------------------------------------------------------
+
class AcceleratorEntry(object):
"""
A class used to define items in an `wx.AcceleratorTable`. wxPython
"""
return _core_.Window_GetForegroundColour(*args, **kwargs)
+ def SetBackgroundStyle(*args, **kwargs):
+ """
+ SetBackgroundStyle(self, int style) -> bool
+
+ Returns the background style of the window. The background style
+ indicates how the background of the window is drawn.
+
+ ====================== ========================================
+ wx.BG_STYLE_SYSTEM The background colour or pattern should
+ be determined by the system
+ wx.BG_STYLE_COLOUR The background should be a solid colour
+ wx.BG_STYLE_CUSTOM The background will be implemented by the
+ application.
+ ====================== ========================================
+
+ On GTK+, use of wx.BG_STYLE_CUSTOM allows the flicker-free drawing of
+ a custom background, such as a tiled bitmap. Currently the style has
+ no effect on other platforms.
+
+ :see: `GetBackgroundStyle`, `SetBackgroundColour`
+ """
+ return _core_.Window_SetBackgroundStyle(*args, **kwargs)
+
+ def GetBackgroundStyle(*args, **kwargs):
+ """
+ GetBackgroundStyle(self) -> int
+
+ Returns the background style of the window.
+
+ :see: `SetBackgroundStyle`
+ """
+ return _core_.Window_GetBackgroundStyle(*args, **kwargs)
+
def SetCursor(*args, **kwargs):
"""
SetCursor(self, Cursor cursor) -> bool
"""
return _core_.Window_GetHandle(*args, **kwargs)
+ def AssociateHandle(*args, **kwargs):
+ """
+ AssociateHandle(self, long handle)
+
+ Associate the window with a new native handle
+ """
+ return _core_.Window_AssociateHandle(*args, **kwargs)
+
+ def DissociateHandle(*args, **kwargs):
+ """
+ DissociateHandle(self)
+
+ Dissociate the current native handle from the window
+ """
+ return _core_.Window_DissociateHandle(*args, **kwargs)
+
def OnPaint(*args, **kwargs):
"""OnPaint(self, PaintEvent event)"""
return _core_.Window_OnPaint(*args, **kwargs)
layout sizer object is already owned by the window, it will be deleted
if the deleteOld parameter is true. Note that this function will also
call SetAutoLayout implicitly with a True parameter if the sizer is
- non-NoneL and False otherwise.
+ non-None, and False otherwise.
"""
return _core_.Window_SetSizer(*args, **kwargs)
ShouldInheritColours to return false, the colours will not be changed
no matter what and only the font might.
- This rather complicated logic is necessary in order to accomodate the
- different usage scenarius. The most common one is when all default
+ This rather complicated logic is necessary in order to accommodate the
+ different usage scenarios. The most common one is when all default
attributes are used and in this case, nothing should be inherited as
in modern GUIs different controls use different fonts (and colours)
than their siblings so they can't inherit the same value from the
"""
return _core_.SizerItem_GetRatio(*args, **kwargs)
+ def GetRect(*args, **kwargs):
+ """
+ GetRect(self) -> Rect
+
+ Returns the rectangle that the sizer item should occupy
+ """
+ return _core_.SizerItem_GetRect(*args, **kwargs)
+
def IsWindow(*args, **kwargs):
"""
IsWindow(self) -> bool
def Add(*args, **kwargs):
"""
Add(self, item, int proportion=0, int flag=0, int border=0,
- PyObject userData=None)
+ PyObject userData=None) -> wx.SizerItem
Appends a child item to the sizer.
"""
def Insert(*args, **kwargs):
"""
Insert(self, int before, item, int proportion=0, int flag=0, int border=0,
- PyObject userData=None)
+ PyObject userData=None) -> wx.SizerItem
Inserts a new item into the list of items managed by this sizer before
the item at index *before*. See `Add` for a description of the parameters.
def Prepend(*args, **kwargs):
"""
Prepend(self, item, int proportion=0, int flag=0, int border=0,
- PyObject userData=None)
+ PyObject userData=None) -> wx.SizerItem
Adds a new item to the begining of the list of sizer items managed by
this sizer. See `Add` for a description of the parameters.
"""
return _core_.Sizer_Detach(*args, **kwargs)
+ def GetItem(*args, **kwargs):
+ """
+ GetItem(self, item) -> 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
+ the item to be detached.
+ """
+ return _core_.Sizer_GetItem(*args, **kwargs)
+
def _SetItemMinSize(*args, **kwargs):
"""_SetItemMinSize(self, PyObject item, Size size)"""
return _core_.Sizer__SetItemMinSize(*args, **kwargs)
def Show(*args, **kwargs):
"""
- Show(self, item, bool show=True)
+ Show(self, item, bool show=True, bool recursive=false) -> bool
Shows or hides an item managed by the sizer. To make a sizer item
disappear or reappear, use Show followed by `Layout`. The *item*
parameter can be either a window, a sizer, or the zero-based index of
- the item.
+ the item. Use the recursive parameter to show or hide an item in a
+ subsizer. Returns True if the item was found.
"""
return _core_.Sizer_Show(*args, **kwargs)
"""
return _core_.Sizer_IsShown(*args, **kwargs)
- def Hide(self, item):
+ def Hide(self, item, recursive=False):
"""
- A convenience method for Show(item, False).
+ A convenience method for Show(item, False, recursive).
"""
- self.Show(item, False)
+ return self.Show(item, False, recursive)
def ShowItems(*args, **kwargs):
"""
ShowItems(self, bool show)
- Recursively call `wx.Window.Show` on all sizer items.
+ Recursively call `wx.SizerItem.Show` on all sizer items.
"""
return _core_.Sizer_ShowItems(*args, **kwargs)
self.this = newobj.this
self.thisown = 1
del newobj.thisown
+ self._setOORInfo(self)
+
def Add(*args, **kwargs):
"""
Add(self, item, GBPosition pos, GBSpan span=DefaultSpan, int flag=0,
- int border=0, userData=None)
+ int border=0, userData=None) -> wx.GBSizerItem
Adds an item to the sizer at the grid cell *pos*, optionally spanning
more than one row or column as specified with *span*. The remaining
def AddItem(*args, **kwargs):
"""
- Add(self, GBSizerItem item) -> bool
+ Add(self, GBSizerItem item) -> wx.GBSizerItem
Add an item to the sizer using a `wx.GBSizerItem`. Returns True if
the item was successfully placed at its given cell position, False if
"""
return _core_.GridBagSizer_AddItem(*args, **kwargs)
+ def GetCellSize(*args, **kwargs):
+ """
+ GetCellSize(self, int row, int col) -> Size
+
+ Get the size of the specified cell, including hgap and
+ vgap. Only valid after a Layout.
+ """
+ return _core_.GridBagSizer_GetCellSize(*args, **kwargs)
+
def GetEmptyCellSize(*args, **kwargs):
"""
GetEmptyCellSize(self) -> Size
#----------------------------------------------------------------------------
# Load version numbers from __version__... Ensure that major and minor
-# versions are the same for both wxPython and wxWindows.
+# versions are the same for both wxPython and wxWidgets.
from __version__ import *
__version__ = VERSION_STRING
-assert MAJOR_VERSION == _core_.MAJOR_VERSION, "wxPython/wxWindows version mismatch"
-assert MINOR_VERSION == _core_.MINOR_VERSION, "wxPython/wxWindows version mismatch"
+assert MAJOR_VERSION == _core_.MAJOR_VERSION, "wxPython/wxWidgets version mismatch"
+assert MINOR_VERSION == _core_.MINOR_VERSION, "wxPython/wxWidgets version mismatch"
if RELEASE_VERSION != _core_.RELEASE_VERSION:
import warnings
- warnings.warn("wxPython/wxWindows release number mismatch")
+ warnings.warn("wxPython/wxWidgets release number mismatch")
+
+#----------------------------------------------------------------------------
+
+# Set the default string conversion encoding from the locale
+import locale
+default = locale.getdefaultlocale()[1]
+if default:
+ wx.SetDefaultPyEncoding(default)
+del default
+del locale
#----------------------------------------------------------------------------
#----------------------------------------------------------------------------
-_wxPyCallAfterId = None
def CallAfter(callable, *args, **kw):
"""
app = wx.GetApp()
assert app is not None, 'No wx.App created yet'
- global _wxPyCallAfterId
- if _wxPyCallAfterId is None:
- _wxPyCallAfterId = wx.NewEventType()
- app.Connect(-1, -1, _wxPyCallAfterId,
- lambda event: event.callable(*event.args, **event.kw) )
+ if not hasattr(app, "_CallAfterId"):
+ app._CallAfterId = wx.NewEventType()
+ app.Connect(-1, -1, app._CallAfterId,
+ lambda event: event.callable(*event.args, **event.kw) )
evt = wx.PyEvent()
- evt.SetEventType(_wxPyCallAfterId)
+ evt.SetEventType(app._CallAfterId)
evt.callable = callable
evt.args = args
evt.kw = kw
wx.PostEvent(app, evt)
-
#----------------------------------------------------------------------------
class FutureCall:
"""
- A convenience class for wx.Timer, that calls the given callable
+ A convenience class for `wx.Timer`, that calls the given callable
object once after the given amount of milliseconds, passing any
positional or keyword args. The return value of the callable is
availbale after it has been run with the `GetResult` method.
projects / wxWidgets.git / blobdiff