Sneed-Group/Poodletooth-iLand
1
0
Fork 0
mirror of https://github.com/Sneed-Group/Poodletooth-iLand synced 2024-12-27 05:32:41 -06:00
Code Issues Projects Releases Packages Wiki Activity Actions
Poodletooth-iLand/panda/python/Lib/site-packages/wx/core.pi
Master Jumblespeed d882959bfa switch to remote
2015-05-18 22:11:33 -04:00

45520 lines
1.1 MiB
Executable file
Raw Blame History

# -*- coding: utf-8 -*-
#---------------------------------------------------------------------------
# This file is generated by wxPython's PI generator. Do not edit by hand.
#
# (The *.pi files are used by WingIDE to provide more information than it is
# able to glean from introspection of extension types and methods.)
#
# Copyright: (c) 2013 by Total Control Software
# License: wxWindows License
#---------------------------------------------------------------------------
#-- begin-_core --#
#-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
# This code block was included from src/core_ex.py
import sys as _sys
# Load version numbers from __version__... Ensure that major and minor
# versions are the same for both wxPython and wxWidgets.
if 'wxEVT_NULL' in dir():
from wx.__version__ import *
import wx._core
__version__ = VERSION_STRING
assert MAJOR_VERSION == wx._core.MAJOR_VERSION, "wxPython/wxWidgets version mismatch"
assert MINOR_VERSION == wx._core.MINOR_VERSION, "wxPython/wxWidgets version mismatch"
if RELEASE_NUMBER != wx._core.RELEASE_NUMBER:
import warnings
warnings.warn("wxPython/wxWidgets release number mismatch")
# Register a function to be called when Python terminates that will clean
# up and release all system resources that wxWidgets allocated.
import atexit
atexit.register(wx._core._wxPyCleanup)
del atexit
else:
Port = ''
Platform = ''
PlatformInfo = []
# A little trick to make 'wx' be a reference to this module so wx.Names can
# be used in the python code here.
wx = _sys.modules[__name__]
import warnings
class wxPyDeprecationWarning(DeprecationWarning):
pass
warnings.simplefilter('default', wxPyDeprecationWarning)
del warnings
def deprecated(item, msg='', useName=False):
"""
Create a delegating wrapper that raises a deprecation warning. Can be
used with callable objects (functions, methods, classes) or with
properties.
"""
import warnings
name = ''
if useName:
try:
name = ' ' + item.__name__
except AttributeError:
pass
if isinstance(item, type):
# It is a class. Make a subclass that raises a warning.
class DeprecatedClassProxy(item):
def __init__(*args, **kw):
warnings.warn("Using deprecated class%s. %s" % (name, msg),
wxPyDeprecationWarning, stacklevel=2)
item.__init__(*args, **kw)
DeprecatedClassProxy.__name__ = item.__name__
return DeprecatedClassProxy
elif callable(item):
# wrap a new function around the callable
def deprecated_func(*args, **kw):
warnings.warn("Call to deprecated item%s. %s" % (name, msg),
wxPyDeprecationWarning, stacklevel=2)
if not kw:
return item(*args)
return item(*args, **kw)
deprecated_func.__name__ = item.__name__
deprecated_func.__doc__ = item.__doc__
if hasattr(item, '__dict__'):
deprecated_func.__dict__.update(item.__dict__)
return deprecated_func
elif hasattr(item, '__get__'):
# it should be a property if there is a getter
class DepGetProp(object):
def __init__(self,item, msg):
self.item = item
self.msg = msg
def __get__(self, inst, klass):
warnings.warn("Accessing deprecated property. %s" % msg,
wxPyDeprecationWarning, stacklevel=2)
return self.item.__get__(inst, klass)
class DepGetSetProp(DepGetProp):
def __set__(self, inst, val):
warnings.warn("Accessing deprecated property. %s" % msg,
wxPyDeprecationWarning, stacklevel=2)
return self.item.__set__(inst, val)
class DepGetSetDelProp(DepGetSetProp):
def __delete__(self, inst):
warnings.warn("Accessing deprecated property. %s" % msg,
wxPyDeprecationWarning, stacklevel=2)
return self.item.__delete__(inst)
if hasattr(item, '__set__') and hasattr(item, '__delete__'):
return DepGetSetDelProp(item, msg)
elif hasattr(item, '__set__'):
return DepGetSetProp(item, msg)
else:
return DepGetProp(item, msg)
else:
raise TypeError("unsupported type %s" % type(item))
def deprecatedMsg(msg):
"""
A wrapper for the deprecated decorator that makes it easier to attach a
custom message to the warning that is raised if the item is used. This
can also be used in the @decorator role since it returns the real
decorator when called.
"""
import functools
return functools.partial(deprecated, msg=msg, useName=True)
#----------------------------------------------------------------------------
EmptyString = ""
#----------------------------------------------------------------------------
# End of included code block
#-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
def version():
"""
Returns a string containing version and port info
"""
pass
def CallAfter(callableObj, *args, **kw):
"""
Call the specified function after the current and pending event
handlers have been completed. This is also good for making GUI
method calls from non-GUI threads. Any extra positional or
keyword args are passed on to the callable when it is called.
:param PyObject callableObj: the callable object
:param args: arguments to be passed to the callable object
:param kw: keywords to be passed to the callable object
.. seealso::
:class:`CallLater`
"""
pass
class CallLater(object):
"""
A convenience class for :class:`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 :meth:`~CallLater.GetResult` method.
If you don't need to get the return value or restart the timer
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 :meth:`~CallLater.Notify`) but the cycle will be broken when
the timer completes, automatically cleaning up the :class:`CallLater`
object.
.. seealso::
:func:`CallAfter`
"""
def __init__(self, millis, callableObj, *args, **kwargs):
"""
A convenience class for :class:`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 :meth:`~CallLater.GetResult` method.
:param int millis: number of milli seconds
:param PyObject callableObj: the callable object
:param args: arguments to be passed to the callable object
:param kw: keywords to be passed to the callable object
"""
pass
def __del__(self):
pass
def Start(self, millis=None, *args, **kwargs):
"""
(Re)start the timer
:param int millis: number of milli seconds
:param args: arguments to be passed to the callable object
:param kw: keywords to be passed to the callable object
"""
pass
Restart = Start
def Stop(self):
"""
Stop and destroy the timer.
"""
pass
def GetInterval(self):
pass
def IsRunning(self):
pass
def SetArgs(self, *args, **kwargs):
"""
(Re)set the args passed to the callable object. This is
useful in conjunction with :meth:`Restart` if you want to schedule a
new call to the same callable object but with different
parameters.
:param args: arguments to be passed to the callable object
:param kw: keywords to be passed to the callable object
"""
pass
def HasRun(self):
"""
Returns whether or not the callable has run.
:rtype: bool
"""
pass
def GetResult(self):
"""
Returns the value of the callable.
:rtype: a Python object
:return: result from callable
"""
pass
def Notify(self):
"""
The timer has expired so call the callable.
"""
pass
Interval = property(None, None)
Result = property(None, None)
FutureCall = deprecated(CallLater, 'Use CallLater instead.')
def GetDefaultPyEncoding():
return "utf-8"
GetDefaultPyEncoding = deprecated(GetDefaultPyEncoding, msg="wxPython now always uses utf-8")
def IsMainThread(self):
"""
IsMainThread() -> bool
Returns ``True`` if the current thread is what wx considers the GUI
thread.
"""
#-- end-_core --#
#-- begin-defs --#
INT8_MIN = 0
INT8_MAX = 0
UINT8_MAX = 0
INT16_MIN = 0
INT16_MAX = 0
UINT16_MAX = 0
INT32_MIN = 0
INT32_MAX = 0
UINT32_MAX = 0
INT64_MIN = 0
INT64_MAX = 0
UINT64_MAX = 0
SIZE_AUTO_WIDTH = 0
SIZE_AUTO_HEIGHT = 0
SIZE_AUTO = 0
SIZE_USE_EXISTING = 0
SIZE_ALLOW_MINUS_ONE = 0
SIZE_NO_ADJUSTMENTS = 0
SIZE_FORCE = 0
SIZE_FORCE_EVENT = 0
VSCROLL = 0
HSCROLL = 0
CAPTION = 0
DOUBLE_BORDER = 0
SUNKEN_BORDER = 0
RAISED_BORDER = 0
BORDER = 0
SIMPLE_BORDER = 0
STATIC_BORDER = 0
NO_BORDER = 0
ALWAYS_SHOW_SB = 0
CLIP_CHILDREN = 0
CLIP_SIBLINGS = 0
TRANSPARENT_WINDOW = 0
TAB_TRAVERSAL = 0
WANTS_CHARS = 0
RETAINED = 0
BACKINGSTORE = 0
POPUP_WINDOW = 0
FULL_REPAINT_ON_RESIZE = 0
NO_FULL_REPAINT_ON_RESIZE = 0
WINDOW_STYLE_MASK = 0
WS_EX_VALIDATE_RECURSIVELY = 0
WS_EX_BLOCK_EVENTS = 0
WS_EX_TRANSIENT = 0
WS_EX_THEMED_BACKGROUND = 0
WS_EX_PROCESS_IDLE = 0
WS_EX_PROCESS_UI_UPDATES = 0
FRAME_EX_METAL = 0
DIALOG_EX_METAL = 0
WS_EX_CONTEXTHELP = 0
FRAME_EX_CONTEXTHELP = 0
DIALOG_EX_CONTEXTHELP = 0
FRAME_DRAWER = 0
FRAME_NO_WINDOW_MENU = 0
MB_DOCKABLE = 0
MENU_TEAROFF = 0
COLOURED = 0
FIXED_LENGTH = 0
LB_SORT = 0
LB_SINGLE = 0
LB_MULTIPLE = 0
LB_EXTENDED = 0
LB_NEEDED_SB = 0
LB_OWNERDRAW = 0
LB_ALWAYS_SB = 0
LB_NO_SB = 0
LB_HSCROLL = 0
LB_INT_HEIGHT = 0
CB_SIMPLE = 0
CB_SORT = 0
CB_READONLY = 0
CB_DROPDOWN = 0
RA_LEFTTORIGHT = 0
RA_TOPTOBOTTOM = 0
RA_SPECIFY_COLS = 0
RA_SPECIFY_ROWS = 0
RA_HORIZONTAL = 0
RA_VERTICAL = 0
RB_GROUP = 0
RB_SINGLE = 0
SB_HORIZONTAL = 0
SB_VERTICAL = 0
SP_HORIZONTAL = 0
SP_VERTICAL = 0
SP_ARROW_KEYS = 0
SP_WRAP = 0
TC_RIGHTJUSTIFY = 0
TC_FIXEDWIDTH = 0
TC_TOP = 0
TC_LEFT = 0
TC_RIGHT = 0
TC_BOTTOM = 0
TC_MULTILINE = 0
TC_OWNERDRAW = 0
BI_EXPAND = 0
LI_HORIZONTAL = 0
LI_VERTICAL = 0
YES = 0
OK = 0
NO = 0
YES_NO = 0
CANCEL = 0
APPLY = 0
CLOSE = 0
OK_DEFAULT = 0
YES_DEFAULT = 0
NO_DEFAULT = 0
CANCEL_DEFAULT = 0
ICON_EXCLAMATION = 0
ICON_HAND = 0
ICON_WARNING = 0
ICON_ERROR = 0
ICON_QUESTION = 0
ICON_INFORMATION = 0
ICON_STOP = 0
ICON_ASTERISK = 0
HELP = 0
FORWARD = 0
BACKWARD = 0
RESET = 0
MORE = 0
SETUP = 0
ICON_NONE = 0
ICON_AUTH_NEEDED = 0
ICON_MASK = 0
NOT_FOUND = 0
PRINT_QUALITY_HIGH = 0
PRINT_QUALITY_MEDIUM = 0
PRINT_QUALITY_LOW = 0
PRINT_QUALITY_DRAFT = 0
STAY_ON_TOP = 0
ICONIZE = 0
MINIMIZE = 0
MAXIMIZE = 0
CLOSE_BOX = 0
SYSTEM_MENU = 0
MINIMIZE_BOX = 0
MAXIMIZE_BOX = 0
TINY_CAPTION = 0
RESIZE_BORDER = 0
CENTRE = 0
CENTER = 0
HORIZONTAL = 0
VERTICAL = 0
BOTH = 0
ORIENTATION_MASK = 0
LEFT = 0
RIGHT = 0
UP = 0
DOWN = 0
TOP = 0
BOTTOM = 0
NORTH = 0
SOUTH = 0
WEST = 0
EAST = 0
ALL = 0
DIRECTION_MASK = 0
ALIGN_INVALID = 0
ALIGN_NOT = 0
ALIGN_CENTER_HORIZONTAL = 0
ALIGN_CENTRE_HORIZONTAL = 0
ALIGN_LEFT = 0
ALIGN_TOP = 0
ALIGN_RIGHT = 0
ALIGN_BOTTOM = 0
ALIGN_CENTER_VERTICAL = 0
ALIGN_CENTRE_VERTICAL = 0
ALIGN_CENTER = 0
ALIGN_CENTRE = 0
ALIGN_MASK = 0
FIXED_MINSIZE = 0
RESERVE_SPACE_EVEN_IF_HIDDEN = 0
SIZER_FLAG_BITS_MASK = 0
STRETCH_NOT = 0
SHRINK = 0
GROW = 0
EXPAND = 0
SHAPED = 0
TILE = 0
STRETCH_MASK = 0
BORDER_DEFAULT = 0
BORDER_NONE = 0
BORDER_STATIC = 0
BORDER_SIMPLE = 0
BORDER_RAISED = 0
BORDER_SUNKEN = 0
BORDER_DOUBLE = 0
BORDER_THEME = 0
BORDER_MASK = 0
BG_STYLE_ERASE = 0
BG_STYLE_SYSTEM = 0
BG_STYLE_PAINT = 0
BG_STYLE_COLOUR = 0
BG_STYLE_TRANSPARENT = 0
ID_AUTO_LOWEST = 0
ID_AUTO_HIGHEST = 0
ID_NONE = 0
ID_SEPARATOR = 0
ID_ANY = 0
ID_LOWEST = 0
ID_OPEN = 0
ID_CLOSE = 0
ID_NEW = 0
ID_SAVE = 0
ID_SAVEAS = 0
ID_REVERT = 0
ID_EXIT = 0
ID_UNDO = 0
ID_REDO = 0
ID_HELP = 0
ID_PRINT = 0
ID_PRINT_SETUP = 0
ID_PAGE_SETUP = 0
ID_PREVIEW = 0
ID_ABOUT = 0
ID_HELP_CONTENTS = 0
ID_HELP_INDEX = 0
ID_HELP_SEARCH = 0
ID_HELP_COMMANDS = 0
ID_HELP_PROCEDURES = 0
ID_HELP_CONTEXT = 0
ID_CLOSE_ALL = 0
ID_PREFERENCES = 0
ID_EDIT = 0
ID_CUT = 0
ID_COPY = 0
ID_PASTE = 0
ID_CLEAR = 0
ID_FIND = 0
ID_DUPLICATE = 0
ID_SELECTALL = 0
ID_DELETE = 0
ID_REPLACE = 0
ID_REPLACE_ALL = 0
ID_PROPERTIES = 0
ID_VIEW_DETAILS = 0
ID_VIEW_LARGEICONS = 0
ID_VIEW_SMALLICONS = 0
ID_VIEW_LIST = 0
ID_VIEW_SORTDATE = 0
ID_VIEW_SORTNAME = 0
ID_VIEW_SORTSIZE = 0
ID_VIEW_SORTTYPE = 0
ID_FILE = 0
ID_FILE1 = 0
ID_FILE2 = 0
ID_FILE3 = 0
ID_FILE4 = 0
ID_FILE5 = 0
ID_FILE6 = 0
ID_FILE7 = 0
ID_FILE8 = 0
ID_FILE9 = 0
ID_OK = 0
ID_CANCEL = 0
ID_APPLY = 0
ID_YES = 0
ID_NO = 0
ID_STATIC = 0
ID_FORWARD = 0
ID_BACKWARD = 0
ID_DEFAULT = 0
ID_MORE = 0
ID_SETUP = 0
ID_RESET = 0
ID_CONTEXT_HELP = 0
ID_YESTOALL = 0
ID_NOTOALL = 0
ID_ABORT = 0
ID_RETRY = 0
ID_IGNORE = 0
ID_ADD = 0
ID_REMOVE = 0
ID_UP = 0
ID_DOWN = 0
ID_HOME = 0
ID_REFRESH = 0
ID_STOP = 0
ID_INDEX = 0
ID_BOLD = 0
ID_ITALIC = 0
ID_JUSTIFY_CENTER = 0
ID_JUSTIFY_FILL = 0
ID_JUSTIFY_RIGHT = 0
ID_JUSTIFY_LEFT = 0
ID_UNDERLINE = 0
ID_INDENT = 0
ID_UNINDENT = 0
ID_ZOOM_100 = 0
ID_ZOOM_FIT = 0
ID_ZOOM_IN = 0
ID_ZOOM_OUT = 0
ID_UNDELETE = 0
ID_REVERT_TO_SAVED = 0
ID_CDROM = 0
ID_CONVERT = 0
ID_EXECUTE = 0
ID_FLOPPY = 0
ID_HARDDISK = 0
ID_BOTTOM = 0
ID_FIRST = 0
ID_LAST = 0
ID_TOP = 0
ID_INFO = 0
ID_JUMP_TO = 0
ID_NETWORK = 0
ID_SELECT_COLOR = 0
ID_SELECT_FONT = 0
ID_SORT_ASCENDING = 0
ID_SORT_DESCENDING = 0
ID_SPELL_CHECK = 0
ID_STRIKETHROUGH = 0
ID_SYSTEM_MENU = 0
ID_CLOSE_FRAME = 0
ID_MOVE_FRAME = 0
ID_RESIZE_FRAME = 0
ID_MAXIMIZE_FRAME = 0
ID_ICONIZE_FRAME = 0
ID_RESTORE_FRAME = 0
ID_MDI_WINDOW_FIRST = 0
ID_MDI_WINDOW_CASCADE = 0
ID_MDI_WINDOW_TILE_HORZ = 0
ID_MDI_WINDOW_TILE_VERT = 0
ID_MDI_WINDOW_ARRANGE_ICONS = 0
ID_MDI_WINDOW_PREV = 0
ID_MDI_WINDOW_NEXT = 0
ID_MDI_WINDOW_LAST = 0
ID_FILEDLGG = 0
ID_FILECTRL = 0
ID_HIGHEST = 0
ITEM_SEPARATOR = 0
ITEM_NORMAL = 0
ITEM_CHECK = 0
ITEM_RADIO = 0
ITEM_DROPDOWN = 0
ITEM_MAX = 0
HT_NOWHERE = 0
HT_SCROLLBAR_FIRST = 0
HT_SCROLLBAR_ARROW_LINE_1 = 0
HT_SCROLLBAR_ARROW_LINE_2 = 0
HT_SCROLLBAR_ARROW_PAGE_1 = 0
HT_SCROLLBAR_ARROW_PAGE_2 = 0
HT_SCROLLBAR_THUMB = 0
HT_SCROLLBAR_BAR_1 = 0
HT_SCROLLBAR_BAR_2 = 0
HT_SCROLLBAR_LAST = 0
HT_WINDOW_OUTSIDE = 0
HT_WINDOW_INSIDE = 0
HT_WINDOW_VERT_SCROLLBAR = 0
HT_WINDOW_HORZ_SCROLLBAR = 0
HT_WINDOW_CORNER = 0
HT_MAX = 0
DF_INVALID = 0
DF_TEXT = 0
DF_BITMAP = 0
DF_METAFILE = 0
DF_SYLK = 0
DF_DIF = 0
DF_TIFF = 0
DF_OEMTEXT = 0
DF_DIB = 0
DF_PALETTE = 0
DF_PENDATA = 0
DF_RIFF = 0
DF_WAVE = 0
DF_UNICODETEXT = 0
DF_ENHMETAFILE = 0
DF_FILENAME = 0
DF_LOCALE = 0
DF_PRIVATE = 0
DF_HTML = 0
DF_MAX = 0
WXK_NONE = 0
WXK_CONTROL_A = 0
WXK_CONTROL_B = 0
WXK_CONTROL_C = 0
WXK_CONTROL_D = 0
WXK_CONTROL_E = 0
WXK_CONTROL_F = 0
WXK_CONTROL_G = 0
WXK_CONTROL_H = 0
WXK_CONTROL_I = 0
WXK_CONTROL_J = 0
WXK_CONTROL_K = 0
WXK_CONTROL_L = 0
WXK_CONTROL_M = 0
WXK_CONTROL_N = 0
WXK_CONTROL_O = 0
WXK_CONTROL_P = 0
WXK_CONTROL_Q = 0
WXK_CONTROL_R = 0
WXK_CONTROL_S = 0
WXK_CONTROL_T = 0
WXK_CONTROL_U = 0
WXK_CONTROL_V = 0
WXK_CONTROL_W = 0
WXK_CONTROL_X = 0
WXK_CONTROL_Y = 0
WXK_CONTROL_Z = 0
WXK_BACK = 0
WXK_TAB = 0
WXK_RETURN = 0
WXK_ESCAPE = 0
WXK_SPACE = 0
WXK_DELETE = 0
WXK_START = 0
WXK_LBUTTON = 0
WXK_RBUTTON = 0
WXK_CANCEL = 0
WXK_MBUTTON = 0
WXK_CLEAR = 0
WXK_SHIFT = 0
WXK_ALT = 0
WXK_CONTROL = 0
WXK_RAW_CONTROL = 0
WXK_MENU = 0
WXK_PAUSE = 0
WXK_CAPITAL = 0
WXK_END = 0
WXK_HOME = 0
WXK_LEFT = 0
WXK_UP = 0
WXK_RIGHT = 0
WXK_DOWN = 0
WXK_SELECT = 0
WXK_PRINT = 0
WXK_EXECUTE = 0
WXK_SNAPSHOT = 0
WXK_INSERT = 0
WXK_HELP = 0
WXK_NUMPAD0 = 0
WXK_NUMPAD1 = 0
WXK_NUMPAD2 = 0
WXK_NUMPAD3 = 0
WXK_NUMPAD4 = 0
WXK_NUMPAD5 = 0
WXK_NUMPAD6 = 0
WXK_NUMPAD7 = 0
WXK_NUMPAD8 = 0
WXK_NUMPAD9 = 0
WXK_MULTIPLY = 0
WXK_ADD = 0
WXK_SEPARATOR = 0
WXK_SUBTRACT = 0
WXK_DECIMAL = 0
WXK_DIVIDE = 0
WXK_F1 = 0
WXK_F2 = 0
WXK_F3 = 0
WXK_F4 = 0
WXK_F5 = 0
WXK_F6 = 0
WXK_F7 = 0
WXK_F8 = 0
WXK_F9 = 0
WXK_F10 = 0
WXK_F11 = 0
WXK_F12 = 0
WXK_F13 = 0
WXK_F14 = 0
WXK_F15 = 0
WXK_F16 = 0
WXK_F17 = 0
WXK_F18 = 0
WXK_F19 = 0
WXK_F20 = 0
WXK_F21 = 0
WXK_F22 = 0
WXK_F23 = 0
WXK_F24 = 0
WXK_NUMLOCK = 0
WXK_SCROLL = 0
WXK_PAGEUP = 0
WXK_PAGEDOWN = 0
WXK_NUMPAD_SPACE = 0
WXK_NUMPAD_TAB = 0
WXK_NUMPAD_ENTER = 0
WXK_NUMPAD_F1 = 0
WXK_NUMPAD_F2 = 0
WXK_NUMPAD_F3 = 0
WXK_NUMPAD_F4 = 0
WXK_NUMPAD_HOME = 0
WXK_NUMPAD_LEFT = 0
WXK_NUMPAD_UP = 0
WXK_NUMPAD_RIGHT = 0
WXK_NUMPAD_DOWN = 0
WXK_NUMPAD_PAGEUP = 0
WXK_NUMPAD_PAGEDOWN = 0
WXK_NUMPAD_END = 0
WXK_NUMPAD_BEGIN = 0
WXK_NUMPAD_INSERT = 0
WXK_NUMPAD_DELETE = 0
WXK_NUMPAD_EQUAL = 0
WXK_NUMPAD_MULTIPLY = 0
WXK_NUMPAD_ADD = 0
WXK_NUMPAD_SEPARATOR = 0
WXK_NUMPAD_SUBTRACT = 0
WXK_NUMPAD_DECIMAL = 0
WXK_NUMPAD_DIVIDE = 0
WXK_WINDOWS_LEFT = 0
WXK_WINDOWS_RIGHT = 0
WXK_WINDOWS_MENU = 0
WXK_COMMAND = 0
WXK_SPECIAL1 = 0
WXK_SPECIAL2 = 0
WXK_SPECIAL3 = 0
WXK_SPECIAL4 = 0
WXK_SPECIAL5 = 0
WXK_SPECIAL6 = 0
WXK_SPECIAL7 = 0
WXK_SPECIAL8 = 0
WXK_SPECIAL9 = 0
WXK_SPECIAL10 = 0
WXK_SPECIAL11 = 0
WXK_SPECIAL12 = 0
WXK_SPECIAL13 = 0
WXK_SPECIAL14 = 0
WXK_SPECIAL15 = 0
WXK_SPECIAL16 = 0
WXK_SPECIAL17 = 0
WXK_SPECIAL18 = 0
WXK_SPECIAL19 = 0
WXK_SPECIAL20 = 0
MOD_NONE = 0
MOD_ALT = 0
MOD_CONTROL = 0
MOD_ALTGR = 0
MOD_SHIFT = 0
MOD_META = 0
MOD_WIN = 0
MOD_RAW_CONTROL = 0
MOD_CMD = 0
MOD_ALL = 0
PAPER_10X11 = 0
PAPER_10X14 = 0
PAPER_11X17 = 0
PAPER_12X11 = 0
PAPER_15X11 = 0
PAPER_9X11 = 0
PAPER_A2 = 0
PAPER_A3 = 0
PAPER_A3_EXTRA = 0
PAPER_A3_EXTRA_TRANSVERSE = 0
PAPER_A3_ROTATED = 0
PAPER_A3_TRANSVERSE = 0
PAPER_A4 = 0
PAPER_A4SMALL = 0
PAPER_A4_EXTRA = 0
PAPER_A4_PLUS = 0
PAPER_A4_ROTATED = 0
PAPER_A4_TRANSVERSE = 0
PAPER_A5 = 0
PAPER_A5_EXTRA = 0
PAPER_A5_ROTATED = 0
PAPER_A5_TRANSVERSE = 0
PAPER_A6 = 0
PAPER_A6_ROTATED = 0
PAPER_A_PLUS = 0
PAPER_B4 = 0
PAPER_B4_JIS_ROTATED = 0
PAPER_B5 = 0
PAPER_B5_EXTRA = 0
PAPER_B5_JIS_ROTATED = 0
PAPER_B5_TRANSVERSE = 0
PAPER_B6_JIS = 0
PAPER_B6_JIS_ROTATED = 0
PAPER_B_PLUS = 0
PAPER_CSHEET = 0
PAPER_DBL_JAPANESE_POSTCARD = 0
PAPER_DBL_JAPANESE_POSTCARD_ROTATED = 0
PAPER_DSHEET = 0
PAPER_ENV_10 = 0
PAPER_ENV_11 = 0
PAPER_ENV_12 = 0
PAPER_ENV_14 = 0
PAPER_ENV_9 = 0
PAPER_ENV_B4 = 0
PAPER_ENV_B5 = 0
PAPER_ENV_B6 = 0
PAPER_ENV_C3 = 0
PAPER_ENV_C4 = 0
PAPER_ENV_C5 = 0
PAPER_ENV_C6 = 0
PAPER_ENV_C65 = 0
PAPER_ENV_DL = 0
PAPER_ENV_INVITE = 0
PAPER_ENV_ITALY = 0
PAPER_ENV_MONARCH = 0
PAPER_ENV_PERSONAL = 0
PAPER_ESHEET = 0
PAPER_EXECUTIVE = 0
PAPER_FANFOLD_LGL_GERMAN = 0
PAPER_FANFOLD_STD_GERMAN = 0
PAPER_FANFOLD_US = 0
PAPER_FOLIO = 0
PAPER_ISO_B4 = 0
PAPER_JAPANESE_POSTCARD = 0
PAPER_JAPANESE_POSTCARD_ROTATED = 0
PAPER_JENV_CHOU3 = 0
PAPER_JENV_CHOU3_ROTATED = 0
PAPER_JENV_CHOU4 = 0
PAPER_JENV_CHOU4_ROTATED = 0
PAPER_JENV_KAKU2 = 0
PAPER_JENV_KAKU2_ROTATED = 0
PAPER_JENV_KAKU3 = 0
PAPER_JENV_KAKU3_ROTATED = 0
PAPER_JENV_YOU4 = 0
PAPER_JENV_YOU4_ROTATED = 0
PAPER_LEDGER = 0
PAPER_LEGAL = 0
PAPER_LEGAL_EXTRA = 0
PAPER_LETTER = 0
PAPER_LETTERSMALL = 0
PAPER_LETTER_EXTRA = 0
PAPER_LETTER_EXTRA_TRANSVERSE = 0
PAPER_LETTER_PLUS = 0
PAPER_LETTER_ROTATED = 0
PAPER_LETTER_TRANSVERSE = 0
PAPER_NONE = 0
PAPER_NOTE = 0
PAPER_P16K = 0
PAPER_P16K_ROTATED = 0
PAPER_P32K = 0
PAPER_P32KBIG = 0
PAPER_P32KBIG_ROTATED = 0
PAPER_P32K_ROTATED = 0
PAPER_PENV_1 = 0
PAPER_PENV_10 = 0
PAPER_PENV_10_ROTATED = 0
PAPER_PENV_1_ROTATED = 0
PAPER_PENV_2 = 0
PAPER_PENV_2_ROTATED = 0
PAPER_PENV_3 = 0
PAPER_PENV_3_ROTATED = 0
PAPER_PENV_4 = 0
PAPER_PENV_4_ROTATED = 0
PAPER_PENV_5 = 0
PAPER_PENV_5_ROTATED = 0
PAPER_PENV_6 = 0
PAPER_PENV_6_ROTATED = 0
PAPER_PENV_7 = 0
PAPER_PENV_7_ROTATED = 0
PAPER_PENV_8 = 0
PAPER_PENV_8_ROTATED = 0
PAPER_PENV_9 = 0
PAPER_PENV_9_ROTATED = 0
PAPER_QUARTO = 0
PAPER_STATEMENT = 0
PAPER_TABLOID = 0
PAPER_TABLOID_EXTRA = 0
PORTRAIT = 0
LANDSCAPE = 0
DUPLEX_SIMPLEX = 0
DUPLEX_HORIZONTAL = 0
DUPLEX_VERTICAL = 0
PRINT_MODE_NONE = 0
PRINT_MODE_PREVIEW = 0
PRINT_MODE_FILE = 0
PRINT_MODE_PRINTER = 0
PRINT_MODE_STREAM = 0
UPDATE_UI_NONE = 0
UPDATE_UI_RECURSE = 0
UPDATE_UI_FROMIDLE = 0
DefaultCoord = 0
BG_STYLE_CUSTOM = BG_STYLE_PAINT
ADJUST_MINSIZE = 0
#-- end-defs --#
#-- begin-debug --#
def Abort():
"""
Abort()
Exits the program immediately.
"""
def DisableAsserts():
"""
DisableAsserts()
Disable the condition checks in the assertions.
"""
def Trap():
"""
Trap()
Generate a debugger exception meaning that the control is passed to
the debugger if one is attached to the process.
"""
#-- end-debug --#
#-- begin-object --#
class RefCounter(object):
"""
RefCounter()
This class is used to manage reference-counting providing a simple
interface and a counter.
"""
def __init__(self):
"""
RefCounter()
This class is used to manage reference-counting providing a simple
interface and a counter.
"""
def DecRef(self):
"""
DecRef()
Decrements the reference count associated with this shared data and,
if it reaches zero, destroys this instance of wxRefCounter releasing
its memory.
"""
def GetRefCount(self):
"""
GetRefCount() -> int
Returns the reference count associated with this shared data.
"""
def IncRef(self):
"""
IncRef()
Increments the reference count associated with this shared data.
"""
RefCount = property(None, None)
# end of class RefCounter
class Object(object):
"""
Object()
Object(other)
This is the root class of many of the wxWidgets classes.
"""
def __init__(self, *args, **kw):
"""
Object()
Object(other)
This is the root class of many of the wxWidgets classes.
"""
def GetRefData(self):
"""
GetRefData() -> ObjectRefData
Returns the wxObject::m_refData pointer, i.e. the data referenced by
this object.
"""
def IsSameAs(self, obj):
"""
IsSameAs(obj) -> bool
Returns true if this object has the same data pointer as obj.
"""
def Ref(self, clone):
"""
Ref(clone)
Makes this object refer to the data in clone.
"""
def SetRefData(self, data):
"""
SetRefData(data)
Sets the wxObject::m_refData pointer.
"""
def UnRef(self):
"""
UnRef()
Decrements the reference count in the associated data, and if it is
zero, deletes the data.
"""
def UnShare(self):
"""
UnShare()
This is the same of AllocExclusive() but this method is public.
"""
def GetClassName(self):
"""
GetClassName() -> Char
Returns the class name of the C++ class using wxRTTI.
"""
def Destroy(self):
"""
Destroy()
Deletes the C++ object this Python object is a proxy for.
"""
ClassName = property(None, None)
RefData = property(None, None)
# end of class Object
#-- end-object --#
#-- begin-clntdatactnr --#
class ClientDataContainer(object):
"""
ClientDataContainer()
This class is a mixin that provides storage and management of "client
data".
"""
def __init__(self):
"""
ClientDataContainer()
This class is a mixin that provides storage and management of "client
data".
"""
def GetClientData(self):
"""
GetClientData() -> ClientData
Get a pointer to the client data object.
"""
def SetClientData(self, data):
"""
SetClientData(data)
Set the client data object.
"""
def GetClientObject(self):
"""
Alias for :meth:`GetClientData`
"""
def SetClientObject(self, data):
"""
Alias for :meth:`SetClientData`
"""
ClientObject = property(None, None)
# end of class ClientDataContainer
#-- end-clntdatactnr --#
#-- begin-wxdatetime --#
DefaultTimeSpanFormat = ""
DefaultDateTimeFormat = ""
class DateTime(object):
"""
DateTime()
DateTime(date)
DateTime(day, month, year=Inv_Year, hour=0, minute=0, second=0, millisec=0)
wxDateTime class represents an absolute moment in time.
"""
class TimeZone(object):
"""
TimeZone(tz)
TimeZone(offset=0)
Class representing a time zone.
"""
def __init__(self, *args, **kw):
"""
TimeZone(tz)
TimeZone(offset=0)
Class representing a time zone.
"""
def GetOffset(self):
"""
GetOffset() -> long
Return the offset of this time zone from UTC, in seconds.
"""
@staticmethod
def Make(offset):
"""
Make(offset) -> DateTime.TimeZone
Create a time zone with the given offset in seconds.
"""
Offset = property(None, None)
# end of class TimeZone
class Tm(object):
"""
Contains broken down date-time representation.
"""
msec = property(None, None)
sec = property(None, None)
min = property(None, None)
hour = property(None, None)
mday = property(None, None)
yday = property(None, None)
mon = property(None, None)
year = property(None, None)
def IsValid(self):
"""
IsValid() -> bool
Check if the given date/time is valid (in Gregorian calendar).
"""
def GetWeekDay(self):
"""
GetWeekDay() -> DateTime.WeekDay
Return the week day corresponding to this date.
"""
WeekDay = property(None, None)
# end of class Tm
Local = 0
GMT_12 = 0
GMT_11 = 0
GMT_10 = 0
GMT_9 = 0
GMT_8 = 0
GMT_7 = 0
GMT_6 = 0
GMT_5 = 0
GMT_4 = 0
GMT_3 = 0
GMT_2 = 0
GMT_1 = 0
GMT0 = 0
GMT1 = 0
GMT2 = 0
GMT3 = 0
GMT4 = 0
GMT5 = 0
GMT6 = 0
GMT7 = 0
GMT8 = 0
GMT9 = 0
GMT10 = 0
GMT11 = 0
GMT12 = 0
GMT13 = 0
WET = 0
WEST = 0
CET = 0
CEST = 0
EET = 0
EEST = 0
MSK = 0
MSD = 0
AST = 0
ADT = 0
EST = 0
EDT = 0
CST = 0
CDT = 0
MST = 0
MDT = 0
PST = 0
PDT = 0
HST = 0
AKST = 0
AKDT = 0
A_WST = 0
A_CST = 0
A_EST = 0
A_ESST = 0
NZST = 0
NZDT = 0
UTC = 0
Gregorian = 0
Julian = 0
Country_Unknown = 0
Country_Default = 0
Country_WesternEurope_Start = 0
Country_EEC = 0
France = 0
Germany = 0
UK = 0
Country_WesternEurope_End = 0
Russia = 0
USA = 0
Jan = 0
Feb = 0
Mar = 0
Apr = 0
May = 0
Jun = 0
Jul = 0
Aug = 0
Sep = 0
Oct = 0
Nov = 0
Dec = 0
Inv_Month = 0
Sun = 0
Mon = 0
Tue = 0
Wed = 0
Thu = 0
Fri = 0
Sat = 0
Inv_WeekDay = 0
Inv_Year = 0
Name_Full = 0
Name_Abbr = 0
Default_First = 0
Monday_First = 0
Sunday_First = 0
def __init__(self, *args, **kw):
"""
DateTime()
DateTime(date)
DateTime(day, month, year=Inv_Year, hour=0, minute=0, second=0, millisec=0)
wxDateTime class represents an absolute moment in time.
"""
def ResetTime(self):
"""
ResetTime() -> DateTime
Reset time to midnight (00:00:00) without changing the date.
"""
def Set(self, *args, **kw):
"""
Set(day, month, year=Inv_Year, hour=0, minute=0, second=0, millisec=0) -> DateTime
Sets the date and time from the parameters.
"""
def SetHMS(self, hour, minute=0, second=0, millisec=0):
"""
SetHMS(hour, minute=0, second=0, millisec=0) -> DateTime
Sets the date to be equal to Today() and the time from supplied
parameters.
"""
def SetJDN(self, jdn):
"""
SetJDN(jdn) -> DateTime
Sets the date from the so-called Julian Day Number.
"""
def SetTimeT(self, timet):
"""
SetTimeT(timet) -> DateTime
Constructs the object from timet value holding the number of seconds
since Jan 1, 1970 UTC.
"""
def SetTm(self, tm):
"""
SetTm(tm) -> DateTime
Sets the date and time from the broken down representation in the
wxDateTime::Tm structure.
"""
def SetDay(self, day):
"""
SetDay(day) -> DateTime
Sets the day without changing other date components.
"""
def SetFromDOS(self, ddt):
"""
SetFromDOS(ddt) -> DateTime
Sets the date from the date and time in DOS format.
"""
def SetHour(self, hour):
"""
SetHour(hour) -> DateTime
Sets the hour without changing other date components.
"""
def SetMillisecond(self, millisecond):
"""
SetMillisecond(millisecond) -> DateTime
Sets the millisecond without changing other date components.
"""
def SetMinute(self, minute):
"""
SetMinute(minute) -> DateTime
Sets the minute without changing other date components.
"""
def SetMonth(self, month):
"""
SetMonth(month) -> DateTime
Sets the month without changing other date components.
"""
def SetSecond(self, second):
"""
SetSecond(second) -> DateTime
Sets the second without changing other date components.
"""
def SetToCurrent(self):
"""
SetToCurrent() -> DateTime
Sets the date and time of to the current values.
"""
def SetYear(self, year):
"""
SetYear(year) -> DateTime
Sets the year without changing other date components.
"""
def GetAsDOS(self):
"""
GetAsDOS() -> unsignedlong
Returns the date and time in DOS format.
"""
def GetCentury(self, *args, **kw):
"""
GetCentury(tz=Local) -> int
Returns the century of this date.
"""
def GetDateOnly(self):
"""
GetDateOnly() -> DateTime
Returns the object having the same date component as this one but time
of 00:00:00.
"""
def GetDay(self, tz=Local):
"""
GetDay(tz=Local) -> unsignedshort
Returns the day in the given timezone (local one by default).
"""
def GetDayOfYear(self, tz=Local):
"""
GetDayOfYear(tz=Local) -> unsignedshort
Returns the day of the year (in 1-366 range) in the given timezone
(local one by default).
"""
def GetHour(self, tz=Local):
"""
GetHour(tz=Local) -> unsignedshort
Returns the hour in the given timezone (local one by default).
"""
def GetMillisecond(self, tz=Local):
"""
GetMillisecond(tz=Local) -> unsignedshort
Returns the milliseconds in the given timezone (local one by default).
"""
def GetMinute(self, tz=Local):
"""
GetMinute(tz=Local) -> unsignedshort
Returns the minute in the given timezone (local one by default).
"""
def GetMonth(self, tz=Local):
"""
GetMonth(tz=Local) -> DateTime.Month
Returns the month in the given timezone (local one by default).
"""
def GetSecond(self, tz=Local):
"""
GetSecond(tz=Local) -> unsignedshort
Returns the seconds in the given timezone (local one by default).
"""
def GetTicks(self):
"""
GetTicks() -> time_t
Returns the number of seconds since Jan 1, 1970 UTC.
"""
def GetTm(self, tz=Local):
"""
GetTm(tz=Local) -> DateTime.Tm
Returns broken down representation of the date and time.
"""
def GetWeekDay(self, *args, **kw):
"""
GetWeekDay(tz=Local) -> DateTime.WeekDay
GetWeekDay(weekday, n=1, month=Inv_Month, year=Inv_Year) -> DateTime
Returns the week day in the given timezone (local one by default).
"""
def GetWeekOfMonth(self, flags=Monday_First, tz=Local):
"""
GetWeekOfMonth(flags=Monday_First, tz=Local) -> unsignedshort
Returns the ordinal number of the week in the month (in 1-5 range).
"""
def GetWeekOfYear(self, flags=Monday_First, tz=Local):
"""
GetWeekOfYear(flags=Monday_First, tz=Local) -> unsignedshort
Returns the number of the week of the year this date is in.
"""
def GetYear(self, tz=Local):
"""
GetYear(tz=Local) -> int
Returns the year in the given timezone (local one by default).
"""
def IsValid(self):
"""
IsValid() -> bool
Returns true if the object represents a valid time moment.
"""
def IsWorkDay(self, country=Country_Default):
"""
IsWorkDay(country=Country_Default) -> bool
Returns true is this day is not a holiday in the given country.
"""
def IsEarlierThan(self, datetime):
"""
IsEarlierThan(datetime) -> bool
Returns true if this date precedes the given one.
"""
def IsEqualTo(self, datetime):
"""
IsEqualTo(datetime) -> bool
Returns true if the two dates are strictly identical.
"""
def IsEqualUpTo(self, dt, ts):
"""
IsEqualUpTo(dt, ts) -> bool
Returns true if the date is equal to another one up to the given time
interval, i.e. if the absolute difference between the two dates is
less than this interval.
"""
def IsLaterThan(self, datetime):
"""
IsLaterThan(datetime) -> bool
Returns true if this date is later than the given one.
"""
def IsSameDate(self, dt):
"""
IsSameDate(dt) -> bool
Returns true if the date is the same without comparing the time parts.
"""
def IsSameTime(self, dt):
"""
IsSameTime(dt) -> bool
Returns true if the time is the same (although dates may differ).
"""
def IsStrictlyBetween(self, t1, t2):
"""
IsStrictlyBetween(t1, t2) -> bool
Returns true if this date lies strictly between the two given dates.
"""
def IsBetween(self, t1, t2):
"""
IsBetween(t1, t2) -> bool
Returns true if IsStrictlyBetween() is true or if the date is equal to
one of the limit values.
"""
def Add(self, *args, **kw):
"""
Add(diff) -> DateTime
Add(diff) -> DateTime
Adds the given date span to this object.
"""
def Subtract(self, *args, **kw):
"""
Subtract(diff) -> DateTime
Subtract(diff) -> DateTime
Subtract(dt) -> TimeSpan
Subtracts the given time span from this object.
"""
def DiffAsDateSpan(self, dt):
"""
DiffAsDateSpan(dt) -> DateSpan
Returns the difference between this object and dt as a wxDateSpan.
"""
def Format(self, format=DefaultDateTimeFormat, tz=Local):
"""
Format(format=DefaultDateTimeFormat, tz=Local) -> String
This function does the same as the standard ANSI C strftime(3)
function
(http://www.cplusplus.com/reference/clibrary/ctime/strftime.html).
"""
def FormatDate(self):
"""
FormatDate() -> String
Identical to calling Format() with "%x" argument (which means
"preferred date representation for the current locale").
"""
def FormatISOCombined(self, sep='T'):
"""
FormatISOCombined(sep='T') -> String
Returns the combined date-time representation in the ISO 8601 format
"YYYY-MM-DDTHH:MM:SS".
"""
def FormatISODate(self):
"""
FormatISODate() -> String
This function returns the date representation in the ISO 8601 format
"YYYY-MM-DD".
"""
def FormatISOTime(self):
"""
FormatISOTime() -> String
This function returns the time representation in the ISO 8601 format
"HH:MM:SS".
"""
def FormatTime(self):
"""
FormatTime() -> String
Identical to calling Format() with "%X" argument (which means
"preferred time representation for the current locale").
"""
def ParseDate(self, date):
"""
ParseDate(date) -> int
This function is like ParseDateTime(), but it only allows the date to
be specified.
"""
def ParseDateTime(self, datetime):
"""
ParseDateTime(datetime) -> int
Parses the string datetime containing the date and time in free
format.
"""
def ParseFormat(self, *args, **kw):
"""
ParseFormat(date, format, dateDef) -> int
ParseFormat(date, format) -> int
ParseFormat(date) -> int
This function parses the string date according to the given format.
"""
def ParseISOCombined(self, date, sep='T'):
"""
ParseISOCombined(date, sep='T') -> bool
This function parses the string containing the date and time in ISO
8601 combined format "YYYY-MM-DDTHH:MM:SS".
"""
def ParseISODate(self, date):
"""
ParseISODate(date) -> bool
This function parses the date in ISO 8601 format "YYYY-MM-DD".
"""
def ParseISOTime(self, date):
"""
ParseISOTime(date) -> bool
This function parses the time in ISO 8601 format "HH:MM:SS".
"""
def ParseRfc822Date(self, date):
"""
ParseRfc822Date(date) -> int
Parses the string date looking for a date formatted according to the
RFC 822 in it.
"""
def ParseTime(self, time):
"""
ParseTime(time) -> int
This functions is like ParseDateTime(), but only allows the time to be
specified in the input string.
"""
def GetLastMonthDay(self, month=Inv_Month, year=Inv_Year):
"""
GetLastMonthDay(month=Inv_Month, year=Inv_Year) -> DateTime
Returns the copy of this object to which SetToLastMonthDay() was
applied.
"""
def GetLastWeekDay(self, weekday, month=Inv_Month, year=Inv_Year):
"""
GetLastWeekDay(weekday, month=Inv_Month, year=Inv_Year) -> DateTime
Returns the copy of this object to which SetToLastWeekDay() was
applied.
"""
def GetNextWeekDay(self, weekday):
"""
GetNextWeekDay(weekday) -> DateTime
Returns the copy of this object to which SetToNextWeekDay() was
applied.
"""
def GetPrevWeekDay(self, weekday):
"""
GetPrevWeekDay(weekday) -> DateTime
Returns the copy of this object to which SetToPrevWeekDay() was
applied.
"""
def GetWeekDayInSameWeek(self, weekday, flags=Monday_First):
"""
GetWeekDayInSameWeek(weekday, flags=Monday_First) -> DateTime
Returns the copy of this object to which SetToWeekDayInSameWeek() was
applied.
"""
def GetYearDay(self, yday):
"""
GetYearDay(yday) -> DateTime
Returns the copy of this object to which SetToYearDay() was applied.
"""
def SetToLastMonthDay(self, month=Inv_Month, year=Inv_Year):
"""
SetToLastMonthDay(month=Inv_Month, year=Inv_Year) -> DateTime
Sets the date to the last day in the specified month (the current one
by default).
"""
def SetToLastWeekDay(self, weekday, month=Inv_Month, year=Inv_Year):
"""
SetToLastWeekDay(weekday, month=Inv_Month, year=Inv_Year) -> bool
The effect of calling this function is the same as of calling
SetToWeekDay(-1, weekday, month, year).
"""
def SetToNextWeekDay(self, weekday):
"""
SetToNextWeekDay(weekday) -> DateTime
Sets the date so that it will be the first weekday following the
current date.
"""
def SetToPrevWeekDay(self, weekday):
"""
SetToPrevWeekDay(weekday) -> DateTime
Sets the date so that it will be the last weekday before the current
date.
"""
def SetToWeekDay(self, weekday, n=1, month=Inv_Month, year=Inv_Year):
"""
SetToWeekDay(weekday, n=1, month=Inv_Month, year=Inv_Year) -> bool
Sets the date to the n-th weekday in the given month of the given year
(the current month and year are used by default).
"""
def SetToWeekDayInSameWeek(self, weekday, flags=Monday_First):
"""
SetToWeekDayInSameWeek(weekday, flags=Monday_First) -> DateTime
Adjusts the date so that it will still lie in the same week as before,
but its week day will be the given one.
"""
def SetToYearDay(self, yday):
"""
SetToYearDay(yday) -> DateTime
Sets the date to the day number yday in the same year (i.e. unlike the
other functions, this one does not use the current year).
"""
def GetJDN(self):
"""
GetJDN() -> double
Synonym for GetJulianDayNumber().
"""
def GetJulianDayNumber(self):
"""
GetJulianDayNumber() -> double
Returns the JDN corresponding to this date.
"""
def GetMJD(self):
"""
GetMJD() -> double
Synonym for GetModifiedJulianDayNumber().
"""
def GetModifiedJulianDayNumber(self):
"""
GetModifiedJulianDayNumber() -> double
Returns the "Modified Julian Day Number" (MJD) which is, by
definition, is equal to JDN - 2400000.5.
"""
def GetRataDie(self):
"""
GetRataDie() -> double
Return the Rata Die number of this date.
"""
def FromTimezone(self, tz, noDST=False):
"""
FromTimezone(tz, noDST=False) -> DateTime
Transform the date from the given time zone to the local one.
"""
def IsDST(self, country=Country_Default):
"""
IsDST(country=Country_Default) -> int
Returns true if the DST is applied for this date in the given country.
"""
def MakeFromTimezone(self, tz, noDST=False):
"""
MakeFromTimezone(tz, noDST=False) -> DateTime
Same as FromTimezone() but modifies the object in place.
"""
def MakeTimezone(self, tz, noDST=False):
"""
MakeTimezone(tz, noDST=False) -> DateTime
Modifies the object in place to represent the date in another time
zone.
"""
def MakeUTC(self, noDST=False):
"""
MakeUTC(noDST=False) -> DateTime
This is the same as calling MakeTimezone() with the argument GMT0.
"""
def ToTimezone(self, tz, noDST=False):
"""
ToTimezone(tz, noDST=False) -> DateTime
Transform the date to the given time zone.
"""
def ToUTC(self, noDST=False):
"""
ToUTC(noDST=False) -> DateTime
This is the same as calling ToTimezone() with the argument GMT0.
"""
@staticmethod
def ConvertYearToBC(year):
"""
ConvertYearToBC(year) -> int
Converts the year in absolute notation (i.e. a number which can be
negative, positive or zero) to the year in BC/AD notation.
"""
@staticmethod
def GetAmPmStrings():
"""
GetAmPmStrings() -> (am, pm)
Returns the translations of the strings AM and PM used for time
formatting for the current locale.
"""
@staticmethod
def GetBeginDST(year=Inv_Year, country=Country_Default):
"""
GetBeginDST(year=Inv_Year, country=Country_Default) -> DateTime
Get the beginning of DST for the given country in the given year
(current one by default).
"""
@staticmethod
def GetEndDST(year=Inv_Year, country=Country_Default):
"""
GetEndDST(year=Inv_Year, country=Country_Default) -> DateTime
Returns the end of DST for the given country in the given year
(current one by default).
"""
@staticmethod
def GetCountry():
"""
GetCountry() -> Country
Returns the current default country.
"""
@staticmethod
def GetCurrentMonth(cal=Gregorian):
"""
GetCurrentMonth(cal=Gregorian) -> DateTime.Month
Get the current month in given calendar (only Gregorian is currently
supported).
"""
@staticmethod
def GetCurrentYear(cal=Gregorian):
"""
GetCurrentYear(cal=Gregorian) -> int
Get the current year in given calendar (only Gregorian is currently
supported).
"""
@staticmethod
def GetEnglishMonthName(month, flags=Name_Full):
"""
GetEnglishMonthName(month, flags=Name_Full) -> String
Return the standard English name of the given month.
"""
@staticmethod
def GetEnglishWeekDayName(weekday, flags=Name_Full):
"""
GetEnglishWeekDayName(weekday, flags=Name_Full) -> String
Return the standard English name of the given week day.
"""
@staticmethod
def GetMonthName(month, flags=Name_Full):
"""
GetMonthName(month, flags=Name_Full) -> String
Gets the full (default) or abbreviated name of the given month.
"""
@staticmethod
def GetNumberOfDays(*args, **kw):
"""
GetNumberOfDays(month, year=Inv_Year, cal=Gregorian) -> unsignedshort
Returns the number of days in the given month of the given year.
"""
@staticmethod
def GetTimeNow():
"""
GetTimeNow() -> time_t
Returns the current time.
"""
@staticmethod
def GetWeekDayName(weekday, flags=Name_Full):
"""
GetWeekDayName(weekday, flags=Name_Full) -> String
Gets the full (default) or abbreviated name of the given week day.
"""
@staticmethod
def IsDSTApplicable(year=Inv_Year, country=Country_Default):
"""
IsDSTApplicable(year=Inv_Year, country=Country_Default) -> bool
Returns true if DST was used in the given year (the current one by
default) in the given country.
"""
@staticmethod
def IsLeapYear(year=Inv_Year, cal=Gregorian):
"""
IsLeapYear(year=Inv_Year, cal=Gregorian) -> bool
Returns true if the year is a leap one in the specified calendar.
"""
@staticmethod
def IsWestEuropeanCountry(country=Country_Default):
"""
IsWestEuropeanCountry(country=Country_Default) -> bool
This function returns true if the specified (or default) country is
one of Western European ones.
"""
@staticmethod
def Now():
"""
Now() -> DateTime
Returns the object corresponding to the current time.
"""
@staticmethod
def SetCountry(country):
"""
SetCountry(country)
Sets the country to use by default.
"""
@staticmethod
def SetToWeekOfYear(year, numWeek, weekday=Mon):
"""
SetToWeekOfYear(year, numWeek, weekday=Mon) -> DateTime
Set the date to the given weekday in the week number numWeek of the
given year .
"""
@staticmethod
def Today():
"""
Today() -> DateTime
Returns the object corresponding to the midnight of the current day
(i.e. the same as Now(), but the time part is set to 0).
"""
@staticmethod
def UNow():
"""
UNow() -> DateTime
Returns the object corresponding to the current UTC time including the
milliseconds.
"""
@staticmethod
def FromTimeT(timet):
"""
FromTimeT(timet) -> DateTime
Construct a :class:`DateTime` from a C ``time_t`` value, the number of
seconds since the epoch.
"""
@staticmethod
def FromJDN(jdn):
"""
FromJDN(jdn) -> DateTime
Construct a :class:`DateTime` from a Julian Day Number.
By definition, the Julian Day Number, usually abbreviated as JDN, of a
particular instant is the fractional number of days since 12 hours
Universal Coordinated Time (Greenwich mean noon) on January 1 of the
year -4712 in the Julian proleptic calendar.
"""
@staticmethod
def FromHMS(hour, minute=0, second=0, millisecond=0):
"""
FromHMS(hour, minute=0, second=0, millisecond=0) -> DateTime
Construct a :class:`DateTime` equal to :meth:`Today` () with the time
set to the supplied parameters.
"""
@staticmethod
def FromDMY(day, month, year=Inv_Year, hour=0, minute=0, second=0, millisecond=0):
"""
FromDMY(day, month, year=Inv_Year, hour=0, minute=0, second=0, millisecond=0) -> DateTime
Construct a :class:`DateTime` using the supplied parameters.
"""
def __repr__(self):
"""
"""
def __str__(self):
"""
"""
day = property(None, None)
month = property(None, None)
year = property(None, None)
hour = property(None, None)
minute = property(None, None)
second = property(None, None)
millisecond = property(None, None)
JDN = property(None, None)
DayOfYear = property(None, None)
JulianDayNumber = property(None, None)
LastMonthDay = property(None, None)
MJD = property(None, None)
ModifiedJulianDayNumber = property(None, None)
RataDie = property(None, None)
Ticks = property(None, None)
WeekOfMonth = property(None, None)
WeekOfYear = property(None, None)
# end of class DateTime
class DateSpan(object):
"""
DateSpan(years=0, months=0, weeks=0, days=0)
This class is a "logical time span" and is useful for implementing
program logic for such things as "add one month to the date" which, in
general, doesn't mean to add 60*60*24*31 seconds to it, but to take
the same date the next month (to understand that this is indeed
different consider adding one month to Feb, 15 we want to get Mar,
15, of course).
"""
def __init__(self, years=0, months=0, weeks=0, days=0):
"""
DateSpan(years=0, months=0, weeks=0, days=0)
This class is a "logical time span" and is useful for implementing
program logic for such things as "add one month to the date" which, in
general, doesn't mean to add 60*60*24*31 seconds to it, but to take
the same date the next month (to understand that this is indeed
different consider adding one month to Feb, 15 we want to get Mar,
15, of course).
"""
def Add(self, *args, **kw):
"""
Add(other) -> DateSpan
Adds the given wxDateSpan to this wxDateSpan and returns a reference
to itself.
"""
def GetDays(self):
"""
GetDays() -> int
Returns the number of days (not counting the weeks component) in this
date span.
"""
def GetMonths(self):
"""
GetMonths() -> int
Returns the number of the months (not counting the years) in this date
span.
"""
def GetTotalMonths(self):
"""
GetTotalMonths() -> int
Returns the combined number of months in this date span, counting both
years and months.
"""
def GetTotalDays(self):
"""
GetTotalDays() -> int
Returns the combined number of days in this date span, counting both
weeks and days.
"""
def GetWeeks(self):
"""
GetWeeks() -> int
Returns the number of weeks in this date span.
"""
def GetYears(self):
"""
GetYears() -> int
Returns the number of years in this date span.
"""
def Multiply(self, *args, **kw):
"""
Multiply(factor) -> DateSpan
Multiplies this date span by the specified factor.
"""
def Neg(self):
"""
Neg() -> DateSpan
Changes the sign of this date span.
"""
def Negate(self):
"""
Negate() -> DateSpan
Returns a date span with the opposite sign.
"""
def SetDays(self, n):
"""
SetDays(n) -> DateSpan
Sets the number of days (without modifying any other components) in
this date span.
"""
def SetMonths(self, n):
"""
SetMonths(n) -> DateSpan
Sets the number of months (without modifying any other components) in
this date span.
"""
def SetWeeks(self, n):
"""
SetWeeks(n) -> DateSpan
Sets the number of weeks (without modifying any other components) in
this date span.
"""
def SetYears(self, n):
"""
SetYears(n) -> DateSpan
Sets the number of years (without modifying any other components) in
this date span.
"""
def Subtract(self, *args, **kw):
"""
Subtract(other) -> DateSpan
Subtracts the given wxDateSpan to this wxDateSpan and returns a
reference to itself.
"""
@staticmethod
def Day():
"""
Day() -> DateSpan
Returns a date span object corresponding to one day.
"""
@staticmethod
def Days(days):
"""
Days(days) -> DateSpan
Returns a date span object corresponding to the given number of days.
"""
@staticmethod
def Month():
"""
Month() -> DateSpan
Returns a date span object corresponding to one month.
"""
@staticmethod
def Months(mon):
"""
Months(mon) -> DateSpan
Returns a date span object corresponding to the given number of
months.
"""
@staticmethod
def Week():
"""
Week() -> DateSpan
Returns a date span object corresponding to one week.
"""
@staticmethod
def Weeks(weeks):
"""
Weeks(weeks) -> DateSpan
Returns a date span object corresponding to the given number of weeks.
"""
@staticmethod
def Year():
"""
Year() -> DateSpan
Returns a date span object corresponding to one year.
"""
@staticmethod
def Years(years):
"""
Years(years) -> DateSpan
Returns a date span object corresponding to the given number of years.
"""
# end of class DateSpan
class TimeSpan(object):
"""
TimeSpan()
TimeSpan(hours, min=0, sec=0, msec=0)
wxTimeSpan class represents a time interval.
"""
def __init__(self, *args, **kw):
"""
TimeSpan()
TimeSpan(hours, min=0, sec=0, msec=0)
wxTimeSpan class represents a time interval.
"""
def Abs(self):
"""
Abs() -> TimeSpan
Returns the absolute value of the timespan: does not modify the
object.
"""
def Add(self, *args, **kw):
"""
Add(diff) -> TimeSpan
Adds the given wxTimeSpan to this wxTimeSpan and returns a reference
to itself.
"""
def Format(self, format=DefaultTimeSpanFormat):
"""
Format(format=DefaultTimeSpanFormat) -> String
Returns the string containing the formatted representation of the time
span.
"""
def GetDays(self):
"""
GetDays() -> int
Returns the difference in number of days.
"""
def GetHours(self):
"""
GetHours() -> int
Returns the difference in number of hours.
"""
def GetMilliseconds(self):
"""
GetMilliseconds() -> LongLong
Returns the difference in number of milliseconds.
"""
def GetMinutes(self):
"""
GetMinutes() -> int
Returns the difference in number of minutes.
"""
def GetSeconds(self):
"""
GetSeconds() -> LongLong
Returns the difference in number of seconds.
"""
def GetValue(self):
"""
GetValue() -> LongLong
Returns the internal representation of timespan.
"""
def GetWeeks(self):
"""
GetWeeks() -> int
Returns the difference in number of weeks.
"""
def IsEqualTo(self, ts):
"""
IsEqualTo(ts) -> bool
Returns true if two timespans are equal.
"""
def IsLongerThan(self, ts):
"""
IsLongerThan(ts) -> bool
Compares two timespans: works with the absolute values, i.e. -2 hours
is longer than 1 hour.
"""
def IsNegative(self):
"""
IsNegative() -> bool
Returns true if the timespan is negative.
"""
def IsNull(self):
"""
IsNull() -> bool
Returns true if the timespan is empty.
"""
def IsPositive(self):
"""
IsPositive() -> bool
Returns true if the timespan is positive.
"""
def IsShorterThan(self, ts):
"""
IsShorterThan(ts) -> bool
Compares two timespans: works with the absolute values, i.e. 1 hour is
shorter than -2 hours.
"""
def Multiply(self, *args, **kw):
"""
Multiply(n) -> TimeSpan
Multiplies this time span by n.
"""
def Neg(self):
"""
Neg() -> TimeSpan
Negate the value of the timespan.
"""
def Negate(self):
"""
Negate() -> TimeSpan
Returns timespan with inverted sign.
"""
def Subtract(self, *args, **kw):
"""
Subtract(diff) -> TimeSpan
Subtracts the given wxTimeSpan to this wxTimeSpan and returns a
reference to itself.
"""
@staticmethod
def Day():
"""
Day() -> TimeSpan
Returns the timespan for one day.
"""
@staticmethod
def Days(days):
"""
Days(days) -> TimeSpan
Returns the timespan for the given number of days.
"""
@staticmethod
def Hour():
"""
Hour() -> TimeSpan
Returns the timespan for one hour.
"""
@staticmethod
def Hours(hours):
"""
Hours(hours) -> TimeSpan
Returns the timespan for the given number of hours.
"""
@staticmethod
def Millisecond():
"""
Millisecond() -> TimeSpan
Returns the timespan for one millisecond.
"""
@staticmethod
def Milliseconds(ms):
"""
Milliseconds(ms) -> TimeSpan
Returns the timespan for the given number of milliseconds.
"""
@staticmethod
def Minute():
"""
Minute() -> TimeSpan
Returns the timespan for one minute.
"""
@staticmethod
def Minutes(min):
"""
Minutes(min) -> TimeSpan
Returns the timespan for the given number of minutes.
"""
@staticmethod
def Second():
"""
Second() -> TimeSpan
Returns the timespan for one second.
"""
@staticmethod
def Seconds(sec):
"""
Seconds(sec) -> TimeSpan
Returns the timespan for the given number of seconds.
"""
@staticmethod
def Week():
"""
Week() -> TimeSpan
Returns the timespan for one week.
"""
@staticmethod
def Weeks(weeks):
"""
Weeks(weeks) -> TimeSpan
Returns the timespan for the given number of weeks.
"""
# end of class TimeSpan
DefaultDateTime = DateTime()
InvalidDateTime = DefaultDateTime
@wx.deprecated
def DateTimeFromTimeT(timet):
"""
Compatibility wrapper for :meth:`DateTime.FromTimeT`
"""
pass
@wx.deprecated
def DateTimeFromJDN(jdn):
"""
Compatibility wrapper for :meth:`DateTime.FromJDN`
"""
pass
@wx.deprecated
def DateTimeFromHMS(hour, minute=0, second=0, millisecond=0):
"""
Compatibility wrapper for :meth:`DateTime.FromHMS`
"""
pass
@wx.deprecated
def DateTimeFromDMY(day, month, year=DateTime.Inv_Year, hour=0, minute=0, second=0, millisecond=0):
"""
Compatibility wrapper for :meth:`DateTime.FromDMY`
"""
pass
def pydate2wxdate(date):
"""
Convert a Python date or datetime to a :class:`DateTime` object
"""
pass
def wxdate2pydate(date):
"""
Convert a :class:`DateTime` object to a Python datetime.
"""
pass
#-- end-wxdatetime --#
#-- begin-stopwatch --#
class StopWatch(object):
"""
StopWatch()
The wxStopWatch class allow you to measure time intervals.
"""
def __init__(self):
"""
StopWatch()
The wxStopWatch class allow you to measure time intervals.
"""
def Pause(self):
"""
Pause()
Pauses the stop watch.
"""
def Resume(self):
"""
Resume()
Resumes the stop watch which had been paused with Pause().
"""
def Start(self, milliseconds=0):
"""
Start(milliseconds=0)
(Re)starts the stop watch with a given initial value.
"""
def Time(self):
"""
Time() -> long
Returns the time in milliseconds since the start (or restart) or the
last call of Pause().
"""
def TimeInMicro(self):
"""
TimeInMicro() -> LongLong
Returns elapsed time in microseconds.
"""
# end of class StopWatch
#-- end-stopwatch --#
#-- begin-windowid --#
class IdManager(object):
"""
wxIdManager is responsible for allocating and releasing window IDs.
"""
@staticmethod
def ReserveId(count=1):
"""
ReserveId(count=1) -> WindowID
Called directly by wxWindow::NewControlId(), this function will create
a new ID or range of IDs.
"""
@staticmethod
def UnreserveId(id, count=1):
"""
UnreserveId(id, count=1)
Called directly by wxWindow::UnreserveControlId(), this function will
unreserve an ID or range of IDs that is currently reserved.
"""
# end of class IdManager
#-- end-windowid --#
#-- begin-platinfo --#
OS_UNKNOWN = 0
OS_MAC_OS = 0
OS_MAC_OSX_DARWIN = 0
OS_MAC = 0
OS_WINDOWS_9X = 0
OS_WINDOWS_NT = 0
OS_WINDOWS_MICRO = 0
OS_WINDOWS_CE = 0
OS_WINDOWS = 0
OS_UNIX_LINUX = 0
OS_UNIX_FREEBSD = 0
OS_UNIX_OPENBSD = 0
OS_UNIX_NETBSD = 0
OS_UNIX_SOLARIS = 0
OS_UNIX_AIX = 0
OS_UNIX_HPUX = 0
OS_UNIX = 0
OS_DOS = 0
OS_OS2 = 0
PORT_UNKNOWN = 0
PORT_BASE = 0
PORT_MSW = 0
PORT_MOTIF = 0
PORT_GTK = 0
PORT_DFB = 0
PORT_X11 = 0
PORT_OS2 = 0
PORT_MAC = 0
PORT_COCOA = 0
PORT_WINCE = 0
ARCH_INVALID = 0
ARCH_32 = 0
ARCH_64 = 0
ARCH_MAX = 0
ENDIAN_INVALID = 0
ENDIAN_BIG = 0
ENDIAN_LITTLE = 0
ENDIAN_PDP = 0
ENDIAN_MAX = 0
class PlatformInformation(object):
"""
PlatformInfo()
PlatformInfo(pid, tkMajor=-1, tkMinor=-1, id=OS_UNKNOWN, osMajor=-1, osMinor=-1, arch=ARCH_INVALID, endian=ENDIAN_INVALID)
This class holds information about the operating system, the toolkit
and the basic architecture of the machine where the application is
currently running.
"""
def __init__(self, *args, **kw):
"""
PlatformInfo()
PlatformInfo(pid, tkMajor=-1, tkMinor=-1, id=OS_UNKNOWN, osMajor=-1, osMinor=-1, arch=ARCH_INVALID, endian=ENDIAN_INVALID)
This class holds information about the operating system, the toolkit
and the basic architecture of the machine where the application is
currently running.
"""
@staticmethod
def GetArch(arch):
"""
GetArch(arch) -> Architecture
Converts the given string to a wxArchitecture enum value or to
wxARCH_INVALID if the given string is not a valid architecture string
(i.e.
"""
def GetEndianness(self, *args, **kw):
"""
GetEndianness() -> Endianness
Returns the endianness ID of this wxPlatformInfo instance.
"""
def GetOperatingSystemId(self, *args, **kw):
"""
GetOperatingSystemId() -> OperatingSystemId
Returns the operating system ID of this wxPlatformInfo instance.
"""
def GetPortId(self, *args, **kw):
"""
GetPortId() -> PortId
Returns the wxWidgets port ID associated with this wxPlatformInfo
instance.
"""
def GetArchName(self, *args, **kw):
"""
GetArchName() -> String
Returns the name for the architecture of this wxPlatformInfo instance.
"""
def GetEndiannessName(self, *args, **kw):
"""
GetEndiannessName() -> String
Returns the name for the endianness of this wxPlatformInfo instance.
"""
def GetOperatingSystemFamilyName(self, *args, **kw):
"""
GetOperatingSystemFamilyName() -> String
Returns the operating system family name of the OS associated with
this wxPlatformInfo instance.
"""
def GetOperatingSystemIdName(self, *args, **kw):
"""
GetOperatingSystemIdName() -> String
Returns the operating system name of the OS associated with this
wxPlatformInfo instance.
"""
def GetPortIdName(self, *args, **kw):
"""
GetPortIdName() -> String
Returns the name of the wxWidgets port ID associated with this
wxPlatformInfo instance.
"""
def GetPortIdShortName(self, *args, **kw):
"""
GetPortIdShortName() -> String
Returns the short name of the wxWidgets port ID associated with this
wxPlatformInfo instance.
"""
@staticmethod
def GetOperatingSystemDirectory():
"""
GetOperatingSystemDirectory() -> String
Returns the operating system directory.
"""
def GetArchitecture(self):
"""
GetArchitecture() -> Architecture
Returns the architecture ID of this wxPlatformInfo instance.
"""
def GetOSMajorVersion(self):
"""
GetOSMajorVersion() -> int
Returns the run-time major version of the OS associated with this
wxPlatformInfo instance.
"""
def GetOSMinorVersion(self):
"""
GetOSMinorVersion() -> int
Returns the run-time minor version of the OS associated with this
wxPlatformInfo instance.
"""
def GetOperatingSystemDescription(self):
"""
GetOperatingSystemDescription() -> String
Returns the description of the operating system of this wxPlatformInfo
instance.
"""
def GetLinuxDistributionInfo(self):
"""
GetLinuxDistributionInfo() -> LinuxDistributionInfo
Returns the Linux distribution info associated with this
wxPlatformInfo instance.
"""
def GetDesktopEnvironment(self):
"""
GetDesktopEnvironment() -> String
Returns the desktop environment associated with this wxPlatformInfo
instance.
"""
def GetToolkitMajorVersion(self):
"""
GetToolkitMajorVersion() -> int
Returns the run-time major version of the toolkit associated with this
wxPlatformInfo instance.
"""
def GetToolkitMinorVersion(self):
"""
GetToolkitMinorVersion() -> int
Returns the run-time minor version of the toolkit associated with this
wxPlatformInfo instance.
"""
def SetArchitecture(self, n):
"""
SetArchitecture(n)
Sets the architecture enum value associated with this wxPlatformInfo
instance.
"""
def SetEndianness(self, n):
"""
SetEndianness(n)
Sets the endianness enum value associated with this wxPlatformInfo
instance.
"""
def SetOSVersion(self, major, minor):
"""
SetOSVersion(major, minor)
Sets the version of the operating system associated with this
wxPlatformInfo instance.
"""
def SetOperatingSystemId(self, n):
"""
SetOperatingSystemId(n)
Sets the operating system associated with this wxPlatformInfo
instance.
"""
def SetPortId(self, n):
"""
SetPortId(n)
Sets the wxWidgets port ID associated with this wxPlatformInfo
instance.
"""
def SetToolkitVersion(self, major, minor):
"""
SetToolkitVersion(major, minor)
Sets the version of the toolkit associated with this wxPlatformInfo
instance.
"""
def SetOperatingSystemDescription(self, desc):
"""
SetOperatingSystemDescription(desc)
Sets the operating system description associated with this
wxPlatformInfo instance.
"""
def SetDesktopEnvironment(self, de):
"""
SetDesktopEnvironment(de)
Sets the desktop environment associated with this wxPlatformInfo
instance.
"""
def SetLinuxDistributionInfo(self, di):
"""
SetLinuxDistributionInfo(di)
Sets the linux distribution info associated with this wxPlatformInfo
instance.
"""
def CheckOSVersion(self, major, minor):
"""
CheckOSVersion(major, minor) -> bool
Returns true if the OS version is at least major.minor.
"""
def CheckToolkitVersion(self, major, minor):
"""
CheckToolkitVersion(major, minor) -> bool
Returns true if the toolkit version is at least major.minor.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if this instance is fully initialized with valid values.
"""
def IsUsingUniversalWidgets(self):
"""
IsUsingUniversalWidgets() -> bool
Returns true if this wxPlatformInfo describes wxUniversal build.
"""
def __ne__(self):
"""
"""
def __eq__(self):
"""
"""
@staticmethod
def Get():
"""
Get() -> PlatformInfo
Returns the global wxPlatformInfo object, initialized with the values
for the currently running platform.
"""
ArchName = property(None, None)
Architecture = property(None, None)
DesktopEnvironment = property(None, None)
Endianness = property(None, None)
EndiannessName = property(None, None)
LinuxDistributionInfo = property(None, None)
OSMajorVersion = property(None, None)
OSMinorVersion = property(None, None)
OperatingSystemDescription = property(None, None)
OperatingSystemFamilyName = property(None, None)
OperatingSystemId = property(None, None)
OperatingSystemIdName = property(None, None)
PortId = property(None, None)
PortIdName = property(None, None)
PortIdShortName = property(None, None)
ToolkitMajorVersion = property(None, None)
ToolkitMinorVersion = property(None, None)
# end of class PlatformInformation
class LinuxDistributionInfo(object):
"""
A structure containing information about a Linux distribution as
returned by the lsb_release utility.
"""
Id = property(None, None)
Release = property(None, None)
CodeName = property(None, None)
Description = property(None, None)
def __eq__(self):
"""
"""
def __ne__(self):
"""
"""
# end of class LinuxDistributionInfo
#-- end-platinfo --#
#-- begin-vidmode --#
class VideoMode(object):
"""
VideoMode(width=0, height=0, depth=0, freq=0)
Determines the sizes and locations of displays connected to the
system.
"""
def __init__(self, width=0, height=0, depth=0, freq=0):
"""
VideoMode(width=0, height=0, depth=0, freq=0)
Determines the sizes and locations of displays connected to the
system.
"""
w = property(None, None)
h = property(None, None)
bpp = property(None, None)
refresh = property(None, None)
def Matches(self, other):
"""
Matches(other) -> bool
Returns true if this mode matches the other one in the sense that all
non zero fields of the other mode have the same value in this one
(except for refresh which is allowed to have a greater value).
"""
def GetWidth(self):
"""
GetWidth() -> int
Returns the screen width in pixels (e.g. 640), 0 means unspecified.
"""
def GetHeight(self):
"""
GetHeight() -> int
Returns the screen height in pixels (e.g. 480), 0 means unspecified.
"""
def GetDepth(self):
"""
GetDepth() -> int
Returns bits per pixel (e.g. 32), 1 is monochrome and 0 means
unspecified/known.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the object has been initialized.
"""
def __eq__(self):
"""
"""
def __ne__(self):
"""
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
Depth = property(None, None)
Height = property(None, None)
Width = property(None, None)
# end of class VideoMode
DefaultVideoMode = VideoMode()
#-- end-vidmode --#
#-- begin-display --#
class Display(object):
"""
Display(index=0)
Determines the sizes and locations of displays connected to the
system.
"""
def __init__(self, index=0):
"""
Display(index=0)
Determines the sizes and locations of displays connected to the
system.
"""
def ChangeMode(self, mode=DefaultVideoMode):
"""
ChangeMode(mode=DefaultVideoMode) -> bool
Changes the video mode of this display to the mode specified in the
mode parameter.
"""
def GetClientArea(self):
"""
GetClientArea() -> Rect
Returns the client area of the display.
"""
def GetCurrentMode(self):
"""
GetCurrentMode() -> VideoMode
Returns the current video mode that this display is in.
"""
def GetGeometry(self):
"""
GetGeometry() -> Rect
Returns the bounding rectangle of the display whose index was passed
to the constructor.
"""
def GetModes(self, mode=DefaultVideoMode):
"""
GetModes(mode=DefaultVideoMode) -> ArrayVideoModes
Fills and returns an array with all the video modes that are supported
by this display, or video modes that are supported by this display and
match the mode parameter (if mode is not wxDefaultVideoMode).
"""
def GetName(self):
"""
GetName() -> String
Returns the display's name.
"""
def IsPrimary(self):
"""
IsPrimary() -> bool
Returns true if the display is the primary display.
"""
@staticmethod
def GetCount():
"""
GetCount() -> unsignedint
Returns the number of connected displays.
"""
@staticmethod
def GetFromPoint(pt):
"""
GetFromPoint(pt) -> int
Returns the index of the display on which the given point lies, or
wxNOT_FOUND if the point is not on any connected display.
"""
@staticmethod
def GetFromWindow(win):
"""
GetFromWindow(win) -> int
Returns the index of the display on which the given window lies.
"""
ClientArea = property(None, None)
CurrentMode = property(None, None)
Geometry = property(None, None)
Name = property(None, None)
# end of class Display
#-- end-display --#
#-- begin-intl --#
LANGUAGE_DEFAULT = 0
LANGUAGE_UNKNOWN = 0
LANGUAGE_ABKHAZIAN = 0
LANGUAGE_AFAR = 0
LANGUAGE_AFRIKAANS = 0
LANGUAGE_ALBANIAN = 0
LANGUAGE_AMHARIC = 0
LANGUAGE_ARABIC = 0
LANGUAGE_ARABIC_ALGERIA = 0
LANGUAGE_ARABIC_BAHRAIN = 0
LANGUAGE_ARABIC_EGYPT = 0
LANGUAGE_ARABIC_IRAQ = 0
LANGUAGE_ARABIC_JORDAN = 0
LANGUAGE_ARABIC_KUWAIT = 0
LANGUAGE_ARABIC_LEBANON = 0
LANGUAGE_ARABIC_LIBYA = 0
LANGUAGE_ARABIC_MOROCCO = 0
LANGUAGE_ARABIC_OMAN = 0
LANGUAGE_ARABIC_QATAR = 0
LANGUAGE_ARABIC_SAUDI_ARABIA = 0
LANGUAGE_ARABIC_SUDAN = 0
LANGUAGE_ARABIC_SYRIA = 0
LANGUAGE_ARABIC_TUNISIA = 0
LANGUAGE_ARABIC_UAE = 0
LANGUAGE_ARABIC_YEMEN = 0
LANGUAGE_ARMENIAN = 0
LANGUAGE_ASSAMESE = 0
LANGUAGE_ASTURIAN = 0
LANGUAGE_AYMARA = 0
LANGUAGE_AZERI = 0
LANGUAGE_AZERI_CYRILLIC = 0
LANGUAGE_AZERI_LATIN = 0
LANGUAGE_BASHKIR = 0
LANGUAGE_BASQUE = 0
LANGUAGE_BELARUSIAN = 0
LANGUAGE_BENGALI = 0
LANGUAGE_BHUTANI = 0
LANGUAGE_BIHARI = 0
LANGUAGE_BISLAMA = 0
LANGUAGE_BOSNIAN = 0
LANGUAGE_BRETON = 0
LANGUAGE_BULGARIAN = 0
LANGUAGE_BURMESE = 0
LANGUAGE_CAMBODIAN = 0
LANGUAGE_CATALAN = 0
LANGUAGE_CHINESE = 0
LANGUAGE_CHINESE_SIMPLIFIED = 0
LANGUAGE_CHINESE_TRADITIONAL = 0
LANGUAGE_CHINESE_HONGKONG = 0
LANGUAGE_CHINESE_MACAU = 0
LANGUAGE_CHINESE_SINGAPORE = 0
LANGUAGE_CHINESE_TAIWAN = 0
LANGUAGE_CORSICAN = 0
LANGUAGE_CROATIAN = 0
LANGUAGE_CZECH = 0
LANGUAGE_DANISH = 0
LANGUAGE_DUTCH = 0
LANGUAGE_DUTCH_BELGIAN = 0
LANGUAGE_ENGLISH = 0
LANGUAGE_ENGLISH_UK = 0
LANGUAGE_ENGLISH_US = 0
LANGUAGE_ENGLISH_AUSTRALIA = 0
LANGUAGE_ENGLISH_BELIZE = 0
LANGUAGE_ENGLISH_BOTSWANA = 0
LANGUAGE_ENGLISH_CANADA = 0
LANGUAGE_ENGLISH_CARIBBEAN = 0
LANGUAGE_ENGLISH_DENMARK = 0
LANGUAGE_ENGLISH_EIRE = 0
LANGUAGE_ENGLISH_JAMAICA = 0
LANGUAGE_ENGLISH_NEW_ZEALAND = 0
LANGUAGE_ENGLISH_PHILIPPINES = 0
LANGUAGE_ENGLISH_SOUTH_AFRICA = 0
LANGUAGE_ENGLISH_TRINIDAD = 0
LANGUAGE_ENGLISH_ZIMBABWE = 0
LANGUAGE_ESPERANTO = 0
LANGUAGE_ESTONIAN = 0
LANGUAGE_FAEROESE = 0
LANGUAGE_FARSI = 0
LANGUAGE_FIJI = 0
LANGUAGE_FINNISH = 0
LANGUAGE_FRENCH = 0
LANGUAGE_FRENCH_BELGIAN = 0
LANGUAGE_FRENCH_CANADIAN = 0
LANGUAGE_FRENCH_LUXEMBOURG = 0
LANGUAGE_FRENCH_MONACO = 0
LANGUAGE_FRENCH_SWISS = 0
LANGUAGE_FRISIAN = 0
LANGUAGE_GALICIAN = 0
LANGUAGE_GEORGIAN = 0
LANGUAGE_GERMAN = 0
LANGUAGE_GERMAN_AUSTRIAN = 0
LANGUAGE_GERMAN_BELGIUM = 0
LANGUAGE_GERMAN_LIECHTENSTEIN = 0
LANGUAGE_GERMAN_LUXEMBOURG = 0
LANGUAGE_GERMAN_SWISS = 0
LANGUAGE_GREEK = 0
LANGUAGE_GREENLANDIC = 0
LANGUAGE_GUARANI = 0
LANGUAGE_GUJARATI = 0
LANGUAGE_HAUSA = 0
LANGUAGE_HEBREW = 0
LANGUAGE_HINDI = 0
LANGUAGE_HUNGARIAN = 0
LANGUAGE_ICELANDIC = 0
LANGUAGE_INDONESIAN = 0
LANGUAGE_INTERLINGUA = 0
LANGUAGE_INTERLINGUE = 0
LANGUAGE_INUKTITUT = 0
LANGUAGE_INUPIAK = 0
LANGUAGE_IRISH = 0
LANGUAGE_ITALIAN = 0
LANGUAGE_ITALIAN_SWISS = 0
LANGUAGE_JAPANESE = 0
LANGUAGE_JAVANESE = 0
LANGUAGE_KANNADA = 0
LANGUAGE_KASHMIRI = 0
LANGUAGE_KASHMIRI_INDIA = 0
LANGUAGE_KAZAKH = 0
LANGUAGE_KERNEWEK = 0
LANGUAGE_KINYARWANDA = 0
LANGUAGE_KIRGHIZ = 0
LANGUAGE_KIRUNDI = 0
LANGUAGE_KONKANI = 0
LANGUAGE_KOREAN = 0
LANGUAGE_KURDISH = 0
LANGUAGE_LAOTHIAN = 0
LANGUAGE_LATIN = 0
LANGUAGE_LATVIAN = 0
LANGUAGE_LINGALA = 0
LANGUAGE_LITHUANIAN = 0
LANGUAGE_MACEDONIAN = 0
LANGUAGE_MALAGASY = 0
LANGUAGE_MALAY = 0
LANGUAGE_MALAYALAM = 0
LANGUAGE_MALAY_BRUNEI_DARUSSALAM = 0
LANGUAGE_MALAY_MALAYSIA = 0
LANGUAGE_MALTESE = 0
LANGUAGE_MANIPURI = 0
LANGUAGE_MAORI = 0
LANGUAGE_MARATHI = 0
LANGUAGE_MOLDAVIAN = 0
LANGUAGE_MONGOLIAN = 0
LANGUAGE_NAURU = 0
LANGUAGE_NEPALI = 0
LANGUAGE_NEPALI_INDIA = 0
LANGUAGE_NORWEGIAN_BOKMAL = 0
LANGUAGE_NORWEGIAN_NYNORSK = 0
LANGUAGE_OCCITAN = 0
LANGUAGE_ORIYA = 0
LANGUAGE_OROMO = 0
LANGUAGE_PASHTO = 0
LANGUAGE_POLISH = 0
LANGUAGE_PORTUGUESE = 0
LANGUAGE_PORTUGUESE_BRAZILIAN = 0
LANGUAGE_PUNJABI = 0
LANGUAGE_QUECHUA = 0
LANGUAGE_RHAETO_ROMANCE = 0
LANGUAGE_ROMANIAN = 0
LANGUAGE_RUSSIAN = 0
LANGUAGE_RUSSIAN_UKRAINE = 0
LANGUAGE_SAMI = 0
LANGUAGE_SAMOAN = 0
LANGUAGE_SANGHO = 0
LANGUAGE_SANSKRIT = 0
LANGUAGE_SCOTS_GAELIC = 0
LANGUAGE_SERBIAN = 0
LANGUAGE_SERBIAN_CYRILLIC = 0
LANGUAGE_SERBIAN_LATIN = 0
LANGUAGE_SERBO_CROATIAN = 0
LANGUAGE_SESOTHO = 0
LANGUAGE_SETSWANA = 0
LANGUAGE_SHONA = 0
LANGUAGE_SINDHI = 0
LANGUAGE_SINHALESE = 0
LANGUAGE_SISWATI = 0
LANGUAGE_SLOVAK = 0
LANGUAGE_SLOVENIAN = 0
LANGUAGE_SOMALI = 0
LANGUAGE_SPANISH = 0
LANGUAGE_SPANISH_ARGENTINA = 0
LANGUAGE_SPANISH_BOLIVIA = 0
LANGUAGE_SPANISH_CHILE = 0
LANGUAGE_SPANISH_COLOMBIA = 0
LANGUAGE_SPANISH_COSTA_RICA = 0
LANGUAGE_SPANISH_DOMINICAN_REPUBLIC = 0
LANGUAGE_SPANISH_ECUADOR = 0
LANGUAGE_SPANISH_EL_SALVADOR = 0
LANGUAGE_SPANISH_GUATEMALA = 0
LANGUAGE_SPANISH_HONDURAS = 0
LANGUAGE_SPANISH_MEXICAN = 0
LANGUAGE_SPANISH_MODERN = 0
LANGUAGE_SPANISH_NICARAGUA = 0
LANGUAGE_SPANISH_PANAMA = 0
LANGUAGE_SPANISH_PARAGUAY = 0
LANGUAGE_SPANISH_PERU = 0
LANGUAGE_SPANISH_PUERTO_RICO = 0
LANGUAGE_SPANISH_URUGUAY = 0
LANGUAGE_SPANISH_US = 0
LANGUAGE_SPANISH_VENEZUELA = 0
LANGUAGE_SUNDANESE = 0
LANGUAGE_SWAHILI = 0
LANGUAGE_SWEDISH = 0
LANGUAGE_SWEDISH_FINLAND = 0
LANGUAGE_TAGALOG = 0
LANGUAGE_TAJIK = 0
LANGUAGE_TAMIL = 0
LANGUAGE_TATAR = 0
LANGUAGE_TELUGU = 0
LANGUAGE_THAI = 0
LANGUAGE_TIBETAN = 0
LANGUAGE_TIGRINYA = 0
LANGUAGE_TONGA = 0
LANGUAGE_TSONGA = 0
LANGUAGE_TURKISH = 0
LANGUAGE_TURKMEN = 0
LANGUAGE_TWI = 0
LANGUAGE_UIGHUR = 0
LANGUAGE_UKRAINIAN = 0
LANGUAGE_URDU = 0
LANGUAGE_URDU_INDIA = 0
LANGUAGE_URDU_PAKISTAN = 0
LANGUAGE_UZBEK = 0
LANGUAGE_UZBEK_CYRILLIC = 0
LANGUAGE_UZBEK_LATIN = 0
LANGUAGE_VALENCIAN = 0
LANGUAGE_VIETNAMESE = 0
LANGUAGE_VOLAPUK = 0
LANGUAGE_WELSH = 0
LANGUAGE_WOLOF = 0
LANGUAGE_XHOSA = 0
LANGUAGE_YIDDISH = 0
LANGUAGE_YORUBA = 0
LANGUAGE_ZHUANG = 0
LANGUAGE_ZULU = 0
LANGUAGE_KABYLE = 0
LANGUAGE_USER_DEFINED = 0
Layout_Default = 0
Layout_LeftToRight = 0
Layout_RightToLeft = 0
LOCALE_CAT_NUMBER = 0
LOCALE_CAT_DATE = 0
LOCALE_CAT_MONEY = 0
LOCALE_CAT_DEFAULT = 0
LOCALE_THOUSANDS_SEP = 0
LOCALE_DECIMAL_POINT = 0
LOCALE_SHORT_DATE_FMT = 0
LOCALE_LONG_DATE_FMT = 0
LOCALE_DATE_TIME_FMT = 0
LOCALE_TIME_FMT = 0
class LanguageInfo(object):
"""
Encapsulates a wxLanguage identifier together with OS-specific
information related to that language.
"""
Language = property(None, None)
CanonicalName = property(None, None)
Description = property(None, None)
LayoutDirection = property(None, None)
def GetLocaleName(self):
"""
GetLocaleName() -> String
Return the locale name corresponding to this language usable with
setlocale() on the current system.
"""
LocaleName = property(None, None)
# end of class LanguageInfo
class Locale(object):
"""
Locale()
Locale(language, flags=LOCALE_LOAD_DEFAULT)
Locale(name, shortName=EmptyString, locale=EmptyString, bLoadDefault=True)
wxLocale class encapsulates all language-dependent settings and is a
generalization of the C locale concept.
"""
def __init__(self, *args, **kw):
"""
Locale()
Locale(language, flags=LOCALE_LOAD_DEFAULT)
Locale(name, shortName=EmptyString, locale=EmptyString, bLoadDefault=True)
wxLocale class encapsulates all language-dependent settings and is a
generalization of the C locale concept.
"""
def AddCatalog(self, *args, **kw):
"""
AddCatalog(domain) -> bool
AddCatalog(domain, msgIdLanguage) -> bool
AddCatalog(domain, msgIdLanguage, msgIdCharset) -> bool
Calls wxTranslations::AddCatalog(const wxString&).
"""
def GetCanonicalName(self):
"""
GetCanonicalName() -> String
Returns the canonical form of current locale name.
"""
def GetHeaderValue(self, header, domain=EmptyString):
"""
GetHeaderValue(header, domain=EmptyString) -> String
Calls wxTranslations::GetHeaderValue().
"""
def GetLanguage(self):
"""
GetLanguage() -> int
Returns the wxLanguage constant of current language.
"""
def GetLocale(self):
"""
GetLocale() -> String
Returns the locale name as passed to the constructor or Init().
"""
def GetName(self):
"""
GetName() -> String
Returns the current short name for the locale (as given to the
constructor or the Init() function).
"""
def GetString(self, *args, **kw):
"""
GetString(origString, domain=EmptyString) -> String
GetString(origString, origString2, n, domain=EmptyString) -> String
Calls wxGetTranslation(const wxString&, const wxString&).
"""
def GetSysName(self):
"""
GetSysName() -> String
Returns current platform-specific locale name as passed to
setlocale().
"""
def Init(self, *args, **kw):
"""
Init(language=LANGUAGE_DEFAULT, flags=LOCALE_LOAD_DEFAULT) -> bool
Init(name, shortName=EmptyString, locale=EmptyString, bLoadDefault=True) -> bool
Initializes the wxLocale instance.
"""
def IsLoaded(self, domain):
"""
IsLoaded(domain) -> bool
Calls wxTranslations::IsLoaded().
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the locale could be set successfully.
"""
@staticmethod
def AddCatalogLookupPathPrefix(prefix):
"""
AddCatalogLookupPathPrefix(prefix)
Calls wxFileTranslationsLoader::AddCatalogLookupPathPrefix().
"""
@staticmethod
def AddLanguage(info):
"""
AddLanguage(info)
Adds custom, user-defined language to the database of known languages.
"""
@staticmethod
def FindLanguageInfo(locale):
"""
FindLanguageInfo(locale) -> LanguageInfo
This function may be used to find the language description structure
for the given locale, specified either as a two letter ISO language
code (for example, "pt"), a language code followed by the country code
("pt_BR") or a full, human readable, language description
("Portuguese-Brazil").
"""
@staticmethod
def GetLanguageInfo(lang):
"""
GetLanguageInfo(lang) -> LanguageInfo
Returns a pointer to wxLanguageInfo structure containing information
about the given language or NULL if this language is unknown.
"""
@staticmethod
def GetLanguageName(lang):
"""
GetLanguageName(lang) -> String
Returns English name of the given language or empty string if this
language is unknown.
"""
@staticmethod
def GetLanguageCanonicalName(lang):
"""
GetLanguageCanonicalName(lang) -> String
Returns canonical name (see GetCanonicalName()) of the given language
or empty string if this language is unknown.
"""
@staticmethod
def GetSystemEncoding():
"""
GetSystemEncoding() -> FontEncoding
Tries to detect the user's default font encoding.
"""
@staticmethod
def GetSystemEncodingName():
"""
GetSystemEncodingName() -> String
Tries to detect the name of the user's default font encoding.
"""
@staticmethod
def GetSystemLanguage():
"""
GetSystemLanguage() -> int
Tries to detect the user's default locale setting.
"""
@staticmethod
def GetInfo(index, cat=LOCALE_CAT_DEFAULT):
"""
GetInfo(index, cat=LOCALE_CAT_DEFAULT) -> String
Get the values of the given locale-dependent datum.
"""
@staticmethod
def IsAvailable(lang):
"""
IsAvailable(lang) -> bool
Check whether the operating system and/or C run time environment
supports this locale.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
CanonicalName = property(None, None)
Language = property(None, None)
Locale = property(None, None)
Name = property(None, None)
SysName = property(None, None)
# end of class Locale
#----------------------------------------------------------------------------
# Add the directory where the wxWidgets catalogs were installed
# to the default catalog path, if they were put in the pacakge dir.
import os
_localedir = os.path.join(os.path.dirname(__file__), "locale")
if os.path.exists(_localedir):
Locale.AddCatalogLookupPathPrefix(_localedir)
del os
#----------------------------------------------------------------------------
#-- end-intl --#
#-- begin-translation --#
class Translations(object):
"""
Translations()
This class allows to get translations for strings.
"""
def __init__(self):
"""
Translations()
This class allows to get translations for strings.
"""
def SetLoader(self, loader):
"""
SetLoader(loader)
Changes loader use to read catalogs to a non-default one.
"""
def SetLanguage(self, *args, **kw):
"""
SetLanguage(lang)
SetLanguage(lang)
Sets translations language to use.
"""
def GetAvailableTranslations(self, domain):
"""
GetAvailableTranslations(domain) -> ArrayString
Returns list of all translations of domain that were found.
"""
def GetBestTranslation(self, *args, **kw):
"""
GetBestTranslation(domain, msgIdLanguage) -> String
GetBestTranslation(domain, msgIdLanguage="en") -> String
Returns the best UI language for the domain.
"""
def AddStdCatalog(self):
"""
AddStdCatalog() -> bool
Add standard wxWidgets catalogs ("wxstd" and possible port-specific
catalogs).
"""
def AddCatalog(self, *args, **kw):
"""
AddCatalog(domain) -> bool
AddCatalog(domain, msgIdLanguage) -> bool
Add a catalog for use with the current locale.
"""
def IsLoaded(self, domain):
"""
IsLoaded(domain) -> bool
Check if the given catalog is loaded, and returns true if it is.
"""
def GetTranslatedString(self, *args, **kw):
"""
GetTranslatedString(origString, domain=EmptyString) -> String
GetTranslatedString(origString, n, domain=EmptyString) -> String
Retrieves the translation for a string in all loaded domains unless
the domain parameter is specified (and then only this catalog/domain
is searched).
"""
def GetHeaderValue(self, header, domain=EmptyString):
"""
GetHeaderValue(header, domain=EmptyString) -> String
Returns the header value for header header.
"""
@staticmethod
def Get():
"""
Get() -> Translations
Returns current translations object, may return NULL.
"""
@staticmethod
def Set(t):
"""
Set(t)
Sets current translations object.
"""
# end of class Translations
class TranslationsLoader(object):
"""
TranslationsLoader()
Abstraction of translations discovery and loading.
"""
def __init__(self):
"""
TranslationsLoader()
Abstraction of translations discovery and loading.
"""
def LoadCatalog(self, domain, lang):
"""
LoadCatalog(domain, lang) -> MsgCatalog
Called to load requested catalog.
"""
def GetAvailableTranslations(self, domain):
"""
GetAvailableTranslations(domain) -> ArrayString
Implements wxTranslations::GetAvailableTranslations().
"""
# end of class TranslationsLoader
class FileTranslationsLoader(TranslationsLoader):
"""
Standard wxTranslationsLoader implementation.
"""
@staticmethod
def AddCatalogLookupPathPrefix(prefix):
"""
AddCatalogLookupPathPrefix(prefix)
Add a prefix to the catalog lookup path: the message catalog files
will be looked up under prefix/lang/LC_MESSAGES and prefix/lang
directories (in this order).
"""
# end of class FileTranslationsLoader
def GetTranslation(*args, **kw):
"""
GetTranslation(string, domain=EmptyString) -> String
GetTranslation(string, plural, n, domain=EmptyString) -> String
This function returns the translation of string in the current
locale().
"""
#-- end-translation --#
#-- begin-cmndata --#
PRINTBIN_DEFAULT = 0
PRINTBIN_ONLYONE = 0
PRINTBIN_LOWER = 0
PRINTBIN_MIDDLE = 0
PRINTBIN_MANUAL = 0
PRINTBIN_ENVELOPE = 0
PRINTBIN_ENVMANUAL = 0
PRINTBIN_AUTO = 0
PRINTBIN_TRACTOR = 0
PRINTBIN_SMALLFMT = 0
PRINTBIN_LARGEFMT = 0
PRINTBIN_LARGECAPACITY = 0
PRINTBIN_CASSETTE = 0
PRINTBIN_FORMSOURCE = 0
PRINTBIN_USER = 0
class PageSetupDialogData(Object):
"""
PageSetupDialogData()
PageSetupDialogData(data)
PageSetupDialogData(printData)
This class holds a variety of information related to
wxPageSetupDialog.
"""
def __init__(self, *args, **kw):
"""
PageSetupDialogData()
PageSetupDialogData(data)
PageSetupDialogData(printData)
This class holds a variety of information related to
wxPageSetupDialog.
"""
def EnableHelp(self, flag):
"""
EnableHelp(flag)
Enables or disables the "Help" button (Windows only).
"""
def EnableMargins(self, flag):
"""
EnableMargins(flag)
Enables or disables the margin controls (Windows only).
"""
def EnableOrientation(self, flag):
"""
EnableOrientation(flag)
Enables or disables the orientation control (Windows only).
"""
def EnablePaper(self, flag):
"""
EnablePaper(flag)
Enables or disables the paper size control (Windows only).
"""
def EnablePrinter(self, flag):
"""
EnablePrinter(flag)
Enables or disables the "Printer" button, which invokes a printer
setup dialog.
"""
def GetDefaultInfo(self):
"""
GetDefaultInfo() -> bool
Returns true if the dialog will simply return default printer
information (such as orientation) instead of showing a dialog (Windows
only).
"""
def GetDefaultMinMargins(self):
"""
GetDefaultMinMargins() -> bool
Returns true if the page setup dialog will take its minimum margin
values from the currently selected printer properties (Windows only).
"""
def GetEnableHelp(self):
"""
GetEnableHelp() -> bool
Returns true if the printer setup button is enabled.
"""
def GetEnableMargins(self):
"""
GetEnableMargins() -> bool
Returns true if the margin controls are enabled (Windows only).
"""
def GetEnableOrientation(self):
"""
GetEnableOrientation() -> bool
Returns true if the orientation control is enabled (Windows only).
"""
def GetEnablePaper(self):
"""
GetEnablePaper() -> bool
Returns true if the paper size control is enabled (Windows only).
"""
def GetEnablePrinter(self):
"""
GetEnablePrinter() -> bool
Returns true if the printer setup button is enabled.
"""
def GetMarginBottomRight(self):
"""
GetMarginBottomRight() -> Point
Returns the right (x) and bottom (y) margins in millimetres.
"""
def GetMarginTopLeft(self):
"""
GetMarginTopLeft() -> Point
Returns the left (x) and top (y) margins in millimetres.
"""
def GetMinMarginBottomRight(self):
"""
GetMinMarginBottomRight() -> Point
Returns the right (x) and bottom (y) minimum margins the user can
enter (Windows only).
"""
def GetMinMarginTopLeft(self):
"""
GetMinMarginTopLeft() -> Point
Returns the left (x) and top (y) minimum margins the user can enter
(Windows only).
"""
def GetPaperId(self):
"""
GetPaperId() -> PaperSize
Returns the paper id (stored in the internal wxPrintData object).
"""
def GetPaperSize(self):
"""
GetPaperSize() -> Size
Returns the paper size in millimetres.
"""
def GetPrintData(self):
"""
GetPrintData() -> PrintData
Returns a reference to the print data associated with this object.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the print data associated with the dialog data is
valid.
"""
def SetDefaultInfo(self, flag):
"""
SetDefaultInfo(flag)
Pass true if the dialog will simply return default printer information
(such as orientation) instead of showing a dialog (Windows only).
"""
def SetDefaultMinMargins(self, flag):
"""
SetDefaultMinMargins(flag)
Pass true if the page setup dialog will take its minimum margin values
from the currently selected printer properties (Windows only).
"""
def SetMarginBottomRight(self, pt):
"""
SetMarginBottomRight(pt)
Sets the right (x) and bottom (y) margins in millimetres.
"""
def SetMarginTopLeft(self, pt):
"""
SetMarginTopLeft(pt)
Sets the left (x) and top (y) margins in millimetres.
"""
def SetMinMarginBottomRight(self, pt):
"""
SetMinMarginBottomRight(pt)
Sets the right (x) and bottom (y) minimum margins the user can enter
(Windows only).
"""
def SetMinMarginTopLeft(self, pt):
"""
SetMinMarginTopLeft(pt)
Sets the left (x) and top (y) minimum margins the user can enter
(Windows only).
"""
def SetPaperId(self, id):
"""
SetPaperId(id)
Sets the paper size id.
"""
def SetPaperSize(self, size):
"""
SetPaperSize(size)
Sets the paper size in millimetres.
"""
def SetPrintData(self, printData):
"""
SetPrintData(printData)
Sets the print data associated with this object.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
MarginBottomRight = property(None, None)
MarginTopLeft = property(None, None)
MinMarginBottomRight = property(None, None)
MinMarginTopLeft = property(None, None)
PaperId = property(None, None)
PaperSize = property(None, None)
PrintData = property(None, None)
# end of class PageSetupDialogData
class PrintData(Object):
"""
PrintData()
PrintData(data)
This class holds a variety of information related to printers and
printer device contexts.
"""
def __init__(self, *args, **kw):
"""
PrintData()
PrintData(data)
This class holds a variety of information related to printers and
printer device contexts.
"""
def GetBin(self):
"""
GetBin() -> PrintBin
Returns the current bin (papersource).
"""
def GetCollate(self):
"""
GetCollate() -> bool
Returns true if collation is on.
"""
def GetColour(self):
"""
GetColour() -> bool
Returns true if colour printing is on.
"""
def GetDuplex(self):
"""
GetDuplex() -> DuplexMode
Returns the duplex mode.
"""
def GetNoCopies(self):
"""
GetNoCopies() -> int
Returns the number of copies requested by the user.
"""
def GetOrientation(self):
"""
GetOrientation() -> PrintOrientation
Gets the orientation.
"""
def GetPaperId(self):
"""
GetPaperId() -> PaperSize
Returns the paper size id.
"""
def GetPrinterName(self):
"""
GetPrinterName() -> String
Returns the printer name.
"""
def GetQuality(self):
"""
GetQuality() -> PrintQuality
Returns the current print quality.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the print data is valid for using in print dialogs.
"""
def SetBin(self, flag):
"""
SetBin(flag)
Sets the current bin.
"""
def SetCollate(self, flag):
"""
SetCollate(flag)
Sets collation to on or off.
"""
def SetColour(self, flag):
"""
SetColour(flag)
Sets colour printing on or off.
"""
def SetDuplex(self, mode):
"""
SetDuplex(mode)
Returns the duplex mode.
"""
def SetNoCopies(self, n):
"""
SetNoCopies(n)
Sets the default number of copies to be printed out.
"""
def SetOrientation(self, orientation):
"""
SetOrientation(orientation)
Sets the orientation.
"""
def SetPaperId(self, paperId):
"""
SetPaperId(paperId)
Sets the paper id.
"""
def SetPrinterName(self, printerName):
"""
SetPrinterName(printerName)
Sets the printer name.
"""
def SetQuality(self, quality):
"""
SetQuality(quality)
Sets the desired print quality.
"""
def GetFilename(self):
"""
GetFilename() -> String
"""
def SetFilename(self, filename):
"""
SetFilename(filename)
"""
def GetPrintMode(self):
"""
GetPrintMode() -> PrintMode
"""
def SetPrintMode(self, printMode):
"""
SetPrintMode(printMode)
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def GetPrivData(self):
"""
GetPrivData() -> PyObject
"""
def SetPrivData(self, data):
"""
SetPrivData(data)
"""
Bin = property(None, None)
Collate = property(None, None)
Colour = property(None, None)
Duplex = property(None, None)
Filename = property(None, None)
NoCopies = property(None, None)
Orientation = property(None, None)
PaperId = property(None, None)
PrintMode = property(None, None)
PrinterName = property(None, None)
PrivData = property(None, None)
Quality = property(None, None)
# end of class PrintData
class PrintDialogData(Object):
"""
PrintDialogData()
PrintDialogData(dialogData)
PrintDialogData(printData)
This class holds information related to the visual characteristics of
wxPrintDialog.
"""
def __init__(self, *args, **kw):
"""
PrintDialogData()
PrintDialogData(dialogData)
PrintDialogData(printData)
This class holds information related to the visual characteristics of
wxPrintDialog.
"""
def EnableHelp(self, flag):
"""
EnableHelp(flag)
Enables or disables the "Help" button.
"""
def EnablePageNumbers(self, flag):
"""
EnablePageNumbers(flag)
Enables or disables the "Page numbers" controls.
"""
def EnablePrintToFile(self, flag):
"""
EnablePrintToFile(flag)
Enables or disables the "Print to file" checkbox.
"""
def EnableSelection(self, flag):
"""
EnableSelection(flag)
Enables or disables the "Selection" radio button.
"""
def GetAllPages(self):
"""
GetAllPages() -> bool
Returns true if the user requested that all pages be printed.
"""
def GetCollate(self):
"""
GetCollate() -> bool
Returns true if the user requested that the document(s) be collated.
"""
def GetFromPage(self):
"""
GetFromPage() -> int
Returns the from page number, as entered by the user.
"""
def GetMaxPage(self):
"""
GetMaxPage() -> int
Returns the maximum page number.
"""
def GetMinPage(self):
"""
GetMinPage() -> int
Returns the minimum page number.
"""
def GetNoCopies(self):
"""
GetNoCopies() -> int
Returns the number of copies requested by the user.
"""
def GetPrintData(self):
"""
GetPrintData() -> PrintData
Returns a reference to the internal wxPrintData object.
"""
def GetPrintToFile(self):
"""
GetPrintToFile() -> bool
Returns true if the user has selected printing to a file.
"""
def GetSelection(self):
"""
GetSelection() -> bool
Returns true if the user requested that the selection be printed
(where "selection" is a concept specific to the application).
"""
def GetToPage(self):
"""
GetToPage() -> int
Returns the "print to" page number, as entered by the user.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the print data is valid for using in print dialogs.
"""
def SetCollate(self, flag):
"""
SetCollate(flag)
Sets the "Collate" checkbox to true or false.
"""
def SetFromPage(self, page):
"""
SetFromPage(page)
Sets the from page number.
"""
def SetMaxPage(self, page):
"""
SetMaxPage(page)
Sets the maximum page number.
"""
def SetMinPage(self, page):
"""
SetMinPage(page)
Sets the minimum page number.
"""
def SetNoCopies(self, n):
"""
SetNoCopies(n)
Sets the default number of copies the user has requested to be printed
out.
"""
def SetPrintData(self, printData):
"""
SetPrintData(printData)
Sets the internal wxPrintData.
"""
def SetPrintToFile(self, flag):
"""
SetPrintToFile(flag)
Sets the "Print to file" checkbox to true or false.
"""
def SetSelection(self, flag):
"""
SetSelection(flag)
Selects the "Selection" radio button.
"""
def SetToPage(self, page):
"""
SetToPage(page)
Sets the "print to" page number.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
AllPages = property(None, None)
Collate = property(None, None)
FromPage = property(None, None)
MaxPage = property(None, None)
MinPage = property(None, None)
NoCopies = property(None, None)
PrintData = property(None, None)
PrintToFile = property(None, None)
Selection = property(None, None)
ToPage = property(None, None)
# end of class PrintDialogData
#-- end-cmndata --#
#-- begin-gdicmn --#
BITMAP_TYPE_INVALID = 0
BITMAP_TYPE_BMP = 0
BITMAP_TYPE_ICO = 0
BITMAP_TYPE_CUR = 0
BITMAP_TYPE_XBM = 0
BITMAP_TYPE_XBM_DATA = 0
BITMAP_TYPE_XPM = 0
BITMAP_TYPE_XPM_DATA = 0
BITMAP_TYPE_TIFF = 0
BITMAP_TYPE_TIF = 0
BITMAP_TYPE_GIF = 0
BITMAP_TYPE_PNG = 0
BITMAP_TYPE_JPEG = 0
BITMAP_TYPE_PNM = 0
BITMAP_TYPE_PCX = 0
BITMAP_TYPE_PICT = 0
BITMAP_TYPE_ICON = 0
BITMAP_TYPE_ANI = 0
BITMAP_TYPE_IFF = 0
BITMAP_TYPE_TGA = 0
BITMAP_TYPE_MACCURSOR = 0
BITMAP_TYPE_ANY = 0
ODDEVEN_RULE = 0
WINDING_RULE = 0
CURSOR_NONE = 0
CURSOR_ARROW = 0
CURSOR_RIGHT_ARROW = 0
CURSOR_BULLSEYE = 0
CURSOR_CHAR = 0
CURSOR_CROSS = 0
CURSOR_HAND = 0
CURSOR_IBEAM = 0
CURSOR_LEFT_BUTTON = 0
CURSOR_MAGNIFIER = 0
CURSOR_MIDDLE_BUTTON = 0
CURSOR_NO_ENTRY = 0
CURSOR_PAINT_BRUSH = 0
CURSOR_PENCIL = 0
CURSOR_POINT_LEFT = 0
CURSOR_POINT_RIGHT = 0
CURSOR_QUESTION_ARROW = 0
CURSOR_RIGHT_BUTTON = 0
CURSOR_SIZENESW = 0
CURSOR_SIZENS = 0
CURSOR_SIZENWSE = 0
CURSOR_SIZEWE = 0
CURSOR_SIZING = 0
CURSOR_SPRAYCAN = 0
CURSOR_WAIT = 0
CURSOR_WATCH = 0
CURSOR_BLANK = 0
CURSOR_DEFAULT = 0
CURSOR_COPY_ARROW = 0
CURSOR_ARROWWAIT = 0
CURSOR_MAX = 0
class Point(object):
"""
Point()
Point(x, y)
Point(pt)
A wxPoint is a useful data structure for graphics operations.
"""
def __init__(self, *args, **kw):
"""
Point()
Point(x, y)
Point(pt)
A wxPoint is a useful data structure for graphics operations.
"""
def __iadd__(self, *args, **kw):
"""
"""
def __isub__(self, *args, **kw):
"""
"""
def IsFullySpecified(self):
"""
IsFullySpecified() -> bool
Returns true if neither of the point components is equal to
wxDefaultCoord.
"""
def SetDefaults(self, pt):
"""
SetDefaults(pt)
Combine this object with another one replacing the uninitialized
values.
"""
x = property(None, None)
y = property(None, None)
def __eq__(self, other):
"""
__eq__(other) -> bool
"""
def __ne__(self, other):
"""
__ne__(other) -> bool
"""
def Get(self):
"""
Get() -> (x,y)
Return the x and y properties as a tuple.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
# end of class Point
class Size(object):
"""
Size()
Size(width, height)
A wxSize is a useful data structure for graphics operations.
"""
def __init__(self, *args, **kw):
"""
Size()
Size(width, height)
A wxSize is a useful data structure for graphics operations.
"""
def DecBy(self, *args, **kw):
"""
DecBy(pt)
DecBy(size)
DecBy(dx, dy)
DecBy(d)
Decreases the size in both x and y directions.
"""
def IncBy(self, *args, **kw):
"""
IncBy(pt)
IncBy(size)
IncBy(dx, dy)
IncBy(d)
Increases the size in both x and y directions.
"""
def __iadd__(self):
"""
"""
def __isub__(self):
"""
"""
def __idiv__(self):
"""
"""
def __imul__(self):
"""
"""
def DecTo(self, size):
"""
DecTo(size)
Decrements this object so that both of its dimensions are not greater
than the corresponding dimensions of the size.
"""
def DecToIfSpecified(self, size):
"""
DecToIfSpecified(size)
Decrements this object to be not bigger than the given size ignoring
non-specified components.
"""
def GetHeight(self):
"""
GetHeight() -> int
Gets the height member.
"""
def GetWidth(self):
"""
GetWidth() -> int
Gets the width member.
"""
def IncTo(self, size):
"""
IncTo(size)
Increments this object so that both of its dimensions are not less
than the corresponding dimensions of the size.
"""
def IsFullySpecified(self):
"""
IsFullySpecified() -> bool
Returns true if neither of the size object components is equal to -1,
which is used as default for the size values in wxWidgets (hence the
predefined wxDefaultSize has both of its components equal to -1).
"""
def Scale(self, xscale, yscale):
"""
Scale(xscale, yscale) -> Size
Scales the dimensions of this object by the given factors.
"""
def Set(self, width, height):
"""
Set(width, height)
Sets the width and height members.
"""
def SetDefaults(self, sizeDefault):
"""
SetDefaults(sizeDefault)
Combine this size object with another one replacing the default (i.e.
equal to -1) components of this object with those of the other.
"""
def SetHeight(self, height):
"""
SetHeight(height)
Sets the height.
"""
def SetWidth(self, width):
"""
SetWidth(width)
Sets the width.
"""
Height = property(None, None)
Width = property(None, None)
width = property(None, None)
height = property(None, None)
x = property(None, None)
y = property(None, None)
def __eq__(self, other):
"""
__eq__(other) -> bool
"""
def __ne__(self, other):
"""
__ne__(other) -> bool
"""
def Get(self):
"""
Get() -> (width, height)
Return the width and height properties as a tuple.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
# end of class Size
class Rect(object):
"""
Rect()
Rect(x, y, width, height)
Rect(pos, size)
Rect(size)
Rect(topLeft, bottomRight)
A class for manipulating rectangles.
"""
def __init__(self, *args, **kw):
"""
Rect()
Rect(x, y, width, height)
Rect(pos, size)
Rect(size)
Rect(topLeft, bottomRight)
A class for manipulating rectangles.
"""
def CentreIn(self, r, dir=BOTH):
"""
CentreIn(r, dir=BOTH) -> Rect
Returns the rectangle having the same size as this one but centered
relatively to the given rectangle r.
"""
def CenterIn(self, r, dir=BOTH):
"""
CenterIn(r, dir=BOTH) -> Rect
Returns the rectangle having the same size as this one but centered
relatively to the given rectangle r.
"""
def Deflate(self, *args, **kw):
"""
Deflate(dx, dy) -> Rect
Deflate(diff) -> Rect
Deflate(diff) -> Rect
Decrease the rectangle size.
"""
def Inflate(self, *args, **kw):
"""
Inflate(dx, dy) -> Rect
Inflate(diff) -> Rect
Inflate(diff) -> Rect
Increases the size of the rectangle.
"""
def Offset(self, *args, **kw):
"""
Offset(dx, dy)
Offset(pt)
Moves the rectangle by the specified offset.
"""
def Union(self, *args, **kw):
"""
Union(rect) -> Rect
Modifies the rectangle to contain the bounding box of this rectangle
and the one passed in as parameter.
"""
def __iadd__(self):
"""
"""
def __imul__(self):
"""
"""
height = property(None, None)
width = property(None, None)
x = property(None, None)
y = property(None, None)
def Contains(self, *args, **kw):
"""
Contains(x, y) -> bool
Contains(pt) -> bool
Contains(rect) -> bool
Returns true if the given point is inside the rectangle (or on its
boundary) and false otherwise.
"""
def GetBottom(self):
"""
GetBottom() -> int
Gets the bottom point of the rectangle.
"""
def GetBottomLeft(self):
"""
GetBottomLeft() -> Point
Gets the position of the bottom left corner.
"""
def GetBottomRight(self):
"""
GetBottomRight() -> Point
Gets the position of the bottom right corner.
"""
def GetHeight(self):
"""
GetHeight() -> int
Gets the height member.
"""
def GetLeft(self):
"""
GetLeft() -> int
Gets the left point of the rectangle (the same as GetX()).
"""
def GetPosition(self):
"""
GetPosition() -> Point
Gets the position.
"""
def GetRight(self):
"""
GetRight() -> int
Gets the right point of the rectangle.
"""
def GetSize(self):
"""
GetSize() -> Size
Gets the size.
"""
def GetTop(self):
"""
GetTop() -> int
Gets the top point of the rectangle (the same as GetY()).
"""
def GetTopLeft(self):
"""
GetTopLeft() -> Point
Gets the position of the top left corner of the rectangle, same as
GetPosition().
"""
def GetTopRight(self):
"""
GetTopRight() -> Point
Gets the position of the top right corner.
"""
def GetWidth(self):
"""
GetWidth() -> int
Gets the width member.
"""
def GetX(self):
"""
GetX() -> int
Gets the x member.
"""
def GetY(self):
"""
GetY() -> int
Gets the y member.
"""
def Intersect(self, *args, **kw):
"""
Intersect(rect) -> Rect
Modifies this rectangle to contain the overlapping portion of this
rectangle and the one passed in as parameter.
"""
def Intersects(self, rect):
"""
Intersects(rect) -> bool
Returns true if this rectangle has a non-empty intersection with the
rectangle rect and false otherwise.
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Returns true if this rectangle has a width or height less than or
equal to 0 and false otherwise.
"""
def SetHeight(self, height):
"""
SetHeight(height)
Sets the height.
"""
def SetPosition(self, pos):
"""
SetPosition(pos)
Sets the position.
"""
def SetSize(self, s):
"""
SetSize(s)
Sets the size.
"""
def SetWidth(self, width):
"""
SetWidth(width)
Sets the width.
"""
def SetX(self, x):
"""
SetX(x)
Sets the x position.
"""
def SetY(self, y):
"""
SetY(y)
Sets the y position.
"""
def SetLeft(self, left):
"""
SetLeft(left)
Set the left side of the rectangle.
"""
def SetRight(self, right):
"""
SetRight(right)
Set the right side of the rectangle.
"""
def SetTop(self, top):
"""
SetTop(top)
Set the top edge of the rectangle.
"""
def SetBottom(self, bottom):
"""
SetBottom(bottom)
Set the bottom edge of the rectangle.
"""
def SetTopLeft(self, p):
"""
SetTopLeft(p)
Set the top-left point of the rectangle.
"""
def SetBottomRight(self, p):
"""
SetBottomRight(p)
Set the bottom-right point of the rectangle.
"""
def SetTopRight(self, p):
"""
SetTopRight(p)
Set the top-right point of the rectangle.
"""
def SetBottomLeft(self, p):
"""
SetBottomLeft(p)
Set the bottom-left point of the rectangle.
"""
Bottom = property(None, None)
BottomLeft = property(None, None)
BottomRight = property(None, None)
Height = property(None, None)
Left = property(None, None)
Position = property(None, None)
Right = property(None, None)
Size = property(None, None)
Top = property(None, None)
TopLeft = property(None, None)
TopRight = property(None, None)
Width = property(None, None)
X = property(None, None)
Y = property(None, None)
left = property(None, None)
top = property(None, None)
right = property(None, None)
bottom = property(None, None)
bottomLeft = property(None, None)
bottomRight = property(None, None)
topLeft = property(None, None)
topRight = property(None, None)
def __eq__(self, other):
"""
__eq__(other) -> bool
"""
def __ne__(self, other):
"""
__ne__(other) -> bool
"""
def Get(self):
"""
Get() -> (x, y, width, height)
Return the rectangle's properties as a tuple.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
# end of class Rect
class RealPoint(object):
"""
RealPoint()
RealPoint(x, y)
RealPoint(pt)
A wxRealPoint is a useful data structure for graphics operations.
"""
def __init__(self, *args, **kw):
"""
RealPoint()
RealPoint(x, y)
RealPoint(pt)
A wxRealPoint is a useful data structure for graphics operations.
"""
def __iadd__(self, *args, **kw):
"""
"""
def __isub__(self, *args, **kw):
"""
"""
x = property(None, None)
y = property(None, None)
def __eq__(self, other):
"""
__eq__(other) -> bool
"""
def __ne__(self, other):
"""
__ne__(other) -> bool
"""
def Get(self):
"""
Get() -> (x, y)
Return the point's properties as a tuple.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
# end of class RealPoint
class ColourDatabase(object):
"""
ColourDatabase()
wxWidgets maintains a database of standard RGB colours for a
predefined set of named colours.
"""
def __init__(self):
"""
ColourDatabase()
wxWidgets maintains a database of standard RGB colours for a
predefined set of named colours.
"""
def AddColour(self, colourName, colour):
"""
AddColour(colourName, colour)
Adds a colour to the database.
"""
def Find(self, colourName):
"""
Find(colourName) -> Colour
Finds a colour given the name.
"""
def FindName(self, colour):
"""
FindName(colour) -> String
Finds a colour name given the colour.
"""
def FindColour(self, colour):
"""
"""
# end of class ColourDatabase
def ColourDisplay():
"""
ColourDisplay() -> bool
Returns true if the display is colour, false otherwise.
"""
def DisplayDepth():
"""
DisplayDepth() -> int
Returns the depth of the display (a value of 1 denotes a monochrome
display).
"""
def SetCursor(cursor):
"""
SetCursor(cursor)
Globally sets the cursor; only has an effect on Windows, Mac and GTK+.
"""
def ClientDisplayRect():
"""
ClientDisplayRect() -> (x, y, width, height)
Returns the dimensions of the work area on the display.
"""
def GetClientDisplayRect():
"""
GetClientDisplayRect() -> Rect
Returns the dimensions of the work area on the display.
"""
def GetDisplayPPI():
"""
GetDisplayPPI() -> Size
Returns the display resolution in pixels per inch.
"""
def DisplaySize():
"""
DisplaySize() -> (width, height)
Returns the display size in pixels.
"""
def GetDisplaySize():
"""
GetDisplaySize() -> Size
Returns the display size in pixels.
"""
def DisplaySizeMM():
"""
DisplaySizeMM() -> (width, height)
Returns the display size in millimeters.
"""
def GetDisplaySizeMM():
"""
GetDisplaySizeMM() -> Size
Returns the display size in millimeters.
"""
DefaultPosition = Point()
DefaultSize = Size()
def IntersectRect(self, r1, r2):
"""
IntersectRect(r1, r2) -> PyObject
Calculate and return the intersection of r1 and r2. Returns None if
there
is no intersection.
"""
#-- end-gdicmn --#
#-- begin-geometry --#
Inside = 0
OutLeft = 0
OutRight = 0
OutTop = 0
OutBottom = 0
class Point2D(object):
"""
Point2DDouble()
Point2DDouble(x, y)
Point2DDouble(pt)
Point2DDouble(pt)
"""
def __init__(self, *args, **kw):
"""
Point2DDouble()
Point2DDouble(x, y)
Point2DDouble(pt)
Point2DDouble(pt)
"""
m_x = property(None, None)
m_y = property(None, None)
def GetFloor(self):
"""
GetFloor() -> (x, y)
"""
def GetRounded(self):
"""
GetRounded() -> (x, y)
"""
def GetVectorLength(self):
"""
GetVectorLength() -> Double
"""
def GetVectorAngle(self):
"""
GetVectorAngle() -> Double
"""
def SetVectorLength(self, length):
"""
SetVectorLength(length)
"""
def SetVectorAngle(self, degrees):
"""
SetVectorAngle(degrees)
"""
def Normalize(self):
"""
Normalize()
"""
def GetDistance(self, pt):
"""
GetDistance(pt) -> Double
"""
def GetDistanceSquare(self, pt):
"""
GetDistanceSquare(pt) -> Double
"""
def GetDotProduct(self, vec):
"""
GetDotProduct(vec) -> Double
"""
def GetCrossProduct(self, vec):
"""
GetCrossProduct(vec) -> Double
"""
def __sub__(self):
"""
"""
def __iadd__(self):
"""
"""
def __isub__(self):
"""
"""
def __imul__(self, *args, **kw):
"""
"""
def __idiv__(self, *args, **kw):
"""
"""
def __eq__(self):
"""
"""
def __ne__(self):
"""
"""
def Get(self):
"""
Get() -> PyObject
Get() -> (x,y)
Return the x and y properties as a tuple.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
VectorAngle = property(None, None)
VectorLength = property(None, None)
# end of class Point2D
class Rect2D(object):
"""
Rect2DDouble()
Rect2DDouble(x, y, w, h)
"""
def __init__(self, *args, **kw):
"""
Rect2DDouble()
Rect2DDouble(x, y, w, h)
"""
m_x = property(None, None)
m_y = property(None, None)
m_width = property(None, None)
m_height = property(None, None)
def GetPosition(self):
"""
GetPosition() -> Point2DDouble
"""
def GetSize(self):
"""
GetSize() -> Size
"""
def GetLeft(self):
"""
GetLeft() -> Double
"""
def SetLeft(self, n):
"""
SetLeft(n)
"""
def MoveLeftTo(self, n):
"""
MoveLeftTo(n)
"""
def GetTop(self):
"""
GetTop() -> Double
"""
def SetTop(self, n):
"""
SetTop(n)
"""
def MoveTopTo(self, n):
"""
MoveTopTo(n)
"""
def GetBottom(self):
"""
GetBottom() -> Double
"""
def SetBottom(self, n):
"""
SetBottom(n)
"""
def MoveBottomTo(self, n):
"""
MoveBottomTo(n)
"""
def GetRight(self):
"""
GetRight() -> Double
"""
def SetRight(self, n):
"""
SetRight(n)
"""
def MoveRightTo(self, n):
"""
MoveRightTo(n)
"""
def GetLeftTop(self):
"""
GetLeftTop() -> Point2DDouble
"""
def SetLeftTop(self, pt):
"""
SetLeftTop(pt)
"""
def MoveLeftTopTo(self, pt):
"""
MoveLeftTopTo(pt)
"""
def GetLeftBottom(self):
"""
GetLeftBottom() -> Point2DDouble
"""
def SetLeftBottom(self, pt):
"""
SetLeftBottom(pt)
"""
def MoveLeftBottomTo(self, pt):
"""
MoveLeftBottomTo(pt)
"""
def GetRightTop(self):
"""
GetRightTop() -> Point2DDouble
"""
def SetRightTop(self, pt):
"""
SetRightTop(pt)
"""
def MoveRightTopTo(self, pt):
"""
MoveRightTopTo(pt)
"""
def GetRightBottom(self):
"""
GetRightBottom() -> Point2DDouble
"""
def SetRightBottom(self, pt):
"""
SetRightBottom(pt)
"""
def MoveRightBottomTo(self, pt):
"""
MoveRightBottomTo(pt)
"""
def GetCentre(self):
"""
GetCentre() -> Point2DDouble
"""
def SetCentre(self, pt):
"""
SetCentre(pt)
"""
def MoveCentreTo(self, pt):
"""
MoveCentreTo(pt)
"""
def GetOutCode(self, pt):
"""
GetOutCode(pt) -> OutCode
"""
def GetOutcode(self, pt):
"""
GetOutcode(pt) -> OutCode
"""
def Contains(self, *args, **kw):
"""
Contains(pt) -> bool
Contains(rect) -> bool
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
"""
def HaveEqualSize(self, rect):
"""
HaveEqualSize(rect) -> bool
"""
def Inset(self, *args, **kw):
"""
Inset(x, y)
Inset(left, top, right, bottom)
"""
def Offset(self, pt):
"""
Offset(pt)
"""
def ConstrainTo(self, rect):
"""
ConstrainTo(rect)
"""
def Interpolate(self, widthfactor, heightfactor):
"""
Interpolate(widthfactor, heightfactor) -> Point2DDouble
"""
def Intersect(self, *args, **kw):
"""
Intersect(otherRect)
Intersect(src1, src2, dest)
"""
def CreateIntersection(self, otherRect):
"""
CreateIntersection(otherRect) -> Rect2DDouble
"""
def Intersects(self, rect):
"""
Intersects(rect) -> bool
"""
def Union(self, *args, **kw):
"""
Union(otherRect)
Union(pt)
Union(src1, src2, dest)
"""
def CreateUnion(self, otherRect):
"""
CreateUnion(otherRect) -> Rect2DDouble
"""
def Scale(self, *args, **kw):
"""
Scale(f)
Scale(num, denum)
"""
def __eq__(self):
"""
"""
def __ne__(self):
"""
"""
def Get(self):
"""
Get() -> PyObject
Get() -> (x, y, width, height)
Return the rectangle's properties as a tuple.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
Bottom = property(None, None)
Centre = property(None, None)
Left = property(None, None)
LeftBottom = property(None, None)
LeftTop = property(None, None)
Position = property(None, None)
Right = property(None, None)
RightBottom = property(None, None)
RightTop = property(None, None)
Size = property(None, None)
Top = property(None, None)
# end of class Rect2D
#-- end-geometry --#
#-- begin-affinematrix2d --#
class Matrix2D(object):
"""
Matrix2D(v11=1, v12=0, v21=0, v22=1)
A simple container for 2x2 matrix.
"""
def __init__(self, v11=1, v12=0, v21=0, v22=1):
"""
Matrix2D(v11=1, v12=0, v21=0, v22=1)
A simple container for 2x2 matrix.
"""
m_11 = property(None, None)
m_12 = property(None, None)
m_21 = property(None, None)
m_22 = property(None, None)
# end of class Matrix2D
class AffineMatrix2DBase(object):
"""
AffineMatrix2DBase()
A 2x3 matrix representing an affine 2D transformation.
"""
def __init__(self):
"""
AffineMatrix2DBase()
A 2x3 matrix representing an affine 2D transformation.
"""
def IsEqual(self, t):
"""
IsEqual(t) -> bool
Check that this matrix is identical with t.
"""
def __eq__(self):
"""
"""
def Set(self, mat2D, tr):
"""
Set(mat2D, tr)
Set all elements of this matrix.
"""
def Get(self):
"""
Get() -> (mat2D, tr)
Get the component values of the matrix.
"""
def Concat(self, t):
"""
Concat(t)
Concatenate this matrix with another one.
"""
def Invert(self):
"""
Invert() -> bool
Invert this matrix.
"""
def IsIdentity(self):
"""
IsIdentity() -> bool
Check if this is the identity matrix.
"""
def __ne__(self):
"""
"""
def Translate(self, dx, dy):
"""
Translate(dx, dy)
Add the translation to this matrix.
"""
def Scale(self, xScale, yScale):
"""
Scale(xScale, yScale)
Add scaling to this matrix.
"""
def Rotate(self, cRadians):
"""
Rotate(cRadians)
Add clockwise rotation to this matrix.
"""
def Mirror(self, direction=HORIZONTAL):
"""
Mirror(direction=HORIZONTAL)
Add mirroring to this matrix.
"""
def TransformPoint(self, *args, **kw):
"""
TransformPoint(p) -> Point2DDouble
TransformPoint(x, y) -> (x, y)
Applies this matrix to the point.
"""
def TransformDistance(self, *args, **kw):
"""
TransformDistance(p) -> Point2DDouble
TransformDistance(dx, dy) -> (dx, dy)
Applies the linear part of this matrix, i.e. without translation.
"""
# end of class AffineMatrix2DBase
class AffineMatrix2D(AffineMatrix2DBase):
"""
AffineMatrix2D()
A 3x2 matrix representing an affine 2D transformation.
"""
def __init__(self):
"""
AffineMatrix2D()
A 3x2 matrix representing an affine 2D transformation.
"""
def IsEqual(self, t):
"""
IsEqual(t)
Check that this matrix is identical with t.
"""
def __eq__(self):
"""
"""
def Get(self):
"""
Get() -> (mat2D, tr)
Get the component values of the matrix.
"""
def Set(self, mat2D, tr):
"""
Set(mat2D, tr)
Set all elements of this matrix.
"""
def Concat(self, t):
"""
Concat(t)
Concatenate this matrix with another one.
"""
def Invert(self):
"""
Invert() -> bool
Invert this matrix.
"""
def IsIdentity(self):
"""
IsIdentity() -> bool
Check if this is the identity matrix.
"""
def __ne__(self):
"""
"""
def Translate(self, dx, dy):
"""
Translate(dx, dy)
Add the translation to this matrix.
"""
def Scale(self, xScale, yScale):
"""
Scale(xScale, yScale)
Add scaling to this matrix.
"""
def Mirror(self, direction=HORIZONTAL):
"""
Mirror(direction=HORIZONTAL)
Add mirroring to this matrix.
"""
def Rotate(self, cRadians):
"""
Rotate(cRadians)
Add clockwise rotation to this matrix.
"""
def TransformPoint(self, *args, **kw):
"""
TransformPoint(p) -> Point2DDouble
TransformPoint(x, y) -> (x, y)
Applies this matrix to the point.
"""
def TransformDistance(self, *args, **kw):
"""
TransformDistance(p) -> Point2DDouble
TransformDistance(dx, dy) -> (dx, dy)
Applies the linear part of this matrix, i.e. without translation.
"""
# end of class AffineMatrix2D
#-- end-affinematrix2d --#
#-- begin-position --#
class Position(object):
"""
Position()
Position(row, col)
This class represents the position of an item in any kind of grid of
rows and columns such as wxGridBagSizer, or wxHVScrolledWindow.
"""
def __init__(self, *args, **kw):
"""
Position()
Position(row, col)
This class represents the position of an item in any kind of grid of
rows and columns such as wxGridBagSizer, or wxHVScrolledWindow.
"""
def __eq__(self):
"""
"""
def __ne__(self):
"""
"""
def __iadd__(self, *args, **kw):
"""
"""
def __isub__(self, *args, **kw):
"""
"""
def __add__(self, *args, **kw):
"""
"""
def __sub__(self, *args, **kw):
"""
"""
def GetCol(self):
"""
GetCol() -> int
A synonym for GetColumn().
"""
def GetColumn(self):
"""
GetColumn() -> int
Get the current row value.
"""
def GetRow(self):
"""
GetRow() -> int
Get the current row value.
"""
def SetCol(self, column):
"""
SetCol(column)
A synonym for SetColumn().
"""
def SetColumn(self, column):
"""
SetColumn(column)
Set a new column value.
"""
def SetRow(self, row):
"""
SetRow(row)
Set a new row value.
"""
def Get(self):
"""
Get() -> (row,col)
Return the row and col properties as a tuple.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
Col = property(None, None)
Column = property(None, None)
Row = property(None, None)
# end of class Position
#-- end-position --#
#-- begin-colour --#
C2S_NAME = 0
C2S_CSS_SYNTAX = 0
C2S_HTML_SYNTAX = 0
ALPHA_TRANSPARENT = 0
ALPHA_OPAQUE = 0
class Colour(Object):
"""
Colour()
Colour(red, green, blue, alpha=ALPHA_OPAQUE)
Colour(colRGB)
Colour(colour)
A colour is an object representing a combination of Red, Green, and
Blue (RGB) intensity values, and is used to determine drawing colours.
"""
def __init__(self, *args, **kw):
"""
Colour()
Colour(red, green, blue, alpha=ALPHA_OPAQUE)
Colour(colRGB)
Colour(colour)
A colour is an object representing a combination of Red, Green, and
Blue (RGB) intensity values, and is used to determine drawing colours.
"""
def SetRGB(self, colRGB):
"""
SetRGB(colRGB)
Sets the RGB or RGBA colour values from a single 32 bit value.
"""
def SetRGBA(self, colRGBA):
"""
SetRGBA(colRGBA)
Sets the RGB or RGBA colour values from a single 32 bit value.
"""
def GetRGB(self):
"""
GetRGB() -> Uint32
Gets the RGB or RGBA colour values as a single 32 bit value.
"""
def GetRGBA(self):
"""
GetRGBA() -> Uint32
Gets the RGB or RGBA colour values as a single 32 bit value.
"""
def Set(self, *args, **kw):
"""
Set(red, green, blue, alpha=ALPHA_OPAQUE)
Set(RGB)
Set(str) -> bool
Sets the RGB intensity values using the given values (first overload),
extracting them from the packed long (second overload), using the
given string (third overload).
"""
def Alpha(self):
"""
Alpha() -> unsignedchar
Returns the alpha value, on platforms where alpha is not yet
supported, this always returns wxALPHA_OPAQUE.
"""
def Blue(self):
"""
Blue() -> unsignedchar
Returns the blue intensity.
"""
def GetAsString(self, flags=C2S_NAME|C2S_CSS_SYNTAX):
"""
GetAsString(flags=C2S_NAME|C2S_CSS_SYNTAX) -> String
Converts this colour to a wxString using the given flags.
"""
def GetPixel(self):
"""
GetPixel() -> IntPtr
"""
def Green(self):
"""
Green() -> unsignedchar
Returns the green intensity.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the colour object is valid (the colour has been
initialised with RGB values).
"""
def Red(self):
"""
Red() -> unsignedchar
Returns the red intensity.
"""
def __ne__(self):
"""
"""
def __eq__(self):
"""
"""
def MakeDisabled(self, *args, **kw):
"""
MakeDisabled(brightness=255) -> Colour
MakeDisabled(r, g, b, brightness=255) -> (r, g, b)
Make a disabled version of this colour.
"""
def ChangeLightness(self, *args, **kw):
"""
ChangeLightness(ialpha) -> Colour
ChangeLightness(r, g, b, ialpha) -> (r, g, b)
wxColour wrapper for ChangeLightness(r,g,b,ialpha).
"""
@staticmethod
def MakeMono(on):
"""
MakeMono(on) -> (r, g, b)
Assign 0 or 255 to rgb out parameters.
"""
@staticmethod
def MakeGrey(*args, **kw):
"""
MakeGrey(r, g, b) -> (r, g, b)
MakeGrey(r, g, b, weight_r, weight_g, weight_b) -> (r, g, b)
Create a grey colour from (in/out) rgb parameters using integer
arithmetic.
"""
@staticmethod
def AlphaBlend(fg, bg, alpha):
"""
AlphaBlend(fg, bg, alpha) -> unsignedchar
Blend colour, taking alpha into account.
"""
Pixel = property(None, None)
RGB = property(None, None)
RGBA = property(None, None)
red = property(None, None)
green = property(None, None)
blue = property(None, None)
alpha = property(None, None)
def _copyFrom(self, other):
"""
_copyFrom(other)
For internal use only.
"""
def Get(self, includeAlpha=True):
"""
Get(includeAlpha=True) -> PyObject
Get(includeAlpha=False) -> (r,g,b) or (r,g,b,a)
Returns the RGB intensity values as a tuple, optionally the alpha
value as well.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
# end of class Colour
NullColour = Colour()
TransparentColour = Colour()
def MacThemeColour(self, themeBrushID):
"""
MacThemeColour(themeBrushID) -> Colour
"""
# These stock colours will be initialized when the wx.App object is created.
BLACK = Colour()
BLUE = Colour()
CYAN = Colour()
GREEN = Colour()
YELLOW = Colour()
LIGHT_GREY = Colour()
RED = Colour()
WHITE = Colour()
NamedColour = wx.deprecated(Colour, "Use Colour instead.")
#-- end-colour --#
#-- begin-stream --#
STREAM_NO_ERROR = 0
STREAM_EOF = 0
STREAM_WRITE_ERROR = 0
STREAM_READ_ERROR = 0
FromStart = 0
FromCurrent = 0
FromEnd = 0
class StreamBase(object):
"""
StreamBase()
This class is the base class of most stream related classes in
wxWidgets.
"""
def __init__(self):
"""
StreamBase()
This class is the base class of most stream related classes in
wxWidgets.
"""
def GetLastError(self):
"""
GetLastError() -> StreamError
This function returns the last error.
"""
def GetLength(self):
"""
GetLength() -> FileOffset
Returns the length of the stream in bytes.
"""
def GetSize(self):
"""
GetSize() -> size_t
This function returns the size of the stream.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if no error occurred on the stream.
"""
def IsSeekable(self):
"""
IsSeekable() -> bool
Returns true if the stream supports seeking to arbitrary offsets.
"""
def Reset(self, error=STREAM_NO_ERROR):
"""
Reset(error=STREAM_NO_ERROR)
Resets the stream state.
"""
LastError = property(None, None)
Length = property(None, None)
Size = property(None, None)
# end of class StreamBase
class InputStream(StreamBase):
"""
InputStream()
wxInputStream is an abstract base class which may not be used
directly.
"""
def __init__(self):
"""
InputStream()
wxInputStream is an abstract base class which may not be used
directly.
"""
def CanRead(self):
"""
CanRead() -> bool
Returns true if some data is available in the stream right now, so
that calling Read() wouldn't block.
"""
def Eof(self):
"""
Eof() -> bool
Returns true after an attempt has been made to read past the end of
the stream.
"""
def GetC(self):
"""
GetC() -> int
Returns the first character in the input queue and removes it,
blocking until it appears if necessary.
"""
def LastRead(self):
"""
LastRead() -> size_t
Returns the last number of bytes read.
"""
def Peek(self):
"""
Peek() -> char
Returns the first character in the input queue without removing it.
"""
def Read(self, *args, **kw):
"""
Read(buffer, size) -> InputStream
Read(stream_out) -> InputStream
Reads the specified amount of bytes and stores the data in buffer.
"""
def ReadAll(self, buffer, size):
"""
ReadAll(buffer, size) -> bool
Reads exactly the specified number of bytes into the buffer.
"""
def SeekI(self, pos, mode=FromStart):
"""
SeekI(pos, mode=FromStart) -> FileOffset
Changes the stream current position.
"""
def TellI(self):
"""
TellI() -> FileOffset
Returns the current stream position or wxInvalidOffset if it's not
available (e.g.
"""
def Ungetch(self, *args, **kw):
"""
Ungetch(buffer, size) -> size_t
Ungetch(c) -> bool
This function is only useful in read mode.
"""
def seek(self, offset, whence=0):
"""
seek(offset, whence=0)
"""
def tell(self):
"""
tell() -> FileOffset
"""
def close(self):
"""
close()
"""
def flush(self):
"""
flush()
"""
def eof(self):
"""
eof() -> bool
"""
def read(self, *args, **kw):
"""
read() -> PyObject
read(size) -> PyObject
"""
def readline(self, *args, **kw):
"""
readline() -> PyObject
readline(size) -> PyObject
"""
def readlines(self, *args, **kw):
"""
readlines() -> PyObject
readlines(sizehint) -> PyObject
"""
C = property(None, None)
# end of class InputStream
class OutputStream(StreamBase):
"""
OutputStream()
wxOutputStream is an abstract base class which may not be used
directly.
"""
def __init__(self):
"""
OutputStream()
wxOutputStream is an abstract base class which may not be used
directly.
"""
def Close(self):
"""
Close() -> bool
Closes the stream, returning false if an error occurs.
"""
def LastWrite(self):
"""
LastWrite() -> size_t
Returns the number of bytes written during the last Write().
"""
def PutC(self, c):
"""
PutC(c)
Puts the specified character in the output queue and increments the
stream position.
"""
def SeekO(self, pos, mode=FromStart):
"""
SeekO(pos, mode=FromStart) -> FileOffset
Changes the stream current position.
"""
def TellO(self):
"""
TellO() -> FileOffset
Returns the current stream position.
"""
def Write(self, *args, **kw):
"""
Write(buffer, size) -> OutputStream
Write(stream_in) -> OutputStream
Writes up to the specified amount of bytes using the data of buffer.
"""
def WriteAll(self, buffer, size):
"""
WriteAll(buffer, size) -> bool
Writes exactly the specified number of bytes from the buffer.
"""
def seek(self, offset, whence=0):
"""
seek(offset, whence=0)
"""
def tell(self):
"""
tell() -> FileOffset
"""
def close(self):
"""
close()
"""
def flush(self):
"""
flush()
"""
def eof(self):
"""
eof() -> bool
"""
def write(self, data):
"""
write(data)
"""
# end of class OutputStream
#-- end-stream --#
#-- begin-filesys --#
FS_READ = 0
FS_SEEKABLE = 0
class FileSystem(Object):
"""
FileSystem()
This class provides an interface for opening files on different file
systems.
"""
def __init__(self):
"""
FileSystem()
This class provides an interface for opening files on different file
systems.
"""
def ChangePathTo(self, location, is_dir=False):
"""
ChangePathTo(location, is_dir=False)
Sets the current location.
"""
def FindFileInPath(self, pStr, path, file):
"""
FindFileInPath(pStr, path, file) -> bool
Looks for the file with the given name file in a colon or semi-colon
(depending on the current platform) separated list of directories in
path.
"""
def FindFirst(self, wildcard, flags=0):
"""
FindFirst(wildcard, flags=0) -> String
Works like wxFindFirstFile().
"""
def FindNext(self):
"""
FindNext() -> String
Returns the next filename that matches the parameters passed to
FindFirst().
"""
def GetPath(self):
"""
GetPath() -> String
Returns the actual path (set by wxFileSystem::ChangePathTo).
"""
def OpenFile(self, location, flags=FS_READ):
"""
OpenFile(location, flags=FS_READ) -> FSFile
Opens the file and returns a pointer to a wxFSFile object or NULL if
failed.
"""
@staticmethod
def AddHandler(handler):
"""
AddHandler(handler)
This static function adds new handler into the list of handlers (see
wxFileSystemHandler) which provide access to virtual FS.
"""
@staticmethod
def RemoveHandler(handler):
"""
RemoveHandler(handler) -> FileSystemHandler
Remove a filesystem handler from the list of handlers.
"""
@staticmethod
def FileNameToURL(filename):
"""
FileNameToURL(filename) -> String
Converts a wxFileName into an URL.
"""
@staticmethod
def HasHandlerForPath(location):
"""
HasHandlerForPath(location) -> bool
This static function returns true if there is a registered handler
which can open the given location.
"""
@staticmethod
def URLToFileName(url):
"""
URLToFileName(url) -> FileName
Converts URL into a well-formed filename.
"""
Path = property(None, None)
# end of class FileSystem
class FSFile(Object):
"""
FSFile(stream, location, mimetype, anchor, modif)
This class represents a single file opened by wxFileSystem.
"""
def __init__(self, stream, location, mimetype, anchor, modif):
"""
FSFile(stream, location, mimetype, anchor, modif)
This class represents a single file opened by wxFileSystem.
"""
def DetachStream(self):
"""
DetachStream() -> InputStream
Detaches the stream from the wxFSFile object.
"""
def GetAnchor(self):
"""
GetAnchor() -> String
Returns anchor (if present).
"""
def GetLocation(self):
"""
GetLocation() -> String
Returns full location of the file, including path and protocol.
"""
def GetMimeType(self):
"""
GetMimeType() -> String
Returns the MIME type of the content of this file.
"""
def GetModificationTime(self):
"""
GetModificationTime() -> DateTime
Returns time when this file was modified.
"""
def GetStream(self):
"""
GetStream() -> InputStream
Returns pointer to the stream.
"""
Anchor = property(None, None)
Location = property(None, None)
MimeType = property(None, None)
ModificationTime = property(None, None)
Stream = property(None, None)
# end of class FSFile
class FileSystemHandler(Object):
"""
FileSystemHandler()
Classes derived from wxFileSystemHandler are used to access virtual
file systems.
"""
def __init__(self):
"""
FileSystemHandler()
Classes derived from wxFileSystemHandler are used to access virtual
file systems.
"""
def CanOpen(self, location):
"""
CanOpen(location) -> bool
Returns true if the handler is able to open this file.
"""
def FindFirst(self, wildcard, flags=0):
"""
FindFirst(wildcard, flags=0) -> String
Works like wxFindFirstFile().
"""
def FindNext(self):
"""
FindNext() -> String
Returns next filename that matches parameters passed to
wxFileSystem::FindFirst.
"""
def OpenFile(self, fs, location):
"""
OpenFile(fs, location) -> FSFile
Opens the file and returns wxFSFile pointer or NULL if failed.
"""
@staticmethod
def GetMimeTypeFromExt(location):
"""
GetMimeTypeFromExt(location) -> String
Returns the MIME type based on extension of location.
"""
@staticmethod
def GetAnchor(location):
"""
GetAnchor(location) -> String
Returns the anchor if present in the location.
"""
@staticmethod
def GetLeftLocation(location):
"""
GetLeftLocation(location) -> String
Returns the left location string extracted from location.
"""
@staticmethod
def GetProtocol(location):
"""
GetProtocol(location) -> String
Returns the protocol string extracted from location.
"""
@staticmethod
def GetRightLocation(location):
"""
GetRightLocation(location) -> String
Returns the right location string extracted from location.
"""
# end of class FileSystemHandler
class MemoryFSHandler(FileSystemHandler):
"""
MemoryFSHandler()
This wxFileSystem handler can store arbitrary data in memory stream
and make them accessible via an URL.
"""
def __init__(self):
"""
MemoryFSHandler()
This wxFileSystem handler can store arbitrary data in memory stream
and make them accessible via an URL.
"""
@staticmethod
def AddFile(*args, **kw):
"""
AddFile(filename, image, type)
AddFile(filename, bitmap, type)
Adds a file to the list of the files stored in memory.
"""
@staticmethod
def AddFileWithMimeType(*args, **kw):
"""
AddFileWithMimeType(filename, textdata, mimetype)
AddFileWithMimeType(filename, binarydata, size, mimetype)
Like AddFile(), but lets you explicitly specify added file's MIME
type.
"""
@staticmethod
def RemoveFile(filename):
"""
RemoveFile(filename)
Removes a file from memory FS and frees the occupied memory.
"""
# end of class MemoryFSHandler
class ArchiveFSHandler(FileSystemHandler):
"""
ArchiveFSHandler()
A file system handler for accessing files inside of archives.
"""
def __init__(self):
"""
ArchiveFSHandler()
A file system handler for accessing files inside of archives.
"""
def Cleanup(self):
"""
Cleanup()
"""
# end of class ArchiveFSHandler
class FilterFSHandler(FileSystemHandler):
"""
FilterFSHandler()
Filter file system handler.
"""
def __init__(self):
"""
FilterFSHandler()
Filter file system handler.
"""
# end of class FilterFSHandler
class InternetFSHandler(FileSystemHandler):
"""
InternetFSHandler()
A file system handler for accessing files from internet servers.
"""
def __init__(self):
"""
InternetFSHandler()
A file system handler for accessing files from internet servers.
"""
# end of class InternetFSHandler
ZipFSHandler = wx.deprecated(ArchiveFSHandler, "Use ArchiveFSHandler instead.")
#-- end-filesys --#
#-- begin-image --#
IMAGE_RESOLUTION_NONE = 0
IMAGE_RESOLUTION_INCHES = 0
IMAGE_RESOLUTION_CM = 0
IMAGE_QUALITY_NEAREST = 0
IMAGE_QUALITY_BILINEAR = 0
IMAGE_QUALITY_BICUBIC = 0
IMAGE_QUALITY_BOX_AVERAGE = 0
IMAGE_QUALITY_NORMAL = 0
IMAGE_QUALITY_HIGH = 0
PNG_TYPE_COLOUR = 0
PNG_TYPE_GREY = 0
PNG_TYPE_GREY_RED = 0
PNG_TYPE_PALETTE = 0
BMP_24BPP = 0
BMP_8BPP = 0
BMP_8BPP_GREY = 0
BMP_8BPP_GRAY = 0
BMP_8BPP_RED = 0
BMP_8BPP_PALETTE = 0
BMP_4BPP = 0
BMP_1BPP = 0
BMP_1BPP_BW = 0
IMAGE_ALPHA_TRANSPARENT = 0
IMAGE_ALPHA_OPAQUE = 0
IMAGE_ALPHA_THRESHOLD = 0
class Image(Object):
"""
Image()
Image(width, height, clear=True)
Image(sz, clear=True)
Image(name, type=BITMAP_TYPE_ANY, index=-1)
Image(name, mimetype, index=-1)
Image(stream, type=BITMAP_TYPE_ANY, index=-1)
Image(stream, mimetype, index=-1)
Image(width, height, data)
Image(width, height, data, alpha)
Image(size, data)
Image(size, data, alpha)
This class encapsulates a platform-independent image.
"""
class HSVValue(object):
"""
HSVValue(h=0.0, s=0.0, v=0.0)
A simple class which stores hue, saturation and value as doubles in
the range 0.0-1.0.
"""
def __init__(self, h=0.0, s=0.0, v=0.0):
"""
HSVValue(h=0.0, s=0.0, v=0.0)
A simple class which stores hue, saturation and value as doubles in
the range 0.0-1.0.
"""
hue = property(None, None)
saturation = property(None, None)
value = property(None, None)
# end of class HSVValue
class RGBValue(object):
"""
RGBValue(r=0, g=0, b=0)
A simple class which stores red, green and blue values as 8 bit
unsigned integers in the range of 0-255.
"""
def __init__(self, r=0, g=0, b=0):
"""
RGBValue(r=0, g=0, b=0)
A simple class which stores red, green and blue values as 8 bit
unsigned integers in the range of 0-255.
"""
red = property(None, None)
green = property(None, None)
blue = property(None, None)
# end of class RGBValue
def __init__(self, *args, **kw):
"""
Image()
Image(width, height, clear=True)
Image(sz, clear=True)
Image(name, type=BITMAP_TYPE_ANY, index=-1)
Image(name, mimetype, index=-1)
Image(stream, type=BITMAP_TYPE_ANY, index=-1)
Image(stream, mimetype, index=-1)
Image(width, height, data)
Image(width, height, data, alpha)
Image(size, data)
Image(size, data, alpha)
This class encapsulates a platform-independent image.
"""
def Copy(self):
"""
Copy() -> Image
Returns an identical copy of this image.
"""
def Create(self, *args, **kw):
"""
Create(width, height, clear=True) -> bool
Create(sz, clear=True) -> bool
Create(width, height, data) -> bool
Create(width, height, data, alpha) -> bool
Create(size, data) -> bool
Create(size, data, alpha) -> bool
Creates a fresh image.
"""
def Clear(self, value=0):
"""
Clear(value=0)
Initialize the image data with zeroes (the default) or with the byte
value given as value.
"""
def Destroy(self):
"""
Destroy()
Destroys the image data.
"""
def InitAlpha(self):
"""
InitAlpha()
Initializes the image alpha channel data.
"""
def Blur(self, blurRadius):
"""
Blur(blurRadius) -> Image
Blurs the image in both horizontal and vertical directions by the
specified pixel blurRadius.
"""
def BlurHorizontal(self, blurRadius):
"""
BlurHorizontal(blurRadius) -> Image
Blurs the image in the horizontal direction only.
"""
def BlurVertical(self, blurRadius):
"""
BlurVertical(blurRadius) -> Image
Blurs the image in the vertical direction only.
"""
def Mirror(self, horizontally=True):
"""
Mirror(horizontally=True) -> Image
Returns a mirrored copy of the image.
"""
def Paste(self, image, x, y):
"""
Paste(image, x, y)
Copy the data of the given image to the specified position in this
image.
"""
def Replace(self, r1, g1, b1, r2, g2, b2):
"""
Replace(r1, g1, b1, r2, g2, b2)
Replaces the colour specified by r1,g1,b1 by the colour r2,g2,b2.
"""
def Rescale(self, width, height, quality=IMAGE_QUALITY_NORMAL):
"""
Rescale(width, height, 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.
"""
def Resize(self, size, pos, red=-1, green=-1, blue=-1):
"""
Resize(size, pos, red=-1, green=-1, blue=-1) -> Image
Changes the size of the image in-place without scaling it by adding
either a border with the given colour or cropping as necessary.
"""
def Rotate(self, angle, rotationCentre, interpolating=True, offsetAfterRotation=None):
"""
Rotate(angle, rotationCentre, interpolating=True, offsetAfterRotation=None) -> Image
Rotates the image about the given point, by angle radians.
"""
def Rotate90(self, clockwise=True):
"""
Rotate90(clockwise=True) -> Image
Returns a copy of the image rotated 90 degrees in the direction
indicated by clockwise.
"""
def Rotate180(self):
"""
Rotate180() -> Image
Returns a copy of the image rotated by 180 degrees.
"""
def RotateHue(self, angle):
"""
RotateHue(angle)
Rotates the hue of each pixel in the image by angle, which is a double
in the range of -1.0 to +1.0, where -1.0 corresponds to -360 degrees
and +1.0 corresponds to +360 degrees.
"""
def Scale(self, width, height, quality=IMAGE_QUALITY_NORMAL):
"""
Scale(width, height, quality=IMAGE_QUALITY_NORMAL) -> Image
Returns a scaled version of the image.
"""
def Size(self, size, pos, red=-1, green=-1, blue=-1):
"""
Size(size, pos, red=-1, green=-1, blue=-1) -> Image
Returns a resized version of this image without scaling it by adding
either a border with the given colour or cropping as necessary.
"""
def ConvertAlphaToMask(self, *args, **kw):
"""
ConvertAlphaToMask(threshold=IMAGE_ALPHA_THRESHOLD) -> bool
ConvertAlphaToMask(mr, mg, mb, threshold=IMAGE_ALPHA_THRESHOLD) -> bool
If the image has alpha channel, this method converts it to mask.
"""
def ConvertToGreyscale(self, *args, **kw):
"""
ConvertToGreyscale(weight_r, weight_g, weight_b) -> Image
ConvertToGreyscale() -> Image
Returns a greyscale version of the image.
"""
def ConvertToMono(self, r, g, b):
"""
ConvertToMono(r, g, b) -> Image
Returns monochromatic version of the image.
"""
def ConvertToDisabled(self, brightness=255):
"""
ConvertToDisabled(brightness=255) -> Image
Returns disabled (dimmed) version of the image.
"""
def ComputeHistogram(self, histogram):
"""
ComputeHistogram(histogram) -> unsignedlong
Computes the histogram of the image.
"""
def FindFirstUnusedColour(self, startR=1, startG=0, startB=0):
"""
FindFirstUnusedColour(startR=1, startG=0, startB=0) -> (r, g, b)
Finds the first colour that is never used in the image.
"""
def GetAlpha(self, *args, **kw):
"""
GetAlpha(x, y) -> unsignedchar
GetAlpha() -> PyObject
Return alpha value at given pixel location.
"""
def GetData(self):
"""
GetData() -> PyObject
Returns a copy of the RGB bytes of the image.
"""
def GetRed(self, x, y):
"""
GetRed(x, y) -> unsignedchar
Returns the red intensity at the given coordinate.
"""
def GetGreen(self, x, y):
"""
GetGreen(x, y) -> unsignedchar
Returns the green intensity at the given coordinate.
"""
def GetBlue(self, x, y):
"""
GetBlue(x, y) -> unsignedchar
Returns the blue intensity at the given coordinate.
"""
def GetMaskRed(self):
"""
GetMaskRed() -> unsignedchar
Gets the red value of the mask colour.
"""
def GetMaskGreen(self):
"""
GetMaskGreen() -> unsignedchar
Gets the green value of the mask colour.
"""
def GetMaskBlue(self):
"""
GetMaskBlue() -> unsignedchar
Gets the blue value of the mask colour.
"""
def GetWidth(self):
"""
GetWidth() -> int
Gets the width of the image in pixels.
"""
def GetHeight(self):
"""
GetHeight() -> int
Gets the height of the image in pixels.
"""
def GetSize(self):
"""
GetSize() -> Size
Returns the size of the image in pixels.
"""
def GetOption(self, name):
"""
GetOption(name) -> String
Gets a user-defined string-valued option.
"""
def GetOptionInt(self, name):
"""
GetOptionInt(name) -> int
Gets a user-defined integer-valued option.
"""
def GetOrFindMaskColour(self):
"""
GetOrFindMaskColour() -> (r, g, b)
Get the current mask colour or find a suitable unused colour that
could be used as a mask colour.
"""
def GetPalette(self):
"""
GetPalette() -> Palette
Returns the palette associated with the image.
"""
def GetSubImage(self, rect):
"""
GetSubImage(rect) -> Image
Returns a sub image of the current one as long as the rect belongs
entirely to the image.
"""
def GetType(self):
"""
GetType() -> BitmapType
Gets the type of image found by LoadFile() or specified with
SaveFile().
"""
def HasAlpha(self):
"""
HasAlpha() -> bool
Returns true if this image has alpha channel, false otherwise.
"""
def HasMask(self):
"""
HasMask() -> bool
Returns true if there is a mask active, false otherwise.
"""
def HasOption(self, name):
"""
HasOption(name) -> bool
Returns true if the given option is present.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if image data is present.
"""
def IsTransparent(self, x, y, threshold=IMAGE_ALPHA_THRESHOLD):
"""
IsTransparent(x, y, threshold=IMAGE_ALPHA_THRESHOLD) -> bool
Returns true if the given pixel is transparent, i.e. either has the
mask colour if this image has a mask or if this image has alpha
channel and alpha value of this pixel is strictly less than threshold.
"""
def LoadFile(self, *args, **kw):
"""
LoadFile(stream, type=BITMAP_TYPE_ANY, index=-1) -> bool
LoadFile(name, type=BITMAP_TYPE_ANY, index=-1) -> bool
LoadFile(name, mimetype, index=-1) -> bool
LoadFile(stream, mimetype, index=-1) -> bool
Loads an image from an input stream.
"""
def SaveFile(self, *args, **kw):
"""
SaveFile(stream, mimetype) -> bool
SaveFile(name, type) -> bool
SaveFile(name, mimetype) -> bool
SaveFile(name) -> bool
SaveFile(stream, type) -> bool
Saves an image in the given stream.
"""
def SetAlpha(self, *args, **kw):
"""
SetAlpha(x, y, alpha)
SetAlpha(alpha)
Sets the alpha value for the given pixel.
"""
def ClearAlpha(self):
"""
ClearAlpha()
Removes the alpha channel from the image.
"""
def SetData(self, *args, **kw):
"""
SetData(data)
SetData(data, new_width, new_height)
Sets the image data without performing checks.
"""
def SetMask(self, hasMask=True):
"""
SetMask(hasMask=True)
Specifies whether there is a mask or not.
"""
def SetMaskColour(self, red, green, blue):
"""
SetMaskColour(red, green, blue)
Sets the mask colour for this image (and tells the image to use the
mask).
"""
def SetMaskFromImage(self, mask, mr, mg, mb):
"""
SetMaskFromImage(mask, mr, mg, mb) -> bool
Sets image's mask so that the pixels that have RGB value of mr,mg,mb
in mask will be masked in the image.
"""
def SetOption(self, *args, **kw):
"""
SetOption(name, value)
SetOption(name, value)
Sets a user-defined option.
"""
def SetPalette(self, palette):
"""
SetPalette(palette)
Associates a palette with the image.
"""
def SetRGB(self, *args, **kw):
"""
SetRGB(x, y, r, g, b)
SetRGB(rect, red, green, blue)
Set the color of the pixel at the given x and y coordinate.
"""
def SetType(self, type):
"""
SetType(type)
Set the type of image returned by GetType().
"""
@staticmethod
def AddHandler(handler):
"""
AddHandler(handler)
Register an image handler.
"""
@staticmethod
def CleanUpHandlers():
"""
CleanUpHandlers()
Deletes all image handlers.
"""
@staticmethod
def FindHandler(*args, **kw):
"""
FindHandler(name) -> ImageHandler
FindHandler(extension, imageType) -> ImageHandler
FindHandler(imageType) -> ImageHandler
Finds the handler with the given name.
"""
@staticmethod
def FindHandlerMime(mimetype):
"""
FindHandlerMime(mimetype) -> ImageHandler
Finds the handler associated with the given MIME type.
"""
@staticmethod
def InitStandardHandlers():
"""
InitStandardHandlers()
Internal use only.
"""
@staticmethod
def InsertHandler(handler):
"""
InsertHandler(handler)
Adds a handler at the start of the static list of format handlers.
"""
@staticmethod
def RemoveHandler(name):
"""
RemoveHandler(name) -> bool
Finds the handler with the given name, and removes it.
"""
@staticmethod
def GetImageCount(*args, **kw):
"""
GetImageCount(filename, type=BITMAP_TYPE_ANY) -> int
GetImageCount(stream, type=BITMAP_TYPE_ANY) -> int
If the image file contains more than one image and the image handler
is capable of retrieving these individually, this function will return
the number of available images.
"""
@staticmethod
def CanRead(*args, **kw):
"""
CanRead(filename) -> bool
CanRead(stream) -> bool
Returns true if at least one of the available image handlers can read
the file with the given name.
"""
@staticmethod
def GetImageExtWildcard():
"""
GetImageExtWildcard() -> String
Iterates all registered wxImageHandler objects, and returns a string
containing file extension masks suitable for passing to file open/save
dialog boxes.
"""
@staticmethod
def RGBtoHSV(rgb):
"""
RGBtoHSV(rgb) -> Image.HSVValue
Converts a color in RGB color space to HSV color space.
"""
@staticmethod
def HSVtoRGB(hsv):
"""
HSVtoRGB(hsv) -> Image.RGBValue
Converts a color in HSV color space to RGB color space.
"""
def GetDataBuffer(self):
"""
GetDataBuffer() -> PyObject
Returns a writable Python buffer object that is pointing at the RGB
image data buffer inside the :class:`Image`. You need to ensure that
you do
not use this buffer object after the image has been destroyed.
"""
def GetAlphaBuffer(self):
"""
GetAlphaBuffer() -> PyObject
Returns a writable Python buffer object that is pointing at the Alpha
data buffer inside the :class:`Image`. You need to ensure that you do
not use this buffer object after the image has been destroyed.
"""
def SetDataBuffer(self, *args, **kw):
"""
SetDataBuffer(data)
SetDataBuffer(data, new_width, new_height)
Sets the internal image data 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 lives at least as long as the
:class:`Image` does.
"""
def SetAlphaBuffer(self, alpha):
"""
SetAlphaBuffer(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 lives at least as long as the
:class:`Image` does.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def ConvertToBitmap(self, depth=-1):
"""
ConvertToBitmap(depth=-1) -> Bitmap
Convert the image to a :class:`Bitmap`.
"""
def ConvertToMonoBitmap(self, red, green, blue):
"""
ConvertToMonoBitmap(red, green, blue) -> Bitmap
Creates a monochrome version of the image and returns it as a :class:`Bitmap`.
"""
def AdjustChannels(self, factor_red, factor_green, factor_blue, factor_alpha=1.0):
"""
AdjustChannels(factor_red, factor_green, factor_blue, factor_alpha=1.0) -> Image
This function muliplies all 4 channels (red, green, blue, alpha) with
a factor (around 1.0). Useful for gamma correction, colour correction
and to add a certain amount of transparency to a image (fade in fade
out effects). If factor_alpha is given but the original image has no
alpha channel then a alpha channel will be added.
"""
Width = property(None, None)
Height = property(None, None)
MaskBlue = property(None, None)
MaskGreen = property(None, None)
MaskRed = property(None, None)
Type = property(None, None)
# end of class Image
class ImageHistogram(Object):
"""
ImageHistogram()
"""
def __init__(self):
"""
ImageHistogram()
"""
def FindFirstUnusedColour(self, startR=1, startG=0, startB=0):
"""
FindFirstUnusedColour(startR=1, startG=0, startB=0) -> (r, g, b)
"""
@staticmethod
def MakeKey(r, g, b):
"""
MakeKey(r, g, b) -> unsignedlong
"""
# end of class ImageHistogram
class ImageHandler(Object):
"""
ImageHandler()
This is the base class for implementing image file loading/saving, and
image creation from data.
"""
def __init__(self):
"""
ImageHandler()
This is the base class for implementing image file loading/saving, and
image creation from data.
"""
def CanRead(self, *args, **kw):
"""
CanRead(stream) -> bool
CanRead(filename) -> bool
Returns true if this handler supports the image format contained in
the given stream.
"""
def GetExtension(self):
"""
GetExtension() -> String
Gets the preferred file extension associated with this handler.
"""
def GetAltExtensions(self):
"""
GetAltExtensions() -> ArrayString
Returns the other file extensions associated with this handler.
"""
def GetImageCount(self, stream):
"""
GetImageCount(stream) -> int
If the image file contains more than one image and the image handler
is capable of retrieving these individually, this function will return
the number of available images.
"""
def GetMimeType(self):
"""
GetMimeType() -> String
Gets the MIME type associated with this handler.
"""
def GetName(self):
"""
GetName() -> String
Gets the name of this handler.
"""
def GetType(self):
"""
GetType() -> BitmapType
Gets the image type associated with this handler.
"""
def LoadFile(self, image, stream, verbose=True, index=-1):
"""
LoadFile(image, stream, verbose=True, index=-1) -> bool
Loads a image from a stream, putting the resulting data into image.
"""
def SaveFile(self, image, stream, verbose=True):
"""
SaveFile(image, stream, verbose=True) -> bool
Saves a image in the output stream.
"""
def SetExtension(self, extension):
"""
SetExtension(extension)
Sets the preferred file extension associated with this handler.
"""
def SetAltExtensions(self, extensions):
"""
SetAltExtensions(extensions)
Sets the alternative file extensions associated with this handler.
"""
def SetMimeType(self, mimetype):
"""
SetMimeType(mimetype)
Sets the handler MIME type.
"""
def SetName(self, name):
"""
SetName(name)
Sets the handler name.
"""
AltExtensions = property(None, None)
Extension = property(None, None)
MimeType = property(None, None)
Name = property(None, None)
Type = property(None, None)
def DoGetImageCount(self, stream):
"""
DoGetImageCount(stream) -> int
Called to get the number of images available in a multi-image file
type, if supported.
"""
def DoCanRead(self, stream):
"""
DoCanRead(stream) -> bool
Called to test if this handler can read an image from the given
stream.
"""
# end of class ImageHandler
def InitAllImageHandlers():
"""
InitAllImageHandlers()
Initializes all available image handlers.
"""
NullImage = Image()
@wx.deprecated
def EmptyImage(width=0, height=0, clear=True):
"""
A compatibility wrapper for the wx.Image(width, height) constructor
"""
pass
@wx.deprecated
def ImageFromBitmap(bitmap):
"""
Create a :class:`Image` from a :class:`Bitmap`
"""
pass
@wx.deprecated
def ImageFromStream(stream, type=BITMAP_TYPE_ANY, index=-1):
"""
Load an image from a stream (file-like object)
"""
pass
@wx.deprecated
def ImageFromData(width, height, data):
"""
Compatibility wrapper for creating an image from RGB data
"""
pass
@wx.deprecated
def ImageFromDataWithAlpha(width, height, data, alpha):
"""
Compatibility wrapper for creating an image from RGB and Alpha data
"""
pass
def ImageFromBuffer(width, height, dataBuffer, alphaBuffer=None):
"""
Creates a :class:`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 :class:`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 :class:`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 :class:`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 :class:`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.
"""
pass
IMAGE_OPTION_QUALITY = "quality"
IMAGE_OPTION_FILENAME = "FileName"
IMAGE_OPTION_RESOLUTION = "Resolution"
IMAGE_OPTION_RESOLUTIONX = "ResolutionX"
IMAGE_OPTION_RESOLUTIONY = "ResolutionY"
IMAGE_OPTION_RESOLUTIONUNIT = "ResolutionUnit"
IMAGE_OPTION_MAX_WIDTH = "MaxWidth"
IMAGE_OPTION_MAX_HEIGHT = "MaxHeight"
IMAGE_OPTION_ORIGINAL_WIDTH = "OriginalWidth"
IMAGE_OPTION_ORIGINAL_HEIGHT = "OriginalHeight"
IMAGE_OPTION_BMP_FORMAT = "wxBMP_FORMAT"
IMAGE_OPTION_CUR_HOTSPOT_X = "HotSpotX"
IMAGE_OPTION_CUR_HOTSPOT_Y = "HotSpotY"
IMAGE_OPTION_GIF_COMMENT = "GifComment"
IMAGE_OPTION_PNG_FORMAT = "PngFormat"
IMAGE_OPTION_PNG_BITDEPTH = "PngBitDepth"
IMAGE_OPTION_PNG_FILTER = "PngF"
IMAGE_OPTION_PNG_COMPRESSION_LEVEL = "PngZL"
IMAGE_OPTION_PNG_COMPRESSION_MEM_LEVEL = "PngZM"
IMAGE_OPTION_PNG_COMPRESSION_STRATEGY = "PngZS"
IMAGE_OPTION_PNG_COMPRESSION_BUFFER_SIZE = "PngZB"
IMAGE_OPTION_TIFF_BITSPERSAMPLE = "BitsPerSample"
IMAGE_OPTION_TIFF_SAMPLESPERPIXEL = "SamplesPerPixel"
IMAGE_OPTION_TIFF_COMPRESSION = "Compression"
IMAGE_OPTION_TIFF_PHOTOMETRIC = "Photometric"
IMAGE_OPTION_TIFF_IMAGEDESCRIPTOR = "ImageDescriptor"
#-- end-image --#
#-- begin-gdiobj --#
class GDIObject(Object):
"""
GDIObject()
This class allows platforms to implement functionality to optimise GDI
objects, such as wxPen, wxBrush and wxFont.
"""
def __init__(self):
"""
GDIObject()
This class allows platforms to implement functionality to optimise GDI
objects, such as wxPen, wxBrush and wxFont.
"""
# end of class GDIObject
#-- end-gdiobj --#
#-- begin-bitmap --#
BitmapBufferFormat_RGB = 0
BitmapBufferFormat_RGBA = 0
BitmapBufferFormat_RGB32 = 0
BitmapBufferFormat_ARGB32 = 0
BITMAP_SCREEN_DEPTH = 0
class Bitmap(GDIObject):
"""
Bitmap()
Bitmap(bitmap)
Bitmap(bits, width, height, depth=1)
Bitmap(width, height, depth=BITMAP_SCREEN_DEPTH)
Bitmap(sz, depth=BITMAP_SCREEN_DEPTH)
Bitmap(name, type=BITMAP_TYPE_ANY)
Bitmap(img, depth=BITMAP_SCREEN_DEPTH)
Bitmap(listOfBytes)
This class encapsulates the concept of a platform-dependent bitmap,
either monochrome or colour or colour with alpha channel support.
"""
def __init__(self, *args, **kw):
"""
Bitmap()
Bitmap(bitmap)
Bitmap(bits, width, height, depth=1)
Bitmap(width, height, depth=BITMAP_SCREEN_DEPTH)
Bitmap(sz, depth=BITMAP_SCREEN_DEPTH)
Bitmap(name, type=BITMAP_TYPE_ANY)
Bitmap(img, depth=BITMAP_SCREEN_DEPTH)
Bitmap(listOfBytes)
This class encapsulates the concept of a platform-dependent bitmap,
either monochrome or colour or colour with alpha channel support.
"""
def ConvertToImage(self):
"""
ConvertToImage() -> Image
Creates an image from a platform-dependent bitmap.
"""
def CopyFromIcon(self, icon):
"""
CopyFromIcon(icon) -> bool
Creates the bitmap from an icon.
"""
def Create(self, *args, **kw):
"""
Create(width, height, depth=BITMAP_SCREEN_DEPTH) -> bool
Create(sz, depth=BITMAP_SCREEN_DEPTH) -> bool
Creates a fresh bitmap.
"""
def GetDepth(self):
"""
GetDepth() -> int
Gets the colour depth of the bitmap.
"""
def GetHeight(self):
"""
GetHeight() -> int
Gets the height of the bitmap in pixels.
"""
def GetMask(self):
"""
GetMask() -> Mask
Gets the associated mask (if any) which may have been loaded from a
file or set for the bitmap.
"""
def GetPalette(self):
"""
GetPalette() -> Palette
Gets the associated palette (if any) which may have been loaded from a
file or set for the bitmap.
"""
def GetSubBitmap(self, rect):
"""
GetSubBitmap(rect) -> Bitmap
Returns a sub bitmap of the current one as long as the rect belongs
entirely to the bitmap.
"""
def GetSize(self):
"""
GetSize() -> Size
Returns the size of the bitmap in pixels.
"""
def ConvertToDisabled(self, brightness=255):
"""
ConvertToDisabled(brightness=255) -> Bitmap
Returns disabled (dimmed) version of the bitmap.
"""
def GetWidth(self):
"""
GetWidth() -> int
Gets the width of the bitmap in pixels.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if bitmap data is present.
"""
def LoadFile(self, name, type=BITMAP_TYPE_ANY):
"""
LoadFile(name, type=BITMAP_TYPE_ANY) -> bool
Loads a bitmap from a file or resource.
"""
def SaveFile(self, name, type, palette=None):
"""
SaveFile(name, type, palette=None) -> bool
Saves a bitmap in the named file.
"""
def SetDepth(self, depth):
"""
SetDepth(depth)
Sets the depth member (does not affect the bitmap data).
"""
def SetHeight(self, height):
"""
SetHeight(height)
Sets the height member (does not affect the bitmap data).
"""
def SetMask(self, mask):
"""
SetMask(mask)
Sets the mask for this bitmap.
"""
def SetPalette(self, palette):
"""
SetPalette(palette)
Sets the associated palette.
"""
def SetWidth(self, width):
"""
SetWidth(width)
Sets the width member (does not affect the bitmap data).
"""
@staticmethod
def NewFromPNGData(data, size):
"""
NewFromPNGData(data, size) -> Bitmap
Loads a bitmap from the memory containing image data in PNG format.
"""
def SetMaskColour(self, colour):
"""
SetMaskColour(colour)
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def GetHandle(self):
"""
GetHandle() -> long
MSW-only method to fetch the windows handle for the bitmap.
"""
def SetHandle(self, handle):
"""
SetHandle(handle)
MSW-only method to set the windows handle for the bitmap.
"""
def SetSize(self, size):
"""
SetSize(size)
Set the bitmap size (does not alter the existing native bitmap data or
image size).
"""
def CopyFromBuffer(self, data, format=BitmapBufferFormat_RGB, stride=-1):
"""
CopyFromBuffer(data, format=BitmapBufferFormat_RGB, stride=-1)
Copy data from a buffer object to replace the bitmap pixel data.
Default format is plain RGB, but other formats are now supported as
well. The following symbols are used to specify the format of the
bytes in the buffer:
============================= ================================
wx.BitmapBufferFormat_RGB A simple sequence of RGB bytes
wx.BitmapBufferFormat_RGBA A simple sequence of RGBA bytes
wx.BitmapBufferFormat_ARGB32 A sequence of 32-bit values in
native endian order, with alpha in the upper 8 bits, followed by red,
green, and blue.
wx.BitmapBufferFormat_RGB32 Same as above but the alpha byte is
ignored.
============================= ================================
"""
def CopyToBuffer(self, data, format=BitmapBufferFormat_RGB, stride=-1):
"""
CopyToBuffer(data, format=BitmapBufferFormat_RGB, stride=-1)
Copy pixel data to a buffer object. See :meth:`CopyFromBuffer` for
buffer
format details.
"""
@staticmethod
def FromBufferAndAlpha(width, height, data, alpha):
"""
FromBufferAndAlpha(width, height, data, alpha) -> Bitmap
Creates a :class:`Bitmap` from in-memory data. The data and alpha
parameters must be a Python object that implements the buffer
interface, such as a string, bytearray, etc. The data object
is expected to contain a series of RGB bytes and be at least
width*height*3 bytes long, while the alpha object is expected
to be width*height bytes long and represents the image's alpha
channel. On Windows and Mac the RGB values will be
'premultiplied' by the alpha values. (The other platforms do
the multiplication themselves.)
Unlike :func:`ImageFromBuffer` the bitmap created with this function
does not share the memory block with the buffer object. This is
because the native pixel buffer format varies on different
platforms, and so instead an efficient as possible copy of the
data is made from the buffer object to the bitmap's native pixel
buffer.
"""
@staticmethod
def FromBuffer(width, height, data):
"""
FromBuffer(width, height, data) -> Bitmap
Creates a :class:`Bitmap` from in-memory data. The data parameter
must be a Python object that implements the buffer interface, such
as a string, bytearray, etc. The data object is expected to contain
a series of RGB bytes and be at least width*height*3 bytes long.
Unlike :func:`ImageFromBuffer` the bitmap created with this function
does not share the memory block with the buffer object. This is
because the native pixel buffer format varies on different
platforms, and so instead an efficient as possible copy of the
data is made from the buffer object to the bitmap's native pixel
buffer.
"""
@staticmethod
def FromBufferRGBA(width, height, data):
"""
FromBufferRGBA(width, height, data) -> Bitmap
Creates a :class:`Bitmap` from in-memory data. The data parameter
must be a Python object that implements the buffer interface, such
as a string, bytearray, etc. The data object is expected to contain
a series of RGBA bytes and be at least width*height*4 bytes long.
On Windows and Mac the RGB values will be 'premultiplied' by the
alpha values. (The other platforms do the multiplication themselves.)
Unlike :func:`ImageFromBuffer` the bitmap created with this function
does not share the memory block with the buffer object. This is
because the native pixel buffer format varies on different
platforms, and so instead an efficient as possible copy of the
data is made from the buffer object to the bitmap's native pixel
buffer.
"""
@staticmethod
def FromRGBA(width, height, red=0, green=0, blue=0, alpha=0):
"""
FromRGBA(width, height, red=0, green=0, blue=0, alpha=0) -> Bitmap
Creates a new empty 32-bit :class:`Bitmap` where every pixel has been
initialized with the given RGBA values.
"""
Depth = property(None, None)
Handle = property(None, None)
Height = property(None, None)
Mask = property(None, None)
Palette = property(None, None)
Size = property(None, None)
Width = property(None, None)
# end of class Bitmap
class Mask(Object):
"""
Mask()
Mask(bitmap, index)
Mask(bitmap)
Mask(bitmap, colour)
This class encapsulates a monochrome mask bitmap, where the masked
area is black and the unmasked area is white.
"""
def __init__(self, *args, **kw):
"""
Mask()
Mask(bitmap, index)
Mask(bitmap)
Mask(bitmap, colour)
This class encapsulates a monochrome mask bitmap, where the masked
area is black and the unmasked area is white.
"""
def Create(self, *args, **kw):
"""
Create(bitmap, index) -> bool
Create(bitmap) -> bool
Create(bitmap, colour) -> bool
Constructs a mask from a bitmap and a palette index that indicates the
background.
"""
def GetBitmap(self):
"""
GetBitmap() -> Bitmap
Returns the mask as a monochrome bitmap.
"""
Bitmap = property(None, None)
# end of class Mask
NullBitmap = Bitmap()
@wx.deprecated
def BitmapFromBuffer(width, height, dataBuffer, alphaBuffer=None):
"""
A compatibility wrapper for :meth:`Bitmap.FromBuffer` and :meth:`Bitmap.FromBufferAndAlpha`
"""
pass
@wx.deprecated
def BitmapFromBufferRGBA(width, height, dataBuffer):
"""
A compatibility wrapper for :meth:`Bitmap.FromBufferRGBA`
"""
pass
@wx.deprecated
def EmptyBitmapRGBA(width, height, red=0, green=0, blue=0, alpha=0):
"""
A compatibility wrapper for :meth:`Bitmap.FromRGBA`
"""
pass
@wx.deprecated
def EmptyBitmap(width, height, depth=BITMAP_SCREEN_DEPTH):
"""
A compatibility wrapper for the wx.Bitmap(width, height, depth) constructor
"""
pass
@wx.deprecated
def BitmapFromImage(image):
"""
A compatibility wrapper for the wx.Bitmap(wx.Image) constructor
"""
pass
#-- end-bitmap --#
#-- begin-icon --#
ICON_SCREEN_DEPTH = 0
class Icon(GDIObject):
"""
Icon()
Icon(icon)
Icon(name, type=BITMAP_TYPE_ANY, desiredWidth=-1, desiredHeight=-1)
Icon(loc)
Icon(bmp)
An icon is a small rectangular bitmap usually used for denoting a
minimized application.
"""
def __init__(self, *args, **kw):
"""
Icon()
Icon(icon)
Icon(name, type=BITMAP_TYPE_ANY, desiredWidth=-1, desiredHeight=-1)
Icon(loc)
Icon(bmp)
An icon is a small rectangular bitmap usually used for denoting a
minimized application.
"""
def CreateFromHICON(self, hicon):
"""
CreateFromHICON(hicon) -> bool
MSW-only method to create a wx.Icon from a native icon handle.
"""
def CopyFromBitmap(self, bmp):
"""
CopyFromBitmap(bmp)
Copies bmp bitmap to this icon.
"""
def GetDepth(self):
"""
GetDepth() -> int
Gets the colour depth of the icon.
"""
def GetHeight(self):
"""
GetHeight() -> int
Gets the height of the icon in pixels.
"""
def GetWidth(self):
"""
GetWidth() -> int
Gets the width of the icon in pixels.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if icon data is present.
"""
def LoadFile(self, name, type=BITMAP_TYPE_ANY, desiredWidth=-1, desiredHeight=-1):
"""
LoadFile(name, type=BITMAP_TYPE_ANY, desiredWidth=-1, desiredHeight=-1) -> bool
Loads an icon from a file or resource.
"""
def SetDepth(self, depth):
"""
SetDepth(depth)
Sets the depth member (does not affect the icon data).
"""
def SetHeight(self, height):
"""
SetHeight(height)
Sets the height member (does not affect the icon data).
"""
def SetWidth(self, width):
"""
SetWidth(width)
Sets the width member (does not affect the icon data).
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def GetHandle(self):
"""
GetHandle() -> long
"""
def SetHandle(self, handle):
"""
SetHandle(handle)
"""
Depth = property(None, None)
Handle = property(None, None)
Height = property(None, None)
Width = property(None, None)
# end of class Icon
NullIcon = Icon()
@wx.deprecated
def EmptyIcon():
"""
A compatibility wrapper for the :class:`Icon` constructor
"""
pass
#-- end-icon --#
#-- begin-iconloc --#
class IconLocation(object):
"""
IconLocation()
IconLocation(filename, num=0)
wxIconLocation is a tiny class describing the location of an
(external, i.e.
"""
def __init__(self, *args, **kw):
"""
IconLocation()
IconLocation(filename, num=0)
wxIconLocation is a tiny class describing the location of an
(external, i.e.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the object is valid, i.e. was properly initialized,
and false otherwise.
"""
def SetFileName(self, filename):
"""
SetFileName(filename)
"""
def GetFileName(self):
"""
GetFileName() -> String
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def GetIndex(self):
"""
GetIndex() -> int
"""
def SetIndex(self, num):
"""
SetIndex(num)
"""
FileName = property(None, None)
Index = property(None, None)
# end of class IconLocation
#-- end-iconloc --#
#-- begin-iconbndl --#
class IconBundle(GDIObject):
"""
IconBundle()
IconBundle(file, type=BITMAP_TYPE_ANY)
IconBundle(stream, type=BITMAP_TYPE_ANY)
IconBundle(icon)
IconBundle(ic)
This class contains multiple copies of an icon in different sizes.
"""
FALLBACK_NONE = 0
FALLBACK_SYSTEM = 0
FALLBACK_NEAREST_LARGER = 0
def __init__(self, *args, **kw):
"""
IconBundle()
IconBundle(file, type=BITMAP_TYPE_ANY)
IconBundle(stream, type=BITMAP_TYPE_ANY)
IconBundle(icon)
IconBundle(ic)
This class contains multiple copies of an icon in different sizes.
"""
def AddIcon(self, *args, **kw):
"""
AddIcon(file, type=BITMAP_TYPE_ANY)
AddIcon(stream, type=BITMAP_TYPE_ANY)
AddIcon(icon)
Adds all the icons contained in the file to the bundle; if the
collection already contains icons with the same width and height, they
are replaced by the new ones.
"""
def GetIcon(self, *args, **kw):
"""
GetIcon(size, flags=FALLBACK_SYSTEM) -> Icon
GetIcon(size=DefaultCoord, flags=FALLBACK_SYSTEM) -> Icon
Returns the icon with the given size.
"""
def GetIconOfExactSize(self, size):
"""
GetIconOfExactSize(size) -> Icon
Returns the icon with exactly the given size or wxNullIcon if this
size is not available.
"""
def GetIconCount(self):
"""
GetIconCount() -> size_t
return the number of available icons
"""
def GetIconByIndex(self, n):
"""
GetIconByIndex(n) -> Icon
return the icon at index (must be < GetIconCount())
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Returns true if the bundle doesn't contain any icons, false otherwise
(in which case a call to GetIcon() with default parameter should
return a valid icon).
"""
Icon = property(None, None)
IconCount = property(None, None)
# end of class IconBundle
NullIconBundle = IconBundle()
#-- end-iconbndl --#
#-- begin-font --#
FONTFAMILY_DEFAULT = 0
FONTFAMILY_DECORATIVE = 0
FONTFAMILY_ROMAN = 0
FONTFAMILY_SCRIPT = 0
FONTFAMILY_SWISS = 0
FONTFAMILY_MODERN = 0
FONTFAMILY_TELETYPE = 0
FONTFAMILY_MAX = 0
FONTFAMILY_UNKNOWN = 0
FONTSTYLE_NORMAL = 0
FONTSTYLE_ITALIC = 0
FONTSTYLE_SLANT = 0
FONTSTYLE_MAX = 0
FONTWEIGHT_NORMAL = 0
FONTWEIGHT_LIGHT = 0
FONTWEIGHT_BOLD = 0
FONTWEIGHT_MAX = 0
FONTSIZE_XX_SMALL = 0
FONTSIZE_X_SMALL = 0
FONTSIZE_SMALL = 0
FONTSIZE_MEDIUM = 0
FONTSIZE_LARGE = 0
FONTSIZE_X_LARGE = 0
FONTSIZE_XX_LARGE = 0
FONTFLAG_DEFAULT = 0
FONTFLAG_ITALIC = 0
FONTFLAG_SLANT = 0
FONTFLAG_LIGHT = 0
FONTFLAG_BOLD = 0
FONTFLAG_ANTIALIASED = 0
FONTFLAG_NOT_ANTIALIASED = 0
FONTFLAG_UNDERLINED = 0
FONTFLAG_STRIKETHROUGH = 0
FONTFLAG_MASK = 0
FONTENCODING_SYSTEM = 0
FONTENCODING_DEFAULT = 0
FONTENCODING_ISO8859_1 = 0
FONTENCODING_ISO8859_2 = 0
FONTENCODING_ISO8859_3 = 0
FONTENCODING_ISO8859_4 = 0
FONTENCODING_ISO8859_5 = 0
FONTENCODING_ISO8859_6 = 0
FONTENCODING_ISO8859_7 = 0
FONTENCODING_ISO8859_8 = 0
FONTENCODING_ISO8859_9 = 0
FONTENCODING_ISO8859_10 = 0
FONTENCODING_ISO8859_11 = 0
FONTENCODING_ISO8859_12 = 0
FONTENCODING_ISO8859_13 = 0
FONTENCODING_ISO8859_14 = 0
FONTENCODING_ISO8859_15 = 0
FONTENCODING_ISO8859_MAX = 0
FONTENCODING_KOI8 = 0
FONTENCODING_KOI8_U = 0
FONTENCODING_ALTERNATIVE = 0
FONTENCODING_BULGARIAN = 0
FONTENCODING_CP437 = 0
FONTENCODING_CP850 = 0
FONTENCODING_CP852 = 0
FONTENCODING_CP855 = 0
FONTENCODING_CP866 = 0
FONTENCODING_CP874 = 0
FONTENCODING_CP932 = 0
FONTENCODING_CP936 = 0
FONTENCODING_CP949 = 0
FONTENCODING_CP950 = 0
FONTENCODING_CP1250 = 0
FONTENCODING_CP1251 = 0
FONTENCODING_CP1252 = 0
FONTENCODING_CP1253 = 0
FONTENCODING_CP1254 = 0
FONTENCODING_CP1255 = 0
FONTENCODING_CP1256 = 0
FONTENCODING_CP1257 = 0
FONTENCODING_CP1258 = 0
FONTENCODING_CP1361 = 0
FONTENCODING_CP12_MAX = 0
FONTENCODING_UTF7 = 0
FONTENCODING_UTF8 = 0
FONTENCODING_EUC_JP = 0
FONTENCODING_UTF16BE = 0
FONTENCODING_UTF16LE = 0
FONTENCODING_UTF32BE = 0
FONTENCODING_UTF32LE = 0
FONTENCODING_MACROMAN = 0
FONTENCODING_MACJAPANESE = 0
FONTENCODING_MACCHINESETRAD = 0
FONTENCODING_MACKOREAN = 0
FONTENCODING_MACARABIC = 0
FONTENCODING_MACHEBREW = 0
FONTENCODING_MACGREEK = 0
FONTENCODING_MACCYRILLIC = 0
FONTENCODING_MACDEVANAGARI = 0
FONTENCODING_MACGURMUKHI = 0
FONTENCODING_MACGUJARATI = 0
FONTENCODING_MACORIYA = 0
FONTENCODING_MACBENGALI = 0
FONTENCODING_MACTAMIL = 0
FONTENCODING_MACTELUGU = 0
FONTENCODING_MACKANNADA = 0
FONTENCODING_MACMALAJALAM = 0
FONTENCODING_MACSINHALESE = 0
FONTENCODING_MACBURMESE = 0
FONTENCODING_MACKHMER = 0
FONTENCODING_MACTHAI = 0
FONTENCODING_MACLAOTIAN = 0
FONTENCODING_MACGEORGIAN = 0
FONTENCODING_MACARMENIAN = 0
FONTENCODING_MACCHINESESIMP = 0
FONTENCODING_MACTIBETAN = 0
FONTENCODING_MACMONGOLIAN = 0
FONTENCODING_MACETHIOPIC = 0
FONTENCODING_MACCENTRALEUR = 0
FONTENCODING_MACVIATNAMESE = 0
FONTENCODING_MACARABICEXT = 0
FONTENCODING_MACSYMBOL = 0
FONTENCODING_MACDINGBATS = 0
FONTENCODING_MACTURKISH = 0
FONTENCODING_MACCROATIAN = 0
FONTENCODING_MACICELANDIC = 0
FONTENCODING_MACROMANIAN = 0
FONTENCODING_MACCELTIC = 0
FONTENCODING_MACGAELIC = 0
FONTENCODING_MACKEYBOARD = 0
FONTENCODING_ISO2022_JP = 0
FONTENCODING_MAX = 0
FONTENCODING_MACMIN = 0
FONTENCODING_MACMAX = 0
FONTENCODING_UTF16 = 0
FONTENCODING_UTF32 = 0
FONTENCODING_UNICODE = 0
FONTENCODING_GB2312 = 0
FONTENCODING_BIG5 = 0
FONTENCODING_SHIFT_JIS = 0
FONTENCODING_EUC_KR = 0
FONTENCODING_JOHAB = 0
FONTENCODING_VIETNAMESE = 0
class FontInfo(object):
"""
FontInfo()
FontInfo(pointSize)
FontInfo(pixelSize)
This class is a helper used for wxFont creation using named parameter
idiom: it allows to specify various wxFont attributes using the
chained calls to its clearly named methods instead of passing them in
the fixed order to wxFont constructors.
"""
def __init__(self, *args, **kw):
"""
FontInfo()
FontInfo(pointSize)
FontInfo(pixelSize)
This class is a helper used for wxFont creation using named parameter
idiom: it allows to specify various wxFont attributes using the
chained calls to its clearly named methods instead of passing them in
the fixed order to wxFont constructors.
"""
def Family(self, family):
"""
Family(family) -> FontInfo
Set the font family.
"""
def FaceName(self, faceName):
"""
FaceName(faceName) -> FontInfo
Set the font face name to use.
"""
def Bold(self, bold=True):
"""
Bold(bold=True) -> FontInfo
Use a bold version of the font.
"""
def Light(self, light=True):
"""
Light(light=True) -> FontInfo
Use a lighter version of the font.
"""
def Italic(self, italic=True):
"""
Italic(italic=True) -> FontInfo
Use an italic version of the font.
"""
def Slant(self, slant=True):
"""
Slant(slant=True) -> FontInfo
Use a slanted version of the font.
"""
def AntiAliased(self, antiAliased=True):
"""
AntiAliased(antiAliased=True) -> FontInfo
Set anti-aliasing flag.
"""
def Underlined(self, underlined=True):
"""
Underlined(underlined=True) -> FontInfo
Use an underlined version of the font.
"""
def Strikethrough(self, strikethrough=True):
"""
Strikethrough(strikethrough=True) -> FontInfo
Use a strike-through version of the font.
"""
def Encoding(self, encoding):
"""
Encoding(encoding) -> FontInfo
Set the font encoding to use.
"""
def AllFlags(self, flags):
"""
AllFlags(flags) -> FontInfo
Set all the font attributes at once.
"""
# end of class FontInfo
class Font(GDIObject):
"""
Font()
Font(font)
Font(font)
Font(pointSize, family, style, weight, underline=False, faceName=EmptyString, encoding=FONTENCODING_DEFAULT)
Font(pixelSize, family, style, weight, underline=False, faceName=EmptyString, encoding=FONTENCODING_DEFAULT)
Font(nativeInfoString)
Font(nativeInfo)
A font is an object which determines the appearance of text.
"""
def __init__(self, *args, **kw):
"""
Font()
Font(font)
Font(font)
Font(pointSize, family, style, weight, underline=False, faceName=EmptyString, encoding=FONTENCODING_DEFAULT)
Font(pixelSize, family, style, weight, underline=False, faceName=EmptyString, encoding=FONTENCODING_DEFAULT)
Font(nativeInfoString)
Font(nativeInfo)
A font is an object which determines the appearance of text.
"""
def GetEncoding(self):
"""
GetEncoding() -> FontEncoding
Returns the encoding of this font.
"""
def GetFaceName(self):
"""
GetFaceName() -> String
Returns the face name associated with the font, or the empty string if
there is no face information.
"""
def GetFamily(self):
"""
GetFamily() -> FontFamily
Gets the font family if possible.
"""
def GetNativeFontInfoDesc(self):
"""
GetNativeFontInfoDesc() -> String
Returns the platform-dependent string completely describing this font.
"""
def GetNativeFontInfoUserDesc(self):
"""
GetNativeFontInfoUserDesc() -> String
Returns a user-friendly string for this font object.
"""
def GetNativeFontInfo(self):
"""
GetNativeFontInfo() -> NativeFontInfo
Returns the encoding of this font.
"""
def GetPointSize(self):
"""
GetPointSize() -> int
Gets the point size.
"""
def GetPixelSize(self):
"""
GetPixelSize() -> Size
Gets the pixel size.
"""
def GetStyle(self):
"""
GetStyle() -> FontStyle
Gets the font style.
"""
def GetUnderlined(self):
"""
GetUnderlined() -> bool
Returns true if the font is underlined, false otherwise.
"""
def GetStrikethrough(self):
"""
GetStrikethrough() -> bool
Returns true if the font is stricken-through, false otherwise.
"""
def GetWeight(self):
"""
GetWeight() -> FontWeight
Gets the font weight.
"""
def IsFixedWidth(self):
"""
IsFixedWidth() -> bool
Returns true if the font is a fixed width (or monospaced) font, false
if it is a proportional one or font is invalid.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if this object is a valid font, false otherwise.
"""
def Bold(self):
"""
Bold() -> Font
Returns a bold version of this font.
"""
def Italic(self):
"""
Italic() -> Font
Returns an italic version of this font.
"""
def Larger(self):
"""
Larger() -> Font
Returns a larger version of this font.
"""
def Smaller(self):
"""
Smaller() -> Font
Returns a smaller version of this font.
"""
def Underlined(self):
"""
Underlined() -> Font
Returns underlined version of this font.
"""
def Strikethrough(self):
"""
Strikethrough() -> Font
Returns stricken-through version of this font.
"""
def MakeBold(self):
"""
MakeBold() -> Font
Changes this font to be bold.
"""
def MakeItalic(self):
"""
MakeItalic() -> Font
Changes this font to be italic.
"""
def MakeLarger(self):
"""
MakeLarger() -> Font
Changes this font to be larger.
"""
def MakeSmaller(self):
"""
MakeSmaller() -> Font
Changes this font to be smaller.
"""
def MakeUnderlined(self):
"""
MakeUnderlined() -> Font
Changes this font to be underlined.
"""
def MakeStrikethrough(self):
"""
MakeStrikethrough() -> Font
Changes this font to be stricken-through.
"""
def Scale(self, x):
"""
Scale(x) -> Font
Changes the size of this font.
"""
def Scaled(self, x):
"""
Scaled(x) -> Font
Returns a scaled version of this font.
"""
def SetEncoding(self, encoding):
"""
SetEncoding(encoding)
Sets the encoding for this font.
"""
def SetFaceName(self, faceName):
"""
SetFaceName(faceName) -> bool
Sets the facename for the font.
"""
def SetFamily(self, family):
"""
SetFamily(family)
Sets the font family.
"""
def SetNativeFontInfo(self, *args, **kw):
"""
SetNativeFontInfo(info) -> bool
SetNativeFontInfo(info)
Creates the font corresponding to the given native font description
string which must have been previously returned by
GetNativeFontInfoDesc().
"""
def SetNativeFontInfoUserDesc(self, info):
"""
SetNativeFontInfoUserDesc(info) -> bool
Creates the font corresponding to the given native font description
string and returns true if the creation was successful.
"""
def SetPointSize(self, pointSize):
"""
SetPointSize(pointSize)
Sets the point size.
"""
def SetPixelSize(self, pixelSize):
"""
SetPixelSize(pixelSize)
Sets the pixel size.
"""
def SetStyle(self, style):
"""
SetStyle(style)
Sets the font style.
"""
def SetSymbolicSize(self, size):
"""
SetSymbolicSize(size)
Sets the font size using a predefined symbolic size name.
"""
def SetSymbolicSizeRelativeTo(self, size, base):
"""
SetSymbolicSizeRelativeTo(size, base)
Sets the font size compared to the base font size.
"""
def SetUnderlined(self, underlined):
"""
SetUnderlined(underlined)
Sets underlining.
"""
def SetStrikethrough(self, strikethrough):
"""
SetStrikethrough(strikethrough)
Sets strike-through attribute of the font.
"""
def SetWeight(self, weight):
"""
SetWeight(weight)
Sets the font weight.
"""
@staticmethod
def New(*args, **kw):
"""
New(pointSize, family, style, weight, underline=False, faceName=EmptyString, encoding=FONTENCODING_DEFAULT) -> Font
New(pointSize, family, flags=FONTFLAG_DEFAULT, faceName=EmptyString, encoding=FONTENCODING_DEFAULT) -> Font
New(pixelSize, family, style, weight, underline=False, faceName=EmptyString, encoding=FONTENCODING_DEFAULT) -> Font
New(pixelSize, family, flags=FONTFLAG_DEFAULT, faceName=EmptyString, encoding=FONTENCODING_DEFAULT) -> Font
New(nativeInfo) -> Font
New(nativeInfoString) -> Font
This function takes the same parameters as the relative wxFont
constructor and returns a new font object allocated on the heap.
"""
def __ne__(self):
"""
"""
def __eq__(self):
"""
"""
@staticmethod
def GetDefaultEncoding():
"""
GetDefaultEncoding() -> FontEncoding
Returns the current application's default encoding.
"""
@staticmethod
def SetDefaultEncoding(encoding):
"""
SetDefaultEncoding(encoding)
Sets the default font encoding.
"""
Encoding = property(None, None)
FaceName = property(None, None)
Family = property(None, None)
NativeFontInfoDesc = property(None, None)
NativeFontInfoUserDesc = property(None, None)
PointSize = property(None, None)
PixelSize = property(None, None)
Style = property(None, None)
Weight = property(None, None)
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def GetHFONT(self):
"""
GetHFONT() -> void
Returns the font's native handle.
"""
def OSXGetCGFont(self):
"""
OSXGetCGFont() -> void
Returns the font's native handle.
"""
def GetPangoFontDescription(self):
"""
GetPangoFontDescription() -> void
Returns the font's native handle.
"""
def _copyFrom(self, other):
"""
_copyFrom(other)
For internal use only.
"""
def SetNoAntiAliasing(self, no=True):
"""
"""
def GetNoAntiAliasing(self):
"""
"""
# end of class Font
class FontList(object):
"""
FontList()
A font list is a list containing all fonts which have been created.
"""
def __init__(self):
"""
FontList()
A font list is a list containing all fonts which have been created.
"""
def FindOrCreateFont(self, point_size, family, style, weight, underline=False, facename=EmptyString, encoding=FONTENCODING_DEFAULT):
"""
FindOrCreateFont(point_size, family, style, weight, underline=False, facename=EmptyString, encoding=FONTENCODING_DEFAULT) -> Font
Finds a font of the given specification, or creates one and adds it to
the list.
"""
# end of class FontList
NullFont = Font()
def FFont(self, pointSize, family, flags=FONTFLAG_DEFAULT, faceName=EmptyString, encoding=FONTENCODING_DEFAULT):
"""
FFont(pointSize, family, flags=FONTFLAG_DEFAULT, faceName=EmptyString, encoding=FONTENCODING_DEFAULT)
"""
# These stock fonts will be initialized when the wx.App object is created.
NORMAL_FONT = Font()
SMALL_FONT = Font()
ITALIC_FONT = Font()
SWISS_FONT = Font()
wx.DEFAULT = int(wx.FONTFAMILY_DEFAULT)
wx.DECORATIVE = int(wx.FONTFAMILY_DECORATIVE)
wx.ROMAN = int(wx.FONTFAMILY_ROMAN)
wx.SCRIPT = int(wx.FONTFAMILY_SCRIPT)
wx.SWISS = int(wx.FONTFAMILY_SWISS)
wx.MODERN = int(wx.FONTFAMILY_MODERN)
wx.TELETYPE = int(wx.FONTFAMILY_TELETYPE)
wx.NORMAL = int(wx.FONTWEIGHT_NORMAL)
wx.LIGHT = int(wx.FONTWEIGHT_LIGHT)
wx.BOLD = int(wx.FONTWEIGHT_BOLD)
wx.NORMAL = int(wx.FONTSTYLE_NORMAL)
wx.ITALIC = int(wx.FONTSTYLE_ITALIC)
wx.SLANT = int(wx.FONTSTYLE_SLANT)
#-- end-font --#
#-- begin-fontutil --#
class NativeFontInfo(object):
"""
NativeFontInfo()
NativeFontInfo(info)
wxNativeFontInfo is platform-specific font representation: this class
should be considered as an opaque font description only used by the
native functions, the user code can only get the objects of this type
from somewhere and pass it somewhere else (possibly save them
somewhere using ToString() and restore them using FromString())
"""
def __init__(self, *args, **kw):
"""
NativeFontInfo()
NativeFontInfo(info)
wxNativeFontInfo is platform-specific font representation: this class
should be considered as an opaque font description only used by the
native functions, the user code can only get the objects of this type
from somewhere and pass it somewhere else (possibly save them
somewhere using ToString() and restore them using FromString())
"""
def Init(self):
"""
Init()
"""
def InitFromFont(self, font):
"""
InitFromFont(font)
"""
def GetPointSize(self):
"""
GetPointSize() -> int
"""
def GetStyle(self):
"""
GetStyle() -> FontStyle
"""
def GetWeight(self):
"""
GetWeight() -> FontWeight
"""
def GetUnderlined(self):
"""
GetUnderlined() -> bool
"""
def GetFaceName(self):
"""
GetFaceName() -> String
"""
def GetFamily(self):
"""
GetFamily() -> FontFamily
"""
def GetEncoding(self):
"""
GetEncoding() -> FontEncoding
"""
def SetPointSize(self, pointsize):
"""
SetPointSize(pointsize)
"""
def SetStyle(self, style):
"""
SetStyle(style)
"""
def SetWeight(self, weight):
"""
SetWeight(weight)
"""
def SetUnderlined(self, underlined):
"""
SetUnderlined(underlined)
"""
def SetFaceName(self, *args, **kw):
"""
SetFaceName(facename) -> bool
SetFaceName(facenames)
"""
def SetFamily(self, family):
"""
SetFamily(family)
"""
def SetEncoding(self, encoding):
"""
SetEncoding(encoding)
"""
def FromString(self, s):
"""
FromString(s) -> bool
"""
def ToString(self):
"""
ToString() -> String
"""
def FromUserString(self, s):
"""
FromUserString(s) -> bool
"""
def ToUserString(self):
"""
ToUserString() -> String
"""
def __str__(self):
"""
__str__() -> String
"""
Encoding = property(None, None)
FaceName = property(None, None)
Family = property(None, None)
PointSize = property(None, None)
Style = property(None, None)
Underlined = property(None, None)
Weight = property(None, None)
# end of class NativeFontInfo
#-- end-fontutil --#
#-- begin-pen --#
PENSTYLE_INVALID = 0
PENSTYLE_SOLID = 0
PENSTYLE_DOT = 0
PENSTYLE_LONG_DASH = 0
PENSTYLE_SHORT_DASH = 0
PENSTYLE_DOT_DASH = 0
PENSTYLE_USER_DASH = 0
PENSTYLE_TRANSPARENT = 0
PENSTYLE_STIPPLE_MASK_OPAQUE = 0
PENSTYLE_STIPPLE_MASK = 0
PENSTYLE_STIPPLE = 0
PENSTYLE_BDIAGONAL_HATCH = 0
PENSTYLE_CROSSDIAG_HATCH = 0
PENSTYLE_FDIAGONAL_HATCH = 0
PENSTYLE_CROSS_HATCH = 0
PENSTYLE_HORIZONTAL_HATCH = 0
PENSTYLE_VERTICAL_HATCH = 0
PENSTYLE_FIRST_HATCH = 0
PENSTYLE_LAST_HATCH = 0
JOIN_INVALID = 0
JOIN_BEVEL = 0
JOIN_MITER = 0
JOIN_ROUND = 0
CAP_INVALID = 0
CAP_ROUND = 0
CAP_PROJECTING = 0
CAP_BUTT = 0
class Pen(GDIObject):
"""
Pen()
Pen(colour, width=1, style=PENSTYLE_SOLID)
Pen(pen)
A pen is a drawing tool for drawing outlines.
"""
def __init__(self, *args, **kw):
"""
Pen()
Pen(colour, width=1, style=PENSTYLE_SOLID)
Pen(pen)
A pen is a drawing tool for drawing outlines.
"""
def SetColour(self, *args, **kw):
"""
SetColour(colour)
SetColour(red, green, blue)
The pen's colour is changed to the given colour.
"""
def GetCap(self):
"""
GetCap() -> PenCap
Returns the pen cap style, which may be one of wxCAP_ROUND,
wxCAP_PROJECTING and wxCAP_BUTT.
"""
def GetColour(self):
"""
GetColour() -> Colour
Returns a reference to the pen colour.
"""
def GetDashes(self):
"""
GetDashes() -> ArrayInt
Gets an array of dashes (defined as char in X, DWORD under Windows).
"""
def GetJoin(self):
"""
GetJoin() -> PenJoin
Returns the pen join style, which may be one of wxJOIN_BEVEL,
wxJOIN_ROUND and wxJOIN_MITER.
"""
def GetStipple(self):
"""
GetStipple() -> Bitmap
Gets a pointer to the stipple bitmap.
"""
def GetStyle(self):
"""
GetStyle() -> PenStyle
Returns the pen style.
"""
def GetWidth(self):
"""
GetWidth() -> int
Returns the pen width.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the pen is initialised.
"""
def IsNonTransparent(self):
"""
IsNonTransparent() -> bool
Returns true if the pen is a valid non-transparent pen.
"""
def IsTransparent(self):
"""
IsTransparent() -> bool
Returns true if the pen is transparent.
"""
def SetCap(self, capStyle):
"""
SetCap(capStyle)
Sets the pen cap style, which may be one of wxCAP_ROUND,
wxCAP_PROJECTING and wxCAP_BUTT.
"""
def SetDashes(self, dashes):
"""
SetDashes(dashes)
Associates an array of dash values (defined as char in X, DWORD under
Windows) with the pen.
"""
def SetJoin(self, join_style):
"""
SetJoin(join_style)
Sets the pen join style, which may be one of wxJOIN_BEVEL,
wxJOIN_ROUND and wxJOIN_MITER.
"""
def SetStipple(self, stipple):
"""
SetStipple(stipple)
Sets the bitmap for stippling.
"""
def SetStyle(self, style):
"""
SetStyle(style)
Set the pen style.
"""
def SetWidth(self, width):
"""
SetWidth(width)
Sets the pen width.
"""
def __ne__(self):
"""
"""
def __eq__(self):
"""
"""
Cap = property(None, None)
Colour = property(None, None)
Dashes = property(None, None)
Join = property(None, None)
Stipple = property(None, None)
Style = property(None, None)
Width = property(None, None)
def _copyFrom(self, other):
"""
_copyFrom(other)
For internal use only.
"""
# end of class Pen
class PenList(object):
"""
PenList()
There is only one instance of this class: wxThePenList.
"""
def __init__(self):
"""
PenList()
There is only one instance of this class: wxThePenList.
"""
def FindOrCreatePen(self, colour, width=1, style=PENSTYLE_SOLID):
"""
FindOrCreatePen(colour, width=1, style=PENSTYLE_SOLID) -> Pen
Finds a pen with the specified attributes and returns it, else creates
a new pen, adds it to the pen list, and returns it.
"""
# end of class PenList
NullPen = Pen()
# These stock pens will be initialized when the wx.App object is created.
RED_PEN = Pen()
BLUE_PEN = Pen()
CYAN_PEN = Pen()
GREEN_PEN = Pen()
YELLOW_PEN = Pen()
BLACK_PEN = Pen()
WHITE_PEN = Pen()
TRANSPARENT_PEN = Pen()
BLACK_DASHED_PEN = Pen()
GREY_PEN = Pen()
MEDIUM_GREY_PEN = Pen()
LIGHT_GREY_PEN = Pen()
wx.SOLID = int(wx.PENSTYLE_SOLID)
wx.DOT = int(wx.PENSTYLE_DOT)
wx.LONG_DASH = int(wx.PENSTYLE_LONG_DASH)
wx.SHORT_DASH = int(wx.PENSTYLE_SHORT_DASH)
wx.DOT_DASH = int(wx.PENSTYLE_DOT_DASH)
wx.USER_DASH = int(wx.PENSTYLE_USER_DASH)
wx.TRANSPARENT = int(wx.PENSTYLE_TRANSPARENT)
#-- end-pen --#
#-- begin-brush --#
BRUSHSTYLE_INVALID = 0
BRUSHSTYLE_SOLID = 0
BRUSHSTYLE_TRANSPARENT = 0
BRUSHSTYLE_STIPPLE_MASK_OPAQUE = 0
BRUSHSTYLE_STIPPLE_MASK = 0
BRUSHSTYLE_STIPPLE = 0
BRUSHSTYLE_BDIAGONAL_HATCH = 0
BRUSHSTYLE_CROSSDIAG_HATCH = 0
BRUSHSTYLE_FDIAGONAL_HATCH = 0
BRUSHSTYLE_CROSS_HATCH = 0
BRUSHSTYLE_HORIZONTAL_HATCH = 0
BRUSHSTYLE_VERTICAL_HATCH = 0
BRUSHSTYLE_FIRST_HATCH = 0
BRUSHSTYLE_LAST_HATCH = 0
class Brush(GDIObject):
"""
Brush()
Brush(colour, style=BRUSHSTYLE_SOLID)
Brush(stippleBitmap)
Brush(brush)
A brush is a drawing tool for filling in areas.
"""
def __init__(self, *args, **kw):
"""
Brush()
Brush(colour, style=BRUSHSTYLE_SOLID)
Brush(stippleBitmap)
Brush(brush)
A brush is a drawing tool for filling in areas.
"""
def SetColour(self, *args, **kw):
"""
SetColour(colour)
SetColour(red, green, blue)
Sets the brush colour using red, green and blue values.
"""
def GetColour(self):
"""
GetColour() -> Colour
Returns a reference to the brush colour.
"""
def GetStipple(self):
"""
GetStipple() -> Bitmap
Gets a pointer to the stipple bitmap.
"""
def GetStyle(self):
"""
GetStyle() -> BrushStyle
Returns the brush style, one of the wxBrushStyle values.
"""
def IsHatch(self):
"""
IsHatch() -> bool
Returns true if the style of the brush is any of hatched fills.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the brush is initialised.
"""
def IsNonTransparent(self):
"""
IsNonTransparent() -> bool
Returns true if the brush is a valid non-transparent brush.
"""
def IsTransparent(self):
"""
IsTransparent() -> bool
Returns true if the brush is transparent.
"""
def SetStipple(self, bitmap):
"""
SetStipple(bitmap)
Sets the stipple bitmap.
"""
def SetStyle(self, style):
"""
SetStyle(style)
Sets the brush style.
"""
def __ne__(self):
"""
"""
def __eq__(self):
"""
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def MacSetTheme(self, macThemeBrushID):
"""
MacSetTheme(macThemeBrushID)
"""
Colour = property(None, None)
Stipple = property(None, None)
Style = property(None, None)
def _copyFrom(self, other):
"""
_copyFrom(other)
For internal use only.
"""
# end of class Brush
class BrushList(object):
"""
A brush list is a list containing all brushes which have been created.
"""
def FindOrCreateBrush(self, colour, style=BRUSHSTYLE_SOLID):
"""
FindOrCreateBrush(colour, style=BRUSHSTYLE_SOLID) -> Brush
Finds a brush with the specified attributes and returns it, else
creates a new brush, adds it to the brush list, and returns it.
"""
# end of class BrushList
NullBrush = Brush()
# These stock brushes will be initialized when the wx.App object is created.
BLUE_BRUSH = Brush()
GREEN_BRUSH = Brush()
YELLOW_BRUSH = Brush()
WHITE_BRUSH = Brush()
BLACK_BRUSH = Brush()
GREY_BRUSH = Brush()
MEDIUM_GREY_BRUSH = Brush()
LIGHT_GREY_BRUSH = Brush()
TRANSPARENT_BRUSH = Brush()
CYAN_BRUSH = Brush()
RED_BRUSH = Brush()
wx.STIPPLE_MASK_OPAQUE = int(wx.BRUSHSTYLE_STIPPLE_MASK_OPAQUE)
wx.STIPPLE_MASK = int(wx.BRUSHSTYLE_STIPPLE_MASK)
wx.STIPPLE = int(wx.BRUSHSTYLE_STIPPLE)
wx.BDIAGONAL_HATCH = int(wx.BRUSHSTYLE_BDIAGONAL_HATCH)
wx.CROSSDIAG_HATCH = int(wx.BRUSHSTYLE_CROSSDIAG_HATCH)
wx.FDIAGONAL_HATCH = int(wx.BRUSHSTYLE_FDIAGONAL_HATCH)
wx.CROSS_HATCH = int(wx.BRUSHSTYLE_CROSS_HATCH)
wx.HORIZONTAL_HATCH = int(wx.BRUSHSTYLE_HORIZONTAL_HATCH)
wx.VERTICAL_HATCH = int(wx.BRUSHSTYLE_VERTICAL_HATCH)
#-- end-brush --#
#-- begin-cursor --#
class Cursor(GDIObject):
"""
Cursor()
Cursor(cursorName, type=BITMAP_TYPE_ANY, hotSpotX=0, hotSpotY=0)
Cursor(cursorId)
Cursor(image)
Cursor(cursor)
A cursor is a small bitmap usually used for denoting where the mouse
pointer is, with a picture that might indicate the interpretation of a
mouse click.
"""
def __init__(self, *args, **kw):
"""
Cursor()
Cursor(cursorName, type=BITMAP_TYPE_ANY, hotSpotX=0, hotSpotY=0)
Cursor(cursorId)
Cursor(image)
Cursor(cursor)
A cursor is a small bitmap usually used for denoting where the mouse
pointer is, with a picture that might indicate the interpretation of a
mouse click.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if cursor data is present.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def GetHandle(self):
"""
GetHandle() -> long
Get the handle for the Cursor. Windows only.
"""
def SetHandle(self, handle):
"""
SetHandle(handle)
Set the handle to use for this Cursor. Windows only.
"""
def _copyFrom(self, other):
"""
_copyFrom(other)
For internal use only.
"""
Handle = property(None, None)
# end of class Cursor
NullCursor = Cursor()
# These stock cursors will be initialized when the wx.App object is created.
STANDARD_CURSOR = Cursor()
HOURGLASS_CURSOR = Cursor()
CROSS_CURSOR = Cursor()
StockCursor = wx.deprecated(Cursor, "Use Cursor instead.")
CursorFromImage = wx.deprecated(Cursor, "Use Cursor instead.")
#-- end-cursor --#
#-- begin-region --#
OutRegion = 0
PartRegion = 0
InRegion = 0
class RegionIterator(Object):
"""
RegionIterator()
RegionIterator(region)
This class is used to iterate through the rectangles in a region,
typically when examining the damaged regions of a window within an
OnPaint call.
"""
def __init__(self, *args, **kw):
"""
RegionIterator()
RegionIterator(region)
This class is used to iterate through the rectangles in a region,
typically when examining the damaged regions of a window within an
OnPaint call.
"""
def GetH(self):
"""
GetH() -> Coord
An alias for GetHeight().
"""
def GetHeight(self):
"""
GetHeight() -> Coord
Returns the height value for the current region.
"""
def GetRect(self):
"""
GetRect() -> Rect
Returns the current rectangle.
"""
def GetW(self):
"""
GetW() -> Coord
An alias for GetWidth().
"""
def GetWidth(self):
"""
GetWidth() -> Coord
Returns the width value for the current region.
"""
def GetX(self):
"""
GetX() -> Coord
Returns the x value for the current region.
"""
def GetY(self):
"""
GetY() -> Coord
Returns the y value for the current region.
"""
def HaveRects(self):
"""
HaveRects() -> bool
Returns true if there are still some rectangles; otherwise returns
false.
"""
def Reset(self, *args, **kw):
"""
Reset()
Reset(region)
Resets the iterator to the beginning of the rectangles.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
Returns true while there are still rectangles available in the
iteration.
"""
def Next(self):
"""
Next()
Move the iterator to the next rectangle in the region.
"""
H = property(None, None)
Height = property(None, None)
Rect = property(None, None)
W = property(None, None)
Width = property(None, None)
X = property(None, None)
Y = property(None, None)
# end of class RegionIterator
class Region(GDIObject):
"""
Region()
Region(x, y, width, height)
Region(topLeft, bottomRight)
Region(rect)
Region(region)
Region(bmp)
Region(bmp, transColour, tolerance=0)
Region(points, fillStyle=ODDEVEN_RULE)
A wxRegion represents a simple or complex region on a device context
or window.
"""
def __init__(self, *args, **kw):
"""
Region()
Region(x, y, width, height)
Region(topLeft, bottomRight)
Region(rect)
Region(region)
Region(bmp)
Region(bmp, transColour, tolerance=0)
Region(points, fillStyle=ODDEVEN_RULE)
A wxRegion represents a simple or complex region on a device context
or window.
"""
def GetBox(self, *args, **kw):
"""
GetBox() -> Rect
Returns the outer bounds of the region.
"""
def Offset(self, *args, **kw):
"""
Offset(x, y) -> bool
Offset(pt) -> bool
Moves the region by the specified offsets in horizontal and vertical
directions.
"""
def Clear(self):
"""
Clear()
Clears the current region.
"""
def Contains(self, *args, **kw):
"""
Contains(x, y) -> RegionContain
Contains(pt) -> RegionContain
Contains(x, y, width, height) -> RegionContain
Contains(rect) -> RegionContain
Returns a value indicating whether the given point is contained within
the region.
"""
def ConvertToBitmap(self):
"""
ConvertToBitmap() -> Bitmap
Convert the region to a black and white bitmap with the white pixels
being inside the region.
"""
def Intersect(self, *args, **kw):
"""
Intersect(x, y, width, height) -> bool
Intersect(rect) -> bool
Intersect(region) -> bool
Finds the intersection of this region and another, rectangular region,
specified using position and size.
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Returns true if the region is empty, false otherwise.
"""
def IsEqual(self, region):
"""
IsEqual(region) -> bool
Returns true if the region is equal to, i.e. covers the same area as,
another one.
"""
def Subtract(self, *args, **kw):
"""
Subtract(rect) -> bool
Subtract(region) -> bool
Subtracts a rectangular region from this region.
"""
def Union(self, *args, **kw):
"""
Union(x, y, width, height) -> bool
Union(rect) -> bool
Union(region) -> bool
Union(bmp) -> bool
Union(bmp, transColour, tolerance=0) -> bool
Finds the union of this region and another, rectangular region,
specified using position and size.
"""
def Xor(self, *args, **kw):
"""
Xor(x, y, width, height) -> bool
Xor(rect) -> bool
Xor(region) -> bool
Finds the Xor of this region and another, rectangular region,
specified using position and size.
"""
def __iter__(self):
"""
Returns a rectangle interator conforming to the Python iterator
protocol.
"""
class PyRegionIterator(object):
"A Python iterator for wx.Region objects"
def __init__(self, region):
self._region = region
self._iterator = wx.RegionIterator(region)
def next(self):
if not self._iterator:
raise StopIteration
rect = self._iterator.GetRect()
if self._iterator.HaveRects():
self._iterator.Next()
return rect
__next__ = next # for Python 3
Box = property(None, None)
# end of class Region
#-- end-region --#
#-- begin-dc --#
CLEAR = 0
XOR = 0
INVERT = 0
OR_REVERSE = 0
AND_REVERSE = 0
COPY = 0
AND = 0
AND_INVERT = 0
NO_OP = 0
NOR = 0
EQUIV = 0
SRC_INVERT = 0
OR_INVERT = 0
NAND = 0
OR = 0
SET = 0
FLOOD_SURFACE = 0
FLOOD_BORDER = 0
MM_TEXT = 0
MM_METRIC = 0
MM_LOMETRIC = 0
MM_TWIPS = 0
MM_POINTS = 0
class FontMetrics(object):
"""
FontMetrics()
Simple collection of various font metrics.
"""
def __init__(self):
"""
FontMetrics()
Simple collection of various font metrics.
"""
height = property(None, None)
ascent = property(None, None)
descent = property(None, None)
internalLeading = property(None, None)
externalLeading = property(None, None)
averageWidth = property(None, None)
# end of class FontMetrics
class DC(Object):
"""
A wxDC is a "device context" onto which graphics and text can be
drawn.
"""
def DeviceToLogicalX(self, x):
"""
DeviceToLogicalX(x) -> Coord
Convert device X coordinate to logical coordinate, using the current
mapping mode, user scale factor, device origin and axis orientation.
"""
def DeviceToLogicalXRel(self, x):
"""
DeviceToLogicalXRel(x) -> Coord
Convert device X coordinate to relative logical coordinate, using the
current mapping mode and user scale factor but ignoring the axis
orientation.
"""
def DeviceToLogicalY(self, y):
"""
DeviceToLogicalY(y) -> Coord
Converts device Y coordinate to logical coordinate, using the current
mapping mode, user scale factor, device origin and axis orientation.
"""
def DeviceToLogicalYRel(self, y):
"""
DeviceToLogicalYRel(y) -> Coord
Convert device Y coordinate to relative logical coordinate, using the
current mapping mode and user scale factor but ignoring the axis
orientation.
"""
def LogicalToDeviceX(self, x):
"""
LogicalToDeviceX(x) -> Coord
Converts logical X coordinate to device coordinate, using the current
mapping mode, user scale factor, device origin and axis orientation.
"""
def LogicalToDeviceXRel(self, x):
"""
LogicalToDeviceXRel(x) -> Coord
Converts logical X coordinate to relative device coordinate, using the
current mapping mode and user scale factor but ignoring the axis
orientation.
"""
def LogicalToDeviceY(self, y):
"""
LogicalToDeviceY(y) -> Coord
Converts logical Y coordinate to device coordinate, using the current
mapping mode, user scale factor, device origin and axis orientation.
"""
def LogicalToDeviceYRel(self, y):
"""
LogicalToDeviceYRel(y) -> Coord
Converts logical Y coordinate to relative device coordinate, using the
current mapping mode and user scale factor but ignoring the axis
orientation.
"""
def Clear(self):
"""
Clear()
Clears the device context using the current background brush.
"""
def DrawArc(self, *args, **kw):
"""
DrawArc(xStart, yStart, xEnd, yEnd, xc, yc)
DrawArc(ptStart, ptEnd, centre)
Draws an arc from the given start to the given end point.
"""
def DrawBitmap(self, *args, **kw):
"""
DrawBitmap(bitmap, x, y, useMask=False)
DrawBitmap(bmp, pt, useMask=False)
Draw a bitmap on the device context at the specified point.
"""
def DrawCheckMark(self, *args, **kw):
"""
DrawCheckMark(x, y, width, height)
DrawCheckMark(rect)
Draws a check mark inside the given rectangle.
"""
def DrawCircle(self, *args, **kw):
"""
DrawCircle(x, y, radius)
DrawCircle(pt, radius)
Draws a circle with the given centre and radius.
"""
def DrawEllipse(self, *args, **kw):
"""
DrawEllipse(x, y, width, height)
DrawEllipse(pt, size)
DrawEllipse(rect)
Draws an ellipse contained in the rectangle specified either with the
given top left corner and the given size or directly.
"""
def DrawEllipticArc(self, *args, **kw):
"""
DrawEllipticArc(x, y, width, height, start, end)
DrawEllipticArc(pt, sz, sa, ea)
Draws an arc of an ellipse.
"""
def DrawIcon(self, *args, **kw):
"""
DrawIcon(icon, x, y)
DrawIcon(icon, pt)
Draw an icon on the display (does nothing if the device context is
PostScript).
"""
def DrawLabel(self, *args, **kw):
"""
DrawLabel(text, bitmap, rect, alignment=ALIGN_LEFT|ALIGN_TOP, indexAccel=-1) -> Rect
DrawLabel(text, rect, alignment=ALIGN_LEFT|ALIGN_TOP, indexAccel=-1)
Draw optional bitmap and the text into the given rectangle and aligns
it as specified by alignment parameter; it also will emphasize the
character with the given index if it is != -1 and return the bounding
rectangle if required.
"""
def DrawLine(self, *args, **kw):
"""
DrawLine(x1, y1, x2, y2)
DrawLine(pt1, pt2)
Draws a line from the first point to the second.
"""
def DrawLines(self, *args, **kw):
"""
DrawLines(points, xoffset=0, yoffset=0)
This method uses a list of wxPoints, adding the optional offset
coordinate.
"""
def DrawPoint(self, *args, **kw):
"""
DrawPoint(x, y)
DrawPoint(pt)
Draws a point using the color of the current pen.
"""
def DrawPolygon(self, *args, **kw):
"""
DrawPolygon(points, xoffset=0, yoffset=0, fill_style=ODDEVEN_RULE)
This method draws a filled polygon using a list of wxPoints, adding
the optional offset coordinate.
"""
def DrawRectangle(self, *args, **kw):
"""
DrawRectangle(x, y, width, height)
DrawRectangle(pt, sz)
DrawRectangle(rect)
Draws a rectangle with the given top left corner, and with the given
size.
"""
def DrawRotatedText(self, *args, **kw):
"""
DrawRotatedText(text, x, y, angle)
DrawRotatedText(text, point, angle)
Draws the text rotated by angle degrees (positive angles are
counterclockwise; the full angle is 360 degrees).
"""
def DrawRoundedRectangle(self, *args, **kw):
"""
DrawRoundedRectangle(x, y, width, height, radius)
DrawRoundedRectangle(pt, sz, radius)
DrawRoundedRectangle(rect, radius)
Draws a rectangle with the given top left corner, and with the given
size.
"""
def DrawSpline(self, *args, **kw):
"""
DrawSpline(points)
DrawSpline(x1, y1, x2, y2, x3, y3)
This is an overloaded member function, provided for convenience. It
differs from the above function only in what argument(s) it accepts.
"""
def DrawText(self, *args, **kw):
"""
DrawText(text, x, y)
DrawText(text, pt)
Draws a text string at the specified point, using the current text
font, and the current text foreground and background colours.
"""
def GradientFillConcentric(self, *args, **kw):
"""
GradientFillConcentric(rect, initialColour, destColour)
GradientFillConcentric(rect, initialColour, destColour, circleCenter)
Fill the area specified by rect with a radial gradient, starting from
initialColour at the centre of the circle and fading to destColour on
the circle outside.
"""
def GradientFillLinear(self, rect, initialColour, destColour, nDirection=RIGHT):
"""
GradientFillLinear(rect, initialColour, destColour, nDirection=RIGHT)
Fill the area specified by rect with a linear gradient, starting from
initialColour and eventually fading to destColour.
"""
def FloodFill(self, *args, **kw):
"""
FloodFill(x, y, colour, style=FLOOD_SURFACE) -> bool
FloodFill(pt, col, style=FLOOD_SURFACE) -> bool
Flood fills the device context starting from the given point, using
the current brush colour, and using a style:
"""
def CrossHair(self, *args, **kw):
"""
CrossHair(x, y)
CrossHair(pt)
Displays a cross hair using the current pen.
"""
def DestroyClippingRegion(self):
"""
DestroyClippingRegion()
Destroys the current clipping region so that none of the DC is
clipped.
"""
def GetClippingBox(self):
"""
GetClippingBox() -> (x, y, width, height)
Gets the rectangle surrounding the current clipping region.
"""
def SetClippingRegion(self, *args, **kw):
"""
SetClippingRegion(x, y, width, height)
SetClippingRegion(pt, sz)
SetClippingRegion(rect)
Sets the clipping region for this device context to the intersection
of the given region described by the parameters of this method and the
previously set clipping region.
"""
def SetDeviceClippingRegion(self, region):
"""
SetDeviceClippingRegion(region)
Sets the clipping region for this device context.
"""
def GetCharHeight(self):
"""
GetCharHeight() -> Coord
Gets the character height of the currently set font.
"""
def GetCharWidth(self):
"""
GetCharWidth() -> Coord
Gets the average character width of the currently set font.
"""
def GetFontMetrics(self):
"""
GetFontMetrics() -> FontMetrics
Returns the various font characteristics.
"""
def GetFullMultiLineTextExtent(self, *args, **kw):
"""
GetFullMultiLineTextExtent(string, font=None) -> (w, h, heightLine)
GetMultiLineTextExtent(string) -> Size
Gets the dimensions of the string using the currently selected font.
"""
def GetPartialTextExtents(self, text):
"""
GetPartialTextExtents(text) -> ArrayInt
Fills the widths array with the widths from the beginning of text to
the corresponding character of text.
"""
def GetFullTextExtent(self, *args, **kw):
"""
GetFullTextExtent(string, font=None) -> (w, h, descent, externalLeading)
GetTextExtent(string) -> Size
Gets the dimensions of the string using the currently selected font.
"""
def GetBackgroundMode(self):
"""
GetBackgroundMode() -> int
Returns the current background mode: wxSOLID or wxTRANSPARENT.
"""
def GetFont(self):
"""
GetFont() -> Font
Gets the current font.
"""
def GetLayoutDirection(self):
"""
GetLayoutDirection() -> LayoutDirection
Gets the current layout direction of the device context.
"""
def GetTextBackground(self):
"""
GetTextBackground() -> Colour
Gets the current text background colour.
"""
def GetTextForeground(self):
"""
GetTextForeground() -> Colour
Gets the current text foreground colour.
"""
def SetBackgroundMode(self, mode):
"""
SetBackgroundMode(mode)
mode may be one of wxSOLID and wxTRANSPARENT.
"""
def SetFont(self, font):
"""
SetFont(font)
Sets the current font for the DC.
"""
def SetTextBackground(self, colour):
"""
SetTextBackground(colour)
Sets the current text background colour for the DC.
"""
def SetTextForeground(self, colour):
"""
SetTextForeground(colour)
Sets the current text foreground colour for the DC.
"""
def SetLayoutDirection(self, dir):
"""
SetLayoutDirection(dir)
Sets the current layout direction for the device context.
"""
def CalcBoundingBox(self, x, y):
"""
CalcBoundingBox(x, y)
Adds the specified point to the bounding box which can be retrieved
with MinX(), MaxX() and MinY(), MaxY() functions.
"""
def MaxX(self):
"""
MaxX() -> Coord
Gets the maximum horizontal extent used in drawing commands so far.
"""
def MaxY(self):
"""
MaxY() -> Coord
Gets the maximum vertical extent used in drawing commands so far.
"""
def MinX(self):
"""
MinX() -> Coord
Gets the minimum horizontal extent used in drawing commands so far.
"""
def MinY(self):
"""
MinY() -> Coord
Gets the minimum vertical extent used in drawing commands so far.
"""
def ResetBoundingBox(self):
"""
ResetBoundingBox()
Resets the bounding box: after a call to this function, the bounding
box doesn't contain anything.
"""
def StartDoc(self, message):
"""
StartDoc(message) -> bool
Starts a document (only relevant when outputting to a printer).
"""
def StartPage(self):
"""
StartPage()
Starts a document page (only relevant when outputting to a printer).
"""
def EndDoc(self):
"""
EndDoc()
Ends a document (only relevant when outputting to a printer).
"""
def EndPage(self):
"""
EndPage()
Ends a document page (only relevant when outputting to a printer).
"""
def Blit(self, xdest, ydest, width, height, source, xsrc, ysrc, logicalFunc=COPY, useMask=False, xsrcMask=DefaultCoord, ysrcMask=DefaultCoord):
"""
Blit(xdest, ydest, width, height, source, xsrc, ysrc, logicalFunc=COPY, useMask=False, xsrcMask=DefaultCoord, ysrcMask=DefaultCoord) -> bool
Copy from a source DC to this DC.
"""
def StretchBlit(self, xdest, ydest, dstWidth, dstHeight, source, xsrc, ysrc, srcWidth, srcHeight, logicalFunc=COPY, useMask=False, xsrcMask=DefaultCoord, ysrcMask=DefaultCoord):
"""
StretchBlit(xdest, ydest, dstWidth, dstHeight, source, xsrc, ysrc, srcWidth, srcHeight, logicalFunc=COPY, useMask=False, xsrcMask=DefaultCoord, ysrcMask=DefaultCoord) -> bool
Copy from a source DC to this DC possibly changing the scale.
"""
def GetBackground(self):
"""
GetBackground() -> Brush
Gets the brush used for painting the background.
"""
def GetBrush(self):
"""
GetBrush() -> Brush
Gets the current brush.
"""
def GetPen(self):
"""
GetPen() -> Pen
Gets the current pen.
"""
def SetBackground(self, brush):
"""
SetBackground(brush)
Sets the current background brush for the DC.
"""
def SetBrush(self, brush):
"""
SetBrush(brush)
Sets the current brush for the DC.
"""
def SetPen(self, pen):
"""
SetPen(pen)
Sets the current pen for the DC.
"""
def CanUseTransformMatrix(self):
"""
CanUseTransformMatrix() -> bool
Check if the use of transformation matrix is supported by the current
system.
"""
def ResetTransformMatrix(self):
"""
ResetTransformMatrix()
Revert the transformation matrix to identity matrix.
"""
def CanDrawBitmap(self):
"""
CanDrawBitmap() -> bool
Does the DC support drawing bitmaps?
"""
def CanGetTextExtent(self):
"""
CanGetTextExtent() -> bool
Does the DC support calculating the size required to draw text?
"""
def CopyAttributes(self, dc):
"""
CopyAttributes(dc)
Copy attributes from another DC.
"""
def GetDepth(self):
"""
GetDepth() -> int
Returns the depth (number of bits/pixel) of this DC.
"""
def GetDeviceOrigin(self):
"""
GetDeviceOrigin() -> Point
Returns the current device origin.
"""
def GetLogicalFunction(self):
"""
GetLogicalFunction() -> RasterOperationMode
Gets the current logical function.
"""
def GetMapMode(self):
"""
GetMapMode() -> MappingMode
Gets the current mapping mode for the device context.
"""
def GetPixel(self, x, y):
"""
GetPixel(x, y) -> Colour
Gets the colour at the specified location on the DC.
"""
def GetPPI(self):
"""
GetPPI() -> Size
Returns the resolution of the device in pixels per inch.
"""
def GetSize(self, *args, **kw):
"""
GetSize() -> Size
This is an overloaded member function, provided for convenience. It
differs from the above function only in what argument(s) it accepts.
"""
def GetSizeMM(self, *args, **kw):
"""
GetSizeMM() -> Size
This is an overloaded member function, provided for convenience. It
differs from the above function only in what argument(s) it accepts.
"""
def GetUserScale(self):
"""
GetUserScale() -> (x, y)
Gets the current user scale factor.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the DC is ok to use.
"""
def SetAxisOrientation(self, xLeftRight, yBottomUp):
"""
SetAxisOrientation(xLeftRight, yBottomUp)
Sets the x and y axis orientation (i.e. the direction from lowest to
highest values on the axis).
"""
def SetDeviceOrigin(self, x, y):
"""
SetDeviceOrigin(x, y)
Sets the device origin (i.e. the origin in pixels after scaling has
been applied).
"""
def SetLogicalFunction(self, function):
"""
SetLogicalFunction(function)
Sets the current logical function for the device context.
"""
def SetMapMode(self, mode):
"""
SetMapMode(mode)
The mapping mode of the device context defines the unit of measurement
used to convert logical units to device units.
"""
def SetPalette(self, palette):
"""
SetPalette(palette)
If this is a window DC or memory DC, assigns the given palette to the
window or bitmap associated with the DC.
"""
def SetUserScale(self, xScale, yScale):
"""
SetUserScale(xScale, yScale)
Sets the user scaling factor, useful for applications which require
'zooming'.
"""
def GetHandle(self):
"""
GetHandle() -> void
Returns a value that can be used as a handle to the native drawing
context, if this wxDC has something that could be thought of in that
way.
"""
def GetAsBitmap(self, subrect=None):
"""
GetAsBitmap(subrect=None) -> Bitmap
If supported by the platform and the type of DC, fetch the contents of
the DC, or a subset of it, as a bitmap.
"""
def SetLogicalScale(self, x, y):
"""
SetLogicalScale(x, y)
"""
def GetLogicalScale(self):
"""
GetLogicalScale() -> (x, y)
"""
def SetLogicalOrigin(self, x, y):
"""
SetLogicalOrigin(x, y)
"""
def GetLogicalOrigin(self):
"""
GetLogicalOrigin() -> (x, y)
"""
def GetClippingRect(self):
"""
Gets the rectangle surrounding the current clipping region
"""
DrawImageLabel = wx.deprecated(DrawLabel, "Use DrawLabel instead.")
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def GetBoundingBox(self):
"""
GetBoundingBox() -> (x1,y1, x2,y2)
Returns the min and max points used in drawing commands so far.
"""
def GetHDC(self):
"""
GetHDC() -> long
"""
def GetCGContext(self):
"""
GetCGContext() -> void
"""
def GetGdkDrawable(self):
"""
GetGdkDrawable() -> void
"""
GetHDC = wx.deprecated(GetHDC, "Use GetHandle instead.")
GetCGContext = wx.deprecated(GetCGContext, "Use GetHandle instead.")
GetGdkDrawable = wx.deprecated(GetGdkDrawable, "Use GetHandle instead.")
def _DrawPointList(self, pyCoords, pyPens, pyBrushes):
"""
_DrawPointList(pyCoords, pyPens, pyBrushes) -> PyObject
"""
def _DrawLineList(self, pyCoords, pyPens, pyBrushes):
"""
_DrawLineList(pyCoords, pyPens, pyBrushes) -> PyObject
"""
def _DrawRectangleList(self, pyCoords, pyPens, pyBrushes):
"""
_DrawRectangleList(pyCoords, pyPens, pyBrushes) -> PyObject
"""
def _DrawEllipseList(self, pyCoords, pyPens, pyBrushes):
"""
_DrawEllipseList(pyCoords, pyPens, pyBrushes) -> PyObject
"""
def _DrawPolygonList(self, pyCoords, pyPens, pyBrushes):
"""
_DrawPolygonList(pyCoords, pyPens, pyBrushes) -> PyObject
"""
def _DrawTextList(self, textList, pyPoints, foregroundList, backgroundList):
"""
_DrawTextList(textList, pyPoints, foregroundList, backgroundList) -> PyObject
"""
def DrawPointList(self, points, pens=None):
"""
Draw a list of points as quickly as possible.
:param points: A sequence of 2-element sequences representing
each point to draw, (x,y).
:param pens: If None, then the current pen is used. If a single
pen then it will be used for all points. If a list of
pens then there should be one for each point in points.
"""
def DrawLineList(self, lines, pens=None):
"""
Draw a list of lines as quickly as possible.
:param lines: A sequence of 4-element sequences representing
each line to draw, (x1,y1, x2,y2).
:param pens: If None, then the current pen is used. If a
single pen then it will be used for all lines. If
a list of pens then there should be one for each line
in lines.
"""
def DrawRectangleList(self, rectangles, pens=None, brushes=None):
"""
Draw a list of rectangles as quickly as possible.
:param rectangles: A sequence of 4-element sequences representing
each rectangle to draw, (x,y, w,h).
:param pens: If None, then the current pen is used. If a
single pen then it will be used for all rectangles.
If a list of pens then there should be one for each
rectangle in rectangles.
:param brushes: A brush or brushes to be used to fill the rectagles,
with similar semantics as the pens parameter.
"""
def DrawEllipseList(self, ellipses, pens=None, brushes=None):
"""
Draw a list of ellipses as quickly as possible.
:param ellipses: A sequence of 4-element sequences representing
each ellipse to draw, (x,y, w,h).
:param pens: If None, then the current pen is used. If a
single pen then it will be used for all ellipses.
If a list of pens then there should be one for each
ellipse in ellipses.
:param brushes: A brush or brushes to be used to fill the ellipses,
with similar semantics as the pens parameter.
"""
def DrawPolygonList(self, polygons, pens=None, brushes=None):
"""
Draw a list of polygons, each of which is a list of points.
:param polygons: A sequence of sequences of sequences.
[[(x1,y1),(x2,y2),(x3,y3)...], [(x1,y1),(x2,y2),(x3,y3)...]]
:param pens: If None, then the current pen is used. If a
single pen then it will be used for all polygons.
If a list of pens then there should be one for each
polygon.
:param brushes: A brush or brushes to be used to fill the polygons,
with similar semantics as the pens parameter.
"""
def DrawTextList(self, textList, coords, foregrounds=None, backgrounds=None):
"""
Draw a list of strings using a list of coordinants for positioning each string.
:param textList: A list of strings
:param coords: A list of (x,y) positions
:param foregrounds: A list of `wx.Colour` objects to use for the
foregrounds of the strings.
:param backgrounds: A list of `wx.Colour` objects to use for the
backgrounds of the strings.
NOTE: Make sure you set background mode to wx.Solid (DC.SetBackgroundMode)
If you want backgrounds to do anything.
"""
AsBitmap = property(None, None)
Background = property(None, None)
BackgroundMode = property(None, None)
BoundingBox = property(None, None)
Brush = property(None, None)
CGContext = property(None, None)
CharHeight = property(None, None)
CharWidth = property(None, None)
ClippingRect = property(None, None)
Depth = property(None, None)
DeviceOrigin = property(None, None)
Font = property(None, None)
FontMetrics = property(None, None)
GdkDrawable = property(None, None)
HDC = property(None, None)
Handle = property(None, None)
LayoutDirection = property(None, None)
LogicalFunction = property(None, None)
MapMode = property(None, None)
PPI = property(None, None)
Pen = property(None, None)
Pixel = property(None, None)
Size = property(None, None)
SizeMM = property(None, None)
TextBackground = property(None, None)
TextForeground = property(None, None)
# end of class DC
class DCClipper(object):
"""
DCClipper(dc, region)
DCClipper(dc, rect)
DCClipper(dc, x, y, w, h)
wxDCClipper is a helper class for setting a clipping region on a wxDC
during its lifetime.
"""
def __init__(self, *args, **kw):
"""
DCClipper(dc, region)
DCClipper(dc, rect)
DCClipper(dc, x, y, w, h)
wxDCClipper is a helper class for setting a clipping region on a wxDC
during its lifetime.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class DCClipper
class DCBrushChanger(object):
"""
DCBrushChanger(dc, brush)
wxDCBrushChanger is a small helper class for setting a brush on a wxDC
and unsetting it automatically in the destructor, restoring the
previous one.
"""
def __init__(self, dc, brush):
"""
DCBrushChanger(dc, brush)
wxDCBrushChanger is a small helper class for setting a brush on a wxDC
and unsetting it automatically in the destructor, restoring the
previous one.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class DCBrushChanger
class DCPenChanger(object):
"""
DCPenChanger(dc, pen)
wxDCPenChanger is a small helper class for setting a pen on a wxDC and
unsetting it automatically in the destructor, restoring the previous
one.
"""
def __init__(self, dc, pen):
"""
DCPenChanger(dc, pen)
wxDCPenChanger is a small helper class for setting a pen on a wxDC and
unsetting it automatically in the destructor, restoring the previous
one.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class DCPenChanger
class DCTextColourChanger(object):
"""
DCTextColourChanger(dc)
DCTextColourChanger(dc, col)
wxDCTextColourChanger is a small helper class for setting a foreground
text colour on a wxDC and unsetting it automatically in the
destructor, restoring the previous one.
"""
def __init__(self, *args, **kw):
"""
DCTextColourChanger(dc)
DCTextColourChanger(dc, col)
wxDCTextColourChanger is a small helper class for setting a foreground
text colour on a wxDC and unsetting it automatically in the
destructor, restoring the previous one.
"""
def Set(self, col):
"""
Set(col)
Set the colour to use.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class DCTextColourChanger
class DCFontChanger(object):
"""
DCFontChanger(dc)
DCFontChanger(dc, font)
wxDCFontChanger is a small helper class for setting a font on a wxDC
and unsetting it automatically in the destructor, restoring the
previous one.
"""
def __init__(self, *args, **kw):
"""
DCFontChanger(dc)
DCFontChanger(dc, font)
wxDCFontChanger is a small helper class for setting a font on a wxDC
and unsetting it automatically in the destructor, restoring the
previous one.
"""
def Set(self, font):
"""
Set(font)
Set the font to use.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class DCFontChanger
#-- end-dc --#
#-- begin-dcclient --#
class WindowDC(DC):
"""
WindowDC(window)
A wxWindowDC must be constructed if an application wishes to paint on
the whole area of a window (client and decorations).
"""
def __init__(self, window):
"""
WindowDC(window)
A wxWindowDC must be constructed if an application wishes to paint on
the whole area of a window (client and decorations).
"""
# end of class WindowDC
class ClientDC(WindowDC):
"""
ClientDC(window)
A wxClientDC must be constructed if an application wishes to paint on
the client area of a window from outside an EVT_PAINT() handler.
"""
def __init__(self, window):
"""
ClientDC(window)
A wxClientDC must be constructed if an application wishes to paint on
the client area of a window from outside an EVT_PAINT() handler.
"""
# end of class ClientDC
class PaintDC(ClientDC):
"""
PaintDC(window)
A wxPaintDC must be constructed if an application wishes to paint on
the client area of a window from within an EVT_PAINT() event handler.
"""
def __init__(self, window):
"""
PaintDC(window)
A wxPaintDC must be constructed if an application wishes to paint on
the client area of a window from within an EVT_PAINT() event handler.
"""
# end of class PaintDC
#-- end-dcclient --#
#-- begin-dcmemory --#
class MemoryDC(DC):
"""
MemoryDC()
MemoryDC(dc)
MemoryDC(bitmap)
A memory device context provides a means to draw graphics onto a
bitmap.
"""
def __init__(self, *args, **kw):
"""
MemoryDC()
MemoryDC(dc)
MemoryDC(bitmap)
A memory device context provides a means to draw graphics onto a
bitmap.
"""
def SelectObject(self, bitmap):
"""
SelectObject(bitmap)
Works exactly like SelectObjectAsSource() but this is the function you
should use when you select a bitmap because you want to modify it,
e.g.
"""
def SelectObjectAsSource(self, bitmap):
"""
SelectObjectAsSource(bitmap)
Selects the given bitmap into the device context, to use as the memory
bitmap.
"""
# end of class MemoryDC
#-- end-dcmemory --#
#-- begin-dcbuffer --#
BUFFER_VIRTUAL_AREA = 0
BUFFER_CLIENT_AREA = 0
BUFFER_USES_SHARED_BUFFER = 0
class BufferedDC(MemoryDC):
"""
BufferedDC()
BufferedDC(dc, area, style=BUFFER_CLIENT_AREA)
BufferedDC(dc, buffer=NullBitmap, style=BUFFER_CLIENT_AREA)
This class provides a simple way to avoid flicker: when drawing on it,
everything is in fact first drawn on an in-memory buffer (a wxBitmap)
and then copied to the screen, using the associated wxDC, only once,
when this object is destroyed.
"""
def __init__(self, *args, **kw):
"""
BufferedDC()
BufferedDC(dc, area, style=BUFFER_CLIENT_AREA)
BufferedDC(dc, buffer=NullBitmap, style=BUFFER_CLIENT_AREA)
This class provides a simple way to avoid flicker: when drawing on it,
everything is in fact first drawn on an in-memory buffer (a wxBitmap)
and then copied to the screen, using the associated wxDC, only once,
when this object is destroyed.
"""
def Init(self, *args, **kw):
"""
Init(dc, area, style=BUFFER_CLIENT_AREA)
Init(dc, buffer=NullBitmap, style=BUFFER_CLIENT_AREA)
Initializes the object created using the default constructor.
"""
def UnMask(self):
"""
UnMask()
Blits the buffer to the dc, and detaches the dc from the buffer (so it
can be effectively used once only).
"""
def SetStyle(self, style):
"""
SetStyle(style)
Set the style.
"""
def GetStyle(self):
"""
GetStyle() -> int
Get the style.
"""
Style = property(None, None)
# end of class BufferedDC
class BufferedPaintDC(BufferedDC):
"""
BufferedPaintDC(window, buffer, style=BUFFER_CLIENT_AREA)
BufferedPaintDC(window, style=BUFFER_CLIENT_AREA)
This is a subclass of wxBufferedDC which can be used inside of an
EVT_PAINT() event handler to achieve double-buffered drawing.
"""
def __init__(self, *args, **kw):
"""
BufferedPaintDC(window, buffer, style=BUFFER_CLIENT_AREA)
BufferedPaintDC(window, style=BUFFER_CLIENT_AREA)
This is a subclass of wxBufferedDC which can be used inside of an
EVT_PAINT() event handler to achieve double-buffered drawing.
"""
# end of class BufferedPaintDC
class AutoBufferedPaintDC(BufferedPaintDC):
"""
AutoBufferedPaintDC(window)
This wxDC derivative can be used inside of an EVT_PAINT() event
handler to achieve double-buffered drawing.
"""
def __init__(self, window):
"""
AutoBufferedPaintDC(window)
This wxDC derivative can be used inside of an EVT_PAINT() event
handler to achieve double-buffered drawing.
"""
# end of class AutoBufferedPaintDC
def AutoBufferedPaintDCFactory(window):
"""
AutoBufferedPaintDCFactory(window) -> DC
Check if the window is natively double buffered and will return a
wxPaintDC if it is, a wxBufferedPaintDC otherwise.
"""
#-- end-dcbuffer --#
#-- begin-dcscreen --#
class ScreenDC(DC):
"""
ScreenDC()
A wxScreenDC can be used to paint on the screen.
"""
def __init__(self):
"""
ScreenDC()
A wxScreenDC can be used to paint on the screen.
"""
@staticmethod
def EndDrawingOnTop():
"""
EndDrawingOnTop() -> bool
Use this in conjunction with StartDrawingOnTop().
"""
@staticmethod
def StartDrawingOnTop(*args, **kw):
"""
StartDrawingOnTop(window) -> bool
StartDrawingOnTop(rect=None) -> bool
Use this in conjunction with EndDrawingOnTop() to ensure that drawing
to the screen occurs on top of existing windows.
"""
# end of class ScreenDC
#-- end-dcscreen --#
#-- begin-dcgraph --#
class GCDC(DC):
"""
GCDC(windowDC)
GCDC(memoryDC)
GCDC(printerDC)
GCDC(context)
GCDC()
wxGCDC is a device context that draws on a wxGraphicsContext.
"""
def __init__(self, *args, **kw):
"""
GCDC(windowDC)
GCDC(memoryDC)
GCDC(printerDC)
GCDC(context)
GCDC()
wxGCDC is a device context that draws on a wxGraphicsContext.
"""
def GetGraphicsContext(self):
"""
GetGraphicsContext() -> GraphicsContext
Retrieves associated wxGraphicsContext.
"""
def SetGraphicsContext(self, ctx):
"""
SetGraphicsContext(ctx)
Set the graphics context to be used for this wxGCDC.
"""
GraphicsContext = property(None, None)
# end of class GCDC
#-- end-dcgraph --#
#-- begin-dcmirror --#
class MirrorDC(DC):
"""
MirrorDC(dc, mirror)
wxMirrorDC is a simple wrapper class which is always associated with a
real wxDC object and either forwards all of its operations to it
without changes (no mirroring takes place) or exchanges x and y
coordinates which makes it possible to reuse the same code to draw a
figure and its mirror i.e.
"""
def __init__(self, dc, mirror):
"""
MirrorDC(dc, mirror)
wxMirrorDC is a simple wrapper class which is always associated with a
real wxDC object and either forwards all of its operations to it
without changes (no mirroring takes place) or exchanges x and y
coordinates which makes it possible to reuse the same code to draw a
figure and its mirror i.e.
"""
# end of class MirrorDC
#-- end-dcmirror --#
#-- begin-dcprint --#
class PrinterDC(DC):
"""
PrinterDC(printData)
A printer device context is specific to MSW and Mac, and allows access
to any printer with a Windows or Macintosh driver.
"""
def __init__(self, printData):
"""
PrinterDC(printData)
A printer device context is specific to MSW and Mac, and allows access
to any printer with a Windows or Macintosh driver.
"""
def GetPaperRect(self):
"""
GetPaperRect() -> Rect
Return the rectangle in device coordinates that corresponds to the
full paper area, including the nonprinting regions of the paper.
"""
PaperRect = property(None, None)
# end of class PrinterDC
#-- end-dcprint --#
#-- begin-dcps --#
class PostScriptDC(DC):
"""
PostScriptDC()
PostScriptDC(printData)
This defines the wxWidgets Encapsulated PostScript device context,
which can write PostScript files on any platform.
"""
def __init__(self, *args, **kw):
"""
PostScriptDC()
PostScriptDC(printData)
This defines the wxWidgets Encapsulated PostScript device context,
which can write PostScript files on any platform.
"""
# end of class PostScriptDC
#-- end-dcps --#
#-- begin-dcsvg --#
class SVGFileDC(DC):
"""
SVGFileDC(filename, width=320, height=240, dpi=72)
A wxSVGFileDC is a device context onto which graphics and text can be
drawn, and the output produced as a vector file, in SVG format.
"""
def __init__(self, filename, width=320, height=240, dpi=72):
"""
SVGFileDC(filename, width=320, height=240, dpi=72)
A wxSVGFileDC is a device context onto which graphics and text can be
drawn, and the output produced as a vector file, in SVG format.
"""
def CrossHair(self, x, y):
"""
CrossHair(x, y)
Functions not implemented in this DC class.
"""
def FloodFill(self, x, y, colour, style=FLOOD_SURFACE):
"""
FloodFill(x, y, colour, style=FLOOD_SURFACE) -> bool
Functions not implemented in this DC class.
"""
def GetClippingBox(self, x, y, width, height):
"""
GetClippingBox(x, y, width, height)
Functions not implemented in this DC class.
"""
def GetPixel(self, x, y, colour):
"""
GetPixel(x, y, colour) -> bool
Functions not implemented in this DC class.
"""
def SetPalette(self, palette):
"""
SetPalette(palette)
Functions not implemented in this DC class.
"""
def StartDoc(self, message):
"""
StartDoc(message) -> bool
Functions not implemented in this DC class.
"""
def EndDoc(self):
"""
EndDoc()
Does nothing.
"""
def EndPage(self):
"""
EndPage()
Does nothing.
"""
def Clear(self):
"""
Clear()
This makes no sense in wxSVGFileDC and does nothing.
"""
def SetLogicalFunction(self, function):
"""
SetLogicalFunction(function)
Does the same as wxDC::SetLogicalFunction(), except that only wxCOPY
is available.
"""
def SetClippingRegion(self, *args, **kw):
"""
SetClippingRegion(x, y, width, height)
SetClippingRegion(pt, sz)
SetClippingRegion(rect)
SetClippingRegion(region)
Sets the clipping region for this device context to the intersection
of the given region described by the parameters of this method and the
previously set clipping region.
"""
def DestroyClippingRegion(self):
"""
DestroyClippingRegion()
Destroys the current clipping region so that none of the DC is
clipped.
"""
# end of class SVGFileDC
#-- end-dcsvg --#
#-- begin-graphics --#
ANTIALIAS_NONE = 0
ANTIALIAS_DEFAULT = 0
INTERPOLATION_DEFAULT = 0
INTERPOLATION_NONE = 0
INTERPOLATION_FAST = 0
INTERPOLATION_GOOD = 0
INTERPOLATION_BEST = 0
COMPOSITION_INVALID = 0
COMPOSITION_CLEAR = 0
COMPOSITION_SOURCE = 0
COMPOSITION_OVER = 0
COMPOSITION_IN = 0
COMPOSITION_OUT = 0
COMPOSITION_ATOP = 0
COMPOSITION_DEST = 0
COMPOSITION_DEST_OVER = 0
COMPOSITION_DEST_IN = 0
COMPOSITION_DEST_OUT = 0
COMPOSITION_DEST_ATOP = 0
COMPOSITION_XOR = 0
COMPOSITION_ADD = 0
class GraphicsObject(Object):
"""
This class is the superclass of native graphics objects like pens etc.
"""
def GetRenderer(self):
"""
GetRenderer() -> GraphicsRenderer
Returns the renderer that was used to create this instance, or NULL if
it has not been initialized yet.
"""
def IsNull(self):
"""
IsNull() -> bool
"""
def IsOk(self):
"""
IsOk() -> bool
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
Renderer = property(None, None)
# end of class GraphicsObject
class GraphicsBitmap(GraphicsObject):
"""
GraphicsBitmap()
Represents a bitmap.
"""
def __init__(self):
"""
GraphicsBitmap()
Represents a bitmap.
"""
def ConvertToImage(self):
"""
ConvertToImage() -> Image
Return the contents of this bitmap as wxImage.
"""
def GetNativeBitmap(self):
"""
GetNativeBitmap() -> void
Return the pointer to the native bitmap data.
"""
NativeBitmap = property(None, None)
# end of class GraphicsBitmap
class GraphicsBrush(GraphicsObject):
"""
A wxGraphicsBrush is a native representation of a brush.
"""
# end of class GraphicsBrush
class GraphicsFont(GraphicsObject):
"""
A wxGraphicsFont is a native representation of a font.
"""
# end of class GraphicsFont
class GraphicsPen(GraphicsObject):
"""
A wxGraphicsPen is a native representation of a pen.
"""
# end of class GraphicsPen
class GraphicsContext(GraphicsObject):
"""
A wxGraphicsContext instance is the object that is drawn upon.
"""
def CreateLinearGradientBrush(self, *args, **kw):
"""
CreateLinearGradientBrush(x1, y1, x2, y2, c1, c2) -> GraphicsBrush
CreateLinearGradientBrush(x1, y1, x2, y2, stops) -> GraphicsBrush
Creates a native brush with a linear gradient.
"""
def CreateRadialGradientBrush(self, *args, **kw):
"""
CreateRadialGradientBrush(xo, yo, xc, yc, radius, oColor, cColor) -> GraphicsBrush
CreateRadialGradientBrush(xo, yo, xc, yc, radius, stops) -> GraphicsBrush
Creates a native brush with a radial gradient.
"""
def DrawBitmap(self, *args, **kw):
"""
DrawBitmap(bmp, x, y, w, h)
DrawBitmap(bmp, x, y, w, h)
Draws the bitmap.
"""
@staticmethod
def Create(*args, **kw):
"""
Create(window) -> GraphicsContext
Create(windowDC) -> GraphicsContext
Create(memoryDC) -> GraphicsContext
Create(printerDC) -> GraphicsContext
Create(image) -> GraphicsContext
Create() -> GraphicsContext
Creates a wxGraphicsContext from a wxWindow.
"""
@staticmethod
def CreateFromNative(context):
"""
CreateFromNative(context) -> GraphicsContext
Creates a wxGraphicsContext from a native context.
"""
@staticmethod
def CreateFromNativeWindow(window):
"""
CreateFromNativeWindow(window) -> GraphicsContext
Creates a wxGraphicsContext from a native window.
"""
def Clip(self, *args, **kw):
"""
Clip(region)
Clip(x, y, w, h)
Clips drawings to the specified region.
"""
def ConcatTransform(self, matrix):
"""
ConcatTransform(matrix)
Concatenates the passed in transform with the current transform of
this context.
"""
def CreateBitmap(self, bitmap):
"""
CreateBitmap(bitmap) -> GraphicsBitmap
Creates wxGraphicsBitmap from an existing wxBitmap.
"""
def CreateBitmapFromImage(self, image):
"""
CreateBitmapFromImage(image) -> GraphicsBitmap
Creates wxGraphicsBitmap from an existing wxImage.
"""
def CreateSubBitmap(self, bitmap, x, y, w, h):
"""
CreateSubBitmap(bitmap, x, y, w, h) -> GraphicsBitmap
Extracts a sub-bitmap from an existing bitmap.
"""
def CreateBrush(self, brush):
"""
CreateBrush(brush) -> GraphicsBrush
Creates a native brush from a wxBrush.
"""
def CreateFont(self, *args, **kw):
"""
CreateFont(font, col=BLACK) -> GraphicsFont
CreateFont(sizeInPixels, facename, flags=FONTFLAG_DEFAULT, col=BLACK) -> GraphicsFont
Creates a native graphics font from a wxFont and a text colour.
"""
def CreateMatrix(self, *args, **kw):
"""
CreateMatrix(a=1.0, b=0.0, c=0.0, d=1.0, tx=0.0, ty=0.0) -> GraphicsMatrix
CreateMatrix(mat) -> GraphicsMatrix
Creates a native affine transformation matrix from the passed in
values.
"""
def CreatePath(self):
"""
CreatePath() -> GraphicsPath
Creates a native graphics path which is initially empty.
"""
def CreatePen(self, pen):
"""
CreatePen(pen) -> GraphicsPen
Creates a native pen from a wxPen.
"""
def DrawEllipse(self, x, y, w, h):
"""
DrawEllipse(x, y, w, h)
Draws an ellipse.
"""
def DrawIcon(self, icon, x, y, w, h):
"""
DrawIcon(icon, x, y, w, h)
Draws the icon.
"""
def DrawLines(self, point2Ds, fillStyle=ODDEVEN_RULE):
"""
DrawLines(point2Ds, fillStyle=ODDEVEN_RULE)
Draws a polygon.
"""
def DrawPath(self, path, fillStyle=ODDEVEN_RULE):
"""
DrawPath(path, fillStyle=ODDEVEN_RULE)
Draws the path by first filling and then stroking.
"""
def DrawRectangle(self, x, y, w, h):
"""
DrawRectangle(x, y, w, h)
Draws a rectangle.
"""
def DrawRoundedRectangle(self, x, y, w, h, radius):
"""
DrawRoundedRectangle(x, y, w, h, radius)
Draws a rounded rectangle.
"""
def DrawText(self, *args, **kw):
"""
DrawText(str, x, y)
DrawText(str, x, y, angle)
DrawText(str, x, y, backgroundBrush)
DrawText(str, x, y, angle, backgroundBrush)
Draws text at the defined position.
"""
def FillPath(self, path, fillStyle=ODDEVEN_RULE):
"""
FillPath(path, fillStyle=ODDEVEN_RULE)
Fills the path with the current brush.
"""
def GetNativeContext(self):
"""
GetNativeContext() -> void
Returns the native context (CGContextRef for Core Graphics, Graphics
pointer for GDIPlus and cairo_t pointer for cairo).
"""
def GetPartialTextExtents(self, text):
"""
GetPartialTextExtents(text) -> ArrayDouble
Fills the widths array with the widths from the beginning of text to
the corresponding character of text.
"""
def GetFullTextExtent(self, *args, **kw):
"""
GetFullTextExtent(text) -> (width, height, descent, externalLeading)
GetTextExtent(text) -> (width, height)
Gets the dimensions of the string using the currently selected font.
"""
def GetTransform(self):
"""
GetTransform() -> GraphicsMatrix
Gets the current transformation matrix of this context.
"""
def ResetClip(self):
"""
ResetClip()
Resets the clipping to original shape.
"""
def Rotate(self, angle):
"""
Rotate(angle)
Rotates the current transformation matrix (in radians).
"""
def Scale(self, xScale, yScale):
"""
Scale(xScale, yScale)
Scales the current transformation matrix.
"""
def SetBrush(self, *args, **kw):
"""
SetBrush(brush)
SetBrush(brush)
Sets the brush for filling paths.
"""
def SetFont(self, *args, **kw):
"""
SetFont(font, colour)
SetFont(font)
Sets the font for drawing text.
"""
def SetPen(self, *args, **kw):
"""
SetPen(pen)
SetPen(pen)
Sets the pen used for stroking.
"""
def SetTransform(self, matrix):
"""
SetTransform(matrix)
Sets the current transformation matrix of this context.
"""
def StrokeLine(self, x1, y1, x2, y2):
"""
StrokeLine(x1, y1, x2, y2)
Strokes a single line.
"""
def StrokeLines(self, point2Ds):
"""
StrokeLines(point2Ds)
Stroke lines conencting all the points.
"""
def StrokePath(self, path):
"""
StrokePath(path)
Strokes along a path with the current pen.
"""
def Translate(self, dx, dy):
"""
Translate(dx, dy)
Translates the current transformation matrix.
"""
def BeginLayer(self, opacity):
"""
BeginLayer(opacity)
Redirects all rendering is done into a fully transparent temporary
context.
"""
def EndLayer(self):
"""
EndLayer()
Composites back the drawings into the context with the opacity given
at the BeginLayer call.
"""
def SetAntialiasMode(self, antialias):
"""
SetAntialiasMode(antialias) -> bool
Sets the antialiasing mode, returns true if it supported.
"""
def GetAntialiasMode(self):
"""
GetAntialiasMode() -> AntialiasMode
Returns the current shape antialiasing mode.
"""
def SetInterpolationQuality(self, interpolation):
"""
SetInterpolationQuality(interpolation) -> bool
Sets the interpolation quality, returns true if it is supported.
"""
def GetInterpolationQuality(self):
"""
GetInterpolationQuality() -> InterpolationQuality
Returns the current interpolation quality.
"""
def SetCompositionMode(self, op):
"""
SetCompositionMode(op) -> bool
Sets the compositing operator, returns true if it supported.
"""
def GetCompositionMode(self):
"""
GetCompositionMode() -> CompositionMode
Returns the current compositing operator.
"""
def PushState(self):
"""
PushState()
Push the current state of the context's transformation matrix on a
stack.
"""
def PopState(self):
"""
PopState()
Pops a stored state from the stack and sets the current transformation
matrix to that state.
"""
def ShouldOffset(self):
"""
ShouldOffset() -> bool
"""
def EnableOffset(self, enable=True):
"""
EnableOffset(enable=True)
"""
def DisableOffset(self):
"""
DisableOffset()
"""
def OffsetEnabled(self):
"""
OffsetEnabled() -> bool
"""
def StartDoc(self, message):
"""
StartDoc(message) -> bool
Begin a new document (relevant only for printing / pdf etc.) If there
is a progress dialog, message will be shown.
"""
def EndDoc(self):
"""
EndDoc()
Done with that document (relevant only for printing / pdf etc.)
"""
def StartPage(self, width=0, height=0):
"""
StartPage(width=0, height=0)
Opens a new page (relevant only for printing / pdf etc.) with the
given size in points.
"""
def EndPage(self):
"""
EndPage()
Ends the current page (relevant only for printing / pdf etc.)
"""
def Flush(self):
"""
Flush()
Make sure that the current content of this context is immediately
visible.
"""
def GetSize(self):
"""
GetSize() -> (width, height)
Returns the size of the graphics context in device coordinates.
"""
def GetDPI(self):
"""
GetDPI() -> (dpiX, dpiY)
Returns the resolution of the graphics context in device points per
inch.
"""
DrawRotatedText = wx.deprecated(DrawText, 'Use DrawText instead.')
def StrokeLineSegments(self, beginPoint2Ds, endPoint2Ds):
"""
StrokeLineSegments(beginPoint2Ds, endPoint2Ds)
Stroke disconnected lines from begin to end points.
"""
AntialiasMode = property(None, None)
CompositionMode = property(None, None)
InterpolationQuality = property(None, None)
NativeContext = property(None, None)
TextExtent = property(None, None)
Transform = property(None, None)
# end of class GraphicsContext
class GraphicsGradientStop(object):
"""
GraphicsGradientStop(col=TransparentColour, pos=0.)
Represents a single gradient stop in a collection of gradient stops as
represented by wxGraphicsGradientStops.
"""
def __init__(self, col=TransparentColour, pos=0.):
"""
GraphicsGradientStop(col=TransparentColour, pos=0.)
Represents a single gradient stop in a collection of gradient stops as
represented by wxGraphicsGradientStops.
"""
def GetColour(self):
"""
GetColour() -> Colour
Return the stop colour.
"""
def SetColour(self, col):
"""
SetColour(col)
Change the stop colour.
"""
def GetPosition(self):
"""
GetPosition() -> float
Return the stop position.
"""
def SetPosition(self, pos):
"""
SetPosition(pos)
Change the stop position.
"""
Colour = property(None, None)
Position = property(None, None)
# end of class GraphicsGradientStop
class GraphicsGradientStops(object):
"""
GraphicsGradientStops(startCol=TransparentColour, endCol=TransparentColour)
Represents a collection of wxGraphicGradientStop values for use with
CreateLinearGradientBrush and CreateRadialGradientBrush.
"""
def __init__(self, startCol=TransparentColour, endCol=TransparentColour):
"""
GraphicsGradientStops(startCol=TransparentColour, endCol=TransparentColour)
Represents a collection of wxGraphicGradientStop values for use with
CreateLinearGradientBrush and CreateRadialGradientBrush.
"""
def Add(self, *args, **kw):
"""
Add(stop)
Add(col, pos)
Add a new stop.
"""
def Item(self, n):
"""
Item(n) -> GraphicsGradientStop
Returns the stop at the given index.
"""
def GetCount(self):
"""
GetCount() -> size_t
Returns the number of stops.
"""
def SetStartColour(self, col):
"""
SetStartColour(col)
Set the start colour to col.
"""
def GetStartColour(self):
"""
GetStartColour() -> Colour
Returns the start colour.
"""
def SetEndColour(self, col):
"""
SetEndColour(col)
Set the end colour to col.
"""
def GetEndColour(self):
"""
GetEndColour() -> Colour
Returns the end colour.
"""
def __len__(self):
"""
__len__() -> SIP_SSIZE_T
"""
def __getitem__(self, n):
"""
__getitem__(n)
"""
Count = property(None, None)
EndColour = property(None, None)
StartColour = property(None, None)
# end of class GraphicsGradientStops
class GraphicsMatrix(GraphicsObject):
"""
A wxGraphicsMatrix is a native representation of an affine matrix.
"""
def Concat(self, t):
"""
Concat(t)
Concatenates the matrix passed with the current matrix.
"""
def Get(self):
"""
Get() -> (a, b, c, d, tx, ty)
Returns the component values of the matrix via the argument pointers.
"""
def GetNativeMatrix(self):
"""
GetNativeMatrix() -> void
Returns the native representation of the matrix.
"""
def Invert(self):
"""
Invert()
Inverts the matrix.
"""
def IsEqual(self, t):
"""
IsEqual(t) -> bool
Returns true if the elements of the transformation matrix are equal.
"""
def IsIdentity(self):
"""
IsIdentity() -> bool
Return true if this is the identity matrix.
"""
def Rotate(self, angle):
"""
Rotate(angle)
Rotates this matrix clockwise (in radians).
"""
def Scale(self, xScale, yScale):
"""
Scale(xScale, yScale)
Scales this matrix.
"""
def Set(self, a=1.0, b=0.0, c=0.0, d=1.0, tx=0.0, ty=0.0):
"""
Set(a=1.0, b=0.0, c=0.0, d=1.0, tx=0.0, ty=0.0)
Sets the matrix to the respective values (default values are the
identity matrix).
"""
def TransformDistance(self, dx, dy):
"""
TransformDistance(dx, dy) -> (dx, dy)
Applies this matrix to a distance (ie.
"""
def TransformPoint(self, x, y):
"""
TransformPoint(x, y) -> (x, y)
Applies this matrix to a point.
"""
def Translate(self, dx, dy):
"""
Translate(dx, dy)
Translates this matrix.
"""
NativeMatrix = property(None, None)
# end of class GraphicsMatrix
class GraphicsPath(GraphicsObject):
"""
A wxGraphicsPath is a native representation of a geometric path.
"""
def AddArc(self, *args, **kw):
"""
AddArc(x, y, r, startAngle, endAngle, clockwise)
AddArc(c, r, startAngle, endAngle, clockwise)
Adds an arc of a circle.
"""
def AddArcToPoint(self, x1, y1, x2, y2, r):
"""
AddArcToPoint(x1, y1, x2, y2, r)
Appends a an arc to two tangents connecting (current) to (x1,y1) and
(x1,y1) to (x2,y2), also a straight line from (current) to (x1,y1).
"""
def AddCircle(self, x, y, r):
"""
AddCircle(x, y, r)
Appends a circle around (x,y) with radius r as a new closed subpath.
"""
def AddCurveToPoint(self, *args, **kw):
"""
AddCurveToPoint(cx1, cy1, cx2, cy2, x, y)
AddCurveToPoint(c1, c2, e)
Adds a cubic bezier curve from the current point, using two control
points and an end point.
"""
def AddEllipse(self, x, y, w, h):
"""
AddEllipse(x, y, w, h)
Appends an ellipse fitting into the passed in rectangle.
"""
def AddLineToPoint(self, *args, **kw):
"""
AddLineToPoint(x, y)
AddLineToPoint(p)
Adds a straight line from the current point to (x,y).
"""
def AddPath(self, path):
"""
AddPath(path)
Adds another path.
"""
def AddQuadCurveToPoint(self, cx, cy, x, y):
"""
AddQuadCurveToPoint(cx, cy, x, y)
Adds a quadratic bezier curve from the current point, using a control
point and an end point.
"""
def AddRectangle(self, x, y, w, h):
"""
AddRectangle(x, y, w, h)
Appends a rectangle as a new closed subpath.
"""
def AddRoundedRectangle(self, x, y, w, h, radius):
"""
AddRoundedRectangle(x, y, w, h, radius)
Appends a rounded rectangle as a new closed subpath.
"""
def CloseSubpath(self):
"""
CloseSubpath()
Closes the current sub-path.
"""
def Contains(self, *args, **kw):
"""
Contains(c, fillStyle=ODDEVEN_RULE) -> bool
Contains(x, y, fillStyle=ODDEVEN_RULE) -> bool
"""
def GetBox(self, *args, **kw):
"""
GetBox() -> Rect2D
Gets the bounding box enclosing all points (possibly including control
points).
"""
def GetCurrentPoint(self, *args, **kw):
"""
GetCurrentPoint() -> Point2D
Gets the last point of the current path, (0,0) if not yet set.
"""
def GetNativePath(self):
"""
GetNativePath() -> void
Returns the native path (CGPathRef for Core Graphics, Path pointer for
GDIPlus and a cairo_path_t pointer for cairo).
"""
def MoveToPoint(self, *args, **kw):
"""
MoveToPoint(x, y)
MoveToPoint(p)
Begins a new subpath at (x,y).
"""
def Transform(self, matrix):
"""
Transform(matrix)
Transforms each point of this path by the matrix.
"""
def UnGetNativePath(self, p):
"""
UnGetNativePath(p)
Gives back the native path returned by GetNativePath() because there
might be some deallocations necessary (e.g.
"""
Box = property(None, None)
CurrentPoint = property(None, None)
NativePath = property(None, None)
# end of class GraphicsPath
class GraphicsRenderer(Object):
"""
A wxGraphicsRenderer is the instance corresponding to the rendering
engine used.
"""
def CreateBitmap(self, bitmap):
"""
CreateBitmap(bitmap) -> GraphicsBitmap
Creates wxGraphicsBitmap from an existing wxBitmap.
"""
def CreateBitmapFromImage(self, image):
"""
CreateBitmapFromImage(image) -> GraphicsBitmap
Creates wxGraphicsBitmap from an existing wxImage.
"""
def CreateImageFromBitmap(self, bmp):
"""
CreateImageFromBitmap(bmp) -> Image
Creates a wxImage from a wxGraphicsBitmap.
"""
def CreateBitmapFromNativeBitmap(self, bitmap):
"""
CreateBitmapFromNativeBitmap(bitmap) -> GraphicsBitmap
Creates wxGraphicsBitmap from a native bitmap handle.
"""
def CreateContext(self, *args, **kw):
"""
CreateContext(window) -> GraphicsContext
CreateContext(windowDC) -> GraphicsContext
CreateContext(memoryDC) -> GraphicsContext
CreateContext(printerDC) -> GraphicsContext
Creates a wxGraphicsContext from a wxWindow.
"""
def CreateContextFromImage(self, image):
"""
CreateContextFromImage(image) -> GraphicsContext
Creates a wxGraphicsContext associated with a wxImage.
"""
def CreateBrush(self, brush):
"""
CreateBrush(brush) -> GraphicsBrush
Creates a native brush from a wxBrush.
"""
def CreateContextFromNativeContext(self, context):
"""
CreateContextFromNativeContext(context) -> GraphicsContext
Creates a wxGraphicsContext from a native context.
"""
def CreateContextFromNativeWindow(self, window):
"""
CreateContextFromNativeWindow(window) -> GraphicsContext
Creates a wxGraphicsContext from a native window.
"""
def CreateMeasuringContext(self):
"""
CreateMeasuringContext() -> GraphicsContext
Creates a wxGraphicsContext that can be used for measuring texts only.
"""
def CreateFont(self, *args, **kw):
"""
CreateFont(font, col=BLACK) -> GraphicsFont
CreateFont(sizeInPixels, facename, flags=FONTFLAG_DEFAULT, col=BLACK) -> GraphicsFont
Creates a native graphics font from a wxFont and a text colour.
"""
def CreateLinearGradientBrush(self, x1, y1, x2, y2, stops):
"""
CreateLinearGradientBrush(x1, y1, x2, y2, stops) -> GraphicsBrush
Creates a native brush with a linear gradient.
"""
def CreateMatrix(self, a=1.0, b=0.0, c=0.0, d=1.0, tx=0.0, ty=0.0):
"""
CreateMatrix(a=1.0, b=0.0, c=0.0, d=1.0, tx=0.0, ty=0.0) -> GraphicsMatrix
Creates a native affine transformation matrix from the passed in
values.
"""
def CreatePath(self):
"""
CreatePath() -> GraphicsPath
Creates a native graphics path which is initially empty.
"""
def CreatePen(self, pen):
"""
CreatePen(pen) -> GraphicsPen
Creates a native pen from a wxPen.
"""
def CreateRadialGradientBrush(self, xo, yo, xc, yc, radius, stops):
"""
CreateRadialGradientBrush(xo, yo, xc, yc, radius, stops) -> GraphicsBrush
Creates a native brush with a radial gradient.
"""
def CreateSubBitmap(self, bitmap, x, y, w, h):
"""
CreateSubBitmap(bitmap, x, y, w, h) -> GraphicsBitmap
Extracts a sub-bitmap from an existing bitmap.
"""
@staticmethod
def GetDefaultRenderer():
"""
GetDefaultRenderer() -> GraphicsRenderer
Returns the default renderer on this platform.
"""
@staticmethod
def GetCairoRenderer():
"""
GetCairoRenderer() -> GraphicsRenderer
"""
# end of class GraphicsRenderer
NullGraphicsPen = GraphicsPen()
NullGraphicsBrush = GraphicsBrush()
NullGraphicsFont = GraphicsFont()
NullGraphicsBitmap = GraphicsBitmap()
NullGraphicsMatrix = GraphicsMatrix()
NullGraphicsPath = GraphicsPath()
#-- end-graphics --#
#-- begin-imaglist --#
IMAGELIST_DRAW_NORMAL = 0
IMAGELIST_DRAW_TRANSPARENT = 0
IMAGELIST_DRAW_SELECTED = 0
IMAGELIST_DRAW_FOCUSED = 0
IMAGE_LIST_NORMAL = 0
IMAGE_LIST_SMALL = 0
IMAGE_LIST_STATE = 0
class ImageList(Object):
"""
ImageList()
ImageList(width, height, mask=True, initialCount=1)
A wxImageList contains a list of images, which are stored in an
unspecified form.
"""
def __init__(self, *args, **kw):
"""
ImageList()
ImageList(width, height, mask=True, initialCount=1)
A wxImageList contains a list of images, which are stored in an
unspecified form.
"""
def Add(self, *args, **kw):
"""
Add(bitmap, mask=NullBitmap) -> int
Add(bitmap, maskColour) -> int
Add(icon) -> int
Adds a new image or images using a bitmap and optional mask bitmap.
"""
def Create(self, width, height, mask=True, initialCount=1):
"""
Create(width, height, mask=True, initialCount=1) -> bool
Initializes the list.
"""
def Draw(self, index, dc, x, y, flags=IMAGELIST_DRAW_NORMAL, solidBackground=False):
"""
Draw(index, dc, x, y, flags=IMAGELIST_DRAW_NORMAL, solidBackground=False) -> bool
Draws a specified image onto a device context.
"""
def GetBitmap(self, index):
"""
GetBitmap(index) -> Bitmap
Returns the bitmap corresponding to the given index.
"""
def GetIcon(self, index):
"""
GetIcon(index) -> Icon
Returns the icon corresponding to the given index.
"""
def GetImageCount(self):
"""
GetImageCount() -> int
Returns the number of images in the list.
"""
def GetSize(self, index):
"""
GetSize(index) -> (width, height)
Retrieves the size of the images in the list.
"""
def Remove(self, index):
"""
Remove(index) -> bool
Removes the image at the given position.
"""
def RemoveAll(self):
"""
RemoveAll() -> bool
Removes all the images in the list.
"""
def Replace(self, *args, **kw):
"""
Replace(index, bitmap, mask=NullBitmap) -> bool
Replace(index, icon) -> bool
Replaces the existing image with the new image.
"""
ImageCount = property(None, None)
# end of class ImageList
#-- end-imaglist --#
#-- begin-overlay --#
class Overlay(object):
"""
Overlay()
Creates an overlay over an existing window, allowing for manipulations
like rubberbanding, etc.
"""
def __init__(self):
"""
Overlay()
Creates an overlay over an existing window, allowing for manipulations
like rubberbanding, etc.
"""
def Reset(self):
"""
Reset()
Clears the overlay without restoring the former state.
"""
# end of class Overlay
class DCOverlay(object):
"""
DCOverlay(overlay, dc, x, y, width, height)
DCOverlay(overlay, dc)
Connects an overlay with a drawing DC.
"""
def __init__(self, *args, **kw):
"""
DCOverlay(overlay, dc, x, y, width, height)
DCOverlay(overlay, dc)
Connects an overlay with a drawing DC.
"""
def Clear(self):
"""
Clear()
Clears the layer, restoring the state at the last init.
"""
# end of class DCOverlay
#-- end-overlay --#
#-- begin-renderer --#
CONTROL_DISABLED = 0
CONTROL_FOCUSED = 0
CONTROL_PRESSED = 0
CONTROL_SPECIAL = 0
CONTROL_ISDEFAULT = 0
CONTROL_ISSUBMENU = 0
CONTROL_EXPANDED = 0
CONTROL_SIZEGRIP = 0
CONTROL_FLAT = 0
CONTROL_CURRENT = 0
CONTROL_SELECTED = 0
CONTROL_CHECKED = 0
CONTROL_CHECKABLE = 0
CONTROL_UNDETERMINED = 0
TITLEBAR_BUTTON_CLOSE = 0
TITLEBAR_BUTTON_MAXIMIZE = 0
TITLEBAR_BUTTON_ICONIZE = 0
TITLEBAR_BUTTON_RESTORE = 0
TITLEBAR_BUTTON_HELP = 0
HDR_SORT_ICON_NONE = 0
HDR_SORT_ICON_UP = 0
HDR_SORT_ICON_DOWN = 0
class SplitterRenderParams(object):
"""
SplitterRenderParams(widthSash_, border_, isSens_)
This is just a simple struct used as a return value of
wxRendererNative::GetSplitterParams().
"""
def __init__(self, widthSash_, border_, isSens_):
"""
SplitterRenderParams(widthSash_, border_, isSens_)
This is just a simple struct used as a return value of
wxRendererNative::GetSplitterParams().
"""
border = property(None, None)
isHotSensitive = property(None, None)
widthSash = property(None, None)
# end of class SplitterRenderParams
class HeaderButtonParams(object):
"""
HeaderButtonParams()
This struct can optionally be used with
wxRendererNative::DrawHeaderButton() to specify custom values used to
draw the text or bitmap label.
"""
def __init__(self):
"""
HeaderButtonParams()
This struct can optionally be used with
wxRendererNative::DrawHeaderButton() to specify custom values used to
draw the text or bitmap label.
"""
m_arrowColour = property(None, None)
m_selectionColour = property(None, None)
m_labelText = property(None, None)
m_labelFont = property(None, None)
m_labelColour = property(None, None)
m_labelBitmap = property(None, None)
m_labelAlignment = property(None, None)
# end of class HeaderButtonParams
class RendererNative(object):
"""
First, a brief introduction to wxRendererNative and why it is needed.
"""
def DrawCheckBox(self, win, dc, rect, flags=0):
"""
DrawCheckBox(win, dc, rect, flags=0)
Draw a check box.
"""
def DrawComboBoxDropButton(self, win, dc, rect, flags=0):
"""
DrawComboBoxDropButton(win, dc, rect, flags=0)
Draw a button like the one used by wxComboBox to show a drop down
window.
"""
def DrawDropArrow(self, win, dc, rect, flags=0):
"""
DrawDropArrow(win, dc, rect, flags=0)
Draw a drop down arrow that is suitable for use outside a combo box.
"""
def DrawFocusRect(self, win, dc, rect, flags=0):
"""
DrawFocusRect(win, dc, rect, flags=0)
Draw a focus rectangle using the specified rectangle.
"""
def DrawHeaderButton(self, win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None):
"""
DrawHeaderButton(win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None) -> int
Draw the header control button (used, for example, by wxListCtrl).
"""
def DrawHeaderButtonContents(self, win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None):
"""
DrawHeaderButtonContents(win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None) -> int
Draw the contents of a header control button (label, sort arrows,
etc.).
"""
def DrawItemSelectionRect(self, win, dc, rect, flags=0):
"""
DrawItemSelectionRect(win, dc, rect, flags=0)
Draw a selection rectangle underneath the text as used e.g.
"""
def DrawPushButton(self, win, dc, rect, flags=0):
"""
DrawPushButton(win, dc, rect, flags=0)
Draw a blank push button that looks very similar to wxButton.
"""
def DrawSplitterBorder(self, win, dc, rect, flags=0):
"""
DrawSplitterBorder(win, dc, rect, flags=0)
Draw the border for sash window: this border must be such that the
sash drawn by DrawSplitterSash() blends into it well.
"""
def DrawSplitterSash(self, win, dc, size, position, orient, flags=0):
"""
DrawSplitterSash(win, dc, size, position, orient, flags=0)
Draw a sash.
"""
def DrawTreeItemButton(self, win, dc, rect, flags=0):
"""
DrawTreeItemButton(win, dc, rect, flags=0)
Draw the expanded/collapsed icon for a tree control item.
"""
def DrawChoice(self, win, dc, rect, flags=0):
"""
DrawChoice(win, dc, rect, flags=0)
Draw a native wxChoice.
"""
def DrawComboBox(self, win, dc, rect, flags=0):
"""
DrawComboBox(win, dc, rect, flags=0)
Draw a native wxComboBox.
"""
def DrawTextCtrl(self, win, dc, rect, flags=0):
"""
DrawTextCtrl(win, dc, rect, flags=0)
Draw a native wxTextCtrl frame.
"""
def DrawRadioBitmap(self, win, dc, rect, flags=0):
"""
DrawRadioBitmap(win, dc, rect, flags=0)
Draw a native wxRadioButton bitmap.
"""
def DrawTitleBarBitmap(self, win, dc, rect, button, flags=0):
"""
DrawTitleBarBitmap(win, dc, rect, button, flags=0)
Draw a title bar button in the given state.
"""
def GetCheckBoxSize(self, win):
"""
GetCheckBoxSize(win) -> Size
Returns the size of a check box.
"""
def GetHeaderButtonHeight(self, win):
"""
GetHeaderButtonHeight(win) -> int
Returns the height of a header button, either a fixed platform height
if available, or a generic height based on the win window's font.
"""
def GetHeaderButtonMargin(self, win):
"""
GetHeaderButtonMargin(win) -> int
Returns the horizontal margin on the left and right sides of header
button's label.
"""
def GetSplitterParams(self, win):
"""
GetSplitterParams(win) -> SplitterRenderParams
Get the splitter parameters, see wxSplitterRenderParams.
"""
def GetVersion(self):
"""
GetVersion() -> RendererVersion
This function is used for version checking: Load() refuses to load any
shared libraries implementing an older or incompatible version.
"""
@staticmethod
def Get():
"""
Get() -> RendererNative
Return the currently used renderer.
"""
@staticmethod
def GetDefault():
"""
GetDefault() -> RendererNative
Return the default (native) implementation for this platform this is
also the one used by default but this may be changed by calling Set()
in which case the return value of this method may be different from
the return value of Get().
"""
@staticmethod
def GetGeneric():
"""
GetGeneric() -> RendererNative
Return the generic implementation of the renderer.
"""
@staticmethod
def Load(name):
"""
Load(name) -> RendererNative
Load the renderer from the specified DLL, the returned pointer must be
deleted by caller if not NULL when it is not used any more.
"""
@staticmethod
def Set(renderer):
"""
Set(renderer) -> RendererNative
Set the renderer to use, passing NULL reverts to using the default
renderer (the global renderer must always exist).
"""
Version = property(None, None)
# end of class RendererNative
class DelegateRendererNative(RendererNative):
"""
DelegateRendererNative()
DelegateRendererNative(rendererNative)
wxDelegateRendererNative allows reuse of renderers code by forwarding
all the wxRendererNative methods to the given object and thus allowing
you to only modify some of its methods without having to reimplement
all of them.
"""
def __init__(self, *args, **kw):
"""
DelegateRendererNative()
DelegateRendererNative(rendererNative)
wxDelegateRendererNative allows reuse of renderers code by forwarding
all the wxRendererNative methods to the given object and thus allowing
you to only modify some of its methods without having to reimplement
all of them.
"""
def DrawHeaderButton(self, win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None):
"""
DrawHeaderButton(win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None) -> int
Draw the header control button (used, for example, by wxListCtrl).
"""
def DrawHeaderButtonContents(self, win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None):
"""
DrawHeaderButtonContents(win, dc, rect, flags=0, sortArrow=HDR_SORT_ICON_NONE, params=None) -> int
Draw the contents of a header control button (label, sort arrows,
etc.).
"""
def GetHeaderButtonHeight(self, win):
"""
GetHeaderButtonHeight(win) -> int
Returns the height of a header button, either a fixed platform height
if available, or a generic height based on the win window's font.
"""
def GetHeaderButtonMargin(self, win):
"""
GetHeaderButtonMargin(win) -> int
Returns the horizontal margin on the left and right sides of header
button's label.
"""
def DrawTreeItemButton(self, win, dc, rect, flags=0):
"""
DrawTreeItemButton(win, dc, rect, flags=0)
Draw the expanded/collapsed icon for a tree control item.
"""
def DrawSplitterBorder(self, win, dc, rect, flags=0):
"""
DrawSplitterBorder(win, dc, rect, flags=0)
Draw the border for sash window: this border must be such that the
sash drawn by DrawSplitterSash() blends into it well.
"""
def DrawSplitterSash(self, win, dc, size, position, orient, flags=0):
"""
DrawSplitterSash(win, dc, size, position, orient, flags=0)
Draw a sash.
"""
def DrawComboBoxDropButton(self, win, dc, rect, flags=0):
"""
DrawComboBoxDropButton(win, dc, rect, flags=0)
Draw a button like the one used by wxComboBox to show a drop down
window.
"""
def DrawDropArrow(self, win, dc, rect, flags=0):
"""
DrawDropArrow(win, dc, rect, flags=0)
Draw a drop down arrow that is suitable for use outside a combo box.
"""
def DrawCheckBox(self, win, dc, rect, flags=0):
"""
DrawCheckBox(win, dc, rect, flags=0)
Draw a check box.
"""
def GetCheckBoxSize(self, win):
"""
GetCheckBoxSize(win) -> Size
Returns the size of a check box.
"""
def DrawPushButton(self, win, dc, rect, flags=0):
"""
DrawPushButton(win, dc, rect, flags=0)
Draw a blank push button that looks very similar to wxButton.
"""
def DrawItemSelectionRect(self, win, dc, rect, flags=0):
"""
DrawItemSelectionRect(win, dc, rect, flags=0)
Draw a selection rectangle underneath the text as used e.g.
"""
def DrawFocusRect(self, win, dc, rect, flags=0):
"""
DrawFocusRect(win, dc, rect, flags=0)
Draw a focus rectangle using the specified rectangle.
"""
def GetSplitterParams(self, win):
"""
GetSplitterParams(win) -> SplitterRenderParams
Get the splitter parameters, see wxSplitterRenderParams.
"""
def GetVersion(self):
"""
GetVersion() -> RendererVersion
This function is used for version checking: Load() refuses to load any
shared libraries implementing an older or incompatible version.
"""
Version = property(None, None)
# end of class DelegateRendererNative
class RendererVersion(object):
"""
RendererVersion(version_, age_)
This simple struct represents the wxRendererNative interface version
and is only used as the return value of
wxRendererNative::GetVersion().
"""
def __init__(self, version_, age_):
"""
RendererVersion(version_, age_)
This simple struct represents the wxRendererNative interface version
and is only used as the return value of
wxRendererNative::GetVersion().
"""
age = property(None, None)
version = property(None, None)
@staticmethod
def IsCompatible(ver):
"""
IsCompatible(ver) -> bool
Checks if the main program is compatible with the renderer having the
version ver, returns true if it is and false otherwise.
"""
# end of class RendererVersion
#-- end-renderer --#
#-- begin-rawbmp --#
class PixelDataBase(object):
"""
PixelDataBase()
"""
def GetOrigin(self):
"""
GetOrigin() -> Point
Return the origin of the area this pixel data represents.
"""
def GetWidth(self):
"""
GetWidth() -> int
Return the width of the area this pixel data represents.
"""
def GetHeight(self):
"""
GetHeight() -> int
Return the height of the area this pixel data represents.
"""
def GetSize(self):
"""
GetSize() -> Size
Return the size of the area this pixel data represents.
"""
def GetRowStride(self):
"""
GetRowStride() -> int
Returns the distance between the start of one row to the start of the
next row.
"""
def __iter__(self):
"""
Create and return an iterator/generator object for traversing
this pixel data object.
"""
Height = property(None, None)
Origin = property(None, None)
RowStride = property(None, None)
Size = property(None, None)
Width = property(None, None)
def wxPixelDataBase(self):
"""
"""
# end of class PixelDataBase
class NativePixelData(PixelDataBase):
"""
NativePixelData(bmp)
NativePixelData(bmp, rect)
NativePixelData(bmp, pt, sz)
A class providing direct access to a :class:`Bitmap`'s
internal data without alpha channel (RGB).
"""
def __init__(self, *args, **kw):
"""
NativePixelData(bmp)
NativePixelData(bmp, rect)
NativePixelData(bmp, pt, sz)
A class providing direct access to a :class:`Bitmap`'s
internal data without alpha channel (RGB).
"""
def GetPixels(self):
"""
GetPixels() -> NativePixelData_Accessor
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
Pixels = property(None, None)
# end of class NativePixelData
class NativePixelData_Accessor(object):
"""
NativePixelData_Accessor(data)
NativePixelData_Accessor(bmp, data)
NativePixelData_Accessor()
"""
def __init__(self, *args, **kw):
"""
NativePixelData_Accessor(data)
NativePixelData_Accessor(bmp, data)
NativePixelData_Accessor()
"""
def Reset(self, data):
"""
Reset(data)
"""
def IsOk(self):
"""
IsOk() -> bool
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def Offset(self, data, x, y):
"""
Offset(data, x, y)
"""
def OffsetX(self, data, x):
"""
OffsetX(data, x)
"""
def OffsetY(self, data, y):
"""
OffsetY(data, y)
"""
def MoveTo(self, data, x, y):
"""
MoveTo(data, x, y)
"""
def nextPixel(self):
"""
nextPixel()
"""
def Set(self, red, green, blue):
"""
Set(red, green, blue)
"""
def Get(self):
"""
Get() -> PyObject
"""
# end of class NativePixelData_Accessor
class AlphaPixelData(PixelDataBase):
"""
AlphaPixelData(bmp)
AlphaPixelData(bmp, rect)
AlphaPixelData(bmp, pt, sz)
A class providing direct access to a :class:`wx.Bitmap`'s
internal data including the alpha channel (RGBA).
"""
def __init__(self, *args, **kw):
"""
AlphaPixelData(bmp)
AlphaPixelData(bmp, rect)
AlphaPixelData(bmp, pt, sz)
A class providing direct access to a :class:`wx.Bitmap`'s
internal data including the alpha channel (RGBA).
"""
def GetPixels(self):
"""
GetPixels() -> AlphaPixelData_Accessor
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
Pixels = property(None, None)
# end of class AlphaPixelData
class AlphaPixelData_Accessor(object):
"""
AlphaPixelData_Accessor(data)
AlphaPixelData_Accessor(bmp, data)
AlphaPixelData_Accessor()
"""
def __init__(self, *args, **kw):
"""
AlphaPixelData_Accessor(data)
AlphaPixelData_Accessor(bmp, data)
AlphaPixelData_Accessor()
"""
def Reset(self, data):
"""
Reset(data)
"""
def IsOk(self):
"""
IsOk() -> bool
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
def Offset(self, data, x, y):
"""
Offset(data, x, y)
"""
def OffsetX(self, data, x):
"""
OffsetX(data, x)
"""
def OffsetY(self, data, y):
"""
OffsetY(data, y)
"""
def MoveTo(self, data, x, y):
"""
MoveTo(data, x, y)
"""
def nextPixel(self):
"""
nextPixel()
"""
def Set(self, red, green, blue, alpha):
"""
Set(red, green, blue, alpha)
"""
def Get(self):
"""
Get() -> PyObject
"""
# end of class AlphaPixelData_Accessor
#-- end-rawbmp --#
#-- begin-accel --#
ACCEL_NORMAL = 0
ACCEL_ALT = 0
ACCEL_CTRL = 0
ACCEL_SHIFT = 0
ACCEL_RAW_CTRL = 0
ACCEL_CMD = 0
class AcceleratorEntry(object):
"""
AcceleratorEntry(flags=0, keyCode=0, cmd=0, item=None)
AcceleratorEntry(entry)
An object used by an application wishing to create an accelerator
table (see wxAcceleratorTable).
"""
def __init__(self, *args, **kw):
"""
AcceleratorEntry(flags=0, keyCode=0, cmd=0, item=None)
AcceleratorEntry(entry)
An object used by an application wishing to create an accelerator
table (see wxAcceleratorTable).
"""
def GetCommand(self):
"""
GetCommand() -> int
Returns the command identifier for the accelerator table entry.
"""
def GetFlags(self):
"""
GetFlags() -> int
Returns the flags for the accelerator table entry.
"""
def GetKeyCode(self):
"""
GetKeyCode() -> int
Returns the keycode for the accelerator table entry.
"""
def GetMenuItem(self):
"""
GetMenuItem() -> MenuItem
Returns the menu item associated with this accelerator entry.
"""
def Set(self, flags, keyCode, cmd, item=None):
"""
Set(flags, keyCode, cmd, item=None)
Sets the accelerator entry parameters.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if this object is correctly initialized.
"""
def ToString(self):
"""
ToString() -> String
Returns a textual representation of this accelerator.
"""
def ToRawString(self):
"""
ToRawString() -> String
Returns a textual representation of this accelerator which is
appropriate for saving in configuration files.
"""
def FromString(self, str):
"""
FromString(str) -> bool
Parses the given string and sets the accelerator accordingly.
"""
def __eq__(self):
"""
"""
def __ne__(self):
"""
"""
Command = property(None, None)
Flags = property(None, None)
KeyCode = property(None, None)
MenuItem = property(None, None)
# end of class AcceleratorEntry
class AcceleratorTable(Object):
"""
AcceleratorTable()
AcceleratorTable(entries)
An accelerator table allows the application to specify a table of
keyboard shortcuts for menu or button commands.
"""
def __init__(self, *args, **kw):
"""
AcceleratorTable()
AcceleratorTable(entries)
An accelerator table allows the application to specify a table of
keyboard shortcuts for menu or button commands.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the accelerator table is valid.
"""
# end of class AcceleratorTable
NullAcceleratorTable = AcceleratorTable()
@wx.deprecated
def GetAccelFromString(label):
pass
#-- end-accel --#
#-- begin-log --#
LOG_FatalError = 0
LOG_Error = 0
LOG_Warning = 0
LOG_Message = 0
LOG_Status = 0
LOG_Info = 0
LOG_Debug = 0
LOG_Trace = 0
LOG_Progress = 0
LOG_User = 0
LOG_Max = 0
class Log(object):
"""
wxLog class defines the interface for the log targets used by
wxWidgets logging functions as explained in the Logging Overview.
"""
@staticmethod
def AddTraceMask(mask):
"""
AddTraceMask(mask)
Add the mask to the list of allowed masks for wxLogTrace().
"""
@staticmethod
def ClearTraceMasks():
"""
ClearTraceMasks()
Removes all trace masks previously set with AddTraceMask().
"""
@staticmethod
def GetTraceMasks():
"""
GetTraceMasks() -> ArrayString
Returns the currently allowed list of string trace masks.
"""
@staticmethod
def IsAllowedTraceMask(mask):
"""
IsAllowedTraceMask(mask) -> bool
Returns true if the mask is one of allowed masks for wxLogTrace().
"""
@staticmethod
def RemoveTraceMask(mask):
"""
RemoveTraceMask(mask)
Remove the mask from the list of allowed masks for wxLogTrace().
"""
@staticmethod
def DontCreateOnDemand():
"""
DontCreateOnDemand()
Instructs wxLog to not create new log targets on the fly if there is
none currently (see GetActiveTarget()).
"""
@staticmethod
def GetActiveTarget():
"""
GetActiveTarget() -> Log
Returns the pointer to the active log target (may be NULL).
"""
@staticmethod
def SetActiveTarget(logtarget):
"""
SetActiveTarget(logtarget) -> Log
Sets the specified log target as the active one.
"""
@staticmethod
def SetThreadActiveTarget(logger):
"""
SetThreadActiveTarget(logger) -> Log
Sets a thread-specific log target.
"""
@staticmethod
def FlushActive():
"""
FlushActive()
Flushes the current log target if any, does nothing if there is none.
"""
@staticmethod
def Resume():
"""
Resume()
Resumes logging previously suspended by a call to Suspend().
"""
@staticmethod
def Suspend():
"""
Suspend()
Suspends the logging until Resume() is called.
"""
@staticmethod
def GetLogLevel():
"""
GetLogLevel() -> LogLevel
Returns the current log level limit.
"""
@staticmethod
def IsLevelEnabled(level, component):
"""
IsLevelEnabled(level, component) -> bool
Returns true if logging at this level is enabled for the current
thread.
"""
@staticmethod
def SetComponentLevel(component, level):
"""
SetComponentLevel(component, level)
Sets the log level for the given component.
"""
@staticmethod
def SetLogLevel(logLevel):
"""
SetLogLevel(logLevel)
Specifies that log messages with level greater (numerically) than
logLevel should be ignored and not sent to the active log target.
"""
@staticmethod
def EnableLogging(enable=True):
"""
EnableLogging(enable=True) -> bool
Globally enable or disable logging.
"""
@staticmethod
def IsEnabled():
"""
IsEnabled() -> bool
Returns true if logging is enabled at all now.
"""
@staticmethod
def GetRepetitionCounting():
"""
GetRepetitionCounting() -> bool
Returns whether the repetition counting mode is enabled.
"""
@staticmethod
def SetRepetitionCounting(repetCounting=True):
"""
SetRepetitionCounting(repetCounting=True)
Enables logging mode in which a log message is logged once, and in
case exactly the same message successively repeats one or more times,
only the number of repetitions is logged.
"""
@staticmethod
def GetTimestamp():
"""
GetTimestamp() -> String
Returns the current timestamp format string.
"""
@staticmethod
def SetTimestamp(format):
"""
SetTimestamp(format)
Sets the timestamp format prepended by the default log targets to all
messages.
"""
@staticmethod
def DisableTimestamp():
"""
DisableTimestamp()
Disables time stamping of the log messages.
"""
@staticmethod
def GetVerbose():
"""
GetVerbose() -> bool
Returns whether the verbose mode is currently active.
"""
@staticmethod
def SetVerbose(verbose=True):
"""
SetVerbose(verbose=True)
Activates or deactivates verbose mode in which the verbose messages
are logged as the normal ones instead of being silently dropped.
"""
def SetFormatter(self, formatter):
"""
SetFormatter(formatter) -> LogFormatter
Sets the specified formatter as the active one.
"""
def Flush(self):
"""
Flush()
Some of wxLog implementations, most notably the standard wxLogGui
class, buffer the messages (for example, to avoid showing the user a
zillion of modal message boxes one after another which would be
really annoying).
"""
def LogRecord(self, level, msg, info):
"""
LogRecord(level, msg, info)
Log the given record.
"""
def DoLogRecord(self, level, msg, info):
"""
DoLogRecord(level, msg, info)
Called to log a new record.
"""
def DoLogTextAtLevel(self, level, msg):
"""
DoLogTextAtLevel(level, msg)
Called to log the specified string at given level.
"""
def DoLogText(self, msg):
"""
DoLogText(msg)
Called to log the specified string.
"""
# end of class Log
class LogGui(Log):
"""
LogGui()
This is the default log target for the GUI wxWidgets applications.
"""
def __init__(self):
"""
LogGui()
This is the default log target for the GUI wxWidgets applications.
"""
def Flush(self):
"""
Flush()
Presents the accumulated log messages, if any, to the user.
"""
# end of class LogGui
class LogNull(object):
"""
LogNull()
This class allows you to temporarily suspend logging.
"""
def __init__(self):
"""
LogNull()
This class allows you to temporarily suspend logging.
"""
# end of class LogNull
class LogRecordInfo(object):
"""
Information about a log record (unit of the log output).
"""
filename = property(None, None)
line = property(None, None)
func = property(None, None)
timestamp = property(None, None)
# end of class LogRecordInfo
class LogChain(Log):
"""
LogChain(logger)
This simple class allows you to chain log sinks, that is to install a
new sink but keep passing log messages to the old one instead of
replacing it completely as wxLog::SetActiveTarget does.
"""
def __init__(self, logger):
"""
LogChain(logger)
This simple class allows you to chain log sinks, that is to install a
new sink but keep passing log messages to the old one instead of
replacing it completely as wxLog::SetActiveTarget does.
"""
def DetachOldLog(self):
"""
DetachOldLog()
Detaches the old log target so it won't be destroyed when the
wxLogChain object is destroyed.
"""
def GetOldLog(self):
"""
GetOldLog() -> Log
Returns the pointer to the previously active log target (which may be
NULL).
"""
def IsPassingMessages(self):
"""
IsPassingMessages() -> bool
Returns true if the messages are passed to the previously active log
target (default) or false if PassMessages() had been called.
"""
def PassMessages(self, passMessages):
"""
PassMessages(passMessages)
By default, the log messages are passed to the previously active log
target.
"""
def SetLog(self, logger):
"""
SetLog(logger)
Sets another log target to use (may be NULL).
"""
OldLog = property(None, None)
# end of class LogChain
class LogInterposer(LogChain):
"""
LogInterposer()
A special version of wxLogChain which uses itself as the new log
target.
"""
def __init__(self):
"""
LogInterposer()
A special version of wxLogChain which uses itself as the new log
target.
"""
# end of class LogInterposer
class LogInterposerTemp(LogChain):
"""
LogInterposerTemp()
A special version of wxLogChain which uses itself as the new log
target.
"""
def __init__(self):
"""
LogInterposerTemp()
A special version of wxLogChain which uses itself as the new log
target.
"""
# end of class LogInterposerTemp
class LogWindow(LogInterposer):
"""
LogWindow(pParent, szTitle, show=True, passToOld=True)
This class represents a background log window: to be precise, it
collects all log messages in the log frame which it manages but also
passes them on to the log target which was active at the moment of its
creation.
"""
def __init__(self, pParent, szTitle, show=True, passToOld=True):
"""
LogWindow(pParent, szTitle, show=True, passToOld=True)
This class represents a background log window: to be precise, it
collects all log messages in the log frame which it manages but also
passes them on to the log target which was active at the moment of its
creation.
"""
def GetFrame(self):
"""
GetFrame() -> Frame
Returns the associated log frame window.
"""
def OnFrameClose(self, frame):
"""
OnFrameClose(frame) -> bool
Called if the user closes the window interactively, will not be called
if it is destroyed for another reason (such as when program exits).
"""
def OnFrameDelete(self, frame):
"""
OnFrameDelete(frame)
Called right before the log frame is going to be deleted: will always
be called unlike OnFrameClose().
"""
def Show(self, show=True):
"""
Show(show=True)
Shows or hides the frame.
"""
Frame = property(None, None)
# end of class LogWindow
class LogStderr(Log):
"""
LogStderr()
This class can be used to redirect the log messages to a C file stream
(not to be confused with C++ streams).
"""
def __init__(self):
"""
LogStderr()
This class can be used to redirect the log messages to a C file stream
(not to be confused with C++ streams).
"""
# end of class LogStderr
class LogBuffer(Log):
"""
LogBuffer()
wxLogBuffer is a very simple implementation of log sink which simply
collects all the logged messages in a string (except the debug
messages which are output in the usual way immediately as we're
presumably not interested in collecting them for later).
"""
def __init__(self):
"""
LogBuffer()
wxLogBuffer is a very simple implementation of log sink which simply
collects all the logged messages in a string (except the debug
messages which are output in the usual way immediately as we're
presumably not interested in collecting them for later).
"""
def Flush(self):
"""
Flush()
Shows all the messages collected so far to the user (using a message
box in the GUI applications or by printing them out to the console in
text mode) and clears the internal buffer.
"""
def GetBuffer(self):
"""
GetBuffer() -> String
Returns the current buffer contains.
"""
Buffer = property(None, None)
# end of class LogBuffer
class LogTextCtrl(Log):
"""
LogTextCtrl(pTextCtrl)
Using these target all the log messages can be redirected to a text
control.
"""
def __init__(self, pTextCtrl):
"""
LogTextCtrl(pTextCtrl)
Using these target all the log messages can be redirected to a text
control.
"""
# end of class LogTextCtrl
class LogFormatter(object):
"""
LogFormatter()
wxLogFormatter class is used to format the log messages.
"""
def __init__(self):
"""
LogFormatter()
wxLogFormatter class is used to format the log messages.
"""
def Format(self, level, msg, info):
"""
Format(level, msg, info) -> String
This function creates the full log message string.
"""
def FormatTime(self, time):
"""
FormatTime(time) -> String
This function formats the time stamp part of the log message.
"""
# end of class LogFormatter
def SafeShowMessage(title, text):
"""
SafeShowMessage(title, text)
This function shows a message to the user in a safe way and should be
safe to call even before the application has been initialized or if it
is currently in some other strange state (for example, about to
crash).
"""
def SysErrorCode():
"""
SysErrorCode() -> unsignedlong
Returns the error code from the last system call.
"""
def SysErrorMsg(errCode=0):
"""
SysErrorMsg(errCode=0) -> String
Returns the error message corresponding to the given system error
code.
"""
def LogGeneric(level, message):
"""
LogGeneric(level, message)
Logs a message with the given wxLogLevel.
"""
def LogMessage(message):
"""
LogMessage(message)
For all normal, informational messages.
"""
def LogVerbose(message):
"""
LogVerbose(message)
For verbose output.
"""
def LogWarning(message):
"""
LogWarning(message)
For warnings - they are also normally shown to the user, but don't
interrupt the program work.
"""
def LogFatalError(message):
"""
LogFatalError(message)
Like wxLogError(), but also terminates the program with the exit code
3.
"""
def LogError(message):
"""
LogError(message)
The functions to use for error messages, i.e.
"""
def LogDebug(message):
"""
LogDebug(message)
The right functions for debug output.
"""
def LogStatus(*args, **kw):
"""
LogStatus(frame, message)
LogStatus(message)
Messages logged by this function will appear in the statusbar of the
frame or of the top level application window by default (i.e.
"""
def LogSysError(message):
"""
LogSysError(message)
Mostly used by wxWidgets itself, but might be handy for logging errors
after system call (API function) failure.
"""
#-- end-log --#
#-- begin-dataobj --#
class DataFormat(object):
"""
DataFormat(format=DF_INVALID)
DataFormat(format)
A wxDataFormat is an encapsulation of a platform-specific format
handle which is used by the system for the clipboard and drag and drop
operations.
"""
def __init__(self, *args, **kw):
"""
DataFormat(format=DF_INVALID)
DataFormat(format)
A wxDataFormat is an encapsulation of a platform-specific format
handle which is used by the system for the clipboard and drag and drop
operations.
"""
def GetId(self):
"""
GetId() -> String
Returns the name of a custom format (this function will fail for a
standard format).
"""
def GetType(self):
"""
GetType() -> DataFormatId
Returns the platform-specific number identifying the format.
"""
def SetId(self, format):
"""
SetId(format)
Sets the format to be the custom format identified by the given name.
"""
def SetType(self, type):
"""
SetType(type)
Sets the format to the given value, which should be one of wxDF_XXX
constants.
"""
def __ne__(self, *args, **kw):
"""
"""
def __eq__(self, *args, **kw):
"""
"""
Id = property(None, None)
Type = property(None, None)
# end of class DataFormat
FormatInvalid = DataFormat()
class DataObject(object):
"""
DataObject()
A wxDataObject represents data that can be copied to or from the
clipboard, or dragged and dropped.
"""
Get = 0
Set = 0
Both = 0
def __init__(self):
"""
DataObject()
A wxDataObject represents data that can be copied to or from the
clipboard, or dragged and dropped.
"""
def GetAllFormats(self, dir=Get):
"""
GetAllFormats(dir=Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
def GetDataHere(self, format, buf):
"""
GetDataHere(format, buf) -> bool
Copies this data object's data in the requested format to the buffer
provided.
"""
def GetDataSize(self, format):
"""
GetDataSize(format) -> size_t
Returns the data size of the given format format.
"""
def GetFormatCount(self, dir=Get):
"""
GetFormatCount(dir=Get) -> size_t
Returns the number of available formats for rendering or setting the
data.
"""
def GetPreferredFormat(self, dir=Get):
"""
GetPreferredFormat(dir=Get) -> DataFormat
Returns the preferred format for either rendering the data (if dir is
Get, its default value) or for setting it.
"""
def SetData(self, format, buf):
"""
SetData(format, buf) -> bool
Copies data from the provided buffer to this data object for the
specified format.
"""
def IsSupported(self, format, dir=Get):
"""
IsSupported(format, dir=Get) -> bool
Returns true if this format is supported.
"""
def _testGetAllFormats(self):
"""
_testGetAllFormats()
"""
AllFormats = property(None, None)
DataHere = property(None, None)
FormatCount = property(None, None)
PreferredFormat = property(None, None)
# end of class DataObject
class DataObjectSimple(DataObject):
"""
DataObjectSimple(format=FormatInvalid)
DataObjectSimple(formatName)
This is the simplest possible implementation of the wxDataObject
class.
"""
def __init__(self, *args, **kw):
"""
DataObjectSimple(format=FormatInvalid)
DataObjectSimple(formatName)
This is the simplest possible implementation of the wxDataObject
class.
"""
def GetDataHere(self, buf):
"""
GetDataHere(buf) -> bool
Copies this data object's data bytes to the given buffer
"""
def GetDataSize(self):
"""
GetDataSize() -> size_t
Gets the size of our data.
"""
def GetFormat(self):
"""
GetFormat() -> DataFormat
Returns the (one and only one) format supported by this object.
"""
def SetData(self, buf):
"""
SetData(buf) -> bool
Copies data from the provided buffer to this data object.
"""
def SetFormat(self, format):
"""
SetFormat(format)
Sets the supported format.
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
AllFormats = property(None, None)
DataHere = property(None, None)
DataSize = property(None, None)
Format = property(None, None)
# end of class DataObjectSimple
class CustomDataObject(DataObjectSimple):
"""
CustomDataObject(format=FormatInvalid)
CustomDataObject(formatName)
wxCustomDataObject is a specialization of wxDataObjectSimple for some
application-specific data in arbitrary (either custom or one of the
standard ones).
"""
def __init__(self, *args, **kw):
"""
CustomDataObject(format=FormatInvalid)
CustomDataObject(formatName)
wxCustomDataObject is a specialization of wxDataObjectSimple for some
application-specific data in arbitrary (either custom or one of the
standard ones).
"""
def GetData(self):
"""
GetData() -> PyObject
Returns a reference to the data buffer.
"""
def GetSize(self):
"""
GetSize() -> size_t
Returns the data size in bytes.
"""
def SetData(self, buf):
"""
SetData(buf) -> bool
Copies data from the provided buffer to this data object's buffer
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
AllFormats = property(None, None)
Data = property(None, None)
Size = property(None, None)
# end of class CustomDataObject
class DataObjectComposite(DataObject):
"""
DataObjectComposite()
wxDataObjectComposite is the simplest wxDataObject derivation which
may be used to support multiple formats.
"""
def __init__(self):
"""
DataObjectComposite()
wxDataObjectComposite is the simplest wxDataObject derivation which
may be used to support multiple formats.
"""
def Add(self, dataObject, preferred=False):
"""
Add(dataObject, preferred=False)
Adds the dataObject to the list of supported objects and it becomes
the preferred object if preferred is true.
"""
def GetReceivedFormat(self):
"""
GetReceivedFormat() -> DataFormat
Report the format passed to the SetData() method.
"""
def GetObject(self, format, dir=DataObject.Get):
"""
GetObject(format, dir=DataObject.Get) -> DataObjectSimple
Returns the pointer to the object which supports the passed format for
the specified direction.
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
def SetData(self, format, buf):
"""
SetData(format, buf) -> bool
"""
AllFormats = property(None, None)
ReceivedFormat = property(None, None)
# end of class DataObjectComposite
class BitmapDataObject(DataObjectSimple):
"""
BitmapDataObject(bitmap=NullBitmap)
wxBitmapDataObject is a specialization of wxDataObject for bitmap
data.
"""
def __init__(self, bitmap=NullBitmap):
"""
BitmapDataObject(bitmap=NullBitmap)
wxBitmapDataObject is a specialization of wxDataObject for bitmap
data.
"""
def GetBitmap(self):
"""
GetBitmap() -> Bitmap
Returns the bitmap associated with the data object.
"""
def SetBitmap(self, bitmap):
"""
SetBitmap(bitmap)
Sets the bitmap associated with the data object.
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
def SetData(self, format, buf):
"""
SetData(format, buf) -> bool
"""
AllFormats = property(None, None)
Bitmap = property(None, None)
# end of class BitmapDataObject
class TextDataObject(DataObjectSimple):
"""
TextDataObject(text=EmptyString)
wxTextDataObject is a specialization of wxDataObjectSimple for text
data.
"""
def __init__(self, text=EmptyString):
"""
TextDataObject(text=EmptyString)
wxTextDataObject is a specialization of wxDataObjectSimple for text
data.
"""
def GetText(self):
"""
GetText() -> String
Returns the text associated with the data object.
"""
def GetTextLength(self):
"""
GetTextLength() -> size_t
Returns the data size.
"""
def GetFormatCount(self, dir=DataObject.Get):
"""
GetFormatCount(dir=DataObject.Get) -> size_t
Returns 2 under wxMac and wxGTK, where text data coming from the
clipboard may be provided as ANSI (wxDF_TEXT) or as Unicode text
(wxDF_UNICODETEXT, but only when wxUSE_UNICODE==1).
"""
def GetFormat(self):
"""
GetFormat() -> DataFormat
Returns the preferred format supported by this object.
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
def SetText(self, strText):
"""
SetText(strText)
Sets the text associated with the data object.
"""
def SetData(self, format, buf):
"""
SetData(format, buf) -> bool
"""
AllFormats = property(None, None)
Format = property(None, None)
FormatCount = property(None, None)
Text = property(None, None)
TextLength = property(None, None)
# end of class TextDataObject
class URLDataObject(DataObject):
"""
URLDataObject(url=EmptyString)
wxURLDataObject is a wxDataObject containing an URL and can be used
e.g.
"""
def __init__(self, url=EmptyString):
"""
URLDataObject(url=EmptyString)
wxURLDataObject is a wxDataObject containing an URL and can be used
e.g.
"""
def GetURL(self):
"""
GetURL() -> String
Returns the URL stored by this object, as a string.
"""
def SetURL(self, url):
"""
SetURL(url)
Sets the URL stored by this object.
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
def SetData(self, format, buf):
"""
SetData(format, buf) -> bool
"""
AllFormats = property(None, None)
URL = property(None, None)
# end of class URLDataObject
class FileDataObject(DataObjectSimple):
"""
FileDataObject()
wxFileDataObject is a specialization of wxDataObject for file names.
"""
def __init__(self):
"""
FileDataObject()
wxFileDataObject is a specialization of wxDataObject for file names.
"""
def AddFile(self, file):
"""
AddFile(file)
Adds a file to the file list represented by this data object (Windows
only).
"""
def GetFilenames(self):
"""
GetFilenames() -> ArrayString
Returns the array of file names.
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
def SetData(self, format, buf):
"""
SetData(format, buf) -> bool
"""
AllFormats = property(None, None)
Filenames = property(None, None)
# end of class FileDataObject
class HTMLDataObject(DataObjectSimple):
"""
HTMLDataObject(html=EmptyString)
wxHTMLDataObject is used for working with HTML-formatted text.
"""
def __init__(self, html=EmptyString):
"""
HTMLDataObject(html=EmptyString)
wxHTMLDataObject is used for working with HTML-formatted text.
"""
def GetHTML(self):
"""
GetHTML() -> String
Returns the HTML string.
"""
def SetHTML(self, html):
"""
SetHTML(html)
Sets the HTML string.
"""
def GetAllFormats(self, dir=DataObject.Get):
"""
GetAllFormats(dir=DataObject.Get)
Returns a list of wx.DataFormat objects which this data object
supports transfering in the given direction.
"""
def SetData(self, format, buf):
"""
SetData(format, buf) -> bool
"""
AllFormats = property(None, None)
HTML = property(None, None)
# end of class HTMLDataObject
PyDataObjectSimple = wx.deprecated(DataObjectSimple), 'Use DataObjectSimple instead.'
PyTextDataObject = wx.deprecated(TextDataObject, 'Use TextDataObject instead.')
PyBitmapDataObject = wx.deprecated(BitmapDataObject, 'Use TextDataObject instead.')
#-- end-dataobj --#
#-- begin-dnd --#
Drag_CopyOnly = 0
Drag_AllowMove = 0
Drag_DefaultMove = 0
DragError = 0
DragNone = 0
DragCopy = 0
DragMove = 0
DragLink = 0
DragCancel = 0
def IsDragResultOk(res):
"""
IsDragResultOk(res) -> bool
Returns true if res indicates that something was done during a DnD
operation, i.e.
"""
class DropSource(object):
"""
DropSource(win=None)
DropSource(data, win=None)
This class represents a source for a drag and drop operation.
"""
def __init__(self, *args, **kw):
"""
DropSource(win=None)
DropSource(data, win=None)
This class represents a source for a drag and drop operation.
"""
def DoDragDrop(self, flags=Drag_CopyOnly):
"""
DoDragDrop(flags=Drag_CopyOnly) -> DragResult
Starts the drag-and-drop operation which will terminate when the user
releases the mouse.
"""
def GetDataObject(self):
"""
GetDataObject() -> DataObject
Returns the wxDataObject object that has been assigned previously.
"""
def GiveFeedback(self, effect):
"""
GiveFeedback(effect) -> bool
You may give some custom UI feedback during the drag and drop
operation by overriding this function.
"""
def SetCursor(self, res, cursor):
"""
SetCursor(res, cursor)
Set the icon to use for a certain drag result.
"""
def SetIcon(self, res, icon):
"""
SetIcon(res, icon)
Set the icon to use for a certain drag result.
"""
def SetData(self, data):
"""
SetData(data)
Sets the data wxDataObject associated with the drop source.
"""
DataObject = property(None, None)
# end of class DropSource
class DropTarget(object):
"""
DropTarget(data=None)
This class represents a target for a drag and drop operation.
"""
def __init__(self, data=None):
"""
DropTarget(data=None)
This class represents a target for a drag and drop operation.
"""
def GetData(self):
"""
GetData() -> bool
This method may only be called from within OnData().
"""
def OnData(self, x, y, defResult):
"""
OnData(x, y, defResult) -> DragResult
Called after OnDrop() returns true.
"""
def OnDragOver(self, x, y, defResult):
"""
OnDragOver(x, y, defResult) -> DragResult
Called when the mouse is being dragged over the drop target.
"""
def OnDrop(self, x, y):
"""
OnDrop(x, y) -> bool
Called when the user drops a data object on the target.
"""
def OnEnter(self, x, y, defResult):
"""
OnEnter(x, y, defResult) -> DragResult
Called when the mouse enters the drop target.
"""
def OnLeave(self):
"""
OnLeave()
Called when the mouse leaves the drop target.
"""
def GetDataObject(self):
"""
GetDataObject() -> DataObject
Returns the data wxDataObject associated with the drop target.
"""
def SetDataObject(self, data):
"""
SetDataObject(data)
Sets the data wxDataObject associated with the drop target and deletes
any previously associated data object.
"""
def SetDefaultAction(self, action):
"""
SetDefaultAction(action)
Sets the default action for drag and drop.
"""
def GetDefaultAction(self):
"""
GetDefaultAction() -> DragResult
Returns default action for drag and drop or wxDragNone if this not
specified.
"""
Data = property(None, None)
DataObject = property(None, None)
DefaultAction = property(None, None)
# end of class DropTarget
class TextDropTarget(DropTarget):
"""
TextDropTarget()
A predefined drop target for dealing with text data.
"""
def __init__(self):
"""
TextDropTarget()
A predefined drop target for dealing with text data.
"""
def OnDrop(self, x, y):
"""
OnDrop(x, y) -> bool
See wxDropTarget::OnDrop().
"""
def OnDropText(self, x, y, data):
"""
OnDropText(x, y, data) -> bool
Override this function to receive dropped text.
"""
# end of class TextDropTarget
class FileDropTarget(DropTarget):
"""
FileDropTarget()
This is a drop target which accepts files (dragged from File Manager
or Explorer).
"""
def __init__(self):
"""
FileDropTarget()
This is a drop target which accepts files (dragged from File Manager
or Explorer).
"""
def OnDrop(self, x, y):
"""
OnDrop(x, y) -> bool
See wxDropTarget::OnDrop().
"""
def OnDropFiles(self, x, y, filenames):
"""
OnDropFiles(x, y, filenames) -> bool
Override this function to receive dropped files.
"""
# end of class FileDropTarget
PyDropTarget = wx.deprecated(DropTarget, 'Use DropTarget instead.')
#-- end-dnd --#
#-- begin-clipbrd --#
class Clipboard(Object):
"""
Clipboard()
A class for manipulating the clipboard.
"""
def __init__(self):
"""
Clipboard()
A class for manipulating the clipboard.
"""
def AddData(self, data):
"""
AddData(data) -> bool
Call this function to add the data object to the clipboard.
"""
def Clear(self):
"""
Clear()
Clears the global clipboard object and the system's clipboard if
possible.
"""
def Close(self):
"""
Close()
Call this function to close the clipboard, having opened it with
Open().
"""
def Flush(self):
"""
Flush() -> bool
Flushes the clipboard: this means that the data which is currently on
clipboard will stay available even after the application exits
(possibly eating memory), otherwise the clipboard will be emptied on
exit.
"""
def GetData(self, data):
"""
GetData(data) -> bool
Call this function to fill data with data on the clipboard, if
available in the required format.
"""
def IsOpened(self):
"""
IsOpened() -> bool
Returns true if the clipboard has been opened.
"""
def IsSupported(self, format):
"""
IsSupported(format) -> bool
Returns true if there is data which matches the data format of the
given data object currently available on the clipboard.
"""
def IsUsingPrimarySelection(self):
"""
IsUsingPrimarySelection() -> bool
Returns true if we are using the primary selection, false if clipboard
one.
"""
def Open(self):
"""
Open() -> bool
Call this function to open the clipboard before calling SetData() and
GetData().
"""
def SetData(self, data):
"""
SetData(data) -> bool
Call this function to set the data object to the clipboard.
"""
def UsePrimarySelection(self, primary=False):
"""
UsePrimarySelection(primary=False)
On platforms supporting it (all X11-based ports), wxClipboard uses the
CLIPBOARD X11 selection by default.
"""
@staticmethod
def Get():
"""
Get() -> Clipboard
Returns the global instance (wxTheClipboard) of the clipboard object.
"""
# end of class Clipboard
# Since wxTheClipoard is not really a global varaiable (it is a macro
# that calls the Get static method) we can't declare it as a global
# variable for the wrapper generator, otherwise it will try to run the
# function at module import and the wxApp object won't exist yet. So
# we'll use a class that will allow us to delay calling the Get until
# wx.TheClipboard is actually being used for the first time.
class _wxPyDelayedInitWrapper(object):
def __init__(self, initfunc, *args, **kwargs):
self._initfunc = initfunc
self._args = args
self._kwargs = kwargs
self._instance = None
def _checkInstance(self):
if self._instance is None:
if wx.GetApp():
self._instance = self._initfunc(*self._args, **self._kwargs)
def __getattr__(self, name):
self._checkInstance()
return getattr(self._instance, name)
def __repr__(self):
self._checkInstance()
return repr(self._instance)
# context manager methods
def __enter__(self):
self._checkInstance()
if not self.Open():
raise RuntimeError('Unable to open clipboard.')
return self
def __exit__(self, exc_type, exc_val, exc_tb):
self.Close()
TheClipboard = _wxPyDelayedInitWrapper(Clipboard.Get)
#-- end-clipbrd --#
#-- begin-config --#
class ConfigBase(Object):
"""
ConfigBase(appName=EmptyString, vendorName=EmptyString, localFilename=EmptyString, globalFilename=EmptyString, style=0)
wxConfigBase defines the basic interface of all config classes.
"""
Type_Unknown = 0
Type_String = 0
Type_Boolean = 0
Type_Integer = 0
Type_Float = 0
def __init__(self, appName=EmptyString, vendorName=EmptyString, localFilename=EmptyString, globalFilename=EmptyString, style=0):
"""
ConfigBase(appName=EmptyString, vendorName=EmptyString, localFilename=EmptyString, globalFilename=EmptyString, style=0)
wxConfigBase defines the basic interface of all config classes.
"""
def GetPath(self):
"""
GetPath() -> String
Retrieve the current path (always as absolute path).
"""
def SetPath(self, strPath):
"""
SetPath(strPath)
Set current path: if the first character is '/', it is the absolute
path, otherwise it is a relative path.
"""
def GetFirstEntry(self):
"""
GetFirstEntry() -> PyObject
GetFirstEntry() -> (more, value, index)
Allows enumerating the entries in the current group in a config
object. Returns a tuple containing a flag indicating if there are
more
items, the name of the current item, and an index to pass to
GetNextEntry to fetch the next item.
"""
def GetFirstGroup(self):
"""
GetFirstGroup() -> PyObject
GetFirstGroup() -> (more, value, index)
Allows enumerating the subgroups in a config object. Returns a tuple
containing a flag indicating if there are more items, the name of the
current item, and an index to pass to GetNextGroup to fetch the next
item.
"""
def GetNextEntry(self, index):
"""
GetNextEntry(index) -> PyObject
GetNextEntry() -> (more, value, index)
Allows enumerating the entries in the current group in a config
object. Returns a tuple containing a flag indicating if there are
more
items, the name of the current item, and an index to pass to
GetNextEntry to fetch the next item.
"""
def GetNextGroup(self, index):
"""
GetNextGroup(index) -> PyObject
GetNextGroup(long index) -> (more, value, index)
Allows enumerating the subgroups in a config object. Returns a tuple
containing a flag indicating if there are more items, the name of the
current item, and an index to pass to GetNextGroup to fetch the next
item.
"""
def GetNumberOfEntries(self, bRecursive=False):
"""
GetNumberOfEntries(bRecursive=False) -> size_t
Get number of entries in the current group.
"""
def GetNumberOfGroups(self, bRecursive=False):
"""
GetNumberOfGroups(bRecursive=False) -> size_t
Get number of entries/subgroups in the current group, with or without
its subgroups.
"""
def Exists(self, strName):
"""
Exists(strName) -> bool
"""
def GetEntryType(self, name):
"""
GetEntryType(name) -> ConfigBase.EntryType
Returns the type of the given entry or Unknown if the entry doesn't
exist.
"""
def HasEntry(self, strName):
"""
HasEntry(strName) -> bool
"""
def HasGroup(self, strName):
"""
HasGroup(strName) -> bool
"""
def GetAppName(self):
"""
GetAppName() -> String
Returns the application name.
"""
def GetVendorName(self):
"""
GetVendorName() -> String
Returns the vendor name.
"""
def Flush(self, bCurrentOnly=False):
"""
Flush(bCurrentOnly=False) -> bool
Permanently writes all changes (otherwise, they're only written from
object's destructor).
"""
def Read(self, *args, **kw):
"""
Read(key, defaultVal=EmptyString) -> String
Another version of Read(), returning the string value directly.
"""
def ReadBool(self, key, defaultVal=False):
"""
ReadBool(key, defaultVal=False) -> bool
"""
def ReadDouble(self, key, defaultVal):
"""
ReadDouble(key, defaultVal) -> double
Reads a double value from the key and returns it.
"""
def ReadLong(self, key, defaultVal):
"""
ReadLong(key, defaultVal) -> long
Reads a long value from the key and returns it.
"""
def Write(self, key, value):
"""
Write(key, value) -> bool
Writes the wxString value to the config file and returns true on
success.
"""
def RenameEntry(self, oldName, newName):
"""
RenameEntry(oldName, newName) -> bool
Renames an entry in the current group.
"""
def RenameGroup(self, oldName, newName):
"""
RenameGroup(oldName, newName) -> bool
Renames a subgroup of the current group.
"""
def DeleteAll(self):
"""
DeleteAll() -> bool
Delete the whole underlying object (disk file, registry key, ...).
"""
def DeleteEntry(self, key, bDeleteGroupIfEmpty=True):
"""
DeleteEntry(key, bDeleteGroupIfEmpty=True) -> bool
Deletes the specified entry and the group it belongs to if it was the
last key in it and the second parameter is true.
"""
def DeleteGroup(self, key):
"""
DeleteGroup(key) -> bool
Delete the group (with all subgroups).
"""
def IsExpandingEnvVars(self):
"""
IsExpandingEnvVars() -> bool
Returns true if we are expanding environment variables in key values.
"""
def IsRecordingDefaults(self):
"""
IsRecordingDefaults() -> bool
Returns true if we are writing defaults back to the config file.
"""
def SetExpandEnvVars(self, bDoIt=True):
"""
SetExpandEnvVars(bDoIt=True)
Determine whether we wish to expand environment variables in key
values.
"""
def SetRecordDefaults(self, bDoIt=True):
"""
SetRecordDefaults(bDoIt=True)
Sets whether defaults are recorded to the config file whenever an
attempt to read the value which is not present in it is done.
"""
@staticmethod
def Create():
"""
Create() -> ConfigBase
Create a new config object and sets it as the current one.
"""
@staticmethod
def DontCreateOnDemand():
"""
DontCreateOnDemand()
Calling this function will prevent Get() from automatically creating a
new config object if the current one is NULL.
"""
@staticmethod
def Get(CreateOnDemand=True):
"""
Get(CreateOnDemand=True) -> ConfigBase
Get the current config object.
"""
@staticmethod
def Set(pConfig):
"""
Set(pConfig) -> ConfigBase
Sets the config object as the current one, returns the pointer to the
previous current object (both the parameter and returned value may be
NULL).
"""
def ReadInt(self, key, defaultVal=0):
"""
ReadInt(key, defaultVal=0) -> long
"""
def ReadFloat(self, key, defaultVal=0.0):
"""
ReadFloat(key, defaultVal=0.0) -> double
"""
def WriteInt(self, key, value):
"""
WriteInt(key, value) -> bool
"""
def WriteFloat(self, key, value):
"""
WriteFloat(key, value) -> bool
"""
def WriteBool(self, key, value):
"""
WriteBool(key, value) -> bool
"""
AppName = property(None, None)
FirstEntry = property(None, None)
FirstGroup = property(None, None)
NextEntry = property(None, None)
NextGroup = property(None, None)
NumberOfEntries = property(None, None)
NumberOfGroups = property(None, None)
Path = property(None, None)
VendorName = property(None, None)
# end of class ConfigBase
class FileConfig(ConfigBase):
"""
FileConfig(appName=EmptyString, vendorName=EmptyString, localFilename=EmptyString, globalFilename=EmptyString, style=CONFIG_USE_LOCAL_FILE|CONFIG_USE_GLOBAL_FILE)
FileConfig(is)
wxFileConfig implements wxConfigBase interface for storing and
retrieving configuration information using plain text files.
"""
def __init__(self, *args, **kw):
"""
FileConfig(appName=EmptyString, vendorName=EmptyString, localFilename=EmptyString, globalFilename=EmptyString, style=CONFIG_USE_LOCAL_FILE|CONFIG_USE_GLOBAL_FILE)
FileConfig(is)
wxFileConfig implements wxConfigBase interface for storing and
retrieving configuration information using plain text files.
"""
def Save(self, os):
"""
Save(os) -> bool
Saves all config data to the given stream, returns true if data was
saved successfully or false on error.
"""
def SetUmask(self, mode):
"""
SetUmask(mode)
Allows to set the mode to be used for the config file creation.
"""
def SetPath(self, strPath):
"""
SetPath(strPath)
Set current path: if the first character is '/', it is the absolute
path, otherwise it is a relative path.
"""
def GetPath(self):
"""
GetPath() -> String
Retrieve the current path (always as absolute path).
"""
def GetNumberOfEntries(self, bRecursive=False):
"""
GetNumberOfEntries(bRecursive=False) -> size_t
Get number of entries in the current group.
"""
def GetNumberOfGroups(self, bRecursive=False):
"""
GetNumberOfGroups(bRecursive=False) -> size_t
Get number of entries/subgroups in the current group, with or without
its subgroups.
"""
def HasGroup(self, strName):
"""
HasGroup(strName) -> bool
"""
def HasEntry(self, strName):
"""
HasEntry(strName) -> bool
"""
def Flush(self, bCurrentOnly=False):
"""
Flush(bCurrentOnly=False) -> bool
Permanently writes all changes (otherwise, they're only written from
object's destructor).
"""
def RenameEntry(self, oldName, newName):
"""
RenameEntry(oldName, newName) -> bool
Renames an entry in the current group.
"""
def RenameGroup(self, oldName, newName):
"""
RenameGroup(oldName, newName) -> bool
Renames a subgroup of the current group.
"""
def DeleteEntry(self, key, bDeleteGroupIfEmpty=True):
"""
DeleteEntry(key, bDeleteGroupIfEmpty=True) -> bool
Deletes the specified entry and the group it belongs to if it was the
last key in it and the second parameter is true.
"""
def DeleteGroup(self, key):
"""
DeleteGroup(key) -> bool
Delete the group (with all subgroups).
"""
def DeleteAll(self):
"""
DeleteAll() -> bool
Delete the whole underlying object (disk file, registry key, ...).
"""
@staticmethod
def GetGlobalFileName(szFile):
"""
GetGlobalFileName(szFile) -> String
"""
@staticmethod
def GetLocalFileName(szFile, style=0):
"""
GetLocalFileName(szFile, style=0) -> String
"""
NumberOfEntries = property(None, None)
NumberOfGroups = property(None, None)
Path = property(None, None)
# end of class FileConfig
class ConfigPathChanger(object):
"""
ConfigPathChanger(pContainer, strEntry)
A handy little class which changes the current path in a wxConfig
object and restores it in dtor.
"""
def __init__(self, pContainer, strEntry):
"""
ConfigPathChanger(pContainer, strEntry)
A handy little class which changes the current path in a wxConfig
object and restores it in dtor.
"""
def Name(self):
"""
Name() -> String
Returns the name of the key which was passed to the ctor.
"""
def UpdateIfDeleted(self):
"""
UpdateIfDeleted()
This method must be called if the original path inside the wxConfig
object (i.e.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class ConfigPathChanger
#-- end-config --#
#-- begin-tracker --#
class Trackable(object):
"""
Add-on base class for a trackable object.
"""
# end of class Trackable
#-- end-tracker --#
#-- begin-kbdstate --#
class KeyboardState(object):
"""
KeyboardState(controlDown=False, shiftDown=False, altDown=False, metaDown=False)
Provides methods for testing the state of the keyboard modifier keys.
"""
def __init__(self, controlDown=False, shiftDown=False, altDown=False, metaDown=False):
"""
KeyboardState(controlDown=False, shiftDown=False, altDown=False, metaDown=False)
Provides methods for testing the state of the keyboard modifier keys.
"""
def GetModifiers(self):
"""
GetModifiers() -> int
Return the bit mask of all pressed modifier keys.
"""
def HasAnyModifiers(self):
"""
HasAnyModifiers() -> bool
Returns true if any modifiers at all are pressed.
"""
def HasModifiers(self):
"""
HasModifiers() -> bool
Returns true if Control or Alt are pressed.
"""
def ControlDown(self):
"""
ControlDown() -> bool
Returns true if the Control key or Apple/Command key under OS X is
pressed.
"""
def RawControlDown(self):
"""
RawControlDown() -> bool
Returns true if the Control key (also under OS X).
"""
def ShiftDown(self):
"""
ShiftDown() -> bool
Returns true if the Shift key is pressed.
"""
def MetaDown(self):
"""
MetaDown() -> bool
Returns true if the Meta/Windows/Apple key is pressed.
"""
def AltDown(self):
"""
AltDown() -> bool
Returns true if the Alt key is pressed.
"""
def CmdDown(self):
"""
CmdDown() -> bool
Returns true if the key used for command accelerators is pressed.
"""
def SetControlDown(self, down):
"""
SetControlDown(down)
"""
def SetRawControlDown(self, down):
"""
SetRawControlDown(down)
"""
def SetShiftDown(self, down):
"""
SetShiftDown(down)
"""
def SetAltDown(self, down):
"""
SetAltDown(down)
"""
def SetMetaDown(self, down):
"""
SetMetaDown(down)
"""
controlDown = property(None, None)
rawControlDown = property(None, None)
shiftDown = property(None, None)
altDown = property(None, None)
metaDown = property(None, None)
cmdDown = property(None, None)
# For 2.8 compatibility
m_controlDown = wx.deprecated(controlDown, "Use controlDown instead.")
m_shiftDown = wx.deprecated(shiftDown, "Use shiftDown instead.")
m_altDown = wx.deprecated(altDown, "Use altDown instead.")
m_metaDown = wx.deprecated(metaDown, "Use metaDown instead.")
# end of class KeyboardState
#-- end-kbdstate --#
#-- begin-mousestate --#
MOUSE_BTN_ANY = 0
MOUSE_BTN_NONE = 0
MOUSE_BTN_LEFT = 0
MOUSE_BTN_MIDDLE = 0
MOUSE_BTN_RIGHT = 0
MOUSE_BTN_AUX1 = 0
MOUSE_BTN_AUX2 = 0
MOUSE_BTN_MAX = 0
class MouseState(KeyboardState):
"""
MouseState()
Represents the mouse state.
"""
def __init__(self):
"""
MouseState()
Represents the mouse state.
"""
def GetPosition(self, *args, **kw):
"""
GetPosition() -> Point
Returns the physical mouse position.
"""
def GetX(self):
"""
GetX() -> Coord
Returns X coordinate of the physical mouse event position.
"""
def GetY(self):
"""
GetY() -> Coord
Returns Y coordinate of the physical mouse event position.
"""
def LeftIsDown(self):
"""
LeftIsDown() -> bool
Returns true if the left mouse button is currently down.
"""
def MiddleIsDown(self):
"""
MiddleIsDown() -> bool
Returns true if the middle mouse button is currently down.
"""
def RightIsDown(self):
"""
RightIsDown() -> bool
Returns true if the right mouse button is currently down.
"""
def Aux1IsDown(self):
"""
Aux1IsDown() -> bool
Returns true if the first extra button mouse button is currently down.
"""
def Aux2IsDown(self):
"""
Aux2IsDown() -> bool
Returns true if the second extra button mouse button is currently
down.
"""
def SetX(self, x):
"""
SetX(x)
"""
def SetY(self, y):
"""
SetY(y)
"""
def SetPosition(self, pos):
"""
SetPosition(pos)
"""
def SetLeftDown(self, down):
"""
SetLeftDown(down)
"""
def SetMiddleDown(self, down):
"""
SetMiddleDown(down)
"""
def SetRightDown(self, down):
"""
SetRightDown(down)
"""
def SetAux1Down(self, down):
"""
SetAux1Down(down)
"""
def SetAux2Down(self, down):
"""
SetAux2Down(down)
"""
def SetState(self, state):
"""
SetState(state)
"""
x = property(None, None)
y = property(None, None)
leftIsDown = property(None, None)
middleIsDown = property(None, None)
rightIsDown = property(None, None)
aux1IsDown = property(None, None)
aux2IsDown = property(None, None)
Position = property(None, None)
# end of class MouseState
#-- end-mousestate --#
#-- begin-tooltip --#
class ToolTip(Object):
"""
ToolTip(tip)
This class holds information about a tooltip associated with a window
(see wxWindow::SetToolTip()).
"""
def __init__(self, tip):
"""
ToolTip(tip)
This class holds information about a tooltip associated with a window
(see wxWindow::SetToolTip()).
"""
def GetTip(self):
"""
GetTip() -> String
Get the tooltip text.
"""
def GetWindow(self):
"""
GetWindow() -> Window
Get the associated window.
"""
def SetTip(self, tip):
"""
SetTip(tip)
Set the tooltip text.
"""
@staticmethod
def Enable(flag):
"""
Enable(flag)
Enable or disable tooltips globally.
"""
@staticmethod
def SetAutoPop(msecs):
"""
SetAutoPop(msecs)
Set the delay after which the tooltip disappears or how long a tooltip
remains visible.
"""
@staticmethod
def SetDelay(msecs):
"""
SetDelay(msecs)
Set the delay after which the tooltip appears.
"""
@staticmethod
def SetMaxWidth(width):
"""
SetMaxWidth(width)
Set tooltip maximal width in pixels.
"""
@staticmethod
def SetReshow(msecs):
"""
SetReshow(msecs)
Set the delay between subsequent tooltips to appear.
"""
Tip = property(None, None)
Window = property(None, None)
# end of class ToolTip
#-- end-tooltip --#
#-- begin-layout --#
Left = 0
Top = 0
Right = 0
Bottom = 0
Width = 0
Height = 0
Centre = 0
Center = 0
CentreX = 0
CentreY = 0
Unconstrained = 0
AsIs = 0
PercentOf = 0
Above = 0
Below = 0
LeftOf = 0
RightOf = 0
SameAs = 0
Absolute = 0
LAYOUT_DEFAULT_MARGIN = 0
class IndividualLayoutConstraint(Object):
"""
IndividualLayoutConstraint()
"""
def __init__(self):
"""
IndividualLayoutConstraint()
"""
def Set(self, rel, otherW, otherE, val=0, margin=LAYOUT_DEFAULT_MARGIN):
"""
Set(rel, otherW, otherE, val=0, margin=LAYOUT_DEFAULT_MARGIN)
"""
def LeftOf(self, sibling, margin=LAYOUT_DEFAULT_MARGIN):
"""
LeftOf(sibling, margin=LAYOUT_DEFAULT_MARGIN)
"""
def RightOf(self, sibling, margin=LAYOUT_DEFAULT_MARGIN):
"""
RightOf(sibling, margin=LAYOUT_DEFAULT_MARGIN)
"""
def Above(self, sibling, margin=LAYOUT_DEFAULT_MARGIN):
"""
Above(sibling, margin=LAYOUT_DEFAULT_MARGIN)
"""
def Below(self, sibling, margin=LAYOUT_DEFAULT_MARGIN):
"""
Below(sibling, margin=LAYOUT_DEFAULT_MARGIN)
"""
def SameAs(self, otherW, edge, margin=LAYOUT_DEFAULT_MARGIN):
"""
SameAs(otherW, edge, margin=LAYOUT_DEFAULT_MARGIN)
"""
def PercentOf(self, otherW, wh, per):
"""
PercentOf(otherW, wh, per)
"""
def Absolute(self, val):
"""
Absolute(val)
"""
def Unconstrained(self):
"""
Unconstrained()
"""
def AsIs(self):
"""
AsIs()
"""
def GetOtherWindow(self):
"""
GetOtherWindow() -> Window
"""
def GetMyEdge(self):
"""
GetMyEdge() -> Edge
"""
def SetEdge(self, which):
"""
SetEdge(which)
"""
def SetValue(self, v):
"""
SetValue(v)
"""
def GetMargin(self):
"""
GetMargin() -> int
"""
def SetMargin(self, m):
"""
SetMargin(m)
"""
def GetValue(self):
"""
GetValue() -> int
"""
def GetPercent(self):
"""
GetPercent() -> int
"""
def GetOtherEdge(self):
"""
GetOtherEdge() -> int
"""
def GetDone(self):
"""
GetDone() -> bool
"""
def SetDone(self, d):
"""
SetDone(d)
"""
def GetRelationship(self):
"""
GetRelationship() -> Relationship
"""
def SetRelationship(self, r):
"""
SetRelationship(r)
"""
def ResetIfWin(self, otherW):
"""
ResetIfWin(otherW) -> bool
"""
def SatisfyConstraint(self, constraints, win):
"""
SatisfyConstraint(constraints, win) -> bool
"""
def GetEdge(self, which, thisWin, other):
"""
GetEdge(which, thisWin, other) -> int
"""
Done = property(None, None)
Margin = property(None, None)
MyEdge = property(None, None)
OtherEdge = property(None, None)
OtherWindow = property(None, None)
Percent = property(None, None)
Relationship = property(None, None)
Value = property(None, None)
# end of class IndividualLayoutConstraint
class LayoutConstraints(Object):
"""
LayoutConstraints()
"""
def __init__(self):
"""
LayoutConstraints()
"""
left = property(None, None)
top = property(None, None)
right = property(None, None)
bottom = property(None, None)
width = property(None, None)
height = property(None, None)
centreX = property(None, None)
centreY = property(None, None)
def SatisfyConstraints(self, win, noChanges):
"""
SatisfyConstraints(win, noChanges) -> bool
"""
def AreSatisfied(self):
"""
AreSatisfied() -> bool
"""
# end of class LayoutConstraints
#-- end-layout --#
#-- begin-event --#
EVENT_PROPAGATE_NONE = 0
EVENT_PROPAGATE_MAX = 0
wxEVT_CATEGORY_UI = 0
wxEVT_CATEGORY_USER_INPUT = 0
wxEVT_CATEGORY_SOCKET = 0
wxEVT_CATEGORY_TIMER = 0
wxEVT_CATEGORY_THREAD = 0
wxEVT_CATEGORY_ALL = 0
WXK_CATEGORY_ARROW = 0
WXK_CATEGORY_PAGING = 0
WXK_CATEGORY_JUMP = 0
WXK_CATEGORY_TAB = 0
WXK_CATEGORY_CUT = 0
WXK_CATEGORY_NAVIGATION = 0
JOYSTICK1 = 0
JOYSTICK2 = 0
JOY_BUTTON_ANY = 0
JOY_BUTTON1 = 0
JOY_BUTTON2 = 0
JOY_BUTTON3 = 0
JOY_BUTTON4 = 0
UPDATE_UI_PROCESS_ALL = 0
UPDATE_UI_PROCESS_SPECIFIED = 0
MOUSE_WHEEL_VERTICAL = 0
MOUSE_WHEEL_HORIZONTAL = 0
IDLE_PROCESS_ALL = 0
IDLE_PROCESS_SPECIFIED = 0
wxEVT_NULL = 0
wxEVT_ANY = 0
wxEVT_BUTTON = 0
wxEVT_CHECKBOX = 0
wxEVT_CHOICE = 0
wxEVT_LISTBOX = 0
wxEVT_LISTBOX_DCLICK = 0
wxEVT_CHECKLISTBOX = 0
wxEVT_MENU = 0
wxEVT_SLIDER = 0
wxEVT_RADIOBOX = 0
wxEVT_RADIOBUTTON = 0
wxEVT_SCROLLBAR = 0
wxEVT_VLBOX = 0
wxEVT_COMBOBOX = 0
wxEVT_TOOL_RCLICKED = 0
wxEVT_TOOL_DROPDOWN = 0
wxEVT_TOOL_ENTER = 0
wxEVT_COMBOBOX_DROPDOWN = 0
wxEVT_COMBOBOX_CLOSEUP = 0
wxEVT_THREAD = 0
wxEVT_LEFT_DOWN = 0
wxEVT_LEFT_UP = 0
wxEVT_MIDDLE_DOWN = 0
wxEVT_MIDDLE_UP = 0
wxEVT_RIGHT_DOWN = 0
wxEVT_RIGHT_UP = 0
wxEVT_MOTION = 0
wxEVT_ENTER_WINDOW = 0
wxEVT_LEAVE_WINDOW = 0
wxEVT_LEFT_DCLICK = 0
wxEVT_MIDDLE_DCLICK = 0
wxEVT_RIGHT_DCLICK = 0
wxEVT_SET_FOCUS = 0
wxEVT_KILL_FOCUS = 0
wxEVT_CHILD_FOCUS = 0
wxEVT_MOUSEWHEEL = 0
wxEVT_AUX1_DOWN = 0
wxEVT_AUX1_UP = 0
wxEVT_AUX1_DCLICK = 0
wxEVT_AUX2_DOWN = 0
wxEVT_AUX2_UP = 0
wxEVT_AUX2_DCLICK = 0
wxEVT_CHAR = 0
wxEVT_CHAR_HOOK = 0
wxEVT_NAVIGATION_KEY = 0
wxEVT_KEY_DOWN = 0
wxEVT_KEY_UP = 0
wxEVT_HOTKEY = 0
wxEVT_SET_CURSOR = 0
wxEVT_SCROLL_TOP = 0
wxEVT_SCROLL_BOTTOM = 0
wxEVT_SCROLL_LINEUP = 0
wxEVT_SCROLL_LINEDOWN = 0
wxEVT_SCROLL_PAGEUP = 0
wxEVT_SCROLL_PAGEDOWN = 0
wxEVT_SCROLL_THUMBTRACK = 0
wxEVT_SCROLL_THUMBRELEASE = 0
wxEVT_SCROLL_CHANGED = 0
wxEVT_SPIN_UP = 0
wxEVT_SPIN_DOWN = 0
wxEVT_SPIN = 0
wxEVT_SCROLLWIN_TOP = 0
wxEVT_SCROLLWIN_BOTTOM = 0
wxEVT_SCROLLWIN_LINEUP = 0
wxEVT_SCROLLWIN_LINEDOWN = 0
wxEVT_SCROLLWIN_PAGEUP = 0
wxEVT_SCROLLWIN_PAGEDOWN = 0
wxEVT_SCROLLWIN_THUMBTRACK = 0
wxEVT_SCROLLWIN_THUMBRELEASE = 0
wxEVT_SIZE = 0
wxEVT_MOVE = 0
wxEVT_CLOSE_WINDOW = 0
wxEVT_END_SESSION = 0
wxEVT_QUERY_END_SESSION = 0
wxEVT_ACTIVATE_APP = 0
wxEVT_ACTIVATE = 0
wxEVT_CREATE = 0
wxEVT_DESTROY = 0
wxEVT_SHOW = 0
wxEVT_ICONIZE = 0
wxEVT_MAXIMIZE = 0
wxEVT_MOUSE_CAPTURE_CHANGED = 0
wxEVT_MOUSE_CAPTURE_LOST = 0
wxEVT_PAINT = 0
wxEVT_ERASE_BACKGROUND = 0
wxEVT_NC_PAINT = 0
wxEVT_MENU_OPEN = 0
wxEVT_MENU_CLOSE = 0
wxEVT_MENU_HIGHLIGHT = 0
wxEVT_CONTEXT_MENU = 0
wxEVT_SYS_COLOUR_CHANGED = 0
wxEVT_DISPLAY_CHANGED = 0
wxEVT_QUERY_NEW_PALETTE = 0
wxEVT_PALETTE_CHANGED = 0
wxEVT_JOY_BUTTON_DOWN = 0
wxEVT_JOY_BUTTON_UP = 0
wxEVT_JOY_MOVE = 0
wxEVT_JOY_ZMOVE = 0
wxEVT_DROP_FILES = 0
wxEVT_INIT_DIALOG = 0
wxEVT_IDLE = 0
wxEVT_UPDATE_UI = 0
wxEVT_SIZING = 0
wxEVT_MOVING = 0
wxEVT_MOVE_START = 0
wxEVT_MOVE_END = 0
wxEVT_HIBERNATE = 0
wxEVT_TEXT_COPY = 0
wxEVT_TEXT_CUT = 0
wxEVT_TEXT_PASTE = 0
wxEVT_COMMAND_LEFT_CLICK = 0
wxEVT_COMMAND_LEFT_DCLICK = 0
wxEVT_COMMAND_RIGHT_CLICK = 0
wxEVT_COMMAND_RIGHT_DCLICK = 0
wxEVT_COMMAND_SET_FOCUS = 0
wxEVT_COMMAND_KILL_FOCUS = 0
wxEVT_COMMAND_ENTER = 0
wxEVT_HELP = 0
wxEVT_DETAILED_HELP = 0
wxEVT_TOOL = 0
wxEVT_WINDOW_MODAL_DIALOG_CLOSED = 0
class EvtHandler(Object, Trackable):
"""
EvtHandler()
A class that can handle events from the windowing system.
"""
def __init__(self):
"""
EvtHandler()
A class that can handle events from the windowing system.
"""
def QueueEvent(self, event):
"""
QueueEvent(event)
Queue event for a later processing.
"""
def AddPendingEvent(self, event):
"""
AddPendingEvent(event)
Post an event to be processed later.
"""
def ProcessEvent(self, event):
"""
ProcessEvent(event) -> bool
Processes an event, searching event tables and calling zero or more
suitable event handler function(s).
"""
def ProcessEventLocally(self, event):
"""
ProcessEventLocally(event) -> bool
Try to process the event in this handler and all those chained to it.
"""
def SafelyProcessEvent(self, event):
"""
SafelyProcessEvent(event) -> bool
Processes an event by calling ProcessEvent() and handles any
exceptions that occur in the process.
"""
def ProcessPendingEvents(self):
"""
ProcessPendingEvents()
Processes the pending events previously queued using QueueEvent() or
AddPendingEvent(); you must call this function only if you are sure
there are pending events for this handler, otherwise a wxCHECK will
fail.
"""
def DeletePendingEvents(self):
"""
DeletePendingEvents()
Deletes all events queued on this event handler using QueueEvent() or
AddPendingEvent().
"""
def Connect(self, id, lastId, eventType, func):
"""
Connect(id, lastId, eventType, func)
Make an entry in the dynamic event table for an event binding.
"""
def Disconnect(self, id, lastId=-1, eventType=wxEVT_NULL, func=None):
"""
Disconnect(id, lastId=-1, eventType=wxEVT_NULL, func=None) -> bool
Remove an event binding by removing its entry in the dynamic event
table.
"""
def GetEvtHandlerEnabled(self):
"""
GetEvtHandlerEnabled() -> bool
Returns true if the event handler is enabled, false otherwise.
"""
def GetNextHandler(self):
"""
GetNextHandler() -> EvtHandler
Returns the pointer to the next handler in the chain.
"""
def GetPreviousHandler(self):
"""
GetPreviousHandler() -> EvtHandler
Returns the pointer to the previous handler in the chain.
"""
def SetEvtHandlerEnabled(self, enabled):
"""
SetEvtHandlerEnabled(enabled)
Enables or disables the event handler.
"""
def SetNextHandler(self, handler):
"""
SetNextHandler(handler)
Sets the pointer to the next handler.
"""
def SetPreviousHandler(self, handler):
"""
SetPreviousHandler(handler)
Sets the pointer to the previous handler.
"""
def Unlink(self):
"""
Unlink()
Unlinks this event handler from the chain it's part of (if any); then
links the "previous" event handler to the "next" one (so that the
chain won't be interrupted).
"""
def IsUnlinked(self):
"""
IsUnlinked() -> bool
Returns true if the next and the previous handler pointers of this
event handler instance are NULL.
"""
@staticmethod
def AddFilter(filter):
"""
AddFilter(filter)
Add an event filter whose FilterEvent() method will be called for each
and every event processed by wxWidgets.
"""
@staticmethod
def RemoveFilter(filter):
"""
RemoveFilter(filter)
Remove a filter previously installed with AddFilter().
"""
def Bind(self, event, handler, source=None, id=wx.ID_ANY, id2=wx.ID_ANY):
"""
Bind an event to an event handler.
:param event: One of the ``EVT_*`` event binder objects that
specifies the type of event to bind.
:param handler: A callable object to be invoked when the
event is delivered to self. Pass ``None`` to
disconnect an event handler.
:param source: Sometimes the event originates from a
different window than self, but you still
want to catch it in self. (For example, a
button event delivered to a frame.) By
passing the source of the event, the event
handling system is able to differentiate
between the same event type from different
controls.
:param id: Used to spcify the event source by ID instead
of instance.
:param id2: Used when it is desirable to bind a handler
to a range of IDs, such as with EVT_MENU_RANGE.
"""
def Unbind(self, event, source=None, id=wx.ID_ANY, id2=wx.ID_ANY, handler=None):
"""
Disconnects the event handler binding for event from `self`.
Returns ``True`` if successful.
"""
EvtHandlerEnabled = property(None, None)
NextHandler = property(None, None)
PreviousHandler = property(None, None)
# end of class EvtHandler
class EventBlocker(EvtHandler):
"""
EventBlocker(win, type=-1)
This class is a special event handler which allows to discard any
event (or a set of event types) directed to a specific window.
"""
def __init__(self, win, type=-1):
"""
EventBlocker(win, type=-1)
This class is a special event handler which allows to discard any
event (or a set of event types) directed to a specific window.
"""
def Block(self, eventType):
"""
Block(eventType)
Adds to the list of event types which should be blocked the given
eventType.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class EventBlocker
class PropagationDisabler(object):
"""
PropagationDisabler(event)
Helper class to temporarily change an event to not propagate.
"""
def __init__(self, event):
"""
PropagationDisabler(event)
Helper class to temporarily change an event to not propagate.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class PropagationDisabler
class PropagateOnce(object):
"""
PropagateOnce(event)
Helper class to temporarily lower propagation level.
"""
def __init__(self, event):
"""
PropagateOnce(event)
Helper class to temporarily lower propagation level.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class PropagateOnce
class Event(Object):
"""
Event(id=0, eventType=wxEVT_NULL)
An event is a structure holding information about an event passed to a
callback or member function.
"""
def __init__(self, id=0, eventType=wxEVT_NULL):
"""
Event(id=0, eventType=wxEVT_NULL)
An event is a structure holding information about an event passed to a
callback or member function.
"""
def Clone(self):
"""
Clone() -> Event
Returns a copy of the event.
"""
def GetEventObject(self):
"""
GetEventObject() -> Object
Returns the object (usually a window) associated with the event, if
any.
"""
def GetEventType(self):
"""
GetEventType() -> EventType
Returns the identifier of the given event type, such as wxEVT_BUTTON.
"""
def GetEventCategory(self):
"""
GetEventCategory() -> EventCategory
Returns a generic category for this event.
"""
def GetId(self):
"""
GetId() -> int
Returns the identifier associated with this event, such as a button
command id.
"""
def GetEventUserData(self):
"""
GetEventUserData() -> Object
Return the user data associated with a dynamically connected event
handler.
"""
def GetSkipped(self):
"""
GetSkipped() -> bool
Returns true if the event handler should be skipped, false otherwise.
"""
def GetTimestamp(self):
"""
GetTimestamp() -> long
Gets the timestamp for the event.
"""
def IsCommandEvent(self):
"""
IsCommandEvent() -> bool
Returns true if the event is or is derived from wxCommandEvent else it
returns false.
"""
def ResumePropagation(self, propagationLevel):
"""
ResumePropagation(propagationLevel)
Sets the propagation level to the given value (for example returned
from an earlier call to wxEvent::StopPropagation).
"""
def SetEventObject(self, object):
"""
SetEventObject(object)
Sets the originating object.
"""
def SetEventType(self, type):
"""
SetEventType(type)
Sets the event type.
"""
def SetId(self, id):
"""
SetId(id)
Sets the identifier associated with this event, such as a button
command id.
"""
def SetTimestamp(self, timeStamp=0):
"""
SetTimestamp(timeStamp=0)
Sets the timestamp for the event.
"""
def ShouldPropagate(self):
"""
ShouldPropagate() -> bool
Test if this event should be propagated or not, i.e. if the
propagation level is currently greater than 0.
"""
def Skip(self, skip=True):
"""
Skip(skip=True)
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.
"""
def StopPropagation(self):
"""
StopPropagation() -> int
Stop the event from propagating to its parent window.
"""
EventObject = property(None, None)
EventType = property(None, None)
Id = property(None, None)
Skipped = property(None, None)
Timestamp = property(None, None)
# end of class Event
class CommandEvent(Event):
"""
CommandEvent(commandEventType=wxEVT_NULL, id=0)
This event class contains information about command events, which
originate from a variety of simple controls.
"""
def __init__(self, commandEventType=wxEVT_NULL, id=0):
"""
CommandEvent(commandEventType=wxEVT_NULL, id=0)
This event class contains information about command events, which
originate from a variety of simple controls.
"""
def GetClientObject(self):
"""
GetClientObject() -> ClientData
Returns client object pointer for a listbox or choice selection event
(not valid for a deselection).
"""
def GetExtraLong(self):
"""
GetExtraLong() -> long
Returns extra information dependent on the event objects type.
"""
def GetInt(self):
"""
GetInt() -> int
Returns the integer identifier corresponding to a listbox, choice or
radiobox selection (only if the event was a selection, not a
deselection), or a boolean value representing the value of a checkbox.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns item index for a listbox or choice selection event (not valid
for a deselection).
"""
def GetString(self):
"""
GetString() -> String
Returns item string for a listbox or choice selection event.
"""
def IsChecked(self):
"""
IsChecked() -> bool
This method can be used with checkbox and menu events: for the
checkboxes, the method returns true for a selection event and false
for a deselection one.
"""
def IsSelection(self):
"""
IsSelection() -> bool
For a listbox or similar event, returns true if it is a selection,
false if it is a deselection.
"""
def SetClientObject(self, clientObject):
"""
SetClientObject(clientObject)
Sets the client object for this event.
"""
def SetExtraLong(self, extraLong):
"""
SetExtraLong(extraLong)
Sets the m_extraLong member.
"""
def SetInt(self, intCommand):
"""
SetInt(intCommand)
Sets the m_commandInt member.
"""
def SetString(self, string):
"""
SetString(string)
Sets the m_commandString member.
"""
GetClientData = GetClientObject
SetClientData = SetClientObject
ClientObject = property(None, None)
ClientData = ClientObject
ExtraLong = property(None, None)
Int = property(None, None)
Selection = property(None, None)
String = property(None, None)
# end of class CommandEvent
class ActivateEvent(Event):
"""
ActivateEvent(eventType=wxEVT_NULL, active=True, id=0, ActivationReason=Reason_Unknown)
An activate event is sent when a window or application is being
activated or deactivated.
"""
Reason_Mouse = 0
Reason_Unknown = 0
def __init__(self, eventType=wxEVT_NULL, active=True, id=0, ActivationReason=Reason_Unknown):
"""
ActivateEvent(eventType=wxEVT_NULL, active=True, id=0, ActivationReason=Reason_Unknown)
An activate event is sent when a window or application is being
activated or deactivated.
"""
def GetActive(self):
"""
GetActive() -> bool
Returns true if the application or window is being activated, false
otherwise.
"""
def GetActivationReason(self):
"""
GetActivationReason() -> Reason
Allows to check if the window was activated by clicking it with the
mouse or in some other way.
"""
Active = property(None, None)
# end of class ActivateEvent
class ChildFocusEvent(CommandEvent):
"""
ChildFocusEvent(win=None)
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.
"""
def __init__(self, win=None):
"""
ChildFocusEvent(win=None)
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.
"""
def GetWindow(self):
"""
GetWindow() -> Window
Returns the direct child which receives the focus, or a (grand-)parent
of the control receiving the focus.
"""
Window = property(None, None)
# end of class ChildFocusEvent
class ClipboardTextEvent(CommandEvent):
"""
ClipboardTextEvent(commandType=wxEVT_NULL, id=0)
This class represents the events generated by a control (typically a
wxTextCtrl but other windows can generate these events as well) when
its content gets copied or cut to, or pasted from the clipboard.
"""
def __init__(self, commandType=wxEVT_NULL, id=0):
"""
ClipboardTextEvent(commandType=wxEVT_NULL, id=0)
This class represents the events generated by a control (typically a
wxTextCtrl but other windows can generate these events as well) when
its content gets copied or cut to, or pasted from the clipboard.
"""
# end of class ClipboardTextEvent
class CloseEvent(Event):
"""
CloseEvent(commandEventType=wxEVT_NULL, id=0)
This event class contains information about window and session close
events.
"""
def __init__(self, commandEventType=wxEVT_NULL, id=0):
"""
CloseEvent(commandEventType=wxEVT_NULL, id=0)
This event class contains information about window and session close
events.
"""
def CanVeto(self):
"""
CanVeto() -> bool
Returns true if you can veto a system shutdown or a window close
event.
"""
def GetLoggingOff(self):
"""
GetLoggingOff() -> bool
Returns true if the user is just logging off or false if the system is
shutting down.
"""
def SetCanVeto(self, canVeto):
"""
SetCanVeto(canVeto)
Sets the 'can veto' flag.
"""
def SetLoggingOff(self, loggingOff):
"""
SetLoggingOff(loggingOff)
Sets the 'logging off' flag.
"""
def Veto(self, veto=True):
"""
Veto(veto=True)
Call this from your event handler to veto a system shutdown or to
signal to the calling application that a window close did not happen.
"""
def GetVeto(self):
"""
GetVeto() -> bool
Returns whether the Veto flag was set.
"""
LoggingOff = property(None, None)
# end of class CloseEvent
class ContextMenuEvent(CommandEvent):
"""
ContextMenuEvent(type=wxEVT_NULL, id=0, pos=DefaultPosition)
This class is used for context menu events, sent to give the
application a chance to show a context (popup) menu for a wxWindow.
"""
def __init__(self, type=wxEVT_NULL, id=0, pos=DefaultPosition):
"""
ContextMenuEvent(type=wxEVT_NULL, id=0, pos=DefaultPosition)
This class is used for context menu events, sent to give the
application a chance to show a context (popup) menu for a wxWindow.
"""
def GetPosition(self):
"""
GetPosition() -> Point
Returns the position in screen coordinates at which the menu should be
shown.
"""
def SetPosition(self, point):
"""
SetPosition(point)
Sets the position at which the menu should be shown.
"""
Position = property(None, None)
# end of class ContextMenuEvent
class DisplayChangedEvent(Event):
"""
DisplayChangedEvent()
"""
def __init__(self):
"""
DisplayChangedEvent()
"""
# end of class DisplayChangedEvent
class DropFilesEvent(Event):
"""
DropFilesEvent(id=0, files=None)
This class is used for drop files events, that is, when files have
been dropped onto the window.
"""
def __init__(self, id=0, files=None):
"""
DropFilesEvent(id=0, files=None)
This class is used for drop files events, that is, when files have
been dropped onto the window.
"""
def GetFiles(self):
"""
GetFiles() -> PyObject
Returns an array of filenames.
"""
def GetNumberOfFiles(self):
"""
GetNumberOfFiles() -> int
Returns the number of files dropped.
"""
def GetPosition(self):
"""
GetPosition() -> Point
Returns the position at which the files were dropped.
"""
Files = property(None, None)
NumberOfFiles = property(None, None)
Position = property(None, None)
# end of class DropFilesEvent
class EraseEvent(Event):
"""
EraseEvent(id=0, dc=None)
An erase event is sent when a window's background needs to be
repainted.
"""
def __init__(self, id=0, dc=None):
"""
EraseEvent(id=0, dc=None)
An erase event is sent when a window's background needs to be
repainted.
"""
def GetDC(self):
"""
GetDC() -> DC
Returns the device context associated with the erase event to draw on.
"""
DC = property(None, None)
# end of class EraseEvent
class FocusEvent(Event):
"""
FocusEvent(eventType=wxEVT_NULL, id=0)
A focus event is sent when a window's focus changes.
"""
def __init__(self, eventType=wxEVT_NULL, id=0):
"""
FocusEvent(eventType=wxEVT_NULL, id=0)
A focus event is sent when a window's focus changes.
"""
def GetWindow(self):
"""
GetWindow() -> Window
Returns the window associated with this event, that is the window
which had the focus before for the wxEVT_SET_FOCUS event and the
window which is going to receive focus for the wxEVT_KILL_FOCUS one.
"""
def SetWindow(self, win):
"""
SetWindow(win)
"""
Window = property(None, None)
# end of class FocusEvent
class HelpEvent(CommandEvent):
"""
HelpEvent(type=wxEVT_NULL, winid=0, pt=DefaultPosition, origin=Origin_Unknown)
A help event is sent when the user has requested context-sensitive
help.
"""
Origin_Unknown = 0
Origin_Keyboard = 0
Origin_HelpButton = 0
def __init__(self, type=wxEVT_NULL, winid=0, pt=DefaultPosition, origin=Origin_Unknown):
"""
HelpEvent(type=wxEVT_NULL, winid=0, pt=DefaultPosition, origin=Origin_Unknown)
A help event is sent when the user has requested context-sensitive
help.
"""
def GetOrigin(self):
"""
GetOrigin() -> HelpEvent.Origin
Returns the origin of the help event which is one of the
wxHelpEvent::Origin values.
"""
def GetPosition(self):
"""
GetPosition() -> Point
Returns the left-click position of the mouse, in screen coordinates.
"""
def SetOrigin(self, origin):
"""
SetOrigin(origin)
Set the help event origin, only used internally by wxWidgets normally.
"""
def SetPosition(self, pt):
"""
SetPosition(pt)
Sets the left-click position of the mouse, in screen coordinates.
"""
Position = property(None, None)
# end of class HelpEvent
class IconizeEvent(Event):
"""
IconizeEvent(id=0, iconized=True)
An event being sent when the frame is iconized (minimized) or
restored.
"""
def __init__(self, id=0, iconized=True):
"""
IconizeEvent(id=0, iconized=True)
An event being sent when the frame is iconized (minimized) or
restored.
"""
def IsIconized(self):
"""
IsIconized() -> bool
Returns true if the frame has been iconized, false if it has been
restored.
"""
def Iconized(self):
"""
Iconized() -> bool
"""
# end of class IconizeEvent
class IdleEvent(Event):
"""
IdleEvent()
This class is used for idle events, which are generated when the
system becomes idle.
"""
def __init__(self):
"""
IdleEvent()
This class is used for idle events, which are generated when the
system becomes idle.
"""
def MoreRequested(self):
"""
MoreRequested() -> bool
Returns true if the OnIdle function processing this event requested
more processing time.
"""
def RequestMore(self, needMore=True):
"""
RequestMore(needMore=True)
Tells wxWidgets that more processing is required.
"""
@staticmethod
def GetMode():
"""
GetMode() -> IdleMode
Static function returning a value specifying how wxWidgets will send
idle events: to all windows, or only to those which specify that they
will process the events.
"""
@staticmethod
def SetMode(mode):
"""
SetMode(mode)
Static function for specifying how wxWidgets will send idle events: to
all windows, or only to those which specify that they will process the
events.
"""
# end of class IdleEvent
class InitDialogEvent(Event):
"""
InitDialogEvent(id=0)
A wxInitDialogEvent is sent as a dialog or panel is being initialised.
"""
def __init__(self, id=0):
"""
InitDialogEvent(id=0)
A wxInitDialogEvent is sent as a dialog or panel is being initialised.
"""
# end of class InitDialogEvent
class JoystickEvent(Event):
"""
JoystickEvent(eventType=wxEVT_NULL, state=0, joystick=JOYSTICK1, change=0)
This event class contains information about joystick events,
particularly events received by windows.
"""
def __init__(self, eventType=wxEVT_NULL, state=0, joystick=JOYSTICK1, change=0):
"""
JoystickEvent(eventType=wxEVT_NULL, state=0, joystick=JOYSTICK1, change=0)
This event class contains information about joystick events,
particularly events received by windows.
"""
def ButtonDown(self, button=JOY_BUTTON_ANY):
"""
ButtonDown(button=JOY_BUTTON_ANY) -> bool
Returns true if the event was a down event from the specified button
(or any button).
"""
def ButtonIsDown(self, button=JOY_BUTTON_ANY):
"""
ButtonIsDown(button=JOY_BUTTON_ANY) -> bool
Returns true if the specified button (or any button) was in a down
state.
"""
def ButtonUp(self, button=JOY_BUTTON_ANY):
"""
ButtonUp(button=JOY_BUTTON_ANY) -> bool
Returns true if the event was an up event from the specified button
(or any button).
"""
def GetButtonChange(self):
"""
GetButtonChange() -> int
Returns the identifier of the button changing state.
"""
def GetButtonState(self):
"""
GetButtonState() -> int
Returns the down state of the buttons.
"""
def GetJoystick(self):
"""
GetJoystick() -> int
Returns the identifier of the joystick generating the event - one of
wxJOYSTICK1 and wxJOYSTICK2.
"""
def GetPosition(self):
"""
GetPosition() -> Point
Returns the x, y position of the joystick event.
"""
def GetZPosition(self):
"""
GetZPosition() -> int
Returns the z position of the joystick event.
"""
def IsButton(self):
"""
IsButton() -> bool
Returns true if this was a button up or down event (not 'is any button
down?').
"""
def IsMove(self):
"""
IsMove() -> bool
Returns true if this was an x, y move event.
"""
def IsZMove(self):
"""
IsZMove() -> bool
Returns true if this was a z move event.
"""
ButtonChange = property(None, None)
ButtonState = property(None, None)
Joystick = property(None, None)
Position = property(None, None)
ZPosition = property(None, None)
# end of class JoystickEvent
class KeyEvent(Event, KeyboardState):
"""
KeyEvent(keyEventType=wxEVT_NULL)
This event class contains information about key press and release
events.
"""
def __init__(self, keyEventType=wxEVT_NULL):
"""
KeyEvent(keyEventType=wxEVT_NULL)
This event class contains information about key press and release
events.
"""
def GetPosition(self, *args, **kw):
"""
GetPosition() -> Point
Obtains the position (in client coordinates) at which the key was
pressed.
"""
def GetKeyCode(self):
"""
GetKeyCode() -> int
Returns the key code of the key that generated this event.
"""
def IsKeyInCategory(self, category):
"""
IsKeyInCategory(category) -> bool
Returns true if the key is in the given key category.
"""
def GetRawKeyCode(self):
"""
GetRawKeyCode() -> Uint32
Returns the raw key code for this event.
"""
def GetRawKeyFlags(self):
"""
GetRawKeyFlags() -> Uint32
Returns the low level key flags for this event.
"""
def GetUnicodeKey(self):
"""
GetUnicodeKey() -> Char
Returns the Unicode character corresponding to this key event.
"""
def GetX(self):
"""
GetX() -> Coord
Returns the X position (in client coordinates) of the event.
"""
def GetY(self):
"""
GetY() -> Coord
Returns the Y position (in client coordinates) of the event.
"""
def DoAllowNextEvent(self):
"""
DoAllowNextEvent()
Allow normal key events generation.
"""
def IsNextEventAllowed(self):
"""
IsNextEventAllowed() -> bool
Returns true if DoAllowNextEvent() had been called, false by default.
"""
X = property(None, None)
Y = property(None, None)
KeyCode = property(None, None)
Position = property(None, None)
RawKeyCode = property(None, None)
RawKeyFlags = property(None, None)
UnicodeKey = property(None, None)
# end of class KeyEvent
class MaximizeEvent(Event):
"""
MaximizeEvent(id=0)
An event being sent when a top level window is maximized.
"""
def __init__(self, id=0):
"""
MaximizeEvent(id=0)
An event being sent when a top level window is maximized.
"""
# end of class MaximizeEvent
class MenuEvent(Event):
"""
MenuEvent(type=wxEVT_NULL, id=0, menu=None)
This class is used for a variety of menu-related events.
"""
def __init__(self, type=wxEVT_NULL, id=0, menu=None):
"""
MenuEvent(type=wxEVT_NULL, id=0, menu=None)
This class is used for a variety of menu-related events.
"""
def GetMenu(self):
"""
GetMenu() -> Menu
Returns the menu which is being opened or closed.
"""
def GetMenuId(self):
"""
GetMenuId() -> int
Returns the menu identifier associated with the event.
"""
def IsPopup(self):
"""
IsPopup() -> bool
Returns true if the menu which is being opened or closed is a popup
menu, false if it is a normal one.
"""
Menu = property(None, None)
MenuId = property(None, None)
# end of class MenuEvent
class MouseCaptureChangedEvent(Event):
"""
MouseCaptureChangedEvent(windowId=0, gainedCapture=None)
An mouse capture changed event is sent to a window that loses its
mouse capture.
"""
def __init__(self, windowId=0, gainedCapture=None):
"""
MouseCaptureChangedEvent(windowId=0, gainedCapture=None)
An mouse capture changed event is sent to a window that loses its
mouse capture.
"""
def GetCapturedWindow(self):
"""
GetCapturedWindow() -> Window
Returns the window that gained the capture, or NULL if it was a non-
wxWidgets window.
"""
CapturedWindow = property(None, None)
# end of class MouseCaptureChangedEvent
class MouseCaptureLostEvent(Event):
"""
MouseCaptureLostEvent(windowId=0)
A mouse capture lost event is sent to a window that had obtained mouse
capture, which was subsequently lost due to an "external" event (for
example, when a dialog box is shown or if another application captures
the mouse).
"""
def __init__(self, windowId=0):
"""
MouseCaptureLostEvent(windowId=0)
A mouse capture lost event is sent to a window that had obtained mouse
capture, which was subsequently lost due to an "external" event (for
example, when a dialog box is shown or if another application captures
the mouse).
"""
# end of class MouseCaptureLostEvent
class MouseEvent(Event, MouseState):
"""
MouseEvent(mouseEventType=wxEVT_NULL)
This event class contains information about the events generated by
the mouse: they include mouse buttons press and release events and
mouse move events.
"""
def __init__(self, mouseEventType=wxEVT_NULL):
"""
MouseEvent(mouseEventType=wxEVT_NULL)
This event class contains information about the events generated by
the mouse: they include mouse buttons press and release events and
mouse move events.
"""
def Aux1DClick(self):
"""
Aux1DClick() -> bool
Returns true if the event was a first extra button double click.
"""
def Aux1Down(self):
"""
Aux1Down() -> bool
Returns true if the first extra button mouse button changed to down.
"""
def Aux1Up(self):
"""
Aux1Up() -> bool
Returns true if the first extra button mouse button changed to up.
"""
def Aux2DClick(self):
"""
Aux2DClick() -> bool
Returns true if the event was a second extra button double click.
"""
def Aux2Down(self):
"""
Aux2Down() -> bool
Returns true if the second extra button mouse button changed to down.
"""
def Aux2Up(self):
"""
Aux2Up() -> bool
Returns true if the second extra button mouse button changed to up.
"""
def Button(self, but):
"""
Button(but) -> bool
Returns true if the event was generated by the specified button.
"""
def ButtonDClick(self, but=MOUSE_BTN_ANY):
"""
ButtonDClick(but=MOUSE_BTN_ANY) -> bool
If the argument is omitted, this returns true if the event was a mouse
double click event.
"""
def ButtonDown(self, but=MOUSE_BTN_ANY):
"""
ButtonDown(but=MOUSE_BTN_ANY) -> bool
If the argument is omitted, this returns true if the event was a mouse
button down event.
"""
def ButtonUp(self, but=MOUSE_BTN_ANY):
"""
ButtonUp(but=MOUSE_BTN_ANY) -> bool
If the argument is omitted, this returns true if the event was a mouse
button up event.
"""
def Dragging(self):
"""
Dragging() -> bool
Returns true if this was a dragging event (motion while a button is
depressed).
"""
def Entering(self):
"""
Entering() -> bool
Returns true if the mouse was entering the window.
"""
def GetButton(self):
"""
GetButton() -> int
Returns the mouse button which generated this event or
wxMOUSE_BTN_NONE if no button is involved (for mouse move, enter or
leave event, for example).
"""
def GetClickCount(self):
"""
GetClickCount() -> int
Returns the number of mouse clicks for this event: 1 for a simple
click, 2 for a double-click, 3 for a triple-click and so on.
"""
def GetLinesPerAction(self):
"""
GetLinesPerAction() -> int
Returns the configured number of lines (or whatever) to be scrolled
per wheel action.
"""
def GetColumnsPerAction(self):
"""
GetColumnsPerAction() -> int
Returns the configured number of columns (or whatever) to be scrolled
per wheel action.
"""
def GetLogicalPosition(self, dc):
"""
GetLogicalPosition(dc) -> Point
Returns the logical mouse position in pixels (i.e. translated
according to the translation set for the DC, which usually indicates
that the window has been scrolled).
"""
def GetWheelDelta(self):
"""
GetWheelDelta() -> int
Get wheel delta, normally 120.
"""
def GetWheelRotation(self):
"""
GetWheelRotation() -> int
Get wheel rotation, positive or negative indicates direction of
rotation.
"""
def GetWheelAxis(self):
"""
GetWheelAxis() -> MouseWheelAxis
Gets the axis the wheel operation concerns.
"""
def IsButton(self):
"""
IsButton() -> bool
Returns true if the event was a mouse button event (not necessarily a
button down event - that may be tested using ButtonDown()).
"""
def IsPageScroll(self):
"""
IsPageScroll() -> bool
Returns true if the system has been setup to do page scrolling with
the mouse wheel instead of line scrolling.
"""
def Leaving(self):
"""
Leaving() -> bool
Returns true if the mouse was leaving the window.
"""
def LeftDClick(self):
"""
LeftDClick() -> bool
Returns true if the event was a left double click.
"""
def LeftDown(self):
"""
LeftDown() -> bool
Returns true if the left mouse button changed to down.
"""
def LeftUp(self):
"""
LeftUp() -> bool
Returns true if the left mouse button changed to up.
"""
def MetaDown(self):
"""
MetaDown() -> bool
Returns true if the Meta key was down at the time of the event.
"""
def MiddleDClick(self):
"""
MiddleDClick() -> bool
Returns true if the event was a middle double click.
"""
def MiddleDown(self):
"""
MiddleDown() -> bool
Returns true if the middle mouse button changed to down.
"""
def MiddleUp(self):
"""
MiddleUp() -> bool
Returns true if the middle mouse button changed to up.
"""
def Moving(self):
"""
Moving() -> bool
Returns true if this was a motion event and no mouse buttons were
pressed.
"""
def RightDClick(self):
"""
RightDClick() -> bool
Returns true if the event was a right double click.
"""
def RightDown(self):
"""
RightDown() -> bool
Returns true if the right mouse button changed to down.
"""
def RightUp(self):
"""
RightUp() -> bool
Returns true if the right mouse button changed to up.
"""
LinesPerAction = property(None, None)
LogicalPosition = property(None, None)
WheelDelta = property(None, None)
WheelRotation = property(None, None)
# end of class MouseEvent
class MoveEvent(Event):
"""
MoveEvent(pt, id=0)
A move event holds information about wxTopLevelWindow move change
events.
"""
def __init__(self, pt, id=0):
"""
MoveEvent(pt, id=0)
A move event holds information about wxTopLevelWindow move change
events.
"""
def GetPosition(self):
"""
GetPosition() -> Point
Returns the position of the window generating the move change event.
"""
def GetRect(self):
"""
GetRect() -> Rect
"""
def SetRect(self, rect):
"""
SetRect(rect)
"""
def SetPosition(self, pos):
"""
SetPosition(pos)
"""
Rect = property(None, None)
Position = property(None, None)
# end of class MoveEvent
class NavigationKeyEvent(Event):
"""
NavigationKeyEvent()
NavigationKeyEvent(event)
This event class contains information about navigation events,
generated by navigation keys such as tab and page down.
"""
IsBackward = 0
IsForward = 0
WinChange = 0
FromTab = 0
def __init__(self, *args, **kw):
"""
NavigationKeyEvent()
NavigationKeyEvent(event)
This event class contains information about navigation events,
generated by navigation keys such as tab and page down.
"""
def GetCurrentFocus(self):
"""
GetCurrentFocus() -> Window
Returns the child that has the focus, or NULL.
"""
def GetDirection(self):
"""
GetDirection() -> bool
Returns true if the navigation was in the forward direction.
"""
def IsFromTab(self):
"""
IsFromTab() -> bool
Returns true if the navigation event was from a tab key.
"""
def IsWindowChange(self):
"""
IsWindowChange() -> bool
Returns true if the navigation event represents a window change (for
example, from Ctrl-Page Down in a notebook).
"""
def SetCurrentFocus(self, currentFocus):
"""
SetCurrentFocus(currentFocus)
Sets the current focus window member.
"""
def SetDirection(self, direction):
"""
SetDirection(direction)
Sets the direction to forward if direction is true, or backward if
false.
"""
def SetFlags(self, flags):
"""
SetFlags(flags)
Sets the flags for this event.
"""
def SetFromTab(self, fromTab):
"""
SetFromTab(fromTab)
Marks the navigation event as from a tab key.
"""
def SetWindowChange(self, windowChange):
"""
SetWindowChange(windowChange)
Marks the event as a window change event.
"""
CurrentFocus = property(None, None)
Direction = property(None, None)
# end of class NavigationKeyEvent
class NotifyEvent(CommandEvent):
"""
NotifyEvent(eventType=wxEVT_NULL, id=0)
This class is not used by the event handlers by itself, but is a base
class for other event classes (such as wxBookCtrlEvent).
"""
def __init__(self, eventType=wxEVT_NULL, id=0):
"""
NotifyEvent(eventType=wxEVT_NULL, id=0)
This class is not used by the event handlers by itself, but is a base
class for other event classes (such as wxBookCtrlEvent).
"""
def Allow(self):
"""
Allow()
This is the opposite of Veto(): it explicitly allows the event to be
processed.
"""
def IsAllowed(self):
"""
IsAllowed() -> bool
Returns true if the change is allowed (Veto() hasn't been called) or
false otherwise (if it was).
"""
def Veto(self):
"""
Veto()
Prevents the change announced by this event from happening.
"""
# end of class NotifyEvent
class PaintEvent(Event):
"""
PaintEvent(id=0)
A paint event is sent when a window's contents needs to be repainted.
"""
def __init__(self, id=0):
"""
PaintEvent(id=0)
A paint event is sent when a window's contents needs to be repainted.
"""
# end of class PaintEvent
class PaletteChangedEvent(Event):
"""
PaletteChangedEvent(winid=0)
"""
def __init__(self, winid=0):
"""
PaletteChangedEvent(winid=0)
"""
def SetChangedWindow(self, win):
"""
SetChangedWindow(win)
"""
def GetChangedWindow(self):
"""
GetChangedWindow() -> Window
"""
ChangedWindow = property(None, None)
# end of class PaletteChangedEvent
class QueryNewPaletteEvent(Event):
"""
QueryNewPaletteEvent(winid=0)
"""
def __init__(self, winid=0):
"""
QueryNewPaletteEvent(winid=0)
"""
def SetPaletteRealized(self, realized):
"""
SetPaletteRealized(realized)
"""
def GetPaletteRealized(self):
"""
GetPaletteRealized() -> bool
"""
PaletteRealized = property(None, None)
# end of class QueryNewPaletteEvent
class ScrollEvent(CommandEvent):
"""
ScrollEvent(commandType=wxEVT_NULL, id=0, pos=0, orientation=0)
A scroll event holds information about events sent from stand-alone
scrollbars (see wxScrollBar) and sliders (see wxSlider).
"""
def __init__(self, commandType=wxEVT_NULL, id=0, pos=0, orientation=0):
"""
ScrollEvent(commandType=wxEVT_NULL, id=0, pos=0, orientation=0)
A scroll event holds information about events sent from stand-alone
scrollbars (see wxScrollBar) and sliders (see wxSlider).
"""
def GetOrientation(self):
"""
GetOrientation() -> int
Returns wxHORIZONTAL or wxVERTICAL, depending on the orientation of
the scrollbar.
"""
def GetPosition(self):
"""
GetPosition() -> int
Returns the position of the scrollbar.
"""
def SetOrientation(self, orient):
"""
SetOrientation(orient)
"""
def SetPosition(self, pos):
"""
SetPosition(pos)
"""
Orientation = property(None, None)
Position = property(None, None)
# end of class ScrollEvent
class ScrollWinEvent(Event):
"""
ScrollWinEvent(commandType=wxEVT_NULL, pos=0, orientation=0)
A scroll event holds information about events sent from scrolling
windows.
"""
def __init__(self, commandType=wxEVT_NULL, pos=0, orientation=0):
"""
ScrollWinEvent(commandType=wxEVT_NULL, pos=0, orientation=0)
A scroll event holds information about events sent from scrolling
windows.
"""
def GetOrientation(self):
"""
GetOrientation() -> int
Returns wxHORIZONTAL or wxVERTICAL, depending on the orientation of
the scrollbar.
"""
def GetPosition(self):
"""
GetPosition() -> int
Returns the position of the scrollbar for the thumb track and release
events.
"""
def SetOrientation(self, orient):
"""
SetOrientation(orient)
"""
def SetPosition(self, pos):
"""
SetPosition(pos)
"""
Orientation = property(None, None)
Position = property(None, None)
# end of class ScrollWinEvent
class SetCursorEvent(Event):
"""
SetCursorEvent(x=0, y=0)
A wxSetCursorEvent is generated from wxWindow when the mouse cursor is
about to be set as a result of mouse motion.
"""
def __init__(self, x=0, y=0):
"""
SetCursorEvent(x=0, y=0)
A wxSetCursorEvent is generated from wxWindow when the mouse cursor is
about to be set as a result of mouse motion.
"""
def GetCursor(self):
"""
GetCursor() -> Cursor
Returns a reference to the cursor specified by this event.
"""
def GetX(self):
"""
GetX() -> Coord
Returns the X coordinate of the mouse in client coordinates.
"""
def GetY(self):
"""
GetY() -> Coord
Returns the Y coordinate of the mouse in client coordinates.
"""
def HasCursor(self):
"""
HasCursor() -> bool
Returns true if the cursor specified by this event is a valid cursor.
"""
def SetCursor(self, cursor):
"""
SetCursor(cursor)
Sets the cursor associated with this event.
"""
Cursor = property(None, None)
X = property(None, None)
Y = property(None, None)
# end of class SetCursorEvent
class ShowEvent(Event):
"""
ShowEvent(winid=0, show=False)
An event being sent when the window is shown or hidden.
"""
def __init__(self, winid=0, show=False):
"""
ShowEvent(winid=0, show=False)
An event being sent when the window is shown or hidden.
"""
def SetShow(self, show):
"""
SetShow(show)
Set whether the windows was shown or hidden.
"""
def IsShown(self):
"""
IsShown() -> bool
Return true if the window has been shown, false if it has been hidden.
"""
Show = property(None, None)
# end of class ShowEvent
class SizeEvent(Event):
"""
SizeEvent(sz, id=0)
A size event holds information about size change events of wxWindow.
"""
def __init__(self, sz, id=0):
"""
SizeEvent(sz, id=0)
A size event holds information about size change events of wxWindow.
"""
def GetSize(self):
"""
GetSize() -> Size
Returns the entire size of the window generating the size change
event.
"""
def SetSize(self, size):
"""
SetSize(size)
"""
def GetRect(self):
"""
GetRect() -> Rect
"""
def SetRect(self, rect):
"""
SetRect(rect)
"""
Rect = property(None, None)
Size = property(None, None)
# end of class SizeEvent
class SysColourChangedEvent(Event):
"""
SysColourChangedEvent()
This class is used for system colour change events, which are
generated when the user changes the colour settings using the control
panel.
"""
def __init__(self):
"""
SysColourChangedEvent()
This class is used for system colour change events, which are
generated when the user changes the colour settings using the control
panel.
"""
# end of class SysColourChangedEvent
class UpdateUIEvent(CommandEvent):
"""
UpdateUIEvent(commandId=0)
This class is used for pseudo-events which are called by wxWidgets to
give an application the chance to update various user interface
elements.
"""
def __init__(self, commandId=0):
"""
UpdateUIEvent(commandId=0)
This class is used for pseudo-events which are called by wxWidgets to
give an application the chance to update various user interface
elements.
"""
def Check(self, check):
"""
Check(check)
Check or uncheck the UI element.
"""
def Enable(self, enable):
"""
Enable(enable)
Enable or disable the UI element.
"""
def GetChecked(self):
"""
GetChecked() -> bool
Returns true if the UI element should be checked.
"""
def GetEnabled(self):
"""
GetEnabled() -> bool
Returns true if the UI element should be enabled.
"""
def GetSetChecked(self):
"""
GetSetChecked() -> bool
Returns true if the application has called Check().
"""
def GetSetEnabled(self):
"""
GetSetEnabled() -> bool
Returns true if the application has called Enable().
"""
def GetSetShown(self):
"""
GetSetShown() -> bool
Returns true if the application has called Show().
"""
def GetSetText(self):
"""
GetSetText() -> bool
Returns true if the application has called SetText().
"""
def GetShown(self):
"""
GetShown() -> bool
Returns true if the UI element should be shown.
"""
def GetText(self):
"""
GetText() -> String
Returns the text that should be set for the UI element.
"""
def SetText(self, text):
"""
SetText(text)
Sets the text for this UI element.
"""
def Show(self, show):
"""
Show(show)
Show or hide the UI element.
"""
@staticmethod
def CanUpdate(window):
"""
CanUpdate(window) -> bool
Returns true if it is appropriate to update (send UI update events to)
this window.
"""
@staticmethod
def GetMode():
"""
GetMode() -> UpdateUIMode
Static function returning a value specifying how wxWidgets will send
update events: to all windows, or only to those which specify that
they will process the events.
"""
@staticmethod
def GetUpdateInterval():
"""
GetUpdateInterval() -> long
Returns the current interval between updates in milliseconds.
"""
@staticmethod
def ResetUpdateTime():
"""
ResetUpdateTime()
Used internally to reset the last-updated time to the current time.
"""
@staticmethod
def SetMode(mode):
"""
SetMode(mode)
Specify how wxWidgets will send update events: to all windows, or only
to those which specify that they will process the events.
"""
@staticmethod
def SetUpdateInterval(updateInterval):
"""
SetUpdateInterval(updateInterval)
Sets the interval between updates in milliseconds.
"""
Checked = property(None, None)
Enabled = property(None, None)
Shown = property(None, None)
Text = property(None, None)
# end of class UpdateUIEvent
class WindowCreateEvent(CommandEvent):
"""
WindowCreateEvent(win=None)
This event is sent just after the actual window associated with a
wxWindow object has been created.
"""
def __init__(self, win=None):
"""
WindowCreateEvent(win=None)
This event is sent just after the actual window associated with a
wxWindow object has been created.
"""
def GetWindow(self):
"""
GetWindow() -> Window
Return the window being created.
"""
Window = property(None, None)
# end of class WindowCreateEvent
class WindowDestroyEvent(CommandEvent):
"""
WindowDestroyEvent(win=None)
This event is sent as early as possible during the window destruction
process.
"""
def __init__(self, win=None):
"""
WindowDestroyEvent(win=None)
This event is sent as early as possible during the window destruction
process.
"""
def GetWindow(self):
"""
GetWindow() -> Window
Return the window being destroyed.
"""
Window = property(None, None)
# end of class WindowDestroyEvent
def NewEventType():
"""
NewEventType() -> EventType
Generates a new unique event type.
"""
def PostEvent(dest, event):
"""
PostEvent(dest, event)
In a GUI application, this function posts event to the specified dest
object using wxEvtHandler::AddPendingEvent().
"""
def QueueEvent(dest, event):
"""
QueueEvent(dest, event)
Queue an event for processing on the given object.
"""
class PyEventBinder(object):
"""
Instances of this class are used to bind specific events to event handlers.
"""
def __init__(self, evtType, expectedIDs=0):
pass
def Bind(self, target, id1, id2, function):
"""
Bind this set of event types to target using its Connect() method.
"""
pass
def Unbind(self, target, id1, id2, handler=None):
"""
Remove an event binding.
"""
pass
def _getEvtType(self):
"""
Make it easy to get to the default wxEventType typeID for this
event binder.
"""
pass
typeId = property(None, None)
@wx.deprecated
def __call__(self, *args):
"""
For backwards compatibility with the old ``EVT_*`` functions.
Should be called with either (window, func), (window, ID,
func) or (window, ID1, ID2, func) parameters depending on the
type of the event.
"""
pass
#-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
# This code block was included from src/event_ex.py
# Create some event binders
EVT_SIZE = wx.PyEventBinder( wxEVT_SIZE )
EVT_SIZING = wx.PyEventBinder( wxEVT_SIZING )
EVT_MOVE = wx.PyEventBinder( wxEVT_MOVE )
EVT_MOVING = wx.PyEventBinder( wxEVT_MOVING )
EVT_MOVE_START = wx.PyEventBinder( wxEVT_MOVE_START )
EVT_MOVE_END = wx.PyEventBinder( wxEVT_MOVE_END )
EVT_CLOSE = wx.PyEventBinder( wxEVT_CLOSE_WINDOW )
EVT_END_SESSION = wx.PyEventBinder( wxEVT_END_SESSION )
EVT_QUERY_END_SESSION = wx.PyEventBinder( wxEVT_QUERY_END_SESSION )
EVT_PAINT = wx.PyEventBinder( wxEVT_PAINT )
EVT_NC_PAINT = wx.PyEventBinder( wxEVT_NC_PAINT )
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_CHAR_HOOK = wx.PyEventBinder( wxEVT_CHAR_HOOK )
EVT_MENU_OPEN = wx.PyEventBinder( wxEVT_MENU_OPEN )
EVT_MENU_CLOSE = wx.PyEventBinder( wxEVT_MENU_CLOSE )
EVT_MENU_HIGHLIGHT = wx.PyEventBinder( wxEVT_MENU_HIGHLIGHT, 1)
EVT_MENU_HIGHLIGHT_ALL = wx.PyEventBinder( wxEVT_MENU_HIGHLIGHT )
EVT_SET_FOCUS = wx.PyEventBinder( wxEVT_SET_FOCUS )
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_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 )
EVT_INIT_DIALOG = wx.PyEventBinder( wxEVT_INIT_DIALOG )
EVT_SYS_COLOUR_CHANGED = wx.PyEventBinder( wxEVT_SYS_COLOUR_CHANGED )
EVT_DISPLAY_CHANGED = wx.PyEventBinder( wxEVT_DISPLAY_CHANGED )
EVT_SHOW = wx.PyEventBinder( wxEVT_SHOW )
EVT_MAXIMIZE = wx.PyEventBinder( wxEVT_MAXIMIZE )
EVT_ICONIZE = wx.PyEventBinder( wxEVT_ICONIZE )
EVT_NAVIGATION_KEY = wx.PyEventBinder( wxEVT_NAVIGATION_KEY )
EVT_PALETTE_CHANGED = wx.PyEventBinder( wxEVT_PALETTE_CHANGED )
EVT_QUERY_NEW_PALETTE = wx.PyEventBinder( wxEVT_QUERY_NEW_PALETTE )
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 )
EVT_MIDDLE_DOWN = wx.PyEventBinder( wxEVT_MIDDLE_DOWN )
EVT_MIDDLE_UP = wx.PyEventBinder( wxEVT_MIDDLE_UP )
EVT_RIGHT_DOWN = wx.PyEventBinder( wxEVT_RIGHT_DOWN )
EVT_RIGHT_UP = wx.PyEventBinder( wxEVT_RIGHT_UP )
EVT_MOTION = wx.PyEventBinder( wxEVT_MOTION )
EVT_LEFT_DCLICK = wx.PyEventBinder( wxEVT_LEFT_DCLICK )
EVT_MIDDLE_DCLICK = wx.PyEventBinder( wxEVT_MIDDLE_DCLICK )
EVT_RIGHT_DCLICK = wx.PyEventBinder( wxEVT_RIGHT_DCLICK )
EVT_LEAVE_WINDOW = wx.PyEventBinder( wxEVT_LEAVE_WINDOW )
EVT_ENTER_WINDOW = wx.PyEventBinder( wxEVT_ENTER_WINDOW )
EVT_MOUSEWHEEL = wx.PyEventBinder( wxEVT_MOUSEWHEEL )
EVT_MOUSE_AUX1_DOWN = wx.PyEventBinder( wxEVT_AUX1_DOWN )
EVT_MOUSE_AUX1_UP = wx.PyEventBinder( wxEVT_AUX1_UP )
EVT_MOUSE_AUX1_DCLICK = wx.PyEventBinder( wxEVT_AUX1_DCLICK )
EVT_MOUSE_AUX2_DOWN = wx.PyEventBinder( wxEVT_AUX2_DOWN )
EVT_MOUSE_AUX2_UP = wx.PyEventBinder( wxEVT_AUX2_UP )
EVT_MOUSE_AUX2_DCLICK = wx.PyEventBinder( wxEVT_AUX2_DCLICK )
EVT_MOUSE_EVENTS = wx.PyEventBinder([ wxEVT_LEFT_DOWN,
wxEVT_LEFT_UP,
wxEVT_MIDDLE_DOWN,
wxEVT_MIDDLE_UP,
wxEVT_RIGHT_DOWN,
wxEVT_RIGHT_UP,
wxEVT_MOTION,
wxEVT_LEFT_DCLICK,
wxEVT_MIDDLE_DCLICK,
wxEVT_RIGHT_DCLICK,
wxEVT_ENTER_WINDOW,
wxEVT_LEAVE_WINDOW,
wxEVT_MOUSEWHEEL,
wxEVT_AUX1_DOWN,
wxEVT_AUX1_UP,
wxEVT_AUX1_DCLICK,
wxEVT_AUX2_DOWN,
wxEVT_AUX2_UP,
wxEVT_AUX2_DCLICK,
])
# Scrolling from wxWindow (sent to wxScrolledWindow)
EVT_SCROLLWIN = wx.PyEventBinder([ wxEVT_SCROLLWIN_TOP,
wxEVT_SCROLLWIN_BOTTOM,
wxEVT_SCROLLWIN_LINEUP,
wxEVT_SCROLLWIN_LINEDOWN,
wxEVT_SCROLLWIN_PAGEUP,
wxEVT_SCROLLWIN_PAGEDOWN,
wxEVT_SCROLLWIN_THUMBTRACK,
wxEVT_SCROLLWIN_THUMBRELEASE,
])
EVT_SCROLLWIN_TOP = wx.PyEventBinder( wxEVT_SCROLLWIN_TOP )
EVT_SCROLLWIN_BOTTOM = wx.PyEventBinder( wxEVT_SCROLLWIN_BOTTOM )
EVT_SCROLLWIN_LINEUP = wx.PyEventBinder( wxEVT_SCROLLWIN_LINEUP )
EVT_SCROLLWIN_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLLWIN_LINEDOWN )
EVT_SCROLLWIN_PAGEUP = wx.PyEventBinder( wxEVT_SCROLLWIN_PAGEUP )
EVT_SCROLLWIN_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLLWIN_PAGEDOWN )
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,
wxEVT_SCROLL_CHANGED,
])
EVT_SCROLL_TOP = wx.PyEventBinder( wxEVT_SCROLL_TOP )
EVT_SCROLL_BOTTOM = wx.PyEventBinder( wxEVT_SCROLL_BOTTOM )
EVT_SCROLL_LINEUP = wx.PyEventBinder( wxEVT_SCROLL_LINEUP )
EVT_SCROLL_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLL_LINEDOWN )
EVT_SCROLL_PAGEUP = wx.PyEventBinder( wxEVT_SCROLL_PAGEUP )
EVT_SCROLL_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLL_PAGEDOWN )
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,
wxEVT_SCROLL_THUMBRELEASE,
wxEVT_SCROLL_CHANGED,
], 1)
EVT_COMMAND_SCROLL_TOP = wx.PyEventBinder( wxEVT_SCROLL_TOP, 1)
EVT_COMMAND_SCROLL_BOTTOM = wx.PyEventBinder( wxEVT_SCROLL_BOTTOM, 1)
EVT_COMMAND_SCROLL_LINEUP = wx.PyEventBinder( wxEVT_SCROLL_LINEUP, 1)
EVT_COMMAND_SCROLL_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLL_LINEDOWN, 1)
EVT_COMMAND_SCROLL_PAGEUP = wx.PyEventBinder( wxEVT_SCROLL_PAGEUP, 1)
EVT_COMMAND_SCROLL_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLL_PAGEDOWN, 1)
EVT_COMMAND_SCROLL_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLL_THUMBTRACK, 1)
EVT_COMMAND_SCROLL_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLL_THUMBRELEASE, 1)
EVT_COMMAND_SCROLL_CHANGED = wx.PyEventBinder( wxEVT_SCROLL_CHANGED, 1)
EVT_COMMAND_SCROLL_ENDSCROLL = EVT_COMMAND_SCROLL_CHANGED
EVT_BUTTON = wx.PyEventBinder( wxEVT_BUTTON, 1)
EVT_CHECKBOX = wx.PyEventBinder( wxEVT_CHECKBOX, 1)
EVT_CHOICE = wx.PyEventBinder( wxEVT_CHOICE, 1)
EVT_LISTBOX = wx.PyEventBinder( wxEVT_LISTBOX, 1)
EVT_LISTBOX_DCLICK = wx.PyEventBinder( wxEVT_LISTBOX_DCLICK, 1)
EVT_MENU = wx.PyEventBinder( wxEVT_MENU, 1)
EVT_MENU_RANGE = wx.PyEventBinder( wxEVT_MENU, 2)
EVT_SLIDER = wx.PyEventBinder( wxEVT_SLIDER, 1)
EVT_RADIOBOX = wx.PyEventBinder( wxEVT_RADIOBOX, 1)
EVT_RADIOBUTTON = wx.PyEventBinder( wxEVT_RADIOBUTTON, 1)
EVT_SCROLLBAR = wx.PyEventBinder( wxEVT_SCROLLBAR, 1)
EVT_VLBOX = wx.PyEventBinder( wxEVT_VLBOX, 1)
EVT_COMBOBOX = wx.PyEventBinder( wxEVT_COMBOBOX, 1)
EVT_TOOL = wx.PyEventBinder( wxEVT_TOOL, 1)
EVT_TOOL_RANGE = wx.PyEventBinder( wxEVT_TOOL, 2)
EVT_TOOL_RCLICKED = wx.PyEventBinder( wxEVT_TOOL_RCLICKED, 1)
EVT_TOOL_RCLICKED_RANGE = wx.PyEventBinder( wxEVT_TOOL_RCLICKED, 2)
EVT_TOOL_ENTER = wx.PyEventBinder( wxEVT_TOOL_ENTER, 1)
EVT_TOOL_DROPDOWN = wx.PyEventBinder( wxEVT_TOOL_DROPDOWN, 1)
EVT_CHECKLISTBOX = wx.PyEventBinder( wxEVT_CHECKLISTBOX, 1)
EVT_COMBOBOX_DROPDOWN = wx.PyEventBinder( wxEVT_COMBOBOX_DROPDOWN , 1)
EVT_COMBOBOX_CLOSEUP = wx.PyEventBinder( wxEVT_COMBOBOX_CLOSEUP , 1)
EVT_COMMAND_LEFT_CLICK = wx.PyEventBinder( wxEVT_COMMAND_LEFT_CLICK, 1)
EVT_COMMAND_LEFT_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_LEFT_DCLICK, 1)
EVT_COMMAND_RIGHT_CLICK = wx.PyEventBinder( wxEVT_COMMAND_RIGHT_CLICK, 1)
EVT_COMMAND_RIGHT_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_RIGHT_DCLICK, 1)
EVT_COMMAND_SET_FOCUS = wx.PyEventBinder( wxEVT_COMMAND_SET_FOCUS, 1)
EVT_COMMAND_KILL_FOCUS = wx.PyEventBinder( wxEVT_COMMAND_KILL_FOCUS, 1)
EVT_COMMAND_ENTER = wx.PyEventBinder( wxEVT_COMMAND_ENTER, 1)
EVT_HELP = wx.PyEventBinder( wxEVT_HELP, 1)
EVT_HELP_RANGE = wx.PyEventBinder( wxEVT_HELP, 2)
EVT_DETAILED_HELP = wx.PyEventBinder( wxEVT_DETAILED_HELP, 1)
EVT_DETAILED_HELP_RANGE = wx.PyEventBinder( wxEVT_DETAILED_HELP, 2)
EVT_IDLE = wx.PyEventBinder( wxEVT_IDLE )
EVT_UPDATE_UI = wx.PyEventBinder( wxEVT_UPDATE_UI, 1)
EVT_UPDATE_UI_RANGE = wx.PyEventBinder( wxEVT_UPDATE_UI, 2)
EVT_CONTEXT_MENU = wx.PyEventBinder( wxEVT_CONTEXT_MENU )
EVT_THREAD = wx.PyEventBinder( wxEVT_THREAD )
EVT_WINDOW_MODAL_DIALOG_CLOSED = wx.PyEventBinder( wxEVT_WINDOW_MODAL_DIALOG_CLOSED )
EVT_JOY_BUTTON_DOWN = wx.PyEventBinder( wxEVT_JOY_BUTTON_DOWN )
EVT_JOY_BUTTON_UP = wx.PyEventBinder( wxEVT_JOY_BUTTON_UP )
EVT_JOY_MOVE = wx.PyEventBinder( wxEVT_JOY_MOVE )
EVT_JOY_ZMOVE = wx.PyEventBinder( wxEVT_JOY_ZMOVE )
EVT_JOYSTICK_EVENTS = wx.PyEventBinder([ wxEVT_JOY_BUTTON_DOWN,
wxEVT_JOY_BUTTON_UP,
wxEVT_JOY_MOVE,
wxEVT_JOY_ZMOVE,
])
# deprecated wxEVT aliases
wxEVT_COMMAND_BUTTON_CLICKED = wxEVT_BUTTON
wxEVT_COMMAND_CHECKBOX_CLICKED = wxEVT_CHECKBOX
wxEVT_COMMAND_CHOICE_SELECTED = wxEVT_CHOICE
wxEVT_COMMAND_LISTBOX_SELECTED = wxEVT_LISTBOX
wxEVT_COMMAND_LISTBOX_DOUBLECLICKED = wxEVT_LISTBOX_DCLICK
wxEVT_COMMAND_CHECKLISTBOX_TOGGLED = wxEVT_CHECKLISTBOX
wxEVT_COMMAND_MENU_SELECTED = wxEVT_MENU
wxEVT_COMMAND_TOOL_CLICKED = wxEVT_TOOL
wxEVT_COMMAND_SLIDER_UPDATED = wxEVT_SLIDER
wxEVT_COMMAND_RADIOBOX_SELECTED = wxEVT_RADIOBOX
wxEVT_COMMAND_RADIOBUTTON_SELECTED = wxEVT_RADIOBUTTON
wxEVT_COMMAND_SCROLLBAR_UPDATED = wxEVT_SCROLLBAR
wxEVT_COMMAND_VLBOX_SELECTED = wxEVT_VLBOX
wxEVT_COMMAND_COMBOBOX_SELECTED = wxEVT_COMBOBOX
wxEVT_COMMAND_TOOL_RCLICKED = wxEVT_TOOL_RCLICKED
wxEVT_COMMAND_TOOL_DROPDOWN_CLICKED = wxEVT_TOOL_DROPDOWN
wxEVT_COMMAND_TOOL_ENTER = wxEVT_TOOL_ENTER
wxEVT_COMMAND_COMBOBOX_DROPDOWN = wxEVT_COMBOBOX_DROPDOWN
wxEVT_COMMAND_COMBOBOX_CLOSEUP = wxEVT_COMBOBOX_CLOSEUP
# End of included code block
#-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
PyEvtHandler = wx.deprecated(EvtHandler, "Use :class:`EvtHandler` instead.")
#-- end-event --#
#-- begin-pyevent --#
class PyEvent(Event):
"""
PyEvent(id=0, eventType=wxEVT_NULL)
:class:`PyEvent` can be used as a base class for implementing custom
event types in Python. You should derive from this class instead
of :class:`Event` because this class is Python-aware and is able to
transport its Python bits safely through the wxWidgets event
system and have them still be there when the event handler is
invoked. Note that since :class:`PyEvent` is taking care of preserving
the extra attributes that have been set then you do not need to
override the Clone method in your derived classes.
:see: :class:`PyCommandEvent`
"""
def __init__(self, id=0, eventType=wxEVT_NULL):
"""
PyEvent(id=0, eventType=wxEVT_NULL)
:class:`PyEvent` can be used as a base class for implementing custom
event types in Python. You should derive from this class instead
of :class:`Event` because this class is Python-aware and is able to
transport its Python bits safely through the wxWidgets event
system and have them still be there when the event handler is
invoked. Note that since :class:`PyEvent` is taking care of preserving
the extra attributes that have been set then you do not need to
override the Clone method in your derived classes.
:see: :class:`PyCommandEvent`
"""
def __getattr__(self, name):
"""
__getattr__(name) -> PyObject
"""
def __delattr__(self, name):
"""
__delattr__(name)
"""
def __setattr__(self, name, value):
"""
__setattr__(name, value)
"""
def Clone(self):
"""
Clone() -> Event
"""
def _getAttrDict(self):
"""
_getAttrDict() -> PyObject
"""
def Clone(self):
"""
Make a new instance of the event that is a copy of self.
Through the magic of Python this implementation should work for
this and all derived classes.
"""
# end of class PyEvent
class PyCommandEvent(CommandEvent):
"""
PyCommandEvent(eventType=wxEVT_NULL, id=0)
:class:`PyCommandEvent` can be used as a base class for implementing
custom event types in Python. You should derive from this class
instead of :class:`CommandEvent` because this class is Python-aware
and is able to transport its Python bits safely through the
wxWidgets event system and have them still be there when the
event handler is invoked. Note that since :class:`PyCommandEvent` is
taking care of preserving the extra attributes that have been set
then you do not need to override the Clone method in your
derived classes.
:see: :class:`PyEvent`
"""
def __init__(self, eventType=wxEVT_NULL, id=0):
"""
PyCommandEvent(eventType=wxEVT_NULL, id=0)
:class:`PyCommandEvent` can be used as a base class for implementing
custom event types in Python. You should derive from this class
instead of :class:`CommandEvent` because this class is Python-aware
and is able to transport its Python bits safely through the
wxWidgets event system and have them still be there when the
event handler is invoked. Note that since :class:`PyCommandEvent` is
taking care of preserving the extra attributes that have been set
then you do not need to override the Clone method in your
derived classes.
:see: :class:`PyEvent`
"""
def __getattr__(self, name):
"""
__getattr__(name) -> PyObject
"""
def __delattr__(self, name):
"""
__delattr__(name)
"""
def __setattr__(self, name, value):
"""
__setattr__(name, value)
"""
def Clone(self):
"""
Clone() -> Event
"""
def _getAttrDict(self):
"""
_getAttrDict() -> PyObject
"""
def Clone(self):
"""
Make a new instance of the event that is a copy of self.
Through the magic of Python this implementation should work for
this and all derived classes.
"""
# end of class PyCommandEvent
#-- end-pyevent --#
#-- begin-sizer --#
FLEX_GROWMODE_NONE = 0
FLEX_GROWMODE_SPECIFIED = 0
FLEX_GROWMODE_ALL = 0
class SizerItem(Object):
"""
SizerItem(window, flags)
SizerItem(window, proportion=0, flag=0, border=0, userData=None)
SizerItem(sizer, flags)
SizerItem(sizer, proportion=0, flag=0, border=0, userData=None)
SizerItem(width, height, proportion=0, flag=0, border=0, userData=None)
The wxSizerItem class is used to track the position, size and other
attributes of each item managed by a wxSizer.
"""
def __init__(self, *args, **kw):
"""
SizerItem(window, flags)
SizerItem(window, proportion=0, flag=0, border=0, userData=None)
SizerItem(sizer, flags)
SizerItem(sizer, proportion=0, flag=0, border=0, userData=None)
SizerItem(width, height, proportion=0, flag=0, border=0, userData=None)
The wxSizerItem class is used to track the position, size and other
attributes of each item managed by a wxSizer.
"""
def AssignSpacer(self, *args, **kw):
"""
AssignSpacer(size)
AssignSpacer(w, h)
Set the size of the spacer tracked by this item.
"""
def SetRatio(self, *args, **kw):
"""
SetRatio(width, height)
SetRatio(size)
SetRatio(ratio)
Set the ratio item attribute.
"""
def AssignWindow(self, window):
"""
AssignWindow(window)
Set the window to be tracked by this item.
"""
def AssignSizer(self, sizer):
"""
AssignSizer(sizer)
Set the sizer tracked by this item.
"""
def CalcMin(self):
"""
CalcMin() -> Size
Calculates the minimum desired size for the item, including any space
needed by borders.
"""
def DeleteWindows(self):
"""
DeleteWindows()
Destroy the window or the windows in a subsizer, depending on the type
of item.
"""
def DetachSizer(self):
"""
DetachSizer()
Enable deleting the SizerItem without destroying the contained sizer.
"""
def GetBorder(self):
"""
GetBorder() -> int
Return the border attribute.
"""
def GetFlag(self):
"""
GetFlag() -> int
Return the flags attribute.
"""
def GetId(self):
"""
GetId() -> int
Return the numeric id of wxSizerItem, or wxID_NONE if the id has not
been set.
"""
def GetMinSize(self):
"""
GetMinSize() -> Size
Get the minimum size needed for the item.
"""
def SetMinSize(self, *args, **kw):
"""
SetMinSize(size)
SetMinSize(x, y)
Sets the minimum size to be allocated for this item.
"""
def GetPosition(self):
"""
GetPosition() -> Point
What is the current position of the item, as set in the last Layout.
"""
def GetProportion(self):
"""
GetProportion() -> int
Get the proportion item attribute.
"""
def GetRatio(self):
"""
GetRatio() -> float
Get the ration item attribute.
"""
def GetRect(self):
"""
GetRect() -> Rect
Get the rectangle of the item on the parent window, excluding borders.
"""
def GetSize(self):
"""
GetSize() -> Size
Get the current size of the item, as set in the last Layout.
"""
def GetSizer(self):
"""
GetSizer() -> Sizer
If this item is tracking a sizer, return it.
"""
def GetSpacer(self):
"""
GetSpacer() -> Size
If this item is tracking a spacer, return its size.
"""
def GetUserData(self):
"""
GetUserData() -> PyUserData
Get the userData item attribute.
"""
def GetWindow(self):
"""
GetWindow() -> Window
If this item is tracking a window then return it.
"""
def IsShown(self):
"""
IsShown() -> bool
Returns true if this item is a window or a spacer and it is shown or
if this item is a sizer and not all of its elements are hidden.
"""
def IsSizer(self):
"""
IsSizer() -> bool
Is this item a sizer?
"""
def IsSpacer(self):
"""
IsSpacer() -> bool
Is this item a spacer?
"""
def IsWindow(self):
"""
IsWindow() -> bool
Is this item a window?
"""
def SetBorder(self, border):
"""
SetBorder(border)
Set the border item attribute.
"""
def SetDimension(self, pos, size):
"""
SetDimension(pos, size)
Set the position and size of the space allocated to the sizer, and
adjust the position and size of the item to be within that space
taking alignment and borders into account.
"""
def SetFlag(self, flag):
"""
SetFlag(flag)
Set the flag item attribute.
"""
def SetId(self, id):
"""
SetId(id)
Sets the numeric id of the wxSizerItem to id.
"""
def SetInitSize(self, x, y):
"""
SetInitSize(x, y)
"""
def SetProportion(self, proportion):
"""
SetProportion(proportion)
Set the proportion item attribute.
"""
def SetUserData(self, userData):
"""
SetUserData(userData)
"""
def Show(self, show):
"""
Show(show)
Set the show item attribute, which sizers use to determine if the item
is to be made part of the layout or not.
"""
Border = property(None, None)
Flag = property(None, None)
Id = property(None, None)
MinSize = property(None, None)
Position = property(None, None)
Proportion = property(None, None)
Ratio = property(None, None)
Rect = property(None, None)
Size = property(None, None)
Sizer = property(None, None)
Spacer = property(None, None)
UserData = property(None, None)
Window = property(None, None)
# end of class SizerItem
class SizerFlags(object):
"""
SizerFlags(proportion=0)
Container for sizer items flags providing readable names for them.
"""
def __init__(self, proportion=0):
"""
SizerFlags(proportion=0)
Container for sizer items flags providing readable names for them.
"""
def Align(self, alignment):
"""
Align(alignment) -> SizerFlags
Sets the alignment of this wxSizerFlags to align.
"""
def Border(self, *args, **kw):
"""
Border(direction, borderinpixels) -> SizerFlags
Border(direction=ALL) -> SizerFlags
Sets the wxSizerFlags to have a border of a number of pixels specified
by borderinpixels with the directions specified by direction.
"""
def Bottom(self):
"""
Bottom() -> SizerFlags
Aligns the object to the bottom, similar for Align(wxALIGN_BOTTOM).
"""
def Center(self):
"""
Center() -> SizerFlags
Sets the object of the wxSizerFlags to center itself in the area it is
given.
"""
def Centre(self):
"""
Centre() -> SizerFlags
Center() for people with the other dialect of English.
"""
def DoubleBorder(self, direction=ALL):
"""
DoubleBorder(direction=ALL) -> SizerFlags
Sets the border in the given direction having twice the default border
size.
"""
def DoubleHorzBorder(self):
"""
DoubleHorzBorder() -> SizerFlags
Sets the border in left and right directions having twice the default
border size.
"""
def Expand(self):
"""
Expand() -> SizerFlags
Sets the object of the wxSizerFlags to expand to fill as much area as
it can.
"""
def FixedMinSize(self):
"""
FixedMinSize() -> SizerFlags
Set the wxFIXED_MINSIZE flag which indicates that the initial size of
the window should be also set as its minimal size.
"""
def ReserveSpaceEvenIfHidden(self):
"""
ReserveSpaceEvenIfHidden() -> SizerFlags
Set the wxRESERVE_SPACE_EVEN_IF_HIDDEN flag.
"""
def Left(self):
"""
Left() -> SizerFlags
Aligns the object to the left, similar for Align(wxALIGN_LEFT).
"""
def Proportion(self, proportion):
"""
Proportion(proportion) -> SizerFlags
Sets the proportion of this wxSizerFlags to proportion.
"""
def Right(self):
"""
Right() -> SizerFlags
Aligns the object to the right, similar for Align(wxALIGN_RIGHT).
"""
def Shaped(self):
"""
Shaped() -> SizerFlags
Set the wx_SHAPED flag which indicates that the elements should always
keep the fixed width to height ratio equal to its original value.
"""
def Top(self):
"""
Top() -> SizerFlags
Aligns the object to the top, similar for Align(wxALIGN_TOP).
"""
def TripleBorder(self, direction=ALL):
"""
TripleBorder(direction=ALL) -> SizerFlags
Sets the border in the given direction having thrice the default
border size.
"""
@staticmethod
def GetDefaultBorder():
"""
GetDefaultBorder() -> int
Returns the border used by default in Border() method.
"""
# end of class SizerFlags
class Sizer(Object):
"""
Sizer()
wxSizer is the abstract base class used for laying out subwindows in a
window.
"""
def __init__(self):
"""
Sizer()
wxSizer is the abstract base class used for laying out subwindows in a
window.
"""
def GetChildren(self):
"""
GetChildren() -> SizerItemList
Returns the list of the items in this sizer.
"""
def SetItemMinSize(self, *args, **kw):
"""
SetItemMinSize(window, width, height) -> bool
SetItemMinSize(window, size) -> bool
SetItemMinSize(sizer, width, height) -> bool
SetItemMinSize(sizer, size) -> bool
SetItemMinSize(index, width, height) -> bool
SetItemMinSize(index, size) -> bool
Set an item's minimum size by window, sizer, or position.
"""
def Add(self, *args, **kw):
"""
Add(window, flags) -> SizerItem
Add(window, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Add(sizer, flags) -> SizerItem
Add(sizer, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Add(width, height, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Add(width, height, flags) -> SizerItem
Add(item) -> SizerItem
Add(size, proportion=0, flag=0, border=0, /Transfer/=None) -> SizerItem
Add(size, flags) -> SizerItem
Appends a child to the sizer.
"""
def AddSpacer(self, size):
"""
AddSpacer(size) -> SizerItem
This base function adds non-stretchable space to both the horizontal
and vertical orientation of the sizer.
"""
def AddStretchSpacer(self, prop=1):
"""
AddStretchSpacer(prop=1) -> SizerItem
Adds stretchable space to the sizer.
"""
def CalcMin(self):
"""
CalcMin() -> Size
This method is abstract and has to be overwritten by any derived
class.
"""
def Clear(self, delete_windows=False):
"""
Clear(delete_windows=False)
Detaches all children from the sizer.
"""
def ComputeFittingClientSize(self, window):
"""
ComputeFittingClientSize(window) -> Size
Computes client area size for window so that it matches the sizer's
minimal size.
"""
def ComputeFittingWindowSize(self, window):
"""
ComputeFittingWindowSize(window) -> Size
Like ComputeFittingClientSize(), but converts the result into window
size.
"""
def Detach(self, *args, **kw):
"""
Detach(window) -> bool
Detach(sizer) -> bool
Detach(index) -> bool
Detach the child window from the sizer without destroying it.
"""
def Fit(self, window):
"""
Fit(window) -> Size
Tell the sizer to resize the window so that its client area matches
the sizer's minimal size (ComputeFittingClientSize() is called to
determine it).
"""
def FitInside(self, window):
"""
FitInside(window)
Tell the sizer to resize the virtual size of the window to match the
sizer's minimal size.
"""
def InformFirstDirection(self, direction, size, availableOtherDir):
"""
InformFirstDirection(direction, size, availableOtherDir) -> bool
Inform sizer about the first direction that has been decided (by
parent item).
"""
def GetContainingWindow(self):
"""
GetContainingWindow() -> Window
Returns the window this sizer is used in or NULL if none.
"""
def SetContainingWindow(self, window):
"""
SetContainingWindow(window)
Set the window this sizer is used in.
"""
def GetItemCount(self):
"""
GetItemCount() -> size_t
Returns the number of items in the sizer.
"""
def GetItem(self, *args, **kw):
"""
GetItem(window, recursive=False) -> SizerItem
GetItem(sizer, recursive=False) -> SizerItem
GetItem(index) -> SizerItem
Finds wxSizerItem which holds the given window.
"""
def GetItemById(self, id, recursive=False):
"""
GetItemById(id, recursive=False) -> SizerItem
Finds item of the sizer which has the given id.
"""
def GetMinSize(self):
"""
GetMinSize() -> Size
Returns the minimal size of the sizer.
"""
def GetPosition(self):
"""
GetPosition() -> Point
Returns the current position of the sizer.
"""
def GetSize(self):
"""
GetSize() -> Size
Returns the current size of the sizer.
"""
def Hide(self, *args, **kw):
"""
Hide(window, recursive=False) -> bool
Hide(sizer, recursive=False) -> bool
Hide(index) -> bool
Hides the child window.
"""
def Insert(self, *args, **kw):
"""
Insert(index, window, flags) -> SizerItem
Insert(index, window, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Insert(index, sizer, flags) -> SizerItem
Insert(index, sizer, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Insert(index, width, height, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Insert(index, width, height, flags) -> SizerItem
Insert(index, item) -> SizerItem
Insert(index, size, proportion=0, flag=0, border=0, /Transfer/=None) -> SizerItem
Insert(index, size, flags) -> SizerItem
Insert a child into the sizer before any existing item at index.
"""
def InsertSpacer(self, index, size):
"""
InsertSpacer(index, size) -> SizerItem
Inserts non-stretchable space to the sizer.
"""
def InsertStretchSpacer(self, index, prop=1):
"""
InsertStretchSpacer(index, prop=1) -> SizerItem
Inserts stretchable space to the sizer.
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Return true if the sizer has no elements.
"""
def IsShown(self, *args, **kw):
"""
IsShown(window) -> bool
IsShown(sizer) -> bool
IsShown(index) -> bool
Returns true if the window is shown.
"""
def Layout(self):
"""
Layout()
Call this to force layout of the children anew, e.g. after having
added a child to or removed a child (window, other sizer or space)
from the sizer while keeping the current dimension.
"""
def Prepend(self, *args, **kw):
"""
Prepend(window, flags) -> SizerItem
Prepend(window, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Prepend(sizer, flags) -> SizerItem
Prepend(sizer, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Prepend(width, height, proportion=0, flag=0, border=0, userData=None) -> SizerItem
Prepend(width, height, flags) -> SizerItem
Prepend(item) -> SizerItem
Prepend(size, proportion=0, flag=0, border=0, /Transfer/=None) -> SizerItem
Prepend(size, flags) -> SizerItem
Same as Add(), but prepends the items to the beginning of the list of
items (windows, subsizers or spaces) owned by this sizer.
"""
def PrependSpacer(self, size):
"""
PrependSpacer(size) -> SizerItem
Prepends non-stretchable space to the sizer.
"""
def PrependStretchSpacer(self, prop=1):
"""
PrependStretchSpacer(prop=1) -> SizerItem
Prepends stretchable space to the sizer.
"""
def RecalcSizes(self):
"""
RecalcSizes()
This method is abstract and has to be overwritten by any derived
class.
"""
def Remove(self, *args, **kw):
"""
Remove(sizer) -> bool
Remove(index) -> bool
Removes a sizer child from the sizer and destroys it.
"""
def Replace(self, *args, **kw):
"""
Replace(oldwin, newwin, recursive=False) -> bool
Replace(oldsz, newsz, recursive=False) -> bool
Replace(index, newitem) -> bool
Detaches the given oldwin from the sizer and replaces it with the
given newwin.
"""
def SetDimension(self, *args, **kw):
"""
SetDimension(x, y, width, height)
SetDimension(pos, size)
Call this to force the sizer to take the given dimension and thus
force the items owned by the sizer to resize themselves according to
the rules defined by the parameter in the Add() and Prepend() methods.
"""
def SetMinSize(self, *args, **kw):
"""
SetMinSize(size)
SetMinSize(width, height)
Call this to give the sizer a minimal size.
"""
def SetSizeHints(self, window):
"""
SetSizeHints(window)
This method first calls Fit() and then
wxTopLevelWindow::SetSizeHints() on the window passed to it.
"""
def SetVirtualSizeHints(self, window):
"""
SetVirtualSizeHints(window)
Tell the sizer to set the minimal size of the window virtual area to
match the sizer's minimal size.
"""
def Show(self, *args, **kw):
"""
Show(window, show=True, recursive=False) -> bool
Show(sizer, show=True, recursive=False) -> bool
Show(index, show=True) -> bool
Shows or hides the window.
"""
def ShowItems(self, show):
"""
ShowItems(show)
Show or hide all items managed by the sizer.
"""
def AddMany(self, items):
"""
:meth:`AddMany` is a convenience method for adding several items to a sizer
at one time. Simply pass it a list of tuples, where each tuple
consists of the parameters that you would normally pass to the :meth:`Add`
method.
"""
def __nonzero__(self):
"""
Can be used to test if the C++ part of the sizer still exists, with
code like this::
if theSizer:
doSomething()
"""
__bool__ = __nonzero__
Children = property(None, None)
ContainingWindow = property(None, None)
ItemCount = property(None, None)
MinSize = property(None, None)
Position = property(None, None)
Size = property(None, None)
# end of class Sizer
class BoxSizer(Sizer):
"""
BoxSizer(orient=HORIZONTAL)
The basic idea behind a box sizer is that windows will most often be
laid out in rather simple basic geometry, typically in a row or a
column or several hierarchies of either.
"""
def __init__(self, orient=HORIZONTAL):
"""
BoxSizer(orient=HORIZONTAL)
The basic idea behind a box sizer is that windows will most often be
laid out in rather simple basic geometry, typically in a row or a
column or several hierarchies of either.
"""
def AddSpacer(self, size):
"""
AddSpacer(size) -> SizerItem
Adds non-stretchable space to the main orientation of the sizer only.
"""
def CalcMin(self):
"""
CalcMin() -> Size
Implements the calculation of a box sizer's minimal.
"""
def GetOrientation(self):
"""
GetOrientation() -> int
Returns the orientation of the box sizer, either wxVERTICAL or
wxHORIZONTAL.
"""
def SetOrientation(self, orient):
"""
SetOrientation(orient)
Sets the orientation of the box sizer, either wxVERTICAL or
wxHORIZONTAL.
"""
def RecalcSizes(self):
"""
RecalcSizes()
Implements the calculation of a box sizer's dimensions and then sets
the size of its children (calling wxWindow::SetSize if the child is a
window).
"""
Orientation = property(None, None)
# end of class BoxSizer
class StaticBoxSizer(BoxSizer):
"""
StaticBoxSizer(box, orient=HORIZONTAL)
StaticBoxSizer(orient, parent, label=EmptyString)
wxStaticBoxSizer is a sizer derived from wxBoxSizer but adds a static
box around the sizer.
"""
def __init__(self, *args, **kw):
"""
StaticBoxSizer(box, orient=HORIZONTAL)
StaticBoxSizer(orient, parent, label=EmptyString)
wxStaticBoxSizer is a sizer derived from wxBoxSizer but adds a static
box around the sizer.
"""
def GetStaticBox(self):
"""
GetStaticBox() -> StaticBox
Returns the static box associated with the sizer.
"""
def CalcMin(self):
"""
CalcMin() -> Size
Implements the calculation of a box sizer's minimal.
"""
def RecalcSizes(self):
"""
RecalcSizes()
Implements the calculation of a box sizer's dimensions and then sets
the size of its children (calling wxWindow::SetSize if the child is a
window).
"""
StaticBox = property(None, None)
# end of class StaticBoxSizer
class GridSizer(Sizer):
"""
GridSizer(cols, vgap, hgap)
GridSizer(cols, gap=Size(0,0))
GridSizer(rows, cols, vgap, hgap)
GridSizer(rows, cols, gap)
A grid sizer is a sizer which lays out its children in a two-
dimensional table with all table fields having the same size, i.e.
"""
def __init__(self, *args, **kw):
"""
GridSizer(cols, vgap, hgap)
GridSizer(cols, gap=Size(0,0))
GridSizer(rows, cols, vgap, hgap)
GridSizer(rows, cols, gap)
A grid sizer is a sizer which lays out its children in a two-
dimensional table with all table fields having the same size, i.e.
"""
def GetCols(self):
"""
GetCols() -> int
Returns the number of columns that has been specified for the sizer.
"""
def GetRows(self):
"""
GetRows() -> int
Returns the number of rows that has been specified for the sizer.
"""
def GetEffectiveColsCount(self):
"""
GetEffectiveColsCount() -> int
Returns the number of columns currently used by the sizer.
"""
def GetEffectiveRowsCount(self):
"""
GetEffectiveRowsCount() -> int
Returns the number of rows currently used by the sizer.
"""
def GetHGap(self):
"""
GetHGap() -> int
Returns the horizontal gap (in pixels) between cells in the sizer.
"""
def GetVGap(self):
"""
GetVGap() -> int
Returns the vertical gap (in pixels) between the cells in the sizer.
"""
def SetCols(self, cols):
"""
SetCols(cols)
Sets the number of columns in the sizer.
"""
def SetHGap(self, gap):
"""
SetHGap(gap)
Sets the horizontal gap (in pixels) between cells in the sizer.
"""
def SetRows(self, rows):
"""
SetRows(rows)
Sets the number of rows in the sizer.
"""
def SetVGap(self, gap):
"""
SetVGap(gap)
Sets the vertical gap (in pixels) between the cells in the sizer.
"""
def CalcMin(self):
"""
CalcMin() -> Size
This method is abstract and has to be overwritten by any derived
class.
"""
def RecalcSizes(self):
"""
RecalcSizes()
This method is abstract and has to be overwritten by any derived
class.
"""
def CalcRowsCols(self):
"""
CalcRowsCols() -> (rows, cols)
Calculates how many rows and columns will be in the sizer based
on the current number of items and also the rows, cols specified
in the constructor.
"""
Cols = property(None, None)
EffectiveColsCount = property(None, None)
EffectiveRowsCount = property(None, None)
HGap = property(None, None)
Rows = property(None, None)
VGap = property(None, None)
# end of class GridSizer
class FlexGridSizer(GridSizer):
"""
FlexGridSizer(cols, vgap, hgap)
FlexGridSizer(cols, gap=Size(0,0))
FlexGridSizer(rows, cols, vgap, hgap)
FlexGridSizer(rows, cols, gap)
A flex grid sizer is a sizer which lays out its children in a two-
dimensional table with all table fields in one row having the same
height and all fields in one column having the same width, but all
rows or all columns are not necessarily the same height or width as in
the wxGridSizer.
"""
def __init__(self, *args, **kw):
"""
FlexGridSizer(cols, vgap, hgap)
FlexGridSizer(cols, gap=Size(0,0))
FlexGridSizer(rows, cols, vgap, hgap)
FlexGridSizer(rows, cols, gap)
A flex grid sizer is a sizer which lays out its children in a two-
dimensional table with all table fields in one row having the same
height and all fields in one column having the same width, but all
rows or all columns are not necessarily the same height or width as in
the wxGridSizer.
"""
def AddGrowableCol(self, idx, proportion=0):
"""
AddGrowableCol(idx, proportion=0)
Specifies that column idx (starting from zero) should be grown if
there is extra space available to the sizer.
"""
def AddGrowableRow(self, idx, proportion=0):
"""
AddGrowableRow(idx, proportion=0)
Specifies that row idx (starting from zero) should be grown if there
is extra space available to the sizer.
"""
def GetFlexibleDirection(self):
"""
GetFlexibleDirection() -> int
Returns a wxOrientation value that specifies whether the sizer
flexibly resizes its columns, rows, or both (default).
"""
def GetNonFlexibleGrowMode(self):
"""
GetNonFlexibleGrowMode() -> FlexSizerGrowMode
Returns the value that specifies how the sizer grows in the "non-
flexible" direction if there is one.
"""
def IsColGrowable(self, idx):
"""
IsColGrowable(idx) -> bool
Returns true if column idx is growable.
"""
def IsRowGrowable(self, idx):
"""
IsRowGrowable(idx) -> bool
Returns true if row idx is growable.
"""
def RemoveGrowableCol(self, idx):
"""
RemoveGrowableCol(idx)
Specifies that the idx column index is no longer growable.
"""
def RemoveGrowableRow(self, idx):
"""
RemoveGrowableRow(idx)
Specifies that the idx row index is no longer growable.
"""
def SetFlexibleDirection(self, direction):
"""
SetFlexibleDirection(direction)
Specifies whether the sizer should flexibly resize its columns, rows,
or both.
"""
def SetNonFlexibleGrowMode(self, mode):
"""
SetNonFlexibleGrowMode(mode)
Specifies how the sizer should grow in the non-flexible direction if
there is one (so SetFlexibleDirection() must have been called
previously).
"""
def GetRowHeights(self):
"""
GetRowHeights() -> ArrayInt
Returns a read-only array containing the heights of the rows in the
sizer.
"""
def GetColWidths(self):
"""
GetColWidths() -> ArrayInt
Returns a read-only array containing the widths of the columns in the
sizer.
"""
def RecalcSizes(self):
"""
RecalcSizes()
This method is abstract and has to be overwritten by any derived
class.
"""
def CalcMin(self):
"""
CalcMin() -> Size
This method is abstract and has to be overwritten by any derived
class.
"""
ColWidths = property(None, None)
FlexibleDirection = property(None, None)
NonFlexibleGrowMode = property(None, None)
RowHeights = property(None, None)
# end of class FlexGridSizer
class StdDialogButtonSizer(BoxSizer):
"""
StdDialogButtonSizer()
This class creates button layouts which conform to the standard button
spacing and ordering defined by the platform or toolkit's user
interface guidelines (if such things exist).
"""
def __init__(self):
"""
StdDialogButtonSizer()
This class creates button layouts which conform to the standard button
spacing and ordering defined by the platform or toolkit's user
interface guidelines (if such things exist).
"""
def AddButton(self, button):
"""
AddButton(button)
Adds a button to the wxStdDialogButtonSizer.
"""
def Realize(self):
"""
Realize()
Rearranges the buttons and applies proper spacing between buttons to
make them match the platform or toolkit's interface guidelines.
"""
def SetAffirmativeButton(self, button):
"""
SetAffirmativeButton(button)
Sets the affirmative button for the sizer.
"""
def SetCancelButton(self, button):
"""
SetCancelButton(button)
Sets the cancel button for the sizer.
"""
def SetNegativeButton(self, button):
"""
SetNegativeButton(button)
Sets the negative button for the sizer.
"""
def RecalcSizes(self):
"""
RecalcSizes()
Implements the calculation of a box sizer's dimensions and then sets
the size of its children (calling wxWindow::SetSize if the child is a
window).
"""
def CalcMin(self):
"""
CalcMin() -> Size
Implements the calculation of a box sizer's minimal.
"""
# end of class StdDialogButtonSizer
PySizer = wx.deprecated(Sizer, 'Use Sizer instead.')
#-- end-sizer --#
#-- begin-gbsizer --#
class GBPosition(object):
"""
GBPosition()
GBPosition(row, col)
This class represents the position of an item in a virtual grid of
rows and columns managed by a wxGridBagSizer.
"""
def __init__(self, *args, **kw):
"""
GBPosition()
GBPosition(row, col)
This class represents the position of an item in a virtual grid of
rows and columns managed by a wxGridBagSizer.
"""
def GetCol(self):
"""
GetCol() -> int
Get the current column value.
"""
def GetRow(self):
"""
GetRow() -> int
Get the current row value.
"""
def SetCol(self, col):
"""
SetCol(col)
Set a new column value.
"""
def SetRow(self, row):
"""
SetRow(row)
Set a new row value.
"""
def __ne__(self):
"""
"""
def __eq__(self):
"""
"""
def Get(self):
"""
Get() -> (row, col)
Return the row and col properties as a tuple.
"""
def Set(self, row=0, col=0):
"""
Set(row=0, col=0)
Set both the row and column properties.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
Row = property(None, None)
Col = property(None, None)
row = property(None, None)
col = property(None, None)
# end of class GBPosition
class GBSpan(object):
"""
GBSpan()
GBSpan(rowspan, colspan)
This class is used to hold the row and column spanning attributes of
items in a wxGridBagSizer.
"""
def __init__(self, *args, **kw):
"""
GBSpan()
GBSpan(rowspan, colspan)
This class is used to hold the row and column spanning attributes of
items in a wxGridBagSizer.
"""
def GetColspan(self):
"""
GetColspan() -> int
Get the current colspan value.
"""
def GetRowspan(self):
"""
GetRowspan() -> int
Get the current rowspan value.
"""
def SetColspan(self, colspan):
"""
SetColspan(colspan)
Set a new colspan value.
"""
def SetRowspan(self, rowspan):
"""
SetRowspan(rowspan)
Set a new rowspan value.
"""
def __ne__(self):
"""
"""
def __eq__(self):
"""
"""
def Get(self):
"""
Get() -> (rowspan, colspan)
Return the rowspan and colspan properties as a tuple.
"""
def Set(self, rowspan=0, colspan=0):
"""
Set(rowspan=0, colspan=0)
Set both the rowspan and colspan properties.
"""
def __str__(self):
"""
"""
def __repr__(self):
"""
"""
def __len__(self):
"""
"""
def __nonzero__(self):
"""
"""
def __reduce__(self):
"""
"""
def __getitem__(self, idx):
"""
"""
def __setitem__(self, idx, val):
"""
"""
__safe_for_unpickling__ = True
Rowspan = property(None, None)
Colspan = property(None, None)
rowspan = property(None, None)
colspan = property(None, None)
# end of class GBSpan
class GBSizerItem(SizerItem):
"""
GBSizerItem(width, height, pos, span=DefaultSpan, flag=0, border=0, userData=None)
GBSizerItem(window, pos, span=DefaultSpan, flag=0, border=0, userData=None)
GBSizerItem(sizer, pos, span=DefaultSpan, flag=0, border=0, userData=None)
The wxGBSizerItem class is used by the wxGridBagSizer for tracking the
items in the sizer.
"""
def __init__(self, *args, **kw):
"""
GBSizerItem(width, height, pos, span=DefaultSpan, flag=0, border=0, userData=None)
GBSizerItem(window, pos, span=DefaultSpan, flag=0, border=0, userData=None)
GBSizerItem(sizer, pos, span=DefaultSpan, flag=0, border=0, userData=None)
The wxGBSizerItem class is used by the wxGridBagSizer for tracking the
items in the sizer.
"""
def GetPos(self, *args, **kw):
"""
GetPos() -> GBPosition
Get the grid position of the item.
"""
def GetSpan(self, *args, **kw):
"""
GetSpan() -> GBSpan
Get the row and column spanning of the item.
"""
def GetEndPos(self):
"""
GetEndPos() -> (row, col)
Get the row and column of the endpoint of this item.
"""
def Intersects(self, *args, **kw):
"""
Intersects(other) -> bool
Intersects(pos, span) -> bool
Returns true if this item and the other item intersect.
"""
def SetPos(self, pos):
"""
SetPos(pos) -> bool
If the item is already a member of a sizer then first ensure that
there is no other item that would intersect with this one at the new
position, then set the new position.
"""
def SetSpan(self, span):
"""
SetSpan(span) -> bool
If the item is already a member of a sizer then first ensure that
there is no other item that would intersect with this one with its new
spanning size, then set the new spanning.
"""
def GetGBSizer(self):
"""
GetGBSizer() -> GridBagSizer
"""
def SetGBSizer(self, sizer):
"""
SetGBSizer(sizer)
"""
GBSizer = property(None, None)
Pos = property(None, None)
Span = property(None, None)
# end of class GBSizerItem
class GridBagSizer(FlexGridSizer):
"""
GridBagSizer(vgap=0, hgap=0)
A wxSizer that can lay out items in a virtual grid like a
wxFlexGridSizer but in this case explicit positioning of the items is
allowed using wxGBPosition, and items can optionally span more than
one row and/or column using wxGBSpan.
"""
def __init__(self, vgap=0, hgap=0):
"""
GridBagSizer(vgap=0, hgap=0)
A wxSizer that can lay out items in a virtual grid like a
wxFlexGridSizer but in this case explicit positioning of the items is
allowed using wxGBPosition, and items can optionally span more than
one row and/or column using wxGBSpan.
"""
def Add(self, *args, **kw):
"""
Add(window, pos, span=DefaultSpan, flag=0, border=0, userData=None) -> SizerItem
Add(sizer, pos, span=DefaultSpan, flag=0, border=0, userData=None) -> SizerItem
Add(item) -> SizerItem
Add(width, height, pos, span=DefaultSpan, flag=0, border=0, userData=None) -> SizerItem
Adds the given item to the given position.
"""
def CheckForIntersection(self, *args, **kw):
"""
CheckForIntersection(item, excludeItem=None) -> bool
CheckForIntersection(pos, span, excludeItem=None) -> bool
Look at all items and see if any intersect (or would overlap) the
given item.
"""
def FindItem(self, *args, **kw):
"""
FindItem(window) -> GBSizerItem
FindItem(sizer) -> GBSizerItem
Find the sizer item for the given window or subsizer, returns NULL if
not found.
"""
def GetItemPosition(self, *args, **kw):
"""
GetItemPosition(window) -> GBPosition
GetItemPosition(sizer) -> GBPosition
GetItemPosition(index) -> GBPosition
Get the grid position of the specified item.
"""
def GetItemSpan(self, *args, **kw):
"""
GetItemSpan(window) -> GBSpan
GetItemSpan(sizer) -> GBSpan
GetItemSpan(index) -> GBSpan
Get the row/col spanning of the specified item.
"""
def SetItemPosition(self, *args, **kw):
"""
SetItemPosition(window, pos) -> bool
SetItemPosition(sizer, pos) -> bool
SetItemPosition(index, pos) -> bool
Set the grid position of the specified item.
"""
def SetItemSpan(self, *args, **kw):
"""
SetItemSpan(window, span) -> bool
SetItemSpan(sizer, span) -> bool
SetItemSpan(index, span) -> bool
Set the row/col spanning of the specified item.
"""
def CalcMin(self):
"""
CalcMin() -> Size
Called when the managed size of the sizer is needed or when layout
needs done.
"""
def FindItemAtPoint(self, pt):
"""
FindItemAtPoint(pt) -> GBSizerItem
Return the sizer item located at the point given in pt, or NULL if
there is no item at that point.
"""
def FindItemAtPosition(self, pos):
"""
FindItemAtPosition(pos) -> GBSizerItem
Return the sizer item for the given grid cell, or NULL if there is no
item at that position.
"""
def FindItemWithData(self, userData):
"""
FindItemWithData(userData) -> GBSizerItem
Return the sizer item that has a matching user data (it only compares
pointer values) or NULL if not found.
"""
def GetCellSize(self, row, col):
"""
GetCellSize(row, col) -> Size
Get the size of the specified cell, including hgap and vgap.
"""
def GetEmptyCellSize(self):
"""
GetEmptyCellSize() -> Size
Get the size used for cells in the grid with no item.
"""
def RecalcSizes(self):
"""
RecalcSizes()
Called when the managed size of the sizer is needed or when layout
needs done.
"""
def SetEmptyCellSize(self, sz):
"""
SetEmptyCellSize(sz)
Set the size used for cells in the grid with no item.
"""
EmptyCellSize = property(None, None)
# end of class GridBagSizer
DefaultSpan = GBSpan()
#-- end-gbsizer --#
#-- begin-wrapsizer --#
EXTEND_LAST_ON_EACH_LINE = 0
REMOVE_LEADING_SPACES = 0
WRAPSIZER_DEFAULT_FLAGS = 0
class WrapSizer(BoxSizer):
"""
WrapSizer(orient=HORIZONTAL, flags=WRAPSIZER_DEFAULT_FLAGS)
A wrap sizer lays out its items in a single line, like a box sizer as
long as there is space available in that direction.
"""
def __init__(self, orient=HORIZONTAL, flags=WRAPSIZER_DEFAULT_FLAGS):
"""
WrapSizer(orient=HORIZONTAL, flags=WRAPSIZER_DEFAULT_FLAGS)
A wrap sizer lays out its items in a single line, like a box sizer as
long as there is space available in that direction.
"""
def InformFirstDirection(self, direction, size, availableOtherDir):
"""
InformFirstDirection(direction, size, availableOtherDir) -> bool
Not used by an application.
"""
def RecalcSizes(self):
"""
RecalcSizes()
Implements the calculation of a box sizer's dimensions and then sets
the size of its children (calling wxWindow::SetSize if the child is a
window).
"""
def CalcMin(self):
"""
CalcMin() -> Size
Implements the calculation of a box sizer's minimal.
"""
def IsSpaceItem(self, item):
"""
IsSpaceItem(item) -> bool
Can be overridden in the derived classes to treat some normal items as
spacers.
"""
# end of class WrapSizer
#-- end-wrapsizer --#
#-- begin-stdpaths --#
class StandardPaths(object):
"""
StandardPaths()
wxStandardPaths returns the standard locations in the file system and
should be used by applications to find their data files in a portable
way.
"""
ResourceCat_None = 0
ResourceCat_Messages = 0
def GetAppDocumentsDir(self):
"""
GetAppDocumentsDir() -> String
Return the directory for the document files used by this application.
"""
def GetConfigDir(self):
"""
GetConfigDir() -> String
Return the directory containing the system config files.
"""
def GetDataDir(self):
"""
GetDataDir() -> String
Return the location of the applications global, i.e. not user-
specific, data files.
"""
def GetDocumentsDir(self):
"""
GetDocumentsDir() -> String
Return the directory containing the current user's documents.
"""
def GetExecutablePath(self):
"""
GetExecutablePath() -> String
Return the directory and the filename for the current executable.
"""
def GetInstallPrefix(self):
"""
GetInstallPrefix() -> String
Return the program installation prefix, e.g. /usr, /opt or
/home/zeitlin.
"""
def GetLocalDataDir(self):
"""
GetLocalDataDir() -> String
Return the location for application data files which are host-specific
and can't, or shouldn't, be shared with the other machines.
"""
def GetLocalizedResourcesDir(self, lang, category=ResourceCat_None):
"""
GetLocalizedResourcesDir(lang, category=ResourceCat_None) -> String
Return the localized resources directory containing the resource files
of the specified category for the given language.
"""
def GetPluginsDir(self):
"""
GetPluginsDir() -> String
Return the directory where the loadable modules (plugins) live.
"""
def GetResourcesDir(self):
"""
GetResourcesDir() -> String
Return the directory where the application resource files are located.
"""
def GetTempDir(self):
"""
GetTempDir() -> String
Return the directory for storing temporary files.
"""
def GetUserConfigDir(self):
"""
GetUserConfigDir() -> String
Return the directory for the user config files:
"""
def GetUserDataDir(self):
"""
GetUserDataDir() -> String
Return the directory for the user-dependent application data files:
"""
def GetUserLocalDataDir(self):
"""
GetUserLocalDataDir() -> String
Return the directory for user data files which shouldn't be shared
with the other machines.
"""
def SetInstallPrefix(self, prefix):
"""
SetInstallPrefix(prefix)
Lets wxStandardPaths know about the real program installation prefix
on a Unix system.
"""
def UseAppInfo(self, info):
"""
UseAppInfo(info)
Controls what application information is used when constructing paths
that should be unique to this program, such as the application data
directory, the plugins directory on Unix, etc.
"""
@staticmethod
def Get():
"""
Get() -> StandardPaths
Returns reference to the unique global standard paths object.
"""
@staticmethod
def MSWGetShellDir(csidl):
"""
MSWGetShellDir(csidl) -> String
Returns location of Windows shell special folder.
"""
AppDocumentsDir = property(None, None)
ConfigDir = property(None, None)
DataDir = property(None, None)
DocumentsDir = property(None, None)
ExecutablePath = property(None, None)
InstallPrefix = property(None, None)
LocalDataDir = property(None, None)
PluginsDir = property(None, None)
ResourcesDir = property(None, None)
TempDir = property(None, None)
UserConfigDir = property(None, None)
UserDataDir = property(None, None)
UserLocalDataDir = property(None, None)
def wxStandardPaths(self):
"""
"""
# end of class StandardPaths
#-- end-stdpaths --#
#-- begin-eventfilter --#
class EventFilter(object):
"""
EventFilter()
A global event filter for pre-processing all the events generated in
the program.
"""
Event_Skip = 0
Event_Ignore = 0
Event_Processed = 0
def __init__(self):
"""
EventFilter()
A global event filter for pre-processing all the events generated in
the program.
"""
def FilterEvent(self, event):
"""
FilterEvent(event) -> int
Override this method to implement event pre-processing.
"""
# end of class EventFilter
#-- end-eventfilter --#
#-- begin-evtloop --#
class EventLoopBase(object):
"""
Base class for all event loop implementations.
"""
def Run(self):
"""
Run() -> int
Start the event loop, return the exit code when it is finished.
"""
def IsRunning(self):
"""
IsRunning() -> bool
Return true if this event loop is currently running.
"""
def IsOk(self):
"""
IsOk() -> bool
Use this to check whether the event loop was successfully created
before using it.
"""
def Exit(self, rc=0):
"""
Exit(rc=0)
Exit the currently running loop with the given exit code.
"""
def ScheduleExit(self, rc=0):
"""
ScheduleExit(rc=0)
Schedule an exit from the loop with the given exit code.
"""
def Pending(self):
"""
Pending() -> bool
Return true if any events are available.
"""
def Dispatch(self):
"""
Dispatch() -> bool
Dispatches the next event in the windowing system event queue.
"""
def DispatchTimeout(self, timeout):
"""
DispatchTimeout(timeout) -> int
Dispatch an event but not wait longer than the specified timeout for
it.
"""
def WakeUp(self):
"""
WakeUp()
Called by wxWidgets to wake up the event loop even if it is currently
blocked inside Dispatch().
"""
def WakeUpIdle(self):
"""
WakeUpIdle()
Makes sure that idle events are sent again.
"""
def ProcessIdle(self):
"""
ProcessIdle() -> bool
This virtual function is called when the application becomes idle and
normally just sends wxIdleEvent to all interested parties.
"""
def IsYielding(self):
"""
IsYielding() -> bool
Returns true if called from inside Yield() or from inside YieldFor().
"""
def Yield(self, onlyIfNeeded=False):
"""
Yield(onlyIfNeeded=False) -> bool
Yields control to pending messages in the windowing system.
"""
def YieldFor(self, eventsToProcess):
"""
YieldFor(eventsToProcess) -> bool
Works like Yield() with onlyIfNeeded == true, except that it allows
the caller to specify a mask of the wxEventCategory values which
indicates which events should be processed and which should instead be
"delayed" (i.e.
"""
def IsEventAllowedInsideYield(self, cat):
"""
IsEventAllowedInsideYield(cat) -> bool
Returns true if the given event category is allowed inside a
YieldFor() call (i.e.
"""
@staticmethod
def GetActive():
"""
GetActive() -> EventLoopBase
Return the currently active (running) event loop.
"""
@staticmethod
def SetActive(loop):
"""
SetActive(loop)
Set currently active (running) event loop.
"""
def IsMain(self):
"""
IsMain() -> bool
Returns true if this is the main loop executed by wxApp::OnRun().
"""
def OnExit(self):
"""
OnExit()
This function is called before the event loop terminates, whether this
happens normally (because of Exit() call) or abnormally (because of an
exception thrown from inside the loop).
"""
# end of class EventLoopBase
class EventLoopActivator(object):
"""
EventLoopActivator(loop)
Makes an event loop temporarily active.
"""
def __init__(self, loop):
"""
EventLoopActivator(loop)
Makes an event loop temporarily active.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
# end of class EventLoopActivator
class GUIEventLoop(EventLoopBase):
"""
GUIEventLoop()
A generic implementation of the GUI event loop.
"""
def __init__(self):
"""
GUIEventLoop()
A generic implementation of the GUI event loop.
"""
# end of class GUIEventLoop
@wx.deprecatedMsg('Use GUIEventLoop instead.')
class EventLoop(GUIEventLoop):
'''A class using the old name for compatibility.'''
def __init__(self):
GUIEventLoop.__init__(self)
#-- end-evtloop --#
#-- begin-apptrait --#
class AppTraits(object):
"""
The wxAppTraits class defines various configurable aspects of a wxApp.
"""
def CreateConfig(self):
"""
CreateConfig() -> ConfigBase
Called by wxWidgets to create the default configuration object for the
application.
"""
def CreateEventLoop(self):
"""
CreateEventLoop() -> EventLoopBase
Used by wxWidgets to create the main event loop used by
wxApp::OnRun().
"""
def CreateLogTarget(self):
"""
CreateLogTarget() -> Log
Creates a wxLog class for the application to use for logging errors.
"""
def GetDesktopEnvironment(self):
"""
GetDesktopEnvironment() -> String
This method returns the name of the desktop environment currently
running in a Unix desktop.
"""
def GetStandardPaths(self):
"""
GetStandardPaths() -> StandardPaths
Returns the wxStandardPaths object for the application.
"""
def GetToolkitVersion(self, major=None, minor=None):
"""
GetToolkitVersion(major=None, minor=None) -> PortId
Returns the wxWidgets port ID used by the running program and
eventually fills the given pointers with the values of the major and
minor digits of the native toolkit currently used.
"""
def HasStderr(self):
"""
HasStderr() -> bool
Returns true if fprintf(stderr) goes somewhere, false otherwise.
"""
def IsUsingUniversalWidgets(self):
"""
IsUsingUniversalWidgets() -> bool
Returns true if the library was built as wxUniversal.
"""
def ShowAssertDialog(self, msg):
"""
ShowAssertDialog(msg) -> bool
Shows the assert dialog with the specified message in GUI mode or just
prints the string to stderr in console mode.
"""
DesktopEnvironment = property(None, None)
StandardPaths = property(None, None)
ToolkitVersion = property(None, None)
# end of class AppTraits
#-- end-apptrait --#
#-- begin-app --#
class AppConsole(EvtHandler, EventFilter):
"""
This class is essential for writing console-only or hybrid apps
without having to define wxUSE_GUI=0.
"""
def MainLoop(self):
"""
MainLoop() -> int
Called by wxWidgets on creation of the application.
"""
def ExitMainLoop(self):
"""
ExitMainLoop()
Call this to explicitly exit the main message (event) loop.
"""
def FilterEvent(self, event):
"""
FilterEvent(event) -> int
Overridden wxEventFilter method.
"""
def GetMainLoop(self):
"""
GetMainLoop() -> EventLoopBase
Returns the main event loop instance, i.e. the event loop which is
started by OnRun() and which dispatches all events sent from the
native toolkit to the application (except when new event loops are
temporarily set-up).
"""
def ProcessPendingEvents(self):
"""
ProcessPendingEvents()
Process all pending events; it is necessary to call this function to
process events posted with wxEvtHandler::QueueEvent or
wxEvtHandler::AddPendingEvent.
"""
def DeletePendingEvents(self):
"""
DeletePendingEvents()
Deletes the pending events of all wxEvtHandlers of this application.
"""
def HasPendingEvents(self):
"""
HasPendingEvents() -> bool
Returns true if there are pending events on the internal pending event
list.
"""
def SuspendProcessingOfPendingEvents(self):
"""
SuspendProcessingOfPendingEvents()
Temporary suspends processing of the pending events.
"""
def ResumeProcessingOfPendingEvents(self):
"""
ResumeProcessingOfPendingEvents()
Resume processing of the pending events previously stopped because of
a call to SuspendProcessingOfPendingEvents().
"""
def ScheduleForDestruction(self, object):
"""
ScheduleForDestruction(object)
Delayed objects destruction.
"""
def IsScheduledForDestruction(self, object):
"""
IsScheduledForDestruction(object) -> bool
Check if the object had been scheduled for destruction with
ScheduleForDestruction().
"""
def OnEventLoopEnter(self, loop):
"""
OnEventLoopEnter(loop)
Called by wxEventLoopBase::SetActive(): you can override this function
and put here the code which needs an active event loop.
"""
def OnEventLoopExit(self, loop):
"""
OnEventLoopExit(loop)
Called by wxEventLoopBase::OnExit() for each event loop which is
exited.
"""
def OnExit(self):
"""
OnExit() -> int
Override this member function for any processing which needs to be
done as the application is about to exit.
"""
def OnInit(self):
"""
OnInit() -> bool
This must be provided by the application, and will usually create the
application's main window, optionally calling SetTopWindow().
"""
def OnRun(self):
"""
OnRun() -> int
This virtual function is where the execution of a program written in
wxWidgets starts.
"""
def GetAppDisplayName(self):
"""
GetAppDisplayName() -> String
Returns the user-readable application name.
"""
def GetAppName(self):
"""
GetAppName() -> String
Returns the application name.
"""
def GetClassName(self):
"""
GetClassName() -> String
Gets the class name of the application.
"""
def GetTraits(self):
"""
GetTraits() -> AppTraits
Returns a pointer to the wxAppTraits object for the application.
"""
def GetVendorDisplayName(self):
"""
GetVendorDisplayName() -> String
Returns the user-readable vendor name.
"""
def GetVendorName(self):
"""
GetVendorName() -> String
Returns the application's vendor name.
"""
def SetAppDisplayName(self, name):
"""
SetAppDisplayName(name)
Set the application name to be used in the user-visible places such as
window titles.
"""
def SetAppName(self, name):
"""
SetAppName(name)
Sets the name of the application.
"""
def SetClassName(self, name):
"""
SetClassName(name)
Sets the class name of the application.
"""
def SetVendorDisplayName(self, name):
"""
SetVendorDisplayName(name)
Set the vendor name to be used in the user-visible places.
"""
def SetVendorName(self, name):
"""
SetVendorName(name)
Sets the name of application's vendor.
"""
def Yield(self, onlyIfNeeded=False):
"""
Yield(onlyIfNeeded=False) -> bool
"""
def SetCLocale(self):
"""
SetCLocale()
Sets the C locale to the default locale for the current environment.
"""
@staticmethod
def SetInstance(app):
"""
SetInstance(app)
Allows external code to modify global wxTheApp, but you should really
know what you're doing if you call it.
"""
@staticmethod
def GetInstance():
"""
GetInstance() -> AppConsole
Returns the one and only global application object.
"""
@staticmethod
def IsMainLoopRunning():
"""
IsMainLoopRunning() -> bool
Returns true if the main event loop is currently running, i.e. if the
application is inside OnRun().
"""
AppDisplayName = property(None, None)
AppName = property(None, None)
ClassName = property(None, None)
VendorDisplayName = property(None, None)
VendorName = property(None, None)
Traits = property(None, None)
# end of class AppConsole
APP_ASSERT_SUPPRESS = 0
APP_ASSERT_EXCEPTION = 0
APP_ASSERT_DIALOG = 0
APP_ASSERT_LOG = 0
class PyApp(AppConsole):
"""
PyApp()
The wxApp class represents the application itself when wxUSE_GUI=1.
"""
def __init__(self):
"""
PyApp()
The wxApp class represents the application itself when wxUSE_GUI=1.
"""
def MacNewFile(self):
"""
MacNewFile()
Called in response of an "open-application" Apple event.
"""
def MacOpenFiles(self, fileNames):
"""
MacOpenFiles(fileNames)
Called in response of an openFiles message with Cocoa, or an "open-
document" Apple event with Carbon.
"""
def MacOpenFile(self, fileName):
"""
MacOpenFile(fileName)
Called in response of an "open-document" Apple event.
"""
def MacOpenURL(self, url):
"""
MacOpenURL(url)
Called in response of a "get-url" Apple event.
"""
def MacPrintFile(self, fileName):
"""
MacPrintFile(fileName)
Called in response of a "print-document" Apple event.
"""
def MacReopenApp(self):
"""
MacReopenApp()
Called in response of a "reopen-application" Apple event.
"""
def OSXIsGUIApplication(self):
"""
OSXIsGUIApplication() -> bool
May be overridden to indicate that the application is not a foreground
GUI application under OS X.
"""
def GetDisplayMode(self):
"""
GetDisplayMode() -> VideoMode
Get display mode that is used use.
"""
def GetExitOnFrameDelete(self):
"""
GetExitOnFrameDelete() -> bool
Returns true if the application will exit when the top-level frame is
deleted.
"""
def GetLayoutDirection(self):
"""
GetLayoutDirection() -> LayoutDirection
Return the layout direction for the current locale or wxLayout_Default
if it's unknown.
"""
def GetUseBestVisual(self):
"""
GetUseBestVisual() -> bool
Returns true if the application will use the best visual on systems
that support different visuals, false otherwise.
"""
def GetTopWindow(self):
"""
GetTopWindow() -> Window
Returns a pointer to the top window.
"""
def IsActive(self):
"""
IsActive() -> bool
Returns true if the application is active, i.e. if one of its windows
is currently in the foreground.
"""
def SafeYield(self, win, onlyIfNeeded):
"""
SafeYield(win, onlyIfNeeded) -> bool
This function is similar to wxYield(), except that it disables the
user input to all program windows before calling wxAppConsole::Yield
and re-enables it again afterwards.
"""
def SafeYieldFor(self, win, eventsToProcess):
"""
SafeYieldFor(win, eventsToProcess) -> bool
Works like SafeYield() with onlyIfNeeded == true except that it allows
the caller to specify a mask of events to be processed.
"""
def SetDisplayMode(self, info):
"""
SetDisplayMode(info) -> bool
Set display mode to use.
"""
def SetExitOnFrameDelete(self, flag):
"""
SetExitOnFrameDelete(flag)
Allows the programmer to specify whether the application will exit
when the top-level frame is deleted.
"""
def SetNativeTheme(self, theme):
"""
SetNativeTheme(theme) -> bool
Allows runtime switching of the UI environment theme.
"""
def SetTopWindow(self, window):
"""
SetTopWindow(window)
Sets the 'top' window.
"""
def SetUseBestVisual(self, flag, forceTrueColour=False):
"""
SetUseBestVisual(flag, forceTrueColour=False)
Allows the programmer to specify whether the application will use the
best visual on systems that support several visual on the same
display.
"""
def MacHideApp(self):
"""
MacHideApp()
Hide all application windows just as the user can do with the
system Hide command. Mac only.
"""
@staticmethod
def GetComCtl32Version():
"""
GetComCtl32Version() -> int
Returns 400, 470, 471, etc. for comctl32.dll 4.00, 4.70, 4.71 or 0 if
it wasn't found at all. Raises an exception on non-Windows platforms.
"""
@staticmethod
def GetShell32Version():
"""
GetShell32Version() -> int
Returns 400, 470, 471, etc. for shell32.dll 4.00, 4.70, 4.71 or 0 if
it wasn't found at all. Raises an exception on non-Windows platforms.
"""
def GetAssertMode(self):
"""
GetAssertMode() -> AppAssertMode
Returns the current mode for how the application responds to wx
asserts.
"""
def SetAssertMode(self, AppAssertMode):
"""
SetAssertMode(AppAssertMode)
Set the mode indicating how the application responds to wx assertion
statements. Valid settings are a combination of these flags:
- wx.APP_ASSERT_SUPPRESS
- wx.APP_ASSERT_EXCEPTION
- wx.APP_ASSERT_DIALOG
- wx.APP_ASSERT_LOG
The default behavior is to raise a wx.wxAssertionError exception.
"""
@staticmethod
def IsDisplayAvailable():
"""
IsDisplayAvailable() -> bool
Returns True if the application is able to connect to the system's
display, or whatever the equivallent is for the platform.
"""
AssertMode = property(None, None)
DisplayMode = property(None, None)
ExitOnFrameDelete = property(None, None)
LayoutDirection = property(None, None)
UseBestVisual = property(None, None)
TopWindow = property(None, None)
# end of class PyApp
def GetApp():
"""
GetApp() -> PyApp
Returns the current application object.
"""
def HandleFatalExceptions(doIt=True):
"""
HandleFatalExceptions(doIt=True) -> bool
If doIt is true, the fatal exceptions (also known as general
protection faults under Windows or segmentation violations in the Unix
world) will be caught and passed to wxApp::OnFatalException.
"""
def WakeUpIdle():
"""
WakeUpIdle()
This function wakes up the (internal and platform dependent) idle
system, i.e.
"""
def Yield():
"""
Yield() -> bool
Calls wxAppConsole::Yield.
"""
def SafeYield(win=None, onlyIfNeeded=False):
"""
SafeYield(win=None, onlyIfNeeded=False) -> bool
Calls wxApp::SafeYield.
"""
def Exit():
"""
Exit()
Exits application after calling wxApp::OnExit.
"""
class PyOnDemandOutputWindow(object):
"""
A class that can be used for redirecting Python's stdout and
stderr streams. It will do nothing until something is wrriten to
the stream at which point it will create a Frame with a text area
and write the text there.
"""
def __init__(self, title="wxPython: stdout/stderr"):
pass
def SetParent(self, parent):
"""
Set the window to be used as the popup Frame's parent.
"""
pass
def CreateOutputWindow(self, txt):
pass
def OnCloseWindow(self, event):
pass
def write(self, text):
"""
Create the output window if needed and write the string to it.
If not called in the context of the gui thread then CallAfter is
used to do the work there.
"""
pass
def close(self):
pass
def flush(self):
pass
class App(PyApp):
"""
The ``wx.App`` class represents the application and is used to:
* bootstrap the wxPython system and initialize the underlying
gui toolkit
* set and get application-wide properties
* implement the native windowing system main message or event loop,
and to dispatch events to window instances
* etc.
Every wx application must have a single ``wx.App`` instance, and all
creation of UI objects should be delayed until after the ``wx.App`` object
has been created in order to ensure that the gui platform and wxWidgets
have been fully initialized.
Normally you would derive from this class and implement an ``OnInit``
method that creates a frame and then calls ``self.SetTopWindow(frame)``,
however ``wx.App`` is also usable on it's own without derivation.
"""
outputWindowClass = PyOnDemandOutputWindow
def __init__(self, redirect=False, filename=None, useBestVisual=False, clearSigInt=True):
"""
Construct a ``wx.App`` object.
:param redirect: Should ``sys.stdout`` and ``sys.stderr`` be
redirected? Defaults to False. 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 class of your choosing.)
:param filename: The name of a file to redirect output to, if
redirect is True.
:param useBestVisual: Should the app try to use the best
available visual provided by the system (only relevant on
systems that have more than one visual.) This parameter
must be used instead of calling `SetUseBestVisual` later
on because it must be set before the underlying GUI
toolkit is initialized.
:param clearSigInt: Should SIGINT be cleared? This allows the
app to terminate upon a Ctrl-C in the console like other
GUI apps will.
:note: You should override OnInit to do application
initialization to ensure that the system, toolkit and
wxWidgets are fully initialized.
"""
pass
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. This can be overridden in derived classes, but be sure to call
this method from there.
"""
pass
def __del__(self):
pass
def SetTopWindow(self, frame):
"""
Set the "main" top level window, which will be used for the parent of
the on-demand output window as well as for dialogs that do not have
an explicit parent set.
"""
pass
def MainLoop(self):
"""
Execute the main GUI event loop
"""
pass
def RedirectStdio(self, filename=None):
"""
Redirect sys.stdout and sys.stderr to a file or a popup window.
"""
pass
def RestoreStdio(self):
pass
def SetOutputWindowAttributes(self, title=None, pos=None, size=None):
"""
Set the title, position and/or size of the output window if the stdio
has been redirected. This should be called before any output would
cause the output window to be created.
"""
pass
@staticmethod
def Get():
"""
A staticmethod returning the currently active application object.
Essentially just a more pythonic version of :meth:`GetApp`.
"""
pass
@wx.deprecated
class PySimpleApp(App):
"""
This class is deprecated. Please use :class:`App` instead.
"""
def __init__(self, *args, **kw):
pass
#-- end-app --#
#-- begin-timer --#
TIMER_CONTINUOUS = 0
TIMER_ONE_SHOT = 0
wxEVT_TIMER = 0
class Timer(EvtHandler):
"""
Timer()
Timer(owner, id=-1)
The wxTimer class allows you to execute code at specified intervals.
"""
def __init__(self, *args, **kw):
"""
Timer()
Timer(owner, id=-1)
The wxTimer class allows you to execute code at specified intervals.
"""
def GetId(self):
"""
GetId() -> int
Returns the ID of the events generated by this timer.
"""
def GetInterval(self):
"""
GetInterval() -> int
Returns the current interval for the timer (in milliseconds).
"""
def GetOwner(self):
"""
GetOwner() -> EvtHandler
Returns the current owner of the timer.
"""
def IsOneShot(self):
"""
IsOneShot() -> bool
Returns true if the timer is one shot, i.e. if it will stop after
firing the first notification automatically.
"""
def IsRunning(self):
"""
IsRunning() -> bool
Returns true if the timer is running, false if it is stopped.
"""
def Notify(self):
"""
Notify()
This member should be overridden by the user if the default
constructor was used and SetOwner() wasn't called.
"""
def SetOwner(self, owner, id=-1):
"""
SetOwner(owner, id=-1)
Associates the timer with the given owner object.
"""
def Start(self, milliseconds=-1, oneShot=TIMER_CONTINUOUS):
"""
Start(milliseconds=-1, oneShot=TIMER_CONTINUOUS) -> bool
(Re)starts the timer.
"""
def StartOnce(self, milliseconds=-1):
"""
StartOnce(milliseconds=-1) -> bool
Starts the timer for a once-only notification.
"""
def Stop(self):
"""
Stop()
Stops the timer.
"""
Id = property(None, None)
Interval = property(None, None)
Owner = property(None, None)
# end of class Timer
class TimerRunner(object):
"""
TimerRunner(timer)
TimerRunner(timer, milli, oneShot=False)
Starts the timer in its ctor, stops in the dtor.
"""
def __init__(self, *args, **kw):
"""
TimerRunner(timer)
TimerRunner(timer, milli, oneShot=False)
Starts the timer in its ctor, stops in the dtor.
"""
def Start(self, milli, oneShot=False):
"""
Start(milli, oneShot=False)
"""
# end of class TimerRunner
class TimerEvent(Event):
"""
TimerEvent()
TimerEvent(timer)
wxTimerEvent object is passed to the event handler of timer events
(see wxTimer::SetOwner).
"""
def __init__(self, *args, **kw):
"""
TimerEvent()
TimerEvent(timer)
wxTimerEvent object is passed to the event handler of timer events
(see wxTimer::SetOwner).
"""
def GetInterval(self):
"""
GetInterval() -> int
Returns the interval of the timer which generated this event.
"""
def GetTimer(self):
"""
GetTimer() -> Timer
Returns the timer object which generated this event.
"""
Interval = property(None, None)
Timer = property(None, None)
# end of class TimerEvent
EVT_TIMER = wx.PyEventBinder( wxEVT_TIMER )
class PyTimer(Timer):
'''This timer class is passed the callable object to be called when the timer expires.'''
def __init__(self, notify):
Timer.__init__(self)
self.notify = notify
def Notify(self):
if self.notify:
self.notify()
#-- end-timer --#
#-- begin-window --#
SHOW_EFFECT_NONE = 0
SHOW_EFFECT_ROLL_TO_LEFT = 0
SHOW_EFFECT_ROLL_TO_RIGHT = 0
SHOW_EFFECT_ROLL_TO_TOP = 0
SHOW_EFFECT_ROLL_TO_BOTTOM = 0
SHOW_EFFECT_SLIDE_TO_LEFT = 0
SHOW_EFFECT_SLIDE_TO_RIGHT = 0
SHOW_EFFECT_SLIDE_TO_TOP = 0
SHOW_EFFECT_SLIDE_TO_BOTTOM = 0
SHOW_EFFECT_BLEND = 0
SHOW_EFFECT_EXPAND = 0
SHOW_EFFECT_MAX = 0
SEND_EVENT_POST = 0
WINDOW_VARIANT_NORMAL = 0
WINDOW_VARIANT_SMALL = 0
WINDOW_VARIANT_MINI = 0
WINDOW_VARIANT_LARGE = 0
WINDOW_VARIANT_MAX = 0
class VisualAttributes(object):
"""
Struct containing all the visual attributes of a control.
"""
font = property(None, None)
colFg = property(None, None)
colBg = property(None, None)
# end of class VisualAttributes
PanelNameStr = ""
class WindowBase(EvtHandler):
"""
"""
def AddChild(self, child):
"""
AddChild(child)
"""
def RemoveChild(self, child):
"""
RemoveChild(child)
"""
# end of class WindowBase
class Window(WindowBase):
"""
Window()
Window(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
wxWindow is the base class for all windows and represents any visible
object on screen.
"""
class ChildrenRepositioningGuard(object):
"""
ChildrenRepositioningGuard(win)
Helper for ensuring EndRepositioningChildren() is called correctly.
"""
def __init__(self, win):
"""
ChildrenRepositioningGuard(win)
Helper for ensuring EndRepositioningChildren() is called correctly.
"""
# end of class ChildrenRepositioningGuard
def __init__(self, *args, **kw):
"""
Window()
Window(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
wxWindow is the base class for all windows and represents any visible
object on screen.
"""
def AcceptsFocus(self):
"""
AcceptsFocus() -> bool
This method may be overridden in the derived classes to return false
to indicate that this control doesn't accept input at all (i.e.
behaves like e.g. wxStaticText) and so doesn't need focus.
"""
def AcceptsFocusFromKeyboard(self):
"""
AcceptsFocusFromKeyboard() -> bool
This method may be overridden in the derived classes to return false
to indicate that while this control can, in principle, have focus if
the user clicks it with the mouse, it shouldn't be included in the TAB
traversal chain when using the keyboard.
"""
def AcceptsFocusRecursively(self):
"""
AcceptsFocusRecursively() -> bool
Overridden to indicate whether this window or one of its children
accepts focus.
"""
def IsFocusable(self):
"""
IsFocusable() -> bool
Can this window itself have focus?
"""
def CanAcceptFocus(self):
"""
CanAcceptFocus() -> bool
Can this window have focus right now?
"""
def CanAcceptFocusFromKeyboard(self):
"""
CanAcceptFocusFromKeyboard() -> bool
Can this window be assigned focus from keyboard right now?
"""
def HasFocus(self):
"""
HasFocus() -> bool
Returns true if the window (or in case of composite controls, its main
child window) has focus.
"""
def SetCanFocus(self, canFocus):
"""
SetCanFocus(canFocus)
This method is only implemented by ports which have support for native
TAB traversal (such as GTK+ 2.0).
"""
def SetFocus(self):
"""
SetFocus()
This sets the window to receive keyboard input.
"""
def SetFocusFromKbd(self):
"""
SetFocusFromKbd()
This function is called by wxWidgets keyboard navigation code when the
user gives the focus to this window from keyboard (e.g.
"""
def AddChild(self, child):
"""
AddChild(child)
Adds a child window.
"""
def DestroyChildren(self):
"""
DestroyChildren() -> bool
Destroys all children of a window.
"""
def FindWindow(self, *args, **kw):
"""
FindWindow(id) -> Window
FindWindow(name) -> Window
Find a child of this window, by id.
"""
def GetChildren(self):
"""
GetChildren() -> WindowList
Returns a reference to the list of the window's children.
"""
def RemoveChild(self, child):
"""
RemoveChild(child)
Removes a child window.
"""
def GetGrandParent(self):
"""
GetGrandParent() -> Window
Returns the grandparent of a window, or NULL if there isn't one.
"""
def GetNextSibling(self):
"""
GetNextSibling() -> Window
Returns the next window after this one among the parent's children or
NULL if this window is the last child.
"""
def GetParent(self):
"""
GetParent() -> Window
Returns the parent of the window, or NULL if there is no parent.
"""
def GetPrevSibling(self):
"""
GetPrevSibling() -> Window
Returns the previous window before this one among the parent's
children or NULL if this window is the first child.
"""
def IsDescendant(self, win):
"""
IsDescendant(win) -> bool
Check if the specified window is a descendant of this one.
"""
def Reparent(self, newParent):
"""
Reparent(newParent) -> bool
Reparents the window, i.e. the window will be removed from its current
parent window (e.g.
"""
def AlwaysShowScrollbars(self, hflag=True, vflag=True):
"""
AlwaysShowScrollbars(hflag=True, vflag=True)
Call this function to force one or both scrollbars to be always shown,
even if the window is big enough to show its entire contents without
scrolling.
"""
def GetScrollPos(self, orientation):
"""
GetScrollPos(orientation) -> int
Returns the built-in scrollbar position.
"""
def GetScrollRange(self, orientation):
"""
GetScrollRange(orientation) -> int
Returns the built-in scrollbar range.
"""
def GetScrollThumb(self, orientation):
"""
GetScrollThumb(orientation) -> int
Returns the built-in scrollbar thumb size.
"""
def CanScroll(self, orient):
"""
CanScroll(orient) -> bool
Returns true if this window can have a scroll bar in this orientation.
"""
def HasScrollbar(self, orient):
"""
HasScrollbar(orient) -> bool
Returns true if this window currently has a scroll bar for this
orientation.
"""
def IsScrollbarAlwaysShown(self, orient):
"""
IsScrollbarAlwaysShown(orient) -> bool
Return whether a scrollbar is always shown.
"""
def ScrollLines(self, lines):
"""
ScrollLines(lines) -> bool
Scrolls the window by the given number of lines down (if lines is
positive) or up.
"""
def ScrollPages(self, pages):
"""
ScrollPages(pages) -> bool
Scrolls the window by the given number of pages down (if pages is
positive) or up.
"""
def ScrollWindow(self, dx, dy, rect=None):
"""
ScrollWindow(dx, dy, rect=None)
Physically scrolls the pixels in the window and move child windows
accordingly.
"""
def LineUp(self):
"""
LineUp() -> bool
Same as ScrollLines (-1).
"""
def LineDown(self):
"""
LineDown() -> bool
Same as ScrollLines (1).
"""
def PageUp(self):
"""
PageUp() -> bool
Same as ScrollPages (-1).
"""
def PageDown(self):
"""
PageDown() -> bool
Same as ScrollPages (1).
"""
def SetScrollPos(self, orientation, pos, refresh=True):
"""
SetScrollPos(orientation, pos, refresh=True)
Sets the position of one of the built-in scrollbars.
"""
def SetScrollbar(self, orientation, position, thumbSize, range, refresh=True):
"""
SetScrollbar(orientation, position, thumbSize, range, refresh=True)
Sets the scrollbar properties of a built-in scrollbar.
"""
def BeginRepositioningChildren(self):
"""
BeginRepositioningChildren() -> bool
Prepare for changing positions of multiple child windows.
"""
def EndRepositioningChildren(self):
"""
EndRepositioningChildren()
Fix child window positions after setting all of them at once.
"""
def CacheBestSize(self, size):
"""
CacheBestSize(size)
Sets the cached best size value.
"""
def ClientToWindowSize(self, size):
"""
ClientToWindowSize(size) -> Size
Converts client area size size to corresponding window size.
"""
def WindowToClientSize(self, size):
"""
WindowToClientSize(size) -> Size
Converts window size size to corresponding client area size In other
words, the returned value is what would GetClientSize() return if this
window had given window size.
"""
def Fit(self):
"""
Fit()
Sizes the window so that it fits around its subwindows.
"""
def FitInside(self):
"""
FitInside()
Similar to Fit(), but sizes the interior (virtual) size of a window.
"""
def GetBestSize(self):
"""
GetBestSize() -> Size
This functions returns the best acceptable minimal size for the
window.
"""
def GetBestHeight(self, width):
"""
GetBestHeight(width) -> int
Returns the best height needed by this window if it had the given
width.
"""
def GetBestWidth(self, height):
"""
GetBestWidth(height) -> int
Returns the best width needed by this window if it had the given
height.
"""
def GetClientSize(self, *args, **kw):
"""
GetClientSize() -> Size
Returns the size of the window 'client area' in pixels.
"""
def GetEffectiveMinSize(self):
"""
GetEffectiveMinSize() -> Size
Merges the window's best size into the min size and returns the
result.
"""
def GetMaxClientSize(self):
"""
GetMaxClientSize() -> Size
Returns the maximum size of window's client area.
"""
def GetMaxSize(self):
"""
GetMaxSize() -> Size
Returns the maximum size of the window.
"""
def GetMinClientSize(self):
"""
GetMinClientSize() -> Size
Returns the minimum size of window's client area, an indication to the
sizer layout mechanism that this is the minimum required size of its
client area.
"""
def GetMinSize(self):
"""
GetMinSize() -> Size
Returns the minimum size of the window, an indication to the sizer
layout mechanism that this is the minimum required size.
"""
def GetMinWidth(self):
"""
GetMinWidth() -> int
Returns the horizontal component of window minimal size.
"""
def GetMinHeight(self):
"""
GetMinHeight() -> int
Returns the vertical component of window minimal size.
"""
def GetMaxWidth(self):
"""
GetMaxWidth() -> int
Returns the horizontal component of window maximal size.
"""
def GetMaxHeight(self):
"""
GetMaxHeight() -> int
Returns the vertical component of window maximal size.
"""
def GetSize(self, *args, **kw):
"""
GetSize() -> Size
Returns the size of the entire window in pixels, including title bar,
border, scrollbars, etc.
"""
def GetVirtualSize(self, *args, **kw):
"""
GetVirtualSize() -> Size
This gets the virtual size of the window in pixels.
"""
def GetBestVirtualSize(self):
"""
GetBestVirtualSize() -> Size
Return the largest of ClientSize and BestSize (as determined by a
sizer, interior children, or other means)
"""
def GetContentScaleFactor(self):
"""
GetContentScaleFactor() -> double
Returns the magnification of the backing store of this window, eg 2.0
for a window on a retina screen.
"""
def GetWindowBorderSize(self):
"""
GetWindowBorderSize() -> Size
Returns the size of the left/right and top/bottom borders of this
window in x and y components of the result respectively.
"""
def InformFirstDirection(self, direction, size, availableOtherDir):
"""
InformFirstDirection(direction, size, availableOtherDir) -> bool
wxSizer and friends use this to give a chance to a component to recalc
its min size once one of the final size components is known.
"""
def InvalidateBestSize(self):
"""
InvalidateBestSize()
Resets the cached best size value so it will be recalculated the next
time it is needed.
"""
def PostSizeEvent(self):
"""
PostSizeEvent()
Posts a size event to the window.
"""
def PostSizeEventToParent(self):
"""
PostSizeEventToParent()
Posts a size event to the parent of this window.
"""
def SendSizeEvent(self, flags=0):
"""
SendSizeEvent(flags=0)
This function sends a dummy size event to the window allowing it to
re-layout its children positions.
"""
def SendSizeEventToParent(self, flags=0):
"""
SendSizeEventToParent(flags=0)
Safe wrapper for GetParent()->SendSizeEvent().
"""
def SetClientSize(self, *args, **kw):
"""
SetClientSize(width, height)
SetClientSize(size)
SetClientSize(rect)
This sets the size of the window client area in pixels.
"""
def SetContainingSizer(self, sizer):
"""
SetContainingSizer(sizer)
This normally does not need to be called by user code.
"""
def SetInitialSize(self, size=DefaultSize):
"""
SetInitialSize(size=DefaultSize)
A smart SetSize that will fill in default size components with the
window's best size values.
"""
def SetMaxClientSize(self, size):
"""
SetMaxClientSize(size)
Sets the maximum client size of the window, to indicate to the sizer
layout mechanism that this is the maximum possible size of its client
area.
"""
def SetMaxSize(self, size):
"""
SetMaxSize(size)
Sets the maximum size of the window, to indicate to the sizer layout
mechanism that this is the maximum possible size.
"""
def SetMinClientSize(self, size):
"""
SetMinClientSize(size)
Sets the minimum client size of the window, to indicate to the sizer
layout mechanism that this is the minimum required size of window's
client area.
"""
def SetMinSize(self, size):
"""
SetMinSize(size)
Sets the minimum size of the window, to indicate to the sizer layout
mechanism that this is the minimum required size.
"""
def SetSize(self, *args, **kw):
"""
SetSize(x, y, width, height, sizeFlags=SIZE_AUTO)
SetSize(rect)
SetSize(size)
SetSize(width, height)
Sets the size of the window in pixels.
"""
def SetSizeHints(self, *args, **kw):
"""
SetSizeHints(minSize, maxSize=DefaultSize, incSize=DefaultSize)
SetSizeHints(minW, minH, maxW=-1, maxH=-1, incW=-1, incH=-1)
Use of this function for windows which are not toplevel windows (such
as wxDialog or wxFrame) is discouraged.
"""
def SetVirtualSize(self, *args, **kw):
"""
SetVirtualSize(width, height)
SetVirtualSize(size)
Sets the virtual size of the window in pixels.
"""
def Center(self, dir=BOTH):
"""
Center(dir=BOTH)
A synonym for Centre().
"""
def CenterOnParent(self, dir=BOTH):
"""
CenterOnParent(dir=BOTH)
A synonym for CentreOnParent().
"""
def Centre(self, direction=BOTH):
"""
Centre(direction=BOTH)
Centres the window.
"""
def CentreOnParent(self, direction=BOTH):
"""
CentreOnParent(direction=BOTH)
Centres the window on its parent.
"""
def GetPosition(self, *args, **kw):
"""
GetPosition() -> Point
This gets the position of the window in pixels, relative to the parent
window for the child windows or relative to the display origin for the
top level windows.
"""
def GetRect(self):
"""
GetRect() -> Rect
Returns the position and size of the window as a wxRect object.
"""
def GetScreenPosition(self, *args, **kw):
"""
GetScreenPosition() -> Point
Returns the window position in screen coordinates, whether the window
is a child window or a top level one.
"""
def GetScreenRect(self):
"""
GetScreenRect() -> Rect
Returns the position and size of the window on the screen as a wxRect
object.
"""
def GetClientAreaOrigin(self):
"""
GetClientAreaOrigin() -> Point
Get the origin of the client area of the window relative to the window
top left corner (the client area may be shifted because of the
borders, scrollbars, other decorations...)
"""
def GetClientRect(self):
"""
GetClientRect() -> Rect
Get the client rectangle in window (i.e. client) coordinates.
"""
def Move(self, *args, **kw):
"""
Move(x, y, flags=SIZE_USE_EXISTING)
Move(pt, flags=SIZE_USE_EXISTING)
Moves the window to the given position.
"""
def SetPosition(self, pt):
"""
SetPosition(pt)
A synonym for Centre().
"""
def ClientToScreen(self, *args, **kw):
"""
ClientToScreen(pt) -> Point
Converts to screen coordinates from coordinates relative to this
window.
"""
def ConvertDialogToPixels(self, *args, **kw):
"""
ConvertDialogToPixels(pt) -> Point
ConvertDialogToPixels(sz) -> Size
Converts a point or size from dialog units to pixels.
"""
def ConvertPixelsToDialog(self, *args, **kw):
"""
ConvertPixelsToDialog(pt) -> Point
ConvertPixelsToDialog(sz) -> Size
Converts a point or size from pixels to dialog units.
"""
def ScreenToClient(self, *args, **kw):
"""
ScreenToClient(pt) -> Point
Converts from screen to client window coordinates.
"""
def ClearBackground(self):
"""
ClearBackground()
Clears the window by filling it with the current background colour.
"""
def Freeze(self):
"""
Freeze()
Freezes the window or, in other words, prevents any updates from
taking place on screen, the window is not redrawn at all.
"""
def Thaw(self):
"""
Thaw()
Re-enables window updating after a previous call to Freeze().
"""
def IsFrozen(self):
"""
IsFrozen() -> bool
Returns true if the window is currently frozen by a call to Freeze().
"""
def GetBackgroundColour(self):
"""
GetBackgroundColour() -> Colour
Returns the background colour of the window.
"""
def GetBackgroundStyle(self):
"""
GetBackgroundStyle() -> BackgroundStyle
Returns the background style of the window.
"""
def GetCharHeight(self):
"""
GetCharHeight() -> int
Returns the character height for this window.
"""
def GetCharWidth(self):
"""
GetCharWidth() -> int
Returns the average character width for this window.
"""
def GetDefaultAttributes(self):
"""
GetDefaultAttributes() -> VisualAttributes
Currently this is the same as calling
wxWindow::GetClassDefaultAttributes(wxWindow::GetWindowVariant()).
"""
def GetFont(self):
"""
GetFont() -> Font
Returns the font for this window.
"""
def GetForegroundColour(self):
"""
GetForegroundColour() -> Colour
Returns the foreground colour of the window.
"""
def GetFullTextExtent(self, *args, **kw):
"""
GetFullTextExtent(string, font=None) -> (w, h, descent, externalLeading)
GetTextExtent(string) -> Size
Gets the dimensions of the string as it would be drawn on the window
with the currently selected font.
"""
def GetUpdateRegion(self):
"""
GetUpdateRegion() -> Region
Returns the region specifying which parts of the window have been
damaged.
"""
def GetUpdateClientRect(self):
"""
GetUpdateClientRect() -> Rect
Get the update rectangle bounding box in client coords.
"""
def HasTransparentBackground(self):
"""
HasTransparentBackground() -> bool
Returns true if this window background is transparent (as, for
example, for wxStaticText) and should show the parent window
background.
"""
def Refresh(self, eraseBackground=True, rect=None):
"""
Refresh(eraseBackground=True, rect=None)
Causes this window, and all of its children recursively (except under
wxGTK1 where this is not implemented), to be repainted.
"""
def RefreshRect(self, rect, eraseBackground=True):
"""
RefreshRect(rect, eraseBackground=True)
Redraws the contents of the given rectangle: only the area inside it
will be repainted.
"""
def Update(self):
"""
Update()
Calling this method immediately repaints the invalidated area of the
window and all of its children recursively (this normally only happens
when the flow of control returns to the event loop).
"""
def SetBackgroundColour(self, colour):
"""
SetBackgroundColour(colour) -> bool
Sets the background colour of the window.
"""
def SetBackgroundStyle(self, style):
"""
SetBackgroundStyle(style) -> bool
Sets the background style of the window.
"""
def IsTransparentBackgroundSupported(self, reason=None):
"""
IsTransparentBackgroundSupported(reason=None) -> bool
Checks whether using transparent background might work.
"""
def SetFont(self, font):
"""
SetFont(font) -> bool
Sets the font for this window.
"""
def SetForegroundColour(self, colour):
"""
SetForegroundColour(colour) -> bool
Sets the foreground colour of the window.
"""
def SetOwnBackgroundColour(self, colour):
"""
SetOwnBackgroundColour(colour)
Sets the background colour of the window but prevents it from being
inherited by the children of this window.
"""
def InheritsBackgroundColour(self):
"""
InheritsBackgroundColour() -> bool
Return true if this window inherits the background colour from its
parent.
"""
def UseBgCol(self):
"""
UseBgCol() -> bool
Return true if a background colour has been set for this window.
"""
def SetOwnFont(self, font):
"""
SetOwnFont(font)
Sets the font of the window but prevents it from being inherited by
the children of this window.
"""
def SetOwnForegroundColour(self, colour):
"""
SetOwnForegroundColour(colour)
Sets the foreground colour of the window but prevents it from being
inherited by the children of this window.
"""
def SetPalette(self, pal):
"""
SetPalette(pal)
"""
def ShouldInheritColours(self):
"""
ShouldInheritColours() -> bool
Return true from here to allow the colours of this window to be
changed by InheritAttributes().
"""
def SetThemeEnabled(self, enable):
"""
SetThemeEnabled(enable)
This function tells a window if it should use the system's "theme"
code to draw the windows' background instead of its own background
drawing code.
"""
def GetThemeEnabled(self):
"""
GetThemeEnabled() -> bool
Clears the window by filling it with the current background colour.
"""
def CanSetTransparent(self):
"""
CanSetTransparent() -> bool
Returns true if the system supports transparent windows and calling
SetTransparent() may succeed.
"""
def SetTransparent(self, alpha):
"""
SetTransparent(alpha) -> bool
Set the transparency of the window.
"""
def GetEventHandler(self):
"""
GetEventHandler() -> EvtHandler
Returns the event handler for this window.
"""
def HandleAsNavigationKey(self, event):
"""
HandleAsNavigationKey(event) -> bool
This function will generate the appropriate call to Navigate() if the
key event is one normally used for keyboard navigation and return true
in this case.
"""
def HandleWindowEvent(self, event):
"""
HandleWindowEvent(event) -> bool
Shorthand for:
"""
def ProcessWindowEvent(self, event):
"""
ProcessWindowEvent(event) -> bool
Convenient wrapper for ProcessEvent().
"""
def ProcessWindowEventLocally(self, event):
"""
ProcessWindowEventLocally(event) -> bool
Wrapper for wxEvtHandler::ProcessEventLocally().
"""
def PopEventHandler(self, deleteHandler=False):
"""
PopEventHandler(deleteHandler=False) -> EvtHandler
Removes and returns the top-most event handler on the event handler
stack.
"""
def PushEventHandler(self, handler):
"""
PushEventHandler(handler)
Pushes this event handler onto the event stack for the window.
"""
def RemoveEventHandler(self, handler):
"""
RemoveEventHandler(handler) -> bool
Find the given handler in the windows event handler stack and removes
(but does not delete) it from the stack.
"""
def SetEventHandler(self, handler):
"""
SetEventHandler(handler)
Sets the event handler for this window.
"""
def SetNextHandler(self, handler):
"""
SetNextHandler(handler)
wxWindows cannot be used to form event handler chains; this function
thus will assert when called.
"""
def SetPreviousHandler(self, handler):
"""
SetPreviousHandler(handler)
wxWindows cannot be used to form event handler chains; this function
thus will assert when called.
"""
def GetExtraStyle(self):
"""
GetExtraStyle() -> long
Returns the extra style bits for the window.
"""
def GetWindowStyleFlag(self):
"""
GetWindowStyleFlag() -> long
Gets the window style that was passed to the constructor or Create()
method.
"""
def GetWindowStyle(self):
"""
GetWindowStyle() -> long
See GetWindowStyleFlag() for more info.
"""
def HasExtraStyle(self, exFlag):
"""
HasExtraStyle(exFlag) -> bool
Returns true if the window has the given exFlag bit set in its extra
styles.
"""
def HasFlag(self, flag):
"""
HasFlag(flag) -> bool
Returns true if the window has the given flag bit set.
"""
def SetExtraStyle(self, exStyle):
"""
SetExtraStyle(exStyle)
Sets the extra style bits for the window.
"""
def SetWindowStyleFlag(self, style):
"""
SetWindowStyleFlag(style)
Sets the style of the window.
"""
def SetWindowStyle(self, style):
"""
SetWindowStyle(style)
See SetWindowStyleFlag() for more info.
"""
def ToggleWindowStyle(self, flag):
"""
ToggleWindowStyle(flag) -> bool
Turns the given flag on if it's currently turned off and vice versa.
"""
def MoveAfterInTabOrder(self, win):
"""
MoveAfterInTabOrder(win)
Moves this window in the tab navigation order after the specified win.
"""
def MoveBeforeInTabOrder(self, win):
"""
MoveBeforeInTabOrder(win)
Same as MoveAfterInTabOrder() except that it inserts this window just
before win instead of putting it right after it.
"""
def Navigate(self, flags=NavigationKeyEvent.IsForward):
"""
Navigate(flags=NavigationKeyEvent.IsForward) -> bool
Performs a keyboard navigation action starting from this window.
"""
def NavigateIn(self, flags=NavigationKeyEvent.IsForward):
"""
NavigateIn(flags=NavigationKeyEvent.IsForward) -> bool
Performs a keyboard navigation action inside this window.
"""
def Lower(self):
"""
Lower()
Lowers the window to the bottom of the window hierarchy (Z-order).
"""
def Raise(self):
"""
Raise()
Raises the window to the top of the window hierarchy (Z-order).
"""
def Hide(self):
"""
Hide() -> bool
Equivalent to calling wxWindow::Show(false).
"""
def HideWithEffect(self, effect, timeout=0):
"""
HideWithEffect(effect, timeout=0) -> bool
This function hides a window, like Hide(), but using a special visual
effect if possible.
"""
def IsEnabled(self):
"""
IsEnabled() -> bool
Returns true if the window is enabled, i.e. if it accepts user input,
false otherwise.
"""
def IsExposed(self, *args, **kw):
"""
IsExposed(x, y) -> bool
IsExposed(pt) -> bool
IsExposed(x, y, w, h) -> bool
IsExposed(rect) -> bool
Returns true if the given point or rectangle area has been exposed
since the last repaint.
"""
def IsShown(self):
"""
IsShown() -> bool
Returns true if the window is shown, false if it has been hidden.
"""
def IsShownOnScreen(self):
"""
IsShownOnScreen() -> 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.
"""
def Disable(self):
"""
Disable() -> bool
Disables the window.
"""
def Enable(self, enable=True):
"""
Enable(enable=True) -> bool
Enable or disable the window for user input.
"""
def Show(self, show=True):
"""
Show(show=True) -> bool
Shows or hides the window.
"""
def ShowWithEffect(self, effect, timeout=0):
"""
ShowWithEffect(effect, timeout=0) -> bool
This function shows a window, like Show(), but using a special visual
effect if possible.
"""
def GetHelpText(self):
"""
GetHelpText() -> String
Gets the help text to be used as context-sensitive help for this
window.
"""
def SetHelpText(self, helpText):
"""
SetHelpText(helpText)
Sets the help text to be used as context-sensitive help for this
window.
"""
def GetHelpTextAtPoint(self, point, origin):
"""
GetHelpTextAtPoint(point, origin) -> String
Gets the help text to be used as context-sensitive help for this
window.
"""
def GetToolTip(self):
"""
GetToolTip() -> ToolTip
Get the associated tooltip or NULL if none.
"""
def GetToolTipText(self):
"""
GetToolTipText() -> String
Get the text of the associated tooltip or empty string if none.
"""
def SetToolTip(self, *args, **kw):
"""
SetToolTip(tipString)
SetToolTip(tip)
Attach a tooltip to the window.
"""
def UnsetToolTip(self):
"""
UnsetToolTip()
Unset any existing tooltip.
"""
def GetPopupMenuSelectionFromUser(self, *args, **kw):
"""
GetPopupMenuSelectionFromUser(menu, pos=DefaultPosition) -> int
GetPopupMenuSelectionFromUser(menu, x, y) -> int
This function shows a popup menu at the given position in this window
and returns the selected id.
"""
def PopupMenu(self, *args, **kw):
"""
PopupMenu(menu, pos=DefaultPosition) -> bool
PopupMenu(menu, x, y) -> bool
Pops up the given menu at the specified coordinates, relative to this
window, and returns control when the user has dismissed the menu.
"""
def GetValidator(self):
"""
GetValidator() -> Validator
Validator functions.
"""
def SetValidator(self, validator):
"""
SetValidator(validator)
Deletes the current validator (if any) and sets the window validator,
having called wxValidator::Clone to create a new validator of this
type.
"""
def TransferDataFromWindow(self):
"""
TransferDataFromWindow() -> bool
Transfers values from child controls to data areas specified by their
validators.
"""
def TransferDataToWindow(self):
"""
TransferDataToWindow() -> bool
Transfers values to child controls from data areas specified by their
validators.
"""
def Validate(self):
"""
Validate() -> bool
Validates the current values of the child controls using their
validators.
"""
def GetId(self):
"""
GetId() -> WindowID
Returns the identifier of the window.
"""
def GetLabel(self):
"""
GetLabel() -> String
Generic way of getting a label from any window, for identification
purposes.
"""
def GetLayoutDirection(self):
"""
GetLayoutDirection() -> LayoutDirection
Returns the layout direction for this window, Note that
wxLayout_Default is returned if layout direction is not supported.
"""
def AdjustForLayoutDirection(self, x, width, widthTotal):
"""
AdjustForLayoutDirection(x, width, widthTotal) -> Coord
Mirror coordinates for RTL layout if this window uses it and if the
mirroring is not done automatically like Win32.
"""
def GetName(self):
"""
GetName() -> String
Returns the window's name.
"""
def GetWindowVariant(self):
"""
GetWindowVariant() -> WindowVariant
Returns the value previously passed to SetWindowVariant().
"""
def SetId(self, winid):
"""
SetId(winid)
Sets the identifier of the window.
"""
def SetLabel(self, label):
"""
SetLabel(label)
Sets the window's label.
"""
def SetLayoutDirection(self, dir):
"""
SetLayoutDirection(dir)
Sets the layout direction for this window.
"""
def SetName(self, name):
"""
SetName(name)
Sets the window's name.
"""
def SetWindowVariant(self, variant):
"""
SetWindowVariant(variant)
Chooses a different variant of the window display to use.
"""
def GetAcceleratorTable(self):
"""
GetAcceleratorTable() -> AcceleratorTable
Gets the accelerator table for this window.
"""
def SetAcceleratorTable(self, accel):
"""
SetAcceleratorTable(accel)
Sets the accelerator table for this window.
"""
def Close(self, force=False):
"""
Close(force=False) -> bool
This function simply generates a wxCloseEvent whose handler usually
tries to close the window.
"""
def Destroy(self):
"""
Destroy() -> bool
Destroys the window safely.
"""
def IsBeingDeleted(self):
"""
IsBeingDeleted() -> bool
Returns true if this window is in process of being destroyed.
"""
def GetDropTarget(self):
"""
GetDropTarget() -> DropTarget
Returns the associated drop target, which may be NULL.
"""
def SetDropTarget(self, target):
"""
SetDropTarget(target)
Associates a drop target with this window.
"""
def DragAcceptFiles(self, accept):
"""
DragAcceptFiles(accept)
Enables or disables eligibility for drop file events (OnDropFiles).
"""
def GetContainingSizer(self):
"""
GetContainingSizer() -> Sizer
Returns the sizer of which this window is a member, if any, otherwise
NULL.
"""
def GetSizer(self):
"""
GetSizer() -> Sizer
Returns the sizer associated with the window by a previous call to
SetSizer(), or NULL.
"""
def SetSizer(self, sizer, deleteOld=True):
"""
SetSizer(sizer, deleteOld=True)
Sets the window to have the given layout sizer.
"""
def SetSizerAndFit(self, sizer, deleteOld=True):
"""
SetSizerAndFit(sizer, deleteOld=True)
This method calls SetSizer() and then wxSizer::SetSizeHints which sets
the initial window size to the size needed to accommodate all sizer
elements and sets the size hints which, if this window is a top level
one, prevent the user from resizing it to be less than this minimal
size.
"""
def GetConstraints(self):
"""
GetConstraints() -> LayoutConstraints
Returns a pointer to the window's layout constraints, or NULL if there
are none.
"""
def SetConstraints(self, constraints):
"""
SetConstraints(constraints)
Sets the window to have the given layout constraints.
"""
def Layout(self):
"""
Layout() -> bool
Invokes the constraint-based layout algorithm or the sizer-based
algorithm for this window.
"""
def SetAutoLayout(self, autoLayout):
"""
SetAutoLayout(autoLayout)
Determines whether the Layout() function will be called automatically
when the window is resized.
"""
def GetAutoLayout(self):
"""
GetAutoLayout() -> bool
Returns the sizer of which this window is a member, if any, otherwise
NULL.
"""
def CaptureMouse(self):
"""
CaptureMouse()
Directs all mouse input to this window.
"""
def GetCaret(self):
"""
GetCaret() -> Caret
Returns the caret() associated with the window.
"""
def GetCursor(self):
"""
GetCursor() -> Cursor
Return the cursor associated with this window.
"""
def HasCapture(self):
"""
HasCapture() -> bool
Returns true if this window has the current mouse capture.
"""
def ReleaseMouse(self):
"""
ReleaseMouse()
Releases mouse input captured with CaptureMouse().
"""
def SetCaret(self, caret):
"""
SetCaret(caret)
Sets the caret() associated with the window.
"""
def SetCursor(self, cursor):
"""
SetCursor(cursor) -> bool
Sets the window's cursor.
"""
def WarpPointer(self, x, y):
"""
WarpPointer(x, y)
Moves the pointer to the given position on the window.
"""
def HitTest(self, *args, **kw):
"""
HitTest(x, y) -> HitTest
HitTest(pt) -> HitTest
Get the window border style from the given flags: this is different
from simply doing flags & wxBORDER_MASK because it uses
GetDefaultBorder() to translate wxBORDER_DEFAULT to something
reasonable.
"""
def GetBorder(self, *args, **kw):
"""
GetBorder(flags) -> Border
GetBorder() -> Border
Get the window border style from the given flags: this is different
from simply doing flags & wxBORDER_MASK because it uses
GetDefaultBorder() to translate wxBORDER_DEFAULT to something
reasonable.
"""
def DoUpdateWindowUI(self, event):
"""
DoUpdateWindowUI(event)
Does the window-specific updating after processing the update event.
"""
def GetHandle(self):
"""
GetHandle() -> unsignedlong
Returns the platform-specific handle of the physical window.
"""
def HasMultiplePages(self):
"""
HasMultiplePages() -> bool
This method should be overridden to return true if this window has
multiple pages.
"""
def InheritAttributes(self):
"""
InheritAttributes()
This function is (or should be, in case of custom controls) called
during window creation to intelligently set up the window visual
attributes, that is the font and the foreground and background
colours.
"""
def InitDialog(self):
"""
InitDialog()
Sends an wxEVT_INIT_DIALOG event, whose handler usually transfers data
to the dialog via validators.
"""
def IsDoubleBuffered(self):
"""
IsDoubleBuffered() -> 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.
"""
def SetDoubleBuffered(self, on):
"""
SetDoubleBuffered(on)
Turn on or off double buffering of the window if the system supports
it.
"""
def IsRetained(self):
"""
IsRetained() -> bool
Returns true if the window is retained, false otherwise.
"""
def IsThisEnabled(self):
"""
IsThisEnabled() -> bool
Returns true if this window is intrinsically enabled, false otherwise,
i.e. if Enable() Enable(false) had been called.
"""
def IsTopLevel(self):
"""
IsTopLevel() -> bool
Returns true if the given window is a top-level one.
"""
def OnInternalIdle(self):
"""
OnInternalIdle()
This virtual function is normally only used internally, but sometimes
an application may need it to implement functionality that should not
be disabled by an application defining an OnIdle handler in a derived
class.
"""
def SendIdleEvents(self, event):
"""
SendIdleEvents(event) -> bool
Send idle event to window and all subwindows.
"""
def RegisterHotKey(self, hotkeyId, modifiers, virtualKeyCode):
"""
RegisterHotKey(hotkeyId, modifiers, virtualKeyCode) -> bool
Registers a system wide hotkey.
"""
def UnregisterHotKey(self, hotkeyId):
"""
UnregisterHotKey(hotkeyId) -> bool
Unregisters a system wide hotkey.
"""
def UpdateWindowUI(self, flags=UPDATE_UI_NONE):
"""
UpdateWindowUI(flags=UPDATE_UI_NONE)
This function sends one or more wxUpdateUIEvent to the window.
"""
@staticmethod
def GetClassDefaultAttributes(variant=WINDOW_VARIANT_NORMAL):
"""
GetClassDefaultAttributes(variant=WINDOW_VARIANT_NORMAL) -> VisualAttributes
Returns the default font and colours which are used by the control.
"""
@staticmethod
def FindFocus():
"""
FindFocus() -> Window
Finds the window or control which currently has the keyboard focus.
"""
@staticmethod
def FindWindowById(id, parent=0):
"""
FindWindowById(id, parent=0) -> Window
Find the first window with the given id.
"""
@staticmethod
def FindWindowByLabel(label, parent=0):
"""
FindWindowByLabel(label, parent=0) -> Window
Find a window by its label.
"""
@staticmethod
def FindWindowByName(name, parent=0):
"""
FindWindowByName(name, parent=0) -> Window
Find a window by its name (as given in a window constructor or
Create() function call).
"""
@staticmethod
def GetCapture():
"""
GetCapture() -> Window
Returns the currently captured window.
"""
@staticmethod
def NewControlId(count=1):
"""
NewControlId(count=1) -> WindowID
Create a new ID or range of IDs that are not currently in use.
"""
@staticmethod
def UnreserveControlId(id, count=1):
"""
UnreserveControlId(id, count=1)
Unreserve an ID or range of IDs that was reserved by NewControlId().
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr) -> bool
"""
def SetRect(self, rect):
"""
"""
Rect = property(None, None)
def SetClientRect(self, rect):
"""
"""
ClientRect = property(None, None)
def GetGtkWidget(self):
"""
GetGtkWidget() -> void
"""
def AssociateHandle(self, handle):
"""
AssociateHandle(handle)
Associate the window with a new native handle
"""
def DissociateHandle(self):
"""
DissociateHandle()
Dissociate the current native handle from the window
"""
def GetTopLevelParent(self):
"""
GetTopLevelParent() -> Window
Returns the first ancestor of this window which is a top-level window.
"""
def MacIsWindowScrollbar(self, sb):
"""
MacIsWindowScrollbar(sb)
Is the given widget one of this window's built-in scrollbars? Only
applicable on Mac.
"""
def SetDimensions(self, x, y, width, height, sizeFlags=SIZE_AUTO):
"""
SetDimensions(x, y, width, height, sizeFlags=SIZE_AUTO)
"""
SetDimensions = wx.deprecated(SetDimensions, 'Use SetSize instead.')
def __nonzero__(self):
"""
Can be used to test if the C++ part of the window still exists, with
code like this::
if theWindow:
doSomething()
"""
__bool__ = __nonzero__
def DestroyLater(self):
"""
Schedules the window to be destroyed in the near future.
This should be used whenever Destroy could happen too soon, such
as when there may still be events for this window or its children
waiting in the event queue.
"""
def PostCreate(self, pre):
"""
"""
AcceleratorTable = property(None, None)
AutoLayout = property(None, None)
BackgroundColour = property(None, None)
BackgroundStyle = property(None, None)
EffectiveMinSize = property(None, None)
BestSize = property(None, None)
BestVirtualSize = property(None, None)
Border = property(None, None)
Caret = property(None, None)
CharHeight = property(None, None)
CharWidth = property(None, None)
Children = property(None, None)
ClientAreaOrigin = property(None, None)
ClientSize = property(None, None)
Constraints = property(None, None)
ContainingSizer = property(None, None)
Cursor = property(None, None)
DefaultAttributes = property(None, None)
DropTarget = property(None, None)
EventHandler = property(None, None)
ExtraStyle = property(None, None)
Font = property(None, None)
ForegroundColour = property(None, None)
GrandParent = property(None, None)
TopLevelParent = property(None, None)
Handle = property(None, None)
HelpText = property(None, None)
Id = property(None, None)
Label = property(None, None)
LayoutDirection = property(None, None)
MaxHeight = property(None, None)
MaxSize = property(None, None)
MaxWidth = property(None, None)
MinHeight = property(None, None)
MinSize = property(None, None)
MinWidth = property(None, None)
Name = property(None, None)
Parent = property(None, None)
Position = property(None, None)
ScreenPosition = property(None, None)
ScreenRect = property(None, None)
Size = property(None, None)
Sizer = property(None, None)
ThemeEnabled = property(None, None)
ToolTip = property(None, None)
UpdateClientRect = property(None, None)
UpdateRegion = property(None, None)
Validator = property(None, None)
VirtualSize = property(None, None)
WindowStyle = property(None, None)
WindowStyleFlag = property(None, None)
WindowVariant = property(None, None)
Shown = property(None, None)
Enabled = property(None, None)
TopLevel = property(None, None)
MinClientSize = property(None, None)
MaxClientSize = property(None, None)
def GetPositionTuple(self):
"""
"""
def MoveXY(self, x, y):
"""
"""
def SetSizeWH(self, w, h):
"""
"""
def SetVirtualSizeWH(self, w, h):
"""
"""
def GetVirtualSizeTuple(self):
"""
"""
def SetToolTipString(self, string):
"""
"""
def ConvertDialogPointToPixels(self, point):
"""
"""
def ConvertDialogSizeToPixels(self, size):
"""
"""
def DoGetBestSize(self):
"""
DoGetBestSize() -> Size
Implementation of GetBestSize() that can be overridden.
"""
def DoGetBestClientSize(self):
"""
DoGetBestClientSize() -> Size
Override this method to return the best size for a custom control.
"""
def SendDestroyEvent(self):
"""
SendDestroyEvent()
Generate wxWindowDestroyEvent for this window.
"""
def ProcessEvent(self, event):
"""
ProcessEvent(event) -> bool
This function is public in wxEvtHandler but protected in wxWindow
because for wxWindows you should always call ProcessEvent() on the
pointer returned by GetEventHandler() and not on the wxWindow object
itself.
"""
# end of class Window
def FindWindowAtPointer():
"""
FindWindowAtPointer() -> (Window, pt)
Find the deepest window at the mouse pointer position, returning the
window and current pointer position in screen coordinates.
"""
def GetActiveWindow():
"""
GetActiveWindow() -> Window
Gets the currently active window (implemented for MSW and GTK only
currently, always returns NULL in the other ports).
"""
def GetTopLevelParent(window):
"""
GetTopLevelParent(window) -> Window
Returns the first top level parent of the given window, or in other
words, the frame or dialog containing it, or NULL.
"""
class FrozenWindow(object):
"""
A context manager to be used with Python 'with' statements
that will freeze the given window for the duration of the
with block.
"""
def __init__(self, window):
self._win = window
def __enter__(self):
self._win.Freeze()
return self
def __exit__(self, exc_type, exc_val, exc_tb):
self._win.Thaw()
def GetTopLevelWindows(self):
"""
GetTopLevelWindows() -> WindowList
Returns a list-like object of the the application's top-level windows,
(frames,dialogs, etc.)
"""
PyWindow = wx.deprecated(Window, 'Use Window instead.')
def FindWindowById(self, id, parent=None):
"""
FindWindowById(id, parent=None) -> Window
FindWindowById(id, parent=None) -> Window
Find the first window in the application with the given id. If parent
is None, the search will start from all top-level frames and dialog
boxes; if non-None, the search will be limited to the given window
hierarchy. The search is recursive in both cases.
"""
def FindWindowByName(self, name, parent=None):
"""
FindWindowByName(name, parent=None) -> Window
FindWindowByName(name, parent=None) -> Window
Find a window by its name (as given in a window constructor or Create
function call). If parent is None, the search will start from all
top-level frames and dialog boxes; if non-None, the search will be
limited to the given window hierarchy. The search is recursive in both
cases.
If no window with the name is found, wx.FindWindowByLabel is called.
"""
def FindWindowByLabel(self, label, parent=None):
"""
FindWindowByLabel(label, parent=None) -> Window
FindWindowByLabel(label, parent=None) -> Window
Find a window by its label. Depending on the type of window, the label
may be a window title or panel item label. If parent is None, the
search will start from all top-level frames and dialog boxes; if
non-None, the search will be limited to the given window
hierarchy. The search is recursive in both cases.
"""
#-- end-window --#
#-- begin-validate --#
class Validator(EvtHandler):
"""
Validator()
wxValidator is the base class for a family of validator classes that
mediate between a class of control, and application data.
"""
def __init__(self):
"""
Validator()
wxValidator is the base class for a family of validator classes that
mediate between a class of control, and application data.
"""
def Clone(self):
"""
Clone() -> Object
All validator classes must implement the Clone() function, which
returns an identical copy of itself.
"""
def GetWindow(self):
"""
GetWindow() -> Window
Returns the window associated with the validator.
"""
def SetWindow(self, window):
"""
SetWindow(window)
Associates a window with the validator.
"""
def TransferFromWindow(self):
"""
TransferFromWindow() -> bool
This overridable function is called when the value in the window must
be transferred to the validator.
"""
def TransferToWindow(self):
"""
TransferToWindow() -> bool
This overridable function is called when the value associated with the
validator must be transferred to the window.
"""
def Validate(self, parent):
"""
Validate(parent) -> bool
This overridable function is called when the value in the associated
window must be validated.
"""
@staticmethod
def SuppressBellOnError(suppress=True):
"""
SuppressBellOnError(suppress=True)
This functions switches on or turns off the error sound produced by
the validators if an invalid key is pressed.
"""
@staticmethod
def IsSilent():
"""
IsSilent() -> bool
Returns if the error sound is currently disabled.
"""
Window = property(None, None)
# end of class Validator
DefaultValidator = Validator()
PyValidator = wx.deprecated(Validator, 'Use Validator instead.')
#-- end-validate --#
#-- begin-panel --#
class Panel(Window):
"""
Panel()
Panel(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TAB_TRAVERSAL, name=PanelNameStr)
A panel is a window on which controls are placed.
"""
def __init__(self, *args, **kw):
"""
Panel()
Panel(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TAB_TRAVERSAL, name=PanelNameStr)
A panel is a window on which controls are placed.
"""
def AcceptsFocus(self):
"""
AcceptsFocus() -> bool
This method is overridden from wxWindow::AcceptsFocus() and returns
true only if there is no child window in the panel which can accept
the focus.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TAB_TRAVERSAL, name=PanelNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TAB_TRAVERSAL, name=PanelNameStr) -> bool
Used for two-step panel construction.
"""
def InitDialog(self):
"""
InitDialog()
Sends a wxInitDialogEvent, which in turn transfers data to the dialog
via validators.
"""
def Layout(self):
"""
Layout() -> bool
See wxWindow::SetAutoLayout(): when auto layout is on, this function
gets called automatically when the window is resized.
"""
def SetFocus(self):
"""
SetFocus()
Overrides wxWindow::SetFocus().
"""
def SetFocusIgnoringChildren(self):
"""
SetFocusIgnoringChildren()
In contrast to SetFocus() (see above) this will set the focus to the
panel even if there are child windows in the panel.
"""
# end of class Panel
PyPanel = wx.deprecated(Panel, 'Use Panel instead.')
#-- end-panel --#
#-- begin-menuitem --#
class MenuItem(Object):
"""
MenuItem(parentMenu=None, id=ID_SEPARATOR, text=EmptyString, helpString=EmptyString, kind=ITEM_NORMAL, subMenu=None)
A menu item represents an item in a menu.
"""
def __init__(self, parentMenu=None, id=ID_SEPARATOR, text=EmptyString, helpString=EmptyString, kind=ITEM_NORMAL, subMenu=None):
"""
MenuItem(parentMenu=None, id=ID_SEPARATOR, text=EmptyString, helpString=EmptyString, kind=ITEM_NORMAL, subMenu=None)
A menu item represents an item in a menu.
"""
def GetBackgroundColour(self):
"""
GetBackgroundColour() -> Colour
Returns the background colour associated with the menu item.
"""
def GetBitmap(self, checked=True):
"""
GetBitmap(checked=True) -> Bitmap
Returns the checked or unchecked bitmap.
"""
def GetDisabledBitmap(self):
"""
GetDisabledBitmap() -> Bitmap
Returns the bitmap to be used for disabled items.
"""
def GetFont(self):
"""
GetFont() -> Font
Returns the font associated with the menu item.
"""
def GetHelp(self):
"""
GetHelp() -> String
Returns the help string associated with the menu item.
"""
def GetId(self):
"""
GetId() -> int
Returns the menu item identifier.
"""
def GetItemLabel(self):
"""
GetItemLabel() -> String
Returns the text associated with the menu item including any
accelerator characters that were passed to the constructor or
SetItemLabel().
"""
def GetItemLabelText(self):
"""
GetItemLabelText() -> String
Returns the text associated with the menu item, without any
accelerator characters.
"""
def GetKind(self):
"""
GetKind() -> ItemKind
Returns the item kind, one of wxITEM_SEPARATOR, wxITEM_NORMAL,
wxITEM_CHECK or wxITEM_RADIO.
"""
def GetLabel(self):
"""
GetLabel() -> String
Returns the text associated with the menu item without any accelerator
characters it might contain.
"""
def GetMarginWidth(self):
"""
GetMarginWidth() -> int
Gets the width of the menu item checkmark bitmap.
"""
def GetMenu(self):
"""
GetMenu() -> Menu
Returns the menu this menu item is in, or NULL if this menu item is
not attached.
"""
def GetName(self):
"""
GetName() -> String
Returns the text associated with the menu item.
"""
def GetSubMenu(self):
"""
GetSubMenu() -> Menu
Returns the submenu associated with the menu item, or NULL if there
isn't one.
"""
def GetText(self):
"""
GetText() -> String
Returns the text associated with the menu item, such as it was passed
to the wxMenuItem constructor, i.e.
"""
def GetTextColour(self):
"""
GetTextColour() -> Colour
Returns the text colour associated with the menu item.
"""
def GetAccel(self):
"""
GetAccel() -> AcceleratorEntry
Get our accelerator or NULL (caller must delete the pointer)
"""
def IsCheck(self):
"""
IsCheck() -> bool
Returns true if the item is a check item.
"""
def IsCheckable(self):
"""
IsCheckable() -> bool
Returns true if the item is checkable.
"""
def IsChecked(self):
"""
IsChecked() -> bool
Returns true if the item is checked.
"""
def IsEnabled(self):
"""
IsEnabled() -> bool
Returns true if the item is enabled.
"""
def IsRadio(self):
"""
IsRadio() -> bool
Returns true if the item is a radio button.
"""
def IsSeparator(self):
"""
IsSeparator() -> bool
Returns true if the item is a separator.
"""
def IsSubMenu(self):
"""
IsSubMenu() -> bool
Returns true if the item is a submenu.
"""
def SetBackgroundColour(self, colour):
"""
SetBackgroundColour(colour)
Sets the background colour associated with the menu item.
"""
def SetBitmap(self, bmp, checked=True):
"""
SetBitmap(bmp, checked=True)
Sets the bitmap for the menu item.
"""
def SetBitmaps(self, checked, unchecked=NullBitmap):
"""
SetBitmaps(checked, unchecked=NullBitmap)
Sets the checked/unchecked bitmaps for the menu item.
"""
def SetDisabledBitmap(self, disabled):
"""
SetDisabledBitmap(disabled)
Sets the to be used for disabled menu items.
"""
def SetFont(self, font):
"""
SetFont(font)
Sets the font associated with the menu item.
"""
def SetHelp(self, helpString):
"""
SetHelp(helpString)
Sets the help string.
"""
def SetItemLabel(self, label):
"""
SetItemLabel(label)
Sets the label associated with the menu item.
"""
def SetMarginWidth(self, width):
"""
SetMarginWidth(width)
Sets the width of the menu item checkmark bitmap.
"""
def SetMenu(self, menu):
"""
SetMenu(menu)
Sets the parent menu which will contain this menu item.
"""
def SetSubMenu(self, menu):
"""
SetSubMenu(menu)
Sets the submenu of this menu item.
"""
def SetText(self, text):
"""
SetText(text)
Sets the text associated with the menu item.
"""
def SetTextColour(self, colour):
"""
SetTextColour(colour)
Sets the text colour associated with the menu item.
"""
def SetAccel(self, accel):
"""
SetAccel(accel)
Set the accel for this item - this may also be done indirectly with
SetText()
"""
def Check(self, check=True):
"""
Check(check=True)
Checks or unchecks the menu item.
"""
def Enable(self, enable=True):
"""
Enable(enable=True)
Enables or disables the menu item.
"""
@staticmethod
def GetLabelFromText(text):
"""
GetLabelFromText(text) -> String
"""
@staticmethod
def GetLabelText(text):
"""
GetLabelText(text) -> String
Strips all accelerator characters and mnemonics from the given text.
"""
Accel = property(None, None)
BackgroundColour = property(None, None)
Bitmap = property(None, None)
DisabledBitmap = property(None, None)
Font = property(None, None)
Help = property(None, None)
Id = property(None, None)
ItemLabel = property(None, None)
ItemLabelText = property(None, None)
Kind = property(None, None)
Label = property(None, None)
MarginWidth = property(None, None)
Menu = property(None, None)
Name = property(None, None)
SubMenu = property(None, None)
Text = property(None, None)
TextColour = property(None, None)
# end of class MenuItem
#-- end-menuitem --#
#-- begin-menu --#
class Menu(EvtHandler):
"""
Menu()
Menu(style)
Menu(title, style=0)
A menu is a popup (or pull down) list of items, one of which may be
selected before the menu goes away (clicking elsewhere dismisses the
menu).
"""
def __init__(self, *args, **kw):
"""
Menu()
Menu(style)
Menu(title, style=0)
A menu is a popup (or pull down) list of items, one of which may be
selected before the menu goes away (clicking elsewhere dismisses the
menu).
"""
def GetMenuItems(self):
"""
GetMenuItems() -> MenuItemList
Returns the list of items in the menu.
"""
def Append(self, *args, **kw):
"""
Append(id, item=EmptyString, helpString=EmptyString, kind=ITEM_NORMAL) -> MenuItem
Append(id, item, subMenu, helpString=EmptyString) -> MenuItem
Append(menuItem) -> MenuItem
Adds a menu item.
"""
def AppendCheckItem(self, id, item, help=EmptyString):
"""
AppendCheckItem(id, item, help=EmptyString) -> MenuItem
Adds a checkable item to the end of the menu.
"""
def AppendRadioItem(self, id, item, help=EmptyString):
"""
AppendRadioItem(id, item, help=EmptyString) -> MenuItem
Adds a radio item to the end of the menu.
"""
def AppendSeparator(self):
"""
AppendSeparator() -> MenuItem
Adds a separator to the end of the menu.
"""
def AppendSubMenu(self, submenu, text, help=EmptyString):
"""
AppendSubMenu(submenu, text, help=EmptyString) -> MenuItem
Adds the given submenu to this menu.
"""
def Break(self):
"""
Break()
Inserts a break in a menu, causing the next appended item to appear in
a new column.
"""
def Check(self, id, check):
"""
Check(id, check)
Checks or unchecks the menu item.
"""
def Delete(self, *args, **kw):
"""
Delete(id) -> bool
Delete(item) -> bool
Deletes the menu item from the menu.
"""
def DestroyItem(self, *args, **kw):
"""
DestroyItem(id) -> bool
DestroyItem(item) -> bool
Deletes the menu item from the menu.
"""
def Enable(self, id, enable):
"""
Enable(id, enable)
Enables or disables (greys out) a menu item.
"""
def FindChildItem(self, id):
"""
FindChildItem(id) -> (MenuItem, pos)
Finds the menu item object associated with the given menu item
identifier and, optionally, the position of the item in the menu.
"""
def FindItem(self, *args, **kw):
"""
FindItem(itemString) -> int
FindItem(id) -> (MenuItem, menu)
Finds the menu id for a menu item string.
"""
def FindItemByPosition(self, position):
"""
FindItemByPosition(position) -> MenuItem
Returns the wxMenuItem given a position in the menu.
"""
def GetHelpString(self, id):
"""
GetHelpString(id) -> String
Returns the help string associated with a menu item.
"""
def GetLabel(self, id):
"""
GetLabel(id) -> String
Returns a menu item label.
"""
def GetLabelText(self, id):
"""
GetLabelText(id) -> String
Returns a menu item label, without any of the original mnemonics and
accelerators.
"""
def GetMenuItemCount(self):
"""
GetMenuItemCount() -> size_t
Returns the number of items in the menu.
"""
def GetTitle(self):
"""
GetTitle() -> String
Returns the title of the menu.
"""
def Insert(self, *args, **kw):
"""
Insert(pos, menuItem) -> MenuItem
Insert(pos, id, item=EmptyString, helpString=EmptyString, kind=ITEM_NORMAL) -> MenuItem
Insert(pos, id, text, submenu, help=EmptyString) -> MenuItem
Inserts the given item before the position pos.
"""
def InsertCheckItem(self, pos, id, item, helpString=EmptyString):
"""
InsertCheckItem(pos, id, item, helpString=EmptyString) -> MenuItem
Inserts a checkable item at the given position.
"""
def InsertRadioItem(self, pos, id, item, helpString=EmptyString):
"""
InsertRadioItem(pos, id, item, helpString=EmptyString) -> MenuItem
Inserts a radio item at the given position.
"""
def InsertSeparator(self, pos):
"""
InsertSeparator(pos) -> MenuItem
Inserts a separator at the given position.
"""
def IsChecked(self, id):
"""
IsChecked(id) -> bool
Determines whether a menu item is checked.
"""
def IsEnabled(self, id):
"""
IsEnabled(id) -> bool
Determines whether a menu item is enabled.
"""
def Prepend(self, *args, **kw):
"""
Prepend(item) -> MenuItem
Prepend(id, item=EmptyString, helpString=EmptyString, kind=ITEM_NORMAL) -> MenuItem
Prepend(id, text, submenu, help=EmptyString) -> MenuItem
Inserts the given item at position 0, i.e. before all the other
existing items.
"""
def PrependCheckItem(self, id, item, helpString=EmptyString):
"""
PrependCheckItem(id, item, helpString=EmptyString) -> MenuItem
Inserts a checkable item at position 0.
"""
def PrependRadioItem(self, id, item, helpString=EmptyString):
"""
PrependRadioItem(id, item, helpString=EmptyString) -> MenuItem
Inserts a radio item at position 0.
"""
def PrependSeparator(self):
"""
PrependSeparator() -> MenuItem
Inserts a separator at position 0.
"""
def Remove(self, *args, **kw):
"""
Remove(id) -> MenuItem
Remove(item) -> MenuItem
Removes the menu item from the menu but doesn't delete the associated
C++ object.
"""
def SetHelpString(self, id, helpString):
"""
SetHelpString(id, helpString)
Sets an item's help string.
"""
def SetLabel(self, id, label):
"""
SetLabel(id, label)
Sets the label of a menu item.
"""
def SetTitle(self, title):
"""
SetTitle(title)
Sets the title of the menu.
"""
def UpdateUI(self, source=None):
"""
UpdateUI(source=None)
Sends events to source (or owning window if NULL) to update the menu
UI.
"""
def SetInvokingWindow(self, win):
"""
SetInvokingWindow(win)
"""
def GetInvokingWindow(self):
"""
GetInvokingWindow() -> Window
"""
def GetWindow(self):
"""
GetWindow() -> Window
"""
def GetStyle(self):
"""
GetStyle() -> long
"""
def SetParent(self, parent):
"""
SetParent(parent)
"""
def GetParent(self):
"""
GetParent() -> Menu
"""
def Attach(self, menubar):
"""
Attach(menubar)
"""
def Detach(self):
"""
Detach()
"""
def IsAttached(self):
"""
IsAttached() -> bool
"""
def AppendMenu(self, id, item, subMenu, help=""):
"""
"""
def AppendItem(self, menuItem):
"""
"""
def InsertMenu(self, pos, id, item, subMenu, help=""):
"""
"""
def InsertItem(self, pos, menuItem):
"""
"""
def PrependMenu(self, id, item, subMenu, help=""):
"""
"""
def PrependItem(self, menuItem):
"""
"""
def RemoveMenu(self, id, item, subMenu, help=""):
"""
"""
def RemoveItem(self, menuItem):
"""
"""
def FindItemById(self, id):
"""
FindItemById(id) -> MenuItem
FindItemById(id) -> MenuItem
Finds the menu item object associated with the given menu item
identifier.
"""
InvokingWindow = property(None, None)
MenuItemCount = property(None, None)
MenuItems = property(None, None)
Parent = property(None, None)
Style = property(None, None)
Title = property(None, None)
Window = property(None, None)
# end of class Menu
class MenuBar(Window):
"""
MenuBar(style=0)
A menu bar is a series of menus accessible from the top of a frame.
"""
def __init__(self, *args, **kw):
"""
MenuBar(style=0)
A menu bar is a series of menus accessible from the top of a frame.
"""
def Append(self, menu, title):
"""
Append(menu, title) -> bool
Adds the item to the end of the menu bar.
"""
def Check(self, id, check):
"""
Check(id, check)
Checks or unchecks a menu item.
"""
def Enable(self, id, enable):
"""
Enable(id, enable)
Enables or disables (greys out) a menu item.
"""
def IsEnabledTop(self, pos):
"""
IsEnabledTop(pos) -> bool
Returns true if the menu with the given index is enabled.
"""
def EnableTop(self, pos, enable):
"""
EnableTop(pos, enable)
Enables or disables a whole menu.
"""
def FindItem(self, id):
"""
FindItem(id) -> (MenuItem, menu)
Finds the menu item object associated with the given menu item
identifier.
"""
def FindMenu(self, title):
"""
FindMenu(title) -> int
Returns the index of the menu with the given title or wxNOT_FOUND if
no such menu exists in this menubar.
"""
def FindMenuItem(self, menuString, itemString):
"""
FindMenuItem(menuString, itemString) -> int
Finds the menu item id for a menu name/menu item string pair.
"""
def GetHelpString(self, id):
"""
GetHelpString(id) -> String
Gets the help string associated with the menu item identifier.
"""
def GetLabel(self, id):
"""
GetLabel(id) -> String
Gets the label associated with a menu item.
"""
def GetLabelTop(self, pos):
"""
GetLabelTop(pos) -> String
Returns the label of a top-level menu.
"""
def GetMenu(self, menuIndex):
"""
GetMenu(menuIndex) -> Menu
Returns the menu at menuIndex (zero-based).
"""
def GetMenuCount(self):
"""
GetMenuCount() -> size_t
Returns the number of menus in this menubar.
"""
def GetMenuLabel(self, pos):
"""
GetMenuLabel(pos) -> String
Returns the label of a top-level menu.
"""
def GetMenuLabelText(self, pos):
"""
GetMenuLabelText(pos) -> String
Returns the label of a top-level menu.
"""
def Insert(self, pos, menu, title):
"""
Insert(pos, menu, title) -> bool
Inserts the menu at the given position into the menu bar.
"""
def IsChecked(self, id):
"""
IsChecked(id) -> bool
Determines whether an item is checked.
"""
def IsEnabled(self, id):
"""
IsEnabled(id) -> bool
Determines whether an item is enabled.
"""
def Refresh(self, eraseBackground=True, rect=None):
"""
Refresh(eraseBackground=True, rect=None)
Redraw the menu bar.
"""
def Remove(self, pos):
"""
Remove(pos) -> Menu
Removes the menu from the menu bar and returns the menu object - the
caller is responsible for deleting it.
"""
def Replace(self, pos, menu, title):
"""
Replace(pos, menu, title) -> Menu
Replaces the menu at the given position with another one.
"""
def SetHelpString(self, id, helpString):
"""
SetHelpString(id, helpString)
Sets the help string associated with a menu item.
"""
def SetLabel(self, id, label):
"""
SetLabel(id, label)
Sets the label of a menu item.
"""
def SetLabelTop(self, pos, label):
"""
SetLabelTop(pos, label)
Sets the label of a top-level menu.
"""
def SetMenuLabel(self, pos, label):
"""
SetMenuLabel(pos, label)
Sets the label of a top-level menu.
"""
def OSXGetAppleMenu(self):
"""
OSXGetAppleMenu() -> Menu
Returns the Apple menu.
"""
def GetFrame(self):
"""
GetFrame() -> Frame
"""
def IsAttached(self):
"""
IsAttached() -> bool
"""
def Attach(self, frame):
"""
Attach(frame)
"""
def Detach(self):
"""
Detach()
"""
@staticmethod
def MacSetCommonMenuBar(menubar):
"""
MacSetCommonMenuBar(menubar)
Enables you to set the global menubar on Mac, that is, the menubar
displayed when the app is running without any frames open.
"""
@staticmethod
def MacGetCommonMenuBar():
"""
MacGetCommonMenuBar() -> MenuBar
Enables you to get the global menubar on Mac, that is, the menubar
displayed when the app is running without any frames open.
"""
def FindItemById(self, id):
"""
FindItemById(id) -> MenuItem
FindItemById(id) -> MenuItem
Finds the menu item object associated with the given menu item
identifier.
"""
def GetMenus(self):
"""
GetMenus() -> (menu, label)
Return a list of (menu, label) items for the menus in the :class:`MenuBar`.
"""
def SetMenus(self, items):
"""
SetMenus()
Clear and add new menus to the :class:`MenuBar` from a list of (menu, label) items.
"""
Menus = property(None, None)
# end of class MenuBar
#-- end-menu --#
#-- begin-scrolwin --#
SHOW_SB_NEVER = 0
SHOW_SB_DEFAULT = 0
SHOW_SB_ALWAYS = 0
class Scrolled(object):
"""
Scrolled()
Scrolled(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HSCROLL|VSCROLL, name="scrolledWindow")
The wxScrolled class manages scrolling for its client area,
transforming the coordinates according to the scrollbar positions, and
setting the scroll positions, thumb sizes and ranges according to the
area in view.
"""
def __init__(self, *args, **kw):
"""
Scrolled()
Scrolled(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HSCROLL|VSCROLL, name="scrolledWindow")
The wxScrolled class manages scrolling for its client area,
transforming the coordinates according to the scrollbar positions, and
setting the scroll positions, thumb sizes and ranges according to the
area in view.
"""
def CalcScrolledPosition(self, *args, **kw):
"""
CalcScrolledPosition(x, y) -> (xx, yy)
CalcScrolledPosition(pt) -> Point
Translates the logical coordinates to the device ones.
"""
def CalcUnscrolledPosition(self, *args, **kw):
"""
CalcUnscrolledPosition(x, y) -> (xx, yy)
CalcUnscrolledPosition(pt) -> Point
Translates the device coordinates to the logical ones.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HSCROLL|VSCROLL, name="scrolledWindow"):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HSCROLL|VSCROLL, name="scrolledWindow") -> bool
Creates the window for two-step construction.
"""
def DisableKeyboardScrolling(self):
"""
DisableKeyboardScrolling()
Disable use of keyboard keys for scrolling.
"""
def DoPrepareDC(self, dc):
"""
DoPrepareDC(dc)
Call this function to prepare the device context for drawing a
scrolled image.
"""
def EnableScrolling(self, xScrolling, yScrolling):
"""
EnableScrolling(xScrolling, yScrolling)
Enable or disable use of wxWindow::ScrollWindow() for scrolling.
"""
def ShowScrollbars(self, horz, vert):
"""
ShowScrollbars(horz, vert)
Set the scrollbar visibility.
"""
def GetScrollPixelsPerUnit(self):
"""
GetScrollPixelsPerUnit() -> (xUnit, yUnit)
Get the number of pixels per scroll unit (line), in each direction, as
set by SetScrollbars().
"""
def GetViewStart(self, *args, **kw):
"""
GetViewStart() -> (x, y)
Get the position at which the visible portion of the window starts.
"""
def GetVirtualSize(self):
"""
GetVirtualSize() -> (x, y)
Gets the size in device units of the scrollable window area (as
opposed to the client size, which is the area of the window currently
visible).
"""
def IsRetained(self):
"""
IsRetained() -> bool
Motif only: true if the window has a backing bitmap.
"""
def OnDraw(self, dc):
"""
OnDraw(dc)
Called by the default paint event handler to allow the application to
define painting behaviour without having to worry about calling
DoPrepareDC().
"""
def PrepareDC(self, dc):
"""
PrepareDC(dc)
This function is for backwards compatibility only and simply calls
DoPrepareDC() now.
"""
def Scroll(self, *args, **kw):
"""
Scroll(x, y)
Scroll(pt)
Scrolls a window so the view start is at the given point.
"""
def SetScrollRate(self, xstep, ystep):
"""
SetScrollRate(xstep, ystep)
Set the horizontal and vertical scrolling increment only.
"""
def SetScrollbars(self, pixelsPerUnitX, pixelsPerUnitY, noUnitsX, noUnitsY, xPos=0, yPos=0, noRefresh=False):
"""
SetScrollbars(pixelsPerUnitX, pixelsPerUnitY, noUnitsX, noUnitsY, xPos=0, yPos=0, noRefresh=False)
Sets up vertical and/or horizontal scrollbars.
"""
def SetTargetWindow(self, window):
"""
SetTargetWindow(window)
Call this function to tell wxScrolled to perform the actual scrolling
on a different window (and not on itself).
"""
def GetTargetWindow(self):
"""
GetTargetWindow() -> Window
"""
def SetTargetRect(self, rect):
"""
SetTargetRect(rect)
"""
def GetTargetRect(self):
"""
GetTargetRect() -> Rect
"""
def GetScrollPageSize(self, orient):
"""
GetScrollPageSize(orient) -> int
"""
def SetScrollPageSize(self, orient, pageSize):
"""
SetScrollPageSize(orient, pageSize)
"""
def GetScrollLines(self, orient):
"""
GetScrollLines(orient) -> int
"""
def SetScale(self, xs, ys):
"""
SetScale(xs, ys)
"""
def GetScaleX(self):
"""
GetScaleX() -> double
"""
def GetScaleY(self):
"""
GetScaleY() -> double
"""
def AdjustScrollbars(self):
"""
AdjustScrollbars()
"""
def IsAutoScrolling(self):
"""
IsAutoScrolling() -> bool
Are we generating the autoscroll events?
"""
def StopAutoScrolling(self):
"""
StopAutoScrolling()
Stop generating the scroll events when mouse is held outside the
window.
"""
def SendAutoScrollEvents(self, event):
"""
SendAutoScrollEvents(event) -> bool
This method can be overridden in a derived class to forbid sending the
auto scroll events - note that unlike StopAutoScrolling() it doesn't
stop the timer, so it will be called repeatedly and will typically
return different values depending on the current mouse position.
"""
ScaleX = property(None, None)
ScaleY = property(None, None)
TargetRect = property(None, None)
TargetWindow = property(None, None)
def GetSizeAvailableForScrollTarget(self, size):
"""
GetSizeAvailableForScrollTarget(size) -> Size
Function which must be overridden to implement the size available for
the scroll target for the given size of the main window.
"""
# end of class Scrolled
class ScrolledWindow(Panel, Scrolled):
"""
The :ref:`ScrolledWindow` class is a combination of the :ref:`Panel` and
:ref:`Scrolled` classes, and manages scrolling for its client area,
transforming the coordinates according to the scrollbar positions,
and setting the scroll positions, thumb sizes and ranges according to
the area in view.
"""
class ScrolledCanvas(Window, Scrolled):
"""
The :ref:`ScrolledCanvas` class is a combination of the :ref:`Window` and
:ref:`Scrolled` classes, and manages scrolling for its client area,
transforming the coordinates according to the scrollbar positions,
and setting the scroll positions, thumb sizes and ranges according to
the area in view.
"""
PyScrolledWindow = wx.deprecated(ScrolledWindow, 'Use ScrolledWindow instead.')
#-- end-scrolwin --#
#-- begin-vscroll --#
class VarScrollHelperBase(object):
"""
VarScrollHelperBase(winToScroll)
This class provides all common base functionality for scroll
calculations shared among all variable scrolled window implementations
as well as automatic scrollbar functionality, saved scroll positions,
controlling target windows to be scrolled, as well as defining all
required virtual functions that need to be implemented for any
orientation specific work.
"""
def __init__(self, winToScroll):
"""
VarScrollHelperBase(winToScroll)
This class provides all common base functionality for scroll
calculations shared among all variable scrolled window implementations
as well as automatic scrollbar functionality, saved scroll positions,
controlling target windows to be scrolled, as well as defining all
required virtual functions that need to be implemented for any
orientation specific work.
"""
def CalcScrolledPosition(self, coord):
"""
CalcScrolledPosition(coord) -> int
Translates the logical coordinate given to the current device
coordinate.
"""
def CalcUnscrolledPosition(self, coord):
"""
CalcUnscrolledPosition(coord) -> int
Translates the device coordinate given to the corresponding logical
coordinate.
"""
def EnablePhysicalScrolling(self, scrolling=True):
"""
EnablePhysicalScrolling(scrolling=True)
With physical scrolling on (when this is true), the device origin is
changed properly when a wxPaintDC is prepared, children are actually
moved and laid out properly, and the contents of the window (pixels)
are actually moved.
"""
def GetNonOrientationTargetSize(self):
"""
GetNonOrientationTargetSize() -> int
This function needs to be overridden in the in the derived class to
return the window size with respect to the opposing orientation.
"""
def GetOrientation(self):
"""
GetOrientation() -> Orientation
This function need to be overridden to return the orientation that
this helper is working with, either wxHORIZONTAL or wxVERTICAL.
"""
def GetOrientationTargetSize(self):
"""
GetOrientationTargetSize() -> int
This function needs to be overridden in the in the derived class to
return the window size with respect to the orientation this helper is
working with.
"""
def GetTargetWindow(self):
"""
GetTargetWindow() -> Window
This function will return the target window this helper class is
currently scrolling.
"""
def GetVisibleBegin(self):
"""
GetVisibleBegin() -> size_t
Returns the index of the first visible unit based on the scroll
position.
"""
def GetVisibleEnd(self):
"""
GetVisibleEnd() -> size_t
Returns the index of the last visible unit based on the scroll
position.
"""
def IsVisible(self, unit):
"""
IsVisible(unit) -> bool
Returns true if the given scroll unit is currently visible (even if
only partially visible) or false otherwise.
"""
def RefreshAll(self):
"""
RefreshAll()
Recalculate all parameters and repaint all units.
"""
def SetTargetWindow(self, target):
"""
SetTargetWindow(target)
Normally the window will scroll itself, but in some rare occasions you
might want it to scroll (part of) another window (e.g.
"""
def UpdateScrollbar(self):
"""
UpdateScrollbar()
Update the thumb size shown by the scrollbar.
"""
def VirtualHitTest(self, coord):
"""
VirtualHitTest(coord) -> int
Returns the virtual scroll unit under the device unit given accounting
for scroll position or wxNOT_FOUND if none (i.e.
"""
NonOrientationTargetSize = property(None, None)
Orientation = property(None, None)
OrientationTargetSize = property(None, None)
TargetWindow = property(None, None)
VisibleBegin = property(None, None)
VisibleEnd = property(None, None)
def OnGetUnitsSizeHint(self, unitMin, unitMax):
"""
OnGetUnitsSizeHint(unitMin, unitMax)
This function doesn't have to be overridden but it may be useful to do
so if calculating the units' sizes is a relatively expensive operation
as it gives your code a chance to calculate several of them at once
and cache the result if necessary.
"""
def EstimateTotalSize(self):
"""
EstimateTotalSize() -> Coord
When the number of scroll units change, we try to estimate the total
size of all units when the full window size is needed (i.e.
"""
def OnGetUnitSize(self, unit):
"""
OnGetUnitSize(unit) -> Coord
This function must be overridden in the derived class, and should
return the size of the given unit in pixels.
"""
# end of class VarScrollHelperBase
class VarVScrollHelper(VarScrollHelperBase):
"""
VarVScrollHelper(winToScroll)
This class provides functions wrapping the wxVarScrollHelperBase
class, targeted for vertical-specific scrolling.
"""
def __init__(self, winToScroll):
"""
VarVScrollHelper(winToScroll)
This class provides functions wrapping the wxVarScrollHelperBase
class, targeted for vertical-specific scrolling.
"""
def GetRowCount(self):
"""
GetRowCount() -> size_t
Returns the number of rows the target window contains.
"""
def GetVisibleRowsBegin(self):
"""
GetVisibleRowsBegin() -> size_t
Returns the index of the first visible row based on the scroll
position.
"""
def GetVisibleRowsEnd(self):
"""
GetVisibleRowsEnd() -> size_t
Returns the index of the last visible row based on the scroll
position.
"""
def IsRowVisible(self, row):
"""
IsRowVisible(row) -> bool
Returns true if the given row is currently visible (even if only
partially visible) or false otherwise.
"""
def RefreshRow(self, row):
"""
RefreshRow(row)
Triggers a refresh for just the given row's area of the window if it's
visible.
"""
def RefreshRows(self, from_, to_):
"""
RefreshRows(from_, to_)
Triggers a refresh for the area between the specified range of rows
given (inclusively).
"""
def ScrollRowPages(self, pages):
"""
ScrollRowPages(pages) -> bool
Scroll by the specified number of pages which may be positive (to
scroll down) or negative (to scroll up).
"""
def ScrollRows(self, rows):
"""
ScrollRows(rows) -> bool
Scroll by the specified number of rows which may be positive (to
scroll down) or negative (to scroll up).
"""
def ScrollToRow(self, row):
"""
ScrollToRow(row) -> bool
Scroll to the specified row.
"""
def SetRowCount(self, rowCount):
"""
SetRowCount(rowCount)
Set the number of rows the window contains.
"""
RowCount = property(None, None)
VisibleRowsBegin = property(None, None)
VisibleRowsEnd = property(None, None)
def OnGetRowsHeightHint(self, rowMin, rowMax):
"""
OnGetRowsHeightHint(rowMin, rowMax)
This function doesn't have to be overridden but it may be useful to do
so if calculating the rows' sizes is a relatively expensive operation
as it gives your code a chance to calculate several of them at once
and cache the result if necessary.
"""
def EstimateTotalHeight(self):
"""
EstimateTotalHeight() -> Coord
This class forwards calls from EstimateTotalSize() to this function so
derived classes can override either just the height or the width
estimation, or just estimate both differently if desired in any
wxHVScrolledWindow derived class.
"""
def OnGetRowHeight(self, row):
"""
OnGetRowHeight(row) -> Coord
This function must be overridden in the derived class, and should
return the height of the given row in pixels.
"""
# end of class VarVScrollHelper
class VarHScrollHelper(VarScrollHelperBase):
"""
VarHScrollHelper(winToScroll)
This class provides functions wrapping the wxVarScrollHelperBase
class, targeted for horizontal-specific scrolling.
"""
def __init__(self, winToScroll):
"""
VarHScrollHelper(winToScroll)
This class provides functions wrapping the wxVarScrollHelperBase
class, targeted for horizontal-specific scrolling.
"""
def GetColumnCount(self):
"""
GetColumnCount() -> size_t
Returns the number of columns the target window contains.
"""
def GetVisibleColumnsBegin(self):
"""
GetVisibleColumnsBegin() -> size_t
Returns the index of the first visible column based on the scroll
position.
"""
def GetVisibleColumnsEnd(self):
"""
GetVisibleColumnsEnd() -> size_t
Returns the index of the last visible column based on the scroll
position.
"""
def IsColumnVisible(self, column):
"""
IsColumnVisible(column) -> bool
Returns true if the given column is currently visible (even if only
partially visible) or false otherwise.
"""
def RefreshColumn(self, column):
"""
RefreshColumn(column)
Triggers a refresh for just the given column's area of the window if
it's visible.
"""
def RefreshColumns(self, from_, to_):
"""
RefreshColumns(from_, to_)
Triggers a refresh for the area between the specified range of columns
given (inclusively).
"""
def ScrollColumnPages(self, pages):
"""
ScrollColumnPages(pages) -> bool
Scroll by the specified number of pages which may be positive (to
scroll right) or negative (to scroll left).
"""
def ScrollColumns(self, columns):
"""
ScrollColumns(columns) -> bool
Scroll by the specified number of columns which may be positive (to
scroll right) or negative (to scroll left).
"""
def ScrollToColumn(self, column):
"""
ScrollToColumn(column) -> bool
Scroll to the specified column.
"""
def SetColumnCount(self, columnCount):
"""
SetColumnCount(columnCount)
Set the number of columns the window contains.
"""
ColumnCount = property(None, None)
VisibleColumnsBegin = property(None, None)
VisibleColumnsEnd = property(None, None)
def EstimateTotalWidth(self):
"""
EstimateTotalWidth() -> Coord
This class forwards calls from EstimateTotalSize() to this function so
derived classes can override either just the height or the width
estimation, or just estimate both differently if desired in any
wxHVScrolledWindow derived class.
"""
def OnGetColumnsWidthHint(self, columnMin, columnMax):
"""
OnGetColumnsWidthHint(columnMin, columnMax)
This function doesn't have to be overridden but it may be useful to do
so if calculating the columns' sizes is a relatively expensive
operation as it gives your code a chance to calculate several of them
at once and cache the result if necessary.
"""
def OnGetColumnWidth(self, column):
"""
OnGetColumnWidth(column) -> Coord
This function must be overridden in the derived class, and should
return the width of the given column in pixels.
"""
# end of class VarHScrollHelper
class VarHVScrollHelper(VarVScrollHelper, VarHScrollHelper):
"""
VarHVScrollHelper(winToScroll)
This class provides functions wrapping the wxVarHScrollHelper and
wxVarVScrollHelper classes, targeted for scrolling a window in both
axis.
"""
def __init__(self, winToScroll):
"""
VarHVScrollHelper(winToScroll)
This class provides functions wrapping the wxVarHScrollHelper and
wxVarVScrollHelper classes, targeted for scrolling a window in both
axis.
"""
def IsVisible(self, *args, **kw):
"""
IsVisible(row, column) -> bool
IsVisible(pos) -> bool
Returns true if both the given row and column are currently visible
(even if only partially visible) or false otherwise.
"""
def RefreshRowColumn(self, *args, **kw):
"""
RefreshRowColumn(row, column)
RefreshRowColumn(pos)
Triggers a refresh for just the area shared between the given row and
column of the window if it is visible.
"""
def RefreshRowsColumns(self, *args, **kw):
"""
RefreshRowsColumns(fromRow, toRow, fromColumn, toColumn)
RefreshRowsColumns(from, to)
Triggers a refresh for the visible area shared between all given rows
and columns (inclusive) of the window.
"""
def ScrollToRowColumn(self, *args, **kw):
"""
ScrollToRowColumn(row, column) -> bool
ScrollToRowColumn(pos) -> bool
Scroll to the specified row and column.
"""
def VirtualHitTest(self, *args, **kw):
"""
VirtualHitTest(x, y) -> Position
VirtualHitTest(pos) -> Position
Returns the virtual scroll unit under the device unit given accounting
for scroll position or wxNOT_FOUND (for the row, column, or possibly
both values) if none.
"""
def EnablePhysicalScrolling(self, vscrolling=True, hscrolling=True):
"""
EnablePhysicalScrolling(vscrolling=True, hscrolling=True)
With physical scrolling on (when this is true), the device origin is
changed properly when a wxPaintDC is prepared, children are actually
moved and laid out properly, and the contents of the window (pixels)
are actually moved.
"""
def GetRowColumnCount(self):
"""
GetRowColumnCount() -> Size
Returns the number of columns and rows the target window contains.
"""
def GetVisibleBegin(self):
"""
GetVisibleBegin() -> Position
Returns the index of the first visible column and row based on the
current scroll position.
"""
def GetVisibleEnd(self):
"""
GetVisibleEnd() -> Position
Returns the index of the last visible column and row based on the
scroll position.
"""
def SetRowColumnCount(self, rowCount, columnCount):
"""
SetRowColumnCount(rowCount, columnCount)
Set the number of rows and columns the target window will contain.
"""
RowColumnCount = property(None, None)
VisibleBegin = property(None, None)
VisibleEnd = property(None, None)
# end of class VarHVScrollHelper
class VScrolledWindow(Panel, VarVScrollHelper):
"""
VScrolledWindow()
VScrolledWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
In the name of this class, "V" may stand for "variable" because it can
be used for scrolling rows of variable heights; "virtual", because it
is not necessary to know the heights of all rows in advance only
those which are shown on the screen need to be measured; or even
"vertical", because this class only supports scrolling vertically.
"""
def __init__(self, *args, **kw):
"""
VScrolledWindow()
VScrolledWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
In the name of this class, "V" may stand for "variable" because it can
be used for scrolling rows of variable heights; "virtual", because it
is not necessary to know the heights of all rows in advance only
those which are shown on the screen need to be measured; or even
"vertical", because this class only supports scrolling vertically.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr) -> bool
Same as the non-default constructor, but returns a status code: true
if ok, false if the window couldn't be created.
"""
# end of class VScrolledWindow
class HScrolledWindow(Panel, VarHScrollHelper):
"""
HScrolledWindow()
HScrolledWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
In the name of this class, "H" stands for "horizontal" because it can
be used for scrolling columns of variable widths.
"""
def __init__(self, *args, **kw):
"""
HScrolledWindow()
HScrolledWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
In the name of this class, "H" stands for "horizontal" because it can
be used for scrolling columns of variable widths.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr) -> bool
Same as the non-default constructor, but returns a status code: true
if ok, false if the window couldn't be created.
"""
# end of class HScrolledWindow
class HVScrolledWindow(Panel, VarHVScrollHelper):
"""
HVScrolledWindow()
HVScrolledWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
This window inherits all functionality of both vertical and
horizontal, variable scrolled windows.
"""
def __init__(self, *args, **kw):
"""
HVScrolledWindow()
HVScrolledWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr)
This window inherits all functionality of both vertical and
horizontal, variable scrolled windows.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=PanelNameStr) -> bool
Same as the non-default constructor, but returns a status code: true
if ok, false if the window couldn't be created.
"""
# end of class HVScrolledWindow
#-- end-vscroll --#
#-- begin-control --#
ELLIPSIZE_FLAGS_NONE = 0
ELLIPSIZE_FLAGS_PROCESS_MNEMONICS = 0
ELLIPSIZE_FLAGS_EXPAND_TABS = 0
ELLIPSIZE_FLAGS_DEFAULT = 0
ELLIPSIZE_NONE = 0
ELLIPSIZE_START = 0
ELLIPSIZE_MIDDLE = 0
ELLIPSIZE_END = 0
ControlNameStr = ""
class Control(Window):
"""
Control(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ControlNameStr)
Control()
This is the base class for a control or "widget".
"""
def __init__(self, *args, **kw):
"""
Control(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ControlNameStr)
Control()
This is the base class for a control or "widget".
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ControlNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ControlNameStr) -> bool
"""
def Command(self, event):
"""
Command(event)
Simulates the effect of the user issuing a command to the item.
"""
def GetLabel(self):
"""
GetLabel() -> String
Returns the control's label, as it was passed to SetLabel().
"""
def GetLabelText(self, *args, **kw):
"""
GetLabelText() -> String
GetLabelText(label) -> String
Returns the control's label without mnemonics.
"""
def GetSizeFromTextSize(self, *args, **kw):
"""
GetSizeFromTextSize(xlen, ylen=-1) -> Size
GetSizeFromTextSize(tsize) -> Size
Determine the size needed by the control to leave the given area for
its text.
"""
def SetLabel(self, label):
"""
SetLabel(label)
Sets the control's label.
"""
def SetLabelText(self, text):
"""
SetLabelText(text)
Sets the control's label to exactly the given string.
"""
def SetLabelMarkup(self, markup):
"""
SetLabelMarkup(markup) -> bool
Sets the controls label to a string using markup.
"""
@staticmethod
def RemoveMnemonics(str):
"""
RemoveMnemonics(str) -> String
Returns the given str string without mnemonics ("&" characters).
"""
@staticmethod
def EscapeMnemonics(text):
"""
EscapeMnemonics(text) -> String
Escapes the special mnemonics characters ("&") in the given string.
"""
@staticmethod
def Ellipsize(label, dc, mode, maxWidth, flags=ELLIPSIZE_FLAGS_DEFAULT):
"""
Ellipsize(label, dc, mode, maxWidth, flags=ELLIPSIZE_FLAGS_DEFAULT) -> String
Replaces parts of the label string with ellipsis, if needed, so that
it fits into maxWidth pixels if possible.
"""
Label = property(None, None)
LabelText = property(None, None)
# end of class Control
PyControl = wx.deprecated(Control, 'Use Control instead.')
#-- end-control --#
#-- begin-ctrlsub --#
class ItemContainerImmutable(object):
"""
ItemContainerImmutable()
wxItemContainer defines an interface which is implemented by all
controls which have string subitems each of which may be selected.
"""
def __init__(self):
"""
ItemContainerImmutable()
wxItemContainer defines an interface which is implemented by all
controls which have string subitems each of which may be selected.
"""
def GetCount(self):
"""
GetCount() -> unsignedint
Returns the number of items in the control.
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Returns true if the control is empty or false if it has some items.
"""
def GetString(self, n):
"""
GetString(n) -> String
Returns the label of the item with the given index.
"""
def GetStrings(self):
"""
GetStrings() -> ArrayString
Returns the array of the labels of all items in the control.
"""
def SetString(self, n, string):
"""
SetString(n, string)
Sets the label for the given item.
"""
def FindString(self, string, caseSensitive=False):
"""
FindString(string, caseSensitive=False) -> int
Finds an item whose label matches the given string.
"""
def SetSelection(self, n):
"""
SetSelection(n)
Sets the selection to the given item n or removes the selection
entirely if n == wxNOT_FOUND.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the index of the selected item or wxNOT_FOUND if no item is
selected.
"""
def SetStringSelection(self, string):
"""
SetStringSelection(string) -> bool
Selects the item with the specified string in the control.
"""
def GetStringSelection(self):
"""
GetStringSelection() -> String
Returns the label of the selected item or an empty string if no item
is selected.
"""
def Select(self, n):
"""
Select(n)
This is the same as SetSelection() and exists only because it is
slightly more natural for controls which support multiple selection.
"""
Count = property(None, None)
Selection = property(None, None)
StringSelection = property(None, None)
Strings = property(None, None)
# end of class ItemContainerImmutable
class ItemContainer(ItemContainerImmutable):
"""
This class is an abstract base class for some wxWidgets controls which
contain several items such as wxListBox, wxCheckListBox, wxComboBox or
wxChoice.
"""
def Append(self, *args, **kw):
"""
Append(item) -> int
Append(item, clientData) -> int
Append(items) -> int
Appends item into the control.
"""
def GetClientData(self, n):
"""
GetClientData(n) -> ClientData
Returns a pointer to the client data associated with the given item
(if any).
"""
def SetClientData(self, n, data):
"""
SetClientData(n, data)
Associates the given typed client data pointer with the given item:
the data object will be deleted when the item is deleted (either
explicitly by using Delete() or implicitly when the control itself is
destroyed).
"""
def Insert(self, *args, **kw):
"""
Insert(item, pos) -> int
Insert(item, pos, clientData) -> int
Insert(items, pos) -> int
Inserts item into the control.
"""
def Set(self, *args, **kw):
"""
Set(items)
Replaces the current control contents with the given items.
"""
def Clear(self):
"""
Clear()
Removes all items from the control.
"""
def Delete(self, n):
"""
Delete(n)
Deletes an item from the control.
"""
def DetachClientObject(self, n):
"""
DetachClientObject(n) -> ClientData
Returns the client object associated with the given item and transfers
its ownership to the caller.
"""
def HasClientData(self):
"""
HasClientData() -> bool
Returns true, if either untyped data (void*) or object data
(wxClientData*) is associated with the items of the control.
"""
def HasClientObjectData(self):
"""
HasClientObjectData() -> bool
Returns true, if object data is associated with the items of the
control.
"""
def HasClientUntypedData(self):
"""
HasClientUntypedData() -> bool
Returns true, if untyped data (void*) is associated with the items of
the control.
"""
def GetClientObject(self, n):
"""
Alias for :meth:`GetClientData`
"""
def SetClientObject(self, n, data):
"""
Alias for :meth:`SetClientData`
"""
def AppendItems(self, items):
"""
"""
def GetItems(self):
"""
"""
def SetItems(self, items):
"""
"""
Items = property(None, None)
# end of class ItemContainer
class ControlWithItems(Control, ItemContainer):
"""
This is convenience class that derives from both wxControl and
wxItemContainer.
"""
# end of class ControlWithItems
#-- end-ctrlsub --#
#-- begin-statbmp --#
StaticBitmapNameStr = ""
class StaticBitmap(Control):
"""
StaticBitmap()
StaticBitmap(parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBitmapNameStr)
A static bitmap control displays a bitmap.
"""
def __init__(self, *args, **kw):
"""
StaticBitmap()
StaticBitmap(parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBitmapNameStr)
A static bitmap control displays a bitmap.
"""
def Create(self, parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBitmapNameStr):
"""
Create(parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBitmapNameStr) -> bool
Creation function, for two-step construction.
"""
def GetBitmap(self):
"""
GetBitmap() -> Bitmap
Returns the bitmap currently used in the control.
"""
def GetIcon(self):
"""
GetIcon() -> Icon
Returns the icon currently used in the control.
"""
def SetBitmap(self, label):
"""
SetBitmap(label)
Sets the bitmap label.
"""
def SetIcon(self, label):
"""
SetIcon(label)
Sets the label to the given icon.
"""
Bitmap = property(None, None)
Icon = property(None, None)
# end of class StaticBitmap
#-- end-statbmp --#
#-- begin-stattext --#
ST_NO_AUTORESIZE = 0
ST_ELLIPSIZE_START = 0
ST_ELLIPSIZE_MIDDLE = 0
ST_ELLIPSIZE_END = 0
StaticTextNameStr = ""
class StaticText(Control):
"""
StaticText()
StaticText(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticTextNameStr)
A static text control displays one or more lines of read-only text.
"""
def __init__(self, *args, **kw):
"""
StaticText()
StaticText(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticTextNameStr)
A static text control displays one or more lines of read-only text.
"""
def Create(self, parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticTextNameStr):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticTextNameStr) -> bool
Creation function, for two-step construction.
"""
def IsEllipsized(self):
"""
IsEllipsized() -> bool
Returns true if the window styles for this control contains one of the
wxST_ELLIPSIZE_START, wxST_ELLIPSIZE_MIDDLE or wxST_ELLIPSIZE_END
styles.
"""
def Wrap(self, width):
"""
Wrap(width)
This functions wraps the controls label so that each of its lines
becomes at most width pixels wide if possible (the lines are broken at
words boundaries so it might not be the case if words are too long).
"""
# end of class StaticText
#-- end-stattext --#
#-- begin-statbox --#
StaticBoxNameStr = ""
class StaticBox(Control):
"""
StaticBox()
StaticBox(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBoxNameStr)
A static box is a rectangle drawn around other windows to denote a
logical grouping of items.
"""
def __init__(self, *args, **kw):
"""
StaticBox()
StaticBox(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBoxNameStr)
A static box is a rectangle drawn around other windows to denote a
logical grouping of items.
"""
def Create(self, parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBoxNameStr):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, name=StaticBoxNameStr) -> bool
Creates the static box for two-step construction.
"""
# end of class StaticBox
#-- end-statbox --#
#-- begin-statusbar --#
STB_SIZEGRIP = 0
STB_SHOW_TIPS = 0
STB_ELLIPSIZE_START = 0
STB_ELLIPSIZE_MIDDLE = 0
STB_ELLIPSIZE_END = 0
STB_DEFAULT_STYLE = 0
SB_NORMAL = 0
SB_FLAT = 0
SB_RAISED = 0
SB_SUNKEN = 0
StatusBarNameStr = ""
class StatusBar(Control):
"""
StatusBar()
StatusBar(parent, id=ID_ANY, style=STB_DEFAULT_STYLE, name=StatusBarNameStr)
A status bar is a narrow window that can be placed along the bottom of
a frame to give small amounts of status information.
"""
def __init__(self, *args, **kw):
"""
StatusBar()
StatusBar(parent, id=ID_ANY, style=STB_DEFAULT_STYLE, name=StatusBarNameStr)
A status bar is a narrow window that can be placed along the bottom of
a frame to give small amounts of status information.
"""
def Create(self, parent, id=ID_ANY, style=STB_DEFAULT_STYLE, name=StatusBarNameStr):
"""
Create(parent, id=ID_ANY, style=STB_DEFAULT_STYLE, name=StatusBarNameStr) -> bool
Creates the window, for two-step construction.
"""
def GetFieldRect(self, i):
"""
GetFieldRect(i) -> Rect
Returns the size and position of a field's internal bounding
rectangle.
"""
def GetFieldsCount(self):
"""
GetFieldsCount() -> int
Returns the number of fields in the status bar.
"""
def GetField(self, n):
"""
GetField(n) -> StatusBarPane
Returns the wxStatusBarPane representing the n-th field.
"""
def GetBorders(self):
"""
GetBorders() -> Size
Returns the horizontal and vertical borders used when rendering the
field text inside the field area.
"""
def GetStatusText(self, i=0):
"""
GetStatusText(i=0) -> String
Returns the string associated with a status bar field.
"""
def GetStatusWidth(self, n):
"""
GetStatusWidth(n) -> int
Returns the width of the n-th field.
"""
def GetStatusStyle(self, n):
"""
GetStatusStyle(n) -> int
Returns the style of the n-th field.
"""
def PopStatusText(self, field=0):
"""
PopStatusText(field=0)
Restores the text to the value it had before the last call to
PushStatusText().
"""
def PushStatusText(self, string, field=0):
"""
PushStatusText(string, field=0)
Saves the current field text in a per-field stack, and sets the field
text to the string passed as argument.
"""
def SetFieldsCount(self, number=1, widths=None):
"""
SetFieldsCount(number=1, widths=None)
Sets the number of fields, and optionally the field widths.
"""
def SetMinHeight(self, height):
"""
SetMinHeight(height)
Sets the minimal possible height for the status bar.
"""
def SetStatusStyles(self, n, styles):
"""
SetStatusStyles(n, styles)
Sets the styles of the fields in the status line which can make fields
appear flat or raised instead of the standard sunken 3D border.
"""
def SetStatusText(self, text, i=0):
"""
SetStatusText(text, i=0)
Sets the status text for the i-th field.
"""
def SetStatusWidths(self, widths):
"""
SetStatusWidths(widths)
Sets the widths of the fields in the status line.
"""
Borders = property(None, None)
FieldRect = property(None, None)
FieldsCount = property(None, None)
StatusText = property(None, None)
# end of class StatusBar
class StatusBarPane(object):
"""
StatusBarPane(style=SB_NORMAL, width=0)
A status bar pane data container used by wxStatusBar.
"""
def __init__(self, style=SB_NORMAL, width=0):
"""
StatusBarPane(style=SB_NORMAL, width=0)
A status bar pane data container used by wxStatusBar.
"""
def GetWidth(self):
"""
GetWidth() -> int
Returns the pane width; it maybe negative, indicating a variable-width
field.
"""
def GetStyle(self):
"""
GetStyle() -> int
Returns the pane style.
"""
def GetText(self):
"""
GetText() -> String
Returns the text currently shown in this pane.
"""
Style = property(None, None)
Text = property(None, None)
Width = property(None, None)
# end of class StatusBarPane
#-- end-statusbar --#
#-- begin-choice --#
class Choice(Control, ItemContainer):
"""
Choice()
Choice(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ChoiceNameStr)
A choice item is used to select one of a list of strings.
"""
def __init__(self, *args, **kw):
"""
Choice()
Choice(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ChoiceNameStr)
A choice item is used to select one of a list of strings.
"""
def Create(self, *args, **kw):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ChoiceNameStr) -> bool
Creates the choice for two-step construction.
"""
def GetColumns(self):
"""
GetColumns() -> int
Gets the number of columns in this choice item.
"""
def GetCurrentSelection(self):
"""
GetCurrentSelection() -> int
Unlike wxControlWithItems::GetSelection() which only returns the
accepted selection value (the selection in the control once the user
closes the dropdown list), this function returns the current
selection.
"""
def SetColumns(self, n=1):
"""
SetColumns(n=1)
Sets the number of columns in this choice item.
"""
def IsSorted(self):
"""
IsSorted() -> bool
"""
def GetCount(self):
"""
GetCount() -> unsignedint
Returns the number of items in the control.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the index of the selected item or wxNOT_FOUND if no item is
selected.
"""
def SetSelection(self, n):
"""
SetSelection(n)
Sets the selection to the given item n or removes the selection
entirely if n == wxNOT_FOUND.
"""
def FindString(self, string, caseSensitive=False):
"""
FindString(string, caseSensitive=False) -> int
Finds an item whose label matches the given string.
"""
def GetString(self, n):
"""
GetString(n) -> String
Returns the label of the item with the given index.
"""
def SetString(self, n, string):
"""
SetString(n, string)
Sets the label for the given item.
"""
Columns = property(None, None)
Count = property(None, None)
CurrentSelection = property(None, None)
Selection = property(None, None)
# end of class Choice
#-- end-choice --#
#-- begin-anybutton --#
BU_LEFT = 0
BU_TOP = 0
BU_RIGHT = 0
BU_BOTTOM = 0
BU_ALIGN_MASK = 0
BU_EXACTFIT = 0
BU_NOTEXT = 0
BU_AUTODRAW = 0
class AnyButton(Control):
"""
AnyButton()
A class for common button functionality used as the base for the
various button classes.
"""
def __init__(self):
"""
AnyButton()
A class for common button functionality used as the base for the
various button classes.
"""
def SetBitmapMargins(self, *args, **kw):
"""
SetBitmapMargins(x, y)
SetBitmapMargins(sz)
Set the margins between the bitmap and the text of the button.
"""
def GetBitmap(self):
"""
GetBitmap() -> Bitmap
Return the bitmap shown by the button.
"""
def GetBitmapCurrent(self):
"""
GetBitmapCurrent() -> Bitmap
Returns the bitmap used when the mouse is over the button, which may
be invalid.
"""
def GetBitmapDisabled(self):
"""
GetBitmapDisabled() -> Bitmap
Returns the bitmap for the disabled state, which may be invalid.
"""
def GetBitmapFocus(self):
"""
GetBitmapFocus() -> Bitmap
Returns the bitmap for the focused state, which may be invalid.
"""
def GetBitmapLabel(self):
"""
GetBitmapLabel() -> Bitmap
Returns the bitmap for the normal state.
"""
def GetBitmapPressed(self):
"""
GetBitmapPressed() -> Bitmap
Returns the bitmap for the pressed state, which may be invalid.
"""
def SetBitmap(self, bitmap, dir=LEFT):
"""
SetBitmap(bitmap, dir=LEFT)
Sets the bitmap to display in the button.
"""
def SetBitmapCurrent(self, bitmap):
"""
SetBitmapCurrent(bitmap)
Sets the bitmap to be shown when the mouse is over the button.
"""
def SetBitmapDisabled(self, bitmap):
"""
SetBitmapDisabled(bitmap)
Sets the bitmap for the disabled button appearance.
"""
def SetBitmapFocus(self, bitmap):
"""
SetBitmapFocus(bitmap)
Sets the bitmap for the button appearance when it has the keyboard
focus.
"""
def SetBitmapLabel(self, bitmap):
"""
SetBitmapLabel(bitmap)
Sets the bitmap label for the button.
"""
def SetBitmapPressed(self, bitmap):
"""
SetBitmapPressed(bitmap)
Sets the bitmap for the selected (depressed) button appearance.
"""
def GetBitmapMargins(self):
"""
GetBitmapMargins() -> Size
Get the margins between the bitmap and the text of the button.
"""
def SetBitmapPosition(self, dir):
"""
SetBitmapPosition(dir)
Set the position at which the bitmap is displayed.
"""
Bitmap = property(None, None)
BitmapCurrent = property(None, None)
BitmapDisabled = property(None, None)
BitmapFocus = property(None, None)
BitmapLabel = property(None, None)
BitmapMargins = property(None, None)
BitmapPressed = property(None, None)
# end of class AnyButton
#-- end-anybutton --#
#-- begin-button --#
ButtonNameStr = ""
class Button(AnyButton):
"""
Button()
Button(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ButtonNameStr)
A button is a control that contains a text string, and is one of the
most common elements of a GUI.
"""
def __init__(self, *args, **kw):
"""
Button()
Button(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ButtonNameStr)
A button is a control that contains a text string, and is one of the
most common elements of a GUI.
"""
def Create(self, parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ButtonNameStr):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ButtonNameStr) -> bool
Button creation function for two-step creation.
"""
def GetAuthNeeded(self):
"""
GetAuthNeeded() -> bool
Returns true if an authentication needed symbol is displayed on the
button.
"""
def GetLabel(self):
"""
GetLabel() -> String
Returns the string label for the button.
"""
def SetAuthNeeded(self, needed=True):
"""
SetAuthNeeded(needed=True)
Sets whether an authentication needed symbol should be displayed on
the button.
"""
def SetDefault(self):
"""
SetDefault() -> Window
This sets the button to be the default item in its top-level window
(e.g.
"""
def SetLabel(self, label):
"""
SetLabel(label)
Sets the string label for the button.
"""
@staticmethod
def GetDefaultSize():
"""
GetDefaultSize() -> Size
Returns the default size for the buttons.
"""
AuthNeeded = property(None, None)
Label = property(None, None)
# end of class Button
#-- end-button --#
#-- begin-bmpbuttn --#
class BitmapButton(Button):
"""
BitmapButton()
BitmapButton(parent, id=ID_ANY, bitmap=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=BU_AUTODRAW, validator=DefaultValidator, name=ButtonNameStr)
A bitmap button is a control that contains a bitmap.
"""
def __init__(self, *args, **kw):
"""
BitmapButton()
BitmapButton(parent, id=ID_ANY, bitmap=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=BU_AUTODRAW, validator=DefaultValidator, name=ButtonNameStr)
A bitmap button is a control that contains a bitmap.
"""
def Create(self, parent, id=ID_ANY, bitmap=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=BU_AUTODRAW, validator=DefaultValidator, name=ButtonNameStr):
"""
Create(parent, id=ID_ANY, bitmap=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=BU_AUTODRAW, validator=DefaultValidator, name=ButtonNameStr) -> bool
Button creation function for two-step creation.
"""
@staticmethod
def NewCloseButton(parent, winid):
"""
NewCloseButton(parent, winid) -> BitmapButton
Helper function creating a standard-looking "Close" button.
"""
# end of class BitmapButton
#-- end-bmpbuttn --#
#-- begin-withimage --#
class WithImages(object):
"""
WithImages()
A mixin class to be used with other classes that use a wxImageList.
"""
NO_IMAGE = 0
def __init__(self):
"""
WithImages()
A mixin class to be used with other classes that use a wxImageList.
"""
def AssignImageList(self, imageList):
"""
AssignImageList(imageList)
Sets the image list for the page control and takes ownership of the
list.
"""
def SetImageList(self, imageList):
"""
SetImageList(imageList)
Sets the image list to use.
"""
def GetImageList(self):
"""
GetImageList() -> ImageList
Returns the associated image list, may be NULL.
"""
ImageList = property(None, None)
# end of class WithImages
NO_IMAGE = 0
#-- end-withimage --#
#-- begin-bookctrl --#
BK_DEFAULT = 0
BK_TOP = 0
BK_BOTTOM = 0
BK_LEFT = 0
BK_RIGHT = 0
BK_ALIGN_MASK = 0
BK_HITTEST_NOWHERE = 0
BK_HITTEST_ONICON = 0
BK_HITTEST_ONLABEL = 0
BK_HITTEST_ONITEM = 0
BK_HITTEST_ONPAGE = 0
class BookCtrlBase(Control, WithImages):
"""
BookCtrlBase()
BookCtrlBase(parent, winid, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
A book control is a convenient way of displaying multiple pages of
information, displayed one page at a time.
"""
NO_IMAGE = 0
def __init__(self, *args, **kw):
"""
BookCtrlBase()
BookCtrlBase(parent, winid, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
A book control is a convenient way of displaying multiple pages of
information, displayed one page at a time.
"""
def GetPageImage(self, nPage):
"""
GetPageImage(nPage) -> int
Returns the image index for the given page.
"""
def SetPageImage(self, page, image):
"""
SetPageImage(page, image) -> bool
Sets the image index for the given page.
"""
def GetPageText(self, nPage):
"""
GetPageText(nPage) -> String
Returns the string for the given page.
"""
def SetPageText(self, page, text):
"""
SetPageText(page, text) -> bool
Sets the text for the given page.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the currently selected page, or wxNOT_FOUND if none was
selected.
"""
def GetCurrentPage(self):
"""
GetCurrentPage() -> Window
Returns the currently selected page or NULL.
"""
def SetSelection(self, page):
"""
SetSelection(page) -> int
Sets the selection to the given page, returning the previous
selection.
"""
def AdvanceSelection(self, forward=True):
"""
AdvanceSelection(forward=True)
Cycles through the tabs.
"""
def ChangeSelection(self, page):
"""
ChangeSelection(page) -> int
Changes the selection to the given page, returning the previous
selection.
"""
def FindPage(self, page):
"""
FindPage(page) -> int
Returns the index of the specified tab window or wxNOT_FOUND if not
found.
"""
def AddPage(self, page, text, select=False, imageId=NO_IMAGE):
"""
AddPage(page, text, select=False, imageId=NO_IMAGE) -> bool
Adds a new page.
"""
def DeleteAllPages(self):
"""
DeleteAllPages() -> bool
Deletes all pages.
"""
def DeletePage(self, page):
"""
DeletePage(page) -> bool
Deletes the specified page, and the associated window.
"""
def InsertPage(self, index, page, text, select=False, imageId=NO_IMAGE):
"""
InsertPage(index, page, text, select=False, imageId=NO_IMAGE) -> bool
Inserts a new page at the specified position.
"""
def RemovePage(self, page):
"""
RemovePage(page) -> bool
Deletes the specified page, without deleting the associated window.
"""
def GetPageCount(self):
"""
GetPageCount() -> size_t
Returns the number of pages in the control.
"""
def GetPage(self, page):
"""
GetPage(page) -> Window
Returns the window at the given page position.
"""
def Create(self, parent, winid, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString):
"""
Create(parent, winid, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString) -> bool
Constructs the book control with the given parameters.
"""
def SetPageSize(self, size):
"""
SetPageSize(size)
Sets the width and height of the pages.
"""
def HitTest(self, pt):
"""
HitTest(pt) -> (int, flags)
Returns the index of the tab at the specified position or wxNOT_FOUND
if none.
"""
CurrentPage = property(None, None)
PageCount = property(None, None)
Selection = property(None, None)
# end of class BookCtrlBase
class BookCtrlEvent(NotifyEvent):
"""
BookCtrlEvent(eventType=wxEVT_NULL, id=0, sel=NOT_FOUND, oldSel=NOT_FOUND)
This class represents the events generated by book controls
(wxNotebook, wxListbook, wxChoicebook, wxTreebook, wxAuiNotebook).
"""
def __init__(self, eventType=wxEVT_NULL, id=0, sel=NOT_FOUND, oldSel=NOT_FOUND):
"""
BookCtrlEvent(eventType=wxEVT_NULL, id=0, sel=NOT_FOUND, oldSel=NOT_FOUND)
This class represents the events generated by book controls
(wxNotebook, wxListbook, wxChoicebook, wxTreebook, wxAuiNotebook).
"""
def GetOldSelection(self):
"""
GetOldSelection() -> int
Returns the page that was selected before the change, wxNOT_FOUND if
none was selected.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the currently selected page, or wxNOT_FOUND if none was
selected.
"""
def SetOldSelection(self, page):
"""
SetOldSelection(page)
Sets the id of the page selected before the change.
"""
def SetSelection(self, page):
"""
SetSelection(page)
Sets the selection member variable.
"""
OldSelection = property(None, None)
Selection = property(None, None)
# end of class BookCtrlEvent
#-- end-bookctrl --#
#-- begin-notebook --#
NB_DEFAULT = 0
NB_TOP = 0
NB_BOTTOM = 0
NB_LEFT = 0
NB_RIGHT = 0
NB_FIXEDWIDTH = 0
NB_MULTILINE = 0
NB_NOPAGETHEME = 0
NB_FLAT = 0
NB_HITTEST_NOWHERE = 0
NB_HITTEST_ONICON = 0
NB_HITTEST_ONLABEL = 0
NB_HITTEST_ONITEM = 0
NB_HITTEST_ONPAGE = 0
wxEVT_NOTEBOOK_PAGE_CHANGED = 0
wxEVT_NOTEBOOK_PAGE_CHANGING = 0
NotebookNameStr = ""
class Notebook(BookCtrlBase):
"""
Notebook()
Notebook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=NotebookNameStr)
This class represents a notebook control, which manages multiple
windows with associated tabs.
"""
def __init__(self, *args, **kw):
"""
Notebook()
Notebook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=NotebookNameStr)
This class represents a notebook control, which manages multiple
windows with associated tabs.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=NotebookNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=NotebookNameStr) -> bool
Creates a notebook control.
"""
def GetRowCount(self):
"""
GetRowCount() -> int
Returns the number of rows in the notebook control.
"""
def GetThemeBackgroundColour(self):
"""
GetThemeBackgroundColour() -> Colour
If running under Windows and themes are enabled for the application,
this function returns a suitable colour for painting the background of
a notebook page, and can be passed to SetBackgroundColour().
"""
def SetPadding(self, padding):
"""
SetPadding(padding)
Sets the amount of space around each page's icon and label, in pixels.
"""
def GetPageImage(self, nPage):
"""
GetPageImage(nPage) -> int
Returns the image index for the given page.
"""
def SetPageImage(self, page, image):
"""
SetPageImage(page, image) -> bool
Sets the image index for the given page.
"""
def GetPageText(self, nPage):
"""
GetPageText(nPage) -> String
Returns the string for the given page.
"""
def SetPageText(self, page, text):
"""
SetPageText(page, text) -> bool
Sets the text for the given page.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the currently selected page, or wxNOT_FOUND if none was
selected.
"""
def SetSelection(self, page):
"""
SetSelection(page) -> int
Sets the selection to the given page, returning the previous
selection.
"""
def ChangeSelection(self, page):
"""
ChangeSelection(page) -> int
Changes the selection to the given page, returning the previous
selection.
"""
def InsertPage(self, index, page, text, select=False, imageId=NO_IMAGE):
"""
InsertPage(index, page, text, select=False, imageId=NO_IMAGE) -> bool
Inserts a new page at the specified position.
"""
RowCount = property(None, None)
Selection = property(None, None)
ThemeBackgroundColour = property(None, None)
# end of class Notebook
EVT_NOTEBOOK_PAGE_CHANGED = wx.PyEventBinder( wxEVT_NOTEBOOK_PAGE_CHANGED, 1 )
EVT_NOTEBOOK_PAGE_CHANGING = wx.PyEventBinder( wxEVT_NOTEBOOK_PAGE_CHANGING, 1 )
# Aliases for the "best book" control as described in the overview
BookCtrl = Notebook
wxEVT_BOOKCTRL_PAGE_CHANGED = wxEVT_NOTEBOOK_PAGE_CHANGED
wxEVT_BOOKCTRL_PAGE_CHANGING = wxEVT_NOTEBOOK_PAGE_CHANGING
EVT_BOOKCTRL_PAGE_CHANGED = EVT_NOTEBOOK_PAGE_CHANGED
EVT_BOOKCTRL_PAGE_CHANGING = EVT_NOTEBOOK_PAGE_CHANGING
# deprecated wxEVT aliases
wxEVT_COMMAND_BOOKCTRL_PAGE_CHANGED = wxEVT_BOOKCTRL_PAGE_CHANGED
wxEVT_COMMAND_BOOKCTRL_PAGE_CHANGING = wxEVT_BOOKCTRL_PAGE_CHANGING
wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED = wxEVT_NOTEBOOK_PAGE_CHANGED
wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING = wxEVT_NOTEBOOK_PAGE_CHANGING
#-- end-notebook --#
#-- begin-splitter --#
SP_NOBORDER = 0
SP_THIN_SASH = 0
SP_NOSASH = 0
SP_PERMIT_UNSPLIT = 0
SP_LIVE_UPDATE = 0
SP_3DSASH = 0
SP_3DBORDER = 0
SP_NO_XP_THEME = 0
SP_BORDER = 0
SP_3D = 0
SPLIT_HORIZONTAL = 0
SPLIT_VERTICAL = 0
SPLIT_DRAG_NONE = 0
SPLIT_DRAG_DRAGGING = 0
SPLIT_DRAG_LEFT_DOWN = 0
wxEVT_SPLITTER_SASH_POS_CHANGED = 0
wxEVT_SPLITTER_SASH_POS_CHANGING = 0
wxEVT_SPLITTER_DOUBLECLICKED = 0
wxEVT_SPLITTER_UNSPLIT = 0
class SplitterWindow(Window):
"""
SplitterWindow()
SplitterWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SP_3D, name="splitterWindow")
This class manages up to two subwindows.
"""
def __init__(self, *args, **kw):
"""
SplitterWindow()
SplitterWindow(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SP_3D, name="splitterWindow")
This class manages up to two subwindows.
"""
def Create(self, parent, id=ID_ANY, point=DefaultPosition, size=DefaultSize, style=SP_3D, name="splitter"):
"""
Create(parent, id=ID_ANY, point=DefaultPosition, size=DefaultSize, style=SP_3D, name="splitter") -> bool
Creation function, for two-step construction.
"""
def GetMinimumPaneSize(self):
"""
GetMinimumPaneSize() -> int
Returns the current minimum pane size (defaults to zero).
"""
def GetSashGravity(self):
"""
GetSashGravity() -> double
Returns the current sash gravity.
"""
def GetSashPosition(self):
"""
GetSashPosition() -> int
Returns the current sash position.
"""
def GetSashSize(self):
"""
GetSashSize() -> int
Returns the default sash size in pixels or 0 if it is invisible.
"""
def GetDefaultSashSize(self):
"""
GetDefaultSashSize() -> int
Returns the default sash size in pixels.
"""
def GetSplitMode(self):
"""
GetSplitMode() -> SplitMode
Gets the split mode.
"""
def GetWindow1(self):
"""
GetWindow1() -> Window
Returns the left/top or only pane.
"""
def GetWindow2(self):
"""
GetWindow2() -> Window
Returns the right/bottom pane.
"""
def Initialize(self, window):
"""
Initialize(window)
Initializes the splitter window to have one pane.
"""
def IsSashInvisible(self):
"""
IsSashInvisible() -> bool
Returns true if the sash is invisible even when the window is split,
false otherwise.
"""
def IsSplit(self):
"""
IsSplit() -> bool
Returns true if the window is split, false otherwise.
"""
def ReplaceWindow(self, winOld, winNew):
"""
ReplaceWindow(winOld, winNew) -> bool
This function replaces one of the windows managed by the
wxSplitterWindow with another one.
"""
def SetMinimumPaneSize(self, paneSize):
"""
SetMinimumPaneSize(paneSize)
Sets the minimum pane size.
"""
def SetSashGravity(self, gravity):
"""
SetSashGravity(gravity)
Sets the sash gravity.
"""
def SetSashPosition(self, position, redraw=True):
"""
SetSashPosition(position, redraw=True)
Sets the sash position.
"""
def SetSplitMode(self, mode):
"""
SetSplitMode(mode)
Sets the split mode.
"""
def SetSashInvisible(self, invisible=True):
"""
SetSashInvisible(invisible=True)
Sets whether the sash should be invisible, even when the window is
split.
"""
def SplitHorizontally(self, window1, window2, sashPosition=0):
"""
SplitHorizontally(window1, window2, sashPosition=0) -> bool
Initializes the top and bottom panes of the splitter window.
"""
def SplitVertically(self, window1, window2, sashPosition=0):
"""
SplitVertically(window1, window2, sashPosition=0) -> bool
Initializes the left and right panes of the splitter window.
"""
def Unsplit(self, toRemove=None):
"""
Unsplit(toRemove=None) -> bool
Unsplits the window.
"""
def UpdateSize(self):
"""
UpdateSize()
Causes any pending sizing of the sash and child panes to take place
immediately.
"""
DefaultSashSize = property(None, None)
MinimumPaneSize = property(None, None)
SashGravity = property(None, None)
SashPosition = property(None, None)
SashSize = property(None, None)
SplitMode = property(None, None)
Window1 = property(None, None)
Window2 = property(None, None)
SashInvisible = property(None, None)
# end of class SplitterWindow
class SplitterEvent(NotifyEvent):
"""
SplitterEvent(eventType=wxEVT_NULL, splitter=None)
This class represents the events generated by a splitter control.
"""
def __init__(self, eventType=wxEVT_NULL, splitter=None):
"""
SplitterEvent(eventType=wxEVT_NULL, splitter=None)
This class represents the events generated by a splitter control.
"""
def GetSashPosition(self):
"""
GetSashPosition() -> int
Returns the new sash position.
"""
def GetWindowBeingRemoved(self):
"""
GetWindowBeingRemoved() -> Window
Returns a pointer to the window being removed when a splitter window
is unsplit.
"""
def GetX(self):
"""
GetX() -> int
Returns the x coordinate of the double-click point.
"""
def GetY(self):
"""
GetY() -> int
Returns the y coordinate of the double-click point.
"""
def SetSashPosition(self, pos):
"""
SetSashPosition(pos)
In the case of wxEVT_SPLITTER_SASH_POS_CHANGED events, sets the new
sash position.
"""
EVT_SPLITTER_SASH_POS_CHANGED = wx.PyEventBinder( wxEVT_SPLITTER_SASH_POS_CHANGED, 1 )
EVT_SPLITTER_SASH_POS_CHANGING = wx.PyEventBinder( wxEVT_SPLITTER_SASH_POS_CHANGING, 1 )
EVT_SPLITTER_DOUBLECLICKED = wx.PyEventBinder( wxEVT_SPLITTER_DOUBLECLICKED, 1 )
EVT_SPLITTER_UNSPLIT = wx.PyEventBinder( wxEVT_SPLITTER_UNSPLIT, 1 )
EVT_SPLITTER_DCLICK = EVT_SPLITTER_DOUBLECLICKED
# deprecated wxEVT aliases
wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED = wxEVT_SPLITTER_SASH_POS_CHANGED
wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING = wxEVT_SPLITTER_SASH_POS_CHANGING
wxEVT_COMMAND_SPLITTER_DOUBLECLICKED = wxEVT_SPLITTER_DOUBLECLICKED
wxEVT_COMMAND_SPLITTER_UNSPLIT = wxEVT_SPLITTER_UNSPLIT
SashPosition = property(None, None)
WindowBeingRemoved = property(None, None)
X = property(None, None)
Y = property(None, None)
# end of class SplitterEvent
#-- end-splitter --#
#-- begin-collpane --#
CP_DEFAULT_STYLE = 0
CP_NO_TLW_RESIZE = 0
wxEVT_COLLAPSIBLEPANE_CHANGED = 0
CollapsiblePaneNameStr = ""
class CollapsiblePane(Control):
"""
CollapsiblePane()
CollapsiblePane(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CP_DEFAULT_STYLE, validator=DefaultValidator, name=CollapsiblePaneNameStr)
A collapsible pane is a container with an embedded button-like control
which can be used by the user to collapse or expand the pane's
contents.
"""
def __init__(self, *args, **kw):
"""
CollapsiblePane()
CollapsiblePane(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CP_DEFAULT_STYLE, validator=DefaultValidator, name=CollapsiblePaneNameStr)
A collapsible pane is a container with an embedded button-like control
which can be used by the user to collapse or expand the pane's
contents.
"""
def Create(self, parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CP_DEFAULT_STYLE, validator=DefaultValidator, name=CollapsiblePaneNameStr):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CP_DEFAULT_STYLE, validator=DefaultValidator, name=CollapsiblePaneNameStr) -> bool
"""
def Collapse(self, collapse=True):
"""
Collapse(collapse=True)
Collapses or expands the pane window.
"""
def Expand(self):
"""
Expand()
Same as calling Collapse(false).
"""
def GetPane(self):
"""
GetPane() -> Window
Returns a pointer to the pane window.
"""
def IsCollapsed(self):
"""
IsCollapsed() -> bool
Returns true if the pane window is currently hidden.
"""
def IsExpanded(self):
"""
IsExpanded() -> bool
Returns true if the pane window is currently shown.
"""
Pane = property(None, None)
# end of class CollapsiblePane
class CollapsiblePaneEvent(CommandEvent):
"""
CollapsiblePaneEvent(generator, id, collapsed)
This event class is used for the events generated by
wxCollapsiblePane.
"""
def __init__(self, generator, id, collapsed):
"""
CollapsiblePaneEvent(generator, id, collapsed)
This event class is used for the events generated by
wxCollapsiblePane.
"""
def GetCollapsed(self):
"""
GetCollapsed() -> bool
Returns true if the pane has been collapsed.
"""
def SetCollapsed(self, collapsed):
"""
SetCollapsed(collapsed)
Sets this as a collapsed pane event (if collapsed is true) or as an
expanded pane event (if collapsed is false).
"""
Collapsed = property(None, None)
# end of class CollapsiblePaneEvent
EVT_COLLAPSIBLEPANE_CHANGED = wx.PyEventBinder( wxEVT_COLLAPSIBLEPANE_CHANGED )
# deprecated wxEVT alias
wxEVT_COMMAND_COLLPANE_CHANGED = wxEVT_COLLAPSIBLEPANE_CHANGED
#-- end-collpane --#
#-- begin-statline --#
StaticLineNameStr = ""
class StaticLine(Control):
"""
StaticLine()
StaticLine(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LI_HORIZONTAL, name=StaticLineNameStr)
A static line is just a line which may be used in a dialog to separate
the groups of controls.
"""
def __init__(self, *args, **kw):
"""
StaticLine()
StaticLine(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LI_HORIZONTAL, name=StaticLineNameStr)
A static line is just a line which may be used in a dialog to separate
the groups of controls.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LI_HORIZONTAL, name=StaticLineNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LI_HORIZONTAL, name=StaticLineNameStr) -> bool
Creates the static line for two-step construction.
"""
def IsVertical(self):
"""
IsVertical() -> bool
Returns true if the line is vertical, false if horizontal.
"""
@staticmethod
def GetDefaultSize():
"""
GetDefaultSize() -> int
This static function returns the size which will be given to the
smaller dimension of the static line, i.e.
"""
# end of class StaticLine
#-- end-statline --#
#-- begin-textcompleter --#
class TextCompleter(object):
"""
Base class for custom text completer objects.
"""
def Start(self, prefix):
"""
Start(prefix) -> bool
Function called to start iteration over the completions for the given
prefix.
"""
def GetNext(self):
"""
GetNext() -> String
Called to retrieve the next completion.
"""
Next = property(None, None)
# end of class TextCompleter
class TextCompleterSimple(TextCompleter):
"""
A simpler base class for custom completer objects.
"""
def GetCompletions(self, prefix, res):
"""
GetCompletions(prefix, res)
Pure virtual method returning all possible completions for the given
prefix.
"""
# end of class TextCompleterSimple
#-- end-textcompleter --#
#-- begin-textentry --#
class TextEntry(object):
"""
Common base class for single line text entry fields.
"""
def SetMargins(self, *args, **kw):
"""
SetMargins(pt) -> bool
SetMargins(left, top=-1) -> bool
Attempts to set the control margins.
"""
def AppendText(self, text):
"""
AppendText(text)
Appends the text to the end of the text control.
"""
def AutoComplete(self, *args, **kw):
"""
AutoComplete(choices) -> bool
AutoComplete(completer) -> bool
Call this function to enable auto-completion of the text typed in a
single-line text control using the given choices.
"""
def AutoCompleteFileNames(self):
"""
AutoCompleteFileNames() -> bool
Call this function to enable auto-completion of the text typed in a
single-line text control using all valid file system paths.
"""
def AutoCompleteDirectories(self):
"""
AutoCompleteDirectories() -> bool
Call this function to enable auto-completion of the text using the
file system directories.
"""
def CanCopy(self):
"""
CanCopy() -> bool
Returns true if the selection can be copied to the clipboard.
"""
def CanCut(self):
"""
CanCut() -> bool
Returns true if the selection can be cut to the clipboard.
"""
def CanPaste(self):
"""
CanPaste() -> bool
Returns true if the contents of the clipboard can be pasted into the
text control.
"""
def CanRedo(self):
"""
CanRedo() -> bool
Returns true if there is a redo facility available and the last
operation can be redone.
"""
def CanUndo(self):
"""
CanUndo() -> bool
Returns true if there is an undo facility available and the last
operation can be undone.
"""
def ChangeValue(self, value):
"""
ChangeValue(value)
Sets the new text control value.
"""
def Clear(self):
"""
Clear()
Clears the text in the control.
"""
def Copy(self):
"""
Copy()
Copies the selected text to the clipboard.
"""
def Cut(self):
"""
Cut()
Copies the selected text to the clipboard and removes it from the
control.
"""
def GetInsertionPoint(self):
"""
GetInsertionPoint() -> long
Returns the insertion point, or cursor, position.
"""
def GetLastPosition(self):
"""
GetLastPosition() -> TextPos
Returns the zero based index of the last position in the text control,
which is equal to the number of characters in the control.
"""
def GetRange(self, from_, to_):
"""
GetRange(from_, to_) -> String
Returns the string containing the text starting in the positions from
and up to to in the control.
"""
def GetSelection(self):
"""
GetSelection() -> (from, to)
Gets the current selection span.
"""
def GetStringSelection(self):
"""
GetStringSelection() -> String
Gets the text currently selected in the control.
"""
def GetValue(self):
"""
GetValue() -> String
Gets the contents of the control.
"""
def IsEditable(self):
"""
IsEditable() -> bool
Returns true if the controls contents may be edited by user (note that
it always can be changed by the program).
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Returns true if the control is currently empty.
"""
def Paste(self):
"""
Paste()
Pastes text from the clipboard to the text item.
"""
def Redo(self):
"""
Redo()
If there is a redo facility and the last operation can be redone,
redoes the last operation.
"""
def Remove(self, from_, to_):
"""
Remove(from_, to_)
Removes the text starting at the first given position up to (but not
including) the character at the last position.
"""
def Replace(self, from_, to_, value):
"""
Replace(from_, to_, value)
Replaces the text starting at the first position up to (but not
including) the character at the last position with the given text.
"""
def SetEditable(self, editable):
"""
SetEditable(editable)
Makes the text item editable or read-only, overriding the
wxTE_READONLY flag.
"""
def SetInsertionPoint(self, pos):
"""
SetInsertionPoint(pos)
Sets the insertion point at the given position.
"""
def SetInsertionPointEnd(self):
"""
SetInsertionPointEnd()
Sets the insertion point at the end of the text control.
"""
def SetMaxLength(self, len):
"""
SetMaxLength(len)
This function sets the maximum number of characters the user can enter
into the control.
"""
def SetSelection(self, from_, to_):
"""
SetSelection(from_, to_)
Selects the text starting at the first position up to (but not
including) the character at the last position.
"""
def SelectAll(self):
"""
SelectAll()
Selects all text in the control.
"""
def SelectNone(self):
"""
SelectNone()
Deselects selected text in the control.
"""
def SetHint(self, hint):
"""
SetHint(hint) -> bool
Sets a hint shown in an empty unfocused text control.
"""
def GetHint(self):
"""
GetHint() -> String
Returns the current hint string.
"""
def GetMargins(self):
"""
GetMargins() -> Point
Returns the margins used by the control.
"""
def SetValue(self, value):
"""
SetValue(value)
Sets the new text control value.
"""
def Undo(self):
"""
Undo()
If there is an undo facility and the last operation can be undone,
undoes the last operation.
"""
def WriteText(self, text):
"""
WriteText(text)
Writes the text into the text control at the current insertion
position.
"""
Hint = property(None, None)
InsertionPoint = property(None, None)
LastPosition = property(None, None)
Margins = property(None, None)
StringSelection = property(None, None)
Value = property(None, None)
# end of class TextEntry
#-- end-textentry --#
#-- begin-textctrl --#
TE_NO_VSCROLL = 0
TE_READONLY = 0
TE_MULTILINE = 0
TE_PROCESS_TAB = 0
TE_LEFT = 0
TE_CENTER = 0
TE_RIGHT = 0
TE_CENTRE = 0
TE_RICH = 0
TE_PROCESS_ENTER = 0
TE_PASSWORD = 0
TE_AUTO_URL = 0
TE_NOHIDESEL = 0
TE_DONTWRAP = 0
TE_CHARWRAP = 0
TE_WORDWRAP = 0
TE_BESTWRAP = 0
TE_RICH2 = 0
TEXT_TYPE_ANY = 0
TEXT_ALIGNMENT_DEFAULT = 0
TEXT_ALIGNMENT_LEFT = 0
TEXT_ALIGNMENT_CENTRE = 0
TEXT_ALIGNMENT_CENTER = 0
TEXT_ALIGNMENT_RIGHT = 0
TEXT_ALIGNMENT_JUSTIFIED = 0
TEXT_ATTR_TEXT_COLOUR = 0
TEXT_ATTR_BACKGROUND_COLOUR = 0
TEXT_ATTR_FONT_FACE = 0
TEXT_ATTR_FONT_POINT_SIZE = 0
TEXT_ATTR_FONT_PIXEL_SIZE = 0
TEXT_ATTR_FONT_WEIGHT = 0
TEXT_ATTR_FONT_ITALIC = 0
TEXT_ATTR_FONT_UNDERLINE = 0
TEXT_ATTR_FONT_STRIKETHROUGH = 0
TEXT_ATTR_FONT_ENCODING = 0
TEXT_ATTR_FONT_FAMILY = 0
TEXT_ATTR_FONT_SIZE = 0
TEXT_ATTR_FONT = 0
TEXT_ATTR_ALIGNMENT = 0
TEXT_ATTR_LEFT_INDENT = 0
TEXT_ATTR_RIGHT_INDENT = 0
TEXT_ATTR_TABS = 0
TEXT_ATTR_PARA_SPACING_AFTER = 0
TEXT_ATTR_PARA_SPACING_BEFORE = 0
TEXT_ATTR_LINE_SPACING = 0
TEXT_ATTR_CHARACTER_STYLE_NAME = 0
TEXT_ATTR_PARAGRAPH_STYLE_NAME = 0
TEXT_ATTR_LIST_STYLE_NAME = 0
TEXT_ATTR_BULLET_STYLE = 0
TEXT_ATTR_BULLET_NUMBER = 0
TEXT_ATTR_BULLET_TEXT = 0
TEXT_ATTR_BULLET_NAME = 0
TEXT_ATTR_BULLET = 0
TEXT_ATTR_URL = 0
TEXT_ATTR_PAGE_BREAK = 0
TEXT_ATTR_EFFECTS = 0
TEXT_ATTR_OUTLINE_LEVEL = 0
TEXT_ATTR_CHARACTER = 0
TEXT_ATTR_PARAGRAPH = 0
TEXT_ATTR_ALL = 0
TEXT_ATTR_BULLET_STYLE_NONE = 0
TEXT_ATTR_BULLET_STYLE_ARABIC = 0
TEXT_ATTR_BULLET_STYLE_LETTERS_UPPER = 0
TEXT_ATTR_BULLET_STYLE_LETTERS_LOWER = 0
TEXT_ATTR_BULLET_STYLE_ROMAN_UPPER = 0
TEXT_ATTR_BULLET_STYLE_ROMAN_LOWER = 0
TEXT_ATTR_BULLET_STYLE_SYMBOL = 0
TEXT_ATTR_BULLET_STYLE_BITMAP = 0
TEXT_ATTR_BULLET_STYLE_PARENTHESES = 0
TEXT_ATTR_BULLET_STYLE_PERIOD = 0
TEXT_ATTR_BULLET_STYLE_STANDARD = 0
TEXT_ATTR_BULLET_STYLE_RIGHT_PARENTHESIS = 0
TEXT_ATTR_BULLET_STYLE_OUTLINE = 0
TEXT_ATTR_BULLET_STYLE_ALIGN_LEFT = 0
TEXT_ATTR_BULLET_STYLE_ALIGN_RIGHT = 0
TEXT_ATTR_BULLET_STYLE_ALIGN_CENTRE = 0
TEXT_ATTR_BULLET_STYLE_CONTINUATION = 0
TEXT_ATTR_EFFECT_NONE = 0
TEXT_ATTR_EFFECT_CAPITALS = 0
TEXT_ATTR_EFFECT_SMALL_CAPITALS = 0
TEXT_ATTR_EFFECT_STRIKETHROUGH = 0
TEXT_ATTR_EFFECT_DOUBLE_STRIKETHROUGH = 0
TEXT_ATTR_EFFECT_SHADOW = 0
TEXT_ATTR_EFFECT_EMBOSS = 0
TEXT_ATTR_EFFECT_OUTLINE = 0
TEXT_ATTR_EFFECT_ENGRAVE = 0
TEXT_ATTR_EFFECT_SUPERSCRIPT = 0
TEXT_ATTR_EFFECT_SUBSCRIPT = 0
TEXT_ATTR_LINE_SPACING_NORMAL = 0
TEXT_ATTR_LINE_SPACING_HALF = 0
TEXT_ATTR_LINE_SPACING_TWICE = 0
TE_HT_UNKNOWN = 0
TE_HT_BEFORE = 0
TE_HT_ON_TEXT = 0
TE_HT_BELOW = 0
TE_HT_BEYOND = 0
wxEVT_TEXT = 0
wxEVT_TEXT_ENTER = 0
wxEVT_TEXT_URL = 0
wxEVT_TEXT_MAXLEN = 0
class TextAttr(object):
"""
TextAttr()
TextAttr(colText, colBack=NullColour, font=NullFont, alignment=TEXT_ALIGNMENT_DEFAULT)
TextAttr(attr)
wxTextAttr represents the character and paragraph attributes, or
style, for a range of text in a wxTextCtrl or wxRichTextCtrl.
"""
def __init__(self, *args, **kw):
"""
TextAttr()
TextAttr(colText, colBack=NullColour, font=NullFont, alignment=TEXT_ALIGNMENT_DEFAULT)
TextAttr(attr)
wxTextAttr represents the character and paragraph attributes, or
style, for a range of text in a wxTextCtrl or wxRichTextCtrl.
"""
def GetAlignment(self):
"""
GetAlignment() -> TextAttrAlignment
Returns the alignment flags.
"""
def GetBackgroundColour(self):
"""
GetBackgroundColour() -> Colour
Returns the background colour.
"""
def GetBulletFont(self):
"""
GetBulletFont() -> String
Returns a string containing the name of the font associated with the
bullet symbol.
"""
def GetBulletName(self):
"""
GetBulletName() -> String
Returns the standard bullet name, applicable if the bullet style is
wxTEXT_ATTR_BULLET_STYLE_STANDARD.
"""
def GetBulletNumber(self):
"""
GetBulletNumber() -> int
Returns the bullet number.
"""
def GetBulletStyle(self):
"""
GetBulletStyle() -> int
Returns the bullet style.
"""
def GetBulletText(self):
"""
GetBulletText() -> String
Returns the bullet text, which could be a symbol, or (for example)
cached outline text.
"""
def GetCharacterStyleName(self):
"""
GetCharacterStyleName() -> String
Returns the name of the character style.
"""
def GetFlags(self):
"""
GetFlags() -> long
Returns flags indicating which attributes are applicable.
"""
def GetFont(self):
"""
GetFont() -> Font
Creates and returns a font specified by the font attributes in the
wxTextAttr object.
"""
def GetFontAttributes(self, font, flags=TEXT_ATTR_FONT):
"""
GetFontAttributes(font, flags=TEXT_ATTR_FONT) -> bool
Gets the font attributes from the given font, using only the
attributes specified by flags.
"""
def GetFontEncoding(self):
"""
GetFontEncoding() -> FontEncoding
Returns the font encoding.
"""
def GetFontFaceName(self):
"""
GetFontFaceName() -> String
Returns the font face name.
"""
def GetFontFamily(self):
"""
GetFontFamily() -> FontFamily
Returns the font family.
"""
def GetFontSize(self):
"""
GetFontSize() -> int
Returns the font size in points.
"""
def GetFontStyle(self):
"""
GetFontStyle() -> FontStyle
Returns the font style.
"""
def GetFontUnderlined(self):
"""
GetFontUnderlined() -> bool
Returns true if the font is underlined.
"""
def GetFontWeight(self):
"""
GetFontWeight() -> FontWeight
Returns the font weight.
"""
def GetLeftIndent(self):
"""
GetLeftIndent() -> long
Returns the left indent in tenths of a millimetre.
"""
def GetLeftSubIndent(self):
"""
GetLeftSubIndent() -> long
Returns the left sub-indent in tenths of a millimetre.
"""
def GetLineSpacing(self):
"""
GetLineSpacing() -> int
Returns the line spacing value, one of wxTextAttrLineSpacing values.
"""
def GetListStyleName(self):
"""
GetListStyleName() -> String
Returns the name of the list style.
"""
def GetOutlineLevel(self):
"""
GetOutlineLevel() -> int
Returns the outline level.
"""
def GetParagraphSpacingAfter(self):
"""
GetParagraphSpacingAfter() -> int
Returns the space in tenths of a millimeter after the paragraph.
"""
def GetParagraphSpacingBefore(self):
"""
GetParagraphSpacingBefore() -> int
Returns the space in tenths of a millimeter before the paragraph.
"""
def GetParagraphStyleName(self):
"""
GetParagraphStyleName() -> String
Returns the name of the paragraph style.
"""
def GetRightIndent(self):
"""
GetRightIndent() -> long
Returns the right indent in tenths of a millimeter.
"""
def GetTabs(self):
"""
GetTabs() -> ArrayInt
Returns an array of tab stops, each expressed in tenths of a
millimeter.
"""
def GetTextColour(self):
"""
GetTextColour() -> Colour
Returns the text foreground colour.
"""
def GetTextEffectFlags(self):
"""
GetTextEffectFlags() -> int
Returns the text effect bits of interest.
"""
def GetTextEffects(self):
"""
GetTextEffects() -> int
Returns the text effects, a bit list of styles.
"""
def GetURL(self):
"""
GetURL() -> String
Returns the URL for the content.
"""
def HasAlignment(self):
"""
HasAlignment() -> bool
Returns true if the attribute object specifies alignment.
"""
def HasBackgroundColour(self):
"""
HasBackgroundColour() -> bool
Returns true if the attribute object specifies a background colour.
"""
def HasBulletName(self):
"""
HasBulletName() -> bool
Returns true if the attribute object specifies a standard bullet name.
"""
def HasBulletNumber(self):
"""
HasBulletNumber() -> bool
Returns true if the attribute object specifies a bullet number.
"""
def HasBulletStyle(self):
"""
HasBulletStyle() -> bool
Returns true if the attribute object specifies a bullet style.
"""
def HasBulletText(self):
"""
HasBulletText() -> bool
Returns true if the attribute object specifies bullet text (usually
specifying a symbol).
"""
def HasCharacterStyleName(self):
"""
HasCharacterStyleName() -> bool
Returns true if the attribute object specifies a character style name.
"""
def HasFlag(self, flag):
"""
HasFlag(flag) -> bool
Returns true if the flag is present in the attribute object's flag
bitlist.
"""
def HasFont(self):
"""
HasFont() -> bool
Returns true if the attribute object specifies any font attributes.
"""
def HasFontEncoding(self):
"""
HasFontEncoding() -> bool
Returns true if the attribute object specifies an encoding.
"""
def HasFontFaceName(self):
"""
HasFontFaceName() -> bool
Returns true if the attribute object specifies a font face name.
"""
def HasFontFamily(self):
"""
HasFontFamily() -> bool
Returns true if the attribute object specifies a font family.
"""
def HasFontItalic(self):
"""
HasFontItalic() -> bool
Returns true if the attribute object specifies italic style.
"""
def HasFontSize(self):
"""
HasFontSize() -> bool
Returns true if the attribute object specifies a font point or pixel
size.
"""
def HasFontPointSize(self):
"""
HasFontPointSize() -> bool
Returns true if the attribute object specifies a font point size.
"""
def HasFontPixelSize(self):
"""
HasFontPixelSize() -> bool
Returns true if the attribute object specifies a font pixel size.
"""
def HasFontUnderlined(self):
"""
HasFontUnderlined() -> bool
Returns true if the attribute object specifies either underlining or
no underlining.
"""
def HasFontWeight(self):
"""
HasFontWeight() -> bool
Returns true if the attribute object specifies font weight (bold,
light or normal).
"""
def HasLeftIndent(self):
"""
HasLeftIndent() -> bool
Returns true if the attribute object specifies a left indent.
"""
def HasLineSpacing(self):
"""
HasLineSpacing() -> bool
Returns true if the attribute object specifies line spacing.
"""
def HasListStyleName(self):
"""
HasListStyleName() -> bool
Returns true if the attribute object specifies a list style name.
"""
def HasOutlineLevel(self):
"""
HasOutlineLevel() -> bool
Returns true if the attribute object specifies an outline level.
"""
def HasPageBreak(self):
"""
HasPageBreak() -> bool
Returns true if the attribute object specifies a page break before
this paragraph.
"""
def HasParagraphSpacingAfter(self):
"""
HasParagraphSpacingAfter() -> bool
Returns true if the attribute object specifies spacing after a
paragraph.
"""
def HasParagraphSpacingBefore(self):
"""
HasParagraphSpacingBefore() -> bool
Returns true if the attribute object specifies spacing before a
paragraph.
"""
def HasParagraphStyleName(self):
"""
HasParagraphStyleName() -> bool
Returns true if the attribute object specifies a paragraph style name.
"""
def HasRightIndent(self):
"""
HasRightIndent() -> bool
Returns true if the attribute object specifies a right indent.
"""
def HasTabs(self):
"""
HasTabs() -> bool
Returns true if the attribute object specifies tab stops.
"""
def HasTextColour(self):
"""
HasTextColour() -> bool
Returns true if the attribute object specifies a text foreground
colour.
"""
def HasTextEffects(self):
"""
HasTextEffects() -> bool
Returns true if the attribute object specifies text effects.
"""
def HasURL(self):
"""
HasURL() -> bool
Returns true if the attribute object specifies a URL.
"""
def IsCharacterStyle(self):
"""
IsCharacterStyle() -> bool
Returns true if the object represents a character style, that is, the
flags specify a font or a text background or foreground colour.
"""
def IsDefault(self):
"""
IsDefault() -> bool
Returns false if we have any attributes set, true otherwise.
"""
def IsParagraphStyle(self):
"""
IsParagraphStyle() -> bool
Returns true if the object represents a paragraph style, that is, the
flags specify alignment, indentation, tabs, paragraph spacing, or
bullet style.
"""
def SetAlignment(self, alignment):
"""
SetAlignment(alignment)
Sets the paragraph alignment.
"""
def SetBackgroundColour(self, colBack):
"""
SetBackgroundColour(colBack)
Sets the background colour.
"""
def SetBulletFont(self, font):
"""
SetBulletFont(font)
Sets the name of the font associated with the bullet symbol.
"""
def SetBulletName(self, name):
"""
SetBulletName(name)
Sets the standard bullet name, applicable if the bullet style is
wxTEXT_ATTR_BULLET_STYLE_STANDARD.
"""
def SetBulletNumber(self, n):
"""
SetBulletNumber(n)
Sets the bullet number.
"""
def SetBulletStyle(self, style):
"""
SetBulletStyle(style)
Sets the bullet style.
"""
def SetBulletText(self, text):
"""
SetBulletText(text)
Sets the bullet text, which could be a symbol, or (for example) cached
outline text.
"""
def SetCharacterStyleName(self, name):
"""
SetCharacterStyleName(name)
Sets the character style name.
"""
def SetFlags(self, flags):
"""
SetFlags(flags)
Sets the flags determining which styles are being specified.
"""
def SetFont(self, font, flags=TEXT_ATTR_FONT & ~TEXT_ATTR_FONT_PIXEL_SIZE):
"""
SetFont(font, flags=TEXT_ATTR_FONT & ~TEXT_ATTR_FONT_PIXEL_SIZE)
Sets the attributes for the given font.
"""
def SetFontEncoding(self, encoding):
"""
SetFontEncoding(encoding)
Sets the font encoding.
"""
def SetFontFaceName(self, faceName):
"""
SetFontFaceName(faceName)
Sets the font face name.
"""
def SetFontFamily(self, family):
"""
SetFontFamily(family)
Sets the font family.
"""
def SetFontSize(self, pointSize):
"""
SetFontSize(pointSize)
Sets the font size in points.
"""
def SetFontPointSize(self, pointSize):
"""
SetFontPointSize(pointSize)
Sets the font size in points.
"""
def SetFontPixelSize(self, pixelSize):
"""
SetFontPixelSize(pixelSize)
Sets the font size in pixels.
"""
def SetFontStyle(self, fontStyle):
"""
SetFontStyle(fontStyle)
Sets the font style (normal, italic or slanted).
"""
def SetFontUnderlined(self, underlined):
"""
SetFontUnderlined(underlined)
Sets the font underlining.
"""
def SetFontWeight(self, fontWeight):
"""
SetFontWeight(fontWeight)
Sets the font weight.
"""
def SetLeftIndent(self, indent, subIndent=0):
"""
SetLeftIndent(indent, subIndent=0)
Sets the left indent and left subindent in tenths of a millimetre.
"""
def SetLineSpacing(self, spacing):
"""
SetLineSpacing(spacing)
Sets the line spacing.
"""
def SetListStyleName(self, name):
"""
SetListStyleName(name)
Sets the list style name.
"""
def SetOutlineLevel(self, level):
"""
SetOutlineLevel(level)
Specifies the outline level.
"""
def SetPageBreak(self, pageBreak=True):
"""
SetPageBreak(pageBreak=True)
Specifies a page break before this paragraph.
"""
def SetParagraphSpacingAfter(self, spacing):
"""
SetParagraphSpacingAfter(spacing)
Sets the spacing after a paragraph, in tenths of a millimetre.
"""
def SetParagraphSpacingBefore(self, spacing):
"""
SetParagraphSpacingBefore(spacing)
Sets the spacing before a paragraph, in tenths of a millimetre.
"""
def SetParagraphStyleName(self, name):
"""
SetParagraphStyleName(name)
Sets the name of the paragraph style.
"""
def SetRightIndent(self, indent):
"""
SetRightIndent(indent)
Sets the right indent in tenths of a millimetre.
"""
def SetTabs(self, tabs):
"""
SetTabs(tabs)
Sets the tab stops, expressed in tenths of a millimetre.
"""
def SetTextColour(self, colText):
"""
SetTextColour(colText)
Sets the text foreground colour.
"""
def SetTextEffectFlags(self, flags):
"""
SetTextEffectFlags(flags)
Sets the text effect bits of interest.
"""
def SetTextEffects(self, effects):
"""
SetTextEffects(effects)
Sets the text effects, a bit list of styles.
"""
def SetURL(self, url):
"""
SetURL(url)
Sets the URL for the content.
"""
def Apply(self, style, compareWith=None):
"""
Apply(style, compareWith=None) -> bool
Applies the attributes in style to the original object, but not those
attributes from style that are the same as those in compareWith (if
passed).
"""
def Merge(self, *args, **kw):
"""
Merge(overlay)
Merge(base, overlay) -> TextAttr
Copies all defined/valid properties from overlay to current object.
"""
def EqPartial(self, attr, weakTest=True):
"""
EqPartial(attr, weakTest=True) -> bool
Partial equality test.
"""
Alignment = property(None, None)
BackgroundColour = property(None, None)
BulletFont = property(None, None)
BulletName = property(None, None)
BulletNumber = property(None, None)
BulletStyle = property(None, None)
BulletText = property(None, None)
CharacterStyleName = property(None, None)
Flags = property(None, None)
Font = property(None, None)
FontEncoding = property(None, None)
FontFaceName = property(None, None)
FontFamily = property(None, None)
FontSize = property(None, None)
FontStyle = property(None, None)
FontUnderlined = property(None, None)
FontWeight = property(None, None)
LeftIndent = property(None, None)
LeftSubIndent = property(None, None)
LineSpacing = property(None, None)
ListStyleName = property(None, None)
OutlineLevel = property(None, None)
ParagraphSpacingAfter = property(None, None)
ParagraphSpacingBefore = property(None, None)
ParagraphStyleName = property(None, None)
RightIndent = property(None, None)
Tabs = property(None, None)
TextColour = property(None, None)
TextEffectFlags = property(None, None)
TextEffects = property(None, None)
URL = property(None, None)
# end of class TextAttr
TextCtrlNameStr = ""
class TextCtrl(Control, TextEntry):
"""
TextCtrl()
TextCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=TextCtrlNameStr)
A text control allows text to be displayed and edited.
"""
def __init__(self, *args, **kw):
"""
TextCtrl()
TextCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=TextCtrlNameStr)
A text control allows text to be displayed and edited.
"""
def Create(self, parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=TextCtrlNameStr):
"""
Create(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=TextCtrlNameStr) -> bool
Creates the text control for two-step construction.
"""
def DiscardEdits(self):
"""
DiscardEdits()
Resets the internal modified flag as if the current changes had been
saved.
"""
def EmulateKeyPress(self, event):
"""
EmulateKeyPress(event) -> bool
This function inserts into the control the character which would have
been inserted if the given key event had occurred in the text control.
"""
def GetDefaultStyle(self):
"""
GetDefaultStyle() -> TextAttr
Returns the style currently used for the new text.
"""
def GetLineLength(self, lineNo):
"""
GetLineLength(lineNo) -> int
Gets the length of the specified line, not including any trailing
newline character(s).
"""
def GetLineText(self, lineNo):
"""
GetLineText(lineNo) -> String
Returns the contents of a given line in the text control, not
including any trailing newline character(s).
"""
def GetNumberOfLines(self):
"""
GetNumberOfLines() -> int
Returns the number of lines in the text control buffer.
"""
def GetStyle(self, position, style):
"""
GetStyle(position, style) -> bool
Returns the style at this position in the text control.
"""
def HitTestPos(self, pt):
"""
HitTestPos(pt) -> (TextCtrlHitTestResult, pos)
Finds the position of the character at the specified point.
"""
def HitTest(self, pt):
"""
HitTest(pt) -> (TextCtrlHitTestResult, col, row)
Finds the row and column of the character at the specified point.
"""
def IsModified(self):
"""
IsModified() -> bool
Returns true if the text has been modified by user.
"""
def IsMultiLine(self):
"""
IsMultiLine() -> bool
Returns true if this is a multi line edit control and false otherwise.
"""
def IsSingleLine(self):
"""
IsSingleLine() -> bool
Returns true if this is a single line edit control and false
otherwise.
"""
def LoadFile(self, filename, fileType=TEXT_TYPE_ANY):
"""
LoadFile(filename, fileType=TEXT_TYPE_ANY) -> bool
Loads and displays the named file, if it exists.
"""
def MarkDirty(self):
"""
MarkDirty()
Mark text as modified (dirty).
"""
def PositionToXY(self, pos):
"""
PositionToXY(pos) -> (bool, x, y)
Converts given position to a zero-based column, line number pair.
"""
def PositionToCoords(self, pos):
"""
PositionToCoords(pos) -> Point
Converts given text position to client coordinates in pixels.
"""
def SaveFile(self, filename=EmptyString, fileType=TEXT_TYPE_ANY):
"""
SaveFile(filename=EmptyString, fileType=TEXT_TYPE_ANY) -> bool
Saves the contents of the control in a text file.
"""
def SetDefaultStyle(self, style):
"""
SetDefaultStyle(style) -> bool
Changes the default style to use for the new text which is going to be
added to the control using WriteText() or AppendText().
"""
def SetModified(self, modified):
"""
SetModified(modified)
Marks the control as being modified by the user or not.
"""
def SetStyle(self, start, end, style):
"""
SetStyle(start, end, style) -> bool
Changes the style of the given range.
"""
def ShowPosition(self, pos):
"""
ShowPosition(pos)
Makes the line containing the given position visible.
"""
def XYToPosition(self, x, y):
"""
XYToPosition(x, y) -> long
Converts the given zero based column and line number to a position.
"""
def MacCheckSpelling(self, check):
"""
MacCheckSpelling(check)
Turn on the native spell checking for the text widget on
OSX. Ignored on other platforms.
"""
DefaultStyle = property(None, None)
NumberOfLines = property(None, None)
# end of class TextCtrl
class TextUrlEvent(CommandEvent):
"""
TextUrlEvent(winid, evtMouse, start, end)
TextUrlEvent(event)
"""
def __init__(self, *args, **kw):
"""
TextUrlEvent(winid, evtMouse, start, end)
TextUrlEvent(event)
"""
def GetMouseEvent(self):
"""
GetMouseEvent() -> MouseEvent
"""
def GetURLStart(self):
"""
GetURLStart() -> long
"""
def GetURLEnd(self):
"""
GetURLEnd() -> long
"""
def Clone(self):
"""
Clone() -> Event
Returns a copy of the event.
"""
MouseEvent = property(None, None)
URLEnd = property(None, None)
URLStart = property(None, None)
# end of class TextUrlEvent
EVT_TEXT = wx.PyEventBinder( wxEVT_TEXT, 1)
EVT_TEXT_ENTER = wx.PyEventBinder( wxEVT_TEXT_ENTER, 1)
EVT_TEXT_URL = wx.PyEventBinder( wxEVT_TEXT_URL, 1)
EVT_TEXT_MAXLEN = wx.PyEventBinder( wxEVT_TEXT_MAXLEN, 1)
EVT_TEXT_CUT = wx.PyEventBinder( wxEVT_TEXT_CUT )
EVT_TEXT_COPY = wx.PyEventBinder( wxEVT_TEXT_COPY )
EVT_TEXT_PASTE = wx.PyEventBinder( wxEVT_TEXT_PASTE )
# deprecated wxEVT aliases
wxEVT_COMMAND_TEXT_UPDATED = wxEVT_TEXT
wxEVT_COMMAND_TEXT_ENTER = wxEVT_TEXT_ENTER
wxEVT_COMMAND_TEXT_URL = wxEVT_TEXT_URL
wxEVT_COMMAND_TEXT_MAXLEN = wxEVT_TEXT_MAXLEN
wxEVT_COMMAND_TEXT_CUT = wxEVT_TEXT_CUT
wxEVT_COMMAND_TEXT_COPY = wxEVT_TEXT_COPY
wxEVT_COMMAND_TEXT_PASTE = wxEVT_TEXT_PASTE
#-- end-textctrl --#
#-- begin-combobox --#
class ComboBox(Control, ItemContainer, TextEntry):
"""
ComboBox()
ComboBox(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ComboBoxNameStr)
A combobox is like a combination of an edit control and a listbox.
"""
def __init__(self, *args, **kw):
"""
ComboBox()
ComboBox(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ComboBoxNameStr)
A combobox is like a combination of an edit control and a listbox.
"""
def Create(self, *args, **kw):
"""
Create(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ComboBoxNameStr) -> bool
Creates the combobox for two-step construction.
"""
def GetCurrentSelection(self):
"""
GetCurrentSelection() -> int
Returns the item being selected right now.
"""
def GetInsertionPoint(self):
"""
GetInsertionPoint() -> long
Same as wxTextEntry::GetInsertionPoint().
"""
def IsListEmpty(self):
"""
IsListEmpty() -> bool
Returns true if the list of combobox choices is empty.
"""
def IsTextEmpty(self):
"""
IsTextEmpty() -> bool
Returns true if the text of the combobox is empty.
"""
def SetSelection(self, *args, **kw):
"""
SetSelection(from_, to_)
SetSelection(n)
Same as wxTextEntry::SetSelection().
"""
def SetTextSelection(self, from_, to_):
"""
SetTextSelection(from_, to_)
Same as wxTextEntry::SetSelection().
"""
def SetValue(self, text):
"""
SetValue(text)
Sets the text for the combobox text field.
"""
def Popup(self):
"""
Popup()
Shows the list box portion of the combo box.
"""
def Dismiss(self):
"""
Dismiss()
Hides the list box portion of the combo box.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the index of the selected item or wxNOT_FOUND if no item is
selected.
"""
def GetTextSelection(self):
"""
GetTextSelection() -> (from, to)
Gets the current selection span.
"""
def FindString(self, string, caseSensitive=False):
"""
FindString(string, caseSensitive=False) -> int
Finds an item whose label matches the given string.
"""
def GetString(self, n):
"""
GetString(n) -> String
Returns the label of the item with the given index.
"""
def GetStringSelection(self):
"""
GetStringSelection() -> String
Gets the text currently selected in the control.
"""
def SetString(self, n, text):
"""
SetString(n, text)
Changes the text of the specified combobox item.
"""
def GetCount(self):
"""
GetCount() -> unsignedint
Returns the number of items in the control.
"""
SetMark = wx.deprecated(SetTextSelection, 'Use SetTextSelection instead.')
GetMark = wx.deprecated(GetTextSelection, 'Use GetTextSelection instead.')
Count = property(None, None)
CurrentSelection = property(None, None)
InsertionPoint = property(None, None)
Selection = property(None, None)
StringSelection = property(None, None)
# end of class ComboBox
#-- end-combobox --#
#-- begin-checkbox --#
CHK_2STATE = 0
CHK_3STATE = 0
CHK_ALLOW_3RD_STATE_FOR_USER = 0
CHK_UNCHECKED = 0
CHK_CHECKED = 0
CHK_UNDETERMINED = 0
CheckBoxNameStr = ""
class CheckBox(Control):
"""
CheckBox()
CheckBox(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=CheckBoxNameStr)
A checkbox is a labelled box which by default is either on (checkmark
is visible) or off (no checkmark).
"""
def __init__(self, *args, **kw):
"""
CheckBox()
CheckBox(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=CheckBoxNameStr)
A checkbox is a labelled box which by default is either on (checkmark
is visible) or off (no checkmark).
"""
def Create(self, parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=CheckBoxNameStr):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=CheckBoxNameStr) -> bool
Creates the checkbox for two-step construction.
"""
def GetValue(self):
"""
GetValue() -> bool
Gets the state of a 2-state checkbox.
"""
def Get3StateValue(self):
"""
Get3StateValue() -> CheckBoxState
Gets the state of a 3-state checkbox.
"""
def Is3State(self):
"""
Is3State() -> bool
Returns whether or not the checkbox is a 3-state checkbox.
"""
def Is3rdStateAllowedForUser(self):
"""
Is3rdStateAllowedForUser() -> bool
Returns whether or not the user can set the checkbox to the third
state.
"""
def IsChecked(self):
"""
IsChecked() -> bool
This is just a maybe more readable synonym for GetValue(): just as the
latter, it returns true if the checkbox is checked and false
otherwise.
"""
def SetValue(self, state):
"""
SetValue(state)
Sets the checkbox to the given state.
"""
def Set3StateValue(self, state):
"""
Set3StateValue(state)
Sets the checkbox to the given state.
"""
Value = property(None, None)
ThreeStateValue = property(None, None)
# end of class CheckBox
#-- end-checkbox --#
#-- begin-listbox --#
class ListBox(Control, ItemContainer):
"""
ListBox()
ListBox(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ListBoxNameStr)
A listbox is used to select one or more of a list of strings.
"""
def __init__(self, *args, **kw):
"""
ListBox()
ListBox(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ListBoxNameStr)
A listbox is used to select one or more of a list of strings.
"""
def Create(self, *args, **kw):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ListBoxNameStr) -> bool
Creates the listbox for two-step construction.
"""
def Deselect(self, n):
"""
Deselect(n)
Deselects an item in the list box.
"""
def SetSelection(self, n):
"""
SetSelection(n)
Sets the selection to the given item n or removes the selection
entirely if n == wxNOT_FOUND.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the index of the selected item or wxNOT_FOUND if no item is
selected.
"""
def SetStringSelection(self, *args, **kw):
"""
SetStringSelection(s, select) -> bool
SetStringSelection(s) -> bool
"""
def GetSelections(self):
"""
GetSelections() -> ArrayInt
Fill an array of ints with the positions of the currently selected
items.
"""
def HitTest(self, *args, **kw):
"""
HitTest(point) -> int
HitTest(x, y) -> int
Returns the item located at point, or wxNOT_FOUND if there is no item
located at point.
"""
def InsertItems(self, *args, **kw):
"""
InsertItems(items, pos)
Insert the given number of strings before the specified position.
"""
def IsSelected(self, n):
"""
IsSelected(n) -> bool
Determines whether an item is selected.
"""
def SetFirstItem(self, *args, **kw):
"""
SetFirstItem(n)
SetFirstItem(string)
Set the specified item to be the first visible item.
"""
def EnsureVisible(self, n):
"""
EnsureVisible(n)
Ensure that the item with the given index is currently shown.
"""
def IsSorted(self):
"""
IsSorted() -> bool
Return true if the listbox has wxLB_SORT style.
"""
def GetCount(self):
"""
GetCount() -> unsignedint
Returns the number of items in the control.
"""
def GetString(self, n):
"""
GetString(n) -> String
Returns the label of the item with the given index.
"""
def SetString(self, n, string):
"""
SetString(n, string)
Sets the label for the given item.
"""
def FindString(self, string, caseSensitive=False):
"""
FindString(string, caseSensitive=False) -> int
Finds an item whose label matches the given string.
"""
Count = property(None, None)
Selection = property(None, None)
Selections = property(None, None)
# end of class ListBox
#-- end-listbox --#
#-- begin-checklst --#
class CheckListBox(ListBox):
"""
CheckListBox(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name="listBox")
CheckListBox()
A wxCheckListBox is like a wxListBox, but allows items to be checked
or unchecked.
"""
def __init__(self, *args, **kw):
"""
CheckListBox(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name="listBox")
CheckListBox()
A wxCheckListBox is like a wxListBox, but allows items to be checked
or unchecked.
"""
def Create(self, *args, **kw):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ListBoxNameStr) -> bool
"""
def Check(self, item, check=True):
"""
Check(item, check=True)
Checks the given item.
"""
def IsChecked(self, item):
"""
IsChecked(item) -> bool
Returns true if the given item is checked, false otherwise.
"""
def GetCheckedItems(self):
"""
GetCheckedItems()
Return a sequence of integers corresponding to the checked items in
the control, based on :meth:`IsChecked`.
"""
def GetCheckedStrings(self):
"""
GetCheckedStrings()
Return a tuple of strings corresponding to the checked
items of the control, based on :meth:`GetChecked`.
"""
def SetCheckedItems(self, indexes):
"""
SetCheckedItems(indexes)
Sets the checked state of items if the index of the item is
found in the indexes sequence.
"""
def SetCheckedStrings(self, strings):
"""
SetCheckedStrings(strings)
Sets the checked state of items if the item's string is found
in the strings sequence.
"""
def GetChecked(self):
"""
"""
def SetChecked(self, indexes):
"""
"""
Checked = property(None, None)
CheckedItems = property(None, None)
CheckedStrings = property(None, None)
# end of class CheckListBox
#-- end-checklst --#
#-- begin-gauge --#
GA_HORIZONTAL = 0
GA_VERTICAL = 0
GA_SMOOTH = 0
GaugeNameStr = ""
class Gauge(Control):
"""
Gauge()
Gauge(parent, id=ID_ANY, range=100, pos=DefaultPosition, size=DefaultSize, style=GA_HORIZONTAL, validator=DefaultValidator, name=GaugeNameStr)
A gauge is a horizontal or vertical bar which shows a quantity (often
time).
"""
def __init__(self, *args, **kw):
"""
Gauge()
Gauge(parent, id=ID_ANY, range=100, pos=DefaultPosition, size=DefaultSize, style=GA_HORIZONTAL, validator=DefaultValidator, name=GaugeNameStr)
A gauge is a horizontal or vertical bar which shows a quantity (often
time).
"""
def Create(self, parent, id=ID_ANY, range=100, pos=DefaultPosition, size=DefaultSize, style=GA_HORIZONTAL, validator=DefaultValidator, name=GaugeNameStr):
"""
Create(parent, id=ID_ANY, range=100, pos=DefaultPosition, size=DefaultSize, style=GA_HORIZONTAL, validator=DefaultValidator, name=GaugeNameStr) -> bool
Creates the gauge for two-step construction.
"""
def GetBezelFace(self):
"""
GetBezelFace() -> int
Returns the width of the 3D bezel face.
"""
def GetRange(self):
"""
GetRange() -> int
Returns the maximum position of the gauge.
"""
def GetShadowWidth(self):
"""
GetShadowWidth() -> int
Returns the 3D shadow margin width.
"""
def GetValue(self):
"""
GetValue() -> int
Returns the current position of the gauge.
"""
def IsVertical(self):
"""
IsVertical() -> bool
Returns true if the gauge is vertical (has wxGA_VERTICAL style) and
false otherwise.
"""
def Pulse(self):
"""
Pulse()
Switch the gauge to indeterminate mode (if required) and makes the
gauge move a bit to indicate the user that some progress has been
made.
"""
def SetBezelFace(self, width):
"""
SetBezelFace(width)
Sets the 3D bezel face width.
"""
def SetRange(self, range):
"""
SetRange(range)
Sets the range (maximum value) of the gauge.
"""
def SetShadowWidth(self, width):
"""
SetShadowWidth(width)
Sets the 3D shadow width.
"""
def SetValue(self, pos):
"""
SetValue(pos)
Sets the position of the gauge.
"""
BezelFace = property(None, None)
Range = property(None, None)
ShadowWidth = property(None, None)
Value = property(None, None)
# end of class Gauge
#-- end-gauge --#
#-- begin-headercol --#
COL_WIDTH_DEFAULT = 0
COL_WIDTH_AUTOSIZE = 0
COL_RESIZABLE = 0
COL_SORTABLE = 0
COL_REORDERABLE = 0
COL_HIDDEN = 0
COL_DEFAULT_FLAGS = 0
class HeaderColumn(object):
"""
Represents a column header in controls displaying tabular data such as
wxDataViewCtrl or wxGrid.
"""
def GetTitle(self):
"""
GetTitle() -> String
Get the text shown in the column header.
"""
def GetBitmap(self):
"""
GetBitmap() -> Bitmap
Returns the bitmap in the header of the column, if any.
"""
def GetWidth(self):
"""
GetWidth() -> int
Returns the current width of the column.
"""
def GetMinWidth(self):
"""
GetMinWidth() -> int
Return the minimal column width.
"""
def GetAlignment(self):
"""
GetAlignment() -> Alignment
Returns the current column alignment.
"""
def GetFlags(self):
"""
GetFlags() -> int
Get the column flags.
"""
def HasFlag(self, flag):
"""
HasFlag(flag) -> bool
Return true if the specified flag is currently set for this column.
"""
def IsResizeable(self):
"""
IsResizeable() -> bool
Return true if the column can be resized by the user.
"""
def IsSortable(self):
"""
IsSortable() -> bool
Returns true if the column can be clicked by user to sort the control
contents by the field in this column.
"""
def IsReorderable(self):
"""
IsReorderable() -> bool
Returns true if the column can be dragged by user to change its order.
"""
def IsHidden(self):
"""
IsHidden() -> bool
Returns true if the column is currently hidden.
"""
def IsShown(self):
"""
IsShown() -> bool
Returns true if the column is currently shown.
"""
def IsSortKey(self):
"""
IsSortKey() -> bool
Returns true if the column is currently used for sorting.
"""
def IsSortOrderAscending(self):
"""
IsSortOrderAscending() -> bool
Returns true, if the sort order is ascending.
"""
Alignment = property(None, None)
Bitmap = property(None, None)
Flags = property(None, None)
MinWidth = property(None, None)
Title = property(None, None)
Width = property(None, None)
Resizeable = property(None, None)
Sortable = property(None, None)
Reorderable = property(None, None)
Hidden = property(None, None)
Shown = property(None, None)
SortOrderAscending = property(None, None)
SortKey = property(None, None)
# end of class HeaderColumn
class SettableHeaderColumn(HeaderColumn):
"""
Adds methods to set the column attributes to wxHeaderColumn.
"""
def SetTitle(self, title):
"""
SetTitle(title)
Set the text to display in the column header.
"""
def SetBitmap(self, bitmap):
"""
SetBitmap(bitmap)
Set the bitmap to be displayed in the column header.
"""
def SetWidth(self, width):
"""
SetWidth(width)
Set the column width.
"""
def SetMinWidth(self, minWidth):
"""
SetMinWidth(minWidth)
Set the minimal column width.
"""
def SetAlignment(self, align):
"""
SetAlignment(align)
Set the alignment of the column header.
"""
def SetFlags(self, flags):
"""
SetFlags(flags)
Set the column flags.
"""
def ChangeFlag(self, flag, set):
"""
ChangeFlag(flag, set)
Set or clear the given flag.
"""
def SetFlag(self, flag):
"""
SetFlag(flag)
Set the specified flag for the column.
"""
def ClearFlag(self, flag):
"""
ClearFlag(flag)
Clear the specified flag for the column.
"""
def ToggleFlag(self, flag):
"""
ToggleFlag(flag)
Toggle the specified flag for the column.
"""
def SetResizeable(self, resizable):
"""
SetResizeable(resizable)
Call this to enable or disable interactive resizing of the column by
the user.
"""
def SetSortable(self, sortable):
"""
SetSortable(sortable)
Allow clicking the column to sort the control contents by the field in
this column.
"""
def SetReorderable(self, reorderable):
"""
SetReorderable(reorderable)
Allow changing the column order by dragging it.
"""
def SetHidden(self, hidden):
"""
SetHidden(hidden)
Hide or show the column.
"""
def UnsetAsSortKey(self):
"""
UnsetAsSortKey()
Don't use this column for sorting.
"""
def SetSortOrder(self, ascending):
"""
SetSortOrder(ascending)
Sets this column as the sort key for the associated control.
"""
def ToggleSortOrder(self):
"""
ToggleSortOrder()
Inverses the sort order.
"""
Title = property(None, None)
Bitmap = property(None, None)
Width = property(None, None)
MinWidth = property(None, None)
Alignment = property(None, None)
Flags = property(None, None)
Resizeable = property(None, None)
Sortable = property(None, None)
Reorderable = property(None, None)
Hidden = property(None, None)
# end of class SettableHeaderColumn
class HeaderColumnSimple(SettableHeaderColumn):
"""
HeaderColumnSimple(title, width=COL_WIDTH_DEFAULT, align=ALIGN_NOT, flags=COL_DEFAULT_FLAGS)
HeaderColumnSimple(bitmap, width=COL_WIDTH_DEFAULT, align=ALIGN_CENTER, flags=COL_DEFAULT_FLAGS)
Simple container for the information about the column.
"""
def __init__(self, *args, **kw):
"""
HeaderColumnSimple(title, width=COL_WIDTH_DEFAULT, align=ALIGN_NOT, flags=COL_DEFAULT_FLAGS)
HeaderColumnSimple(bitmap, width=COL_WIDTH_DEFAULT, align=ALIGN_CENTER, flags=COL_DEFAULT_FLAGS)
Simple container for the information about the column.
"""
def SetTitle(self, title):
"""
SetTitle(title)
Trivial implementations of the base class pure virtual functions.
"""
def GetTitle(self):
"""
GetTitle() -> String
Trivial implementations of the base class pure virtual functions.
"""
def SetBitmap(self, bitmap):
"""
SetBitmap(bitmap)
Trivial implementations of the base class pure virtual functions.
"""
def GetBitmap(self):
"""
GetBitmap() -> Bitmap
Trivial implementations of the base class pure virtual functions.
"""
def SetWidth(self, width):
"""
SetWidth(width)
Trivial implementations of the base class pure virtual functions.
"""
def GetWidth(self):
"""
GetWidth() -> int
Trivial implementations of the base class pure virtual functions.
"""
def SetMinWidth(self, minWidth):
"""
SetMinWidth(minWidth)
Trivial implementations of the base class pure virtual functions.
"""
def GetMinWidth(self):
"""
GetMinWidth() -> int
Trivial implementations of the base class pure virtual functions.
"""
def SetAlignment(self, align):
"""
SetAlignment(align)
Trivial implementations of the base class pure virtual functions.
"""
def GetAlignment(self):
"""
GetAlignment() -> Alignment
Trivial implementations of the base class pure virtual functions.
"""
def SetFlags(self, flags):
"""
SetFlags(flags)
Trivial implementations of the base class pure virtual functions.
"""
def GetFlags(self):
"""
GetFlags() -> int
Trivial implementations of the base class pure virtual functions.
"""
def IsSortKey(self):
"""
IsSortKey() -> bool
Trivial implementations of the base class pure virtual functions.
"""
def SetSortOrder(self, ascending):
"""
SetSortOrder(ascending)
Trivial implementations of the base class pure virtual functions.
"""
def IsSortOrderAscending(self):
"""
IsSortOrderAscending() -> bool
Trivial implementations of the base class pure virtual functions.
"""
Alignment = property(None, None)
Bitmap = property(None, None)
Flags = property(None, None)
MinWidth = property(None, None)
Title = property(None, None)
Width = property(None, None)
# end of class HeaderColumnSimple
#-- end-headercol --#
#-- begin-headerctrl --#
HD_ALLOW_REORDER = 0
HD_ALLOW_HIDE = 0
HD_DEFAULT_STYLE = 0
wxEVT_HEADER_CLICK = 0
wxEVT_HEADER_RIGHT_CLICK = 0
wxEVT_HEADER_MIDDLE_CLICK = 0
wxEVT_HEADER_DCLICK = 0
wxEVT_HEADER_RIGHT_DCLICK = 0
wxEVT_HEADER_MIDDLE_DCLICK = 0
wxEVT_HEADER_SEPARATOR_DCLICK = 0
wxEVT_HEADER_BEGIN_RESIZE = 0
wxEVT_HEADER_RESIZING = 0
wxEVT_HEADER_END_RESIZE = 0
wxEVT_HEADER_BEGIN_REORDER = 0
wxEVT_HEADER_END_REORDER = 0
wxEVT_HEADER_DRAGGING_CANCELLED = 0
HeaderCtrlNameStr = ""
class HeaderCtrl(Control):
"""
HeaderCtrl()
HeaderCtrl(parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HD_DEFAULT_STYLE, name=HeaderCtrlNameStr)
wxHeaderCtrl is the control containing the column headings which is
usually used for display of tabular data.
"""
def __init__(self, *args, **kw):
"""
HeaderCtrl()
HeaderCtrl(parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HD_DEFAULT_STYLE, name=HeaderCtrlNameStr)
wxHeaderCtrl is the control containing the column headings which is
usually used for display of tabular data.
"""
def Create(self, parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HD_DEFAULT_STYLE, name=HeaderCtrlNameStr):
"""
Create(parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HD_DEFAULT_STYLE, name=HeaderCtrlNameStr) -> bool
Create the header control window.
"""
def SetColumnCount(self, count):
"""
SetColumnCount(count)
Set the number of columns in the control.
"""
def GetColumnCount(self):
"""
GetColumnCount() -> unsignedint
Return the number of columns in the control.
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Return whether the control has any columns.
"""
def UpdateColumn(self, idx):
"""
UpdateColumn(idx)
Update the column with the given index.
"""
def SetColumnsOrder(self, order):
"""
SetColumnsOrder(order)
Change the columns display order.
"""
def GetColumnsOrder(self):
"""
GetColumnsOrder() -> ArrayInt
Return the array describing the columns display order.
"""
def GetColumnAt(self, pos):
"""
GetColumnAt(pos) -> unsignedint
Return the index of the column displayed at the given position.
"""
def GetColumnPos(self, idx):
"""
GetColumnPos(idx) -> unsignedint
Get the position at which this column is currently displayed.
"""
def ResetColumnsOrder(self):
"""
ResetColumnsOrder()
Reset the columns order to the natural one.
"""
def ShowColumnsMenu(self, pt, title=""):
"""
ShowColumnsMenu(pt, title="") -> bool
Show the popup menu allowing the user to show or hide the columns.
"""
def AddColumnsItems(self, menu, idColumnsBase=0):
"""
AddColumnsItems(menu, idColumnsBase=0)
Helper function appending the checkable items corresponding to all the
columns to the given menu.
"""
def ShowCustomizeDialog(self):
"""
ShowCustomizeDialog() -> bool
Show the column customization dialog.
"""
def GetColumnTitleWidth(self, col):
"""
GetColumnTitleWidth(col) -> int
Returns width needed for given column's title.
"""
@staticmethod
def MoveColumnInOrderArray(order, idx, pos):
"""
MoveColumnInOrderArray(order, idx, pos)
Helper function to manipulate the array of column indices.
"""
ColumnCount = property(None, None)
ColumnsOrder = property(None, None)
def GetColumn(self, idx):
"""
GetColumn(idx) -> HeaderColumn
Method to be implemented by the derived classes to return the
information for the given column.
"""
def UpdateColumnVisibility(self, idx, show):
"""
UpdateColumnVisibility(idx, show)
Method called when the column visibility is changed by the user.
"""
def UpdateColumnsOrder(self, order):
"""
UpdateColumnsOrder(order)
Method called when the columns order is changed in the customization
dialog.
"""
def UpdateColumnWidthToFit(self, idx, widthTitle):
"""
UpdateColumnWidthToFit(idx, widthTitle) -> bool
Method which may be implemented by the derived classes to allow double
clicking the column separator to resize the column to fit its
contents.
"""
def OnColumnCountChanging(self, count):
"""
OnColumnCountChanging(count)
Can be overridden in the derived class to update internal data
structures when the number of the columns in the control changes.
"""
# end of class HeaderCtrl
class HeaderCtrlSimple(HeaderCtrl):
"""
HeaderCtrlSimple()
HeaderCtrlSimple(parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HD_DEFAULT_STYLE, name=HeaderCtrlNameStr)
wxHeaderCtrlSimple is a concrete header control which can be used
directly, without inheriting from it as you need to do when using
wxHeaderCtrl itself.
"""
def __init__(self, *args, **kw):
"""
HeaderCtrlSimple()
HeaderCtrlSimple(parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=HD_DEFAULT_STYLE, name=HeaderCtrlNameStr)
wxHeaderCtrlSimple is a concrete header control which can be used
directly, without inheriting from it as you need to do when using
wxHeaderCtrl itself.
"""
def InsertColumn(self, col, idx):
"""
InsertColumn(col, idx)
Insert the column at the given position.
"""
def AppendColumn(self, col):
"""
AppendColumn(col)
Append the column to the end of the control.
"""
def DeleteColumn(self, idx):
"""
DeleteColumn(idx)
Delete the column at the given position.
"""
def ShowColumn(self, idx, show=True):
"""
ShowColumn(idx, show=True)
Show or hide the column.
"""
def HideColumn(self, idx):
"""
HideColumn(idx)
Hide the column with the given index.
"""
def ShowSortIndicator(self, idx, sortOrder=True):
"""
ShowSortIndicator(idx, sortOrder=True)
Update the column sort indicator.
"""
def RemoveSortIndicator(self):
"""
RemoveSortIndicator()
Remove the sort indicator from the column being used as sort key.
"""
def GetBestFittingWidth(self, idx):
"""
GetBestFittingWidth(idx) -> int
This function can be overridden in the classes deriving from this
control instead of overriding UpdateColumnWidthToFit().
"""
# end of class HeaderCtrlSimple
class HeaderCtrlEvent(NotifyEvent):
"""
HeaderCtrlEvent(commandType=wxEVT_NULL, winid=0)
HeaderCtrlEvent(event)
Event class representing the events generated by wxHeaderCtrl.
"""
def __init__(self, *args, **kw):
"""
HeaderCtrlEvent(commandType=wxEVT_NULL, winid=0)
HeaderCtrlEvent(event)
Event class representing the events generated by wxHeaderCtrl.
"""
def GetColumn(self):
"""
GetColumn() -> int
Return the index of the column affected by this event.
"""
def SetColumn(self, col):
"""
SetColumn(col)
"""
def GetWidth(self):
"""
GetWidth() -> int
Return the current width of the column.
"""
def SetWidth(self, width):
"""
SetWidth(width)
"""
def GetNewOrder(self):
"""
GetNewOrder() -> unsignedint
Return the new order of the column.
"""
def SetNewOrder(self, order):
"""
SetNewOrder(order)
"""
Column = property(None, None)
NewOrder = property(None, None)
Width = property(None, None)
# end of class HeaderCtrlEvent
EVT_HEADER_CLICK = wx.PyEventBinder( wxEVT_HEADER_CLICK )
EVT_HEADER_RIGHT_CLICK = wx.PyEventBinder( wxEVT_HEADER_RIGHT_CLICK )
EVT_HEADER_MIDDLE_CLICK = wx.PyEventBinder( wxEVT_HEADER_MIDDLE_CLICK )
EVT_HEADER_DCLICK = wx.PyEventBinder( wxEVT_HEADER_DCLICK )
EVT_HEADER_RIGHT_DCLICK = wx.PyEventBinder( wxEVT_HEADER_RIGHT_DCLICK )
EVT_HEADER_MIDDLE_DCLICK = wx.PyEventBinder( wxEVT_HEADER_MIDDLE_DCLICK )
EVT_HEADER_SEPARATOR_DCLICK = wx.PyEventBinder( wxEVT_HEADER_SEPARATOR_DCLICK )
EVT_HEADER_BEGIN_RESIZE = wx.PyEventBinder( wxEVT_HEADER_BEGIN_RESIZE )
EVT_HEADER_RESIZING = wx.PyEventBinder( wxEVT_HEADER_RESIZING )
EVT_HEADER_END_RESIZE = wx.PyEventBinder( wxEVT_HEADER_END_RESIZE )
EVT_HEADER_BEGIN_REORDER = wx.PyEventBinder( wxEVT_HEADER_BEGIN_REORDER )
EVT_HEADER_END_REORDER = wx.PyEventBinder( wxEVT_HEADER_END_REORDER )
EVT_HEADER_DRAGGING_CANCELLED = wx.PyEventBinder( wxEVT_HEADER_DRAGGING_CANCELLED )
# deprecated wxEVT aliases
wxEVT_COMMAND_HEADER_CLICK = wxEVT_HEADER_CLICK
wxEVT_COMMAND_HEADER_RIGHT_CLICK = wxEVT_HEADER_RIGHT_CLICK
wxEVT_COMMAND_HEADER_MIDDLE_CLICK = wxEVT_HEADER_MIDDLE_CLICK
wxEVT_COMMAND_HEADER_DCLICK = wxEVT_HEADER_DCLICK
wxEVT_COMMAND_HEADER_RIGHT_DCLICK = wxEVT_HEADER_RIGHT_DCLICK
wxEVT_COMMAND_HEADER_MIDDLE_DCLICK = wxEVT_HEADER_MIDDLE_DCLICK
wxEVT_COMMAND_HEADER_SEPARATOR_DCLICK = wxEVT_HEADER_SEPARATOR_DCLICK
wxEVT_COMMAND_HEADER_BEGIN_RESIZE = wxEVT_HEADER_BEGIN_RESIZE
wxEVT_COMMAND_HEADER_RESIZING = wxEVT_HEADER_RESIZING
wxEVT_COMMAND_HEADER_END_RESIZE = wxEVT_HEADER_END_RESIZE
wxEVT_COMMAND_HEADER_BEGIN_REORDER = wxEVT_HEADER_BEGIN_REORDER
wxEVT_COMMAND_HEADER_END_REORDER = wxEVT_HEADER_END_REORDER
wxEVT_COMMAND_HEADER_DRAGGING_CANCELLED = wxEVT_HEADER_DRAGGING_CANCELLED
#-- end-headerctrl --#
#-- begin-srchctrl --#
wxEVT_SEARCHCTRL_CANCEL_BTN = 0
wxEVT_SEARCHCTRL_SEARCH_BTN = 0
SearchCtrlNameStr = ""
class SearchCtrl(Control):
"""
SearchCtrl()
SearchCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=SearchCtrlNameStr)
A search control is a composite control with a search button, a text
control, and a cancel button.
"""
def __init__(self, *args, **kw):
"""
SearchCtrl()
SearchCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=SearchCtrlNameStr)
A search control is a composite control with a search button, a text
control, and a cancel button.
"""
def Create(self, parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=SearchCtrlNameStr):
"""
Create(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=SearchCtrlNameStr) -> bool
"""
def GetMenu(self):
"""
GetMenu() -> Menu
Returns a pointer to the search control's menu object or NULL if there
is no menu attached.
"""
def IsSearchButtonVisible(self):
"""
IsSearchButtonVisible() -> bool
Returns the search button visibility value.
"""
def IsCancelButtonVisible(self):
"""
IsCancelButtonVisible() -> bool
Returns the cancel button's visibility state.
"""
def SetMenu(self, menu):
"""
SetMenu(menu)
Sets the search control's menu object.
"""
def ShowCancelButton(self, show):
"""
ShowCancelButton(show)
Shows or hides the cancel button.
"""
def ShowSearchButton(self, show):
"""
ShowSearchButton(show)
Sets the search button visibility value on the search control.
"""
def SetDescriptiveText(self, text):
"""
SetDescriptiveText(text)
Set the text to be displayed in the search control when the user has
not yet typed anything in it.
"""
def GetDescriptiveText(self):
"""
GetDescriptiveText() -> String
Return the text displayed when there is not yet any user input.
"""
def SetSearchBitmap(self, bmp):
"""
SetSearchBitmap(bmp)
"""
def SetSearchMenuBitmap(self, bmp):
"""
SetSearchMenuBitmap(bmp)
"""
def SetCancelBitmap(self, bmp):
"""
SetCancelBitmap(bmp)
"""
def SetMargins(self, *args, **kw):
"""
SetMargins(pt) -> bool
SetMargins(left, top=-1) -> bool
Attempts to set the control margins.
"""
def AppendText(self, text):
"""
AppendText(text)
Appends the text to the end of the text control.
"""
def AutoComplete(self, *args, **kw):
"""
AutoComplete(choices) -> bool
AutoComplete(completer) -> bool
Call this function to enable auto-completion of the text typed in a
single-line text control using the given choices.
"""
def AutoCompleteFileNames(self):
"""
AutoCompleteFileNames() -> bool
Call this function to enable auto-completion of the text typed in a
single-line text control using all valid file system paths.
"""
def AutoCompleteDirectories(self):
"""
AutoCompleteDirectories() -> bool
Call this function to enable auto-completion of the text using the
file system directories.
"""
def CanCopy(self):
"""
CanCopy() -> bool
Returns true if the selection can be copied to the clipboard.
"""
def CanCut(self):
"""
CanCut() -> bool
Returns true if the selection can be cut to the clipboard.
"""
def CanPaste(self):
"""
CanPaste() -> bool
Returns true if the contents of the clipboard can be pasted into the
text control.
"""
def CanRedo(self):
"""
CanRedo() -> bool
Returns true if there is a redo facility available and the last
operation can be redone.
"""
def CanUndo(self):
"""
CanUndo() -> bool
Returns true if there is an undo facility available and the last
operation can be undone.
"""
def ChangeValue(self, value):
"""
ChangeValue(value)
Sets the new text control value.
"""
def Clear(self):
"""
Clear()
Clears the text in the control.
"""
def Copy(self):
"""
Copy()
Copies the selected text to the clipboard.
"""
def Cut(self):
"""
Cut()
Copies the selected text to the clipboard and removes it from the
control.
"""
def GetInsertionPoint(self):
"""
GetInsertionPoint() -> long
Returns the insertion point, or cursor, position.
"""
def GetLastPosition(self):
"""
GetLastPosition() -> TextPos
Returns the zero based index of the last position in the text control,
which is equal to the number of characters in the control.
"""
def GetRange(self, from_, to_):
"""
GetRange(from_, to_) -> String
Returns the string containing the text starting in the positions from
and up to to in the control.
"""
def GetSelection(self):
"""
GetSelection() -> (from, to)
Gets the current selection span.
"""
def GetStringSelection(self):
"""
GetStringSelection() -> String
Gets the text currently selected in the control.
"""
def GetValue(self):
"""
GetValue() -> String
Gets the contents of the control.
"""
def IsEditable(self):
"""
IsEditable() -> bool
Returns true if the controls contents may be edited by user (note that
it always can be changed by the program).
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Returns true if the control is currently empty.
"""
def Paste(self):
"""
Paste()
Pastes text from the clipboard to the text item.
"""
def Redo(self):
"""
Redo()
If there is a redo facility and the last operation can be redone,
redoes the last operation.
"""
def Remove(self, from_, to_):
"""
Remove(from_, to_)
Removes the text starting at the first given position up to (but not
including) the character at the last position.
"""
def Replace(self, from_, to_, value):
"""
Replace(from_, to_, value)
Replaces the text starting at the first position up to (but not
including) the character at the last position with the given text.
"""
def SetEditable(self, editable):
"""
SetEditable(editable)
Makes the text item editable or read-only, overriding the
wxTE_READONLY flag.
"""
def SetInsertionPoint(self, pos):
"""
SetInsertionPoint(pos)
Sets the insertion point at the given position.
"""
def SetInsertionPointEnd(self):
"""
SetInsertionPointEnd()
Sets the insertion point at the end of the text control.
"""
def SetMaxLength(self, len):
"""
SetMaxLength(len)
This function sets the maximum number of characters the user can enter
into the control.
"""
def SetSelection(self, from_, to_):
"""
SetSelection(from_, to_)
Selects the text starting at the first position up to (but not
including) the character at the last position.
"""
def SelectAll(self):
"""
SelectAll()
Selects all text in the control.
"""
def SelectNone(self):
"""
SelectNone()
Deselects selected text in the control.
"""
def SetHint(self, hint):
"""
SetHint(hint) -> bool
Sets a hint shown in an empty unfocused text control.
"""
def GetHint(self):
"""
GetHint() -> String
Returns the current hint string.
"""
def GetMargins(self):
"""
GetMargins() -> Point
Returns the margins used by the control.
"""
def SetValue(self, value):
"""
SetValue(value)
Sets the new text control value.
"""
def Undo(self):
"""
Undo()
If there is an undo facility and the last operation can be undone,
undoes the last operation.
"""
def WriteText(self, text):
"""
WriteText(text)
Writes the text into the text control at the current insertion
position.
"""
def DiscardEdits(self):
"""
DiscardEdits()
Resets the internal modified flag as if the current changes had been
saved.
"""
def EmulateKeyPress(self, event):
"""
EmulateKeyPress(event) -> bool
This function inserts into the control the character which would have
been inserted if the given key event had occurred in the text control.
"""
def GetDefaultStyle(self):
"""
GetDefaultStyle() -> TextAttr
Returns the style currently used for the new text.
"""
def GetLineLength(self, lineNo):
"""
GetLineLength(lineNo) -> int
Gets the length of the specified line, not including any trailing
newline character(s).
"""
def GetLineText(self, lineNo):
"""
GetLineText(lineNo) -> String
Returns the contents of a given line in the text control, not
including any trailing newline character(s).
"""
def GetNumberOfLines(self):
"""
GetNumberOfLines() -> int
Returns the number of lines in the text control buffer.
"""
def GetStyle(self, position, style):
"""
GetStyle(position, style) -> bool
Returns the style at this position in the text control.
"""
def HitTestPos(self, pt):
"""
HitTestPos(pt) -> (TextCtrlHitTestResult, pos)
Finds the position of the character at the specified point.
"""
def HitTest(self, pt):
"""
HitTest(pt) -> (TextCtrlHitTestResult, col, row)
Finds the row and column of the character at the specified point.
"""
def IsModified(self):
"""
IsModified() -> bool
Returns true if the text has been modified by user.
"""
def IsMultiLine(self):
"""
IsMultiLine() -> bool
Returns true if this is a multi line edit control and false otherwise.
"""
def IsSingleLine(self):
"""
IsSingleLine() -> bool
Returns true if this is a single line edit control and false
otherwise.
"""
def MarkDirty(self):
"""
MarkDirty()
Mark text as modified (dirty).
"""
def PositionToXY(self, pos):
"""
PositionToXY(pos) -> (bool, x, y)
Converts given position to a zero-based column, line number pair.
"""
def PositionToCoords(self, pos):
"""
PositionToCoords(pos) -> Point
Converts given text position to client coordinates in pixels.
"""
def SetDefaultStyle(self, style):
"""
SetDefaultStyle(style) -> bool
Changes the default style to use for the new text which is going to be
added to the control using WriteText() or AppendText().
"""
def SetModified(self, modified):
"""
SetModified(modified)
Marks the control as being modified by the user or not.
"""
def SetStyle(self, start, end, style):
"""
SetStyle(start, end, style) -> bool
Changes the style of the given range.
"""
def ShowPosition(self, pos):
"""
ShowPosition(pos)
Makes the line containing the given position visible.
"""
def XYToPosition(self, x, y):
"""
XYToPosition(x, y) -> long
Converts the given zero based column and line number to a position.
"""
SearchButtonVisible = property(None, None)
CancelButtonVisible = property(None, None)
DefaultStyle = property(None, None)
DescriptiveText = property(None, None)
Hint = property(None, None)
InsertionPoint = property(None, None)
LastPosition = property(None, None)
Margins = property(None, None)
Menu = property(None, None)
NumberOfLines = property(None, None)
StringSelection = property(None, None)
Value = property(None, None)
# end of class SearchCtrl
EVT_SEARCHCTRL_CANCEL_BTN = wx.PyEventBinder( wxEVT_SEARCHCTRL_CANCEL_BTN, 1)
EVT_SEARCHCTRL_SEARCH_BTN = wx.PyEventBinder( wxEVT_SEARCHCTRL_SEARCH_BTN, 1)
# deprecated wxEVT aliases
wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN = wxEVT_SEARCHCTRL_CANCEL_BTN
wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN = wxEVT_SEARCHCTRL_SEARCH_BTN
#-- end-srchctrl --#
#-- begin-radiobox --#
RadioBoxNameStr = ""
class RadioBox(Control, ItemContainerImmutable):
"""
RadioBox()
RadioBox(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, choices=[], majorDimension=0, style=RA_SPECIFY_COLS, validator=DefaultValidator, name=RadioBoxNameStr)
A radio box item is used to select one of number of mutually exclusive
choices.
"""
def __init__(self, *args, **kw):
"""
RadioBox()
RadioBox(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, choices=[], majorDimension=0, style=RA_SPECIFY_COLS, validator=DefaultValidator, name=RadioBoxNameStr)
A radio box item is used to select one of number of mutually exclusive
choices.
"""
def Create(self, *args, **kw):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, choices=[], majorDimension=0, style=RA_SPECIFY_COLS, validator=DefaultValidator, name=RadioBoxNameStr) -> bool
Creates the radiobox for two-step construction.
"""
def EnableItem(self, n, enable=True):
"""
EnableItem(n, enable=True) -> bool
Enables or disables an individual button in the radiobox.
"""
def FindString(self, string, bCase=False):
"""
FindString(string, bCase=False) -> int
Finds a button matching the given string, returning the position if
found, or wxNOT_FOUND if not found.
"""
def GetColumnCount(self):
"""
GetColumnCount() -> unsignedint
Returns the number of columns in the radiobox.
"""
def GetItemFromPoint(self, pt):
"""
GetItemFromPoint(pt) -> int
Returns a radio box item under the point, a zero-based item index, or
wxNOT_FOUND if no item is under the point.
"""
def GetItemHelpText(self, item):
"""
GetItemHelpText(item) -> String
Returns the helptext associated with the specified item if any or
wxEmptyString.
"""
def GetItemToolTip(self, item):
"""
GetItemToolTip(item) -> ToolTip
Returns the tooltip associated with the specified item if any or NULL.
"""
def GetRowCount(self):
"""
GetRowCount() -> unsignedint
Returns the number of rows in the radiobox.
"""
def IsItemEnabled(self, n):
"""
IsItemEnabled(n) -> bool
Returns true if the item is enabled or false if it was disabled using
Enable(n, false).
"""
def IsItemShown(self, n):
"""
IsItemShown(n) -> bool
Returns true if the item is currently shown or false if it was hidden
using Show(n, false).
"""
def SetItemHelpText(self, item, helptext):
"""
SetItemHelpText(item, helptext)
Sets the helptext for an item.
"""
def SetItemToolTip(self, item, text):
"""
SetItemToolTip(item, text)
Sets the tooltip text for the specified item in the radio group.
"""
def SetSelection(self, n):
"""
SetSelection(n)
Sets the selection to the given item.
"""
def ShowItem(self, item, show=True):
"""
ShowItem(item, show=True) -> bool
Shows or hides individual buttons.
"""
def GetCount(self):
"""
GetCount() -> unsignedint
Returns the number of items in the control.
"""
def GetString(self, n):
"""
GetString(n) -> String
Returns the label of the item with the given index.
"""
def SetString(self, n, string):
"""
SetString(n, string)
Sets the label for the given item.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the index of the selected item or wxNOT_FOUND if no item is
selected.
"""
def GetItemLabel(self, n):
"""
GetItemLabel(self, n) -> string
Return the text of the n'th item in the radio box.
"""
def SetItemLabel(self, n, text):
"""
SetItemLabel(self, n, text)
Set the text of the n'th item in the radio box.
"""
ColumnCount = property(None, None)
Count = property(None, None)
RowCount = property(None, None)
Selection = property(None, None)
# end of class RadioBox
#-- end-radiobox --#
#-- begin-radiobut --#
RadioButtonNameStr = ""
class RadioButton(Control):
"""
RadioButton()
RadioButton(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=RadioButtonNameStr)
A radio button item is a button which usually denotes one of several
mutually exclusive options.
"""
def __init__(self, *args, **kw):
"""
RadioButton()
RadioButton(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=RadioButtonNameStr)
A radio button item is a button which usually denotes one of several
mutually exclusive options.
"""
def Create(self, parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=RadioButtonNameStr):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=RadioButtonNameStr) -> bool
Creates the choice for two-step construction.
"""
def GetValue(self):
"""
GetValue() -> bool
Returns true if the radio button is checked, false otherwise.
"""
def SetValue(self, value):
"""
SetValue(value)
Sets the radio button to checked or unchecked status.
"""
Value = property(None, None)
# end of class RadioButton
#-- end-radiobut --#
#-- begin-slider --#
SL_HORIZONTAL = 0
SL_VERTICAL = 0
SL_TICKS = 0
SL_AUTOTICKS = 0
SL_LEFT = 0
SL_TOP = 0
SL_RIGHT = 0
SL_BOTTOM = 0
SL_BOTH = 0
SL_SELRANGE = 0
SL_INVERSE = 0
SL_MIN_MAX_LABELS = 0
SL_VALUE_LABEL = 0
SL_LABELS = 0
SliderNameStr = ""
class Slider(Control):
"""
Slider()
Slider(parent, id=ID_ANY, value=0, minValue=0, maxValue=100, pos=DefaultPosition, size=DefaultSize, style=SL_HORIZONTAL, validator=DefaultValidator, name=SliderNameStr)
A slider is a control with a handle which can be pulled back and forth
to change the value.
"""
def __init__(self, *args, **kw):
"""
Slider()
Slider(parent, id=ID_ANY, value=0, minValue=0, maxValue=100, pos=DefaultPosition, size=DefaultSize, style=SL_HORIZONTAL, validator=DefaultValidator, name=SliderNameStr)
A slider is a control with a handle which can be pulled back and forth
to change the value.
"""
def ClearSel(self):
"""
ClearSel()
Clears the selection, for a slider with the wxSL_SELRANGE style.
"""
def ClearTicks(self):
"""
ClearTicks()
Clears the ticks.
"""
def Create(self, parent, id=ID_ANY, value=0, minValue=0, maxValue=100, point=DefaultPosition, size=DefaultSize, style=SL_HORIZONTAL, validator=DefaultValidator, name=SliderNameStr):
"""
Create(parent, id=ID_ANY, value=0, minValue=0, maxValue=100, point=DefaultPosition, size=DefaultSize, style=SL_HORIZONTAL, validator=DefaultValidator, name=SliderNameStr) -> bool
Used for two-step slider construction.
"""
def GetLineSize(self):
"""
GetLineSize() -> int
Returns the line size.
"""
def GetMax(self):
"""
GetMax() -> int
Gets the maximum slider value.
"""
def GetMin(self):
"""
GetMin() -> int
Gets the minimum slider value.
"""
def GetPageSize(self):
"""
GetPageSize() -> int
Returns the page size.
"""
def GetSelEnd(self):
"""
GetSelEnd() -> int
Returns the selection end point.
"""
def GetSelStart(self):
"""
GetSelStart() -> int
Returns the selection start point.
"""
def GetThumbLength(self):
"""
GetThumbLength() -> int
Returns the thumb length.
"""
def GetTickFreq(self):
"""
GetTickFreq() -> int
Returns the tick frequency.
"""
def GetValue(self):
"""
GetValue() -> int
Gets the current slider value.
"""
def SetLineSize(self, lineSize):
"""
SetLineSize(lineSize)
Sets the line size for the slider.
"""
def SetMin(self, minValue):
"""
SetMin(minValue)
Sets the minimum slider value.
"""
def SetMax(self, maxValue):
"""
SetMax(maxValue)
Sets the maximum slider value.
"""
def SetPageSize(self, pageSize):
"""
SetPageSize(pageSize)
Sets the page size for the slider.
"""
def SetRange(self, minValue, maxValue):
"""
SetRange(minValue, maxValue)
Sets the minimum and maximum slider values.
"""
def SetSelection(self, startPos, endPos):
"""
SetSelection(startPos, endPos)
Sets the selection.
"""
def SetThumbLength(self, len):
"""
SetThumbLength(len)
Sets the slider thumb length.
"""
def SetTick(self, tickPos):
"""
SetTick(tickPos)
Sets a tick position.
"""
def SetTickFreq(self, n):
"""
SetTickFreq(n)
Sets the tick mark frequency and position.
"""
def SetValue(self, value):
"""
SetValue(value)
Sets the slider position.
"""
def GetRange(self):
"""
"""
LineSize = property(None, None)
Max = property(None, None)
Min = property(None, None)
PageSize = property(None, None)
Range = property(None, None)
SelEnd = property(None, None)
SelStart = property(None, None)
ThumbLength = property(None, None)
TickFreq = property(None, None)
Value = property(None, None)
# end of class Slider
#-- end-slider --#
#-- begin-spinbutt --#
class SpinButton(Control):
"""
SpinButton()
SpinButton(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SP_VERTICAL, name="spinButton")
A wxSpinButton has two small up and down (or left and right) arrow
buttons.
"""
def __init__(self, *args, **kw):
"""
SpinButton()
SpinButton(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SP_VERTICAL, name="spinButton")
A wxSpinButton has two small up and down (or left and right) arrow
buttons.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SP_VERTICAL, name="wxSpinButton"):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SP_VERTICAL, name="wxSpinButton") -> bool
Scrollbar creation function called by the spin button constructor.
"""
def GetMax(self):
"""
GetMax() -> int
Returns the maximum permissible value.
"""
def GetMin(self):
"""
GetMin() -> int
Returns the minimum permissible value.
"""
def GetValue(self):
"""
GetValue() -> int
Returns the current spin button value.
"""
def SetRange(self, min, max):
"""
SetRange(min, max)
Sets the range of the spin button.
"""
def SetValue(self, value):
"""
SetValue(value)
Sets the value of the spin button.
"""
def GetRange(self):
"""
"""
def SetMin(self, minVal):
"""
"""
def SetMax(self, maxVal):
"""
"""
EVT_SPIN_UP = wx.PyEventBinder( wxEVT_SPIN_UP, 1)
EVT_SPIN_DOWN = wx.PyEventBinder( wxEVT_SPIN_DOWN, 1)
EVT_SPIN = wx.PyEventBinder( wxEVT_SPIN, 1)
Max = property(None, None)
Min = property(None, None)
Range = property(None, None)
Value = property(None, None)
# end of class SpinButton
class SpinEvent(NotifyEvent):
"""
SpinEvent(commandType=wxEVT_NULL, id=0)
This event class is used for the events generated by wxSpinButton and
wxSpinCtrl.
"""
def __init__(self, commandType=wxEVT_NULL, id=0):
"""
SpinEvent(commandType=wxEVT_NULL, id=0)
This event class is used for the events generated by wxSpinButton and
wxSpinCtrl.
"""
def GetPosition(self):
"""
GetPosition() -> int
Retrieve the current spin button or control value.
"""
def SetPosition(self, pos):
"""
SetPosition(pos)
Set the value associated with the event.
"""
Position = property(None, None)
# end of class SpinEvent
#-- end-spinbutt --#
#-- begin-spinctrl --#
wxEVT_SPINCTRL = 0
wxEVT_SPINCTRLDOUBLE = 0
class SpinCtrl(Control):
"""
SpinCtrl()
SpinCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, name="wxSpinCtrl")
wxSpinCtrl combines wxTextCtrl and wxSpinButton in one control.
"""
def __init__(self, *args, **kw):
"""
SpinCtrl()
SpinCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, name="wxSpinCtrl")
wxSpinCtrl combines wxTextCtrl and wxSpinButton in one control.
"""
def Create(self, parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, name="wxSpinCtrl"):
"""
Create(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, name="wxSpinCtrl") -> bool
Creation function called by the spin control constructor.
"""
def GetBase(self):
"""
GetBase() -> int
Returns the numerical base being currently used, 10 by default.
"""
def GetMax(self):
"""
GetMax() -> int
Gets maximal allowable value.
"""
def GetMin(self):
"""
GetMin() -> int
Gets minimal allowable value.
"""
def GetValue(self):
"""
GetValue() -> int
Gets the value of the spin control.
"""
def SetBase(self, base):
"""
SetBase(base) -> bool
Sets the base to use for the numbers in this control.
"""
def SetRange(self, minVal, maxVal):
"""
SetRange(minVal, maxVal)
Sets range of allowable values.
"""
def SetSelection(self, from_, to_):
"""
SetSelection(from_, to_)
Select the text in the text part of the control between positions from
(inclusive) and to (exclusive).
"""
def SetValue(self, *args, **kw):
"""
SetValue(text)
SetValue(value)
Sets the value of the spin control.
"""
def GetRange(self):
"""
"""
def SetMin(self, minVal):
"""
"""
def SetMax(self, maxVal):
"""
"""
Base = property(None, None)
Max = property(None, None)
Min = property(None, None)
Range = property(None, None)
Value = property(None, None)
# end of class SpinCtrl
class SpinCtrlDouble(Control):
"""
SpinCtrlDouble()
SpinCtrlDouble(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, inc=1, name=T("wxSpinCtrlDouble"))
wxSpinCtrlDouble combines wxTextCtrl and wxSpinButton in one control
and displays a real number.
"""
def __init__(self, *args, **kw):
"""
SpinCtrlDouble()
SpinCtrlDouble(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, inc=1, name=T("wxSpinCtrlDouble"))
wxSpinCtrlDouble combines wxTextCtrl and wxSpinButton in one control
and displays a real number.
"""
def Create(self, parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, inc=1, name="wxSpinCtrlDouble"):
"""
Create(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=SP_ARROW_KEYS, min=0, max=100, initial=0, inc=1, name="wxSpinCtrlDouble") -> bool
Creation function called by the spin control constructor.
"""
def GetDigits(self):
"""
GetDigits() -> unsignedint
Gets the number of digits in the display.
"""
def GetIncrement(self):
"""
GetIncrement() -> double
Gets the increment value.
"""
def GetMax(self):
"""
GetMax() -> double
Gets maximal allowable value.
"""
def GetMin(self):
"""
GetMin() -> double
Gets minimal allowable value.
"""
def GetValue(self):
"""
GetValue() -> double
Gets the value of the spin control.
"""
def SetDigits(self, digits):
"""
SetDigits(digits)
Sets the number of digits in the display.
"""
def SetIncrement(self, inc):
"""
SetIncrement(inc)
Sets the increment value.
"""
def SetRange(self, minVal, maxVal):
"""
SetRange(minVal, maxVal)
Sets range of allowable values.
"""
def SetValue(self, *args, **kw):
"""
SetValue(text)
SetValue(value)
Sets the value of the spin control.
"""
def GetRange(self):
"""
"""
def SetMin(self, minVal):
"""
"""
def SetMax(self, maxVal):
"""
"""
Digits = property(None, None)
Increment = property(None, None)
Max = property(None, None)
Min = property(None, None)
Range = property(None, None)
Value = property(None, None)
# end of class SpinCtrlDouble
class SpinDoubleEvent(NotifyEvent):
"""
SpinDoubleEvent(commandType=wxEVT_NULL, winid=0, value=0)
SpinDoubleEvent(event)
This event class is used for the events generated by wxSpinCtrlDouble.
"""
def __init__(self, *args, **kw):
"""
SpinDoubleEvent(commandType=wxEVT_NULL, winid=0, value=0)
SpinDoubleEvent(event)
This event class is used for the events generated by wxSpinCtrlDouble.
"""
def GetValue(self):
"""
GetValue() -> double
Returns the value associated with this spin control event.
"""
def SetValue(self, value):
"""
SetValue(value)
Set the value associated with the event.
"""
Value = property(None, None)
# end of class SpinDoubleEvent
EVT_SPINCTRL = wx.PyEventBinder( wxEVT_SPINCTRL, 1)
EVT_SPINCTRLDOUBLE = wx.PyEventBinder( wxEVT_SPINCTRLDOUBLE, 1)
# deprecated wxEVT aliases
wxEVT_COMMAND_SPINCTRL_UPDATED = wxEVT_SPINCTRL
wxEVT_COMMAND_SPINCTRLDOUBLE_UPDATED = wxEVT_SPINCTRLDOUBLE
#-- end-spinctrl --#
#-- begin-tglbtn --#
wxEVT_TOGGLEBUTTON = 0
class ToggleButton(AnyButton):
"""
ToggleButton()
ToggleButton(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr)
wxToggleButton is a button that stays pressed when clicked by the
user.
"""
def __init__(self, *args, **kw):
"""
ToggleButton()
ToggleButton(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr)
wxToggleButton is a button that stays pressed when clicked by the
user.
"""
def Create(self, parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr):
"""
Create(parent, id=ID_ANY, label=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr) -> bool
Creates the toggle button for two-step construction.
"""
def GetValue(self):
"""
GetValue() -> bool
Gets the state of the toggle button.
"""
def SetValue(self, state):
"""
SetValue(state)
Sets the toggle button to the given state.
"""
Value = property(None, None)
# end of class ToggleButton
class BitmapToggleButton(ToggleButton):
"""
BitmapToggleButton()
BitmapToggleButton(parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr)
wxBitmapToggleButton is a wxToggleButton that contains a bitmap
instead of text.
"""
def __init__(self, *args, **kw):
"""
BitmapToggleButton()
BitmapToggleButton(parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr)
wxBitmapToggleButton is a wxToggleButton that contains a bitmap
instead of text.
"""
def Create(self, parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr):
"""
Create(parent, id=ID_ANY, label=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, val=DefaultValidator, name=CheckBoxNameStr) -> bool
Create method for two-step construction.
"""
def GetValue(self):
"""
GetValue() -> bool
Gets the state of the toggle button.
"""
def SetValue(self, state):
"""
SetValue(state)
Sets the toggle button to the given state.
"""
Value = property(None, None)
# end of class BitmapToggleButton
EVT_TOGGLEBUTTON = PyEventBinder(wxEVT_TOGGLEBUTTON, 1)
# deprecated wxEVT alias
wxEVT_COMMAND_TOGGLEBUTTON_CLICKED = wxEVT_TOGGLEBUTTON
#-- end-tglbtn --#
#-- begin-scrolbar --#
ScrollBarNameStr = ""
class ScrollBar(Control):
"""
ScrollBar()
ScrollBar(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SB_HORIZONTAL, validator=DefaultValidator, name=ScrollBarNameStr)
A wxScrollBar is a control that represents a horizontal or vertical
scrollbar.
"""
def __init__(self, *args, **kw):
"""
ScrollBar()
ScrollBar(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SB_HORIZONTAL, validator=DefaultValidator, name=ScrollBarNameStr)
A wxScrollBar is a control that represents a horizontal or vertical
scrollbar.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SB_HORIZONTAL, validator=DefaultValidator, name=ScrollBarNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=SB_HORIZONTAL, validator=DefaultValidator, name=ScrollBarNameStr) -> bool
Scrollbar creation function called by the scrollbar constructor.
"""
def GetPageSize(self):
"""
GetPageSize() -> int
Returns the page size of the scrollbar.
"""
def GetRange(self):
"""
GetRange() -> int
Returns the length of the scrollbar.
"""
def GetThumbPosition(self):
"""
GetThumbPosition() -> int
Returns the current position of the scrollbar thumb.
"""
def GetThumbSize(self):
"""
GetThumbSize() -> int
Returns the thumb or 'view' size.
"""
def SetScrollbar(self, position, thumbSize, range, pageSize, refresh=True):
"""
SetScrollbar(position, thumbSize, range, pageSize, refresh=True)
Sets the scrollbar properties.
"""
def SetThumbPosition(self, viewStart):
"""
SetThumbPosition(viewStart)
Sets the position of the scrollbar.
"""
def IsVertical(self):
"""
IsVertical() -> bool
Returns true for scrollbars that have the vertical style set.
"""
PageSize = property(None, None)
Range = property(None, None)
ThumbPosition = property(None, None)
ThumbSize = property(None, None)
# end of class ScrollBar
#-- end-scrolbar --#
#-- begin-toolbar --#
TOOL_STYLE_BUTTON = 0
TOOL_STYLE_SEPARATOR = 0
TOOL_STYLE_CONTROL = 0
TB_HORIZONTAL = 0
TB_TOP = 0
TB_VERTICAL = 0
TB_LEFT = 0
TB_3DBUTTONS = 0
TB_FLAT = 0
TB_DOCKABLE = 0
TB_NOICONS = 0
TB_TEXT = 0
TB_NODIVIDER = 0
TB_NOALIGN = 0
TB_HORZ_LAYOUT = 0
TB_HORZ_TEXT = 0
TB_NO_TOOLTIPS = 0
TB_BOTTOM = 0
TB_RIGHT = 0
TB_DEFAULT_STYLE = 0
class ToolBarToolBase(Object):
"""
ToolBarToolBase(tbar=None, toolid=ID_SEPARATOR, label=EmptyString, bmpNormal=NullBitmap, bmpDisabled=NullBitmap, kind=ITEM_NORMAL, clientData=None, shortHelpString=EmptyString, longHelpString=EmptyString)
ToolBarToolBase(tbar, control, label)
A toolbar tool represents one item on the toolbar.
"""
def __init__(self, *args, **kw):
"""
ToolBarToolBase(tbar=None, toolid=ID_SEPARATOR, label=EmptyString, bmpNormal=NullBitmap, bmpDisabled=NullBitmap, kind=ITEM_NORMAL, clientData=None, shortHelpString=EmptyString, longHelpString=EmptyString)
ToolBarToolBase(tbar, control, label)
A toolbar tool represents one item on the toolbar.
"""
def GetId(self):
"""
GetId() -> int
"""
def GetControl(self):
"""
GetControl() -> Control
"""
def GetToolBar(self):
"""
GetToolBar() -> ToolBar
Return the toolbar this tool is a member of.
"""
def IsStretchable(self):
"""
IsStretchable() -> bool
"""
def IsButton(self):
"""
IsButton() -> bool
"""
def IsControl(self):
"""
IsControl() -> bool
"""
def IsSeparator(self):
"""
IsSeparator() -> bool
"""
def IsStretchableSpace(self):
"""
IsStretchableSpace() -> bool
"""
def GetStyle(self):
"""
GetStyle() -> int
"""
def GetKind(self):
"""
GetKind() -> ItemKind
"""
def MakeStretchable(self):
"""
MakeStretchable()
"""
def IsEnabled(self):
"""
IsEnabled() -> bool
"""
def IsToggled(self):
"""
IsToggled() -> bool
"""
def CanBeToggled(self):
"""
CanBeToggled() -> bool
"""
def GetNormalBitmap(self):
"""
GetNormalBitmap() -> Bitmap
"""
def GetDisabledBitmap(self):
"""
GetDisabledBitmap() -> Bitmap
"""
def GetBitmap(self):
"""
GetBitmap() -> Bitmap
"""
def GetLabel(self):
"""
GetLabel() -> String
"""
def GetShortHelp(self):
"""
GetShortHelp() -> String
"""
def GetLongHelp(self):
"""
GetLongHelp() -> String
"""
def GetClientData(self):
"""
GetClientData() -> PyUserData
"""
def Enable(self, enable):
"""
Enable(enable) -> bool
"""
def Toggle(self, *args, **kw):
"""
Toggle(toggle) -> bool
Toggle()
"""
def SetToggle(self, toggle):
"""
SetToggle(toggle) -> bool
"""
def SetShortHelp(self, help):
"""
SetShortHelp(help) -> bool
"""
def SetLongHelp(self, help):
"""
SetLongHelp(help) -> bool
"""
def SetNormalBitmap(self, bmp):
"""
SetNormalBitmap(bmp)
"""
def SetDisabledBitmap(self, bmp):
"""
SetDisabledBitmap(bmp)
"""
def SetLabel(self, label):
"""
SetLabel(label)
"""
def SetClientData(self, clientData):
"""
SetClientData(clientData)
"""
def Detach(self):
"""
Detach()
"""
def Attach(self, tbar):
"""
Attach(tbar)
"""
def SetDropdownMenu(self, menu):
"""
SetDropdownMenu(menu)
"""
def GetDropdownMenu(self):
"""
GetDropdownMenu() -> Menu
"""
Bitmap = property(None, None)
ClientData = property(None, None)
Control = property(None, None)
DisabledBitmap = property(None, None)
DropdownMenu = property(None, None)
Id = property(None, None)
Kind = property(None, None)
Label = property(None, None)
LongHelp = property(None, None)
NormalBitmap = property(None, None)
ShortHelp = property(None, None)
Style = property(None, None)
ToolBar = property(None, None)
# end of class ToolBarToolBase
ToolBarNameStr = ""
class ToolBar(Control):
"""
ToolBar()
ToolBar(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TB_HORIZONTAL, name=ToolBarNameStr)
A toolbar is a bar of buttons and/or other controls usually placed
below the menu bar in a wxFrame.
"""
def __init__(self, *args, **kw):
"""
ToolBar()
ToolBar(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TB_HORIZONTAL, name=ToolBarNameStr)
A toolbar is a bar of buttons and/or other controls usually placed
below the menu bar in a wxFrame.
"""
def AddTool(self, *args, **kw):
"""
AddTool(tool) -> ToolBarToolBase
AddTool(toolId, label, bitmap, shortHelp=EmptyString, kind=ITEM_NORMAL) -> ToolBarToolBase
AddTool(toolId, label, bitmap, bmpDisabled, kind=ITEM_NORMAL, shortHelpString=EmptyString, longHelpString=EmptyString, clientData=None) -> ToolBarToolBase
Adds a tool to the toolbar.
"""
def InsertTool(self, *args, **kw):
"""
InsertTool(pos, toolId, label, bitmap, bmpDisabled=NullBitmap, kind=ITEM_NORMAL, shortHelp=EmptyString, longHelp=EmptyString, clientData=None) -> ToolBarToolBase
InsertTool(pos, tool) -> ToolBarToolBase
Inserts the tool with the specified attributes into the toolbar at the
given position.
"""
def SetMargins(self, *args, **kw):
"""
SetMargins(x, y)
SetMargins(size)
Set the values to be used as margins for the toolbar.
"""
def AddCheckTool(self, toolId, label, bitmap1, bmpDisabled=NullBitmap, shortHelp=EmptyString, longHelp=EmptyString, clientData=None):
"""
AddCheckTool(toolId, label, bitmap1, bmpDisabled=NullBitmap, shortHelp=EmptyString, longHelp=EmptyString, clientData=None) -> ToolBarToolBase
Adds a new check (or toggle) tool to the toolbar.
"""
def AddControl(self, control, label=EmptyString):
"""
AddControl(control, label=EmptyString) -> ToolBarToolBase
Adds any control to the toolbar, typically e.g. a wxComboBox.
"""
def AddRadioTool(self, toolId, label, bitmap1, bmpDisabled=NullBitmap, shortHelp=EmptyString, longHelp=EmptyString, clientData=None):
"""
AddRadioTool(toolId, label, bitmap1, bmpDisabled=NullBitmap, shortHelp=EmptyString, longHelp=EmptyString, clientData=None) -> ToolBarToolBase
Adds a new radio tool to the toolbar.
"""
def AddSeparator(self):
"""
AddSeparator() -> ToolBarToolBase
Adds a separator for spacing groups of tools.
"""
def AddStretchableSpace(self):
"""
AddStretchableSpace() -> ToolBarToolBase
Adds a stretchable space to the toolbar.
"""
def ClearTools(self):
"""
ClearTools()
Deletes all the tools in the toolbar.
"""
def DeleteTool(self, toolId):
"""
DeleteTool(toolId) -> bool
Removes the specified tool from the toolbar and deletes it.
"""
def DeleteToolByPos(self, pos):
"""
DeleteToolByPos(pos) -> bool
This function behaves like DeleteTool() but it deletes the tool at the
specified position and not the one with the given id.
"""
def EnableTool(self, toolId, enable):
"""
EnableTool(toolId, enable)
Enables or disables the tool.
"""
def FindById(self, id):
"""
FindById(id) -> ToolBarToolBase
Returns a pointer to the tool identified by id or NULL if no
corresponding tool is found.
"""
def FindControl(self, id):
"""
FindControl(id) -> Control
Returns a pointer to the control identified by id or NULL if no
corresponding control is found.
"""
def FindToolForPosition(self, x, y):
"""
FindToolForPosition(x, y) -> ToolBarToolBase
Finds a tool for the given mouse position.
"""
def GetMargins(self):
"""
GetMargins() -> Size
Returns the left/right and top/bottom margins, which are also used for
inter-toolspacing.
"""
def GetToolBitmapSize(self):
"""
GetToolBitmapSize() -> Size
Returns the size of bitmap that the toolbar expects to have.
"""
def GetToolByPos(self, pos):
"""
GetToolByPos(pos) -> ToolBarToolBase
Returns a pointer to the tool at ordinal position pos.
"""
def GetToolClientData(self, toolId):
"""
GetToolClientData(toolId) -> PyUserData
Get any client data associated with the tool.
"""
def GetToolEnabled(self, toolId):
"""
GetToolEnabled(toolId) -> bool
Called to determine whether a tool is enabled (responds to user
input).
"""
def GetToolLongHelp(self, toolId):
"""
GetToolLongHelp(toolId) -> String
Returns the long help for the given tool.
"""
def GetToolPacking(self):
"""
GetToolPacking() -> int
Returns the value used for packing tools.
"""
def GetToolPos(self, toolId):
"""
GetToolPos(toolId) -> int
Returns the tool position in the toolbar, or wxNOT_FOUND if the tool
is not found.
"""
def GetToolSeparation(self):
"""
GetToolSeparation() -> int
Returns the default separator size.
"""
def GetToolShortHelp(self, toolId):
"""
GetToolShortHelp(toolId) -> String
Returns the short help for the given tool.
"""
def GetToolSize(self):
"""
GetToolSize() -> Size
Returns the size of a whole button, which is usually larger than a
tool bitmap because of added 3D effects.
"""
def GetToolState(self, toolId):
"""
GetToolState(toolId) -> bool
Gets the on/off state of a toggle tool.
"""
def GetToolsCount(self):
"""
GetToolsCount() -> size_t
Returns the number of tools in the toolbar.
"""
def InsertControl(self, pos, control, label=EmptyString):
"""
InsertControl(pos, control, label=EmptyString) -> ToolBarToolBase
Inserts the control into the toolbar at the given position.
"""
def InsertSeparator(self, pos):
"""
InsertSeparator(pos) -> ToolBarToolBase
Inserts the separator into the toolbar at the given position.
"""
def InsertStretchableSpace(self, pos):
"""
InsertStretchableSpace(pos) -> ToolBarToolBase
Inserts a stretchable space at the given position.
"""
def Realize(self):
"""
Realize() -> bool
This function should be called after you have added tools.
"""
def RemoveTool(self, id):
"""
RemoveTool(id) -> ToolBarToolBase
Removes the given tool from the toolbar but doesn't delete it.
"""
def SetDropdownMenu(self, id, menu):
"""
SetDropdownMenu(id, menu) -> bool
Sets the dropdown menu for the tool given by its id.
"""
def SetToolBitmapSize(self, size):
"""
SetToolBitmapSize(size)
Sets the default size of each tool bitmap.
"""
def SetToolClientData(self, id, clientData):
"""
SetToolClientData(id, clientData)
Sets the client data associated with the tool.
"""
def SetToolDisabledBitmap(self, id, bitmap):
"""
SetToolDisabledBitmap(id, bitmap)
Sets the bitmap to be used by the tool with the given ID when the tool
is in a disabled state.
"""
def SetToolLongHelp(self, toolId, helpString):
"""
SetToolLongHelp(toolId, helpString)
Sets the long help for the given tool.
"""
def SetToolNormalBitmap(self, id, bitmap):
"""
SetToolNormalBitmap(id, bitmap)
Sets the bitmap to be used by the tool with the given ID.
"""
def SetToolPacking(self, packing):
"""
SetToolPacking(packing)
Sets the value used for spacing tools.
"""
def SetToolSeparation(self, separation):
"""
SetToolSeparation(separation)
Sets the default separator size.
"""
def SetToolShortHelp(self, toolId, helpString):
"""
SetToolShortHelp(toolId, helpString)
Sets the short help for the given tool.
"""
def ToggleTool(self, toolId, toggle):
"""
ToggleTool(toolId, toggle)
Toggles a tool on or off.
"""
def CreateTool(self, *args, **kw):
"""
CreateTool(toolId, label, bmpNormal, bmpDisabled=NullBitmap, kind=ITEM_NORMAL, clientData=None, shortHelp=EmptyString, longHelp=EmptyString) -> ToolBarToolBase
CreateTool(control, label) -> ToolBarToolBase
Factory function to create a new toolbar tool.
"""
def AddSimpleTool(self, toolId, bitmap, shortHelpString="", longHelpString="", isToggle=0):
"""
Old style method to add a tool to the toolbar.
"""
def AddLabelTool(self, id, label, bitmap, bmpDisabled=wx.NullBitmap, kind=wx.ITEM_NORMAL, shortHelp="", longHelp="", clientData=None):
"""
Old style method to add a tool in the toolbar.
"""
def InsertSimpleTool(self, pos, toolId, bitmap, shortHelpString="", longHelpString="", isToggle=0):
"""
Old style method to insert a tool in the toolbar.
"""
def InsertLabelTool(self, pos, id, label, bitmap, bmpDisabled=wx.NullBitmap, kind=wx.ITEM_NORMAL, shortHelp="", longHelp="", clientData=None):
"""
Old style method to insert a tool in the toolbar.
"""
Margins = property(None, None)
ToolBitmapSize = property(None, None)
ToolPacking = property(None, None)
ToolSeparation = property(None, None)
ToolSize = property(None, None)
ToolsCount = property(None, None)
# end of class ToolBar
#-- end-toolbar --#
#-- begin-infobar --#
class InfoBar(Control):
"""
InfoBar()
InfoBar(parent, winid=ID_ANY)
An info bar is a transient window shown at top or bottom of its parent
window to display non-critical information to the user.
"""
def __init__(self, *args, **kw):
"""
InfoBar()
InfoBar(parent, winid=ID_ANY)
An info bar is a transient window shown at top or bottom of its parent
window to display non-critical information to the user.
"""
def SetShowHideEffects(self, showEffect, hideEffect):
"""
SetShowHideEffects(showEffect, hideEffect)
Set the effects to use when showing and hiding the bar.
"""
def GetShowEffect(self):
"""
GetShowEffect() -> ShowEffect
Return the effect currently used for showing the bar.
"""
def GetHideEffect(self):
"""
GetHideEffect() -> ShowEffect
Return the effect currently used for hiding the bar.
"""
def SetEffectDuration(self, duration):
"""
SetEffectDuration(duration)
Set the duration of the animation used when showing or hiding the bar.
"""
def GetEffectDuration(self):
"""
GetEffectDuration() -> int
Return the effect animation duration currently used.
"""
def SetFont(self, font):
"""
SetFont(font) -> bool
Overridden base class methods changes the font of the text message.
"""
def Create(self, parent, winid=ID_ANY):
"""
Create(parent, winid=ID_ANY) -> bool
Create the info bar window.
"""
def AddButton(self, btnid, label=""):
"""
AddButton(btnid, label="")
Add a button to be shown in the info bar.
"""
def Dismiss(self):
"""
Dismiss()
Hide the info bar window.
"""
def RemoveButton(self, btnid):
"""
RemoveButton(btnid)
Remove a button previously added by AddButton().
"""
def ShowMessage(self, msg, flags=ICON_INFORMATION):
"""
ShowMessage(msg, flags=ICON_INFORMATION)
Show a message in the bar.
"""
EffectDuration = property(None, None)
HideEffect = property(None, None)
ShowEffect = property(None, None)
# end of class InfoBar
#-- end-infobar --#
#-- begin-listctrl --#
LC_VRULES = 0
LC_HRULES = 0
LC_ICON = 0
LC_SMALL_ICON = 0
LC_LIST = 0
LC_REPORT = 0
LC_ALIGN_TOP = 0
LC_ALIGN_LEFT = 0
LC_AUTOARRANGE = 0
LC_VIRTUAL = 0
LC_EDIT_LABELS = 0
LC_NO_HEADER = 0
LC_NO_SORT_HEADER = 0
LC_SINGLE_SEL = 0
LC_SORT_ASCENDING = 0
LC_SORT_DESCENDING = 0
LC_MASK_TYPE = 0
LC_MASK_ALIGN = 0
LC_MASK_SORT = 0
LIST_MASK_STATE = 0
LIST_MASK_TEXT = 0
LIST_MASK_IMAGE = 0
LIST_MASK_DATA = 0
LIST_SET_ITEM = 0
LIST_MASK_WIDTH = 0
LIST_MASK_FORMAT = 0
LIST_STATE_DONTCARE = 0
LIST_STATE_DROPHILITED = 0
LIST_STATE_FOCUSED = 0
LIST_STATE_SELECTED = 0
LIST_STATE_CUT = 0
LIST_STATE_DISABLED = 0
LIST_STATE_FILTERED = 0
LIST_STATE_INUSE = 0
LIST_STATE_PICKED = 0
LIST_STATE_SOURCE = 0
LIST_HITTEST_ABOVE = 0
LIST_HITTEST_BELOW = 0
LIST_HITTEST_NOWHERE = 0
LIST_HITTEST_ONITEMICON = 0
LIST_HITTEST_ONITEMLABEL = 0
LIST_HITTEST_ONITEMRIGHT = 0
LIST_HITTEST_ONITEMSTATEICON = 0
LIST_HITTEST_TOLEFT = 0
LIST_HITTEST_TORIGHT = 0
LIST_HITTEST_ONITEM = 0
LIST_GETSUBITEMRECT_WHOLEITEM = 0
LIST_NEXT_ABOVE = 0
LIST_NEXT_ALL = 0
LIST_NEXT_BELOW = 0
LIST_NEXT_LEFT = 0
LIST_NEXT_RIGHT = 0
LIST_ALIGN_DEFAULT = 0
LIST_ALIGN_LEFT = 0
LIST_ALIGN_TOP = 0
LIST_ALIGN_SNAP_TO_GRID = 0
LIST_FORMAT_LEFT = 0
LIST_FORMAT_RIGHT = 0
LIST_FORMAT_CENTRE = 0
LIST_FORMAT_CENTER = 0
LIST_AUTOSIZE = 0
LIST_AUTOSIZE_USEHEADER = 0
LIST_RECT_BOUNDS = 0
LIST_RECT_ICON = 0
LIST_RECT_LABEL = 0
LIST_FIND_UP = 0
LIST_FIND_DOWN = 0
LIST_FIND_LEFT = 0
LIST_FIND_RIGHT = 0
wxEVT_LIST_BEGIN_DRAG = 0
wxEVT_LIST_BEGIN_RDRAG = 0
wxEVT_LIST_BEGIN_LABEL_EDIT = 0
wxEVT_LIST_END_LABEL_EDIT = 0
wxEVT_LIST_DELETE_ITEM = 0
wxEVT_LIST_DELETE_ALL_ITEMS = 0
wxEVT_LIST_ITEM_SELECTED = 0
wxEVT_LIST_ITEM_DESELECTED = 0
wxEVT_LIST_KEY_DOWN = 0
wxEVT_LIST_INSERT_ITEM = 0
wxEVT_LIST_COL_CLICK = 0
wxEVT_LIST_ITEM_RIGHT_CLICK = 0
wxEVT_LIST_ITEM_MIDDLE_CLICK = 0
wxEVT_LIST_ITEM_ACTIVATED = 0
wxEVT_LIST_CACHE_HINT = 0
wxEVT_LIST_COL_RIGHT_CLICK = 0
wxEVT_LIST_COL_BEGIN_DRAG = 0
wxEVT_LIST_COL_DRAGGING = 0
wxEVT_LIST_COL_END_DRAG = 0
wxEVT_LIST_ITEM_FOCUSED = 0
class ListItemAttr(object):
"""
ListItemAttr()
ListItemAttr(colText, colBack, font)
Represents the attributes (color, font, ...) of a wxListCtrl's
wxListItem.
"""
def __init__(self, *args, **kw):
"""
ListItemAttr()
ListItemAttr(colText, colBack, font)
Represents the attributes (color, font, ...) of a wxListCtrl's
wxListItem.
"""
def GetBackgroundColour(self):
"""
GetBackgroundColour() -> Colour
Returns the currently set background color.
"""
def GetFont(self):
"""
GetFont() -> Font
Returns the currently set font.
"""
def GetTextColour(self):
"""
GetTextColour() -> Colour
Returns the currently set text color.
"""
def HasBackgroundColour(self):
"""
HasBackgroundColour() -> bool
Returns true if the currently set background color is valid.
"""
def HasFont(self):
"""
HasFont() -> bool
Returns true if the currently set font is valid.
"""
def HasTextColour(self):
"""
HasTextColour() -> bool
Returns true if the currently set text color is valid.
"""
def SetBackgroundColour(self, colour):
"""
SetBackgroundColour(colour)
Sets a new background color.
"""
def SetFont(self, font):
"""
SetFont(font)
Sets a new font.
"""
def SetTextColour(self, colour):
"""
SetTextColour(colour)
Sets a new text color.
"""
BackgroundColour = property(None, None)
Font = property(None, None)
TextColour = property(None, None)
# end of class ListItemAttr
class ListItem(Object):
"""
ListItem()
This class stores information about a wxListCtrl item or column.
"""
def __init__(self):
"""
ListItem()
This class stores information about a wxListCtrl item or column.
"""
def SetData(self, *args, **kw):
"""
SetData(data)
Sets client data for the item.
"""
def Clear(self):
"""
Clear()
Resets the item state to the default.
"""
def GetAlign(self):
"""
GetAlign() -> ListColumnFormat
Returns the alignment for this item.
"""
def GetBackgroundColour(self):
"""
GetBackgroundColour() -> Colour
Returns the background colour for this item.
"""
def GetColumn(self):
"""
GetColumn() -> int
Returns the zero-based column; meaningful only in report mode.
"""
def GetData(self):
"""
GetData() -> long
Returns client data associated with the control.
"""
def GetFont(self):
"""
GetFont() -> Font
Returns the font used to display the item.
"""
def GetId(self):
"""
GetId() -> long
Returns the zero-based item position.
"""
def GetImage(self):
"""
GetImage() -> int
Returns the zero-based index of the image associated with the item
into the image list.
"""
def GetMask(self):
"""
GetMask() -> long
Returns a bit mask indicating which fields of the structure are valid.
"""
def GetState(self):
"""
GetState() -> long
Returns a bit field representing the state of the item.
"""
def GetText(self):
"""
GetText() -> String
Returns the label/header text.
"""
def GetTextColour(self):
"""
GetTextColour() -> Colour
Returns the text colour.
"""
def GetWidth(self):
"""
GetWidth() -> int
Meaningful only for column headers in report mode.
"""
def SetAlign(self, align):
"""
SetAlign(align)
Sets the alignment for the item.
"""
def SetBackgroundColour(self, colBack):
"""
SetBackgroundColour(colBack)
Sets the background colour for the item.
"""
def SetColumn(self, col):
"""
SetColumn(col)
Sets the zero-based column.
"""
def SetFont(self, font):
"""
SetFont(font)
Sets the font for the item.
"""
def SetId(self, id):
"""
SetId(id)
Sets the zero-based item position.
"""
def SetImage(self, image):
"""
SetImage(image)
Sets the zero-based index of the image associated with the item into
the image list.
"""
def SetMask(self, mask):
"""
SetMask(mask)
Sets the mask of valid fields.
"""
def SetState(self, state):
"""
SetState(state)
Sets the item state flags (note that the valid state flags are
influenced by the value of the state mask, see
wxListItem::SetStateMask).
"""
def SetStateMask(self, stateMask):
"""
SetStateMask(stateMask)
Sets the bitmask that is used to determine which of the state flags
are to be set.
"""
def SetText(self, text):
"""
SetText(text)
Sets the text label for the item.
"""
def SetTextColour(self, colText):
"""
SetTextColour(colText)
Sets the text colour for the item.
"""
def SetWidth(self, width):
"""
SetWidth(width)
Meaningful only for column headers in report mode.
"""
Align = property(None, None)
BackgroundColour = property(None, None)
Column = property(None, None)
Data = property(None, None)
Font = property(None, None)
Id = property(None, None)
Image = property(None, None)
Mask = property(None, None)
State = property(None, None)
Text = property(None, None)
TextColour = property(None, None)
Width = property(None, None)
# end of class ListItem
ListCtrlNameStr = ""
class ListCtrl(Control):
"""
ListCtrl()
ListCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_ICON, validator=DefaultValidator, name=ListCtrlNameStr)
A list control presents lists in a number of formats: list view,
report view, icon view and small icon view.
"""
def __init__(self, *args, **kw):
"""
ListCtrl()
ListCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_ICON, validator=DefaultValidator, name=ListCtrlNameStr)
A list control presents lists in a number of formats: list view,
report view, icon view and small icon view.
"""
def AppendColumn(self, heading, format=LIST_FORMAT_LEFT, width=-1):
"""
AppendColumn(heading, format=LIST_FORMAT_LEFT, width=-1) -> long
Adds a new column to the list control in report view mode.
"""
def Arrange(self, flag=LIST_ALIGN_DEFAULT):
"""
Arrange(flag=LIST_ALIGN_DEFAULT) -> bool
Arranges the items in icon or small icon view.
"""
def AssignImageList(self, imageList, which):
"""
AssignImageList(imageList, which)
Sets the image list associated with the control and takes ownership of
it (i.e.
"""
def ClearAll(self):
"""
ClearAll()
Deletes all items and all columns.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_ICON, validator=DefaultValidator, name=ListCtrlNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_ICON, validator=DefaultValidator, name=ListCtrlNameStr) -> bool
Creates the list control.
"""
def DeleteAllItems(self):
"""
DeleteAllItems() -> bool
Deletes all items in the list control.
"""
def DeleteColumn(self, col):
"""
DeleteColumn(col) -> bool
Deletes a column.
"""
def DeleteItem(self, item):
"""
DeleteItem(item) -> bool
Deletes the specified item.
"""
def EditLabel(self, item):
"""
EditLabel(item) -> TextCtrl
Starts editing the label of the given item.
"""
def EnableAlternateRowColours(self, enable=True):
"""
EnableAlternateRowColours(enable=True)
Enable alternating row background colours (also called zebra
striping).
"""
def EnableBellOnNoMatch(self, on=True):
"""
EnableBellOnNoMatch(on=True)
Enable or disable a beep if there is no match for the currently
entered text when searching for the item from keyboard.
"""
def EnsureVisible(self, item):
"""
EnsureVisible(item) -> bool
Ensures this item is visible.
"""
def FindItem(self, *args, **kw):
"""
FindItem(start, str, partial=False) -> long
FindItem(start, data) -> long
FindItem(start, pt, direction) -> long
Find an item whose label matches this string, starting from start or
the beginning if start is -1.
"""
def GetColumn(self, col):
"""
GetColumn(col) -> ListItem
Gets information about this column. See SetItem() for more
information.
"""
def GetColumnCount(self):
"""
GetColumnCount() -> int
Returns the number of columns.
"""
def GetColumnIndexFromOrder(self, pos):
"""
GetColumnIndexFromOrder(pos) -> int
Gets the column index from its position in visual order.
"""
def GetColumnOrder(self, col):
"""
GetColumnOrder(col) -> int
Gets the column visual order position.
"""
def GetColumnWidth(self, col):
"""
GetColumnWidth(col) -> int
Gets the column width (report view only).
"""
def GetColumnsOrder(self):
"""
GetColumnsOrder() -> ArrayInt
Returns the array containing the orders of all columns.
"""
def GetCountPerPage(self):
"""
GetCountPerPage() -> int
Gets the number of items that can fit vertically in the visible area
of the list control (list or report view) or the total number of items
in the list control (icon or small icon view).
"""
def GetEditControl(self):
"""
GetEditControl() -> TextCtrl
Returns the edit control being currently used to edit a label.
"""
def GetImageList(self, which):
"""
GetImageList(which) -> ImageList
Returns the specified image list.
"""
def GetItem(self, itemIdx, col=0):
"""
GetItem(itemIdx, col=0) -> ListItem
Gets information about the item. See SetItem() for more information.
"""
def GetItemBackgroundColour(self, item):
"""
GetItemBackgroundColour(item) -> Colour
Returns the colour for this item.
"""
def GetItemCount(self):
"""
GetItemCount() -> int
Returns the number of items in the list control.
"""
def GetItemData(self, item):
"""
GetItemData(item) -> UIntPtr
Gets the application-defined data associated with this item.
"""
def GetItemFont(self, item):
"""
GetItemFont(item) -> Font
Returns the item's font.
"""
def GetItemPosition(self, item):
"""
GetItemPosition(item) -> Point
Returns the position of the item, in icon or small icon view.
"""
def GetItemRect(self, item, code=LIST_RECT_BOUNDS):
"""
GetItemRect(item, code=LIST_RECT_BOUNDS) -> Rect
Returns the rectangle representing the item's size and position, in
physical coordinates.
code is one of wx.LIST_RECT_BOUNDS, wx.LIST_RECT_ICON,
wx.LIST_RECT_LABEL.
"""
def GetItemSpacing(self):
"""
GetItemSpacing() -> Size
Retrieves the spacing between icons in pixels: horizontal spacing is
returned as x component of the wxSize object and the vertical spacing
as its y component.
"""
def GetItemState(self, item, stateMask):
"""
GetItemState(item, stateMask) -> int
Gets the item state.
"""
def GetItemText(self, item, col=0):
"""
GetItemText(item, col=0) -> String
Gets the item text for this item.
"""
def GetItemTextColour(self, item):
"""
GetItemTextColour(item) -> Colour
Returns the colour for this item.
"""
def GetNextItem(self, item, geometry=LIST_NEXT_ALL, state=LIST_STATE_DONTCARE):
"""
GetNextItem(item, geometry=LIST_NEXT_ALL, state=LIST_STATE_DONTCARE) -> long
Searches for an item with the given geometry or state, starting from
item but excluding the item itself.
"""
def GetSelectedItemCount(self):
"""
GetSelectedItemCount() -> int
Returns the number of selected items in the list control.
"""
def GetSubItemRect(self, item, subItem, rect, code=LIST_RECT_BOUNDS):
"""
GetSubItemRect(item, subItem, rect, code=LIST_RECT_BOUNDS) -> bool
Returns the rectangle representing the size and position, in physical
coordinates, of the given subitem, i.e.
"""
def GetTextColour(self):
"""
GetTextColour() -> Colour
Gets the text colour of the list control.
"""
def GetTopItem(self):
"""
GetTopItem() -> long
Gets the index of the topmost visible item when in list or report
view.
"""
def GetViewRect(self):
"""
GetViewRect() -> Rect
Returns the rectangle taken by all items in the control.
"""
def SetAlternateRowColour(self, colour):
"""
SetAlternateRowColour(colour)
Set the alternative row background colour to a specific colour.
"""
def HitTest(self, point):
"""
HitTest(point) -> (long, flags)
Determines which item (if any) is at the specified point, giving
details in flags.
"""
def InReportView(self):
"""
InReportView() -> bool
Returns true if the control is currently using wxLC_REPORT style.
"""
def InsertColumn(self, *args, **kw):
"""
InsertColumn(col, info) -> long
InsertColumn(col, heading, format=LIST_FORMAT_LEFT, width=LIST_AUTOSIZE) -> long
For report view mode (only), inserts a column.
"""
def InsertItem(self, *args, **kw):
"""
InsertItem(info) -> long
InsertItem(index, label) -> long
InsertItem(index, imageIndex) -> long
InsertItem(index, label, imageIndex) -> long
Inserts an item, returning the index of the new item if successful, -1
otherwise.
"""
def IsVirtual(self):
"""
IsVirtual() -> bool
Returns true if the control is currently in virtual report view.
"""
def RefreshItem(self, item):
"""
RefreshItem(item)
Redraws the given item.
"""
def RefreshItems(self, itemFrom, itemTo):
"""
RefreshItems(itemFrom, itemTo)
Redraws the items between itemFrom and itemTo.
"""
def ScrollList(self, dx, dy):
"""
ScrollList(dx, dy) -> bool
Scrolls the list control.
"""
def SetBackgroundColour(self, col):
"""
SetBackgroundColour(col) -> bool
Sets the background colour.
"""
def SetColumn(self, col, item):
"""
SetColumn(col, item) -> bool
Sets information about this column.
"""
def SetColumnWidth(self, col, width):
"""
SetColumnWidth(col, width) -> bool
Sets the column width.
"""
def SetColumnsOrder(self, orders):
"""
SetColumnsOrder(orders) -> bool
Changes the order in which the columns are shown.
"""
def SetImageList(self, imageList, which):
"""
SetImageList(imageList, which)
Sets the image list associated with the control.
"""
def SetItem(self, *args, **kw):
"""
SetItem(info) -> bool
SetItem(index, column, label, imageId=-1) -> long
Sets the data of an item.
"""
def SetItemBackgroundColour(self, item, col):
"""
SetItemBackgroundColour(item, col)
Sets the background colour for this item.
"""
def SetItemColumnImage(self, item, column, image):
"""
SetItemColumnImage(item, column, image) -> bool
Sets the image associated with the item.
"""
def SetItemCount(self, count):
"""
SetItemCount(count)
This method can only be used with virtual list controls.
"""
def SetItemData(self, item, data):
"""
SetItemData(item, data) -> bool
Associates application-defined data with this item.
"""
def SetItemFont(self, item, font):
"""
SetItemFont(item, font)
Sets the item's font.
"""
def SetItemImage(self, item, image, selImage=-1):
"""
SetItemImage(item, image, selImage=-1) -> bool
Sets the unselected and selected images associated with the item.
"""
def SetItemPosition(self, item, pos):
"""
SetItemPosition(item, pos) -> bool
Sets the position of the item, in icon or small icon view.
"""
def SetItemPtrData(self, item, data):
"""
SetItemPtrData(item, data) -> bool
Associates application-defined data with this item.
"""
def SetItemState(self, item, state, stateMask):
"""
SetItemState(item, state, stateMask) -> bool
Sets the item state.
"""
def SetItemText(self, item, text):
"""
SetItemText(item, text)
Sets the item text for this item.
"""
def SetItemTextColour(self, item, col):
"""
SetItemTextColour(item, col)
Sets the colour for this item.
"""
def SetSingleStyle(self, style, add=True):
"""
SetSingleStyle(style, add=True)
Adds or removes a single window style.
"""
def SetTextColour(self, col):
"""
SetTextColour(col)
Sets the text colour of the list control.
"""
def SetWindowStyleFlag(self, style):
"""
SetWindowStyleFlag(style)
Sets the whole window style, deleting all items.
"""
def SortItems(self, fnSortCallBack):
"""
SortItems(fnSortCallBack) -> bool
Call this function to sort the items in the list control.
"""
def HitTestSubItem(self, point):
"""
HitTestSubItemHitTestSubItem(point) -> (item, flags, subitem)
Determines which item (if any) is at the specified point, giving
details in flags.
"""
FindItemData = wx.deprecated(FindItem, "Use FindItem instead.")
FindItemAtPos = wx.deprecated(FindItem, "Use FindItem instead.")
InsertStringItem = wx.deprecated(InsertItem, "Use InsertItem instead.")
InsertImageItem = wx.deprecated(InsertItem, "Use InsertItem instead.")
InsertImageStringItem = wx.deprecated(InsertItem, "Use InsertItem instead.")
SetStringItem = wx.deprecated(SetItem, "Use SetItem instead.")
def HasColumnOrderSupport(self):
"""
HasColumnOrderSupport() -> bool
"""
def Select(self, idx, on=1):
"""
Selects/deselects an item.
"""
def Focus(self, idx):
"""
Focus and show the given item.
"""
def GetFocusedItem(self):
"""
Gets the currently focused item or -1 if none is focused.
"""
def GetFirstSelected(self, *args):
"""
Returns the first selected item, or -1 when none is selected.
"""
def GetNextSelected(self, item):
"""
Returns subsequent selected items, or -1 when no more are selected.
"""
def IsSelected(self, idx):
"""
Returns ``True`` if the item is selected.
"""
def SetColumnImage(self, col, image):
"""
"""
def ClearColumnImage(self, col):
"""
"""
def Append(self, entry):
"""
Append an item to the list control. The `entry` parameter should be a
sequence with an item for each column
"""
def GetMainWindow(self):
"""
GetMainWindow() -> Window
"""
Column = property(None, None)
ColumnCount = property(None, None)
ColumnsOrder = property(None, None)
CountPerPage = property(None, None)
EditControl = property(None, None)
FocusedItem = property(None, None)
Item = property(None, None)
ItemCount = property(None, None)
ItemPosition = property(None, None)
ItemRect = property(None, None)
ItemSpacing = property(None, None)
MainWindow = property(None, None)
SelectedItemCount = property(None, None)
TextColour = property(None, None)
TopItem = property(None, None)
ViewRect = property(None, None)
def OnGetItemAttr(self, item):
"""
OnGetItemAttr(item) -> ListItemAttr
This function may be overridden in the derived class for a control
with wxLC_VIRTUAL style.
"""
def OnGetItemColumnImage(self, item, column):
"""
OnGetItemColumnImage(item, column) -> int
Override this function in the derived class for a control with
wxLC_VIRTUAL and wxLC_REPORT styles in order to specify the image
index for the given line and column.
"""
def OnGetItemImage(self, item):
"""
OnGetItemImage(item) -> int
This function must be overridden in the derived class for a control
with wxLC_VIRTUAL style having an "image list" (see SetImageList(); if
the control doesn't have an image list, it is not necessary to
override it).
"""
def OnGetItemText(self, item, column):
"""
OnGetItemText(item, column) -> String
This function must be overridden in the derived class for a control
with wxLC_VIRTUAL style.
"""
# end of class ListCtrl
class ListView(ListCtrl):
"""
ListView()
ListView(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_ICON, validator=DefaultValidator, name=ListCtrlNameStr)
This class currently simply presents a simpler to use interface for
the wxListCtrl it can be thought of as a façade for that complicated
class.
"""
def __init__(self, *args, **kw):
"""
ListView()
ListView(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_ICON, validator=DefaultValidator, name=ListCtrlNameStr)
This class currently simply presents a simpler to use interface for
the wxListCtrl it can be thought of as a façade for that complicated
class.
"""
def ClearColumnImage(self, col):
"""
ClearColumnImage(col)
Resets the column image after calling this function, no image will be
shown.
"""
def Focus(self, index):
"""
Focus(index)
Sets focus to the item with the given index.
"""
def GetFirstSelected(self):
"""
GetFirstSelected() -> long
Returns the first selected item in a (presumably) multiple selection
control.
"""
def GetFocusedItem(self):
"""
GetFocusedItem() -> long
Returns the currently focused item or -1 if none.
"""
def GetNextSelected(self, item):
"""
GetNextSelected(item) -> long
Used together with GetFirstSelected() to iterate over all selected
items in the control.
"""
def IsSelected(self, index):
"""
IsSelected(index) -> bool
Returns true if the item with the given index is selected, false
otherwise.
"""
def Select(self, n, on=True):
"""
Select(n, on=True)
Selects or unselects the given item.
"""
def SetColumnImage(self, col, image):
"""
SetColumnImage(col, image)
Sets the column image for the specified column.
"""
FirstSelected = property(None, None)
FocusedItem = property(None, None)
# end of class ListView
class ListEvent(NotifyEvent):
"""
ListEvent(commandType=wxEVT_NULL, id=0)
A list event holds information about events associated with wxListCtrl
objects.
"""
def __init__(self, commandType=wxEVT_NULL, id=0):
"""
ListEvent(commandType=wxEVT_NULL, id=0)
A list event holds information about events associated with wxListCtrl
objects.
"""
def GetCacheFrom(self):
"""
GetCacheFrom() -> long
For EVT_LIST_CACHE_HINT event only: return the first item which the
list control advises us to cache.
"""
def GetCacheTo(self):
"""
GetCacheTo() -> long
For EVT_LIST_CACHE_HINT event only: return the last item (inclusive)
which the list control advises us to cache.
"""
def GetColumn(self):
"""
GetColumn() -> int
The column position: it is only used with COL events.
"""
def GetData(self):
"""
GetData() -> UIntPtr
The data.
"""
def GetImage(self):
"""
GetImage() -> int
The image.
"""
def GetIndex(self):
"""
GetIndex() -> long
The item index.
"""
def GetItem(self):
"""
GetItem() -> ListItem
An item object, used by some events.
"""
def GetKeyCode(self):
"""
GetKeyCode() -> int
Key code if the event is a keypress event.
"""
def GetLabel(self):
"""
GetLabel() -> String
The (new) item label for EVT_LIST_END_LABEL_EDIT event.
"""
def GetMask(self):
"""
GetMask() -> long
The mask.
"""
def GetPoint(self):
"""
GetPoint() -> Point
The position of the mouse pointer if the event is a drag event.
"""
def GetText(self):
"""
GetText() -> String
The text.
"""
def IsEditCancelled(self):
"""
IsEditCancelled() -> bool
This method only makes sense for EVT_LIST_END_LABEL_EDIT message and
returns true if it the label editing has been cancelled by the user
(GetLabel() returns an empty string in this case but it doesn't allow
the application to distinguish between really cancelling the edit and
the admittedly rare case when the user wants to rename it to an empty
string).
"""
EVT_LIST_BEGIN_DRAG = PyEventBinder(wxEVT_LIST_BEGIN_DRAG , 1)
EVT_LIST_BEGIN_RDRAG = PyEventBinder(wxEVT_LIST_BEGIN_RDRAG , 1)
EVT_LIST_BEGIN_LABEL_EDIT = PyEventBinder(wxEVT_LIST_BEGIN_LABEL_EDIT , 1)
EVT_LIST_END_LABEL_EDIT = PyEventBinder(wxEVT_LIST_END_LABEL_EDIT , 1)
EVT_LIST_DELETE_ITEM = PyEventBinder(wxEVT_LIST_DELETE_ITEM , 1)
EVT_LIST_DELETE_ALL_ITEMS = PyEventBinder(wxEVT_LIST_DELETE_ALL_ITEMS , 1)
EVT_LIST_ITEM_SELECTED = PyEventBinder(wxEVT_LIST_ITEM_SELECTED , 1)
EVT_LIST_ITEM_DESELECTED = PyEventBinder(wxEVT_LIST_ITEM_DESELECTED , 1)
EVT_LIST_KEY_DOWN = PyEventBinder(wxEVT_LIST_KEY_DOWN , 1)
EVT_LIST_INSERT_ITEM = PyEventBinder(wxEVT_LIST_INSERT_ITEM , 1)
EVT_LIST_COL_CLICK = PyEventBinder(wxEVT_LIST_COL_CLICK , 1)
EVT_LIST_ITEM_RIGHT_CLICK = PyEventBinder(wxEVT_LIST_ITEM_RIGHT_CLICK , 1)
EVT_LIST_ITEM_MIDDLE_CLICK = PyEventBinder(wxEVT_LIST_ITEM_MIDDLE_CLICK, 1)
EVT_LIST_ITEM_ACTIVATED = PyEventBinder(wxEVT_LIST_ITEM_ACTIVATED , 1)
EVT_LIST_CACHE_HINT = PyEventBinder(wxEVT_LIST_CACHE_HINT , 1)
EVT_LIST_COL_RIGHT_CLICK = PyEventBinder(wxEVT_LIST_COL_RIGHT_CLICK , 1)
EVT_LIST_COL_BEGIN_DRAG = PyEventBinder(wxEVT_LIST_COL_BEGIN_DRAG , 1)
EVT_LIST_COL_DRAGGING = PyEventBinder(wxEVT_LIST_COL_DRAGGING , 1)
EVT_LIST_COL_END_DRAG = PyEventBinder(wxEVT_LIST_COL_END_DRAG , 1)
EVT_LIST_ITEM_FOCUSED = PyEventBinder(wxEVT_LIST_ITEM_FOCUSED , 1)
# deprecated wxEVT aliases
wxEVT_COMMAND_LIST_BEGIN_DRAG = wxEVT_LIST_BEGIN_DRAG
wxEVT_COMMAND_LIST_BEGIN_RDRAG = wxEVT_LIST_BEGIN_RDRAG
wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT = wxEVT_LIST_BEGIN_LABEL_EDIT
wxEVT_COMMAND_LIST_END_LABEL_EDIT = wxEVT_LIST_END_LABEL_EDIT
wxEVT_COMMAND_LIST_DELETE_ITEM = wxEVT_LIST_DELETE_ITEM
wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS = wxEVT_LIST_DELETE_ALL_ITEMS
wxEVT_COMMAND_LIST_ITEM_SELECTED = wxEVT_LIST_ITEM_SELECTED
wxEVT_COMMAND_LIST_ITEM_DESELECTED = wxEVT_LIST_ITEM_DESELECTED
wxEVT_COMMAND_LIST_KEY_DOWN = wxEVT_LIST_KEY_DOWN
wxEVT_COMMAND_LIST_INSERT_ITEM = wxEVT_LIST_INSERT_ITEM
wxEVT_COMMAND_LIST_COL_CLICK = wxEVT_LIST_COL_CLICK
wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK = wxEVT_LIST_ITEM_RIGHT_CLICK
wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK = wxEVT_LIST_ITEM_MIDDLE_CLICK
wxEVT_COMMAND_LIST_ITEM_ACTIVATED = wxEVT_LIST_ITEM_ACTIVATED
wxEVT_COMMAND_LIST_CACHE_HINT = wxEVT_LIST_CACHE_HINT
wxEVT_COMMAND_LIST_COL_RIGHT_CLICK = wxEVT_LIST_COL_RIGHT_CLICK
wxEVT_COMMAND_LIST_COL_BEGIN_DRAG = wxEVT_LIST_COL_BEGIN_DRAG
wxEVT_COMMAND_LIST_COL_DRAGGING = wxEVT_LIST_COL_DRAGGING
wxEVT_COMMAND_LIST_COL_END_DRAG = wxEVT_LIST_COL_END_DRAG
wxEVT_COMMAND_LIST_ITEM_FOCUSED = wxEVT_LIST_ITEM_FOCUSED
CacheFrom = property(None, None)
CacheTo = property(None, None)
Column = property(None, None)
Data = property(None, None)
Image = property(None, None)
Index = property(None, None)
Item = property(None, None)
KeyCode = property(None, None)
Label = property(None, None)
Mask = property(None, None)
Point = property(None, None)
Text = property(None, None)
# end of class ListEvent
#-- end-listctrl --#
#-- begin-treectrl --#
TR_NO_BUTTONS = 0
TR_HAS_BUTTONS = 0
TR_NO_LINES = 0
TR_LINES_AT_ROOT = 0
TR_TWIST_BUTTONS = 0
TR_SINGLE = 0
TR_MULTIPLE = 0
TR_HAS_VARIABLE_ROW_HEIGHT = 0
TR_EDIT_LABELS = 0
TR_ROW_LINES = 0
TR_HIDE_ROOT = 0
TR_FULL_ROW_HIGHLIGHT = 0
TR_DEFAULT_STYLE = 0
TreeItemIcon_Normal = 0
TreeItemIcon_Selected = 0
TreeItemIcon_Expanded = 0
TreeItemIcon_SelectedExpanded = 0
TreeItemIcon_Max = 0
TREE_ITEMSTATE_NONE = 0
TREE_ITEMSTATE_NEXT = 0
TREE_ITEMSTATE_PREV = 0
TREE_HITTEST_ABOVE = 0
TREE_HITTEST_BELOW = 0
TREE_HITTEST_NOWHERE = 0
TREE_HITTEST_ONITEMBUTTON = 0
TREE_HITTEST_ONITEMICON = 0
TREE_HITTEST_ONITEMINDENT = 0
TREE_HITTEST_ONITEMLABEL = 0
TREE_HITTEST_ONITEMRIGHT = 0
TREE_HITTEST_ONITEMSTATEICON = 0
TREE_HITTEST_TOLEFT = 0
TREE_HITTEST_TORIGHT = 0
TREE_HITTEST_ONITEMUPPERPART = 0
TREE_HITTEST_ONITEMLOWERPART = 0
TREE_HITTEST_ONITEM = 0
wxEVT_TREE_BEGIN_DRAG = 0
wxEVT_TREE_BEGIN_RDRAG = 0
wxEVT_TREE_BEGIN_LABEL_EDIT = 0
wxEVT_TREE_END_LABEL_EDIT = 0
wxEVT_TREE_DELETE_ITEM = 0
wxEVT_TREE_GET_INFO = 0
wxEVT_TREE_SET_INFO = 0
wxEVT_TREE_ITEM_EXPANDED = 0
wxEVT_TREE_ITEM_EXPANDING = 0
wxEVT_TREE_ITEM_COLLAPSED = 0
wxEVT_TREE_ITEM_COLLAPSING = 0
wxEVT_TREE_SEL_CHANGED = 0
wxEVT_TREE_SEL_CHANGING = 0
wxEVT_TREE_KEY_DOWN = 0
wxEVT_TREE_ITEM_ACTIVATED = 0
wxEVT_TREE_ITEM_RIGHT_CLICK = 0
wxEVT_TREE_ITEM_MIDDLE_CLICK = 0
wxEVT_TREE_END_DRAG = 0
wxEVT_TREE_STATE_IMAGE_CLICK = 0
wxEVT_TREE_ITEM_GETTOOLTIP = 0
wxEVT_TREE_ITEM_MENU = 0
class TreeItemId(object):
"""
TreeItemId()
An opaque reference to a tree item.
"""
def __init__(self):
"""
TreeItemId()
An opaque reference to a tree item.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if this instance is referencing a valid tree item.
"""
def GetID(self):
"""
GetID() -> void
"""
def Unset(self):
"""
Unset()
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
ID = property(None, None)
# end of class TreeItemId
TreeCtrlNameStr = ""
class TreeCtrl(Control):
"""
TreeCtrl()
TreeCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TR_DEFAULT_STYLE, validator=DefaultValidator, name=TreeCtrlNameStr)
A tree control presents information as a hierarchy, with items that
may be expanded to show further items.
"""
def __init__(self, *args, **kw):
"""
TreeCtrl()
TreeCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TR_DEFAULT_STYLE, validator=DefaultValidator, name=TreeCtrlNameStr)
A tree control presents information as a hierarchy, with items that
may be expanded to show further items.
"""
def AddRoot(self, text, image=-1, selImage=-1, data=None):
"""
AddRoot(text, image=-1, selImage=-1, data=None) -> TreeItemId
Adds the root node to the tree, returning the new item.
"""
def AppendItem(self, parent, text, image=-1, selImage=-1, data=None):
"""
AppendItem(parent, text, image=-1, selImage=-1, data=None) -> TreeItemId
Appends an item to the end of the branch identified by parent, return
a new item id.
"""
def AssignImageList(self, imageList):
"""
AssignImageList(imageList)
Sets the normal image list.
"""
def AssignStateImageList(self, imageList):
"""
AssignStateImageList(imageList)
Sets the state image list.
"""
def Collapse(self, item):
"""
Collapse(item)
Collapses the given item.
"""
def CollapseAll(self):
"""
CollapseAll()
Collapses the root item.
"""
def CollapseAllChildren(self, item):
"""
CollapseAllChildren(item)
Collapses this item and all of its children, recursively.
"""
def CollapseAndReset(self, item):
"""
CollapseAndReset(item)
Collapses the given item and removes all children.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TR_DEFAULT_STYLE, validator=DefaultValidator, name=TreeCtrlNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=TR_DEFAULT_STYLE, validator=DefaultValidator, name=TreeCtrlNameStr) -> bool
Creates the tree control.
"""
def Delete(self, item):
"""
Delete(item)
Deletes the specified item.
"""
def DeleteAllItems(self):
"""
DeleteAllItems()
Deletes all items in the control.
"""
def DeleteChildren(self, item):
"""
DeleteChildren(item)
Deletes all children of the given item (but not the item itself).
"""
def EditLabel(self, item):
"""
EditLabel(item) -> TextCtrl
Starts editing the label of the given item.
"""
def EnableBellOnNoMatch(self, on=True):
"""
EnableBellOnNoMatch(on=True)
Enable or disable a beep if there is no match for the currently
entered text when searching for the item from keyboard.
"""
def EndEditLabel(self, item, discardChanges=False):
"""
EndEditLabel(item, discardChanges=False)
Ends label editing.
"""
def EnsureVisible(self, item):
"""
EnsureVisible(item)
Scrolls and/or expands items to ensure that the given item is visible.
"""
def Expand(self, item):
"""
Expand(item)
Expands the given item.
"""
def ExpandAll(self):
"""
ExpandAll()
Expands all items in the tree.
"""
def ExpandAllChildren(self, item):
"""
ExpandAllChildren(item)
Expands the given item and all its children recursively.
"""
def GetBoundingRect(self, item, textOnly=False):
"""
GetBoundingRect(item, textOnly=False) -> PyObject
Returns the rectangle bounding the item. If textOnly is true,
only the rectangle around the item's label will be returned, otherwise
the item's image is also taken into account. The return value may be
None
if the rectangle was not successfully retrieved, such as if the item
is
currently not visible.
"""
def GetChildrenCount(self, item, recursively=True):
"""
GetChildrenCount(item, recursively=True) -> size_t
Returns the number of items in the branch.
"""
def GetCount(self):
"""
GetCount() -> unsignedint
Returns the number of items in the control.
"""
def GetEditControl(self):
"""
GetEditControl() -> TextCtrl
Returns the edit control being currently used to edit a label.
"""
def GetFirstChild(self, item):
"""
GetFirstChild(item) -> (TreeItemId, cookie)
Returns the first child; call GetNextChild() for the next child.
"""
def GetFirstVisibleItem(self):
"""
GetFirstVisibleItem() -> TreeItemId
Returns the first visible item.
"""
def GetFocusedItem(self):
"""
GetFocusedItem() -> TreeItemId
Returns the item last clicked or otherwise selected.
"""
def ClearFocusedItem(self):
"""
ClearFocusedItem()
Clears the currently focused item.
"""
def SetFocusedItem(self, item):
"""
SetFocusedItem(item)
Sets the currently focused item.
"""
def GetImageList(self):
"""
GetImageList() -> ImageList
Returns the normal image list.
"""
def GetIndent(self):
"""
GetIndent() -> unsignedint
Returns the current tree control indentation.
"""
def GetItemBackgroundColour(self, item):
"""
GetItemBackgroundColour(item) -> Colour
Returns the background colour of the item.
"""
def GetItemData(self, item):
"""
GetItemData(item) -> TreeItemData
Returns the tree item data associated with the item.
"""
def GetItemFont(self, item):
"""
GetItemFont(item) -> Font
Returns the font of the item label.
"""
def GetItemImage(self, item, which=TreeItemIcon_Normal):
"""
GetItemImage(item, which=TreeItemIcon_Normal) -> int
Gets the specified item image.
"""
def GetItemParent(self, item):
"""
GetItemParent(item) -> TreeItemId
Returns the item's parent.
"""
def GetItemState(self, item):
"""
GetItemState(item) -> int
Gets the specified item state.
"""
def GetItemText(self, item):
"""
GetItemText(item) -> String
Returns the item label.
"""
def GetItemTextColour(self, item):
"""
GetItemTextColour(item) -> Colour
Returns the colour of the item label.
"""
def GetLastChild(self, item):
"""
GetLastChild(item) -> TreeItemId
Returns the last child of the item (or an invalid tree item if this
item has no children).
"""
def GetNextChild(self, item, cookie):
"""
GetNextChild(item, cookie) -> (TreeItemId, cookie)
Returns the next child; call GetFirstChild() for the first child.
"""
def GetNextSibling(self, item):
"""
GetNextSibling(item) -> TreeItemId
Returns the next sibling of the specified item; call GetPrevSibling()
for the previous sibling.
"""
def GetNextVisible(self, item):
"""
GetNextVisible(item) -> TreeItemId
Returns the next visible item or an invalid item if this item is the
last visible one.
"""
def GetPrevSibling(self, item):
"""
GetPrevSibling(item) -> TreeItemId
Returns the previous sibling of the specified item; call
GetNextSibling() for the next sibling.
"""
def GetPrevVisible(self, item):
"""
GetPrevVisible(item) -> TreeItemId
Returns the previous visible item or an invalid item if this item is
the first visible one.
"""
def GetQuickBestSize(self):
"""
GetQuickBestSize() -> bool
Returns true if the control will use a quick calculation for the best
size, looking only at the first and last items.
"""
def GetRootItem(self):
"""
GetRootItem() -> TreeItemId
Returns the root item for the tree control.
"""
def GetSelection(self):
"""
GetSelection() -> TreeItemId
Returns the selection, or an invalid item if there is no selection.
"""
def GetSelections(self):
"""
GetSelections() -> PyObject
Returns a list of currently selected items in the tree. This function
can be called only if the control has the wx.TR_MULTIPLE style.
"""
def GetStateImageList(self):
"""
GetStateImageList() -> ImageList
Returns the state image list (from which application-defined state
images are taken).
"""
def HitTest(self, point, flags):
"""
HitTest(point, flags) -> TreeItemId
Calculates which (if any) item is under the given point, returning the
tree item id at this point plus extra information flags.
"""
def InsertItem(self, *args, **kw):
"""
InsertItem(parent, previous, text, image=-1, selImage=-1, data=None) -> TreeItemId
InsertItem(parent, pos, text, image=-1, selImage=-1, data=None) -> TreeItemId
Inserts an item after a given one (previous).
"""
def IsBold(self, item):
"""
IsBold(item) -> bool
Returns true if the given item is in bold state.
"""
def IsEmpty(self):
"""
IsEmpty() -> bool
Returns true if the control is empty (i.e. has no items, even no root
one).
"""
def IsExpanded(self, item):
"""
IsExpanded(item) -> bool
Returns true if the item is expanded (only makes sense if it has
children).
"""
def IsSelected(self, item):
"""
IsSelected(item) -> bool
Returns true if the item is selected.
"""
def IsVisible(self, item):
"""
IsVisible(item) -> bool
Returns true if the item is visible on the screen.
"""
def ItemHasChildren(self, item):
"""
ItemHasChildren(item) -> bool
Returns true if the item has children.
"""
def OnCompareItems(self, item1, item2):
"""
OnCompareItems(item1, item2) -> int
Override this function in the derived class to change the sort order
of the items in the tree control.
"""
def PrependItem(self, parent, text, image=-1, selImage=-1, data=None):
"""
PrependItem(parent, text, image=-1, selImage=-1, data=None) -> TreeItemId
Appends an item as the first child of parent, return a new item id.
"""
def ScrollTo(self, item):
"""
ScrollTo(item)
Scrolls the specified item into view.
"""
def SelectItem(self, item, select=True):
"""
SelectItem(item, select=True)
Selects the given item.
"""
def SetImageList(self, imageList):
"""
SetImageList(imageList)
Sets the normal image list.
"""
def SetIndent(self, indent):
"""
SetIndent(indent)
Sets the indentation for the tree control.
"""
def SetItemBackgroundColour(self, item, col):
"""
SetItemBackgroundColour(item, col)
Sets the colour of the item's background.
"""
def SetItemBold(self, item, bold=True):
"""
SetItemBold(item, bold=True)
Makes item appear in bold font if bold parameter is true or resets it
to the normal state.
"""
def SetItemData(self, item, data):
"""
SetItemData(item, data)
Sets the item client data.
"""
def SetItemDropHighlight(self, item, highlight=True):
"""
SetItemDropHighlight(item, highlight=True)
Gives the item the visual feedback for Drag'n'Drop actions, which is
useful if something is dragged from the outside onto the tree control
(as opposed to a DnD operation within the tree control, which already
is implemented internally).
"""
def SetItemFont(self, item, font):
"""
SetItemFont(item, font)
Sets the item's font.
"""
def SetItemHasChildren(self, item, hasChildren=True):
"""
SetItemHasChildren(item, hasChildren=True)
Force appearance of the button next to the item.
"""
def SetItemImage(self, item, image, which=TreeItemIcon_Normal):
"""
SetItemImage(item, image, which=TreeItemIcon_Normal)
Sets the specified item's image.
"""
def SetItemState(self, item, state):
"""
SetItemState(item, state)
Sets the specified item state.
"""
def SetItemText(self, item, text):
"""
SetItemText(item, text)
Sets the item label.
"""
def SetItemTextColour(self, item, col):
"""
SetItemTextColour(item, col)
Sets the colour of the item's text.
"""
def SetQuickBestSize(self, quickBestSize):
"""
SetQuickBestSize(quickBestSize)
If true is passed, specifies that the control will use a quick
calculation for the best size, looking only at the first and last
items.
"""
def SetStateImageList(self, imageList):
"""
SetStateImageList(imageList)
Sets the state image list (from which application-defined state images
are taken).
"""
def SetWindowStyle(self, styles):
"""
SetWindowStyle(styles)
Sets the mode flags associated with the display of the tree control.
"""
def SortChildren(self, item):
"""
SortChildren(item)
Sorts the children of the given item using OnCompareItems().
"""
def Toggle(self, item):
"""
Toggle(item)
Toggles the given item between collapsed and expanded states.
"""
def ToggleItemSelection(self, item):
"""
ToggleItemSelection(item)
Toggles the given item between selected and unselected states.
"""
def Unselect(self):
"""
Unselect()
Removes the selection from the currently selected item (if any).
"""
def UnselectAll(self):
"""
UnselectAll()
This function either behaves the same as Unselect() if the control
doesn't have wxTR_MULTIPLE style, or removes the selection from all
items if it does have this style.
"""
def UnselectItem(self, item):
"""
UnselectItem(item)
Unselects the given item.
"""
def SelectChildren(self, parent):
"""
SelectChildren(parent)
Select all the immediate children of the given parent.
"""
GetItemPyData = wx.deprecated(GetItemData, 'Use GetItemData instead.')
SetItemPyData = wx.deprecated(SetItemData, 'Use SetItemData instead.')
GetPyData = wx.deprecated(GetItemData, 'Use GetItemData instead.')
SetPyData = wx.deprecated(SetItemData, 'Use SetItemData instead.')
BoundingRect = property(None, None)
Count = property(None, None)
EditControl = property(None, None)
FirstVisibleItem = property(None, None)
FocusedItem = property(None, None)
ImageList = property(None, None)
Indent = property(None, None)
QuickBestSize = property(None, None)
RootItem = property(None, None)
Selection = property(None, None)
Selections = property(None, None)
StateImageList = property(None, None)
# end of class TreeCtrl
class TreeEvent(NotifyEvent):
"""
TreeEvent(commandType, tree, item=TreeItemId())
A tree event holds information about events associated with wxTreeCtrl
objects.
"""
def __init__(self, commandType, tree, item=TreeItemId()):
"""
TreeEvent(commandType, tree, item=TreeItemId())
A tree event holds information about events associated with wxTreeCtrl
objects.
"""
def GetItem(self):
"""
GetItem() -> TreeItemId
Returns the item (valid for all events).
"""
def GetKeyCode(self):
"""
GetKeyCode() -> int
Returns the key code if the event is a key event.
"""
def GetKeyEvent(self):
"""
GetKeyEvent() -> KeyEvent
Returns the key event for EVT_TREE_KEY_DOWN events.
"""
def GetLabel(self):
"""
GetLabel() -> String
Returns the label if the event is a begin or end edit label event.
"""
def GetOldItem(self):
"""
GetOldItem() -> TreeItemId
Returns the old item index (valid for EVT_TREE_ITEM_CHANGING and
EVT_TREE_ITEM_CHANGED events).
"""
def GetPoint(self):
"""
GetPoint() -> Point
Returns the position of the mouse pointer if the event is a drag or
menu-context event.
"""
def IsEditCancelled(self):
"""
IsEditCancelled() -> bool
Returns true if the label edit was cancelled.
"""
def SetToolTip(self, tooltip):
"""
SetToolTip(tooltip)
Set the tooltip for the item (valid for EVT_TREE_ITEM_GETTOOLTIP
events).
"""
EVT_TREE_BEGIN_DRAG = PyEventBinder(wxEVT_TREE_BEGIN_DRAG , 1)
EVT_TREE_BEGIN_RDRAG = PyEventBinder(wxEVT_TREE_BEGIN_RDRAG , 1)
EVT_TREE_BEGIN_LABEL_EDIT = PyEventBinder(wxEVT_TREE_BEGIN_LABEL_EDIT , 1)
EVT_TREE_END_LABEL_EDIT = PyEventBinder(wxEVT_TREE_END_LABEL_EDIT , 1)
EVT_TREE_DELETE_ITEM = PyEventBinder(wxEVT_TREE_DELETE_ITEM , 1)
EVT_TREE_GET_INFO = PyEventBinder(wxEVT_TREE_GET_INFO , 1)
EVT_TREE_SET_INFO = PyEventBinder(wxEVT_TREE_SET_INFO , 1)
EVT_TREE_ITEM_EXPANDED = PyEventBinder(wxEVT_TREE_ITEM_EXPANDED , 1)
EVT_TREE_ITEM_EXPANDING = PyEventBinder(wxEVT_TREE_ITEM_EXPANDING , 1)
EVT_TREE_ITEM_COLLAPSED = PyEventBinder(wxEVT_TREE_ITEM_COLLAPSED , 1)
EVT_TREE_ITEM_COLLAPSING = PyEventBinder(wxEVT_TREE_ITEM_COLLAPSING , 1)
EVT_TREE_SEL_CHANGED = PyEventBinder(wxEVT_TREE_SEL_CHANGED , 1)
EVT_TREE_SEL_CHANGING = PyEventBinder(wxEVT_TREE_SEL_CHANGING , 1)
EVT_TREE_KEY_DOWN = PyEventBinder(wxEVT_TREE_KEY_DOWN , 1)
EVT_TREE_ITEM_ACTIVATED = PyEventBinder(wxEVT_TREE_ITEM_ACTIVATED , 1)
EVT_TREE_ITEM_RIGHT_CLICK = PyEventBinder(wxEVT_TREE_ITEM_RIGHT_CLICK , 1)
EVT_TREE_ITEM_MIDDLE_CLICK = PyEventBinder(wxEVT_TREE_ITEM_MIDDLE_CLICK, 1)
EVT_TREE_END_DRAG = PyEventBinder(wxEVT_TREE_END_DRAG , 1)
EVT_TREE_STATE_IMAGE_CLICK = PyEventBinder(wxEVT_TREE_STATE_IMAGE_CLICK, 1)
EVT_TREE_ITEM_GETTOOLTIP = PyEventBinder(wxEVT_TREE_ITEM_GETTOOLTIP, 1)
EVT_TREE_ITEM_MENU = PyEventBinder(wxEVT_TREE_ITEM_MENU, 1)
# deprecated wxEVT aliases
wxEVT_COMMAND_TREE_BEGIN_DRAG = wxEVT_TREE_BEGIN_DRAG
wxEVT_COMMAND_TREE_BEGIN_RDRAG = wxEVT_TREE_BEGIN_RDRAG
wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT = wxEVT_TREE_BEGIN_LABEL_EDIT
wxEVT_COMMAND_TREE_END_LABEL_EDIT = wxEVT_TREE_END_LABEL_EDIT
wxEVT_COMMAND_TREE_DELETE_ITEM = wxEVT_TREE_DELETE_ITEM
wxEVT_COMMAND_TREE_GET_INFO = wxEVT_TREE_GET_INFO
wxEVT_COMMAND_TREE_SET_INFO = wxEVT_TREE_SET_INFO
wxEVT_COMMAND_TREE_ITEM_EXPANDED = wxEVT_TREE_ITEM_EXPANDED
wxEVT_COMMAND_TREE_ITEM_EXPANDING = wxEVT_TREE_ITEM_EXPANDING
wxEVT_COMMAND_TREE_ITEM_COLLAPSED = wxEVT_TREE_ITEM_COLLAPSED
wxEVT_COMMAND_TREE_ITEM_COLLAPSING = wxEVT_TREE_ITEM_COLLAPSING
wxEVT_COMMAND_TREE_SEL_CHANGED = wxEVT_TREE_SEL_CHANGED
wxEVT_COMMAND_TREE_SEL_CHANGING = wxEVT_TREE_SEL_CHANGING
wxEVT_COMMAND_TREE_KEY_DOWN = wxEVT_TREE_KEY_DOWN
wxEVT_COMMAND_TREE_ITEM_ACTIVATED = wxEVT_TREE_ITEM_ACTIVATED
wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK = wxEVT_TREE_ITEM_RIGHT_CLICK
wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK = wxEVT_TREE_ITEM_MIDDLE_CLICK
wxEVT_COMMAND_TREE_END_DRAG = wxEVT_TREE_END_DRAG
wxEVT_COMMAND_TREE_STATE_IMAGE_CLICK = wxEVT_TREE_STATE_IMAGE_CLICK
wxEVT_COMMAND_TREE_ITEM_GETTOOLTIP = wxEVT_TREE_ITEM_GETTOOLTIP
wxEVT_COMMAND_TREE_ITEM_MENU = wxEVT_TREE_ITEM_MENU
Item = property(None, None)
KeyCode = property(None, None)
KeyEvent = property(None, None)
Label = property(None, None)
OldItem = property(None, None)
Point = property(None, None)
# end of class TreeEvent
def TreeItemData(data):
return data
TreeItemData = deprecated(TreeItemData, "The TreeItemData class no longer exists, just pass your object directly to the tree instead.")
#-- end-treectrl --#
#-- begin-pickers --#
PB_USE_TEXTCTRL = 0
PB_SMALL = 0
CLRP_USE_TEXTCTRL = 0
CLRP_DEFAULT_STYLE = 0
CLRP_SHOW_LABEL = 0
wxEVT_COLOURPICKER_CHANGED = 0
FLP_OPEN = 0
FLP_SAVE = 0
FLP_OVERWRITE_PROMPT = 0
FLP_FILE_MUST_EXIST = 0
FLP_CHANGE_DIR = 0
FLP_SMALL = 0
FLP_USE_TEXTCTRL = 0
FLP_DEFAULT_STYLE = 0
DIRP_DIR_MUST_EXIST = 0
DIRP_CHANGE_DIR = 0
DIRP_SMALL = 0
DIRP_USE_TEXTCTRL = 0
DIRP_DEFAULT_STYLE = 0
wxEVT_FILEPICKER_CHANGED = 0
wxEVT_DIRPICKER_CHANGED = 0
FNTP_FONTDESC_AS_LABEL = 0
FNTP_USEFONT_FOR_LABEL = 0
FONTBTN_DEFAULT_STYLE = 0
FNTP_USE_TEXTCTRL = 0
FNTP_DEFAULT_STYLE = 0
wxEVT_FONTPICKER_CHANGED = 0
class PickerBase(Control):
"""
PickerBase()
Base abstract class for all pickers which support an auxiliary text
control.
"""
def __init__(self):
"""
PickerBase()
Base abstract class for all pickers which support an auxiliary text
control.
"""
def CreateBase(self, parent, id=ID_ANY, text=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ButtonNameStr):
"""
CreateBase(parent, id=ID_ANY, text=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ButtonNameStr) -> bool
"""
def GetInternalMargin(self):
"""
GetInternalMargin() -> int
Returns the margin (in pixel) between the picker and the text control.
"""
def GetPickerCtrlProportion(self):
"""
GetPickerCtrlProportion() -> int
Returns the proportion value of the picker.
"""
def GetTextCtrl(self):
"""
GetTextCtrl() -> TextCtrl
Returns a pointer to the text control handled by this window or NULL
if the wxPB_USE_TEXTCTRL style was not specified when this control was
created.
"""
def GetPickerCtrl(self):
"""
GetPickerCtrl() -> Control
Returns the native implementation of the real picker control.
"""
def GetTextCtrlProportion(self):
"""
GetTextCtrlProportion() -> int
Returns the proportion value of the text control.
"""
def HasTextCtrl(self):
"""
HasTextCtrl() -> bool
Returns true if this window has a valid text control (i.e. if the
wxPB_USE_TEXTCTRL style was given when creating this control).
"""
def IsPickerCtrlGrowable(self):
"""
IsPickerCtrlGrowable() -> bool
Returns true if the picker control is growable.
"""
def IsTextCtrlGrowable(self):
"""
IsTextCtrlGrowable() -> bool
Returns true if the text control is growable.
"""
def SetInternalMargin(self, margin):
"""
SetInternalMargin(margin)
Sets the margin (in pixel) between the picker and the text control.
"""
def SetPickerCtrlGrowable(self, grow=True):
"""
SetPickerCtrlGrowable(grow=True)
Sets the picker control as growable when grow is true.
"""
def SetPickerCtrlProportion(self, prop):
"""
SetPickerCtrlProportion(prop)
Sets the proportion value of the picker.
"""
def SetTextCtrlGrowable(self, grow=True):
"""
SetTextCtrlGrowable(grow=True)
Sets the text control as growable when grow is true.
"""
def SetTextCtrlProportion(self, prop):
"""
SetTextCtrlProportion(prop)
Sets the proportion value of the text control.
"""
def SetTextCtrl(self, text):
"""
SetTextCtrl(text)
"""
def SetPickerCtrl(self, picker):
"""
SetPickerCtrl(picker)
"""
def UpdatePickerFromTextCtrl(self):
"""
UpdatePickerFromTextCtrl()
"""
def UpdateTextCtrlFromPicker(self):
"""
UpdateTextCtrlFromPicker()
"""
InternalMargin = property(None, None)
PickerCtrl = property(None, None)
PickerCtrlProportion = property(None, None)
TextCtrl = property(None, None)
TextCtrlProportion = property(None, None)
def GetTextCtrlStyle(self, style):
"""
GetTextCtrlStyle(style) -> long
"""
def GetPickerStyle(self, style):
"""
GetPickerStyle(style) -> long
"""
def PostCreation(self):
"""
PostCreation()
"""
# end of class PickerBase
ColourPickerWidgetNameStr = ""
ColourPickerCtrlNameStr = ""
class ColourPickerCtrl(PickerBase):
"""
ColourPickerCtrl()
ColourPickerCtrl(parent, id=ID_ANY, colour=BLACK, pos=DefaultPosition, size=DefaultSize, style=CLRP_DEFAULT_STYLE, validator=DefaultValidator, name=ColourPickerCtrlNameStr)
This control allows the user to select a colour.
"""
def __init__(self, *args, **kw):
"""
ColourPickerCtrl()
ColourPickerCtrl(parent, id=ID_ANY, colour=BLACK, pos=DefaultPosition, size=DefaultSize, style=CLRP_DEFAULT_STYLE, validator=DefaultValidator, name=ColourPickerCtrlNameStr)
This control allows the user to select a colour.
"""
def SetColour(self, *args, **kw):
"""
SetColour(col)
SetColour(colname)
Sets the currently selected colour.
"""
def Create(self, parent, id=ID_ANY, colour=BLACK, pos=DefaultPosition, size=DefaultSize, style=CLRP_DEFAULT_STYLE, validator=DefaultValidator, name=ColourPickerCtrlNameStr):
"""
Create(parent, id=ID_ANY, colour=BLACK, pos=DefaultPosition, size=DefaultSize, style=CLRP_DEFAULT_STYLE, validator=DefaultValidator, name=ColourPickerCtrlNameStr) -> bool
Creates a colour picker with the given arguments.
"""
def GetColour(self):
"""
GetColour() -> Colour
Returns the currently selected colour.
"""
Colour = property(None, None)
# end of class ColourPickerCtrl
class ColourPickerEvent(CommandEvent):
"""
ColourPickerEvent()
ColourPickerEvent(generator, id, colour)
This event class is used for the events generated by
wxColourPickerCtrl.
"""
def __init__(self, *args, **kw):
"""
ColourPickerEvent()
ColourPickerEvent(generator, id, colour)
This event class is used for the events generated by
wxColourPickerCtrl.
"""
def GetColour(self):
"""
GetColour() -> Colour
Retrieve the colour the user has just selected.
"""
def SetColour(self, pos):
"""
SetColour(pos)
Set the colour associated with the event.
"""
EVT_COLOURPICKER_CHANGED = wx.PyEventBinder( wxEVT_COLOURPICKER_CHANGED, 1 )
# deprecated wxEVT alias
wxEVT_COMMAND_COLOURPICKER_CHANGED = wxEVT_COLOURPICKER_CHANGED
Colour = property(None, None)
# end of class ColourPickerEvent
FilePickerWidgetLabel = ""
FilePickerWidgetNameStr = ""
FilePickerCtrlNameStr = ""
FileSelectorPromptStr = ""
FileSelectorDefaultWildcardStr = ""
class FilePickerCtrl(PickerBase):
"""
FilePickerCtrl()
FilePickerCtrl(parent, id=ID_ANY, path=EmptyString, message=FileSelectorPromptStr, wildcard=FileSelectorDefaultWildcardStr, pos=DefaultPosition, size=DefaultSize, style=FLP_DEFAULT_STYLE, validator=DefaultValidator, name=FilePickerCtrlNameStr)
This control allows the user to select a file.
"""
def __init__(self, *args, **kw):
"""
FilePickerCtrl()
FilePickerCtrl(parent, id=ID_ANY, path=EmptyString, message=FileSelectorPromptStr, wildcard=FileSelectorDefaultWildcardStr, pos=DefaultPosition, size=DefaultSize, style=FLP_DEFAULT_STYLE, validator=DefaultValidator, name=FilePickerCtrlNameStr)
This control allows the user to select a file.
"""
def Create(self, parent, id=ID_ANY, path=EmptyString, message=FileSelectorPromptStr, wildcard=FileSelectorDefaultWildcardStr, pos=DefaultPosition, size=DefaultSize, style=FLP_DEFAULT_STYLE, validator=DefaultValidator, name=FilePickerCtrlNameStr):
"""
Create(parent, id=ID_ANY, path=EmptyString, message=FileSelectorPromptStr, wildcard=FileSelectorDefaultWildcardStr, pos=DefaultPosition, size=DefaultSize, style=FLP_DEFAULT_STYLE, validator=DefaultValidator, name=FilePickerCtrlNameStr) -> bool
Creates this widget with the given parameters.
"""
def GetPath(self):
"""
GetPath() -> String
Returns the absolute path of the currently selected file.
"""
def SetInitialDirectory(self, dir):
"""
SetInitialDirectory(dir)
Set the directory to show when starting to browse for files.
"""
def SetPath(self, filename):
"""
SetPath(filename)
Sets the absolute path of the currently selected file.
"""
Path = property(None, None)
# end of class FilePickerCtrl
DirPickerWidgetLabel = ""
DirPickerWidgetNameStr = ""
DirPickerCtrlNameStr = ""
DirSelectorPromptStr = ""
class DirPickerCtrl(PickerBase):
"""
DirPickerCtrl()
DirPickerCtrl(parent, id=ID_ANY, path=EmptyString, message=DirSelectorPromptStr, pos=DefaultPosition, size=DefaultSize, style=DIRP_DEFAULT_STYLE, validator=DefaultValidator, name=DirPickerCtrlNameStr)
This control allows the user to select a directory.
"""
def __init__(self, *args, **kw):
"""
DirPickerCtrl()
DirPickerCtrl(parent, id=ID_ANY, path=EmptyString, message=DirSelectorPromptStr, pos=DefaultPosition, size=DefaultSize, style=DIRP_DEFAULT_STYLE, validator=DefaultValidator, name=DirPickerCtrlNameStr)
This control allows the user to select a directory.
"""
def Create(self, parent, id=ID_ANY, path=EmptyString, message=DirSelectorPromptStr, pos=DefaultPosition, size=DefaultSize, style=DIRP_DEFAULT_STYLE, validator=DefaultValidator, name=DirPickerCtrlNameStr):
"""
Create(parent, id=ID_ANY, path=EmptyString, message=DirSelectorPromptStr, pos=DefaultPosition, size=DefaultSize, style=DIRP_DEFAULT_STYLE, validator=DefaultValidator, name=DirPickerCtrlNameStr) -> bool
Creates the widgets with the given parameters.
"""
def GetPath(self):
"""
GetPath() -> String
Returns the absolute path of the currently selected directory.
"""
def SetInitialDirectory(self, dir):
"""
SetInitialDirectory(dir)
Set the directory to show when starting to browse for directories.
"""
def SetPath(self, dirname):
"""
SetPath(dirname)
Sets the absolute path of the currently selected directory (the
default converter uses current locale's charset).
"""
Path = property(None, None)
# end of class DirPickerCtrl
class FileDirPickerEvent(CommandEvent):
"""
FileDirPickerEvent()
FileDirPickerEvent(type, generator, id, path)
This event class is used for the events generated by wxFilePickerCtrl
and by wxDirPickerCtrl.
"""
def __init__(self, *args, **kw):
"""
FileDirPickerEvent()
FileDirPickerEvent(type, generator, id, path)
This event class is used for the events generated by wxFilePickerCtrl
and by wxDirPickerCtrl.
"""
def GetPath(self):
"""
GetPath() -> String
Retrieve the absolute path of the file/directory the user has just
selected.
"""
def SetPath(self, path):
"""
SetPath(path)
Set the absolute path of the file/directory associated with the event.
"""
EVT_FILEPICKER_CHANGED = wx.PyEventBinder( wxEVT_FILEPICKER_CHANGED, 1 )
EVT_DIRPICKER_CHANGED = wx.PyEventBinder( wxEVT_DIRPICKER_CHANGED, 1 )
# deprecated wxEVT aliases
wxEVT_COMMAND_FILEPICKER_CHANGED = wxEVT_FILEPICKER_CHANGED
wxEVT_COMMAND_DIRPICKER_CHANGED = wxEVT_DIRPICKER_CHANGED
Path = property(None, None)
# end of class FileDirPickerEvent
FontPickerWidgetNameStr = ""
FontPickerCtrlNameStr = ""
class FontPickerCtrl(PickerBase):
"""
FontPickerCtrl()
FontPickerCtrl(parent, id=ID_ANY, font=NullFont, pos=DefaultPosition, size=DefaultSize, style=FNTP_DEFAULT_STYLE, validator=DefaultValidator, name=FontPickerCtrlNameStr)
This control allows the user to select a font.
"""
def __init__(self, *args, **kw):
"""
FontPickerCtrl()
FontPickerCtrl(parent, id=ID_ANY, font=NullFont, pos=DefaultPosition, size=DefaultSize, style=FNTP_DEFAULT_STYLE, validator=DefaultValidator, name=FontPickerCtrlNameStr)
This control allows the user to select a font.
"""
def Create(self, parent, id=ID_ANY, font=NullFont, pos=DefaultPosition, size=DefaultSize, style=FNTP_DEFAULT_STYLE, validator=DefaultValidator, name=FontPickerCtrlNameStr):
"""
Create(parent, id=ID_ANY, font=NullFont, pos=DefaultPosition, size=DefaultSize, style=FNTP_DEFAULT_STYLE, validator=DefaultValidator, name=FontPickerCtrlNameStr) -> bool
Creates this widget with given parameters.
"""
def GetMaxPointSize(self):
"""
GetMaxPointSize() -> unsignedint
Returns the maximum point size value allowed for the user-chosen font.
"""
def GetSelectedFont(self):
"""
GetSelectedFont() -> Font
Returns the currently selected font.
"""
def SetMaxPointSize(self, max):
"""
SetMaxPointSize(max)
Sets the maximum point size value allowed for the user-chosen font.
"""
def SetSelectedFont(self, font):
"""
SetSelectedFont(font)
Sets the currently selected font.
"""
MaxPointSize = property(None, None)
SelectedFont = property(None, None)
# end of class FontPickerCtrl
class FontPickerEvent(CommandEvent):
"""
FontPickerEvent(generator, id, font)
This event class is used for the events generated by wxFontPickerCtrl.
"""
def __init__(self, generator, id, font):
"""
FontPickerEvent(generator, id, font)
This event class is used for the events generated by wxFontPickerCtrl.
"""
def GetFont(self):
"""
GetFont() -> Font
Retrieve the font the user has just selected.
"""
def SetFont(self, f):
"""
SetFont(f)
Set the font associated with the event.
"""
EVT_FONTPICKER_CHANGED = wx.PyEventBinder( wxEVT_FONTPICKER_CHANGED, 1 )
# deprecated wxEVT alias
wxEVT_COMMAND_FONTPICKER_CHANGED = wxEVT_FONTPICKER_CHANGED
Font = property(None, None)
# end of class FontPickerEvent
if 'wxMac' in wx.PlatformInfo:
# ColourData object to be shared by all colour pickers
_colourData = None
class ColourPickerCtrl(PickerBase):
'''
This control allows the user to select a colour. The
implementation varies by platform but is usually a button which
brings up a `wx.ColourDialog` when clicked.
Window Styles
-------------
====================== ============================================
wx.CLRP_DEFAULT Default style.
wx.CLRP_USE_TEXTCTRL Creates a text control to the left of the
picker button which is completely managed
by the `wx.ColourPickerCtrl` and which can
be used by the user to specify a colour.
The text control is automatically synchronized
with the button's value. Use functions defined in
`wx.PickerBase` to modify the text control.
wx.CLRP_SHOW_LABEL Shows the colour in HTML form (AABBCC) as the
colour button label (instead of no label at all).
====================== ============================================
Events
------
======================== ==========================================
EVT_COLOURPICKER_CHANGED The user changed the colour selected in the
control either using the button or using the
text control (see wx.CLRP_USE_TEXTCTRL; note
that in this case the event is fired only if
the user's input is valid, i.e. recognizable).
======================== ==========================================
'''
#--------------------------------------------------
class ColourPickerButton(BitmapButton):
def __init__(self, parent, id=-1, colour=wx.BLACK,
pos=wx.DefaultPosition, size=wx.DefaultSize,
style = CLRP_DEFAULT_STYLE,
validator = wx.DefaultValidator,
name = "colourpickerwidget"):
wx.BitmapButton.__init__(self, parent, id, wx.Bitmap(1,1),
pos, size, style, validator, name)
self.SetColour(colour)
self.InvalidateBestSize()
self.SetInitialSize(size)
self.Bind(wx.EVT_BUTTON, self.OnButtonClick)
global _colourData
if _colourData is None:
_colourData = wx.ColourData()
_colourData.SetChooseFull(True)
grey = 0
for i in range(16):
c = wx.Colour(grey, grey, grey)
_colourData.SetCustomColour(i, c)
grey += 16
def SetColour(self, colour):
self.colour = colour
bmp = self._makeBitmap()
self.SetBitmapLabel(bmp)
def GetColour(self):
return self.colour
def OnButtonClick(self, evt):
global _colourData
_colourData.SetColour(self.colour)
dlg = wx.ColourDialog(self, _colourData)
if dlg.ShowModal() == wx.ID_OK:
_colourData = dlg.GetColourData()
self.SetColour(_colourData.GetColour())
evt = wx.ColourPickerEvent(self, self.GetId(), self.GetColour())
self.GetEventHandler().ProcessEvent(evt)
def _makeBitmap(self):
width = height = 22
bg = self.GetColour()
if self.HasFlag(CLRP_SHOW_LABEL):
w, h = self.GetTextExtent(bg.GetAsString(wx.C2S_HTML_SYNTAX))
width += w
bmp = wx.Bitmap(width, height)
dc = wx.MemoryDC(bmp)
dc.SetBackground(wx.Brush(self.colour))
dc.Clear()
if self.HasFlag(CLRP_SHOW_LABEL):
from wx.lib.colourutils import BestLabelColour
fg = BestLabelColour(bg)
dc.SetTextForeground(fg)
dc.DrawText(bg.GetAsString(wx.C2S_HTML_SYNTAX),
(width - w)/2, (height - h)/2)
return bmp
#--------------------------------------------------
def __init__(self, parent, id=-1, colour=wx.BLACK,
pos=wx.DefaultPosition, size=wx.DefaultSize,
style = CLRP_DEFAULT_STYLE,
validator = wx.DefaultValidator,
name = "colourpicker"):
if type(colour) != wx.Colour:
colour = wx.Colour(colour)
wx.PickerBase.__init__(self)
self.CreateBase(parent, id, colour.GetAsString(),
pos, size, style, validator, name)
widget = ColourPickerCtrl.ColourPickerButton(
self, -1, colour, style=self.GetPickerStyle(style))
self.SetPickerCtrl(widget)
widget.Bind(wx.EVT_COLOURPICKER_CHANGED, self.OnColourChange)
self.PostCreation()
def GetColour(self):
'''Set the displayed colour.'''
return self.GetPickerCtrl().GetColour()
def SetColour(self, colour):
'''Returns the currently selected colour.'''
self.GetPickerCtrl().SetColour(colour)
self.UpdateTextCtrlFromPicker()
def UpdatePickerFromTextCtrl(self):
col = wx.Colour(self.GetTextCtrl().GetValue())
if not col.Ok():
return
if self.GetColour() != col:
self.GetPickerCtrl().SetColour(col)
evt = wx.ColourPickerEvent(self, self.GetId(), self.GetColour())
self.GetEventHandler().ProcessEvent(evt)
def UpdateTextCtrlFromPicker(self):
if not self.GetTextCtrl():
return
self.GetTextCtrl().SetValue(self.GetColour().GetAsString())
def GetPickerStyle(self, style):
return style & CLRP_SHOW_LABEL
def OnColourChange(self, evt):
self.UpdateTextCtrlFromPicker()
evt = wx.ColourPickerEvent(self, self.GetId(), self.GetColour())
self.GetEventHandler().ProcessEvent(evt)
#-- end-pickers --#
#-- begin-filectrl --#
FC_DEFAULT_STYLE = 0
FC_OPEN = 0
FC_SAVE = 0
FC_MULTIPLE = 0
FC_NOSHOWHIDDEN = 0
wxEVT_FILECTRL_SELECTIONCHANGED = 0
wxEVT_FILECTRL_FILEACTIVATED = 0
wxEVT_FILECTRL_FOLDERCHANGED = 0
wxEVT_FILECTRL_FILTERCHANGED = 0
FileCtrlNameStr = ""
class FileCtrl(Control):
"""
FileCtrl()
FileCtrl(parent, id=ID_ANY, defaultDirectory=EmptyString, defaultFilename=EmptyString, wildCard=FileSelectorDefaultWildcardStr, style=FC_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileCtrlNameStr)
This control allows the user to select a file.
"""
def __init__(self, *args, **kw):
"""
FileCtrl()
FileCtrl(parent, id=ID_ANY, defaultDirectory=EmptyString, defaultFilename=EmptyString, wildCard=FileSelectorDefaultWildcardStr, style=FC_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileCtrlNameStr)
This control allows the user to select a file.
"""
def Create(self, parent, id=ID_ANY, defaultDirectory=EmptyString, defaultFilename=EmptyString, wildCard=FileSelectorDefaultWildcardStr, style=FC_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileCtrlNameStr):
"""
Create(parent, id=ID_ANY, defaultDirectory=EmptyString, defaultFilename=EmptyString, wildCard=FileSelectorDefaultWildcardStr, style=FC_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileCtrlNameStr) -> bool
Create function for two-step construction.
"""
def GetDirectory(self):
"""
GetDirectory() -> String
Returns the current directory of the file control (i.e. the directory
shown by it).
"""
def GetFilename(self):
"""
GetFilename() -> String
Returns the currently selected filename.
"""
def GetFilenames(self):
"""
GetFilenames() -> ArrayString
Returns a list of filenames selected in the control. This function
should only be used with controls which have the wx.FC_MULTIPLE style,
use GetFilename for the others.
"""
def GetFilterIndex(self):
"""
GetFilterIndex() -> int
Returns the zero-based index of the currently selected filter.
"""
def GetPath(self):
"""
GetPath() -> String
Returns the full path (directory and filename) of the currently
selected file.
"""
def GetPaths(self):
"""
GetPaths() -> ArrayString
Returns a list of the full paths (directory and filename) of the files
chosen. This function should only be used with controlss which have
the wx.FC_MULTIPLE style, use GetPath for the others.
"""
def GetWildcard(self):
"""
GetWildcard() -> String
Returns the current wildcard.
"""
def SetDirectory(self, directory):
"""
SetDirectory(directory) -> bool
Sets(changes) the current directory displayed in the control.
"""
def SetFilename(self, filename):
"""
SetFilename(filename) -> bool
Selects a certain file.
"""
def SetPath(self, path):
"""
SetPath(path) -> bool
Changes to a certain directory and selects a certain file.
"""
def SetFilterIndex(self, filterIndex):
"""
SetFilterIndex(filterIndex)
Sets the current filter index, starting from zero.
"""
def SetWildcard(self, wildCard):
"""
SetWildcard(wildCard)
Sets the wildcard, which can contain multiple file types, for example:
"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif".
"""
def ShowHidden(self, show):
"""
ShowHidden(show)
Sets whether hidden files and folders are shown or not.
"""
Directory = property(None, None)
Filename = property(None, None)
Filenames = property(None, None)
FilterIndex = property(None, None)
Path = property(None, None)
Paths = property(None, None)
Wildcard = property(None, None)
# end of class FileCtrl
class FileCtrlEvent(CommandEvent):
"""
FileCtrlEvent(type, evtObject, id)
A file control event holds information about events associated with
wxFileCtrl objects.
"""
def __init__(self, type, evtObject, id):
"""
FileCtrlEvent(type, evtObject, id)
A file control event holds information about events associated with
wxFileCtrl objects.
"""
def GetDirectory(self):
"""
GetDirectory() -> String
Returns the current directory.
"""
def GetFile(self):
"""
GetFile() -> String
Returns the file selected (assuming it is only one file).
"""
def GetFiles(self):
"""
GetFiles() -> ArrayString
Returns the files selected.
"""
def GetFilterIndex(self):
"""
GetFilterIndex() -> int
Returns the current file filter index.
"""
def SetFiles(self, files):
"""
SetFiles(files)
Sets the files changed by this event.
"""
def SetDirectory(self, directory):
"""
SetDirectory(directory)
Sets the directory of this event.
"""
def SetFilterIndex(self, index):
"""
SetFilterIndex(index)
Sets the filter index changed by this event.
"""
EVT_FILECTRL_SELECTIONCHANGED = wx.PyEventBinder( wxEVT_FILECTRL_SELECTIONCHANGED, 1)
EVT_FILECTRL_FILEACTIVATED = wx.PyEventBinder( wxEVT_FILECTRL_FILEACTIVATED, 1)
EVT_FILECTRL_FOLDERCHANGED = wx.PyEventBinder( wxEVT_FILECTRL_FOLDERCHANGED, 1)
EVT_FILECTRL_FILTERCHANGED = wx.PyEventBinder( wxEVT_FILECTRL_FILTERCHANGED, 1)
Directory = property(None, None)
File = property(None, None)
Files = property(None, None)
FilterIndex = property(None, None)
# end of class FileCtrlEvent
#-- end-filectrl --#
#-- begin-combo --#
CC_SPECIAL_DCLICK = 0
CC_STD_BUTTON = 0
class ComboPopup(object):
"""
ComboPopup()
In order to use a custom popup with wxComboCtrl, an interface class
must be derived from wxComboPopup.
"""
def __init__(self):
"""
ComboPopup()
In order to use a custom popup with wxComboCtrl, an interface class
must be derived from wxComboPopup.
"""
def Create(self, parent):
"""
Create(parent) -> bool
The derived class must implement this to create the popup control.
"""
def DestroyPopup(self):
"""
DestroyPopup()
You only need to implement this member function if you create your
popup class in non-standard way.
"""
def Dismiss(self):
"""
Dismiss()
Utility function that hides the popup.
"""
def FindItem(self, item, trueItem=None):
"""
FindItem(item, trueItem=None) -> bool
Implement to customize matching of value string to an item container
entry.
"""
def GetAdjustedSize(self, minWidth, prefHeight, maxHeight):
"""
GetAdjustedSize(minWidth, prefHeight, maxHeight) -> Size
The derived class may implement this to return adjusted size for the
popup control, according to the variables given.
"""
def GetComboCtrl(self):
"""
GetComboCtrl() -> ComboCtrl
Returns pointer to the associated parent wxComboCtrl.
"""
def GetControl(self):
"""
GetControl() -> Window
The derived class must implement this to return pointer to the
associated control created in Create().
"""
def GetStringValue(self):
"""
GetStringValue() -> String
The derived class must implement this to return string representation
of the value.
"""
def Init(self):
"""
Init()
The derived class must implement this to initialize its internal
variables.
"""
def IsCreated(self):
"""
IsCreated() -> bool
Utility method that returns true if Create has been called.
"""
def LazyCreate(self):
"""
LazyCreate() -> bool
The derived class may implement this to return true if it wants to
delay call to Create() until the popup is shown for the first time.
"""
def OnComboDoubleClick(self):
"""
OnComboDoubleClick()
The derived class may implement this to do something when the parent
wxComboCtrl gets double-clicked.
"""
def OnComboKeyEvent(self, event):
"""
OnComboKeyEvent(event)
The derived class may implement this to receive key events from the
parent wxComboCtrl.
"""
def OnDismiss(self):
"""
OnDismiss()
The derived class may implement this to do special processing when
popup is hidden.
"""
def OnPopup(self):
"""
OnPopup()
The derived class may implement this to do special processing when
popup is shown.
"""
def PaintComboControl(self, dc, rect):
"""
PaintComboControl(dc, rect)
The derived class may implement this to paint the parent wxComboCtrl.
"""
def SetStringValue(self, value):
"""
SetStringValue(value)
The derived class must implement this to receive string value changes
from wxComboCtrl.
"""
ComboCtrl = property(None, None)
Control = property(None, None)
StringValue = property(None, None)
# end of class ComboPopup
class ComboCtrlFeatures(object):
"""
Features enabled for wxComboCtrl.
"""
MovableButton = 0
BitmapButton = 0
ButtonSpacing = 0
TextIndent = 0
PaintControl = 0
PaintWritable = 0
Borderless = 0
All = 0
# end of class ComboCtrlFeatures
ComboBoxNameStr = ""
class ComboCtrl(Control, TextEntry):
"""
ComboCtrl()
ComboCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ComboBoxNameStr)
A combo control is a generic combobox that allows totally custom
popup.
"""
def __init__(self, *args, **kw):
"""
ComboCtrl()
ComboCtrl(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ComboBoxNameStr)
A combo control is a generic combobox that allows totally custom
popup.
"""
def SetMargins(self, *args, **kw):
"""
SetMargins(pt) -> bool
SetMargins(left, top=-1) -> bool
Attempts to set the control margins.
"""
def Copy(self):
"""
Copy()
Copies the selected text to the clipboard.
"""
def Create(self, parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ComboBoxNameStr):
"""
Create(parent, id=ID_ANY, value=EmptyString, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ComboBoxNameStr) -> bool
Creates the combo control for two-step construction.
"""
def Cut(self):
"""
Cut()
Copies the selected text to the clipboard and removes the selection.
"""
def Dismiss(self):
"""
Dismiss()
Dismisses the popup window.
"""
def EnablePopupAnimation(self, enable=True):
"""
EnablePopupAnimation(enable=True)
Enables or disables popup animation, if any, depending on the value of
the argument.
"""
def IsKeyPopupToggle(self, event):
"""
IsKeyPopupToggle(event) -> bool
Returns true if given key combination should toggle the popup.
"""
def PrepareBackground(self, dc, rect, flags):
"""
PrepareBackground(dc, rect, flags)
Prepare background of combo control or an item in a dropdown list in a
way typical on platform.
"""
def ShouldDrawFocus(self):
"""
ShouldDrawFocus() -> bool
Returns true if focus indicator should be drawn in the control.
"""
def GetBitmapDisabled(self):
"""
GetBitmapDisabled() -> Bitmap
Returns disabled button bitmap that has been set with
SetButtonBitmaps().
"""
def GetBitmapHover(self):
"""
GetBitmapHover() -> Bitmap
Returns button mouse hover bitmap that has been set with
SetButtonBitmaps().
"""
def GetBitmapNormal(self):
"""
GetBitmapNormal() -> Bitmap
Returns default button bitmap that has been set with
SetButtonBitmaps().
"""
def GetBitmapPressed(self):
"""
GetBitmapPressed() -> Bitmap
Returns depressed button bitmap that has been set with
SetButtonBitmaps().
"""
def GetButtonSize(self):
"""
GetButtonSize() -> Size
Returns current size of the dropdown button.
"""
def GetCustomPaintWidth(self):
"""
GetCustomPaintWidth() -> int
Returns custom painted area in control.
"""
def GetHint(self):
"""
GetHint() -> String
Returns the current hint string.
"""
def GetInsertionPoint(self):
"""
GetInsertionPoint() -> long
Returns the insertion point for the combo control's text field.
"""
def GetLastPosition(self):
"""
GetLastPosition() -> long
Returns the last position in the combo control text field.
"""
def GetMargins(self):
"""
GetMargins() -> Point
Returns the margins used by the control.
"""
def GetPopupControl(self):
"""
GetPopupControl() -> ComboPopup
Returns current popup interface that has been set with
SetPopupControl().
"""
def GetPopupWindow(self):
"""
GetPopupWindow() -> Window
Returns popup window containing the popup control.
"""
def GetTextCtrl(self):
"""
GetTextCtrl() -> TextCtrl
Get the text control which is part of the combo control.
"""
def GetTextIndent(self):
"""
GetTextIndent() -> Coord
Returns actual indentation in pixels.
"""
def GetTextRect(self):
"""
GetTextRect() -> Rect
Returns area covered by the text field (includes everything except
borders and the dropdown button).
"""
def GetValue(self):
"""
GetValue() -> String
Returns text representation of the current value.
"""
def HidePopup(self, generateEvent=False):
"""
HidePopup(generateEvent=False)
Dismisses the popup window.
"""
def IsPopupShown(self):
"""
IsPopupShown() -> bool
Returns true if the popup is currently shown.
"""
def IsPopupWindowState(self, state):
"""
IsPopupWindowState(state) -> bool
Returns true if the popup window is in the given state.
"""
def OnButtonClick(self):
"""
OnButtonClick()
Implement in a derived class to define what happens on dropdown button
click.
"""
def Paste(self):
"""
Paste()
Pastes text from the clipboard to the text field.
"""
def Popup(self):
"""
Popup()
Shows the popup portion of the combo control.
"""
def Remove(self, frm, to):
"""
Remove(frm, to)
Removes the text between the two positions in the combo control text
field.
"""
def Replace(self, frm, to, text):
"""
Replace(frm, to, text)
Replaces the text between two positions with the given text, in the
combo control text field.
"""
def SetButtonBitmaps(self, bmpNormal, pushButtonBg=False, bmpPressed=NullBitmap, bmpHover=NullBitmap, bmpDisabled=NullBitmap):
"""
SetButtonBitmaps(bmpNormal, pushButtonBg=False, bmpPressed=NullBitmap, bmpHover=NullBitmap, bmpDisabled=NullBitmap)
Sets custom dropdown button graphics.
"""
def SetButtonPosition(self, width=-1, height=-1, side=RIGHT, spacingX=0):
"""
SetButtonPosition(width=-1, height=-1, side=RIGHT, spacingX=0)
Sets size and position of dropdown button.
"""
def SetCustomPaintWidth(self, width):
"""
SetCustomPaintWidth(width)
Set width, in pixels, of custom painted area in control without
wxCB_READONLY style.
"""
def SetHint(self, hint):
"""
SetHint(hint) -> bool
Sets a hint shown in an empty unfocused combo control.
"""
def SetInsertionPoint(self, pos):
"""
SetInsertionPoint(pos)
Sets the insertion point in the text field.
"""
def SetInsertionPointEnd(self):
"""
SetInsertionPointEnd()
Sets the insertion point at the end of the combo control text field.
"""
def SetPopupAnchor(self, anchorSide):
"""
SetPopupAnchor(anchorSide)
Set side of the control to which the popup will align itself.
"""
def SetPopupControl(self, popup):
"""
SetPopupControl(popup)
Set popup interface class derived from wxComboPopup.
"""
def SetPopupExtents(self, extLeft, extRight):
"""
SetPopupExtents(extLeft, extRight)
Extends popup size horizontally, relative to the edges of the combo
control.
"""
def SetPopupMaxHeight(self, height):
"""
SetPopupMaxHeight(height)
Sets preferred maximum height of the popup.
"""
def SetPopupMinWidth(self, width):
"""
SetPopupMinWidth(width)
Sets minimum width of the popup.
"""
def SetSelection(self, frm, to):
"""
SetSelection(frm, to)
Selects the text between the two positions, in the combo control text
field.
"""
def SetText(self, value):
"""
SetText(value)
Sets the text for the text field without affecting the popup.
"""
def SetTextCtrlStyle(self, style):
"""
SetTextCtrlStyle(style)
Set a custom window style for the embedded wxTextCtrl.
"""
def SetTextIndent(self, indent):
"""
SetTextIndent(indent)
This will set the space in pixels between left edge of the control and
the text, regardless whether control is read-only or not.
"""
def SetValue(self, value):
"""
SetValue(value)
Sets the text for the combo control text field.
"""
def SetValueByUser(self, value):
"""
SetValueByUser(value)
Changes value of the control as if user had done it by selecting an
item from a combo box drop-down list.
"""
def ShowPopup(self):
"""
ShowPopup()
Show the popup.
"""
def Undo(self):
"""
Undo()
Undoes the last edit in the text field.
"""
def UseAltPopupWindow(self, enable=True):
"""
UseAltPopupWindow(enable=True)
Enable or disable usage of an alternative popup window, which
guarantees ability to focus the popup control, and allows common
native controls to function normally.
"""
@staticmethod
def GetFeatures():
"""
GetFeatures() -> int
Returns features supported by wxComboCtrl.
"""
BitmapDisabled = property(None, None)
BitmapHover = property(None, None)
BitmapNormal = property(None, None)
BitmapPressed = property(None, None)
ButtonSize = property(None, None)
CustomPaintWidth = property(None, None)
Hint = property(None, None)
InsertionPoint = property(None, None)
LastPosition = property(None, None)
Margins = property(None, None)
PopupControl = property(None, None)
PopupWindow = property(None, None)
TextCtrl = property(None, None)
TextIndent = property(None, None)
TextRect = property(None, None)
Value = property(None, None)
def AnimateShow(self, rect, flags):
"""
AnimateShow(rect, flags) -> bool
This member function is not normally called in application code.
"""
def DoSetPopupControl(self, popup):
"""
DoSetPopupControl(popup)
This member function is not normally called in application code.
"""
def DoShowPopup(self, rect, flags):
"""
DoShowPopup(rect, flags)
This member function is not normally called in application code.
"""
# end of class ComboCtrl
#-- end-combo --#
#-- begin-choicebk --#
CHB_DEFAULT = 0
CHB_TOP = 0
CHB_BOTTOM = 0
CHB_LEFT = 0
CHB_RIGHT = 0
CHB_ALIGN_MASK = 0
wxEVT_CHOICEBOOK_PAGE_CHANGED = 0
wxEVT_CHOICEBOOK_PAGE_CHANGING = 0
class Choicebook(BookCtrlBase):
"""
Choicebook()
Choicebook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
wxChoicebook is a class similar to wxNotebook, but uses a wxChoice
control to show the labels instead of the tabs.
"""
def __init__(self, *args, **kw):
"""
Choicebook()
Choicebook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
wxChoicebook is a class similar to wxNotebook, but uses a wxChoice
control to show the labels instead of the tabs.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString) -> bool
Create the choicebook control that has already been constructed with
the default constructor.
"""
def GetChoiceCtrl(self):
"""
GetChoiceCtrl() -> Choice
Returns the wxChoice associated with the control.
"""
ChoiceCtrl = property(None, None)
# end of class Choicebook
EVT_CHOICEBOOK_PAGE_CHANGED = wx.PyEventBinder( wxEVT_CHOICEBOOK_PAGE_CHANGED, 1 )
EVT_CHOICEBOOK_PAGE_CHANGING = wx.PyEventBinder( wxEVT_CHOICEBOOK_PAGE_CHANGING, 1 )
# deprecated wxEVT aliases
wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGED = wxEVT_CHOICEBOOK_PAGE_CHANGED
wxEVT_COMMAND_CHOICEBOOK_PAGE_CHANGING = wxEVT_CHOICEBOOK_PAGE_CHANGING
#-- end-choicebk --#
#-- begin-listbook --#
LB_DEFAULT = 0
LB_TOP = 0
LB_BOTTOM = 0
LB_LEFT = 0
LB_RIGHT = 0
LB_ALIGN_MASK = 0
wxEVT_LISTBOOK_PAGE_CHANGED = 0
wxEVT_LISTBOOK_PAGE_CHANGING = 0
class Listbook(BookCtrlBase):
"""
Listbook()
Listbook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
wxListbook is a class similar to wxNotebook but which uses a
wxListCtrl to show the labels instead of the tabs.
"""
def __init__(self, *args, **kw):
"""
Listbook()
Listbook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
wxListbook is a class similar to wxNotebook but which uses a
wxListCtrl to show the labels instead of the tabs.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString) -> bool
Create the list book control that has already been constructed with
the default constructor.
"""
def GetListView(self):
"""
GetListView() -> ListView
Returns the wxListView associated with the control.
"""
ListView = property(None, None)
# end of class Listbook
EVT_LISTBOOK_PAGE_CHANGED = wx.PyEventBinder( wxEVT_LISTBOOK_PAGE_CHANGED, 1 )
EVT_LISTBOOK_PAGE_CHANGING = wx.PyEventBinder( wxEVT_LISTBOOK_PAGE_CHANGING, 1 )
# deprecated wxEVT aliases
wxEVT_COMMAND_LISTBOOK_PAGE_CHANGED = wxEVT_LISTBOOK_PAGE_CHANGED
wxEVT_COMMAND_LISTBOOK_PAGE_CHANGING = wxEVT_LISTBOOK_PAGE_CHANGING
#-- end-listbook --#
#-- begin-toolbook --#
TBK_BUTTONBAR = 0
TBK_HORZ_LAYOUT = 0
wxEVT_TOOLBOOK_PAGE_CHANGED = 0
wxEVT_TOOLBOOK_PAGE_CHANGING = 0
class Toolbook(BookCtrlBase):
"""
Toolbook()
Toolbook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
wxToolbook is a class similar to wxNotebook but which uses a wxToolBar
to show the labels instead of the tabs.
"""
def __init__(self, *args, **kw):
"""
Toolbook()
Toolbook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString)
wxToolbook is a class similar to wxNotebook but which uses a wxToolBar
to show the labels instead of the tabs.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=EmptyString) -> bool
Create the tool book control that has already been constructed with
the default constructor.
"""
def GetToolBar(self):
"""
GetToolBar() -> ToolBar
Return the toolbar used for page selection.
"""
ToolBar = property(None, None)
# end of class Toolbook
EVT_TOOLBOOK_PAGE_CHANGED = wx.PyEventBinder( wxEVT_TOOLBOOK_PAGE_CHANGED, 1 )
EVT_TOOLBOOK_PAGE_CHANGING = wx.PyEventBinder( wxEVT_TOOLBOOK_PAGE_CHANGING, 1 )
# deprecated wxEVT aliases
wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGED = wxEVT_TOOLBOOK_PAGE_CHANGED
wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGING = wxEVT_TOOLBOOK_PAGE_CHANGING
#-- end-toolbook --#
#-- begin-treebook --#
wxEVT_TREEBOOK_PAGE_CHANGED = 0
wxEVT_TREEBOOK_PAGE_CHANGING = 0
wxEVT_TREEBOOK_NODE_COLLAPSED = 0
wxEVT_TREEBOOK_NODE_EXPANDED = 0
class Treebook(BookCtrlBase):
"""
Treebook()
Treebook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=BK_DEFAULT, name=EmptyString)
This class is an extension of the wxNotebook class that allows a tree
structured set of pages to be shown in a control.
"""
def __init__(self, *args, **kw):
"""
Treebook()
Treebook(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=BK_DEFAULT, name=EmptyString)
This class is an extension of the wxNotebook class that allows a tree
structured set of pages to be shown in a control.
"""
def AddPage(self, page, text, bSelect=False, imageId=NOT_FOUND):
"""
AddPage(page, text, bSelect=False, imageId=NOT_FOUND) -> bool
Adds a new page.
"""
def AddSubPage(self, page, text, bSelect=False, imageId=NOT_FOUND):
"""
AddSubPage(page, text, bSelect=False, imageId=NOT_FOUND) -> bool
Adds a new child-page to the last top-level page.
"""
def CollapseNode(self, pageId):
"""
CollapseNode(pageId) -> bool
Shortcut for ExpandNode( pageId, false ).
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=BK_DEFAULT, name=EmptyString):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=BK_DEFAULT, name=EmptyString) -> bool
Creates a treebook control.
"""
def DeletePage(self, pagePos):
"""
DeletePage(pagePos) -> bool
Deletes the page at the specified position and all its children.
"""
def ExpandNode(self, pageId, expand=True):
"""
ExpandNode(pageId, expand=True) -> bool
Expands (collapses) the pageId node.
"""
def GetPageParent(self, page):
"""
GetPageParent(page) -> int
Returns the parent page of the given one or wxNOT_FOUND if this is a
top-level page.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the currently selected page, or wxNOT_FOUND if none was
selected.
"""
def InsertPage(self, pagePos, page, text, bSelect=False, imageId=NOT_FOUND):
"""
InsertPage(pagePos, page, text, bSelect=False, imageId=NOT_FOUND) -> bool
Inserts a new page just before the page indicated by pagePos.
"""
def InsertSubPage(self, pagePos, page, text, bSelect=False, imageId=NOT_FOUND):
"""
InsertSubPage(pagePos, page, text, bSelect=False, imageId=NOT_FOUND) -> bool
Inserts a sub page under the specified page.
"""
def IsNodeExpanded(self, pageId):
"""
IsNodeExpanded(pageId) -> bool
Returns true if the page represented by pageId is expanded.
"""
Selection = property(None, None)
# end of class Treebook
EVT_TREEBOOK_PAGE_CHANGED = wx.PyEventBinder( wxEVT_TREEBOOK_PAGE_CHANGED, 1 )
EVT_TREEBOOK_PAGE_CHANGING = wx.PyEventBinder( wxEVT_TREEBOOK_PAGE_CHANGING, 1)
EVT_TREEBOOK_NODE_COLLAPSED = wx.PyEventBinder( wxEVT_TREEBOOK_NODE_COLLAPSED, 1 )
EVT_TREEBOOK_NODE_EXPANDED = wx.PyEventBinder( wxEVT_TREEBOOK_NODE_EXPANDED, 1 )
# deprecated wxEVT aliases
wxEVT_COMMAND_TREEBOOK_PAGE_CHANGED = wxEVT_TREEBOOK_PAGE_CHANGED
wxEVT_COMMAND_TREEBOOK_PAGE_CHANGING = wxEVT_TREEBOOK_PAGE_CHANGING
wxEVT_COMMAND_TREEBOOK_NODE_COLLAPSED = wxEVT_TREEBOOK_NODE_COLLAPSED
wxEVT_COMMAND_TREEBOOK_NODE_EXPANDED = wxEVT_TREEBOOK_NODE_EXPANDED
#-- end-treebook --#
#-- begin-vlbox --#
VListBoxNameStr = ""
class VListBox(VScrolledWindow):
"""
VListBox()
VListBox(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=VListBoxNameStr)
wxVListBox is a wxListBox-like control with the following two main
differences from a regular wxListBox: it can have an arbitrarily huge
number of items because it doesn't store them itself but uses the
OnDrawItem() callback to draw them (so it is a virtual listbox) and
its items can have variable height as determined by OnMeasureItem()
(so it is also a listbox with the lines of variable height).
"""
def __init__(self, *args, **kw):
"""
VListBox()
VListBox(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=VListBoxNameStr)
wxVListBox is a wxListBox-like control with the following two main
differences from a regular wxListBox: it can have an arbitrarily huge
number of items because it doesn't store them itself but uses the
OnDrawItem() callback to draw them (so it is a virtual listbox) and
its items can have variable height as determined by OnMeasureItem()
(so it is also a listbox with the lines of variable height).
"""
def SetMargins(self, *args, **kw):
"""
SetMargins(pt)
SetMargins(x, y)
Set the margins: horizontal margin is the distance between the window
border and the item contents while vertical margin is half of the
distance between items.
"""
def Clear(self):
"""
Clear()
Deletes all items from the control.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=VListBoxNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0, name=VListBoxNameStr) -> bool
Creates the control.
"""
def DeselectAll(self):
"""
DeselectAll() -> bool
Deselects all the items in the listbox.
"""
def GetFirstSelected(self):
"""
GetFirstSelected() -> (int, cookie)
Returns the index of the first selected item in the listbox or
wxNOT_FOUND if no items are currently selected.
"""
def GetItemCount(self):
"""
GetItemCount() -> size_t
Get the number of items in the control.
"""
def GetMargins(self):
"""
GetMargins() -> Point
Returns the margins used by the control.
"""
def GetItemRect(self, item):
"""
GetItemRect(item) -> Rect
Returns the rectangle occupied by this item in physical coordinates.
"""
def GetNextSelected(self, cookie):
"""
GetNextSelected(cookie) -> (int, cookie)
Returns the index of the next selected item or wxNOT_FOUND if there
are no more.
"""
def GetSelectedCount(self):
"""
GetSelectedCount() -> size_t
Returns the number of the items currently selected.
"""
def GetSelection(self):
"""
GetSelection() -> int
Get the currently selected item or wxNOT_FOUND if there is no
selection.
"""
def GetSelectionBackground(self):
"""
GetSelectionBackground() -> Colour
Returns the background colour used for the selected cells.
"""
def HasMultipleSelection(self):
"""
HasMultipleSelection() -> bool
Returns true if the listbox was created with wxLB_MULTIPLE style and
so supports multiple selection or false if it is a single selection
listbox.
"""
def IsCurrent(self, item):
"""
IsCurrent(item) -> bool
Returns true if this item is the current one, false otherwise.
"""
def IsSelected(self, item):
"""
IsSelected(item) -> bool
Returns true if this item is selected, false otherwise.
"""
def Select(self, item, select=True):
"""
Select(item, select=True) -> bool
Selects or deselects the specified item which must be valid (i.e. not
equal to wxNOT_FOUND).
"""
def SelectAll(self):
"""
SelectAll() -> bool
Selects all the items in the listbox.
"""
def SelectRange(self, from_, to_):
"""
SelectRange(from_, to_) -> bool
Selects all items in the specified range which may be given in any
order.
"""
def SetItemCount(self, count):
"""
SetItemCount(count)
Set the number of items to be shown in the control.
"""
def SetSelection(self, selection):
"""
SetSelection(selection)
Set the selection to the specified item, if it is -1 the selection is
unset.
"""
def SetSelectionBackground(self, col):
"""
SetSelectionBackground(col)
Sets the colour to be used for the selected cells background.
"""
def Toggle(self, item):
"""
Toggle(item)
Toggles the state of the specified item, i.e. selects it if it was
unselected and deselects it if it was selected.
"""
ItemCount = property(None, None)
Margins = property(None, None)
SelectedCount = property(None, None)
Selection = property(None, None)
SelectionBackground = property(None, None)
def OnDrawItem(self, dc, rect, n):
"""
OnDrawItem(dc, rect, n)
The derived class must implement this function to actually draw the
item with the given index on the provided DC.
"""
def OnDrawBackground(self, dc, rect, n):
"""
OnDrawBackground(dc, rect, n)
This method is used to draw the item's background and, maybe, a border
around it.
"""
def OnDrawSeparator(self, dc, rect, n):
"""
OnDrawSeparator(dc, rect, n)
This method may be used to draw separators between the lines.
"""
def OnMeasureItem(self, n):
"""
OnMeasureItem(n) -> Coord
The derived class must implement this method to return the height of
the specified item (in pixels).
"""
# end of class VListBox
#-- end-vlbox --#
#-- begin-nonownedwnd --#
FRAME_SHAPED = 0
class NonOwnedWindow(Window):
"""
Common base class for all non-child windows.
"""
def SetShape(self, *args, **kw):
"""
SetShape(region) -> bool
SetShape(path) -> bool
If the platform supports it, sets the shape of the window to that
depicted by region.
"""
# end of class NonOwnedWindow
#-- end-nonownedwnd --#
#-- begin-toplevel --#
DEFAULT_FRAME_STYLE = 0
USER_ATTENTION_INFO = 0
USER_ATTENTION_ERROR = 0
FULLSCREEN_NOMENUBAR = 0
FULLSCREEN_NOTOOLBAR = 0
FULLSCREEN_NOSTATUSBAR = 0
FULLSCREEN_NOBORDER = 0
FULLSCREEN_NOCAPTION = 0
FULLSCREEN_ALL = 0
FrameNameStr = ""
class TopLevelWindow(NonOwnedWindow):
"""
TopLevelWindow()
TopLevelWindow(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
wxTopLevelWindow is a common base class for wxDialog and wxFrame.
"""
def __init__(self, *args, **kw):
"""
TopLevelWindow()
TopLevelWindow(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
wxTopLevelWindow is a common base class for wxDialog and wxFrame.
"""
def Create(self, parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr):
"""
Create(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr) -> bool
Creates the top level window.
"""
def CanSetTransparent(self):
"""
CanSetTransparent() -> bool
Returns true if the platform supports making the window translucent.
"""
def CenterOnScreen(self, direction=BOTH):
"""
CenterOnScreen(direction=BOTH)
A synonym for CentreOnScreen().
"""
def CentreOnScreen(self, direction=BOTH):
"""
CentreOnScreen(direction=BOTH)
Centres the window on screen.
"""
def EnableCloseButton(self, enable=True):
"""
EnableCloseButton(enable=True) -> bool
Enables or disables the Close button (most often in the right upper
corner of a dialog) and the Close entry of the system menu (most often
in the left upper corner of the dialog).
"""
def GetDefaultItem(self):
"""
GetDefaultItem() -> Window
Returns a pointer to the button which is the default for this window,
or NULL.
"""
def GetIcon(self):
"""
GetIcon() -> Icon
Returns the standard icon of the window.
"""
def GetIcons(self):
"""
GetIcons() -> IconBundle
Returns all icons associated with the window, there will be none of
them if neither SetIcon() nor SetIcons() had been called before.
"""
def GetTitle(self):
"""
GetTitle() -> String
Gets a string containing the window title.
"""
def Iconize(self, iconize=True):
"""
Iconize(iconize=True)
Iconizes or restores the window.
"""
def IsActive(self):
"""
IsActive() -> bool
Returns true if this window is currently active, i.e. if the user is
currently working with it.
"""
def IsAlwaysMaximized(self):
"""
IsAlwaysMaximized() -> bool
Returns true if this window is expected to be always maximized, either
due to platform policy or due to local policy regarding particular
class.
"""
def IsFullScreen(self):
"""
IsFullScreen() -> bool
Returns true if the window is in fullscreen mode.
"""
def IsIconized(self):
"""
IsIconized() -> bool
Returns true if the window is iconized.
"""
def IsMaximized(self):
"""
IsMaximized() -> bool
Returns true if the window is maximized.
"""
def Layout(self):
"""
Layout() -> bool
See wxWindow::SetAutoLayout(): when auto layout is on, this function
gets called automatically when the window is resized.
"""
def Maximize(self, maximize=True):
"""
Maximize(maximize=True)
Maximizes or restores the window.
"""
def RequestUserAttention(self, flags=USER_ATTENTION_INFO):
"""
RequestUserAttention(flags=USER_ATTENTION_INFO)
Use a system-dependent way to attract users attention to the window
when it is in background.
"""
def SetDefaultItem(self, win):
"""
SetDefaultItem(win) -> Window
Changes the default item for the panel, usually win is a button.
"""
def SetTmpDefaultItem(self, win):
"""
SetTmpDefaultItem(win) -> Window
"""
def GetTmpDefaultItem(self):
"""
GetTmpDefaultItem() -> Window
"""
def SetIcon(self, icon):
"""
SetIcon(icon)
Sets the icon for this window.
"""
def SetIcons(self, icons):
"""
SetIcons(icons)
Sets several icons of different sizes for this window: this allows to
use different icons for different situations (e.g.
"""
def SetMaxSize(self, size):
"""
SetMaxSize(size)
A simpler interface for setting the size hints than SetSizeHints().
"""
def SetMinSize(self, size):
"""
SetMinSize(size)
A simpler interface for setting the size hints than SetSizeHints().
"""
def SetSizeHints(self, *args, **kw):
"""
SetSizeHints(minW, minH, maxW=-1, maxH=-1, incW=-1, incH=-1)
SetSizeHints(minSize, maxSize=DefaultSize, incSize=DefaultSize)
Allows specification of minimum and maximum window sizes, and window
size increments.
"""
def SetTitle(self, title):
"""
SetTitle(title)
Sets the window title.
"""
def SetTransparent(self, alpha):
"""
SetTransparent(alpha) -> bool
If the platform supports it will set the window to be translucent.
"""
def ShouldPreventAppExit(self):
"""
ShouldPreventAppExit() -> bool
This virtual function is not meant to be called directly but can be
overridden to return false (it returns true by default) to allow the
application to close even if this, presumably not very important,
window is still opened.
"""
def OSXSetModified(self, modified):
"""
OSXSetModified(modified)
This function sets the wxTopLevelWindow's modified state on OS X,
which currently draws a black dot in the wxTopLevelWindow's close
button.
"""
def OSXIsModified(self):
"""
OSXIsModified() -> bool
Returns the current modified state of the wxTopLevelWindow on OS X.
"""
def SetRepresentedFilename(self, filename):
"""
SetRepresentedFilename(filename)
Sets the file name represented by this wxTopLevelWindow.
"""
def ShowWithoutActivating(self):
"""
ShowWithoutActivating()
Show the wxTopLevelWindow, but do not give it keyboard focus.
"""
def ShowFullScreen(self, show, style=FULLSCREEN_ALL):
"""
ShowFullScreen(show, style=FULLSCREEN_ALL) -> bool
Depending on the value of show parameter the window is either shown
full screen or restored to its normal state.
"""
@staticmethod
def GetDefaultSize():
"""
GetDefaultSize() -> Size
Get the default size for a new top level window.
"""
def MacSetMetalAppearance(self, on):
"""
MacSetMetalAppearance(on)
"""
def MacGetMetalAppearance(self):
"""
MacGetMetalAppearance() -> bool
"""
def MacGetUnifiedAppearance(self):
"""
MacGetUnifiedAppearance() -> bool
"""
def MacGetTopLevelWindowRef(self):
"""
MacGetTopLevelWindowRef() -> void
"""
DefaultItem = property(None, None)
Icon = property(None, None)
Title = property(None, None)
TmpDefaultItem = property(None, None)
OSXModified = property(None, None)
MacMetalAppearance = property(None, None)
# end of class TopLevelWindow
#-- end-toplevel --#
#-- begin-dialog --#
DIALOG_NO_PARENT = 0
DEFAULT_DIALOG_STYLE = 0
DIALOG_ADAPTATION_NONE = 0
DIALOG_ADAPTATION_STANDARD_SIZER = 0
DIALOG_ADAPTATION_ANY_SIZER = 0
DIALOG_ADAPTATION_LOOSE_BUTTONS = 0
DIALOG_ADAPTATION_MODE_DEFAULT = 0
DIALOG_ADAPTATION_MODE_ENABLED = 0
DIALOG_ADAPTATION_MODE_DISABLED = 0
DialogNameStr = ""
class Dialog(TopLevelWindow):
"""
Dialog()
Dialog(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_DIALOG_STYLE, name=DialogNameStr)
A dialog box is a window with a title bar and sometimes a system menu,
which can be moved around the screen.
"""
def __init__(self, *args, **kw):
"""
Dialog()
Dialog(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_DIALOG_STYLE, name=DialogNameStr)
A dialog box is a window with a title bar and sometimes a system menu,
which can be moved around the screen.
"""
def AddMainButtonId(self, id):
"""
AddMainButtonId(id)
Adds an identifier to be regarded as a main button for the non-
scrolling area of a dialog.
"""
def CanDoLayoutAdaptation(self):
"""
CanDoLayoutAdaptation() -> bool
Returns true if this dialog can and should perform layout adaptation
using DoLayoutAdaptation(), usually if the dialog is too large to fit
on the display.
"""
def Centre(self, direction=BOTH):
"""
Centre(direction=BOTH)
Centres the dialog box on the display.
"""
def Create(self, parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_DIALOG_STYLE, name=DialogNameStr):
"""
Create(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_DIALOG_STYLE, name=DialogNameStr) -> bool
Used for two-step dialog box construction.
"""
def CreateButtonSizer(self, flags):
"""
CreateButtonSizer(flags) -> Sizer
Creates a sizer with standard buttons.
"""
def CreateSeparatedButtonSizer(self, flags):
"""
CreateSeparatedButtonSizer(flags) -> Sizer
Creates a sizer with standard buttons using CreateButtonSizer()
separated from the rest of the dialog contents by a horizontal
wxStaticLine.
"""
def CreateSeparatedSizer(self, sizer):
"""
CreateSeparatedSizer(sizer) -> Sizer
Returns the sizer containing the given one with a separating
wxStaticLine if necessarily.
"""
def CreateStdDialogButtonSizer(self, flags):
"""
CreateStdDialogButtonSizer(flags) -> StdDialogButtonSizer
Creates a wxStdDialogButtonSizer with standard buttons.
"""
def CreateTextSizer(self, message):
"""
CreateTextSizer(message) -> Sizer
Splits text up at newlines and places the lines into wxStaticText
objects in a vertical wxBoxSizer.
"""
def DoLayoutAdaptation(self):
"""
DoLayoutAdaptation() -> bool
Performs layout adaptation, usually if the dialog is too large to fit
on the display.
"""
def EndModal(self, retCode):
"""
EndModal(retCode)
Ends a modal dialog, passing a value to be returned from the
ShowModal() invocation.
"""
def GetAffirmativeId(self):
"""
GetAffirmativeId() -> int
Gets the identifier of the button which works like standard OK button
in this dialog.
"""
def GetContentWindow(self):
"""
GetContentWindow() -> Window
Override this to return a window containing the main content of the
dialog.
"""
def GetEscapeId(self):
"""
GetEscapeId() -> int
Gets the identifier of the button to map presses of ESC button to.
"""
def GetLayoutAdaptationDone(self):
"""
GetLayoutAdaptationDone() -> bool
Returns true if the dialog has been adapted, usually by making it
scrollable to work with a small display.
"""
def GetLayoutAdaptationLevel(self):
"""
GetLayoutAdaptationLevel() -> int
Gets a value representing the aggressiveness of search for buttons and
sizers to be in the non-scrolling part of a layout-adapted dialog.
"""
def GetLayoutAdaptationMode(self):
"""
GetLayoutAdaptationMode() -> DialogLayoutAdaptationMode
Gets the adaptation mode, overriding the global adaptation flag.
"""
def GetMainButtonIds(self):
"""
GetMainButtonIds() -> ArrayInt
Returns an array of identifiers to be regarded as the main buttons for
the non-scrolling area of a dialog.
"""
def GetReturnCode(self):
"""
GetReturnCode() -> int
Gets the return code for this window.
"""
def Iconize(self, iconize=True):
"""
Iconize(iconize=True)
Iconizes or restores the dialog.
"""
def IsIconized(self):
"""
IsIconized() -> bool
Returns true if the dialog box is iconized.
"""
def IsMainButtonId(self, id):
"""
IsMainButtonId(id) -> bool
Returns true if id is in the array of identifiers to be regarded as
the main buttons for the non-scrolling area of a dialog.
"""
def IsModal(self):
"""
IsModal() -> bool
Returns true if the dialog box is modal, false otherwise.
"""
def SetAffirmativeId(self, id):
"""
SetAffirmativeId(id)
Sets the identifier to be used as OK button.
"""
def SetEscapeId(self, id):
"""
SetEscapeId(id)
Sets the identifier of the button which should work like the standard
"Cancel" button in this dialog.
"""
def SetIcon(self, icon):
"""
SetIcon(icon)
Sets the icon for this dialog.
"""
def SetIcons(self, icons):
"""
SetIcons(icons)
Sets the icons for this dialog.
"""
def SetLayoutAdaptationDone(self, done):
"""
SetLayoutAdaptationDone(done)
Marks the dialog as having been adapted, usually by making it
scrollable to work with a small display.
"""
def SetLayoutAdaptationLevel(self, level):
"""
SetLayoutAdaptationLevel(level)
Sets the aggressiveness of search for buttons and sizers to be in the
non-scrolling part of a layout-adapted dialog.
"""
def SetLayoutAdaptationMode(self, mode):
"""
SetLayoutAdaptationMode(mode)
Sets the adaptation mode, overriding the global adaptation flag.
"""
def SetReturnCode(self, retCode):
"""
SetReturnCode(retCode)
Sets the return code for this window.
"""
def Show(self, show=1):
"""
Show(show=1) -> bool
Hides or shows the dialog.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows an application-modal dialog.
"""
def ShowWindowModal(self):
"""
ShowWindowModal()
Shows a dialog modal to the parent top level window only.
"""
@staticmethod
def EnableLayoutAdaptation(enable):
"""
EnableLayoutAdaptation(enable)
A static function enabling or disabling layout adaptation for all
dialogs.
"""
@staticmethod
def GetLayoutAdapter():
"""
GetLayoutAdapter() -> DialogLayoutAdapter
A static function getting the current layout adapter object.
"""
@staticmethod
def IsLayoutAdaptationEnabled():
"""
IsLayoutAdaptationEnabled() -> bool
A static function returning true if layout adaptation is enabled for
all dialogs.
"""
@staticmethod
def SetLayoutAdapter(adapter):
"""
SetLayoutAdapter(adapter) -> DialogLayoutAdapter
A static function for setting the current layout adapter object,
returning the old adapter.
"""
def __enter__(self):
"""
"""
def __exit__(self, exc_type, exc_val, exc_tb):
"""
"""
AffirmativeId = property(None, None)
ContentWindow = property(None, None)
EscapeId = property(None, None)
LayoutAdaptationDone = property(None, None)
LayoutAdaptationLevel = property(None, None)
LayoutAdaptationMode = property(None, None)
MainButtonIds = property(None, None)
ReturnCode = property(None, None)
# end of class Dialog
class DialogLayoutAdapter(object):
"""
DialogLayoutAdapter()
This abstract class is the base for classes that help wxWidgets
perform run-time layout adaptation of dialogs.
"""
def __init__(self):
"""
DialogLayoutAdapter()
This abstract class is the base for classes that help wxWidgets
perform run-time layout adaptation of dialogs.
"""
def CanDoLayoutAdaptation(self, dialog):
"""
CanDoLayoutAdaptation(dialog) -> bool
Override this to returns true if adaptation can and should be done.
"""
def DoLayoutAdaptation(self, dialog):
"""
DoLayoutAdaptation(dialog) -> bool
Override this to perform layout adaptation, such as making parts of
the dialog scroll and resizing the dialog to fit the display.
"""
# end of class DialogLayoutAdapter
class WindowModalDialogEvent(CommandEvent):
"""
WindowModalDialogEvent(commandType=wxEVT_NULL, id=0)
Event sent by wxDialog::ShowWindowModal() when the dialog closes.
"""
def __init__(self, commandType=wxEVT_NULL, id=0):
"""
WindowModalDialogEvent(commandType=wxEVT_NULL, id=0)
Event sent by wxDialog::ShowWindowModal() when the dialog closes.
"""
def GetDialog(self):
"""
GetDialog() -> Dialog
Return the corresponding dialog.
"""
def GetReturnCode(self):
"""
GetReturnCode() -> int
Return the dialog's return code.
"""
def Clone(self):
"""
Clone() -> Event
Clone the event.
"""
Dialog = property(None, None)
ReturnCode = property(None, None)
# end of class WindowModalDialogEvent
#-- end-dialog --#
#-- begin-dirdlg --#
DD_CHANGE_DIR = 0
DD_DIR_MUST_EXIST = 0
DD_NEW_DIR_BUTTON = 0
DD_DEFAULT_STYLE = 0
DirDialogNameStr = ""
DirDialogDefaultFolderStr = ""
class DirDialog(Dialog):
"""
DirDialog(parent, message=DirSelectorPromptStr, defaultPath=EmptyString, style=DD_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=DirDialogNameStr)
This class represents the directory chooser dialog.
"""
def __init__(self, parent, message=DirSelectorPromptStr, defaultPath=EmptyString, style=DD_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=DirDialogNameStr):
"""
DirDialog(parent, message=DirSelectorPromptStr, defaultPath=EmptyString, style=DD_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=DirDialogNameStr)
This class represents the directory chooser dialog.
"""
def GetMessage(self):
"""
GetMessage() -> String
Returns the message that will be displayed on the dialog.
"""
def GetPath(self):
"""
GetPath() -> String
Returns the default or user-selected path.
"""
def SetMessage(self, message):
"""
SetMessage(message)
Sets the message that will be displayed on the dialog.
"""
def SetPath(self, path):
"""
SetPath(path)
Sets the default path.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning wxID_OK if the user pressed OK, and
wxID_CANCEL otherwise.
"""
Message = property(None, None)
Path = property(None, None)
# end of class DirDialog
def DirSelector(message=DirSelectorPromptStr, default_path=EmptyString, style=0, pos=DefaultPosition, parent=None):
"""
DirSelector(message=DirSelectorPromptStr, default_path=EmptyString, style=0, pos=DefaultPosition, parent=None) -> String
Pops up a directory selector dialog.
"""
#-- end-dirdlg --#
#-- begin-dirctrl --#
DIRCTRL_DIR_ONLY = 0
DIRCTRL_SELECT_FIRST = 0
DIRCTRL_SHOW_FILTERS = 0
DIRCTRL_3D_INTERNAL = 0
DIRCTRL_EDIT_LABELS = 0
DIRCTRL_MULTIPLE = 0
wxEVT_DIRCTRL_SELECTIONCHANGED = 0
wxEVT_DIRCTRL_FILEACTIVATED = 0
class GenericDirCtrl(Control):
"""
GenericDirCtrl()
GenericDirCtrl(parent, id=ID_ANY, dir=DirDialogDefaultFolderStr, pos=DefaultPosition, size=DefaultSize, style=DIRCTRL_3D_INTERNAL, filter=EmptyString, defaultFilter=0, name=TreeCtrlNameStr)
This control can be used to place a directory listing (with optional
files) on an arbitrary window.
"""
def __init__(self, *args, **kw):
"""
GenericDirCtrl()
GenericDirCtrl(parent, id=ID_ANY, dir=DirDialogDefaultFolderStr, pos=DefaultPosition, size=DefaultSize, style=DIRCTRL_3D_INTERNAL, filter=EmptyString, defaultFilter=0, name=TreeCtrlNameStr)
This control can be used to place a directory listing (with optional
files) on an arbitrary window.
"""
def CollapsePath(self, path):
"""
CollapsePath(path) -> bool
Collapse the given path.
"""
def CollapseTree(self):
"""
CollapseTree()
Collapses the entire tree.
"""
def Create(self, parent, id=ID_ANY, dir=DirDialogDefaultFolderStr, pos=DefaultPosition, size=DefaultSize, style=DIRCTRL_3D_INTERNAL, filter=EmptyString, defaultFilter=0, name=TreeCtrlNameStr):
"""
Create(parent, id=ID_ANY, dir=DirDialogDefaultFolderStr, pos=DefaultPosition, size=DefaultSize, style=DIRCTRL_3D_INTERNAL, filter=EmptyString, defaultFilter=0, name=TreeCtrlNameStr) -> bool
Create function for two-step construction.
"""
def ExpandPath(self, path):
"""
ExpandPath(path) -> bool
Tries to expand as much of the given path as possible, so that the
filename or directory is visible in the tree control.
"""
def GetDefaultPath(self):
"""
GetDefaultPath() -> String
Gets the default path.
"""
def GetFilePath(self):
"""
GetFilePath() -> String
Gets selected filename path only (else empty string).
"""
def GetFilePaths(self, paths):
"""
GetFilePaths(paths)
Fills the array paths with the currently selected filepaths.
"""
def GetFilter(self):
"""
GetFilter() -> String
Returns the filter string.
"""
def GetFilterIndex(self):
"""
GetFilterIndex() -> int
Returns the current filter index (zero-based).
"""
def GetFilterListCtrl(self):
"""
GetFilterListCtrl() -> DirFilterListCtrl
Returns a pointer to the filter list control (if present).
"""
def GetPath(self, *args, **kw):
"""
GetPath() -> String
GetPath(itemId) -> String
Gets the currently-selected directory or filename.
"""
def GetPaths(self, paths):
"""
GetPaths(paths)
Fills the array paths with the selected directories and filenames.
"""
def GetRootId(self):
"""
GetRootId() -> TreeItemId
Returns the root id for the tree control.
"""
def GetTreeCtrl(self):
"""
GetTreeCtrl() -> TreeCtrl
Returns a pointer to the tree control.
"""
def Init(self):
"""
Init()
Initializes variables.
"""
def ReCreateTree(self):
"""
ReCreateTree()
Collapse and expand the tree, thus re-creating it from scratch.
"""
def SetDefaultPath(self, path):
"""
SetDefaultPath(path)
Sets the default path.
"""
def SetFilter(self, filter):
"""
SetFilter(filter)
Sets the filter string.
"""
def SetFilterIndex(self, n):
"""
SetFilterIndex(n)
Sets the current filter index (zero-based).
"""
def SetPath(self, path):
"""
SetPath(path)
Sets the current path.
"""
def ShowHidden(self, show):
"""
ShowHidden(show)
"""
def SelectPath(self, path, select=True):
"""
SelectPath(path, select=True)
Selects the given item.
"""
def SelectPaths(self, paths):
"""
SelectPaths(paths)
Selects only the specified paths, clearing any previous selection.
"""
def UnselectAll(self):
"""
UnselectAll()
Removes the selection from all currently selected items.
"""
EVT_DIRCTRL_SELECTIONCHANGED = wx.PyEventBinder( wxEVT_DIRCTRL_SELECTIONCHANGED, 1 )
EVT_DIRCTRL_FILEACTIVATED = wx.PyEventBinder( wxEVT_DIRCTRL_FILEACTIVATED, 1 )
DefaultPath = property(None, None)
FilePath = property(None, None)
Filter = property(None, None)
FilterIndex = property(None, None)
FilterListCtrl = property(None, None)
Path = property(None, None)
RootId = property(None, None)
TreeCtrl = property(None, None)
# end of class GenericDirCtrl
class DirFilterListCtrl(Choice):
"""
DirFilterListCtrl()
DirFilterListCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0)
"""
def __init__(self, *args, **kw):
"""
DirFilterListCtrl()
DirFilterListCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0)
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=0) -> bool
"""
def Init(self):
"""
Init()
"""
def FillFilterList(self, filter, defaultFilter):
"""
FillFilterList(filter, defaultFilter)
"""
# end of class DirFilterListCtrl
#-- end-dirctrl --#
#-- begin-filedlg --#
FD_DEFAULT_STYLE = 0
FD_OPEN = 0
FD_SAVE = 0
FD_OVERWRITE_PROMPT = 0
FD_FILE_MUST_EXIST = 0
FD_MULTIPLE = 0
FD_CHANGE_DIR = 0
FD_PREVIEW = 0
FileDialogNameStr = ""
class FileDialog(Dialog):
"""
FileDialog(parent, message=FileSelectorPromptStr, defaultDir=EmptyString, defaultFile=EmptyString, wildcard=FileSelectorDefaultWildcardStr, style=FD_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileDialogNameStr)
This class represents the file chooser dialog.
"""
def __init__(self, parent, message=FileSelectorPromptStr, defaultDir=EmptyString, defaultFile=EmptyString, wildcard=FileSelectorDefaultWildcardStr, style=FD_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileDialogNameStr):
"""
FileDialog(parent, message=FileSelectorPromptStr, defaultDir=EmptyString, defaultFile=EmptyString, wildcard=FileSelectorDefaultWildcardStr, style=FD_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileDialogNameStr)
This class represents the file chooser dialog.
"""
def GetCurrentlySelectedFilename(self):
"""
GetCurrentlySelectedFilename() -> String
Returns the path of the file currently selected in dialog.
"""
def GetDirectory(self):
"""
GetDirectory() -> String
Returns the default directory.
"""
def GetExtraControl(self):
"""
GetExtraControl() -> Window
If functions SetExtraControlCreator() and ShowModal() were called,
returns the extra window.
"""
def GetFilename(self):
"""
GetFilename() -> String
Returns the default filename.
"""
def GetFilenames(self):
"""
GetFilenames() -> ArrayString
Returns a list of filenames chosen in the dialog. This function
should only be used with the dialogs which have wx.MULTIPLE style,
use GetFilename for the others.
"""
def GetFilterIndex(self):
"""
GetFilterIndex() -> int
Returns the index into the list of filters supplied, optionally, in
the wildcard parameter.
"""
def GetMessage(self):
"""
GetMessage() -> String
Returns the message that will be displayed on the dialog.
"""
def GetPath(self):
"""
GetPath() -> String
Returns the full path (directory and filename) of the selected file.
"""
def GetPaths(self):
"""
GetPaths() -> ArrayString
Returns a list of the full paths of the files chosen. This function
should only be used with the dialogs which have wx.MULTIPLE style, use
GetPath for the others.
"""
def GetWildcard(self):
"""
GetWildcard() -> String
Returns the file dialog wildcard.
"""
def SetDirectory(self, directory):
"""
SetDirectory(directory)
Sets the default directory.
"""
def SetFilename(self, setfilename):
"""
SetFilename(setfilename)
Sets the default filename.
"""
def SetFilterIndex(self, filterIndex):
"""
SetFilterIndex(filterIndex)
Sets the default filter index, starting from zero.
"""
def SetMessage(self, message):
"""
SetMessage(message)
Sets the message that will be displayed on the dialog.
"""
def SetPath(self, path):
"""
SetPath(path)
Sets the path (the combined directory and filename that will be
returned when the dialog is dismissed).
"""
def SetWildcard(self, wildCard):
"""
SetWildcard(wildCard)
Sets the wildcard, which can contain multiple file types, for example:
"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif".
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning wxID_OK if the user pressed OK, and
wxID_CANCEL otherwise.
"""
CurrentlySelectedFilename = property(None, None)
Directory = property(None, None)
ExtraControl = property(None, None)
Filename = property(None, None)
Filenames = property(None, None)
FilterIndex = property(None, None)
Message = property(None, None)
Path = property(None, None)
Paths = property(None, None)
Wildcard = property(None, None)
# end of class FileDialog
def FileSelector(message, default_path=EmptyString, default_filename=EmptyString, default_extension=EmptyString, wildcard=FileSelectorDefaultWildcardStr, flags=0, parent=None, x=DefaultCoord, y=DefaultCoord):
"""
FileSelector(message, default_path=EmptyString, default_filename=EmptyString, default_extension=EmptyString, wildcard=FileSelectorDefaultWildcardStr, flags=0, parent=None, x=DefaultCoord, y=DefaultCoord) -> String
Pops up a file selector box.
"""
def FileSelectorEx(message=FileSelectorPromptStr, default_path=EmptyString, default_filename=EmptyString, indexDefaultExtension=None, wildcard=FileSelectorDefaultWildcardStr, flags=0, parent=None, x=DefaultCoord, y=DefaultCoord):
"""
FileSelectorEx(message=FileSelectorPromptStr, default_path=EmptyString, default_filename=EmptyString, indexDefaultExtension=None, wildcard=FileSelectorDefaultWildcardStr, flags=0, parent=None, x=DefaultCoord, y=DefaultCoord) -> String
An extended version of wxFileSelector.
"""
def LoadFileSelector(what, extension, default_name=EmptyString, parent=None):
"""
LoadFileSelector(what, extension, default_name=EmptyString, parent=None) -> String
Ask for filename to load.
"""
def SaveFileSelector(what, extension, default_name=EmptyString, parent=None):
"""
SaveFileSelector(what, extension, default_name=EmptyString, parent=None) -> String
Ask for filename to save.
"""
#-- end-filedlg --#
#-- begin-frame --#
FRAME_NO_TASKBAR = 0
FRAME_TOOL_WINDOW = 0
FRAME_FLOAT_ON_PARENT = 0
class Frame(TopLevelWindow):
"""
Frame()
Frame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
A frame is a window whose size and position can (usually) be changed
by the user.
"""
def __init__(self, *args, **kw):
"""
Frame()
Frame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
A frame is a window whose size and position can (usually) be changed
by the user.
"""
def Centre(self, direction=BOTH):
"""
Centre(direction=BOTH)
Centres the frame on the display.
"""
def Create(self, parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr):
"""
Create(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr) -> bool
Used in two-step frame construction.
"""
def CreateStatusBar(self, number=1, style=STB_DEFAULT_STYLE, id=0, name=StatusBarNameStr):
"""
CreateStatusBar(number=1, style=STB_DEFAULT_STYLE, id=0, name=StatusBarNameStr) -> StatusBar
Creates a status bar at the bottom of the frame.
"""
def CreateToolBar(self, style=TB_DEFAULT_STYLE, id=ID_ANY, name=ToolBarNameStr):
"""
CreateToolBar(style=TB_DEFAULT_STYLE, id=ID_ANY, name=ToolBarNameStr) -> ToolBar
Creates a toolbar at the top or left of the frame.
"""
def GetClientAreaOrigin(self):
"""
GetClientAreaOrigin() -> Point
Returns the origin of the frame client area (in client coordinates).
"""
def GetMenuBar(self):
"""
GetMenuBar() -> MenuBar
Returns a pointer to the menubar currently associated with the frame
(if any).
"""
def GetStatusBar(self):
"""
GetStatusBar() -> StatusBar
Returns a pointer to the status bar currently associated with the
frame (if any).
"""
def GetStatusBarPane(self):
"""
GetStatusBarPane() -> int
Returns the status bar pane used to display menu and toolbar help.
"""
def GetToolBar(self):
"""
GetToolBar() -> ToolBar
Returns a pointer to the toolbar currently associated with the frame
(if any).
"""
def OnCreateStatusBar(self, number, style, id, name):
"""
OnCreateStatusBar(number, style, id, name) -> StatusBar
Virtual function called when a status bar is requested by
CreateStatusBar().
"""
def OnCreateToolBar(self, style, id, name):
"""
OnCreateToolBar(style, id, name) -> ToolBar
Virtual function called when a toolbar is requested by
CreateToolBar().
"""
def ProcessCommand(self, id):
"""
ProcessCommand(id) -> bool
Simulate a menu command.
"""
def SetMenuBar(self, menuBar):
"""
SetMenuBar(menuBar)
Tells the frame to show the given menu bar.
"""
def SetStatusBar(self, statusBar):
"""
SetStatusBar(statusBar)
Associates a status bar with the frame.
"""
def SetStatusBarPane(self, n):
"""
SetStatusBarPane(n)
Set the status bar pane used to display menu and toolbar help.
"""
def SetStatusText(self, text, number=0):
"""
SetStatusText(text, number=0)
Sets the status bar text and redraws the status bar.
"""
def SetStatusWidths(self, widths):
"""
SetStatusWidths(widths)
Sets the widths of the fields in the status bar.
"""
def SetToolBar(self, toolBar):
"""
SetToolBar(toolBar)
Associates a toolbar with the frame.
"""
def PushStatusText(self, text, number=0):
"""
PushStatusText(text, number=0)
"""
def PopStatusText(self, number=0):
"""
PopStatusText(number=0)
"""
MenuBar = property(None, None)
StatusBar = property(None, None)
StatusBarPane = property(None, None)
ToolBar = property(None, None)
# end of class Frame
#-- end-frame --#
#-- begin-msgdlg --#
MessageBoxCaptionStr = ""
class MessageDialog(Dialog):
"""
MessageDialog(parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE, pos=DefaultPosition)
This class represents a dialog that shows a single or multi-line
message, with a choice of OK, Yes, No and Cancel buttons.
"""
class ButtonLabel(object):
"""
ButtonLabel(stockId)
ButtonLabel(label)
Helper class allowing to use either stock id or string labels.
"""
def __init__(self, *args, **kw):
"""
ButtonLabel(stockId)
ButtonLabel(label)
Helper class allowing to use either stock id or string labels.
"""
def GetAsString(self):
"""
GetAsString() -> String
Return the associated label as string.
"""
def GetStockId(self):
"""
GetStockId() -> int
Return the stock id or wxID_NONE if this is not a stock label.
"""
AsString = property(None, None)
StockId = property(None, None)
# end of class ButtonLabel
def __init__(self, parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE, pos=DefaultPosition):
"""
MessageDialog(parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE, pos=DefaultPosition)
This class represents a dialog that shows a single or multi-line
message, with a choice of OK, Yes, No and Cancel buttons.
"""
def SetExtendedMessage(self, extendedMessage):
"""
SetExtendedMessage(extendedMessage)
Sets the extended message for the dialog: this message is usually an
extension of the short message specified in the constructor or set
with SetMessage().
"""
def SetHelpLabel(self, help):
"""
SetHelpLabel(help) -> bool
Sets the label for the Help button.
"""
def SetMessage(self, message):
"""
SetMessage(message)
Sets the message shown by the dialog.
"""
def SetOKCancelLabels(self, ok, cancel):
"""
SetOKCancelLabels(ok, cancel) -> bool
Overrides the default labels of the OK and Cancel buttons.
"""
def SetOKLabel(self, ok):
"""
SetOKLabel(ok) -> bool
Overrides the default label of the OK button.
"""
def SetYesNoCancelLabels(self, yes, no, cancel):
"""
SetYesNoCancelLabels(yes, no, cancel) -> bool
Overrides the default labels of the Yes, No and Cancel buttons.
"""
def SetYesNoLabels(self, yes, no):
"""
SetYesNoLabels(yes, no) -> bool
Overrides the default labels of the Yes and No buttons.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning one of wxID_OK, wxID_CANCEL, wxID_YES,
wxID_NO or wxID_HELP.
"""
def GetCaption(self):
"""
GetCaption() -> String
"""
def GetMessage(self):
"""
GetMessage() -> String
"""
def GetExtendedMessage(self):
"""
GetExtendedMessage() -> String
"""
def GetMessageDialogStyle(self):
"""
GetMessageDialogStyle() -> long
"""
def HasCustomLabels(self):
"""
HasCustomLabels() -> bool
"""
def GetYesLabel(self):
"""
GetYesLabel() -> String
"""
def GetNoLabel(self):
"""
GetNoLabel() -> String
"""
def GetOKLabel(self):
"""
GetOKLabel() -> String
"""
def GetCancelLabel(self):
"""
GetCancelLabel() -> String
"""
def GetHelpLabel(self):
"""
GetHelpLabel() -> String
"""
def GetEffectiveIcon(self):
"""
GetEffectiveIcon() -> long
"""
CancelLabel = property(None, None)
Caption = property(None, None)
EffectiveIcon = property(None, None)
ExtendedMessage = property(None, None)
HelpLabel = property(None, None)
Message = property(None, None)
MessageDialogStyle = property(None, None)
NoLabel = property(None, None)
OKLabel = property(None, None)
YesLabel = property(None, None)
# end of class MessageDialog
def MessageBox(message, caption=MessageBoxCaptionStr, style=OK|CENTRE, parent=None, x=DefaultCoord, y=DefaultCoord):
"""
MessageBox(message, caption=MessageBoxCaptionStr, style=OK|CENTRE, parent=None, x=DefaultCoord, y=DefaultCoord) -> int
Show a general purpose message dialog.
"""
class GenericMessageDialog(Dialog):
"""
GenericMessageDialog(parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE, pos=DefaultPosition)
This class represents a dialog that shows a single or multi-line
message, with a choice of OK, Yes, No and Cancel buttons.
"""
class ButtonLabel(object):
"""
ButtonLabel(stockId)
ButtonLabel(label)
Helper class allowing to use either stock id or string labels.
"""
def __init__(self, *args, **kw):
"""
ButtonLabel(stockId)
ButtonLabel(label)
Helper class allowing to use either stock id or string labels.
"""
def GetAsString(self):
"""
GetAsString() -> String
Return the associated label as string.
"""
def GetStockId(self):
"""
GetStockId() -> int
Return the stock id or wxID_NONE if this is not a stock label.
"""
AsString = property(None, None)
StockId = property(None, None)
# end of class ButtonLabel
def __init__(self, parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE, pos=DefaultPosition):
"""
GenericMessageDialog(parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE, pos=DefaultPosition)
This class represents a dialog that shows a single or multi-line
message, with a choice of OK, Yes, No and Cancel buttons.
"""
def SetExtendedMessage(self, extendedMessage):
"""
SetExtendedMessage(extendedMessage)
Sets the extended message for the dialog: this message is usually an
extension of the short message specified in the constructor or set
with SetMessage().
"""
def SetHelpLabel(self, help):
"""
SetHelpLabel(help) -> bool
Sets the label for the Help button.
"""
def SetMessage(self, message):
"""
SetMessage(message)
Sets the message shown by the dialog.
"""
def SetOKCancelLabels(self, ok, cancel):
"""
SetOKCancelLabels(ok, cancel) -> bool
Overrides the default labels of the OK and Cancel buttons.
"""
def SetOKLabel(self, ok):
"""
SetOKLabel(ok) -> bool
Overrides the default label of the OK button.
"""
def SetYesNoCancelLabels(self, yes, no, cancel):
"""
SetYesNoCancelLabels(yes, no, cancel) -> bool
Overrides the default labels of the Yes, No and Cancel buttons.
"""
def SetYesNoLabels(self, yes, no):
"""
SetYesNoLabels(yes, no) -> bool
Overrides the default labels of the Yes and No buttons.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning one of wxID_OK, wxID_CANCEL, wxID_YES,
wxID_NO or wxID_HELP.
"""
def GetCaption(self):
"""
GetCaption() -> String
"""
def GetMessage(self):
"""
GetMessage() -> String
"""
def GetExtendedMessage(self):
"""
GetExtendedMessage() -> String
"""
def GetMessageDialogStyle(self):
"""
GetMessageDialogStyle() -> long
"""
def HasCustomLabels(self):
"""
HasCustomLabels() -> bool
"""
def GetYesLabel(self):
"""
GetYesLabel() -> String
"""
def GetNoLabel(self):
"""
GetNoLabel() -> String
"""
def GetOKLabel(self):
"""
GetOKLabel() -> String
"""
def GetCancelLabel(self):
"""
GetCancelLabel() -> String
"""
def GetHelpLabel(self):
"""
GetHelpLabel() -> String
"""
def GetEffectiveIcon(self):
"""
GetEffectiveIcon() -> long
"""
CancelLabel = property(None, None)
Caption = property(None, None)
EffectiveIcon = property(None, None)
ExtendedMessage = property(None, None)
HelpLabel = property(None, None)
Message = property(None, None)
MessageDialogStyle = property(None, None)
NoLabel = property(None, None)
OKLabel = property(None, None)
YesLabel = property(None, None)
def AddMessageDialogCheckBox(self, sizer):
"""
AddMessageDialogCheckBox(sizer)
Can be overridden to provide more contents for the dialog
"""
def AddMessageDialogDetails(self, sizer):
"""
AddMessageDialogDetails(sizer)
Can be overridden to provide more contents for the dialog
"""
# end of class GenericMessageDialog
#-- end-msgdlg --#
#-- begin-richmsgdlg --#
class RichMessageDialog(GenericMessageDialog):
"""
RichMessageDialog(parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE)
Extension of wxMessageDialog with additional functionality.
"""
def __init__(self, parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE):
"""
RichMessageDialog(parent, message, caption=MessageBoxCaptionStr, style=OK|CENTRE)
Extension of wxMessageDialog with additional functionality.
"""
def ShowCheckBox(self, checkBoxText, checked=False):
"""
ShowCheckBox(checkBoxText, checked=False)
Shows a checkbox with a given label or hides it.
"""
def GetCheckBoxText(self):
"""
GetCheckBoxText() -> String
Retrieves the label for the checkbox.
"""
def ShowDetailedText(self, detailedText):
"""
ShowDetailedText(detailedText)
Shows or hides a detailed text and an expander that is used to show or
hide the detailed text.
"""
def GetDetailedText(self):
"""
GetDetailedText() -> String
Retrieves the detailed text.
"""
def IsCheckBoxChecked(self):
"""
IsCheckBoxChecked() -> bool
Retrieves the state of the checkbox.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning one of wxID_OK, wxID_CANCEL, wxID_YES,
wxID_NO.
"""
CheckBoxText = property(None, None)
DetailedText = property(None, None)
# end of class RichMessageDialog
#-- end-richmsgdlg --#
#-- begin-progdlg --#
PD_CAN_ABORT = 0
PD_APP_MODAL = 0
PD_AUTO_HIDE = 0
PD_ELAPSED_TIME = 0
PD_ESTIMATED_TIME = 0
PD_SMOOTH = 0
PD_REMAINING_TIME = 0
PD_CAN_SKIP = 0
class GenericProgressDialog(Dialog):
"""
GenericProgressDialog(title, message, maximum=100, parent=None, style=PD_AUTO_HIDE|PD_APP_MODAL)
This class represents a dialog that shows a short message and a
progress bar.
"""
def __init__(self, title, message, maximum=100, parent=None, style=PD_AUTO_HIDE|PD_APP_MODAL):
"""
GenericProgressDialog(title, message, maximum=100, parent=None, style=PD_AUTO_HIDE|PD_APP_MODAL)
This class represents a dialog that shows a short message and a
progress bar.
"""
def GetValue(self):
"""
GetValue() -> int
Returns the last value passed to the Update() function or wxNOT_FOUND
if the dialog has no progress bar.
"""
def GetRange(self):
"""
GetRange() -> int
Returns the maximum value of the progress meter, as passed to the
constructor or wxNOT_FOUND if the dialog has no progress bar.
"""
def GetMessage(self):
"""
GetMessage() -> String
Returns the last message passed to the Update() function; if you
always passed wxEmptyString to Update() then the message set through
the constructor is returned.
"""
def Pulse(self, newmsg=EmptyString):
"""
Pulse(newmsg=EmptyString) -> (bool, skip)
Like Update() but makes the gauge control run in indeterminate mode.
"""
def Resume(self):
"""
Resume()
Can be used to continue with the dialog, after the user had clicked
the "Abort" button.
"""
def SetRange(self, maximum):
"""
SetRange(maximum)
Changes the maximum value of the progress meter given in the
constructor.
"""
def WasCancelled(self):
"""
WasCancelled() -> bool
Returns true if the "Cancel" button was pressed.
"""
def WasSkipped(self):
"""
WasSkipped() -> bool
Returns true if the "Skip" button was pressed.
"""
def Update(self, value, newmsg=EmptyString):
"""
Update(value, newmsg=EmptyString) -> (bool, skip)
Updates the dialog, setting the progress bar to the new value and
updating the message if new one is specified.
"""
Message = property(None, None)
Range = property(None, None)
Value = property(None, None)
# end of class GenericProgressDialog
class ProgressDialog(GenericProgressDialog):
"""
ProgressDialog(title, message, maximum=100, parent=None, style=PD_APP_MODAL|PD_AUTO_HIDE)
If supported by the platform this class will provide the platform's
native progress dialog, else it will simply be the
wxGenericProgressDialog.
"""
def __init__(self, title, message, maximum=100, parent=None, style=PD_APP_MODAL|PD_AUTO_HIDE):
"""
ProgressDialog(title, message, maximum=100, parent=None, style=PD_APP_MODAL|PD_AUTO_HIDE)
If supported by the platform this class will provide the platform's
native progress dialog, else it will simply be the
wxGenericProgressDialog.
"""
# end of class ProgressDialog
#-- end-progdlg --#
#-- begin-popupwin --#
class PopupWindow(NonOwnedWindow):
"""
PopupWindow()
PopupWindow(parent, flags=BORDER_NONE)
A special kind of top level window used for popup menus, combobox
popups and such.
"""
def __init__(self, *args, **kw):
"""
PopupWindow()
PopupWindow(parent, flags=BORDER_NONE)
A special kind of top level window used for popup menus, combobox
popups and such.
"""
def Create(self, parent, flags=BORDER_NONE):
"""
Create(parent, flags=BORDER_NONE) -> bool
Create method for two-step creation.
"""
def Position(self, ptOrigin, sizePopup):
"""
Position(ptOrigin, sizePopup)
Move the popup window to the right position, i.e. such that it is
entirely visible.
"""
# end of class PopupWindow
class PopupTransientWindow(PopupWindow):
"""
PopupTransientWindow()
PopupTransientWindow(parent, flags=BORDER_NONE)
A wxPopupWindow which disappears automatically when the user clicks
mouse outside it or if it loses focus in any other way.
"""
def __init__(self, *args, **kw):
"""
PopupTransientWindow()
PopupTransientWindow(parent, flags=BORDER_NONE)
A wxPopupWindow which disappears automatically when the user clicks
mouse outside it or if it loses focus in any other way.
"""
def Popup(self, focus=None):
"""
Popup(focus=None)
Popup the window (this will show it too).
"""
def Dismiss(self):
"""
Dismiss()
Hide the window.
"""
def ProcessLeftDown(self, event):
"""
ProcessLeftDown(event) -> bool
Called when a mouse is pressed while the popup is shown.
"""
def OnDismiss(self):
"""
OnDismiss()
This is called when the popup is disappeared because of anything else
but direct call to Dismiss().
"""
# end of class PopupTransientWindow
#-- end-popupwin --#
#-- begin-tipwin --#
class TipWindow(Window):
"""
TipWindow(parent, text, maxLength=100)
Shows simple text in a popup tip window on creation.
"""
def __init__(self, parent, text, maxLength=100):
"""
TipWindow(parent, text, maxLength=100)
Shows simple text in a popup tip window on creation.
"""
def SetBoundingRect(self, rectBound):
"""
SetBoundingRect(rectBound)
By default, the tip window disappears when the user clicks the mouse
or presses a keyboard key or if it loses focus in any other way - for
example because the user switched to another application window.
"""
# end of class TipWindow
#-- end-tipwin --#
#-- begin-colordlg --#
class ColourData(Object):
"""
ColourData()
This class holds a variety of information related to colour dialogs.
"""
NUM_CUSTOM = 0
def __init__(self):
"""
ColourData()
This class holds a variety of information related to colour dialogs.
"""
def GetChooseFull(self):
"""
GetChooseFull() -> bool
Under Windows, determines whether the Windows colour dialog will
display the full dialog with custom colour selection controls.
"""
def GetColour(self):
"""
GetColour() -> Colour
Gets the current colour associated with the colour dialog.
"""
def GetCustomColour(self, i):
"""
GetCustomColour(i) -> Colour
Returns custom colours associated with the colour dialog.
"""
def SetChooseFull(self, flag):
"""
SetChooseFull(flag)
Under Windows, tells the Windows colour dialog to display the full
dialog with custom colour selection controls.
"""
def SetColour(self, colour):
"""
SetColour(colour)
Sets the default colour for the colour dialog.
"""
def SetCustomColour(self, i, colour):
"""
SetCustomColour(i, colour)
Sets custom colours for the colour dialog.
"""
def ToString(self):
"""
ToString() -> String
Converts the colours saved in this class in a string form, separating
the various colours with a comma.
"""
def FromString(self, str):
"""
FromString(str) -> bool
Decodes the given string, which should be in the same format returned
by ToString(), and sets the internal colours.
"""
ChooseFull = property(None, None)
Colour = property(None, None)
# end of class ColourData
class ColourDialog(Dialog):
"""
ColourDialog(parent, data=None)
This class represents the colour chooser dialog.
"""
def __init__(self, parent, data=None):
"""
ColourDialog(parent, data=None)
This class represents the colour chooser dialog.
"""
def Create(self, parent, data=None):
"""
Create(parent, data=None) -> bool
Same as wxColourDialog().
"""
def GetColourData(self):
"""
GetColourData() -> ColourData
Returns the colour data associated with the colour dialog.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning wxID_OK if the user pressed OK, and
wxID_CANCEL otherwise.
"""
ColourData = property(None, None)
# end of class ColourDialog
def GetColourFromUser(parent, colInit, caption=EmptyString, data=None):
"""
GetColourFromUser(parent, colInit, caption=EmptyString, data=None) -> Colour
Shows the colour selection dialog and returns the colour selected by
user or invalid colour (use wxColour::IsOk() to test whether a colour
is valid) if the dialog was cancelled.
"""
#-- end-colordlg --#
#-- begin-choicdlg --#
CHOICE_WIDTH = 0
CHOICE_HEIGHT = 0
CHOICEDLG_STYLE = 0
class MultiChoiceDialog(Dialog):
"""
MultiChoiceDialog(parent, message, caption, n, choices, style=CHOICEDLG_STYLE, pos=DefaultPosition)
MultiChoiceDialog(parent, message, caption, choices, style=CHOICEDLG_STYLE, pos=DefaultPosition)
This class represents a dialog that shows a list of strings, and
allows the user to select one or more.
"""
def __init__(self, *args, **kw):
"""
MultiChoiceDialog(parent, message, caption, n, choices, style=CHOICEDLG_STYLE, pos=DefaultPosition)
MultiChoiceDialog(parent, message, caption, choices, style=CHOICEDLG_STYLE, pos=DefaultPosition)
This class represents a dialog that shows a list of strings, and
allows the user to select one or more.
"""
def GetSelections(self):
"""
GetSelections() -> ArrayInt
Returns array with indexes of selected items.
"""
def SetSelections(self, selections):
"""
SetSelections(selections)
Sets selected items from the array of selected items' indexes.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning either wxID_OK or wxID_CANCEL.
"""
Selections = property(None, None)
# end of class MultiChoiceDialog
class SingleChoiceDialog(Dialog):
"""
PySingleChoiceDialog(parent, message, caption, choices, style=CHOICEDLG_STYLE, pos=DefaultPosition)
This class represents a dialog that shows a list of strings, and
allows the user to select one.
"""
def __init__(self, *args, **kw):
"""
PySingleChoiceDialog(parent, message, caption, choices, style=CHOICEDLG_STYLE, pos=DefaultPosition)
This class represents a dialog that shows a list of strings, and
allows the user to select one.
"""
def GetSelection(self):
"""
GetSelection() -> int
Returns the index of selected item.
"""
def GetStringSelection(self):
"""
GetStringSelection() -> String
Returns the selected string.
"""
def SetSelection(self, selection):
"""
SetSelection(selection)
Sets the index of the initially selected item.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning either wxID_OK or wxID_CANCEL.
"""
Selection = property(None, None)
StringSelection = property(None, None)
# end of class SingleChoiceDialog
def GetSingleChoice(*args, **kw):
"""
GetSingleChoice(message, caption, aChoices, parent=None, x=DefaultCoord, y=DefaultCoord, centre=True, width=CHOICE_WIDTH, height=CHOICE_HEIGHT, initialSelection=0) -> String
GetSingleChoice(message, caption, choices, initialSelection, parent=None) -> String
Pops up a dialog box containing a message, OK/Cancel buttons and a
single-selection listbox.
"""
#-- end-choicdlg --#
#-- begin-fdrepdlg --#
FR_DOWN = 0
FR_WHOLEWORD = 0
FR_MATCHCASE = 0
FR_REPLACEDIALOG = 0
FR_NOUPDOWN = 0
FR_NOMATCHCASE = 0
FR_NOWHOLEWORD = 0
wxEVT_FIND = 0
wxEVT_FIND_NEXT = 0
wxEVT_FIND_REPLACE = 0
wxEVT_FIND_REPLACE_ALL = 0
wxEVT_FIND_CLOSE = 0
class FindDialogEvent(CommandEvent):
"""
FindDialogEvent(commandType=wxEVT_NULL, id=0)
wxFindReplaceDialog events.
"""
def __init__(self, commandType=wxEVT_NULL, id=0):
"""
FindDialogEvent(commandType=wxEVT_NULL, id=0)
wxFindReplaceDialog events.
"""
def GetDialog(self):
"""
GetDialog() -> FindReplaceDialog
Return the pointer to the dialog which generated this event.
"""
def GetFindString(self):
"""
GetFindString() -> String
Return the string to find (never empty).
"""
def GetFlags(self):
"""
GetFlags() -> int
Get the currently selected flags: this is the combination of the
wxFindReplaceFlags enumeration values.
"""
def GetReplaceString(self):
"""
GetReplaceString() -> String
Return the string to replace the search string with (only for replace
and replace all events).
"""
EVT_FIND = wx.PyEventBinder( wxEVT_FIND, 1 )
EVT_FIND_NEXT = wx.PyEventBinder( wxEVT_FIND_NEXT, 1 )
EVT_FIND_REPLACE = wx.PyEventBinder( wxEVT_FIND_REPLACE, 1 )
EVT_FIND_REPLACE_ALL = wx.PyEventBinder( wxEVT_FIND_REPLACE_ALL, 1 )
EVT_FIND_CLOSE = wx.PyEventBinder( wxEVT_FIND_CLOSE, 1 )
# deprecated wxEVT aliases
wxEVT_COMMAND_FIND = wxEVT_FIND
wxEVT_COMMAND_FIND_NEXT = wxEVT_FIND_NEXT
wxEVT_COMMAND_FIND_REPLACE = wxEVT_FIND_REPLACE
wxEVT_COMMAND_FIND_REPLACE_ALL = wxEVT_FIND_REPLACE_ALL
wxEVT_COMMAND_FIND_CLOSE = wxEVT_FIND_CLOSE
Dialog = property(None, None)
FindString = property(None, None)
Flags = property(None, None)
ReplaceString = property(None, None)
# end of class FindDialogEvent
class FindReplaceData(Object):
"""
FindReplaceData(flags=0)
wxFindReplaceData holds the data for wxFindReplaceDialog.
"""
def __init__(self, flags=0):
"""
FindReplaceData(flags=0)
wxFindReplaceData holds the data for wxFindReplaceDialog.
"""
def GetFindString(self):
"""
GetFindString() -> String
Get the string to find.
"""
def GetFlags(self):
"""
GetFlags() -> int
Get the combination of wxFindReplaceFlags values.
"""
def GetReplaceString(self):
"""
GetReplaceString() -> String
Get the replacement string.
"""
def SetFindString(self, str):
"""
SetFindString(str)
Set the string to find (used as initial value by the dialog).
"""
def SetFlags(self, flags):
"""
SetFlags(flags)
Set the flags to use to initialize the controls of the dialog.
"""
def SetReplaceString(self, str):
"""
SetReplaceString(str)
Set the replacement string (used as initial value by the dialog).
"""
FindString = property(None, None)
Flags = property(None, None)
ReplaceString = property(None, None)
# end of class FindReplaceData
class FindReplaceDialog(Dialog):
"""
FindReplaceDialog()
FindReplaceDialog(parent, data, title=EmptyString, style=0)
wxFindReplaceDialog is a standard modeless dialog which is used to
allow the user to search for some text (and possibly replace it with
something else).
"""
def __init__(self, *args, **kw):
"""
FindReplaceDialog()
FindReplaceDialog(parent, data, title=EmptyString, style=0)
wxFindReplaceDialog is a standard modeless dialog which is used to
allow the user to search for some text (and possibly replace it with
something else).
"""
def Create(self, parent, data, title=EmptyString, style=0):
"""
Create(parent, data, title=EmptyString, style=0) -> bool
Creates the dialog; use wxWindow::Show to show it on screen.
"""
def GetData(self):
"""
GetData() -> FindReplaceData
Get the wxFindReplaceData object used by this dialog.
"""
Data = property(None, None)
# end of class FindReplaceDialog
#-- end-fdrepdlg --#
#-- begin-mdi --#
class MDIClientWindow(Window):
"""
MDIClientWindow()
An MDI client window is a child of wxMDIParentFrame, and manages zero
or more wxMDIChildFrame objects.
"""
def __init__(self):
"""
MDIClientWindow()
An MDI client window is a child of wxMDIParentFrame, and manages zero
or more wxMDIChildFrame objects.
"""
def CreateClient(self, parent, style=0):
"""
CreateClient(parent, style=0) -> bool
Called by wxMDIParentFrame immediately after creating the client
window.
"""
# end of class MDIClientWindow
class MDIParentFrame(Frame):
"""
MDIParentFrame()
MDIParentFrame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE|VSCROLL|HSCROLL, name=FrameNameStr)
An MDI (Multiple Document Interface) parent frame is a window which
can contain MDI child frames in its client area which emulates the
full desktop.
"""
def __init__(self, *args, **kw):
"""
MDIParentFrame()
MDIParentFrame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE|VSCROLL|HSCROLL, name=FrameNameStr)
An MDI (Multiple Document Interface) parent frame is a window which
can contain MDI child frames in its client area which emulates the
full desktop.
"""
def ActivateNext(self):
"""
ActivateNext()
Activates the MDI child following the currently active one.
"""
def ActivatePrevious(self):
"""
ActivatePrevious()
Activates the MDI child preceding the currently active one.
"""
def ArrangeIcons(self):
"""
ArrangeIcons()
Arranges any iconized (minimized) MDI child windows.
"""
def Cascade(self):
"""
Cascade()
Arranges the MDI child windows in a cascade.
"""
def Create(self, parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE|VSCROLL|HSCROLL, name=FrameNameStr):
"""
Create(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE|VSCROLL|HSCROLL, name=FrameNameStr) -> bool
Used in two-step frame construction.
"""
def GetActiveChild(self):
"""
GetActiveChild() -> MDIChildFrame
Returns a pointer to the active MDI child, if there is one.
"""
def GetClientWindow(self):
"""
GetClientWindow() -> MDIClientWindow
Returns a pointer to the client window.
"""
def GetWindowMenu(self):
"""
GetWindowMenu() -> Menu
Returns the current MDI Window menu.
"""
def OnCreateClient(self):
"""
OnCreateClient() -> MDIClientWindow
Override this to return a different kind of client window.
"""
def SetWindowMenu(self, menu):
"""
SetWindowMenu(menu)
Replace the current MDI Window menu.
"""
def Tile(self, orient=HORIZONTAL):
"""
Tile(orient=HORIZONTAL)
Tiles the MDI child windows either horizontally or vertically
depending on whether orient is wxHORIZONTAL or wxVERTICAL.
"""
@staticmethod
def IsTDI():
"""
IsTDI() -> bool
Returns whether the MDI implementation is tab-based.
"""
ActiveChild = property(None, None)
ClientWindow = property(None, None)
WindowMenu = property(None, None)
# end of class MDIParentFrame
class MDIChildFrame(Frame):
"""
MDIChildFrame()
MDIChildFrame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
An MDI child frame is a frame that can only exist inside a
wxMDIClientWindow, which is itself a child of wxMDIParentFrame.
"""
def __init__(self, *args, **kw):
"""
MDIChildFrame()
MDIChildFrame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
An MDI child frame is a frame that can only exist inside a
wxMDIClientWindow, which is itself a child of wxMDIParentFrame.
"""
def Activate(self):
"""
Activate()
Activates this MDI child frame.
"""
def Create(self, parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr):
"""
Create(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr) -> bool
Used in two-step frame construction.
"""
def GetMDIParent(self):
"""
GetMDIParent() -> MDIParentFrame
Returns the MDI parent frame containing this child.
"""
def IsAlwaysMaximized(self):
"""
IsAlwaysMaximized() -> bool
Returns true for MDI children in TDI implementations.
"""
def Maximize(self, maximize=True):
"""
Maximize(maximize=True)
Maximizes this MDI child frame.
"""
def Restore(self):
"""
Restore()
Restores this MDI child frame (unmaximizes).
"""
MDIParent = property(None, None)
# end of class MDIChildFrame
#-- end-mdi --#
#-- begin-fontdlg --#
class FontData(Object):
"""
FontData()
This class holds a variety of information related to font dialogs.
"""
def __init__(self):
"""
FontData()
This class holds a variety of information related to font dialogs.
"""
def EnableEffects(self, enable):
"""
EnableEffects(enable)
Enables or disables "effects" under Windows or generic only.
"""
def GetAllowSymbols(self):
"""
GetAllowSymbols() -> bool
Under Windows, returns a flag determining whether symbol fonts can be
selected.
"""
def GetChosenFont(self):
"""
GetChosenFont() -> Font
Gets the font chosen by the user if the user pressed OK
(wxFontDialog::ShowModal() returned wxID_OK).
"""
def GetColour(self):
"""
GetColour() -> Colour
Gets the colour associated with the font dialog.
"""
def GetEnableEffects(self):
"""
GetEnableEffects() -> bool
Determines whether "effects" are enabled under Windows.
"""
def GetInitialFont(self):
"""
GetInitialFont() -> Font
Gets the font that will be initially used by the font dialog.
"""
def GetShowHelp(self):
"""
GetShowHelp() -> bool
Returns true if the Help button will be shown (Windows only).
"""
def SetAllowSymbols(self, allowSymbols):
"""
SetAllowSymbols(allowSymbols)
Under Windows, determines whether symbol fonts can be selected.
"""
def SetChosenFont(self, font):
"""
SetChosenFont(font)
Sets the font that will be returned to the user (for internal use
only).
"""
def SetColour(self, colour):
"""
SetColour(colour)
Sets the colour that will be used for the font foreground colour.
"""
def SetInitialFont(self, font):
"""
SetInitialFont(font)
Sets the font that will be initially used by the font dialog.
"""
def SetRange(self, min, max):
"""
SetRange(min, max)
Sets the valid range for the font point size (Windows only).
"""
def SetShowHelp(self, showHelp):
"""
SetShowHelp(showHelp)
Determines whether the Help button will be displayed in the font
dialog (Windows only).
"""
AllowSymbols = property(None, None)
ChosenFont = property(None, None)
Colour = property(None, None)
InitialFont = property(None, None)
ShowHelp = property(None, None)
# end of class FontData
class FontDialog(Dialog):
"""
FontDialog()
FontDialog(parent)
FontDialog(parent, data)
This class represents the font chooser dialog.
"""
def __init__(self, *args, **kw):
"""
FontDialog()
FontDialog(parent)
FontDialog(parent, data)
This class represents the font chooser dialog.
"""
def GetFontData(self, *args, **kw):
"""
GetFontData() -> FontData
Returns the font data associated with the font dialog.
"""
def Create(self, *args, **kw):
"""
Create(parent) -> bool
Create(parent, data) -> bool
Creates the dialog if the wxFontDialog object had been initialized
using the default constructor.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning wxID_OK if the user pressed Ok, and
wxID_CANCEL otherwise.
"""
FontData = property(None, None)
# end of class FontDialog
def GetFontFromUser(parent, fontInit, caption=EmptyString):
"""
GetFontFromUser(parent, fontInit, caption=EmptyString) -> Font
Shows the font selection dialog and returns the font selected by user
or invalid font (use wxFont::IsOk() to test whether a font is valid)
if the dialog was cancelled.
"""
#-- end-fontdlg --#
#-- begin-rearrangectrl --#
RearrangeListNameStr = ""
RearrangeDialogNameStr = ""
class RearrangeList(CheckListBox):
"""
RearrangeList()
RearrangeList(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr)
A listbox-like control allowing the user to rearrange the items and to
enable or disable them.
"""
def __init__(self, *args, **kw):
"""
RearrangeList()
RearrangeList(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr)
A listbox-like control allowing the user to rearrange the items and to
enable or disable them.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr) -> bool
Effectively creates the window for an object created using the default
constructor.
"""
def GetCurrentOrder(self):
"""
GetCurrentOrder() -> ArrayInt
Return the current order of the items.
"""
def CanMoveCurrentUp(self):
"""
CanMoveCurrentUp() -> bool
Return true if the currently selected item can be moved up.
"""
def CanMoveCurrentDown(self):
"""
CanMoveCurrentDown() -> bool
Return true if the currently selected item can be moved down.
"""
def MoveCurrentUp(self):
"""
MoveCurrentUp() -> bool
Move the currently selected item one position above.
"""
def MoveCurrentDown(self):
"""
MoveCurrentDown() -> bool
Move the currently selected item one position below.
"""
CurrentOrder = property(None, None)
# end of class RearrangeList
class RearrangeCtrl(Panel):
"""
RearrangeCtrl()
RearrangeCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr)
A composite control containing a wxRearrangeList and the buttons
allowing to move the items in it.
"""
def __init__(self, *args, **kw):
"""
RearrangeCtrl()
RearrangeCtrl(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr)
A composite control containing a wxRearrangeList and the buttons
allowing to move the items in it.
"""
def Create(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr):
"""
Create(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, order=[], items=[], style=0, validator=DefaultValidator, name=RearrangeListNameStr) -> bool
Effectively creates the window for an object created using the default
constructor.
"""
def GetList(self):
"""
GetList() -> RearrangeList
Return the listbox which is the main part of this control.
"""
List = property(None, None)
# end of class RearrangeCtrl
class RearrangeDialog(Dialog):
"""
RearrangeDialog()
RearrangeDialog(parent, message, title=EmptyString, order=[], items=[], pos=DefaultPosition, name=RearrangeDialogNameStr)
A dialog allowing the user to rearrange the specified items.
"""
def __init__(self, *args, **kw):
"""
RearrangeDialog()
RearrangeDialog(parent, message, title=EmptyString, order=[], items=[], pos=DefaultPosition, name=RearrangeDialogNameStr)
A dialog allowing the user to rearrange the specified items.
"""
def Create(self, parent, message, title=EmptyString, order=[], items=[], pos=DefaultPosition, name=RearrangeDialogNameStr):
"""
Create(parent, message, title=EmptyString, order=[], items=[], pos=DefaultPosition, name=RearrangeDialogNameStr) -> bool
Effectively creates the dialog for an object created using the default
constructor.
"""
def AddExtraControls(self, win):
"""
AddExtraControls(win)
Customize the dialog by adding extra controls to it.
"""
def GetList(self):
"""
GetList() -> RearrangeList
Return the list control used by the dialog.
"""
def GetOrder(self):
"""
GetOrder() -> ArrayInt
Return the array describing the order of items after it was modified
by the user.
"""
List = property(None, None)
Order = property(None, None)
# end of class RearrangeDialog
#-- end-rearrangectrl --#
#-- begin-minifram --#
class MiniFrame(Frame):
"""
MiniFrame()
MiniFrame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CAPTION|RESIZE_BORDER, name=FrameNameStr)
A miniframe is a frame with a small title bar.
"""
def __init__(self, *args, **kw):
"""
MiniFrame()
MiniFrame(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CAPTION|RESIZE_BORDER, name=FrameNameStr)
A miniframe is a frame with a small title bar.
"""
def Create(self, parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CAPTION|RESIZE_BORDER, name=FrameNameStr):
"""
Create(parent, id=ID_ANY, title=EmptyString, pos=DefaultPosition, size=DefaultSize, style=CAPTION|RESIZE_BORDER, name=FrameNameStr) -> bool
Used in two-step frame construction.
"""
# end of class MiniFrame
#-- end-minifram --#
#-- begin-textdlg --#
TextEntryDialogStyle = 0
GetTextFromUserPromptStr = ""
GetPasswordFromUserPromptStr = ""
class TextEntryDialog(Dialog):
"""
TextEntryDialog()
TextEntryDialog(parent, message, caption=GetTextFromUserPromptStr, value=EmptyString, style=TextEntryDialogStyle, pos=DefaultPosition)
This class represents a dialog that requests a one-line text string
from the user.
"""
def __init__(self, *args, **kw):
"""
TextEntryDialog()
TextEntryDialog(parent, message, caption=GetTextFromUserPromptStr, value=EmptyString, style=TextEntryDialogStyle, pos=DefaultPosition)
This class represents a dialog that requests a one-line text string
from the user.
"""
def Create(self, parent, message, caption=GetTextFromUserPromptStr, value=EmptyString, style=TextEntryDialogStyle, pos=DefaultPosition):
"""
Create(parent, message, caption=GetTextFromUserPromptStr, value=EmptyString, style=TextEntryDialogStyle, pos=DefaultPosition) -> bool
"""
def GetValue(self):
"""
GetValue() -> String
Returns the text that the user has entered if the user has pressed OK,
or the original value if the user has pressed Cancel.
"""
def SetMaxLength(self, len):
"""
SetMaxLength(len)
This function sets the maximum number of characters the user can enter
into this dialog.
"""
def SetValue(self, value):
"""
SetValue(value)
Sets the default text value.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning wxID_OK if the user pressed OK, and
wxID_CANCEL otherwise.
"""
Value = property(None, None)
# end of class TextEntryDialog
class PasswordEntryDialog(TextEntryDialog):
"""
PasswordEntryDialog(parent, message, caption=GetPasswordFromUserPromptStr, defaultValue=EmptyString, style=TextEntryDialogStyle, pos=DefaultPosition)
This class represents a dialog that requests a one-line password
string from the user.
"""
def __init__(self, parent, message, caption=GetPasswordFromUserPromptStr, defaultValue=EmptyString, style=TextEntryDialogStyle, pos=DefaultPosition):
"""
PasswordEntryDialog(parent, message, caption=GetPasswordFromUserPromptStr, defaultValue=EmptyString, style=TextEntryDialogStyle, pos=DefaultPosition)
This class represents a dialog that requests a one-line password
string from the user.
"""
# end of class PasswordEntryDialog
def GetTextFromUser(message, caption=GetTextFromUserPromptStr, default_value=EmptyString, parent=None, x=DefaultCoord, y=DefaultCoord, centre=True):
"""
GetTextFromUser(message, caption=GetTextFromUserPromptStr, default_value=EmptyString, parent=None, x=DefaultCoord, y=DefaultCoord, centre=True) -> String
Pop up a dialog box with title set to caption, message, and a
default_value.
"""
def GetPasswordFromUser(message, caption=GetPasswordFromUserPromptStr, default_value=EmptyString, parent=None, x=DefaultCoord, y=DefaultCoord, centre=True):
"""
GetPasswordFromUser(message, caption=GetPasswordFromUserPromptStr, default_value=EmptyString, parent=None, x=DefaultCoord, y=DefaultCoord, centre=True) -> String
Similar to wxGetTextFromUser() but the text entered in the dialog is
not shown on screen but replaced with stars.
"""
#-- end-textdlg --#
#-- begin-power --#
POWER_SOCKET = 0
POWER_BATTERY = 0
POWER_UNKNOWN = 0
BATTERY_NORMAL_STATE = 0
BATTERY_LOW_STATE = 0
BATTERY_CRITICAL_STATE = 0
BATTERY_SHUTDOWN_STATE = 0
BATTERY_UNKNOWN_STATE = 0
wxEVT_POWER_SUSPENDING = 0
wxEVT_POWER_SUSPENDED = 0
wxEVT_POWER_SUSPEND_CANCEL = 0
wxEVT_POWER_RESUME = 0
class PowerEvent(Event):
"""
PowerEvent()
PowerEvent(evtType)
The power events are generated when the system power state changes,
e.g.
"""
def __init__(self, *args, **kw):
"""
PowerEvent()
PowerEvent(evtType)
The power events are generated when the system power state changes,
e.g.
"""
def Veto(self):
"""
Veto()
Call this to prevent suspend from taking place in
wxEVT_POWER_SUSPENDING handler (it is ignored for all the others).
"""
def IsVetoed(self):
"""
IsVetoed() -> bool
Returns whether Veto has been called.
"""
EVT_POWER_SUSPENDING = wx.PyEventBinder( wxEVT_POWER_SUSPENDING , 1 )
EVT_POWER_SUSPENDED = wx.PyEventBinder( wxEVT_POWER_SUSPENDED , 1 )
EVT_POWER_SUSPEND_CANCEL = wx.PyEventBinder( wxEVT_POWER_SUSPEND_CANCEL , 1 )
EVT_POWER_RESUME = wx.PyEventBinder( wxEVT_POWER_RESUME , 1 )
# end of class PowerEvent
#-- end-power --#
#-- begin-utils --#
SIGNONE = 0
SIGHUP = 0
SIGINT = 0
SIGQUIT = 0
SIGILL = 0
SIGTRAP = 0
SIGABRT = 0
SIGEMT = 0
SIGFPE = 0
SIGKILL = 0
SIGBUS = 0
SIGSEGV = 0
SIGSYS = 0
SIGPIPE = 0
SIGALRM = 0
SIGTERM = 0
KILL_OK = 0
KILL_BAD_SIGNAL = 0
KILL_ACCESS_DENIED = 0
KILL_NO_PROCESS = 0
KILL_ERROR = 0
KILL_NOCHILDREN = 0
KILL_CHILDREN = 0
SHUTDOWN_FORCE = 0
SHUTDOWN_POWEROFF = 0
SHUTDOWN_REBOOT = 0
SHUTDOWN_LOGOFF = 0
Strip_Mnemonics = 0
Strip_Accel = 0
Strip_All = 0
EXEC_ASYNC = 0
EXEC_SYNC = 0
EXEC_SHOW_CONSOLE = 0
EXEC_MAKE_GROUP_LEADER = 0
EXEC_NODISABLE = 0
EXEC_NOEVENTS = 0
EXEC_HIDE_CONSOLE = 0
EXEC_BLOCK = 0
def BeginBusyCursor(cursor=HOURGLASS_CURSOR):
"""
BeginBusyCursor(cursor=HOURGLASS_CURSOR)
Changes the cursor to the given cursor for all windows in the
application.
"""
def EndBusyCursor():
"""
EndBusyCursor()
Changes the cursor back to the original cursor, for all windows in the
application.
"""
def IsBusy():
"""
IsBusy() -> bool
Returns true if between two wxBeginBusyCursor() and wxEndBusyCursor()
calls.
"""
def Bell():
"""
Bell()
Ring the system bell.
"""
def InfoMessageBox(parent):
"""
InfoMessageBox(parent)
Shows a message box with the information about the wxWidgets build
used, including its version, most important build parameters and the
version of the underlying GUI toolkit.
"""
def GetLibraryVersionInfo():
"""
GetLibraryVersionInfo() -> VersionInfo
Get wxWidgets version information.
"""
def GetBatteryState():
"""
GetBatteryState() -> BatteryState
Returns battery state as one of wxBATTERY_NORMAL_STATE,
wxBATTERY_LOW_STATE, wxBATTERY_CRITICAL_STATE,
wxBATTERY_SHUTDOWN_STATE or wxBATTERY_UNKNOWN_STATE.
"""
def GetPowerType():
"""
GetPowerType() -> PowerType
Returns the type of power source as one of wxPOWER_SOCKET,
wxPOWER_BATTERY or wxPOWER_UNKNOWN.
"""
def GetKeyState(key):
"""
GetKeyState(key) -> bool
For normal keys, returns true if the specified key is currently down.
"""
def GetMousePosition():
"""
GetMousePosition() -> Point
Returns the mouse position in screen coordinates.
"""
def GetMouseState():
"""
GetMouseState() -> MouseState
Returns the current state of the mouse.
"""
def EnableTopLevelWindows(enable=True):
"""
EnableTopLevelWindows(enable=True)
This function enables or disables all top level windows.
"""
def FindWindowAtPoint(pt):
"""
FindWindowAtPoint(pt) -> Window
Find the deepest window at the given mouse position in screen
coordinates, returning the window if found, or NULL if not.
"""
def FindWindowByLabel(label, parent=None):
"""
FindWindowByLabel(label, parent=None) -> Window
"""
def FindWindowByName(name, parent=None):
"""
FindWindowByName(name, parent=None) -> Window
"""
def FindMenuItemId(frame, menuString, itemString):
"""
FindMenuItemId(frame, menuString, itemString) -> int
Find a menu item identifier associated with the given frame's menu
bar.
"""
def NewId():
"""
NewId() -> int
"""
def RegisterId(id):
"""
RegisterId(id)
Ensures that Ids subsequently generated by wxNewId() do not clash with
the given id.
"""
def LaunchDefaultApplication(document, flags=0):
"""
LaunchDefaultApplication(document, flags=0) -> bool
Opens the document in the application associated with the files of
this type.
"""
def LaunchDefaultBrowser(url, flags=0):
"""
LaunchDefaultBrowser(url, flags=0) -> bool
Opens the url in user's default browser.
"""
def StripMenuCodes(str, flags=Strip_All):
"""
StripMenuCodes(str, flags=Strip_All) -> String
Strips any menu codes from str and returns the result.
"""
def GetEmailAddress(*args, **kw):
"""
GetEmailAddress() -> String
Copies the user's email address into the supplied buffer, by
concatenating the values returned by wxGetFullHostName() and
wxGetUserId().
"""
def GetHomeDir():
"""
GetHomeDir() -> String
Return the (current) user's home directory.
"""
def GetHostName(*args, **kw):
"""
GetHostName() -> String
Copies the current host machine's name into the supplied buffer.
"""
def GetFullHostName():
"""
GetFullHostName() -> String
Returns the FQDN (fully qualified domain host name) or an empty string
on error.
"""
def GetUserHome(user=EmptyString):
"""
GetUserHome(user=EmptyString) -> String
Returns the home directory for the given user.
"""
def GetUserId(*args, **kw):
"""
GetUserId() -> String
This function returns the "user id" also known as "login name" under
Unix (i.e.
"""
def GetUserName(*args, **kw):
"""
GetUserName() -> String
This function returns the full user name (something like "Mr. John
Smith").
"""
def GetOsDescription():
"""
GetOsDescription() -> String
Returns the string containing the description of the current platform
in a user-readable form.
"""
def GetOsVersion():
"""
GetOsVersion() -> (OperatingSystemId, major, minor)
Gets the version and the operating system ID for currently running OS.
"""
def IsPlatform64Bit():
"""
IsPlatform64Bit() -> bool
Returns true if the operating system the program is running under is
64 bit.
"""
def IsPlatformLittleEndian():
"""
IsPlatformLittleEndian() -> bool
Returns true if the current platform is little endian (instead of big
endian).
"""
def Execute(command, flags=EXEC_ASYNC, callback=None, env=None):
"""
Execute(command, flags=EXEC_ASYNC, callback=None, env=None) -> long
Executes another program in Unix or Windows.
"""
def GetProcessId():
"""
GetProcessId() -> unsignedlong
Returns the number uniquely identifying the current process in the
system.
"""
def Kill(pid, sig=SIGTERM, rc=None, flags=KILL_NOCHILDREN):
"""
Kill(pid, sig=SIGTERM, rc=None, flags=KILL_NOCHILDREN) -> int
Equivalent to the Unix kill function: send the given signal sig to the
process with PID pid.
"""
def Shell(command=EmptyString):
"""
Shell(command=EmptyString) -> bool
Executes a command in an interactive shell window.
"""
def Shutdown(flags=SHUTDOWN_POWEROFF):
"""
Shutdown(flags=SHUTDOWN_POWEROFF) -> bool
This function shuts down or reboots the computer depending on the
value of the flags.
"""
def MicroSleep(microseconds):
"""
MicroSleep(microseconds)
Sleeps for the specified number of microseconds.
"""
def MilliSleep(milliseconds):
"""
MilliSleep(milliseconds)
Sleeps for the specified number of milliseconds.
"""
def Now():
"""
Now() -> String
Returns a string representing the current date and time.
"""
def Sleep(secs):
"""
Sleep(secs)
Sleeps for the specified number of seconds.
"""
def Usleep(milliseconds):
"""
Usleep(milliseconds)
"""
class WindowDisabler(object):
"""
WindowDisabler(disable=True)
WindowDisabler(winToSkip)
This class disables all windows of the application (may be with the
exception of one of them) in its constructor and enables them back in
its destructor.
"""
def __init__(self, *args, **kw):
"""
WindowDisabler(disable=True)
WindowDisabler(winToSkip)
This class disables all windows of the application (may be with the
exception of one of them) in its constructor and enables them back in
its destructor.
"""
# end of class WindowDisabler
class BusyCursor(object):
"""
BusyCursor(cursor=HOURGLASS_CURSOR)
This class makes it easy to tell your user that the program is
temporarily busy.
"""
def __init__(self, cursor=HOURGLASS_CURSOR):
"""
BusyCursor(cursor=HOURGLASS_CURSOR)
This class makes it easy to tell your user that the program is
temporarily busy.
"""
# end of class BusyCursor
class VersionInfo(object):
"""
VersionInfo(name="", major=0, minor=0, micro=0, description="", copyright="")
wxVersionInfo contains version information.
"""
def __init__(self, name="", major=0, minor=0, micro=0, description="", copyright=""):
"""
VersionInfo(name="", major=0, minor=0, micro=0, description="", copyright="")
wxVersionInfo contains version information.
"""
def GetName(self):
"""
GetName() -> String
Get the name of the object (library).
"""
def GetMajor(self):
"""
GetMajor() -> int
Get the major version number.
"""
def GetMinor(self):
"""
GetMinor() -> int
Get the minor version number.
"""
def GetMicro(self):
"""
GetMicro() -> int
Get the micro version, or release number.
"""
def ToString(self):
"""
ToString() -> String
Get the string representation of this version object.
"""
def GetVersionString(self):
"""
GetVersionString() -> String
Get the string representation.
"""
def HasDescription(self):
"""
HasDescription() -> bool
Return true if a description string has been specified.
"""
def GetDescription(self):
"""
GetDescription() -> String
Get the description string.
"""
def HasCopyright(self):
"""
HasCopyright() -> bool
Returns true if a copyright string has been specified.
"""
def GetCopyright(self):
"""
GetCopyright() -> String
Get the copyright string.
"""
Copyright = property(None, None)
Description = property(None, None)
Major = property(None, None)
Micro = property(None, None)
Minor = property(None, None)
Name = property(None, None)
VersionString = property(None, None)
# end of class VersionInfo
#-- end-utils --#
#-- begin-process --#
wxEVT_END_PROCESS = 0
class Process(EvtHandler):
"""
Process(parent=None, id=-1)
Process(flags)
The objects of this class are used in conjunction with the wxExecute()
function.
"""
def __init__(self, *args, **kw):
"""
Process(parent=None, id=-1)
Process(flags)
The objects of this class are used in conjunction with the wxExecute()
function.
"""
def CloseOutput(self):
"""
CloseOutput()
Closes the output stream (the one connected to the stdin of the child
process).
"""
def Detach(self):
"""
Detach()
Detaches this event handler from the parent specified in the
constructor (see wxEvtHandler::Unlink() for a similar but not
identical function).
"""
def GetErrorStream(self):
"""
GetErrorStream() -> InputStream
Returns an input stream which corresponds to the standard error output
(stderr) of the child process.
"""
def GetInputStream(self):
"""
GetInputStream() -> InputStream
It returns an input stream corresponding to the standard output stream
of the subprocess.
"""
def GetOutputStream(self):
"""
GetOutputStream() -> OutputStream
It returns an output stream corresponding to the input stream of the
subprocess.
"""
def GetPid(self):
"""
GetPid() -> long
Returns the process ID of the process launched by Open() or set by
wxExecute() (if you passed this wxProcess as argument).
"""
def IsErrorAvailable(self):
"""
IsErrorAvailable() -> bool
Returns true if there is data to be read on the child process standard
error stream.
"""
def IsInputAvailable(self):
"""
IsInputAvailable() -> bool
Returns true if there is data to be read on the child process standard
output stream.
"""
def IsInputOpened(self):
"""
IsInputOpened() -> bool
Returns true if the child process standard output stream is opened.
"""
def OnTerminate(self, pid, status):
"""
OnTerminate(pid, status)
It is called when the process with the pid pid finishes.
"""
def Redirect(self):
"""
Redirect()
Turns on redirection.
"""
def SetPriority(self, priority):
"""
SetPriority(priority)
Sets the priority of the process, between 0 (lowest) and 100
(highest).
"""
@staticmethod
def Exists(pid):
"""
Exists(pid) -> bool
Returns true if the given process exists in the system.
"""
@staticmethod
def Kill(pid, sig=SIGTERM, flags=KILL_NOCHILDREN):
"""
Kill(pid, sig=SIGTERM, flags=KILL_NOCHILDREN) -> KillError
Send the specified signal to the given process.
"""
@staticmethod
def Open(cmd, flags=EXEC_ASYNC):
"""
Open(cmd, flags=EXEC_ASYNC) -> Process
This static method replaces the standard popen() function: it launches
the process specified by the cmd parameter and returns the wxProcess
object which can be used to retrieve the streams connected to the
standard input, output and error output of the child process.
"""
ErrorStream = property(None, None)
InputStream = property(None, None)
OutputStream = property(None, None)
Pid = property(None, None)
# end of class Process
class ProcessEvent(Event):
"""
ProcessEvent(id=0, pid=0, exitcode=0)
A process event is sent to the wxEvtHandler specified to wxProcess
when a process is terminated.
"""
def __init__(self, id=0, pid=0, exitcode=0):
"""
ProcessEvent(id=0, pid=0, exitcode=0)
A process event is sent to the wxEvtHandler specified to wxProcess
when a process is terminated.
"""
def GetExitCode(self):
"""
GetExitCode() -> int
Returns the exist status.
"""
def GetPid(self):
"""
GetPid() -> int
Returns the process id.
"""
ExitCode = property(None, None)
Pid = property(None, None)
# end of class ProcessEvent
EVT_END_PROCESS = wx.PyEventBinder( wxEVT_END_PROCESS )
#-- end-process --#
#-- begin-uiaction --#
class UIActionSimulator(object):
"""
UIActionSimulator()
wxUIActionSimulator is a class used to simulate user interface actions
such as a mouse click or a key press.
"""
def __init__(self):
"""
UIActionSimulator()
wxUIActionSimulator is a class used to simulate user interface actions
such as a mouse click or a key press.
"""
def MouseMove(self, *args, **kw):
"""
MouseMove(x, y) -> bool
MouseMove(point) -> bool
Move the mouse to the specified coordinates.
"""
def MouseDown(self, button=MOUSE_BTN_LEFT):
"""
MouseDown(button=MOUSE_BTN_LEFT) -> bool
Press a mouse button.
"""
def MouseUp(self, button=MOUSE_BTN_LEFT):
"""
MouseUp(button=MOUSE_BTN_LEFT) -> bool
Release a mouse button.
"""
def MouseClick(self, button=MOUSE_BTN_LEFT):
"""
MouseClick(button=MOUSE_BTN_LEFT) -> bool
Click a mouse button.
"""
def MouseDblClick(self, button=MOUSE_BTN_LEFT):
"""
MouseDblClick(button=MOUSE_BTN_LEFT) -> bool
Double-click a mouse button.
"""
def MouseDragDrop(self, x1, y1, x2, y2, button=MOUSE_BTN_LEFT):
"""
MouseDragDrop(x1, y1, x2, y2, button=MOUSE_BTN_LEFT) -> bool
Perform a drag and drop operation.
"""
def KeyDown(self, keycode, modifiers=MOD_NONE):
"""
KeyDown(keycode, modifiers=MOD_NONE) -> bool
Press a key.
"""
def KeyUp(self, keycode, modifiers=MOD_NONE):
"""
KeyUp(keycode, modifiers=MOD_NONE) -> bool
Release a key.
"""
def Char(self, keycode, modifiers=MOD_NONE):
"""
Char(keycode, modifiers=MOD_NONE) -> bool
Press and release a key.
"""
def Text(self, text):
"""
Text(text) -> bool
Emulate typing in the keys representing the given string.
"""
# end of class UIActionSimulator
#-- end-uiaction --#
#-- begin-snglinst --#
class SingleInstanceChecker(object):
"""
SingleInstanceChecker()
SingleInstanceChecker(name, path=EmptyString)
wxSingleInstanceChecker class allows to check that only a single
instance of a program is running.
"""
def __init__(self, *args, **kw):
"""
SingleInstanceChecker()
SingleInstanceChecker(name, path=EmptyString)
wxSingleInstanceChecker class allows to check that only a single
instance of a program is running.
"""
def Create(self, name, path=EmptyString):
"""
Create(name, path=EmptyString) -> bool
Initialize the object if it had been created using the default
constructor.
"""
def CreateDefault(self):
"""
CreateDefault() -> bool
Calls Create() with default name.
"""
def IsAnotherRunning(self):
"""
IsAnotherRunning() -> bool
Returns true if another copy of this program is already running and
false otherwise.
"""
# end of class SingleInstanceChecker
#-- end-snglinst --#
#-- begin-help --#
HELP_NETSCAPE = 0
HELP_SEARCH_INDEX = 0
HELP_SEARCH_ALL = 0
class HelpControllerBase(Object):
"""
HelpControllerBase(parentWindow=None)
This is the abstract base class a family of classes by which
applications may invoke a help viewer to provide on-line help.
"""
def __init__(self, parentWindow=None):
"""
HelpControllerBase(parentWindow=None)
This is the abstract base class a family of classes by which
applications may invoke a help viewer to provide on-line help.
"""
def Initialize(self, *args, **kw):
"""
Initialize(file) -> bool
Initialize(file, server) -> bool
Initializes the help instance with a help filename, and optionally a
server socket number if using wxHelp (now obsolete).
"""
def DisplayBlock(self, blockNo):
"""
DisplayBlock(blockNo) -> bool
If the help viewer is not running, runs it and displays the file at
the given block number.
"""
def DisplayContents(self):
"""
DisplayContents() -> bool
If the help viewer is not running, runs it and displays the contents.
"""
def DisplayContextPopup(self, contextId):
"""
DisplayContextPopup(contextId) -> bool
Displays the section as a popup window using a context id.
"""
def DisplaySection(self, *args, **kw):
"""
DisplaySection(section) -> bool
DisplaySection(sectionNo) -> bool
If the help viewer is not running, runs it and displays the given
section.
"""
def DisplayTextPopup(self, text, pos):
"""
DisplayTextPopup(text, pos) -> bool
Displays the text in a popup window, if possible.
"""
def GetFrameParameters(self):
"""
GetFrameParameters() -> (Frame, size, pos, newFrameEachTime)
For wxHtmlHelpController, returns the latest frame size and position
settings and whether a new frame is drawn with each invocation.
"""
def GetParentWindow(self):
"""
GetParentWindow() -> Window
Returns the window to be used as the parent for the help window.
"""
def KeywordSearch(self, keyWord, mode=HELP_SEARCH_ALL):
"""
KeywordSearch(keyWord, mode=HELP_SEARCH_ALL) -> bool
If the help viewer is not running, runs it, and searches for sections
matching the given keyword.
"""
def LoadFile(self, file=EmptyString):
"""
LoadFile(file=EmptyString) -> bool
If the help viewer is not running, runs it and loads the given file.
"""
def OnQuit(self):
"""
OnQuit()
Overridable member called when this application's viewer is quit by
the user.
"""
def Quit(self):
"""
Quit() -> bool
If the viewer is running, quits it by disconnecting.
"""
def SetFrameParameters(self, titleFormat, size, pos=DefaultPosition, newFrameEachTime=False):
"""
SetFrameParameters(titleFormat, size, pos=DefaultPosition, newFrameEachTime=False)
Set the parameters of the frame window.
"""
def SetParentWindow(self, parentWindow):
"""
SetParentWindow(parentWindow)
Sets the window to be used as the parent for the help window.
"""
def SetViewer(self, viewer, flags=HELP_NETSCAPE):
"""
SetViewer(viewer, flags=HELP_NETSCAPE)
Sets detailed viewer information.
"""
FrameParameters = property(None, None)
ParentWindow = property(None, None)
# end of class HelpControllerBase
#-- end-help --#
#-- begin-cshelp --#
class HelpProvider(object):
"""
wxHelpProvider is an abstract class used by a program implementing
context-sensitive help to show the help text for the given window.
"""
def AddHelp(self, *args, **kw):
"""
AddHelp(window, text)
AddHelp(id, text)
Associates the text with the given window.
"""
def GetHelp(self, window):
"""
GetHelp(window) -> String
This version associates the given text with all windows with this id.
"""
def RemoveHelp(self, window):
"""
RemoveHelp(window)
Removes the association between the window pointer and the help text.
"""
def ShowHelp(self, window):
"""
ShowHelp(window) -> bool
Shows help for the given window.
"""
def ShowHelpAtPoint(self, window, point, origin):
"""
ShowHelpAtPoint(window, point, origin) -> bool
This function may be overridden to show help for the window when it
should depend on the position inside the window, By default this
method forwards to ShowHelp(), so it is enough to only implement the
latter if the help doesn't depend on the position.
"""
@staticmethod
def Get():
"""
Get() -> HelpProvider
Returns pointer to help provider instance.
"""
@staticmethod
def Set(helpProvider):
"""
Set(helpProvider) -> HelpProvider
Set the current, application-wide help provider.
"""
# end of class HelpProvider
class SimpleHelpProvider(HelpProvider):
"""
wxSimpleHelpProvider is an implementation of wxHelpProvider which
supports only plain text help strings, and shows the string associated
with the control (if any) in a tooltip.
"""
# end of class SimpleHelpProvider
class HelpControllerHelpProvider(SimpleHelpProvider):
"""
HelpControllerHelpProvider(hc=None)
wxHelpControllerHelpProvider is an implementation of wxHelpProvider
which supports both context identifiers and plain text help strings.
"""
def __init__(self, hc=None):
"""
HelpControllerHelpProvider(hc=None)
wxHelpControllerHelpProvider is an implementation of wxHelpProvider
which supports both context identifiers and plain text help strings.
"""
def GetHelpController(self):
"""
GetHelpController() -> HelpControllerBase
Returns the help controller associated with this help provider.
"""
def SetHelpController(self, hc):
"""
SetHelpController(hc)
Sets the help controller associated with this help provider.
"""
HelpController = property(None, None)
# end of class HelpControllerHelpProvider
class ContextHelp(Object):
"""
ContextHelp(window=None, doNow=True)
This class changes the cursor to a query and puts the application into
a 'context-sensitive help mode'.
"""
def __init__(self, window=None, doNow=True):
"""
ContextHelp(window=None, doNow=True)
This class changes the cursor to a query and puts the application into
a 'context-sensitive help mode'.
"""
def BeginContextHelp(self, window):
"""
BeginContextHelp(window) -> bool
Puts the application into context-sensitive help mode.
"""
def EndContextHelp(self):
"""
EndContextHelp() -> bool
Ends context-sensitive help mode.
"""
# end of class ContextHelp
class ContextHelpButton(BitmapButton):
"""
ContextHelpButton(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=BU_AUTODRAW)
Instances of this class may be used to add a question mark button that
when pressed, puts the application into context-help mode.
"""
def __init__(self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=BU_AUTODRAW):
"""
ContextHelpButton(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=BU_AUTODRAW)
Instances of this class may be used to add a question mark button that
when pressed, puts the application into context-help mode.
"""
# end of class ContextHelpButton
#-- end-cshelp --#
#-- begin-settings --#
SYS_OEM_FIXED_FONT = 0
SYS_ANSI_FIXED_FONT = 0
SYS_ANSI_VAR_FONT = 0
SYS_SYSTEM_FONT = 0
SYS_DEVICE_DEFAULT_FONT = 0
SYS_DEFAULT_GUI_FONT = 0
SYS_COLOUR_SCROLLBAR = 0
SYS_COLOUR_DESKTOP = 0
SYS_COLOUR_ACTIVECAPTION = 0
SYS_COLOUR_INACTIVECAPTION = 0
SYS_COLOUR_MENU = 0
SYS_COLOUR_WINDOW = 0
SYS_COLOUR_WINDOWFRAME = 0
SYS_COLOUR_MENUTEXT = 0
SYS_COLOUR_WINDOWTEXT = 0
SYS_COLOUR_CAPTIONTEXT = 0
SYS_COLOUR_ACTIVEBORDER = 0
SYS_COLOUR_INACTIVEBORDER = 0
SYS_COLOUR_APPWORKSPACE = 0
SYS_COLOUR_HIGHLIGHT = 0
SYS_COLOUR_HIGHLIGHTTEXT = 0
SYS_COLOUR_BTNFACE = 0
SYS_COLOUR_BTNSHADOW = 0
SYS_COLOUR_GRAYTEXT = 0
SYS_COLOUR_BTNTEXT = 0
SYS_COLOUR_INACTIVECAPTIONTEXT = 0
SYS_COLOUR_BTNHIGHLIGHT = 0
SYS_COLOUR_3DDKSHADOW = 0
SYS_COLOUR_3DLIGHT = 0
SYS_COLOUR_INFOTEXT = 0
SYS_COLOUR_INFOBK = 0
SYS_COLOUR_LISTBOX = 0
SYS_COLOUR_HOTLIGHT = 0
SYS_COLOUR_GRADIENTACTIVECAPTION = 0
SYS_COLOUR_GRADIENTINACTIVECAPTION = 0
SYS_COLOUR_MENUHILIGHT = 0
SYS_COLOUR_MENUBAR = 0
SYS_COLOUR_LISTBOXTEXT = 0
SYS_COLOUR_LISTBOXHIGHLIGHTTEXT = 0
SYS_COLOUR_BACKGROUND = 0
SYS_COLOUR_3DFACE = 0
SYS_COLOUR_3DSHADOW = 0
SYS_COLOUR_BTNHILIGHT = 0
SYS_COLOUR_3DHIGHLIGHT = 0
SYS_COLOUR_3DHILIGHT = 0
SYS_COLOUR_FRAMEBK = 0
SYS_MOUSE_BUTTONS = 0
SYS_BORDER_X = 0
SYS_BORDER_Y = 0
SYS_CURSOR_X = 0
SYS_CURSOR_Y = 0
SYS_DCLICK_X = 0
SYS_DCLICK_Y = 0
SYS_DRAG_X = 0
SYS_DRAG_Y = 0
SYS_EDGE_X = 0
SYS_EDGE_Y = 0
SYS_HSCROLL_ARROW_X = 0
SYS_HSCROLL_ARROW_Y = 0
SYS_HTHUMB_X = 0
SYS_ICON_X = 0
SYS_ICON_Y = 0
SYS_ICONSPACING_X = 0
SYS_ICONSPACING_Y = 0
SYS_WINDOWMIN_X = 0
SYS_WINDOWMIN_Y = 0
SYS_SCREEN_X = 0
SYS_SCREEN_Y = 0
SYS_FRAMESIZE_X = 0
SYS_FRAMESIZE_Y = 0
SYS_SMALLICON_X = 0
SYS_SMALLICON_Y = 0
SYS_HSCROLL_Y = 0
SYS_VSCROLL_X = 0
SYS_VSCROLL_ARROW_X = 0
SYS_VSCROLL_ARROW_Y = 0
SYS_VTHUMB_Y = 0
SYS_CAPTION_Y = 0
SYS_MENU_Y = 0
SYS_NETWORK_PRESENT = 0
SYS_PENWINDOWS_PRESENT = 0
SYS_SHOW_SOUNDS = 0
SYS_SWAP_BUTTONS = 0
SYS_DCLICK_MSEC = 0
SYS_CAN_DRAW_FRAME_DECORATIONS = 0
SYS_CAN_ICONIZE_FRAME = 0
SYS_TABLET_PRESENT = 0
SYS_SCREEN_NONE = 0
SYS_SCREEN_TINY = 0
SYS_SCREEN_PDA = 0
SYS_SCREEN_SMALL = 0
SYS_SCREEN_DESKTOP = 0
class SystemSettings(Object):
"""
SystemSettings()
wxSystemSettings allows the application to ask for details about the
system.
"""
def __init__(self):
"""
SystemSettings()
wxSystemSettings allows the application to ask for details about the
system.
"""
@staticmethod
def GetColour(index):
"""
GetColour(index) -> Colour
Returns a system colour.
"""
@staticmethod
def GetFont(index):
"""
GetFont(index) -> Font
Returns a system font.
"""
@staticmethod
def GetMetric(index, win=None):
"""
GetMetric(index, win=None) -> int
Returns the value of a system metric, or -1 if the metric is not
supported on the current system.
"""
@staticmethod
def GetScreenType():
"""
GetScreenType() -> SystemScreenType
Returns the screen type.
"""
@staticmethod
def HasFeature(index):
"""
HasFeature(index) -> bool
Returns true if the port has certain feature.
"""
# end of class SystemSettings
#-- end-settings --#
#-- begin-sysopt --#
class SystemOptions(Object):
"""
SystemOptions()
wxSystemOptions stores option/value pairs that wxWidgets itself or
applications can use to alter behaviour at run-time.
"""
def __init__(self):
"""
SystemOptions()
wxSystemOptions stores option/value pairs that wxWidgets itself or
applications can use to alter behaviour at run-time.
"""
@staticmethod
def SetOption(*args, **kw):
"""
SetOption(name, value)
SetOption(name, value)
Sets an option.
"""
@staticmethod
def GetOption(name):
"""
GetOption(name) -> String
Gets an option.
"""
@staticmethod
def GetOptionInt(name):
"""
GetOptionInt(name) -> int
Gets an option as an integer.
"""
@staticmethod
def HasOption(name):
"""
HasOption(name) -> bool
Returns true if the given option is present.
"""
@staticmethod
def IsFalse(name):
"""
IsFalse(name) -> bool
Returns true if the option with the given name had been set to 0
value.
"""
# end of class SystemOptions
#-- end-sysopt --#
#-- begin-artprov --#
ART_FIND_AND_REPLACE = ""
ART_FIND = ""
ART_QUIT = ""
ART_CLOSE = ""
ART_MINUS = ""
ART_PLUS = ""
ART_REDO = ""
ART_UNDO = ""
ART_NEW = ""
ART_DELETE = ""
ART_PASTE = ""
ART_CUT = ""
ART_COPY = ""
ART_MISSING_IMAGE = ""
ART_INFORMATION = ""
ART_WARNING = ""
ART_QUESTION = ""
ART_ERROR = ""
ART_CROSS_MARK = ""
ART_TICK_MARK = ""
ART_NORMAL_FILE = ""
ART_EXECUTABLE_FILE = ""
ART_GO_DIR_UP = ""
ART_FOLDER_OPEN = ""
ART_FOLDER = ""
ART_REMOVABLE = ""
ART_CDROM = ""
ART_FLOPPY = ""
ART_HARDDISK = ""
ART_NEW_DIR = ""
ART_LIST_VIEW = ""
ART_REPORT_VIEW = ""
ART_TIP = ""
ART_HELP = ""
ART_PRINT = ""
ART_FILE_SAVE_AS = ""
ART_FILE_SAVE = ""
ART_FILE_OPEN = ""
ART_GOTO_LAST = ""
ART_GOTO_FIRST = ""
ART_GO_HOME = ""
ART_GO_TO_PARENT = ""
ART_GO_DOWN = ""
ART_GO_UP = ""
ART_GO_FORWARD = ""
ART_GO_BACK = ""
ART_HELP_PAGE = ""
ART_HELP_FOLDER = ""
ART_HELP_BOOK = ""
ART_HELP_SETTINGS = ""
ART_HELP_SIDE_PANEL = ""
ART_DEL_BOOKMARK = ""
ART_ADD_BOOKMARK = ""
ART_OTHER = ""
ART_LIST = ""
ART_BUTTON = ""
ART_MESSAGE_BOX = ""
ART_HELP_BROWSER = ""
ART_CMN_DIALOG = ""
ART_FRAME_ICON = ""
ART_MENU = ""
ART_TOOLBAR = ""
class ArtProvider(Object):
"""
wxArtProvider class is used to customize the look of wxWidgets
application.
"""
@staticmethod
def Delete(provider):
"""
Delete(provider) -> bool
Delete the given provider.
"""
@staticmethod
def GetBitmap(id, client=ART_OTHER, size=DefaultSize):
"""
GetBitmap(id, client=ART_OTHER, size=DefaultSize) -> Bitmap
Query registered providers for bitmap with given ID.
"""
@staticmethod
def GetIcon(id, client=ART_OTHER, size=DefaultSize):
"""
GetIcon(id, client=ART_OTHER, size=DefaultSize) -> Icon
Same as wxArtProvider::GetBitmap, but return a wxIcon object (or
wxNullIcon on failure).
"""
@staticmethod
def GetNativeSizeHint(client):
"""
GetNativeSizeHint(client) -> Size
Returns native icon size for use specified by client hint.
"""
@staticmethod
def GetSizeHint(client, platform_default=False):
"""
GetSizeHint(client, platform_default=False) -> Size
Returns a suitable size hint for the given wxArtClient.
"""
@staticmethod
def GetIconBundle(id, client=ART_OTHER):
"""
GetIconBundle(id, client=ART_OTHER) -> IconBundle
Query registered providers for icon bundle with given ID.
"""
@staticmethod
def HasNativeProvider():
"""
HasNativeProvider() -> bool
Returns true if the platform uses native icons provider that should
take precedence over any customizations.
"""
@staticmethod
def Insert(provider):
"""
Insert(provider)
"""
@staticmethod
def Pop():
"""
Pop() -> bool
Remove latest added provider and delete it.
"""
@staticmethod
def Push(provider):
"""
Push(provider)
Register new art provider and add it to the top of providers stack
(i.e.
"""
@staticmethod
def PushBack(provider):
"""
PushBack(provider)
Register new art provider and add it to the bottom of providers stack.
"""
@staticmethod
def Remove(provider):
"""
Remove(provider) -> bool
Remove a provider from the stack if it is on it.
"""
@staticmethod
def GetMessageBoxIconId(flags):
"""
GetMessageBoxIconId(flags) -> ArtID
Helper used by GetMessageBoxIcon(): return the art id corresponding to
the standard wxICON_INFORMATION/WARNING/ERROR/QUESTION flags (only one
can be set)
"""
@staticmethod
def GetMessageBoxIcon(flags):
"""
GetMessageBoxIcon(flags) -> Icon
Helper used by several generic classes: return the icon corresponding
to the standard wxICON_INFORMATION/WARNING/ERROR/QUESTION flags (only
one can be set)
"""
def CreateBitmap(self, id, client, size):
"""
CreateBitmap(id, client, size) -> Bitmap
Derived art provider classes must override this method to create
requested art resource.
"""
def CreateIconBundle(self, id, client):
"""
CreateIconBundle(id, client) -> IconBundle
This method is similar to CreateBitmap() but can be used when a bitmap
(or an icon) exists in several sizes.
"""
# end of class ArtProvider
#-- end-artprov --#
#-- begin-dragimag --#
class DragImage(Object):
"""
DragImage()
DragImage(image, cursor=NullCursor)
DragImage(image, cursor=NullCursor)
DragImage(text, cursor=NullCursor)
DragImage(treeCtrl, id)
DragImage(listCtrl, id)
This class is used when you wish to drag an object on the screen, and
a simple cursor is not enough.
"""
def __init__(self, *args, **kw):
"""
DragImage()
DragImage(image, cursor=NullCursor)
DragImage(image, cursor=NullCursor)
DragImage(text, cursor=NullCursor)
DragImage(treeCtrl, id)
DragImage(listCtrl, id)
This class is used when you wish to drag an object on the screen, and
a simple cursor is not enough.
"""
def BeginDrag(self, *args, **kw):
"""
BeginDrag(hotspot, window, fullScreen=False, rect=None) -> bool
BeginDrag(hotspot, window, boundingWindow) -> bool
Start dragging the image, in a window or full screen.
"""
def EndDrag(self):
"""
EndDrag() -> bool
Call this when the drag has finished.
"""
def Hide(self):
"""
Hide() -> bool
Hides the image.
"""
def Move(self, pt):
"""
Move(pt) -> bool
Call this to move the image to a new position.
"""
def Show(self):
"""
Show() -> bool
Shows the image.
"""
# end of class DragImage
class GenericDragImage(Object):
"""
GenericDragImage()
GenericDragImage(image, cursor=NullCursor)
GenericDragImage(image, cursor=NullCursor)
GenericDragImage(text, cursor=NullCursor)
GenericDragImage(treeCtrl, id)
GenericDragImage(listCtrl, id)
This class is used when you wish to drag an object on the screen, and
a simple cursor is not enough.
"""
def __init__(self, *args, **kw):
"""
GenericDragImage()
GenericDragImage(image, cursor=NullCursor)
GenericDragImage(image, cursor=NullCursor)
GenericDragImage(text, cursor=NullCursor)
GenericDragImage(treeCtrl, id)
GenericDragImage(listCtrl, id)
This class is used when you wish to drag an object on the screen, and
a simple cursor is not enough.
"""
def BeginDrag(self, *args, **kw):
"""
BeginDrag(hotspot, window, fullScreen=False, rect=None) -> bool
BeginDrag(hotspot, window, boundingWindow) -> bool
Start dragging the image, in a window or full screen.
"""
def DoDrawImage(self, dc, pos):
"""
DoDrawImage(dc, pos) -> bool
Draws the image on the device context with top-left corner at the
given position.
"""
def EndDrag(self):
"""
EndDrag() -> bool
Call this when the drag has finished.
"""
def GetImageRect(self, pos):
"""
GetImageRect(pos) -> Rect
Returns the rectangle enclosing the image, assuming that the image is
drawn with its top-left corner at the given point.
"""
def Hide(self):
"""
Hide() -> bool
Hides the image.
"""
def Move(self, pt):
"""
Move(pt) -> bool
Call this to move the image to a new position.
"""
def Show(self):
"""
Show() -> bool
Shows the image.
"""
def UpdateBackingFromWindow(self, windowDC, destDC, sourceRect, destRect):
"""
UpdateBackingFromWindow(windowDC, destDC, sourceRect, destRect) -> bool
Override this if you wish to draw the window contents to the backing
bitmap yourself.
"""
# end of class GenericDragImage
#-- end-dragimag --#
#-- begin-printfw --#
PREVIEW_PRINT = 0
PREVIEW_PREVIOUS = 0
PREVIEW_NEXT = 0
PREVIEW_ZOOM = 0
PREVIEW_FIRST = 0
PREVIEW_LAST = 0
PREVIEW_GOTO = 0
PREVIEW_DEFAULT = 0
ID_PREVIEW_CLOSE = 0
ID_PREVIEW_NEXT = 0
ID_PREVIEW_PREVIOUS = 0
ID_PREVIEW_PRINT = 0
ID_PREVIEW_ZOOM = 0
ID_PREVIEW_FIRST = 0
ID_PREVIEW_LAST = 0
ID_PREVIEW_GOTO = 0
ID_PREVIEW_ZOOM_IN = 0
ID_PREVIEW_ZOOM_OUT = 0
PRINTER_NO_ERROR = 0
PRINTER_CANCELLED = 0
PRINTER_ERROR = 0
PreviewFrame_AppModal = 0
PreviewFrame_WindowModal = 0
PreviewFrame_NonModal = 0
class PreviewControlBar(Panel):
"""
PreviewControlBar(preview, buttons, parent, pos=DefaultPosition, size=DefaultSize, style=0, name="panel")
This is the default implementation of the preview control bar, a panel
with buttons and a zoom control.
"""
def __init__(self, preview, buttons, parent, pos=DefaultPosition, size=DefaultSize, style=0, name="panel"):
"""
PreviewControlBar(preview, buttons, parent, pos=DefaultPosition, size=DefaultSize, style=0, name="panel")
This is the default implementation of the preview control bar, a panel
with buttons and a zoom control.
"""
def CreateButtons(self):
"""
CreateButtons()
Creates buttons, according to value of the button style flags.
"""
def GetPrintPreview(self):
"""
GetPrintPreview() -> PrintPreview
Gets the print preview object associated with the control bar.
"""
def GetZoomControl(self):
"""
GetZoomControl() -> int
Gets the current zoom setting in percent.
"""
def SetZoomControl(self, percent):
"""
SetZoomControl(percent)
Sets the zoom control.
"""
PrintPreview = property(None, None)
ZoomControl = property(None, None)
# end of class PreviewControlBar
class PreviewCanvas(ScrolledWindow):
"""
PreviewCanvas(preview, parent, pos=DefaultPosition, size=DefaultSize, style=0, name="canvas")
A preview canvas is the default canvas used by the print preview
system to display the preview.
"""
def __init__(self, preview, parent, pos=DefaultPosition, size=DefaultSize, style=0, name="canvas"):
"""
PreviewCanvas(preview, parent, pos=DefaultPosition, size=DefaultSize, style=0, name="canvas")
A preview canvas is the default canvas used by the print preview
system to display the preview.
"""
def OnPaint(self, event):
"""
OnPaint(event)
Calls wxPrintPreview::PaintPage() to refresh the canvas.
"""
# end of class PreviewCanvas
class PreviewFrame(Frame):
"""
PreviewFrame(preview, parent, title="PrintPreview", pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
This class provides the default method of managing the print preview
interface.
"""
def __init__(self, preview, parent, title="PrintPreview", pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr):
"""
PreviewFrame(preview, parent, title="PrintPreview", pos=DefaultPosition, size=DefaultSize, style=DEFAULT_FRAME_STYLE, name=FrameNameStr)
This class provides the default method of managing the print preview
interface.
"""
def CreateCanvas(self):
"""
CreateCanvas()
Creates a wxPreviewCanvas.
"""
def CreateControlBar(self):
"""
CreateControlBar()
Creates a wxPreviewControlBar.
"""
def Initialize(self):
"""
Initialize()
Initializes the frame elements and prepares for showing it.
"""
def InitializeWithModality(self, kind):
"""
InitializeWithModality(kind)
Initializes the frame elements and prepares for showing it with the
given modality kind.
"""
def OnCloseWindow(self, event):
"""
OnCloseWindow(event)
Enables any disabled frames in the application, and deletes the print
preview object, implicitly deleting any printout objects associated
with the print preview object.
"""
# end of class PreviewFrame
class PrintPreview(Object):
"""
PrintPreview(printout, printoutForPrinting=None, data=None)
PrintPreview(printout, printoutForPrinting, data)
Objects of this class manage the print preview process.
"""
def __init__(self, *args, **kw):
"""
PrintPreview(printout, printoutForPrinting=None, data=None)
PrintPreview(printout, printoutForPrinting, data)
Objects of this class manage the print preview process.
"""
def GetCanvas(self):
"""
GetCanvas() -> PreviewCanvas
Gets the preview window used for displaying the print preview image.
"""
def GetCurrentPage(self):
"""
GetCurrentPage() -> int
Gets the page currently being previewed.
"""
def GetFrame(self):
"""
GetFrame() -> Frame
Gets the frame used for displaying the print preview canvas and
control bar.
"""
def GetMaxPage(self):
"""
GetMaxPage() -> int
Returns the maximum page number.
"""
def GetMinPage(self):
"""
GetMinPage() -> int
Returns the minimum page number.
"""
def GetPrintout(self):
"""
GetPrintout() -> Printout
Gets the preview printout object associated with the wxPrintPreview
object.
"""
def GetPrintoutForPrinting(self):
"""
GetPrintoutForPrinting() -> Printout
Gets the printout object to be used for printing from within the
preview interface, or NULL if none exists.
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the wxPrintPreview is valid, false otherwise.
"""
def PaintPage(self, canvas, dc):
"""
PaintPage(canvas, dc) -> bool
This refreshes the preview window with the preview image.
"""
def Print(self, prompt):
"""
Print(prompt) -> bool
Invokes the print process using the second wxPrintout object supplied
in the wxPrintPreview constructor.
"""
def RenderPage(self, pageNum):
"""
RenderPage(pageNum) -> bool
Renders a page into a wxMemoryDC.
"""
def SetCanvas(self, window):
"""
SetCanvas(window)
Sets the window to be used for displaying the print preview image.
"""
def SetCurrentPage(self, pageNum):
"""
SetCurrentPage(pageNum) -> bool
Sets the current page to be previewed.
"""
def SetFrame(self, frame):
"""
SetFrame(frame)
Sets the frame to be used for displaying the print preview canvas and
control bar.
"""
def SetPrintout(self, printout):
"""
SetPrintout(printout)
Associates a printout object with the wxPrintPreview object.
"""
def SetZoom(self, percent):
"""
SetZoom(percent)
Sets the percentage preview zoom, and refreshes the preview canvas
accordingly.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
Ok = wx.deprecated(IsOk, 'Use IsOk instead.')
Canvas = property(None, None)
CurrentPage = property(None, None)
Frame = property(None, None)
MaxPage = property(None, None)
MinPage = property(None, None)
Printout = property(None, None)
PrintoutForPrinting = property(None, None)
# end of class PrintPreview
class Printer(Object):
"""
Printer(data=None)
This class represents the Windows or PostScript printer, and is the
vehicle through which printing may be launched by an application.
"""
def __init__(self, data=None):
"""
Printer(data=None)
This class represents the Windows or PostScript printer, and is the
vehicle through which printing may be launched by an application.
"""
def CreateAbortWindow(self, parent, printout):
"""
CreateAbortWindow(parent, printout) -> PrintAbortDialog
Creates the default printing abort window, with a cancel button.
"""
def GetAbort(self):
"""
GetAbort() -> bool
Returns true if the user has aborted the print job.
"""
def GetPrintDialogData(self):
"""
GetPrintDialogData() -> PrintDialogData
Returns the print data associated with the printer object.
"""
def Print(self, parent, printout, prompt=True):
"""
Print(parent, printout, prompt=True) -> bool
Starts the printing process.
"""
def PrintDialog(self, parent):
"""
PrintDialog(parent) -> DC
Invokes the print dialog.
"""
def ReportError(self, parent, printout, message):
"""
ReportError(parent, printout, message)
Default error-reporting function.
"""
def Setup(self, parent):
"""
Setup(parent) -> bool
Invokes the print setup dialog.
"""
@staticmethod
def GetLastError():
"""
GetLastError() -> PrinterError
Return last error.
"""
Abort = property(None, None)
PrintDialogData = property(None, None)
# end of class Printer
class Printout(Object):
"""
Printout(title="Printout")
This class encapsulates the functionality of printing out an
application document.
"""
def __init__(self, title="Printout"):
"""
Printout(title="Printout")
This class encapsulates the functionality of printing out an
application document.
"""
def FitThisSizeToPage(self, imageSize):
"""
FitThisSizeToPage(imageSize)
Set the user scale and device origin of the wxDC associated with this
wxPrintout so that the given image size fits entirely within the page
rectangle and the origin is at the top left corner of the page
rectangle.
"""
def FitThisSizeToPageMargins(self, imageSize, pageSetupData):
"""
FitThisSizeToPageMargins(imageSize, pageSetupData)
Set the user scale and device origin of the wxDC associated with this
wxPrintout so that the given image size fits entirely within the page
margins set in the given wxPageSetupDialogData object.
"""
def FitThisSizeToPaper(self, imageSize):
"""
FitThisSizeToPaper(imageSize)
Set the user scale and device origin of the wxDC associated with this
wxPrintout so that the given image size fits entirely within the paper
and the origin is at the top left corner of the paper.
"""
def GetDC(self):
"""
GetDC() -> DC
Returns the device context associated with the printout (given to the
printout at start of printing or previewing).
"""
def GetLogicalPageMarginsRect(self, pageSetupData):
"""
GetLogicalPageMarginsRect(pageSetupData) -> Rect
Return the rectangle corresponding to the page margins specified by
the given wxPageSetupDialogData object in the associated wxDC's
logical coordinates for the current user scale and device origin.
"""
def GetLogicalPageRect(self):
"""
GetLogicalPageRect() -> Rect
Return the rectangle corresponding to the page in the associated wxDC
's logical coordinates for the current user scale and device origin.
"""
def GetLogicalPaperRect(self):
"""
GetLogicalPaperRect() -> Rect
Return the rectangle corresponding to the paper in the associated wxDC
's logical coordinates for the current user scale and device origin.
"""
def GetPPIPrinter(self):
"""
GetPPIPrinter() -> (w, h)
Returns the number of pixels per logical inch of the printer device
context.
"""
def GetPPIScreen(self):
"""
GetPPIScreen() -> (w, h)
Returns the number of pixels per logical inch of the screen device
context.
"""
def GetPageInfo(self):
"""
GetPageInfo() -> (minPage, maxPage, pageFrom, pageTo)
Called by the framework to obtain information from the application
about minimum and maximum page values that the user can select, and
the required page range to be printed.
"""
def GetPageSizeMM(self):
"""
GetPageSizeMM() -> (w, h)
Returns the size of the printer page in millimetres.
"""
def GetPageSizePixels(self):
"""
GetPageSizePixels() -> (w, h)
Returns the size of the printer page in pixels, called the page
rectangle.
"""
def GetPaperRectPixels(self):
"""
GetPaperRectPixels() -> Rect
Returns the rectangle that corresponds to the entire paper in pixels,
called the paper rectangle.
"""
def GetTitle(self):
"""
GetTitle() -> String
Returns the title of the printout.
"""
def HasPage(self, pageNum):
"""
HasPage(pageNum) -> bool
Should be overridden to return true if the document has this page, or
false if not.
"""
def IsPreview(self):
"""
IsPreview() -> bool
Returns true if the printout is currently being used for previewing.
"""
def GetPreview(self):
"""
GetPreview() -> PrintPreview
Returns the associated preview object if any.
"""
def MapScreenSizeToDevice(self):
"""
MapScreenSizeToDevice()
Set the user scale and device origin of the wxDC associated with this
wxPrintout so that one screen pixel maps to one device pixel on the
DC.
"""
def MapScreenSizeToPage(self):
"""
MapScreenSizeToPage()
This sets the user scale of the wxDC associated with this wxPrintout
to the same scale as MapScreenSizeToPaper() but sets the logical
origin to the top left corner of the page rectangle.
"""
def MapScreenSizeToPageMargins(self, pageSetupData):
"""
MapScreenSizeToPageMargins(pageSetupData)
This sets the user scale of the wxDC associated with this wxPrintout
to the same scale as MapScreenSizeToPageMargins() but sets the logical
origin to the top left corner of the page margins specified by the
given wxPageSetupDialogData object.
"""
def MapScreenSizeToPaper(self):
"""
MapScreenSizeToPaper()
Set the user scale and device origin of the wxDC associated with this
wxPrintout so that the printed page matches the screen size as closely
as possible and the logical origin is in the top left corner of the
paper rectangle.
"""
def OffsetLogicalOrigin(self, xoff, yoff):
"""
OffsetLogicalOrigin(xoff, yoff)
Shift the device origin by an amount specified in logical coordinates.
"""
def OnBeginDocument(self, startPage, endPage):
"""
OnBeginDocument(startPage, endPage) -> bool
Called by the framework at the start of document printing.
"""
def OnBeginPrinting(self):
"""
OnBeginPrinting()
Called by the framework at the start of printing.
"""
def OnEndDocument(self):
"""
OnEndDocument()
Called by the framework at the end of document printing.
"""
def OnEndPrinting(self):
"""
OnEndPrinting()
Called by the framework at the end of printing.
"""
def OnPreparePrinting(self):
"""
OnPreparePrinting()
Called once by the framework before any other demands are made of the
wxPrintout object.
"""
def OnPrintPage(self, pageNum):
"""
OnPrintPage(pageNum) -> bool
Called by the framework when a page should be printed.
"""
def SetLogicalOrigin(self, x, y):
"""
SetLogicalOrigin(x, y)
Set the device origin of the associated wxDC so that the current
logical point becomes the new logical origin.
"""
DC = property(None, None)
LogicalPageRect = property(None, None)
LogicalPaperRect = property(None, None)
PaperRectPixels = property(None, None)
Preview = property(None, None)
Title = property(None, None)
# end of class Printout
class PrintAbortDialog(Dialog):
"""
PrintAbortDialog(parent, documentTitle, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_DIALOG_STYLE, name="dialog")
The dialog created by default by the print framework that enables
aborting the printing process.
"""
def __init__(self, parent, documentTitle, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_DIALOG_STYLE, name="dialog"):
"""
PrintAbortDialog(parent, documentTitle, pos=DefaultPosition, size=DefaultSize, style=DEFAULT_DIALOG_STYLE, name="dialog")
The dialog created by default by the print framework that enables
aborting the printing process.
"""
def SetProgress(self, currentPage, totalPages, currentCopy, totalCopies):
"""
SetProgress(currentPage, totalPages, currentCopy, totalCopies)
"""
# end of class PrintAbortDialog
PyPrintPreview = wx.deprecated(PrintPreview, 'Use PrintPreview instead.')
PyPreviewFrame = wx.deprecated(PreviewFrame, 'Use PreviewFrame instead.')
PyPreviewControlBar = wx.deprecated(PreviewControlBar, 'Use PreviewControlBar instead.')
PyPrintout = wx.deprecated(Printout, 'Use Printout instead.')
#-- end-printfw --#
#-- begin-printdlg --#
class PrintDialog(Object):
"""
PrintDialog(parent, data=None)
PrintDialog(parent, data)
This class represents the print and print setup common dialogs.
"""
def __init__(self, *args, **kw):
"""
PrintDialog(parent, data=None)
PrintDialog(parent, data)
This class represents the print and print setup common dialogs.
"""
def GetPrintDC(self):
"""
GetPrintDC() -> DC
Returns the device context created by the print dialog, if any.
"""
def GetPrintDialogData(self):
"""
GetPrintDialogData() -> PrintDialogData
Returns the print dialog data associated with the print dialog.
"""
def GetPrintData(self):
"""
GetPrintData() -> PrintData
Returns the print data associated with the print dialog.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning wxID_OK if the user pressed OK, and
wxID_CANCEL otherwise.
"""
PrintDC = property(None, None)
PrintData = property(None, None)
PrintDialogData = property(None, None)
# end of class PrintDialog
class PageSetupDialog(Object):
"""
PageSetupDialog(parent, data=None)
This class represents the page setup common dialog.
"""
def __init__(self, parent, data=None):
"""
PageSetupDialog(parent, data=None)
This class represents the page setup common dialog.
"""
def GetPageSetupData(self):
"""
GetPageSetupData() -> PageSetupDialogData
Returns the wxPageSetupDialogData object associated with the dialog.
"""
def ShowModal(self):
"""
ShowModal() -> int
Shows the dialog, returning wxID_OK if the user pressed OK, and
wxID_CANCEL otherwise.
"""
PageSetupData = property(None, None)
# end of class PageSetupDialog
#-- end-printdlg --#
#-- begin-mimetype --#
class FileType(object):
"""
FileType(ftInfo)
This class holds information about a given file type.
"""
class MessageParameters(object):
"""
MessageParameters()
MessageParameters(filename, mimetype=EmptyString)
Class representing message parameters.
"""
def __init__(self, *args, **kw):
"""
MessageParameters()
MessageParameters(filename, mimetype=EmptyString)
Class representing message parameters.
"""
def GetFileName(self):
"""
GetFileName() -> String
Return the filename.
"""
def GetMimeType(self):
"""
GetMimeType() -> String
Return the MIME type.
"""
def GetParamValue(self, name):
"""
GetParamValue(name) -> String
Overridable method for derived classes. Returns empty string by
default.
"""
FileName = property(None, None)
MimeType = property(None, None)
# end of class MessageParameters
def __init__(self, ftInfo):
"""
FileType(ftInfo)
This class holds information about a given file type.
"""
def GetOpenCommand(self, *args, **kw):
"""
GetOpenCommand(filename) -> String
GetOpenCommand(params) -> String
With the first version of this method, if the true is returned, the
string pointed to by command is filled with the command which must be
executed (see wxExecute()) in order to open the file of the given
type.
"""
def GetDescription(self):
"""
GetDescription() -> String
Returns a brief description for this file type: for example, "text
document" for
the "text/plain" MIME type.
"""
def GetExtensions(self):
"""
GetExtensions() -> ArrayString
Returns all extensions associated with this file type: for
example, it may contain the following two elements for the MIME
type "text/html" (notice the absence of the leading dot): "html"
and "htm".
This function is not implemented on Windows, there is no (efficient)
way to retrieve associated extensions from the given MIME type on
this platform.
"""
def GetIcon(self):
"""
GetIcon() -> Icon
Return the icon associated with this mime type, if any.
"""
def GetMimeType(self):
"""
GetMimeType() -> String
Returns full MIME type specification for this file type: for example,
"text/plain".
"""
def GetMimeTypes(self):
"""
GetMimeTypes() -> ArrayString
Same as GetMimeType but returns a list of types. This will usually
contain
only one item, but sometimes, such as on Unix with KDE more than one
type
if there are differences between KDE< mailcap and mime.types.
"""
def GetPrintCommand(self, params):
"""
GetPrintCommand(params) -> String
Returns the command which must be executed (see wxExecute()) in order
to
print the file of the given type. The name of the file is retrieved
from
the MessageParameters class.
"""
def GetAllCommands(self, params):
"""
GetAllCommands(params) -> (size_t, verbs, commands)
Returns the number of commands for this mime type, and fills the verbs
and commands arrays with the command information.
"""
@staticmethod
def ExpandCommand(command, params):
"""
ExpandCommand(command, params) -> String
This function is primarily intended for GetOpenCommand and
GetPrintCommand usage but may be also used by the application directly
if, for example, you want to use some non-default command to open the
file.
"""
def GetIconLocation(self):
"""
GetIconLocation() -> IconLocation
Returns a wx.IconLocation that can be used to fetch the icon for this
mime type.
"""
def GetIconInfo(self):
"""
GetIconInfo() -> PyObject
Returns a tuple containing the Icon for this file type, the file where
the
icon is found, and the index of the image in that file, if applicable.
"""
Description = property(None, None)
Extensions = property(None, None)
Icon = property(None, None)
IconInfo = property(None, None)
IconLocation = property(None, None)
MimeType = property(None, None)
MimeTypes = property(None, None)
OpenCommand = property(None, None)
PrintCommand = property(None, None)
# end of class FileType
class FileTypeInfo(object):
"""
FileTypeInfo()
FileTypeInfo(mimeType)
FileTypeInfo(mimeType, openCmd, printCmd, description, extension)
FileTypeInfo(sArray)
Container of information about wxFileType.
"""
def __init__(self, *args, **kw):
"""
FileTypeInfo()
FileTypeInfo(mimeType)
FileTypeInfo(mimeType, openCmd, printCmd, description, extension)
FileTypeInfo(sArray)
Container of information about wxFileType.
"""
def AddExtension(self, ext):
"""
AddExtension(ext)
Add another extension associated with this file type.
"""
def SetDescription(self, description):
"""
SetDescription(description)
Set the file type description.
"""
def SetOpenCommand(self, command):
"""
SetOpenCommand(command)
Set the command to be used for opening files of this type.
"""
def SetPrintCommand(self, command):
"""
SetPrintCommand(command)
Set the command to be used for printing files of this type.
"""
def SetShortDesc(self, shortDesc):
"""
SetShortDesc(shortDesc)
Set the short description for the files of this type.
"""
def SetIcon(self, iconFile, iconIndex=0):
"""
SetIcon(iconFile, iconIndex=0)
Set the icon information.
"""
def GetMimeType(self):
"""
GetMimeType() -> String
Get the MIME type.
"""
def GetOpenCommand(self):
"""
GetOpenCommand() -> String
Get the open command.
"""
def GetPrintCommand(self):
"""
GetPrintCommand() -> String
Get the print command.
"""
def GetShortDesc(self):
"""
GetShortDesc() -> String
Get the short description (only used under Win32 so far)
"""
def GetDescription(self):
"""
GetDescription() -> String
Get the long, user visible description.
"""
def GetExtensions(self):
"""
GetExtensions() -> ArrayString
Get the array of all extensions.
"""
def GetExtensionsCount(self):
"""
GetExtensionsCount() -> size_t
Get the number of extensions.
"""
def GetIconFile(self):
"""
GetIconFile() -> String
Get the icon filename.
"""
def GetIconIndex(self):
"""
GetIconIndex() -> int
Get the index of the icon within the icon file.
"""
Description = property(None, None)
Extensions = property(None, None)
ExtensionsCount = property(None, None)
IconFile = property(None, None)
IconIndex = property(None, None)
MimeType = property(None, None)
OpenCommand = property(None, None)
PrintCommand = property(None, None)
ShortDesc = property(None, None)
# end of class FileTypeInfo
class MimeTypesManager(object):
"""
MimeTypesManager()
This class allows the application to retrieve information about all
known MIME types from a system-specific location and the filename
extensions to the MIME types and vice versa.
"""
def __init__(self):
"""
MimeTypesManager()
This class allows the application to retrieve information about all
known MIME types from a system-specific location and the filename
extensions to the MIME types and vice versa.
"""
def AddFallbacks(self, fallbacks):
"""
AddFallbacks(fallbacks)
This function may be used to provide hard-wired fallbacks for the MIME
types and extensions that might not be present in the system MIME
database.
"""
def GetFileTypeFromExtension(self, extension):
"""
GetFileTypeFromExtension(extension) -> FileType
Gather information about the files with given extension and return the
corresponding wxFileType object or NULL if the extension is unknown.
"""
def GetFileTypeFromMimeType(self, mimeType):
"""
GetFileTypeFromMimeType(mimeType) -> FileType
Gather information about the files with given MIME type and return the
corresponding wxFileType object or NULL if the MIME type is unknown.
"""
def Associate(self, ftInfo):
"""
Associate(ftInfo) -> FileType
Create a new association using the fields of wxFileTypeInfo (at least
the MIME type and the extension should be set).
"""
def Unassociate(self, ft):
"""
Unassociate(ft) -> bool
Undo Associate().
"""
def EnumAllFileTypes(self):
"""
EnumAllFileTypes() -> ArrayString
Returns a list of all known file types.
"""
@staticmethod
def IsOfType(mimeType, wildcard):
"""
IsOfType(mimeType, wildcard) -> bool
This function returns true if either the given mimeType is exactly the
same as wildcard or if it has the same category and the subtype of
wildcard is '*'.
"""
# end of class MimeTypesManager
TheMimeTypesManager = MimeTypesManager()
#-- end-mimetype --#
#-- begin-busyinfo --#
class BusyInfo(object):
"""
BusyInfo(msg, parent=None)
This class makes it easy to tell your user that the program is
temporarily busy.
"""
def __init__(self, msg, parent=None):
"""
BusyInfo(msg, parent=None)
This class makes it easy to tell your user that the program is
temporarily busy.
"""
# end of class BusyInfo
#-- end-busyinfo --#
#-- begin-caret --#
class Caret(object):
"""
Caret(window, width, height)
Caret(window, size)
Caret()
A caret is a blinking cursor showing the position where the typed text
will appear.
"""
def __init__(self, *args, **kw):
"""
Caret(window, width, height)
Caret(window, size)
Caret()
A caret is a blinking cursor showing the position where the typed text
will appear.
"""
def Create(self, *args, **kw):
"""
Create(window, width, height) -> bool
Create(window, size) -> bool
Creates a caret with the given size (in pixels) and associates it with
the window (same as the equivalent constructors).
"""
def GetPosition(self, *args, **kw):
"""
GetPosition() -> Point
Get the caret position (in pixels).
"""
def GetSize(self, *args, **kw):
"""
GetSize() -> Size
Get the caret size.
"""
def Move(self, *args, **kw):
"""
Move(x, y)
Move(pt)
Move the caret to given position (in logical coordinates).
"""
def SetSize(self, *args, **kw):
"""
SetSize(width, height)
SetSize(size)
Changes the size of the caret.
"""
def GetWindow(self):
"""
GetWindow() -> Window
Get the window the caret is associated with.
"""
def Hide(self):
"""
Hide()
Hides the caret, same as Show(false).
"""
def IsOk(self):
"""
IsOk() -> bool
Returns true if the caret was created successfully.
"""
def IsVisible(self):
"""
IsVisible() -> bool
Returns true if the caret is visible and false if it is permanently
hidden (if it is blinking and not shown currently but will be after
the next blink, this method still returns true).
"""
def Show(self, show=True):
"""
Show(show=True)
Shows or hides the caret.
"""
@staticmethod
def GetBlinkTime():
"""
GetBlinkTime() -> int
Returns the blink time which is measured in milliseconds and is the
time elapsed between 2 inversions of the caret (blink time of the
caret is the same for all carets, so this functions is static).
"""
@staticmethod
def SetBlinkTime(milliseconds):
"""
SetBlinkTime(milliseconds)
Sets the blink time for all the carets.
"""
def __nonzero__(self):
"""
__nonzero__() -> int
"""
Position = property(None, None)
Size = property(None, None)
Window = property(None, None)
# end of class Caret
#-- end-caret --#
#-- begin-fontenum --#
class FontEnumerator(object):
"""
FontEnumerator()
wxFontEnumerator enumerates either all available fonts on the system
or only the ones with given attributes - either only fixed-width
(suited for use in programs such as terminal emulators and the like)
or the fonts available in the given encoding).
"""
def __init__(self):
"""
FontEnumerator()
wxFontEnumerator enumerates either all available fonts on the system
or only the ones with given attributes - either only fixed-width
(suited for use in programs such as terminal emulators and the like)
or the fonts available in the given encoding).
"""
def EnumerateEncodings(self, font=EmptyString):
"""
EnumerateEncodings(font=EmptyString) -> bool
Call OnFontEncoding() for each encoding supported by the given font -
or for each encoding supported by at least some font if font is not
specified.
"""
def EnumerateFacenames(self, encoding=FONTENCODING_SYSTEM, fixedWidthOnly=False):
"""
EnumerateFacenames(encoding=FONTENCODING_SYSTEM, fixedWidthOnly=False) -> bool
Call OnFacename() for each font which supports given encoding (only if
it is not wxFONTENCODING_SYSTEM) and is of fixed width (if
fixedWidthOnly is true).
"""
def OnFacename(self, font):
"""
OnFacename(font) -> bool
Called by EnumerateFacenames() for each match.
"""
def OnFontEncoding(self, font, encoding):
"""
OnFontEncoding(font, encoding) -> bool
Called by EnumerateEncodings() for each match.
"""
@staticmethod
def GetEncodings(facename=EmptyString):
"""
GetEncodings(facename=EmptyString) -> ArrayString
Return array of strings containing all encodings found by
EnumerateEncodings().
"""
@staticmethod
def GetFacenames(encoding=FONTENCODING_SYSTEM, fixedWidthOnly=False):
"""
GetFacenames(encoding=FONTENCODING_SYSTEM, fixedWidthOnly=False) -> ArrayString
Return array of strings containing all facenames found by
EnumerateFacenames().
"""
@staticmethod
def IsValidFacename(facename):
"""
IsValidFacename(facename) -> bool
Returns true if the given string is valid face name, i.e.
"""
# end of class FontEnumerator
#-- end-fontenum --#
#-- begin-fontmap --#
class FontMapper(object):
"""
FontMapper()
wxFontMapper manages user-definable correspondence between logical
font names and the fonts present on the machine.
"""
def __init__(self):
"""
FontMapper()
wxFontMapper manages user-definable correspondence between logical
font names and the fonts present on the machine.
"""
def GetAltForEncoding(self, *args, **kw):
"""
GetAltForEncoding(encoding, facename=EmptyString, interactive=True) -> (bool, alt_encoding)
Find an alternative for the given encoding (which is supposed to not
be available on this system).
"""
def CharsetToEncoding(self, charset, interactive=True):
"""
CharsetToEncoding(charset, interactive=True) -> FontEncoding
Returns the encoding for the given charset (in the form of RFC 2046)
or wxFONTENCODING_SYSTEM if couldn't decode it.
"""
def IsEncodingAvailable(self, encoding, facename=EmptyString):
"""
IsEncodingAvailable(encoding, facename=EmptyString) -> bool
Check whether given encoding is available in given face or not.
"""
def SetConfigPath(self, prefix):
"""
SetConfigPath(prefix)
Set the root config path to use (should be an absolute path).
"""
def SetDialogParent(self, parent):
"""
SetDialogParent(parent)
The parent window for modal dialogs.
"""
def SetDialogTitle(self, title):
"""
SetDialogTitle(title)
The title for the dialogs (note that default is quite reasonable).
"""
@staticmethod
def Get():
"""
Get() -> FontMapper
Get the current font mapper object.
"""
@staticmethod
def GetAllEncodingNames(encoding):
"""
GetAllEncodingNames(encoding) -> ArrayString
Returns the array of all possible names for the given encoding. If it
isn't empty, the first name in it is the canonical encoding name,
i.e. the same string as returned by GetEncodingName()
"""
@staticmethod
def GetEncoding(n):
"""
GetEncoding(n) -> FontEncoding
Returns the n-th supported encoding.
"""
@staticmethod
def GetEncodingDescription(encoding):
"""
GetEncodingDescription(encoding) -> String
Return user-readable string describing the given encoding.
"""
@staticmethod
def GetEncodingFromName(encoding):
"""
GetEncodingFromName(encoding) -> FontEncoding
Return the encoding corresponding to the given internal name.
"""
@staticmethod
def GetEncodingName(encoding):
"""
GetEncodingName(encoding) -> String
Return internal string identifier for the encoding (see also
wxFontMapper::GetEncodingDescription).
"""
@staticmethod
def GetSupportedEncodingsCount():
"""
GetSupportedEncodingsCount() -> size_t
Returns the number of the font encodings supported by this class.
"""
@staticmethod
def Set(mapper):
"""
Set(mapper) -> FontMapper
Set the current font mapper object and return previous one (may be
NULL).
"""
# end of class FontMapper
#-- end-fontmap --#
#-- begin-mousemanager --#
class MouseEventsManager(EvtHandler):
"""
MouseEventsManager()
MouseEventsManager(win)
Helper for handling mouse input events in windows containing multiple
items.
"""
def __init__(self, *args, **kw):
"""
MouseEventsManager()
MouseEventsManager(win)
Helper for handling mouse input events in windows containing multiple
items.
"""
def Create(self, win):
"""
Create(win) -> bool
Finishes initialization of the object created using default
constructor.
"""
def MouseHitTest(self, pos):
"""
MouseHitTest(pos) -> int
Must be overridden to return the item at the given position.
"""
def MouseClicked(self, item):
"""
MouseClicked(item) -> bool
Must be overridden to react to mouse clicks.
"""
def MouseDragBegin(self, item, pos):
"""
MouseDragBegin(item, pos) -> bool
Must be overridden to allow or deny dragging of the item.
"""
def MouseDragging(self, item, pos):
"""
MouseDragging(item, pos)
Must be overridden to provide feed back while an item is being
dragged.
"""
def MouseDragEnd(self, item, pos):
"""
MouseDragEnd(item, pos)
Must be overridden to handle item drop.
"""
def MouseDragCancelled(self, item):
"""
MouseDragCancelled(item)
Must be overridden to handle cancellation of mouse dragging.
"""
def MouseClickBegin(self, item):
"""
MouseClickBegin(item)
May be overridden to update the state of an item when it is pressed.
"""
def MouseClickCancelled(self, item):
"""
MouseClickCancelled(item)
Must be overridden to reset the item appearance changed by
MouseClickBegin().
"""
# end of class MouseEventsManager
#-- end-mousemanager --#
#-- begin-filehistory --#
class FileHistory(Object):
"""
FileHistory(maxFiles=9, idBase=ID_FILE1)
The wxFileHistory encapsulates a user interface convenience, the list
of most recently visited files as shown on a menu (usually the File
menu).
"""
def __init__(self, maxFiles=9, idBase=ID_FILE1):
"""
FileHistory(maxFiles=9, idBase=ID_FILE1)
The wxFileHistory encapsulates a user interface convenience, the list
of most recently visited files as shown on a menu (usually the File
menu).
"""
def AddFileToHistory(self, filename):
"""
AddFileToHistory(filename)
Adds a file to the file history list, if the object has a pointer to
an appropriate file menu.
"""
def AddFilesToMenu(self, *args, **kw):
"""
AddFilesToMenu()
AddFilesToMenu(menu)
Appends the files in the history list, to all menus managed by the
file history object.
"""
def GetBaseId(self):
"""
GetBaseId() -> WindowID
Returns the base identifier for the range used for appending items.
"""
def GetCount(self):
"""
GetCount() -> size_t
Returns the number of files currently stored in the file history.
"""
def GetHistoryFile(self, index):
"""
GetHistoryFile(index) -> String
Returns the file at this index (zero-based).
"""
def GetMaxFiles(self):
"""
GetMaxFiles() -> int
Returns the maximum number of files that can be stored.
"""
def GetMenus(self):
"""
GetMenus() -> FileHistoryMenuList
Returns the list of menus that are managed by this file history
object.
"""
def Load(self, config):
"""
Load(config)
Loads the file history from the given config object.
"""
def RemoveFileFromHistory(self, i):
"""
RemoveFileFromHistory(i)
Removes the specified file from the history.
"""
def RemoveMenu(self, menu):
"""
RemoveMenu(menu)
Removes this menu from the list of those managed by this object.
"""
def Save(self, config):
"""
Save(config)
Saves the file history into the given config object.
"""
def SetBaseId(self, baseId):
"""
SetBaseId(baseId)
Sets the base identifier for the range used for appending items.
"""
def UseMenu(self, menu):
"""
UseMenu(menu)
Adds this menu to the list of those menus that are managed by this
file history object.
"""
BaseId = property(None, None)
Count = property(None, None)
MaxFiles = property(None, None)
Menus = property(None, None)
# end of class FileHistory
#-- end-filehistory --#
#-- begin-cmdproc --#
class Command(Object):
"""
Command(canUndo=False, name=EmptyString)
wxCommand is a base class for modelling an application command, which
is an action usually performed by selecting a menu item, pressing a
toolbar button or any other means provided by the application to
change the data or view.
"""
def __init__(self, canUndo=False, name=EmptyString):
"""
Command(canUndo=False, name=EmptyString)
wxCommand is a base class for modelling an application command, which
is an action usually performed by selecting a menu item, pressing a
toolbar button or any other means provided by the application to
change the data or view.
"""
def CanUndo(self):
"""
CanUndo() -> bool
Returns true if the command can be undone, false otherwise.
"""
def Do(self):
"""
Do() -> bool
Override this member function to execute the appropriate action when
called.
"""
def GetName(self):
"""
GetName() -> String
Returns the command name.
"""
def Undo(self):
"""
Undo() -> bool
Override this member function to un-execute a previous Do.
"""
Name = property(None, None)
# end of class Command
class CommandProcessor(Object):
"""
CommandProcessor(maxCommands=-1)
wxCommandProcessor is a class that maintains a history of wxCommands,
with undo/redo functionality built-in.
"""
def __init__(self, maxCommands=-1):
"""
CommandProcessor(maxCommands=-1)
wxCommandProcessor is a class that maintains a history of wxCommands,
with undo/redo functionality built-in.
"""
def CanUndo(self):
"""
CanUndo() -> bool
Returns true if the currently-active command can be undone, false
otherwise.
"""
def CanRedo(self):
"""
CanRedo() -> bool
Returns true if the currently-active command can be redone, false
otherwise.
"""
def ClearCommands(self):
"""
ClearCommands()
Deletes all commands in the list and sets the current command pointer
to NULL.
"""
def GetCommands(self):
"""
GetCommands() -> CommandList
Returns the list of commands.
"""
def GetCurrentCommand(self):
"""
GetCurrentCommand() -> Command
Returns the current command.
"""
def GetEditMenu(self):
"""
GetEditMenu() -> Menu
Returns the edit menu associated with the command processor.
"""
def GetMaxCommands(self):
"""
GetMaxCommands() -> int
Returns the maximum number of commands that the command processor
stores.
"""
def GetRedoAccelerator(self):
"""
GetRedoAccelerator() -> String
Returns the string that will be appended to the Redo menu item.
"""
def GetRedoMenuLabel(self):
"""
GetRedoMenuLabel() -> String
Returns the string that will be shown for the redo menu item.
"""
def GetUndoAccelerator(self):
"""
GetUndoAccelerator() -> String
Returns the string that will be appended to the Undo menu item.
"""
def GetUndoMenuLabel(self):
"""
GetUndoMenuLabel() -> String
Returns the string that will be shown for the undo menu item.
"""
def Initialize(self):
"""
Initialize()
Initializes the command processor, setting the current command to the
last in the list (if any), and updating the edit menu (if one has been
specified).
"""
def IsDirty(self):
"""
IsDirty() -> bool
Returns a boolean value that indicates if changes have been made since
the last save operation.
"""
def MarkAsSaved(self):
"""
MarkAsSaved()
You must call this method whenever the project is saved if you plan to
use IsDirty().
"""
def Redo(self):
"""
Redo() -> bool
Executes (redoes) the current command (the command that has just been
undone if any).
"""
def SetEditMenu(self, menu):
"""
SetEditMenu(menu)
Tells the command processor to update the Undo and Redo items on this
menu as appropriate.
"""
def SetMenuStrings(self):
"""
SetMenuStrings()
Sets the menu labels according to the currently set menu and the
current command state.
"""
def SetRedoAccelerator(self, accel):
"""
SetRedoAccelerator(accel)
Sets the string that will be appended to the Redo menu item.
"""
def SetUndoAccelerator(self, accel):
"""
SetUndoAccelerator(accel)
Sets the string that will be appended to the Undo menu item.
"""
def Submit(self, command, storeIt=True):
"""
Submit(command, storeIt=True) -> bool
Submits a new command to the command processor.
"""
def Store(self, command):
"""
Store(command)
Just store the command without executing it.
"""
def Undo(self):
"""
Undo() -> bool
Undoes the last command executed.
"""
Commands = property(None, None)
CurrentCommand = property(None, None)
EditMenu = property(None, None)
MaxCommands = property(None, None)
RedoAccelerator = property(None, None)
RedoMenuLabel = property(None, None)
UndoAccelerator = property(None, None)
UndoMenuLabel = property(None, None)
# end of class CommandProcessor
#-- end-cmdproc --#
#-- begin-fswatcher --#
FSW_EVENT_CREATE = 0
FSW_EVENT_DELETE = 0
FSW_EVENT_RENAME = 0
FSW_EVENT_MODIFY = 0
FSW_EVENT_ACCESS = 0
FSW_EVENT_ATTRIB = 0
FSW_EVENT_UNMOUNT = 0
FSW_EVENT_WARNING = 0
FSW_EVENT_ERROR = 0
FSW_EVENT_ALL = 0
FSW_WARNING_NONE = 0
FSW_WARNING_GENERAL = 0
FSW_WARNING_OVERFLOW = 0
wxEVT_FSWATCHER = 0
class FileSystemWatcher(EvtHandler):
"""
FileSystemWatcher()
The wxFileSystemWatcher class allows to receive notifications of file
system changes.
"""
def __init__(self):
"""
FileSystemWatcher()
The wxFileSystemWatcher class allows to receive notifications of file
system changes.
"""
def Add(self, path, events=FSW_EVENT_ALL):
"""
Add(path, events=FSW_EVENT_ALL) -> bool
Adds path to currently watched files.
"""
def AddTree(self, path, events=FSW_EVENT_ALL, filter=EmptyString):
"""
AddTree(path, events=FSW_EVENT_ALL, filter=EmptyString) -> bool
This is the same as Add(), but also recursively adds every
file/directory in the tree rooted at path.
"""
def Remove(self, path):
"""
Remove(path) -> bool
Removes path from the list of watched paths.
"""
def RemoveTree(self, path):
"""
RemoveTree(path) -> bool
This is the same as Remove(), but also removes every file/directory
belonging to the tree rooted at path.
"""
def RemoveAll(self):
"""
RemoveAll() -> bool
Clears the list of currently watched paths.
"""
def GetWatchedPathsCount(self):
"""
GetWatchedPathsCount() -> int
Returns the number of currently watched paths.
"""
def GetWatchedPaths(self, paths):
"""
GetWatchedPaths(paths) -> int
Retrieves all watched paths and places them in paths.
"""
def SetOwner(self, handler):
"""
SetOwner(handler)
Associates the file system watcher with the given handler object.
"""
WatchedPathsCount = property(None, None)
# end of class FileSystemWatcher
class FileSystemWatcherEvent(Event):
"""
FileSystemWatcherEvent(changeType=0, watchid=ID_ANY)
FileSystemWatcherEvent(changeType, warningType, errorMsg, watchid=ID_ANY)
FileSystemWatcherEvent(changeType, path, newPath, watchid=ID_ANY)
A class of events sent when a file system event occurs.
"""
def __init__(self, *args, **kw):
"""
FileSystemWatcherEvent(changeType=0, watchid=ID_ANY)
FileSystemWatcherEvent(changeType, warningType, errorMsg, watchid=ID_ANY)
FileSystemWatcherEvent(changeType, path, newPath, watchid=ID_ANY)
A class of events sent when a file system event occurs.
"""
def GetPath(self):
"""
GetPath() -> FileName
Returns the path at which the event occurred.
"""
def GetNewPath(self):
"""
GetNewPath() -> FileName
Returns the new path of the renamed file/directory if this is a rename
event.
"""
def GetChangeType(self):
"""
GetChangeType() -> int
Returns the type of file system change that occurred.
"""
def IsError(self):
"""
IsError() -> bool
Returns true if this error is an error event.
"""
def GetErrorDescription(self):
"""
GetErrorDescription() -> String
Return a description of the warning or error if this is an error
event.
"""
def GetWarningType(self):
"""
GetWarningType() -> FSWWarningType
Return the type of the warning if this event is a warning one.
"""
def ToString(self):
"""
ToString() -> String
Returns a wxString describing an event, useful for logging, debugging
or testing.
"""
EVT_FSWATCHER = wx.PyEventBinder(wxEVT_FSWATCHER)
ChangeType = property(None, None)
ErrorDescription = property(None, None)
NewPath = property(None, None)
Path = property(None, None)
WarningType = property(None, None)
# end of class FileSystemWatcherEvent
#-- end-fswatcher --#
#-- begin-preferences --#
class PreferencesEditor(object):
"""
PreferencesEditor(title="")
Manage preferences dialog.
"""
def __init__(self, title=""):
"""
PreferencesEditor(title="")
Manage preferences dialog.
"""
def AddPage(self, page):
"""
AddPage(page)
Add a new page to the editor.
"""
def Show(self, parent):
"""
Show(parent)
Show the preferences dialog or bring it to the top if it's already
shown.
"""
def Dismiss(self):
"""
Dismiss()
Hide the currently shown dialog, if any.
"""
@staticmethod
def ShouldApplyChangesImmediately():
"""
ShouldApplyChangesImmediately() -> bool
Returns whether changes to values in preferences pages should be
applied immediately or only when the user clicks the OK button.
"""
# end of class PreferencesEditor
class PreferencesPage(object):
"""
PreferencesPage()
One page of preferences dialog.
"""
def __init__(self):
"""
PreferencesPage()
One page of preferences dialog.
"""
def GetName(self):
"""
GetName() -> String
Return name of the page.
"""
def GetLargeIcon(self):
"""
GetLargeIcon() -> Bitmap
Return 32x32 icon used for the page on some platforms.
"""
def CreateWindow(self, parent):
"""
CreateWindow(parent) -> Window
Create a window for this page.
"""
LargeIcon = property(None, None)
Name = property(None, None)
# end of class PreferencesPage
class StockPreferencesPage(PreferencesPage):
"""
StockPreferencesPage(kind)
Specialization of wxPreferencesPage useful for certain commonly used
preferences page.
"""
Kind_General = 0
Kind_Advanced = 0
def __init__(self, kind):
"""
StockPreferencesPage(kind)
Specialization of wxPreferencesPage useful for certain commonly used
preferences page.
"""
def GetKind(self):
"""
GetKind() -> Kind
Returns the page's kind.
"""
def GetName(self):
"""
GetName() -> String
Reimplemented to return suitable name for the page's kind.
"""
def GetLargeIcon(self):
"""
GetLargeIcon() -> Bitmap
Reimplemented to return stock icon on OS X.
"""
LargeIcon = property(None, None)
Name = property(None, None)
# end of class StockPreferencesPage
#-- end-preferences --#
#-- begin-modalhook --#
class ModalDialogHook(object):
"""
ModalDialogHook()
Allows to intercept all modal dialog calls.
"""
def __init__(self):
"""
ModalDialogHook()
Allows to intercept all modal dialog calls.
"""
def Register(self):
"""
Register()
Register this hook as being active.
"""
def Unregister(self):
"""
Unregister()
Unregister this hook.
"""
def Enter(self, dialog):
"""
Enter(dialog) -> int
Called by wxWidgets before showing any modal dialogs.
"""
def Exit(self, dialog):
"""
Exit(dialog)
Called by wxWidgets after dismissing the modal dialog.
"""
# end of class ModalDialogHook
#-- end-modalhook --#
Reference in a new issue View git blame Copy permalink