]> git.saurik.com Git - wxWidgets.git/blame - wxPython/src/msw/_core.py
Log the exception when writing to file fails.
[wxWidgets.git] / wxPython / src / msw / _core.py
CommitLineData
d55e5bfc
RD
1# This file was created automatically by SWIG.
2# Don't modify this file, modify the SWIG interface instead.
3
4import _core_
5
093d3ff1
RD
6def _swig_setattr_nondynamic(self,class_type,name,value,static=1):
7 if (name == "this"):
8 if isinstance(value, class_type):
9 self.__dict__[name] = value.this
10 if hasattr(value,"thisown"): self.__dict__["thisown"] = value.thisown
11 del value.thisown
12 return
13 method = class_type.__swig_setmethods__.get(name,None)
14 if method: return method(self,value)
15 if (not static) or hasattr(self,name) or (name == "thisown"):
16 self.__dict__[name] = value
17 else:
18 raise AttributeError("You cannot add attributes to %s" % self)
19
20def _swig_setattr(self,class_type,name,value):
21 return _swig_setattr_nondynamic(self,class_type,name,value,0)
22
23def _swig_getattr(self,class_type,name):
24 method = class_type.__swig_getmethods__.get(name,None)
25 if method: return method(self)
26 raise AttributeError,name
27
28import types
29try:
30 _object = types.ObjectType
31 _newclass = 1
32except AttributeError:
33 class _object : pass
34 _newclass = 0
35del types
36
37
38def _swig_setattr_nondynamic_method(set):
39 def set_attr(self,name,value):
40 if hasattr(self,name) or (name in ("this", "thisown")):
41 set(self,name,value)
42 else:
43 raise AttributeError("You cannot add attributes to %s" % self)
44 return set_attr
45
46
d55e5bfc
RD
47#// Give a reference to the dictionary of this module to the C++ extension
48#// code.
49_core_._wxPySetDictionary(vars())
50
51#// A little trick to make 'wx' be a reference to this module so wx.Names can
52#// be used here.
53import sys as _sys
54wx = _sys.modules[__name__]
55
c24da6d6
RD
56
57#----------------------------------------------------------------------------
58
59def _deprecated(callable, msg=None):
60 """
61 Create a wrapper function that will raise a DeprecationWarning
62 before calling the callable.
63 """
64 if msg is None:
65 msg = "%s is deprecated" % callable
66 def deprecatedWrapper(*args, **kwargs):
67 import warnings
68 warnings.warn(msg, DeprecationWarning, stacklevel=2)
69 return callable(*args, **kwargs)
70 deprecatedWrapper.__doc__ = msg
71 return deprecatedWrapper
72
73
74#----------------------------------------------------------------------------
75
d55e5bfc
RD
76NOT_FOUND = _core_.NOT_FOUND
77VSCROLL = _core_.VSCROLL
78HSCROLL = _core_.HSCROLL
79CAPTION = _core_.CAPTION
80DOUBLE_BORDER = _core_.DOUBLE_BORDER
81SUNKEN_BORDER = _core_.SUNKEN_BORDER
82RAISED_BORDER = _core_.RAISED_BORDER
83BORDER = _core_.BORDER
84SIMPLE_BORDER = _core_.SIMPLE_BORDER
85STATIC_BORDER = _core_.STATIC_BORDER
86TRANSPARENT_WINDOW = _core_.TRANSPARENT_WINDOW
87NO_BORDER = _core_.NO_BORDER
57133d5c 88DEFAULT_CONTROL_BORDER = _core_.DEFAULT_CONTROL_BORDER
6d88e192 89DEFAULT_STATUSBAR_STYLE = _core_.DEFAULT_STATUSBAR_STYLE
d55e5bfc
RD
90TAB_TRAVERSAL = _core_.TAB_TRAVERSAL
91WANTS_CHARS = _core_.WANTS_CHARS
92POPUP_WINDOW = _core_.POPUP_WINDOW
93CENTER_FRAME = _core_.CENTER_FRAME
94CENTRE_ON_SCREEN = _core_.CENTRE_ON_SCREEN
95CENTER_ON_SCREEN = _core_.CENTER_ON_SCREEN
d55e5bfc
RD
96CLIP_CHILDREN = _core_.CLIP_CHILDREN
97CLIP_SIBLINGS = _core_.CLIP_SIBLINGS
98ALWAYS_SHOW_SB = _core_.ALWAYS_SHOW_SB
99RETAINED = _core_.RETAINED
100BACKINGSTORE = _core_.BACKINGSTORE
101COLOURED = _core_.COLOURED
102FIXED_LENGTH = _core_.FIXED_LENGTH
103LB_NEEDED_SB = _core_.LB_NEEDED_SB
104LB_ALWAYS_SB = _core_.LB_ALWAYS_SB
105LB_SORT = _core_.LB_SORT
106LB_SINGLE = _core_.LB_SINGLE
107LB_MULTIPLE = _core_.LB_MULTIPLE
108LB_EXTENDED = _core_.LB_EXTENDED
109LB_OWNERDRAW = _core_.LB_OWNERDRAW
110LB_HSCROLL = _core_.LB_HSCROLL
111PROCESS_ENTER = _core_.PROCESS_ENTER
112PASSWORD = _core_.PASSWORD
113CB_SIMPLE = _core_.CB_SIMPLE
114CB_DROPDOWN = _core_.CB_DROPDOWN
115CB_SORT = _core_.CB_SORT
116CB_READONLY = _core_.CB_READONLY
117RA_HORIZONTAL = _core_.RA_HORIZONTAL
118RA_VERTICAL = _core_.RA_VERTICAL
119RA_SPECIFY_ROWS = _core_.RA_SPECIFY_ROWS
120RA_SPECIFY_COLS = _core_.RA_SPECIFY_COLS
fef4c27a 121RA_USE_CHECKBOX = _core_.RA_USE_CHECKBOX
d55e5bfc
RD
122RB_GROUP = _core_.RB_GROUP
123RB_SINGLE = _core_.RB_SINGLE
d55e5bfc
RD
124SB_HORIZONTAL = _core_.SB_HORIZONTAL
125SB_VERTICAL = _core_.SB_VERTICAL
fef4c27a 126RB_USE_CHECKBOX = _core_.RB_USE_CHECKBOX
d55e5bfc
RD
127ST_SIZEGRIP = _core_.ST_SIZEGRIP
128ST_NO_AUTORESIZE = _core_.ST_NO_AUTORESIZE
129FLOOD_SURFACE = _core_.FLOOD_SURFACE
130FLOOD_BORDER = _core_.FLOOD_BORDER
131ODDEVEN_RULE = _core_.ODDEVEN_RULE
132WINDING_RULE = _core_.WINDING_RULE
133TOOL_TOP = _core_.TOOL_TOP
134TOOL_BOTTOM = _core_.TOOL_BOTTOM
135TOOL_LEFT = _core_.TOOL_LEFT
136TOOL_RIGHT = _core_.TOOL_RIGHT
137OK = _core_.OK
138YES_NO = _core_.YES_NO
139CANCEL = _core_.CANCEL
140YES = _core_.YES
141NO = _core_.NO
142NO_DEFAULT = _core_.NO_DEFAULT
143YES_DEFAULT = _core_.YES_DEFAULT
144ICON_EXCLAMATION = _core_.ICON_EXCLAMATION
145ICON_HAND = _core_.ICON_HAND
146ICON_QUESTION = _core_.ICON_QUESTION
147ICON_INFORMATION = _core_.ICON_INFORMATION
148ICON_STOP = _core_.ICON_STOP
149ICON_ASTERISK = _core_.ICON_ASTERISK
150ICON_MASK = _core_.ICON_MASK
151ICON_WARNING = _core_.ICON_WARNING
152ICON_ERROR = _core_.ICON_ERROR
153FORWARD = _core_.FORWARD
154BACKWARD = _core_.BACKWARD
155RESET = _core_.RESET
156HELP = _core_.HELP
157MORE = _core_.MORE
158SETUP = _core_.SETUP
159SIZE_AUTO_WIDTH = _core_.SIZE_AUTO_WIDTH
160SIZE_AUTO_HEIGHT = _core_.SIZE_AUTO_HEIGHT
161SIZE_AUTO = _core_.SIZE_AUTO
162SIZE_USE_EXISTING = _core_.SIZE_USE_EXISTING
163SIZE_ALLOW_MINUS_ONE = _core_.SIZE_ALLOW_MINUS_ONE
164PORTRAIT = _core_.PORTRAIT
165LANDSCAPE = _core_.LANDSCAPE
166PRINT_QUALITY_HIGH = _core_.PRINT_QUALITY_HIGH
167PRINT_QUALITY_MEDIUM = _core_.PRINT_QUALITY_MEDIUM
168PRINT_QUALITY_LOW = _core_.PRINT_QUALITY_LOW
169PRINT_QUALITY_DRAFT = _core_.PRINT_QUALITY_DRAFT
170ID_ANY = _core_.ID_ANY
171ID_SEPARATOR = _core_.ID_SEPARATOR
172ID_LOWEST = _core_.ID_LOWEST
173ID_OPEN = _core_.ID_OPEN
174ID_CLOSE = _core_.ID_CLOSE
175ID_NEW = _core_.ID_NEW
176ID_SAVE = _core_.ID_SAVE
177ID_SAVEAS = _core_.ID_SAVEAS
178ID_REVERT = _core_.ID_REVERT
179ID_EXIT = _core_.ID_EXIT
180ID_UNDO = _core_.ID_UNDO
181ID_REDO = _core_.ID_REDO
182ID_HELP = _core_.ID_HELP
183ID_PRINT = _core_.ID_PRINT
184ID_PRINT_SETUP = _core_.ID_PRINT_SETUP
185ID_PREVIEW = _core_.ID_PREVIEW
186ID_ABOUT = _core_.ID_ABOUT
187ID_HELP_CONTENTS = _core_.ID_HELP_CONTENTS
188ID_HELP_COMMANDS = _core_.ID_HELP_COMMANDS
189ID_HELP_PROCEDURES = _core_.ID_HELP_PROCEDURES
190ID_HELP_CONTEXT = _core_.ID_HELP_CONTEXT
191ID_CLOSE_ALL = _core_.ID_CLOSE_ALL
192ID_PREFERENCES = _core_.ID_PREFERENCES
193ID_CUT = _core_.ID_CUT
194ID_COPY = _core_.ID_COPY
195ID_PASTE = _core_.ID_PASTE
196ID_CLEAR = _core_.ID_CLEAR
197ID_FIND = _core_.ID_FIND
198ID_DUPLICATE = _core_.ID_DUPLICATE
199ID_SELECTALL = _core_.ID_SELECTALL
200ID_DELETE = _core_.ID_DELETE
201ID_REPLACE = _core_.ID_REPLACE
202ID_REPLACE_ALL = _core_.ID_REPLACE_ALL
203ID_PROPERTIES = _core_.ID_PROPERTIES
204ID_VIEW_DETAILS = _core_.ID_VIEW_DETAILS
205ID_VIEW_LARGEICONS = _core_.ID_VIEW_LARGEICONS
206ID_VIEW_SMALLICONS = _core_.ID_VIEW_SMALLICONS
207ID_VIEW_LIST = _core_.ID_VIEW_LIST
208ID_VIEW_SORTDATE = _core_.ID_VIEW_SORTDATE
209ID_VIEW_SORTNAME = _core_.ID_VIEW_SORTNAME
210ID_VIEW_SORTSIZE = _core_.ID_VIEW_SORTSIZE
211ID_VIEW_SORTTYPE = _core_.ID_VIEW_SORTTYPE
212ID_FILE1 = _core_.ID_FILE1
213ID_FILE2 = _core_.ID_FILE2
214ID_FILE3 = _core_.ID_FILE3
215ID_FILE4 = _core_.ID_FILE4
216ID_FILE5 = _core_.ID_FILE5
217ID_FILE6 = _core_.ID_FILE6
218ID_FILE7 = _core_.ID_FILE7
219ID_FILE8 = _core_.ID_FILE8
220ID_FILE9 = _core_.ID_FILE9
221ID_OK = _core_.ID_OK
222ID_CANCEL = _core_.ID_CANCEL
223ID_APPLY = _core_.ID_APPLY
224ID_YES = _core_.ID_YES
225ID_NO = _core_.ID_NO
226ID_STATIC = _core_.ID_STATIC
227ID_FORWARD = _core_.ID_FORWARD
228ID_BACKWARD = _core_.ID_BACKWARD
229ID_DEFAULT = _core_.ID_DEFAULT
230ID_MORE = _core_.ID_MORE
231ID_SETUP = _core_.ID_SETUP
232ID_RESET = _core_.ID_RESET
233ID_CONTEXT_HELP = _core_.ID_CONTEXT_HELP
234ID_YESTOALL = _core_.ID_YESTOALL
235ID_NOTOALL = _core_.ID_NOTOALL
236ID_ABORT = _core_.ID_ABORT
237ID_RETRY = _core_.ID_RETRY
238ID_IGNORE = _core_.ID_IGNORE
0f63ec68
RD
239ID_ADD = _core_.ID_ADD
240ID_REMOVE = _core_.ID_REMOVE
241ID_UP = _core_.ID_UP
242ID_DOWN = _core_.ID_DOWN
243ID_HOME = _core_.ID_HOME
244ID_REFRESH = _core_.ID_REFRESH
245ID_STOP = _core_.ID_STOP
246ID_INDEX = _core_.ID_INDEX
247ID_BOLD = _core_.ID_BOLD
248ID_ITALIC = _core_.ID_ITALIC
249ID_JUSTIFY_CENTER = _core_.ID_JUSTIFY_CENTER
250ID_JUSTIFY_FILL = _core_.ID_JUSTIFY_FILL
251ID_JUSTIFY_RIGHT = _core_.ID_JUSTIFY_RIGHT
252ID_JUSTIFY_LEFT = _core_.ID_JUSTIFY_LEFT
253ID_UNDERLINE = _core_.ID_UNDERLINE
254ID_INDENT = _core_.ID_INDENT
255ID_UNINDENT = _core_.ID_UNINDENT
256ID_ZOOM_100 = _core_.ID_ZOOM_100
257ID_ZOOM_FIT = _core_.ID_ZOOM_FIT
258ID_ZOOM_IN = _core_.ID_ZOOM_IN
259ID_ZOOM_OUT = _core_.ID_ZOOM_OUT
260ID_UNDELETE = _core_.ID_UNDELETE
261ID_REVERT_TO_SAVED = _core_.ID_REVERT_TO_SAVED
d55e5bfc
RD
262ID_HIGHEST = _core_.ID_HIGHEST
263OPEN = _core_.OPEN
264SAVE = _core_.SAVE
265HIDE_READONLY = _core_.HIDE_READONLY
266OVERWRITE_PROMPT = _core_.OVERWRITE_PROMPT
267FILE_MUST_EXIST = _core_.FILE_MUST_EXIST
268MULTIPLE = _core_.MULTIPLE
269CHANGE_DIR = _core_.CHANGE_DIR
270ACCEL_ALT = _core_.ACCEL_ALT
271ACCEL_CTRL = _core_.ACCEL_CTRL
272ACCEL_SHIFT = _core_.ACCEL_SHIFT
273ACCEL_NORMAL = _core_.ACCEL_NORMAL
274PD_AUTO_HIDE = _core_.PD_AUTO_HIDE
275PD_APP_MODAL = _core_.PD_APP_MODAL
276PD_CAN_ABORT = _core_.PD_CAN_ABORT
277PD_ELAPSED_TIME = _core_.PD_ELAPSED_TIME
278PD_ESTIMATED_TIME = _core_.PD_ESTIMATED_TIME
279PD_REMAINING_TIME = _core_.PD_REMAINING_TIME
62d32a5f
RD
280PD_SMOOTH = _core_.PD_SMOOTH
281PD_CAN_SKIP = _core_.PD_CAN_SKIP
d55e5bfc
RD
282DD_NEW_DIR_BUTTON = _core_.DD_NEW_DIR_BUTTON
283DD_DEFAULT_STYLE = _core_.DD_DEFAULT_STYLE
284MENU_TEAROFF = _core_.MENU_TEAROFF
285MB_DOCKABLE = _core_.MB_DOCKABLE
286NO_FULL_REPAINT_ON_RESIZE = _core_.NO_FULL_REPAINT_ON_RESIZE
287FULL_REPAINT_ON_RESIZE = _core_.FULL_REPAINT_ON_RESIZE
288LI_HORIZONTAL = _core_.LI_HORIZONTAL
289LI_VERTICAL = _core_.LI_VERTICAL
290WS_EX_VALIDATE_RECURSIVELY = _core_.WS_EX_VALIDATE_RECURSIVELY
291WS_EX_BLOCK_EVENTS = _core_.WS_EX_BLOCK_EVENTS
292WS_EX_TRANSIENT = _core_.WS_EX_TRANSIENT
293WS_EX_THEMED_BACKGROUND = _core_.WS_EX_THEMED_BACKGROUND
294WS_EX_PROCESS_IDLE = _core_.WS_EX_PROCESS_IDLE
295WS_EX_PROCESS_UI_UPDATES = _core_.WS_EX_PROCESS_UI_UPDATES
296MM_TEXT = _core_.MM_TEXT
297MM_LOMETRIC = _core_.MM_LOMETRIC
298MM_HIMETRIC = _core_.MM_HIMETRIC
299MM_LOENGLISH = _core_.MM_LOENGLISH
300MM_HIENGLISH = _core_.MM_HIENGLISH
301MM_TWIPS = _core_.MM_TWIPS
302MM_ISOTROPIC = _core_.MM_ISOTROPIC
303MM_ANISOTROPIC = _core_.MM_ANISOTROPIC
304MM_POINTS = _core_.MM_POINTS
305MM_METRIC = _core_.MM_METRIC
306CENTRE = _core_.CENTRE
307CENTER = _core_.CENTER
308HORIZONTAL = _core_.HORIZONTAL
309VERTICAL = _core_.VERTICAL
310BOTH = _core_.BOTH
311LEFT = _core_.LEFT
312RIGHT = _core_.RIGHT
313UP = _core_.UP
314DOWN = _core_.DOWN
315TOP = _core_.TOP
316BOTTOM = _core_.BOTTOM
317NORTH = _core_.NORTH
318SOUTH = _core_.SOUTH
319WEST = _core_.WEST
320EAST = _core_.EAST
321ALL = _core_.ALL
322ALIGN_NOT = _core_.ALIGN_NOT
323ALIGN_CENTER_HORIZONTAL = _core_.ALIGN_CENTER_HORIZONTAL
324ALIGN_CENTRE_HORIZONTAL = _core_.ALIGN_CENTRE_HORIZONTAL
325ALIGN_LEFT = _core_.ALIGN_LEFT
326ALIGN_TOP = _core_.ALIGN_TOP
327ALIGN_RIGHT = _core_.ALIGN_RIGHT
328ALIGN_BOTTOM = _core_.ALIGN_BOTTOM
329ALIGN_CENTER_VERTICAL = _core_.ALIGN_CENTER_VERTICAL
330ALIGN_CENTRE_VERTICAL = _core_.ALIGN_CENTRE_VERTICAL
331ALIGN_CENTER = _core_.ALIGN_CENTER
332ALIGN_CENTRE = _core_.ALIGN_CENTRE
333ALIGN_MASK = _core_.ALIGN_MASK
334STRETCH_NOT = _core_.STRETCH_NOT
335SHRINK = _core_.SHRINK
336GROW = _core_.GROW
337EXPAND = _core_.EXPAND
338SHAPED = _core_.SHAPED
339FIXED_MINSIZE = _core_.FIXED_MINSIZE
340TILE = _core_.TILE
341ADJUST_MINSIZE = _core_.ADJUST_MINSIZE
342BORDER_DEFAULT = _core_.BORDER_DEFAULT
343BORDER_NONE = _core_.BORDER_NONE
344BORDER_STATIC = _core_.BORDER_STATIC
345BORDER_SIMPLE = _core_.BORDER_SIMPLE
346BORDER_RAISED = _core_.BORDER_RAISED
347BORDER_SUNKEN = _core_.BORDER_SUNKEN
348BORDER_DOUBLE = _core_.BORDER_DOUBLE
349BORDER_MASK = _core_.BORDER_MASK
0f63ec68
RD
350BG_STYLE_SYSTEM = _core_.BG_STYLE_SYSTEM
351BG_STYLE_COLOUR = _core_.BG_STYLE_COLOUR
352BG_STYLE_CUSTOM = _core_.BG_STYLE_CUSTOM
d55e5bfc
RD
353DEFAULT = _core_.DEFAULT
354DECORATIVE = _core_.DECORATIVE
355ROMAN = _core_.ROMAN
356SCRIPT = _core_.SCRIPT
357SWISS = _core_.SWISS
358MODERN = _core_.MODERN
359TELETYPE = _core_.TELETYPE
360VARIABLE = _core_.VARIABLE
361FIXED = _core_.FIXED
362NORMAL = _core_.NORMAL
363LIGHT = _core_.LIGHT
364BOLD = _core_.BOLD
365ITALIC = _core_.ITALIC
366SLANT = _core_.SLANT
367SOLID = _core_.SOLID
368DOT = _core_.DOT
369LONG_DASH = _core_.LONG_DASH
370SHORT_DASH = _core_.SHORT_DASH
371DOT_DASH = _core_.DOT_DASH
372USER_DASH = _core_.USER_DASH
373TRANSPARENT = _core_.TRANSPARENT
374STIPPLE = _core_.STIPPLE
d04418a7
RD
375STIPPLE_MASK = _core_.STIPPLE_MASK
376STIPPLE_MASK_OPAQUE = _core_.STIPPLE_MASK_OPAQUE
d55e5bfc
RD
377BDIAGONAL_HATCH = _core_.BDIAGONAL_HATCH
378CROSSDIAG_HATCH = _core_.CROSSDIAG_HATCH
379FDIAGONAL_HATCH = _core_.FDIAGONAL_HATCH
380CROSS_HATCH = _core_.CROSS_HATCH
381HORIZONTAL_HATCH = _core_.HORIZONTAL_HATCH
382VERTICAL_HATCH = _core_.VERTICAL_HATCH
383JOIN_BEVEL = _core_.JOIN_BEVEL
384JOIN_MITER = _core_.JOIN_MITER
385JOIN_ROUND = _core_.JOIN_ROUND
386CAP_ROUND = _core_.CAP_ROUND
387CAP_PROJECTING = _core_.CAP_PROJECTING
388CAP_BUTT = _core_.CAP_BUTT
389CLEAR = _core_.CLEAR
390XOR = _core_.XOR
391INVERT = _core_.INVERT
392OR_REVERSE = _core_.OR_REVERSE
393AND_REVERSE = _core_.AND_REVERSE
394COPY = _core_.COPY
395AND = _core_.AND
396AND_INVERT = _core_.AND_INVERT
397NO_OP = _core_.NO_OP
398NOR = _core_.NOR
399EQUIV = _core_.EQUIV
400SRC_INVERT = _core_.SRC_INVERT
401OR_INVERT = _core_.OR_INVERT
402NAND = _core_.NAND
403OR = _core_.OR
404SET = _core_.SET
405WXK_BACK = _core_.WXK_BACK
406WXK_TAB = _core_.WXK_TAB
407WXK_RETURN = _core_.WXK_RETURN
408WXK_ESCAPE = _core_.WXK_ESCAPE
409WXK_SPACE = _core_.WXK_SPACE
410WXK_DELETE = _core_.WXK_DELETE
411WXK_START = _core_.WXK_START
412WXK_LBUTTON = _core_.WXK_LBUTTON
413WXK_RBUTTON = _core_.WXK_RBUTTON
414WXK_CANCEL = _core_.WXK_CANCEL
415WXK_MBUTTON = _core_.WXK_MBUTTON
416WXK_CLEAR = _core_.WXK_CLEAR
417WXK_SHIFT = _core_.WXK_SHIFT
418WXK_ALT = _core_.WXK_ALT
419WXK_CONTROL = _core_.WXK_CONTROL
420WXK_MENU = _core_.WXK_MENU
421WXK_PAUSE = _core_.WXK_PAUSE
422WXK_CAPITAL = _core_.WXK_CAPITAL
423WXK_PRIOR = _core_.WXK_PRIOR
424WXK_NEXT = _core_.WXK_NEXT
425WXK_END = _core_.WXK_END
426WXK_HOME = _core_.WXK_HOME
427WXK_LEFT = _core_.WXK_LEFT
428WXK_UP = _core_.WXK_UP
429WXK_RIGHT = _core_.WXK_RIGHT
430WXK_DOWN = _core_.WXK_DOWN
431WXK_SELECT = _core_.WXK_SELECT
432WXK_PRINT = _core_.WXK_PRINT
433WXK_EXECUTE = _core_.WXK_EXECUTE
434WXK_SNAPSHOT = _core_.WXK_SNAPSHOT
435WXK_INSERT = _core_.WXK_INSERT
436WXK_HELP = _core_.WXK_HELP
437WXK_NUMPAD0 = _core_.WXK_NUMPAD0
438WXK_NUMPAD1 = _core_.WXK_NUMPAD1
439WXK_NUMPAD2 = _core_.WXK_NUMPAD2
440WXK_NUMPAD3 = _core_.WXK_NUMPAD3
441WXK_NUMPAD4 = _core_.WXK_NUMPAD4
442WXK_NUMPAD5 = _core_.WXK_NUMPAD5
443WXK_NUMPAD6 = _core_.WXK_NUMPAD6
444WXK_NUMPAD7 = _core_.WXK_NUMPAD7
445WXK_NUMPAD8 = _core_.WXK_NUMPAD8
446WXK_NUMPAD9 = _core_.WXK_NUMPAD9
447WXK_MULTIPLY = _core_.WXK_MULTIPLY
448WXK_ADD = _core_.WXK_ADD
449WXK_SEPARATOR = _core_.WXK_SEPARATOR
450WXK_SUBTRACT = _core_.WXK_SUBTRACT
451WXK_DECIMAL = _core_.WXK_DECIMAL
452WXK_DIVIDE = _core_.WXK_DIVIDE
453WXK_F1 = _core_.WXK_F1
454WXK_F2 = _core_.WXK_F2
455WXK_F3 = _core_.WXK_F3
456WXK_F4 = _core_.WXK_F4
457WXK_F5 = _core_.WXK_F5
458WXK_F6 = _core_.WXK_F6
459WXK_F7 = _core_.WXK_F7
460WXK_F8 = _core_.WXK_F8
461WXK_F9 = _core_.WXK_F9
462WXK_F10 = _core_.WXK_F10
463WXK_F11 = _core_.WXK_F11
464WXK_F12 = _core_.WXK_F12
465WXK_F13 = _core_.WXK_F13
466WXK_F14 = _core_.WXK_F14
467WXK_F15 = _core_.WXK_F15
468WXK_F16 = _core_.WXK_F16
469WXK_F17 = _core_.WXK_F17
470WXK_F18 = _core_.WXK_F18
471WXK_F19 = _core_.WXK_F19
472WXK_F20 = _core_.WXK_F20
473WXK_F21 = _core_.WXK_F21
474WXK_F22 = _core_.WXK_F22
475WXK_F23 = _core_.WXK_F23
476WXK_F24 = _core_.WXK_F24
477WXK_NUMLOCK = _core_.WXK_NUMLOCK
478WXK_SCROLL = _core_.WXK_SCROLL
479WXK_PAGEUP = _core_.WXK_PAGEUP
480WXK_PAGEDOWN = _core_.WXK_PAGEDOWN
481WXK_NUMPAD_SPACE = _core_.WXK_NUMPAD_SPACE
482WXK_NUMPAD_TAB = _core_.WXK_NUMPAD_TAB
483WXK_NUMPAD_ENTER = _core_.WXK_NUMPAD_ENTER
484WXK_NUMPAD_F1 = _core_.WXK_NUMPAD_F1
485WXK_NUMPAD_F2 = _core_.WXK_NUMPAD_F2
486WXK_NUMPAD_F3 = _core_.WXK_NUMPAD_F3
487WXK_NUMPAD_F4 = _core_.WXK_NUMPAD_F4
488WXK_NUMPAD_HOME = _core_.WXK_NUMPAD_HOME
489WXK_NUMPAD_LEFT = _core_.WXK_NUMPAD_LEFT
490WXK_NUMPAD_UP = _core_.WXK_NUMPAD_UP
491WXK_NUMPAD_RIGHT = _core_.WXK_NUMPAD_RIGHT
492WXK_NUMPAD_DOWN = _core_.WXK_NUMPAD_DOWN
493WXK_NUMPAD_PRIOR = _core_.WXK_NUMPAD_PRIOR
494WXK_NUMPAD_PAGEUP = _core_.WXK_NUMPAD_PAGEUP
495WXK_NUMPAD_NEXT = _core_.WXK_NUMPAD_NEXT
496WXK_NUMPAD_PAGEDOWN = _core_.WXK_NUMPAD_PAGEDOWN
497WXK_NUMPAD_END = _core_.WXK_NUMPAD_END
498WXK_NUMPAD_BEGIN = _core_.WXK_NUMPAD_BEGIN
499WXK_NUMPAD_INSERT = _core_.WXK_NUMPAD_INSERT
500WXK_NUMPAD_DELETE = _core_.WXK_NUMPAD_DELETE
501WXK_NUMPAD_EQUAL = _core_.WXK_NUMPAD_EQUAL
502WXK_NUMPAD_MULTIPLY = _core_.WXK_NUMPAD_MULTIPLY
503WXK_NUMPAD_ADD = _core_.WXK_NUMPAD_ADD
504WXK_NUMPAD_SEPARATOR = _core_.WXK_NUMPAD_SEPARATOR
505WXK_NUMPAD_SUBTRACT = _core_.WXK_NUMPAD_SUBTRACT
506WXK_NUMPAD_DECIMAL = _core_.WXK_NUMPAD_DECIMAL
507WXK_NUMPAD_DIVIDE = _core_.WXK_NUMPAD_DIVIDE
508WXK_WINDOWS_LEFT = _core_.WXK_WINDOWS_LEFT
509WXK_WINDOWS_RIGHT = _core_.WXK_WINDOWS_RIGHT
510WXK_WINDOWS_MENU = _core_.WXK_WINDOWS_MENU
88c6b281
RD
511WXK_COMMAND = _core_.WXK_COMMAND
512WXK_SPECIAL1 = _core_.WXK_SPECIAL1
513WXK_SPECIAL2 = _core_.WXK_SPECIAL2
514WXK_SPECIAL3 = _core_.WXK_SPECIAL3
515WXK_SPECIAL4 = _core_.WXK_SPECIAL4
516WXK_SPECIAL5 = _core_.WXK_SPECIAL5
517WXK_SPECIAL6 = _core_.WXK_SPECIAL6
518WXK_SPECIAL7 = _core_.WXK_SPECIAL7
519WXK_SPECIAL8 = _core_.WXK_SPECIAL8
520WXK_SPECIAL9 = _core_.WXK_SPECIAL9
521WXK_SPECIAL10 = _core_.WXK_SPECIAL10
522WXK_SPECIAL11 = _core_.WXK_SPECIAL11
523WXK_SPECIAL12 = _core_.WXK_SPECIAL12
524WXK_SPECIAL13 = _core_.WXK_SPECIAL13
525WXK_SPECIAL14 = _core_.WXK_SPECIAL14
526WXK_SPECIAL15 = _core_.WXK_SPECIAL15
527WXK_SPECIAL16 = _core_.WXK_SPECIAL16
528WXK_SPECIAL17 = _core_.WXK_SPECIAL17
529WXK_SPECIAL18 = _core_.WXK_SPECIAL18
530WXK_SPECIAL19 = _core_.WXK_SPECIAL19
531WXK_SPECIAL20 = _core_.WXK_SPECIAL20
d55e5bfc
RD
532PAPER_NONE = _core_.PAPER_NONE
533PAPER_LETTER = _core_.PAPER_LETTER
534PAPER_LEGAL = _core_.PAPER_LEGAL
535PAPER_A4 = _core_.PAPER_A4
536PAPER_CSHEET = _core_.PAPER_CSHEET
537PAPER_DSHEET = _core_.PAPER_DSHEET
538PAPER_ESHEET = _core_.PAPER_ESHEET
539PAPER_LETTERSMALL = _core_.PAPER_LETTERSMALL
540PAPER_TABLOID = _core_.PAPER_TABLOID
541PAPER_LEDGER = _core_.PAPER_LEDGER
542PAPER_STATEMENT = _core_.PAPER_STATEMENT
543PAPER_EXECUTIVE = _core_.PAPER_EXECUTIVE
544PAPER_A3 = _core_.PAPER_A3
545PAPER_A4SMALL = _core_.PAPER_A4SMALL
546PAPER_A5 = _core_.PAPER_A5
547PAPER_B4 = _core_.PAPER_B4
548PAPER_B5 = _core_.PAPER_B5
549PAPER_FOLIO = _core_.PAPER_FOLIO
550PAPER_QUARTO = _core_.PAPER_QUARTO
551PAPER_10X14 = _core_.PAPER_10X14
552PAPER_11X17 = _core_.PAPER_11X17
553PAPER_NOTE = _core_.PAPER_NOTE
554PAPER_ENV_9 = _core_.PAPER_ENV_9
555PAPER_ENV_10 = _core_.PAPER_ENV_10
556PAPER_ENV_11 = _core_.PAPER_ENV_11
557PAPER_ENV_12 = _core_.PAPER_ENV_12
558PAPER_ENV_14 = _core_.PAPER_ENV_14
559PAPER_ENV_DL = _core_.PAPER_ENV_DL
560PAPER_ENV_C5 = _core_.PAPER_ENV_C5
561PAPER_ENV_C3 = _core_.PAPER_ENV_C3
562PAPER_ENV_C4 = _core_.PAPER_ENV_C4
563PAPER_ENV_C6 = _core_.PAPER_ENV_C6
564PAPER_ENV_C65 = _core_.PAPER_ENV_C65
565PAPER_ENV_B4 = _core_.PAPER_ENV_B4
566PAPER_ENV_B5 = _core_.PAPER_ENV_B5
567PAPER_ENV_B6 = _core_.PAPER_ENV_B6
568PAPER_ENV_ITALY = _core_.PAPER_ENV_ITALY
569PAPER_ENV_MONARCH = _core_.PAPER_ENV_MONARCH
570PAPER_ENV_PERSONAL = _core_.PAPER_ENV_PERSONAL
571PAPER_FANFOLD_US = _core_.PAPER_FANFOLD_US
572PAPER_FANFOLD_STD_GERMAN = _core_.PAPER_FANFOLD_STD_GERMAN
573PAPER_FANFOLD_LGL_GERMAN = _core_.PAPER_FANFOLD_LGL_GERMAN
574PAPER_ISO_B4 = _core_.PAPER_ISO_B4
575PAPER_JAPANESE_POSTCARD = _core_.PAPER_JAPANESE_POSTCARD
576PAPER_9X11 = _core_.PAPER_9X11
577PAPER_10X11 = _core_.PAPER_10X11
578PAPER_15X11 = _core_.PAPER_15X11
579PAPER_ENV_INVITE = _core_.PAPER_ENV_INVITE
580PAPER_LETTER_EXTRA = _core_.PAPER_LETTER_EXTRA
581PAPER_LEGAL_EXTRA = _core_.PAPER_LEGAL_EXTRA
582PAPER_TABLOID_EXTRA = _core_.PAPER_TABLOID_EXTRA
583PAPER_A4_EXTRA = _core_.PAPER_A4_EXTRA
584PAPER_LETTER_TRANSVERSE = _core_.PAPER_LETTER_TRANSVERSE
585PAPER_A4_TRANSVERSE = _core_.PAPER_A4_TRANSVERSE
586PAPER_LETTER_EXTRA_TRANSVERSE = _core_.PAPER_LETTER_EXTRA_TRANSVERSE
587PAPER_A_PLUS = _core_.PAPER_A_PLUS
588PAPER_B_PLUS = _core_.PAPER_B_PLUS
589PAPER_LETTER_PLUS = _core_.PAPER_LETTER_PLUS
590PAPER_A4_PLUS = _core_.PAPER_A4_PLUS
591PAPER_A5_TRANSVERSE = _core_.PAPER_A5_TRANSVERSE
592PAPER_B5_TRANSVERSE = _core_.PAPER_B5_TRANSVERSE
593PAPER_A3_EXTRA = _core_.PAPER_A3_EXTRA
594PAPER_A5_EXTRA = _core_.PAPER_A5_EXTRA
595PAPER_B5_EXTRA = _core_.PAPER_B5_EXTRA
596PAPER_A2 = _core_.PAPER_A2
597PAPER_A3_TRANSVERSE = _core_.PAPER_A3_TRANSVERSE
598PAPER_A3_EXTRA_TRANSVERSE = _core_.PAPER_A3_EXTRA_TRANSVERSE
034e3677
RD
599PAPER_DBL_JAPANESE_POSTCARD = _core_.PAPER_DBL_JAPANESE_POSTCARD
600PAPER_A6 = _core_.PAPER_A6
601PAPER_JENV_KAKU2 = _core_.PAPER_JENV_KAKU2
602PAPER_JENV_KAKU3 = _core_.PAPER_JENV_KAKU3
603PAPER_JENV_CHOU3 = _core_.PAPER_JENV_CHOU3
604PAPER_JENV_CHOU4 = _core_.PAPER_JENV_CHOU4
605PAPER_LETTER_ROTATED = _core_.PAPER_LETTER_ROTATED
606PAPER_A3_ROTATED = _core_.PAPER_A3_ROTATED
607PAPER_A4_ROTATED = _core_.PAPER_A4_ROTATED
608PAPER_A5_ROTATED = _core_.PAPER_A5_ROTATED
609PAPER_B4_JIS_ROTATED = _core_.PAPER_B4_JIS_ROTATED
610PAPER_B5_JIS_ROTATED = _core_.PAPER_B5_JIS_ROTATED
611PAPER_JAPANESE_POSTCARD_ROTATED = _core_.PAPER_JAPANESE_POSTCARD_ROTATED
612PAPER_DBL_JAPANESE_POSTCARD_ROTATED = _core_.PAPER_DBL_JAPANESE_POSTCARD_ROTATED
613PAPER_A6_ROTATED = _core_.PAPER_A6_ROTATED
614PAPER_JENV_KAKU2_ROTATED = _core_.PAPER_JENV_KAKU2_ROTATED
615PAPER_JENV_KAKU3_ROTATED = _core_.PAPER_JENV_KAKU3_ROTATED
616PAPER_JENV_CHOU3_ROTATED = _core_.PAPER_JENV_CHOU3_ROTATED
617PAPER_JENV_CHOU4_ROTATED = _core_.PAPER_JENV_CHOU4_ROTATED
618PAPER_B6_JIS = _core_.PAPER_B6_JIS
619PAPER_B6_JIS_ROTATED = _core_.PAPER_B6_JIS_ROTATED
620PAPER_12X11 = _core_.PAPER_12X11
621PAPER_JENV_YOU4 = _core_.PAPER_JENV_YOU4
622PAPER_JENV_YOU4_ROTATED = _core_.PAPER_JENV_YOU4_ROTATED
623PAPER_P16K = _core_.PAPER_P16K
624PAPER_P32K = _core_.PAPER_P32K
625PAPER_P32KBIG = _core_.PAPER_P32KBIG
626PAPER_PENV_1 = _core_.PAPER_PENV_1
627PAPER_PENV_2 = _core_.PAPER_PENV_2
628PAPER_PENV_3 = _core_.PAPER_PENV_3
629PAPER_PENV_4 = _core_.PAPER_PENV_4
630PAPER_PENV_5 = _core_.PAPER_PENV_5
631PAPER_PENV_6 = _core_.PAPER_PENV_6
632PAPER_PENV_7 = _core_.PAPER_PENV_7
633PAPER_PENV_8 = _core_.PAPER_PENV_8
634PAPER_PENV_9 = _core_.PAPER_PENV_9
635PAPER_PENV_10 = _core_.PAPER_PENV_10
636PAPER_P16K_ROTATED = _core_.PAPER_P16K_ROTATED
637PAPER_P32K_ROTATED = _core_.PAPER_P32K_ROTATED
638PAPER_P32KBIG_ROTATED = _core_.PAPER_P32KBIG_ROTATED
639PAPER_PENV_1_ROTATED = _core_.PAPER_PENV_1_ROTATED
640PAPER_PENV_2_ROTATED = _core_.PAPER_PENV_2_ROTATED
641PAPER_PENV_3_ROTATED = _core_.PAPER_PENV_3_ROTATED
642PAPER_PENV_4_ROTATED = _core_.PAPER_PENV_4_ROTATED
643PAPER_PENV_5_ROTATED = _core_.PAPER_PENV_5_ROTATED
644PAPER_PENV_6_ROTATED = _core_.PAPER_PENV_6_ROTATED
645PAPER_PENV_7_ROTATED = _core_.PAPER_PENV_7_ROTATED
646PAPER_PENV_8_ROTATED = _core_.PAPER_PENV_8_ROTATED
647PAPER_PENV_9_ROTATED = _core_.PAPER_PENV_9_ROTATED
648PAPER_PENV_10_ROTATED = _core_.PAPER_PENV_10_ROTATED
d55e5bfc
RD
649DUPLEX_SIMPLEX = _core_.DUPLEX_SIMPLEX
650DUPLEX_HORIZONTAL = _core_.DUPLEX_HORIZONTAL
651DUPLEX_VERTICAL = _core_.DUPLEX_VERTICAL
652ITEM_SEPARATOR = _core_.ITEM_SEPARATOR
653ITEM_NORMAL = _core_.ITEM_NORMAL
654ITEM_CHECK = _core_.ITEM_CHECK
655ITEM_RADIO = _core_.ITEM_RADIO
656ITEM_MAX = _core_.ITEM_MAX
657HT_NOWHERE = _core_.HT_NOWHERE
658HT_SCROLLBAR_FIRST = _core_.HT_SCROLLBAR_FIRST
659HT_SCROLLBAR_ARROW_LINE_1 = _core_.HT_SCROLLBAR_ARROW_LINE_1
660HT_SCROLLBAR_ARROW_LINE_2 = _core_.HT_SCROLLBAR_ARROW_LINE_2
661HT_SCROLLBAR_ARROW_PAGE_1 = _core_.HT_SCROLLBAR_ARROW_PAGE_1
662HT_SCROLLBAR_ARROW_PAGE_2 = _core_.HT_SCROLLBAR_ARROW_PAGE_2
663HT_SCROLLBAR_THUMB = _core_.HT_SCROLLBAR_THUMB
664HT_SCROLLBAR_BAR_1 = _core_.HT_SCROLLBAR_BAR_1
665HT_SCROLLBAR_BAR_2 = _core_.HT_SCROLLBAR_BAR_2
666HT_SCROLLBAR_LAST = _core_.HT_SCROLLBAR_LAST
667HT_WINDOW_OUTSIDE = _core_.HT_WINDOW_OUTSIDE
668HT_WINDOW_INSIDE = _core_.HT_WINDOW_INSIDE
669HT_WINDOW_VERT_SCROLLBAR = _core_.HT_WINDOW_VERT_SCROLLBAR
670HT_WINDOW_HORZ_SCROLLBAR = _core_.HT_WINDOW_HORZ_SCROLLBAR
671HT_WINDOW_CORNER = _core_.HT_WINDOW_CORNER
672HT_MAX = _core_.HT_MAX
673MOD_NONE = _core_.MOD_NONE
674MOD_ALT = _core_.MOD_ALT
675MOD_CONTROL = _core_.MOD_CONTROL
676MOD_SHIFT = _core_.MOD_SHIFT
677MOD_WIN = _core_.MOD_WIN
678UPDATE_UI_NONE = _core_.UPDATE_UI_NONE
679UPDATE_UI_RECURSE = _core_.UPDATE_UI_RECURSE
680UPDATE_UI_FROMIDLE = _core_.UPDATE_UI_FROMIDLE
681#---------------------------------------------------------------------------
682
683class Object(object):
684 """
685 The base class for most wx objects, although in wxPython not
686 much functionality is needed nor exposed.
687 """
688 def __init__(self): raise RuntimeError, "No constructor defined"
689 def __repr__(self):
690 return "<%s.%s; proxy of C++ wxObject instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
691 def GetClassName(*args, **kwargs):
692 """
693 GetClassName(self) -> String
694
695 Returns the class name of the C++ class using wxRTTI.
696 """
697 return _core_.Object_GetClassName(*args, **kwargs)
698
699 def Destroy(*args, **kwargs):
700 """
701 Destroy(self)
702
703 Deletes the C++ object this Python object is a proxy for.
704 """
705 return _core_.Object_Destroy(*args, **kwargs)
706
707
708class ObjectPtr(Object):
709 def __init__(self, this):
710 self.this = this
711 if not hasattr(self,"thisown"): self.thisown = 0
712 self.__class__ = Object
713_core_.Object_swigregister(ObjectPtr)
714_wxPySetDictionary = _core_._wxPySetDictionary
715
716_wxPyFixStockObjects = _core_._wxPyFixStockObjects
717
718cvar = _core_.cvar
719EmptyString = cvar.EmptyString
720
721#---------------------------------------------------------------------------
722
723BITMAP_TYPE_INVALID = _core_.BITMAP_TYPE_INVALID
724BITMAP_TYPE_BMP = _core_.BITMAP_TYPE_BMP
725BITMAP_TYPE_ICO = _core_.BITMAP_TYPE_ICO
726BITMAP_TYPE_CUR = _core_.BITMAP_TYPE_CUR
727BITMAP_TYPE_XBM = _core_.BITMAP_TYPE_XBM
728BITMAP_TYPE_XBM_DATA = _core_.BITMAP_TYPE_XBM_DATA
729BITMAP_TYPE_XPM = _core_.BITMAP_TYPE_XPM
730BITMAP_TYPE_XPM_DATA = _core_.BITMAP_TYPE_XPM_DATA
731BITMAP_TYPE_TIF = _core_.BITMAP_TYPE_TIF
732BITMAP_TYPE_GIF = _core_.BITMAP_TYPE_GIF
733BITMAP_TYPE_PNG = _core_.BITMAP_TYPE_PNG
734BITMAP_TYPE_JPEG = _core_.BITMAP_TYPE_JPEG
735BITMAP_TYPE_PNM = _core_.BITMAP_TYPE_PNM
736BITMAP_TYPE_PCX = _core_.BITMAP_TYPE_PCX
737BITMAP_TYPE_PICT = _core_.BITMAP_TYPE_PICT
738BITMAP_TYPE_ICON = _core_.BITMAP_TYPE_ICON
739BITMAP_TYPE_ANI = _core_.BITMAP_TYPE_ANI
740BITMAP_TYPE_IFF = _core_.BITMAP_TYPE_IFF
741BITMAP_TYPE_MACCURSOR = _core_.BITMAP_TYPE_MACCURSOR
742BITMAP_TYPE_ANY = _core_.BITMAP_TYPE_ANY
743CURSOR_NONE = _core_.CURSOR_NONE
744CURSOR_ARROW = _core_.CURSOR_ARROW
745CURSOR_RIGHT_ARROW = _core_.CURSOR_RIGHT_ARROW
746CURSOR_BULLSEYE = _core_.CURSOR_BULLSEYE
747CURSOR_CHAR = _core_.CURSOR_CHAR
748CURSOR_CROSS = _core_.CURSOR_CROSS
749CURSOR_HAND = _core_.CURSOR_HAND
750CURSOR_IBEAM = _core_.CURSOR_IBEAM
751CURSOR_LEFT_BUTTON = _core_.CURSOR_LEFT_BUTTON
752CURSOR_MAGNIFIER = _core_.CURSOR_MAGNIFIER
753CURSOR_MIDDLE_BUTTON = _core_.CURSOR_MIDDLE_BUTTON
754CURSOR_NO_ENTRY = _core_.CURSOR_NO_ENTRY
755CURSOR_PAINT_BRUSH = _core_.CURSOR_PAINT_BRUSH
756CURSOR_PENCIL = _core_.CURSOR_PENCIL
757CURSOR_POINT_LEFT = _core_.CURSOR_POINT_LEFT
758CURSOR_POINT_RIGHT = _core_.CURSOR_POINT_RIGHT
759CURSOR_QUESTION_ARROW = _core_.CURSOR_QUESTION_ARROW
760CURSOR_RIGHT_BUTTON = _core_.CURSOR_RIGHT_BUTTON
761CURSOR_SIZENESW = _core_.CURSOR_SIZENESW
762CURSOR_SIZENS = _core_.CURSOR_SIZENS
763CURSOR_SIZENWSE = _core_.CURSOR_SIZENWSE
764CURSOR_SIZEWE = _core_.CURSOR_SIZEWE
765CURSOR_SIZING = _core_.CURSOR_SIZING
766CURSOR_SPRAYCAN = _core_.CURSOR_SPRAYCAN
767CURSOR_WAIT = _core_.CURSOR_WAIT
768CURSOR_WATCH = _core_.CURSOR_WATCH
769CURSOR_BLANK = _core_.CURSOR_BLANK
770CURSOR_DEFAULT = _core_.CURSOR_DEFAULT
771CURSOR_COPY_ARROW = _core_.CURSOR_COPY_ARROW
772CURSOR_ARROWWAIT = _core_.CURSOR_ARROWWAIT
773CURSOR_MAX = _core_.CURSOR_MAX
774#---------------------------------------------------------------------------
775
776class Size(object):
777 """
79fccf9d 778 wx.Size is a useful data structure used to represent the size of
093d3ff1
RD
779 something. It simply contians integer width and height
780 proprtites. In most places in wxPython where a wx.Size is
781 expected a (width, height) tuple can be used instead.
d55e5bfc
RD
782 """
783 def __repr__(self):
784 return "<%s.%s; proxy of C++ wxSize instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
785 width = property(_core_.Size_width_get, _core_.Size_width_set)
786 height = property(_core_.Size_height_get, _core_.Size_height_set)
787 x = width; y = height
788 def __init__(self, *args, **kwargs):
789 """
790 __init__(self, int w=0, int h=0) -> Size
791
792 Creates a size object.
793 """
794 newobj = _core_.new_Size(*args, **kwargs)
795 self.this = newobj.this
796 self.thisown = 1
797 del newobj.thisown
798 def __del__(self, destroy=_core_.delete_Size):
799 """__del__(self)"""
800 try:
801 if self.thisown: destroy(self)
802 except: pass
803
804 def __eq__(*args, **kwargs):
805 """
806 __eq__(self, Size sz) -> bool
807
808 Test for equality of wx.Size objects.
809 """
810 return _core_.Size___eq__(*args, **kwargs)
811
812 def __ne__(*args, **kwargs):
813 """
814 __ne__(self, Size sz) -> bool
815
816 Test for inequality.
817 """
818 return _core_.Size___ne__(*args, **kwargs)
819
820 def __add__(*args, **kwargs):
821 """
822 __add__(self, Size sz) -> Size
823
824 Add sz's proprties to this and return the result.
825 """
826 return _core_.Size___add__(*args, **kwargs)
827
828 def __sub__(*args, **kwargs):
829 """
830 __sub__(self, Size sz) -> Size
831
832 Subtract sz's properties from this and return the result.
833 """
834 return _core_.Size___sub__(*args, **kwargs)
835
836 def IncTo(*args, **kwargs):
837 """
838 IncTo(self, Size sz)
839
840 Increments this object so that both of its dimensions are not less
841 than the corresponding dimensions of the size.
842 """
843 return _core_.Size_IncTo(*args, **kwargs)
844
845 def DecTo(*args, **kwargs):
846 """
847 DecTo(self, Size sz)
848
849 Decrements this object so that both of its dimensions are not greater
850 than the corresponding dimensions of the size.
851 """
852 return _core_.Size_DecTo(*args, **kwargs)
853
854 def Set(*args, **kwargs):
855 """
856 Set(self, int w, int h)
857
858 Set both width and height.
859 """
860 return _core_.Size_Set(*args, **kwargs)
861
862 def SetWidth(*args, **kwargs):
863 """SetWidth(self, int w)"""
864 return _core_.Size_SetWidth(*args, **kwargs)
865
866 def SetHeight(*args, **kwargs):
867 """SetHeight(self, int h)"""
868 return _core_.Size_SetHeight(*args, **kwargs)
869
870 def GetWidth(*args, **kwargs):
871 """GetWidth(self) -> int"""
872 return _core_.Size_GetWidth(*args, **kwargs)
873
874 def GetHeight(*args, **kwargs):
875 """GetHeight(self) -> int"""
876 return _core_.Size_GetHeight(*args, **kwargs)
877
878 def IsFullySpecified(*args, **kwargs):
879 """
880 IsFullySpecified(self) -> bool
881
882 Returns True if both components of the size are non-default values.
883 """
884 return _core_.Size_IsFullySpecified(*args, **kwargs)
885
886 def SetDefaults(*args, **kwargs):
887 """
888 SetDefaults(self, Size size)
889
79fccf9d
RD
890 Combine this size with the other one replacing the default components
891 of this object (i.e. equal to -1) with those of the other.
d55e5bfc
RD
892 """
893 return _core_.Size_SetDefaults(*args, **kwargs)
894
895 def Get(*args, **kwargs):
896 """
897 Get() -> (width,height)
898
899 Returns the width and height properties as a tuple.
900 """
901 return _core_.Size_Get(*args, **kwargs)
902
79fccf9d 903 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
d55e5bfc
RD
904 def __str__(self): return str(self.Get())
905 def __repr__(self): return 'wx.Size'+str(self.Get())
906 def __len__(self): return len(self.Get())
907 def __getitem__(self, index): return self.Get()[index]
908 def __setitem__(self, index, val):
909 if index == 0: self.width = val
910 elif index == 1: self.height = val
911 else: raise IndexError
912 def __nonzero__(self): return self.Get() != (0,0)
913 __safe_for_unpickling__ = True
914 def __reduce__(self): return (wx.Size, self.Get())
915
916
917class SizePtr(Size):
918 def __init__(self, this):
919 self.this = this
920 if not hasattr(self,"thisown"): self.thisown = 0
921 self.__class__ = Size
922_core_.Size_swigregister(SizePtr)
923
924#---------------------------------------------------------------------------
925
926class RealPoint(object):
927 """
79fccf9d
RD
928 A data structure for representing a point or position with floating
929 point x and y properties. In wxPython most places that expect a
930 wx.RealPoint can also accept a (x,y) tuple.
d55e5bfc
RD
931 """
932 def __repr__(self):
933 return "<%s.%s; proxy of C++ wxRealPoint instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
934 x = property(_core_.RealPoint_x_get, _core_.RealPoint_x_set)
935 y = property(_core_.RealPoint_y_get, _core_.RealPoint_y_set)
936 def __init__(self, *args, **kwargs):
937 """
938 __init__(self, double x=0.0, double y=0.0) -> RealPoint
939
940 Create a wx.RealPoint object
941 """
942 newobj = _core_.new_RealPoint(*args, **kwargs)
943 self.this = newobj.this
944 self.thisown = 1
945 del newobj.thisown
946 def __del__(self, destroy=_core_.delete_RealPoint):
947 """__del__(self)"""
948 try:
949 if self.thisown: destroy(self)
950 except: pass
951
952 def __eq__(*args, **kwargs):
953 """
954 __eq__(self, RealPoint pt) -> bool
955
956 Test for equality of wx.RealPoint objects.
957 """
958 return _core_.RealPoint___eq__(*args, **kwargs)
959
960 def __ne__(*args, **kwargs):
961 """
962 __ne__(self, RealPoint pt) -> bool
963
964 Test for inequality of wx.RealPoint objects.
965 """
966 return _core_.RealPoint___ne__(*args, **kwargs)
967
968 def __add__(*args, **kwargs):
969 """
970 __add__(self, RealPoint pt) -> RealPoint
971
972 Add pt's proprties to this and return the result.
973 """
974 return _core_.RealPoint___add__(*args, **kwargs)
975
976 def __sub__(*args, **kwargs):
977 """
978 __sub__(self, RealPoint pt) -> RealPoint
979
980 Subtract pt's proprties from this and return the result
981 """
982 return _core_.RealPoint___sub__(*args, **kwargs)
983
984 def Set(*args, **kwargs):
985 """
986 Set(self, double x, double y)
987
988 Set both the x and y properties
989 """
990 return _core_.RealPoint_Set(*args, **kwargs)
991
992 def Get(*args, **kwargs):
993 """
994 Get() -> (x,y)
995
996 Return the x and y properties as a tuple.
997 """
998 return _core_.RealPoint_Get(*args, **kwargs)
999
79fccf9d 1000 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
d55e5bfc
RD
1001 def __str__(self): return str(self.Get())
1002 def __repr__(self): return 'wx.RealPoint'+str(self.Get())
1003 def __len__(self): return len(self.Get())
1004 def __getitem__(self, index): return self.Get()[index]
1005 def __setitem__(self, index, val):
1006 if index == 0: self.x = val
1007 elif index == 1: self.y = val
1008 else: raise IndexError
1009 def __nonzero__(self): return self.Get() != (0.0, 0.0)
1010 __safe_for_unpickling__ = True
1011 def __reduce__(self): return (wx.RealPoint, self.Get())
1012
1013
1014class RealPointPtr(RealPoint):
1015 def __init__(self, this):
1016 self.this = this
1017 if not hasattr(self,"thisown"): self.thisown = 0
1018 self.__class__ = RealPoint
1019_core_.RealPoint_swigregister(RealPointPtr)
1020
1021#---------------------------------------------------------------------------
1022
1023class Point(object):
1024 """
79fccf9d
RD
1025 A data structure for representing a point or position with integer x
1026 and y properties. Most places in wxPython that expect a wx.Point can
1027 also accept a (x,y) tuple.
d55e5bfc
RD
1028 """
1029 def __repr__(self):
1030 return "<%s.%s; proxy of C++ wxPoint instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1031 x = property(_core_.Point_x_get, _core_.Point_x_set)
1032 y = property(_core_.Point_y_get, _core_.Point_y_set)
1033 def __init__(self, *args, **kwargs):
1034 """
1035 __init__(self, int x=0, int y=0) -> Point
1036
1037 Create a wx.Point object
1038 """
1039 newobj = _core_.new_Point(*args, **kwargs)
1040 self.this = newobj.this
1041 self.thisown = 1
1042 del newobj.thisown
1043 def __del__(self, destroy=_core_.delete_Point):
1044 """__del__(self)"""
1045 try:
1046 if self.thisown: destroy(self)
1047 except: pass
1048
1049 def __eq__(*args, **kwargs):
1050 """
1051 __eq__(self, Point pt) -> bool
1052
1053 Test for equality of wx.Point objects.
1054 """
1055 return _core_.Point___eq__(*args, **kwargs)
1056
1057 def __ne__(*args, **kwargs):
1058 """
1059 __ne__(self, Point pt) -> bool
1060
1061 Test for inequality of wx.Point objects.
1062 """
1063 return _core_.Point___ne__(*args, **kwargs)
1064
1065 def __add__(*args, **kwargs):
1066 """
1067 __add__(self, Point pt) -> Point
1068
1069 Add pt's proprties to this and return the result.
1070 """
1071 return _core_.Point___add__(*args, **kwargs)
1072
1073 def __sub__(*args, **kwargs):
1074 """
1075 __sub__(self, Point pt) -> Point
1076
1077 Subtract pt's proprties from this and return the result
1078 """
1079 return _core_.Point___sub__(*args, **kwargs)
1080
1081 def __iadd__(*args, **kwargs):
1082 """
1083 __iadd__(self, Point pt) -> Point
1084
1085 Add pt to this object.
1086 """
1087 return _core_.Point___iadd__(*args, **kwargs)
1088
1089 def __isub__(*args, **kwargs):
1090 """
1091 __isub__(self, Point pt) -> Point
1092
1093 Subtract pt from this object.
1094 """
1095 return _core_.Point___isub__(*args, **kwargs)
1096
1097 def Set(*args, **kwargs):
1098 """
1099 Set(self, long x, long y)
1100
1101 Set both the x and y properties
1102 """
1103 return _core_.Point_Set(*args, **kwargs)
1104
1105 def Get(*args, **kwargs):
1106 """
1107 Get() -> (x,y)
1108
1109 Return the x and y properties as a tuple.
1110 """
1111 return _core_.Point_Get(*args, **kwargs)
1112
79fccf9d 1113 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
d55e5bfc
RD
1114 def __str__(self): return str(self.Get())
1115 def __repr__(self): return 'wx.Point'+str(self.Get())
1116 def __len__(self): return len(self.Get())
1117 def __getitem__(self, index): return self.Get()[index]
1118 def __setitem__(self, index, val):
1119 if index == 0: self.x = val
1120 elif index == 1: self.y = val
1121 else: raise IndexError
1122 def __nonzero__(self): return self.Get() != (0,0)
1123 __safe_for_unpickling__ = True
1124 def __reduce__(self): return (wx.Point, self.Get())
1125
1126
1127class PointPtr(Point):
1128 def __init__(self, this):
1129 self.this = this
1130 if not hasattr(self,"thisown"): self.thisown = 0
1131 self.__class__ = Point
1132_core_.Point_swigregister(PointPtr)
1133
1134#---------------------------------------------------------------------------
1135
1136class Rect(object):
1137 """
79fccf9d
RD
1138 A class for representing and manipulating rectangles. It has x, y,
1139 width and height properties. In wxPython most palces that expect a
1140 wx.Rect can also accept a (x,y,width,height) tuple.
d55e5bfc
RD
1141 """
1142 def __repr__(self):
1143 return "<%s.%s; proxy of C++ wxRect instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1144 def __init__(self, *args, **kwargs):
1145 """
1146 __init__(self, int x=0, int y=0, int width=0, int height=0) -> Rect
1147
1148 Create a new Rect object.
1149 """
1150 newobj = _core_.new_Rect(*args, **kwargs)
1151 self.this = newobj.this
1152 self.thisown = 1
1153 del newobj.thisown
1154 def __del__(self, destroy=_core_.delete_Rect):
1155 """__del__(self)"""
1156 try:
1157 if self.thisown: destroy(self)
1158 except: pass
1159
1160 def GetX(*args, **kwargs):
1161 """GetX(self) -> int"""
1162 return _core_.Rect_GetX(*args, **kwargs)
1163
1164 def SetX(*args, **kwargs):
1165 """SetX(self, int x)"""
1166 return _core_.Rect_SetX(*args, **kwargs)
1167
1168 def GetY(*args, **kwargs):
1169 """GetY(self) -> int"""
1170 return _core_.Rect_GetY(*args, **kwargs)
1171
1172 def SetY(*args, **kwargs):
1173 """SetY(self, int y)"""
1174 return _core_.Rect_SetY(*args, **kwargs)
1175
1176 def GetWidth(*args, **kwargs):
1177 """GetWidth(self) -> int"""
1178 return _core_.Rect_GetWidth(*args, **kwargs)
1179
1180 def SetWidth(*args, **kwargs):
1181 """SetWidth(self, int w)"""
1182 return _core_.Rect_SetWidth(*args, **kwargs)
1183
1184 def GetHeight(*args, **kwargs):
1185 """GetHeight(self) -> int"""
1186 return _core_.Rect_GetHeight(*args, **kwargs)
1187
1188 def SetHeight(*args, **kwargs):
1189 """SetHeight(self, int h)"""
1190 return _core_.Rect_SetHeight(*args, **kwargs)
1191
1192 def GetPosition(*args, **kwargs):
1193 """GetPosition(self) -> Point"""
1194 return _core_.Rect_GetPosition(*args, **kwargs)
1195
1196 def SetPosition(*args, **kwargs):
1197 """SetPosition(self, Point p)"""
1198 return _core_.Rect_SetPosition(*args, **kwargs)
1199
1200 def GetSize(*args, **kwargs):
1201 """GetSize(self) -> Size"""
1202 return _core_.Rect_GetSize(*args, **kwargs)
1203
1204 def SetSize(*args, **kwargs):
1205 """SetSize(self, Size s)"""
1206 return _core_.Rect_SetSize(*args, **kwargs)
1207
aff4cc5c
RD
1208 def IsEmpty(*args, **kwargs):
1209 """IsEmpty(self) -> bool"""
1210 return _core_.Rect_IsEmpty(*args, **kwargs)
1211
d55e5bfc
RD
1212 def GetTopLeft(*args, **kwargs):
1213 """GetTopLeft(self) -> Point"""
1214 return _core_.Rect_GetTopLeft(*args, **kwargs)
1215
1216 def SetTopLeft(*args, **kwargs):
1217 """SetTopLeft(self, Point p)"""
1218 return _core_.Rect_SetTopLeft(*args, **kwargs)
1219
1220 def GetBottomRight(*args, **kwargs):
1221 """GetBottomRight(self) -> Point"""
1222 return _core_.Rect_GetBottomRight(*args, **kwargs)
1223
1224 def SetBottomRight(*args, **kwargs):
1225 """SetBottomRight(self, Point p)"""
1226 return _core_.Rect_SetBottomRight(*args, **kwargs)
1227
1228 def GetLeft(*args, **kwargs):
1229 """GetLeft(self) -> int"""
1230 return _core_.Rect_GetLeft(*args, **kwargs)
1231
1232 def GetTop(*args, **kwargs):
1233 """GetTop(self) -> int"""
1234 return _core_.Rect_GetTop(*args, **kwargs)
1235
1236 def GetBottom(*args, **kwargs):
1237 """GetBottom(self) -> int"""
1238 return _core_.Rect_GetBottom(*args, **kwargs)
1239
1240 def GetRight(*args, **kwargs):
1241 """GetRight(self) -> int"""
1242 return _core_.Rect_GetRight(*args, **kwargs)
1243
1244 def SetLeft(*args, **kwargs):
1245 """SetLeft(self, int left)"""
1246 return _core_.Rect_SetLeft(*args, **kwargs)
1247
1248 def SetRight(*args, **kwargs):
1249 """SetRight(self, int right)"""
1250 return _core_.Rect_SetRight(*args, **kwargs)
1251
1252 def SetTop(*args, **kwargs):
1253 """SetTop(self, int top)"""
1254 return _core_.Rect_SetTop(*args, **kwargs)
1255
1256 def SetBottom(*args, **kwargs):
1257 """SetBottom(self, int bottom)"""
1258 return _core_.Rect_SetBottom(*args, **kwargs)
1259
1260 position = property(GetPosition, SetPosition)
1261 size = property(GetSize, SetSize)
1262 left = property(GetLeft, SetLeft)
1263 right = property(GetRight, SetRight)
1264 top = property(GetTop, SetTop)
1265 bottom = property(GetBottom, SetBottom)
1266
1267 def Inflate(*args, **kwargs):
1268 """
1269 Inflate(self, int dx, int dy) -> Rect
1270
091fdbfa
RD
1271 Increases the size of the rectangle.
1272
1273 The left border is moved farther left and the right border is moved
1274 farther right by ``dx``. The upper border is moved farther up and the
1275 bottom border is moved farther down by ``dy``. (Note the the width and
1276 height of the rectangle thus change by ``2*dx`` and ``2*dy``,
1277 respectively.) If one or both of ``dx`` and ``dy`` are negative, the
1278 opposite happens: the rectangle size decreases in the respective
1279 direction.
1280
1281 The change is made to the rectangle inplace, if instead you need a
1282 copy that is inflated, preserving the original then make the copy
1283 first::
1284
1285 copy = wx.Rect(*original)
1286 copy.Inflate(10,15)
1287
1288
d55e5bfc
RD
1289 """
1290 return _core_.Rect_Inflate(*args, **kwargs)
1291
1292 def Deflate(*args, **kwargs):
1293 """
1294 Deflate(self, int dx, int dy) -> Rect
1295
091fdbfa
RD
1296 Decrease the rectangle size. This method is the opposite of `Inflate`
1297 in that Deflate(a,b) is equivalent to Inflate(-a,-b). Please refer to
1298 `Inflate` for a full description.
d55e5bfc
RD
1299 """
1300 return _core_.Rect_Deflate(*args, **kwargs)
1301
1302 def OffsetXY(*args, **kwargs):
1303 """
1304 OffsetXY(self, int dx, int dy)
1305
79fccf9d
RD
1306 Moves the rectangle by the specified offset. If dx is positive, the
1307 rectangle is moved to the right, if dy is positive, it is moved to the
1308 bottom, otherwise it is moved to the left or top respectively.
d55e5bfc
RD
1309 """
1310 return _core_.Rect_OffsetXY(*args, **kwargs)
1311
1312 def Offset(*args, **kwargs):
1313 """
1314 Offset(self, Point pt)
1315
1316 Same as OffsetXY but uses dx,dy from Point
1317 """
1318 return _core_.Rect_Offset(*args, **kwargs)
1319
1320 def Intersect(*args, **kwargs):
1321 """
1322 Intersect(self, Rect rect) -> Rect
1323
b519803b 1324 Returns the intersectsion of this rectangle and rect.
d55e5bfc
RD
1325 """
1326 return _core_.Rect_Intersect(*args, **kwargs)
1327
b519803b
RD
1328 def Union(*args, **kwargs):
1329 """
1330 Union(self, Rect rect) -> Rect
1331
1332 Returns the union of this rectangle and rect.
1333 """
1334 return _core_.Rect_Union(*args, **kwargs)
1335
d55e5bfc
RD
1336 def __add__(*args, **kwargs):
1337 """
1338 __add__(self, Rect rect) -> Rect
1339
1340 Add the properties of rect to this rectangle and return the result.
1341 """
1342 return _core_.Rect___add__(*args, **kwargs)
1343
1344 def __iadd__(*args, **kwargs):
1345 """
1346 __iadd__(self, Rect rect) -> Rect
1347
1348 Add the properties of rect to this rectangle, updating this rectangle.
1349 """
1350 return _core_.Rect___iadd__(*args, **kwargs)
1351
1352 def __eq__(*args, **kwargs):
1353 """
1354 __eq__(self, Rect rect) -> bool
1355
1356 Test for equality.
1357 """
1358 return _core_.Rect___eq__(*args, **kwargs)
1359
1360 def __ne__(*args, **kwargs):
1361 """
1362 __ne__(self, Rect rect) -> bool
1363
1364 Test for inequality.
1365 """
1366 return _core_.Rect___ne__(*args, **kwargs)
1367
1368 def InsideXY(*args, **kwargs):
1369 """
1370 InsideXY(self, int x, int y) -> bool
1371
1372 Return True if the point is (not strcitly) inside the rect.
1373 """
1374 return _core_.Rect_InsideXY(*args, **kwargs)
1375
1376 def Inside(*args, **kwargs):
1377 """
1378 Inside(self, Point pt) -> bool
1379
1380 Return True if the point is (not strcitly) inside the rect.
1381 """
1382 return _core_.Rect_Inside(*args, **kwargs)
1383
1384 def Intersects(*args, **kwargs):
1385 """
1386 Intersects(self, Rect rect) -> bool
1387
1388 Returns True if the rectangles have a non empty intersection.
1389 """
1390 return _core_.Rect_Intersects(*args, **kwargs)
1391
1392 x = property(_core_.Rect_x_get, _core_.Rect_x_set)
1393 y = property(_core_.Rect_y_get, _core_.Rect_y_set)
1394 width = property(_core_.Rect_width_get, _core_.Rect_width_set)
1395 height = property(_core_.Rect_height_get, _core_.Rect_height_set)
1396 def Set(*args, **kwargs):
1397 """
1398 Set(self, int x=0, int y=0, int width=0, int height=0)
1399
1400 Set all rectangle properties.
1401 """
1402 return _core_.Rect_Set(*args, **kwargs)
1403
1404 def Get(*args, **kwargs):
1405 """
1406 Get() -> (x,y,width,height)
1407
1408 Return the rectangle properties as a tuple.
1409 """
1410 return _core_.Rect_Get(*args, **kwargs)
1411
79fccf9d 1412 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
d55e5bfc
RD
1413 def __str__(self): return str(self.Get())
1414 def __repr__(self): return 'wx.Rect'+str(self.Get())
1415 def __len__(self): return len(self.Get())
1416 def __getitem__(self, index): return self.Get()[index]
1417 def __setitem__(self, index, val):
1418 if index == 0: self.x = val
1419 elif index == 1: self.y = val
1420 elif index == 2: self.width = val
1421 elif index == 3: self.height = val
1422 else: raise IndexError
1423 def __nonzero__(self): return self.Get() != (0,0,0,0)
1424 __safe_for_unpickling__ = True
1425 def __reduce__(self): return (wx.Rect, self.Get())
1426
1427
1428class RectPtr(Rect):
1429 def __init__(self, this):
1430 self.this = this
1431 if not hasattr(self,"thisown"): self.thisown = 0
1432 self.__class__ = Rect
1433_core_.Rect_swigregister(RectPtr)
1434
1435def RectPP(*args, **kwargs):
1436 """
1437 RectPP(Point topLeft, Point bottomRight) -> Rect
1438
1439 Create a new Rect object from Points representing two corners.
1440 """
1441 val = _core_.new_RectPP(*args, **kwargs)
1442 val.thisown = 1
1443 return val
1444
1445def RectPS(*args, **kwargs):
1446 """
1447 RectPS(Point pos, Size size) -> Rect
1448
1449 Create a new Rect from a position and size.
1450 """
1451 val = _core_.new_RectPS(*args, **kwargs)
1452 val.thisown = 1
1453 return val
1454
c1cb24a4
RD
1455def RectS(*args, **kwargs):
1456 """
1457 RectS(Size size) -> Rect
1458
1459 Create a new Rect from a size only.
1460 """
1461 val = _core_.new_RectS(*args, **kwargs)
1462 val.thisown = 1
1463 return val
1464
d55e5bfc
RD
1465
1466def IntersectRect(*args, **kwargs):
1467 """
1468 IntersectRect(Rect r1, Rect r2) -> Rect
1469
1470 Calculate and return the intersection of r1 and r2.
1471 """
1472 return _core_.IntersectRect(*args, **kwargs)
1473#---------------------------------------------------------------------------
1474
1475class Point2D(object):
79fccf9d
RD
1476 """
1477 wx.Point2Ds represent a point or a vector in a 2d coordinate system
1478 with floating point values.
1479 """
d55e5bfc
RD
1480 def __repr__(self):
1481 return "<%s.%s; proxy of C++ wxPoint2D instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1482 def __init__(self, *args, **kwargs):
1483 """
1484 __init__(self, double x=0.0, double y=0.0) -> Point2D
1485
1486 Create a w.Point2D object.
1487 """
1488 newobj = _core_.new_Point2D(*args, **kwargs)
1489 self.this = newobj.this
1490 self.thisown = 1
1491 del newobj.thisown
1492 def GetFloor(*args, **kwargs):
a8eff060
RD
1493 """
1494 GetFloor() -> (x,y)
1495
1496 Convert to integer
1497 """
d55e5bfc
RD
1498 return _core_.Point2D_GetFloor(*args, **kwargs)
1499
1500 def GetRounded(*args, **kwargs):
a8eff060
RD
1501 """
1502 GetRounded() -> (x,y)
1503
1504 Convert to integer
1505 """
d55e5bfc
RD
1506 return _core_.Point2D_GetRounded(*args, **kwargs)
1507
1508 def GetVectorLength(*args, **kwargs):
1509 """GetVectorLength(self) -> double"""
1510 return _core_.Point2D_GetVectorLength(*args, **kwargs)
1511
1512 def GetVectorAngle(*args, **kwargs):
1513 """GetVectorAngle(self) -> double"""
1514 return _core_.Point2D_GetVectorAngle(*args, **kwargs)
1515
1516 def SetVectorLength(*args, **kwargs):
1517 """SetVectorLength(self, double length)"""
1518 return _core_.Point2D_SetVectorLength(*args, **kwargs)
1519
1520 def SetVectorAngle(*args, **kwargs):
1521 """SetVectorAngle(self, double degrees)"""
1522 return _core_.Point2D_SetVectorAngle(*args, **kwargs)
1523
1524 def SetPolarCoordinates(self, angle, length):
1525 self.SetVectorLength(length)
1526 self.SetVectorAngle(angle)
1527 def Normalize(self):
1528 self.SetVectorLength(1.0)
1529
1530 def GetDistance(*args, **kwargs):
1531 """GetDistance(self, Point2D pt) -> double"""
1532 return _core_.Point2D_GetDistance(*args, **kwargs)
1533
1534 def GetDistanceSquare(*args, **kwargs):
1535 """GetDistanceSquare(self, Point2D pt) -> double"""
1536 return _core_.Point2D_GetDistanceSquare(*args, **kwargs)
1537
1538 def GetDotProduct(*args, **kwargs):
1539 """GetDotProduct(self, Point2D vec) -> double"""
1540 return _core_.Point2D_GetDotProduct(*args, **kwargs)
1541
1542 def GetCrossProduct(*args, **kwargs):
1543 """GetCrossProduct(self, Point2D vec) -> double"""
1544 return _core_.Point2D_GetCrossProduct(*args, **kwargs)
1545
1546 def __neg__(*args, **kwargs):
1547 """
1548 __neg__(self) -> Point2D
1549
1550 the reflection of this point
1551 """
1552 return _core_.Point2D___neg__(*args, **kwargs)
1553
1554 def __iadd__(*args, **kwargs):
1555 """__iadd__(self, Point2D pt) -> Point2D"""
1556 return _core_.Point2D___iadd__(*args, **kwargs)
1557
1558 def __isub__(*args, **kwargs):
1559 """__isub__(self, Point2D pt) -> Point2D"""
1560 return _core_.Point2D___isub__(*args, **kwargs)
1561
1562 def __imul__(*args, **kwargs):
1563 """__imul__(self, Point2D pt) -> Point2D"""
1564 return _core_.Point2D___imul__(*args, **kwargs)
1565
1566 def __idiv__(*args, **kwargs):
1567 """__idiv__(self, Point2D pt) -> Point2D"""
1568 return _core_.Point2D___idiv__(*args, **kwargs)
1569
1570 def __eq__(*args, **kwargs):
1571 """
1572 __eq__(self, Point2D pt) -> bool
1573
1574 Test for equality
1575 """
1576 return _core_.Point2D___eq__(*args, **kwargs)
1577
1578 def __ne__(*args, **kwargs):
1579 """
1580 __ne__(self, Point2D pt) -> bool
1581
1582 Test for inequality
1583 """
1584 return _core_.Point2D___ne__(*args, **kwargs)
1585
1586 x = property(_core_.Point2D_x_get, _core_.Point2D_x_set)
1587 y = property(_core_.Point2D_y_get, _core_.Point2D_y_set)
1588 def Set(*args, **kwargs):
1589 """Set(self, double x=0, double y=0)"""
1590 return _core_.Point2D_Set(*args, **kwargs)
1591
1592 def Get(*args, **kwargs):
1593 """
1594 Get() -> (x,y)
1595
1596 Return x and y properties as a tuple.
1597 """
1598 return _core_.Point2D_Get(*args, **kwargs)
1599
79fccf9d 1600 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
d55e5bfc
RD
1601 def __str__(self): return str(self.Get())
1602 def __repr__(self): return 'wx.Point2D'+str(self.Get())
1603 def __len__(self): return len(self.Get())
1604 def __getitem__(self, index): return self.Get()[index]
1605 def __setitem__(self, index, val):
1606 if index == 0: self.x = val
1607 elif index == 1: self.y = val
1608 else: raise IndexError
1609 def __nonzero__(self): return self.Get() != (0.0, 0.0)
1610 __safe_for_unpickling__ = True
1611 def __reduce__(self): return (wx.Point2D, self.Get())
1612
1613
1614class Point2DPtr(Point2D):
1615 def __init__(self, this):
1616 self.this = this
1617 if not hasattr(self,"thisown"): self.thisown = 0
1618 self.__class__ = Point2D
1619_core_.Point2D_swigregister(Point2DPtr)
1620
1621def Point2DCopy(*args, **kwargs):
1622 """
1623 Point2DCopy(Point2D pt) -> Point2D
1624
1625 Create a w.Point2D object.
1626 """
1627 val = _core_.new_Point2DCopy(*args, **kwargs)
1628 val.thisown = 1
1629 return val
1630
1631def Point2DFromPoint(*args, **kwargs):
1632 """
1633 Point2DFromPoint(Point pt) -> Point2D
1634
1635 Create a w.Point2D object.
1636 """
1637 val = _core_.new_Point2DFromPoint(*args, **kwargs)
1638 val.thisown = 1
1639 return val
1640
1641#---------------------------------------------------------------------------
1642
1643FromStart = _core_.FromStart
1644FromCurrent = _core_.FromCurrent
1645FromEnd = _core_.FromEnd
1646class InputStream(object):
093d3ff1 1647 """Proxy of C++ InputStream class"""
d55e5bfc
RD
1648 def __repr__(self):
1649 return "<%s.%s; proxy of C++ wxPyInputStream instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1650 def __init__(self, *args, **kwargs):
1651 """__init__(self, PyObject p) -> InputStream"""
1652 newobj = _core_.new_InputStream(*args, **kwargs)
1653 self.this = newobj.this
1654 self.thisown = 1
1655 del newobj.thisown
8fb0e70a
RD
1656 def __del__(self, destroy=_core_.delete_InputStream):
1657 """__del__(self)"""
1658 try:
1659 if self.thisown: destroy(self)
1660 except: pass
1661
d55e5bfc
RD
1662 def close(*args, **kwargs):
1663 """close(self)"""
1664 return _core_.InputStream_close(*args, **kwargs)
1665
1666 def flush(*args, **kwargs):
1667 """flush(self)"""
1668 return _core_.InputStream_flush(*args, **kwargs)
1669
1670 def eof(*args, **kwargs):
1671 """eof(self) -> bool"""
1672 return _core_.InputStream_eof(*args, **kwargs)
1673
1674 def read(*args, **kwargs):
1675 """read(self, int size=-1) -> PyObject"""
1676 return _core_.InputStream_read(*args, **kwargs)
1677
1678 def readline(*args, **kwargs):
1679 """readline(self, int size=-1) -> PyObject"""
1680 return _core_.InputStream_readline(*args, **kwargs)
1681
1682 def readlines(*args, **kwargs):
1683 """readlines(self, int sizehint=-1) -> PyObject"""
1684 return _core_.InputStream_readlines(*args, **kwargs)
1685
1686 def seek(*args, **kwargs):
1687 """seek(self, int offset, int whence=0)"""
1688 return _core_.InputStream_seek(*args, **kwargs)
1689
1690 def tell(*args, **kwargs):
1691 """tell(self) -> int"""
1692 return _core_.InputStream_tell(*args, **kwargs)
1693
1694 def Peek(*args, **kwargs):
1695 """Peek(self) -> char"""
1696 return _core_.InputStream_Peek(*args, **kwargs)
1697
1698 def GetC(*args, **kwargs):
1699 """GetC(self) -> char"""
1700 return _core_.InputStream_GetC(*args, **kwargs)
1701
1702 def LastRead(*args, **kwargs):
1703 """LastRead(self) -> size_t"""
1704 return _core_.InputStream_LastRead(*args, **kwargs)
1705
1706 def CanRead(*args, **kwargs):
1707 """CanRead(self) -> bool"""
1708 return _core_.InputStream_CanRead(*args, **kwargs)
1709
1710 def Eof(*args, **kwargs):
1711 """Eof(self) -> bool"""
1712 return _core_.InputStream_Eof(*args, **kwargs)
1713
1714 def Ungetch(*args, **kwargs):
1715 """Ungetch(self, char c) -> bool"""
1716 return _core_.InputStream_Ungetch(*args, **kwargs)
1717
1718 def SeekI(*args, **kwargs):
1719 """SeekI(self, long pos, int mode=FromStart) -> long"""
1720 return _core_.InputStream_SeekI(*args, **kwargs)
1721
1722 def TellI(*args, **kwargs):
1723 """TellI(self) -> long"""
1724 return _core_.InputStream_TellI(*args, **kwargs)
1725
1726
1727class InputStreamPtr(InputStream):
1728 def __init__(self, this):
1729 self.this = this
1730 if not hasattr(self,"thisown"): self.thisown = 0
1731 self.__class__ = InputStream
1732_core_.InputStream_swigregister(InputStreamPtr)
1733DefaultPosition = cvar.DefaultPosition
1734DefaultSize = cvar.DefaultSize
1735
1736class OutputStream(object):
093d3ff1 1737 """Proxy of C++ OutputStream class"""
d55e5bfc
RD
1738 def __init__(self): raise RuntimeError, "No constructor defined"
1739 def __repr__(self):
1740 return "<%s.%s; proxy of C++ wxOutputStream instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1741 def write(*args, **kwargs):
1742 """write(self, PyObject obj)"""
1743 return _core_.OutputStream_write(*args, **kwargs)
1744
1745
1746class OutputStreamPtr(OutputStream):
1747 def __init__(self, this):
1748 self.this = this
1749 if not hasattr(self,"thisown"): self.thisown = 0
1750 self.__class__ = OutputStream
1751_core_.OutputStream_swigregister(OutputStreamPtr)
1752
1753#---------------------------------------------------------------------------
1754
1755class FSFile(Object):
093d3ff1 1756 """Proxy of C++ FSFile class"""
d55e5bfc
RD
1757 def __repr__(self):
1758 return "<%s.%s; proxy of C++ wxFSFile instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1759 def __init__(self, *args, **kwargs):
1760 """
1761 __init__(self, InputStream stream, String loc, String mimetype, String anchor,
1762 DateTime modif) -> FSFile
1763 """
1764 newobj = _core_.new_FSFile(*args, **kwargs)
1765 self.this = newobj.this
1766 self.thisown = 1
1767 del newobj.thisown
e2950dbb 1768 self.thisown = 0 # It will normally be deleted by the user of the wx.FileSystem
4cf4100f 1769
d55e5bfc
RD
1770 def __del__(self, destroy=_core_.delete_FSFile):
1771 """__del__(self)"""
1772 try:
1773 if self.thisown: destroy(self)
1774 except: pass
1775
1776 def GetStream(*args, **kwargs):
1777 """GetStream(self) -> InputStream"""
1778 return _core_.FSFile_GetStream(*args, **kwargs)
1779
1780 def GetMimeType(*args, **kwargs):
1781 """GetMimeType(self) -> String"""
1782 return _core_.FSFile_GetMimeType(*args, **kwargs)
1783
1784 def GetLocation(*args, **kwargs):
1785 """GetLocation(self) -> String"""
1786 return _core_.FSFile_GetLocation(*args, **kwargs)
1787
1788 def GetAnchor(*args, **kwargs):
1789 """GetAnchor(self) -> String"""
1790 return _core_.FSFile_GetAnchor(*args, **kwargs)
1791
1792 def GetModificationTime(*args, **kwargs):
1793 """GetModificationTime(self) -> DateTime"""
1794 return _core_.FSFile_GetModificationTime(*args, **kwargs)
1795
1796
1797class FSFilePtr(FSFile):
1798 def __init__(self, this):
1799 self.this = this
1800 if not hasattr(self,"thisown"): self.thisown = 0
1801 self.__class__ = FSFile
1802_core_.FSFile_swigregister(FSFilePtr)
1803
1804class CPPFileSystemHandler(object):
093d3ff1 1805 """Proxy of C++ CPPFileSystemHandler class"""
d55e5bfc
RD
1806 def __init__(self): raise RuntimeError, "No constructor defined"
1807 def __repr__(self):
1808 return "<%s.%s; proxy of C++ wxFileSystemHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1809
1810class CPPFileSystemHandlerPtr(CPPFileSystemHandler):
1811 def __init__(self, this):
1812 self.this = this
1813 if not hasattr(self,"thisown"): self.thisown = 0
1814 self.__class__ = CPPFileSystemHandler
1815_core_.CPPFileSystemHandler_swigregister(CPPFileSystemHandlerPtr)
1816
1817class FileSystemHandler(CPPFileSystemHandler):
093d3ff1 1818 """Proxy of C++ FileSystemHandler class"""
d55e5bfc
RD
1819 def __repr__(self):
1820 return "<%s.%s; proxy of C++ wxPyFileSystemHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1821 def __init__(self, *args, **kwargs):
1822 """__init__(self) -> FileSystemHandler"""
1823 newobj = _core_.new_FileSystemHandler(*args, **kwargs)
1824 self.this = newobj.this
1825 self.thisown = 1
1826 del newobj.thisown
1827 self._setCallbackInfo(self, FileSystemHandler)
1828
1829 def _setCallbackInfo(*args, **kwargs):
1830 """_setCallbackInfo(self, PyObject self, PyObject _class)"""
1831 return _core_.FileSystemHandler__setCallbackInfo(*args, **kwargs)
1832
1833 def CanOpen(*args, **kwargs):
1834 """CanOpen(self, String location) -> bool"""
1835 return _core_.FileSystemHandler_CanOpen(*args, **kwargs)
1836
1837 def OpenFile(*args, **kwargs):
1838 """OpenFile(self, FileSystem fs, String location) -> FSFile"""
1839 return _core_.FileSystemHandler_OpenFile(*args, **kwargs)
1840
1841 def FindFirst(*args, **kwargs):
1842 """FindFirst(self, String spec, int flags=0) -> String"""
1843 return _core_.FileSystemHandler_FindFirst(*args, **kwargs)
1844
1845 def FindNext(*args, **kwargs):
1846 """FindNext(self) -> String"""
1847 return _core_.FileSystemHandler_FindNext(*args, **kwargs)
1848
1849 def GetProtocol(*args, **kwargs):
1850 """GetProtocol(self, String location) -> String"""
1851 return _core_.FileSystemHandler_GetProtocol(*args, **kwargs)
1852
1853 def GetLeftLocation(*args, **kwargs):
1854 """GetLeftLocation(self, String location) -> String"""
1855 return _core_.FileSystemHandler_GetLeftLocation(*args, **kwargs)
1856
1857 def GetAnchor(*args, **kwargs):
1858 """GetAnchor(self, String location) -> String"""
1859 return _core_.FileSystemHandler_GetAnchor(*args, **kwargs)
1860
1861 def GetRightLocation(*args, **kwargs):
1862 """GetRightLocation(self, String location) -> String"""
1863 return _core_.FileSystemHandler_GetRightLocation(*args, **kwargs)
1864
1865 def GetMimeTypeFromExt(*args, **kwargs):
1866 """GetMimeTypeFromExt(self, String location) -> String"""
1867 return _core_.FileSystemHandler_GetMimeTypeFromExt(*args, **kwargs)
1868
1869
1870class FileSystemHandlerPtr(FileSystemHandler):
1871 def __init__(self, this):
1872 self.this = this
1873 if not hasattr(self,"thisown"): self.thisown = 0
1874 self.__class__ = FileSystemHandler
1875_core_.FileSystemHandler_swigregister(FileSystemHandlerPtr)
1876
1877class FileSystem(Object):
093d3ff1 1878 """Proxy of C++ FileSystem class"""
d55e5bfc
RD
1879 def __repr__(self):
1880 return "<%s.%s; proxy of C++ wxFileSystem instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1881 def __init__(self, *args, **kwargs):
1882 """__init__(self) -> FileSystem"""
1883 newobj = _core_.new_FileSystem(*args, **kwargs)
1884 self.this = newobj.this
1885 self.thisown = 1
1886 del newobj.thisown
1887 def __del__(self, destroy=_core_.delete_FileSystem):
1888 """__del__(self)"""
1889 try:
1890 if self.thisown: destroy(self)
1891 except: pass
1892
1893 def ChangePathTo(*args, **kwargs):
1894 """ChangePathTo(self, String location, bool is_dir=False)"""
1895 return _core_.FileSystem_ChangePathTo(*args, **kwargs)
1896
1897 def GetPath(*args, **kwargs):
1898 """GetPath(self) -> String"""
1899 return _core_.FileSystem_GetPath(*args, **kwargs)
1900
1901 def OpenFile(*args, **kwargs):
1902 """OpenFile(self, String location) -> FSFile"""
1903 return _core_.FileSystem_OpenFile(*args, **kwargs)
1904
1905 def FindFirst(*args, **kwargs):
1906 """FindFirst(self, String spec, int flags=0) -> String"""
1907 return _core_.FileSystem_FindFirst(*args, **kwargs)
1908
1909 def FindNext(*args, **kwargs):
1910 """FindNext(self) -> String"""
1911 return _core_.FileSystem_FindNext(*args, **kwargs)
1912
1913 def AddHandler(*args, **kwargs):
c24da6d6 1914 """AddHandler(CPPFileSystemHandler handler)"""
d55e5bfc
RD
1915 return _core_.FileSystem_AddHandler(*args, **kwargs)
1916
1917 AddHandler = staticmethod(AddHandler)
1918 def CleanUpHandlers(*args, **kwargs):
c24da6d6 1919 """CleanUpHandlers()"""
d55e5bfc
RD
1920 return _core_.FileSystem_CleanUpHandlers(*args, **kwargs)
1921
1922 CleanUpHandlers = staticmethod(CleanUpHandlers)
1923 def FileNameToURL(*args, **kwargs):
c24da6d6 1924 """FileNameToURL(String filename) -> String"""
d55e5bfc
RD
1925 return _core_.FileSystem_FileNameToURL(*args, **kwargs)
1926
1927 FileNameToURL = staticmethod(FileNameToURL)
ae8162c8
RD
1928 def URLToFileName(*args, **kwargs):
1929 """URLToFileName(String url) -> String"""
1930 return _core_.FileSystem_URLToFileName(*args, **kwargs)
1931
1932 URLToFileName = staticmethod(URLToFileName)
d55e5bfc
RD
1933
1934class FileSystemPtr(FileSystem):
1935 def __init__(self, this):
1936 self.this = this
1937 if not hasattr(self,"thisown"): self.thisown = 0
1938 self.__class__ = FileSystem
1939_core_.FileSystem_swigregister(FileSystemPtr)
1940
1941def FileSystem_AddHandler(*args, **kwargs):
1942 """FileSystem_AddHandler(CPPFileSystemHandler handler)"""
1943 return _core_.FileSystem_AddHandler(*args, **kwargs)
1944
1945def FileSystem_CleanUpHandlers(*args, **kwargs):
1946 """FileSystem_CleanUpHandlers()"""
1947 return _core_.FileSystem_CleanUpHandlers(*args, **kwargs)
1948
1949def FileSystem_FileNameToURL(*args, **kwargs):
1950 """FileSystem_FileNameToURL(String filename) -> String"""
1951 return _core_.FileSystem_FileNameToURL(*args, **kwargs)
1952
d55e5bfc
RD
1953def FileSystem_URLToFileName(*args, **kwargs):
1954 """FileSystem_URLToFileName(String url) -> String"""
1955 return _core_.FileSystem_URLToFileName(*args, **kwargs)
ae8162c8 1956
d55e5bfc 1957class InternetFSHandler(CPPFileSystemHandler):
093d3ff1 1958 """Proxy of C++ InternetFSHandler class"""
d55e5bfc
RD
1959 def __repr__(self):
1960 return "<%s.%s; proxy of C++ wxInternetFSHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1961 def __init__(self, *args, **kwargs):
1962 """__init__(self) -> InternetFSHandler"""
1963 newobj = _core_.new_InternetFSHandler(*args, **kwargs)
1964 self.this = newobj.this
1965 self.thisown = 1
1966 del newobj.thisown
1967 def CanOpen(*args, **kwargs):
1968 """CanOpen(self, String location) -> bool"""
1969 return _core_.InternetFSHandler_CanOpen(*args, **kwargs)
1970
1971 def OpenFile(*args, **kwargs):
1972 """OpenFile(self, FileSystem fs, String location) -> FSFile"""
1973 return _core_.InternetFSHandler_OpenFile(*args, **kwargs)
1974
1975
1976class InternetFSHandlerPtr(InternetFSHandler):
1977 def __init__(self, this):
1978 self.this = this
1979 if not hasattr(self,"thisown"): self.thisown = 0
1980 self.__class__ = InternetFSHandler
1981_core_.InternetFSHandler_swigregister(InternetFSHandlerPtr)
1982
1983class ZipFSHandler(CPPFileSystemHandler):
093d3ff1 1984 """Proxy of C++ ZipFSHandler class"""
d55e5bfc
RD
1985 def __repr__(self):
1986 return "<%s.%s; proxy of C++ wxZipFSHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
1987 def __init__(self, *args, **kwargs):
1988 """__init__(self) -> ZipFSHandler"""
1989 newobj = _core_.new_ZipFSHandler(*args, **kwargs)
1990 self.this = newobj.this
1991 self.thisown = 1
1992 del newobj.thisown
1993 def CanOpen(*args, **kwargs):
1994 """CanOpen(self, String location) -> bool"""
1995 return _core_.ZipFSHandler_CanOpen(*args, **kwargs)
1996
1997 def OpenFile(*args, **kwargs):
1998 """OpenFile(self, FileSystem fs, String location) -> FSFile"""
1999 return _core_.ZipFSHandler_OpenFile(*args, **kwargs)
2000
2001 def FindFirst(*args, **kwargs):
2002 """FindFirst(self, String spec, int flags=0) -> String"""
2003 return _core_.ZipFSHandler_FindFirst(*args, **kwargs)
2004
2005 def FindNext(*args, **kwargs):
2006 """FindNext(self) -> String"""
2007 return _core_.ZipFSHandler_FindNext(*args, **kwargs)
2008
2009
2010class ZipFSHandlerPtr(ZipFSHandler):
2011 def __init__(self, this):
2012 self.this = this
2013 if not hasattr(self,"thisown"): self.thisown = 0
2014 self.__class__ = ZipFSHandler
2015_core_.ZipFSHandler_swigregister(ZipFSHandlerPtr)
2016
2017
2018def __wxMemoryFSHandler_AddFile_wxImage(*args, **kwargs):
2019 """__wxMemoryFSHandler_AddFile_wxImage(String filename, Image image, long type)"""
2020 return _core_.__wxMemoryFSHandler_AddFile_wxImage(*args, **kwargs)
2021
2022def __wxMemoryFSHandler_AddFile_wxBitmap(*args, **kwargs):
2023 """__wxMemoryFSHandler_AddFile_wxBitmap(String filename, Bitmap bitmap, long type)"""
2024 return _core_.__wxMemoryFSHandler_AddFile_wxBitmap(*args, **kwargs)
2025
2026def __wxMemoryFSHandler_AddFile_Data(*args, **kwargs):
2027 """__wxMemoryFSHandler_AddFile_Data(String filename, PyObject data)"""
2028 return _core_.__wxMemoryFSHandler_AddFile_Data(*args, **kwargs)
ae8162c8
RD
2029def MemoryFSHandler_AddFile(filename, dataItem, imgType=-1):
2030 """
2031 Add 'file' to the memory filesystem. The dataItem parameter can
2032 either be a `wx.Bitmap`, `wx.Image` or a string that can contain
2033 arbitrary data. If a bitmap or image is used then the imgType
2034 parameter should specify what kind of image file it should be
2035 written as, wx.BITMAP_TYPE_PNG, etc.
2036 """
2037 if isinstance(dataItem, wx.Image):
2038 __wxMemoryFSHandler_AddFile_wxImage(filename, dataItem, imgType)
2039 elif isinstance(dataItem, wx.Bitmap):
2040 __wxMemoryFSHandler_AddFile_wxBitmap(filename, dataItem, imgType)
2041 elif type(dataItem) == str:
2042 __wxMemoryFSHandler_AddFile_Data(filename, dataItem)
2043 else:
2044 raise TypeError, 'wx.Image, wx.Bitmap or string expected'
d55e5bfc
RD
2045
2046class MemoryFSHandler(CPPFileSystemHandler):
093d3ff1 2047 """Proxy of C++ MemoryFSHandler class"""
d55e5bfc
RD
2048 def __repr__(self):
2049 return "<%s.%s; proxy of C++ wxMemoryFSHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
2050 def __init__(self, *args, **kwargs):
2051 """__init__(self) -> MemoryFSHandler"""
2052 newobj = _core_.new_MemoryFSHandler(*args, **kwargs)
2053 self.this = newobj.this
2054 self.thisown = 1
2055 del newobj.thisown
2056 def RemoveFile(*args, **kwargs):
c24da6d6 2057 """RemoveFile(String filename)"""
d55e5bfc
RD
2058 return _core_.MemoryFSHandler_RemoveFile(*args, **kwargs)
2059
2060 RemoveFile = staticmethod(RemoveFile)
2061 AddFile = staticmethod(MemoryFSHandler_AddFile)
2062 def CanOpen(*args, **kwargs):
2063 """CanOpen(self, String location) -> bool"""
2064 return _core_.MemoryFSHandler_CanOpen(*args, **kwargs)
2065
2066 def OpenFile(*args, **kwargs):
2067 """OpenFile(self, FileSystem fs, String location) -> FSFile"""
2068 return _core_.MemoryFSHandler_OpenFile(*args, **kwargs)
2069
2070 def FindFirst(*args, **kwargs):
2071 """FindFirst(self, String spec, int flags=0) -> String"""
2072 return _core_.MemoryFSHandler_FindFirst(*args, **kwargs)
2073
2074 def FindNext(*args, **kwargs):
2075 """FindNext(self) -> String"""
2076 return _core_.MemoryFSHandler_FindNext(*args, **kwargs)
2077
2078
2079class MemoryFSHandlerPtr(MemoryFSHandler):
2080 def __init__(self, this):
2081 self.this = this
2082 if not hasattr(self,"thisown"): self.thisown = 0
2083 self.__class__ = MemoryFSHandler
2084_core_.MemoryFSHandler_swigregister(MemoryFSHandlerPtr)
2085
2086def MemoryFSHandler_RemoveFile(*args, **kwargs):
2087 """MemoryFSHandler_RemoveFile(String filename)"""
2088 return _core_.MemoryFSHandler_RemoveFile(*args, **kwargs)
2089
57133d5c
RD
2090IMAGE_ALPHA_TRANSPARENT = _core_.IMAGE_ALPHA_TRANSPARENT
2091IMAGE_ALPHA_THRESHOLD = _core_.IMAGE_ALPHA_THRESHOLD
2092IMAGE_ALPHA_OPAQUE = _core_.IMAGE_ALPHA_OPAQUE
d55e5bfc
RD
2093#---------------------------------------------------------------------------
2094
2095class ImageHandler(Object):
27fb7603
RD
2096 """
2097 This is the base class for implementing image file loading/saving, and
2098 image creation from data. It is used within `wx.Image` and is not
2099 normally seen by the application.
2100 """
d55e5bfc
RD
2101 def __init__(self): raise RuntimeError, "No constructor defined"
2102 def __repr__(self):
2103 return "<%s.%s; proxy of C++ wxImageHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
2104 def GetName(*args, **kwargs):
2105 """GetName(self) -> String"""
2106 return _core_.ImageHandler_GetName(*args, **kwargs)
2107
2108 def GetExtension(*args, **kwargs):
2109 """GetExtension(self) -> String"""
2110 return _core_.ImageHandler_GetExtension(*args, **kwargs)
2111
2112 def GetType(*args, **kwargs):
2113 """GetType(self) -> long"""
2114 return _core_.ImageHandler_GetType(*args, **kwargs)
2115
2116 def GetMimeType(*args, **kwargs):
2117 """GetMimeType(self) -> String"""
2118 return _core_.ImageHandler_GetMimeType(*args, **kwargs)
2119
2120 def CanRead(*args, **kwargs):
2121 """CanRead(self, String name) -> bool"""
2122 return _core_.ImageHandler_CanRead(*args, **kwargs)
2123
2124 def SetName(*args, **kwargs):
2125 """SetName(self, String name)"""
2126 return _core_.ImageHandler_SetName(*args, **kwargs)
2127
2128 def SetExtension(*args, **kwargs):
2129 """SetExtension(self, String extension)"""
2130 return _core_.ImageHandler_SetExtension(*args, **kwargs)
2131
2132 def SetType(*args, **kwargs):
2133 """SetType(self, long type)"""
2134 return _core_.ImageHandler_SetType(*args, **kwargs)
2135
2136 def SetMimeType(*args, **kwargs):
2137 """SetMimeType(self, String mimetype)"""
2138 return _core_.ImageHandler_SetMimeType(*args, **kwargs)
2139
2140
2141class ImageHandlerPtr(ImageHandler):
2142 def __init__(self, this):
2143 self.this = this
2144 if not hasattr(self,"thisown"): self.thisown = 0
2145 self.__class__ = ImageHandler
2146_core_.ImageHandler_swigregister(ImageHandlerPtr)
2147
2148class ImageHistogram(object):
093d3ff1 2149 """Proxy of C++ ImageHistogram class"""
d55e5bfc
RD
2150 def __repr__(self):
2151 return "<%s.%s; proxy of C++ wxImageHistogram instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
2152 def __init__(self, *args, **kwargs):
2153 """__init__(self) -> ImageHistogram"""
2154 newobj = _core_.new_ImageHistogram(*args, **kwargs)
2155 self.this = newobj.this
2156 self.thisown = 1
2157 del newobj.thisown
2158 def MakeKey(*args, **kwargs):
2159 """
7a27cf7c 2160 MakeKey(byte r, byte g, byte b) -> unsigned long
d55e5bfc
RD
2161
2162 Get the key in the histogram for the given RGB values
2163 """
2164 return _core_.ImageHistogram_MakeKey(*args, **kwargs)
2165
2166 MakeKey = staticmethod(MakeKey)
2167 def FindFirstUnusedColour(*args, **kwargs):
a8eff060
RD
2168 """
2169 FindFirstUnusedColour(int startR=1, int startG=0, int startB=0) -> (success, r, g, b)
2170
2171 Find first colour that is not used in the image and has higher RGB
2172 values than startR, startG, startB. Returns a tuple consisting of a
2173 success flag and rgb values.
2174 """
d55e5bfc
RD
2175 return _core_.ImageHistogram_FindFirstUnusedColour(*args, **kwargs)
2176
f1cbd8fa
RD
2177 def GetCount(*args, **kwargs):
2178 """
2179 GetCount(self, unsigned long key) -> unsigned long
2180
2181 Returns the pixel count for the given key. Use `MakeKey` to create a
2182 key value from a RGB tripple.
2183 """
2184 return _core_.ImageHistogram_GetCount(*args, **kwargs)
2185
2186 def GetCountRGB(*args, **kwargs):
2187 """
7a27cf7c 2188 GetCountRGB(self, byte r, byte g, byte b) -> unsigned long
f1cbd8fa
RD
2189
2190 Returns the pixel count for the given RGB values.
2191 """
2192 return _core_.ImageHistogram_GetCountRGB(*args, **kwargs)
2193
2194 def GetCountColour(*args, **kwargs):
2195 """
2196 GetCountColour(self, Colour colour) -> unsigned long
2197
2198 Returns the pixel count for the given `wx.Colour` value.
2199 """
2200 return _core_.ImageHistogram_GetCountColour(*args, **kwargs)
2201
d55e5bfc
RD
2202
2203class ImageHistogramPtr(ImageHistogram):
2204 def __init__(self, this):
2205 self.this = this
2206 if not hasattr(self,"thisown"): self.thisown = 0
2207 self.__class__ = ImageHistogram
2208_core_.ImageHistogram_swigregister(ImageHistogramPtr)
2209
2210def ImageHistogram_MakeKey(*args, **kwargs):
2211 """
7a27cf7c 2212 ImageHistogram_MakeKey(byte r, byte g, byte b) -> unsigned long
d55e5bfc
RD
2213
2214 Get the key in the histogram for the given RGB values
2215 """
2216 return _core_.ImageHistogram_MakeKey(*args, **kwargs)
2217
2218class Image(Object):
7a27cf7c
RD
2219 """
2220 A platform-independent image class. An image can be created from
2221 data, or using `wx.Bitmap.ConvertToImage`, or loaded from a file in a
2222 variety of formats. Functions are available to set and get image
2223 bits, so it can be used for basic image manipulation.
2224
2225 A wx.Image cannot be drawn directly to a `wx.DC`. Instead, a
2226 platform-specific `wx.Bitmap` object must be created from it using the
2227 `wx.BitmapFromImage` constructor. This bitmap can then be drawn in a
2228 device context, using `wx.DC.DrawBitmap`.
2229
2230 One colour value of the image may be used as a mask colour which will
2231 lead to the automatic creation of a `wx.Mask` object associated to the
2232 bitmap object.
2233
2234 wx.Image supports alpha channel data, that is in addition to a byte
2235 for the red, green and blue colour components for each pixel it also
2236 stores a byte representing the pixel opacity. An alpha value of 0
2237 corresponds to a transparent pixel (null opacity) while a value of 255
2238 means that the pixel is 100% opaque.
2239
2240 Unlike RGB data, not all images have an alpha channel and before using
2241 `GetAlpha` you should check if this image contains an alpha channel
2242 with `HasAlpha`. Note that currently only images loaded from PNG files
2243 with transparency information will have an alpha channel.
2244 """
d55e5bfc
RD
2245 def __repr__(self):
2246 return "<%s.%s; proxy of C++ wxImage instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
2247 def __init__(self, *args, **kwargs):
7a27cf7c
RD
2248 """
2249 __init__(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> Image
2250
2251 Loads an image from a file.
2252 """
d55e5bfc
RD
2253 newobj = _core_.new_Image(*args, **kwargs)
2254 self.this = newobj.this
2255 self.thisown = 1
2256 del newobj.thisown
2257 def __del__(self, destroy=_core_.delete_Image):
2258 """__del__(self)"""
2259 try:
2260 if self.thisown: destroy(self)
2261 except: pass
2262
2263 def Create(*args, **kwargs):
7a27cf7c
RD
2264 """
2265 Create(self, int width, int height, bool clear=True)
2266
2267 Creates a fresh image. If clear is ``True``, the new image will be
2268 initialized to black. Otherwise, the image data will be uninitialized.
2269 """
d55e5bfc
RD
2270 return _core_.Image_Create(*args, **kwargs)
2271
2272 def Destroy(*args, **kwargs):
2273 """
2274 Destroy(self)
2275
7a27cf7c 2276 Destroys the image data.
d55e5bfc
RD
2277 """
2278 return _core_.Image_Destroy(*args, **kwargs)
2279
2280 def Scale(*args, **kwargs):
7a27cf7c
RD
2281 """
2282 Scale(self, int width, int height) -> Image
2283
2284 Returns a scaled version of the image. This is also useful for scaling
2285 bitmaps in general as the only other way to scale bitmaps is to blit a
2286 `wx.MemoryDC` into another `wx.MemoryDC`.
2287 """
d55e5bfc
RD
2288 return _core_.Image_Scale(*args, **kwargs)
2289
2290 def ShrinkBy(*args, **kwargs):
7a27cf7c
RD
2291 """
2292 ShrinkBy(self, int xFactor, int yFactor) -> Image
2293
2294 Return a version of the image scaled smaller by the given factors.
2295 """
d55e5bfc
RD
2296 return _core_.Image_ShrinkBy(*args, **kwargs)
2297
2298 def Rescale(*args, **kwargs):
7a27cf7c
RD
2299 """
2300 Rescale(self, int width, int height) -> Image
2301
2302 Changes the size of the image in-place by scaling it: after a call to
2303 this function, the image will have the given width and height.
2304
2305 Returns the (modified) image itself.
2306 """
d55e5bfc
RD
2307 return _core_.Image_Rescale(*args, **kwargs)
2308
aff4cc5c 2309 def Resize(*args, **kwargs):
7a27cf7c
RD
2310 """
2311 Resize(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image
2312
2313 Changes the size of the image in-place without scaling it, by adding
2314 either a border with the given colour or cropping as necessary. The
2315 image is pasted into a new image with the given size and background
2316 colour at the position pos relative to the upper left of the new
2317 image. If red = green = blue = -1 then use either the current mask
2318 colour if set or find, use, and set a suitable mask colour for any
2319 newly exposed areas.
2320
2321 Returns the (modified) image itself.
2322 """
aff4cc5c
RD
2323 return _core_.Image_Resize(*args, **kwargs)
2324
d55e5bfc 2325 def SetRGB(*args, **kwargs):
7a27cf7c
RD
2326 """
2327 SetRGB(self, int x, int y, byte r, byte g, byte b)
2328
2329 Sets the pixel at the given coordinate. This routine performs
2330 bounds-checks for the coordinate so it can be considered a safe way to
2331 manipulate the data, but in some cases this might be too slow so that
2332 the data will have to be set directly. In that case you will have to
2333 get access to the image data using the `GetData` method.
2334 """
d55e5bfc
RD
2335 return _core_.Image_SetRGB(*args, **kwargs)
2336
aff4cc5c 2337 def SetRGBRect(*args, **kwargs):
7a27cf7c
RD
2338 """
2339 SetRGBRect(self, Rect rect, byte r, byte g, byte b)
2340
2341 Sets the colour of the pixels within the given rectangle. This routine
2342 performs bounds-checks for the rectangle so it can be considered a
2343 safe way to manipulate the data.
2344 """
aff4cc5c
RD
2345 return _core_.Image_SetRGBRect(*args, **kwargs)
2346
d55e5bfc 2347 def GetRed(*args, **kwargs):
7a27cf7c
RD
2348 """
2349 GetRed(self, int x, int y) -> byte
2350
2351 Returns the red intensity at the given coordinate.
2352 """
d55e5bfc
RD
2353 return _core_.Image_GetRed(*args, **kwargs)
2354
2355 def GetGreen(*args, **kwargs):
7a27cf7c
RD
2356 """
2357 GetGreen(self, int x, int y) -> byte
2358
2359 Returns the green intensity at the given coordinate.
2360 """
d55e5bfc
RD
2361 return _core_.Image_GetGreen(*args, **kwargs)
2362
2363 def GetBlue(*args, **kwargs):
7a27cf7c
RD
2364 """
2365 GetBlue(self, int x, int y) -> byte
2366
2367 Returns the blue intensity at the given coordinate.
2368 """
d55e5bfc
RD
2369 return _core_.Image_GetBlue(*args, **kwargs)
2370
2371 def SetAlpha(*args, **kwargs):
7a27cf7c
RD
2372 """
2373 SetAlpha(self, int x, int y, byte alpha)
2374
2375 Sets the alpha value for the given pixel. This function should only be
2376 called if the image has alpha channel data, use `HasAlpha` to check
2377 for this.
2378 """
d55e5bfc
RD
2379 return _core_.Image_SetAlpha(*args, **kwargs)
2380
2381 def GetAlpha(*args, **kwargs):
7a27cf7c
RD
2382 """
2383 GetAlpha(self, int x, int y) -> byte
2384
2385 Returns the alpha value for the given pixel. This function may only be
2386 called for the images with alpha channel, use `HasAlpha` to check for
2387 this.
2388
2389 The returned value is the *opacity* of the image, i.e. the value of 0
2390 corresponds to the fully transparent pixels while the value of 255 to
2391 the fully opaque pixels.
2392 """
d55e5bfc
RD
2393 return _core_.Image_GetAlpha(*args, **kwargs)
2394
2395 def HasAlpha(*args, **kwargs):
7a27cf7c
RD
2396 """
2397 HasAlpha(self) -> bool
2398
2399 Returns true if this image has alpha channel, false otherwise.
2400 """
d55e5bfc
RD
2401 return _core_.Image_HasAlpha(*args, **kwargs)
2402
68350608
RD
2403 def InitAlpha(*args, **kwargs):
2404 """
2405 InitAlpha(self)
2406
2407 Initializes the image alpha channel data. It is an error to call it if
2408 the image already has alpha data. If it doesn't, alpha data will be by
2409 default initialized to all pixels being fully opaque. But if the image
2410 has a a mask colour, all mask pixels will be completely transparent.
2411 """
2412 return _core_.Image_InitAlpha(*args, **kwargs)
2413
57133d5c
RD
2414 def IsTransparent(*args, **kwargs):
2415 """
7a27cf7c 2416 IsTransparent(self, int x, int y, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool
57133d5c 2417
7a27cf7c
RD
2418 Returns ``True`` if this pixel is masked or has an alpha value less
2419 than the spcified threshold.
57133d5c
RD
2420 """
2421 return _core_.Image_IsTransparent(*args, **kwargs)
2422
d55e5bfc 2423 def FindFirstUnusedColour(*args, **kwargs):
a8eff060
RD
2424 """
2425 FindFirstUnusedColour(int startR=1, int startG=0, int startB=0) -> (success, r, g, b)
2426
2427 Find first colour that is not used in the image and has higher RGB
2428 values than startR, startG, startB. Returns a tuple consisting of a
2429 success flag and rgb values.
2430 """
d55e5bfc
RD
2431 return _core_.Image_FindFirstUnusedColour(*args, **kwargs)
2432
4cf4100f
RD
2433 def ConvertAlphaToMask(*args, **kwargs):
2434 """
57133d5c 2435 ConvertAlphaToMask(self, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool
4cf4100f 2436
7a27cf7c
RD
2437 If the image has alpha channel, this method converts it to mask. All
2438 pixels with alpha value less than ``threshold`` are replaced with the
2439 mask colour and the alpha channel is removed. The mask colour is
2440 chosen automatically using `FindFirstUnusedColour`.
4cf4100f
RD
2441
2442 If the image image doesn't have alpha channel, ConvertAlphaToMask does
2443 nothing.
2444 """
2445 return _core_.Image_ConvertAlphaToMask(*args, **kwargs)
2446
8fb0e70a
RD
2447 def ConvertColourToAlpha(*args, **kwargs):
2448 """
7a27cf7c 2449 ConvertColourToAlpha(self, byte r, byte g, byte b) -> bool
8fb0e70a
RD
2450
2451 This method converts an image where the original alpha information is
2452 only available as a shades of a colour (actually shades of grey)
2453 typically when you draw anti-aliased text into a bitmap. The DC
2454 drawing routines draw grey values on the black background although
2455 they actually mean to draw white with differnt alpha values. This
2456 method reverses it, assuming a black (!) background and white text.
2457 The method will then fill up the whole image with the colour given.
2458 """
2459 return _core_.Image_ConvertColourToAlpha(*args, **kwargs)
2460
d55e5bfc 2461 def SetMaskFromImage(*args, **kwargs):
7a27cf7c
RD
2462 """
2463 SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool
2464
2465 Sets the image's mask so that the pixels that have RGB value of
2466 ``(mr,mg,mb)`` in ``mask`` will be masked in this image. This is done
2467 by first finding an unused colour in the image, setting this colour as
2468 the mask colour and then using this colour to draw all pixels in the
2469 image who corresponding pixel in mask has given RGB value.
2470
2471 Returns ``False`` if ``mask`` does not have same dimensions as the
2472 image or if there is no unused colour left. Returns ``True`` if the
2473 mask was successfully applied.
2474
2475 Note that this method involves computing the histogram, which is
2476 computationally intensive operation.
2477 """
d55e5bfc
RD
2478 return _core_.Image_SetMaskFromImage(*args, **kwargs)
2479
2480 def CanRead(*args, **kwargs):
7a27cf7c
RD
2481 """
2482 CanRead(String filename) -> bool
2483
2484 Returns True if the image handlers can read this file.
2485 """
d55e5bfc
RD
2486 return _core_.Image_CanRead(*args, **kwargs)
2487
2488 CanRead = staticmethod(CanRead)
2489 def GetImageCount(*args, **kwargs):
7a27cf7c
RD
2490 """
2491 GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int
2492
2493 If the image file contains more than one image and the image handler
2494 is capable of retrieving these individually, this function will return
2495 the number of available images.
2496 """
d55e5bfc
RD
2497 return _core_.Image_GetImageCount(*args, **kwargs)
2498
2499 GetImageCount = staticmethod(GetImageCount)
2500 def LoadFile(*args, **kwargs):
7a27cf7c
RD
2501 """
2502 LoadFile(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> bool
2503
2504 Loads an image from a file. If no handler type is provided, the
2505 library will try to autodetect the format.
2506 """
d55e5bfc
RD
2507 return _core_.Image_LoadFile(*args, **kwargs)
2508
2509 def LoadMimeFile(*args, **kwargs):
7a27cf7c
RD
2510 """
2511 LoadMimeFile(self, String name, String mimetype, int index=-1) -> bool
2512
2513 Loads an image from a file, specifying the image type with a MIME type
2514 string.
2515 """
d55e5bfc
RD
2516 return _core_.Image_LoadMimeFile(*args, **kwargs)
2517
2518 def SaveFile(*args, **kwargs):
7a27cf7c
RD
2519 """
2520 SaveFile(self, String name, int type) -> bool
2521
2522 Saves an image in the named file.
2523 """
d55e5bfc
RD
2524 return _core_.Image_SaveFile(*args, **kwargs)
2525
2526 def SaveMimeFile(*args, **kwargs):
7a27cf7c
RD
2527 """
2528 SaveMimeFile(self, String name, String mimetype) -> bool
2529
2530 Saves an image in the named file.
2531 """
d55e5bfc
RD
2532 return _core_.Image_SaveMimeFile(*args, **kwargs)
2533
2534 def CanReadStream(*args, **kwargs):
7a27cf7c
RD
2535 """
2536 CanReadStream(InputStream stream) -> bool
2537
2538 Returns True if the image handlers can read an image file from the
2539 data currently on the input stream, or a readable Python file-like
2540 object.
2541 """
d55e5bfc
RD
2542 return _core_.Image_CanReadStream(*args, **kwargs)
2543
2544 CanReadStream = staticmethod(CanReadStream)
2545 def LoadStream(*args, **kwargs):
7a27cf7c
RD
2546 """
2547 LoadStream(self, InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> bool
2548
2549 Loads an image from an input stream or a readable Python file-like
2550 object. If no handler type is provided, the library will try to
2551 autodetect the format.
2552 """
d55e5bfc
RD
2553 return _core_.Image_LoadStream(*args, **kwargs)
2554
2555 def LoadMimeStream(*args, **kwargs):
7a27cf7c
RD
2556 """
2557 LoadMimeStream(self, InputStream stream, String mimetype, int index=-1) -> bool
2558
2559 Loads an image from an input stream or a readable Python file-like
2560 object, using a MIME type string to specify the image file format.
2561 """
d55e5bfc
RD
2562 return _core_.Image_LoadMimeStream(*args, **kwargs)
2563
2564 def Ok(*args, **kwargs):
7a27cf7c
RD
2565 """
2566 Ok(self) -> bool
2567
2568 Returns true if image data is present.
2569 """
d55e5bfc
RD
2570 return _core_.Image_Ok(*args, **kwargs)
2571
2572 def GetWidth(*args, **kwargs):
7a27cf7c
RD
2573 """
2574 GetWidth(self) -> int
2575
2576 Gets the width of the image in pixels.
2577 """
d55e5bfc
RD
2578 return _core_.Image_GetWidth(*args, **kwargs)
2579
2580 def GetHeight(*args, **kwargs):
7a27cf7c
RD
2581 """
2582 GetHeight(self) -> int
2583
2584 Gets the height of the image in pixels.
2585 """
d55e5bfc
RD
2586 return _core_.Image_GetHeight(*args, **kwargs)
2587
2588 def GetSize(*args, **kwargs):
7a27cf7c
RD
2589 """
2590 GetSize(self) -> Size
2591
2592 Returns the size of the image in pixels.
2593 """
d55e5bfc
RD
2594 return _core_.Image_GetSize(*args, **kwargs)
2595
2596 def GetSubImage(*args, **kwargs):
7a27cf7c
RD
2597 """
2598 GetSubImage(self, Rect rect) -> Image
2599
2600 Returns a sub image of the current one as long as the rect belongs
2601 entirely to the image.
2602 """
d55e5bfc
RD
2603 return _core_.Image_GetSubImage(*args, **kwargs)
2604
aff4cc5c 2605 def Size(*args, **kwargs):
7a27cf7c
RD
2606 """
2607 Size(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image
2608
2609 Returns a resized version of this image without scaling it by adding
2610 either a border with the given colour or cropping as necessary. The
2611 image is pasted into a new image with the given size and background
2612 colour at the position ``pos`` relative to the upper left of the new
2613 image. If red = green = blue = -1 then use either the current mask
2614 colour if set or find, use, and set a suitable mask colour for any
2615 newly exposed areas.
2616 """
aff4cc5c
RD
2617 return _core_.Image_Size(*args, **kwargs)
2618
d55e5bfc 2619 def Copy(*args, **kwargs):
7a27cf7c
RD
2620 """
2621 Copy(self) -> Image
2622
2623 Returns an identical copy of the image.
2624 """
d55e5bfc
RD
2625 return _core_.Image_Copy(*args, **kwargs)
2626
2627 def Paste(*args, **kwargs):
7a27cf7c
RD
2628 """
2629 Paste(self, Image image, int x, int y)
2630
2631 Pastes ``image`` into this instance and takes care of the mask colour
2632 and any out of bounds problems.
2633 """
d55e5bfc
RD
2634 return _core_.Image_Paste(*args, **kwargs)
2635
2636 def GetData(*args, **kwargs):
ea939623
RD
2637 """
2638 GetData(self) -> PyObject
2639
2640 Returns a string containing a copy of the RGB bytes of the image.
2641 """
d55e5bfc
RD
2642 return _core_.Image_GetData(*args, **kwargs)
2643
2644 def SetData(*args, **kwargs):
ea939623
RD
2645 """
2646 SetData(self, buffer data)
2647
2648 Resets the Image's RGB data from a buffer of RGB bytes. Accepts
2649 either a string or a buffer object holding the data and the length of
2650 the data must be width*height*3.
2651 """
d55e5bfc
RD
2652 return _core_.Image_SetData(*args, **kwargs)
2653
2654 def GetDataBuffer(*args, **kwargs):
ea939623
RD
2655 """
2656 GetDataBuffer(self) -> PyObject
2657
2658 Returns a writable Python buffer object that is pointing at the RGB
7a27cf7c
RD
2659 image data buffer inside the wx.Image. You need to ensure that you do
2660 not use this buffer object after the image has been destroyed.
ea939623 2661 """
d55e5bfc
RD
2662 return _core_.Image_GetDataBuffer(*args, **kwargs)
2663
2664 def SetDataBuffer(*args, **kwargs):
ea939623
RD
2665 """
2666 SetDataBuffer(self, buffer data)
2667
2668 Sets the internal image data pointer to point at a Python buffer
7a27cf7c
RD
2669 object. This can save making an extra copy of the data but you must
2670 ensure that the buffer object lives longer than the wx.Image does.
ea939623 2671 """
d55e5bfc
RD
2672 return _core_.Image_SetDataBuffer(*args, **kwargs)
2673
2674 def GetAlphaData(*args, **kwargs):
ea939623
RD
2675 """
2676 GetAlphaData(self) -> PyObject
2677
2678 Returns a string containing a copy of the alpha bytes of the image.
2679 """
d55e5bfc
RD
2680 return _core_.Image_GetAlphaData(*args, **kwargs)
2681
2682 def SetAlphaData(*args, **kwargs):
ea939623
RD
2683 """
2684 SetAlphaData(self, buffer alpha)
2685
2686 Resets the Image's alpha data from a buffer of bytes. Accepts either
2687 a string or a buffer object holding the data and the length of the
2688 data must be width*height.
2689 """
d55e5bfc
RD
2690 return _core_.Image_SetAlphaData(*args, **kwargs)
2691
2692 def GetAlphaBuffer(*args, **kwargs):
2693 """GetAlphaBuffer(self) -> PyObject"""
2694 return _core_.Image_GetAlphaBuffer(*args, **kwargs)
2695
2696 def SetAlphaBuffer(*args, **kwargs):
ea939623 2697 """SetAlphaBuffer(self, buffer alpha)"""
d55e5bfc
RD
2698 return _core_.Image_SetAlphaBuffer(*args, **kwargs)
2699
2700 def SetMaskColour(*args, **kwargs):
7a27cf7c
RD
2701 """
2702 SetMaskColour(self, byte r, byte g, byte b)
2703
2704 Sets the mask colour for this image (and tells the image to use the
2705 mask).
2706 """
d55e5bfc
RD
2707 return _core_.Image_SetMaskColour(*args, **kwargs)
2708
aff4cc5c
RD
2709 def GetOrFindMaskColour(*args, **kwargs):
2710 """
2711 GetOrFindMaskColour() -> (r,g,b)
2712
2713 Get the current mask colour or find a suitable colour.
2714 """
2715 return _core_.Image_GetOrFindMaskColour(*args, **kwargs)
2716
d55e5bfc 2717 def GetMaskRed(*args, **kwargs):
7a27cf7c
RD
2718 """
2719 GetMaskRed(self) -> byte
2720
2721 Gets the red component of the mask colour.
2722 """
d55e5bfc
RD
2723 return _core_.Image_GetMaskRed(*args, **kwargs)
2724
2725 def GetMaskGreen(*args, **kwargs):
7a27cf7c
RD
2726 """
2727 GetMaskGreen(self) -> byte
2728
2729 Gets the green component of the mask colour.
2730 """
d55e5bfc
RD
2731 return _core_.Image_GetMaskGreen(*args, **kwargs)
2732
2733 def GetMaskBlue(*args, **kwargs):
7a27cf7c
RD
2734 """
2735 GetMaskBlue(self) -> byte
2736
2737 Gets the blue component of the mask colour.
2738 """
d55e5bfc
RD
2739 return _core_.Image_GetMaskBlue(*args, **kwargs)
2740
2741 def SetMask(*args, **kwargs):
7a27cf7c
RD
2742 """
2743 SetMask(self, bool mask=True)
2744
2745 Specifies whether there is a mask or not. The area of the mask is
2746 determined by the current mask colour.
2747 """
d55e5bfc
RD
2748 return _core_.Image_SetMask(*args, **kwargs)
2749
2750 def HasMask(*args, **kwargs):
7a27cf7c
RD
2751 """
2752 HasMask(self) -> bool
2753
2754 Returns ``True`` if there is a mask active, ``False`` otherwise.
2755 """
d55e5bfc
RD
2756 return _core_.Image_HasMask(*args, **kwargs)
2757
2758 def Rotate(*args, **kwargs):
2759 """
2760 Rotate(self, double angle, Point centre_of_rotation, bool interpolating=True,
2761 Point offset_after_rotation=None) -> Image
7a27cf7c
RD
2762
2763 Rotates the image about the given point, by ``angle`` radians. Passing
2764 ``True`` to ``interpolating`` results in better image quality, but is
2765 slower. If the image has a mask, then the mask colour is used for the
2766 uncovered pixels in the rotated image background. Otherwise, black
2767 will be used as the fill colour.
2768
2769 Returns the rotated image, leaving this image intact.
d55e5bfc
RD
2770 """
2771 return _core_.Image_Rotate(*args, **kwargs)
2772
2773 def Rotate90(*args, **kwargs):
7a27cf7c
RD
2774 """
2775 Rotate90(self, bool clockwise=True) -> Image
2776
2777 Returns a copy of the image rotated 90 degrees in the direction
2778 indicated by ``clockwise``.
2779 """
d55e5bfc
RD
2780 return _core_.Image_Rotate90(*args, **kwargs)
2781
2782 def Mirror(*args, **kwargs):
7a27cf7c
RD
2783 """
2784 Mirror(self, bool horizontally=True) -> Image
2785
2786 Returns a mirrored copy of the image. The parameter ``horizontally``
2787 indicates the orientation.
2788 """
d55e5bfc
RD
2789 return _core_.Image_Mirror(*args, **kwargs)
2790
2791 def Replace(*args, **kwargs):
2792 """
7a27cf7c
RD
2793 Replace(self, byte r1, byte g1, byte b1, byte r2, byte g2, byte b2)
2794
2795 Replaces the colour specified by ``(r1,g1,b1)`` by the colour
2796 ``(r2,g2,b2)``.
d55e5bfc
RD
2797 """
2798 return _core_.Image_Replace(*args, **kwargs)
2799
2800 def ConvertToMono(*args, **kwargs):
7a27cf7c
RD
2801 """
2802 ConvertToMono(self, byte r, byte g, byte b) -> Image
2803
2804 Returns monochromatic version of the image. The returned image has
2805 white colour where the original has ``(r,g,b)`` colour and black
2806 colour everywhere else.
2807 """
d55e5bfc
RD
2808 return _core_.Image_ConvertToMono(*args, **kwargs)
2809
2810 def SetOption(*args, **kwargs):
7a27cf7c
RD
2811 """
2812 SetOption(self, String name, String value)
2813
2814 Sets an image handler defined option. For example, when saving as a
2815 JPEG file, the option ``wx.IMAGE_OPTION_QUALITY`` is used, which is a
2816 number between 0 and 100 (0 is terrible, 100 is very good).
2817 """
d55e5bfc
RD
2818 return _core_.Image_SetOption(*args, **kwargs)
2819
2820 def SetOptionInt(*args, **kwargs):
7a27cf7c
RD
2821 """
2822 SetOptionInt(self, String name, int value)
2823
2824 Sets an image option as an integer.
2825 """
d55e5bfc
RD
2826 return _core_.Image_SetOptionInt(*args, **kwargs)
2827
2828 def GetOption(*args, **kwargs):
7a27cf7c
RD
2829 """
2830 GetOption(self, String name) -> String
2831
2832 Gets the value of an image handler option.
2833 """
d55e5bfc
RD
2834 return _core_.Image_GetOption(*args, **kwargs)
2835
2836 def GetOptionInt(*args, **kwargs):
7a27cf7c
RD
2837 """
2838 GetOptionInt(self, String name) -> int
2839
2840 Gets the value of an image handler option as an integer. If the given
2841 option is not present, the function returns 0.
2842 """
d55e5bfc
RD
2843 return _core_.Image_GetOptionInt(*args, **kwargs)
2844
2845 def HasOption(*args, **kwargs):
7a27cf7c
RD
2846 """
2847 HasOption(self, String name) -> bool
2848
2849 Returns true if the given option is present.
2850 """
d55e5bfc
RD
2851 return _core_.Image_HasOption(*args, **kwargs)
2852
2853 def CountColours(*args, **kwargs):
2854 """CountColours(self, unsigned long stopafter=(unsigned long) -1) -> unsigned long"""
2855 return _core_.Image_CountColours(*args, **kwargs)
2856
2857 def ComputeHistogram(*args, **kwargs):
2858 """ComputeHistogram(self, ImageHistogram h) -> unsigned long"""
2859 return _core_.Image_ComputeHistogram(*args, **kwargs)
2860
2861 def AddHandler(*args, **kwargs):
c24da6d6 2862 """AddHandler(ImageHandler handler)"""
d55e5bfc
RD
2863 return _core_.Image_AddHandler(*args, **kwargs)
2864
2865 AddHandler = staticmethod(AddHandler)
2866 def InsertHandler(*args, **kwargs):
c24da6d6 2867 """InsertHandler(ImageHandler handler)"""
d55e5bfc
RD
2868 return _core_.Image_InsertHandler(*args, **kwargs)
2869
2870 InsertHandler = staticmethod(InsertHandler)
2871 def RemoveHandler(*args, **kwargs):
c24da6d6 2872 """RemoveHandler(String name) -> bool"""
d55e5bfc
RD
2873 return _core_.Image_RemoveHandler(*args, **kwargs)
2874
2875 RemoveHandler = staticmethod(RemoveHandler)
2876 def GetImageExtWildcard(*args, **kwargs):
7a27cf7c
RD
2877 """
2878 GetImageExtWildcard() -> String
2879
2880 Iterates all registered wxImageHandler objects, and returns a string
2881 containing file extension masks suitable for passing to file open/save
2882 dialog boxes.
2883 """
d55e5bfc
RD
2884 return _core_.Image_GetImageExtWildcard(*args, **kwargs)
2885
2886 GetImageExtWildcard = staticmethod(GetImageExtWildcard)
2887 def ConvertToBitmap(*args, **kwargs):
1fbf26be 2888 """ConvertToBitmap(self, int depth=-1) -> Bitmap"""
d55e5bfc
RD
2889 return _core_.Image_ConvertToBitmap(*args, **kwargs)
2890
2891 def ConvertToMonoBitmap(*args, **kwargs):
7a27cf7c 2892 """ConvertToMonoBitmap(self, byte red, byte green, byte blue) -> Bitmap"""
d55e5bfc
RD
2893 return _core_.Image_ConvertToMonoBitmap(*args, **kwargs)
2894
2895 def __nonzero__(self): return self.Ok()
2896
2897class ImagePtr(Image):
2898 def __init__(self, this):
2899 self.this = this
2900 if not hasattr(self,"thisown"): self.thisown = 0
2901 self.__class__ = Image
2902_core_.Image_swigregister(ImagePtr)
2903
2904def ImageFromMime(*args, **kwargs):
7a27cf7c
RD
2905 """
2906 ImageFromMime(String name, String mimetype, int index=-1) -> Image
2907
2908 Loads an image from a file, using a MIME type string (such as
2909 'image/jpeg') to specify image type.
2910 """
d55e5bfc
RD
2911 val = _core_.new_ImageFromMime(*args, **kwargs)
2912 val.thisown = 1
2913 return val
2914
2915def ImageFromStream(*args, **kwargs):
7a27cf7c
RD
2916 """
2917 ImageFromStream(InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> Image
2918
2919 Loads an image from an input stream, or any readable Python file-like
2920 object.
2921 """
d55e5bfc
RD
2922 val = _core_.new_ImageFromStream(*args, **kwargs)
2923 val.thisown = 1
2924 return val
2925
2926def ImageFromStreamMime(*args, **kwargs):
7a27cf7c
RD
2927 """
2928 ImageFromStreamMime(InputStream stream, String mimetype, int index=-1) -> Image
2929
2930 Loads an image from an input stream, or any readable Python file-like
2931 object, specifying the image format with a MIME type string.
2932 """
d55e5bfc
RD
2933 val = _core_.new_ImageFromStreamMime(*args, **kwargs)
2934 val.thisown = 1
2935 return val
2936
c24da6d6 2937def EmptyImage(*args, **kwargs):
ea939623
RD
2938 """
2939 EmptyImage(int width=0, int height=0, bool clear=True) -> Image
2940
2941 Construct an empty image of a given size, optionally setting all
2942 pixels to black.
2943 """
c24da6d6 2944 val = _core_.new_EmptyImage(*args, **kwargs)
d55e5bfc
RD
2945 val.thisown = 1
2946 return val
2947
2948def ImageFromBitmap(*args, **kwargs):
ea939623
RD
2949 """
2950 ImageFromBitmap(Bitmap bitmap) -> Image
2951
2952 Construct an Image from a `wx.Bitmap`.
2953 """
d55e5bfc
RD
2954 val = _core_.new_ImageFromBitmap(*args, **kwargs)
2955 val.thisown = 1
2956 return val
2957
2958def ImageFromData(*args, **kwargs):
ea939623
RD
2959 """
2960 ImageFromData(int width, int height, buffer data) -> Image
2961
2962 Construct an Image from a buffer of RGB bytes. Accepts either a
2963 string or a buffer object holding the data and the length of the data
2964 must be width*height*3.
2965 """
d55e5bfc
RD
2966 val = _core_.new_ImageFromData(*args, **kwargs)
2967 val.thisown = 1
2968 return val
2969
c9c2cf70 2970def ImageFromDataWithAlpha(*args, **kwargs):
ea939623
RD
2971 """
2972 ImageFromDataWithAlpha(int width, int height, buffer data, buffer alpha) -> Image
2973
2974 Construct an Image from a buffer of RGB bytes with an Alpha channel.
2975 Accepts either a string or a buffer object holding the data and the
7a27cf7c
RD
2976 length of the data must be width*height*3 bytes, and the length of the
2977 alpha data must be width*height bytes.
ea939623 2978 """
c9c2cf70
RD
2979 val = _core_.new_ImageFromDataWithAlpha(*args, **kwargs)
2980 val.thisown = 1
2981 return val
2982
d55e5bfc 2983def Image_CanRead(*args, **kwargs):
7a27cf7c
RD
2984 """
2985 Image_CanRead(String filename) -> bool
2986
2987 Returns True if the image handlers can read this file.
2988 """
d55e5bfc
RD
2989 return _core_.Image_CanRead(*args, **kwargs)
2990
2991def Image_GetImageCount(*args, **kwargs):
7a27cf7c
RD
2992 """
2993 Image_GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int
2994
2995 If the image file contains more than one image and the image handler
2996 is capable of retrieving these individually, this function will return
2997 the number of available images.
2998 """
d55e5bfc
RD
2999 return _core_.Image_GetImageCount(*args, **kwargs)
3000
3001def Image_CanReadStream(*args, **kwargs):
7a27cf7c
RD
3002 """
3003 Image_CanReadStream(InputStream stream) -> bool
3004
3005 Returns True if the image handlers can read an image file from the
3006 data currently on the input stream, or a readable Python file-like
3007 object.
3008 """
d55e5bfc
RD
3009 return _core_.Image_CanReadStream(*args, **kwargs)
3010
3011def Image_AddHandler(*args, **kwargs):
3012 """Image_AddHandler(ImageHandler handler)"""
3013 return _core_.Image_AddHandler(*args, **kwargs)
3014
3015def Image_InsertHandler(*args, **kwargs):
3016 """Image_InsertHandler(ImageHandler handler)"""
3017 return _core_.Image_InsertHandler(*args, **kwargs)
3018
3019def Image_RemoveHandler(*args, **kwargs):
3020 """Image_RemoveHandler(String name) -> bool"""
3021 return _core_.Image_RemoveHandler(*args, **kwargs)
3022
3023def Image_GetImageExtWildcard(*args, **kwargs):
7a27cf7c
RD
3024 """
3025 Image_GetImageExtWildcard() -> String
3026
3027 Iterates all registered wxImageHandler objects, and returns a string
3028 containing file extension masks suitable for passing to file open/save
3029 dialog boxes.
3030 """
d55e5bfc
RD
3031 return _core_.Image_GetImageExtWildcard(*args, **kwargs)
3032
a07a67e6
RD
3033def InitAllImageHandlers():
3034 """
3035 The former functionality of InitAllImageHanders is now done internal to
3036 the _core_ extension module and so this function has become a simple NOP.
3037 """
3038 pass
d55e5bfc 3039
d55e5bfc
RD
3040IMAGE_RESOLUTION_INCHES = _core_.IMAGE_RESOLUTION_INCHES
3041IMAGE_RESOLUTION_CM = _core_.IMAGE_RESOLUTION_CM
b9d6a5f3
RD
3042PNG_TYPE_COLOUR = _core_.PNG_TYPE_COLOUR
3043PNG_TYPE_GREY = _core_.PNG_TYPE_GREY
3044PNG_TYPE_GREY_RED = _core_.PNG_TYPE_GREY_RED
d55e5bfc
RD
3045BMP_24BPP = _core_.BMP_24BPP
3046BMP_8BPP = _core_.BMP_8BPP
3047BMP_8BPP_GREY = _core_.BMP_8BPP_GREY
3048BMP_8BPP_GRAY = _core_.BMP_8BPP_GRAY
3049BMP_8BPP_RED = _core_.BMP_8BPP_RED
3050BMP_8BPP_PALETTE = _core_.BMP_8BPP_PALETTE
3051BMP_4BPP = _core_.BMP_4BPP
3052BMP_1BPP = _core_.BMP_1BPP
3053BMP_1BPP_BW = _core_.BMP_1BPP_BW
3054class BMPHandler(ImageHandler):
27fb7603 3055 """A `wx.ImageHandler` for \*.bmp bitmap files."""
d55e5bfc
RD
3056 def __repr__(self):
3057 return "<%s.%s; proxy of C++ wxBMPHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3058 def __init__(self, *args, **kwargs):
27fb7603
RD
3059 """
3060 __init__(self) -> BMPHandler
3061
3062 A `wx.ImageHandler` for \*.bmp bitmap files.
3063 """
d55e5bfc
RD
3064 newobj = _core_.new_BMPHandler(*args, **kwargs)
3065 self.this = newobj.this
3066 self.thisown = 1
3067 del newobj.thisown
3068
3069class BMPHandlerPtr(BMPHandler):
3070 def __init__(self, this):
3071 self.this = this
3072 if not hasattr(self,"thisown"): self.thisown = 0
3073 self.__class__ = BMPHandler
3074_core_.BMPHandler_swigregister(BMPHandlerPtr)
3075NullImage = cvar.NullImage
68350608 3076IMAGE_OPTION_FILENAME = cvar.IMAGE_OPTION_FILENAME
d55e5bfc
RD
3077IMAGE_OPTION_BMP_FORMAT = cvar.IMAGE_OPTION_BMP_FORMAT
3078IMAGE_OPTION_CUR_HOTSPOT_X = cvar.IMAGE_OPTION_CUR_HOTSPOT_X
3079IMAGE_OPTION_CUR_HOTSPOT_Y = cvar.IMAGE_OPTION_CUR_HOTSPOT_Y
3080IMAGE_OPTION_RESOLUTION = cvar.IMAGE_OPTION_RESOLUTION
68350608
RD
3081IMAGE_OPTION_RESOLUTIONX = cvar.IMAGE_OPTION_RESOLUTIONX
3082IMAGE_OPTION_RESOLUTIONY = cvar.IMAGE_OPTION_RESOLUTIONY
d55e5bfc 3083IMAGE_OPTION_RESOLUTIONUNIT = cvar.IMAGE_OPTION_RESOLUTIONUNIT
24d7cbea 3084IMAGE_OPTION_QUALITY = cvar.IMAGE_OPTION_QUALITY
68350608
RD
3085IMAGE_OPTION_BITSPERSAMPLE = cvar.IMAGE_OPTION_BITSPERSAMPLE
3086IMAGE_OPTION_SAMPLESPERPIXEL = cvar.IMAGE_OPTION_SAMPLESPERPIXEL
3087IMAGE_OPTION_COMPRESSION = cvar.IMAGE_OPTION_COMPRESSION
3088IMAGE_OPTION_IMAGEDESCRIPTOR = cvar.IMAGE_OPTION_IMAGEDESCRIPTOR
b9d6a5f3
RD
3089IMAGE_OPTION_PNG_FORMAT = cvar.IMAGE_OPTION_PNG_FORMAT
3090IMAGE_OPTION_PNG_BITDEPTH = cvar.IMAGE_OPTION_PNG_BITDEPTH
d55e5bfc
RD
3091
3092class ICOHandler(BMPHandler):
27fb7603 3093 """A `wx.ImageHandler` for \*.ico icon files."""
d55e5bfc
RD
3094 def __repr__(self):
3095 return "<%s.%s; proxy of C++ wxICOHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3096 def __init__(self, *args, **kwargs):
27fb7603
RD
3097 """
3098 __init__(self) -> ICOHandler
3099
3100 A `wx.ImageHandler` for \*.ico icon files.
3101 """
d55e5bfc
RD
3102 newobj = _core_.new_ICOHandler(*args, **kwargs)
3103 self.this = newobj.this
3104 self.thisown = 1
3105 del newobj.thisown
3106
3107class ICOHandlerPtr(ICOHandler):
3108 def __init__(self, this):
3109 self.this = this
3110 if not hasattr(self,"thisown"): self.thisown = 0
3111 self.__class__ = ICOHandler
3112_core_.ICOHandler_swigregister(ICOHandlerPtr)
3113
3114class CURHandler(ICOHandler):
27fb7603 3115 """A `wx.ImageHandler` for \*.cur cursor files."""
d55e5bfc
RD
3116 def __repr__(self):
3117 return "<%s.%s; proxy of C++ wxCURHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3118 def __init__(self, *args, **kwargs):
27fb7603
RD
3119 """
3120 __init__(self) -> CURHandler
3121
3122 A `wx.ImageHandler` for \*.cur cursor files.
3123 """
d55e5bfc
RD
3124 newobj = _core_.new_CURHandler(*args, **kwargs)
3125 self.this = newobj.this
3126 self.thisown = 1
3127 del newobj.thisown
3128
3129class CURHandlerPtr(CURHandler):
3130 def __init__(self, this):
3131 self.this = this
3132 if not hasattr(self,"thisown"): self.thisown = 0
3133 self.__class__ = CURHandler
3134_core_.CURHandler_swigregister(CURHandlerPtr)
3135
3136class ANIHandler(CURHandler):
27fb7603 3137 """A `wx.ImageHandler` for \*.ani animated cursor files."""
d55e5bfc
RD
3138 def __repr__(self):
3139 return "<%s.%s; proxy of C++ wxANIHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3140 def __init__(self, *args, **kwargs):
27fb7603
RD
3141 """
3142 __init__(self) -> ANIHandler
3143
3144 A `wx.ImageHandler` for \*.ani animated cursor files.
3145 """
d55e5bfc
RD
3146 newobj = _core_.new_ANIHandler(*args, **kwargs)
3147 self.this = newobj.this
3148 self.thisown = 1
3149 del newobj.thisown
3150
3151class ANIHandlerPtr(ANIHandler):
3152 def __init__(self, this):
3153 self.this = this
3154 if not hasattr(self,"thisown"): self.thisown = 0
3155 self.__class__ = ANIHandler
3156_core_.ANIHandler_swigregister(ANIHandlerPtr)
3157
3158class PNGHandler(ImageHandler):
27fb7603 3159 """A `wx.ImageHandler` for PNG image files."""
d55e5bfc
RD
3160 def __repr__(self):
3161 return "<%s.%s; proxy of C++ wxPNGHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3162 def __init__(self, *args, **kwargs):
27fb7603
RD
3163 """
3164 __init__(self) -> PNGHandler
3165
3166 A `wx.ImageHandler` for PNG image files.
3167 """
d55e5bfc
RD
3168 newobj = _core_.new_PNGHandler(*args, **kwargs)
3169 self.this = newobj.this
3170 self.thisown = 1
3171 del newobj.thisown
3172
3173class PNGHandlerPtr(PNGHandler):
3174 def __init__(self, this):
3175 self.this = this
3176 if not hasattr(self,"thisown"): self.thisown = 0
3177 self.__class__ = PNGHandler
3178_core_.PNGHandler_swigregister(PNGHandlerPtr)
3179
3180class GIFHandler(ImageHandler):
27fb7603 3181 """A `wx.ImageHandler` for GIF image files."""
d55e5bfc
RD
3182 def __repr__(self):
3183 return "<%s.%s; proxy of C++ wxGIFHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3184 def __init__(self, *args, **kwargs):
27fb7603
RD
3185 """
3186 __init__(self) -> GIFHandler
3187
3188 A `wx.ImageHandler` for GIF image files.
3189 """
d55e5bfc
RD
3190 newobj = _core_.new_GIFHandler(*args, **kwargs)
3191 self.this = newobj.this
3192 self.thisown = 1
3193 del newobj.thisown
3194
3195class GIFHandlerPtr(GIFHandler):
3196 def __init__(self, this):
3197 self.this = this
3198 if not hasattr(self,"thisown"): self.thisown = 0
3199 self.__class__ = GIFHandler
3200_core_.GIFHandler_swigregister(GIFHandlerPtr)
3201
3202class PCXHandler(ImageHandler):
27fb7603 3203 """A `wx.ImageHandler` for PCX imager files."""
d55e5bfc
RD
3204 def __repr__(self):
3205 return "<%s.%s; proxy of C++ wxPCXHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3206 def __init__(self, *args, **kwargs):
27fb7603
RD
3207 """
3208 __init__(self) -> PCXHandler
3209
3210 A `wx.ImageHandler` for PCX imager files.
3211 """
d55e5bfc
RD
3212 newobj = _core_.new_PCXHandler(*args, **kwargs)
3213 self.this = newobj.this
3214 self.thisown = 1
3215 del newobj.thisown
3216
3217class PCXHandlerPtr(PCXHandler):
3218 def __init__(self, this):
3219 self.this = this
3220 if not hasattr(self,"thisown"): self.thisown = 0
3221 self.__class__ = PCXHandler
3222_core_.PCXHandler_swigregister(PCXHandlerPtr)
3223
3224class JPEGHandler(ImageHandler):
27fb7603 3225 """A `wx.ImageHandler` for JPEG/JPG image files."""
d55e5bfc
RD
3226 def __repr__(self):
3227 return "<%s.%s; proxy of C++ wxJPEGHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3228 def __init__(self, *args, **kwargs):
27fb7603
RD
3229 """
3230 __init__(self) -> JPEGHandler
3231
3232 A `wx.ImageHandler` for JPEG/JPG image files.
3233 """
d55e5bfc
RD
3234 newobj = _core_.new_JPEGHandler(*args, **kwargs)
3235 self.this = newobj.this
3236 self.thisown = 1
3237 del newobj.thisown
3238
3239class JPEGHandlerPtr(JPEGHandler):
3240 def __init__(self, this):
3241 self.this = this
3242 if not hasattr(self,"thisown"): self.thisown = 0
3243 self.__class__ = JPEGHandler
3244_core_.JPEGHandler_swigregister(JPEGHandlerPtr)
3245
3246class PNMHandler(ImageHandler):
27fb7603 3247 """A `wx.ImageHandler` for PNM image files."""
d55e5bfc
RD
3248 def __repr__(self):
3249 return "<%s.%s; proxy of C++ wxPNMHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3250 def __init__(self, *args, **kwargs):
27fb7603
RD
3251 """
3252 __init__(self) -> PNMHandler
3253
3254 A `wx.ImageHandler` for PNM image files.
3255 """
d55e5bfc
RD
3256 newobj = _core_.new_PNMHandler(*args, **kwargs)
3257 self.this = newobj.this
3258 self.thisown = 1
3259 del newobj.thisown
3260
3261class PNMHandlerPtr(PNMHandler):
3262 def __init__(self, this):
3263 self.this = this
3264 if not hasattr(self,"thisown"): self.thisown = 0
3265 self.__class__ = PNMHandler
3266_core_.PNMHandler_swigregister(PNMHandlerPtr)
3267
3268class XPMHandler(ImageHandler):
27fb7603 3269 """A `wx.ImageHandler` for XPM image."""
d55e5bfc
RD
3270 def __repr__(self):
3271 return "<%s.%s; proxy of C++ wxXPMHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3272 def __init__(self, *args, **kwargs):
27fb7603
RD
3273 """
3274 __init__(self) -> XPMHandler
3275
3276 A `wx.ImageHandler` for XPM image.
3277 """
d55e5bfc
RD
3278 newobj = _core_.new_XPMHandler(*args, **kwargs)
3279 self.this = newobj.this
3280 self.thisown = 1
3281 del newobj.thisown
3282
3283class XPMHandlerPtr(XPMHandler):
3284 def __init__(self, this):
3285 self.this = this
3286 if not hasattr(self,"thisown"): self.thisown = 0
3287 self.__class__ = XPMHandler
3288_core_.XPMHandler_swigregister(XPMHandlerPtr)
3289
3290class TIFFHandler(ImageHandler):
27fb7603 3291 """A `wx.ImageHandler` for TIFF image files."""
d55e5bfc
RD
3292 def __repr__(self):
3293 return "<%s.%s; proxy of C++ wxTIFFHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3294 def __init__(self, *args, **kwargs):
27fb7603
RD
3295 """
3296 __init__(self) -> TIFFHandler
3297
3298 A `wx.ImageHandler` for TIFF image files.
3299 """
d55e5bfc
RD
3300 newobj = _core_.new_TIFFHandler(*args, **kwargs)
3301 self.this = newobj.this
3302 self.thisown = 1
3303 del newobj.thisown
3304
3305class TIFFHandlerPtr(TIFFHandler):
3306 def __init__(self, this):
3307 self.this = this
3308 if not hasattr(self,"thisown"): self.thisown = 0
3309 self.__class__ = TIFFHandler
3310_core_.TIFFHandler_swigregister(TIFFHandlerPtr)
3311
c0de73ae
RD
3312QUANTIZE_INCLUDE_WINDOWS_COLOURS = _core_.QUANTIZE_INCLUDE_WINDOWS_COLOURS
3313QUANTIZE_FILL_DESTINATION_IMAGE = _core_.QUANTIZE_FILL_DESTINATION_IMAGE
3314class Quantize(object):
3315 """Performs quantization, or colour reduction, on a wxImage."""
3316 def __init__(self): raise RuntimeError, "No constructor defined"
3317 def __repr__(self):
3318 return "<%s.%s; proxy of C++ wxQuantize instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3319 def Quantize(*args, **kwargs):
3320 """
3321 Quantize(Image src, Image dest, int desiredNoColours=236, int flags=wxQUANTIZE_INCLUDE_WINDOWS_COLOURS|wxQUANTIZE_FILL_DESTINATION_IMAGE) -> bool
3322
3323 Reduce the colours in the source image and put the result into the
3324 destination image, setting the palette in the destination if
3325 needed. Both images may be the same, to overwrite the source image.
3326 """
3327 return _core_.Quantize_Quantize(*args, **kwargs)
3328
3329 Quantize = staticmethod(Quantize)
3330
3331class QuantizePtr(Quantize):
3332 def __init__(self, this):
3333 self.this = this
3334 if not hasattr(self,"thisown"): self.thisown = 0
3335 self.__class__ = Quantize
3336_core_.Quantize_swigregister(QuantizePtr)
3337
3338def Quantize_Quantize(*args, **kwargs):
3339 """
3340 Quantize_Quantize(Image src, Image dest, int desiredNoColours=236, int flags=wxQUANTIZE_INCLUDE_WINDOWS_COLOURS|wxQUANTIZE_FILL_DESTINATION_IMAGE) -> bool
3341
3342 Reduce the colours in the source image and put the result into the
3343 destination image, setting the palette in the destination if
3344 needed. Both images may be the same, to overwrite the source image.
3345 """
3346 return _core_.Quantize_Quantize(*args, **kwargs)
3347
d55e5bfc
RD
3348#---------------------------------------------------------------------------
3349
3350class EvtHandler(Object):
093d3ff1 3351 """Proxy of C++ EvtHandler class"""
d55e5bfc
RD
3352 def __repr__(self):
3353 return "<%s.%s; proxy of C++ wxEvtHandler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3354 def __init__(self, *args, **kwargs):
3355 """__init__(self) -> EvtHandler"""
3356 newobj = _core_.new_EvtHandler(*args, **kwargs)
3357 self.this = newobj.this
3358 self.thisown = 1
3359 del newobj.thisown
3360 def GetNextHandler(*args, **kwargs):
3361 """GetNextHandler(self) -> EvtHandler"""
3362 return _core_.EvtHandler_GetNextHandler(*args, **kwargs)
3363
3364 def GetPreviousHandler(*args, **kwargs):
3365 """GetPreviousHandler(self) -> EvtHandler"""
3366 return _core_.EvtHandler_GetPreviousHandler(*args, **kwargs)
3367
3368 def SetNextHandler(*args, **kwargs):
3369 """SetNextHandler(self, EvtHandler handler)"""
3370 return _core_.EvtHandler_SetNextHandler(*args, **kwargs)
3371
3372 def SetPreviousHandler(*args, **kwargs):
3373 """SetPreviousHandler(self, EvtHandler handler)"""
3374 return _core_.EvtHandler_SetPreviousHandler(*args, **kwargs)
3375
3376 def GetEvtHandlerEnabled(*args, **kwargs):
3377 """GetEvtHandlerEnabled(self) -> bool"""
3378 return _core_.EvtHandler_GetEvtHandlerEnabled(*args, **kwargs)
3379
3380 def SetEvtHandlerEnabled(*args, **kwargs):
3381 """SetEvtHandlerEnabled(self, bool enabled)"""
3382 return _core_.EvtHandler_SetEvtHandlerEnabled(*args, **kwargs)
3383
3384 def ProcessEvent(*args, **kwargs):
3385 """ProcessEvent(self, Event event) -> bool"""
3386 return _core_.EvtHandler_ProcessEvent(*args, **kwargs)
3387
3388 def AddPendingEvent(*args, **kwargs):
3389 """AddPendingEvent(self, Event event)"""
3390 return _core_.EvtHandler_AddPendingEvent(*args, **kwargs)
3391
3392 def ProcessPendingEvents(*args, **kwargs):
3393 """ProcessPendingEvents(self)"""
3394 return _core_.EvtHandler_ProcessPendingEvents(*args, **kwargs)
3395
3396 def Connect(*args, **kwargs):
3397 """Connect(self, int id, int lastId, int eventType, PyObject func)"""
3398 return _core_.EvtHandler_Connect(*args, **kwargs)
3399
3400 def Disconnect(*args, **kwargs):
3401 """Disconnect(self, int id, int lastId=-1, wxEventType eventType=wxEVT_NULL) -> bool"""
3402 return _core_.EvtHandler_Disconnect(*args, **kwargs)
3403
3404 def _setOORInfo(*args, **kwargs):
093d3ff1 3405 """_setOORInfo(self, PyObject _self, bool incref=True)"""
d55e5bfc
RD
3406 return _core_.EvtHandler__setOORInfo(*args, **kwargs)
3407
3408 def Bind(self, event, handler, source=None, id=wx.ID_ANY, id2=wx.ID_ANY):
3409 """
3410 Bind an event to an event handler.
3411
caef1a4d
RD
3412 :param event: One of the EVT_* objects that specifies the
3413 type of event to bind,
d55e5bfc 3414
caef1a4d
RD
3415 :param handler: A callable object to be invoked when the
3416 event is delivered to self. Pass None to
3417 disconnect an event handler.
d55e5bfc 3418
caef1a4d
RD
3419 :param source: Sometimes the event originates from a
3420 different window than self, but you still
3421 want to catch it in self. (For example, a
3422 button event delivered to a frame.) By
3423 passing the source of the event, the event
3424 handling system is able to differentiate
3425 between the same event type from different
3426 controls.
d55e5bfc 3427
caef1a4d
RD
3428 :param id: Used to spcify the event source by ID instead
3429 of instance.
3430
3431 :param id2: Used when it is desirable to bind a handler
3432 to a range of IDs, such as with EVT_MENU_RANGE.
d55e5bfc
RD
3433 """
3434 if source is not None:
3435 id = source.GetId()
3436 event.Bind(self, id, id2, handler)
3437
c24da6d6
RD
3438 def Unbind(self, event, source=None, id=wx.ID_ANY, id2=wx.ID_ANY):
3439 """
3440 Disconencts the event handler binding for event from self.
3441 Returns True if successful.
3442 """
3443 if source is not None:
3444 id = source.GetId()
3445 return event.Unbind(self, id, id2)
d55e5bfc
RD
3446
3447
3448class EvtHandlerPtr(EvtHandler):
3449 def __init__(self, this):
3450 self.this = this
3451 if not hasattr(self,"thisown"): self.thisown = 0
3452 self.__class__ = EvtHandler
3453_core_.EvtHandler_swigregister(EvtHandlerPtr)
3454
3455#---------------------------------------------------------------------------
3456
3457class PyEventBinder(object):
3458 """
3459 Instances of this class are used to bind specific events to event
3460 handlers.
3461 """
3462 def __init__(self, evtType, expectedIDs=0):
3463 if expectedIDs not in [0, 1, 2]:
3464 raise ValueError, "Invalid number of expectedIDs"
3465 self.expectedIDs = expectedIDs
3466
3467 if type(evtType) == list or type(evtType) == tuple:
3468 self.evtType = evtType
3469 else:
3470 self.evtType = [evtType]
3471
3472
3473 def Bind(self, target, id1, id2, function):
3474 """Bind this set of event types to target."""
3475 for et in self.evtType:
3476 target.Connect(id1, id2, et, function)
3477
c24da6d6
RD
3478
3479 def Unbind(self, target, id1, id2):
3480 """Remove an event binding."""
3481 success = 0
3482 for et in self.evtType:
3483 success += target.Disconnect(id1, id2, et)
3484 return success != 0
3485
d55e5bfc
RD
3486
3487 def __call__(self, *args):
3488 """
3489 For backwards compatibility with the old EVT_* functions.
3490 Should be called with either (window, func), (window, ID,
3491 func) or (window, ID1, ID2, func) parameters depending on the
3492 type of the event.
3493 """
3494 assert len(args) == 2 + self.expectedIDs
3495 id1 = wx.ID_ANY
3496 id2 = wx.ID_ANY
3497 target = args[0]
3498 if self.expectedIDs == 0:
3499 func = args[1]
3500 elif self.expectedIDs == 1:
3501 id1 = args[1]
3502 func = args[2]
3503 elif self.expectedIDs == 2:
3504 id1 = args[1]
3505 id2 = args[2]
3506 func = args[3]
3507 else:
3508 raise ValueError, "Unexpected number of IDs"
3509
3510 self.Bind(target, id1, id2, func)
3511
3512
3513# These two are square pegs that don't fit the PyEventBinder hole...
3514def EVT_COMMAND(win, id, cmd, func):
3515 win.Connect(id, -1, cmd, func)
3516def EVT_COMMAND_RANGE(win, id1, id2, cmd, func):
3517 win.Connect(id1, id2, cmd, func)
3518
3519
3520#---------------------------------------------------------------------------
3521
3522#---------------------------------------------------------------------------
3523
3524EVENT_PROPAGATE_NONE = _core_.EVENT_PROPAGATE_NONE
3525EVENT_PROPAGATE_MAX = _core_.EVENT_PROPAGATE_MAX
3526
3527def NewEventType(*args, **kwargs):
3528 """NewEventType() -> wxEventType"""
3529 return _core_.NewEventType(*args, **kwargs)
3530wxEVT_NULL = _core_.wxEVT_NULL
3531wxEVT_FIRST = _core_.wxEVT_FIRST
3532wxEVT_USER_FIRST = _core_.wxEVT_USER_FIRST
3533wxEVT_COMMAND_BUTTON_CLICKED = _core_.wxEVT_COMMAND_BUTTON_CLICKED
3534wxEVT_COMMAND_CHECKBOX_CLICKED = _core_.wxEVT_COMMAND_CHECKBOX_CLICKED
3535wxEVT_COMMAND_CHOICE_SELECTED = _core_.wxEVT_COMMAND_CHOICE_SELECTED
3536wxEVT_COMMAND_LISTBOX_SELECTED = _core_.wxEVT_COMMAND_LISTBOX_SELECTED
3537wxEVT_COMMAND_LISTBOX_DOUBLECLICKED = _core_.wxEVT_COMMAND_LISTBOX_DOUBLECLICKED
3538wxEVT_COMMAND_CHECKLISTBOX_TOGGLED = _core_.wxEVT_COMMAND_CHECKLISTBOX_TOGGLED
3539wxEVT_COMMAND_MENU_SELECTED = _core_.wxEVT_COMMAND_MENU_SELECTED
3540wxEVT_COMMAND_TOOL_CLICKED = _core_.wxEVT_COMMAND_TOOL_CLICKED
3541wxEVT_COMMAND_SLIDER_UPDATED = _core_.wxEVT_COMMAND_SLIDER_UPDATED
3542wxEVT_COMMAND_RADIOBOX_SELECTED = _core_.wxEVT_COMMAND_RADIOBOX_SELECTED
3543wxEVT_COMMAND_RADIOBUTTON_SELECTED = _core_.wxEVT_COMMAND_RADIOBUTTON_SELECTED
3544wxEVT_COMMAND_SCROLLBAR_UPDATED = _core_.wxEVT_COMMAND_SCROLLBAR_UPDATED
3545wxEVT_COMMAND_VLBOX_SELECTED = _core_.wxEVT_COMMAND_VLBOX_SELECTED
3546wxEVT_COMMAND_COMBOBOX_SELECTED = _core_.wxEVT_COMMAND_COMBOBOX_SELECTED
3547wxEVT_COMMAND_TOOL_RCLICKED = _core_.wxEVT_COMMAND_TOOL_RCLICKED
3548wxEVT_COMMAND_TOOL_ENTER = _core_.wxEVT_COMMAND_TOOL_ENTER
3549wxEVT_LEFT_DOWN = _core_.wxEVT_LEFT_DOWN
3550wxEVT_LEFT_UP = _core_.wxEVT_LEFT_UP
3551wxEVT_MIDDLE_DOWN = _core_.wxEVT_MIDDLE_DOWN
3552wxEVT_MIDDLE_UP = _core_.wxEVT_MIDDLE_UP
3553wxEVT_RIGHT_DOWN = _core_.wxEVT_RIGHT_DOWN
3554wxEVT_RIGHT_UP = _core_.wxEVT_RIGHT_UP
3555wxEVT_MOTION = _core_.wxEVT_MOTION
3556wxEVT_ENTER_WINDOW = _core_.wxEVT_ENTER_WINDOW
3557wxEVT_LEAVE_WINDOW = _core_.wxEVT_LEAVE_WINDOW
3558wxEVT_LEFT_DCLICK = _core_.wxEVT_LEFT_DCLICK
3559wxEVT_MIDDLE_DCLICK = _core_.wxEVT_MIDDLE_DCLICK
3560wxEVT_RIGHT_DCLICK = _core_.wxEVT_RIGHT_DCLICK
3561wxEVT_SET_FOCUS = _core_.wxEVT_SET_FOCUS
3562wxEVT_KILL_FOCUS = _core_.wxEVT_KILL_FOCUS
3563wxEVT_CHILD_FOCUS = _core_.wxEVT_CHILD_FOCUS
3564wxEVT_MOUSEWHEEL = _core_.wxEVT_MOUSEWHEEL
3565wxEVT_NC_LEFT_DOWN = _core_.wxEVT_NC_LEFT_DOWN
3566wxEVT_NC_LEFT_UP = _core_.wxEVT_NC_LEFT_UP
3567wxEVT_NC_MIDDLE_DOWN = _core_.wxEVT_NC_MIDDLE_DOWN
3568wxEVT_NC_MIDDLE_UP = _core_.wxEVT_NC_MIDDLE_UP
3569wxEVT_NC_RIGHT_DOWN = _core_.wxEVT_NC_RIGHT_DOWN
3570wxEVT_NC_RIGHT_UP = _core_.wxEVT_NC_RIGHT_UP
3571wxEVT_NC_MOTION = _core_.wxEVT_NC_MOTION
3572wxEVT_NC_ENTER_WINDOW = _core_.wxEVT_NC_ENTER_WINDOW
3573wxEVT_NC_LEAVE_WINDOW = _core_.wxEVT_NC_LEAVE_WINDOW
3574wxEVT_NC_LEFT_DCLICK = _core_.wxEVT_NC_LEFT_DCLICK
3575wxEVT_NC_MIDDLE_DCLICK = _core_.wxEVT_NC_MIDDLE_DCLICK
3576wxEVT_NC_RIGHT_DCLICK = _core_.wxEVT_NC_RIGHT_DCLICK
3577wxEVT_CHAR = _core_.wxEVT_CHAR
3578wxEVT_CHAR_HOOK = _core_.wxEVT_CHAR_HOOK
3579wxEVT_NAVIGATION_KEY = _core_.wxEVT_NAVIGATION_KEY
3580wxEVT_KEY_DOWN = _core_.wxEVT_KEY_DOWN
3581wxEVT_KEY_UP = _core_.wxEVT_KEY_UP
3582wxEVT_HOTKEY = _core_.wxEVT_HOTKEY
3583wxEVT_SET_CURSOR = _core_.wxEVT_SET_CURSOR
3584wxEVT_SCROLL_TOP = _core_.wxEVT_SCROLL_TOP
3585wxEVT_SCROLL_BOTTOM = _core_.wxEVT_SCROLL_BOTTOM
3586wxEVT_SCROLL_LINEUP = _core_.wxEVT_SCROLL_LINEUP
3587wxEVT_SCROLL_LINEDOWN = _core_.wxEVT_SCROLL_LINEDOWN
3588wxEVT_SCROLL_PAGEUP = _core_.wxEVT_SCROLL_PAGEUP
3589wxEVT_SCROLL_PAGEDOWN = _core_.wxEVT_SCROLL_PAGEDOWN
3590wxEVT_SCROLL_THUMBTRACK = _core_.wxEVT_SCROLL_THUMBTRACK
3591wxEVT_SCROLL_THUMBRELEASE = _core_.wxEVT_SCROLL_THUMBRELEASE
db67f999
RD
3592wxEVT_SCROLL_CHANGED = _core_.wxEVT_SCROLL_CHANGED
3593wxEVT_SCROLL_ENDSCROLL = wxEVT_SCROLL_CHANGED
d55e5bfc
RD
3594wxEVT_SCROLLWIN_TOP = _core_.wxEVT_SCROLLWIN_TOP
3595wxEVT_SCROLLWIN_BOTTOM = _core_.wxEVT_SCROLLWIN_BOTTOM
3596wxEVT_SCROLLWIN_LINEUP = _core_.wxEVT_SCROLLWIN_LINEUP
3597wxEVT_SCROLLWIN_LINEDOWN = _core_.wxEVT_SCROLLWIN_LINEDOWN
3598wxEVT_SCROLLWIN_PAGEUP = _core_.wxEVT_SCROLLWIN_PAGEUP
3599wxEVT_SCROLLWIN_PAGEDOWN = _core_.wxEVT_SCROLLWIN_PAGEDOWN
3600wxEVT_SCROLLWIN_THUMBTRACK = _core_.wxEVT_SCROLLWIN_THUMBTRACK
3601wxEVT_SCROLLWIN_THUMBRELEASE = _core_.wxEVT_SCROLLWIN_THUMBRELEASE
3602wxEVT_SIZE = _core_.wxEVT_SIZE
3603wxEVT_MOVE = _core_.wxEVT_MOVE
3604wxEVT_CLOSE_WINDOW = _core_.wxEVT_CLOSE_WINDOW
3605wxEVT_END_SESSION = _core_.wxEVT_END_SESSION
3606wxEVT_QUERY_END_SESSION = _core_.wxEVT_QUERY_END_SESSION
3607wxEVT_ACTIVATE_APP = _core_.wxEVT_ACTIVATE_APP
3608wxEVT_POWER = _core_.wxEVT_POWER
3609wxEVT_ACTIVATE = _core_.wxEVT_ACTIVATE
3610wxEVT_CREATE = _core_.wxEVT_CREATE
3611wxEVT_DESTROY = _core_.wxEVT_DESTROY
3612wxEVT_SHOW = _core_.wxEVT_SHOW
3613wxEVT_ICONIZE = _core_.wxEVT_ICONIZE
3614wxEVT_MAXIMIZE = _core_.wxEVT_MAXIMIZE
3615wxEVT_MOUSE_CAPTURE_CHANGED = _core_.wxEVT_MOUSE_CAPTURE_CHANGED
3616wxEVT_PAINT = _core_.wxEVT_PAINT
3617wxEVT_ERASE_BACKGROUND = _core_.wxEVT_ERASE_BACKGROUND
3618wxEVT_NC_PAINT = _core_.wxEVT_NC_PAINT
3619wxEVT_PAINT_ICON = _core_.wxEVT_PAINT_ICON
3620wxEVT_MENU_OPEN = _core_.wxEVT_MENU_OPEN
3621wxEVT_MENU_CLOSE = _core_.wxEVT_MENU_CLOSE
3622wxEVT_MENU_HIGHLIGHT = _core_.wxEVT_MENU_HIGHLIGHT
3623wxEVT_CONTEXT_MENU = _core_.wxEVT_CONTEXT_MENU
3624wxEVT_SYS_COLOUR_CHANGED = _core_.wxEVT_SYS_COLOUR_CHANGED
3625wxEVT_DISPLAY_CHANGED = _core_.wxEVT_DISPLAY_CHANGED
3626wxEVT_SETTING_CHANGED = _core_.wxEVT_SETTING_CHANGED
3627wxEVT_QUERY_NEW_PALETTE = _core_.wxEVT_QUERY_NEW_PALETTE
3628wxEVT_PALETTE_CHANGED = _core_.wxEVT_PALETTE_CHANGED
3629wxEVT_DROP_FILES = _core_.wxEVT_DROP_FILES
3630wxEVT_DRAW_ITEM = _core_.wxEVT_DRAW_ITEM
3631wxEVT_MEASURE_ITEM = _core_.wxEVT_MEASURE_ITEM
3632wxEVT_COMPARE_ITEM = _core_.wxEVT_COMPARE_ITEM
3633wxEVT_INIT_DIALOG = _core_.wxEVT_INIT_DIALOG
3634wxEVT_IDLE = _core_.wxEVT_IDLE
3635wxEVT_UPDATE_UI = _core_.wxEVT_UPDATE_UI
3636wxEVT_SIZING = _core_.wxEVT_SIZING
3637wxEVT_MOVING = _core_.wxEVT_MOVING
88c6b281 3638wxEVT_HIBERNATE = _core_.wxEVT_HIBERNATE
d55e5bfc
RD
3639wxEVT_COMMAND_LEFT_CLICK = _core_.wxEVT_COMMAND_LEFT_CLICK
3640wxEVT_COMMAND_LEFT_DCLICK = _core_.wxEVT_COMMAND_LEFT_DCLICK
3641wxEVT_COMMAND_RIGHT_CLICK = _core_.wxEVT_COMMAND_RIGHT_CLICK
3642wxEVT_COMMAND_RIGHT_DCLICK = _core_.wxEVT_COMMAND_RIGHT_DCLICK
3643wxEVT_COMMAND_SET_FOCUS = _core_.wxEVT_COMMAND_SET_FOCUS
3644wxEVT_COMMAND_KILL_FOCUS = _core_.wxEVT_COMMAND_KILL_FOCUS
3645wxEVT_COMMAND_ENTER = _core_.wxEVT_COMMAND_ENTER
3646#
3647# Create some event binders
3648EVT_SIZE = wx.PyEventBinder( wxEVT_SIZE )
3649EVT_SIZING = wx.PyEventBinder( wxEVT_SIZING )
3650EVT_MOVE = wx.PyEventBinder( wxEVT_MOVE )
3651EVT_MOVING = wx.PyEventBinder( wxEVT_MOVING )
3652EVT_CLOSE = wx.PyEventBinder( wxEVT_CLOSE_WINDOW )
3653EVT_END_SESSION = wx.PyEventBinder( wxEVT_END_SESSION )
3654EVT_QUERY_END_SESSION = wx.PyEventBinder( wxEVT_QUERY_END_SESSION )
3655EVT_PAINT = wx.PyEventBinder( wxEVT_PAINT )
3656EVT_NC_PAINT = wx.PyEventBinder( wxEVT_NC_PAINT )
3657EVT_ERASE_BACKGROUND = wx.PyEventBinder( wxEVT_ERASE_BACKGROUND )
3658EVT_CHAR = wx.PyEventBinder( wxEVT_CHAR )
3659EVT_KEY_DOWN = wx.PyEventBinder( wxEVT_KEY_DOWN )
3660EVT_KEY_UP = wx.PyEventBinder( wxEVT_KEY_UP )
3661EVT_HOTKEY = wx.PyEventBinder( wxEVT_HOTKEY, 1)
3662EVT_CHAR_HOOK = wx.PyEventBinder( wxEVT_CHAR_HOOK )
3663EVT_MENU_OPEN = wx.PyEventBinder( wxEVT_MENU_OPEN )
3664EVT_MENU_CLOSE = wx.PyEventBinder( wxEVT_MENU_CLOSE )
3665EVT_MENU_HIGHLIGHT = wx.PyEventBinder( wxEVT_MENU_HIGHLIGHT, 1)
3666EVT_MENU_HIGHLIGHT_ALL = wx.PyEventBinder( wxEVT_MENU_HIGHLIGHT )
3667EVT_SET_FOCUS = wx.PyEventBinder( wxEVT_SET_FOCUS )
3668EVT_KILL_FOCUS = wx.PyEventBinder( wxEVT_KILL_FOCUS )
3669EVT_CHILD_FOCUS = wx.PyEventBinder( wxEVT_CHILD_FOCUS )
3670EVT_ACTIVATE = wx.PyEventBinder( wxEVT_ACTIVATE )
3671EVT_ACTIVATE_APP = wx.PyEventBinder( wxEVT_ACTIVATE_APP )
88c6b281 3672EVT_HIBERNATE = wx.PyEventBinder( wxEVT_HIBERNATE )
d55e5bfc
RD
3673EVT_END_SESSION = wx.PyEventBinder( wxEVT_END_SESSION )
3674EVT_QUERY_END_SESSION = wx.PyEventBinder( wxEVT_QUERY_END_SESSION )
3675EVT_DROP_FILES = wx.PyEventBinder( wxEVT_DROP_FILES )
3676EVT_INIT_DIALOG = wx.PyEventBinder( wxEVT_INIT_DIALOG )
3677EVT_SYS_COLOUR_CHANGED = wx.PyEventBinder( wxEVT_SYS_COLOUR_CHANGED )
3678EVT_DISPLAY_CHANGED = wx.PyEventBinder( wxEVT_DISPLAY_CHANGED )
3679EVT_SHOW = wx.PyEventBinder( wxEVT_SHOW )
3680EVT_MAXIMIZE = wx.PyEventBinder( wxEVT_MAXIMIZE )
3681EVT_ICONIZE = wx.PyEventBinder( wxEVT_ICONIZE )
3682EVT_NAVIGATION_KEY = wx.PyEventBinder( wxEVT_NAVIGATION_KEY )
3683EVT_PALETTE_CHANGED = wx.PyEventBinder( wxEVT_PALETTE_CHANGED )
3684EVT_QUERY_NEW_PALETTE = wx.PyEventBinder( wxEVT_QUERY_NEW_PALETTE )
3685EVT_WINDOW_CREATE = wx.PyEventBinder( wxEVT_CREATE )
3686EVT_WINDOW_DESTROY = wx.PyEventBinder( wxEVT_DESTROY )
3687EVT_SET_CURSOR = wx.PyEventBinder( wxEVT_SET_CURSOR )
3688EVT_MOUSE_CAPTURE_CHANGED = wx.PyEventBinder( wxEVT_MOUSE_CAPTURE_CHANGED )
3689
3690EVT_LEFT_DOWN = wx.PyEventBinder( wxEVT_LEFT_DOWN )
3691EVT_LEFT_UP = wx.PyEventBinder( wxEVT_LEFT_UP )
3692EVT_MIDDLE_DOWN = wx.PyEventBinder( wxEVT_MIDDLE_DOWN )
3693EVT_MIDDLE_UP = wx.PyEventBinder( wxEVT_MIDDLE_UP )
3694EVT_RIGHT_DOWN = wx.PyEventBinder( wxEVT_RIGHT_DOWN )
3695EVT_RIGHT_UP = wx.PyEventBinder( wxEVT_RIGHT_UP )
3696EVT_MOTION = wx.PyEventBinder( wxEVT_MOTION )
3697EVT_LEFT_DCLICK = wx.PyEventBinder( wxEVT_LEFT_DCLICK )
3698EVT_MIDDLE_DCLICK = wx.PyEventBinder( wxEVT_MIDDLE_DCLICK )
3699EVT_RIGHT_DCLICK = wx.PyEventBinder( wxEVT_RIGHT_DCLICK )
3700EVT_LEAVE_WINDOW = wx.PyEventBinder( wxEVT_LEAVE_WINDOW )
3701EVT_ENTER_WINDOW = wx.PyEventBinder( wxEVT_ENTER_WINDOW )
3702EVT_MOUSEWHEEL = wx.PyEventBinder( wxEVT_MOUSEWHEEL )
3703
3704EVT_MOUSE_EVENTS = wx.PyEventBinder([ wxEVT_LEFT_DOWN,
3705 wxEVT_LEFT_UP,
3706 wxEVT_MIDDLE_DOWN,
3707 wxEVT_MIDDLE_UP,
3708 wxEVT_RIGHT_DOWN,
3709 wxEVT_RIGHT_UP,
3710 wxEVT_MOTION,
3711 wxEVT_LEFT_DCLICK,
3712 wxEVT_MIDDLE_DCLICK,
3713 wxEVT_RIGHT_DCLICK,
3714 wxEVT_ENTER_WINDOW,
3715 wxEVT_LEAVE_WINDOW,
3716 wxEVT_MOUSEWHEEL
3717 ])
3718
3719
3720# Scrolling from wxWindow (sent to wxScrolledWindow)
3721EVT_SCROLLWIN = wx.PyEventBinder([ wxEVT_SCROLLWIN_TOP,
3722 wxEVT_SCROLLWIN_BOTTOM,
3723 wxEVT_SCROLLWIN_LINEUP,
3724 wxEVT_SCROLLWIN_LINEDOWN,
3725 wxEVT_SCROLLWIN_PAGEUP,
3726 wxEVT_SCROLLWIN_PAGEDOWN,
3727 wxEVT_SCROLLWIN_THUMBTRACK,
3728 wxEVT_SCROLLWIN_THUMBRELEASE,
3729 ])
3730
3731EVT_SCROLLWIN_TOP = wx.PyEventBinder( wxEVT_SCROLLWIN_TOP )
3732EVT_SCROLLWIN_BOTTOM = wx.PyEventBinder( wxEVT_SCROLLWIN_BOTTOM )
3733EVT_SCROLLWIN_LINEUP = wx.PyEventBinder( wxEVT_SCROLLWIN_LINEUP )
3734EVT_SCROLLWIN_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLLWIN_LINEDOWN )
3735EVT_SCROLLWIN_PAGEUP = wx.PyEventBinder( wxEVT_SCROLLWIN_PAGEUP )
3736EVT_SCROLLWIN_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLLWIN_PAGEDOWN )
3737EVT_SCROLLWIN_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLLWIN_THUMBTRACK )
3738EVT_SCROLLWIN_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLLWIN_THUMBRELEASE )
3739
27fb7603 3740# Scrolling from wx.Slider and wx.ScrollBar
d55e5bfc
RD
3741EVT_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP,
3742 wxEVT_SCROLL_BOTTOM,
3743 wxEVT_SCROLL_LINEUP,
3744 wxEVT_SCROLL_LINEDOWN,
3745 wxEVT_SCROLL_PAGEUP,
3746 wxEVT_SCROLL_PAGEDOWN,
3747 wxEVT_SCROLL_THUMBTRACK,
3748 wxEVT_SCROLL_THUMBRELEASE,
db67f999 3749 wxEVT_SCROLL_CHANGED,
d55e5bfc
RD
3750 ])
3751
3752EVT_SCROLL_TOP = wx.PyEventBinder( wxEVT_SCROLL_TOP )
3753EVT_SCROLL_BOTTOM = wx.PyEventBinder( wxEVT_SCROLL_BOTTOM )
3754EVT_SCROLL_LINEUP = wx.PyEventBinder( wxEVT_SCROLL_LINEUP )
3755EVT_SCROLL_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLL_LINEDOWN )
3756EVT_SCROLL_PAGEUP = wx.PyEventBinder( wxEVT_SCROLL_PAGEUP )
3757EVT_SCROLL_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLL_PAGEDOWN )
3758EVT_SCROLL_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLL_THUMBTRACK )
3759EVT_SCROLL_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLL_THUMBRELEASE )
db67f999
RD
3760EVT_SCROLL_CHANGED = wx.PyEventBinder( wxEVT_SCROLL_CHANGED )
3761EVT_SCROLL_ENDSCROLL = EVT_SCROLL_CHANGED
3762
27fb7603 3763# Scrolling from wx.Slider and wx.ScrollBar, with an id
d55e5bfc
RD
3764EVT_COMMAND_SCROLL = wx.PyEventBinder([ wxEVT_SCROLL_TOP,
3765 wxEVT_SCROLL_BOTTOM,
3766 wxEVT_SCROLL_LINEUP,
3767 wxEVT_SCROLL_LINEDOWN,
3768 wxEVT_SCROLL_PAGEUP,
3769 wxEVT_SCROLL_PAGEDOWN,
3770 wxEVT_SCROLL_THUMBTRACK,
3771 wxEVT_SCROLL_THUMBRELEASE,
db67f999 3772 wxEVT_SCROLL_CHANGED,
d55e5bfc
RD
3773 ], 1)
3774
3775EVT_COMMAND_SCROLL_TOP = wx.PyEventBinder( wxEVT_SCROLL_TOP, 1)
3776EVT_COMMAND_SCROLL_BOTTOM = wx.PyEventBinder( wxEVT_SCROLL_BOTTOM, 1)
3777EVT_COMMAND_SCROLL_LINEUP = wx.PyEventBinder( wxEVT_SCROLL_LINEUP, 1)
3778EVT_COMMAND_SCROLL_LINEDOWN = wx.PyEventBinder( wxEVT_SCROLL_LINEDOWN, 1)
3779EVT_COMMAND_SCROLL_PAGEUP = wx.PyEventBinder( wxEVT_SCROLL_PAGEUP, 1)
3780EVT_COMMAND_SCROLL_PAGEDOWN = wx.PyEventBinder( wxEVT_SCROLL_PAGEDOWN, 1)
3781EVT_COMMAND_SCROLL_THUMBTRACK = wx.PyEventBinder( wxEVT_SCROLL_THUMBTRACK, 1)
3782EVT_COMMAND_SCROLL_THUMBRELEASE = wx.PyEventBinder( wxEVT_SCROLL_THUMBRELEASE, 1)
db67f999
RD
3783EVT_COMMAND_SCROLL_CHANGED = wx.PyEventBinder( wxEVT_SCROLL_CHANGED, 1)
3784EVT_COMMAND_SCROLL_ENDSCROLL = EVT_COMMAND_SCROLL_CHANGED
d55e5bfc
RD
3785
3786EVT_BUTTON = wx.PyEventBinder( wxEVT_COMMAND_BUTTON_CLICKED, 1)
3787EVT_CHECKBOX = wx.PyEventBinder( wxEVT_COMMAND_CHECKBOX_CLICKED, 1)
3788EVT_CHOICE = wx.PyEventBinder( wxEVT_COMMAND_CHOICE_SELECTED, 1)
3789EVT_LISTBOX = wx.PyEventBinder( wxEVT_COMMAND_LISTBOX_SELECTED, 1)
3790EVT_LISTBOX_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, 1)
3791EVT_MENU = wx.PyEventBinder( wxEVT_COMMAND_MENU_SELECTED, 1)
3792EVT_MENU_RANGE = wx.PyEventBinder( wxEVT_COMMAND_MENU_SELECTED, 2)
3793EVT_SLIDER = wx.PyEventBinder( wxEVT_COMMAND_SLIDER_UPDATED, 1)
3794EVT_RADIOBOX = wx.PyEventBinder( wxEVT_COMMAND_RADIOBOX_SELECTED, 1)
3795EVT_RADIOBUTTON = wx.PyEventBinder( wxEVT_COMMAND_RADIOBUTTON_SELECTED, 1)
3796
3797EVT_SCROLLBAR = wx.PyEventBinder( wxEVT_COMMAND_SCROLLBAR_UPDATED, 1)
3798EVT_VLBOX = wx.PyEventBinder( wxEVT_COMMAND_VLBOX_SELECTED, 1)
3799EVT_COMBOBOX = wx.PyEventBinder( wxEVT_COMMAND_COMBOBOX_SELECTED, 1)
3800EVT_TOOL = wx.PyEventBinder( wxEVT_COMMAND_TOOL_CLICKED, 1)
3801EVT_TOOL_RANGE = wx.PyEventBinder( wxEVT_COMMAND_TOOL_CLICKED, 2)
3802EVT_TOOL_RCLICKED = wx.PyEventBinder( wxEVT_COMMAND_TOOL_RCLICKED, 1)
3803EVT_TOOL_RCLICKED_RANGE = wx.PyEventBinder( wxEVT_COMMAND_TOOL_RCLICKED, 2)
3804EVT_TOOL_ENTER = wx.PyEventBinder( wxEVT_COMMAND_TOOL_ENTER, 1)
3805EVT_CHECKLISTBOX = wx.PyEventBinder( wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, 1)
3806
3807
3808EVT_COMMAND_LEFT_CLICK = wx.PyEventBinder( wxEVT_COMMAND_LEFT_CLICK, 1)
3809EVT_COMMAND_LEFT_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_LEFT_DCLICK, 1)
3810EVT_COMMAND_RIGHT_CLICK = wx.PyEventBinder( wxEVT_COMMAND_RIGHT_CLICK, 1)
3811EVT_COMMAND_RIGHT_DCLICK = wx.PyEventBinder( wxEVT_COMMAND_RIGHT_DCLICK, 1)
3812EVT_COMMAND_SET_FOCUS = wx.PyEventBinder( wxEVT_COMMAND_SET_FOCUS, 1)
3813EVT_COMMAND_KILL_FOCUS = wx.PyEventBinder( wxEVT_COMMAND_KILL_FOCUS, 1)
3814EVT_COMMAND_ENTER = wx.PyEventBinder( wxEVT_COMMAND_ENTER, 1)
3815
3816EVT_IDLE = wx.PyEventBinder( wxEVT_IDLE )
3817
3818EVT_UPDATE_UI = wx.PyEventBinder( wxEVT_UPDATE_UI, 1)
3819EVT_UPDATE_UI_RANGE = wx.PyEventBinder( wxEVT_UPDATE_UI, 2)
3820
3821EVT_CONTEXT_MENU = wx.PyEventBinder( wxEVT_CONTEXT_MENU )
3822
3823
3824
3825#---------------------------------------------------------------------------
3826
3827class Event(Object):
27fb7603
RD
3828 """
3829 An event is a structure holding information about an event passed to a
3830 callback or member function. wx.Event is an abstract base class for
3831 other event classes
3832 """
d55e5bfc
RD
3833 def __init__(self): raise RuntimeError, "No constructor defined"
3834 def __repr__(self):
3835 return "<%s.%s; proxy of C++ wxEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3836 def __del__(self, destroy=_core_.delete_Event):
3837 """__del__(self)"""
3838 try:
3839 if self.thisown: destroy(self)
3840 except: pass
3841
3842 def SetEventType(*args, **kwargs):
27fb7603
RD
3843 """
3844 SetEventType(self, wxEventType typ)
3845
3846 Sets the specific type of the event.
3847 """
d55e5bfc
RD
3848 return _core_.Event_SetEventType(*args, **kwargs)
3849
3850 def GetEventType(*args, **kwargs):
27fb7603
RD
3851 """
3852 GetEventType(self) -> wxEventType
3853
3854 Returns the identifier of the given event type, such as
3855 ``wxEVT_COMMAND_BUTTON_CLICKED``.
3856 """
d55e5bfc
RD
3857 return _core_.Event_GetEventType(*args, **kwargs)
3858
3859 def GetEventObject(*args, **kwargs):
27fb7603
RD
3860 """
3861 GetEventObject(self) -> Object
3862
3863 Returns the object (usually a window) associated with the event, if
3864 any.
3865 """
d55e5bfc
RD
3866 return _core_.Event_GetEventObject(*args, **kwargs)
3867
3868 def SetEventObject(*args, **kwargs):
27fb7603
RD
3869 """
3870 SetEventObject(self, Object obj)
3871
3872 Sets the originating object, or in other words, obj is normally the
3873 object that is sending the event.
3874 """
d55e5bfc
RD
3875 return _core_.Event_SetEventObject(*args, **kwargs)
3876
3877 def GetTimestamp(*args, **kwargs):
3878 """GetTimestamp(self) -> long"""
3879 return _core_.Event_GetTimestamp(*args, **kwargs)
3880
3881 def SetTimestamp(*args, **kwargs):
3882 """SetTimestamp(self, long ts=0)"""
3883 return _core_.Event_SetTimestamp(*args, **kwargs)
3884
3885 def GetId(*args, **kwargs):
27fb7603
RD
3886 """
3887 GetId(self) -> int
3888
3889 Returns the identifier associated with this event, such as a button
3890 command id.
3891 """
d55e5bfc
RD
3892 return _core_.Event_GetId(*args, **kwargs)
3893
3894 def SetId(*args, **kwargs):
27fb7603
RD
3895 """
3896 SetId(self, int Id)
3897
3898 Set's the ID for the event. This is usually the ID of the window that
3899 is sending the event, but it can also be a command id from a menu
3900 item, etc.
3901 """
d55e5bfc
RD
3902 return _core_.Event_SetId(*args, **kwargs)
3903
3904 def IsCommandEvent(*args, **kwargs):
27fb7603
RD
3905 """
3906 IsCommandEvent(self) -> bool
3907
3908 Returns true if the event is or is derived from `wx.CommandEvent` else
3909 it returns false. Note: Exists only for optimization purposes.
3910 """
d55e5bfc
RD
3911 return _core_.Event_IsCommandEvent(*args, **kwargs)
3912
3913 def Skip(*args, **kwargs):
51b83b37
RD
3914 """
3915 Skip(self, bool skip=True)
3916
3917 Called by an event handler, it controls whether additional event
3918 handlers bound to this event will be called after the current event
3919 handler returns. Skip(false) (the default setting) will prevent
3920 additional event handlers from being called and control will be
3921 returned to the sender of the event immediately after the current
3922 handler has finished. Skip(True) will cause the event processing
3923 system to continue searching for a handler function for this event.
3924
3925 """
d55e5bfc
RD
3926 return _core_.Event_Skip(*args, **kwargs)
3927
3928 def GetSkipped(*args, **kwargs):
27fb7603
RD
3929 """
3930 GetSkipped(self) -> bool
3931
3932 Returns true if the event handler should be skipped, false otherwise.
3933 :see: `Skip`
3934 """
d55e5bfc
RD
3935 return _core_.Event_GetSkipped(*args, **kwargs)
3936
3937 def ShouldPropagate(*args, **kwargs):
27fb7603
RD
3938 """
3939 ShouldPropagate(self) -> bool
3940
3941 Test if this event should be propagated to the parent window or not,
3942 i.e. if the propagation level is currently greater than 0.
3943 """
d55e5bfc
RD
3944 return _core_.Event_ShouldPropagate(*args, **kwargs)
3945
3946 def StopPropagation(*args, **kwargs):
27fb7603
RD
3947 """
3948 StopPropagation(self) -> int
3949
3950 Stop the event from propagating to its parent window. Returns the old
3951 propagation level value which may be later passed to
3952 `ResumePropagation` to allow propagating the event again.
3953 """
d55e5bfc
RD
3954 return _core_.Event_StopPropagation(*args, **kwargs)
3955
3956 def ResumePropagation(*args, **kwargs):
27fb7603
RD
3957 """
3958 ResumePropagation(self, int propagationLevel)
3959
3960 Resume the event propagation by restoring the propagation level. (For
3961 example, you can use the value returned by an earlier call to
3962 `StopPropagation`.)
3963
3964 """
d55e5bfc
RD
3965 return _core_.Event_ResumePropagation(*args, **kwargs)
3966
3967 def Clone(*args, **kwargs):
3968 """Clone(self) -> Event"""
3969 return _core_.Event_Clone(*args, **kwargs)
3970
3971
3972class EventPtr(Event):
3973 def __init__(self, this):
3974 self.this = this
3975 if not hasattr(self,"thisown"): self.thisown = 0
3976 self.__class__ = Event
3977_core_.Event_swigregister(EventPtr)
3978
3979#---------------------------------------------------------------------------
3980
3981class PropagationDisabler(object):
27fb7603
RD
3982 """
3983 Helper class to temporarily change an event not to propagate. Simply
3984 create an instance of this class and then whe it is destroyed the
3985 propogation of the event will be restored.
3986 """
d55e5bfc
RD
3987 def __repr__(self):
3988 return "<%s.%s; proxy of C++ wxPropagationDisabler instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
3989 def __init__(self, *args, **kwargs):
27fb7603
RD
3990 """
3991 __init__(self, Event event) -> PropagationDisabler
3992
3993 Helper class to temporarily change an event not to propagate. Simply
3994 create an instance of this class and then whe it is destroyed the
3995 propogation of the event will be restored.
3996 """
d55e5bfc
RD
3997 newobj = _core_.new_PropagationDisabler(*args, **kwargs)
3998 self.this = newobj.this
3999 self.thisown = 1
4000 del newobj.thisown
4001 def __del__(self, destroy=_core_.delete_PropagationDisabler):
4002 """__del__(self)"""
4003 try:
4004 if self.thisown: destroy(self)
4005 except: pass
4006
4007
4008class PropagationDisablerPtr(PropagationDisabler):
4009 def __init__(self, this):
4010 self.this = this
4011 if not hasattr(self,"thisown"): self.thisown = 0
4012 self.__class__ = PropagationDisabler
4013_core_.PropagationDisabler_swigregister(PropagationDisablerPtr)
4014
4015class PropagateOnce(object):
27fb7603
RD
4016 """
4017 A helper class that will temporarily lower propagation level of an
4018 event. Simply create an instance of this class and then whe it is
4019 destroyed the propogation of the event will be restored.
4020 """
d55e5bfc
RD
4021 def __repr__(self):
4022 return "<%s.%s; proxy of C++ wxPropagateOnce instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4023 def __init__(self, *args, **kwargs):
27fb7603
RD
4024 """
4025 __init__(self, Event event) -> PropagateOnce
4026
4027 A helper class that will temporarily lower propagation level of an
4028 event. Simply create an instance of this class and then whe it is
4029 destroyed the propogation of the event will be restored.
4030 """
d55e5bfc
RD
4031 newobj = _core_.new_PropagateOnce(*args, **kwargs)
4032 self.this = newobj.this
4033 self.thisown = 1
4034 del newobj.thisown
4035 def __del__(self, destroy=_core_.delete_PropagateOnce):
4036 """__del__(self)"""
4037 try:
4038 if self.thisown: destroy(self)
4039 except: pass
4040
4041
4042class PropagateOncePtr(PropagateOnce):
4043 def __init__(self, this):
4044 self.this = this
4045 if not hasattr(self,"thisown"): self.thisown = 0
4046 self.__class__ = PropagateOnce
4047_core_.PropagateOnce_swigregister(PropagateOncePtr)
4048
4049#---------------------------------------------------------------------------
4050
4051class CommandEvent(Event):
27fb7603
RD
4052 """
4053 This event class contains information about command events, which
4054 originate from a variety of simple controls, as well as menus and
4055 toolbars.
4056 """
d55e5bfc
RD
4057 def __repr__(self):
4058 return "<%s.%s; proxy of C++ wxCommandEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4059 def __init__(self, *args, **kwargs):
27fb7603
RD
4060 """
4061 __init__(self, wxEventType commandType=wxEVT_NULL, int winid=0) -> CommandEvent
4062
4063 This event class contains information about command events, which
4064 originate from a variety of simple controls, as well as menus and
4065 toolbars.
4066 """
d55e5bfc
RD
4067 newobj = _core_.new_CommandEvent(*args, **kwargs)
4068 self.this = newobj.this
4069 self.thisown = 1
4070 del newobj.thisown
4071 def GetSelection(*args, **kwargs):
27fb7603
RD
4072 """
4073 GetSelection(self) -> int
4074
4075 Returns item index for a listbox or choice selection event (not valid
4076 for a deselection).
4077 """
d55e5bfc
RD
4078 return _core_.CommandEvent_GetSelection(*args, **kwargs)
4079
4080 def SetString(*args, **kwargs):
4081 """SetString(self, String s)"""
4082 return _core_.CommandEvent_SetString(*args, **kwargs)
4083
4084 def GetString(*args, **kwargs):
27fb7603
RD
4085 """
4086 GetString(self) -> String
4087
4088 Returns item string for a listbox or choice selection event (not valid
4089 for a deselection).
4090 """
d55e5bfc
RD
4091 return _core_.CommandEvent_GetString(*args, **kwargs)
4092
4093 def IsChecked(*args, **kwargs):
27fb7603
RD
4094 """
4095 IsChecked(self) -> bool
4096
4097 This method can be used with checkbox and menu events: for the
4098 checkboxes, the method returns true for a selection event and false
4099 for a deselection one. For the menu events, this method indicates if
4100 the menu item just has become checked or unchecked (and thus only
4101 makes sense for checkable menu items).
4102 """
d55e5bfc
RD
4103 return _core_.CommandEvent_IsChecked(*args, **kwargs)
4104
4105 Checked = IsChecked
4106 def IsSelection(*args, **kwargs):
27fb7603
RD
4107 """
4108 IsSelection(self) -> bool
4109
4110 For a listbox or similar event, returns true if it is a selection,
4111 false if it is a deselection.
4112 """
d55e5bfc
RD
4113 return _core_.CommandEvent_IsSelection(*args, **kwargs)
4114
4115 def SetExtraLong(*args, **kwargs):
4116 """SetExtraLong(self, long extraLong)"""
4117 return _core_.CommandEvent_SetExtraLong(*args, **kwargs)
4118
4119 def GetExtraLong(*args, **kwargs):
27fb7603
RD
4120 """
4121 GetExtraLong(self) -> long
4122
5ba5649b
RD
4123 Returns extra information dependant on the event objects type. If the
4124 event comes from a listbox selection, it is a boolean determining
4125 whether the event was a selection (true) or a deselection (false). A
4126 listbox deselection only occurs for multiple-selection boxes, and in
4127 this case the index and string values are indeterminate and the
4128 listbox must be examined by the application.
27fb7603 4129 """
d55e5bfc
RD
4130 return _core_.CommandEvent_GetExtraLong(*args, **kwargs)
4131
4132 def SetInt(*args, **kwargs):
4133 """SetInt(self, int i)"""
4134 return _core_.CommandEvent_SetInt(*args, **kwargs)
4135
4136 def GetInt(*args, **kwargs):
27fb7603
RD
4137 """
4138 GetInt(self) -> long
4139
5ba5649b
RD
4140 Returns the integer identifier corresponding to a listbox, choice or
4141 radiobox selection (only if the event was a selection, not a
4142 deselection), or a boolean value representing the value of a checkbox.
27fb7603 4143 """
d55e5bfc
RD
4144 return _core_.CommandEvent_GetInt(*args, **kwargs)
4145
4146 def Clone(*args, **kwargs):
4147 """Clone(self) -> Event"""
4148 return _core_.CommandEvent_Clone(*args, **kwargs)
4149
4150
4151class CommandEventPtr(CommandEvent):
4152 def __init__(self, this):
4153 self.this = this
4154 if not hasattr(self,"thisown"): self.thisown = 0
4155 self.__class__ = CommandEvent
4156_core_.CommandEvent_swigregister(CommandEventPtr)
4157
4158#---------------------------------------------------------------------------
4159
4160class NotifyEvent(CommandEvent):
27fb7603
RD
4161 """
4162 An instance of this class (or one of its derived classes) is sent from
4163 a control when the control's state is being changed and the control
4164 allows that change to be prevented from happening. The event handler
4165 can call `Veto` or `Allow` to tell the control what to do.
4166 """
d55e5bfc
RD
4167 def __repr__(self):
4168 return "<%s.%s; proxy of C++ wxNotifyEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4169 def __init__(self, *args, **kwargs):
27fb7603
RD
4170 """
4171 __init__(self, wxEventType commandType=wxEVT_NULL, int winid=0) -> NotifyEvent
4172
4173 An instance of this class (or one of its derived classes) is sent from
4174 a control when the control's state is being changed and the control
4175 allows that change to be prevented from happening. The event handler
4176 can call `Veto` or `Allow` to tell the control what to do.
4177 """
d55e5bfc
RD
4178 newobj = _core_.new_NotifyEvent(*args, **kwargs)
4179 self.this = newobj.this
4180 self.thisown = 1
4181 del newobj.thisown
4182 def Veto(*args, **kwargs):
27fb7603
RD
4183 """
4184 Veto(self)
4185
4186 Prevents the change announced by this event from happening.
4187
4188 It is in general a good idea to notify the user about the reasons for
4189 vetoing the change because otherwise the applications behaviour (which
4190 just refuses to do what the user wants) might be quite surprising.
4191 """
d55e5bfc
RD
4192 return _core_.NotifyEvent_Veto(*args, **kwargs)
4193
4194 def Allow(*args, **kwargs):
27fb7603
RD
4195 """
4196 Allow(self)
4197
4198 This is the opposite of `Veto`: it explicitly allows the event to be
4199 processed. For most events it is not necessary to call this method as
4200 the events are allowed anyhow but some are forbidden by default (this
4201 will be mentioned in the corresponding event description).
4202 """
d55e5bfc
RD
4203 return _core_.NotifyEvent_Allow(*args, **kwargs)
4204
4205 def IsAllowed(*args, **kwargs):
27fb7603
RD
4206 """
4207 IsAllowed(self) -> bool
4208
4209 Returns true if the change is allowed (`Veto` hasn't been called) or
4210 false otherwise (if it was).
4211 """
d55e5bfc
RD
4212 return _core_.NotifyEvent_IsAllowed(*args, **kwargs)
4213
4214
4215class NotifyEventPtr(NotifyEvent):
4216 def __init__(self, this):
4217 self.this = this
4218 if not hasattr(self,"thisown"): self.thisown = 0
4219 self.__class__ = NotifyEvent
4220_core_.NotifyEvent_swigregister(NotifyEventPtr)
4221
4222#---------------------------------------------------------------------------
4223
4224class ScrollEvent(CommandEvent):
27fb7603
RD
4225 """
4226 A scroll event holds information about events sent from stand-alone
4227 scrollbars and sliders. Note that scrolled windows do not send
4228 instnaces of this event class, but send the `wx.ScrollWinEvent`
4229 instead.
4230 """
d55e5bfc
RD
4231 def __repr__(self):
4232 return "<%s.%s; proxy of C++ wxScrollEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4233 def __init__(self, *args, **kwargs):
4234 """
4235 __init__(self, wxEventType commandType=wxEVT_NULL, int winid=0, int pos=0,
4236 int orient=0) -> ScrollEvent
4237 """
4238 newobj = _core_.new_ScrollEvent(*args, **kwargs)
4239 self.this = newobj.this
4240 self.thisown = 1
4241 del newobj.thisown
4242 def GetOrientation(*args, **kwargs):
27fb7603
RD
4243 """
4244 GetOrientation(self) -> int
4245
4246 Returns wx.HORIZONTAL or wx.VERTICAL, depending on the orientation of
4247 the scrollbar.
4248 """
d55e5bfc
RD
4249 return _core_.ScrollEvent_GetOrientation(*args, **kwargs)
4250
4251 def GetPosition(*args, **kwargs):
27fb7603
RD
4252 """
4253 GetPosition(self) -> int
4254
4255 Returns the position of the scrollbar.
4256 """
d55e5bfc
RD
4257 return _core_.ScrollEvent_GetPosition(*args, **kwargs)
4258
4259 def SetOrientation(*args, **kwargs):
4260 """SetOrientation(self, int orient)"""
4261 return _core_.ScrollEvent_SetOrientation(*args, **kwargs)
4262
4263 def SetPosition(*args, **kwargs):
4264 """SetPosition(self, int pos)"""
4265 return _core_.ScrollEvent_SetPosition(*args, **kwargs)
4266
4267
4268class ScrollEventPtr(ScrollEvent):
4269 def __init__(self, this):
4270 self.this = this
4271 if not hasattr(self,"thisown"): self.thisown = 0
4272 self.__class__ = ScrollEvent
4273_core_.ScrollEvent_swigregister(ScrollEventPtr)
4274
4275#---------------------------------------------------------------------------
4276
4277class ScrollWinEvent(Event):
27fb7603
RD
4278 """
4279 A wx.ScrollWinEvent holds information about scrolling and is sent from
4280 scrolling windows.
4281 """
d55e5bfc
RD
4282 def __repr__(self):
4283 return "<%s.%s; proxy of C++ wxScrollWinEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4284 def __init__(self, *args, **kwargs):
27fb7603
RD
4285 """
4286 __init__(self, wxEventType commandType=wxEVT_NULL, int pos=0, int orient=0) -> ScrollWinEvent
4287
4288 A wx.ScrollWinEvent holds information about scrolling and is sent from
4289 scrolling windows.
4290 """
d55e5bfc
RD
4291 newobj = _core_.new_ScrollWinEvent(*args, **kwargs)
4292 self.this = newobj.this
4293 self.thisown = 1
4294 del newobj.thisown
4295 def GetOrientation(*args, **kwargs):
27fb7603
RD
4296 """
4297 GetOrientation(self) -> int
4298
4299 Returns wx.HORIZONTAL or wx.VERTICAL, depending on the orientation of
4300 the scrollbar.
4301 """
d55e5bfc
RD
4302 return _core_.ScrollWinEvent_GetOrientation(*args, **kwargs)
4303
4304 def GetPosition(*args, **kwargs):
27fb7603
RD
4305 """
4306 GetPosition(self) -> int
4307
4308 Returns the position of the scrollbar for the thumb track and release
4309 events. Note that this field can't be used for the other events, you
4310 need to query the window itself for the current position in that case.
4311 """
d55e5bfc
RD
4312 return _core_.ScrollWinEvent_GetPosition(*args, **kwargs)
4313
4314 def SetOrientation(*args, **kwargs):
4315 """SetOrientation(self, int orient)"""
4316 return _core_.ScrollWinEvent_SetOrientation(*args, **kwargs)
4317
4318 def SetPosition(*args, **kwargs):
4319 """SetPosition(self, int pos)"""
4320 return _core_.ScrollWinEvent_SetPosition(*args, **kwargs)
4321
4322
4323class ScrollWinEventPtr(ScrollWinEvent):
4324 def __init__(self, this):
4325 self.this = this
4326 if not hasattr(self,"thisown"): self.thisown = 0
4327 self.__class__ = ScrollWinEvent
4328_core_.ScrollWinEvent_swigregister(ScrollWinEventPtr)
4329
4330#---------------------------------------------------------------------------
4331
4332MOUSE_BTN_ANY = _core_.MOUSE_BTN_ANY
4333MOUSE_BTN_NONE = _core_.MOUSE_BTN_NONE
4334MOUSE_BTN_LEFT = _core_.MOUSE_BTN_LEFT
4335MOUSE_BTN_MIDDLE = _core_.MOUSE_BTN_MIDDLE
4336MOUSE_BTN_RIGHT = _core_.MOUSE_BTN_RIGHT
4337class MouseEvent(Event):
27fb7603
RD
4338 """
4339 This event class contains information about the events generated by
4340 the mouse: they include mouse buttons press and release events and
4341 mouse move events.
4342
4343 All mouse events involving the buttons use ``wx.MOUSE_BTN_LEFT`` for
4344 the left mouse button, ``wx.MOUSE_BTN_MIDDLE`` for the middle one and
4345 ``wx.MOUSE_BTN_RIGHT`` for the right one. Note that not all mice have
4346 a middle button so a portable application should avoid relying on the
4347 events from it.
4348
4349 Note the difference between methods like `LeftDown` and `LeftIsDown`:
4350 the former returns true when the event corresponds to the left mouse
4351 button click while the latter returns true if the left mouse button is
4352 currently being pressed. For example, when the user is dragging the
4353 mouse you can use `LeftIsDown` to test whether the left mouse button
4354 is (still) depressed. Also, by convention, if `LeftDown` returns true,
4355 `LeftIsDown` will also return true in wxWidgets whatever the
4356 underlying GUI behaviour is (which is platform-dependent). The same
4357 applies, of course, to other mouse buttons as well.
4358 """
d55e5bfc
RD
4359 def __repr__(self):
4360 return "<%s.%s; proxy of C++ wxMouseEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4361 def __init__(self, *args, **kwargs):
27fb7603
RD
4362 """
4363 __init__(self, wxEventType mouseType=wxEVT_NULL) -> MouseEvent
4364
4365 Constructs a wx.MouseEvent. Valid event types are:
4366
4367 * wxEVT_ENTER_WINDOW
4368 * wxEVT_LEAVE_WINDOW
4369 * wxEVT_LEFT_DOWN
4370 * wxEVT_LEFT_UP
4371 * wxEVT_LEFT_DCLICK
4372 * wxEVT_MIDDLE_DOWN
4373 * wxEVT_MIDDLE_UP
4374 * wxEVT_MIDDLE_DCLICK
4375 * wxEVT_RIGHT_DOWN
4376 * wxEVT_RIGHT_UP
4377 * wxEVT_RIGHT_DCLICK
4378 * wxEVT_MOTION
4379 * wxEVT_MOUSEWHEEL
4380 """
d55e5bfc
RD
4381 newobj = _core_.new_MouseEvent(*args, **kwargs)
4382 self.this = newobj.this
4383 self.thisown = 1
4384 del newobj.thisown
4385 def IsButton(*args, **kwargs):
27fb7603
RD
4386 """
4387 IsButton(self) -> bool
4388
4389 Returns true if the event was a mouse button event (not necessarily a
4390 button down event - that may be tested using `ButtonDown`).
4391 """
d55e5bfc
RD
4392 return _core_.MouseEvent_IsButton(*args, **kwargs)
4393
4394 def ButtonDown(*args, **kwargs):
27fb7603
RD
4395 """
4396 ButtonDown(self, int but=MOUSE_BTN_ANY) -> bool
4397
5ba5649b
RD
4398 If the argument is omitted, this returns true if the event was any
4399 mouse button down event. Otherwise the argument specifies which
4400 button-down event shold be checked for (see `Button` for the possible
4401 values).
27fb7603 4402 """
d55e5bfc
RD
4403 return _core_.MouseEvent_ButtonDown(*args, **kwargs)
4404
4405 def ButtonDClick(*args, **kwargs):
27fb7603
RD
4406 """
4407 ButtonDClick(self, int but=MOUSE_BTN_ANY) -> bool
4408
4409 If the argument is omitted, this returns true if the event was any
4410 mouse double click event. Otherwise the argument specifies which
4411 double click event to check for (see `Button` for the possible
4412 values).
4413 """
d55e5bfc
RD
4414 return _core_.MouseEvent_ButtonDClick(*args, **kwargs)
4415
4416 def ButtonUp(*args, **kwargs):
27fb7603
RD
4417 """
4418 ButtonUp(self, int but=MOUSE_BTN_ANY) -> bool
4419
4420 If the argument is omitted, this returns true if the event was any
5ba5649b
RD
4421 mouse button up event. Otherwise the argument specifies which button
4422 up event to check for (see `Button` for the possible values).
27fb7603 4423 """
d55e5bfc
RD
4424 return _core_.MouseEvent_ButtonUp(*args, **kwargs)
4425
4426 def Button(*args, **kwargs):
27fb7603
RD
4427 """
4428 Button(self, int button) -> bool
4429
4430 Returns true if the identified mouse button is changing state. Valid
4431 values of button are:
4432
4433 ==================== =====================================
4434 wx.MOUSE_BTN_LEFT check if left button was pressed
4435 wx.MOUSE_BTN_MIDDLE check if middle button was pressed
4436 wx.MOUSE_BTN_RIGHT check if right button was pressed
4437 wx.MOUSE_BTN_ANY check if any button was pressed
4438 ==================== =====================================
4439
4440 """
d55e5bfc
RD
4441 return _core_.MouseEvent_Button(*args, **kwargs)
4442
4443 def ButtonIsDown(*args, **kwargs):
4444 """ButtonIsDown(self, int but) -> bool"""
4445 return _core_.MouseEvent_ButtonIsDown(*args, **kwargs)
4446
4447 def GetButton(*args, **kwargs):
27fb7603
RD
4448 """
4449 GetButton(self) -> int
4450
4451 Returns the mouse button which generated this event or
4452 wx.MOUSE_BTN_NONE if no button is involved (for mouse move, enter or
4453 leave event, for example). Otherwise wx.MOUSE_BTN_LEFT is returned for
4454 the left button down, up and double click events, wx.MOUSE_BTN_MIDDLE
4455 and wx.MOUSE_BTN_RIGHT for the same events for the middle and the
4456 right buttons respectively.
4457 """
d55e5bfc
RD
4458 return _core_.MouseEvent_GetButton(*args, **kwargs)
4459
4460 def ControlDown(*args, **kwargs):
27fb7603
RD
4461 """
4462 ControlDown(self) -> bool
4463
4464 Returns true if the control key was down at the time of the event.
4465 """
d55e5bfc
RD
4466 return _core_.MouseEvent_ControlDown(*args, **kwargs)
4467
4468 def MetaDown(*args, **kwargs):
27fb7603
RD
4469 """
4470 MetaDown(self) -> bool
4471
4472 Returns true if the Meta key was down at the time of the event.
4473 """
d55e5bfc
RD
4474 return _core_.MouseEvent_MetaDown(*args, **kwargs)
4475
4476 def AltDown(*args, **kwargs):
27fb7603
RD
4477 """
4478 AltDown(self) -> bool
4479
4480 Returns true if the Alt key was down at the time of the event.
4481 """
d55e5bfc
RD
4482 return _core_.MouseEvent_AltDown(*args, **kwargs)
4483
4484 def ShiftDown(*args, **kwargs):
27fb7603
RD
4485 """
4486 ShiftDown(self) -> bool
4487
4488 Returns true if the Shift key was down at the time of the event.
4489 """
d55e5bfc
RD
4490 return _core_.MouseEvent_ShiftDown(*args, **kwargs)
4491
412d302d
RD
4492 def CmdDown(*args, **kwargs):
4493 """
4494 CmdDown(self) -> bool
4495
4496 "Cmd" is a pseudo key which is the same as Control for PC and Unix
4497 platforms but the special "Apple" (a.k.a as "Command") key on
5ba5649b 4498 Macs. It often makes sense to use it instead of, say, `ControlDown`
412d302d 4499 because Cmd key is used for the same thing under Mac as Ctrl
27fb7603 4500 elsewhere. The Ctrl key still exists, it's just not used for this
412d302d
RD
4501 purpose. So for non-Mac platforms this is the same as `ControlDown`
4502 and Macs this is the same as `MetaDown`.
4503 """
4504 return _core_.MouseEvent_CmdDown(*args, **kwargs)
4505
d55e5bfc 4506 def LeftDown(*args, **kwargs):
27fb7603
RD
4507 """
4508 LeftDown(self) -> bool
4509
4510 Returns true if the left mouse button state changed to down.
4511 """
d55e5bfc
RD
4512 return _core_.MouseEvent_LeftDown(*args, **kwargs)
4513
4514 def MiddleDown(*args, **kwargs):
27fb7603
RD
4515 """
4516 MiddleDown(self) -> bool
4517
4518 Returns true if the middle mouse button state changed to down.
4519 """
d55e5bfc
RD
4520 return _core_.MouseEvent_MiddleDown(*args, **kwargs)
4521
4522 def RightDown(*args, **kwargs):
27fb7603
RD
4523 """
4524 RightDown(self) -> bool
4525
4526 Returns true if the right mouse button state changed to down.
4527 """
d55e5bfc
RD
4528 return _core_.MouseEvent_RightDown(*args, **kwargs)
4529
4530 def LeftUp(*args, **kwargs):
27fb7603
RD
4531 """
4532 LeftUp(self) -> bool
4533
4534 Returns true if the left mouse button state changed to up.
4535 """
d55e5bfc
RD
4536 return _core_.MouseEvent_LeftUp(*args, **kwargs)
4537
4538 def MiddleUp(*args, **kwargs):
27fb7603
RD
4539 """
4540 MiddleUp(self) -> bool
4541
4542 Returns true if the middle mouse button state changed to up.
4543 """
d55e5bfc
RD
4544 return _core_.MouseEvent_MiddleUp(*args, **kwargs)
4545
4546 def RightUp(*args, **kwargs):
27fb7603
RD
4547 """
4548 RightUp(self) -> bool
4549
4550 Returns true if the right mouse button state changed to up.
4551 """
d55e5bfc
RD
4552 return _core_.MouseEvent_RightUp(*args, **kwargs)
4553
4554 def LeftDClick(*args, **kwargs):
27fb7603
RD
4555 """
4556 LeftDClick(self) -> bool
4557
4558 Returns true if the event was a left button double click.
4559 """
d55e5bfc
RD
4560 return _core_.MouseEvent_LeftDClick(*args, **kwargs)
4561
4562 def MiddleDClick(*args, **kwargs):
27fb7603
RD
4563 """
4564 MiddleDClick(self) -> bool
4565
4566 Returns true if the event was a middle button double click.
4567 """
d55e5bfc
RD
4568 return _core_.MouseEvent_MiddleDClick(*args, **kwargs)
4569
4570 def RightDClick(*args, **kwargs):
27fb7603
RD
4571 """
4572 RightDClick(self) -> bool
4573
4574 Returns true if the event was a right button double click.
4575 """
d55e5bfc
RD
4576 return _core_.MouseEvent_RightDClick(*args, **kwargs)
4577
4578 def LeftIsDown(*args, **kwargs):
27fb7603
RD
4579 """
4580 LeftIsDown(self) -> bool
4581
4582 Returns true if the left mouse button is currently down, independent
4583 of the current event type.
4584
4585 Please notice that it is not the same as LeftDown which returns true
4586 if the left mouse button was just pressed. Rather, it describes the
4587 state of the mouse button before the event happened.
4588
4589 This event is usually used in the mouse event handlers which process
4590 "move mouse" messages to determine whether the user is (still)
4591 dragging the mouse.
4592 """
d55e5bfc
RD
4593 return _core_.MouseEvent_LeftIsDown(*args, **kwargs)
4594
4595 def MiddleIsDown(*args, **kwargs):
27fb7603
RD
4596 """
4597 MiddleIsDown(self) -> bool
4598
4599 Returns true if the middle mouse button is currently down, independent
4600 of the current event type.
4601 """
d55e5bfc
RD
4602 return _core_.MouseEvent_MiddleIsDown(*args, **kwargs)
4603
4604 def RightIsDown(*args, **kwargs):
27fb7603
RD
4605 """
4606 RightIsDown(self) -> bool
4607
4608 Returns true if the right mouse button is currently down, independent
4609 of the current event type.
4610 """
d55e5bfc
RD
4611 return _core_.MouseEvent_RightIsDown(*args, **kwargs)
4612
4613 def Dragging(*args, **kwargs):
27fb7603
RD
4614 """
4615 Dragging(self) -> bool
4616
4617 Returns true if this was a dragging event (motion while a button is
4618 depressed).
4619 """
d55e5bfc
RD
4620 return _core_.MouseEvent_Dragging(*args, **kwargs)
4621
4622 def Moving(*args, **kwargs):
27fb7603
RD
4623 """
4624 Moving(self) -> bool
4625
4626 Returns true if this was a motion event and no mouse buttons were
4627 pressed. If any mouse button is held pressed, then this method returns
4628 false and Dragging returns true.
4629 """
d55e5bfc
RD
4630 return _core_.MouseEvent_Moving(*args, **kwargs)
4631
4632 def Entering(*args, **kwargs):
27fb7603
RD
4633 """
4634 Entering(self) -> bool
4635
4636 Returns true if the mouse was entering the window.
4637 """
d55e5bfc
RD
4638 return _core_.MouseEvent_Entering(*args, **kwargs)
4639
4640 def Leaving(*args, **kwargs):
27fb7603
RD
4641 """
4642 Leaving(self) -> bool
4643
4644 Returns true if the mouse was leaving the window.
4645 """
d55e5bfc
RD
4646 return _core_.MouseEvent_Leaving(*args, **kwargs)
4647
4648 def GetPosition(*args, **kwargs):
4649 """
4650 GetPosition(self) -> Point
4651
27fb7603
RD
4652 Returns the pixel position of the mouse in window coordinates when the
4653 event happened.
d55e5bfc
RD
4654 """
4655 return _core_.MouseEvent_GetPosition(*args, **kwargs)
4656
4657 def GetPositionTuple(*args, **kwargs):
4658 """
4659 GetPositionTuple() -> (x,y)
4660
27fb7603
RD
4661 Returns the pixel position of the mouse in window coordinates when the
4662 event happened.
d55e5bfc
RD
4663 """
4664 return _core_.MouseEvent_GetPositionTuple(*args, **kwargs)
4665
4666 def GetLogicalPosition(*args, **kwargs):
27fb7603
RD
4667 """
4668 GetLogicalPosition(self, DC dc) -> Point
4669
4670 Returns the logical mouse position in pixels (i.e. translated
4671 according to the translation set for the DC, which usually indicates
4672 that the window has been scrolled).
4673 """
d55e5bfc
RD
4674 return _core_.MouseEvent_GetLogicalPosition(*args, **kwargs)
4675
4676 def GetX(*args, **kwargs):
27fb7603
RD
4677 """
4678 GetX(self) -> int
4679
4680 Returns X coordinate of the physical mouse event position.
4681 """
d55e5bfc
RD
4682 return _core_.MouseEvent_GetX(*args, **kwargs)
4683
4684 def GetY(*args, **kwargs):
27fb7603
RD
4685 """
4686 GetY(self) -> int
4687
4688 Returns Y coordinate of the physical mouse event position.
4689 """
d55e5bfc
RD
4690 return _core_.MouseEvent_GetY(*args, **kwargs)
4691
4692 def GetWheelRotation(*args, **kwargs):
27fb7603
RD
4693 """
4694 GetWheelRotation(self) -> int
4695
4696 Get wheel rotation, positive or negative indicates direction of
4697 rotation. Current devices all send an event when rotation is equal to
4698 +/-WheelDelta, but this allows for finer resolution devices to be
4699 created in the future. Because of this you shouldn't assume that one
4700 event is equal to 1 line or whatever, but you should be able to either
4701 do partial line scrolling or wait until +/-WheelDelta rotation values
4702 have been accumulated before scrolling.
4703 """
d55e5bfc
RD
4704 return _core_.MouseEvent_GetWheelRotation(*args, **kwargs)
4705
4706 def GetWheelDelta(*args, **kwargs):
27fb7603
RD
4707 """
4708 GetWheelDelta(self) -> int
4709
4710 Get wheel delta, normally 120. This is the threshold for action to be
4711 taken, and one such action (for example, scrolling one increment)
4712 should occur for each delta.
4713 """
d55e5bfc
RD
4714 return _core_.MouseEvent_GetWheelDelta(*args, **kwargs)
4715
4716 def GetLinesPerAction(*args, **kwargs):
27fb7603
RD
4717 """
4718 GetLinesPerAction(self) -> int
4719
4720 Returns the configured number of lines (or whatever) to be scrolled
4721 per wheel action. Defaults to three.
4722 """
d55e5bfc
RD
4723 return _core_.MouseEvent_GetLinesPerAction(*args, **kwargs)
4724
4725 def IsPageScroll(*args, **kwargs):
27fb7603
RD
4726 """
4727 IsPageScroll(self) -> bool
4728
4729 Returns true if the system has been setup to do page scrolling with
4730 the mouse wheel instead of line scrolling.
4731 """
d55e5bfc
RD
4732 return _core_.MouseEvent_IsPageScroll(*args, **kwargs)
4733
4734 m_x = property(_core_.MouseEvent_m_x_get, _core_.MouseEvent_m_x_set)
4735 m_y = property(_core_.MouseEvent_m_y_get, _core_.MouseEvent_m_y_set)
4736 m_leftDown = property(_core_.MouseEvent_m_leftDown_get, _core_.MouseEvent_m_leftDown_set)
4737 m_middleDown = property(_core_.MouseEvent_m_middleDown_get, _core_.MouseEvent_m_middleDown_set)
4738 m_rightDown = property(_core_.MouseEvent_m_rightDown_get, _core_.MouseEvent_m_rightDown_set)
4739 m_controlDown = property(_core_.MouseEvent_m_controlDown_get, _core_.MouseEvent_m_controlDown_set)
4740 m_shiftDown = property(_core_.MouseEvent_m_shiftDown_get, _core_.MouseEvent_m_shiftDown_set)
4741 m_altDown = property(_core_.MouseEvent_m_altDown_get, _core_.MouseEvent_m_altDown_set)
4742 m_metaDown = property(_core_.MouseEvent_m_metaDown_get, _core_.MouseEvent_m_metaDown_set)
4743 m_wheelRotation = property(_core_.MouseEvent_m_wheelRotation_get, _core_.MouseEvent_m_wheelRotation_set)
4744 m_wheelDelta = property(_core_.MouseEvent_m_wheelDelta_get, _core_.MouseEvent_m_wheelDelta_set)
4745 m_linesPerAction = property(_core_.MouseEvent_m_linesPerAction_get, _core_.MouseEvent_m_linesPerAction_set)
4746
4747class MouseEventPtr(MouseEvent):
4748 def __init__(self, this):
4749 self.this = this
4750 if not hasattr(self,"thisown"): self.thisown = 0
4751 self.__class__ = MouseEvent
4752_core_.MouseEvent_swigregister(MouseEventPtr)
4753
4754#---------------------------------------------------------------------------
4755
4756class SetCursorEvent(Event):
5ba5649b
RD
4757 """
4758 A SetCursorEvent is generated when the mouse cursor is about to be set
4759 as a result of mouse motion. This event gives the application the
4760 chance to perform specific mouse cursor processing based on the
4761 current position of the mouse within the window. Use the `SetCursor`
4762 method to specify the cursor you want to be displayed.
4763 """
d55e5bfc
RD
4764 def __repr__(self):
4765 return "<%s.%s; proxy of C++ wxSetCursorEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4766 def __init__(self, *args, **kwargs):
5ba5649b
RD
4767 """
4768 __init__(self, int x=0, int y=0) -> SetCursorEvent
4769
4770 Construct a new `wx.SetCursorEvent`.
4771 """
d55e5bfc
RD
4772 newobj = _core_.new_SetCursorEvent(*args, **kwargs)
4773 self.this = newobj.this
4774 self.thisown = 1
4775 del newobj.thisown
4776 def GetX(*args, **kwargs):
5ba5649b
RD
4777 """
4778 GetX(self) -> int
4779
4780 Returns the X coordinate of the mouse in client coordinates.
4781 """
d55e5bfc
RD
4782 return _core_.SetCursorEvent_GetX(*args, **kwargs)
4783
4784 def GetY(*args, **kwargs):
5ba5649b
RD
4785 """
4786 GetY(self) -> int
4787
4788 Returns the Y coordinate of the mouse in client coordinates.
4789 """
d55e5bfc
RD
4790 return _core_.SetCursorEvent_GetY(*args, **kwargs)
4791
4792 def SetCursor(*args, **kwargs):
5ba5649b
RD
4793 """
4794 SetCursor(self, Cursor cursor)
4795
4796 Sets the cursor associated with this event.
4797 """
d55e5bfc
RD
4798 return _core_.SetCursorEvent_SetCursor(*args, **kwargs)
4799
4800 def GetCursor(*args, **kwargs):
5ba5649b
RD
4801 """
4802 GetCursor(self) -> Cursor
4803
4804 Returns a reference to the cursor specified by this event.
4805 """
d55e5bfc
RD
4806 return _core_.SetCursorEvent_GetCursor(*args, **kwargs)
4807
4808 def HasCursor(*args, **kwargs):
5ba5649b
RD
4809 """
4810 HasCursor(self) -> bool
4811
4812 Returns true if the cursor specified by this event is a valid cursor.
4813 """
d55e5bfc
RD
4814 return _core_.SetCursorEvent_HasCursor(*args, **kwargs)
4815
4816
4817class SetCursorEventPtr(SetCursorEvent):
4818 def __init__(self, this):
4819 self.this = this
4820 if not hasattr(self,"thisown"): self.thisown = 0
4821 self.__class__ = SetCursorEvent
4822_core_.SetCursorEvent_swigregister(SetCursorEventPtr)
4823
4824#---------------------------------------------------------------------------
4825
4826class KeyEvent(Event):
5ba5649b
RD
4827 """
4828 This event class contains information about keypress and character
4829 events. These events are only sent to the widget that currently has
4830 the keyboard focus.
4831
4832 Notice that there are three different kinds of keyboard events in
4833 wxWidgets: key down and up events and char events. The difference
4834 between the first two is clear - the first corresponds to a key press
4835 and the second to a key release - otherwise they are identical. Just
4836 note that if the key is maintained in a pressed state you will
4837 typically get a lot of (automatically generated) down events but only
4838 one up so it is wrong to assume that there is one up event
4839 corresponding to each down one.
4840
4841 Both key events provide untranslated key codes while the char event
4842 carries the translated one. The untranslated code for alphanumeric
4843 keys is always an upper case value. For the other keys it is one of
4844 WXK_XXX values from the keycodes table. The translated key is, in
4845 general, the character the user expects to appear as the result of the
4846 key combination when typing the text into a text entry zone, for
4847 example.
4848
4849 A few examples to clarify this (all assume that CAPS LOCK is unpressed
4850 and the standard US keyboard): when the 'A' key is pressed, the key
4851 down event key code is equal to ASCII A == 65. But the char event key
4852 code is ASCII a == 97. On the other hand, if you press both SHIFT and
4853 'A' keys simultaneously , the key code in key down event will still be
4854 just 'A' while the char event key code parameter will now be 'A' as
4855 well.
4856
4857 Although in this simple case it is clear that the correct key code
4858 could be found in the key down event handler by checking the value
4859 returned by `ShiftDown`, in general you should use EVT_CHAR for this
4860 as for non alphanumeric keys or non-US keyboard layouts the
4861 translation is keyboard-layout dependent and can only be done properly
4862 by the system itself.
4863
4864 Another kind of translation is done when the control key is pressed:
4865 for example, for CTRL-A key press the key down event still carries the
4866 same key code 'A' as usual but the char event will have key code of 1,
4867 the ASCII value of this key combination.
4868
4869 You may discover how the other keys on your system behave
4870 interactively by running the KeyEvents sample in the wxPython demo and
4871 pressing some keys while the blue box at the top has the keyboard
4872 focus.
4873
4874 **Note**: If a key down event is caught and the event handler does not
4875 call event.Skip() then the coresponding char event will not
4876 happen. This is by design and enables the programs that handle both
4877 types of events to be a bit simpler.
4878
4879 **Note for Windows programmers**: The key and char events in wxWidgets
4880 are similar to but slightly different from Windows WM_KEYDOWN and
4881 WM_CHAR events. In particular, Alt-x combination will generate a char
4882 event in wxWidgets (unless it is used as an accelerator).
4883
4884 **Tip**: be sure to call event.Skip() for events that you don't
4885 process in key event function, otherwise menu shortcuts may cease to
4886 work under Windows.
4887
4888 """
d55e5bfc
RD
4889 def __repr__(self):
4890 return "<%s.%s; proxy of C++ wxKeyEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
4891 def __init__(self, *args, **kwargs):
5ba5649b
RD
4892 """
4893 __init__(self, wxEventType eventType=wxEVT_NULL) -> KeyEvent
4894
4895 Construct a new `wx.KeyEvent`. Valid event types are:
4896 *
4897 """
d55e5bfc
RD
4898 newobj = _core_.new_KeyEvent(*args, **kwargs)
4899 self.this = newobj.this
4900 self.thisown = 1
4901 del newobj.thisown
4902 def ControlDown(*args, **kwargs):
5ba5649b
RD
4903 """
4904 ControlDown(self) -> bool
4905
4906 Returns ``True`` if the Control key was down at the time of the event.
4907 """
d55e5bfc
RD
4908 return _core_.KeyEvent_ControlDown(*args, **kwargs)
4909
4910 def MetaDown(*args, **kwargs):
5ba5649b
RD
4911 """
4912 MetaDown(self) -> bool
4913
4914 Returns ``True`` if the Meta key was down at the time of the event.
4915 """
d55e5bfc
RD
4916 return _core_.KeyEvent_MetaDown(*args, **kwargs)
4917
4918 def AltDown(*args, **kwargs):
5ba5649b
RD
4919 """
4920 AltDown(self) -> bool
4921
4922 Returns ``True`` if the Alt key was down at the time of the event.
4923 """
d55e5bfc
RD
4924 return _core_.KeyEvent_AltDown(*args, **kwargs)
4925
4926 def ShiftDown(*args, **kwargs):
5ba5649b
RD
4927 """
4928 ShiftDown(self) -> bool
4929
4930 Returns ``True`` if the Shift key was down at the time of the event.
4931 """
d55e5bfc
RD
4932 return _core_.KeyEvent_ShiftDown(*args, **kwargs)
4933
412d302d
RD
4934 def CmdDown(*args, **kwargs):
4935 """
4936 CmdDown(self) -> bool
4937
4938 "Cmd" is a pseudo key which is the same as Control for PC and Unix
4939 platforms but the special "Apple" (a.k.a as "Command") key on
5ba5649b 4940 Macs. It makes often sense to use it instead of, say, `ControlDown`
412d302d
RD
4941 because Cmd key is used for the same thing under Mac as Ctrl
4942 elsewhere. The Ctrl still exists, it's just not used for this
4943 purpose. So for non-Mac platforms this is the same as `ControlDown`
4944 and Macs this is the same as `MetaDown`.
4945 """
4946 return _core_.KeyEvent_CmdDown(*args, **kwargs)
4947
d55e5bfc 4948 def HasModifiers(*args, **kwargs):
5ba5649b
RD
4949 """
4950 HasModifiers(self) -> bool
4951
4952 Returns true if either CTRL or ALT keys was down at the time of the
4953 key event. Note that this function does not take into account neither
4954 SHIFT nor META key states (the reason for ignoring the latter is that
4955 it is common for NUMLOCK key to be configured as META under X but the
4956 key presses even while NUMLOCK is on should be still processed
4957 normally).
4958 """
d55e5bfc
RD
4959 return _core_.KeyEvent_HasModifiers(*args, **kwargs)
4960
4961 def GetKeyCode(*args, **kwargs):
5ba5649b
RD
4962 """
4963 GetKeyCode(self) -> int
4964
4965 Returns the virtual key code. ASCII events return normal ASCII values,
4966 while non-ASCII events return values such as WXK_LEFT for the left
4967 cursor key. See `wx.KeyEvent` for a full list of the virtual key
4968 codes.
4969
4970 Note that in Unicode build, the returned value is meaningful only if
4971 the user entered a character that can be represented in current
4972 locale's default charset. You can obtain the corresponding Unicode
4973 character using `GetUnicodeKey`.
4974 """
d55e5bfc
RD
4975 return _core_.KeyEvent_GetKeyCode(*args, **kwargs)
4976
4977 KeyCode = GetKeyCode
19272049 4978 def GetUnicodeKey(*args, **kwargs):
5ba5649b
RD
4979 """
4980 GetUnicodeKey(self) -> int
4981
4982 Returns the Unicode character corresponding to this key event. This
4983 function is only meaningfule in a Unicode build of wxPython.
4984 """
19272049 4985 return _core_.KeyEvent_GetUnicodeKey(*args, **kwargs)
d55e5bfc 4986
19272049 4987 GetUniChar = GetUnicodeKey
d55e5bfc 4988 def GetRawKeyCode(*args, **kwargs):
5ba5649b
RD
4989 """
4990 GetRawKeyCode(self) -> unsigned int
4991
4992 Returns the raw key code for this event. This is a platform-dependent
4993 scan code which should only be used in advanced
4994 applications. Currently the raw key codes are not supported by all
4995 ports.
4996 """
d55e5bfc
RD
4997 return _core_.KeyEvent_GetRawKeyCode(*args, **kwargs)
4998
4999 def GetRawKeyFlags(*args, **kwargs):
5ba5649b
RD
5000 """
5001 GetRawKeyFlags(self) -> unsigned int
5002
5003 Returns the low level key flags for this event. The flags are
5004 platform-dependent and should only be used in advanced applications.
5005 Currently the raw key flags are not supported by all ports.
5006 """
d55e5bfc
RD
5007 return _core_.KeyEvent_GetRawKeyFlags(*args, **kwargs)
5008
5009 def GetPosition(*args, **kwargs):
5010 """
5011 GetPosition(self) -> Point
5012
5ba5649b 5013 Find the position of the event, if applicable.
d55e5bfc
RD
5014 """
5015 return _core_.KeyEvent_GetPosition(*args, **kwargs)
5016
5017 def GetPositionTuple(*args, **kwargs):
5018 """
5019 GetPositionTuple() -> (x,y)
5020
5ba5649b 5021 Find the position of the event, if applicable.
d55e5bfc
RD
5022 """
5023 return _core_.KeyEvent_GetPositionTuple(*args, **kwargs)
5024
5025 def GetX(*args, **kwargs):
5ba5649b
RD
5026 """
5027 GetX(self) -> int
5028
5029 Returns the X position (in client coordinates) of the event, if
5030 applicable.
5031 """
d55e5bfc
RD
5032 return _core_.KeyEvent_GetX(*args, **kwargs)
5033
5034 def GetY(*args, **kwargs):
5ba5649b
RD
5035 """
5036 GetY(self) -> int
5037
5038 Returns the Y position (in client coordinates) of the event, if
5039 applicable.
5040 """
d55e5bfc
RD
5041 return _core_.KeyEvent_GetY(*args, **kwargs)
5042
5043 m_x = property(_core_.KeyEvent_m_x_get, _core_.KeyEvent_m_x_set)
5044 m_y = property(_core_.KeyEvent_m_y_get, _core_.KeyEvent_m_y_set)
5045 m_keyCode = property(_core_.KeyEvent_m_keyCode_get, _core_.KeyEvent_m_keyCode_set)
5046 m_controlDown = property(_core_.KeyEvent_m_controlDown_get, _core_.KeyEvent_m_controlDown_set)
5047 m_shiftDown = property(_core_.KeyEvent_m_shiftDown_get, _core_.KeyEvent_m_shiftDown_set)
5048 m_altDown = property(_core_.KeyEvent_m_altDown_get, _core_.KeyEvent_m_altDown_set)
5049 m_metaDown = property(_core_.KeyEvent_m_metaDown_get, _core_.KeyEvent_m_metaDown_set)
5050 m_scanCode = property(_core_.KeyEvent_m_scanCode_get, _core_.KeyEvent_m_scanCode_set)
5051 m_rawCode = property(_core_.KeyEvent_m_rawCode_get, _core_.KeyEvent_m_rawCode_set)
5052 m_rawFlags = property(_core_.KeyEvent_m_rawFlags_get, _core_.KeyEvent_m_rawFlags_set)
5053
5054class KeyEventPtr(KeyEvent):
5055 def __init__(self, this):
5056 self.this = this
5057 if not hasattr(self,"thisown"): self.thisown = 0
5058 self.__class__ = KeyEvent
5059_core_.KeyEvent_swigregister(KeyEventPtr)
5060
5061#---------------------------------------------------------------------------
5062
5063class SizeEvent(Event):
5ba5649b
RD
5064 """
5065 A size event holds information about size change events. The EVT_SIZE
5066 handler function will be called when the window it is bound to has
5067 been resized.
5068
5069 Note that the size passed is of the whole window: call
5070 `wx.Window.GetClientSize` for the area which may be used by the
5071 application.
5072
5073 When a window is resized, usually only a small part of the window is
5074 damaged and and that area is all that is in the update region for the
5075 next paint event. However, if your drawing depends on the size of the
5076 window, you may need to clear the DC explicitly and repaint the whole
5077 window. In which case, you may need to call `wx.Window.Refresh` to
5078 invalidate the entire window.
5079
5080 """
d55e5bfc
RD
5081 def __repr__(self):
5082 return "<%s.%s; proxy of C++ wxSizeEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5083 def __init__(self, *args, **kwargs):
5ba5649b
RD
5084 """
5085 __init__(self, Size sz=DefaultSize, int winid=0) -> SizeEvent
5086
5087 Construct a new ``wx.SizeEvent``.
5088 """
d55e5bfc
RD
5089 newobj = _core_.new_SizeEvent(*args, **kwargs)
5090 self.this = newobj.this
5091 self.thisown = 1
5092 del newobj.thisown
5093 def GetSize(*args, **kwargs):
5ba5649b
RD
5094 """
5095 GetSize(self) -> Size
5096
5097 Returns the entire size of the window generating the size change
5098 event.
5099 """
d55e5bfc
RD
5100 return _core_.SizeEvent_GetSize(*args, **kwargs)
5101
5102 def GetRect(*args, **kwargs):
5103 """GetRect(self) -> Rect"""
5104 return _core_.SizeEvent_GetRect(*args, **kwargs)
5105
5106 def SetRect(*args, **kwargs):
5107 """SetRect(self, Rect rect)"""
5108 return _core_.SizeEvent_SetRect(*args, **kwargs)
5109
5110 def SetSize(*args, **kwargs):
5111 """SetSize(self, Size size)"""
5112 return _core_.SizeEvent_SetSize(*args, **kwargs)
5113
5114 m_size = property(_core_.SizeEvent_m_size_get, _core_.SizeEvent_m_size_set)
5115 m_rect = property(_core_.SizeEvent_m_rect_get, _core_.SizeEvent_m_rect_set)
5116
5117class SizeEventPtr(SizeEvent):
5118 def __init__(self, this):
5119 self.this = this
5120 if not hasattr(self,"thisown"): self.thisown = 0
5121 self.__class__ = SizeEvent
5122_core_.SizeEvent_swigregister(SizeEventPtr)
5123
5124#---------------------------------------------------------------------------
5125
5126class MoveEvent(Event):
5ba5649b
RD
5127 """
5128 This event object is sent for EVT_MOVE event bindings when a window is
5129 moved to a new position.
5130 """
d55e5bfc
RD
5131 def __repr__(self):
5132 return "<%s.%s; proxy of C++ wxMoveEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5133 def __init__(self, *args, **kwargs):
5ba5649b
RD
5134 """
5135 __init__(self, Point pos=DefaultPosition, int winid=0) -> MoveEvent
5136
5137 Constructor.
5138 """
d55e5bfc
RD
5139 newobj = _core_.new_MoveEvent(*args, **kwargs)
5140 self.this = newobj.this
5141 self.thisown = 1
5142 del newobj.thisown
5143 def GetPosition(*args, **kwargs):
5ba5649b
RD
5144 """
5145 GetPosition(self) -> Point
5146
5147 Returns the position of the window generating the move change event.
5148 """
d55e5bfc
RD
5149 return _core_.MoveEvent_GetPosition(*args, **kwargs)
5150
5151 def GetRect(*args, **kwargs):
5152 """GetRect(self) -> Rect"""
5153 return _core_.MoveEvent_GetRect(*args, **kwargs)
5154
5155 def SetRect(*args, **kwargs):
5156 """SetRect(self, Rect rect)"""
5157 return _core_.MoveEvent_SetRect(*args, **kwargs)
5158
5159 def SetPosition(*args, **kwargs):
5160 """SetPosition(self, Point pos)"""
5161 return _core_.MoveEvent_SetPosition(*args, **kwargs)
5162
fef4c27a
RD
5163 m_pos = property(GetPosition, SetPosition)
5164 m_rect = property(GetRect, SetRect)
5165
d55e5bfc
RD
5166
5167class MoveEventPtr(MoveEvent):
5168 def __init__(self, this):
5169 self.this = this
5170 if not hasattr(self,"thisown"): self.thisown = 0
5171 self.__class__ = MoveEvent
5172_core_.MoveEvent_swigregister(MoveEventPtr)
5173
5174#---------------------------------------------------------------------------
5175
5176class PaintEvent(Event):
5ba5649b
RD
5177 """
5178 A paint event is sent when a window's contents needs to be repainted.
5179 Note that in an EVT_PAINT handler the application must *always* create
5180 a `wx.PaintDC` object, even if you do not use it. Otherwise MS
5181 Windows assumes that the window has not been painted yet and will send
5182 the event again, causing endless refreshes.
5183
5184 You can optimize painting by retrieving the rectangles that have been
5185 damaged using `wx.Window.GetUpdateRegion` and/or `wx.RegionIterator`,
5186 and only repainting these rectangles. The rectangles are in terms of
5187 the client area, and are unscrolled, so you will need to do some
5188 calculations using the current view position to obtain logical,
5189 scrolled units.
5190
5191 """
d55e5bfc
RD
5192 def __repr__(self):
5193 return "<%s.%s; proxy of C++ wxPaintEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5194 def __init__(self, *args, **kwargs):
5195 """__init__(self, int Id=0) -> PaintEvent"""
5196 newobj = _core_.new_PaintEvent(*args, **kwargs)
5197 self.this = newobj.this
5198 self.thisown = 1
5199 del newobj.thisown
5200
5201class PaintEventPtr(PaintEvent):
5202 def __init__(self, this):
5203 self.this = this
5204 if not hasattr(self,"thisown"): self.thisown = 0
5205 self.__class__ = PaintEvent
5206_core_.PaintEvent_swigregister(PaintEventPtr)
5207
5208class NcPaintEvent(Event):
093d3ff1 5209 """Proxy of C++ NcPaintEvent class"""
d55e5bfc
RD
5210 def __repr__(self):
5211 return "<%s.%s; proxy of C++ wxNcPaintEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5212 def __init__(self, *args, **kwargs):
5213 """__init__(self, int winid=0) -> NcPaintEvent"""
5214 newobj = _core_.new_NcPaintEvent(*args, **kwargs)
5215 self.this = newobj.this
5216 self.thisown = 1
5217 del newobj.thisown
5218
5219class NcPaintEventPtr(NcPaintEvent):
5220 def __init__(self, this):
5221 self.this = this
5222 if not hasattr(self,"thisown"): self.thisown = 0
5223 self.__class__ = NcPaintEvent
5224_core_.NcPaintEvent_swigregister(NcPaintEventPtr)
5225
5226#---------------------------------------------------------------------------
5227
5228class EraseEvent(Event):
5ba5649b
RD
5229 """
5230 An erase event is sent whenever the background of a window needs to be
5231 repainted. To intercept this event use the EVT_ERASE_BACKGROUND event
5232 binder. On some platforms, such as GTK+, this event is simulated
5233 (simply generated just before the paint event) and may cause flicker.
5234
5235 To paint a custom background use the `GetDC` method and use the returned
5236 device context if it is not ``None``, otherwise create a temporary
5237 `wx.ClientDC` and draw on that.
5238
5239 """
d55e5bfc
RD
5240 def __repr__(self):
5241 return "<%s.%s; proxy of C++ wxEraseEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5242 def __init__(self, *args, **kwargs):
5ba5649b
RD
5243 """
5244 __init__(self, int Id=0, DC dc=None) -> EraseEvent
5245
5246 Constructor
5247 """
d55e5bfc
RD
5248 newobj = _core_.new_EraseEvent(*args, **kwargs)
5249 self.this = newobj.this
5250 self.thisown = 1
5251 del newobj.thisown
5252 def GetDC(*args, **kwargs):
5ba5649b
RD
5253 """
5254 GetDC(self) -> DC
5255
5256 Returns the device context the event handler should draw upon. If
5257 ``None`` is returned then create a temporary `wx.ClientDC` and use
5258 that instead.
5259 """
d55e5bfc
RD
5260 return _core_.EraseEvent_GetDC(*args, **kwargs)
5261
5262
5263class EraseEventPtr(EraseEvent):
5264 def __init__(self, this):
5265 self.this = this
5266 if not hasattr(self,"thisown"): self.thisown = 0
5267 self.__class__ = EraseEvent
5268_core_.EraseEvent_swigregister(EraseEventPtr)
5269
5270#---------------------------------------------------------------------------
5271
5272class FocusEvent(Event):
5ba5649b
RD
5273 """
5274 A focus event is sent when a window's focus changes. The window losing
5275 focus receives an EVT_KILL_FOCUS event while the window gaining it
5276 gets an EVT_SET_FOCUS event.
5277
5278 Notice that the set focus event happens both when the user gives focus
5279 to the window (whether using the mouse or keyboard) and when it is
5280 done from the program itself using `wx.Window.SetFocus`.
5281
5282 """
d55e5bfc
RD
5283 def __repr__(self):
5284 return "<%s.%s; proxy of C++ wxFocusEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5285 def __init__(self, *args, **kwargs):
5ba5649b
RD
5286 """
5287 __init__(self, wxEventType type=wxEVT_NULL, int winid=0) -> FocusEvent
5288
5289 Constructor
5290 """
d55e5bfc
RD
5291 newobj = _core_.new_FocusEvent(*args, **kwargs)
5292 self.this = newobj.this
5293 self.thisown = 1
5294 del newobj.thisown
5295 def GetWindow(*args, **kwargs):
5ba5649b
RD
5296 """
5297 GetWindow(self) -> Window
5298
5299 Returns the other window associated with this event, that is the
5300 window which had the focus before for the EVT_SET_FOCUS event and the
5301 window which is going to receive focus for the wxEVT_KILL_FOCUS event.
5302
5303 Warning: the window returned may be None!
5304 """
d55e5bfc
RD
5305 return _core_.FocusEvent_GetWindow(*args, **kwargs)
5306
5307 def SetWindow(*args, **kwargs):
5308 """SetWindow(self, Window win)"""
5309 return _core_.FocusEvent_SetWindow(*args, **kwargs)
5310
5311
5312class FocusEventPtr(FocusEvent):
5313 def __init__(self, this):
5314 self.this = this
5315 if not hasattr(self,"thisown"): self.thisown = 0
5316 self.__class__ = FocusEvent
5317_core_.FocusEvent_swigregister(FocusEventPtr)
5318
5319#---------------------------------------------------------------------------
5320
5321class ChildFocusEvent(CommandEvent):
5ba5649b
RD
5322 """
5323 wx.ChildFocusEvent notifies the parent that a child has received the
5324 focus. Unlike `wx.FocusEvent` it is propagated up the window
5325 heirarchy.
5326 """
d55e5bfc
RD
5327 def __repr__(self):
5328 return "<%s.%s; proxy of C++ wxChildFocusEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5329 def __init__(self, *args, **kwargs):
5ba5649b
RD
5330 """
5331 __init__(self, Window win=None) -> ChildFocusEvent
5332
5333 Constructor
5334 """
d55e5bfc
RD
5335 newobj = _core_.new_ChildFocusEvent(*args, **kwargs)
5336 self.this = newobj.this
5337 self.thisown = 1
5338 del newobj.thisown
5339 def GetWindow(*args, **kwargs):
5ba5649b
RD
5340 """
5341 GetWindow(self) -> Window
5342
5343 The window which has just received the focus.
5344 """
d55e5bfc
RD
5345 return _core_.ChildFocusEvent_GetWindow(*args, **kwargs)
5346
5347
5348class ChildFocusEventPtr(ChildFocusEvent):
5349 def __init__(self, this):
5350 self.this = this
5351 if not hasattr(self,"thisown"): self.thisown = 0
5352 self.__class__ = ChildFocusEvent
5353_core_.ChildFocusEvent_swigregister(ChildFocusEventPtr)
5354
5355#---------------------------------------------------------------------------
5356
5357class ActivateEvent(Event):
5ba5649b
RD
5358 """
5359 An activate event is sent when a top-level window or the entire
5360 application is being activated or deactivated.
5361
5362 A top-level window (a dialog or frame) receives an activate event when
5363 is being activated or deactivated. This is indicated visually by the
5364 title bar changing colour, and a subwindow gaining the keyboard focus.
5365 An application is activated or deactivated when one of its frames
5366 becomes activated, or a frame becomes inactivate resulting in all
5367 application frames being inactive.
5368
5369 Please note that usually you should call event.Skip() in your handlers
5370 for these events so the default handlers will still be called, as not
5371 doing so can result in strange effects.
5372
5373 """
d55e5bfc
RD
5374 def __repr__(self):
5375 return "<%s.%s; proxy of C++ wxActivateEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5376 def __init__(self, *args, **kwargs):
5ba5649b
RD
5377 """
5378 __init__(self, wxEventType type=wxEVT_NULL, bool active=True, int Id=0) -> ActivateEvent
5379
5380 Constructor
5381 """
d55e5bfc
RD
5382 newobj = _core_.new_ActivateEvent(*args, **kwargs)
5383 self.this = newobj.this
5384 self.thisown = 1
5385 del newobj.thisown
5386 def GetActive(*args, **kwargs):
5ba5649b
RD
5387 """
5388 GetActive(self) -> bool
5389
5390 Returns true if the application or window is being activated, false
5391 otherwise.
5392 """
d55e5bfc
RD
5393 return _core_.ActivateEvent_GetActive(*args, **kwargs)
5394
5395
5396class ActivateEventPtr(ActivateEvent):
5397 def __init__(self, this):
5398 self.this = this
5399 if not hasattr(self,"thisown"): self.thisown = 0
5400 self.__class__ = ActivateEvent
5401_core_.ActivateEvent_swigregister(ActivateEventPtr)
5402
5403#---------------------------------------------------------------------------
5404
5405class InitDialogEvent(Event):
5ba5649b
RD
5406 """
5407 A wx.InitDialogEvent is sent as a dialog is being initialised, or for
5408 any window when `wx.Window.InitDialog` is called. Handlers for this
5409 event can transfer data to the window, or anything else that should be
5410 done before the user begins editing the form. The default handler
5411 calls `wx.Window.TransferDataToWindow`.
5412 """
d55e5bfc
RD
5413 def __repr__(self):
5414 return "<%s.%s; proxy of C++ wxInitDialogEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5415 def __init__(self, *args, **kwargs):
5ba5649b
RD
5416 """
5417 __init__(self, int Id=0) -> InitDialogEvent
5418
5419 Constructor
5420 """
d55e5bfc
RD
5421 newobj = _core_.new_InitDialogEvent(*args, **kwargs)
5422 self.this = newobj.this
5423 self.thisown = 1
5424 del newobj.thisown
5425
5426class InitDialogEventPtr(InitDialogEvent):
5427 def __init__(self, this):
5428 self.this = this
5429 if not hasattr(self,"thisown"): self.thisown = 0
5430 self.__class__ = InitDialogEvent
5431_core_.InitDialogEvent_swigregister(InitDialogEventPtr)
5432
5433#---------------------------------------------------------------------------
5434
5435class MenuEvent(Event):
5ba5649b
RD
5436 """
5437 This class is used for a variety of menu-related events. Note that
5438 these do not include menu command events, which are handled by sending
5439 `wx.CommandEvent` objects.
5440
5441 The default handler for wx.EVT_MENU_HIGHLIGHT displays menu item help
5442 text in the first field of the status bar.
5443 """
d55e5bfc
RD
5444 def __repr__(self):
5445 return "<%s.%s; proxy of C++ wxMenuEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5446 def __init__(self, *args, **kwargs):
5ba5649b
RD
5447 """
5448 __init__(self, wxEventType type=wxEVT_NULL, int winid=0, Menu menu=None) -> MenuEvent
5449
5450 Constructor
5451 """
d55e5bfc
RD
5452 newobj = _core_.new_MenuEvent(*args, **kwargs)
5453 self.this = newobj.this
5454 self.thisown = 1
5455 del newobj.thisown
5456 def GetMenuId(*args, **kwargs):
5ba5649b
RD
5457 """
5458 GetMenuId(self) -> int
5459
5460 Returns the menu identifier associated with the event. This method
5461 should be only used with the HIGHLIGHT events.
5462 """
d55e5bfc
RD
5463 return _core_.MenuEvent_GetMenuId(*args, **kwargs)
5464
5465 def IsPopup(*args, **kwargs):
5ba5649b
RD
5466 """
5467 IsPopup(self) -> bool
5468
5469 Returns ``True`` if the menu which is being opened or closed is a
5470 popup menu, ``False`` if it is a normal one. This method should only
5471 be used with the OPEN and CLOSE events.
5472 """
d55e5bfc
RD
5473 return _core_.MenuEvent_IsPopup(*args, **kwargs)
5474
5475 def GetMenu(*args, **kwargs):
5ba5649b
RD
5476 """
5477 GetMenu(self) -> Menu
5478
5479 Returns the menu which is being opened or closed. This method should
5480 only be used with the OPEN and CLOSE events.
5481 """
d55e5bfc
RD
5482 return _core_.MenuEvent_GetMenu(*args, **kwargs)
5483
5484
5485class MenuEventPtr(MenuEvent):
5486 def __init__(self, this):
5487 self.this = this
5488 if not hasattr(self,"thisown"): self.thisown = 0
5489 self.__class__ = MenuEvent
5490_core_.MenuEvent_swigregister(MenuEventPtr)
5491
5492#---------------------------------------------------------------------------
5493
5494class CloseEvent(Event):
5ba5649b
RD
5495 """
5496 This event class contains information about window and session close
5497 events.
5498
5499 The handler function for EVT_CLOSE is called when the user has tried
5500 to close a a frame or dialog box using the window manager controls or
5501 the system menu. It can also be invoked by the application itself
5502 programmatically, for example by calling the `wx.Window.Close`
5503 function.
5504
5505 You should check whether the application is forcing the deletion of
5506 the window using `CanVeto`. If it returns ``False``, you must destroy
5507 the window using `wx.Window.Destroy`. If the return value is ``True``,
5508 it is up to you whether you respond by destroying the window or not.
5509 For example you may wish to display a message dialog prompting to save
5510 files or to cancel the close.
5511
5512 If you don't destroy the window, you should call `Veto` to let the
5513 calling code know that you did not destroy the window. This allows the
5514 `wx.Window.Close` function to return ``True`` or ``False`` depending
5515 on whether the close instruction was honored or not.
5516 """
d55e5bfc
RD
5517 def __repr__(self):
5518 return "<%s.%s; proxy of C++ wxCloseEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5519 def __init__(self, *args, **kwargs):
5ba5649b
RD
5520 """
5521 __init__(self, wxEventType type=wxEVT_NULL, int winid=0) -> CloseEvent
5522
5523 Constructor.
5524 """
d55e5bfc
RD
5525 newobj = _core_.new_CloseEvent(*args, **kwargs)
5526 self.this = newobj.this
5527 self.thisown = 1
5528 del newobj.thisown
5529 def SetLoggingOff(*args, **kwargs):
5ba5649b
RD
5530 """
5531 SetLoggingOff(self, bool logOff)
5532
5533 Sets the 'logging off' flag.
5534 """
d55e5bfc
RD
5535 return _core_.CloseEvent_SetLoggingOff(*args, **kwargs)
5536
5537 def GetLoggingOff(*args, **kwargs):
5ba5649b
RD
5538 """
5539 GetLoggingOff(self) -> bool
5540
034e3677
RD
5541 Returns ``True`` if the user is logging off or ``False`` if the
5542 system is shutting down. This method can only be called for end
5543 session and query end session events, it doesn't make sense for close
5544 window event.
5ba5649b 5545 """
d55e5bfc
RD
5546 return _core_.CloseEvent_GetLoggingOff(*args, **kwargs)
5547
5548 def Veto(*args, **kwargs):
5ba5649b
RD
5549 """
5550 Veto(self, bool veto=True)
5551
5552 Call this from your event handler to veto a system shutdown or to
5553 signal to the calling application that a window close did not happen.
5554
5555 You can only veto a shutdown or close if `CanVeto` returns true.
5556 """
d55e5bfc
RD
5557 return _core_.CloseEvent_Veto(*args, **kwargs)
5558
5ba5649b
RD
5559 def GetVeto(*args, **kwargs):
5560 """GetVeto(self) -> bool"""
5561 return _core_.CloseEvent_GetVeto(*args, **kwargs)
5562
d55e5bfc 5563 def SetCanVeto(*args, **kwargs):
5ba5649b
RD
5564 """
5565 SetCanVeto(self, bool canVeto)
5566
5567 Sets the 'can veto' flag.
5568 """
d55e5bfc
RD
5569 return _core_.CloseEvent_SetCanVeto(*args, **kwargs)
5570
5571 def CanVeto(*args, **kwargs):
5ba5649b
RD
5572 """
5573 CanVeto(self) -> bool
d55e5bfc 5574
5ba5649b
RD
5575 Returns true if you can veto a system shutdown or a window close
5576 event. Vetoing a window close event is not possible if the calling
5577 code wishes to force the application to exit, and so this function
5578 must be called to check this.
5579 """
5580 return _core_.CloseEvent_CanVeto(*args, **kwargs)
d55e5bfc
RD
5581
5582
5583class CloseEventPtr(CloseEvent):
5584 def __init__(self, this):
5585 self.this = this
5586 if not hasattr(self,"thisown"): self.thisown = 0
5587 self.__class__ = CloseEvent
5588_core_.CloseEvent_swigregister(CloseEventPtr)
5589
5590#---------------------------------------------------------------------------
5591
5592class ShowEvent(Event):
5ba5649b 5593 """An EVT_SHOW event is sent when a window is shown or hidden."""
d55e5bfc
RD
5594 def __repr__(self):
5595 return "<%s.%s; proxy of C++ wxShowEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5596 def __init__(self, *args, **kwargs):
5ba5649b
RD
5597 """
5598 __init__(self, int winid=0, bool show=False) -> ShowEvent
5599
5600 An EVT_SHOW event is sent when a window is shown or hidden.
5601 """
d55e5bfc
RD
5602 newobj = _core_.new_ShowEvent(*args, **kwargs)
5603 self.this = newobj.this
5604 self.thisown = 1
5605 del newobj.thisown
5606 def SetShow(*args, **kwargs):
5607 """SetShow(self, bool show)"""
5608 return _core_.ShowEvent_SetShow(*args, **kwargs)
5609
5610 def GetShow(*args, **kwargs):
5611 """GetShow(self) -> bool"""
5612 return _core_.ShowEvent_GetShow(*args, **kwargs)
5613
5614
5615class ShowEventPtr(ShowEvent):
5616 def __init__(self, this):
5617 self.this = this
5618 if not hasattr(self,"thisown"): self.thisown = 0
5619 self.__class__ = ShowEvent
5620_core_.ShowEvent_swigregister(ShowEventPtr)
5621
5622#---------------------------------------------------------------------------
5623
5624class IconizeEvent(Event):
5ba5649b
RD
5625 """
5626 An EVT_ICONIZE event is sent when a frame is iconized (minimized) or
5627 restored.
5628 """
d55e5bfc
RD
5629 def __repr__(self):
5630 return "<%s.%s; proxy of C++ wxIconizeEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5631 def __init__(self, *args, **kwargs):
5ba5649b
RD
5632 """
5633 __init__(self, int id=0, bool iconized=True) -> IconizeEvent
5634
5635 An EVT_ICONIZE event is sent when a frame is iconized (minimized) or
5636 restored.
5637 """
d55e5bfc
RD
5638 newobj = _core_.new_IconizeEvent(*args, **kwargs)
5639 self.this = newobj.this
5640 self.thisown = 1
5641 del newobj.thisown
5642 def Iconized(*args, **kwargs):
5ba5649b
RD
5643 """
5644 Iconized(self) -> bool
5645
5646 Returns ``True`` if the frame has been iconized, ``False`` if it has
5647 been restored.
5648 """
d55e5bfc
RD
5649 return _core_.IconizeEvent_Iconized(*args, **kwargs)
5650
5651
5652class IconizeEventPtr(IconizeEvent):
5653 def __init__(self, this):
5654 self.this = this
5655 if not hasattr(self,"thisown"): self.thisown = 0
5656 self.__class__ = IconizeEvent
5657_core_.IconizeEvent_swigregister(IconizeEventPtr)
5658
5659#---------------------------------------------------------------------------
5660
5661class MaximizeEvent(Event):
5ba5649b 5662 """An EVT_MAXIMIZE event is sent when a frame is maximized or restored."""
d55e5bfc
RD
5663 def __repr__(self):
5664 return "<%s.%s; proxy of C++ wxMaximizeEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5665 def __init__(self, *args, **kwargs):
5ba5649b
RD
5666 """
5667 __init__(self, int id=0) -> MaximizeEvent
5668
5669 An EVT_MAXIMIZE event is sent when a frame is maximized or restored.
5670 """
d55e5bfc
RD
5671 newobj = _core_.new_MaximizeEvent(*args, **kwargs)
5672 self.this = newobj.this
5673 self.thisown = 1
5674 del newobj.thisown
5675
5676class MaximizeEventPtr(MaximizeEvent):
5677 def __init__(self, this):
5678 self.this = this
5679 if not hasattr(self,"thisown"): self.thisown = 0
5680 self.__class__ = MaximizeEvent
5681_core_.MaximizeEvent_swigregister(MaximizeEventPtr)
5682
5683#---------------------------------------------------------------------------
5684
5685class DropFilesEvent(Event):
5ba5649b
RD
5686 """
5687 This class is used for drop files events, that is, when files have
5688 been dropped onto the window. This functionality is only available
5689 under Windows. The window must have previously been enabled for
5690 dropping by calling `wx.Window.DragAcceptFiles`.
5691
5692 Important note: this is a separate implementation to the more general
5693 drag and drop implementation using `wx.FileDropTarget`, and etc. This
5694 implementation uses the older, Windows message-based approach of
5695 dropping files.
5696
5697 Use wx.EVT_DROP_FILES to bind an event handler to receive file drop
5698 events.
5699
5700 """
d55e5bfc
RD
5701 def __init__(self): raise RuntimeError, "No constructor defined"
5702 def __repr__(self):
5703 return "<%s.%s; proxy of C++ wxDropFilesEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5704 def GetPosition(*args, **kwargs):
5ba5649b
RD
5705 """
5706 GetPosition(self) -> Point
5707
5708 Returns the position at which the files were dropped.
5709 """
d55e5bfc
RD
5710 return _core_.DropFilesEvent_GetPosition(*args, **kwargs)
5711
5712 def GetNumberOfFiles(*args, **kwargs):
5ba5649b
RD
5713 """
5714 GetNumberOfFiles(self) -> int
5715
5716 Returns the number of files dropped.
5717 """
d55e5bfc
RD
5718 return _core_.DropFilesEvent_GetNumberOfFiles(*args, **kwargs)
5719
5720 def GetFiles(*args, **kwargs):
5ba5649b
RD
5721 """
5722 GetFiles(self) -> PyObject
5723
5724 Returns a list of the filenames that were dropped.
5725 """
d55e5bfc
RD
5726 return _core_.DropFilesEvent_GetFiles(*args, **kwargs)
5727
5728
5729class DropFilesEventPtr(DropFilesEvent):
5730 def __init__(self, this):
5731 self.this = this
5732 if not hasattr(self,"thisown"): self.thisown = 0
5733 self.__class__ = DropFilesEvent
5734_core_.DropFilesEvent_swigregister(DropFilesEventPtr)
5735
5736#---------------------------------------------------------------------------
5737
5738UPDATE_UI_PROCESS_ALL = _core_.UPDATE_UI_PROCESS_ALL
5739UPDATE_UI_PROCESS_SPECIFIED = _core_.UPDATE_UI_PROCESS_SPECIFIED
5740class UpdateUIEvent(CommandEvent):
5ba5649b
RD
5741 """
5742 This class is used for EVT_UPDATE_UI pseudo-events which are sent by
5743 wxWidgets to give an application the chance to update various user
5744 interface elements.
5745
5746 Without update UI events, an application has to work hard to
5747 check/uncheck, enable/disable, and set the text for elements such as
5748 menu items and toolbar buttons. The code for doing this has to be
5749 mixed up with the code that is invoked when an action is invoked for a
5750 menu item or button.
5751
5752 With update UI events, you define an event handler to look at the
5753 state of the application and change UI elements accordingly. wxWidgets
5754 will call your handler functions in idle time, so you don't have to
5755 worry where to call this code. In addition to being a clearer and more
5756 declarative method, it also means you don't have to worry whether
5757 you're updating a toolbar or menubar identifier. The same handler can
5758 update a menu item and toolbar button, if the ID values are the same.
5759
5760 Instead of directly manipulating the menu or button, you call
5761 functions in the event object, such as `Check`. wxWidgets will
5762 determine whether such a call has been made, and which UI element to
5763 update.
5764
5765 These events will work for popup menus as well as menubars. Just
5766 before a menu is popped up, `wx.Menu.UpdateUI` is called to process
5767 any UI events for the window that owns the menu.
5768
5769 If you find that the overhead of UI update processing is affecting
5770 your application, you can do one or both of the following:
5771
5772 1. Call `wx.UpdateUIEvent.SetMode` with a value of
5773 wx.UPDATE_UI_PROCESS_SPECIFIED, and set the extra style
5774 wx.WS_EX_PROCESS_UPDATE_EVENTS for every window that should
5775 receive update events. No other windows will receive update
5776 events.
5777
5778 2. Call `wx.UpdateUIEvent.SetUpdateInterval` with a millisecond
5779 value to set the delay between updates. You may need to call
5780 `wx.Window.UpdateWindowUI` at critical points, for example when
5781 a dialog is about to be shown, in case the user sees a slight
5782 delay before windows are updated.
5783
5784 Note that although events are sent in idle time, defining a EVT_IDLE
5785 handler for a window does not affect this because the events are sent
5786 from an internal idle handler.
5787
5788 wxWidgets tries to optimize update events on some platforms. On
5789 Windows and GTK+, events for menubar items are only sent when the menu
5790 is about to be shown, and not in idle time.
5791
5792 """
d55e5bfc
RD
5793 def __repr__(self):
5794 return "<%s.%s; proxy of C++ wxUpdateUIEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
5795 def __init__(self, *args, **kwargs):
5ba5649b
RD
5796 """
5797 __init__(self, int commandId=0) -> UpdateUIEvent
5798
5799 Constructor
5800 """
d55e5bfc
RD
5801 newobj = _core_.new_UpdateUIEvent(*args, **kwargs)
5802 self.this = newobj.this
5803 self.thisown = 1
5804 del newobj.thisown
5805 def GetChecked(*args, **kwargs):
5ba5649b
RD
5806 """
5807 GetChecked(self) -> bool
5808
5809 Returns ``True`` if the UI element should be checked.
5810 """
d55e5bfc
RD
5811 return _core_.UpdateUIEvent_GetChecked(*args, **kwargs)
5812
5813 def GetEnabled(*args, **kwargs):
5ba5649b
RD
5814 """
5815 GetEnabled(self) -> bool
5816
5817 Returns ``True`` if the UI element should be enabled.
5818 """
d55e5bfc
RD
5819 return _core_.UpdateUIEvent_GetEnabled(*args, **kwargs)
5820
5821 def GetText(*args, **kwargs):
5ba5649b
RD
5822 """
5823 GetText(self) -> String
5824
5825 Returns the text that should be set for the UI element.
5826 """
d55e5bfc
RD
5827 return _core_.UpdateUIEvent_GetText(*args, **kwargs)
5828
5829 def GetSetText(*args, **kwargs):
5ba5649b
RD
5830 """
5831 GetSetText(self) -> bool
5832
5833 Returns ``True`` if the application has called `SetText`. For
5834 wxWidgets internal use only.
5835 """
d55e5bfc
RD
5836 return _core_.UpdateUIEvent_GetSetText(*args, **kwargs)
5837
5838 def GetSetChecked(*args, **kwargs):
5ba5649b
RD
5839 """
5840 GetSetChecked(self) -> bool
5841
5842 Returns ``True`` if the application has called `Check`. For wxWidgets
5843 internal use only.
5844 """
d55e5bfc
RD
5845 return _core_.UpdateUIEvent_GetSetChecked(*args, **kwargs)
5846
5847 def GetSetEnabled(*args, **kwargs):
5ba5649b
RD
5848 """
5849 GetSetEnabled(self) -> bool
5850
5851 Returns ``True`` if the application has called `Enable`. For wxWidgets
5852 internal use only.
5853 """
d55e5bfc
RD
5854 return _core_.UpdateUIEvent_GetSetEnabled(*args, **kwargs)
5855
5856 def Check(*args, **kwargs):
5ba5649b
RD
5857 """
5858 Check(self, bool check)
5859
5860 Check or uncheck the UI element.
5861 """
d55e5bfc
RD
5862 return _core_.UpdateUIEvent_Check(*args, **kwargs)
5863
5864 def Enable(*args, **kwargs):
5ba5649b
RD
5865 """
5866 Enable(self, bool enable)
5867
5868 Enable or disable the UI element.
5869 """
d55e5bfc
RD
5870 return _core_.UpdateUIEvent_Enable(*args, **kwargs)
5871
5872 def SetText(*args, **kwargs):
5ba5649b
RD
5873 """
5874 SetText(self, String text)
5875
5876 Sets the text for this UI element.
5877 """
d55e5bfc
RD
5878 return _core_.UpdateUIEvent_SetText(*args, **kwargs)
5879
5880 def SetUpdateInterval(*args, **kwargs):
5ba5649b
RD
5881 """
5882 SetUpdateInterval(long updateInterval)
5883
5884 Sets the interval between updates in milliseconds. Set to -1 to
5885 disable updates, or to 0 to update as frequently as possible. The
5886 default is 0.
5887
5888 Use this to reduce the overhead of UI update events if your
5889 application has a lot of windows. If you set the value to -1 or
5890 greater than 0, you may also need to call `wx.Window.UpdateWindowUI`
5891 at appropriate points in your application, such as when a dialog is
5892 about to be shown.
5893 """
d55e5bfc
RD
5894 return _core_.UpdateUIEvent_SetUpdateInterval(*args, **kwargs)
5895
5896 SetUpdateInterval = staticmethod(SetUpdateInterval)
5897 def GetUpdateInterval(*args, **kwargs):
5ba5649b
RD
5898 """
5899 GetUpdateInterval() -> long
5900
5901 Returns the current interval between updates in milliseconds. -1
5902 disables updates, 0 updates as frequently as possible.
5903 """
d55e5bfc
RD
5904 return _core_.UpdateUIEvent_GetUpdateInterval(*args, **kwargs)
5905
5906 GetUpdateInterval = staticmethod(GetUpdateInterval)
5907 def CanUpdate(*args, **kwargs):
5ba5649b
RD
5908 """
5909 CanUpdate(Window win) -> bool
5910
5911 Returns ``True`` if it is appropriate to update (send UI update events
5912 to) this window.
5913
5914 This function looks at the mode used (see `wx.UpdateUIEvent.SetMode`),
5915 the wx.WS_EX_PROCESS_UPDATE_EVENTS flag in window, the time update
5916 events were last sent in idle time, and the update interval, to
5917 determine whether events should be sent to this window now. By default
5918 this will always return true because the update mode is initially
5919 wx.UPDATE_UI_PROCESS_ALL and the interval is set to 0; so update
5920 events will be sent as often as possible. You can reduce the frequency
5921 that events are sent by changing the mode and/or setting an update
5922 interval.
5923
5924 """
d55e5bfc
RD
5925 return _core_.UpdateUIEvent_CanUpdate(*args, **kwargs)
5926
5927 CanUpdate = staticmethod(CanUpdate)
5928 def ResetUpdateTime(*args, **kwargs):
5ba5649b
RD
5929 """
5930 ResetUpdateTime()
5931
5932 Used internally to reset the last-updated time to the current time. It
5933 is assumed that update events are normally sent in idle time, so this
5934 is called at the end of idle processing.
5935 """
d55e5bfc
RD
5936 return _core_.UpdateUIEvent_ResetUpdateTime(*args, **kwargs)
5937
5938 ResetUpdateTime = staticmethod(ResetUpdateTime)
5939 def SetMode(*args, **kwargs):
5ba5649b
RD
5940 """
5941 SetMode(int mode)
5942
5943 Specify how wxWidgets will send update events: to all windows, or only
5944 to those which specify that they will process the events.
5945
5946 The mode may be one of the following values:
5947
5948 ============================= ==========================================
5949 wxUPDATE_UI_PROCESS_ALL Send UI update events to all windows. This
5950 is the default setting.
5951 wxUPDATE_UI_PROCESS_SPECIFIED Send UI update events only to windows that
5952 have the wx.WS_EX_PROCESS_UI_UPDATES extra
5953 style set.
5954 ============================= ==========================================
5955
5956 """
d55e5bfc
RD
5957 return _core_.UpdateUIEvent_SetMode(*args, **kwargs)
5958
5959 SetMode = staticmethod(SetMode)
5960 def GetMode(*args, **kwargs):
5ba5649b
RD
5961 """
5962 GetMode() -> int
5963
5964 Returns a value specifying how wxWidgets will send update events: to
5965 all windows, or only to those which specify that they will process the
5966 events.
5967 """
d55e5bfc
RD
5968 return _core_.UpdateUIEvent_GetMode(*args, **kwargs)
5969
5970 GetMode = staticmethod(GetMode)
5971
5972class UpdateUIEventPtr(UpdateUIEvent):
5973 def __init__(self, this):
5974 self.this = this
5975 if not hasattr(self,"thisown"): self.thisown = 0
5976 self.__class__ = UpdateUIEvent
5977_core_.UpdateUIEvent_swigregister(UpdateUIEventPtr)
5978
5979def UpdateUIEvent_SetUpdateInterval(*args, **kwargs):
5ba5649b
RD
5980 """
5981 UpdateUIEvent_SetUpdateInterval(long updateInterval)
5982
5983 Sets the interval between updates in milliseconds. Set to -1 to
5984 disable updates, or to 0 to update as frequently as possible. The
5985 default is 0.
5986
5987 Use this to reduce the overhead of UI update events if your
5988 application has a lot of windows. If you set the value to -1 or
5989 greater than 0, you may also need to call `wx.Window.UpdateWindowUI`
5990 at appropriate points in your application, such as when a dialog is
5991 about to be shown.
5992 """
d55e5bfc
RD
5993 return _core_.UpdateUIEvent_SetUpdateInterval(*args, **kwargs)
5994
5995def UpdateUIEvent_GetUpdateInterval(*args, **kwargs):
5ba5649b
RD
5996 """
5997 UpdateUIEvent_GetUpdateInterval() -> long
5998
5999 Returns the current interval between updates in milliseconds. -1
6000 disables updates, 0 updates as frequently as possible.
6001 """
d55e5bfc
RD
6002 return _core_.UpdateUIEvent_GetUpdateInterval(*args, **kwargs)
6003
6004def UpdateUIEvent_CanUpdate(*args, **kwargs):
5ba5649b
RD
6005 """
6006 UpdateUIEvent_CanUpdate(Window win) -> bool
6007
6008 Returns ``True`` if it is appropriate to update (send UI update events
6009 to) this window.
6010
6011 This function looks at the mode used (see `wx.UpdateUIEvent.SetMode`),
6012 the wx.WS_EX_PROCESS_UPDATE_EVENTS flag in window, the time update
6013 events were last sent in idle time, and the update interval, to
6014 determine whether events should be sent to this window now. By default
6015 this will always return true because the update mode is initially
6016 wx.UPDATE_UI_PROCESS_ALL and the interval is set to 0; so update
6017 events will be sent as often as possible. You can reduce the frequency
6018 that events are sent by changing the mode and/or setting an update
6019 interval.
6020
6021 """
d55e5bfc
RD
6022 return _core_.UpdateUIEvent_CanUpdate(*args, **kwargs)
6023
6024def UpdateUIEvent_ResetUpdateTime(*args, **kwargs):
5ba5649b
RD
6025 """
6026 UpdateUIEvent_ResetUpdateTime()
6027
6028 Used internally to reset the last-updated time to the current time. It
6029 is assumed that update events are normally sent in idle time, so this
6030 is called at the end of idle processing.
6031 """
d55e5bfc
RD
6032 return _core_.UpdateUIEvent_ResetUpdateTime(*args, **kwargs)
6033
6034def UpdateUIEvent_SetMode(*args, **kwargs):
5ba5649b
RD
6035 """
6036 UpdateUIEvent_SetMode(int mode)
6037
6038 Specify how wxWidgets will send update events: to all windows, or only
6039 to those which specify that they will process the events.
6040
6041 The mode may be one of the following values:
6042
6043 ============================= ==========================================
6044 wxUPDATE_UI_PROCESS_ALL Send UI update events to all windows. This
6045 is the default setting.
6046 wxUPDATE_UI_PROCESS_SPECIFIED Send UI update events only to windows that
6047 have the wx.WS_EX_PROCESS_UI_UPDATES extra
6048 style set.
6049 ============================= ==========================================
6050
6051 """
d55e5bfc
RD
6052 return _core_.UpdateUIEvent_SetMode(*args, **kwargs)
6053
6054def UpdateUIEvent_GetMode(*args, **kwargs):
5ba5649b
RD
6055 """
6056 UpdateUIEvent_GetMode() -> int
6057
6058 Returns a value specifying how wxWidgets will send update events: to
6059 all windows, or only to those which specify that they will process the
6060 events.
6061 """
d55e5bfc
RD
6062 return _core_.UpdateUIEvent_GetMode(*args, **kwargs)
6063
6064#---------------------------------------------------------------------------
6065
6066class SysColourChangedEvent(Event):
5ba5649b
RD
6067 """
6068 This class is used for EVT_SYS_COLOUR_CHANGED, which are generated
6069 when the user changes the colour settings using the control
6070 panel. This is only applicable under Windows.
6071
6072 The default event handler for this event propagates the event to child
6073 windows, since Windows only sends the events to top-level windows. If
6074 intercepting this event for a top-level window, remember to call
6075 `Skip` so the the base class handler will still be executed, or to
6076 pass the event on to the window's children explicitly.
6077
6078 """
d55e5bfc
RD
6079 def __repr__(self):
6080 return "<%s.%s; proxy of C++ wxSysColourChangedEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6081 def __init__(self, *args, **kwargs):
5ba5649b
RD
6082 """
6083 __init__(self) -> SysColourChangedEvent
6084
6085 Constructor
6086 """
d55e5bfc
RD
6087 newobj = _core_.new_SysColourChangedEvent(*args, **kwargs)
6088 self.this = newobj.this
6089 self.thisown = 1
6090 del newobj.thisown
6091
6092class SysColourChangedEventPtr(SysColourChangedEvent):
6093 def __init__(self, this):
6094 self.this = this
6095 if not hasattr(self,"thisown"): self.thisown = 0
6096 self.__class__ = SysColourChangedEvent
6097_core_.SysColourChangedEvent_swigregister(SysColourChangedEventPtr)
6098
6099#---------------------------------------------------------------------------
6100
6101class MouseCaptureChangedEvent(Event):
5ba5649b
RD
6102 """
6103 An mouse capture changed event (EVT_MOUSE_CAPTURE_CHANGED) is sent to
6104 a window that loses its mouse capture. This is called even if
6105 `wx.Window.ReleaseMouse` was called by the application code. Handling
6106 this event allows an application to cater for unexpected capture
6107 releases which might otherwise confuse mouse handling code.
6108
6109 This event is implemented under Windows only.
6110 """
d55e5bfc
RD
6111 def __repr__(self):
6112 return "<%s.%s; proxy of C++ wxMouseCaptureChangedEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6113 def __init__(self, *args, **kwargs):
5ba5649b
RD
6114 """
6115 __init__(self, int winid=0, Window gainedCapture=None) -> MouseCaptureChangedEvent
6116
6117 Constructor
6118 """
d55e5bfc
RD
6119 newobj = _core_.new_MouseCaptureChangedEvent(*args, **kwargs)
6120 self.this = newobj.this
6121 self.thisown = 1
6122 del newobj.thisown
6123 def GetCapturedWindow(*args, **kwargs):
5ba5649b
RD
6124 """
6125 GetCapturedWindow(self) -> Window
6126
6127 Returns the window that gained the capture, or ``None`` if it was a
6128 non-wxWidgets window.
6129 """
d55e5bfc
RD
6130 return _core_.MouseCaptureChangedEvent_GetCapturedWindow(*args, **kwargs)
6131
6132
6133class MouseCaptureChangedEventPtr(MouseCaptureChangedEvent):
6134 def __init__(self, this):
6135 self.this = this
6136 if not hasattr(self,"thisown"): self.thisown = 0
6137 self.__class__ = MouseCaptureChangedEvent
6138_core_.MouseCaptureChangedEvent_swigregister(MouseCaptureChangedEventPtr)
6139
6140#---------------------------------------------------------------------------
6141
6142class DisplayChangedEvent(Event):
5ba5649b
RD
6143 """
6144 An EVT_DISPLAY_CHANGED event is sent to all windows when the display
6145 resolution has changed.
6146
6147 This event is implemented under Windows only.
6148 """
d55e5bfc
RD
6149 def __repr__(self):
6150 return "<%s.%s; proxy of C++ wxDisplayChangedEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6151 def __init__(self, *args, **kwargs):
6152 """__init__(self) -> DisplayChangedEvent"""
6153 newobj = _core_.new_DisplayChangedEvent(*args, **kwargs)
6154 self.this = newobj.this
6155 self.thisown = 1
6156 del newobj.thisown
6157
6158class DisplayChangedEventPtr(DisplayChangedEvent):
6159 def __init__(self, this):
6160 self.this = this
6161 if not hasattr(self,"thisown"): self.thisown = 0
6162 self.__class__ = DisplayChangedEvent
6163_core_.DisplayChangedEvent_swigregister(DisplayChangedEventPtr)
6164
6165#---------------------------------------------------------------------------
6166
6167class PaletteChangedEvent(Event):
5ba5649b
RD
6168 """
6169 An EVT_PALETTE_CHANGED event is sent when the system palette has
6170 changed, thereby giving each window a chance to redo their own to
6171 match.
6172
6173 This event is implemented under Windows only.
6174 """
d55e5bfc
RD
6175 def __repr__(self):
6176 return "<%s.%s; proxy of C++ wxPaletteChangedEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6177 def __init__(self, *args, **kwargs):
5ba5649b
RD
6178 """
6179 __init__(self, int id=0) -> PaletteChangedEvent
6180
6181 An EVT_PALETTE_CHANGED event is sent when the system palette has
6182 changed, thereby giving each window a chance to redo their own to
6183 match.
6184
6185 This event is implemented under Windows only.
6186 """
d55e5bfc
RD
6187 newobj = _core_.new_PaletteChangedEvent(*args, **kwargs)
6188 self.this = newobj.this
6189 self.thisown = 1
6190 del newobj.thisown
6191 def SetChangedWindow(*args, **kwargs):
6192 """SetChangedWindow(self, Window win)"""
6193 return _core_.PaletteChangedEvent_SetChangedWindow(*args, **kwargs)
6194
6195 def GetChangedWindow(*args, **kwargs):
6196 """GetChangedWindow(self) -> Window"""
6197 return _core_.PaletteChangedEvent_GetChangedWindow(*args, **kwargs)
6198
6199
6200class PaletteChangedEventPtr(PaletteChangedEvent):
6201 def __init__(self, this):
6202 self.this = this
6203 if not hasattr(self,"thisown"): self.thisown = 0
6204 self.__class__ = PaletteChangedEvent
6205_core_.PaletteChangedEvent_swigregister(PaletteChangedEventPtr)
6206
6207#---------------------------------------------------------------------------
6208
6209class QueryNewPaletteEvent(Event):
5ba5649b
RD
6210 """
6211 An EVT_QUERY_NEW_PALETE event indicates the window is getting keyboard
6212 focus and should re-do its palette.
6213
6214 This event is implemented under Windows only.
6215 """
d55e5bfc
RD
6216 def __repr__(self):
6217 return "<%s.%s; proxy of C++ wxQueryNewPaletteEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6218 def __init__(self, *args, **kwargs):
5ba5649b
RD
6219 """
6220 __init__(self, int winid=0) -> QueryNewPaletteEvent
6221
6222 Constructor.
6223 """
d55e5bfc
RD
6224 newobj = _core_.new_QueryNewPaletteEvent(*args, **kwargs)
6225 self.this = newobj.this
6226 self.thisown = 1
6227 del newobj.thisown
6228 def SetPaletteRealized(*args, **kwargs):
5ba5649b
RD
6229 """
6230 SetPaletteRealized(self, bool realized)
6231
6232 App should set this if it changes the palette.
6233 """
d55e5bfc
RD
6234 return _core_.QueryNewPaletteEvent_SetPaletteRealized(*args, **kwargs)
6235
6236 def GetPaletteRealized(*args, **kwargs):
6237 """GetPaletteRealized(self) -> bool"""
6238 return _core_.QueryNewPaletteEvent_GetPaletteRealized(*args, **kwargs)
6239
6240
6241class QueryNewPaletteEventPtr(QueryNewPaletteEvent):
6242 def __init__(self, this):
6243 self.this = this
6244 if not hasattr(self,"thisown"): self.thisown = 0
6245 self.__class__ = QueryNewPaletteEvent
6246_core_.QueryNewPaletteEvent_swigregister(QueryNewPaletteEventPtr)
6247
6248#---------------------------------------------------------------------------
6249
6250class NavigationKeyEvent(Event):
5ba5649b
RD
6251 """
6252 EVT_NAVIGATION_KEY events are used to control moving the focus between
6253 widgets, otherwise known as tab-traversal. You woudl normally not
6254 catch navigation events in applications as there are already
6255 appropriate handlers in `wx.Dialog` and `wx.Panel`, but you may find
6256 it useful to send navigation events in certain situations to change
6257 the focus in certain ways, although it's probably easier to just call
6258 `wx.Window.Navigate`.
6259 """
d55e5bfc
RD
6260 def __repr__(self):
6261 return "<%s.%s; proxy of C++ wxNavigationKeyEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6262 def __init__(self, *args, **kwargs):
6263 """__init__(self) -> NavigationKeyEvent"""
6264 newobj = _core_.new_NavigationKeyEvent(*args, **kwargs)
6265 self.this = newobj.this
6266 self.thisown = 1
6267 del newobj.thisown
6268 def GetDirection(*args, **kwargs):
5ba5649b
RD
6269 """
6270 GetDirection(self) -> bool
6271
6272 Returns ``True`` if the direction is forward, ``False`` otherwise.
6273 """
d55e5bfc
RD
6274 return _core_.NavigationKeyEvent_GetDirection(*args, **kwargs)
6275
6276 def SetDirection(*args, **kwargs):
5ba5649b
RD
6277 """
6278 SetDirection(self, bool forward)
6279
6280 Specify the direction that the navigation should take. Usually the
6281 difference between using Tab and Shift-Tab.
6282 """
d55e5bfc
RD
6283 return _core_.NavigationKeyEvent_SetDirection(*args, **kwargs)
6284
6285 def IsWindowChange(*args, **kwargs):
5ba5649b
RD
6286 """
6287 IsWindowChange(self) -> bool
6288
6289 Returns ``True`` if window change is allowed.
6290 """
d55e5bfc
RD
6291 return _core_.NavigationKeyEvent_IsWindowChange(*args, **kwargs)
6292
6293 def SetWindowChange(*args, **kwargs):
5ba5649b
RD
6294 """
6295 SetWindowChange(self, bool ischange)
6296
6297 Specify if the navigation should be able to change parent windows.
6298 For example, changing notebook pages, etc. This is usually implemented
6299 by using Control-Tab.
6300 """
d55e5bfc
RD
6301 return _core_.NavigationKeyEvent_SetWindowChange(*args, **kwargs)
6302
68350608 6303 def IsFromTab(*args, **kwargs):
5ba5649b
RD
6304 """
6305 IsFromTab(self) -> bool
6306
6307 Returns ``True`` if the navigation event is originated from the Tab
6308 key.
6309 """
68350608
RD
6310 return _core_.NavigationKeyEvent_IsFromTab(*args, **kwargs)
6311
6312 def SetFromTab(*args, **kwargs):
5ba5649b
RD
6313 """
6314 SetFromTab(self, bool bIs)
6315
6316 Set to true under MSW if the event was generated using the tab key.
6317 This is required for proper navogation over radio buttons.
6318 """
68350608
RD
6319 return _core_.NavigationKeyEvent_SetFromTab(*args, **kwargs)
6320
908b74cd 6321 def SetFlags(*args, **kwargs):
5ba5649b
RD
6322 """
6323 SetFlags(self, long flags)
6324
6325 Set the navigation flags to a combination of the following:
6326
6327 * wx.NavigationKeyEvent.IsBackward
6328 * wx.NavigationKeyEvent.IsForward
6329 * wx.NavigationKeyEvent.WinChange
6330 * wx.NavigationKeyEvent.FromTab
6331
6332 """
908b74cd
RD
6333 return _core_.NavigationKeyEvent_SetFlags(*args, **kwargs)
6334
d55e5bfc 6335 def GetCurrentFocus(*args, **kwargs):
5ba5649b
RD
6336 """
6337 GetCurrentFocus(self) -> Window
6338
6339 Returns the child window which currenty has the focus. May be
6340 ``None``.
6341 """
d55e5bfc
RD
6342 return _core_.NavigationKeyEvent_GetCurrentFocus(*args, **kwargs)
6343
6344 def SetCurrentFocus(*args, **kwargs):
5ba5649b
RD
6345 """
6346 SetCurrentFocus(self, Window win)
6347
6348 Set the window that has the focus.
6349 """
d55e5bfc
RD
6350 return _core_.NavigationKeyEvent_SetCurrentFocus(*args, **kwargs)
6351
b0f7404b 6352 IsBackward = _core_.NavigationKeyEvent_IsBackward
908b74cd
RD
6353 IsForward = _core_.NavigationKeyEvent_IsForward
6354 WinChange = _core_.NavigationKeyEvent_WinChange
68350608 6355 FromTab = _core_.NavigationKeyEvent_FromTab
d55e5bfc
RD
6356
6357class NavigationKeyEventPtr(NavigationKeyEvent):
6358 def __init__(self, this):
6359 self.this = this
6360 if not hasattr(self,"thisown"): self.thisown = 0
6361 self.__class__ = NavigationKeyEvent
6362_core_.NavigationKeyEvent_swigregister(NavigationKeyEventPtr)
6363
6364#---------------------------------------------------------------------------
6365
6366class WindowCreateEvent(CommandEvent):
5ba5649b
RD
6367 """
6368 The EVT_WINDOW_CREATE event is sent as soon as the window object (the
6369 underlying GUI object) exists.
6370 """
d55e5bfc
RD
6371 def __repr__(self):
6372 return "<%s.%s; proxy of C++ wxWindowCreateEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6373 def __init__(self, *args, **kwargs):
5ba5649b
RD
6374 """
6375 __init__(self, Window win=None) -> WindowCreateEvent
6376
6377 The EVT_WINDOW_CREATE event is sent as soon as the window object (the
6378 underlying GUI object) exists.
6379 """
d55e5bfc
RD
6380 newobj = _core_.new_WindowCreateEvent(*args, **kwargs)
6381 self.this = newobj.this
6382 self.thisown = 1
6383 del newobj.thisown
6384 def GetWindow(*args, **kwargs):
5ba5649b
RD
6385 """
6386 GetWindow(self) -> Window
6387
6388 Returns the window that this event refers to.
6389 """
d55e5bfc
RD
6390 return _core_.WindowCreateEvent_GetWindow(*args, **kwargs)
6391
6392
6393class WindowCreateEventPtr(WindowCreateEvent):
6394 def __init__(self, this):
6395 self.this = this
6396 if not hasattr(self,"thisown"): self.thisown = 0
6397 self.__class__ = WindowCreateEvent
6398_core_.WindowCreateEvent_swigregister(WindowCreateEventPtr)
6399
6400class WindowDestroyEvent(CommandEvent):
5ba5649b
RD
6401 """
6402 The EVT_WINDOW_DESTROY event is sent right before the window is
6403 destroyed.
6404 """
d55e5bfc
RD
6405 def __repr__(self):
6406 return "<%s.%s; proxy of C++ wxWindowDestroyEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6407 def __init__(self, *args, **kwargs):
5ba5649b
RD
6408 """
6409 __init__(self, Window win=None) -> WindowDestroyEvent
6410
6411 The EVT_WINDOW_DESTROY event is sent right before the window is
6412 destroyed.
6413 """
d55e5bfc
RD
6414 newobj = _core_.new_WindowDestroyEvent(*args, **kwargs)
6415 self.this = newobj.this
6416 self.thisown = 1
6417 del newobj.thisown
6418 def GetWindow(*args, **kwargs):
5ba5649b
RD
6419 """
6420 GetWindow(self) -> Window
6421
6422 Returns the window that this event refers to.
6423 """
d55e5bfc
RD
6424 return _core_.WindowDestroyEvent_GetWindow(*args, **kwargs)
6425
6426
6427class WindowDestroyEventPtr(WindowDestroyEvent):
6428 def __init__(self, this):
6429 self.this = this
6430 if not hasattr(self,"thisown"): self.thisown = 0
6431 self.__class__ = WindowDestroyEvent
6432_core_.WindowDestroyEvent_swigregister(WindowDestroyEventPtr)
6433
6434#---------------------------------------------------------------------------
6435
6436class ContextMenuEvent(CommandEvent):
5ba5649b
RD
6437 """
6438 This class is used for context menu events (EVT_CONTECT_MENU,) sent to
6439 give the application a chance to show a context (popup) menu.
6440 """
d55e5bfc
RD
6441 def __repr__(self):
6442 return "<%s.%s; proxy of C++ wxContextMenuEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6443 def __init__(self, *args, **kwargs):
5ba5649b
RD
6444 """
6445 __init__(self, wxEventType type=wxEVT_NULL, int winid=0, Point pt=DefaultPosition) -> ContextMenuEvent
6446
6447 Constructor.
6448 """
d55e5bfc
RD
6449 newobj = _core_.new_ContextMenuEvent(*args, **kwargs)
6450 self.this = newobj.this
6451 self.thisown = 1
6452 del newobj.thisown
6453 def GetPosition(*args, **kwargs):
5ba5649b
RD
6454 """
6455 GetPosition(self) -> Point
6456
6457 Returns the position (in screen coordinants) at which the menu should
6458 be shown.
6459 """
d55e5bfc
RD
6460 return _core_.ContextMenuEvent_GetPosition(*args, **kwargs)
6461
6462 def SetPosition(*args, **kwargs):
5ba5649b
RD
6463 """
6464 SetPosition(self, Point pos)
6465
6466 Sets the position at which the menu should be shown.
6467 """
d55e5bfc
RD
6468 return _core_.ContextMenuEvent_SetPosition(*args, **kwargs)
6469
6470
6471class ContextMenuEventPtr(ContextMenuEvent):
6472 def __init__(self, this):
6473 self.this = this
6474 if not hasattr(self,"thisown"): self.thisown = 0
6475 self.__class__ = ContextMenuEvent
6476_core_.ContextMenuEvent_swigregister(ContextMenuEventPtr)
6477
6478#---------------------------------------------------------------------------
6479
6480IDLE_PROCESS_ALL = _core_.IDLE_PROCESS_ALL
6481IDLE_PROCESS_SPECIFIED = _core_.IDLE_PROCESS_SPECIFIED
6482class IdleEvent(Event):
5ba5649b
RD
6483 """
6484 This class is used for EVT_IDLE events, which are generated and sent
6485 when the application *becomes* idle. In other words, the when the
6486 event queue becomes empty then idle events are sent to all windows (by
6487 default) and as long as none of them call `RequestMore` then there are
6488 no more idle events until after the system event queue has some normal
6489 events and then becomes empty again.
6490
6491 By default, idle events are sent to all windows. If this is causing a
6492 significant overhead in your application, you can call
6493 `wx.IdleEvent.SetMode` with the value wx.IDLE_PROCESS_SPECIFIED, and
6494 set the wx.WS_EX_PROCESS_IDLE extra window style for every window
6495 which should receive idle events. Then idle events will only be sent
6496 to those windows and not to any others.
6497 """
d55e5bfc
RD
6498 def __repr__(self):
6499 return "<%s.%s; proxy of C++ wxIdleEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6500 def __init__(self, *args, **kwargs):
5ba5649b
RD
6501 """
6502 __init__(self) -> IdleEvent
6503
6504 Constructor
6505 """
d55e5bfc
RD
6506 newobj = _core_.new_IdleEvent(*args, **kwargs)
6507 self.this = newobj.this
6508 self.thisown = 1
6509 del newobj.thisown
6510 def RequestMore(*args, **kwargs):
5ba5649b
RD
6511 """
6512 RequestMore(self, bool needMore=True)
6513
6514 Tells wxWidgets that more processing is required. This function can be
6515 called by an EVT_IDLE handler for a window to indicate that the
6516 application should forward the EVT_IDLE event once more to the
6517 application windows. If no window calls this function during its
6518 EVT_IDLE handler, then the application will remain in a passive event
6519 loop until a new event is posted to the application by the windowing
6520 system.
6521 """
d55e5bfc
RD
6522 return _core_.IdleEvent_RequestMore(*args, **kwargs)
6523
6524 def MoreRequested(*args, **kwargs):
5ba5649b
RD
6525 """
6526 MoreRequested(self) -> bool
6527
6528 Returns ``True`` if the OnIdle function processing this event
6529 requested more processing time.
6530 """
d55e5bfc
RD
6531 return _core_.IdleEvent_MoreRequested(*args, **kwargs)
6532
6533 def SetMode(*args, **kwargs):
5ba5649b
RD
6534 """
6535 SetMode(int mode)
6536
6537 Static method for specifying how wxWidgets will send idle events: to
6538 all windows, or only to those which specify that they will process the
6539 events.
6540
6541 The mode can be one of the following values:
6542
6543 ========================= ========================================
6544 wx.IDLE_PROCESS_ALL Send idle events to all windows
6545 wx.IDLE_PROCESS_SPECIFIED Send idle events only to windows that have
6546 the wx.WS_EX_PROCESS_IDLE extra style
6547 flag set.
6548 ========================= ========================================
6549
6550 """
d55e5bfc
RD
6551 return _core_.IdleEvent_SetMode(*args, **kwargs)
6552
6553 SetMode = staticmethod(SetMode)
6554 def GetMode(*args, **kwargs):
5ba5649b
RD
6555 """
6556 GetMode() -> int
6557
6558 Static method returning a value specifying how wxWidgets will send
6559 idle events: to all windows, or only to those which specify that they
6560 will process the events.
6561 """
d55e5bfc
RD
6562 return _core_.IdleEvent_GetMode(*args, **kwargs)
6563
6564 GetMode = staticmethod(GetMode)
6565 def CanSend(*args, **kwargs):
5ba5649b
RD
6566 """
6567 CanSend(Window win) -> bool
6568
6569 Returns ``True`` if it is appropriate to send idle events to this
6570 window.
6571
6572 This function looks at the mode used (see `wx.IdleEvent.SetMode`), and
6573 the wx.WS_EX_PROCESS_IDLE style in window to determine whether idle
6574 events should be sent to this window now. By default this will always
6575 return ``True`` because the update mode is initially
6576 wx.IDLE_PROCESS_ALL. You can change the mode to only send idle events
6577 to windows with the wx.WS_EX_PROCESS_IDLE extra window style set.
6578 """
d55e5bfc
RD
6579 return _core_.IdleEvent_CanSend(*args, **kwargs)
6580
6581 CanSend = staticmethod(CanSend)
6582
6583class IdleEventPtr(IdleEvent):
6584 def __init__(self, this):
6585 self.this = this
6586 if not hasattr(self,"thisown"): self.thisown = 0
6587 self.__class__ = IdleEvent
6588_core_.IdleEvent_swigregister(IdleEventPtr)
6589
6590def IdleEvent_SetMode(*args, **kwargs):
5ba5649b
RD
6591 """
6592 IdleEvent_SetMode(int mode)
6593
6594 Static method for specifying how wxWidgets will send idle events: to
6595 all windows, or only to those which specify that they will process the
6596 events.
6597
6598 The mode can be one of the following values:
6599
6600 ========================= ========================================
6601 wx.IDLE_PROCESS_ALL Send idle events to all windows
6602 wx.IDLE_PROCESS_SPECIFIED Send idle events only to windows that have
6603 the wx.WS_EX_PROCESS_IDLE extra style
6604 flag set.
6605 ========================= ========================================
6606
6607 """
d55e5bfc
RD
6608 return _core_.IdleEvent_SetMode(*args, **kwargs)
6609
6610def IdleEvent_GetMode(*args, **kwargs):
5ba5649b
RD
6611 """
6612 IdleEvent_GetMode() -> int
6613
6614 Static method returning a value specifying how wxWidgets will send
6615 idle events: to all windows, or only to those which specify that they
6616 will process the events.
6617 """
d55e5bfc
RD
6618 return _core_.IdleEvent_GetMode(*args, **kwargs)
6619
6620def IdleEvent_CanSend(*args, **kwargs):
5ba5649b
RD
6621 """
6622 IdleEvent_CanSend(Window win) -> bool
6623
6624 Returns ``True`` if it is appropriate to send idle events to this
6625 window.
6626
6627 This function looks at the mode used (see `wx.IdleEvent.SetMode`), and
6628 the wx.WS_EX_PROCESS_IDLE style in window to determine whether idle
6629 events should be sent to this window now. By default this will always
6630 return ``True`` because the update mode is initially
6631 wx.IDLE_PROCESS_ALL. You can change the mode to only send idle events
6632 to windows with the wx.WS_EX_PROCESS_IDLE extra window style set.
6633 """
d55e5bfc
RD
6634 return _core_.IdleEvent_CanSend(*args, **kwargs)
6635
6636#---------------------------------------------------------------------------
6637
6638class PyEvent(Event):
5ba5649b
RD
6639 """
6640 wx.PyEvent can be used as a base class for implementing custom event
6641 types in Python. You should derived from this class instead of
6642 `wx.Event` because this class is Python-aware and is able to transport
6643 its Python bits safely through the wxWidgets event system and have
6644 them still be there when the event handler is invoked.
6645
6646 :see: `wx.PyCommandEvent`
6647
6648 """
d55e5bfc
RD
6649 def __repr__(self):
6650 return "<%s.%s; proxy of C++ wxPyEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6651 def __init__(self, *args, **kwargs):
5ba5649b 6652 """__init__(self, int winid=0, wxEventType eventType=wxEVT_NULL) -> PyEvent"""
d55e5bfc
RD
6653 newobj = _core_.new_PyEvent(*args, **kwargs)
6654 self.this = newobj.this
6655 self.thisown = 1
6656 del newobj.thisown
5ba5649b 6657 self._SetSelf(self)
d55e5bfc
RD
6658
6659 def __del__(self, destroy=_core_.delete_PyEvent):
6660 """__del__(self)"""
6661 try:
6662 if self.thisown: destroy(self)
6663 except: pass
6664
5ba5649b
RD
6665 def _SetSelf(*args, **kwargs):
6666 """_SetSelf(self, PyObject self)"""
6667 return _core_.PyEvent__SetSelf(*args, **kwargs)
d55e5bfc 6668
5ba5649b
RD
6669 def _GetSelf(*args, **kwargs):
6670 """_GetSelf(self) -> PyObject"""
6671 return _core_.PyEvent__GetSelf(*args, **kwargs)
d55e5bfc
RD
6672
6673
6674class PyEventPtr(PyEvent):
6675 def __init__(self, this):
6676 self.this = this
6677 if not hasattr(self,"thisown"): self.thisown = 0
6678 self.__class__ = PyEvent
6679_core_.PyEvent_swigregister(PyEventPtr)
6680
6681class PyCommandEvent(CommandEvent):
5ba5649b
RD
6682 """
6683 wx.PyCommandEvent can be used as a base class for implementing custom
6684 event types in Python, where the event shoudl travel up to parent
6685 windows looking for a handler. You should derived from this class
6686 instead of `wx.CommandEvent` because this class is Python-aware and is
6687 able to transport its Python bits safely through the wxWidgets event
6688 system and have them still be there when the event handler is invoked.
6689
6690 :see: `wx.PyEvent`
6691
6692 """
d55e5bfc
RD
6693 def __repr__(self):
6694 return "<%s.%s; proxy of C++ wxPyCommandEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6695 def __init__(self, *args, **kwargs):
5ba5649b 6696 """__init__(self, wxEventType eventType=wxEVT_NULL, int id=0) -> PyCommandEvent"""
d55e5bfc
RD
6697 newobj = _core_.new_PyCommandEvent(*args, **kwargs)
6698 self.this = newobj.this
6699 self.thisown = 1
6700 del newobj.thisown
5ba5649b 6701 self._SetSelf(self)
d55e5bfc
RD
6702
6703 def __del__(self, destroy=_core_.delete_PyCommandEvent):
6704 """__del__(self)"""
6705 try:
6706 if self.thisown: destroy(self)
6707 except: pass
6708
5ba5649b
RD
6709 def _SetSelf(*args, **kwargs):
6710 """_SetSelf(self, PyObject self)"""
6711 return _core_.PyCommandEvent__SetSelf(*args, **kwargs)
d55e5bfc 6712
5ba5649b
RD
6713 def _GetSelf(*args, **kwargs):
6714 """_GetSelf(self) -> PyObject"""
6715 return _core_.PyCommandEvent__GetSelf(*args, **kwargs)
d55e5bfc
RD
6716
6717
6718class PyCommandEventPtr(PyCommandEvent):
6719 def __init__(self, this):
6720 self.this = this
6721 if not hasattr(self,"thisown"): self.thisown = 0
6722 self.__class__ = PyCommandEvent
6723_core_.PyCommandEvent_swigregister(PyCommandEventPtr)
6724
53aa7709 6725class DateEvent(CommandEvent):
5ba5649b
RD
6726 """
6727 This event class holds information about a date change event and is
6728 used together with `wx.DatePickerCtrl`. It also serves as a base class
6729 for `wx.calendar.CalendarEvent`. Bind these event types with
6730 EVT_DATE_CHANGED.
6731 """
53aa7709
RD
6732 def __repr__(self):
6733 return "<%s.%s; proxy of C++ wxDateEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6734 def __init__(self, *args, **kwargs):
6735 """__init__(self, Window win, DateTime dt, wxEventType type) -> DateEvent"""
6736 newobj = _core_.new_DateEvent(*args, **kwargs)
6737 self.this = newobj.this
6738 self.thisown = 1
6739 del newobj.thisown
6740 def GetDate(*args, **kwargs):
5ba5649b
RD
6741 """
6742 GetDate(self) -> DateTime
6743
6744 Returns the date.
6745 """
53aa7709
RD
6746 return _core_.DateEvent_GetDate(*args, **kwargs)
6747
6748 def SetDate(*args, **kwargs):
5ba5649b
RD
6749 """
6750 SetDate(self, DateTime date)
6751
6752 Sets the date carried by the event, normally only used by the library
6753 internally.
6754 """
53aa7709
RD
6755 return _core_.DateEvent_SetDate(*args, **kwargs)
6756
6757
6758class DateEventPtr(DateEvent):
6759 def __init__(self, this):
6760 self.this = this
6761 if not hasattr(self,"thisown"): self.thisown = 0
6762 self.__class__ = DateEvent
6763_core_.DateEvent_swigregister(DateEventPtr)
6764
6765wxEVT_DATE_CHANGED = _core_.wxEVT_DATE_CHANGED
6766EVT_DATE_CHANGED = wx.PyEventBinder( wxEVT_DATE_CHANGED, 1 )
6767
d55e5bfc
RD
6768#---------------------------------------------------------------------------
6769
6770PYAPP_ASSERT_SUPPRESS = _core_.PYAPP_ASSERT_SUPPRESS
6771PYAPP_ASSERT_EXCEPTION = _core_.PYAPP_ASSERT_EXCEPTION
6772PYAPP_ASSERT_DIALOG = _core_.PYAPP_ASSERT_DIALOG
6773PYAPP_ASSERT_LOG = _core_.PYAPP_ASSERT_LOG
6774PRINT_WINDOWS = _core_.PRINT_WINDOWS
6775PRINT_POSTSCRIPT = _core_.PRINT_POSTSCRIPT
6776class PyApp(EvtHandler):
c24da6d6
RD
6777 """
6778 The ``wx.PyApp`` class is an *implementation detail*, please use the
6779 `wx.App` class (or some other derived class) instead.
6780 """
d55e5bfc
RD
6781 def __repr__(self):
6782 return "<%s.%s; proxy of C++ wxPyApp instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
6783 def __init__(self, *args, **kwargs):
6784 """
6785 __init__(self) -> PyApp
6786
6787 Create a new application object, starting the bootstrap process.
6788 """
6789 newobj = _core_.new_PyApp(*args, **kwargs)
6790 self.this = newobj.this
6791 self.thisown = 1
6792 del newobj.thisown
70b7a5fe
RD
6793 self._setCallbackInfo(self, PyApp, False)
6794 self._setOORInfo(self, False)
d55e5bfc
RD
6795
6796 def __del__(self, destroy=_core_.delete_PyApp):
6797 """__del__(self)"""
6798 try:
6799 if self.thisown: destroy(self)
6800 except: pass
6801
6802 def _setCallbackInfo(*args, **kwargs):
70b7a5fe 6803 """_setCallbackInfo(self, PyObject self, PyObject _class, bool incref)"""
d55e5bfc
RD
6804 return _core_.PyApp__setCallbackInfo(*args, **kwargs)
6805
6806 def GetAppName(*args, **kwargs):
6807 """
6808 GetAppName(self) -> String
6809
6810 Get the application name.
6811 """
6812 return _core_.PyApp_GetAppName(*args, **kwargs)
6813
6814 def SetAppName(*args, **kwargs):
6815 """
6816 SetAppName(self, String name)
6817
c24da6d6
RD
6818 Set the application name. This value may be used automatically by
6819 `wx.Config` and such.
d55e5bfc
RD
6820 """
6821 return _core_.PyApp_SetAppName(*args, **kwargs)
6822
6823 def GetClassName(*args, **kwargs):
6824 """
6825 GetClassName(self) -> String
6826
6827 Get the application's class name.
6828 """
6829 return _core_.PyApp_GetClassName(*args, **kwargs)
6830
6831 def SetClassName(*args, **kwargs):
6832 """
6833 SetClassName(self, String name)
6834
c24da6d6
RD
6835 Set the application's class name. This value may be used for
6836 X-resources if applicable for the platform
d55e5bfc
RD
6837 """
6838 return _core_.PyApp_SetClassName(*args, **kwargs)
6839
6840 def GetVendorName(*args, **kwargs):
6841 """
6842 GetVendorName(self) -> String
6843
6844 Get the application's vendor name.
6845 """
6846 return _core_.PyApp_GetVendorName(*args, **kwargs)
6847
6848 def SetVendorName(*args, **kwargs):
6849 """
6850 SetVendorName(self, String name)
6851
c24da6d6
RD
6852 Set the application's vendor name. This value may be used
6853 automatically by `wx.Config` and such.
d55e5bfc
RD
6854 """
6855 return _core_.PyApp_SetVendorName(*args, **kwargs)
6856
6857 def GetTraits(*args, **kwargs):
6858 """
6859 GetTraits(self) -> wxAppTraits
6860
c24da6d6
RD
6861 Return (and create if necessary) the app traits object to which we
6862 delegate for everything which either should be configurable by the
6863 user (then he can change the default behaviour simply by overriding
6864 CreateTraits() and returning his own traits object) or which is
6865 GUI/console dependent as then wx.AppTraits allows us to abstract the
6866 differences behind the common facade.
6867
6868 :todo: Add support for overriding CreateAppTraits in wxPython.
d55e5bfc
RD
6869 """
6870 return _core_.PyApp_GetTraits(*args, **kwargs)
6871
6872 def ProcessPendingEvents(*args, **kwargs):
6873 """
6874 ProcessPendingEvents(self)
6875
c24da6d6
RD
6876 Process all events in the Pending Events list -- it is necessary to
6877 call this function to process posted events. This normally happens
6878 during each event loop iteration.
d55e5bfc
RD
6879 """
6880 return _core_.PyApp_ProcessPendingEvents(*args, **kwargs)
6881
6882 def Yield(*args, **kwargs):
6883 """
6884 Yield(self, bool onlyIfNeeded=False) -> bool
6885
c24da6d6
RD
6886 Process all currently pending events right now, instead of waiting
6887 until return to the event loop. It is an error to call ``Yield``
6888 recursively unless the value of ``onlyIfNeeded`` is True.
d55e5bfc 6889
c24da6d6 6890 :warning: This function is dangerous as it can lead to unexpected
79fccf9d
RD
6891 reentrancies (i.e. when called from an event handler it may
6892 result in calling the same event handler again), use with
6893 extreme care or, better, don't use at all!
d55e5bfc 6894
c24da6d6 6895 :see: `wx.Yield`, `wx.YieldIfNeeded`, `wx.SafeYield`
79fccf9d 6896
d55e5bfc
RD
6897 """
6898 return _core_.PyApp_Yield(*args, **kwargs)
6899
6900 def WakeUpIdle(*args, **kwargs):
6901 """
6902 WakeUpIdle(self)
6903
c24da6d6
RD
6904 Make sure that idle events are sent again.
6905 :see: `wx.WakeUpIdle`
d55e5bfc
RD
6906 """
6907 return _core_.PyApp_WakeUpIdle(*args, **kwargs)
6908
84f85550
RD
6909 def IsMainLoopRunning(*args, **kwargs):
6910 """
6911 IsMainLoopRunning() -> bool
6912
6913 Returns True if we're running the main loop, i.e. if the events can
6914 currently be dispatched.
6915 """
6916 return _core_.PyApp_IsMainLoopRunning(*args, **kwargs)
6917
6918 IsMainLoopRunning = staticmethod(IsMainLoopRunning)
d55e5bfc
RD
6919 def MainLoop(*args, **kwargs):
6920 """
6921 MainLoop(self) -> int
6922
c24da6d6
RD
6923 Execute the main GUI loop, the function doesn't normally return until
6924 all top level windows have been closed and destroyed.
d55e5bfc
RD
6925 """
6926 return _core_.PyApp_MainLoop(*args, **kwargs)
6927
6928 def Exit(*args, **kwargs):
6929 """
6930 Exit(self)
6931
6932 Exit the main loop thus terminating the application.
c24da6d6 6933 :see: `wx.Exit`
d55e5bfc
RD
6934 """
6935 return _core_.PyApp_Exit(*args, **kwargs)
6936
6937 def ExitMainLoop(*args, **kwargs):
6938 """
6939 ExitMainLoop(self)
6940
c24da6d6
RD
6941 Exit the main GUI loop during the next iteration of the main
6942 loop, (i.e. it does not stop the program immediately!)
d55e5bfc
RD
6943 """
6944 return _core_.PyApp_ExitMainLoop(*args, **kwargs)
6945
6946 def Pending(*args, **kwargs):
6947 """
6948 Pending(self) -> bool
6949
6950 Returns True if there are unprocessed events in the event queue.
6951 """
6952 return _core_.PyApp_Pending(*args, **kwargs)
6953
6954 def Dispatch(*args, **kwargs):
6955 """
6956 Dispatch(self) -> bool
6957
6958 Process the first event in the event queue (blocks until an event
6959 appears if there are none currently)
6960 """
6961 return _core_.PyApp_Dispatch(*args, **kwargs)
6962
6963 def ProcessIdle(*args, **kwargs):
6964 """
6965 ProcessIdle(self) -> bool
6966
c24da6d6
RD
6967 Called from the MainLoop when the application becomes idle (there are
6968 no pending events) and sends a `wx.IdleEvent` to all interested
6969 parties. Returns True if more idle events are needed, False if not.
d55e5bfc
RD
6970 """
6971 return _core_.PyApp_ProcessIdle(*args, **kwargs)
6972
6973 def SendIdleEvents(*args, **kwargs):
6974 """
6975 SendIdleEvents(self, Window win, IdleEvent event) -> bool
6976
c24da6d6
RD
6977 Send idle event to window and all subwindows. Returns True if more
6978 idle time is requested.
d55e5bfc
RD
6979 """
6980 return _core_.PyApp_SendIdleEvents(*args, **kwargs)
6981
6982 def IsActive(*args, **kwargs):
6983 """
6984 IsActive(self) -> bool
6985
6986 Return True if our app has focus.
6987 """
6988 return _core_.PyApp_IsActive(*args, **kwargs)
6989
6990 def SetTopWindow(*args, **kwargs):
6991 """
6992 SetTopWindow(self, Window win)
6993
c24da6d6 6994 Set the *main* top level window
d55e5bfc
RD
6995 """
6996 return _core_.PyApp_SetTopWindow(*args, **kwargs)
6997
6998 def GetTopWindow(*args, **kwargs):
6999 """
7000 GetTopWindow(self) -> Window
7001
c24da6d6
RD
7002 Return the *main* top level window (if it hadn't been set previously
7003 with SetTopWindow(), will return just some top level window and, if
7004 there not any, will return None)
d55e5bfc
RD
7005 """
7006 return _core_.PyApp_GetTopWindow(*args, **kwargs)
7007
7008 def SetExitOnFrameDelete(*args, **kwargs):
7009 """
7010 SetExitOnFrameDelete(self, bool flag)
7011
c24da6d6
RD
7012 Control the exit behaviour: by default, the program will exit the main
7013 loop (and so, usually, terminate) when the last top-level program
7014 window is deleted. Beware that if you disable this behaviour (with
7015 SetExitOnFrameDelete(False)), you'll have to call ExitMainLoop()
7016 explicitly from somewhere.
d55e5bfc
RD
7017 """
7018 return _core_.PyApp_SetExitOnFrameDelete(*args, **kwargs)
7019
7020 def GetExitOnFrameDelete(*args, **kwargs):
7021 """
7022 GetExitOnFrameDelete(self) -> bool
7023
7024 Get the current exit behaviour setting.
7025 """
7026 return _core_.PyApp_GetExitOnFrameDelete(*args, **kwargs)
7027
7028 def SetUseBestVisual(*args, **kwargs):
7029 """
7030 SetUseBestVisual(self, bool flag)
7031
c24da6d6
RD
7032 Set whether the app should try to use the best available visual on
7033 systems where more than one is available, (Sun, SGI, XFree86 4, etc.)
d55e5bfc
RD
7034 """
7035 return _core_.PyApp_SetUseBestVisual(*args, **kwargs)
7036
7037 def GetUseBestVisual(*args, **kwargs):
7038 """
7039 GetUseBestVisual(self) -> bool
7040
7041 Get current UseBestVisual setting.
7042 """
7043 return _core_.PyApp_GetUseBestVisual(*args, **kwargs)
7044
7045 def SetPrintMode(*args, **kwargs):
7046 """SetPrintMode(self, int mode)"""
7047 return _core_.PyApp_SetPrintMode(*args, **kwargs)
7048
7049 def GetPrintMode(*args, **kwargs):
7050 """GetPrintMode(self) -> int"""
7051 return _core_.PyApp_GetPrintMode(*args, **kwargs)
7052
7053 def SetAssertMode(*args, **kwargs):
7054 """
7055 SetAssertMode(self, int mode)
7056
79fccf9d 7057 Set the OnAssert behaviour for debug and hybrid builds.
d55e5bfc
RD
7058 """
7059 return _core_.PyApp_SetAssertMode(*args, **kwargs)
7060
7061 def GetAssertMode(*args, **kwargs):
7062 """
7063 GetAssertMode(self) -> int
7064
7065 Get the current OnAssert behaviour setting.
7066 """
7067 return _core_.PyApp_GetAssertMode(*args, **kwargs)
7068
7069 def GetMacSupportPCMenuShortcuts(*args, **kwargs):
c24da6d6 7070 """GetMacSupportPCMenuShortcuts() -> bool"""
d55e5bfc
RD
7071 return _core_.PyApp_GetMacSupportPCMenuShortcuts(*args, **kwargs)
7072
7073 GetMacSupportPCMenuShortcuts = staticmethod(GetMacSupportPCMenuShortcuts)
7074 def GetMacAboutMenuItemId(*args, **kwargs):
c24da6d6 7075 """GetMacAboutMenuItemId() -> long"""
d55e5bfc
RD
7076 return _core_.PyApp_GetMacAboutMenuItemId(*args, **kwargs)
7077
7078 GetMacAboutMenuItemId = staticmethod(GetMacAboutMenuItemId)
7079 def GetMacPreferencesMenuItemId(*args, **kwargs):
c24da6d6 7080 """GetMacPreferencesMenuItemId() -> long"""
d55e5bfc
RD
7081 return _core_.PyApp_GetMacPreferencesMenuItemId(*args, **kwargs)
7082
7083 GetMacPreferencesMenuItemId = staticmethod(GetMacPreferencesMenuItemId)
7084 def GetMacExitMenuItemId(*args, **kwargs):
c24da6d6 7085 """GetMacExitMenuItemId() -> long"""
d55e5bfc
RD
7086 return _core_.PyApp_GetMacExitMenuItemId(*args, **kwargs)
7087
7088 GetMacExitMenuItemId = staticmethod(GetMacExitMenuItemId)
7089 def GetMacHelpMenuTitleName(*args, **kwargs):
c24da6d6 7090 """GetMacHelpMenuTitleName() -> String"""
d55e5bfc
RD
7091 return _core_.PyApp_GetMacHelpMenuTitleName(*args, **kwargs)
7092
7093 GetMacHelpMenuTitleName = staticmethod(GetMacHelpMenuTitleName)
7094 def SetMacSupportPCMenuShortcuts(*args, **kwargs):
c24da6d6 7095 """SetMacSupportPCMenuShortcuts(bool val)"""
d55e5bfc
RD
7096 return _core_.PyApp_SetMacSupportPCMenuShortcuts(*args, **kwargs)
7097
7098 SetMacSupportPCMenuShortcuts = staticmethod(SetMacSupportPCMenuShortcuts)
7099 def SetMacAboutMenuItemId(*args, **kwargs):
c24da6d6 7100 """SetMacAboutMenuItemId(long val)"""
d55e5bfc
RD
7101 return _core_.PyApp_SetMacAboutMenuItemId(*args, **kwargs)
7102
7103 SetMacAboutMenuItemId = staticmethod(SetMacAboutMenuItemId)
7104 def SetMacPreferencesMenuItemId(*args, **kwargs):
c24da6d6 7105 """SetMacPreferencesMenuItemId(long val)"""
d55e5bfc
RD
7106 return _core_.PyApp_SetMacPreferencesMenuItemId(*args, **kwargs)
7107
7108 SetMacPreferencesMenuItemId = staticmethod(SetMacPreferencesMenuItemId)
7109 def SetMacExitMenuItemId(*args, **kwargs):
c24da6d6 7110 """SetMacExitMenuItemId(long val)"""
d55e5bfc
RD
7111 return _core_.PyApp_SetMacExitMenuItemId(*args, **kwargs)
7112
7113 SetMacExitMenuItemId = staticmethod(SetMacExitMenuItemId)
7114 def SetMacHelpMenuTitleName(*args, **kwargs):
c24da6d6 7115 """SetMacHelpMenuTitleName(String val)"""
d55e5bfc
RD
7116 return _core_.PyApp_SetMacHelpMenuTitleName(*args, **kwargs)
7117
7118 SetMacHelpMenuTitleName = staticmethod(SetMacHelpMenuTitleName)
7119 def _BootstrapApp(*args, **kwargs):
7120 """
7121 _BootstrapApp(self)
7122
7123 For internal use only
7124 """
7125 return _core_.PyApp__BootstrapApp(*args, **kwargs)
7126
7127 def GetComCtl32Version(*args, **kwargs):
7128 """
c24da6d6 7129 GetComCtl32Version() -> int
d55e5bfc 7130
c24da6d6
RD
7131 Returns 400, 470, 471, etc. for comctl32.dll 4.00, 4.70, 4.71 or 0 if
7132 it wasn't found at all. Raises an exception on non-Windows platforms.
d55e5bfc
RD
7133 """
7134 return _core_.PyApp_GetComCtl32Version(*args, **kwargs)
7135
7136 GetComCtl32Version = staticmethod(GetComCtl32Version)
7137
7138class PyAppPtr(PyApp):
7139 def __init__(self, this):
7140 self.this = this
7141 if not hasattr(self,"thisown"): self.thisown = 0
7142 self.__class__ = PyApp
7143_core_.PyApp_swigregister(PyAppPtr)
7144
84f85550
RD
7145def PyApp_IsMainLoopRunning(*args, **kwargs):
7146 """
7147 PyApp_IsMainLoopRunning() -> bool
7148
7149 Returns True if we're running the main loop, i.e. if the events can
7150 currently be dispatched.
7151 """
7152 return _core_.PyApp_IsMainLoopRunning(*args, **kwargs)
7153
d55e5bfc
RD
7154def PyApp_GetMacSupportPCMenuShortcuts(*args, **kwargs):
7155 """PyApp_GetMacSupportPCMenuShortcuts() -> bool"""
7156 return _core_.PyApp_GetMacSupportPCMenuShortcuts(*args, **kwargs)
7157
7158def PyApp_GetMacAboutMenuItemId(*args, **kwargs):
7159 """PyApp_GetMacAboutMenuItemId() -> long"""
7160 return _core_.PyApp_GetMacAboutMenuItemId(*args, **kwargs)
7161
7162def PyApp_GetMacPreferencesMenuItemId(*args, **kwargs):
7163 """PyApp_GetMacPreferencesMenuItemId() -> long"""
7164 return _core_.PyApp_GetMacPreferencesMenuItemId(*args, **kwargs)
7165
7166def PyApp_GetMacExitMenuItemId(*args, **kwargs):
7167 """PyApp_GetMacExitMenuItemId() -> long"""
7168 return _core_.PyApp_GetMacExitMenuItemId(*args, **kwargs)
7169
7170def PyApp_GetMacHelpMenuTitleName(*args, **kwargs):
7171 """PyApp_GetMacHelpMenuTitleName() -> String"""
7172 return _core_.PyApp_GetMacHelpMenuTitleName(*args, **kwargs)
7173
7174def PyApp_SetMacSupportPCMenuShortcuts(*args, **kwargs):
7175 """PyApp_SetMacSupportPCMenuShortcuts(bool val)"""
7176 return _core_.PyApp_SetMacSupportPCMenuShortcuts(*args, **kwargs)
7177
7178def PyApp_SetMacAboutMenuItemId(*args, **kwargs):
7179 """PyApp_SetMacAboutMenuItemId(long val)"""
7180 return _core_.PyApp_SetMacAboutMenuItemId(*args, **kwargs)
7181
7182def PyApp_SetMacPreferencesMenuItemId(*args, **kwargs):
7183 """PyApp_SetMacPreferencesMenuItemId(long val)"""
7184 return _core_.PyApp_SetMacPreferencesMenuItemId(*args, **kwargs)
7185
7186def PyApp_SetMacExitMenuItemId(*args, **kwargs):
7187 """PyApp_SetMacExitMenuItemId(long val)"""
7188 return _core_.PyApp_SetMacExitMenuItemId(*args, **kwargs)
7189
7190def PyApp_SetMacHelpMenuTitleName(*args, **kwargs):
7191 """PyApp_SetMacHelpMenuTitleName(String val)"""
7192 return _core_.PyApp_SetMacHelpMenuTitleName(*args, **kwargs)
7193
7194def PyApp_GetComCtl32Version(*args, **kwargs):
7195 """
7196 PyApp_GetComCtl32Version() -> int
7197
c24da6d6
RD
7198 Returns 400, 470, 471, etc. for comctl32.dll 4.00, 4.70, 4.71 or 0 if
7199 it wasn't found at all. Raises an exception on non-Windows platforms.
d55e5bfc
RD
7200 """
7201 return _core_.PyApp_GetComCtl32Version(*args, **kwargs)
7202
7203#---------------------------------------------------------------------------
7204
7205
7206def Exit(*args, **kwargs):
7207 """
7208 Exit()
7209
7210 Force an exit of the application. Convenience for wx.GetApp().Exit()
7211 """
7212 return _core_.Exit(*args, **kwargs)
7213
7214def Yield(*args, **kwargs):
7215 """
7216 Yield() -> bool
7217
7218 Yield to other apps/messages. Convenience for wx.GetApp().Yield()
7219 """
7220 return _core_.Yield(*args, **kwargs)
7221
7222def YieldIfNeeded(*args, **kwargs):
7223 """
7224 YieldIfNeeded() -> bool
7225
7226 Yield to other apps/messages. Convenience for wx.GetApp().Yield(True)
7227 """
7228 return _core_.YieldIfNeeded(*args, **kwargs)
7229
7230def SafeYield(*args, **kwargs):
7231 """
7232 SafeYield(Window win=None, bool onlyIfNeeded=False) -> bool
7233
c24da6d6
RD
7234 This function is similar to `wx.Yield`, except that it disables the
7235 user input to all program windows before calling `wx.Yield` and
7236 re-enables it again afterwards. If ``win`` is not None, this window
7237 will remain enabled, allowing the implementation of some limited user
7238 interaction.
d55e5bfc 7239
c24da6d6 7240 :Returns: the result of the call to `wx.Yield`.
d55e5bfc
RD
7241 """
7242 return _core_.SafeYield(*args, **kwargs)
7243
7244def WakeUpIdle(*args, **kwargs):
7245 """
7246 WakeUpIdle()
7247
c24da6d6
RD
7248 Cause the message queue to become empty again, so idle events will be
7249 sent.
d55e5bfc
RD
7250 """
7251 return _core_.WakeUpIdle(*args, **kwargs)
7252
7253def PostEvent(*args, **kwargs):
7254 """
7255 PostEvent(EvtHandler dest, Event event)
7256
c24da6d6
RD
7257 Send an event to a window or other wx.EvtHandler to be processed
7258 later.
d55e5bfc
RD
7259 """
7260 return _core_.PostEvent(*args, **kwargs)
7261
7262def App_CleanUp(*args, **kwargs):
7263 """
7264 App_CleanUp()
7265
79fccf9d 7266 For internal use only, it is used to cleanup after wxWidgets when
c24da6d6 7267 Python shuts down.
d55e5bfc
RD
7268 """
7269 return _core_.App_CleanUp(*args, **kwargs)
7270
7271def GetApp(*args, **kwargs):
7272 """
7273 GetApp() -> PyApp
7274
7275 Return a reference to the current wx.App object.
7276 """
7277 return _core_.GetApp(*args, **kwargs)
5cbf236d
RD
7278
7279def SetDefaultPyEncoding(*args, **kwargs):
7280 """
7281 SetDefaultPyEncoding(string encoding)
7282
7283 Sets the encoding that wxPython will use when it needs to convert a
7284 Python string or unicode object to or from a wxString.
62d32a5f
RD
7285
7286 The default encoding is the value of ``locale.getdefaultlocale()[1]``
7287 but please be aware that the default encoding within the same locale
7288 may be slightly different on different platforms. For example, please
7289 see http://www.alanwood.net/demos/charsetdiffs.html for differences
7290 between the common latin/roman encodings.
5cbf236d
RD
7291 """
7292 return _core_.SetDefaultPyEncoding(*args, **kwargs)
7293
7294def GetDefaultPyEncoding(*args, **kwargs):
7295 """
7296 GetDefaultPyEncoding() -> string
7297
7298 Gets the current encoding that wxPython will use when it needs to
7299 convert a Python string or unicode object to or from a wxString.
7300 """
7301 return _core_.GetDefaultPyEncoding(*args, **kwargs)
d55e5bfc
RD
7302#----------------------------------------------------------------------
7303
7304class PyOnDemandOutputWindow:
7305 """
7306 A class that can be used for redirecting Python's stdout and
7307 stderr streams. It will do nothing until something is wrriten to
7308 the stream at which point it will create a Frame with a text area
7309 and write the text there.
7310 """
7311 def __init__(self, title = "wxPython: stdout/stderr"):
7312 self.frame = None
7313 self.title = title
412d302d
RD
7314 self.pos = wx.DefaultPosition
7315 self.size = (450, 300)
d55e5bfc
RD
7316 self.parent = None
7317
7318 def SetParent(self, parent):
7319 """Set the window to be used as the popup Frame's parent."""
7320 self.parent = parent
7321
7322
7323 def CreateOutputWindow(self, st):
412d302d
RD
7324 self.frame = wx.Frame(self.parent, -1, self.title, self.pos, self.size,
7325 style=wx.DEFAULT_FRAME_STYLE)
d55e5bfc 7326 self.text = wx.TextCtrl(self.frame, -1, "",
412d302d 7327 style=wx.TE_MULTILINE|wx.TE_READONLY)
d55e5bfc 7328 self.text.AppendText(st)
d55e5bfc
RD
7329 self.frame.Show(True)
7330 EVT_CLOSE(self.frame, self.OnCloseWindow)
7331
7332
7333 def OnCloseWindow(self, event):
7334 if self.frame is not None:
7335 self.frame.Destroy()
7336 self.frame = None
7337 self.text = None
7338
7339
7340 # These methods provide the file-like output behaviour.
7341 def write(self, text):
7342 """
7343 Create the output window if needed and write the string to it.
7344 If not called in the context of the gui thread then uses
7345 CallAfter to do the work there.
7346 """
7347 if self.frame is None:
7348 if not wx.Thread_IsMain():
7349 wx.CallAfter(self.CreateOutputWindow, text)
7350 else:
7351 self.CreateOutputWindow(text)
7352 else:
7353 if not wx.Thread_IsMain():
7354 wx.CallAfter(self.text.AppendText, text)
7355 else:
7356 self.text.AppendText(text)
7357
7358
7359 def close(self):
7360 if self.frame is not None:
7361 wx.CallAfter(self.frame.Close)
7362
7363
19272049
RD
7364 def flush(self):
7365 pass
7366
7367
d55e5bfc
RD
7368
7369#----------------------------------------------------------------------
7370
7371_defRedirect = (wx.Platform == '__WXMSW__' or wx.Platform == '__WXMAC__')
7372
7373class App(wx.PyApp):
7374 """
c24da6d6
RD
7375 The ``wx.App`` class represents the application and is used to:
7376
7377 * bootstrap the wxPython system and initialize the underlying
7378 gui toolkit
7379 * set and get application-wide properties
7380 * implement the windowing system main message or event loop,
7381 and to dispatch events to window instances
7382 * etc.
7383
7384 Every application must have a ``wx.App`` instance, and all
7385 creation of UI objects should be delayed until after the
7386 ``wx.App`` object has been created in order to ensure that the gui
7387 platform and wxWidgets have been fully initialized.
7388
7389 Normally you would derive from this class and implement an
7390 ``OnInit`` method that creates a frame and then calls
7391 ``self.SetTopWindow(frame)``.
7392
7393 :see: `wx.PySimpleApp` for a simpler app class that can be used
79fccf9d 7394 directly.
d55e5bfc 7395 """
c24da6d6 7396
d55e5bfc
RD
7397 outputWindowClass = PyOnDemandOutputWindow
7398
c24da6d6
RD
7399 def __init__(self, redirect=_defRedirect, filename=None,
7400 useBestVisual=False, clearSigInt=True):
7401 """
7402 Construct a ``wx.App`` object.
7403
7404 :param redirect: Should ``sys.stdout`` and ``sys.stderr`` be
7405 redirected? Defaults to True on Windows and Mac, False
7406 otherwise. If `filename` is None then output will be
7407 redirected to a window that pops up as needed. (You can
7408 control what kind of window is created for the output by
7409 resetting the class variable ``outputWindowClass`` to a
7410 class of your choosing.)
7411
7412 :param filename: The name of a file to redirect output to, if
7413 redirect is True.
7414
7415 :param useBestVisual: Should the app try to use the best
7416 available visual provided by the system (only relevant on
7417 systems that have more than one visual.) This parameter
7418 must be used instead of calling `SetUseBestVisual` later
7419 on because it must be set before the underlying GUI
7420 toolkit is initialized.
7421
7422 :param clearSigInt: Should SIGINT be cleared? This allows the
7423 app to terminate upon a Ctrl-C in the console like other
7424 GUI apps will.
7425
7426 :note: You should override OnInit to do applicaition
7427 initialization to ensure that the system, toolkit and
7428 wxWidgets are fully initialized.
7429 """
d55e5bfc
RD
7430 wx.PyApp.__init__(self)
7431
7432 if wx.Platform == "__WXMAC__":
7433 try:
7434 import MacOS
7435 if not MacOS.WMAvailable():
7436 print """\
7437This program needs access to the screen. Please run with 'pythonw',
7438not 'python', and only when you are logged in on the main display of
7439your Mac."""
7440 _sys.exit(1)
b1f29bf7
RD
7441 except SystemExit:
7442 raise
d55e5bfc
RD
7443 except:
7444 pass
7445
7446 # This has to be done before OnInit
7447 self.SetUseBestVisual(useBestVisual)
7448
7449 # Set the default handler for SIGINT. This fixes a problem
7450 # where if Ctrl-C is pressed in the console that started this
7451 # app then it will not appear to do anything, (not even send
7452 # KeyboardInterrupt???) but will later segfault on exit. By
7453 # setting the default handler then the app will exit, as
7454 # expected (depending on platform.)
c24da6d6
RD
7455 if clearSigInt:
7456 try:
7457 import signal
7458 signal.signal(signal.SIGINT, signal.SIG_DFL)
7459 except:
7460 pass
d55e5bfc
RD
7461
7462 # Save and redirect the stdio to a window?
7463 self.stdioWin = None
7464 self.saveStdio = (_sys.stdout, _sys.stderr)
7465 if redirect:
7466 self.RedirectStdio(filename)
7467
8fb0e70a
RD
7468 # Use Python's install prefix as the default
7469 wx.StandardPaths.Get().SetInstallPrefix(_sys.prefix)
7470
d55e5bfc
RD
7471 # This finishes the initialization of wxWindows and then calls
7472 # the OnInit that should be present in the derived class
7473 self._BootstrapApp()
7474
7475
66af7a75
RD
7476 def __del__(self, destroy=wx.PyApp.__del__):
7477 self.RestoreStdio() # Just in case the MainLoop was overridden
7478 destroy(self)
d55e5bfc 7479
70b7a5fe
RD
7480 def Destroy(self):
7481 wx.PyApp.Destroy(self)
7482 self.thisown = 0
d55e5bfc
RD
7483
7484 def SetTopWindow(self, frame):
7485 """Set the \"main\" top level window"""
7486 if self.stdioWin:
7487 self.stdioWin.SetParent(frame)
7488 wx.PyApp.SetTopWindow(self, frame)
7489
7490
7491 def MainLoop(self):
7492 """Execute the main GUI event loop"""
7493 wx.PyApp.MainLoop(self)
7494 self.RestoreStdio()
7495
7496
7497 def RedirectStdio(self, filename=None):
7498 """Redirect sys.stdout and sys.stderr to a file or a popup window."""
7499 if filename:
7500 _sys.stdout = _sys.stderr = open(filename, 'a')
7501 else:
7502 self.stdioWin = self.outputWindowClass()
7503 _sys.stdout = _sys.stderr = self.stdioWin
7504
7505
7506 def RestoreStdio(self):
66af7a75
RD
7507 try:
7508 _sys.stdout, _sys.stderr = self.saveStdio
7509 except:
7510 pass
d55e5bfc
RD
7511
7512
412d302d
RD
7513 def SetOutputWindowAttributes(self, title=None, pos=None, size=None):
7514 """
7515 Set the title, position and/or size of the output window if
f5b96ee1
RD
7516 the stdio has been redirected. This should be called before
7517 any output would cause the output window to be created.
412d302d
RD
7518 """
7519 if self.stdioWin:
7520 if title is not None:
7521 self.stdioWin.title = title
7522 if pos is not None:
7523 self.stdioWin.pos = pos
7524 if size is not None:
7525 self.stdioWin.size = size
7526
7527
7528
d55e5bfc 7529
c24da6d6 7530# change from wx.PyApp_XX to wx.App_XX
d55e5bfc
RD
7531App_GetMacSupportPCMenuShortcuts = _core_.PyApp_GetMacSupportPCMenuShortcuts
7532App_GetMacAboutMenuItemId = _core_.PyApp_GetMacAboutMenuItemId
7533App_GetMacPreferencesMenuItemId = _core_.PyApp_GetMacPreferencesMenuItemId
7534App_GetMacExitMenuItemId = _core_.PyApp_GetMacExitMenuItemId
7535App_GetMacHelpMenuTitleName = _core_.PyApp_GetMacHelpMenuTitleName
7536App_SetMacSupportPCMenuShortcuts = _core_.PyApp_SetMacSupportPCMenuShortcuts
7537App_SetMacAboutMenuItemId = _core_.PyApp_SetMacAboutMenuItemId
7538App_SetMacPreferencesMenuItemId = _core_.PyApp_SetMacPreferencesMenuItemId
7539App_SetMacExitMenuItemId = _core_.PyApp_SetMacExitMenuItemId
7540App_SetMacHelpMenuTitleName = _core_.PyApp_SetMacHelpMenuTitleName
7541App_GetComCtl32Version = _core_.PyApp_GetComCtl32Version
7542
7543#----------------------------------------------------------------------------
7544
7545class PySimpleApp(wx.App):
7546 """
7547 A simple application class. You can just create one of these and
7548 then then make your top level windows later, and not have to worry
c24da6d6 7549 about OnInit. For example::
d55e5bfc 7550
c24da6d6
RD
7551 app = wx.PySimpleApp()
7552 frame = wx.Frame(None, title='Hello World')
7553 frame.Show()
7554 app.MainLoop()
7555
7556 :see: `wx.App`
7557 """
7558
7559 def __init__(self, redirect=False, filename=None,
7560 useBestVisual=False, clearSigInt=True):
7561 """
7562 :see: `wx.App.__init__`
7563 """
7564 wx.App.__init__(self, redirect, filename, useBestVisual, clearSigInt)
d55e5bfc
RD
7565
7566 def OnInit(self):
d55e5bfc
RD
7567 return True
7568
7569
c24da6d6 7570
d55e5bfc
RD
7571# Is anybody using this one?
7572class PyWidgetTester(wx.App):
7573 def __init__(self, size = (250, 100)):
7574 self.size = size
7575 wx.App.__init__(self, 0)
7576
7577 def OnInit(self):
7578 self.frame = wx.Frame(None, -1, "Widget Tester", pos=(0,0), size=self.size)
7579 self.SetTopWindow(self.frame)
7580 return True
7581
c24da6d6
RD
7582 def SetWidget(self, widgetClass, *args, **kwargs):
7583 w = widgetClass(self.frame, *args, **kwargs)
d55e5bfc
RD
7584 self.frame.Show(True)
7585
7586#----------------------------------------------------------------------------
7587# DO NOT hold any other references to this object. This is how we
c24da6d6 7588# know when to cleanup system resources that wxWidgets is holding. When
d55e5bfc 7589# the sys module is unloaded, the refcount on sys.__wxPythonCleanup
c24da6d6 7590# goes to zero and it calls the wx.App_CleanUp function.
d55e5bfc
RD
7591
7592class __wxPyCleanup:
7593 def __init__(self):
7594 self.cleanup = _core_.App_CleanUp
7595 def __del__(self):
7596 self.cleanup()
7597
7598_sys.__wxPythonCleanup = __wxPyCleanup()
7599
7600## # another possible solution, but it gets called too early...
c24da6d6
RD
7601## import atexit
7602## atexit.register(_core_.wxApp_CleanUp)
d55e5bfc
RD
7603
7604
7605#----------------------------------------------------------------------------
7606
7607#---------------------------------------------------------------------------
7608
ae8162c8 7609class EventLoop(object):
093d3ff1 7610 """Proxy of C++ EventLoop class"""
ae8162c8
RD
7611 def __repr__(self):
7612 return "<%s.%s; proxy of C++ wxEventLoop instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
7613 def __init__(self, *args, **kwargs):
7614 """__init__(self) -> EventLoop"""
7615 newobj = _core_.new_EventLoop(*args, **kwargs)
7616 self.this = newobj.this
7617 self.thisown = 1
7618 del newobj.thisown
7619 def __del__(self, destroy=_core_.delete_EventLoop):
7620 """__del__(self)"""
7621 try:
7622 if self.thisown: destroy(self)
7623 except: pass
7624
7625 def Run(*args, **kwargs):
7626 """Run(self) -> int"""
7627 return _core_.EventLoop_Run(*args, **kwargs)
7628
7629 def Exit(*args, **kwargs):
7630 """Exit(self, int rc=0)"""
7631 return _core_.EventLoop_Exit(*args, **kwargs)
7632
7633 def Pending(*args, **kwargs):
7634 """Pending(self) -> bool"""
7635 return _core_.EventLoop_Pending(*args, **kwargs)
7636
7637 def Dispatch(*args, **kwargs):
7638 """Dispatch(self) -> bool"""
7639 return _core_.EventLoop_Dispatch(*args, **kwargs)
7640
7641 def IsRunning(*args, **kwargs):
7642 """IsRunning(self) -> bool"""
7643 return _core_.EventLoop_IsRunning(*args, **kwargs)
7644
7645 def GetActive(*args, **kwargs):
7646 """GetActive() -> EventLoop"""
7647 return _core_.EventLoop_GetActive(*args, **kwargs)
7648
7649 GetActive = staticmethod(GetActive)
7650 def SetActive(*args, **kwargs):
7651 """SetActive(EventLoop loop)"""
7652 return _core_.EventLoop_SetActive(*args, **kwargs)
7653
7654 SetActive = staticmethod(SetActive)
7655
7656class EventLoopPtr(EventLoop):
7657 def __init__(self, this):
7658 self.this = this
7659 if not hasattr(self,"thisown"): self.thisown = 0
7660 self.__class__ = EventLoop
7661_core_.EventLoop_swigregister(EventLoopPtr)
7662
7663def EventLoop_GetActive(*args, **kwargs):
7664 """EventLoop_GetActive() -> EventLoop"""
7665 return _core_.EventLoop_GetActive(*args, **kwargs)
7666
7667def EventLoop_SetActive(*args, **kwargs):
7668 """EventLoop_SetActive(EventLoop loop)"""
7669 return _core_.EventLoop_SetActive(*args, **kwargs)
7670
7671#---------------------------------------------------------------------------
7672
d55e5bfc 7673class AcceleratorEntry(object):
c24da6d6
RD
7674 """
7675 A class used to define items in an `wx.AcceleratorTable`. wxPython
7676 programs can choose to use wx.AcceleratorEntry objects, but using a
7677 list of 3-tuple of integers (flags, keyCode, cmdID) usually works just
79fccf9d 7678 as well. See `__init__` for of the tuple values.
c24da6d6
RD
7679
7680 :see: `wx.AcceleratorTable`
7681 """
d55e5bfc
RD
7682 def __repr__(self):
7683 return "<%s.%s; proxy of C++ wxAcceleratorEntry instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
7684 def __init__(self, *args, **kwargs):
c24da6d6
RD
7685 """
7686 __init__(self, int flags=0, int keyCode=0, int cmdID=0) -> AcceleratorEntry
7687
7688 Construct a wx.AcceleratorEntry.
c24da6d6 7689 """
d55e5bfc
RD
7690 newobj = _core_.new_AcceleratorEntry(*args, **kwargs)
7691 self.this = newobj.this
7692 self.thisown = 1
7693 del newobj.thisown
7694 def __del__(self, destroy=_core_.delete_AcceleratorEntry):
7695 """__del__(self)"""
7696 try:
7697 if self.thisown: destroy(self)
7698 except: pass
7699
7700 def Set(*args, **kwargs):
c24da6d6
RD
7701 """
7702 Set(self, int flags, int keyCode, int cmd)
d55e5bfc 7703
c24da6d6
RD
7704 (Re)set the attributes of a wx.AcceleratorEntry.
7705 :see `__init__`
7706 """
7707 return _core_.AcceleratorEntry_Set(*args, **kwargs)
d55e5bfc
RD
7708
7709 def GetFlags(*args, **kwargs):
c24da6d6
RD
7710 """
7711 GetFlags(self) -> int
7712
7713 Get the AcceleratorEntry's flags.
7714 """
d55e5bfc
RD
7715 return _core_.AcceleratorEntry_GetFlags(*args, **kwargs)
7716
7717 def GetKeyCode(*args, **kwargs):
c24da6d6
RD
7718 """
7719 GetKeyCode(self) -> int
7720
7721 Get the AcceleratorEntry's keycode.
7722 """
d55e5bfc
RD
7723 return _core_.AcceleratorEntry_GetKeyCode(*args, **kwargs)
7724
7725 def GetCommand(*args, **kwargs):
c24da6d6
RD
7726 """
7727 GetCommand(self) -> int
7728
7729 Get the AcceleratorEntry's command ID.
7730 """
d55e5bfc
RD
7731 return _core_.AcceleratorEntry_GetCommand(*args, **kwargs)
7732
7733
7734class AcceleratorEntryPtr(AcceleratorEntry):
7735 def __init__(self, this):
7736 self.this = this
7737 if not hasattr(self,"thisown"): self.thisown = 0
7738 self.__class__ = AcceleratorEntry
7739_core_.AcceleratorEntry_swigregister(AcceleratorEntryPtr)
7740
7741class AcceleratorTable(Object):
c24da6d6
RD
7742 """
7743 An accelerator table allows the application to specify a table of
7744 keyboard shortcuts for menus or other commands. On Windows, menu or
7745 button commands are supported; on GTK, only menu commands are
7746 supported.
c24da6d6 7747 """
d55e5bfc
RD
7748 def __repr__(self):
7749 return "<%s.%s; proxy of C++ wxAcceleratorTable instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
7750 def __init__(self, *args, **kwargs):
7751 """
7752 __init__(entries) -> AcceleratorTable
7753
c24da6d6
RD
7754 Construct an AcceleratorTable from a list of `wx.AcceleratorEntry`
7755 items or or of 3-tuples (flags, keyCode, cmdID)
7756
7757 :see: `wx.AcceleratorEntry`
d55e5bfc
RD
7758 """
7759 newobj = _core_.new_AcceleratorTable(*args, **kwargs)
7760 self.this = newobj.this
7761 self.thisown = 1
7762 del newobj.thisown
7763 def __del__(self, destroy=_core_.delete_AcceleratorTable):
7764 """__del__(self)"""
7765 try:
7766 if self.thisown: destroy(self)
7767 except: pass
7768
7769 def Ok(*args, **kwargs):
7770 """Ok(self) -> bool"""
7771 return _core_.AcceleratorTable_Ok(*args, **kwargs)
7772
7773
7774class AcceleratorTablePtr(AcceleratorTable):
7775 def __init__(self, this):
7776 self.this = this
7777 if not hasattr(self,"thisown"): self.thisown = 0
7778 self.__class__ = AcceleratorTable
7779_core_.AcceleratorTable_swigregister(AcceleratorTablePtr)
7780
7781
7782def GetAccelFromString(*args, **kwargs):
7783 """GetAccelFromString(String label) -> AcceleratorEntry"""
7784 return _core_.GetAccelFromString(*args, **kwargs)
7785#---------------------------------------------------------------------------
7786
7787class VisualAttributes(object):
7788 """struct containing all the visual attributes of a control"""
7789 def __repr__(self):
7790 return "<%s.%s; proxy of C++ wxVisualAttributes instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
7791 def __init__(self, *args, **kwargs):
7792 """
7793 __init__(self) -> VisualAttributes
7794
7795 struct containing all the visual attributes of a control
7796 """
7797 newobj = _core_.new_VisualAttributes(*args, **kwargs)
7798 self.this = newobj.this
7799 self.thisown = 1
7800 del newobj.thisown
7801 def __del__(self, destroy=_core_.delete_VisualAttributes):
7802 """__del__(self)"""
7803 try:
7804 if self.thisown: destroy(self)
7805 except: pass
7806
7807 font = property(_core_.VisualAttributes_font_get, _core_.VisualAttributes_font_set)
7808 colFg = property(_core_.VisualAttributes_colFg_get, _core_.VisualAttributes_colFg_set)
7809 colBg = property(_core_.VisualAttributes_colBg_get, _core_.VisualAttributes_colBg_set)
7810
7811class VisualAttributesPtr(VisualAttributes):
7812 def __init__(self, this):
7813 self.this = this
7814 if not hasattr(self,"thisown"): self.thisown = 0
7815 self.__class__ = VisualAttributes
7816_core_.VisualAttributes_swigregister(VisualAttributesPtr)
7817NullAcceleratorTable = cvar.NullAcceleratorTable
7818PanelNameStr = cvar.PanelNameStr
7819
7820WINDOW_VARIANT_NORMAL = _core_.WINDOW_VARIANT_NORMAL
7821WINDOW_VARIANT_SMALL = _core_.WINDOW_VARIANT_SMALL
7822WINDOW_VARIANT_MINI = _core_.WINDOW_VARIANT_MINI
7823WINDOW_VARIANT_LARGE = _core_.WINDOW_VARIANT_LARGE
7824WINDOW_VARIANT_MAX = _core_.WINDOW_VARIANT_MAX
7825class Window(EvtHandler):
7826 """
7827 wx.Window is the base class for all windows and represents any visible
7828 object on the screen. All controls, top level windows and so on are
7829 wx.Windows. Sizers and device contexts are not however, as they don't
7830 appear on screen themselves.
7831
7832 """
7833 def __repr__(self):
7834 return "<%s.%s; proxy of C++ wxWindow instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
7835 def __init__(self, *args, **kwargs):
7836 """
7837 __init__(self, Window parent, int id=-1, Point pos=DefaultPosition,
7838 Size size=DefaultSize, long style=0, String name=PanelNameStr) -> Window
7839
7840 Construct and show a generic Window.
7841 """
7842 newobj = _core_.new_Window(*args, **kwargs)
7843 self.this = newobj.this
7844 self.thisown = 1
7845 del newobj.thisown
7846 self._setOORInfo(self)
7847
7848 def Create(*args, **kwargs):
7849 """
7850 Create(self, Window parent, int id=-1, Point pos=DefaultPosition,
7851 Size size=DefaultSize, long style=0, String name=PanelNameStr) -> bool
7852
7853 Create the GUI part of the Window for 2-phase creation mode.
7854 """
7855 return _core_.Window_Create(*args, **kwargs)
7856
7857 def Close(*args, **kwargs):
7858 """
7859 Close(self, bool force=False) -> bool
7860
7861 This function simply generates a EVT_CLOSE event whose handler usually
7862 tries to close the window. It doesn't close the window itself,
7863 however. If force is False (the default) then the window's close
7864 handler will be allowed to veto the destruction of the window.
d55e5bfc
RD
7865 """
7866 return _core_.Window_Close(*args, **kwargs)
7867
7868 def Destroy(*args, **kwargs):
7869 """
7870 Destroy(self) -> bool
7871
7872 Destroys the window safely. Frames and dialogs are not destroyed
7873 immediately when this function is called -- they are added to a list
7874 of windows to be deleted on idle time, when all the window's events
7875 have been processed. This prevents problems with events being sent to
7876 non-existent windows.
7877
7878 Returns True if the window has either been successfully deleted, or it
7879 has been added to the list of windows pending real deletion.
7880 """
7881 return _core_.Window_Destroy(*args, **kwargs)
7882
7883 def DestroyChildren(*args, **kwargs):
7884 """
7885 DestroyChildren(self) -> bool
7886
79fccf9d
RD
7887 Destroys all children of a window. Called automatically by the
7888 destructor.
d55e5bfc
RD
7889 """
7890 return _core_.Window_DestroyChildren(*args, **kwargs)
7891
7892 def IsBeingDeleted(*args, **kwargs):
7893 """
7894 IsBeingDeleted(self) -> bool
7895
7896 Is the window in the process of being deleted?
7897 """
7898 return _core_.Window_IsBeingDeleted(*args, **kwargs)
7899
7900 def SetTitle(*args, **kwargs):
7901 """
7902 SetTitle(self, String title)
7903
7904 Sets the window's title. Applicable only to frames and dialogs.
7905 """
7906 return _core_.Window_SetTitle(*args, **kwargs)
7907
7908 def GetTitle(*args, **kwargs):
7909 """
7910 GetTitle(self) -> String
7911
7912 Gets the window's title. Applicable only to frames and dialogs.
7913 """
7914 return _core_.Window_GetTitle(*args, **kwargs)
7915
7916 def SetLabel(*args, **kwargs):
7917 """
7918 SetLabel(self, String label)
7919
7920 Set the text which the window shows in its label if applicable.
7921 """
7922 return _core_.Window_SetLabel(*args, **kwargs)
7923
7924 def GetLabel(*args, **kwargs):
7925 """
7926 GetLabel(self) -> String
7927
79fccf9d
RD
7928 Generic way of getting a label from any window, for identification
7929 purposes. The interpretation of this function differs from class to
7930 class. For frames and dialogs, the value returned is the title. For
7931 buttons or static text controls, it is the button text. This function
7932 can be useful for meta-programs such as testing tools or special-needs
7933 access programs)which need to identify windows by name.
d55e5bfc
RD
7934 """
7935 return _core_.Window_GetLabel(*args, **kwargs)
7936
7937 def SetName(*args, **kwargs):
7938 """
7939 SetName(self, String name)
7940
79fccf9d
RD
7941 Sets the window's name. The window name is used for ressource setting
7942 in X, it is not the same as the window title/label
d55e5bfc
RD
7943 """
7944 return _core_.Window_SetName(*args, **kwargs)
7945
7946 def GetName(*args, **kwargs):
7947 """
7948 GetName(self) -> String
7949
79fccf9d
RD
7950 Returns the windows name. This name is not guaranteed to be unique;
7951 it is up to the programmer to supply an appropriate name in the window
7952 constructor or via wx.Window.SetName.
d55e5bfc
RD
7953 """
7954 return _core_.Window_GetName(*args, **kwargs)
7955
7956 def SetWindowVariant(*args, **kwargs):
7957 """
7958 SetWindowVariant(self, int variant)
7959
79fccf9d
RD
7960 Sets the variant of the window/font size to use for this window, if
7961 the platform supports variants, for example, wxMac.
d55e5bfc
RD
7962 """
7963 return _core_.Window_SetWindowVariant(*args, **kwargs)
7964
7965 def GetWindowVariant(*args, **kwargs):
7966 """GetWindowVariant(self) -> int"""
7967 return _core_.Window_GetWindowVariant(*args, **kwargs)
7968
7969 def SetId(*args, **kwargs):
7970 """
7971 SetId(self, int winid)
7972
7973 Sets the identifier of the window. Each window has an integer
7974 identifier. If the application has not provided one, an identifier
7975 will be generated. Normally, the identifier should be provided on
7976 creation and should not be modified subsequently.
7977 """
7978 return _core_.Window_SetId(*args, **kwargs)
7979
7980 def GetId(*args, **kwargs):
7981 """
7982 GetId(self) -> int
7983
7984 Returns the identifier of the window. Each window has an integer
7985 identifier. If the application has not provided one (or the default Id
7986 -1 is used) then an unique identifier with a negative value will be
7987 generated.
7988 """
7989 return _core_.Window_GetId(*args, **kwargs)
7990
7991 def NewControlId(*args, **kwargs):
7992 """
c24da6d6 7993 NewControlId() -> int
d55e5bfc
RD
7994
7995 Generate a control id for the controls which were not given one.
7996 """
7997 return _core_.Window_NewControlId(*args, **kwargs)
7998
7999 NewControlId = staticmethod(NewControlId)
8000 def NextControlId(*args, **kwargs):
8001 """
c24da6d6 8002 NextControlId(int winid) -> int
d55e5bfc
RD
8003
8004 Get the id of the control following the one with the given
79fccf9d 8005 autogenerated) id
d55e5bfc
RD
8006 """
8007 return _core_.Window_NextControlId(*args, **kwargs)
8008
8009 NextControlId = staticmethod(NextControlId)
8010 def PrevControlId(*args, **kwargs):
8011 """
c24da6d6 8012 PrevControlId(int winid) -> int
d55e5bfc
RD
8013
8014 Get the id of the control preceding the one with the given
79fccf9d 8015 autogenerated) id
d55e5bfc
RD
8016 """
8017 return _core_.Window_PrevControlId(*args, **kwargs)
8018
8019 PrevControlId = staticmethod(PrevControlId)
8020 def SetSize(*args, **kwargs):
8021 """
8022 SetSize(self, Size size)
8023
8024 Sets the size of the window in pixels.
8025 """
8026 return _core_.Window_SetSize(*args, **kwargs)
8027
8028 def SetDimensions(*args, **kwargs):
8029 """
8030 SetDimensions(self, int x, int y, int width, int height, int sizeFlags=SIZE_AUTO)
8031
8032 Sets the position and size of the window in pixels. The sizeFlags
8033 parameter indicates the interpretation of the other params if they are
62d32a5f
RD
8034 equal to -1.
8035
8036 ======================== ======================================
8037 wx.SIZE_AUTO A -1 indicates that a class-specific
8038 default should be used.
8039 wx.SIZE_USE_EXISTING Axisting dimensions should be used if
8040 -1 values are supplied.
8041 wxSIZE_ALLOW_MINUS_ONE Allow dimensions of -1 and less to be
8042 interpreted as real dimensions, not
8043 default values.
8044 ======================== ======================================
8045
d55e5bfc
RD
8046 """
8047 return _core_.Window_SetDimensions(*args, **kwargs)
8048
8049 def SetRect(*args, **kwargs):
8050 """
8051 SetRect(self, Rect rect, int sizeFlags=SIZE_AUTO)
8052
8053 Sets the position and size of the window in pixels using a wx.Rect.
8054 """
8055 return _core_.Window_SetRect(*args, **kwargs)
8056
8057 def SetSizeWH(*args, **kwargs):
8058 """
8059 SetSizeWH(self, int width, int height)
8060
8061 Sets the size of the window in pixels.
8062 """
8063 return _core_.Window_SetSizeWH(*args, **kwargs)
8064
8065 def Move(*args, **kwargs):
8066 """
8067 Move(self, Point pt, int flags=SIZE_USE_EXISTING)
8068
8069 Moves the window to the given position.
8070 """
8071 return _core_.Window_Move(*args, **kwargs)
8072
8073 SetPosition = Move
8074 def MoveXY(*args, **kwargs):
8075 """
8076 MoveXY(self, int x, int y, int flags=SIZE_USE_EXISTING)
8077
8078 Moves the window to the given position.
8079 """
8080 return _core_.Window_MoveXY(*args, **kwargs)
8081
f8167d6e
RD
8082 def SetBestFittingSize(*args, **kwargs):
8083 """
8084 SetBestFittingSize(self, Size size=DefaultSize)
8085
8086 A 'Smart' SetSize that will fill in default size components with the
8087 window's *best size* values. Also set's the minsize for use with sizers.
8088 """
8089 return _core_.Window_SetBestFittingSize(*args, **kwargs)
8090
d55e5bfc
RD
8091 def Raise(*args, **kwargs):
8092 """
8093 Raise(self)
8094
8095 Raises the window to the top of the window hierarchy if it is a
8096 managed window (dialog or frame).
8097 """
8098 return _core_.Window_Raise(*args, **kwargs)
8099
8100 def Lower(*args, **kwargs):
8101 """
8102 Lower(self)
8103
8104 Lowers the window to the bottom of the window hierarchy if it is a
8105 managed window (dialog or frame).
8106 """
8107 return _core_.Window_Lower(*args, **kwargs)
8108
8109 def SetClientSize(*args, **kwargs):
8110 """
8111 SetClientSize(self, Size size)
8112
8113 This sets the size of the window client area in pixels. Using this
8114 function to size a window tends to be more device-independent than
8115 wx.Window.SetSize, since the application need not worry about what
8116 dimensions the border or title bar have when trying to fit the window
8117 around panel items, for example.
8118 """
8119 return _core_.Window_SetClientSize(*args, **kwargs)
8120
8121 def SetClientSizeWH(*args, **kwargs):
8122 """
8123 SetClientSizeWH(self, int width, int height)
8124
8125 This sets the size of the window client area in pixels. Using this
8126 function to size a window tends to be more device-independent than
8127 wx.Window.SetSize, since the application need not worry about what
8128 dimensions the border or title bar have when trying to fit the window
8129 around panel items, for example.
8130 """
8131 return _core_.Window_SetClientSizeWH(*args, **kwargs)
8132
8133 def SetClientRect(*args, **kwargs):
8134 """
8135 SetClientRect(self, Rect rect)
8136
8137 This sets the size of the window client area in pixels. Using this
8138 function to size a window tends to be more device-independent than
8139 wx.Window.SetSize, since the application need not worry about what
8140 dimensions the border or title bar have when trying to fit the window
8141 around panel items, for example.
8142 """
8143 return _core_.Window_SetClientRect(*args, **kwargs)
8144
8145 def GetPosition(*args, **kwargs):
8146 """
8147 GetPosition(self) -> Point
8148
8149 Get the window's position.
8150 """
8151 return _core_.Window_GetPosition(*args, **kwargs)
8152
8153 def GetPositionTuple(*args, **kwargs):
8154 """
8155 GetPositionTuple() -> (x,y)
8156
8157 Get the window's position.
8158 """
8159 return _core_.Window_GetPositionTuple(*args, **kwargs)
8160
8161 def GetSize(*args, **kwargs):
8162 """
8163 GetSize(self) -> Size
8164
8165 Get the window size.
8166 """
8167 return _core_.Window_GetSize(*args, **kwargs)
8168
8169 def GetSizeTuple(*args, **kwargs):
8170 """
8171 GetSizeTuple() -> (width, height)
8172
8173 Get the window size.
8174 """
8175 return _core_.Window_GetSizeTuple(*args, **kwargs)
8176
8177 def GetRect(*args, **kwargs):
8178 """
8179 GetRect(self) -> Rect
8180
8181 Returns the size and position of the window as a wx.Rect object.
8182 """
8183 return _core_.Window_GetRect(*args, **kwargs)
8184
8185 def GetClientSize(*args, **kwargs):
8186 """
8187 GetClientSize(self) -> Size
8188
8189 This gets the size of the window's 'client area' in pixels. The client
8190 area is the area which may be drawn on by the programmer, excluding
8191 title bar, border, scrollbars, etc.
8192 """
8193 return _core_.Window_GetClientSize(*args, **kwargs)
8194
8195 def GetClientSizeTuple(*args, **kwargs):
8196 """
8197 GetClientSizeTuple() -> (width, height)
8198
8199 This gets the size of the window's 'client area' in pixels. The client
8200 area is the area which may be drawn on by the programmer, excluding
8201 title bar, border, scrollbars, etc.
8202 """
8203 return _core_.Window_GetClientSizeTuple(*args, **kwargs)
8204
8205 def GetClientAreaOrigin(*args, **kwargs):
8206 """
8207 GetClientAreaOrigin(self) -> Point
8208
8209 Get the origin of the client area of the window relative to the
8210 window's top left corner (the client area may be shifted because of
8211 the borders, scrollbars, other decorations...)
8212 """
8213 return _core_.Window_GetClientAreaOrigin(*args, **kwargs)
8214
8215 def GetClientRect(*args, **kwargs):
8216 """
8217 GetClientRect(self) -> Rect
8218
629f3c1b 8219 Get the client area position and size as a `wx.Rect` object.
d55e5bfc
RD
8220 """
8221 return _core_.Window_GetClientRect(*args, **kwargs)
8222
8223 def GetBestSize(*args, **kwargs):
8224 """
8225 GetBestSize(self) -> Size
8226
248ed943 8227 This function returns the best acceptable minimal size for the
79fccf9d
RD
8228 window, if applicable. For example, for a static text control, it will
8229 be the minimal size such that the control label is not truncated. For
8230 windows containing subwindows (suzh aswx.Panel), the size returned by
8231 this function will be the same as the size the window would have had
8232 after calling Fit.
d55e5bfc
RD
8233 """
8234 return _core_.Window_GetBestSize(*args, **kwargs)
8235
8236 def GetBestSizeTuple(*args, **kwargs):
8237 """
8238 GetBestSizeTuple() -> (width, height)
8239
248ed943 8240 This function returns the best acceptable minimal size for the
79fccf9d
RD
8241 window, if applicable. For example, for a static text control, it will
8242 be the minimal size such that the control label is not truncated. For
8243 windows containing subwindows (suzh aswx.Panel), the size returned by
8244 this function will be the same as the size the window would have had
8245 after calling Fit.
d55e5bfc
RD
8246 """
8247 return _core_.Window_GetBestSizeTuple(*args, **kwargs)
8248
a001823c
RD
8249 def InvalidateBestSize(*args, **kwargs):
8250 """
8251 InvalidateBestSize(self)
8252
8253 Reset the cached best size value so it will be recalculated the next
8254 time it is needed.
8255 """
8256 return _core_.Window_InvalidateBestSize(*args, **kwargs)
8257
e2813725
RD
8258 def CacheBestSize(*args, **kwargs):
8259 """
8260 CacheBestSize(self, Size size)
8261
8262 Cache the best size so it doesn't need to be calculated again, (at least until
8263 some properties of the window change.)
8264 """
8265 return _core_.Window_CacheBestSize(*args, **kwargs)
8266
a001823c
RD
8267 def GetBestFittingSize(*args, **kwargs):
8268 """
8269 GetBestFittingSize(self) -> Size
8270
8271 This function will merge the window's best size into the window's
8272 minimum size, giving priority to the min size components, and returns
8273 the results.
8274
8275 """
8276 return _core_.Window_GetBestFittingSize(*args, **kwargs)
8277
d55e5bfc
RD
8278 def GetAdjustedBestSize(*args, **kwargs):
8279 """
8280 GetAdjustedBestSize(self) -> Size
8281
8282 This method is similar to GetBestSize, except in one
8283 thing. GetBestSize should return the minimum untruncated size of the
8284 window, while this method will return the largest of BestSize and any
8285 user specified minimum size. ie. it is the minimum size the window
8286 should currently be drawn at, not the minimal size it can possibly
8287 tolerate.
8288 """
8289 return _core_.Window_GetAdjustedBestSize(*args, **kwargs)
8290
8291 def Center(*args, **kwargs):
8292 """
8293 Center(self, int direction=BOTH)
8294
8295 Centers the window. The parameter specifies the direction for
8296 cetering, and may be wx.HORIZONTAL, wx.VERTICAL or wx.BOTH. It may
8297 also include wx.CENTER_ON_SCREEN flag if you want to center the window
8298 on the entire screen and not on its parent window. If it is a
8299 top-level window and has no parent then it will always be centered
8300 relative to the screen.
8301 """
8302 return _core_.Window_Center(*args, **kwargs)
8303
8304 Centre = Center
8305 def CenterOnScreen(*args, **kwargs):
8306 """
8307 CenterOnScreen(self, int dir=BOTH)
8308
8309 Center on screen (only works for top level windows)
8310 """
8311 return _core_.Window_CenterOnScreen(*args, **kwargs)
8312
8313 CentreOnScreen = CenterOnScreen
8314 def CenterOnParent(*args, **kwargs):
8315 """
8316 CenterOnParent(self, int dir=BOTH)
8317
8318 Center with respect to the the parent window
8319 """
8320 return _core_.Window_CenterOnParent(*args, **kwargs)
8321
8322 CentreOnParent = CenterOnParent
8323 def Fit(*args, **kwargs):
8324 """
8325 Fit(self)
8326
8327 Sizes the window so that it fits around its subwindows. This function
8328 won't do anything if there are no subwindows and will only really work
8329 correctly if sizers are used for the subwindows layout. Also, if the
8330 window has exactly one subwindow it is better (faster and the result
8331 is more precise as Fit adds some margin to account for fuzziness of
8332 its calculations) to call window.SetClientSize(child.GetSize())
8333 instead of calling Fit.
8334 """
8335 return _core_.Window_Fit(*args, **kwargs)
8336
8337 def FitInside(*args, **kwargs):
8338 """
8339 FitInside(self)
8340
8341 Similar to Fit, but sizes the interior (virtual) size of a
8342 window. Mainly useful with scrolled windows to reset scrollbars after
8343 sizing changes that do not trigger a size event, and/or scrolled
8344 windows without an interior sizer. This function similarly won't do
8345 anything if there are no subwindows.
8346 """
8347 return _core_.Window_FitInside(*args, **kwargs)
8348
03837c5c 8349 def SetSizeHints(*args, **kwargs):
d55e5bfc
RD
8350 """
8351 SetSizeHints(self, int minW, int minH, int maxW=-1, int maxH=-1, int incW=-1,
8352 int incH=-1)
d55e5bfc
RD
8353
8354 Allows specification of minimum and maximum window sizes, and window
8355 size increments. If a pair of values is not set (or set to -1), the
8356 default values will be used. If this function is called, the user
908b74cd
RD
8357 will not be able to size the window outside the given bounds (if it is
8358 a top-level window.) Sizers will also inspect the minimum window size
8359 and will use that value if set when calculating layout.
8360
8361 The resizing increments are only significant under Motif or Xt.
d55e5bfc 8362 """
03837c5c 8363 return _core_.Window_SetSizeHints(*args, **kwargs)
d55e5bfc 8364
03837c5c
RD
8365 def SetSizeHintsSz(*args, **kwargs):
8366 """
8367 SetSizeHintsSz(self, Size minSize, Size maxSize=DefaultSize, Size incSize=DefaultSize)
8368
8369 Allows specification of minimum and maximum window sizes, and window
8370 size increments. If a pair of values is not set (or set to -1), the
8371 default values will be used. If this function is called, the user
8372 will not be able to size the window outside the given bounds (if it is
8373 a top-level window.) Sizers will also inspect the minimum window size
8374 and will use that value if set when calculating layout.
8375
8376 The resizing increments are only significant under Motif or Xt.
8377 """
8378 return _core_.Window_SetSizeHintsSz(*args, **kwargs)
8379
8380 def SetVirtualSizeHints(*args, **kwargs):
d55e5bfc 8381 """
908b74cd 8382 SetVirtualSizeHints(self, int minW, int minH, int maxW=-1, int maxH=-1)
d55e5bfc
RD
8383
8384 Allows specification of minimum and maximum virtual window sizes. If a
8385 pair of values is not set (or set to -1), the default values will be
8386 used. If this function is called, the user will not be able to size
8387 the virtual area of the window outside the given bounds.
8388 """
03837c5c
RD
8389 return _core_.Window_SetVirtualSizeHints(*args, **kwargs)
8390
8391 def SetVirtualSizeHintsSz(*args, **kwargs):
8392 """
8393 SetVirtualSizeHintsSz(self, Size minSize, Size maxSize=DefaultSize)
8394
8395 Allows specification of minimum and maximum virtual window sizes. If a
8396 pair of values is not set (or set to -1), the default values will be
8397 used. If this function is called, the user will not be able to size
8398 the virtual area of the window outside the given bounds.
8399 """
8400 return _core_.Window_SetVirtualSizeHintsSz(*args, **kwargs)
d55e5bfc 8401
908b74cd
RD
8402 def GetMaxSize(*args, **kwargs):
8403 """GetMaxSize(self) -> Size"""
8404 return _core_.Window_GetMaxSize(*args, **kwargs)
8405
8406 def GetMinSize(*args, **kwargs):
8407 """GetMinSize(self) -> Size"""
8408 return _core_.Window_GetMinSize(*args, **kwargs)
8409
8410 def SetMinSize(*args, **kwargs):
8411 """
8412 SetMinSize(self, Size minSize)
8413
8414 A more convenient method than `SetSizeHints` for setting just the
8415 min size.
8416 """
8417 return _core_.Window_SetMinSize(*args, **kwargs)
8418
8419 def SetMaxSize(*args, **kwargs):
8420 """
8421 SetMaxSize(self, Size maxSize)
8422
8423 A more convenient method than `SetSizeHints` for setting just the
8424 max size.
8425 """
8426 return _core_.Window_SetMaxSize(*args, **kwargs)
8427
d55e5bfc
RD
8428 def GetMinWidth(*args, **kwargs):
8429 """GetMinWidth(self) -> int"""
8430 return _core_.Window_GetMinWidth(*args, **kwargs)
8431
8432 def GetMinHeight(*args, **kwargs):
8433 """GetMinHeight(self) -> int"""
8434 return _core_.Window_GetMinHeight(*args, **kwargs)
8435
8436 def GetMaxWidth(*args, **kwargs):
8437 """GetMaxWidth(self) -> int"""
8438 return _core_.Window_GetMaxWidth(*args, **kwargs)
8439
8440 def GetMaxHeight(*args, **kwargs):
8441 """GetMaxHeight(self) -> int"""
8442 return _core_.Window_GetMaxHeight(*args, **kwargs)
8443
d55e5bfc
RD
8444 def SetVirtualSize(*args, **kwargs):
8445 """
8446 SetVirtualSize(self, Size size)
8447
8448 Set the the virtual size of a window in pixels. For most windows this
8449 is just the client area of the window, but for some like scrolled
8450 windows it is more or less independent of the screen window size.
8451 """
8452 return _core_.Window_SetVirtualSize(*args, **kwargs)
8453
8454 def SetVirtualSizeWH(*args, **kwargs):
8455 """
8456 SetVirtualSizeWH(self, int w, int h)
8457
8458 Set the the virtual size of a window in pixels. For most windows this
8459 is just the client area of the window, but for some like scrolled
8460 windows it is more or less independent of the screen window size.
8461 """
8462 return _core_.Window_SetVirtualSizeWH(*args, **kwargs)
8463
8464 def GetVirtualSize(*args, **kwargs):
8465 """
8466 GetVirtualSize(self) -> Size
8467
8468 Get the the virtual size of the window in pixels. For most windows
8469 this is just the client area of the window, but for some like scrolled
8470 windows it is more or less independent of the screen window size.
8471 """
8472 return _core_.Window_GetVirtualSize(*args, **kwargs)
8473
8474 def GetVirtualSizeTuple(*args, **kwargs):
8475 """
8476 GetVirtualSizeTuple() -> (width, height)
8477
8478 Get the the virtual size of the window in pixels. For most windows
8479 this is just the client area of the window, but for some like scrolled
8480 windows it is more or less independent of the screen window size.
8481 """
8482 return _core_.Window_GetVirtualSizeTuple(*args, **kwargs)
8483
8484 def GetBestVirtualSize(*args, **kwargs):
8485 """
8486 GetBestVirtualSize(self) -> Size
8487
8488 Return the largest of ClientSize and BestSize (as determined by a
8489 sizer, interior children, or other means)
8490 """
8491 return _core_.Window_GetBestVirtualSize(*args, **kwargs)
8492
8493 def Show(*args, **kwargs):
8494 """
8495 Show(self, bool show=True) -> bool
8496
8497 Shows or hides the window. You may need to call Raise for a top level
8498 window if you want to bring it to top, although this is not needed if
8499 Show is called immediately after the frame creation. Returns True if
8500 the window has been shown or hidden or False if nothing was done
8501 because it already was in the requested state.
8502 """
8503 return _core_.Window_Show(*args, **kwargs)
8504
8505 def Hide(*args, **kwargs):
8506 """
8507 Hide(self) -> bool
8508
8509 Equivalent to calling Show(False).
8510 """
8511 return _core_.Window_Hide(*args, **kwargs)
8512
8513 def Enable(*args, **kwargs):
8514 """
8515 Enable(self, bool enable=True) -> bool
8516
8517 Enable or disable the window for user input. Note that when a parent
8518 window is disabled, all of its children are disabled as well and they
8519 are reenabled again when the parent is. Returns true if the window
8520 has been enabled or disabled, false if nothing was done, i.e. if the
8521 window had already been in the specified state.
8522 """
8523 return _core_.Window_Enable(*args, **kwargs)
8524
8525 def Disable(*args, **kwargs):
8526 """
8527 Disable(self) -> bool
8528
8529 Disables the window, same as Enable(false).
8530 """
8531 return _core_.Window_Disable(*args, **kwargs)
8532
8533 def IsShown(*args, **kwargs):
8534 """
8535 IsShown(self) -> bool
8536
8537 Returns true if the window is shown, false if it has been hidden.
8538 """
8539 return _core_.Window_IsShown(*args, **kwargs)
8540
8541 def IsEnabled(*args, **kwargs):
8542 """
8543 IsEnabled(self) -> bool
8544
8545 Returns true if the window is enabled for input, false otherwise.
8546 """
8547 return _core_.Window_IsEnabled(*args, **kwargs)
8548
8549 def SetWindowStyleFlag(*args, **kwargs):
8550 """
8551 SetWindowStyleFlag(self, long style)
8552
79fccf9d
RD
8553 Sets the style of the window. Please note that some styles cannot be
8554 changed after the window creation and that Refresh() might need to be
8555 called after changing the others for the change to take place
8556 immediately.
d55e5bfc
RD
8557 """
8558 return _core_.Window_SetWindowStyleFlag(*args, **kwargs)
8559
8560 def GetWindowStyleFlag(*args, **kwargs):
8561 """
8562 GetWindowStyleFlag(self) -> long
8563
8564 Gets the window style that was passed to the constructor or Create
8565 method.
8566 """
8567 return _core_.Window_GetWindowStyleFlag(*args, **kwargs)
8568
8569 SetWindowStyle = SetWindowStyleFlag; GetWindowStyle = GetWindowStyleFlag
8570 def HasFlag(*args, **kwargs):
8571 """
8572 HasFlag(self, int flag) -> bool
8573
8574 Test if the given style is set for this window.
8575 """
8576 return _core_.Window_HasFlag(*args, **kwargs)
8577
8578 def IsRetained(*args, **kwargs):
8579 """
8580 IsRetained(self) -> bool
8581
8582 Returns true if the window is retained, false otherwise. Retained
8583 windows are only available on X platforms.
8584 """
8585 return _core_.Window_IsRetained(*args, **kwargs)
8586
8587 def SetExtraStyle(*args, **kwargs):
8588 """
8589 SetExtraStyle(self, long exStyle)
8590
8591 Sets the extra style bits for the window. Extra styles are the less
8592 often used style bits which can't be set with the constructor or with
8593 SetWindowStyleFlag()
8594 """
8595 return _core_.Window_SetExtraStyle(*args, **kwargs)
8596
8597 def GetExtraStyle(*args, **kwargs):
8598 """
8599 GetExtraStyle(self) -> long
8600
8601 Returns the extra style bits for the window.
8602 """
8603 return _core_.Window_GetExtraStyle(*args, **kwargs)
8604
8605 def MakeModal(*args, **kwargs):
8606 """
8607 MakeModal(self, bool modal=True)
8608
8609 Disables all other windows in the application so that the user can
8610 only interact with this window. Passing False will reverse this
8611 effect.
8612 """
8613 return _core_.Window_MakeModal(*args, **kwargs)
8614
8615 def SetThemeEnabled(*args, **kwargs):
8616 """
8617 SetThemeEnabled(self, bool enableTheme)
8618
8619 This function tells a window if it should use the system's "theme"
8620 code to draw the windows' background instead if its own background
8621 drawing code. This will only have an effect on platforms that support
8622 the notion of themes in user defined windows. One such platform is
8623 GTK+ where windows can have (very colourful) backgrounds defined by a
8624 user's selected theme.
8625
8626 Dialogs, notebook pages and the status bar have this flag set to true
8627 by default so that the default look and feel is simulated best.
8628 """
8629 return _core_.Window_SetThemeEnabled(*args, **kwargs)
8630
8631 def GetThemeEnabled(*args, **kwargs):
8632 """
8633 GetThemeEnabled(self) -> bool
8634
8635 Return the themeEnabled flag.
8636 """
8637 return _core_.Window_GetThemeEnabled(*args, **kwargs)
8638
8639 def SetFocus(*args, **kwargs):
8640 """
8641 SetFocus(self)
8642
8643 Set's the focus to this window, allowing it to receive keyboard input.
8644 """
8645 return _core_.Window_SetFocus(*args, **kwargs)
8646
8647 def SetFocusFromKbd(*args, **kwargs):
8648 """
8649 SetFocusFromKbd(self)
8650
8651 Set focus to this window as the result of a keyboard action. Normally
8652 only called internally.
8653 """
8654 return _core_.Window_SetFocusFromKbd(*args, **kwargs)
8655
8656 def FindFocus(*args, **kwargs):
8657 """
c24da6d6 8658 FindFocus() -> Window
d55e5bfc
RD
8659
8660 Returns the window or control that currently has the keyboard focus,
8661 or None.
8662 """
8663 return _core_.Window_FindFocus(*args, **kwargs)
8664
8665 FindFocus = staticmethod(FindFocus)
8666 def AcceptsFocus(*args, **kwargs):
8667 """
8668 AcceptsFocus(self) -> bool
8669
8670 Can this window have focus?
8671 """
8672 return _core_.Window_AcceptsFocus(*args, **kwargs)
8673
8674 def AcceptsFocusFromKeyboard(*args, **kwargs):
8675 """
8676 AcceptsFocusFromKeyboard(self) -> bool
8677
8678 Can this window be given focus by keyboard navigation? if not, the
8679 only way to give it focus (provided it accepts it at all) is to click
8680 it.
8681 """
8682 return _core_.Window_AcceptsFocusFromKeyboard(*args, **kwargs)
8683
8684 def GetDefaultItem(*args, **kwargs):
8685 """
8686 GetDefaultItem(self) -> Window
8687
8688 Get the default child of this parent, i.e. the one which is activated
8689 by pressing <Enter> such as the OK button on a wx.Dialog.
8690 """
8691 return _core_.Window_GetDefaultItem(*args, **kwargs)
8692
8693 def SetDefaultItem(*args, **kwargs):
8694 """
8695 SetDefaultItem(self, Window child) -> Window
8696
8697 Set this child as default, return the old default.
8698 """
8699 return _core_.Window_SetDefaultItem(*args, **kwargs)
8700
8701 def SetTmpDefaultItem(*args, **kwargs):
8702 """
8703 SetTmpDefaultItem(self, Window win)
8704
8705 Set this child as temporary default
8706 """
8707 return _core_.Window_SetTmpDefaultItem(*args, **kwargs)
8708
908b74cd
RD
8709 def Navigate(*args, **kwargs):
8710 """
8711 Navigate(self, int flags=NavigationKeyEvent.IsForward) -> bool
8712
a8eff060
RD
8713 Does keyboard navigation from this window to another, by sending a
8714 `wx.NavigationKeyEvent`.
908b74cd
RD
8715 """
8716 return _core_.Window_Navigate(*args, **kwargs)
8717
bf26d883
RD
8718 def MoveAfterInTabOrder(*args, **kwargs):
8719 """
8720 MoveAfterInTabOrder(self, Window win)
8721
8722 Moves this window in the tab navigation order after the specified
8723 sibling window. This means that when the user presses the TAB key on
8724 that other window, the focus switches to this window.
8725
8726 The default tab order is the same as creation order. This function
8727 and `MoveBeforeInTabOrder` allow to change it after creating all the
8728 windows.
8729
8730 """
8731 return _core_.Window_MoveAfterInTabOrder(*args, **kwargs)
8732
8733 def MoveBeforeInTabOrder(*args, **kwargs):
8734 """
8735 MoveBeforeInTabOrder(self, Window win)
8736
8737 Same as `MoveAfterInTabOrder` except that it inserts this window just
8738 before win instead of putting it right after it.
8739 """
8740 return _core_.Window_MoveBeforeInTabOrder(*args, **kwargs)
8741
d55e5bfc
RD
8742 def GetChildren(*args, **kwargs):
8743 """
8744 GetChildren(self) -> PyObject
8745
8746 Returns a list of the window's children. NOTE: Currently this is a
8747 copy of the child window list maintained by the window, so the return
8748 value of this function is only valid as long as the window's children
8749 do not change.
8750 """
8751 return _core_.Window_GetChildren(*args, **kwargs)
8752
8753 def GetParent(*args, **kwargs):
8754 """
8755 GetParent(self) -> Window
8756
8757 Returns the parent window of this window, or None if there isn't one.
8758 """
8759 return _core_.Window_GetParent(*args, **kwargs)
8760
8761 def GetGrandParent(*args, **kwargs):
8762 """
8763 GetGrandParent(self) -> Window
8764
79fccf9d
RD
8765 Returns the parent of the parent of this window, or None if there
8766 isn't one.
d55e5bfc
RD
8767 """
8768 return _core_.Window_GetGrandParent(*args, **kwargs)
8769
8770 def IsTopLevel(*args, **kwargs):
8771 """
8772 IsTopLevel(self) -> bool
8773
8774 Returns true if the given window is a top-level one. Currently all
8775 frames and dialogs are always considered to be top-level windows (even
8776 if they have a parent window).
8777 """
8778 return _core_.Window_IsTopLevel(*args, **kwargs)
8779
8780 def Reparent(*args, **kwargs):
8781 """
8782 Reparent(self, Window newParent) -> bool
8783
8784 Reparents the window, i.e the window will be removed from its current
8785 parent window (e.g. a non-standard toolbar in a wxFrame) and then
8786 re-inserted into another. Available on Windows and GTK. Returns True
8787 if the parent was changed, False otherwise (error or newParent ==
8788 oldParent)
8789 """
8790 return _core_.Window_Reparent(*args, **kwargs)
8791
8792 def AddChild(*args, **kwargs):
8793 """
8794 AddChild(self, Window child)
8795
8796 Adds a child window. This is called automatically by window creation
8797 functions so should not be required by the application programmer.
8798 """
8799 return _core_.Window_AddChild(*args, **kwargs)
8800
8801 def RemoveChild(*args, **kwargs):
8802 """
8803 RemoveChild(self, Window child)
8804
8805 Removes a child window. This is called automatically by window
8806 deletion functions so should not be required by the application
8807 programmer.
8808 """
8809 return _core_.Window_RemoveChild(*args, **kwargs)
8810
8811 def FindWindowById(*args, **kwargs):
8812 """
8813 FindWindowById(self, long winid) -> Window
8814
8815 Find a chld of this window by window ID
8816 """
8817 return _core_.Window_FindWindowById(*args, **kwargs)
8818
8819 def FindWindowByName(*args, **kwargs):
8820 """
8821 FindWindowByName(self, String name) -> Window
8822
8823 Find a child of this window by name
8824 """
8825 return _core_.Window_FindWindowByName(*args, **kwargs)
8826
8827 def GetEventHandler(*args, **kwargs):
8828 """
8829 GetEventHandler(self) -> EvtHandler
8830
8831 Returns the event handler for this window. By default, the window is
8832 its own event handler.
8833 """
8834 return _core_.Window_GetEventHandler(*args, **kwargs)
8835
8836 def SetEventHandler(*args, **kwargs):
8837 """
8838 SetEventHandler(self, EvtHandler handler)
8839
8840 Sets the event handler for this window. An event handler is an object
8841 that is capable of processing the events sent to a window. By default,
8842 the window is its own event handler, but an application may wish to
8843 substitute another, for example to allow central implementation of
8844 event-handling for a variety of different window classes.
8845
79fccf9d 8846 It is usually better to use `wx.Window.PushEventHandler` since this sets
d55e5bfc
RD
8847 up a chain of event handlers, where an event not handled by one event
8848 handler is handed to the next one in the chain.
8849 """
8850 return _core_.Window_SetEventHandler(*args, **kwargs)
8851
8852 def PushEventHandler(*args, **kwargs):
8853 """
8854 PushEventHandler(self, EvtHandler handler)
8855
8856 Pushes this event handler onto the event handler stack for the window.
8857 An event handler is an object that is capable of processing the events
8858 sent to a window. By default, the window is its own event handler, but
8859 an application may wish to substitute another, for example to allow
8860 central implementation of event-handling for a variety of different
8861 window classes.
8862
8863 wx.Window.PushEventHandler allows an application to set up a chain of
8864 event handlers, where an event not handled by one event handler is
79fccf9d 8865 handed to the next one in the chain. Use `wx.Window.PopEventHandler` to
d55e5bfc
RD
8866 remove the event handler.
8867 """
8868 return _core_.Window_PushEventHandler(*args, **kwargs)
8869
8870 def PopEventHandler(*args, **kwargs):
8871 """
8872 PopEventHandler(self, bool deleteHandler=False) -> EvtHandler
8873
8874 Removes and returns the top-most event handler on the event handler
8875 stack. If deleteHandler is True then the wx.EvtHandler object will be
8876 destroyed after it is popped.
8877 """
8878 return _core_.Window_PopEventHandler(*args, **kwargs)
8879
8880 def RemoveEventHandler(*args, **kwargs):
8881 """
8882 RemoveEventHandler(self, EvtHandler handler) -> bool
8883
79fccf9d
RD
8884 Find the given handler in the event handler chain and remove (but not
8885 delete) it from the event handler chain, return True if it was found
8886 and False otherwise (this also results in an assert failure so this
8887 function should only be called when the handler is supposed to be
8888 there.)
d55e5bfc
RD
8889 """
8890 return _core_.Window_RemoveEventHandler(*args, **kwargs)
8891
8892 def SetValidator(*args, **kwargs):
8893 """
8894 SetValidator(self, Validator validator)
8895
8896 Deletes the current validator (if any) and sets the window validator,
8897 having called wx.Validator.Clone to create a new validator of this
8898 type.
8899 """
8900 return _core_.Window_SetValidator(*args, **kwargs)
8901
8902 def GetValidator(*args, **kwargs):
8903 """
8904 GetValidator(self) -> Validator
8905
8906 Returns a pointer to the current validator for the window, or None if
8907 there is none.
8908 """
8909 return _core_.Window_GetValidator(*args, **kwargs)
8910
8911 def Validate(*args, **kwargs):
8912 """
8913 Validate(self) -> bool
8914
8915 Validates the current values of the child controls using their
79fccf9d
RD
8916 validators. If the window has wx.WS_EX_VALIDATE_RECURSIVELY extra
8917 style flag set, the method will also call Validate() of all child
8918 windows. Returns false if any of the validations failed.
d55e5bfc
RD
8919 """
8920 return _core_.Window_Validate(*args, **kwargs)
8921
8922 def TransferDataToWindow(*args, **kwargs):
8923 """
8924 TransferDataToWindow(self) -> bool
8925
79fccf9d
RD
8926 Transfers values to child controls from data areas specified by their
8927 validators. If the window has wx.WS_EX_VALIDATE_RECURSIVELY extra
8928 style flag set, the method will also call TransferDataToWindow() of
8929 all child windows.
d55e5bfc
RD
8930 """
8931 return _core_.Window_TransferDataToWindow(*args, **kwargs)
8932
8933 def TransferDataFromWindow(*args, **kwargs):
8934 """
8935 TransferDataFromWindow(self) -> bool
8936
79fccf9d
RD
8937 Transfers values from child controls to data areas specified by their
8938 validators. Returns false if a transfer failed. If the window has
8939 wx.WS_EX_VALIDATE_RECURSIVELY extra style flag set, the method will
8940 also call TransferDataFromWindow() of all child windows.
d55e5bfc
RD
8941 """
8942 return _core_.Window_TransferDataFromWindow(*args, **kwargs)
8943
8944 def InitDialog(*args, **kwargs):
8945 """
8946 InitDialog(self)
8947
79fccf9d
RD
8948 Sends an EVT_INIT_DIALOG event, whose handler usually transfers data
8949 to the dialog via validators.
d55e5bfc
RD
8950 """
8951 return _core_.Window_InitDialog(*args, **kwargs)
8952
8953 def SetAcceleratorTable(*args, **kwargs):
8954 """
8955 SetAcceleratorTable(self, AcceleratorTable accel)
8956
8957 Sets the accelerator table for this window.
8958 """
8959 return _core_.Window_SetAcceleratorTable(*args, **kwargs)
8960
8961 def GetAcceleratorTable(*args, **kwargs):
8962 """
8963 GetAcceleratorTable(self) -> AcceleratorTable
8964
8965 Gets the accelerator table for this window.
8966 """
8967 return _core_.Window_GetAcceleratorTable(*args, **kwargs)
8968
8969 def RegisterHotKey(*args, **kwargs):
8970 """
8971 RegisterHotKey(self, int hotkeyId, int modifiers, int keycode) -> bool
8972
8973 Registers a system wide hotkey. Every time the user presses the hotkey
8974 registered here, this window will receive a hotkey event. It will
8975 receive the event even if the application is in the background and
8976 does not have the input focus because the user is working with some
8977 other application. To bind an event handler function to this hotkey
8978 use EVT_HOTKEY with an id equal to hotkeyId. Returns True if the
8979 hotkey was registered successfully.
8980 """
8981 return _core_.Window_RegisterHotKey(*args, **kwargs)
8982
8983 def UnregisterHotKey(*args, **kwargs):
8984 """
8985 UnregisterHotKey(self, int hotkeyId) -> bool
8986
8987 Unregisters a system wide hotkey.
8988 """
8989 return _core_.Window_UnregisterHotKey(*args, **kwargs)
8990
8991 def ConvertDialogPointToPixels(*args, **kwargs):
8992 """
8993 ConvertDialogPointToPixels(self, Point pt) -> Point
8994
8995 Converts a point or size from dialog units to pixels. Dialog units
8996 are used for maintaining a dialog's proportions even if the font
8997 changes. For the x dimension, the dialog units are multiplied by the
8998 average character width and then divided by 4. For the y dimension,
8999 the dialog units are multiplied by the average character height and
9000 then divided by 8.
9001 """
9002 return _core_.Window_ConvertDialogPointToPixels(*args, **kwargs)
9003
9004 def ConvertDialogSizeToPixels(*args, **kwargs):
9005 """
9006 ConvertDialogSizeToPixels(self, Size sz) -> Size
9007
9008 Converts a point or size from dialog units to pixels. Dialog units
9009 are used for maintaining a dialog's proportions even if the font
9010 changes. For the x dimension, the dialog units are multiplied by the
9011 average character width and then divided by 4. For the y dimension,
9012 the dialog units are multiplied by the average character height and
9013 then divided by 8.
9014 """
9015 return _core_.Window_ConvertDialogSizeToPixels(*args, **kwargs)
9016
9017 def DLG_PNT(*args, **kwargs):
9018 """
9019 DLG_PNT(self, Point pt) -> Point
9020
9021 Converts a point or size from dialog units to pixels. Dialog units
9022 are used for maintaining a dialog's proportions even if the font
9023 changes. For the x dimension, the dialog units are multiplied by the
9024 average character width and then divided by 4. For the y dimension,
9025 the dialog units are multiplied by the average character height and
9026 then divided by 8.
9027 """
9028 return _core_.Window_DLG_PNT(*args, **kwargs)
9029
9030 def DLG_SZE(*args, **kwargs):
9031 """
9032 DLG_SZE(self, Size sz) -> Size
9033
9034 Converts a point or size from dialog units to pixels. Dialog units
9035 are used for maintaining a dialog's proportions even if the font
9036 changes. For the x dimension, the dialog units are multiplied by the
9037 average character width and then divided by 4. For the y dimension,
9038 the dialog units are multiplied by the average character height and
9039 then divided by 8.
9040 """
9041 return _core_.Window_DLG_SZE(*args, **kwargs)
9042
9043 def ConvertPixelPointToDialog(*args, **kwargs):
9044 """ConvertPixelPointToDialog(self, Point pt) -> Point"""
9045 return _core_.Window_ConvertPixelPointToDialog(*args, **kwargs)
9046
9047 def ConvertPixelSizeToDialog(*args, **kwargs):
9048 """ConvertPixelSizeToDialog(self, Size sz) -> Size"""
9049 return _core_.Window_ConvertPixelSizeToDialog(*args, **kwargs)
9050
9051 def WarpPointer(*args, **kwargs):
9052 """
9053 WarpPointer(self, int x, int y)
9054
9055 Moves the pointer to the given position on the window.
9056
9057 NOTE: This function is not supported under Mac because Apple Human
9058 Interface Guidelines forbid moving the mouse cursor programmatically.
9059 """
9060 return _core_.Window_WarpPointer(*args, **kwargs)
9061
9062 def CaptureMouse(*args, **kwargs):
9063 """
9064 CaptureMouse(self)
9065
9066 Directs all mouse input to this window. Call wx.Window.ReleaseMouse to
9067 release the capture.
9068
9069 Note that wxWindows maintains the stack of windows having captured the
9070 mouse and when the mouse is released the capture returns to the window
9071 which had had captured it previously and it is only really released if
9072 there were no previous window. In particular, this means that you must
9073 release the mouse as many times as you capture it.
9074 """
9075 return _core_.Window_CaptureMouse(*args, **kwargs)
9076
9077 def ReleaseMouse(*args, **kwargs):
9078 """
9079 ReleaseMouse(self)
9080
9081 Releases mouse input captured with wx.Window.CaptureMouse.
9082 """
9083 return _core_.Window_ReleaseMouse(*args, **kwargs)
9084
9085 def GetCapture(*args, **kwargs):
9086 """
c24da6d6 9087 GetCapture() -> Window
d55e5bfc
RD
9088
9089 Returns the window which currently captures the mouse or None
9090 """
9091 return _core_.Window_GetCapture(*args, **kwargs)
9092
9093 GetCapture = staticmethod(GetCapture)
9094 def HasCapture(*args, **kwargs):
9095 """
9096 HasCapture(self) -> bool
9097
9098 Returns true if this window has the current mouse capture.
9099 """
9100 return _core_.Window_HasCapture(*args, **kwargs)
9101
9102 def Refresh(*args, **kwargs):
9103 """
9104 Refresh(self, bool eraseBackground=True, Rect rect=None)
9105
9106 Mark the specified rectangle (or the whole window) as "dirty" so it
9107 will be repainted. Causes an EVT_PAINT event to be generated and sent
9108 to the window.
9109 """
9110 return _core_.Window_Refresh(*args, **kwargs)
9111
9112 def RefreshRect(*args, **kwargs):
9113 """
fef4c27a 9114 RefreshRect(self, Rect rect, bool eraseBackground=True)
d55e5bfc
RD
9115
9116 Redraws the contents of the given rectangle: the area inside it will
9117 be repainted. This is the same as Refresh but has a nicer syntax.
9118 """
9119 return _core_.Window_RefreshRect(*args, **kwargs)
9120
9121 def Update(*args, **kwargs):
9122 """
9123 Update(self)
9124
9125 Calling this method immediately repaints the invalidated area of the
9126 window instead of waiting for the EVT_PAINT event to happen, (normally
9127 this would usually only happen when the flow of control returns to the
9128 event loop.) Notice that this function doesn't refresh the window and
9129 does nothing if the window has been already repainted. Use Refresh
9130 first if you want to immediately redraw the window (or some portion of
9131 it) unconditionally.
9132 """
9133 return _core_.Window_Update(*args, **kwargs)
9134
9135 def ClearBackground(*args, **kwargs):
9136 """
9137 ClearBackground(self)
9138
9139 Clears the window by filling it with the current background
9140 colour. Does not cause an erase background event to be generated.
9141 """
9142 return _core_.Window_ClearBackground(*args, **kwargs)
9143
9144 def Freeze(*args, **kwargs):
9145 """
9146 Freeze(self)
9147
79fccf9d
RD
9148 Freezes the window or, in other words, prevents any updates from
9149 taking place on screen, the window is not redrawn at all. Thaw must be
9150 called to reenable window redrawing. Calls to Freeze/Thaw may be
9151 nested, with the actual Thaw being delayed until all the nesting has
9152 been undone.
d55e5bfc
RD
9153
9154 This method is useful for visual appearance optimization (for example,
9155 it is a good idea to use it before inserting large amount of text into
9156 a wxTextCtrl under wxGTK) but is not implemented on all platforms nor
9157 for all controls so it is mostly just a hint to wxWindows and not a
9158 mandatory directive.
9159 """
9160 return _core_.Window_Freeze(*args, **kwargs)
9161
9162 def Thaw(*args, **kwargs):
9163 """
9164 Thaw(self)
9165
9166 Reenables window updating after a previous call to Freeze. Calls to
79fccf9d
RD
9167 Freeze/Thaw may be nested, so Thaw must be called the same number of
9168 times that Freeze was before the window will be updated.
d55e5bfc
RD
9169 """
9170 return _core_.Window_Thaw(*args, **kwargs)
9171
9172 def PrepareDC(*args, **kwargs):
9173 """
9174 PrepareDC(self, DC dc)
9175
9176 Call this function to prepare the device context for drawing a
9177 scrolled image. It sets the device origin according to the current
9178 scroll position.
9179 """
9180 return _core_.Window_PrepareDC(*args, **kwargs)
9181
9182 def GetUpdateRegion(*args, **kwargs):
9183 """
9184 GetUpdateRegion(self) -> Region
9185
9186 Returns the region specifying which parts of the window have been
9187 damaged. Should only be called within an EVT_PAINT handler.
9188 """
9189 return _core_.Window_GetUpdateRegion(*args, **kwargs)
9190
9191 def GetUpdateClientRect(*args, **kwargs):
9192 """
9193 GetUpdateClientRect(self) -> Rect
9194
9195 Get the update rectangle region bounding box in client coords.
9196 """
9197 return _core_.Window_GetUpdateClientRect(*args, **kwargs)
9198
9199 def IsExposed(*args, **kwargs):
9200 """
9201 IsExposed(self, int x, int y, int w=1, int h=1) -> bool
9202
9203 Returns true if the given point or rectangle area has been exposed
9204 since the last repaint. Call this in an paint event handler to
9205 optimize redrawing by only redrawing those areas, which have been
9206 exposed.
9207 """
9208 return _core_.Window_IsExposed(*args, **kwargs)
9209
9210 def IsExposedPoint(*args, **kwargs):
9211 """
9212 IsExposedPoint(self, Point pt) -> bool
9213
9214 Returns true if the given point or rectangle area has been exposed
9215 since the last repaint. Call this in an paint event handler to
9216 optimize redrawing by only redrawing those areas, which have been
9217 exposed.
9218 """
9219 return _core_.Window_IsExposedPoint(*args, **kwargs)
9220
9221 def IsExposedRect(*args, **kwargs):
9222 """
9223 IsExposedRect(self, Rect rect) -> bool
9224
9225 Returns true if the given point or rectangle area has been exposed
9226 since the last repaint. Call this in an paint event handler to
9227 optimize redrawing by only redrawing those areas, which have been
9228 exposed.
9229 """
9230 return _core_.Window_IsExposedRect(*args, **kwargs)
9231
9232 def GetDefaultAttributes(*args, **kwargs):
9233 """
9234 GetDefaultAttributes(self) -> VisualAttributes
9235
79fccf9d
RD
9236 Get the default attributes for an instance of this class. This is
9237 useful if you want to use the same font or colour in your own control
9238 as in a standard control -- which is a much better idea than hard
9239 coding specific colours or fonts which might look completely out of
caef1a4d 9240 place on the user's system, especially if it uses themes.
d55e5bfc
RD
9241 """
9242 return _core_.Window_GetDefaultAttributes(*args, **kwargs)
9243
9244 def GetClassDefaultAttributes(*args, **kwargs):
9245 """
c24da6d6 9246 GetClassDefaultAttributes(int variant=WINDOW_VARIANT_NORMAL) -> VisualAttributes
d55e5bfc 9247
79fccf9d
RD
9248 Get the default attributes for this class. This is useful if you want
9249 to use the same font or colour in your own control as in a standard
9250 control -- which is a much better idea than hard coding specific
caef1a4d
RD
9251 colours or fonts which might look completely out of place on the
9252 user's system, especially if it uses themes.
d55e5bfc
RD
9253
9254 The variant parameter is only relevant under Mac currently and is
79fccf9d 9255 ignore under other platforms. Under Mac, it will change the size of
caef1a4d
RD
9256 the returned font. See `wx.Window.SetWindowVariant` for more about
9257 this.
d55e5bfc
RD
9258 """
9259 return _core_.Window_GetClassDefaultAttributes(*args, **kwargs)
9260
9261 GetClassDefaultAttributes = staticmethod(GetClassDefaultAttributes)
9262 def SetBackgroundColour(*args, **kwargs):
9263 """
9264 SetBackgroundColour(self, Colour colour) -> bool
9265
9266 Sets the background colour of the window. Returns True if the colour
9267 was changed. The background colour is usually painted by the default
9268 EVT_ERASE_BACKGROUND event handler function under Windows and
f8167d6e
RD
9269 automatically under GTK. Using `wx.NullColour` will reset the window
9270 to the default background colour.
d55e5bfc 9271
caef1a4d 9272 Note that setting the background colour may not cause an immediate
f8167d6e 9273 refresh, so you may wish to call `ClearBackground` or `Refresh` after
d55e5bfc
RD
9274 calling this function.
9275
f8167d6e
RD
9276 Using this function will disable attempts to use themes for this
9277 window, if the system supports them. Use with care since usually the
9278 themes represent the appearance chosen by the user to be used for all
9279 applications on the system.
d55e5bfc
RD
9280 """
9281 return _core_.Window_SetBackgroundColour(*args, **kwargs)
9282
412d302d
RD
9283 def SetOwnBackgroundColour(*args, **kwargs):
9284 """SetOwnBackgroundColour(self, Colour colour)"""
9285 return _core_.Window_SetOwnBackgroundColour(*args, **kwargs)
d55e5bfc
RD
9286
9287 def SetForegroundColour(*args, **kwargs):
9288 """
9289 SetForegroundColour(self, Colour colour) -> bool
9290
9291 Sets the foreground colour of the window. Returns True is the colour
9292 was changed. The interpretation of foreground colour is dependent on
9293 the window class; it may be the text colour or other colour, or it may
9294 not be used at all.
9295 """
9296 return _core_.Window_SetForegroundColour(*args, **kwargs)
9297
fa47d7a7
VS
9298 def SetOwnForegroundColour(*args, **kwargs):
9299 """SetOwnForegroundColour(self, Colour colour)"""
9300 return _core_.Window_SetOwnForegroundColour(*args, **kwargs)
d55e5bfc
RD
9301
9302 def GetBackgroundColour(*args, **kwargs):
9303 """
9304 GetBackgroundColour(self) -> Colour
9305
9306 Returns the background colour of the window.
9307 """
9308 return _core_.Window_GetBackgroundColour(*args, **kwargs)
9309
9310 def GetForegroundColour(*args, **kwargs):
9311 """
9312 GetForegroundColour(self) -> Colour
9313
9314 Returns the foreground colour of the window. The interpretation of
9315 foreground colour is dependent on the window class; it may be the text
9316 colour or other colour, or it may not be used at all.
9317 """
9318 return _core_.Window_GetForegroundColour(*args, **kwargs)
9319
dcb8fc74
RD
9320 def InheritsBackgroundColour(*args, **kwargs):
9321 """InheritsBackgroundColour(self) -> bool"""
9322 return _core_.Window_InheritsBackgroundColour(*args, **kwargs)
9323
9324 def UseBgCol(*args, **kwargs):
9325 """UseBgCol(self) -> bool"""
9326 return _core_.Window_UseBgCol(*args, **kwargs)
9327
0f63ec68
RD
9328 def SetBackgroundStyle(*args, **kwargs):
9329 """
9330 SetBackgroundStyle(self, int style) -> bool
9331
9332 Returns the background style of the window. The background style
9333 indicates how the background of the window is drawn.
9334
9335 ====================== ========================================
9336 wx.BG_STYLE_SYSTEM The background colour or pattern should
9337 be determined by the system
9338 wx.BG_STYLE_COLOUR The background should be a solid colour
9339 wx.BG_STYLE_CUSTOM The background will be implemented by the
9340 application.
9341 ====================== ========================================
9342
9343 On GTK+, use of wx.BG_STYLE_CUSTOM allows the flicker-free drawing of
9344 a custom background, such as a tiled bitmap. Currently the style has
9345 no effect on other platforms.
9346
9347 :see: `GetBackgroundStyle`, `SetBackgroundColour`
9348 """
9349 return _core_.Window_SetBackgroundStyle(*args, **kwargs)
9350
9351 def GetBackgroundStyle(*args, **kwargs):
9352 """
9353 GetBackgroundStyle(self) -> int
9354
9355 Returns the background style of the window.
9356
9357 :see: `SetBackgroundStyle`
9358 """
9359 return _core_.Window_GetBackgroundStyle(*args, **kwargs)
9360
51b83b37
RD
9361 def HasTransparentBackground(*args, **kwargs):
9362 """
9363 HasTransparentBackground(self) -> bool
9364
9365 Returns True if this window's background is transparent (as, for
9366 example, for `wx.StaticText`) and should show the parent window's
9367 background.
9368
9369 This method is mostly used internally by the library itself and you
9370 normally shouldn't have to call it. You may, however, have to override
9371 it in your custom control classes to ensure that background is painted
9372 correctly.
9373 """
9374 return _core_.Window_HasTransparentBackground(*args, **kwargs)
9375
d55e5bfc
RD
9376 def SetCursor(*args, **kwargs):
9377 """
9378 SetCursor(self, Cursor cursor) -> bool
9379
9380 Sets the window's cursor. Notice that the window cursor also sets it
9381 for the children of the window implicitly.
9382
9383 The cursor may be wx.NullCursor in which case the window cursor will
9384 be reset back to default.
9385 """
9386 return _core_.Window_SetCursor(*args, **kwargs)
9387
9388 def GetCursor(*args, **kwargs):
9389 """
9390 GetCursor(self) -> Cursor
9391
9392 Return the cursor associated with this window.
9393 """
9394 return _core_.Window_GetCursor(*args, **kwargs)
9395
9396 def SetFont(*args, **kwargs):
9397 """
9398 SetFont(self, Font font) -> bool
9399
9400 Sets the font for this window.
9401 """
9402 return _core_.Window_SetFont(*args, **kwargs)
9403
fa47d7a7
VS
9404 def SetOwnFont(*args, **kwargs):
9405 """SetOwnFont(self, Font font)"""
9406 return _core_.Window_SetOwnFont(*args, **kwargs)
d55e5bfc
RD
9407
9408 def GetFont(*args, **kwargs):
9409 """
9410 GetFont(self) -> Font
9411
9412 Returns the default font used for this window.
9413 """
9414 return _core_.Window_GetFont(*args, **kwargs)
9415
9416 def SetCaret(*args, **kwargs):
9417 """
9418 SetCaret(self, Caret caret)
9419
9420 Sets the caret associated with the window.
9421 """
9422 return _core_.Window_SetCaret(*args, **kwargs)
9423
9424 def GetCaret(*args, **kwargs):
9425 """
9426 GetCaret(self) -> Caret
9427
9428 Returns the caret associated with the window.
9429 """
9430 return _core_.Window_GetCaret(*args, **kwargs)
9431
9432 def GetCharHeight(*args, **kwargs):
9433 """
9434 GetCharHeight(self) -> int
9435
9436 Get the (average) character size for the current font.
9437 """
9438 return _core_.Window_GetCharHeight(*args, **kwargs)
9439
9440 def GetCharWidth(*args, **kwargs):
9441 """
9442 GetCharWidth(self) -> int
9443
9444 Get the (average) character size for the current font.
9445 """
9446 return _core_.Window_GetCharWidth(*args, **kwargs)
9447
9448 def GetTextExtent(*args, **kwargs):
a8eff060
RD
9449 """
9450 GetTextExtent(String string) -> (width, height)
9451
9452 Get the width and height of the text using the current font.
9453 """
d55e5bfc
RD
9454 return _core_.Window_GetTextExtent(*args, **kwargs)
9455
9456 def GetFullTextExtent(*args, **kwargs):
9457 """
9458 GetFullTextExtent(String string, Font font=None) ->
9459 (width, height, descent, externalLeading)
9460
9461 Get the width, height, decent and leading of the text using the
9462 current or specified font.
9463 """
9464 return _core_.Window_GetFullTextExtent(*args, **kwargs)
9465
9466 def ClientToScreenXY(*args, **kwargs):
9467 """
9468 ClientToScreenXY(int x, int y) -> (x,y)
9469
9470 Converts to screen coordinates from coordinates relative to this window.
9471 """
9472 return _core_.Window_ClientToScreenXY(*args, **kwargs)
9473
9474 def ScreenToClientXY(*args, **kwargs):
9475 """
9476 ScreenToClientXY(int x, int y) -> (x,y)
9477
9478 Converts from screen to client window coordinates.
9479 """
9480 return _core_.Window_ScreenToClientXY(*args, **kwargs)
9481
9482 def ClientToScreen(*args, **kwargs):
9483 """
9484 ClientToScreen(self, Point pt) -> Point
9485
9486 Converts to screen coordinates from coordinates relative to this window.
9487 """
9488 return _core_.Window_ClientToScreen(*args, **kwargs)
9489
9490 def ScreenToClient(*args, **kwargs):
9491 """
9492 ScreenToClient(self, Point pt) -> Point
9493
9494 Converts from screen to client window coordinates.
9495 """
9496 return _core_.Window_ScreenToClient(*args, **kwargs)
9497
9498 def HitTestXY(*args, **kwargs):
9499 """
9500 HitTestXY(self, int x, int y) -> int
9501
9502 Test where the given (in client coords) point lies
9503 """
9504 return _core_.Window_HitTestXY(*args, **kwargs)
9505
9506 def HitTest(*args, **kwargs):
9507 """
9508 HitTest(self, Point pt) -> int
9509
9510 Test where the given (in client coords) point lies
9511 """
9512 return _core_.Window_HitTest(*args, **kwargs)
9513
9514 def GetBorder(*args):
9515 """
9516 GetBorder(self, long flags) -> int
9517 GetBorder(self) -> int
9518
9519 Get border for the flags of this window
9520 """
9521 return _core_.Window_GetBorder(*args)
9522
9523 def UpdateWindowUI(*args, **kwargs):
9524 """
9525 UpdateWindowUI(self, long flags=UPDATE_UI_NONE)
9526
9527 This function sends EVT_UPDATE_UI events to the window. The particular
9528 implementation depends on the window; for example a wx.ToolBar will
9529 send an update UI event for each toolbar button, and a wx.Frame will
9530 send an update UI event for each menubar menu item. You can call this
9531 function from your application to ensure that your UI is up-to-date at
9532 a particular point in time (as far as your EVT_UPDATE_UI handlers are
9533 concerned). This may be necessary if you have called
5ba5649b 9534 `wx.UpdateUIEvent.SetMode` or `wx.UpdateUIEvent.SetUpdateInterval` to
d55e5bfc
RD
9535 limit the overhead that wxWindows incurs by sending update UI events
9536 in idle time.
d55e5bfc
RD
9537 """
9538 return _core_.Window_UpdateWindowUI(*args, **kwargs)
9539
9540 def PopupMenuXY(*args, **kwargs):
9541 """
7a0b95b0 9542 PopupMenuXY(self, Menu menu, int x=-1, int y=-1) -> bool
d55e5bfc 9543
7a0b95b0
RD
9544 Pops up the given menu at the specified coordinates, relative to this window,
9545 and returns control when the user has dismissed the menu. If a menu item is
9546 selected, the corresponding menu event is generated and will be processed as
9547 usual. If the default position is given then the current position of the
9548 mouse cursor will be used.
d55e5bfc
RD
9549 """
9550 return _core_.Window_PopupMenuXY(*args, **kwargs)
9551
9552 def PopupMenu(*args, **kwargs):
9553 """
7a0b95b0 9554 PopupMenu(self, Menu menu, Point pos=DefaultPosition) -> bool
d55e5bfc 9555
7a0b95b0
RD
9556 Pops up the given menu at the specified coordinates, relative to this window,
9557 and returns control when the user has dismissed the menu. If a menu item is
9558 selected, the corresponding menu event is generated and will be processed as
9559 usual. If the default position is given then the current position of the
9560 mouse cursor will be used.
d55e5bfc
RD
9561 """
9562 return _core_.Window_PopupMenu(*args, **kwargs)
9563
9564 def GetHandle(*args, **kwargs):
9565 """
9566 GetHandle(self) -> long
9567
9568 Returns the platform-specific handle (as a long integer) of the
9569 physical window. Currently on wxMac it returns the handle of the
9570 toplevel parent of the window.
9571 """
9572 return _core_.Window_GetHandle(*args, **kwargs)
9573
629e65c2
RD
9574 def AssociateHandle(*args, **kwargs):
9575 """
9576 AssociateHandle(self, long handle)
9577
9578 Associate the window with a new native handle
9579 """
9580 return _core_.Window_AssociateHandle(*args, **kwargs)
9581
9582 def DissociateHandle(*args, **kwargs):
9583 """
9584 DissociateHandle(self)
9585
9586 Dissociate the current native handle from the window
9587 """
9588 return _core_.Window_DissociateHandle(*args, **kwargs)
9589
d55e5bfc
RD
9590 def OnPaint(*args, **kwargs):
9591 """OnPaint(self, PaintEvent event)"""
9592 return _core_.Window_OnPaint(*args, **kwargs)
9593
9594 def HasScrollbar(*args, **kwargs):
9595 """
9596 HasScrollbar(self, int orient) -> bool
9597
9598 Does the window have the scrollbar for this orientation?
9599 """
9600 return _core_.Window_HasScrollbar(*args, **kwargs)
9601
9602 def SetScrollbar(*args, **kwargs):
9603 """
79fccf9d 9604 SetScrollbar(self, int orientation, int position, int thumbSize, int range,
d55e5bfc
RD
9605 bool refresh=True)
9606
9607 Sets the scrollbar properties of a built-in scrollbar.
d55e5bfc
RD
9608 """
9609 return _core_.Window_SetScrollbar(*args, **kwargs)
9610
9611 def SetScrollPos(*args, **kwargs):
9612 """
9613 SetScrollPos(self, int orientation, int pos, bool refresh=True)
9614
9615 Sets the position of one of the built-in scrollbars.
9616 """
9617 return _core_.Window_SetScrollPos(*args, **kwargs)
9618
9619 def GetScrollPos(*args, **kwargs):
9620 """
9621 GetScrollPos(self, int orientation) -> int
9622
9623 Returns the built-in scrollbar position.
9624 """
9625 return _core_.Window_GetScrollPos(*args, **kwargs)
9626
9627 def GetScrollThumb(*args, **kwargs):
9628 """
9629 GetScrollThumb(self, int orientation) -> int
9630
9631 Returns the built-in scrollbar thumb size.
9632 """
9633 return _core_.Window_GetScrollThumb(*args, **kwargs)
9634
9635 def GetScrollRange(*args, **kwargs):
9636 """
9637 GetScrollRange(self, int orientation) -> int
9638
9639 Returns the built-in scrollbar range.
9640 """
9641 return _core_.Window_GetScrollRange(*args, **kwargs)
9642
9643 def ScrollWindow(*args, **kwargs):
9644 """
9645 ScrollWindow(self, int dx, int dy, Rect rect=None)
9646
9647 Physically scrolls the pixels in the window and move child windows
9648 accordingly. Use this function to optimise your scrolling
9649 implementations, to minimise the area that must be redrawn. Note that
9650 it is rarely required to call this function from a user program.
d55e5bfc
RD
9651 """
9652 return _core_.Window_ScrollWindow(*args, **kwargs)
9653
9654 def ScrollLines(*args, **kwargs):
9655 """
9656 ScrollLines(self, int lines) -> bool
9657
9658 If the platform and window class supports it, scrolls the window by
9659 the given number of lines down, if lines is positive, or up if lines
9660 is negative. Returns True if the window was scrolled, False if it was
9661 already on top/bottom and nothing was done.
9662 """
9663 return _core_.Window_ScrollLines(*args, **kwargs)
9664
9665 def ScrollPages(*args, **kwargs):
9666 """
9667 ScrollPages(self, int pages) -> bool
9668
79fccf9d 9669 If the platform and window class supports it, scrolls the window by
d55e5bfc
RD
9670 the given number of pages down, if pages is positive, or up if pages
9671 is negative. Returns True if the window was scrolled, False if it was
9672 already on top/bottom and nothing was done.
9673 """
9674 return _core_.Window_ScrollPages(*args, **kwargs)
9675
9676 def LineUp(*args, **kwargs):
9677 """
9678 LineUp(self) -> bool
9679
9680 This is just a wrapper for ScrollLines(-1).
9681 """
9682 return _core_.Window_LineUp(*args, **kwargs)
9683
9684 def LineDown(*args, **kwargs):
9685 """
9686 LineDown(self) -> bool
9687
9688 This is just a wrapper for ScrollLines(1).
9689 """
9690 return _core_.Window_LineDown(*args, **kwargs)
9691
9692 def PageUp(*args, **kwargs):
9693 """
9694 PageUp(self) -> bool
9695
9696 This is just a wrapper for ScrollPages(-1).
9697 """
9698 return _core_.Window_PageUp(*args, **kwargs)
9699
9700 def PageDown(*args, **kwargs):
9701 """
9702 PageDown(self) -> bool
9703
9704 This is just a wrapper for ScrollPages(1).
9705 """
9706 return _core_.Window_PageDown(*args, **kwargs)
9707
9708 def SetHelpText(*args, **kwargs):
9709 """
9710 SetHelpText(self, String text)
9711
9712 Sets the help text to be used as context-sensitive help for this
9713 window. Note that the text is actually stored by the current
9714 wxHelpProvider implementation, and not in the window object itself.
9715 """
9716 return _core_.Window_SetHelpText(*args, **kwargs)
9717
9718 def SetHelpTextForId(*args, **kwargs):
9719 """
9720 SetHelpTextForId(self, String text)
9721
9722 Associate this help text with all windows with the same id as this
9723 one.
9724 """
9725 return _core_.Window_SetHelpTextForId(*args, **kwargs)
9726
9727 def GetHelpText(*args, **kwargs):
9728 """
9729 GetHelpText(self) -> String
9730
9731 Gets the help text to be used as context-sensitive help for this
9732 window. Note that the text is actually stored by the current
9733 wxHelpProvider implementation, and not in the window object itself.
9734 """
9735 return _core_.Window_GetHelpText(*args, **kwargs)
9736
9737 def SetToolTipString(*args, **kwargs):
9738 """
9739 SetToolTipString(self, String tip)
9740
9741 Attach a tooltip to the window.
9742 """
9743 return _core_.Window_SetToolTipString(*args, **kwargs)
9744
9745 def SetToolTip(*args, **kwargs):
9746 """
9747 SetToolTip(self, ToolTip tip)
9748
9749 Attach a tooltip to the window.
9750 """
9751 return _core_.Window_SetToolTip(*args, **kwargs)
9752
9753 def GetToolTip(*args, **kwargs):
9754 """
9755 GetToolTip(self) -> ToolTip
9756
9757 get the associated tooltip or None if none
9758 """
9759 return _core_.Window_GetToolTip(*args, **kwargs)
9760
9761 def SetDropTarget(*args, **kwargs):
9762 """
9763 SetDropTarget(self, DropTarget dropTarget)
9764
9765 Associates a drop target with this window. If the window already has
9766 a drop target, it is deleted.
9767 """
9768 return _core_.Window_SetDropTarget(*args, **kwargs)
9769
9770 def GetDropTarget(*args, **kwargs):
9771 """
9772 GetDropTarget(self) -> DropTarget
9773
9774 Returns the associated drop target, which may be None.
9775 """
9776 return _core_.Window_GetDropTarget(*args, **kwargs)
9777
9778 def DragAcceptFiles(*args, **kwargs):
9779 """
9780 DragAcceptFiles(self, bool accept)
9781
9782 Enables or disables eligibility for drop file events, EVT_DROP_FILES.
5ba5649b 9783 Only functional on Windows.
d55e5bfc
RD
9784 """
9785 return _core_.Window_DragAcceptFiles(*args, **kwargs)
9786
9787 def SetConstraints(*args, **kwargs):
9788 """
9789 SetConstraints(self, LayoutConstraints constraints)
9790
9791 Sets the window to have the given layout constraints. If an existing
9792 layout constraints object is already owned by the window, it will be
9793 deleted. Pass None to disassociate and delete the window's current
9794 constraints.
9795
9796 You must call SetAutoLayout to tell a window to use the constraints
9797 automatically in its default EVT_SIZE handler; otherwise, you must
9798 handle EVT_SIZE yourself and call Layout() explicitly. When setting
9799 both a wx.LayoutConstraints and a wx.Sizer, only the sizer will have
9800 effect.
9801 """
9802 return _core_.Window_SetConstraints(*args, **kwargs)
9803
9804 def GetConstraints(*args, **kwargs):
9805 """
9806 GetConstraints(self) -> LayoutConstraints
9807
9808 Returns a pointer to the window's layout constraints, or None if there
9809 are none.
9810 """
9811 return _core_.Window_GetConstraints(*args, **kwargs)
9812
9813 def SetAutoLayout(*args, **kwargs):
9814 """
9815 SetAutoLayout(self, bool autoLayout)
9816
9817 Determines whether the Layout function will be called automatically
9818 when the window is resized. It is called implicitly by SetSizer but
9819 if you use SetConstraints you should call it manually or otherwise the
9820 window layout won't be correctly updated when its size changes.
9821 """
9822 return _core_.Window_SetAutoLayout(*args, **kwargs)
9823
9824 def GetAutoLayout(*args, **kwargs):
9825 """
9826 GetAutoLayout(self) -> bool
9827
9828 Returns the current autoLayout setting
9829 """
9830 return _core_.Window_GetAutoLayout(*args, **kwargs)
9831
9832 def Layout(*args, **kwargs):
9833 """
9834 Layout(self) -> bool
9835
9836 Invokes the constraint-based layout algorithm or the sizer-based
9837 algorithm for this window. See SetAutoLayout: when auto layout is on,
9838 this function gets called automatically by the default EVT_SIZE
9839 handler when the window is resized.
9840 """
9841 return _core_.Window_Layout(*args, **kwargs)
9842
9843 def SetSizer(*args, **kwargs):
9844 """
9845 SetSizer(self, Sizer sizer, bool deleteOld=True)
9846
9847 Sets the window to have the given layout sizer. The window will then
9848 own the object, and will take care of its deletion. If an existing
9849 layout sizer object is already owned by the window, it will be deleted
9850 if the deleteOld parameter is true. Note that this function will also
9851 call SetAutoLayout implicitly with a True parameter if the sizer is
ae8162c8 9852 non-None, and False otherwise.
d55e5bfc
RD
9853 """
9854 return _core_.Window_SetSizer(*args, **kwargs)
9855
9856 def SetSizerAndFit(*args, **kwargs):
9857 """
9858 SetSizerAndFit(self, Sizer sizer, bool deleteOld=True)
9859
9860 The same as SetSizer, except it also sets the size hints for the
9861 window based on the sizer's minimum size.
9862 """
9863 return _core_.Window_SetSizerAndFit(*args, **kwargs)
9864
9865 def GetSizer(*args, **kwargs):
9866 """
9867 GetSizer(self) -> Sizer
9868
9869 Return the sizer associated with the window by a previous call to
9870 SetSizer or None if there isn't one.
9871 """
9872 return _core_.Window_GetSizer(*args, **kwargs)
9873
9874 def SetContainingSizer(*args, **kwargs):
9875 """
9876 SetContainingSizer(self, Sizer sizer)
9877
9878 This normally does not need to be called by application code. It is
9879 called internally when a window is added to a sizer, and is used so
9880 the window can remove itself from the sizer when it is destroyed.
9881 """
9882 return _core_.Window_SetContainingSizer(*args, **kwargs)
9883
9884 def GetContainingSizer(*args, **kwargs):
9885 """
9886 GetContainingSizer(self) -> Sizer
9887
9888 Return the sizer that this window is a member of, if any, otherwise None.
9889 """
9890 return _core_.Window_GetContainingSizer(*args, **kwargs)
9891
9892 def InheritAttributes(*args, **kwargs):
9893 """
9894 InheritAttributes(self)
9895
79fccf9d
RD
9896 This function is (or should be, in case of custom controls) called
9897 during window creation to intelligently set up the window visual
9898 attributes, that is the font and the foreground and background
9899 colours.
9900
9901 By 'intelligently' the following is meant: by default, all windows use
9902 their own default attributes. However if some of the parent's
9903 attributes are explicitly changed (that is, using SetFont and not
fa47d7a7 9904 SetOwnFont) and if the corresponding attribute hadn't been
79fccf9d
RD
9905 explicitly set for this window itself, then this window takes the same
9906 value as used by the parent. In addition, if the window overrides
9907 ShouldInheritColours to return false, the colours will not be changed
9908 no matter what and only the font might.
9909
ec9b55ca
RD
9910 This rather complicated logic is necessary in order to accommodate the
9911 different usage scenarios. The most common one is when all default
79fccf9d
RD
9912 attributes are used and in this case, nothing should be inherited as
9913 in modern GUIs different controls use different fonts (and colours)
9914 than their siblings so they can't inherit the same value from the
9915 parent. However it was also deemed desirable to allow to simply change
9916 the attributes of all children at once by just changing the font or
9917 colour of their common parent, hence in this case we do inherit the
9918 parents attributes.
9919
d55e5bfc
RD
9920 """
9921 return _core_.Window_InheritAttributes(*args, **kwargs)
9922
9923 def ShouldInheritColours(*args, **kwargs):
9924 """
9925 ShouldInheritColours(self) -> bool
9926
9927 Return true from here to allow the colours of this window to be
79fccf9d
RD
9928 changed by InheritAttributes, returning false forbids inheriting them
9929 from the parent window.
d55e5bfc 9930
79fccf9d
RD
9931 The base class version returns false, but this method is overridden in
9932 wxControl where it returns true.
d55e5bfc
RD
9933 """
9934 return _core_.Window_ShouldInheritColours(*args, **kwargs)
9935
9936 def PostCreate(self, pre):
9937 """
9938 Phase 3 of the 2-phase create <wink!>
9939 Call this method after precreating the window with the 2-phase create method.
9940 """
9941 self.this = pre.this
9942 self.thisown = pre.thisown
9943 pre.thisown = 0
9944 if hasattr(self, '_setOORInfo'):
9945 self._setOORInfo(self)
9946 if hasattr(self, '_setCallbackInfo'):
9947 self._setCallbackInfo(self, self.__class__)
9948
9949
9950class WindowPtr(Window):
9951 def __init__(self, this):
9952 self.this = this
9953 if not hasattr(self,"thisown"): self.thisown = 0
9954 self.__class__ = Window
9955_core_.Window_swigregister(WindowPtr)
9956
9957def PreWindow(*args, **kwargs):
9958 """
9959 PreWindow() -> Window
9960
9961 Precreate a Window for 2-phase creation.
9962 """
9963 val = _core_.new_PreWindow(*args, **kwargs)
9964 val.thisown = 1
9965 return val
9966
9967def Window_NewControlId(*args, **kwargs):
9968 """
9969 Window_NewControlId() -> int
9970
9971 Generate a control id for the controls which were not given one.
9972 """
9973 return _core_.Window_NewControlId(*args, **kwargs)
9974
9975def Window_NextControlId(*args, **kwargs):
9976 """
9977 Window_NextControlId(int winid) -> int
9978
9979 Get the id of the control following the one with the given
79fccf9d 9980 autogenerated) id
d55e5bfc
RD
9981 """
9982 return _core_.Window_NextControlId(*args, **kwargs)
9983
9984def Window_PrevControlId(*args, **kwargs):
9985 """
9986 Window_PrevControlId(int winid) -> int
9987
9988 Get the id of the control preceding the one with the given
79fccf9d 9989 autogenerated) id
d55e5bfc
RD
9990 """
9991 return _core_.Window_PrevControlId(*args, **kwargs)
9992
9993def Window_FindFocus(*args, **kwargs):
9994 """
9995 Window_FindFocus() -> Window
9996
9997 Returns the window or control that currently has the keyboard focus,
9998 or None.
9999 """
10000 return _core_.Window_FindFocus(*args, **kwargs)
10001
10002def Window_GetCapture(*args, **kwargs):
10003 """
10004 Window_GetCapture() -> Window
10005
10006 Returns the window which currently captures the mouse or None
10007 """
10008 return _core_.Window_GetCapture(*args, **kwargs)
10009
10010def Window_GetClassDefaultAttributes(*args, **kwargs):
10011 """
10012 Window_GetClassDefaultAttributes(int variant=WINDOW_VARIANT_NORMAL) -> VisualAttributes
10013
79fccf9d
RD
10014 Get the default attributes for this class. This is useful if you want
10015 to use the same font or colour in your own control as in a standard
10016 control -- which is a much better idea than hard coding specific
caef1a4d
RD
10017 colours or fonts which might look completely out of place on the
10018 user's system, especially if it uses themes.
d55e5bfc
RD
10019
10020 The variant parameter is only relevant under Mac currently and is
79fccf9d 10021 ignore under other platforms. Under Mac, it will change the size of
caef1a4d
RD
10022 the returned font. See `wx.Window.SetWindowVariant` for more about
10023 this.
d55e5bfc
RD
10024 """
10025 return _core_.Window_GetClassDefaultAttributes(*args, **kwargs)
10026
10027def DLG_PNT(win, point_or_x, y=None):
10028 """
10029 Convenience function for converting a Point or (x,y) in
10030 dialog units to pixel units.
10031 """
10032 if y is None:
10033 return win.ConvertDialogPointToPixels(point_or_x)
10034 else:
10035 return win.ConvertDialogPointToPixels(wx.Point(point_or_x, y))
10036
10037def DLG_SZE(win, size_width, height=None):
10038 """
10039 Convenience function for converting a Size or (w,h) in
10040 dialog units to pixel units.
10041 """
10042 if height is None:
10043 return win.ConvertDialogSizeToPixels(size_width)
10044 else:
10045 return win.ConvertDialogSizeToPixels(wx.Size(size_width, height))
10046
10047
10048def FindWindowById(*args, **kwargs):
10049 """
10050 FindWindowById(long id, Window parent=None) -> Window
10051
10052 Find the first window in the application with the given id. If parent
10053 is None, the search will start from all top-level frames and dialog
10054 boxes; if non-None, the search will be limited to the given window
10055 hierarchy. The search is recursive in both cases.
10056 """
10057 return _core_.FindWindowById(*args, **kwargs)
10058
10059def FindWindowByName(*args, **kwargs):
10060 """
10061 FindWindowByName(String name, Window parent=None) -> Window
10062
10063 Find a window by its name (as given in a window constructor or Create
10064 function call). If parent is None, the search will start from all
10065 top-level frames and dialog boxes; if non-None, the search will be
10066 limited to the given window hierarchy. The search is recursive in both
10067 cases.
10068
10069 If no window with such name is found, wx.FindWindowByLabel is called.
10070 """
10071 return _core_.FindWindowByName(*args, **kwargs)
10072
10073def FindWindowByLabel(*args, **kwargs):
10074 """
10075 FindWindowByLabel(String label, Window parent=None) -> Window
10076
10077 Find a window by its label. Depending on the type of window, the label
10078 may be a window title or panel item label. If parent is None, the
10079 search will start from all top-level frames and dialog boxes; if
10080 non-None, the search will be limited to the given window
10081 hierarchy. The search is recursive in both cases.
10082 """
10083 return _core_.FindWindowByLabel(*args, **kwargs)
10084
10085def Window_FromHWND(*args, **kwargs):
10086 """Window_FromHWND(Window parent, unsigned long _hWnd) -> Window"""
10087 return _core_.Window_FromHWND(*args, **kwargs)
3215336e
RD
10088
10089def GetTopLevelWindows(*args, **kwargs):
10090 """
10091 GetTopLevelWindows() -> PyObject
10092
10093 Returns a list of the the application's top-level windows, (frames,
10094 dialogs, etc.) NOTE: Currently this is a copy of the list maintained
10095 by wxWidgets, and so it is only valid as long as no top-level windows
10096 are closed or new top-level windows are created.
10097
10098 """
10099 return _core_.GetTopLevelWindows(*args, **kwargs)
d55e5bfc
RD
10100#---------------------------------------------------------------------------
10101
10102class Validator(EvtHandler):
093d3ff1 10103 """Proxy of C++ Validator class"""
d55e5bfc
RD
10104 def __repr__(self):
10105 return "<%s.%s; proxy of C++ wxValidator instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
10106 def __init__(self, *args, **kwargs):
10107 """__init__(self) -> Validator"""
10108 newobj = _core_.new_Validator(*args, **kwargs)
10109 self.this = newobj.this
10110 self.thisown = 1
10111 del newobj.thisown
10112 self._setOORInfo(self)
10113
10114 def Clone(*args, **kwargs):
10115 """Clone(self) -> Validator"""
10116 return _core_.Validator_Clone(*args, **kwargs)
10117
10118 def Validate(*args, **kwargs):
10119 """Validate(self, Window parent) -> bool"""
10120 return _core_.Validator_Validate(*args, **kwargs)
10121
10122 def TransferToWindow(*args, **kwargs):
10123 """TransferToWindow(self) -> bool"""
10124 return _core_.Validator_TransferToWindow(*args, **kwargs)
10125
10126 def TransferFromWindow(*args, **kwargs):
10127 """TransferFromWindow(self) -> bool"""
10128 return _core_.Validator_TransferFromWindow(*args, **kwargs)
10129
10130 def GetWindow(*args, **kwargs):
10131 """GetWindow(self) -> Window"""
10132 return _core_.Validator_GetWindow(*args, **kwargs)
10133
10134 def SetWindow(*args, **kwargs):
10135 """SetWindow(self, Window window)"""
10136 return _core_.Validator_SetWindow(*args, **kwargs)
10137
10138 def IsSilent(*args, **kwargs):
c24da6d6 10139 """IsSilent() -> bool"""
d55e5bfc
RD
10140 return _core_.Validator_IsSilent(*args, **kwargs)
10141
10142 IsSilent = staticmethod(IsSilent)
10143 def SetBellOnError(*args, **kwargs):
c24da6d6 10144 """SetBellOnError(int doIt=True)"""
d55e5bfc
RD
10145 return _core_.Validator_SetBellOnError(*args, **kwargs)
10146
10147 SetBellOnError = staticmethod(SetBellOnError)
10148
10149class ValidatorPtr(Validator):
10150 def __init__(self, this):
10151 self.this = this
10152 if not hasattr(self,"thisown"): self.thisown = 0
10153 self.__class__ = Validator
10154_core_.Validator_swigregister(ValidatorPtr)
10155
10156def Validator_IsSilent(*args, **kwargs):
10157 """Validator_IsSilent() -> bool"""
10158 return _core_.Validator_IsSilent(*args, **kwargs)
10159
10160def Validator_SetBellOnError(*args, **kwargs):
10161 """Validator_SetBellOnError(int doIt=True)"""
10162 return _core_.Validator_SetBellOnError(*args, **kwargs)
10163
10164class PyValidator(Validator):
093d3ff1 10165 """Proxy of C++ PyValidator class"""
d55e5bfc
RD
10166 def __repr__(self):
10167 return "<%s.%s; proxy of C++ wxPyValidator instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
10168 def __init__(self, *args, **kwargs):
10169 """__init__(self) -> PyValidator"""
10170 newobj = _core_.new_PyValidator(*args, **kwargs)
10171 self.this = newobj.this
10172 self.thisown = 1
10173 del newobj.thisown
10174
10175 self._setCallbackInfo(self, PyValidator, 1)
10176 self._setOORInfo(self)
10177
10178 def _setCallbackInfo(*args, **kwargs):
10179 """_setCallbackInfo(self, PyObject self, PyObject _class, int incref=True)"""
10180 return _core_.PyValidator__setCallbackInfo(*args, **kwargs)
10181
10182
10183class PyValidatorPtr(PyValidator):
10184 def __init__(self, this):
10185 self.this = this
10186 if not hasattr(self,"thisown"): self.thisown = 0
10187 self.__class__ = PyValidator
10188_core_.PyValidator_swigregister(PyValidatorPtr)
10189
10190#---------------------------------------------------------------------------
10191
10192class Menu(EvtHandler):
093d3ff1 10193 """Proxy of C++ Menu class"""
d55e5bfc
RD
10194 def __repr__(self):
10195 return "<%s.%s; proxy of C++ wxMenu instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
10196 def __init__(self, *args, **kwargs):
10197 """__init__(self, String title=EmptyString, long style=0) -> Menu"""
10198 newobj = _core_.new_Menu(*args, **kwargs)
10199 self.this = newobj.this
10200 self.thisown = 1
10201 del newobj.thisown
10202 self._setOORInfo(self)
10203
10204 def Append(*args, **kwargs):
10205 """Append(self, int id, String text, String help=EmptyString, int kind=ITEM_NORMAL) -> MenuItem"""
10206 return _core_.Menu_Append(*args, **kwargs)
10207
10208 def AppendSeparator(*args, **kwargs):
10209 """AppendSeparator(self) -> MenuItem"""
10210 return _core_.Menu_AppendSeparator(*args, **kwargs)
10211
10212 def AppendCheckItem(*args, **kwargs):
10213 """AppendCheckItem(self, int id, String text, String help=EmptyString) -> MenuItem"""
10214 return _core_.Menu_AppendCheckItem(*args, **kwargs)
10215
10216 def AppendRadioItem(*args, **kwargs):
10217 """AppendRadioItem(self, int id, String text, String help=EmptyString) -> MenuItem"""
10218 return _core_.Menu_AppendRadioItem(*args, **kwargs)
10219
10220 def AppendMenu(*args, **kwargs):
10221 """AppendMenu(self, int id, String text, Menu submenu, String help=EmptyString) -> MenuItem"""
10222 return _core_.Menu_AppendMenu(*args, **kwargs)
10223
10224 def AppendItem(*args, **kwargs):
10225 """AppendItem(self, MenuItem item) -> MenuItem"""
10226 return _core_.Menu_AppendItem(*args, **kwargs)
10227
10228 def Break(*args, **kwargs):
10229 """Break(self)"""
10230 return _core_.Menu_Break(*args, **kwargs)
10231
10232 def InsertItem(*args, **kwargs):
10233 """InsertItem(self, size_t pos, MenuItem item) -> MenuItem"""
10234 return _core_.Menu_InsertItem(*args, **kwargs)
10235
10236 def Insert(*args, **kwargs):
10237 """
10238 Insert(self, size_t pos, int id, String text, String help=EmptyString,
10239 int kind=ITEM_NORMAL) -> MenuItem
10240 """
10241 return _core_.Menu_Insert(*args, **kwargs)
10242
10243 def InsertSeparator(*args, **kwargs):
10244 """InsertSeparator(self, size_t pos) -> MenuItem"""
10245 return _core_.Menu_InsertSeparator(*args, **kwargs)
10246
10247 def InsertCheckItem(*args, **kwargs):
10248 """InsertCheckItem(self, size_t pos, int id, String text, String help=EmptyString) -> MenuItem"""
10249 return _core_.Menu_InsertCheckItem(*args, **kwargs)
10250
10251 def InsertRadioItem(*args, **kwargs):
10252 """InsertRadioItem(self, size_t pos, int id, String text, String help=EmptyString) -> MenuItem"""
10253 return _core_.Menu_InsertRadioItem(*args, **kwargs)
10254
10255 def InsertMenu(*args, **kwargs):
10256 """InsertMenu(self, size_t pos, int id, String text, Menu submenu, String help=EmptyString) -> MenuItem"""
10257 return _core_.Menu_InsertMenu(*args, **kwargs)
10258
10259 def PrependItem(*args, **kwargs):
10260 """PrependItem(self, MenuItem item) -> MenuItem"""
10261 return _core_.Menu_PrependItem(*args, **kwargs)
10262
10263 def Prepend(*args, **kwargs):
10264 """Prepend(self, int id, String text, String help=EmptyString, int kind=ITEM_NORMAL) -> MenuItem"""
10265 return _core_.Menu_Prepend(*args, **kwargs)
10266
10267 def PrependSeparator(*args, **kwargs):
10268 """PrependSeparator(self) -> MenuItem"""
10269 return _core_.Menu_PrependSeparator(*args, **kwargs)
10270
10271 def PrependCheckItem(*args, **kwargs):
10272 """PrependCheckItem(self, int id, String text, String help=EmptyString) -> MenuItem"""
10273 return _core_.Menu_PrependCheckItem(*args, **kwargs)
10274
10275 def PrependRadioItem(*args, **kwargs):
10276 """PrependRadioItem(self, int id, String text, String help=EmptyString) -> MenuItem"""
10277 return _core_.Menu_PrependRadioItem(*args, **kwargs)
10278
10279 def PrependMenu(*args, **kwargs):
10280 """PrependMenu(self, int id, String text, Menu submenu, String help=EmptyString) -> MenuItem"""
10281 return _core_.Menu_PrependMenu(*args, **kwargs)
10282
10283 def Remove(*args, **kwargs):
10284 """Remove(self, int id) -> MenuItem"""
10285 return _core_.Menu_Remove(*args, **kwargs)
10286
10287 def RemoveItem(*args, **kwargs):
10288 """RemoveItem(self, MenuItem item) -> MenuItem"""
10289 return _core_.Menu_RemoveItem(*args, **kwargs)
10290
10291 def Delete(*args, **kwargs):
10292 """Delete(self, int id) -> bool"""
10293 return _core_.Menu_Delete(*args, **kwargs)
10294
10295 def DeleteItem(*args, **kwargs):
10296 """DeleteItem(self, MenuItem item) -> bool"""
10297 return _core_.Menu_DeleteItem(*args, **kwargs)
10298
10299 def Destroy(*args, **kwargs):
10300 """
10301 Destroy(self)
10302
10303 Deletes the C++ object this Python object is a proxy for.
10304 """
10305 return _core_.Menu_Destroy(*args, **kwargs)
10306
10307 def DestroyId(*args, **kwargs):
10308 """
10309 DestroyId(self, int id) -> bool
10310
10311 Deletes the C++ object this Python object is a proxy for.
10312 """
10313 return _core_.Menu_DestroyId(*args, **kwargs)
10314
10315 def DestroyItem(*args, **kwargs):
10316 """
10317 DestroyItem(self, MenuItem item) -> bool
10318
10319 Deletes the C++ object this Python object is a proxy for.
10320 """
10321 return _core_.Menu_DestroyItem(*args, **kwargs)
10322
10323 def GetMenuItemCount(*args, **kwargs):
10324 """GetMenuItemCount(self) -> size_t"""
10325 return _core_.Menu_GetMenuItemCount(*args, **kwargs)
10326
10327 def GetMenuItems(*args, **kwargs):
10328 """GetMenuItems(self) -> PyObject"""
10329 return _core_.Menu_GetMenuItems(*args, **kwargs)
10330
10331 def FindItem(*args, **kwargs):
10332 """FindItem(self, String item) -> int"""
10333 return _core_.Menu_FindItem(*args, **kwargs)
10334
10335 def FindItemById(*args, **kwargs):
10336 """FindItemById(self, int id) -> MenuItem"""
10337 return _core_.Menu_FindItemById(*args, **kwargs)
10338
10339 def FindItemByPosition(*args, **kwargs):
10340 """FindItemByPosition(self, size_t position) -> MenuItem"""
10341 return _core_.Menu_FindItemByPosition(*args, **kwargs)
10342
10343 def Enable(*args, **kwargs):
10344 """Enable(self, int id, bool enable)"""
10345 return _core_.Menu_Enable(*args, **kwargs)
10346
10347 def IsEnabled(*args, **kwargs):
10348 """IsEnabled(self, int id) -> bool"""
10349 return _core_.Menu_IsEnabled(*args, **kwargs)
10350
10351 def Check(*args, **kwargs):
10352 """Check(self, int id, bool check)"""
10353 return _core_.Menu_Check(*args, **kwargs)
10354
10355 def IsChecked(*args, **kwargs):
10356 """IsChecked(self, int id) -> bool"""
10357 return _core_.Menu_IsChecked(*args, **kwargs)
10358
10359 def SetLabel(*args, **kwargs):
10360 """SetLabel(self, int id, String label)"""
10361 return _core_.Menu_SetLabel(*args, **kwargs)
10362
10363 def GetLabel(*args, **kwargs):
10364 """GetLabel(self, int id) -> String"""
10365 return _core_.Menu_GetLabel(*args, **kwargs)
10366
10367 def SetHelpString(*args, **kwargs):
10368 """SetHelpString(self, int id, String helpString)"""
10369 return _core_.Menu_SetHelpString(*args, **kwargs)
10370
10371 def GetHelpString(*args, **kwargs):
10372 """GetHelpString(self, int id) -> String"""
10373 return _core_.Menu_GetHelpString(*args, **kwargs)
10374
10375 def SetTitle(*args, **kwargs):
10376 """SetTitle(self, String title)"""
10377 return _core_.Menu_SetTitle(*args, **kwargs)
10378
10379 def GetTitle(*args, **kwargs):
10380 """GetTitle(self) -> String"""
10381 return _core_.Menu_GetTitle(*args, **kwargs)
10382
10383 def SetEventHandler(*args, **kwargs):
10384 """SetEventHandler(self, EvtHandler handler)"""
10385 return _core_.Menu_SetEventHandler(*args, **kwargs)
10386
10387 def GetEventHandler(*args, **kwargs):
10388 """GetEventHandler(self) -> EvtHandler"""
10389 return _core_.Menu_GetEventHandler(*args, **kwargs)
10390
10391 def SetInvokingWindow(*args, **kwargs):
10392 """SetInvokingWindow(self, Window win)"""
10393 return _core_.Menu_SetInvokingWindow(*args, **kwargs)
10394
10395 def GetInvokingWindow(*args, **kwargs):
10396 """GetInvokingWindow(self) -> Window"""
10397 return _core_.Menu_GetInvokingWindow(*args, **kwargs)
10398
10399 def GetStyle(*args, **kwargs):
10400 """GetStyle(self) -> long"""
10401 return _core_.Menu_GetStyle(*args, **kwargs)
10402
10403 def UpdateUI(*args, **kwargs):
10404 """UpdateUI(self, EvtHandler source=None)"""
10405 return _core_.Menu_UpdateUI(*args, **kwargs)
10406
10407 def GetMenuBar(*args, **kwargs):
10408 """GetMenuBar(self) -> MenuBar"""
10409 return _core_.Menu_GetMenuBar(*args, **kwargs)
10410
10411 def Attach(*args, **kwargs):
10412 """Attach(self, wxMenuBarBase menubar)"""
10413 return _core_.Menu_Attach(*args, **kwargs)
10414
10415 def Detach(*args, **kwargs):
10416 """Detach(self)"""
10417 return _core_.Menu_Detach(*args, **kwargs)
10418
10419 def IsAttached(*args, **kwargs):
10420 """IsAttached(self) -> bool"""
10421 return _core_.Menu_IsAttached(*args, **kwargs)
10422
10423 def SetParent(*args, **kwargs):
10424 """SetParent(self, Menu parent)"""
10425 return _core_.Menu_SetParent(*args, **kwargs)
10426
10427 def GetParent(*args, **kwargs):
10428 """GetParent(self) -> Menu"""
10429 return _core_.Menu_GetParent(*args, **kwargs)
10430
10431
10432class MenuPtr(Menu):
10433 def __init__(self, this):
10434 self.this = this
10435 if not hasattr(self,"thisown"): self.thisown = 0
10436 self.__class__ = Menu
10437_core_.Menu_swigregister(MenuPtr)
10438DefaultValidator = cvar.DefaultValidator
10439
10440#---------------------------------------------------------------------------
10441
10442class MenuBar(Window):
093d3ff1 10443 """Proxy of C++ MenuBar class"""
d55e5bfc
RD
10444 def __repr__(self):
10445 return "<%s.%s; proxy of C++ wxMenuBar instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
10446 def __init__(self, *args, **kwargs):
10447 """__init__(self, long style=0) -> MenuBar"""
10448 newobj = _core_.new_MenuBar(*args, **kwargs)
10449 self.this = newobj.this
10450 self.thisown = 1
10451 del newobj.thisown
10452 self._setOORInfo(self)
10453
10454 def Append(*args, **kwargs):
10455 """Append(self, Menu menu, String title) -> bool"""
10456 return _core_.MenuBar_Append(*args, **kwargs)
10457
10458 def Insert(*args, **kwargs):
10459 """Insert(self, size_t pos, Menu menu, String title) -> bool"""
10460 return _core_.MenuBar_Insert(*args, **kwargs)
10461
10462 def GetMenuCount(*args, **kwargs):
10463 """GetMenuCount(self) -> size_t"""
10464 return _core_.MenuBar_GetMenuCount(*args, **kwargs)
10465
10466 def GetMenu(*args, **kwargs):
10467 """GetMenu(self, size_t pos) -> Menu"""
10468 return _core_.MenuBar_GetMenu(*args, **kwargs)
10469
10470 def Replace(*args, **kwargs):
10471 """Replace(self, size_t pos, Menu menu, String title) -> Menu"""
10472 return _core_.MenuBar_Replace(*args, **kwargs)
10473
10474 def Remove(*args, **kwargs):
10475 """Remove(self, size_t pos) -> Menu"""
10476 return _core_.MenuBar_Remove(*args, **kwargs)
10477
10478 def EnableTop(*args, **kwargs):
10479 """EnableTop(self, size_t pos, bool enable)"""
10480 return _core_.MenuBar_EnableTop(*args, **kwargs)
10481
10482 def IsEnabledTop(*args, **kwargs):
10483 """IsEnabledTop(self, size_t pos) -> bool"""
10484 return _core_.MenuBar_IsEnabledTop(*args, **kwargs)
10485
10486 def SetLabelTop(*args, **kwargs):
10487 """SetLabelTop(self, size_t pos, String label)"""
10488 return _core_.MenuBar_SetLabelTop(*args, **kwargs)
10489
10490 def GetLabelTop(*args, **kwargs):
10491 """GetLabelTop(self, size_t pos) -> String"""
10492 return _core_.MenuBar_GetLabelTop(*args, **kwargs)
10493
10494 def FindMenuItem(*args, **kwargs):
10495 """FindMenuItem(self, String menu, String item) -> int"""
10496 return _core_.MenuBar_FindMenuItem(*args, **kwargs)
10497
10498 def FindItemById(*args, **kwargs):
10499 """FindItemById(self, int id) -> MenuItem"""
10500 return _core_.MenuBar_FindItemById(*args, **kwargs)
10501
10502 def FindMenu(*args, **kwargs):
10503 """FindMenu(self, String title) -> int"""
10504 return _core_.MenuBar_FindMenu(*args, **kwargs)
10505
10506 def Enable(*args, **kwargs):
10507 """Enable(self, int id, bool enable)"""
10508 return _core_.MenuBar_Enable(*args, **kwargs)
10509
10510 def Check(*args, **kwargs):
10511 """Check(self, int id, bool check)"""
10512 return _core_.MenuBar_Check(*args, **kwargs)
10513
10514 def IsChecked(*args, **kwargs):
10515 """IsChecked(self, int id) -> bool"""
10516 return _core_.MenuBar_IsChecked(*args, **kwargs)
10517
10518 def IsEnabled(*args, **kwargs):
10519 """IsEnabled(self, int id) -> bool"""
10520 return _core_.MenuBar_IsEnabled(*args, **kwargs)
10521
10522 def SetLabel(*args, **kwargs):
10523 """SetLabel(self, int id, String label)"""
10524 return _core_.MenuBar_SetLabel(*args, **kwargs)
10525
10526 def GetLabel(*args, **kwargs):
10527 """GetLabel(self, int id) -> String"""
10528 return _core_.MenuBar_GetLabel(*args, **kwargs)
10529
10530 def SetHelpString(*args, **kwargs):
10531 """SetHelpString(self, int id, String helpString)"""
10532 return _core_.MenuBar_SetHelpString(*args, **kwargs)
10533
10534 def GetHelpString(*args, **kwargs):
10535 """GetHelpString(self, int id) -> String"""
10536 return _core_.MenuBar_GetHelpString(*args, **kwargs)
10537
10538 def GetFrame(*args, **kwargs):
10539 """GetFrame(self) -> wxFrame"""
10540 return _core_.MenuBar_GetFrame(*args, **kwargs)
10541
10542 def IsAttached(*args, **kwargs):
10543 """IsAttached(self) -> bool"""
10544 return _core_.MenuBar_IsAttached(*args, **kwargs)
10545
10546 def Attach(*args, **kwargs):
10547 """Attach(self, wxFrame frame)"""
10548 return _core_.MenuBar_Attach(*args, **kwargs)
10549
10550 def Detach(*args, **kwargs):
10551 """Detach(self)"""
10552 return _core_.MenuBar_Detach(*args, **kwargs)
10553
db67f999
RD
10554 def SetAutoWindowMenu(*args, **kwargs):
10555 """SetAutoWindowMenu(bool enable)"""
10556 return _core_.MenuBar_SetAutoWindowMenu(*args, **kwargs)
10557
10558 SetAutoWindowMenu = staticmethod(SetAutoWindowMenu)
10559 def GetAutoWindowMenu(*args, **kwargs):
10560 """GetAutoWindowMenu() -> bool"""
10561 return _core_.MenuBar_GetAutoWindowMenu(*args, **kwargs)
10562
10563 GetAutoWindowMenu = staticmethod(GetAutoWindowMenu)
d55e5bfc
RD
10564
10565class MenuBarPtr(MenuBar):
10566 def __init__(self, this):
10567 self.this = this
10568 if not hasattr(self,"thisown"): self.thisown = 0
10569 self.__class__ = MenuBar
10570_core_.MenuBar_swigregister(MenuBarPtr)
10571
db67f999
RD
10572def MenuBar_SetAutoWindowMenu(*args, **kwargs):
10573 """MenuBar_SetAutoWindowMenu(bool enable)"""
10574 return _core_.MenuBar_SetAutoWindowMenu(*args, **kwargs)
10575
10576def MenuBar_GetAutoWindowMenu(*args, **kwargs):
10577 """MenuBar_GetAutoWindowMenu() -> bool"""
10578 return _core_.MenuBar_GetAutoWindowMenu(*args, **kwargs)
10579
d55e5bfc
RD
10580#---------------------------------------------------------------------------
10581
10582class MenuItem(Object):
093d3ff1 10583 """Proxy of C++ MenuItem class"""
d55e5bfc
RD
10584 def __repr__(self):
10585 return "<%s.%s; proxy of C++ wxMenuItem instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
10586 def __init__(self, *args, **kwargs):
10587 """
10588 __init__(self, Menu parentMenu=None, int id=ID_ANY, String text=EmptyString,
10589 String help=EmptyString, int kind=ITEM_NORMAL,
10590 Menu subMenu=None) -> MenuItem
10591 """
10592 newobj = _core_.new_MenuItem(*args, **kwargs)
10593 self.this = newobj.this
10594 self.thisown = 1
10595 del newobj.thisown
10596 def GetMenu(*args, **kwargs):
10597 """GetMenu(self) -> Menu"""
10598 return _core_.MenuItem_GetMenu(*args, **kwargs)
10599
10600 def SetMenu(*args, **kwargs):
10601 """SetMenu(self, Menu menu)"""
10602 return _core_.MenuItem_SetMenu(*args, **kwargs)
10603
10604 def SetId(*args, **kwargs):
10605 """SetId(self, int id)"""
10606 return _core_.MenuItem_SetId(*args, **kwargs)
10607
10608 def GetId(*args, **kwargs):
10609 """GetId(self) -> int"""
10610 return _core_.MenuItem_GetId(*args, **kwargs)
10611
10612 def IsSeparator(*args, **kwargs):
10613 """IsSeparator(self) -> bool"""
10614 return _core_.MenuItem_IsSeparator(*args, **kwargs)
10615
10616 def SetText(*args, **kwargs):
10617 """SetText(self, String str)"""
10618 return _core_.MenuItem_SetText(*args, **kwargs)
10619
10620 def GetLabel(*args, **kwargs):
10621 """GetLabel(self) -> String"""
10622 return _core_.MenuItem_GetLabel(*args, **kwargs)
10623
10624 def GetText(*args, **kwargs):
10625 """GetText(self) -> String"""
10626 return _core_.MenuItem_GetText(*args, **kwargs)
10627
10628 def GetLabelFromText(*args, **kwargs):
c24da6d6 10629 """GetLabelFromText(String text) -> String"""
d55e5bfc
RD
10630 return _core_.MenuItem_GetLabelFromText(*args, **kwargs)
10631
10632 GetLabelFromText = staticmethod(GetLabelFromText)
10633 def GetKind(*args, **kwargs):
10634 """GetKind(self) -> int"""
10635 return _core_.MenuItem_GetKind(*args, **kwargs)
10636
10637 def SetKind(*args, **kwargs):
10638 """SetKind(self, int kind)"""
10639 return _core_.MenuItem_SetKind(*args, **kwargs)
10640
10641 def SetCheckable(*args, **kwargs):
10642 """SetCheckable(self, bool checkable)"""
10643 return _core_.MenuItem_SetCheckable(*args, **kwargs)
10644
10645 def IsCheckable(*args, **kwargs):
10646 """IsCheckable(self) -> bool"""
10647 return _core_.MenuItem_IsCheckable(*args, **kwargs)
10648
10649 def IsSubMenu(*args, **kwargs):
10650 """IsSubMenu(self) -> bool"""
10651 return _core_.MenuItem_IsSubMenu(*args, **kwargs)
10652
10653 def SetSubMenu(*args, **kwargs):
10654 """SetSubMenu(self, Menu menu)"""
10655 return _core_.MenuItem_SetSubMenu(*args, **kwargs)
10656
10657 def GetSubMenu(*args, **kwargs):
10658 """GetSubMenu(self) -> Menu"""
10659 return _core_.MenuItem_GetSubMenu(*args, **kwargs)
10660
10661 def Enable(*args, **kwargs):
10662 """Enable(self, bool enable=True)"""
10663 return _core_.MenuItem_Enable(*args, **kwargs)
10664
10665 def IsEnabled(*args, **kwargs):
10666 """IsEnabled(self) -> bool"""
10667 return _core_.MenuItem_IsEnabled(*args, **kwargs)
10668
10669 def Check(*args, **kwargs):
10670 """Check(self, bool check=True)"""
10671 return _core_.MenuItem_Check(*args, **kwargs)
10672
10673 def IsChecked(*args, **kwargs):
10674 """IsChecked(self) -> bool"""
10675 return _core_.MenuItem_IsChecked(*args, **kwargs)
10676
10677 def Toggle(*args, **kwargs):
10678 """Toggle(self)"""
10679 return _core_.MenuItem_Toggle(*args, **kwargs)
10680
10681 def SetHelp(*args, **kwargs):
10682 """SetHelp(self, String str)"""
10683 return _core_.MenuItem_SetHelp(*args, **kwargs)
10684
10685 def GetHelp(*args, **kwargs):
10686 """GetHelp(self) -> String"""
10687 return _core_.MenuItem_GetHelp(*args, **kwargs)
10688
10689 def GetAccel(*args, **kwargs):
10690 """GetAccel(self) -> AcceleratorEntry"""
10691 return _core_.MenuItem_GetAccel(*args, **kwargs)
10692
10693 def SetAccel(*args, **kwargs):
10694 """SetAccel(self, AcceleratorEntry accel)"""
10695 return _core_.MenuItem_SetAccel(*args, **kwargs)
10696
10697 def SetFont(*args, **kwargs):
10698 """SetFont(self, Font font)"""
10699 return _core_.MenuItem_SetFont(*args, **kwargs)
10700
10701 def GetFont(*args, **kwargs):
10702 """GetFont(self) -> Font"""
10703 return _core_.MenuItem_GetFont(*args, **kwargs)
10704
10705 def SetTextColour(*args, **kwargs):
10706 """SetTextColour(self, Colour colText)"""
10707 return _core_.MenuItem_SetTextColour(*args, **kwargs)
10708
10709 def GetTextColour(*args, **kwargs):
10710 """GetTextColour(self) -> Colour"""
10711 return _core_.MenuItem_GetTextColour(*args, **kwargs)
10712
10713 def SetBackgroundColour(*args, **kwargs):
10714 """SetBackgroundColour(self, Colour colBack)"""
10715 return _core_.MenuItem_SetBackgroundColour(*args, **kwargs)
10716
10717 def GetBackgroundColour(*args, **kwargs):
10718 """GetBackgroundColour(self) -> Colour"""
10719 return _core_.MenuItem_GetBackgroundColour(*args, **kwargs)
10720
10721 def SetBitmaps(*args, **kwargs):
10722 """SetBitmaps(self, Bitmap bmpChecked, Bitmap bmpUnchecked=wxNullBitmap)"""
10723 return _core_.MenuItem_SetBitmaps(*args, **kwargs)
10724
10725 def SetDisabledBitmap(*args, **kwargs):
10726 """SetDisabledBitmap(self, Bitmap bmpDisabled)"""
10727 return _core_.MenuItem_SetDisabledBitmap(*args, **kwargs)
10728
10729 def GetDisabledBitmap(*args, **kwargs):
10730 """GetDisabledBitmap(self) -> Bitmap"""
10731 return _core_.MenuItem_GetDisabledBitmap(*args, **kwargs)
10732
10733 def SetMarginWidth(*args, **kwargs):
10734 """SetMarginWidth(self, int nWidth)"""
10735 return _core_.MenuItem_SetMarginWidth(*args, **kwargs)
10736
10737 def GetMarginWidth(*args, **kwargs):
10738 """GetMarginWidth(self) -> int"""
10739 return _core_.MenuItem_GetMarginWidth(*args, **kwargs)
10740
10741 def GetDefaultMarginWidth(*args, **kwargs):
c24da6d6 10742 """GetDefaultMarginWidth() -> int"""
d55e5bfc
RD
10743 return _core_.MenuItem_GetDefaultMarginWidth(*args, **kwargs)
10744
10745 GetDefaultMarginWidth = staticmethod(GetDefaultMarginWidth)
10746 def IsOwnerDrawn(*args, **kwargs):
10747 """IsOwnerDrawn(self) -> bool"""
10748 return _core_.MenuItem_IsOwnerDrawn(*args, **kwargs)
10749
10750 def SetOwnerDrawn(*args, **kwargs):
10751 """SetOwnerDrawn(self, bool ownerDrawn=True)"""
10752 return _core_.MenuItem_SetOwnerDrawn(*args, **kwargs)
10753
10754 def ResetOwnerDrawn(*args, **kwargs):
10755 """ResetOwnerDrawn(self)"""
10756 return _core_.MenuItem_ResetOwnerDrawn(*args, **kwargs)
10757
10758 def SetBitmap(*args, **kwargs):
10759 """SetBitmap(self, Bitmap bitmap)"""
10760 return _core_.MenuItem_SetBitmap(*args, **kwargs)
10761
10762 def GetBitmap(*args, **kwargs):
10763 """GetBitmap(self) -> Bitmap"""
10764 return _core_.MenuItem_GetBitmap(*args, **kwargs)
10765
10766
10767class MenuItemPtr(MenuItem):
10768 def __init__(self, this):
10769 self.this = this
10770 if not hasattr(self,"thisown"): self.thisown = 0
10771 self.__class__ = MenuItem
10772_core_.MenuItem_swigregister(MenuItemPtr)
10773
10774def MenuItem_GetLabelFromText(*args, **kwargs):
10775 """MenuItem_GetLabelFromText(String text) -> String"""
10776 return _core_.MenuItem_GetLabelFromText(*args, **kwargs)
10777
10778def MenuItem_GetDefaultMarginWidth(*args, **kwargs):
10779 """MenuItem_GetDefaultMarginWidth() -> int"""
10780 return _core_.MenuItem_GetDefaultMarginWidth(*args, **kwargs)
10781
10782#---------------------------------------------------------------------------
10783
10784class Control(Window):
10785 """
10786 This is the base class for a control or 'widget'.
10787
79fccf9d
RD
10788 A control is generally a small window which processes user input
10789 and/or displays one or more item of data.
d55e5bfc
RD
10790 """
10791 def __repr__(self):
10792 return "<%s.%s; proxy of C++ wxControl instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
10793 def __init__(self, *args, **kwargs):
10794 """
248ed943
RD
10795 __init__(self, Window parent, int id=-1, Point pos=DefaultPosition,
10796 Size size=DefaultSize, long style=0, Validator validator=DefaultValidator,
d55e5bfc
RD
10797 String name=ControlNameStr) -> Control
10798
79fccf9d
RD
10799 Create a Control. Normally you should only call this from a subclass'
10800 __init__ as a plain old wx.Control is not very useful.
d55e5bfc
RD
10801 """
10802 newobj = _core_.new_Control(*args, **kwargs)
10803 self.this = newobj.this
10804 self.thisown = 1
10805 del newobj.thisown
10806 self._setOORInfo(self)
10807
10808 def Create(*args, **kwargs):
10809 """
248ed943
RD
10810 Create(self, Window parent, int id=-1, Point pos=DefaultPosition,
10811 Size size=DefaultSize, long style=0, Validator validator=DefaultValidator,
d55e5bfc
RD
10812 String name=ControlNameStr) -> bool
10813
10814 Do the 2nd phase and create the GUI control.
10815 """
10816 return _core_.Control_Create(*args, **kwargs)
10817
10818 def Command(*args, **kwargs):
10819 """
10820 Command(self, CommandEvent event)
10821
79fccf9d
RD
10822 Simulates the effect of the user issuing a command to the item.
10823
10824 :see: `wx.CommandEvent`
10825
d55e5bfc
RD
10826 """
10827 return _core_.Control_Command(*args, **kwargs)
10828
10829 def GetLabel(*args, **kwargs):
10830 """
10831 GetLabel(self) -> String
10832
10833 Return a control's text.
10834 """
10835 return _core_.Control_GetLabel(*args, **kwargs)
10836
10837 def SetLabel(*args, **kwargs):
10838 """
10839 SetLabel(self, String label)
10840
10841 Sets the item's text.
10842 """
10843 return _core_.Control_SetLabel(*args, **kwargs)
10844
a001823c 10845 def GetClassDefaultAttributes(*args, **kwargs):
f8167d6e 10846 """
a001823c 10847 GetClassDefaultAttributes(int variant=WINDOW_VARIANT_NORMAL) -> VisualAttributes
f8167d6e 10848
a001823c
RD
10849 Get the default attributes for this class. This is useful if you want
10850 to use the same font or colour in your own control as in a standard
10851 control -- which is a much better idea than hard coding specific
10852 colours or fonts which might look completely out of place on the
10853 user's system, especially if it uses themes.
f8167d6e 10854
a001823c
RD
10855 The variant parameter is only relevant under Mac currently and is
10856 ignore under other platforms. Under Mac, it will change the size of
10857 the returned font. See `wx.Window.SetWindowVariant` for more about
10858 this.
f8167d6e 10859 """
d55e5bfc
RD
10860 return _core_.Control_GetClassDefaultAttributes(*args, **kwargs)
10861
10862 GetClassDefaultAttributes = staticmethod(GetClassDefaultAttributes)
10863
10864class ControlPtr(Control):
10865 def __init__(self, this):
10866 self.this = this
10867 if not hasattr(self,"thisown"): self.thisown = 0
10868 self.__class__ = Control
10869_core_.Control_swigregister(ControlPtr)
10870ControlNameStr = cvar.ControlNameStr
10871
10872def PreControl(*args, **kwargs):
10873 """
10874 PreControl() -> Control
10875
10876 Precreate a Control control for 2-phase creation
10877 """
10878 val = _core_.new_PreControl(*args, **kwargs)
10879 val.thisown = 1
10880 return val
10881
10882def Control_GetClassDefaultAttributes(*args, **kwargs):
a001823c
RD
10883 """
10884 Control_GetClassDefaultAttributes(int variant=WINDOW_VARIANT_NORMAL) -> VisualAttributes
10885
10886 Get the default attributes for this class. This is useful if you want
10887 to use the same font or colour in your own control as in a standard
10888 control -- which is a much better idea than hard coding specific
10889 colours or fonts which might look completely out of place on the
10890 user's system, especially if it uses themes.
10891
10892 The variant parameter is only relevant under Mac currently and is
10893 ignore under other platforms. Under Mac, it will change the size of
10894 the returned font. See `wx.Window.SetWindowVariant` for more about
10895 this.
10896 """
d55e5bfc
RD
10897 return _core_.Control_GetClassDefaultAttributes(*args, **kwargs)
10898
10899#---------------------------------------------------------------------------
10900
10901class ItemContainer(object):
10902 """
53aa7709
RD
10903 The wx.ItemContainer class defines an interface which is implemented
10904 by all controls which have string subitems, each of which may be
10905 selected, such as `wx.ListBox`, `wx.CheckListBox`, `wx.Choice` as well
10906 as `wx.ComboBox` which implements an extended interface deriving from
79fccf9d 10907 this one.
d55e5bfc 10908
79fccf9d
RD
10909 It defines the methods for accessing the control's items and although
10910 each of the derived classes implements them differently, they still
10911 all conform to the same interface.
d55e5bfc 10912
79fccf9d
RD
10913 The items in a wx.ItemContainer have (non empty) string labels and,
10914 optionally, client data associated with them.
d55e5bfc
RD
10915
10916 """
10917 def __init__(self): raise RuntimeError, "No constructor defined"
10918 def __repr__(self):
10919 return "<%s.%s; proxy of C++ wxItemContainer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
10920 def Append(*args, **kwargs):
10921 """
10922 Append(self, String item, PyObject clientData=None) -> int
10923
79fccf9d
RD
10924 Adds the item to the control, associating the given data with the item
10925 if not None. The return value is the index of the newly added item
10926 which may be different from the last one if the control is sorted (e.g.
10927 has wx.LB_SORT or wx.CB_SORT style).
d55e5bfc
RD
10928 """
10929 return _core_.ItemContainer_Append(*args, **kwargs)
10930
10931 def AppendItems(*args, **kwargs):
10932 """
f5b96ee1 10933 AppendItems(self, List strings)
d55e5bfc 10934
79fccf9d
RD
10935 Apend several items at once to the control. Notice that calling this
10936 method may be much faster than appending the items one by one if you
10937 need to add a lot of items.
d55e5bfc
RD
10938 """
10939 return _core_.ItemContainer_AppendItems(*args, **kwargs)
10940
10941 def Insert(*args, **kwargs):
10942 """
10943 Insert(self, String item, int pos, PyObject clientData=None) -> int
10944
79fccf9d 10945 Insert an item into the control before the item at the ``pos`` index,
d55e5bfc
RD
10946 optionally associating some data object with the item.
10947 """
10948 return _core_.ItemContainer_Insert(*args, **kwargs)
10949
10950 def Clear(*args, **kwargs):
10951 """
10952 Clear(self)
10953
10954 Removes all items from the control.
10955 """
10956 return _core_.ItemContainer_Clear(*args, **kwargs)
10957
10958 def Delete(*args, **kwargs):
10959 """
10960 Delete(self, int n)
10961
79fccf9d
RD
10962 Deletes the item at the zero-based index 'n' from the control. Note
10963 that it is an error (signalled by a `wx.PyAssertionError` exception if
10964 enabled) to remove an item with the index negative or greater or equal
10965 than the number of items in the control.
d55e5bfc
RD
10966 """
10967 return _core_.ItemContainer_Delete(*args, **kwargs)
10968
53aa7709
RD
10969 def GetClientData(*args, **kwargs):
10970 """
10971 GetClientData(self, int n) -> PyObject
10972
10973 Returns the client data associated with the given item, (if any.)
10974 """
10975 return _core_.ItemContainer_GetClientData(*args, **kwargs)
10976
10977 def SetClientData(*args, **kwargs):
10978 """
10979 SetClientData(self, int n, PyObject clientData)
10980
10981 Associate the given client data with the item at position n.
10982 """
10983 return _core_.ItemContainer_SetClientData(*args, **kwargs)
10984
d55e5bfc
RD
10985 def GetCount(*args, **kwargs):
10986 """
10987 GetCount(self) -> int
10988
10989 Returns the number of items in the control.
10990 """
10991 return _core_.ItemContainer_GetCount(*args, **kwargs)
10992
10993 def IsEmpty(*args, **kwargs):
10994 """
10995 IsEmpty(self) -> bool
10996
10997 Returns True if the control is empty or False if it has some items.
10998 """
10999 return _core_.ItemContainer_IsEmpty(*args, **kwargs)
11000
11001 def GetString(*args, **kwargs):
11002 """
11003 GetString(self, int n) -> String
11004
11005 Returns the label of the item with the given index.
11006 """
11007 return _core_.ItemContainer_GetString(*args, **kwargs)
11008
11009 def GetStrings(*args, **kwargs):
11010 """GetStrings(self) -> wxArrayString"""
11011 return _core_.ItemContainer_GetStrings(*args, **kwargs)
11012
11013 def SetString(*args, **kwargs):
11014 """
11015 SetString(self, int n, String s)
11016
11017 Sets the label for the given item.
11018 """
11019 return _core_.ItemContainer_SetString(*args, **kwargs)
11020
11021 def FindString(*args, **kwargs):
11022 """
11023 FindString(self, String s) -> int
11024
11025 Finds an item whose label matches the given string. Returns the
79fccf9d
RD
11026 zero-based position of the item, or ``wx.NOT_FOUND`` if the string was not
11027 found.
d55e5bfc
RD
11028 """
11029 return _core_.ItemContainer_FindString(*args, **kwargs)
11030
53aa7709 11031 def SetSelection(*args, **kwargs):
d55e5bfc 11032 """
53aa7709 11033 SetSelection(self, int n)
d55e5bfc
RD
11034
11035 Sets the item at index 'n' to be the selected item.
11036 """
53aa7709 11037 return _core_.ItemContainer_SetSelection(*args, **kwargs)
d55e5bfc 11038
d55e5bfc
RD
11039 def GetSelection(*args, **kwargs):
11040 """
11041 GetSelection(self) -> int
11042
79fccf9d
RD
11043 Returns the index of the selected item or ``wx.NOT_FOUND`` if no item
11044 is selected.
d55e5bfc
RD
11045 """
11046 return _core_.ItemContainer_GetSelection(*args, **kwargs)
11047
53aa7709
RD
11048 def SetStringSelection(*args, **kwargs):
11049 """SetStringSelection(self, String s) -> bool"""
11050 return _core_.ItemContainer_SetStringSelection(*args, **kwargs)
11051
d55e5bfc
RD
11052 def GetStringSelection(*args, **kwargs):
11053 """
11054 GetStringSelection(self) -> String
11055
79fccf9d
RD
11056 Returns the label of the selected item or an empty string if no item
11057 is selected.
d55e5bfc
RD
11058 """
11059 return _core_.ItemContainer_GetStringSelection(*args, **kwargs)
11060
53aa7709 11061 def Select(*args, **kwargs):
d55e5bfc 11062 """
53aa7709 11063 Select(self, int n)
d55e5bfc 11064
53aa7709
RD
11065 This is the same as `SetSelection` and exists only because it is
11066 slightly more natural for controls which support multiple selection.
d55e5bfc 11067 """
53aa7709 11068 return _core_.ItemContainer_Select(*args, **kwargs)
d55e5bfc
RD
11069
11070
11071class ItemContainerPtr(ItemContainer):
11072 def __init__(self, this):
11073 self.this = this
11074 if not hasattr(self,"thisown"): self.thisown = 0
11075 self.__class__ = ItemContainer
11076_core_.ItemContainer_swigregister(ItemContainerPtr)
11077
11078#---------------------------------------------------------------------------
11079
11080class ControlWithItems(Control,ItemContainer):
11081 """
79fccf9d
RD
11082 wx.ControlWithItems combines the ``wx.ItemContainer`` class with the
11083 wx.Control class, and is used for the base class of various controls
11084 that have items.
d55e5bfc
RD
11085 """
11086 def __init__(self): raise RuntimeError, "No constructor defined"
11087 def __repr__(self):
11088 return "<%s.%s; proxy of C++ wxControlWithItems instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
11089
11090class ControlWithItemsPtr(ControlWithItems):
11091 def __init__(self, this):
11092 self.this = this
11093 if not hasattr(self,"thisown"): self.thisown = 0
11094 self.__class__ = ControlWithItems
11095_core_.ControlWithItems_swigregister(ControlWithItemsPtr)
11096
11097#---------------------------------------------------------------------------
11098
11099class SizerItem(Object):
248ed943
RD
11100 """
11101 The wx.SizerItem class is used to track the position, size and other
11102 attributes of each item managed by a `wx.Sizer`. In normal usage user
11103 code should never need to deal directly with a wx.SizerItem, but
11104 custom classes derived from `wx.PySizer` will probably need to use the
11105 collection of wx.SizerItems held by wx.Sizer when calculating layout.
11106
11107 :see: `wx.Sizer`, `wx.GBSizerItem`
11108 """
d55e5bfc
RD
11109 def __repr__(self):
11110 return "<%s.%s; proxy of C++ wxSizerItem instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
11111 def __init__(self, *args, **kwargs):
248ed943
RD
11112 """
11113 __init__(self) -> SizerItem
11114
11115 Constructs an empty wx.SizerItem. Either a window, sizer or spacer
11116 size will need to be set before this item can be used in a Sizer.
11117
11118 You will probably never need to create a wx.SizerItem directly as they
11119 are created automatically when the sizer's Add, Insert or Prepend
11120 methods are called.
11121
11122 :see: `wx.SizerItemSpacer`, `wx.SizerItemWindow`, `wx.SizerItemSizer`
11123 """
d55e5bfc
RD
11124 newobj = _core_.new_SizerItem(*args, **kwargs)
11125 self.this = newobj.this
11126 self.thisown = 1
11127 del newobj.thisown
11128 def DeleteWindows(*args, **kwargs):
248ed943
RD
11129 """
11130 DeleteWindows(self)
11131
11132 Destroy the window or the windows in a subsizer, depending on the type
11133 of item.
11134 """
d55e5bfc
RD
11135 return _core_.SizerItem_DeleteWindows(*args, **kwargs)
11136
11137 def DetachSizer(*args, **kwargs):
248ed943
RD
11138 """
11139 DetachSizer(self)
11140
11141 Enable deleting the SizerItem without destroying the contained sizer.
11142 """
d55e5bfc
RD
11143 return _core_.SizerItem_DetachSizer(*args, **kwargs)
11144
11145 def GetSize(*args, **kwargs):
248ed943
RD
11146 """
11147 GetSize(self) -> Size
11148
11149 Get the current size of the item, as set in the last Layout.
11150 """
d55e5bfc
RD
11151 return _core_.SizerItem_GetSize(*args, **kwargs)
11152
11153 def CalcMin(*args, **kwargs):
248ed943
RD
11154 """
11155 CalcMin(self) -> Size
11156
11157 Calculates the minimum desired size for the item, including any space
11158 needed by borders.
11159 """
d55e5bfc
RD
11160 return _core_.SizerItem_CalcMin(*args, **kwargs)
11161
11162 def SetDimension(*args, **kwargs):
248ed943
RD
11163 """
11164 SetDimension(self, Point pos, Size size)
11165
11166 Set the position and size of the space allocated for this item by the
11167 sizer, and adjust the position and size of the item (window or
11168 subsizer) to be within that space taking alignment and borders into
11169 account.
11170 """
d55e5bfc
RD
11171 return _core_.SizerItem_SetDimension(*args, **kwargs)
11172
11173 def GetMinSize(*args, **kwargs):
248ed943
RD
11174 """
11175 GetMinSize(self) -> Size
11176
11177 Get the minimum size needed for the item.
11178 """
d55e5bfc
RD
11179 return _core_.SizerItem_GetMinSize(*args, **kwargs)
11180
a001823c
RD
11181 def GetMinSizeWithBorder(*args, **kwargs):
11182 """
11183 GetMinSizeWithBorder(self) -> Size
11184
11185 Get the minimum size needed for the item with space for the borders
11186 added, if needed.
11187 """
11188 return _core_.SizerItem_GetMinSizeWithBorder(*args, **kwargs)
11189
d55e5bfc
RD
11190 def SetInitSize(*args, **kwargs):
11191 """SetInitSize(self, int x, int y)"""
11192 return _core_.SizerItem_SetInitSize(*args, **kwargs)
11193
11194 def SetRatioWH(*args, **kwargs):
248ed943
RD
11195 """
11196 SetRatioWH(self, int width, int height)
11197
11198 Set the ratio item attribute.
11199 """
d55e5bfc
RD
11200 return _core_.SizerItem_SetRatioWH(*args, **kwargs)
11201
11202 def SetRatioSize(*args, **kwargs):
248ed943
RD
11203 """
11204 SetRatioSize(self, Size size)
11205
11206 Set the ratio item attribute.
11207 """
d55e5bfc
RD
11208 return _core_.SizerItem_SetRatioSize(*args, **kwargs)
11209
11210 def SetRatio(*args, **kwargs):
248ed943
RD
11211 """
11212 SetRatio(self, float ratio)
11213
11214 Set the ratio item attribute.
11215 """
d55e5bfc
RD
11216 return _core_.SizerItem_SetRatio(*args, **kwargs)
11217
11218 def GetRatio(*args, **kwargs):
248ed943
RD
11219 """
11220 GetRatio(self) -> float
11221
11222 Set the ratio item attribute.
11223 """
d55e5bfc
RD
11224 return _core_.SizerItem_GetRatio(*args, **kwargs)
11225
c1cb24a4
RD
11226 def GetRect(*args, **kwargs):
11227 """
11228 GetRect(self) -> Rect
11229
11230 Returns the rectangle that the sizer item should occupy
11231 """
11232 return _core_.SizerItem_GetRect(*args, **kwargs)
11233
d55e5bfc 11234 def IsWindow(*args, **kwargs):
248ed943
RD
11235 """
11236 IsWindow(self) -> bool
11237
11238 Is this sizer item a window?
11239 """
d55e5bfc
RD
11240 return _core_.SizerItem_IsWindow(*args, **kwargs)
11241
11242 def IsSizer(*args, **kwargs):
248ed943
RD
11243 """
11244 IsSizer(self) -> bool
11245
11246 Is this sizer item a subsizer?
11247 """
d55e5bfc
RD
11248 return _core_.SizerItem_IsSizer(*args, **kwargs)
11249
11250 def IsSpacer(*args, **kwargs):
248ed943
RD
11251 """
11252 IsSpacer(self) -> bool
11253
11254 Is this sizer item a spacer?
11255 """
d55e5bfc
RD
11256 return _core_.SizerItem_IsSpacer(*args, **kwargs)
11257
11258 def SetProportion(*args, **kwargs):
248ed943
RD
11259 """
11260 SetProportion(self, int proportion)
11261
11262 Set the proportion value for this item.
11263 """
d55e5bfc
RD
11264 return _core_.SizerItem_SetProportion(*args, **kwargs)
11265
11266 def GetProportion(*args, **kwargs):
248ed943
RD
11267 """
11268 GetProportion(self) -> int
11269
11270 Get the proportion value for this item.
11271 """
d55e5bfc
RD
11272 return _core_.SizerItem_GetProportion(*args, **kwargs)
11273
248ed943
RD
11274 SetOption = wx._deprecated(SetProportion, "Please use `SetProportion` instead.")
11275 GetOption = wx._deprecated(GetProportion, "Please use `GetProportion` instead.")
d55e5bfc 11276 def SetFlag(*args, **kwargs):
248ed943
RD
11277 """
11278 SetFlag(self, int flag)
11279
11280 Set the flag value for this item.
11281 """
d55e5bfc
RD
11282 return _core_.SizerItem_SetFlag(*args, **kwargs)
11283
11284 def GetFlag(*args, **kwargs):
248ed943
RD
11285 """
11286 GetFlag(self) -> int
11287
11288 Get the flag value for this item.
11289 """
d55e5bfc
RD
11290 return _core_.SizerItem_GetFlag(*args, **kwargs)
11291
11292 def SetBorder(*args, **kwargs):
248ed943
RD
11293 """
11294 SetBorder(self, int border)
11295
11296 Set the border value for this item.
11297 """
d55e5bfc
RD
11298 return _core_.SizerItem_SetBorder(*args, **kwargs)
11299
11300 def GetBorder(*args, **kwargs):
248ed943
RD
11301 """
11302 GetBorder(self) -> int
11303
11304 Get the border value for this item.
11305 """
d55e5bfc
RD
11306 return _core_.SizerItem_GetBorder(*args, **kwargs)
11307
11308 def GetWindow(*args, **kwargs):
248ed943
RD
11309 """
11310 GetWindow(self) -> Window
11311
11312 Get the window (if any) that is managed by this sizer item.
11313 """
d55e5bfc
RD
11314 return _core_.SizerItem_GetWindow(*args, **kwargs)
11315
11316 def SetWindow(*args, **kwargs):
248ed943
RD
11317 """
11318 SetWindow(self, Window window)
11319
11320 Set the window to be managed by this sizer item.
11321 """
d55e5bfc
RD
11322 return _core_.SizerItem_SetWindow(*args, **kwargs)
11323
11324 def GetSizer(*args, **kwargs):
248ed943
RD
11325 """
11326 GetSizer(self) -> Sizer
11327
11328 Get the subsizer (if any) that is managed by this sizer item.
11329 """
d55e5bfc
RD
11330 return _core_.SizerItem_GetSizer(*args, **kwargs)
11331
11332 def SetSizer(*args, **kwargs):
248ed943
RD
11333 """
11334 SetSizer(self, Sizer sizer)
11335
11336 Set the subsizer to be managed by this sizer item.
11337 """
d55e5bfc
RD
11338 return _core_.SizerItem_SetSizer(*args, **kwargs)
11339
11340 def GetSpacer(*args, **kwargs):
248ed943
RD
11341 """
11342 GetSpacer(self) -> Size
11343
11344 Get the size of the spacer managed by this sizer item.
11345 """
d55e5bfc
RD
11346 return _core_.SizerItem_GetSpacer(*args, **kwargs)
11347
11348 def SetSpacer(*args, **kwargs):
248ed943
RD
11349 """
11350 SetSpacer(self, Size size)
11351
11352 Set the size of the spacer to be managed by this sizer item.
11353 """
d55e5bfc
RD
11354 return _core_.SizerItem_SetSpacer(*args, **kwargs)
11355
11356 def Show(*args, **kwargs):
248ed943
RD
11357 """
11358 Show(self, bool show)
11359
11360 Set the show item attribute, which sizers use to determine if the item
11361 is to be made part of the layout or not. If the item is tracking a
11362 window then it is shown or hidden as needed.
11363 """
d55e5bfc
RD
11364 return _core_.SizerItem_Show(*args, **kwargs)
11365
11366 def IsShown(*args, **kwargs):
248ed943
RD
11367 """
11368 IsShown(self) -> bool
11369
11370 Is the item to be shown in the layout?
11371 """
d55e5bfc
RD
11372 return _core_.SizerItem_IsShown(*args, **kwargs)
11373
11374 def GetPosition(*args, **kwargs):
248ed943
RD
11375 """
11376 GetPosition(self) -> Point
11377
11378 Returns the current position of the item, as set in the last Layout.
11379 """
d55e5bfc
RD
11380 return _core_.SizerItem_GetPosition(*args, **kwargs)
11381
11382 def GetUserData(*args, **kwargs):
248ed943
RD
11383 """
11384 GetUserData(self) -> PyObject
11385
11386 Returns the userData associated with this sizer item, or None if there
11387 isn't any.
11388 """
d55e5bfc
RD
11389 return _core_.SizerItem_GetUserData(*args, **kwargs)
11390
11391
11392class SizerItemPtr(SizerItem):
11393 def __init__(self, this):
11394 self.this = this
11395 if not hasattr(self,"thisown"): self.thisown = 0
11396 self.__class__ = SizerItem
11397_core_.SizerItem_swigregister(SizerItemPtr)
11398
248ed943 11399def SizerItemWindow(*args, **kwargs):
d55e5bfc 11400 """
248ed943
RD
11401 SizerItemWindow(Window window, int proportion, int flag, int border,
11402 PyObject userData=None) -> SizerItem
11403
11404 Constructs a `wx.SizerItem` for tracking a window.
d55e5bfc 11405 """
248ed943 11406 val = _core_.new_SizerItemWindow(*args, **kwargs)
d55e5bfc
RD
11407 val.thisown = 1
11408 return val
11409
248ed943 11410def SizerItemSpacer(*args, **kwargs):
d55e5bfc 11411 """
248ed943
RD
11412 SizerItemSpacer(int width, int height, int proportion, int flag, int border,
11413 PyObject userData=None) -> SizerItem
11414
11415 Constructs a `wx.SizerItem` for tracking a spacer.
d55e5bfc 11416 """
248ed943 11417 val = _core_.new_SizerItemSpacer(*args, **kwargs)
d55e5bfc
RD
11418 val.thisown = 1
11419 return val
11420
11421def SizerItemSizer(*args, **kwargs):
11422 """
11423 SizerItemSizer(Sizer sizer, int proportion, int flag, int border,
248ed943
RD
11424 PyObject userData=None) -> SizerItem
11425
11426 Constructs a `wx.SizerItem` for tracking a subsizer
d55e5bfc
RD
11427 """
11428 val = _core_.new_SizerItemSizer(*args, **kwargs)
11429 val.thisown = 1
11430 return val
11431
11432class Sizer(Object):
248ed943
RD
11433 """
11434 wx.Sizer is the abstract base class used for laying out subwindows in
11435 a window. You cannot use wx.Sizer directly; instead, you will have to
11436 use one of the sizer classes derived from it such as `wx.BoxSizer`,
11437 `wx.StaticBoxSizer`, `wx.NotebookSizer`, `wx.GridSizer`, `wx.FlexGridSizer`
11438 and `wx.GridBagSizer`.
11439
11440 The concept implemented by sizers in wxWidgets is closely related to
11441 layout tools in other GUI toolkits, such as Java's AWT, the GTK
11442 toolkit or the Qt toolkit. It is based upon the idea of the individual
11443 subwindows reporting their minimal required size and their ability to
11444 get stretched if the size of the parent window has changed. This will
11445 most often mean that the programmer does not set the original size of
11446 a dialog in the beginning, rather the dialog will assigned a sizer and
11447 this sizer will be queried about the recommended size. The sizer in
11448 turn will query its children, which can be normal windows or contorls,
11449 empty space or other sizers, so that a hierarchy of sizers can be
11450 constructed. Note that wxSizer does not derive from wxWindow and thus
11451 do not interfere with tab ordering and requires very little resources
11452 compared to a real window on screen.
11453
11454 What makes sizers so well fitted for use in wxWidgets is the fact that
11455 every control reports its own minimal size and the algorithm can
11456 handle differences in font sizes or different window (dialog item)
11457 sizes on different platforms without problems. If for example the
11458 standard font as well as the overall design of Mac widgets requires
11459 more space than on Windows, then the initial size of a dialog using a
11460 sizer will automatically be bigger on Mac than on Windows.
11461 """
d55e5bfc
RD
11462 def __init__(self): raise RuntimeError, "No constructor defined"
11463 def __repr__(self):
11464 return "<%s.%s; proxy of C++ wxSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
11465 def _setOORInfo(*args, **kwargs):
11466 """_setOORInfo(self, PyObject _self)"""
11467 return _core_.Sizer__setOORInfo(*args, **kwargs)
11468
11469 def Add(*args, **kwargs):
11470 """
248ed943 11471 Add(self, item, int proportion=0, int flag=0, int border=0,
c1cb24a4 11472 PyObject userData=None) -> wx.SizerItem
248ed943
RD
11473
11474 Appends a child item to the sizer.
d55e5bfc
RD
11475 """
11476 return _core_.Sizer_Add(*args, **kwargs)
11477
11478 def Insert(*args, **kwargs):
11479 """
248ed943 11480 Insert(self, int before, item, int proportion=0, int flag=0, int border=0,
c1cb24a4 11481 PyObject userData=None) -> wx.SizerItem
248ed943
RD
11482
11483 Inserts a new item into the list of items managed by this sizer before
11484 the item at index *before*. See `Add` for a description of the parameters.
d55e5bfc
RD
11485 """
11486 return _core_.Sizer_Insert(*args, **kwargs)
11487
11488 def Prepend(*args, **kwargs):
11489 """
248ed943 11490 Prepend(self, item, int proportion=0, int flag=0, int border=0,
c1cb24a4 11491 PyObject userData=None) -> wx.SizerItem
248ed943
RD
11492
11493 Adds a new item to the begining of the list of sizer items managed by
11494 this sizer. See `Add` for a description of the parameters.
d55e5bfc
RD
11495 """
11496 return _core_.Sizer_Prepend(*args, **kwargs)
11497
11498 def Remove(*args, **kwargs):
248ed943
RD
11499 """
11500 Remove(self, item) -> bool
11501
11502 Removes an item from the sizer and destroys it. This method does not
11503 cause any layout or resizing to take place, call `Layout` to update
11504 the layout on screen after removing a child from the sizer. The
11505 *item* parameter can be either a window, a sizer, or the zero-based
11506 index of an item to remove. Returns True if the child item was found
11507 and removed.
11508 """
d55e5bfc
RD
11509 return _core_.Sizer_Remove(*args, **kwargs)
11510
1a6bba1e 11511 def Detach(*args, **kwargs):
248ed943
RD
11512 """
11513 Detach(self, item) -> bool
11514
11515 Detaches an item from the sizer without destroying it. This method
11516 does not cause any layout or resizing to take place, call `Layout` to
11517 do so. The *item* parameter can be either a window, a sizer, or the
11518 zero-based index of the item to be detached. Returns True if the child item
11519 was found and detached.
11520 """
1a6bba1e
RD
11521 return _core_.Sizer_Detach(*args, **kwargs)
11522
c1cb24a4
RD
11523 def GetItem(*args, **kwargs):
11524 """
11525 GetItem(self, item) -> wx.SizerItem
11526
11527 Returns the `wx.SizerItem` which holds the *item* given. The *item*
11528 parameter can be either a window, a sizer, or the zero-based index of
11529 the item to be detached.
11530 """
11531 return _core_.Sizer_GetItem(*args, **kwargs)
11532
d55e5bfc
RD
11533 def _SetItemMinSize(*args, **kwargs):
11534 """_SetItemMinSize(self, PyObject item, Size size)"""
11535 return _core_.Sizer__SetItemMinSize(*args, **kwargs)
11536
248ed943
RD
11537 def SetItemMinSize(self, item, *args):
11538 """
11539 SetItemMinSize(self, item, Size size)
11540
11541 Sets the minimum size that will be allocated for an item in the sizer.
11542 The *item* parameter can be either a window, a sizer, or the
11543 zero-based index of the item. If a window or sizer is given then it
11544 will be searched for recursivly in subsizers if neccessary.
11545 """
11546 if len(args) == 2:
11547 # for backward compatibility accept separate width,height args too
11548 return self._SetItemMinSize(item, args)
11549 else:
11550 return self._SetItemMinSize(item, args[0])
11551
d55e5bfc 11552 def AddItem(*args, **kwargs):
248ed943
RD
11553 """
11554 AddItem(self, SizerItem item)
11555
11556 Adds a `wx.SizerItem` to the sizer.
11557 """
d55e5bfc
RD
11558 return _core_.Sizer_AddItem(*args, **kwargs)
11559
11560 def InsertItem(*args, **kwargs):
248ed943
RD
11561 """
11562 InsertItem(self, int index, SizerItem item)
11563
11564 Inserts a `wx.SizerItem` to the sizer at the position given by *index*.
11565 """
d55e5bfc
RD
11566 return _core_.Sizer_InsertItem(*args, **kwargs)
11567
11568 def PrependItem(*args, **kwargs):
248ed943
RD
11569 """
11570 PrependItem(self, SizerItem item)
11571
11572 Prepends a `wx.SizerItem` to the sizer.
11573 """
d55e5bfc
RD
11574 return _core_.Sizer_PrependItem(*args, **kwargs)
11575
248ed943 11576 def AddMany(self, items):
c24da6d6
RD
11577 """
11578 AddMany is a convenience method for adding several items
11579 to a sizer at one time. Simply pass it a list of tuples,
11580 where each tuple consists of the parameters that you
11581 would normally pass to the `Add` method.
11582 """
248ed943
RD
11583 for item in items:
11584 if type(item) != type(()) or (len(item) == 2 and type(item[0]) == type(1)):
11585 item = (item, )
11586 self.Add(*item)
d55e5bfc
RD
11587
11588 # for backwards compatibility only, please do not use in new code
b9d6a5f3
RD
11589 def AddWindow(self, *args, **kw):
11590 """Compatibility alias for `Add`."""
11591 return self.Add(*args, **kw)
11592 def AddSizer(self, *args, **kw):
11593 """Compatibility alias for `Add`."""
11594 return self.Add(*args, **kw)
11595 def AddSpacer(self, *args, **kw):
11596 """Compatibility alias for `Add`."""
11597 return self.Add(*args, **kw)
11598
11599 def PrependWindow(self, *args, **kw):
11600 """Compatibility alias for `Prepend`."""
11601 return self.Prepend(*args, **kw)
11602 def PrependSizer(self, *args, **kw):
11603 """Compatibility alias for `Prepend`."""
11604 return self.Prepend(*args, **kw)
11605 def PrependSpacer(self, *args, **kw):
11606 """Compatibility alias for `Prepend`."""
11607 return self.Prepend(*args, **kw)
11608
11609 def InsertWindow(self, *args, **kw):
11610 """Compatibility alias for `Insert`."""
11611 return self.Insert(*args, **kw)
11612 def InsertSizer(self, *args, **kw):
11613 """Compatibility alias for `Insert`."""
11614 return self.Insert(*args, **kw)
11615 def InsertSpacer(self, *args, **kw):
11616 """Compatibility alias for `Insert`."""
11617 return self.Insert(*args, **kw)
11618
11619 def RemoveWindow(self, *args, **kw):
11620 """Compatibility alias for `Remove`."""
11621 return self.Remove(*args, **kw)
11622 def RemoveSizer(self, *args, **kw):
11623 """Compatibility alias for `Remove`."""
11624 return self.Remove(*args, **kw)
11625 def RemovePos(self, *args, **kw):
11626 """Compatibility alias for `Remove`."""
11627 return self.Remove(*args, **kw)
d55e5bfc
RD
11628
11629
d55e5bfc 11630 def SetDimension(*args, **kwargs):
248ed943
RD
11631 """
11632 SetDimension(self, int x, int y, int width, int height)
11633
11634 Call this to force the sizer to take the given dimension and thus
11635 force the items owned by the sizer to resize themselves according to
11636 the rules defined by the parameter in the `Add`, `Insert` or `Prepend`
11637 methods.
11638 """
d55e5bfc
RD
11639 return _core_.Sizer_SetDimension(*args, **kwargs)
11640
11641 def SetMinSize(*args, **kwargs):
248ed943
RD
11642 """
11643 SetMinSize(self, Size size)
11644
11645 Call this to give the sizer a minimal size. Normally, the sizer will
11646 calculate its minimal size based purely on how much space its children
11647 need. After calling this method `GetMinSize` will return either the
11648 minimal size as requested by its children or the minimal size set
11649 here, depending on which is bigger.
11650 """
d55e5bfc
RD
11651 return _core_.Sizer_SetMinSize(*args, **kwargs)
11652
11653 def GetSize(*args, **kwargs):
248ed943
RD
11654 """
11655 GetSize(self) -> Size
11656
11657 Returns the current size of the space managed by the sizer.
11658 """
d55e5bfc
RD
11659 return _core_.Sizer_GetSize(*args, **kwargs)
11660
11661 def GetPosition(*args, **kwargs):
248ed943
RD
11662 """
11663 GetPosition(self) -> Point
11664
11665 Returns the current position of the sizer's managed space.
11666 """
d55e5bfc
RD
11667 return _core_.Sizer_GetPosition(*args, **kwargs)
11668
11669 def GetMinSize(*args, **kwargs):
248ed943
RD
11670 """
11671 GetMinSize(self) -> Size
11672
11673 Returns the minimal size of the sizer. This is either the combined
11674 minimal size of all the children and their borders or the minimal size
11675 set by SetMinSize, depending on which is bigger.
11676 """
d55e5bfc
RD
11677 return _core_.Sizer_GetMinSize(*args, **kwargs)
11678
11679 def GetSizeTuple(self):
1a6bba1e 11680 return self.GetSize().Get()
d55e5bfc 11681 def GetPositionTuple(self):
1a6bba1e 11682 return self.GetPosition().Get()
d55e5bfc 11683 def GetMinSizeTuple(self):
1a6bba1e 11684 return self.GetMinSize().Get()
d55e5bfc
RD
11685
11686 def RecalcSizes(*args, **kwargs):
248ed943
RD
11687 """
11688 RecalcSizes(self)
11689
11690 Using the sizes calculated by `CalcMin` reposition and resize all the
11691 items managed by this sizer. You should not need to call this directly as
11692 it is called by `Layout`.
11693 """
d55e5bfc
RD
11694 return _core_.Sizer_RecalcSizes(*args, **kwargs)
11695
11696 def CalcMin(*args, **kwargs):
248ed943
RD
11697 """
11698 CalcMin(self) -> Size
11699
11700 This method is where the sizer will do the actual calculation of its
11701 children's minimal sizes. You should not need to call this directly as
11702 it is called by `Layout`.
11703 """
d55e5bfc
RD
11704 return _core_.Sizer_CalcMin(*args, **kwargs)
11705
11706 def Layout(*args, **kwargs):
248ed943
RD
11707 """
11708 Layout(self)
11709
11710 This method will force the recalculation and layout of the items
11711 controlled by the sizer using the current space allocated to the
11712 sizer. Normally this is called automatically from the owning window's
11713 EVT_SIZE handler, but it is also useful to call it from user code when
11714 one of the items in a sizer change size, or items are added or
11715 removed.
11716 """
d55e5bfc
RD
11717 return _core_.Sizer_Layout(*args, **kwargs)
11718
11719 def Fit(*args, **kwargs):
248ed943
RD
11720 """
11721 Fit(self, Window window) -> Size
11722
11723 Tell the sizer to resize the *window* to match the sizer's minimal
11724 size. This is commonly done in the constructor of the window itself in
11725 order to set its initial size to match the needs of the children as
11726 determined by the sizer. Returns the new size.
11727
11728 For a top level window this is the total window size, not the client size.
11729 """
d55e5bfc
RD
11730 return _core_.Sizer_Fit(*args, **kwargs)
11731
11732 def FitInside(*args, **kwargs):
248ed943
RD
11733 """
11734 FitInside(self, Window window)
11735
11736 Tell the sizer to resize the *virtual size* of the *window* to match the
11737 sizer's minimal size. This will not alter the on screen size of the
11738 window, but may cause the addition/removal/alteration of scrollbars
11739 required to view the virtual area in windows which manage it.
11740
11741 :see: `wx.ScrolledWindow.SetScrollbars`, `SetVirtualSizeHints`
11742
11743 """
d55e5bfc
RD
11744 return _core_.Sizer_FitInside(*args, **kwargs)
11745
11746 def SetSizeHints(*args, **kwargs):
248ed943
RD
11747 """
11748 SetSizeHints(self, Window window)
11749
11750 Tell the sizer to set (and `Fit`) the minimal size of the *window* to
11751 match the sizer's minimal size. This is commonly done in the
11752 constructor of the window itself if the window is resizable (as are
11753 many dialogs under Unix and frames on probably all platforms) in order
11754 to prevent the window from being sized smaller than the minimal size
11755 required by the sizer.
11756 """
d55e5bfc
RD
11757 return _core_.Sizer_SetSizeHints(*args, **kwargs)
11758
11759 def SetVirtualSizeHints(*args, **kwargs):
248ed943
RD
11760 """
11761 SetVirtualSizeHints(self, Window window)
11762
11763 Tell the sizer to set the minimal size of the window virtual area to
11764 match the sizer's minimal size. For windows with managed scrollbars
11765 this will set them appropriately.
11766
11767 :see: `wx.ScrolledWindow.SetScrollbars`
11768
11769 """
d55e5bfc
RD
11770 return _core_.Sizer_SetVirtualSizeHints(*args, **kwargs)
11771
11772 def Clear(*args, **kwargs):
248ed943
RD
11773 """
11774 Clear(self, bool deleteWindows=False)
11775
11776 Clear all items from the sizer, optionally destroying the window items
11777 as well.
11778 """
d55e5bfc
RD
11779 return _core_.Sizer_Clear(*args, **kwargs)
11780
11781 def DeleteWindows(*args, **kwargs):
248ed943
RD
11782 """
11783 DeleteWindows(self)
11784
11785 Destroy all windows managed by the sizer.
11786 """
d55e5bfc
RD
11787 return _core_.Sizer_DeleteWindows(*args, **kwargs)
11788
11789 def GetChildren(*args, **kwargs):
248ed943 11790 """
51b83b37 11791 GetChildren(self) -> list
248ed943
RD
11792
11793 Returns a list of all the `wx.SizerItem` objects managed by the sizer.
11794 """
d55e5bfc
RD
11795 return _core_.Sizer_GetChildren(*args, **kwargs)
11796
11797 def Show(*args, **kwargs):
248ed943 11798 """
ae8162c8 11799 Show(self, item, bool show=True, bool recursive=false) -> bool
d55e5bfc 11800
248ed943
RD
11801 Shows or hides an item managed by the sizer. To make a sizer item
11802 disappear or reappear, use Show followed by `Layout`. The *item*
11803 parameter can be either a window, a sizer, or the zero-based index of
629e65c2
RD
11804 the item. Use the recursive parameter to show or hide an item in a
11805 subsizer. Returns True if the item was found.
248ed943
RD
11806 """
11807 return _core_.Sizer_Show(*args, **kwargs)
d55e5bfc
RD
11808
11809 def IsShown(*args, **kwargs):
248ed943
RD
11810 """
11811 IsShown(self, item)
11812
11813 Determines if the item is currently shown. sizer. To make a sizer
11814 item disappear or reappear, use Show followed by `Layout`. The *item*
11815 parameter can be either a window, a sizer, or the zero-based index of
11816 the item.
11817 """
d55e5bfc
RD
11818 return _core_.Sizer_IsShown(*args, **kwargs)
11819
629e65c2 11820 def Hide(self, item, recursive=False):
248ed943 11821 """
27fb7603 11822 A convenience method for `Show` (item, False, recursive).
248ed943 11823 """
06759a38 11824 return self.Show(item, False, recursive)
248ed943 11825
d55e5bfc 11826 def ShowItems(*args, **kwargs):
248ed943
RD
11827 """
11828 ShowItems(self, bool show)
11829
84f85550 11830 Recursively call `wx.SizerItem.Show` on all sizer items.
248ed943 11831 """
d55e5bfc
RD
11832 return _core_.Sizer_ShowItems(*args, **kwargs)
11833
11834
11835class SizerPtr(Sizer):
11836 def __init__(self, this):
11837 self.this = this
11838 if not hasattr(self,"thisown"): self.thisown = 0
11839 self.__class__ = Sizer
11840_core_.Sizer_swigregister(SizerPtr)
11841
11842class PySizer(Sizer):
248ed943
RD
11843 """
11844 wx.PySizer is a special version of `wx.Sizer` that has been
11845 instrumented to allow the C++ virtual methods to be overloaded in
11846 Python derived classes. You would derive from this class if you are
11847 wanting to implement a custom sizer in Python code. Simply implement
11848 `CalcMin` and `RecalcSizes` in the derived class and you're all set.
11849 For example::
11850
11851 class MySizer(wx.PySizer):
11852 def __init__(self):
11853 wx.PySizer.__init__(self)
11854
11855 def CalcMin(self):
11856 for item in self.GetChildren():
11857 # calculate the total minimum width and height needed
11858 # by all items in the sizer according to this sizer's
11859 # layout algorithm.
11860 ...
11861 return wx.Size(width, height)
11862
11863 def RecalcSizes(self):
11864 # find the space allotted to this sizer
11865 pos = self.GetPosition()
11866 size = self.GetSize()
11867 for item in self.GetChildren():
11868 # Recalculate (if necessary) the position and size of
11869 # each item and then call item.SetDimension to do the
11870 # actual positioning and sizing of the items within the
11871 # space alloted to this sizer.
11872 ...
11873 item.SetDimension(itemPos, itemSize)
11874
11875
11876 When `Layout` is called it first calls `CalcMin` followed by
11877 `RecalcSizes` so you can optimize a bit by saving the results of
62d32a5f 11878 `CalcMin` and reusing them in `RecalcSizes`.
248ed943
RD
11879
11880 :see: `wx.SizerItem`, `wx.Sizer.GetChildren`
11881
11882
11883 """
d55e5bfc
RD
11884 def __repr__(self):
11885 return "<%s.%s; proxy of C++ wxPySizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
11886 def __init__(self, *args, **kwargs):
248ed943
RD
11887 """
11888 __init__(self) -> PySizer
11889
11890 Creates a wx.PySizer. Must be called from the __init__ in the derived
11891 class.
11892 """
d55e5bfc
RD
11893 newobj = _core_.new_PySizer(*args, **kwargs)
11894 self.this = newobj.this
11895 self.thisown = 1
11896 del newobj.thisown
11897 self._setCallbackInfo(self, PySizer);self._setOORInfo(self)
11898
11899 def _setCallbackInfo(*args, **kwargs):
11900 """_setCallbackInfo(self, PyObject self, PyObject _class)"""
11901 return _core_.PySizer__setCallbackInfo(*args, **kwargs)
11902
11903
11904class PySizerPtr(PySizer):
11905 def __init__(self, this):
11906 self.this = this
11907 if not hasattr(self,"thisown"): self.thisown = 0
11908 self.__class__ = PySizer
11909_core_.PySizer_swigregister(PySizerPtr)
11910
11911#---------------------------------------------------------------------------
11912
11913class BoxSizer(Sizer):
248ed943
RD
11914 """
11915 The basic idea behind a box sizer is that windows will most often be
11916 laid out in rather simple basic geometry, typically in a row or a
11917 column or nested hierarchies of either. A wx.BoxSizer will lay out
11918 its items in a simple row or column, depending on the orientation
11919 parameter passed to the constructor.
11920 """
d55e5bfc
RD
11921 def __repr__(self):
11922 return "<%s.%s; proxy of C++ wxBoxSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
11923 def __init__(self, *args, **kwargs):
248ed943
RD
11924 """
11925 __init__(self, int orient=HORIZONTAL) -> BoxSizer
11926
11927 Constructor for a wx.BoxSizer. *orient* may be one of ``wx.VERTICAL``
11928 or ``wx.HORIZONTAL`` for creating either a column sizer or a row
11929 sizer.
11930 """
d55e5bfc
RD
11931 newobj = _core_.new_BoxSizer(*args, **kwargs)
11932 self.this = newobj.this
11933 self.thisown = 1
11934 del newobj.thisown
11935 self._setOORInfo(self)
11936
11937 def GetOrientation(*args, **kwargs):
248ed943
RD
11938 """
11939 GetOrientation(self) -> int
11940
11941 Returns the current orientation of the sizer.
11942 """
d55e5bfc
RD
11943 return _core_.BoxSizer_GetOrientation(*args, **kwargs)
11944
11945 def SetOrientation(*args, **kwargs):
248ed943
RD
11946 """
11947 SetOrientation(self, int orient)
d55e5bfc 11948
248ed943
RD
11949 Resets the orientation of the sizer.
11950 """
11951 return _core_.BoxSizer_SetOrientation(*args, **kwargs)
d55e5bfc
RD
11952
11953
11954class BoxSizerPtr(BoxSizer):
11955 def __init__(self, this):
11956 self.this = this
11957 if not hasattr(self,"thisown"): self.thisown = 0
11958 self.__class__ = BoxSizer
11959_core_.BoxSizer_swigregister(BoxSizerPtr)
11960
11961#---------------------------------------------------------------------------
11962
11963class StaticBoxSizer(BoxSizer):
248ed943
RD
11964 """
11965 wx.StaticBoxSizer derives from and functions identically to the
11966 `wx.BoxSizer` and adds a `wx.StaticBox` around the items that the sizer
11967 manages. Note that this static box must be created separately and
11968 passed to the sizer constructor.
11969 """
d55e5bfc
RD
11970 def __repr__(self):
11971 return "<%s.%s; proxy of C++ wxStaticBoxSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
11972 def __init__(self, *args, **kwargs):
248ed943
RD
11973 """
11974 __init__(self, StaticBox box, int orient=HORIZONTAL) -> StaticBoxSizer
11975
11976 Constructor. It takes an associated static box and the orientation
11977 *orient* as parameters - orient can be either of ``wx.VERTICAL`` or
11978 ``wx.HORIZONTAL``.
11979 """
d55e5bfc
RD
11980 newobj = _core_.new_StaticBoxSizer(*args, **kwargs)
11981 self.this = newobj.this
11982 self.thisown = 1
11983 del newobj.thisown
11984 self._setOORInfo(self)
11985
11986 def GetStaticBox(*args, **kwargs):
248ed943
RD
11987 """
11988 GetStaticBox(self) -> StaticBox
d55e5bfc 11989
248ed943
RD
11990 Returns the static box associated with this sizer.
11991 """
11992 return _core_.StaticBoxSizer_GetStaticBox(*args, **kwargs)
d55e5bfc
RD
11993
11994
11995class StaticBoxSizerPtr(StaticBoxSizer):
11996 def __init__(self, this):
11997 self.this = this
11998 if not hasattr(self,"thisown"): self.thisown = 0
11999 self.__class__ = StaticBoxSizer
12000_core_.StaticBoxSizer_swigregister(StaticBoxSizerPtr)
12001
12002#---------------------------------------------------------------------------
12003
12004class GridSizer(Sizer):
248ed943
RD
12005 """
12006 A grid sizer is a sizer which lays out its children in a
12007 two-dimensional table with all cells having the same size. In other
12008 words, the width of each cell within the grid is the width of the
12009 widest item added to the sizer and the height of each grid cell is the
12010 height of the tallest item. An optional vertical and/or horizontal
12011 gap between items can also be specified (in pixels.)
12012
12013 Items are placed in the cells of the grid in the order they are added,
12014 in row-major order. In other words, the first row is filled first,
12015 then the second, and so on until all items have been added. (If
12016 neccessary, additional rows will be added as items are added.) If you
12017 need to have greater control over the cells that items are placed in
12018 then use the `wx.GridBagSizer`.
12019
12020 """
d55e5bfc
RD
12021 def __repr__(self):
12022 return "<%s.%s; proxy of C++ wxGridSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12023 def __init__(self, *args, **kwargs):
248ed943
RD
12024 """
12025 __init__(self, int rows=1, int cols=0, int vgap=0, int hgap=0) -> GridSizer
12026
12027 Constructor for a wx.GridSizer. *rows* and *cols* determine the number
12028 of columns and rows in the sizer - if either of the parameters is
12029 zero, it will be calculated to from the total number of children in
12030 the sizer, thus making the sizer grow dynamically. *vgap* and *hgap*
12031 define extra space between all children.
12032 """
d55e5bfc
RD
12033 newobj = _core_.new_GridSizer(*args, **kwargs)
12034 self.this = newobj.this
12035 self.thisown = 1
12036 del newobj.thisown
12037 self._setOORInfo(self)
12038
d55e5bfc 12039 def SetCols(*args, **kwargs):
248ed943
RD
12040 """
12041 SetCols(self, int cols)
12042
12043 Sets the number of columns in the sizer.
12044 """
d55e5bfc
RD
12045 return _core_.GridSizer_SetCols(*args, **kwargs)
12046
12047 def SetRows(*args, **kwargs):
248ed943
RD
12048 """
12049 SetRows(self, int rows)
12050
12051 Sets the number of rows in the sizer.
12052 """
d55e5bfc
RD
12053 return _core_.GridSizer_SetRows(*args, **kwargs)
12054
12055 def SetVGap(*args, **kwargs):
248ed943
RD
12056 """
12057 SetVGap(self, int gap)
12058
12059 Sets the vertical gap (in pixels) between the cells in the sizer.
12060 """
d55e5bfc
RD
12061 return _core_.GridSizer_SetVGap(*args, **kwargs)
12062
12063 def SetHGap(*args, **kwargs):
248ed943
RD
12064 """
12065 SetHGap(self, int gap)
12066
12067 Sets the horizontal gap (in pixels) between cells in the sizer
12068 """
d55e5bfc
RD
12069 return _core_.GridSizer_SetHGap(*args, **kwargs)
12070
12071 def GetCols(*args, **kwargs):
248ed943
RD
12072 """
12073 GetCols(self) -> int
12074
12075 Returns the number of columns in the sizer.
12076 """
d55e5bfc
RD
12077 return _core_.GridSizer_GetCols(*args, **kwargs)
12078
12079 def GetRows(*args, **kwargs):
248ed943
RD
12080 """
12081 GetRows(self) -> int
12082
12083 Returns the number of rows in the sizer.
12084 """
d55e5bfc
RD
12085 return _core_.GridSizer_GetRows(*args, **kwargs)
12086
12087 def GetVGap(*args, **kwargs):
248ed943
RD
12088 """
12089 GetVGap(self) -> int
12090
12091 Returns the vertical gap (in pixels) between the cells in the sizer.
12092 """
d55e5bfc
RD
12093 return _core_.GridSizer_GetVGap(*args, **kwargs)
12094
12095 def GetHGap(*args, **kwargs):
248ed943
RD
12096 """
12097 GetHGap(self) -> int
12098
12099 Returns the horizontal gap (in pixels) between cells in the sizer.
12100 """
d55e5bfc
RD
12101 return _core_.GridSizer_GetHGap(*args, **kwargs)
12102
12103
12104class GridSizerPtr(GridSizer):
12105 def __init__(self, this):
12106 self.this = this
12107 if not hasattr(self,"thisown"): self.thisown = 0
12108 self.__class__ = GridSizer
12109_core_.GridSizer_swigregister(GridSizerPtr)
12110
12111#---------------------------------------------------------------------------
12112
12113FLEX_GROWMODE_NONE = _core_.FLEX_GROWMODE_NONE
12114FLEX_GROWMODE_SPECIFIED = _core_.FLEX_GROWMODE_SPECIFIED
12115FLEX_GROWMODE_ALL = _core_.FLEX_GROWMODE_ALL
12116class FlexGridSizer(GridSizer):
248ed943
RD
12117 """
12118 A flex grid sizer is a sizer which lays out its children in a
12119 two-dimensional table with all table cells in one row having the same
12120 height and all cells in one column having the same width, but all
12121 rows or all columns are not necessarily the same height or width as in
12122 the `wx.GridSizer`.
12123
12124 wx.FlexGridSizer can also size items equally in one direction but
12125 unequally ("flexibly") in the other. If the sizer is only flexible
12126 in one direction (this can be changed using `SetFlexibleDirection`), it
12127 needs to be decided how the sizer should grow in the other ("non
12128 flexible") direction in order to fill the available space. The
12129 `SetNonFlexibleGrowMode` method serves this purpose.
12130
12131
12132 """
d55e5bfc
RD
12133 def __repr__(self):
12134 return "<%s.%s; proxy of C++ wxFlexGridSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12135 def __init__(self, *args, **kwargs):
248ed943
RD
12136 """
12137 __init__(self, int rows=1, int cols=0, int vgap=0, int hgap=0) -> FlexGridSizer
12138
12139 Constructor for a wx.FlexGridSizer. *rows* and *cols* determine the
12140 number of columns and rows in the sizer - if either of the parameters
12141 is zero, it will be calculated to from the total number of children in
12142 the sizer, thus making the sizer grow dynamically. *vgap* and *hgap*
12143 define extra space between all children.
12144 """
d55e5bfc
RD
12145 newobj = _core_.new_FlexGridSizer(*args, **kwargs)
12146 self.this = newobj.this
12147 self.thisown = 1
12148 del newobj.thisown
12149 self._setOORInfo(self)
12150
248ed943
RD
12151 def AddGrowableRow(*args, **kwargs):
12152 """
12153 AddGrowableRow(self, size_t idx, int proportion=0)
d55e5bfc 12154
248ed943
RD
12155 Specifies that row *idx* (starting from zero) should be grown if there
12156 is extra space available to the sizer.
d55e5bfc 12157
248ed943
RD
12158 The *proportion* parameter has the same meaning as the stretch factor
12159 for the box sizers except that if all proportions are 0, then all
12160 columns are resized equally (instead of not being resized at all).
12161 """
d55e5bfc
RD
12162 return _core_.FlexGridSizer_AddGrowableRow(*args, **kwargs)
12163
12164 def RemoveGrowableRow(*args, **kwargs):
248ed943
RD
12165 """
12166 RemoveGrowableRow(self, size_t idx)
12167
12168 Specifies that row *idx* is no longer growable.
12169 """
d55e5bfc
RD
12170 return _core_.FlexGridSizer_RemoveGrowableRow(*args, **kwargs)
12171
12172 def AddGrowableCol(*args, **kwargs):
248ed943
RD
12173 """
12174 AddGrowableCol(self, size_t idx, int proportion=0)
12175
12176 Specifies that column *idx* (starting from zero) should be grown if
12177 there is extra space available to the sizer.
12178
12179 The *proportion* parameter has the same meaning as the stretch factor
12180 for the box sizers except that if all proportions are 0, then all
12181 columns are resized equally (instead of not being resized at all).
12182 """
d55e5bfc
RD
12183 return _core_.FlexGridSizer_AddGrowableCol(*args, **kwargs)
12184
12185 def RemoveGrowableCol(*args, **kwargs):
248ed943
RD
12186 """
12187 RemoveGrowableCol(self, size_t idx)
12188
12189 Specifies that column *idx* is no longer growable.
12190 """
d55e5bfc
RD
12191 return _core_.FlexGridSizer_RemoveGrowableCol(*args, **kwargs)
12192
12193 def SetFlexibleDirection(*args, **kwargs):
248ed943
RD
12194 """
12195 SetFlexibleDirection(self, int direction)
12196
12197 Specifies whether the sizer should flexibly resize its columns, rows,
12198 or both. Argument *direction* can be one of the following values. Any
12199 other value is ignored.
12200
12201 ============== =======================================
12202 wx.VERTICAL Rows are flexibly sized.
12203 wx.HORIZONTAL Columns are flexibly sized.
12204 wx.BOTH Both rows and columns are flexibly sized
12205 (this is the default value).
12206 ============== =======================================
12207
12208 Note that this method does not trigger relayout.
12209
12210 """
d55e5bfc
RD
12211 return _core_.FlexGridSizer_SetFlexibleDirection(*args, **kwargs)
12212
12213 def GetFlexibleDirection(*args, **kwargs):
248ed943
RD
12214 """
12215 GetFlexibleDirection(self) -> int
12216
12217 Returns a value that specifies whether the sizer
12218 flexibly resizes its columns, rows, or both (default).
12219
12220 :see: `SetFlexibleDirection`
12221 """
d55e5bfc
RD
12222 return _core_.FlexGridSizer_GetFlexibleDirection(*args, **kwargs)
12223
12224 def SetNonFlexibleGrowMode(*args, **kwargs):
248ed943
RD
12225 """
12226 SetNonFlexibleGrowMode(self, int mode)
12227
12228 Specifies how the sizer should grow in the non-flexible direction if
12229 there is one (so `SetFlexibleDirection` must have been called
12230 previously). Argument *mode* can be one of the following values:
12231
12232 ========================== =================================================
12233 wx.FLEX_GROWMODE_NONE Sizer doesn't grow in the non flexible direction.
12234 wx.FLEX_GROWMODE_SPECIFIED Sizer honors growable columns/rows set with
12235 `AddGrowableCol` and `AddGrowableRow`. In this
12236 case equal sizing applies to minimum sizes of
12237 columns or rows (this is the default value).
12238 wx.FLEX_GROWMODE_ALL Sizer equally stretches all columns or rows in
12239 the non flexible direction, whether they are
12240 growable or not in the flexbile direction.
12241 ========================== =================================================
12242
12243 Note that this method does not trigger relayout.
12244
12245
12246 """
d55e5bfc
RD
12247 return _core_.FlexGridSizer_SetNonFlexibleGrowMode(*args, **kwargs)
12248
12249 def GetNonFlexibleGrowMode(*args, **kwargs):
248ed943
RD
12250 """
12251 GetNonFlexibleGrowMode(self) -> int
12252
12253 Returns the value that specifies how the sizer grows in the
12254 non-flexible direction if there is one.
12255
12256 :see: `SetNonFlexibleGrowMode`
12257 """
d55e5bfc
RD
12258 return _core_.FlexGridSizer_GetNonFlexibleGrowMode(*args, **kwargs)
12259
12260 def GetRowHeights(*args, **kwargs):
a8eff060
RD
12261 """
12262 GetRowHeights(self) -> list
12263
12264 Returns a list of integers representing the heights of each of the
12265 rows in the sizer.
12266 """
d55e5bfc
RD
12267 return _core_.FlexGridSizer_GetRowHeights(*args, **kwargs)
12268
12269 def GetColWidths(*args, **kwargs):
a8eff060
RD
12270 """
12271 GetColWidths(self) -> list
12272
12273 Returns a list of integers representing the widths of each of the
12274 columns in the sizer.
12275 """
d55e5bfc
RD
12276 return _core_.FlexGridSizer_GetColWidths(*args, **kwargs)
12277
12278
12279class FlexGridSizerPtr(FlexGridSizer):
12280 def __init__(self, this):
12281 self.this = this
12282 if not hasattr(self,"thisown"): self.thisown = 0
12283 self.__class__ = FlexGridSizer
12284_core_.FlexGridSizer_swigregister(FlexGridSizerPtr)
12285
62d32a5f
RD
12286class StdDialogButtonSizer(BoxSizer):
12287 """
12288 A special sizer that knows how to order and position standard buttons
12289 in order to conform to the current platform's standards. You simply
12290 need to add each `wx.Button` to the sizer, and be sure to create the
53aa7709 12291 buttons using the standard ID's. Then call `Realize` and the sizer
62d32a5f
RD
12292 will take care of the rest.
12293
12294 """
12295 def __repr__(self):
12296 return "<%s.%s; proxy of C++ wxStdDialogButtonSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12297 def __init__(self, *args, **kwargs):
12298 """__init__(self) -> StdDialogButtonSizer"""
12299 newobj = _core_.new_StdDialogButtonSizer(*args, **kwargs)
12300 self.this = newobj.this
12301 self.thisown = 1
12302 del newobj.thisown
12303 def AddButton(*args, **kwargs):
12304 """
12305 AddButton(self, wxButton button)
12306
12307 Use this to add the buttons to this sizer. Do not use the `Add`
12308 method in the base class.
12309 """
12310 return _core_.StdDialogButtonSizer_AddButton(*args, **kwargs)
12311
53aa7709 12312 def Realize(*args, **kwargs):
62d32a5f 12313 """
53aa7709 12314 Realize(self)
62d32a5f
RD
12315
12316 This funciton needs to be called after all the buttons have been added
12317 to the sizer. It will reorder them and position them in a platform
12318 specifc manner.
12319 """
53aa7709 12320 return _core_.StdDialogButtonSizer_Realize(*args, **kwargs)
51b83b37
RD
12321
12322 def SetAffirmativeButton(*args, **kwargs):
12323 """SetAffirmativeButton(self, wxButton button)"""
12324 return _core_.StdDialogButtonSizer_SetAffirmativeButton(*args, **kwargs)
12325
12326 def SetNegativeButton(*args, **kwargs):
12327 """SetNegativeButton(self, wxButton button)"""
12328 return _core_.StdDialogButtonSizer_SetNegativeButton(*args, **kwargs)
12329
12330 def SetCancelButton(*args, **kwargs):
12331 """SetCancelButton(self, wxButton button)"""
12332 return _core_.StdDialogButtonSizer_SetCancelButton(*args, **kwargs)
62d32a5f
RD
12333
12334 def GetAffirmativeButton(*args, **kwargs):
12335 """GetAffirmativeButton(self) -> wxButton"""
12336 return _core_.StdDialogButtonSizer_GetAffirmativeButton(*args, **kwargs)
12337
12338 def GetApplyButton(*args, **kwargs):
12339 """GetApplyButton(self) -> wxButton"""
12340 return _core_.StdDialogButtonSizer_GetApplyButton(*args, **kwargs)
12341
12342 def GetNegativeButton(*args, **kwargs):
12343 """GetNegativeButton(self) -> wxButton"""
12344 return _core_.StdDialogButtonSizer_GetNegativeButton(*args, **kwargs)
12345
12346 def GetCancelButton(*args, **kwargs):
12347 """GetCancelButton(self) -> wxButton"""
12348 return _core_.StdDialogButtonSizer_GetCancelButton(*args, **kwargs)
12349
12350 def GetHelpButton(*args, **kwargs):
12351 """GetHelpButton(self) -> wxButton"""
12352 return _core_.StdDialogButtonSizer_GetHelpButton(*args, **kwargs)
12353
12354
12355class StdDialogButtonSizerPtr(StdDialogButtonSizer):
12356 def __init__(self, this):
12357 self.this = this
12358 if not hasattr(self,"thisown"): self.thisown = 0
12359 self.__class__ = StdDialogButtonSizer
12360_core_.StdDialogButtonSizer_swigregister(StdDialogButtonSizerPtr)
12361
d55e5bfc
RD
12362#---------------------------------------------------------------------------
12363
12364class GBPosition(object):
248ed943
RD
12365 """
12366 This class represents the position of an item in a virtual grid of
12367 rows and columns managed by a `wx.GridBagSizer`. wxPython has
12368 typemaps that will automatically convert from a 2-element sequence of
12369 integers to a wx.GBPosition, so you can use the more pythonic
12370 representation of the position nearly transparently in Python code.
12371 """
d55e5bfc
RD
12372 def __repr__(self):
12373 return "<%s.%s; proxy of C++ wxGBPosition instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12374 def __init__(self, *args, **kwargs):
248ed943
RD
12375 """
12376 __init__(self, int row=0, int col=0) -> GBPosition
12377
12378 This class represents the position of an item in a virtual grid of
12379 rows and columns managed by a `wx.GridBagSizer`. wxPython has
12380 typemaps that will automatically convert from a 2-element sequence of
12381 integers to a wx.GBPosition, so you can use the more pythonic
12382 representation of the position nearly transparently in Python code.
12383 """
d55e5bfc
RD
12384 newobj = _core_.new_GBPosition(*args, **kwargs)
12385 self.this = newobj.this
12386 self.thisown = 1
12387 del newobj.thisown
12388 def GetRow(*args, **kwargs):
12389 """GetRow(self) -> int"""
12390 return _core_.GBPosition_GetRow(*args, **kwargs)
12391
12392 def GetCol(*args, **kwargs):
12393 """GetCol(self) -> int"""
12394 return _core_.GBPosition_GetCol(*args, **kwargs)
12395
12396 def SetRow(*args, **kwargs):
12397 """SetRow(self, int row)"""
12398 return _core_.GBPosition_SetRow(*args, **kwargs)
12399
12400 def SetCol(*args, **kwargs):
12401 """SetCol(self, int col)"""
12402 return _core_.GBPosition_SetCol(*args, **kwargs)
12403
12404 def __eq__(*args, **kwargs):
12405 """__eq__(self, GBPosition other) -> bool"""
12406 return _core_.GBPosition___eq__(*args, **kwargs)
12407
12408 def __ne__(*args, **kwargs):
12409 """__ne__(self, GBPosition other) -> bool"""
12410 return _core_.GBPosition___ne__(*args, **kwargs)
12411
12412 def Set(*args, **kwargs):
12413 """Set(self, int row=0, int col=0)"""
12414 return _core_.GBPosition_Set(*args, **kwargs)
12415
12416 def Get(*args, **kwargs):
12417 """Get(self) -> PyObject"""
12418 return _core_.GBPosition_Get(*args, **kwargs)
12419
79fccf9d 12420 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
d55e5bfc
RD
12421 def __str__(self): return str(self.Get())
12422 def __repr__(self): return 'wx.GBPosition'+str(self.Get())
12423 def __len__(self): return len(self.Get())
12424 def __getitem__(self, index): return self.Get()[index]
12425 def __setitem__(self, index, val):
12426 if index == 0: self.SetRow(val)
12427 elif index == 1: self.SetCol(val)
12428 else: raise IndexError
12429 def __nonzero__(self): return self.Get() != (0,0)
12430 __safe_for_unpickling__ = True
12431 def __reduce__(self): return (wx.GBPosition, self.Get())
12432
12433 row = property(GetRow, SetRow)
12434 col = property(GetCol, SetCol)
12435
12436
12437class GBPositionPtr(GBPosition):
12438 def __init__(self, this):
12439 self.this = this
12440 if not hasattr(self,"thisown"): self.thisown = 0
12441 self.__class__ = GBPosition
12442_core_.GBPosition_swigregister(GBPositionPtr)
12443
12444class GBSpan(object):
248ed943
RD
12445 """
12446 This class is used to hold the row and column spanning attributes of
12447 items in a `wx.GridBagSizer`. wxPython has typemaps that will
12448 automatically convert from a 2-element sequence of integers to a
12449 wx.GBSpan, so you can use the more pythonic representation of the span
12450 nearly transparently in Python code.
12451
12452 """
d55e5bfc
RD
12453 def __repr__(self):
12454 return "<%s.%s; proxy of C++ wxGBSpan instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12455 def __init__(self, *args, **kwargs):
248ed943
RD
12456 """
12457 __init__(self, int rowspan=1, int colspan=1) -> GBSpan
12458
12459 Construct a new wxGBSpan, optionally setting the rowspan and
12460 colspan. The default is (1,1). (Meaning that the item occupies one
12461 cell in each direction.
12462 """
d55e5bfc
RD
12463 newobj = _core_.new_GBSpan(*args, **kwargs)
12464 self.this = newobj.this
12465 self.thisown = 1
12466 del newobj.thisown
12467 def GetRowspan(*args, **kwargs):
12468 """GetRowspan(self) -> int"""
12469 return _core_.GBSpan_GetRowspan(*args, **kwargs)
12470
12471 def GetColspan(*args, **kwargs):
12472 """GetColspan(self) -> int"""
12473 return _core_.GBSpan_GetColspan(*args, **kwargs)
12474
12475 def SetRowspan(*args, **kwargs):
12476 """SetRowspan(self, int rowspan)"""
12477 return _core_.GBSpan_SetRowspan(*args, **kwargs)
12478
12479 def SetColspan(*args, **kwargs):
12480 """SetColspan(self, int colspan)"""
12481 return _core_.GBSpan_SetColspan(*args, **kwargs)
12482
12483 def __eq__(*args, **kwargs):
12484 """__eq__(self, GBSpan other) -> bool"""
12485 return _core_.GBSpan___eq__(*args, **kwargs)
12486
12487 def __ne__(*args, **kwargs):
12488 """__ne__(self, GBSpan other) -> bool"""
12489 return _core_.GBSpan___ne__(*args, **kwargs)
12490
12491 def Set(*args, **kwargs):
12492 """Set(self, int rowspan=1, int colspan=1)"""
12493 return _core_.GBSpan_Set(*args, **kwargs)
12494
12495 def Get(*args, **kwargs):
12496 """Get(self) -> PyObject"""
12497 return _core_.GBSpan_Get(*args, **kwargs)
12498
79fccf9d 12499 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
d55e5bfc
RD
12500 def __str__(self): return str(self.Get())
12501 def __repr__(self): return 'wx.GBSpan'+str(self.Get())
12502 def __len__(self): return len(self.Get())
12503 def __getitem__(self, index): return self.Get()[index]
12504 def __setitem__(self, index, val):
12505 if index == 0: self.SetRowspan(val)
12506 elif index == 1: self.SetColspan(val)
12507 else: raise IndexError
12508 def __nonzero__(self): return self.Get() != (0,0)
12509 __safe_for_unpickling__ = True
12510 def __reduce__(self): return (wx.GBSpan, self.Get())
12511
12512 rowspan = property(GetRowspan, SetRowspan)
12513 colspan = property(GetColspan, SetColspan)
12514
12515
12516class GBSpanPtr(GBSpan):
12517 def __init__(self, this):
12518 self.this = this
12519 if not hasattr(self,"thisown"): self.thisown = 0
12520 self.__class__ = GBSpan
12521_core_.GBSpan_swigregister(GBSpanPtr)
12522
12523class GBSizerItem(SizerItem):
248ed943
RD
12524 """
12525 The wx.GBSizerItem class is used to track the additional data about
12526 items in a `wx.GridBagSizer` such as the item's position in the grid
12527 and how many rows or columns it spans.
12528
12529 """
d55e5bfc
RD
12530 def __repr__(self):
12531 return "<%s.%s; proxy of C++ wxGBSizerItem instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12532 def __init__(self, *args, **kwargs):
248ed943
RD
12533 """
12534 __init__(self) -> GBSizerItem
12535
12536 Constructs an empty wx.GBSizerItem. Either a window, sizer or spacer
12537 size will need to be set, as well as a position and span before this
12538 item can be used in a Sizer.
12539
12540 You will probably never need to create a wx.GBSizerItem directly as they
12541 are created automatically when the sizer's Add method is called.
12542 """
d55e5bfc
RD
12543 newobj = _core_.new_GBSizerItem(*args, **kwargs)
12544 self.this = newobj.this
12545 self.thisown = 1
12546 del newobj.thisown
12547 def GetPos(*args, **kwargs):
248ed943
RD
12548 """
12549 GetPos(self) -> GBPosition
12550
12551 Get the grid position of the item
12552 """
d55e5bfc
RD
12553 return _core_.GBSizerItem_GetPos(*args, **kwargs)
12554
12555 def GetPosTuple(self): return self.GetPos().Get()
12556 def GetSpan(*args, **kwargs):
248ed943
RD
12557 """
12558 GetSpan(self) -> GBSpan
12559
12560 Get the row and column spanning of the item
12561 """
d55e5bfc
RD
12562 return _core_.GBSizerItem_GetSpan(*args, **kwargs)
12563
12564 def GetSpanTuple(self): return self.GetSpan().Get()
12565 def SetPos(*args, **kwargs):
248ed943
RD
12566 """
12567 SetPos(self, GBPosition pos) -> bool
12568
12569 If the item is already a member of a sizer then first ensure that
12570 there is no other item that would intersect with this one at the new
12571 position, then set the new position. Returns True if the change is
12572 successful and after the next Layout() the item will be moved.
12573 """
d55e5bfc
RD
12574 return _core_.GBSizerItem_SetPos(*args, **kwargs)
12575
12576 def SetSpan(*args, **kwargs):
248ed943
RD
12577 """
12578 SetSpan(self, GBSpan span) -> bool
12579
12580 If the item is already a member of a sizer then first ensure that
12581 there is no other item that would intersect with this one with its new
12582 spanning size, then set the new spanning. Returns True if the change
12583 is successful and after the next Layout() the item will be resized.
12584
12585 """
d55e5bfc
RD
12586 return _core_.GBSizerItem_SetSpan(*args, **kwargs)
12587
248ed943 12588 def Intersects(*args, **kwargs):
d55e5bfc
RD
12589 """
12590 Intersects(self, GBSizerItem other) -> bool
248ed943
RD
12591
12592 Returns True if this item and the other item instersect.
d55e5bfc 12593 """
248ed943
RD
12594 return _core_.GBSizerItem_Intersects(*args, **kwargs)
12595
12596 def IntersectsPos(*args, **kwargs):
12597 """
12598 IntersectsPos(self, GBPosition pos, GBSpan span) -> bool
12599
12600 Returns True if the given pos/span would intersect with this item.
12601 """
12602 return _core_.GBSizerItem_IntersectsPos(*args, **kwargs)
d55e5bfc
RD
12603
12604 def GetEndPos(*args, **kwargs):
248ed943
RD
12605 """
12606 GetEndPos(self) -> GBPosition
12607
12608 Get the row and column of the endpoint of this item.
12609 """
d55e5bfc
RD
12610 return _core_.GBSizerItem_GetEndPos(*args, **kwargs)
12611
12612 def GetGBSizer(*args, **kwargs):
248ed943
RD
12613 """
12614 GetGBSizer(self) -> GridBagSizer
12615
12616 Get the sizer this item is a member of.
12617 """
d55e5bfc
RD
12618 return _core_.GBSizerItem_GetGBSizer(*args, **kwargs)
12619
12620 def SetGBSizer(*args, **kwargs):
248ed943
RD
12621 """
12622 SetGBSizer(self, GridBagSizer sizer)
12623
12624 Set the sizer this item is a member of.
12625 """
d55e5bfc
RD
12626 return _core_.GBSizerItem_SetGBSizer(*args, **kwargs)
12627
12628
12629class GBSizerItemPtr(GBSizerItem):
12630 def __init__(self, this):
12631 self.this = this
12632 if not hasattr(self,"thisown"): self.thisown = 0
12633 self.__class__ = GBSizerItem
12634_core_.GBSizerItem_swigregister(GBSizerItemPtr)
12635DefaultSpan = cvar.DefaultSpan
12636
12637def GBSizerItemWindow(*args, **kwargs):
12638 """
12639 GBSizerItemWindow(Window window, GBPosition pos, GBSpan span, int flag,
248ed943
RD
12640 int border, PyObject userData=None) -> GBSizerItem
12641
12642 Construct a `wx.GBSizerItem` for a window.
d55e5bfc
RD
12643 """
12644 val = _core_.new_GBSizerItemWindow(*args, **kwargs)
12645 val.thisown = 1
12646 return val
12647
12648def GBSizerItemSizer(*args, **kwargs):
12649 """
12650 GBSizerItemSizer(Sizer sizer, GBPosition pos, GBSpan span, int flag,
248ed943
RD
12651 int border, PyObject userData=None) -> GBSizerItem
12652
12653 Construct a `wx.GBSizerItem` for a sizer
d55e5bfc
RD
12654 """
12655 val = _core_.new_GBSizerItemSizer(*args, **kwargs)
12656 val.thisown = 1
12657 return val
12658
12659def GBSizerItemSpacer(*args, **kwargs):
12660 """
12661 GBSizerItemSpacer(int width, int height, GBPosition pos, GBSpan span,
248ed943
RD
12662 int flag, int border, PyObject userData=None) -> GBSizerItem
12663
12664 Construct a `wx.GBSizerItem` for a spacer.
d55e5bfc
RD
12665 """
12666 val = _core_.new_GBSizerItemSpacer(*args, **kwargs)
12667 val.thisown = 1
12668 return val
12669
12670class GridBagSizer(FlexGridSizer):
248ed943
RD
12671 """
12672 A `wx.Sizer` that can lay out items in a virtual grid like a
12673 `wx.FlexGridSizer` but in this case explicit positioning of the items
12674 is allowed using `wx.GBPosition`, and items can optionally span more
12675 than one row and/or column using `wx.GBSpan`. The total size of the
12676 virtual grid is determined by the largest row and column that items are
12677 positioned at, adjusted for spanning.
12678
12679 """
d55e5bfc
RD
12680 def __repr__(self):
12681 return "<%s.%s; proxy of C++ wxGridBagSizer instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12682 def __init__(self, *args, **kwargs):
248ed943
RD
12683 """
12684 __init__(self, int vgap=0, int hgap=0) -> GridBagSizer
12685
12686 Constructor, with optional parameters to specify the gap between the
12687 rows and columns.
12688 """
d55e5bfc
RD
12689 newobj = _core_.new_GridBagSizer(*args, **kwargs)
12690 self.this = newobj.this
12691 self.thisown = 1
12692 del newobj.thisown
c9c2cf70
RD
12693 self._setOORInfo(self)
12694
d55e5bfc
RD
12695 def Add(*args, **kwargs):
12696 """
248ed943 12697 Add(self, item, GBPosition pos, GBSpan span=DefaultSpan, int flag=0,
c1cb24a4 12698 int border=0, userData=None) -> wx.GBSizerItem
248ed943
RD
12699
12700 Adds an item to the sizer at the grid cell *pos*, optionally spanning
12701 more than one row or column as specified with *span*. The remaining
12702 args behave similarly to `wx.Sizer.Add`.
12703
12704 Returns True if the item was successfully placed at the given cell
12705 position, False if something was already there.
12706
d55e5bfc
RD
12707 """
12708 return _core_.GridBagSizer_Add(*args, **kwargs)
12709
12710 def AddItem(*args, **kwargs):
248ed943 12711 """
c1cb24a4 12712 Add(self, GBSizerItem item) -> wx.GBSizerItem
248ed943
RD
12713
12714 Add an item to the sizer using a `wx.GBSizerItem`. Returns True if
12715 the item was successfully placed at its given cell position, False if
12716 something was already there.
12717 """
d55e5bfc
RD
12718 return _core_.GridBagSizer_AddItem(*args, **kwargs)
12719
84f85550
RD
12720 def GetCellSize(*args, **kwargs):
12721 """
12722 GetCellSize(self, int row, int col) -> Size
12723
12724 Get the size of the specified cell, including hgap and
12725 vgap. Only valid after a Layout.
12726 """
12727 return _core_.GridBagSizer_GetCellSize(*args, **kwargs)
12728
d55e5bfc 12729 def GetEmptyCellSize(*args, **kwargs):
248ed943
RD
12730 """
12731 GetEmptyCellSize(self) -> Size
12732
12733 Get the size used for cells in the grid with no item.
12734 """
d55e5bfc
RD
12735 return _core_.GridBagSizer_GetEmptyCellSize(*args, **kwargs)
12736
12737 def SetEmptyCellSize(*args, **kwargs):
248ed943
RD
12738 """
12739 SetEmptyCellSize(self, Size sz)
12740
12741 Set the size used for cells in the grid with no item.
12742 """
d55e5bfc
RD
12743 return _core_.GridBagSizer_SetEmptyCellSize(*args, **kwargs)
12744
12745 def GetItemPosition(*args):
12746 """
248ed943
RD
12747 GetItemPosition(self, item) -> GBPosition
12748
12749 Get the grid position of the specified *item* where *item* is either a
12750 window or subsizer that is a member of this sizer, or a zero-based
12751 index of an item.
d55e5bfc
RD
12752 """
12753 return _core_.GridBagSizer_GetItemPosition(*args)
12754
12755 def SetItemPosition(*args):
12756 """
248ed943
RD
12757 SetItemPosition(self, item, GBPosition pos) -> bool
12758
12759 Set the grid position of the specified *item* where *item* is either a
12760 window or subsizer that is a member of this sizer, or a zero-based
12761 index of an item. Returns True on success. If the move is not
12762 allowed (because an item is already there) then False is returned.
12763
d55e5bfc
RD
12764 """
12765 return _core_.GridBagSizer_SetItemPosition(*args)
12766
12767 def GetItemSpan(*args):
12768 """
248ed943
RD
12769 GetItemSpan(self, item) -> GBSpan
12770
12771 Get the row/col spanning of the specified *item* where *item* is
12772 either a window or subsizer that is a member of this sizer, or a
12773 zero-based index of an item.
d55e5bfc
RD
12774 """
12775 return _core_.GridBagSizer_GetItemSpan(*args)
12776
12777 def SetItemSpan(*args):
12778 """
248ed943
RD
12779 SetItemSpan(self, item, GBSpan span) -> bool
12780
12781 Set the row/col spanning of the specified *item* where *item* is
12782 either a window or subsizer that is a member of this sizer, or a
12783 zero-based index of an item. Returns True on success. If the move is
12784 not allowed (because an item is already there) then False is returned.
d55e5bfc
RD
12785 """
12786 return _core_.GridBagSizer_SetItemSpan(*args)
12787
12788 def FindItem(*args):
12789 """
248ed943
RD
12790 FindItem(self, item) -> GBSizerItem
12791
12792 Find the sizer item for the given window or subsizer, returns None if
12793 not found. (non-recursive)
d55e5bfc
RD
12794 """
12795 return _core_.GridBagSizer_FindItem(*args)
12796
12797 def FindItemAtPosition(*args, **kwargs):
248ed943
RD
12798 """
12799 FindItemAtPosition(self, GBPosition pos) -> GBSizerItem
12800
12801 Return the sizer item for the given grid cell, or None if there is no
12802 item at that position. (non-recursive)
12803 """
d55e5bfc
RD
12804 return _core_.GridBagSizer_FindItemAtPosition(*args, **kwargs)
12805
12806 def FindItemAtPoint(*args, **kwargs):
248ed943
RD
12807 """
12808 FindItemAtPoint(self, Point pt) -> GBSizerItem
12809
12810 Return the sizer item located at the point given in *pt*, or None if
12811 there is no item at that point. The (x,y) coordinates in pt correspond
12812 to the client coordinates of the window using the sizer for
12813 layout. (non-recursive)
12814 """
d55e5bfc
RD
12815 return _core_.GridBagSizer_FindItemAtPoint(*args, **kwargs)
12816
248ed943
RD
12817 def CheckForIntersection(*args, **kwargs):
12818 """
12819 CheckForIntersection(self, GBSizerItem item, GBSizerItem excludeItem=None) -> bool
d55e5bfc 12820
248ed943
RD
12821 Look at all items and see if any intersect (or would overlap) the
12822 given *item*. Returns True if so, False if there would be no overlap.
12823 If an *excludeItem* is given then it will not be checked for
12824 intersection, for example it may be the item we are checking the
12825 position of.
d55e5bfc 12826
248ed943
RD
12827 """
12828 return _core_.GridBagSizer_CheckForIntersection(*args, **kwargs)
d55e5bfc 12829
248ed943 12830 def CheckForIntersectionPos(*args, **kwargs):
d55e5bfc 12831 """
248ed943
RD
12832 CheckForIntersectionPos(self, GBPosition pos, GBSpan span, GBSizerItem excludeItem=None) -> bool
12833
12834 Look at all items and see if any intersect (or would overlap) the
12835 given position and span. Returns True if so, False if there would be
12836 no overlap. If an *excludeItem* is given then it will not be checked
12837 for intersection, for example it may be the item we are checking the
12838 position of.
d55e5bfc 12839 """
248ed943 12840 return _core_.GridBagSizer_CheckForIntersectionPos(*args, **kwargs)
d55e5bfc
RD
12841
12842
12843class GridBagSizerPtr(GridBagSizer):
12844 def __init__(self, this):
12845 self.this = this
12846 if not hasattr(self,"thisown"): self.thisown = 0
12847 self.__class__ = GridBagSizer
12848_core_.GridBagSizer_swigregister(GridBagSizerPtr)
12849
12850#---------------------------------------------------------------------------
12851
12852Left = _core_.Left
12853Top = _core_.Top
12854Right = _core_.Right
12855Bottom = _core_.Bottom
12856Width = _core_.Width
12857Height = _core_.Height
12858Centre = _core_.Centre
12859Center = _core_.Center
12860CentreX = _core_.CentreX
12861CentreY = _core_.CentreY
12862Unconstrained = _core_.Unconstrained
12863AsIs = _core_.AsIs
12864PercentOf = _core_.PercentOf
12865Above = _core_.Above
12866Below = _core_.Below
12867LeftOf = _core_.LeftOf
12868RightOf = _core_.RightOf
12869SameAs = _core_.SameAs
12870Absolute = _core_.Absolute
12871class IndividualLayoutConstraint(Object):
12872 """
79fccf9d
RD
12873 Objects of this class are stored in the `wx.LayoutConstraints` class as
12874 one of eight possible constraints that a window can be involved in.
12875 You will never need to create an instance of
12876 wx.IndividualLayoutConstraint, rather you should create a
12877 `wx.LayoutConstraints` instance and use the individual contstraints
d55e5bfc 12878 that it contains.
d55e5bfc
RD
12879 """
12880 def __init__(self): raise RuntimeError, "No constructor defined"
12881 def __repr__(self):
12882 return "<%s.%s; proxy of C++ wxIndividualLayoutConstraint instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
12883 def Set(*args, **kwargs):
79fccf9d
RD
12884 """
12885 Set(self, int rel, Window otherW, int otherE, int val=0, int marg=wxLAYOUT_DEFAULT_MARGIN)
12886
12887 Sets the properties of the constraint. Normally called by one of the
12888 convenience functions such as Above, RightOf, SameAs.
12889 """
d55e5bfc
RD
12890 return _core_.IndividualLayoutConstraint_Set(*args, **kwargs)
12891
12892 def LeftOf(*args, **kwargs):
12893 """
12894 LeftOf(self, Window sibling, int marg=0)
12895
79fccf9d
RD
12896 Constrains this edge to be to the left of the given window, with an
12897 optional margin. Implicitly, this is relative to the left edge of the
12898 other window.
d55e5bfc
RD
12899 """
12900 return _core_.IndividualLayoutConstraint_LeftOf(*args, **kwargs)
12901
12902 def RightOf(*args, **kwargs):
12903 """
12904 RightOf(self, Window sibling, int marg=0)
12905
79fccf9d
RD
12906 Constrains this edge to be to the right of the given window, with an
12907 optional margin. Implicitly, this is relative to the right edge of the
12908 other window.
d55e5bfc
RD
12909 """
12910 return _core_.IndividualLayoutConstraint_RightOf(*args, **kwargs)
12911
12912 def Above(*args, **kwargs):
12913 """
12914 Above(self, Window sibling, int marg=0)
12915
79fccf9d
RD
12916 Constrains this edge to be above the given window, with an optional
12917 margin. Implicitly, this is relative to the top edge of the other
12918 window.
d55e5bfc
RD
12919 """
12920 return _core_.IndividualLayoutConstraint_Above(*args, **kwargs)
12921
12922 def Below(*args, **kwargs):
12923 """
12924 Below(self, Window sibling, int marg=0)
12925
79fccf9d
RD
12926 Constrains this edge to be below the given window, with an optional
12927 margin. Implicitly, this is relative to the bottom edge of the other
12928 window.
d55e5bfc
RD
12929 """
12930 return _core_.IndividualLayoutConstraint_Below(*args, **kwargs)
12931
12932 def SameAs(*args, **kwargs):
12933 """
12934 SameAs(self, Window otherW, int edge, int marg=0)
12935
79fccf9d
RD
12936 Constrains this edge or dimension to be to the same as the edge of the
12937 given window, with an optional margin.
d55e5bfc
RD
12938 """
12939 return _core_.IndividualLayoutConstraint_SameAs(*args, **kwargs)
12940
12941 def PercentOf(*args, **kwargs):
12942 """
12943 PercentOf(self, Window otherW, int wh, int per)
12944
79fccf9d
RD
12945 Constrains this edge or dimension to be to a percentage of the given
12946 window, with an optional margin.
d55e5bfc
RD
12947 """
12948 return _core_.IndividualLayoutConstraint_PercentOf(*args, **kwargs)
12949
12950 def Absolute(*args, **kwargs):
12951 """
12952 Absolute(self, int val)
12953
79fccf9d 12954 Constrains this edge or dimension to be the given absolute value.
d55e5bfc
RD
12955 """
12956 return _core_.IndividualLayoutConstraint_Absolute(*args, **kwargs)
12957
12958 def Unconstrained(*args, **kwargs):
12959 """
12960 Unconstrained(self)
12961
79fccf9d
RD
12962 Sets this edge or dimension to be unconstrained, that is, dependent on
12963 other edges and dimensions from which this value can be deduced.
d55e5bfc
RD
12964 """
12965 return _core_.IndividualLayoutConstraint_Unconstrained(*args, **kwargs)
12966
12967 def AsIs(*args, **kwargs):
12968 """
12969 AsIs(self)
12970
79fccf9d
RD
12971 Sets this edge or constraint to be whatever the window's value is at
12972 the moment. If either of the width and height constraints are *as is*,
12973 the window will not be resized, but moved instead. This is important
12974 when considering panel items which are intended to have a default
12975 size, such as a button, which may take its size from the size of the
12976 button label.
d55e5bfc
RD
12977 """
12978 return _core_.IndividualLayoutConstraint_AsIs(*args, **kwargs)
12979
12980 def GetOtherWindow(*args, **kwargs):
12981 """GetOtherWindow(self) -> Window"""
12982 return _core_.IndividualLayoutConstraint_GetOtherWindow(*args, **kwargs)
12983
12984 def GetMyEdge(*args, **kwargs):
12985 """GetMyEdge(self) -> int"""
12986 return _core_.IndividualLayoutConstraint_GetMyEdge(*args, **kwargs)
12987
12988 def SetEdge(*args, **kwargs):
12989 """SetEdge(self, int which)"""
12990 return _core_.IndividualLayoutConstraint_SetEdge(*args, **kwargs)
12991
12992 def SetValue(*args, **kwargs):
12993 """SetValue(self, int v)"""
12994 return _core_.IndividualLayoutConstraint_SetValue(*args, **kwargs)
12995
12996 def GetMargin(*args, **kwargs):
12997 """GetMargin(self) -> int"""
12998 return _core_.IndividualLayoutConstraint_GetMargin(*args, **kwargs)
12999
13000 def SetMargin(*args, **kwargs):
13001 """SetMargin(self, int m)"""
13002 return _core_.IndividualLayoutConstraint_SetMargin(*args, **kwargs)
13003
13004 def GetValue(*args, **kwargs):
13005 """GetValue(self) -> int"""
13006 return _core_.IndividualLayoutConstraint_GetValue(*args, **kwargs)
13007
13008 def GetPercent(*args, **kwargs):
13009 """GetPercent(self) -> int"""
13010 return _core_.IndividualLayoutConstraint_GetPercent(*args, **kwargs)
13011
13012 def GetOtherEdge(*args, **kwargs):
13013 """GetOtherEdge(self) -> int"""
13014 return _core_.IndividualLayoutConstraint_GetOtherEdge(*args, **kwargs)
13015
13016 def GetDone(*args, **kwargs):
13017 """GetDone(self) -> bool"""
13018 return _core_.IndividualLayoutConstraint_GetDone(*args, **kwargs)
13019
13020 def SetDone(*args, **kwargs):
13021 """SetDone(self, bool d)"""
13022 return _core_.IndividualLayoutConstraint_SetDone(*args, **kwargs)
13023
13024 def GetRelationship(*args, **kwargs):
13025 """GetRelationship(self) -> int"""
13026 return _core_.IndividualLayoutConstraint_GetRelationship(*args, **kwargs)
13027
13028 def SetRelationship(*args, **kwargs):
13029 """SetRelationship(self, int r)"""
13030 return _core_.IndividualLayoutConstraint_SetRelationship(*args, **kwargs)
13031
13032 def ResetIfWin(*args, **kwargs):
13033 """
13034 ResetIfWin(self, Window otherW) -> bool
13035
13036 Reset constraint if it mentions otherWin
13037 """
13038 return _core_.IndividualLayoutConstraint_ResetIfWin(*args, **kwargs)
13039
13040 def SatisfyConstraint(*args, **kwargs):
13041 """
13042 SatisfyConstraint(self, LayoutConstraints constraints, Window win) -> bool
13043
13044 Try to satisfy constraint
13045 """
13046 return _core_.IndividualLayoutConstraint_SatisfyConstraint(*args, **kwargs)
13047
13048 def GetEdge(*args, **kwargs):
13049 """
13050 GetEdge(self, int which, Window thisWin, Window other) -> int
13051
13052 Get the value of this edge or dimension, or if this
13053 is not determinable, -1.
13054 """
13055 return _core_.IndividualLayoutConstraint_GetEdge(*args, **kwargs)
13056
13057
13058class IndividualLayoutConstraintPtr(IndividualLayoutConstraint):
13059 def __init__(self, this):
13060 self.this = this
13061 if not hasattr(self,"thisown"): self.thisown = 0
13062 self.__class__ = IndividualLayoutConstraint
13063_core_.IndividualLayoutConstraint_swigregister(IndividualLayoutConstraintPtr)
13064
13065class LayoutConstraints(Object):
13066 """
79fccf9d
RD
13067 **Note:** constraints are now deprecated and you should use sizers
13068 instead.
d55e5bfc 13069
79fccf9d
RD
13070 Objects of this class can be associated with a window to define its
13071 layout constraints, with respect to siblings or its parent.
d55e5bfc
RD
13072
13073 The class consists of the following eight constraints of class
13074 wx.IndividualLayoutConstraint, some or all of which should be accessed
13075 directly to set the appropriate constraints.
13076
13077 * left: represents the left hand edge of the window
13078 * right: represents the right hand edge of the window
13079 * top: represents the top edge of the window
13080 * bottom: represents the bottom edge of the window
13081 * width: represents the width of the window
13082 * height: represents the height of the window
13083 * centreX: represents the horizontal centre point of the window
13084 * centreY: represents the vertical centre point of the window
13085
79fccf9d
RD
13086 Most constraints are initially set to have the relationship
13087 wxUnconstrained, which means that their values should be calculated by
13088 looking at known constraints. The exceptions are width and height,
13089 which are set to wxAsIs to ensure that if the user does not specify a
13090 constraint, the existing width and height will be used, to be
13091 compatible with panel items which often have take a default size. If
13092 the constraint is ``wx.AsIs``, the dimension will not be changed.
13093
13094 :see: `wx.IndividualLayoutConstraint`, `wx.Window.SetConstraints`
d55e5bfc
RD
13095
13096 """
13097 def __repr__(self):
13098 return "<%s.%s; proxy of C++ wxLayoutConstraints instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
13099 left = property(_core_.LayoutConstraints_left_get)
13100 top = property(_core_.LayoutConstraints_top_get)
13101 right = property(_core_.LayoutConstraints_right_get)
13102 bottom = property(_core_.LayoutConstraints_bottom_get)
13103 width = property(_core_.LayoutConstraints_width_get)
13104 height = property(_core_.LayoutConstraints_height_get)
13105 centreX = property(_core_.LayoutConstraints_centreX_get)
13106 centreY = property(_core_.LayoutConstraints_centreY_get)
13107 def __init__(self, *args, **kwargs):
13108 """__init__(self) -> LayoutConstraints"""
13109 newobj = _core_.new_LayoutConstraints(*args, **kwargs)
13110 self.this = newobj.this
13111 self.thisown = 1
13112 del newobj.thisown
13113 def SatisfyConstraints(*args, **kwargs):
13114 """SatisfyConstraints(Window win) -> (areSatisfied, noChanges)"""
13115 return _core_.LayoutConstraints_SatisfyConstraints(*args, **kwargs)
13116
13117 def AreSatisfied(*args, **kwargs):
13118 """AreSatisfied(self) -> bool"""
13119 return _core_.LayoutConstraints_AreSatisfied(*args, **kwargs)
13120
13121
13122class LayoutConstraintsPtr(LayoutConstraints):
13123 def __init__(self, this):
13124 self.this = this
13125 if not hasattr(self,"thisown"): self.thisown = 0
13126 self.__class__ = LayoutConstraints
13127_core_.LayoutConstraints_swigregister(LayoutConstraintsPtr)
13128
13129#----------------------------------------------------------------------------
13130
13131# Use Python's bool constants if available, make some if not
13132try:
13133 True
13134except NameError:
13135 __builtins__.True = 1==1
13136 __builtins__.False = 1==0
13137 def bool(value): return not not value
13138 __builtins__.bool = bool
13139
13140
13141
13142# workarounds for bad wxRTTI names
13143__wxPyPtrTypeMap['wxGauge95'] = 'wxGauge'
13144__wxPyPtrTypeMap['wxSlider95'] = 'wxSlider'
13145__wxPyPtrTypeMap['wxStatusBar95'] = 'wxStatusBar'
13146
13147
13148#----------------------------------------------------------------------------
13149# Load version numbers from __version__... Ensure that major and minor
0f63ec68 13150# versions are the same for both wxPython and wxWidgets.
d55e5bfc
RD
13151
13152from __version__ import *
13153__version__ = VERSION_STRING
13154
0f63ec68
RD
13155assert MAJOR_VERSION == _core_.MAJOR_VERSION, "wxPython/wxWidgets version mismatch"
13156assert MINOR_VERSION == _core_.MINOR_VERSION, "wxPython/wxWidgets version mismatch"
d55e5bfc
RD
13157if RELEASE_VERSION != _core_.RELEASE_VERSION:
13158 import warnings
0f63ec68 13159 warnings.warn("wxPython/wxWidgets release number mismatch")
d55e5bfc
RD
13160
13161#----------------------------------------------------------------------------
13162
70b7a5fe
RD
13163# Set wxPython's default string<-->unicode conversion encoding from
13164# the locale, but only if Python's default hasn't been changed. (We
13165# assume that if the user has customized it already then that is the
13166# encoding we need to use as well.)
13167#
13168# The encoding selected here is used when string or unicode objects
13169# need to be converted in order to pass them to wxWidgets. Please be
13170# aware that the default encoding within the same locale may be
13171# slightly different on different platforms. For example, please see
62d32a5f
RD
13172# http://www.alanwood.net/demos/charsetdiffs.html for differences
13173# between the common latin/roman encodings.
396fb509
RD
13174
13175default = _sys.getdefaultencoding()
13176if default == 'ascii':
13177 import locale
13178 import codecs
13179 try:
13180 default = locale.getdefaultlocale()[1]
13181 codecs.lookup(default)
70b7a5fe 13182 except (ValueError, LookupError, TypeError):
396fb509
RD
13183 default = _sys.getdefaultencoding()
13184 del locale
13185 del codecs
5cbf236d
RD
13186if default:
13187 wx.SetDefaultPyEncoding(default)
13188del default
5cbf236d
RD
13189
13190#----------------------------------------------------------------------------
13191
d55e5bfc
RD
13192class PyDeadObjectError(AttributeError):
13193 pass
13194
13195class _wxPyDeadObject(object):
13196 """
13197 Instances of wx objects that are OOR capable will have their __class__
13198 changed to this class when the C++ object is deleted. This should help
13199 prevent crashes due to referencing a bogus C++ pointer.
13200 """
13201 reprStr = "wxPython wrapper for DELETED %s object! (The C++ object no longer exists.)"
13202 attrStr = "The C++ part of the %s object has been deleted, attribute access no longer allowed."
13203
13204 def __repr__(self):
13205 if not hasattr(self, "_name"):
13206 self._name = "[unknown]"
13207 return self.reprStr % self._name
13208
13209 def __getattr__(self, *args):
13210 if not hasattr(self, "_name"):
13211 self._name = "[unknown]"
13212 raise PyDeadObjectError(self.attrStr % self._name)
13213
13214 def __nonzero__(self):
13215 return 0
13216
13217
13218
13219class PyUnbornObjectError(AttributeError):
13220 pass
13221
13222class _wxPyUnbornObject(object):
13223 """
13224 Some stock objects are created when the wx._core module is
13225 imported, but their C++ instance is not created until the wx.App
13226 object is created and initialized. These object instances will
13227 temporarily have their __class__ changed to this class so an
13228 exception will be raised if they are used before the C++ instance
13229 is ready.
13230 """
13231
13232 reprStr = "wxPython wrapper for UNBORN object! (The C++ object is not initialized yet.)"
13233 attrStr = "The C++ part of this object has not been initialized, attribute access not allowed."
13234
13235 def __repr__(self):
13236 #if not hasattr(self, "_name"):
13237 # self._name = "[unknown]"
13238 return self.reprStr #% self._name
13239
13240 def __getattr__(self, *args):
13241 #if not hasattr(self, "_name"):
13242 # self._name = "[unknown]"
13243 raise PyUnbornObjectError(self.attrStr) # % self._name )
13244
13245 def __nonzero__(self):
13246 return 0
13247
13248
13249#----------------------------------------------------------------------------
d55e5bfc
RD
13250
13251def CallAfter(callable, *args, **kw):
13252 """
13253 Call the specified function after the current and pending event
13254 handlers have been completed. This is also good for making GUI
0439c23b
RD
13255 method calls from non-GUI threads. Any extra positional or
13256 keyword args are passed on to the callable when it is called.
13257
13258 :see: `wx.FutureCall`
d55e5bfc
RD
13259 """
13260 app = wx.GetApp()
a001823c 13261 assert app is not None, 'No wx.App created yet'
d55e5bfc 13262
891bb194
RD
13263 if not hasattr(app, "_CallAfterId"):
13264 app._CallAfterId = wx.NewEventType()
13265 app.Connect(-1, -1, app._CallAfterId,
13266 lambda event: event.callable(*event.args, **event.kw) )
d55e5bfc 13267 evt = wx.PyEvent()
891bb194 13268 evt.SetEventType(app._CallAfterId)
d55e5bfc
RD
13269 evt.callable = callable
13270 evt.args = args
13271 evt.kw = kw
13272 wx.PostEvent(app, evt)
13273
d55e5bfc
RD
13274#----------------------------------------------------------------------------
13275
13276
13277class FutureCall:
13278 """
8ac8dba0 13279 A convenience class for `wx.Timer`, that calls the given callable
d55e5bfc
RD
13280 object once after the given amount of milliseconds, passing any
13281 positional or keyword args. The return value of the callable is
0439c23b 13282 availbale after it has been run with the `GetResult` method.
d55e5bfc
RD
13283
13284 If you don't need to get the return value or restart the timer
13285 then there is no need to hold a reference to this object. It will
13286 hold a reference to itself while the timer is running (the timer
13287 has a reference to self.Notify) but the cycle will be broken when
13288 the timer completes, automatically cleaning up the wx.FutureCall
13289 object.
0439c23b
RD
13290
13291 :see: `wx.CallAfter`
d55e5bfc
RD
13292 """
13293 def __init__(self, millis, callable, *args, **kwargs):
13294 self.millis = millis
13295 self.callable = callable
13296 self.SetArgs(*args, **kwargs)
13297 self.runCount = 0
13298 self.running = False
13299 self.hasRun = False
13300 self.result = None
13301 self.timer = None
13302 self.Start()
13303
13304 def __del__(self):
13305 self.Stop()
13306
13307
13308 def Start(self, millis=None, *args, **kwargs):
13309 """
13310 (Re)start the timer
13311 """
13312 self.hasRun = False
13313 if millis is not None:
13314 self.millis = millis
13315 if args or kwargs:
13316 self.SetArgs(*args, **kwargs)
13317 self.Stop()
13318 self.timer = wx.PyTimer(self.Notify)
13319 self.timer.Start(self.millis, wx.TIMER_ONE_SHOT)
13320 self.running = True
13321 Restart = Start
13322
13323
13324 def Stop(self):
13325 """
13326 Stop and destroy the timer.
13327 """
13328 if self.timer is not None:
13329 self.timer.Stop()
13330 self.timer = None
13331
13332
13333 def GetInterval(self):
13334 if self.timer is not None:
13335 return self.timer.GetInterval()
13336 else:
13337 return 0
13338
13339
13340 def IsRunning(self):
13341 return self.timer is not None and self.timer.IsRunning()
13342
13343
13344 def SetArgs(self, *args, **kwargs):
13345 """
13346 (Re)set the args passed to the callable object. This is
13347 useful in conjunction with Restart if you want to schedule a
13348 new call to the same callable object but with different
13349 parameters.
13350 """
13351 self.args = args
13352 self.kwargs = kwargs
13353
13354
13355 def HasRun(self):
13356 return self.hasRun
13357
13358 def GetResult(self):
13359 return self.result
13360
13361 def Notify(self):
13362 """
13363 The timer has expired so call the callable.
13364 """
13365 if self.callable and getattr(self.callable, 'im_self', True):
13366 self.runCount += 1
13367 self.running = False
13368 self.result = self.callable(*self.args, **self.kwargs)
13369 self.hasRun = True
13370 if not self.running:
13371 # if it wasn't restarted, then cleanup
13372 wx.CallAfter(self.Stop)
13373
13374
13375
13376#----------------------------------------------------------------------------
13377# Control which items in this module should be documented by epydoc.
13378# We allow only classes and functions, which will help reduce the size
13379# of the docs by filtering out the zillions of constants, EVT objects,
13380# and etc that don't make much sense by themselves, but are instead
13381# documented (or will be) as part of the classes/functions/methods
13382# where they should be used.
13383
c24da6d6
RD
13384class __DocFilter:
13385 """
13386 A filter for epydoc that only allows non-Ptr classes and
13387 fucntions, in order to reduce the clutter in the API docs.
13388 """
13389 def __init__(self, globals):
13390 self._globals = globals
13391
13392 def __call__(self, name):
13393 import types
13394 obj = self._globals.get(name, None)
13395 if type(obj) not in [type, types.ClassType, types.FunctionType, types.BuiltinFunctionType]:
13396 return False
13397 if name.startswith('_') or name.endswith('Ptr') or name.startswith('EVT'):
13398 return False
13399 return True
d55e5bfc
RD
13400
13401#----------------------------------------------------------------------------
13402#----------------------------------------------------------------------------
13403
13404# Import other modules in this package that should show up in the
13405# "core" wx namespace
13406from _gdi import *
13407from _windows import *
13408from _controls import *
13409from _misc import *
13410
13411
13412# Fixup the stock objects since they can't be used yet. (They will be
13413# restored in wx.PyApp.OnInit.)
13414_core_._wxPyFixStockObjects()
13415
13416#----------------------------------------------------------------------------
13417#----------------------------------------------------------------------------
13418
13419