]> git.saurik.com Git - wxWidgets.git/blame - wxPython/src/gtk/_gdi.py
forgot to commit during last regeneration
[wxWidgets.git] / wxPython / src / gtk / _gdi.py
CommitLineData
0085ce49 1# This file was created automatically by SWIG 1.3.29.
d14a1e28 2# Don't modify this file, modify the SWIG interface instead.
70551f47 3
54f9ee45 4import _gdi_
0085ce49
RD
5import new
6new_instancemethod = new.instancemethod
093d3ff1 7def _swig_setattr_nondynamic(self,class_type,name,value,static=1):
0085ce49 8 if (name == "thisown"): return self.this.own(value)
093d3ff1 9 if (name == "this"):
0085ce49
RD
10 if type(value).__name__ == 'PySwigObject':
11 self.__dict__[name] = value
093d3ff1
RD
12 return
13 method = class_type.__swig_setmethods__.get(name,None)
14 if method: return method(self,value)
0085ce49 15 if (not static) or hasattr(self,name):
093d3ff1
RD
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):
0085ce49 24 if (name == "thisown"): return self.this.own()
093d3ff1
RD
25 method = class_type.__swig_getmethods__.get(name,None)
26 if method: return method(self)
27 raise AttributeError,name
28
0085ce49
RD
29def _swig_repr(self):
30 try: strthis = "proxy of " + self.this.__repr__()
31 except: strthis = ""
32 return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
33
093d3ff1
RD
34import types
35try:
36 _object = types.ObjectType
37 _newclass = 1
38except AttributeError:
39 class _object : pass
40 _newclass = 0
41del types
42
43
44def _swig_setattr_nondynamic_method(set):
45 def set_attr(self,name,value):
0085ce49
RD
46 if (name == "thisown"): return self.this.own(value)
47 if hasattr(self,name) or (name == "this"):
093d3ff1
RD
48 set(self,name,value)
49 else:
50 raise AttributeError("You cannot add attributes to %s" % self)
51 return set_attr
52
53
54f9ee45
RD
54import _core
55wx = _core
d14a1e28
RD
56#---------------------------------------------------------------------------
57
54f9ee45 58class GDIObject(_core.Object):
093d3ff1 59 """Proxy of C++ GDIObject class"""
0085ce49
RD
60 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
61 __repr__ = _swig_repr
62 def __init__(self, *args, **kwargs):
a95a7133 63 """__init__(self) -> GDIObject"""
0085ce49
RD
64 _gdi_.GDIObject_swiginit(self,_gdi_.new_GDIObject(*args, **kwargs))
65 __swig_destroy__ = _gdi_.delete_GDIObject
66 __del__ = lambda self : None;
e811c8ce 67 def IsNull(*args, **kwargs):
a95a7133 68 """IsNull(self) -> bool"""
54f9ee45 69 return _gdi_.GDIObject_IsNull(*args, **kwargs)
e811c8ce 70
2131d850 71_gdi_.GDIObject_swigregister(GDIObject)
9df61a29 72
d14a1e28
RD
73#---------------------------------------------------------------------------
74
01f6b6d3
RD
75C2S_NAME = _gdi_.C2S_NAME
76C2S_CSS_SYNTAX = _gdi_.C2S_CSS_SYNTAX
77C2S_HTML_SYNTAX = _gdi_.C2S_HTML_SYNTAX
fc46b7f3
RD
78ALPHA_TRANSPARENT = _gdi_.ALPHA_TRANSPARENT
79ALPHA_OPAQUE = _gdi_.ALPHA_OPAQUE
54f9ee45 80class Colour(_core.Object):
b88bce5f 81 """
41e2b43e
RD
82 A colour is an object representing a combination of Red, Green, and
83 Blue (RGB) intensity values, and is used to determine drawing colours,
84 window colours, etc. Valid RGB values are in the range 0 to 255.
b88bce5f 85
41e2b43e 86 In wxPython there are typemaps that will automatically convert from a
32fe5131
RD
87 colour name, from a '#RRGGBB' colour hex value string, or from a 3
88 integer tuple to a wx.Colour object when calling C++ methods that
89 expect a wxColour. This means that the following are all
90 equivallent::
b88bce5f
RD
91
92 win.SetBackgroundColour(wxColour(0,0,255))
b2df227b
RD
93 win.SetBackgroundColour('BLUE')
94 win.SetBackgroundColour('#0000FF')
32fe5131 95 win.SetBackgroundColour((0,0,255))
b88bce5f 96
41e2b43e
RD
97 Additional colour names and their coresponding values can be added
98 using `wx.ColourDatabase`. Various system colours (as set in the
99 user's system preferences) can be retrieved with
100 `wx.SystemSettings.GetColour`.
101
b88bce5f 102 """
0085ce49
RD
103 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
104 __repr__ = _swig_repr
105 def __init__(self, *args, **kwargs):
b88bce5f 106 """
fc46b7f3 107 __init__(self, byte red=0, byte green=0, byte blue=0, byte alpha=ALPHA_OPAQUE) -> Colour
b88bce5f
RD
108
109 Constructs a colour from red, green and blue values.
41e2b43e
RD
110
111 :see: Alternate constructors `wx.NamedColour` and `wx.ColourRGB`.
112
b88bce5f 113 """
0085ce49
RD
114 _gdi_.Colour_swiginit(self,_gdi_.new_Colour(*args, **kwargs))
115 __swig_destroy__ = _gdi_.delete_Colour
116 __del__ = lambda self : None;
e811c8ce 117 def Red(*args, **kwargs):
b88bce5f 118 """
41e2b43e 119 Red(self) -> byte
b88bce5f
RD
120
121 Returns the red intensity.
122 """
54f9ee45 123 return _gdi_.Colour_Red(*args, **kwargs)
e811c8ce
RD
124
125 def Green(*args, **kwargs):
b88bce5f 126 """
41e2b43e 127 Green(self) -> byte
b88bce5f
RD
128
129 Returns the green intensity.
130 """
54f9ee45 131 return _gdi_.Colour_Green(*args, **kwargs)
e811c8ce
RD
132
133 def Blue(*args, **kwargs):
b88bce5f 134 """
41e2b43e 135 Blue(self) -> byte
b88bce5f
RD
136
137 Returns the blue intensity.
138 """
54f9ee45 139 return _gdi_.Colour_Blue(*args, **kwargs)
e811c8ce 140
fc46b7f3
RD
141 def Alpha(*args, **kwargs):
142 """
143 Alpha(self) -> byte
144
145 Returns the Alpha value.
146 """
147 return _gdi_.Colour_Alpha(*args, **kwargs)
148
e811c8ce 149 def Ok(*args, **kwargs):
b88bce5f 150 """
a95a7133 151 Ok(self) -> bool
b88bce5f
RD
152
153 Returns True if the colour object is valid (the colour has been
154 initialised with RGB values).
155 """
54f9ee45 156 return _gdi_.Colour_Ok(*args, **kwargs)
e811c8ce
RD
157
158 def Set(*args, **kwargs):
b88bce5f 159 """
fc46b7f3 160 Set(self, byte red, byte green, byte blue, byte alpha=ALPHA_OPAQUE)
b88bce5f
RD
161
162 Sets the RGB intensity values.
163 """
54f9ee45 164 return _gdi_.Colour_Set(*args, **kwargs)
e811c8ce 165
c9c7117a 166 def SetRGB(*args, **kwargs):
b88bce5f 167 """
a95a7133 168 SetRGB(self, unsigned long colRGB)
b88bce5f
RD
169
170 Sets the RGB intensity values from a packed RGB value.
171 """
54f9ee45 172 return _gdi_.Colour_SetRGB(*args, **kwargs)
e811c8ce 173
b88bce5f
RD
174 def SetFromName(*args, **kwargs):
175 """
a95a7133 176 SetFromName(self, String colourName)
b88bce5f 177
41e2b43e
RD
178 Sets the RGB intensity values using a colour name listed in
179 ``wx.TheColourDatabase``.
b88bce5f 180 """
54f9ee45 181 return _gdi_.Colour_SetFromName(*args, **kwargs)
b88bce5f 182
01f6b6d3
RD
183 def GetAsString(*args, **kwargs):
184 """
185 GetAsString(self, long flags=wxC2S_NAME|wxC2S_CSS_SYNTAX) -> String
186
187 Return the colour as a string. Acceptable flags are:
188
189 =================== ==================================
190 wx.C2S_NAME return colour name, when possible
191 wx.C2S_CSS_SYNTAX return colour in rgb(r,g,b) syntax
192 wx.C2S_HTML_SYNTAX return colour in #rrggbb syntax
193 =================== ==================================
194 """
195 return _gdi_.Colour_GetAsString(*args, **kwargs)
196
b88bce5f
RD
197 def GetPixel(*args, **kwargs):
198 """
a95a7133 199 GetPixel(self) -> long
b88bce5f
RD
200
201 Returns a pixel value which is platform-dependent. On Windows, a
41e2b43e
RD
202 COLORREF is returned. On X, an allocated pixel value is returned. -1
203 is returned if the pixel is invalid (on X, unallocated).
b88bce5f 204 """
54f9ee45 205 return _gdi_.Colour_GetPixel(*args, **kwargs)
b88bce5f 206
e811c8ce 207 def __eq__(*args, **kwargs):
b88bce5f 208 """
e9d6f3a4 209 __eq__(self, PyObject other) -> bool
b88bce5f 210
e9d6f3a4 211 Compare colours for equality.
b88bce5f 212 """
54f9ee45 213 return _gdi_.Colour___eq__(*args, **kwargs)
e811c8ce
RD
214
215 def __ne__(*args, **kwargs):
b88bce5f 216 """
e9d6f3a4 217 __ne__(self, PyObject other) -> bool
e811c8ce 218
e9d6f3a4 219 Compare colours for inequality.
b88bce5f 220 """
54f9ee45 221 return _gdi_.Colour___ne__(*args, **kwargs)
c9c7117a 222
e811c8ce 223 def Get(*args, **kwargs):
b88bce5f
RD
224 """
225 Get() -> (r, g, b)
226
227 Returns the RGB intensity values as a tuple.
228 """
54f9ee45 229 return _gdi_.Colour_Get(*args, **kwargs)
e811c8ce 230
b88bce5f
RD
231 def GetRGB(*args, **kwargs):
232 """
a95a7133 233 GetRGB(self) -> unsigned long
b88bce5f
RD
234
235 Return the colour as a packed RGB value
236 """
54f9ee45 237 return _gdi_.Colour_GetRGB(*args, **kwargs)
b88bce5f 238
41e2b43e 239 asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead")
fc46b7f3
RD
240 def __str__(self): return str(self.Get(True))
241 def __repr__(self): return 'wx.Colour' + str(self.Get(True))
d14a1e28 242 def __nonzero__(self): return self.Ok()
74e96f3d 243 __safe_for_unpickling__ = True
fc46b7f3 244 def __reduce__(self): return (Colour, self.Get(True))
9df61a29 245
2bf58437
RD
246 Pixel = property(GetPixel,doc="See `GetPixel`")
247 RGB = property(GetRGB,SetRGB,doc="See `GetRGB` and `SetRGB`")
2131d850 248_gdi_.Colour_swigregister(Colour)
70551f47 249
d14a1e28 250def NamedColour(*args, **kwargs):
b88bce5f
RD
251 """
252 NamedColour(String colorName) -> Colour
253
41e2b43e
RD
254 Constructs a colour object using a colour name listed in
255 ``wx.TheColourDatabase``.
b88bce5f 256 """
54f9ee45 257 val = _gdi_.new_NamedColour(*args, **kwargs)
d14a1e28 258 return val
70551f47 259
d14a1e28 260def ColourRGB(*args, **kwargs):
b88bce5f
RD
261 """
262 ColourRGB(unsigned long colRGB) -> Colour
263
264 Constructs a colour from a packed RGB value.
265 """
54f9ee45 266 val = _gdi_.new_ColourRGB(*args, **kwargs)
d14a1e28 267 return val
70551f47 268
994141e6
RD
269Color = Colour
270NamedColor = NamedColour
271ColorRGB = ColourRGB
272
d14a1e28 273class Palette(GDIObject):
093d3ff1 274 """Proxy of C++ Palette class"""
0085ce49
RD
275 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
276 __repr__ = _swig_repr
277 def __init__(self, *args, **kwargs):
a95a7133 278 """__init__(self, int n, unsigned char red, unsigned char green, unsigned char blue) -> Palette"""
0085ce49
RD
279 _gdi_.Palette_swiginit(self,_gdi_.new_Palette(*args, **kwargs))
280 __swig_destroy__ = _gdi_.delete_Palette
281 __del__ = lambda self : None;
e811c8ce 282 def GetPixel(*args, **kwargs):
a95a7133 283 """GetPixel(self, byte red, byte green, byte blue) -> int"""
54f9ee45 284 return _gdi_.Palette_GetPixel(*args, **kwargs)
e811c8ce
RD
285
286 def GetRGB(*args, **kwargs):
d3b6e4ff 287 """GetRGB(self, int pixel) -> (R,G,B)"""
54f9ee45 288 return _gdi_.Palette_GetRGB(*args, **kwargs)
e811c8ce 289
5cbf236d
RD
290 def GetColoursCount(*args, **kwargs):
291 """GetColoursCount(self) -> int"""
292 return _gdi_.Palette_GetColoursCount(*args, **kwargs)
293
e811c8ce 294 def Ok(*args, **kwargs):
a95a7133 295 """Ok(self) -> bool"""
54f9ee45 296 return _gdi_.Palette_Ok(*args, **kwargs)
e811c8ce 297
322913ce 298 def __nonzero__(self): return self.Ok()
33d6fd3b 299 ColoursCount = property(GetColoursCount,doc="See `GetColoursCount`")
2131d850 300_gdi_.Palette_swigregister(Palette)
d14a1e28
RD
301
302#---------------------------------------------------------------------------
303
304class Pen(GDIObject):
093d3ff1 305 """Proxy of C++ Pen class"""
0085ce49
RD
306 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
307 __repr__ = _swig_repr
308 def __init__(self, *args, **kwargs):
a95a7133 309 """__init__(self, Colour colour, int width=1, int style=SOLID) -> Pen"""
0085ce49
RD
310 _gdi_.Pen_swiginit(self,_gdi_.new_Pen(*args, **kwargs))
311 __swig_destroy__ = _gdi_.delete_Pen
312 __del__ = lambda self : None;
e811c8ce 313 def GetCap(*args, **kwargs):
a95a7133 314 """GetCap(self) -> int"""
54f9ee45 315 return _gdi_.Pen_GetCap(*args, **kwargs)
e811c8ce
RD
316
317 def GetColour(*args, **kwargs):
a95a7133 318 """GetColour(self) -> Colour"""
54f9ee45 319 return _gdi_.Pen_GetColour(*args, **kwargs)
e811c8ce
RD
320
321 def GetJoin(*args, **kwargs):
a95a7133 322 """GetJoin(self) -> int"""
54f9ee45 323 return _gdi_.Pen_GetJoin(*args, **kwargs)
e811c8ce
RD
324
325 def GetStyle(*args, **kwargs):
a95a7133 326 """GetStyle(self) -> int"""
54f9ee45 327 return _gdi_.Pen_GetStyle(*args, **kwargs)
e811c8ce
RD
328
329 def GetWidth(*args, **kwargs):
a95a7133 330 """GetWidth(self) -> int"""
54f9ee45 331 return _gdi_.Pen_GetWidth(*args, **kwargs)
e811c8ce
RD
332
333 def Ok(*args, **kwargs):
a95a7133 334 """Ok(self) -> bool"""
54f9ee45 335 return _gdi_.Pen_Ok(*args, **kwargs)
e811c8ce
RD
336
337 def SetCap(*args, **kwargs):
a95a7133 338 """SetCap(self, int cap_style)"""
54f9ee45 339 return _gdi_.Pen_SetCap(*args, **kwargs)
e811c8ce
RD
340
341 def SetColour(*args, **kwargs):
a95a7133 342 """SetColour(self, Colour colour)"""
54f9ee45 343 return _gdi_.Pen_SetColour(*args, **kwargs)
e811c8ce
RD
344
345 def SetJoin(*args, **kwargs):
a95a7133 346 """SetJoin(self, int join_style)"""
54f9ee45 347 return _gdi_.Pen_SetJoin(*args, **kwargs)
e811c8ce
RD
348
349 def SetStyle(*args, **kwargs):
a95a7133 350 """SetStyle(self, int style)"""
54f9ee45 351 return _gdi_.Pen_SetStyle(*args, **kwargs)
e811c8ce
RD
352
353 def SetWidth(*args, **kwargs):
a95a7133 354 """SetWidth(self, int width)"""
54f9ee45 355 return _gdi_.Pen_SetWidth(*args, **kwargs)
e811c8ce
RD
356
357 def SetDashes(*args, **kwargs):
093d3ff1 358 """SetDashes(self, int dashes)"""
54f9ee45 359 return _gdi_.Pen_SetDashes(*args, **kwargs)
e811c8ce
RD
360
361 def GetDashes(*args, **kwargs):
a95a7133 362 """GetDashes(self) -> PyObject"""
54f9ee45 363 return _gdi_.Pen_GetDashes(*args, **kwargs)
e811c8ce 364
66c033b4
RD
365 def _SetDashes(*args, **kwargs):
366 """_SetDashes(self, PyObject _self, PyObject pyDashes)"""
367 return _gdi_.Pen__SetDashes(*args, **kwargs)
368
369 def SetDashes(self, dashes):
370 """
371 Associate a list of dash lengths with the Pen.
372 """
373 self._SetDashes(self, dashes)
374
375 def GetDashCount(*args, **kwargs):
376 """GetDashCount(self) -> int"""
377 return _gdi_.Pen_GetDashCount(*args, **kwargs)
378
33d6fd3b 379 DashCount = property(GetDashCount,doc="See `GetDashCount`")
3adfb63b 380 def __eq__(*args, **kwargs):
a95a7133 381 """__eq__(self, Pen other) -> bool"""
54f9ee45 382 return _gdi_.Pen___eq__(*args, **kwargs)
3adfb63b 383
22faec7d 384 def __ne__(*args, **kwargs):
a95a7133 385 """__ne__(self, Pen other) -> bool"""
54f9ee45 386 return _gdi_.Pen___ne__(*args, **kwargs)
22faec7d 387
d14a1e28 388 def __nonzero__(self): return self.Ok()
33d6fd3b
RD
389 Cap = property(GetCap,SetCap,doc="See `GetCap` and `SetCap`")
390 Colour = property(GetColour,SetColour,doc="See `GetColour` and `SetColour`")
391 Dashes = property(GetDashes,SetDashes,doc="See `GetDashes` and `SetDashes`")
392 Join = property(GetJoin,SetJoin,doc="See `GetJoin` and `SetJoin`")
393 Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`")
394 Width = property(GetWidth,SetWidth,doc="See `GetWidth` and `SetWidth`")
2131d850 395_gdi_.Pen_swigregister(Pen)
d14a1e28 396
66c033b4 397#---------------------------------------------------------------------------
e811c8ce 398
66c033b4
RD
399class Brush(GDIObject):
400 """
401 A brush is a drawing tool for filling in areas. It is used for
402 painting the background of rectangles, ellipses, etc. when drawing on
403 a `wx.DC`. It has a colour and a style.
0df68c9f 404 """
0085ce49
RD
405 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
406 __repr__ = _swig_repr
407 def __init__(self, *args, **kwargs):
0df68c9f 408 """
a95a7133 409 __init__(self, Colour colour, int style=SOLID) -> Brush
1e0c8722 410
41e2b43e 411 Constructs a brush from a `wx.Colour` object and a style.
0df68c9f 412 """
0085ce49
RD
413 _gdi_.Brush_swiginit(self,_gdi_.new_Brush(*args, **kwargs))
414 __swig_destroy__ = _gdi_.delete_Brush
415 __del__ = lambda self : None;
e811c8ce 416 def SetColour(*args, **kwargs):
66c033b4
RD
417 """
418 SetColour(self, Colour col)
419
420 Set the brush's `wx.Colour`.
421 """
54f9ee45 422 return _gdi_.Brush_SetColour(*args, **kwargs)
e811c8ce
RD
423
424 def SetStyle(*args, **kwargs):
66c033b4
RD
425 """
426 SetStyle(self, int style)
427
428 Sets the style of the brush. See `__init__` for a listing of styles.
429 """
54f9ee45 430 return _gdi_.Brush_SetStyle(*args, **kwargs)
e811c8ce
RD
431
432 def SetStipple(*args, **kwargs):
66c033b4
RD
433 """
434 SetStipple(self, Bitmap stipple)
435
436 Sets the stipple `wx.Bitmap`.
437 """
54f9ee45 438 return _gdi_.Brush_SetStipple(*args, **kwargs)
e811c8ce
RD
439
440 def GetColour(*args, **kwargs):
66c033b4
RD
441 """
442 GetColour(self) -> Colour
443
444 Returns the `wx.Colour` of the brush.
445 """
54f9ee45 446 return _gdi_.Brush_GetColour(*args, **kwargs)
e811c8ce
RD
447
448 def GetStyle(*args, **kwargs):
66c033b4
RD
449 """
450 GetStyle(self) -> int
451
452 Returns the style of the brush. See `__init__` for a listing of
453 styles.
454 """
54f9ee45 455 return _gdi_.Brush_GetStyle(*args, **kwargs)
e811c8ce
RD
456
457 def GetStipple(*args, **kwargs):
66c033b4
RD
458 """
459 GetStipple(self) -> Bitmap
460
461 Returns the stiple `wx.Bitmap` of the brush. If the brush does not
462 have a wx.STIPPLE style, then the return value may be non-None but an
463 uninitialised bitmap (`wx.Bitmap.Ok` returns False).
464 """
54f9ee45 465 return _gdi_.Brush_GetStipple(*args, **kwargs)
e811c8ce 466
f78cc896
RD
467 def IsHatch(*args, **kwargs):
468 """
469 IsHatch(self) -> bool
470
471 Is the current style a hatch type?
472 """
473 return _gdi_.Brush_IsHatch(*args, **kwargs)
474
e811c8ce 475 def Ok(*args, **kwargs):
66c033b4
RD
476 """
477 Ok(self) -> bool
478
479 Returns True if the brush is initialised and valid.
480 """
54f9ee45 481 return _gdi_.Brush_Ok(*args, **kwargs)
e811c8ce 482
d14a1e28 483 def __nonzero__(self): return self.Ok()
2bf58437
RD
484 Colour = property(GetColour,SetColour,doc="See `GetColour` and `SetColour`")
485 Stipple = property(GetStipple,SetStipple,doc="See `GetStipple` and `SetStipple`")
486 Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`")
2131d850 487_gdi_.Brush_swigregister(Brush)
d14a1e28 488
d04418a7
RD
489def BrushFromBitmap(*args, **kwargs):
490 """
491 BrushFromBitmap(Bitmap stippleBitmap) -> Brush
492
493 Constructs a stippled brush using a bitmap.
494 """
495 val = _gdi_.new_BrushFromBitmap(*args, **kwargs)
d04418a7
RD
496 return val
497
d14a1e28 498class Bitmap(GDIObject):
66c033b4
RD
499 """
500 The wx.Bitmap class encapsulates the concept of a platform-dependent
501 bitmap. It can be either monochrome or colour, and either loaded from
502 a file or created dynamically. A bitmap can be selected into a memory
503 device context (instance of `wx.MemoryDC`). This enables the bitmap to
504 be copied to a window or memory device context using `wx.DC.Blit`, or
505 to be used as a drawing surface.
66c033b4 506 """
0085ce49
RD
507 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
508 __repr__ = _swig_repr
509 def __init__(self, *args, **kwargs):
0df68c9f 510 """
a95a7133 511 __init__(self, String name, int type=BITMAP_TYPE_ANY) -> Bitmap
1e0c8722 512
0df68c9f
RD
513 Loads a bitmap from a file.
514 """
0085ce49
RD
515 _gdi_.Bitmap_swiginit(self,_gdi_.new_Bitmap(*args, **kwargs))
516 __swig_destroy__ = _gdi_.delete_Bitmap
517 __del__ = lambda self : None;
e811c8ce 518 def Ok(*args, **kwargs):
a95a7133 519 """Ok(self) -> bool"""
54f9ee45 520 return _gdi_.Bitmap_Ok(*args, **kwargs)
e811c8ce
RD
521
522 def GetWidth(*args, **kwargs):
0df68c9f 523 """
a95a7133 524 GetWidth(self) -> int
1e0c8722 525
0df68c9f
RD
526 Gets the width of the bitmap in pixels.
527 """
54f9ee45 528 return _gdi_.Bitmap_GetWidth(*args, **kwargs)
e811c8ce
RD
529
530 def GetHeight(*args, **kwargs):
0df68c9f 531 """
a95a7133 532 GetHeight(self) -> int
1e0c8722 533
0df68c9f
RD
534 Gets the height of the bitmap in pixels.
535 """
54f9ee45 536 return _gdi_.Bitmap_GetHeight(*args, **kwargs)
e811c8ce
RD
537
538 def GetDepth(*args, **kwargs):
0df68c9f 539 """
a95a7133 540 GetDepth(self) -> int
1e0c8722 541
0df68c9f
RD
542 Gets the colour depth of the bitmap. A value of 1 indicates a
543 monochrome bitmap.
544 """
54f9ee45 545 return _gdi_.Bitmap_GetDepth(*args, **kwargs)
e811c8ce 546
b2df227b
RD
547 def GetSize(*args, **kwargs):
548 """
a95a7133 549 GetSize(self) -> Size
b2df227b
RD
550
551 Get the size of the bitmap.
552 """
54f9ee45 553 return _gdi_.Bitmap_GetSize(*args, **kwargs)
b2df227b 554
e811c8ce 555 def ConvertToImage(*args, **kwargs):
0df68c9f 556 """
a95a7133 557 ConvertToImage(self) -> Image
1e0c8722 558
66c033b4
RD
559 Creates a platform-independent image from a platform-dependent
560 bitmap. This preserves mask information so that bitmaps and images can
561 be converted back and forth without loss in that respect.
0df68c9f 562 """
54f9ee45 563 return _gdi_.Bitmap_ConvertToImage(*args, **kwargs)
e811c8ce
RD
564
565 def GetMask(*args, **kwargs):
0df68c9f 566 """
a95a7133 567 GetMask(self) -> Mask
1e0c8722 568
66c033b4
RD
569 Gets the associated mask (if any) which may have been loaded from a
570 file or explpicitly set for the bitmap.
571
572 :see: `SetMask`, `wx.Mask`
573
0df68c9f 574 """
54f9ee45 575 return _gdi_.Bitmap_GetMask(*args, **kwargs)
e811c8ce
RD
576
577 def SetMask(*args, **kwargs):
0df68c9f 578 """
a95a7133 579 SetMask(self, Mask mask)
1e0c8722 580
0df68c9f 581 Sets the mask for this bitmap.
66c033b4
RD
582
583 :see: `GetMask`, `wx.Mask`
584
0df68c9f 585 """
54f9ee45 586 return _gdi_.Bitmap_SetMask(*args, **kwargs)
e811c8ce
RD
587
588 def SetMaskColour(*args, **kwargs):
0df68c9f 589 """
a95a7133 590 SetMaskColour(self, Colour colour)
1e0c8722 591
0df68c9f
RD
592 Create a Mask based on a specified colour in the Bitmap.
593 """
54f9ee45 594 return _gdi_.Bitmap_SetMaskColour(*args, **kwargs)
e811c8ce
RD
595
596 def GetSubBitmap(*args, **kwargs):
0df68c9f 597 """
a95a7133 598 GetSubBitmap(self, Rect rect) -> Bitmap
1e0c8722 599
66c033b4
RD
600 Returns a sub-bitmap of the current one as long as the rect belongs
601 entirely to the bitmap. This function preserves bit depth and mask
602 information.
0df68c9f 603 """
54f9ee45 604 return _gdi_.Bitmap_GetSubBitmap(*args, **kwargs)
e811c8ce
RD
605
606 def SaveFile(*args, **kwargs):
0df68c9f 607 """
66c033b4 608 SaveFile(self, String name, int type, Palette palette=None) -> bool
1e0c8722 609
66c033b4
RD
610 Saves a bitmap in the named file. See `__init__` for a description of
611 the ``type`` parameter.
0df68c9f 612 """
54f9ee45 613 return _gdi_.Bitmap_SaveFile(*args, **kwargs)
e811c8ce
RD
614
615 def LoadFile(*args, **kwargs):
0df68c9f 616 """
a95a7133 617 LoadFile(self, String name, int type) -> bool
1e0c8722 618
66c033b4
RD
619 Loads a bitmap from a file. See `__init__` for a description of the
620 ``type`` parameter.
0df68c9f 621 """
54f9ee45 622 return _gdi_.Bitmap_LoadFile(*args, **kwargs)
e811c8ce 623
d3b6e4ff
RD
624 def GetPalette(*args, **kwargs):
625 """GetPalette(self) -> Palette"""
626 return _gdi_.Bitmap_GetPalette(*args, **kwargs)
627
e811c8ce 628 def CopyFromIcon(*args, **kwargs):
a95a7133 629 """CopyFromIcon(self, Icon icon) -> bool"""
54f9ee45 630 return _gdi_.Bitmap_CopyFromIcon(*args, **kwargs)
e811c8ce
RD
631
632 def SetHeight(*args, **kwargs):
0df68c9f 633 """
a95a7133 634 SetHeight(self, int height)
1e0c8722 635
66c033b4 636 Set the height property (does not affect the existing bitmap data).
0df68c9f 637 """
54f9ee45 638 return _gdi_.Bitmap_SetHeight(*args, **kwargs)
e811c8ce
RD
639
640 def SetWidth(*args, **kwargs):
0df68c9f 641 """
a95a7133 642 SetWidth(self, int width)
1e0c8722 643
66c033b4 644 Set the width property (does not affect the existing bitmap data).
0df68c9f 645 """
54f9ee45 646 return _gdi_.Bitmap_SetWidth(*args, **kwargs)
e811c8ce
RD
647
648 def SetDepth(*args, **kwargs):
0df68c9f 649 """
a95a7133 650 SetDepth(self, int depth)
1e0c8722 651
66c033b4 652 Set the depth property (does not affect the existing bitmap data).
0df68c9f 653 """
54f9ee45 654 return _gdi_.Bitmap_SetDepth(*args, **kwargs)
e811c8ce 655
b2df227b
RD
656 def SetSize(*args, **kwargs):
657 """
a95a7133 658 SetSize(self, Size size)
b2df227b 659
66c033b4 660 Set the bitmap size (does not affect the existing bitmap data).
b2df227b 661 """
54f9ee45 662 return _gdi_.Bitmap_SetSize(*args, **kwargs)
b2df227b 663
d14a1e28 664 def __nonzero__(self): return self.Ok()
4276dc52 665 def __eq__(*args, **kwargs):
a95a7133 666 """__eq__(self, Bitmap other) -> bool"""
54f9ee45 667 return _gdi_.Bitmap___eq__(*args, **kwargs)
4276dc52
RD
668
669 def __ne__(*args, **kwargs):
a95a7133 670 """__ne__(self, Bitmap other) -> bool"""
54f9ee45 671 return _gdi_.Bitmap___ne__(*args, **kwargs)
4276dc52 672
2bf58437
RD
673 Depth = property(GetDepth,SetDepth,doc="See `GetDepth` and `SetDepth`")
674 Height = property(GetHeight,SetHeight,doc="See `GetHeight` and `SetHeight`")
675 Mask = property(GetMask,SetMask,doc="See `GetMask` and `SetMask`")
676 Palette = property(GetPalette,doc="See `GetPalette`")
677 Size = property(GetSize,SetSize,doc="See `GetSize` and `SetSize`")
678 SubBitmap = property(GetSubBitmap,doc="See `GetSubBitmap`")
679 Width = property(GetWidth,SetWidth,doc="See `GetWidth` and `SetWidth`")
2131d850 680_gdi_.Bitmap_swigregister(Bitmap)
70551f47 681
66c033b4
RD
682def EmptyBitmap(*args, **kwargs):
683 """
684 EmptyBitmap(int width, int height, int depth=-1) -> Bitmap
685
686 Creates a new bitmap of the given size. A depth of -1 indicates the
687 depth of the current screen or visual. Some platforms only support 1
0085ce49 688 for monochrome and -1 for the current display depth.
66c033b4
RD
689 """
690 val = _gdi_.new_EmptyBitmap(*args, **kwargs)
66c033b4
RD
691 return val
692
d14a1e28 693def BitmapFromIcon(*args, **kwargs):
0df68c9f
RD
694 """
695 BitmapFromIcon(Icon icon) -> Bitmap
1e0c8722 696
66c033b4 697 Create a new bitmap from a `wx.Icon` object.
0df68c9f 698 """
54f9ee45 699 val = _gdi_.new_BitmapFromIcon(*args, **kwargs)
d14a1e28 700 return val
70551f47 701
d14a1e28 702def BitmapFromImage(*args, **kwargs):
0df68c9f
RD
703 """
704 BitmapFromImage(Image image, int depth=-1) -> Bitmap
705
66c033b4
RD
706 Creates bitmap object from a `wx.Image`. This has to be done to
707 actually display a `wx.Image` as you cannot draw an image directly on
708 a window. The resulting bitmap will use the provided colour depth (or
709 that of the current screen colour depth if depth is -1) which entails
710 that a colour reduction may have to take place.
0df68c9f 711 """
54f9ee45 712 val = _gdi_.new_BitmapFromImage(*args, **kwargs)
d14a1e28 713 return val
3ef86e32 714
d14a1e28 715def BitmapFromXPMData(*args, **kwargs):
0df68c9f
RD
716 """
717 BitmapFromXPMData(PyObject listOfStrings) -> Bitmap
1e0c8722 718
0df68c9f
RD
719 Construct a Bitmap from a list of strings formatted as XPM data.
720 """
54f9ee45 721 val = _gdi_.new_BitmapFromXPMData(*args, **kwargs)
d14a1e28 722 return val
3ef86e32 723
d14a1e28 724def BitmapFromBits(*args, **kwargs):
0df68c9f
RD
725 """
726 BitmapFromBits(PyObject bits, int width, int height, int depth=1) -> Bitmap
727
66c033b4
RD
728 Creates a bitmap from an array of bits. You should only use this
729 function for monochrome bitmaps (depth 1) in portable programs: in
730 this case the bits parameter should contain an XBM image. For other
731 bit depths, the behaviour is platform dependent.
0df68c9f 732 """
54f9ee45 733 val = _gdi_.new_BitmapFromBits(*args, **kwargs)
d14a1e28 734 return val
3ef86e32 735
fc46b7f3
RD
736
737def _BitmapFromBufferAlpha(*args, **kwargs):
738 """_BitmapFromBufferAlpha(int width, int height, buffer data, buffer alpha) -> Bitmap"""
739 return _gdi_._BitmapFromBufferAlpha(*args, **kwargs)
740
741def _BitmapFromBuffer(*args, **kwargs):
742 """_BitmapFromBuffer(int width, int height, buffer data) -> Bitmap"""
743 return _gdi_._BitmapFromBuffer(*args, **kwargs)
744def BitmapFromBuffer(width, height, dataBuffer, alphaBuffer=None):
745 """
746 Creates a `wx.Bitmap` from the data in dataBuffer. The dataBuffer
eec1c382
RD
747 parameter must be a Python object that implements the buffer
748 interface, such as a string, array, etc. The dataBuffer object is
749 expected to contain a series of RGB bytes and be width*height*3
750 bytes long. A buffer object can optionally be supplied for the
751 image's alpha channel data, and it is expected to be width*height
752 bytes long. On Windows the RGB values are 'premultiplied' by the
753 alpha values. (The other platforms do the multiplication
754 themselves.)
755
756 Unlike `wx.ImageFromBuffer` the bitmap created with this function
757 does not share the memory buffer with the buffer object. This is
758 because the native pixel buffer format varies on different
759 platforms, and so instead an efficient as possible copy of the
760 data is made from the buffer objects to the bitmap's native pixel
761 buffer. For direct access to a bitmap's pixel buffer see
762 `wx.NativePixelData` and `wx.AlphaPixelData`.
fc46b7f3
RD
763
764 :see: `wx.Bitmap`, `wx.BitmapFromBufferRGBA`, `wx.NativePixelData`,
765 `wx.AlphaPixelData`, `wx.ImageFromBuffer`
766 """
fc46b7f3
RD
767 if alphaBuffer is not None:
768 return _gdi_._BitmapFromBufferAlpha(width, height, dataBuffer, alphaBuffer)
769 else:
770 return _gdi_._BitmapFromBuffer(width, height, dataBuffer)
771
772
773def _BitmapFromBufferRGBA(*args, **kwargs):
774 """_BitmapFromBufferRGBA(int width, int height, buffer data) -> Bitmap"""
775 return _gdi_._BitmapFromBufferRGBA(*args, **kwargs)
776def BitmapFromBufferRGBA(width, height, dataBuffer):
777 """
778 Creates a `wx.Bitmap` from the data in dataBuffer. The dataBuffer
eec1c382
RD
779 parameter must be a Python object that implements the buffer
780 interface, such as a string, array, etc. The dataBuffer object is
781 expected to contain a series of RGBA bytes (red, green, blue and
782 alpha) and be width*height*4 bytes long. On Windows the RGB
783 values are 'premultiplied' by the alpha values. (The other
784 platforms do the multiplication themselves.)
785
786 Unlike `wx.ImageFromBuffer` the bitmap created with this function
787 does not share the memory buffer with the buffer object. This is
788 because the native pixel buffer format varies on different
789 platforms, and so instead an efficient as possible copy of the
790 data is made from the buffer object to the bitmap's native pixel
791 buffer. For direct access to a bitmap's pixel buffer see
792 `wx.NativePixelData` and `wx.AlphaPixelData`.
fc46b7f3
RD
793
794 :see: `wx.Bitmap`, `wx.BitmapFromBuffer`, `wx.NativePixelData`,
795 `wx.AlphaPixelData`, `wx.ImageFromBuffer`
796 """
fc46b7f3
RD
797 return _gdi_._BitmapFromBufferRGBA(width, height, dataBuffer)
798
799class PixelDataBase(object):
800 """Proxy of C++ PixelDataBase class"""
801 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
802 def __init__(self): raise AttributeError, "No constructor defined"
803 __repr__ = _swig_repr
804 def GetOrigin(*args, **kwargs):
805 """GetOrigin(self) -> Point"""
806 return _gdi_.PixelDataBase_GetOrigin(*args, **kwargs)
807
808 def GetWidth(*args, **kwargs):
809 """GetWidth(self) -> int"""
810 return _gdi_.PixelDataBase_GetWidth(*args, **kwargs)
811
812 def GetHeight(*args, **kwargs):
813 """GetHeight(self) -> int"""
814 return _gdi_.PixelDataBase_GetHeight(*args, **kwargs)
815
816 def GetSize(*args, **kwargs):
817 """GetSize(self) -> Size"""
818 return _gdi_.PixelDataBase_GetSize(*args, **kwargs)
819
820 def GetRowStride(*args, **kwargs):
821 """GetRowStride(self) -> int"""
822 return _gdi_.PixelDataBase_GetRowStride(*args, **kwargs)
823
33d6fd3b
RD
824 Height = property(GetHeight,doc="See `GetHeight`")
825 Origin = property(GetOrigin,doc="See `GetOrigin`")
826 RowStride = property(GetRowStride,doc="See `GetRowStride`")
827 Size = property(GetSize,doc="See `GetSize`")
828 Width = property(GetWidth,doc="See `GetWidth`")
fc46b7f3
RD
829_gdi_.PixelDataBase_swigregister(PixelDataBase)
830
831class NativePixelData(PixelDataBase):
832 """Proxy of C++ NativePixelData class"""
833 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
834 __repr__ = _swig_repr
835 def __init__(self, *args):
836 """
837 __init__(self, Bitmap bmp) -> NativePixelData
838 __init__(self, Bitmap bmp, Rect rect) -> NativePixelData
839 __init__(self, Bitmap bmp, Point pt, Size sz) -> NativePixelData
840 """
841 _gdi_.NativePixelData_swiginit(self,_gdi_.new_NativePixelData(*args))
842 __swig_destroy__ = _gdi_.delete_NativePixelData
843 __del__ = lambda self : None;
844 def GetPixels(*args, **kwargs):
845 """GetPixels(self) -> NativePixelData_Accessor"""
846 return _gdi_.NativePixelData_GetPixels(*args, **kwargs)
847
848 def UseAlpha(*args, **kwargs):
849 """UseAlpha(self)"""
850 return _gdi_.NativePixelData_UseAlpha(*args, **kwargs)
851
852 def __nonzero__(*args, **kwargs):
853 """__nonzero__(self) -> bool"""
854 return _gdi_.NativePixelData___nonzero__(*args, **kwargs)
855
856 def __iter__(self):
195a89b4
RD
857 """
858 Create and return an iterator object for this pixel data
859 object. (It's really a generator but I won't tell if you
860 don't tell.)
861 """
862 width = self.GetWidth()
863 height = self.GetHeight()
864 pixels = self.GetPixels()
865
866
867
868
869 class PixelFacade(object):
fc46b7f3 870 def Get(self):
195a89b4
RD
871 return pixels.Get()
872 def Set(self, *args, **kw):
873 return pixels.Set(*args, **kw)
874 def __str__(self):
875 return str(self.Get())
876 def __repr__(self):
877 return 'pixel(%d,%d): %s' % (x,y,self.Get())
878 X = property(lambda self: x)
879 Y = property(lambda self: y)
880
881 pf = PixelFacade()
882 for y in xrange(height):
883 for x in xrange(width):
884
885
886
887 yield pf
888 pixels.nextPixel()
889 pixels.MoveTo(self, 0, y)
fc46b7f3 890
2bf58437 891 Pixels = property(GetPixels,doc="See `GetPixels`")
fc46b7f3
RD
892_gdi_.NativePixelData_swigregister(NativePixelData)
893
894class NativePixelData_Accessor(object):
895 """Proxy of C++ NativePixelData_Accessor class"""
896 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
897 __repr__ = _swig_repr
898 def __init__(self, *args):
899 """
900 __init__(self, NativePixelData data) -> NativePixelData_Accessor
901 __init__(self, Bitmap bmp, NativePixelData data) -> NativePixelData_Accessor
902 __init__(self) -> NativePixelData_Accessor
903 """
904 _gdi_.NativePixelData_Accessor_swiginit(self,_gdi_.new_NativePixelData_Accessor(*args))
905 __swig_destroy__ = _gdi_.delete_NativePixelData_Accessor
906 __del__ = lambda self : None;
907 def Reset(*args, **kwargs):
908 """Reset(self, NativePixelData data)"""
909 return _gdi_.NativePixelData_Accessor_Reset(*args, **kwargs)
910
911 def IsOk(*args, **kwargs):
912 """IsOk(self) -> bool"""
913 return _gdi_.NativePixelData_Accessor_IsOk(*args, **kwargs)
914
915 def nextPixel(*args, **kwargs):
916 """nextPixel(self)"""
917 return _gdi_.NativePixelData_Accessor_nextPixel(*args, **kwargs)
918
919 def Offset(*args, **kwargs):
920 """Offset(self, NativePixelData data, int x, int y)"""
921 return _gdi_.NativePixelData_Accessor_Offset(*args, **kwargs)
922
923 def OffsetX(*args, **kwargs):
924 """OffsetX(self, NativePixelData data, int x)"""
925 return _gdi_.NativePixelData_Accessor_OffsetX(*args, **kwargs)
926
927 def OffsetY(*args, **kwargs):
928 """OffsetY(self, NativePixelData data, int y)"""
929 return _gdi_.NativePixelData_Accessor_OffsetY(*args, **kwargs)
930
931 def MoveTo(*args, **kwargs):
932 """MoveTo(self, NativePixelData data, int x, int y)"""
933 return _gdi_.NativePixelData_Accessor_MoveTo(*args, **kwargs)
934
935 def Set(*args, **kwargs):
936 """Set(self, byte red, byte green, byte blue)"""
937 return _gdi_.NativePixelData_Accessor_Set(*args, **kwargs)
938
939 def Get(*args, **kwargs):
940 """Get(self) -> PyObject"""
941 return _gdi_.NativePixelData_Accessor_Get(*args, **kwargs)
942
943_gdi_.NativePixelData_Accessor_swigregister(NativePixelData_Accessor)
944
945class AlphaPixelData(PixelDataBase):
946 """Proxy of C++ AlphaPixelData class"""
947 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
948 __repr__ = _swig_repr
949 def __init__(self, *args):
950 """
951 __init__(self, Bitmap bmp) -> AlphaPixelData
952 __init__(self, Bitmap bmp, Rect rect) -> AlphaPixelData
953 __init__(self, Bitmap bmp, Point pt, Size sz) -> AlphaPixelData
954 """
955 _gdi_.AlphaPixelData_swiginit(self,_gdi_.new_AlphaPixelData(*args))
956 self.UseAlpha()
957
958 __swig_destroy__ = _gdi_.delete_AlphaPixelData
959 __del__ = lambda self : None;
960 def GetPixels(*args, **kwargs):
961 """GetPixels(self) -> AlphaPixelData_Accessor"""
962 return _gdi_.AlphaPixelData_GetPixels(*args, **kwargs)
963
964 def UseAlpha(*args, **kwargs):
965 """UseAlpha(self)"""
966 return _gdi_.AlphaPixelData_UseAlpha(*args, **kwargs)
967
968 def __nonzero__(*args, **kwargs):
969 """__nonzero__(self) -> bool"""
970 return _gdi_.AlphaPixelData___nonzero__(*args, **kwargs)
971
972 def __iter__(self):
195a89b4
RD
973 """
974 Create and return an iterator object for this pixel data
975 object. (It's really a generator but I won't tell if you
976 don't tell.)
977 """
978 width = self.GetWidth()
979 height = self.GetHeight()
980 pixels = self.GetPixels()
981
982
983
984
985 class PixelFacade(object):
fc46b7f3 986 def Get(self):
195a89b4
RD
987 return pixels.Get()
988 def Set(self, *args, **kw):
989 return pixels.Set(*args, **kw)
990 def __str__(self):
991 return str(self.Get())
992 def __repr__(self):
993 return 'pixel(%d,%d): %s' % (x,y,self.Get())
994 X = property(lambda self: x)
995 Y = property(lambda self: y)
996
997 pf = PixelFacade()
998 for y in xrange(height):
999 for x in xrange(width):
1000
1001
1002
1003 yield pf
1004 pixels.nextPixel()
1005 pixels.MoveTo(self, 0, y)
fc46b7f3 1006
2bf58437 1007 Pixels = property(GetPixels,doc="See `GetPixels`")
fc46b7f3
RD
1008_gdi_.AlphaPixelData_swigregister(AlphaPixelData)
1009
1010class AlphaPixelData_Accessor(object):
1011 """Proxy of C++ AlphaPixelData_Accessor class"""
1012 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1013 __repr__ = _swig_repr
1014 def __init__(self, *args):
1015 """
1016 __init__(self, AlphaPixelData data) -> AlphaPixelData_Accessor
1017 __init__(self, Bitmap bmp, AlphaPixelData data) -> AlphaPixelData_Accessor
1018 __init__(self) -> AlphaPixelData_Accessor
1019 """
1020 _gdi_.AlphaPixelData_Accessor_swiginit(self,_gdi_.new_AlphaPixelData_Accessor(*args))
1021 __swig_destroy__ = _gdi_.delete_AlphaPixelData_Accessor
1022 __del__ = lambda self : None;
1023 def Reset(*args, **kwargs):
1024 """Reset(self, AlphaPixelData data)"""
1025 return _gdi_.AlphaPixelData_Accessor_Reset(*args, **kwargs)
1026
1027 def IsOk(*args, **kwargs):
1028 """IsOk(self) -> bool"""
1029 return _gdi_.AlphaPixelData_Accessor_IsOk(*args, **kwargs)
1030
1031 def nextPixel(*args, **kwargs):
1032 """nextPixel(self)"""
1033 return _gdi_.AlphaPixelData_Accessor_nextPixel(*args, **kwargs)
1034
1035 def Offset(*args, **kwargs):
1036 """Offset(self, AlphaPixelData data, int x, int y)"""
1037 return _gdi_.AlphaPixelData_Accessor_Offset(*args, **kwargs)
1038
1039 def OffsetX(*args, **kwargs):
1040 """OffsetX(self, AlphaPixelData data, int x)"""
1041 return _gdi_.AlphaPixelData_Accessor_OffsetX(*args, **kwargs)
1042
1043 def OffsetY(*args, **kwargs):
1044 """OffsetY(self, AlphaPixelData data, int y)"""
1045 return _gdi_.AlphaPixelData_Accessor_OffsetY(*args, **kwargs)
1046
1047 def MoveTo(*args, **kwargs):
1048 """MoveTo(self, AlphaPixelData data, int x, int y)"""
1049 return _gdi_.AlphaPixelData_Accessor_MoveTo(*args, **kwargs)
1050
1051 def Set(*args, **kwargs):
1052 """Set(self, byte red, byte green, byte blue, byte alpha)"""
1053 return _gdi_.AlphaPixelData_Accessor_Set(*args, **kwargs)
1054
1055 def Get(*args, **kwargs):
1056 """Get(self) -> PyObject"""
1057 return _gdi_.AlphaPixelData_Accessor_Get(*args, **kwargs)
1058
1059_gdi_.AlphaPixelData_Accessor_swigregister(AlphaPixelData_Accessor)
1060
66c033b4 1061class Mask(_core.Object):
b2df227b 1062 """
66c033b4
RD
1063 This class encapsulates a monochrome mask bitmap, where the masked
1064 area is black and the unmasked area is white. When associated with a
1065 bitmap and drawn in a device context, the unmasked area of the bitmap
1066 will be drawn, and the masked area will not be drawn.
b2df227b 1067
66c033b4
RD
1068 A mask may be associated with a `wx.Bitmap`. It is used in
1069 `wx.DC.DrawBitmap` or `wx.DC.Blit` when the source device context is a
1070 `wx.MemoryDC` with a `wx.Bitmap` selected into it that contains a
1071 mask.
0df68c9f 1072 """
0085ce49
RD
1073 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1074 __repr__ = _swig_repr
1075 def __init__(self, *args, **kwargs):
0df68c9f 1076 """
a95a7133 1077 __init__(self, Bitmap bitmap, Colour colour=NullColour) -> Mask
1e0c8722 1078
66c033b4
RD
1079 Constructs a mask from a `wx.Bitmap` and a `wx.Colour` in that bitmap
1080 that indicates the transparent portions of the mask. In other words,
1081 the pixels in ``bitmap`` that match ``colour`` will be the transparent
1082 portions of the mask. If no ``colour`` or an invalid ``colour`` is
1083 passed then BLACK is used.
1084
1085 :see: `wx.Bitmap`, `wx.Colour`
0df68c9f 1086 """
0085ce49
RD
1087 _gdi_.Mask_swiginit(self,_gdi_.new_Mask(*args, **kwargs))
1088 __swig_destroy__ = _gdi_.delete_Mask
1089 __del__ = lambda self : None;
2131d850 1090_gdi_.Mask_swigregister(Mask)
d14a1e28 1091
66c033b4 1092MaskColour = wx._deprecated(Mask, "wx.MaskColour is deprecated, use `wx.Mask` instead.")
d14a1e28 1093class Icon(GDIObject):
093d3ff1 1094 """Proxy of C++ Icon class"""
0085ce49
RD
1095 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1096 __repr__ = _swig_repr
1097 def __init__(self, *args, **kwargs):
a95a7133 1098 """__init__(self, String name, int type, int desiredWidth=-1, int desiredHeight=-1) -> Icon"""
0085ce49
RD
1099 _gdi_.Icon_swiginit(self,_gdi_.new_Icon(*args, **kwargs))
1100 __swig_destroy__ = _gdi_.delete_Icon
1101 __del__ = lambda self : None;
e811c8ce 1102 def LoadFile(*args, **kwargs):
a95a7133 1103 """LoadFile(self, String name, int type) -> bool"""
54f9ee45 1104 return _gdi_.Icon_LoadFile(*args, **kwargs)
e811c8ce
RD
1105
1106 def Ok(*args, **kwargs):
a95a7133 1107 """Ok(self) -> bool"""
54f9ee45 1108 return _gdi_.Icon_Ok(*args, **kwargs)
e811c8ce
RD
1109
1110 def GetWidth(*args, **kwargs):
a95a7133 1111 """GetWidth(self) -> int"""
54f9ee45 1112 return _gdi_.Icon_GetWidth(*args, **kwargs)
e811c8ce
RD
1113
1114 def GetHeight(*args, **kwargs):
a95a7133 1115 """GetHeight(self) -> int"""
54f9ee45 1116 return _gdi_.Icon_GetHeight(*args, **kwargs)
e811c8ce
RD
1117
1118 def GetDepth(*args, **kwargs):
a95a7133 1119 """GetDepth(self) -> int"""
54f9ee45 1120 return _gdi_.Icon_GetDepth(*args, **kwargs)
e811c8ce
RD
1121
1122 def SetWidth(*args, **kwargs):
a95a7133 1123 """SetWidth(self, int w)"""
54f9ee45 1124 return _gdi_.Icon_SetWidth(*args, **kwargs)
e811c8ce
RD
1125
1126 def SetHeight(*args, **kwargs):
a95a7133 1127 """SetHeight(self, int h)"""
54f9ee45 1128 return _gdi_.Icon_SetHeight(*args, **kwargs)
e811c8ce
RD
1129
1130 def SetDepth(*args, **kwargs):
a95a7133 1131 """SetDepth(self, int d)"""
54f9ee45 1132 return _gdi_.Icon_SetDepth(*args, **kwargs)
e811c8ce
RD
1133
1134 def CopyFromBitmap(*args, **kwargs):
a95a7133 1135 """CopyFromBitmap(self, Bitmap bmp)"""
54f9ee45 1136 return _gdi_.Icon_CopyFromBitmap(*args, **kwargs)
e811c8ce 1137
d14a1e28 1138 def __nonzero__(self): return self.Ok()
97ab0f6a
RD
1139 Depth = property(GetDepth,SetDepth,doc="See `GetDepth` and `SetDepth`")
1140 Height = property(GetHeight,SetHeight,doc="See `GetHeight` and `SetHeight`")
1141 Width = property(GetWidth,SetWidth,doc="See `GetWidth` and `SetWidth`")
2131d850 1142_gdi_.Icon_swigregister(Icon)
059a841c 1143
d14a1e28 1144def EmptyIcon(*args, **kwargs):
e811c8ce 1145 """EmptyIcon() -> Icon"""
54f9ee45 1146 val = _gdi_.new_EmptyIcon(*args, **kwargs)
d14a1e28 1147 return val
059a841c 1148
d14a1e28 1149def IconFromLocation(*args, **kwargs):
e811c8ce 1150 """IconFromLocation(IconLocation loc) -> Icon"""
54f9ee45 1151 val = _gdi_.new_IconFromLocation(*args, **kwargs)
a323d3bd 1152 return val
059a841c 1153
d14a1e28 1154def IconFromBitmap(*args, **kwargs):
e811c8ce 1155 """IconFromBitmap(Bitmap bmp) -> Icon"""
54f9ee45 1156 val = _gdi_.new_IconFromBitmap(*args, **kwargs)
a323d3bd 1157 return val
059a841c 1158
d14a1e28 1159def IconFromXPMData(*args, **kwargs):
e811c8ce 1160 """IconFromXPMData(PyObject listOfStrings) -> Icon"""
54f9ee45 1161 val = _gdi_.new_IconFromXPMData(*args, **kwargs)
d14a1e28 1162 return val
059a841c 1163
d14a1e28 1164class IconLocation(object):
093d3ff1 1165 """Proxy of C++ IconLocation class"""
0085ce49
RD
1166 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1167 __repr__ = _swig_repr
1168 def __init__(self, *args, **kwargs):
a95a7133 1169 """__init__(self, String filename=&wxPyEmptyString, int num=0) -> IconLocation"""
0085ce49
RD
1170 _gdi_.IconLocation_swiginit(self,_gdi_.new_IconLocation(*args, **kwargs))
1171 __swig_destroy__ = _gdi_.delete_IconLocation
1172 __del__ = lambda self : None;
e811c8ce 1173 def IsOk(*args, **kwargs):
a95a7133 1174 """IsOk(self) -> bool"""
54f9ee45 1175 return _gdi_.IconLocation_IsOk(*args, **kwargs)
e811c8ce 1176
d14a1e28 1177 def __nonzero__(self): return self.Ok()
e811c8ce 1178 def SetFileName(*args, **kwargs):
a95a7133 1179 """SetFileName(self, String filename)"""
54f9ee45 1180 return _gdi_.IconLocation_SetFileName(*args, **kwargs)
e811c8ce
RD
1181
1182 def GetFileName(*args, **kwargs):
a95a7133 1183 """GetFileName(self) -> String"""
54f9ee45 1184 return _gdi_.IconLocation_GetFileName(*args, **kwargs)
e811c8ce
RD
1185
1186 def SetIndex(*args, **kwargs):
a95a7133 1187 """SetIndex(self, int num)"""
54f9ee45 1188 return _gdi_.IconLocation_SetIndex(*args, **kwargs)
e811c8ce
RD
1189
1190 def GetIndex(*args, **kwargs):
a95a7133 1191 """GetIndex(self) -> int"""
54f9ee45 1192 return _gdi_.IconLocation_GetIndex(*args, **kwargs)
e811c8ce 1193
97ab0f6a
RD
1194 FileName = property(GetFileName,SetFileName,doc="See `GetFileName` and `SetFileName`")
1195 Index = property(GetIndex,SetIndex,doc="See `GetIndex` and `SetIndex`")
2131d850 1196_gdi_.IconLocation_swigregister(IconLocation)
d14a1e28
RD
1197
1198class IconBundle(object):
093d3ff1 1199 """Proxy of C++ IconBundle class"""
0085ce49
RD
1200 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1201 __repr__ = _swig_repr
1202 def __init__(self, *args, **kwargs):
a95a7133 1203 """__init__(self) -> IconBundle"""
0085ce49
RD
1204 _gdi_.IconBundle_swiginit(self,_gdi_.new_IconBundle(*args, **kwargs))
1205 __swig_destroy__ = _gdi_.delete_IconBundle
1206 __del__ = lambda self : None;
e811c8ce 1207 def AddIcon(*args, **kwargs):
a95a7133 1208 """AddIcon(self, Icon icon)"""
54f9ee45 1209 return _gdi_.IconBundle_AddIcon(*args, **kwargs)
e811c8ce
RD
1210
1211 def AddIconFromFile(*args, **kwargs):
a95a7133 1212 """AddIconFromFile(self, String file, long type)"""
54f9ee45 1213 return _gdi_.IconBundle_AddIconFromFile(*args, **kwargs)
e811c8ce
RD
1214
1215 def GetIcon(*args, **kwargs):
a95a7133 1216 """GetIcon(self, Size size) -> Icon"""
54f9ee45 1217 return _gdi_.IconBundle_GetIcon(*args, **kwargs)
e811c8ce 1218
97ab0f6a 1219 Icon = property(GetIcon,doc="See `GetIcon`")
2131d850 1220_gdi_.IconBundle_swigregister(IconBundle)
5e40f9dd 1221
d14a1e28 1222def IconBundleFromFile(*args, **kwargs):
196addbf 1223 """IconBundleFromFile(String file, long type) -> IconBundle"""
54f9ee45 1224 val = _gdi_.new_IconBundleFromFile(*args, **kwargs)
d14a1e28 1225 return val
5e40f9dd 1226
d14a1e28 1227def IconBundleFromIcon(*args, **kwargs):
e811c8ce 1228 """IconBundleFromIcon(Icon icon) -> IconBundle"""
54f9ee45 1229 val = _gdi_.new_IconBundleFromIcon(*args, **kwargs)
d14a1e28 1230 return val
5e40f9dd 1231
d14a1e28 1232class Cursor(GDIObject):
15afbcd0 1233 """
41e2b43e
RD
1234 A cursor is a small bitmap usually used for denoting where the mouse
1235 pointer is, with a picture that might indicate the interpretation of a
1236 mouse click.
15afbcd0
RD
1237
1238 A single cursor object may be used in many windows (any subwindow
41e2b43e
RD
1239 type). The wxWindows convention is to set the cursor for a window, as
1240 in X, rather than to set it globally as in MS Windows, although a
1241 global `wx.SetCursor` function is also available for use on MS Windows.
1242
15afbcd0 1243 """
0085ce49
RD
1244 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1245 __repr__ = _swig_repr
1246 def __init__(self, *args, **kwargs):
15afbcd0 1247 """
a95a7133 1248 __init__(self, String cursorName, long type, int hotSpotX=0, int hotSpotY=0) -> Cursor
15afbcd0
RD
1249
1250 Construct a Cursor from a file. Specify the type of file using
7557b9b5 1251 wx.BITAMP_TYPE* constants, and specify the hotspot if not using a .cur
41e2b43e 1252 file.
15afbcd0 1253 """
0085ce49
RD
1254 _gdi_.Cursor_swiginit(self,_gdi_.new_Cursor(*args, **kwargs))
1255 __swig_destroy__ = _gdi_.delete_Cursor
1256 __del__ = lambda self : None;
e811c8ce 1257 def Ok(*args, **kwargs):
a95a7133 1258 """Ok(self) -> bool"""
54f9ee45 1259 return _gdi_.Cursor_Ok(*args, **kwargs)
e811c8ce 1260
d14a1e28 1261 def __nonzero__(self): return self.Ok()
2131d850 1262_gdi_.Cursor_swigregister(Cursor)
70551f47 1263
d14a1e28 1264def StockCursor(*args, **kwargs):
15afbcd0
RD
1265 """
1266 StockCursor(int id) -> Cursor
1267
41e2b43e 1268 Create a cursor using one of the stock cursors. Note that not all
7557b9b5 1269 stock cursors are available on all platforms.
15afbcd0 1270 """
54f9ee45 1271 val = _gdi_.new_StockCursor(*args, **kwargs)
d14a1e28 1272 return val
70551f47 1273
d14a1e28 1274def CursorFromImage(*args, **kwargs):
0df68c9f 1275 """
15afbcd0
RD
1276 CursorFromImage(Image image) -> Cursor
1277
7557b9b5 1278 Constructs a cursor from a `wx.Image`. The mask (if any) will be used
53aa7709 1279 for setting the transparent portions of the cursor.
0df68c9f 1280 """
54f9ee45 1281 val = _gdi_.new_CursorFromImage(*args, **kwargs)
d14a1e28 1282 return val
70551f47 1283
d14a1e28
RD
1284#---------------------------------------------------------------------------
1285
54f9ee45
RD
1286OutRegion = _gdi_.OutRegion
1287PartRegion = _gdi_.PartRegion
1288InRegion = _gdi_.InRegion
d14a1e28 1289class Region(GDIObject):
093d3ff1 1290 """Proxy of C++ Region class"""
0085ce49
RD
1291 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1292 __repr__ = _swig_repr
1293 def __init__(self, *args, **kwargs):
a95a7133 1294 """__init__(self, int x=0, int y=0, int width=0, int height=0) -> Region"""
0085ce49
RD
1295 _gdi_.Region_swiginit(self,_gdi_.new_Region(*args, **kwargs))
1296 __swig_destroy__ = _gdi_.delete_Region
1297 __del__ = lambda self : None;
e811c8ce 1298 def Clear(*args, **kwargs):
a95a7133 1299 """Clear(self)"""
54f9ee45 1300 return _gdi_.Region_Clear(*args, **kwargs)
e811c8ce
RD
1301
1302 def Offset(*args, **kwargs):
a95a7133 1303 """Offset(self, int x, int y) -> bool"""
54f9ee45 1304 return _gdi_.Region_Offset(*args, **kwargs)
e811c8ce
RD
1305
1306 def Contains(*args, **kwargs):
a95a7133 1307 """Contains(self, int x, int y) -> int"""
54f9ee45 1308 return _gdi_.Region_Contains(*args, **kwargs)
e811c8ce
RD
1309
1310 def ContainsPoint(*args, **kwargs):
a95a7133 1311 """ContainsPoint(self, Point pt) -> int"""
54f9ee45 1312 return _gdi_.Region_ContainsPoint(*args, **kwargs)
e811c8ce
RD
1313
1314 def ContainsRect(*args, **kwargs):
a95a7133 1315 """ContainsRect(self, Rect rect) -> int"""
54f9ee45 1316 return _gdi_.Region_ContainsRect(*args, **kwargs)
e811c8ce
RD
1317
1318 def ContainsRectDim(*args, **kwargs):
a95a7133 1319 """ContainsRectDim(self, int x, int y, int w, int h) -> int"""
54f9ee45 1320 return _gdi_.Region_ContainsRectDim(*args, **kwargs)
e811c8ce
RD
1321
1322 def GetBox(*args, **kwargs):
a95a7133 1323 """GetBox(self) -> Rect"""
54f9ee45 1324 return _gdi_.Region_GetBox(*args, **kwargs)
e811c8ce
RD
1325
1326 def Intersect(*args, **kwargs):
a95a7133 1327 """Intersect(self, int x, int y, int width, int height) -> bool"""
54f9ee45 1328 return _gdi_.Region_Intersect(*args, **kwargs)
e811c8ce
RD
1329
1330 def IntersectRect(*args, **kwargs):
a95a7133 1331 """IntersectRect(self, Rect rect) -> bool"""
54f9ee45 1332 return _gdi_.Region_IntersectRect(*args, **kwargs)
e811c8ce
RD
1333
1334 def IntersectRegion(*args, **kwargs):
a95a7133 1335 """IntersectRegion(self, Region region) -> bool"""
54f9ee45 1336 return _gdi_.Region_IntersectRegion(*args, **kwargs)
e811c8ce
RD
1337
1338 def IsEmpty(*args, **kwargs):
a95a7133 1339 """IsEmpty(self) -> bool"""
54f9ee45 1340 return _gdi_.Region_IsEmpty(*args, **kwargs)
e811c8ce 1341
f5263701
RD
1342 def IsEqual(*args, **kwargs):
1343 """IsEqual(self, Region region) -> bool"""
1344 return _gdi_.Region_IsEqual(*args, **kwargs)
1345
e811c8ce 1346 def Union(*args, **kwargs):
a95a7133 1347 """Union(self, int x, int y, int width, int height) -> bool"""
54f9ee45 1348 return _gdi_.Region_Union(*args, **kwargs)
e811c8ce
RD
1349
1350 def UnionRect(*args, **kwargs):
a95a7133 1351 """UnionRect(self, Rect rect) -> bool"""
54f9ee45 1352 return _gdi_.Region_UnionRect(*args, **kwargs)
e811c8ce
RD
1353
1354 def UnionRegion(*args, **kwargs):
a95a7133 1355 """UnionRegion(self, Region region) -> bool"""
54f9ee45 1356 return _gdi_.Region_UnionRegion(*args, **kwargs)
e811c8ce
RD
1357
1358 def Subtract(*args, **kwargs):
a95a7133 1359 """Subtract(self, int x, int y, int width, int height) -> bool"""
54f9ee45 1360 return _gdi_.Region_Subtract(*args, **kwargs)
e811c8ce
RD
1361
1362 def SubtractRect(*args, **kwargs):
a95a7133 1363 """SubtractRect(self, Rect rect) -> bool"""
54f9ee45 1364 return _gdi_.Region_SubtractRect(*args, **kwargs)
e811c8ce
RD
1365
1366 def SubtractRegion(*args, **kwargs):
a95a7133 1367 """SubtractRegion(self, Region region) -> bool"""
54f9ee45 1368 return _gdi_.Region_SubtractRegion(*args, **kwargs)
e811c8ce
RD
1369
1370 def Xor(*args, **kwargs):
a95a7133 1371 """Xor(self, int x, int y, int width, int height) -> bool"""
54f9ee45 1372 return _gdi_.Region_Xor(*args, **kwargs)
e811c8ce
RD
1373
1374 def XorRect(*args, **kwargs):
a95a7133 1375 """XorRect(self, Rect rect) -> bool"""
54f9ee45 1376 return _gdi_.Region_XorRect(*args, **kwargs)
e811c8ce
RD
1377
1378 def XorRegion(*args, **kwargs):
a95a7133 1379 """XorRegion(self, Region region) -> bool"""
54f9ee45 1380 return _gdi_.Region_XorRegion(*args, **kwargs)
e811c8ce
RD
1381
1382 def ConvertToBitmap(*args, **kwargs):
a95a7133 1383 """ConvertToBitmap(self) -> Bitmap"""
54f9ee45 1384 return _gdi_.Region_ConvertToBitmap(*args, **kwargs)
e811c8ce
RD
1385
1386 def UnionBitmap(*args, **kwargs):
e6ffcedd 1387 """UnionBitmap(self, Bitmap bmp) -> bool"""
54f9ee45 1388 return _gdi_.Region_UnionBitmap(*args, **kwargs)
e811c8ce 1389
e6ffcedd
RD
1390 def UnionBitmapColour(*args, **kwargs):
1391 """UnionBitmapColour(self, Bitmap bmp, Colour transColour, int tolerance=0) -> bool"""
1392 return _gdi_.Region_UnionBitmapColour(*args, **kwargs)
1393
33d6fd3b 1394 Box = property(GetBox,doc="See `GetBox`")
2131d850 1395_gdi_.Region_swigregister(Region)
5e40f9dd 1396
d14a1e28 1397def RegionFromBitmap(*args, **kwargs):
e6ffcedd 1398 """RegionFromBitmap(Bitmap bmp) -> Region"""
54f9ee45 1399 val = _gdi_.new_RegionFromBitmap(*args, **kwargs)
d14a1e28 1400 return val
5e40f9dd 1401
e6ffcedd
RD
1402def RegionFromBitmapColour(*args, **kwargs):
1403 """RegionFromBitmapColour(Bitmap bmp, Colour transColour, int tolerance=0) -> Region"""
1404 val = _gdi_.new_RegionFromBitmapColour(*args, **kwargs)
e6ffcedd
RD
1405 return val
1406
d14a1e28 1407def RegionFromPoints(*args, **kwargs):
093d3ff1 1408 """RegionFromPoints(int points, int fillStyle=WINDING_RULE) -> Region"""
54f9ee45 1409 val = _gdi_.new_RegionFromPoints(*args, **kwargs)
d14a1e28 1410 return val
5e40f9dd 1411
54f9ee45 1412class RegionIterator(_core.Object):
093d3ff1 1413 """Proxy of C++ RegionIterator class"""
0085ce49
RD
1414 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1415 __repr__ = _swig_repr
1416 def __init__(self, *args, **kwargs):
a95a7133 1417 """__init__(self, Region region) -> RegionIterator"""
0085ce49
RD
1418 _gdi_.RegionIterator_swiginit(self,_gdi_.new_RegionIterator(*args, **kwargs))
1419 __swig_destroy__ = _gdi_.delete_RegionIterator
1420 __del__ = lambda self : None;
e811c8ce 1421 def GetX(*args, **kwargs):
a95a7133 1422 """GetX(self) -> int"""
54f9ee45 1423 return _gdi_.RegionIterator_GetX(*args, **kwargs)
e811c8ce
RD
1424
1425 def GetY(*args, **kwargs):
a95a7133 1426 """GetY(self) -> int"""
54f9ee45 1427 return _gdi_.RegionIterator_GetY(*args, **kwargs)
e811c8ce
RD
1428
1429 def GetW(*args, **kwargs):
a95a7133 1430 """GetW(self) -> int"""
54f9ee45 1431 return _gdi_.RegionIterator_GetW(*args, **kwargs)
e811c8ce
RD
1432
1433 def GetWidth(*args, **kwargs):
a95a7133 1434 """GetWidth(self) -> int"""
54f9ee45 1435 return _gdi_.RegionIterator_GetWidth(*args, **kwargs)
e811c8ce
RD
1436
1437 def GetH(*args, **kwargs):
a95a7133 1438 """GetH(self) -> int"""
54f9ee45 1439 return _gdi_.RegionIterator_GetH(*args, **kwargs)
e811c8ce
RD
1440
1441 def GetHeight(*args, **kwargs):
a95a7133 1442 """GetHeight(self) -> int"""
54f9ee45 1443 return _gdi_.RegionIterator_GetHeight(*args, **kwargs)
e811c8ce
RD
1444
1445 def GetRect(*args, **kwargs):
a95a7133 1446 """GetRect(self) -> Rect"""
54f9ee45 1447 return _gdi_.RegionIterator_GetRect(*args, **kwargs)
e811c8ce
RD
1448
1449 def HaveRects(*args, **kwargs):
a95a7133 1450 """HaveRects(self) -> bool"""
54f9ee45 1451 return _gdi_.RegionIterator_HaveRects(*args, **kwargs)
e811c8ce
RD
1452
1453 def Reset(*args, **kwargs):
a95a7133 1454 """Reset(self)"""
54f9ee45 1455 return _gdi_.RegionIterator_Reset(*args, **kwargs)
e811c8ce
RD
1456
1457 def Next(*args, **kwargs):
a95a7133 1458 """Next(self)"""
54f9ee45 1459 return _gdi_.RegionIterator_Next(*args, **kwargs)
e811c8ce
RD
1460
1461 def __nonzero__(*args, **kwargs):
a95a7133 1462 """__nonzero__(self) -> bool"""
54f9ee45 1463 return _gdi_.RegionIterator___nonzero__(*args, **kwargs)
e811c8ce 1464
33d6fd3b
RD
1465 H = property(GetH,doc="See `GetH`")
1466 Height = property(GetHeight,doc="See `GetHeight`")
1467 Rect = property(GetRect,doc="See `GetRect`")
1468 W = property(GetW,doc="See `GetW`")
1469 Width = property(GetWidth,doc="See `GetWidth`")
1470 X = property(GetX,doc="See `GetX`")
1471 Y = property(GetY,doc="See `GetY`")
2131d850 1472_gdi_.RegionIterator_swigregister(RegionIterator)
d14a1e28
RD
1473
1474#---------------------------------------------------------------------------
1475
54f9ee45
RD
1476FONTFAMILY_DEFAULT = _gdi_.FONTFAMILY_DEFAULT
1477FONTFAMILY_DECORATIVE = _gdi_.FONTFAMILY_DECORATIVE
1478FONTFAMILY_ROMAN = _gdi_.FONTFAMILY_ROMAN
1479FONTFAMILY_SCRIPT = _gdi_.FONTFAMILY_SCRIPT
1480FONTFAMILY_SWISS = _gdi_.FONTFAMILY_SWISS
1481FONTFAMILY_MODERN = _gdi_.FONTFAMILY_MODERN
1482FONTFAMILY_TELETYPE = _gdi_.FONTFAMILY_TELETYPE
1483FONTFAMILY_MAX = _gdi_.FONTFAMILY_MAX
1484FONTFAMILY_UNKNOWN = _gdi_.FONTFAMILY_UNKNOWN
1485FONTSTYLE_NORMAL = _gdi_.FONTSTYLE_NORMAL
1486FONTSTYLE_ITALIC = _gdi_.FONTSTYLE_ITALIC
1487FONTSTYLE_SLANT = _gdi_.FONTSTYLE_SLANT
1488FONTSTYLE_MAX = _gdi_.FONTSTYLE_MAX
1489FONTWEIGHT_NORMAL = _gdi_.FONTWEIGHT_NORMAL
1490FONTWEIGHT_LIGHT = _gdi_.FONTWEIGHT_LIGHT
1491FONTWEIGHT_BOLD = _gdi_.FONTWEIGHT_BOLD
1492FONTWEIGHT_MAX = _gdi_.FONTWEIGHT_MAX
1493FONTFLAG_DEFAULT = _gdi_.FONTFLAG_DEFAULT
1494FONTFLAG_ITALIC = _gdi_.FONTFLAG_ITALIC
1495FONTFLAG_SLANT = _gdi_.FONTFLAG_SLANT
1496FONTFLAG_LIGHT = _gdi_.FONTFLAG_LIGHT
1497FONTFLAG_BOLD = _gdi_.FONTFLAG_BOLD
1498FONTFLAG_ANTIALIASED = _gdi_.FONTFLAG_ANTIALIASED
1499FONTFLAG_NOT_ANTIALIASED = _gdi_.FONTFLAG_NOT_ANTIALIASED
1500FONTFLAG_UNDERLINED = _gdi_.FONTFLAG_UNDERLINED
1501FONTFLAG_STRIKETHROUGH = _gdi_.FONTFLAG_STRIKETHROUGH
1502FONTFLAG_MASK = _gdi_.FONTFLAG_MASK
1503FONTENCODING_SYSTEM = _gdi_.FONTENCODING_SYSTEM
1504FONTENCODING_DEFAULT = _gdi_.FONTENCODING_DEFAULT
1505FONTENCODING_ISO8859_1 = _gdi_.FONTENCODING_ISO8859_1
1506FONTENCODING_ISO8859_2 = _gdi_.FONTENCODING_ISO8859_2
1507FONTENCODING_ISO8859_3 = _gdi_.FONTENCODING_ISO8859_3
1508FONTENCODING_ISO8859_4 = _gdi_.FONTENCODING_ISO8859_4
1509FONTENCODING_ISO8859_5 = _gdi_.FONTENCODING_ISO8859_5
1510FONTENCODING_ISO8859_6 = _gdi_.FONTENCODING_ISO8859_6
1511FONTENCODING_ISO8859_7 = _gdi_.FONTENCODING_ISO8859_7
1512FONTENCODING_ISO8859_8 = _gdi_.FONTENCODING_ISO8859_8
1513FONTENCODING_ISO8859_9 = _gdi_.FONTENCODING_ISO8859_9
1514FONTENCODING_ISO8859_10 = _gdi_.FONTENCODING_ISO8859_10
1515FONTENCODING_ISO8859_11 = _gdi_.FONTENCODING_ISO8859_11
1516FONTENCODING_ISO8859_12 = _gdi_.FONTENCODING_ISO8859_12
1517FONTENCODING_ISO8859_13 = _gdi_.FONTENCODING_ISO8859_13
1518FONTENCODING_ISO8859_14 = _gdi_.FONTENCODING_ISO8859_14
1519FONTENCODING_ISO8859_15 = _gdi_.FONTENCODING_ISO8859_15
1520FONTENCODING_ISO8859_MAX = _gdi_.FONTENCODING_ISO8859_MAX
1521FONTENCODING_KOI8 = _gdi_.FONTENCODING_KOI8
1522FONTENCODING_KOI8_U = _gdi_.FONTENCODING_KOI8_U
1523FONTENCODING_ALTERNATIVE = _gdi_.FONTENCODING_ALTERNATIVE
1524FONTENCODING_BULGARIAN = _gdi_.FONTENCODING_BULGARIAN
1525FONTENCODING_CP437 = _gdi_.FONTENCODING_CP437
1526FONTENCODING_CP850 = _gdi_.FONTENCODING_CP850
1527FONTENCODING_CP852 = _gdi_.FONTENCODING_CP852
1528FONTENCODING_CP855 = _gdi_.FONTENCODING_CP855
1529FONTENCODING_CP866 = _gdi_.FONTENCODING_CP866
1530FONTENCODING_CP874 = _gdi_.FONTENCODING_CP874
1531FONTENCODING_CP932 = _gdi_.FONTENCODING_CP932
1532FONTENCODING_CP936 = _gdi_.FONTENCODING_CP936
1533FONTENCODING_CP949 = _gdi_.FONTENCODING_CP949
1534FONTENCODING_CP950 = _gdi_.FONTENCODING_CP950
1535FONTENCODING_CP1250 = _gdi_.FONTENCODING_CP1250
1536FONTENCODING_CP1251 = _gdi_.FONTENCODING_CP1251
1537FONTENCODING_CP1252 = _gdi_.FONTENCODING_CP1252
1538FONTENCODING_CP1253 = _gdi_.FONTENCODING_CP1253
1539FONTENCODING_CP1254 = _gdi_.FONTENCODING_CP1254
1540FONTENCODING_CP1255 = _gdi_.FONTENCODING_CP1255
1541FONTENCODING_CP1256 = _gdi_.FONTENCODING_CP1256
1542FONTENCODING_CP1257 = _gdi_.FONTENCODING_CP1257
1543FONTENCODING_CP12_MAX = _gdi_.FONTENCODING_CP12_MAX
1544FONTENCODING_UTF7 = _gdi_.FONTENCODING_UTF7
1545FONTENCODING_UTF8 = _gdi_.FONTENCODING_UTF8
1546FONTENCODING_EUC_JP = _gdi_.FONTENCODING_EUC_JP
1547FONTENCODING_UTF16BE = _gdi_.FONTENCODING_UTF16BE
1548FONTENCODING_UTF16LE = _gdi_.FONTENCODING_UTF16LE
1549FONTENCODING_UTF32BE = _gdi_.FONTENCODING_UTF32BE
1550FONTENCODING_UTF32LE = _gdi_.FONTENCODING_UTF32LE
1551FONTENCODING_MACROMAN = _gdi_.FONTENCODING_MACROMAN
1552FONTENCODING_MACJAPANESE = _gdi_.FONTENCODING_MACJAPANESE
1553FONTENCODING_MACCHINESETRAD = _gdi_.FONTENCODING_MACCHINESETRAD
1554FONTENCODING_MACKOREAN = _gdi_.FONTENCODING_MACKOREAN
1555FONTENCODING_MACARABIC = _gdi_.FONTENCODING_MACARABIC
1556FONTENCODING_MACHEBREW = _gdi_.FONTENCODING_MACHEBREW
1557FONTENCODING_MACGREEK = _gdi_.FONTENCODING_MACGREEK
1558FONTENCODING_MACCYRILLIC = _gdi_.FONTENCODING_MACCYRILLIC
1559FONTENCODING_MACDEVANAGARI = _gdi_.FONTENCODING_MACDEVANAGARI
1560FONTENCODING_MACGURMUKHI = _gdi_.FONTENCODING_MACGURMUKHI
1561FONTENCODING_MACGUJARATI = _gdi_.FONTENCODING_MACGUJARATI
1562FONTENCODING_MACORIYA = _gdi_.FONTENCODING_MACORIYA
1563FONTENCODING_MACBENGALI = _gdi_.FONTENCODING_MACBENGALI
1564FONTENCODING_MACTAMIL = _gdi_.FONTENCODING_MACTAMIL
1565FONTENCODING_MACTELUGU = _gdi_.FONTENCODING_MACTELUGU
1566FONTENCODING_MACKANNADA = _gdi_.FONTENCODING_MACKANNADA
1567FONTENCODING_MACMALAJALAM = _gdi_.FONTENCODING_MACMALAJALAM
1568FONTENCODING_MACSINHALESE = _gdi_.FONTENCODING_MACSINHALESE
1569FONTENCODING_MACBURMESE = _gdi_.FONTENCODING_MACBURMESE
1570FONTENCODING_MACKHMER = _gdi_.FONTENCODING_MACKHMER
1571FONTENCODING_MACTHAI = _gdi_.FONTENCODING_MACTHAI
1572FONTENCODING_MACLAOTIAN = _gdi_.FONTENCODING_MACLAOTIAN
1573FONTENCODING_MACGEORGIAN = _gdi_.FONTENCODING_MACGEORGIAN
1574FONTENCODING_MACARMENIAN = _gdi_.FONTENCODING_MACARMENIAN
1575FONTENCODING_MACCHINESESIMP = _gdi_.FONTENCODING_MACCHINESESIMP
1576FONTENCODING_MACTIBETAN = _gdi_.FONTENCODING_MACTIBETAN
1577FONTENCODING_MACMONGOLIAN = _gdi_.FONTENCODING_MACMONGOLIAN
1578FONTENCODING_MACETHIOPIC = _gdi_.FONTENCODING_MACETHIOPIC
1579FONTENCODING_MACCENTRALEUR = _gdi_.FONTENCODING_MACCENTRALEUR
1580FONTENCODING_MACVIATNAMESE = _gdi_.FONTENCODING_MACVIATNAMESE
1581FONTENCODING_MACARABICEXT = _gdi_.FONTENCODING_MACARABICEXT
1582FONTENCODING_MACSYMBOL = _gdi_.FONTENCODING_MACSYMBOL
1583FONTENCODING_MACDINGBATS = _gdi_.FONTENCODING_MACDINGBATS
1584FONTENCODING_MACTURKISH = _gdi_.FONTENCODING_MACTURKISH
1585FONTENCODING_MACCROATIAN = _gdi_.FONTENCODING_MACCROATIAN
1586FONTENCODING_MACICELANDIC = _gdi_.FONTENCODING_MACICELANDIC
1587FONTENCODING_MACROMANIAN = _gdi_.FONTENCODING_MACROMANIAN
1588FONTENCODING_MACCELTIC = _gdi_.FONTENCODING_MACCELTIC
1589FONTENCODING_MACGAELIC = _gdi_.FONTENCODING_MACGAELIC
1590FONTENCODING_MACKEYBOARD = _gdi_.FONTENCODING_MACKEYBOARD
1591FONTENCODING_MACMIN = _gdi_.FONTENCODING_MACMIN
1592FONTENCODING_MACMAX = _gdi_.FONTENCODING_MACMAX
1593FONTENCODING_MAX = _gdi_.FONTENCODING_MAX
1594FONTENCODING_UTF16 = _gdi_.FONTENCODING_UTF16
1595FONTENCODING_UTF32 = _gdi_.FONTENCODING_UTF32
1596FONTENCODING_UNICODE = _gdi_.FONTENCODING_UNICODE
1597FONTENCODING_GB2312 = _gdi_.FONTENCODING_GB2312
1598FONTENCODING_BIG5 = _gdi_.FONTENCODING_BIG5
1599FONTENCODING_SHIFT_JIS = _gdi_.FONTENCODING_SHIFT_JIS
d14a1e28
RD
1600#---------------------------------------------------------------------------
1601
1602class NativeFontInfo(object):
093d3ff1 1603 """Proxy of C++ NativeFontInfo class"""
0085ce49
RD
1604 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1605 __repr__ = _swig_repr
1606 def __init__(self, *args, **kwargs):
a95a7133 1607 """__init__(self) -> NativeFontInfo"""
0085ce49
RD
1608 _gdi_.NativeFontInfo_swiginit(self,_gdi_.new_NativeFontInfo(*args, **kwargs))
1609 __swig_destroy__ = _gdi_.delete_NativeFontInfo
1610 __del__ = lambda self : None;
e811c8ce 1611 def Init(*args, **kwargs):
a95a7133 1612 """Init(self)"""
54f9ee45 1613 return _gdi_.NativeFontInfo_Init(*args, **kwargs)
e811c8ce
RD
1614
1615 def InitFromFont(*args, **kwargs):
a95a7133 1616 """InitFromFont(self, Font font)"""
54f9ee45 1617 return _gdi_.NativeFontInfo_InitFromFont(*args, **kwargs)
e811c8ce
RD
1618
1619 def GetPointSize(*args, **kwargs):
a95a7133 1620 """GetPointSize(self) -> int"""
54f9ee45 1621 return _gdi_.NativeFontInfo_GetPointSize(*args, **kwargs)
e811c8ce
RD
1622
1623 def GetStyle(*args, **kwargs):
a95a7133 1624 """GetStyle(self) -> int"""
54f9ee45 1625 return _gdi_.NativeFontInfo_GetStyle(*args, **kwargs)
e811c8ce
RD
1626
1627 def GetWeight(*args, **kwargs):
a95a7133 1628 """GetWeight(self) -> int"""
54f9ee45 1629 return _gdi_.NativeFontInfo_GetWeight(*args, **kwargs)
e811c8ce
RD
1630
1631 def GetUnderlined(*args, **kwargs):
a95a7133 1632 """GetUnderlined(self) -> bool"""
54f9ee45 1633 return _gdi_.NativeFontInfo_GetUnderlined(*args, **kwargs)
e811c8ce
RD
1634
1635 def GetFaceName(*args, **kwargs):
a95a7133 1636 """GetFaceName(self) -> String"""
54f9ee45 1637 return _gdi_.NativeFontInfo_GetFaceName(*args, **kwargs)
e811c8ce
RD
1638
1639 def GetFamily(*args, **kwargs):
a95a7133 1640 """GetFamily(self) -> int"""
54f9ee45 1641 return _gdi_.NativeFontInfo_GetFamily(*args, **kwargs)
e811c8ce
RD
1642
1643 def GetEncoding(*args, **kwargs):
a95a7133 1644 """GetEncoding(self) -> int"""
54f9ee45 1645 return _gdi_.NativeFontInfo_GetEncoding(*args, **kwargs)
e811c8ce
RD
1646
1647 def SetPointSize(*args, **kwargs):
a95a7133 1648 """SetPointSize(self, int pointsize)"""
54f9ee45 1649 return _gdi_.NativeFontInfo_SetPointSize(*args, **kwargs)
e811c8ce
RD
1650
1651 def SetStyle(*args, **kwargs):
a95a7133 1652 """SetStyle(self, int style)"""
54f9ee45 1653 return _gdi_.NativeFontInfo_SetStyle(*args, **kwargs)
e811c8ce
RD
1654
1655 def SetWeight(*args, **kwargs):
a95a7133 1656 """SetWeight(self, int weight)"""
54f9ee45 1657 return _gdi_.NativeFontInfo_SetWeight(*args, **kwargs)
e811c8ce
RD
1658
1659 def SetUnderlined(*args, **kwargs):
a95a7133 1660 """SetUnderlined(self, bool underlined)"""
54f9ee45 1661 return _gdi_.NativeFontInfo_SetUnderlined(*args, **kwargs)
e811c8ce
RD
1662
1663 def SetFaceName(*args, **kwargs):
704eda0c 1664 """SetFaceName(self, String facename) -> bool"""
54f9ee45 1665 return _gdi_.NativeFontInfo_SetFaceName(*args, **kwargs)
e811c8ce
RD
1666
1667 def SetFamily(*args, **kwargs):
a95a7133 1668 """SetFamily(self, int family)"""
54f9ee45 1669 return _gdi_.NativeFontInfo_SetFamily(*args, **kwargs)
e811c8ce
RD
1670
1671 def SetEncoding(*args, **kwargs):
a95a7133 1672 """SetEncoding(self, int encoding)"""
54f9ee45 1673 return _gdi_.NativeFontInfo_SetEncoding(*args, **kwargs)
e811c8ce
RD
1674
1675 def FromString(*args, **kwargs):
a95a7133 1676 """FromString(self, String s) -> bool"""
54f9ee45 1677 return _gdi_.NativeFontInfo_FromString(*args, **kwargs)
e811c8ce
RD
1678
1679 def ToString(*args, **kwargs):
a95a7133 1680 """ToString(self) -> String"""
54f9ee45 1681 return _gdi_.NativeFontInfo_ToString(*args, **kwargs)
e811c8ce
RD
1682
1683 def __str__(*args, **kwargs):
a95a7133 1684 """__str__(self) -> String"""
54f9ee45 1685 return _gdi_.NativeFontInfo___str__(*args, **kwargs)
e811c8ce
RD
1686
1687 def FromUserString(*args, **kwargs):
a95a7133 1688 """FromUserString(self, String s) -> bool"""
54f9ee45 1689 return _gdi_.NativeFontInfo_FromUserString(*args, **kwargs)
e811c8ce
RD
1690
1691 def ToUserString(*args, **kwargs):
a95a7133 1692 """ToUserString(self) -> String"""
54f9ee45 1693 return _gdi_.NativeFontInfo_ToUserString(*args, **kwargs)
e811c8ce 1694
57332a5a
RD
1695 Encoding = property(GetEncoding,SetEncoding,doc="See `GetEncoding` and `SetEncoding`")
1696 FaceName = property(GetFaceName,SetFaceName,doc="See `GetFaceName` and `SetFaceName`")
1697 Family = property(GetFamily,SetFamily,doc="See `GetFamily` and `SetFamily`")
1698 PointSize = property(GetPointSize,SetPointSize,doc="See `GetPointSize` and `SetPointSize`")
1699 Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`")
1700 Underlined = property(GetUnderlined,SetUnderlined,doc="See `GetUnderlined` and `SetUnderlined`")
1701 Weight = property(GetWeight,SetWeight,doc="See `GetWeight` and `SetWeight`")
2131d850 1702_gdi_.NativeFontInfo_swigregister(NativeFontInfo)
d14a1e28
RD
1703
1704class NativeEncodingInfo(object):
093d3ff1 1705 """Proxy of C++ NativeEncodingInfo class"""
0085ce49
RD
1706 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1707 __repr__ = _swig_repr
54f9ee45
RD
1708 facename = property(_gdi_.NativeEncodingInfo_facename_get, _gdi_.NativeEncodingInfo_facename_set)
1709 encoding = property(_gdi_.NativeEncodingInfo_encoding_get, _gdi_.NativeEncodingInfo_encoding_set)
0085ce49 1710 def __init__(self, *args, **kwargs):
a95a7133 1711 """__init__(self) -> NativeEncodingInfo"""
0085ce49
RD
1712 _gdi_.NativeEncodingInfo_swiginit(self,_gdi_.new_NativeEncodingInfo(*args, **kwargs))
1713 __swig_destroy__ = _gdi_.delete_NativeEncodingInfo
1714 __del__ = lambda self : None;
e811c8ce 1715 def FromString(*args, **kwargs):
a95a7133 1716 """FromString(self, String s) -> bool"""
54f9ee45 1717 return _gdi_.NativeEncodingInfo_FromString(*args, **kwargs)
e811c8ce
RD
1718
1719 def ToString(*args, **kwargs):
a95a7133 1720 """ToString(self) -> String"""
54f9ee45 1721 return _gdi_.NativeEncodingInfo_ToString(*args, **kwargs)
e811c8ce 1722
2131d850 1723_gdi_.NativeEncodingInfo_swigregister(NativeEncodingInfo)
70551f47
RD
1724
1725
e811c8ce 1726def GetNativeFontEncoding(*args, **kwargs):
0085ce49
RD
1727 """GetNativeFontEncoding(int encoding) -> NativeEncodingInfo"""
1728 return _gdi_.GetNativeFontEncoding(*args, **kwargs)
70551f47 1729
e811c8ce 1730def TestFontEncoding(*args, **kwargs):
0085ce49
RD
1731 """TestFontEncoding(NativeEncodingInfo info) -> bool"""
1732 return _gdi_.TestFontEncoding(*args, **kwargs)
d14a1e28
RD
1733#---------------------------------------------------------------------------
1734
1735class FontMapper(object):
093d3ff1 1736 """Proxy of C++ FontMapper class"""
0085ce49
RD
1737 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1738 __repr__ = _swig_repr
1739 def __init__(self, *args, **kwargs):
a95a7133 1740 """__init__(self) -> FontMapper"""
0085ce49
RD
1741 _gdi_.FontMapper_swiginit(self,_gdi_.new_FontMapper(*args, **kwargs))
1742 __swig_destroy__ = _gdi_.delete_FontMapper
1743 __del__ = lambda self : None;
e811c8ce 1744 def Get(*args, **kwargs):
66c033b4 1745 """Get() -> FontMapper"""
54f9ee45 1746 return _gdi_.FontMapper_Get(*args, **kwargs)
e811c8ce
RD
1747
1748 Get = staticmethod(Get)
1749 def Set(*args, **kwargs):
66c033b4 1750 """Set(FontMapper mapper) -> FontMapper"""
54f9ee45 1751 return _gdi_.FontMapper_Set(*args, **kwargs)
e811c8ce
RD
1752
1753 Set = staticmethod(Set)
1754 def CharsetToEncoding(*args, **kwargs):
a95a7133 1755 """CharsetToEncoding(self, String charset, bool interactive=True) -> int"""
54f9ee45 1756 return _gdi_.FontMapper_CharsetToEncoding(*args, **kwargs)
e811c8ce
RD
1757
1758 def GetSupportedEncodingsCount(*args, **kwargs):
66c033b4 1759 """GetSupportedEncodingsCount() -> size_t"""
54f9ee45 1760 return _gdi_.FontMapper_GetSupportedEncodingsCount(*args, **kwargs)
e811c8ce
RD
1761
1762 GetSupportedEncodingsCount = staticmethod(GetSupportedEncodingsCount)
1763 def GetEncoding(*args, **kwargs):
66c033b4 1764 """GetEncoding(size_t n) -> int"""
54f9ee45 1765 return _gdi_.FontMapper_GetEncoding(*args, **kwargs)
e811c8ce
RD
1766
1767 GetEncoding = staticmethod(GetEncoding)
1768 def GetEncodingName(*args, **kwargs):
66c033b4 1769 """GetEncodingName(int encoding) -> String"""
54f9ee45 1770 return _gdi_.FontMapper_GetEncodingName(*args, **kwargs)
e811c8ce
RD
1771
1772 GetEncodingName = staticmethod(GetEncodingName)
1773 def GetEncodingDescription(*args, **kwargs):
66c033b4 1774 """GetEncodingDescription(int encoding) -> String"""
54f9ee45 1775 return _gdi_.FontMapper_GetEncodingDescription(*args, **kwargs)
e811c8ce
RD
1776
1777 GetEncodingDescription = staticmethod(GetEncodingDescription)
b2df227b 1778 def GetEncodingFromName(*args, **kwargs):
66c033b4 1779 """GetEncodingFromName(String name) -> int"""
54f9ee45 1780 return _gdi_.FontMapper_GetEncodingFromName(*args, **kwargs)
b2df227b
RD
1781
1782 GetEncodingFromName = staticmethod(GetEncodingFromName)
e811c8ce 1783 def SetConfigPath(*args, **kwargs):
a95a7133 1784 """SetConfigPath(self, String prefix)"""
54f9ee45 1785 return _gdi_.FontMapper_SetConfigPath(*args, **kwargs)
e811c8ce
RD
1786
1787 def GetDefaultConfigPath(*args, **kwargs):
66c033b4 1788 """GetDefaultConfigPath() -> String"""
54f9ee45 1789 return _gdi_.FontMapper_GetDefaultConfigPath(*args, **kwargs)
e811c8ce
RD
1790
1791 GetDefaultConfigPath = staticmethod(GetDefaultConfigPath)
1792 def GetAltForEncoding(*args, **kwargs):
a95a7133 1793 """GetAltForEncoding(self, int encoding, String facename=EmptyString, bool interactive=True) -> PyObject"""
54f9ee45 1794 return _gdi_.FontMapper_GetAltForEncoding(*args, **kwargs)
e811c8ce
RD
1795
1796 def IsEncodingAvailable(*args, **kwargs):
a95a7133 1797 """IsEncodingAvailable(self, int encoding, String facename=EmptyString) -> bool"""
54f9ee45 1798 return _gdi_.FontMapper_IsEncodingAvailable(*args, **kwargs)
e811c8ce
RD
1799
1800 def SetDialogParent(*args, **kwargs):
a95a7133 1801 """SetDialogParent(self, Window parent)"""
54f9ee45 1802 return _gdi_.FontMapper_SetDialogParent(*args, **kwargs)
e811c8ce
RD
1803
1804 def SetDialogTitle(*args, **kwargs):
a95a7133 1805 """SetDialogTitle(self, String title)"""
54f9ee45 1806 return _gdi_.FontMapper_SetDialogTitle(*args, **kwargs)
e811c8ce 1807
97ab0f6a 1808 AltForEncoding = property(GetAltForEncoding,doc="See `GetAltForEncoding`")
2131d850 1809_gdi_.FontMapper_swigregister(FontMapper)
65191ae8 1810
0085ce49
RD
1811def FontMapper_Get(*args):
1812 """FontMapper_Get() -> FontMapper"""
1813 return _gdi_.FontMapper_Get(*args)
65191ae8 1814
e811c8ce 1815def FontMapper_Set(*args, **kwargs):
0085ce49
RD
1816 """FontMapper_Set(FontMapper mapper) -> FontMapper"""
1817 return _gdi_.FontMapper_Set(*args, **kwargs)
65191ae8 1818
0085ce49
RD
1819def FontMapper_GetSupportedEncodingsCount(*args):
1820 """FontMapper_GetSupportedEncodingsCount() -> size_t"""
1821 return _gdi_.FontMapper_GetSupportedEncodingsCount(*args)
d14a1e28 1822
e811c8ce 1823def FontMapper_GetEncoding(*args, **kwargs):
0085ce49
RD
1824 """FontMapper_GetEncoding(size_t n) -> int"""
1825 return _gdi_.FontMapper_GetEncoding(*args, **kwargs)
d14a1e28 1826
e811c8ce 1827def FontMapper_GetEncodingName(*args, **kwargs):
0085ce49
RD
1828 """FontMapper_GetEncodingName(int encoding) -> String"""
1829 return _gdi_.FontMapper_GetEncodingName(*args, **kwargs)
d14a1e28 1830
e811c8ce 1831def FontMapper_GetEncodingDescription(*args, **kwargs):
0085ce49
RD
1832 """FontMapper_GetEncodingDescription(int encoding) -> String"""
1833 return _gdi_.FontMapper_GetEncodingDescription(*args, **kwargs)
d14a1e28 1834
b2df227b 1835def FontMapper_GetEncodingFromName(*args, **kwargs):
0085ce49
RD
1836 """FontMapper_GetEncodingFromName(String name) -> int"""
1837 return _gdi_.FontMapper_GetEncodingFromName(*args, **kwargs)
b2df227b 1838
0085ce49
RD
1839def FontMapper_GetDefaultConfigPath(*args):
1840 """FontMapper_GetDefaultConfigPath() -> String"""
1841 return _gdi_.FontMapper_GetDefaultConfigPath(*args)
d14a1e28
RD
1842
1843#---------------------------------------------------------------------------
1844
1845class Font(GDIObject):
a97cefba
RD
1846 """
1847 A font is an object which determines the appearance of text. Fonts are
1848 used for drawing text to a device context, and setting the appearance
1849 of a window's text.
1850
1851 You can retrieve the current system font settings with `wx.SystemSettings`.
1852 """
0085ce49
RD
1853 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
1854 __repr__ = _swig_repr
1855 def __init__(self, *args, **kwargs):
0df68c9f 1856 """
a95a7133 1857 __init__(self, int pointSize, int family, int style, int weight, bool underline=False,
196addbf
RD
1858 String face=EmptyString,
1859 int encoding=FONTENCODING_DEFAULT) -> Font
a97cefba
RD
1860
1861 Creates a font object with the specified attributes.
1862
1863 :param pointSize: The size of the font in points.
1864
1865 :param family: Font family. A generic way of referring to fonts
1866 without specifying actual facename. It can be One of
1867 the ``wx.FONTFAMILY_xxx`` constants.
1868
1869 :param style: One of the ``wx.FONTSTYLE_xxx`` constants.
1870
1871 :param weight: Font weight, sometimes also referred to as font
1872 boldness. One of the ``wx.FONTWEIGHT_xxx`` constants.
1873
1874 :param underline: The value can be ``True`` or ``False`` and
1875 indicates whether the font will include an underline. This
1876 may not be supported on all platforms.
1877
1878 :param face: An optional string specifying the actual typeface to
1879 be used. If it is an empty string, a default typeface will be
1880 chosen based on the family.
1881
1882 :param encoding: An encoding which may be one of the
1883 ``wx.FONTENCODING_xxx`` constants. If the specified encoding isn't
1884 available, no font is created.
1885
1886 :see: `wx.FFont`, `wx.FontFromPixelSize`, `wx.FFontFromPixelSize`,
1887 `wx.FontFromNativeInfoString`, `wx.FontFromNativeInfo`
1888
0df68c9f 1889 """
db3e571a 1890 if kwargs.has_key('faceName'): kwargs['face'] = kwargs['faceName'];del kwargs['faceName']
0085ce49
RD
1891 _gdi_.Font_swiginit(self,_gdi_.new_Font(*args, **kwargs))
1892 __swig_destroy__ = _gdi_.delete_Font
1893 __del__ = lambda self : None;
e811c8ce 1894 def Ok(*args, **kwargs):
a97cefba
RD
1895 """
1896 Ok(self) -> bool
1897
1898 Returns ``True`` if this font was successfully created.
1899 """
54f9ee45 1900 return _gdi_.Font_Ok(*args, **kwargs)
e811c8ce 1901
d14a1e28 1902 def __nonzero__(self): return self.Ok()
e811c8ce 1903 def __eq__(*args, **kwargs):
a95a7133 1904 """__eq__(self, Font other) -> bool"""
54f9ee45 1905 return _gdi_.Font___eq__(*args, **kwargs)
e811c8ce
RD
1906
1907 def __ne__(*args, **kwargs):
a95a7133 1908 """__ne__(self, Font other) -> bool"""
54f9ee45 1909 return _gdi_.Font___ne__(*args, **kwargs)
e811c8ce
RD
1910
1911 def GetPointSize(*args, **kwargs):
a97cefba
RD
1912 """
1913 GetPointSize(self) -> int
1914
1915 Gets the point size.
1916 """
54f9ee45 1917 return _gdi_.Font_GetPointSize(*args, **kwargs)
e811c8ce 1918
b6294124 1919 def GetPixelSize(*args, **kwargs):
a97cefba
RD
1920 """
1921 GetPixelSize(self) -> Size
1922
1923 Returns the size in pixels if the font was constructed with a pixel
1924 size.
1925 """
b6294124
RD
1926 return _gdi_.Font_GetPixelSize(*args, **kwargs)
1927
1928 def IsUsingSizeInPixels(*args, **kwargs):
a97cefba
RD
1929 """
1930 IsUsingSizeInPixels(self) -> bool
1931
1932 Returns ``True`` if the font is using a pixelSize.
1933 """
b6294124
RD
1934 return _gdi_.Font_IsUsingSizeInPixels(*args, **kwargs)
1935
e811c8ce 1936 def GetFamily(*args, **kwargs):
a97cefba
RD
1937 """
1938 GetFamily(self) -> int
1939
1940 Gets the font family.
1941 """
54f9ee45 1942 return _gdi_.Font_GetFamily(*args, **kwargs)
e811c8ce
RD
1943
1944 def GetStyle(*args, **kwargs):
a97cefba
RD
1945 """
1946 GetStyle(self) -> int
1947
1948 Gets the font style.
1949 """
54f9ee45 1950 return _gdi_.Font_GetStyle(*args, **kwargs)
e811c8ce
RD
1951
1952 def GetWeight(*args, **kwargs):
a97cefba
RD
1953 """
1954 GetWeight(self) -> int
1955
1956 Gets the font weight.
1957 """
54f9ee45 1958 return _gdi_.Font_GetWeight(*args, **kwargs)
e811c8ce
RD
1959
1960 def GetUnderlined(*args, **kwargs):
a97cefba
RD
1961 """
1962 GetUnderlined(self) -> bool
1963
1964 Returns ``True`` if the font is underlined, ``False`` otherwise.
1965 """
54f9ee45 1966 return _gdi_.Font_GetUnderlined(*args, **kwargs)
e811c8ce
RD
1967
1968 def GetFaceName(*args, **kwargs):
a97cefba
RD
1969 """
1970 GetFaceName(self) -> String
1971
1972 Returns the typeface name associated with the font, or the empty
1973 string if there is no typeface information.
1974 """
54f9ee45 1975 return _gdi_.Font_GetFaceName(*args, **kwargs)
e811c8ce
RD
1976
1977 def GetEncoding(*args, **kwargs):
a97cefba
RD
1978 """
1979 GetEncoding(self) -> int
1980
1981 Get the font's encoding.
1982 """
54f9ee45 1983 return _gdi_.Font_GetEncoding(*args, **kwargs)
e811c8ce
RD
1984
1985 def GetNativeFontInfo(*args, **kwargs):
a97cefba
RD
1986 """
1987 GetNativeFontInfo(self) -> NativeFontInfo
1988
1989 Constructs a `wx.NativeFontInfo` object from this font.
1990 """
54f9ee45 1991 return _gdi_.Font_GetNativeFontInfo(*args, **kwargs)
e811c8ce
RD
1992
1993 def IsFixedWidth(*args, **kwargs):
a97cefba
RD
1994 """
1995 IsFixedWidth(self) -> bool
1996
1997 Returns true if the font is a fixed width (or monospaced) font, false
1998 if it is a proportional one or font is invalid.
1999 """
54f9ee45 2000 return _gdi_.Font_IsFixedWidth(*args, **kwargs)
e811c8ce
RD
2001
2002 def GetNativeFontInfoDesc(*args, **kwargs):
a97cefba
RD
2003 """
2004 GetNativeFontInfoDesc(self) -> String
2005
2006 Returns the platform-dependent string completely describing this font
2007 or an empty string if the font isn't valid.
2008 """
54f9ee45 2009 return _gdi_.Font_GetNativeFontInfoDesc(*args, **kwargs)
e811c8ce
RD
2010
2011 def GetNativeFontInfoUserDesc(*args, **kwargs):
a97cefba
RD
2012 """
2013 GetNativeFontInfoUserDesc(self) -> String
2014
2015 Returns a human readable version of `GetNativeFontInfoDesc`.
2016 """
54f9ee45 2017 return _gdi_.Font_GetNativeFontInfoUserDesc(*args, **kwargs)
e811c8ce
RD
2018
2019 def SetPointSize(*args, **kwargs):
a97cefba
RD
2020 """
2021 SetPointSize(self, int pointSize)
2022
2023 Sets the point size.
2024 """
54f9ee45 2025 return _gdi_.Font_SetPointSize(*args, **kwargs)
e811c8ce 2026
b6294124 2027 def SetPixelSize(*args, **kwargs):
a97cefba
RD
2028 """
2029 SetPixelSize(self, Size pixelSize)
2030
2031 Sets the size in pixels rather than points. If there is platform API
2032 support for this then it is used, otherwise a font with the closest
2033 size is found using a binary search.
2034 """
b6294124
RD
2035 return _gdi_.Font_SetPixelSize(*args, **kwargs)
2036
e811c8ce 2037 def SetFamily(*args, **kwargs):
a97cefba
RD
2038 """
2039 SetFamily(self, int family)
2040
2041 Sets the font family.
2042 """
54f9ee45 2043 return _gdi_.Font_SetFamily(*args, **kwargs)
e811c8ce
RD
2044
2045 def SetStyle(*args, **kwargs):
a97cefba
RD
2046 """
2047 SetStyle(self, int style)
2048
2049 Sets the font style.
2050 """
54f9ee45 2051 return _gdi_.Font_SetStyle(*args, **kwargs)
e811c8ce
RD
2052
2053 def SetWeight(*args, **kwargs):
a97cefba
RD
2054 """
2055 SetWeight(self, int weight)
2056
2057 Sets the font weight.
2058 """
54f9ee45 2059 return _gdi_.Font_SetWeight(*args, **kwargs)
e811c8ce
RD
2060
2061 def SetFaceName(*args, **kwargs):
a97cefba 2062 """
704eda0c 2063 SetFaceName(self, String faceName) -> bool
a97cefba
RD
2064
2065 Sets the facename for the font. The facename, which should be a valid
2066 font installed on the end-user's system.
2067
2068 To avoid portability problems, don't rely on a specific face, but
2069 specify the font family instead or as well. A suitable font will be
2070 found on the end-user's system. If both the family and the facename
2071 are specified, wxWidgets will first search for the specific face, and
2072 then for a font belonging to the same family.
2073 """
54f9ee45 2074 return _gdi_.Font_SetFaceName(*args, **kwargs)
e811c8ce
RD
2075
2076 def SetUnderlined(*args, **kwargs):
a97cefba
RD
2077 """
2078 SetUnderlined(self, bool underlined)
2079
2080 Sets underlining.
2081 """
54f9ee45 2082 return _gdi_.Font_SetUnderlined(*args, **kwargs)
e811c8ce
RD
2083
2084 def SetEncoding(*args, **kwargs):
a97cefba
RD
2085 """
2086 SetEncoding(self, int encoding)
2087
2088 Set the font encoding.
2089 """
54f9ee45 2090 return _gdi_.Font_SetEncoding(*args, **kwargs)
e811c8ce
RD
2091
2092 def SetNativeFontInfo(*args, **kwargs):
a97cefba
RD
2093 """
2094 SetNativeFontInfo(self, NativeFontInfo info)
2095
2096 Set the font's attributes from a `wx.NativeFontInfo` object.
2097 """
54f9ee45 2098 return _gdi_.Font_SetNativeFontInfo(*args, **kwargs)
e811c8ce
RD
2099
2100 def SetNativeFontInfoFromString(*args, **kwargs):
a97cefba 2101 """
704eda0c 2102 SetNativeFontInfoFromString(self, String info) -> bool
a97cefba
RD
2103
2104 Set the font's attributes from string representation of a
2105 `wx.NativeFontInfo` object.
2106 """
54f9ee45 2107 return _gdi_.Font_SetNativeFontInfoFromString(*args, **kwargs)
e811c8ce
RD
2108
2109 def SetNativeFontInfoUserDesc(*args, **kwargs):
a97cefba 2110 """
704eda0c 2111 SetNativeFontInfoUserDesc(self, String info) -> bool
a97cefba
RD
2112
2113 Set the font's attributes from a string formerly returned from
2114 `GetNativeFontInfoDesc`.
2115 """
54f9ee45 2116 return _gdi_.Font_SetNativeFontInfoUserDesc(*args, **kwargs)
e811c8ce
RD
2117
2118 def GetFamilyString(*args, **kwargs):
a97cefba
RD
2119 """
2120 GetFamilyString(self) -> String
2121
2122 Returns a string representation of the font family.
2123 """
54f9ee45 2124 return _gdi_.Font_GetFamilyString(*args, **kwargs)
e811c8ce
RD
2125
2126 def GetStyleString(*args, **kwargs):
a97cefba
RD
2127 """
2128 GetStyleString(self) -> String
2129
2130 Returns a string representation of the font style.
2131 """
54f9ee45 2132 return _gdi_.Font_GetStyleString(*args, **kwargs)
e811c8ce
RD
2133
2134 def GetWeightString(*args, **kwargs):
a97cefba
RD
2135 """
2136 GetWeightString(self) -> String
2137
2138 Return a string representation of the font weight.
2139 """
54f9ee45 2140 return _gdi_.Font_GetWeightString(*args, **kwargs)
e811c8ce
RD
2141
2142 def SetNoAntiAliasing(*args, **kwargs):
a95a7133 2143 """SetNoAntiAliasing(self, bool no=True)"""
54f9ee45 2144 return _gdi_.Font_SetNoAntiAliasing(*args, **kwargs)
e811c8ce
RD
2145
2146 def GetNoAntiAliasing(*args, **kwargs):
a95a7133 2147 """GetNoAntiAliasing(self) -> bool"""
54f9ee45 2148 return _gdi_.Font_GetNoAntiAliasing(*args, **kwargs)
e811c8ce
RD
2149
2150 def GetDefaultEncoding(*args, **kwargs):
a97cefba
RD
2151 """
2152 GetDefaultEncoding() -> int
2153
2154 Returns the encoding used for all fonts created with an encoding of
2155 ``wx.FONTENCODING_DEFAULT``.
2156 """
54f9ee45 2157 return _gdi_.Font_GetDefaultEncoding(*args, **kwargs)
e811c8ce
RD
2158
2159 GetDefaultEncoding = staticmethod(GetDefaultEncoding)
2160 def SetDefaultEncoding(*args, **kwargs):
a97cefba
RD
2161 """
2162 SetDefaultEncoding(int encoding)
2163
2164 Sets the default font encoding.
2165 """
54f9ee45 2166 return _gdi_.Font_SetDefaultEncoding(*args, **kwargs)
e811c8ce
RD
2167
2168 SetDefaultEncoding = staticmethod(SetDefaultEncoding)
97ab0f6a
RD
2169 Encoding = property(GetEncoding,SetEncoding,doc="See `GetEncoding` and `SetEncoding`")
2170 FaceName = property(GetFaceName,SetFaceName,doc="See `GetFaceName` and `SetFaceName`")
2171 Family = property(GetFamily,SetFamily,doc="See `GetFamily` and `SetFamily`")
2172 FamilyString = property(GetFamilyString,doc="See `GetFamilyString`")
2173 NativeFontInfo = property(GetNativeFontInfo,SetNativeFontInfo,doc="See `GetNativeFontInfo` and `SetNativeFontInfo`")
2174 NativeFontInfoDesc = property(GetNativeFontInfoDesc,doc="See `GetNativeFontInfoDesc`")
2175 NativeFontInfoUserDesc = property(GetNativeFontInfoUserDesc,SetNativeFontInfoUserDesc,doc="See `GetNativeFontInfoUserDesc` and `SetNativeFontInfoUserDesc`")
2176 NoAntiAliasing = property(GetNoAntiAliasing,SetNoAntiAliasing,doc="See `GetNoAntiAliasing` and `SetNoAntiAliasing`")
2177 PixelSize = property(GetPixelSize,SetPixelSize,doc="See `GetPixelSize` and `SetPixelSize`")
2178 PointSize = property(GetPointSize,SetPointSize,doc="See `GetPointSize` and `SetPointSize`")
2179 Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`")
2180 StyleString = property(GetStyleString,doc="See `GetStyleString`")
2181 Underlined = property(GetUnderlined,SetUnderlined,doc="See `GetUnderlined` and `SetUnderlined`")
2182 Weight = property(GetWeight,SetWeight,doc="See `GetWeight` and `SetWeight`")
2183 WeightString = property(GetWeightString,doc="See `GetWeightString`")
2131d850 2184_gdi_.Font_swigregister(Font)
5e40f9dd 2185
d14a1e28 2186def FontFromNativeInfo(*args, **kwargs):
a97cefba
RD
2187 """
2188 FontFromNativeInfo(NativeFontInfo info) -> Font
2189
2190 Construct a `wx.Font` from a `wx.NativeFontInfo` object.
2191 """
db3e571a 2192 if kwargs.has_key('faceName'): kwargs['face'] = kwargs['faceName'];del kwargs['faceName']
54f9ee45 2193 val = _gdi_.new_FontFromNativeInfo(*args, **kwargs)
d14a1e28 2194 return val
5e40f9dd 2195
d14a1e28 2196def FontFromNativeInfoString(*args, **kwargs):
a97cefba
RD
2197 """
2198 FontFromNativeInfoString(String info) -> Font
2199
2200 Construct a `wx.Font` from the string representation of a
2201 `wx.NativeFontInfo` object.
2202 """
db3e571a 2203 if kwargs.has_key('faceName'): kwargs['face'] = kwargs['faceName'];del kwargs['faceName']
54f9ee45 2204 val = _gdi_.new_FontFromNativeInfoString(*args, **kwargs)
d14a1e28 2205 return val
5e40f9dd 2206
73c8ef6a 2207def FFont(*args, **kwargs):
0df68c9f 2208 """
73c8ef6a 2209 FFont(int pointSize, int family, int flags=FONTFLAG_DEFAULT,
196addbf 2210 String face=EmptyString, int encoding=FONTENCODING_DEFAULT) -> Font
a97cefba
RD
2211
2212 A bit of a simpler way to create a `wx.Font` using flags instead of
2213 individual attribute settings. The value of flags can be a
2214 combination of the following:
2215
2216 ============================ ==
2217 wx.FONTFLAG_DEFAULT
2218 wx.FONTFLAG_ITALIC
2219 wx.FONTFLAG_SLANT
2220 wx.FONTFLAG_LIGHT
2221 wx.FONTFLAG_BOLD
2222 wx.FONTFLAG_ANTIALIASED
2223 wx.FONTFLAG_NOT_ANTIALIASED
2224 wx.FONTFLAG_UNDERLINED
2225 wx.FONTFLAG_STRIKETHROUGH
2226 ============================ ==
2227
2228 :see: `wx.Font.__init__`
0df68c9f 2229 """
db3e571a 2230 if kwargs.has_key('faceName'): kwargs['face'] = kwargs['faceName'];del kwargs['faceName']
73c8ef6a 2231 val = _gdi_.new_FFont(*args, **kwargs)
d14a1e28 2232 return val
5e40f9dd 2233
b6294124
RD
2234def FontFromPixelSize(*args, **kwargs):
2235 """
2236 FontFromPixelSize(Size pixelSize, int family, int style, int weight,
2237 bool underlined=False, String face=wxEmptyString,
2238 int encoding=FONTENCODING_DEFAULT) -> Font
a97cefba
RD
2239
2240 Creates a font using a size in pixels rather than points. If there is
2241 platform API support for this then it is used, otherwise a font with
2242 the closest size is found using a binary search.
2243
2244 :see: `wx.Font.__init__`
b6294124
RD
2245 """
2246 if kwargs.has_key('faceName'): kwargs['face'] = kwargs['faceName'];del kwargs['faceName']
2247 val = _gdi_.new_FontFromPixelSize(*args, **kwargs)
b6294124
RD
2248 return val
2249
73c8ef6a
RD
2250def FFontFromPixelSize(*args, **kwargs):
2251 """
2252 FFontFromPixelSize(Size pixelSize, int family, int flags=FONTFLAG_DEFAULT,
2253 String face=wxEmptyString, int encoding=FONTENCODING_DEFAULT) -> Font
a97cefba
RD
2254
2255 Creates a font using a size in pixels rather than points. If there is
2256 platform API support for this then it is used, otherwise a font with
2257 the closest size is found using a binary search.
2258
2259 :see: `wx.Font.__init__`, `wx.FFont`
73c8ef6a
RD
2260 """
2261 if kwargs.has_key('faceName'): kwargs['face'] = kwargs['faceName'];del kwargs['faceName']
2262 val = _gdi_.new_FFontFromPixelSize(*args, **kwargs)
73c8ef6a
RD
2263 return val
2264
0085ce49
RD
2265def Font_GetDefaultEncoding(*args):
2266 """
a97cefba
RD
2267 Font_GetDefaultEncoding() -> int
2268
2269 Returns the encoding used for all fonts created with an encoding of
2270 ``wx.FONTENCODING_DEFAULT``.
2271 """
0085ce49 2272 return _gdi_.Font_GetDefaultEncoding(*args)
70551f47 2273
e811c8ce 2274def Font_SetDefaultEncoding(*args, **kwargs):
0085ce49 2275 """
a97cefba
RD
2276 Font_SetDefaultEncoding(int encoding)
2277
2278 Sets the default font encoding.
2279 """
0085ce49 2280 return _gdi_.Font_SetDefaultEncoding(*args, **kwargs)
70551f47 2281
a97cefba 2282Font2 = wx._deprecated(FFont, "Use `wx.FFont` instead.")
d14a1e28 2283#---------------------------------------------------------------------------
70551f47 2284
d14a1e28 2285class FontEnumerator(object):
093d3ff1 2286 """Proxy of C++ FontEnumerator class"""
0085ce49
RD
2287 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
2288 __repr__ = _swig_repr
2289 def __init__(self, *args, **kwargs):
a95a7133 2290 """__init__(self) -> FontEnumerator"""
0085ce49 2291 _gdi_.FontEnumerator_swiginit(self,_gdi_.new_FontEnumerator(*args, **kwargs))
d14a1e28 2292 self._setCallbackInfo(self, FontEnumerator, 0)
e811c8ce 2293
0085ce49
RD
2294 __swig_destroy__ = _gdi_.delete_FontEnumerator
2295 __del__ = lambda self : None;
e811c8ce 2296 def _setCallbackInfo(*args, **kwargs):
a95a7133 2297 """_setCallbackInfo(self, PyObject self, PyObject _class, bool incref)"""
54f9ee45 2298 return _gdi_.FontEnumerator__setCallbackInfo(*args, **kwargs)
e811c8ce
RD
2299
2300 def EnumerateFacenames(*args, **kwargs):
a95a7133 2301 """EnumerateFacenames(self, int encoding=FONTENCODING_SYSTEM, bool fixedWidthOnly=False) -> bool"""
54f9ee45 2302 return _gdi_.FontEnumerator_EnumerateFacenames(*args, **kwargs)
e811c8ce
RD
2303
2304 def EnumerateEncodings(*args, **kwargs):
a95a7133 2305 """EnumerateEncodings(self, String facename=EmptyString) -> bool"""
54f9ee45 2306 return _gdi_.FontEnumerator_EnumerateEncodings(*args, **kwargs)
e811c8ce
RD
2307
2308 def GetEncodings(*args, **kwargs):
704eda0c 2309 """GetEncodings() -> PyObject"""
54f9ee45 2310 return _gdi_.FontEnumerator_GetEncodings(*args, **kwargs)
e811c8ce 2311
704eda0c 2312 GetEncodings = staticmethod(GetEncodings)
e811c8ce 2313 def GetFacenames(*args, **kwargs):
704eda0c 2314 """GetFacenames() -> PyObject"""
54f9ee45 2315 return _gdi_.FontEnumerator_GetFacenames(*args, **kwargs)
e811c8ce 2316
704eda0c
RD
2317 GetFacenames = staticmethod(GetFacenames)
2318 def IsValidFacename(*args, **kwargs):
2319 """
2320 IsValidFacename(String str) -> bool
2321
2322 Convenience function that returns true if the given face name exist in
2323 the user's system
2324 """
2325 return _gdi_.FontEnumerator_IsValidFacename(*args, **kwargs)
2326
2327 IsValidFacename = staticmethod(IsValidFacename)
2131d850 2328_gdi_.FontEnumerator_swigregister(FontEnumerator)
d14a1e28 2329
704eda0c
RD
2330def FontEnumerator_GetEncodings(*args):
2331 """FontEnumerator_GetEncodings() -> PyObject"""
2332 return _gdi_.FontEnumerator_GetEncodings(*args)
2333
2334def FontEnumerator_GetFacenames(*args):
2335 """FontEnumerator_GetFacenames() -> PyObject"""
2336 return _gdi_.FontEnumerator_GetFacenames(*args)
2337
2338def FontEnumerator_IsValidFacename(*args, **kwargs):
2339 """
2340 FontEnumerator_IsValidFacename(String str) -> bool
2341
2342 Convenience function that returns true if the given face name exist in
2343 the user's system
2344 """
2345 return _gdi_.FontEnumerator_IsValidFacename(*args, **kwargs)
2346
d14a1e28
RD
2347#---------------------------------------------------------------------------
2348
54f9ee45
RD
2349LANGUAGE_DEFAULT = _gdi_.LANGUAGE_DEFAULT
2350LANGUAGE_UNKNOWN = _gdi_.LANGUAGE_UNKNOWN
2351LANGUAGE_ABKHAZIAN = _gdi_.LANGUAGE_ABKHAZIAN
2352LANGUAGE_AFAR = _gdi_.LANGUAGE_AFAR
2353LANGUAGE_AFRIKAANS = _gdi_.LANGUAGE_AFRIKAANS
2354LANGUAGE_ALBANIAN = _gdi_.LANGUAGE_ALBANIAN
2355LANGUAGE_AMHARIC = _gdi_.LANGUAGE_AMHARIC
2356LANGUAGE_ARABIC = _gdi_.LANGUAGE_ARABIC
2357LANGUAGE_ARABIC_ALGERIA = _gdi_.LANGUAGE_ARABIC_ALGERIA
2358LANGUAGE_ARABIC_BAHRAIN = _gdi_.LANGUAGE_ARABIC_BAHRAIN
2359LANGUAGE_ARABIC_EGYPT = _gdi_.LANGUAGE_ARABIC_EGYPT
2360LANGUAGE_ARABIC_IRAQ = _gdi_.LANGUAGE_ARABIC_IRAQ
2361LANGUAGE_ARABIC_JORDAN = _gdi_.LANGUAGE_ARABIC_JORDAN
2362LANGUAGE_ARABIC_KUWAIT = _gdi_.LANGUAGE_ARABIC_KUWAIT
2363LANGUAGE_ARABIC_LEBANON = _gdi_.LANGUAGE_ARABIC_LEBANON
2364LANGUAGE_ARABIC_LIBYA = _gdi_.LANGUAGE_ARABIC_LIBYA
2365LANGUAGE_ARABIC_MOROCCO = _gdi_.LANGUAGE_ARABIC_MOROCCO
2366LANGUAGE_ARABIC_OMAN = _gdi_.LANGUAGE_ARABIC_OMAN
2367LANGUAGE_ARABIC_QATAR = _gdi_.LANGUAGE_ARABIC_QATAR
2368LANGUAGE_ARABIC_SAUDI_ARABIA = _gdi_.LANGUAGE_ARABIC_SAUDI_ARABIA
2369LANGUAGE_ARABIC_SUDAN = _gdi_.LANGUAGE_ARABIC_SUDAN
2370LANGUAGE_ARABIC_SYRIA = _gdi_.LANGUAGE_ARABIC_SYRIA
2371LANGUAGE_ARABIC_TUNISIA = _gdi_.LANGUAGE_ARABIC_TUNISIA
2372LANGUAGE_ARABIC_UAE = _gdi_.LANGUAGE_ARABIC_UAE
2373LANGUAGE_ARABIC_YEMEN = _gdi_.LANGUAGE_ARABIC_YEMEN
2374LANGUAGE_ARMENIAN = _gdi_.LANGUAGE_ARMENIAN
2375LANGUAGE_ASSAMESE = _gdi_.LANGUAGE_ASSAMESE
2376LANGUAGE_AYMARA = _gdi_.LANGUAGE_AYMARA
2377LANGUAGE_AZERI = _gdi_.LANGUAGE_AZERI
2378LANGUAGE_AZERI_CYRILLIC = _gdi_.LANGUAGE_AZERI_CYRILLIC
2379LANGUAGE_AZERI_LATIN = _gdi_.LANGUAGE_AZERI_LATIN
2380LANGUAGE_BASHKIR = _gdi_.LANGUAGE_BASHKIR
2381LANGUAGE_BASQUE = _gdi_.LANGUAGE_BASQUE
2382LANGUAGE_BELARUSIAN = _gdi_.LANGUAGE_BELARUSIAN
2383LANGUAGE_BENGALI = _gdi_.LANGUAGE_BENGALI
2384LANGUAGE_BHUTANI = _gdi_.LANGUAGE_BHUTANI
2385LANGUAGE_BIHARI = _gdi_.LANGUAGE_BIHARI
2386LANGUAGE_BISLAMA = _gdi_.LANGUAGE_BISLAMA
2387LANGUAGE_BRETON = _gdi_.LANGUAGE_BRETON
2388LANGUAGE_BULGARIAN = _gdi_.LANGUAGE_BULGARIAN
2389LANGUAGE_BURMESE = _gdi_.LANGUAGE_BURMESE
2390LANGUAGE_CAMBODIAN = _gdi_.LANGUAGE_CAMBODIAN
2391LANGUAGE_CATALAN = _gdi_.LANGUAGE_CATALAN
2392LANGUAGE_CHINESE = _gdi_.LANGUAGE_CHINESE
2393LANGUAGE_CHINESE_SIMPLIFIED = _gdi_.LANGUAGE_CHINESE_SIMPLIFIED
2394LANGUAGE_CHINESE_TRADITIONAL = _gdi_.LANGUAGE_CHINESE_TRADITIONAL
2395LANGUAGE_CHINESE_HONGKONG = _gdi_.LANGUAGE_CHINESE_HONGKONG
2396LANGUAGE_CHINESE_MACAU = _gdi_.LANGUAGE_CHINESE_MACAU
2397LANGUAGE_CHINESE_SINGAPORE = _gdi_.LANGUAGE_CHINESE_SINGAPORE
2398LANGUAGE_CHINESE_TAIWAN = _gdi_.LANGUAGE_CHINESE_TAIWAN
2399LANGUAGE_CORSICAN = _gdi_.LANGUAGE_CORSICAN
2400LANGUAGE_CROATIAN = _gdi_.LANGUAGE_CROATIAN
2401LANGUAGE_CZECH = _gdi_.LANGUAGE_CZECH
2402LANGUAGE_DANISH = _gdi_.LANGUAGE_DANISH
2403LANGUAGE_DUTCH = _gdi_.LANGUAGE_DUTCH
2404LANGUAGE_DUTCH_BELGIAN = _gdi_.LANGUAGE_DUTCH_BELGIAN
2405LANGUAGE_ENGLISH = _gdi_.LANGUAGE_ENGLISH
2406LANGUAGE_ENGLISH_UK = _gdi_.LANGUAGE_ENGLISH_UK
2407LANGUAGE_ENGLISH_US = _gdi_.LANGUAGE_ENGLISH_US
2408LANGUAGE_ENGLISH_AUSTRALIA = _gdi_.LANGUAGE_ENGLISH_AUSTRALIA
2409LANGUAGE_ENGLISH_BELIZE = _gdi_.LANGUAGE_ENGLISH_BELIZE
2410LANGUAGE_ENGLISH_BOTSWANA = _gdi_.LANGUAGE_ENGLISH_BOTSWANA
2411LANGUAGE_ENGLISH_CANADA = _gdi_.LANGUAGE_ENGLISH_CANADA
2412LANGUAGE_ENGLISH_CARIBBEAN = _gdi_.LANGUAGE_ENGLISH_CARIBBEAN
2413LANGUAGE_ENGLISH_DENMARK = _gdi_.LANGUAGE_ENGLISH_DENMARK
2414LANGUAGE_ENGLISH_EIRE = _gdi_.LANGUAGE_ENGLISH_EIRE
2415LANGUAGE_ENGLISH_JAMAICA = _gdi_.LANGUAGE_ENGLISH_JAMAICA
2416LANGUAGE_ENGLISH_NEW_ZEALAND = _gdi_.LANGUAGE_ENGLISH_NEW_ZEALAND
2417LANGUAGE_ENGLISH_PHILIPPINES = _gdi_.LANGUAGE_ENGLISH_PHILIPPINES
2418LANGUAGE_ENGLISH_SOUTH_AFRICA = _gdi_.LANGUAGE_ENGLISH_SOUTH_AFRICA
2419LANGUAGE_ENGLISH_TRINIDAD = _gdi_.LANGUAGE_ENGLISH_TRINIDAD
2420LANGUAGE_ENGLISH_ZIMBABWE = _gdi_.LANGUAGE_ENGLISH_ZIMBABWE
2421LANGUAGE_ESPERANTO = _gdi_.LANGUAGE_ESPERANTO
2422LANGUAGE_ESTONIAN = _gdi_.LANGUAGE_ESTONIAN
2423LANGUAGE_FAEROESE = _gdi_.LANGUAGE_FAEROESE
2424LANGUAGE_FARSI = _gdi_.LANGUAGE_FARSI
2425LANGUAGE_FIJI = _gdi_.LANGUAGE_FIJI
2426LANGUAGE_FINNISH = _gdi_.LANGUAGE_FINNISH
2427LANGUAGE_FRENCH = _gdi_.LANGUAGE_FRENCH
2428LANGUAGE_FRENCH_BELGIAN = _gdi_.LANGUAGE_FRENCH_BELGIAN
2429LANGUAGE_FRENCH_CANADIAN = _gdi_.LANGUAGE_FRENCH_CANADIAN
2430LANGUAGE_FRENCH_LUXEMBOURG = _gdi_.LANGUAGE_FRENCH_LUXEMBOURG
2431LANGUAGE_FRENCH_MONACO = _gdi_.LANGUAGE_FRENCH_MONACO
2432LANGUAGE_FRENCH_SWISS = _gdi_.LANGUAGE_FRENCH_SWISS
2433LANGUAGE_FRISIAN = _gdi_.LANGUAGE_FRISIAN
2434LANGUAGE_GALICIAN = _gdi_.LANGUAGE_GALICIAN
2435LANGUAGE_GEORGIAN = _gdi_.LANGUAGE_GEORGIAN
2436LANGUAGE_GERMAN = _gdi_.LANGUAGE_GERMAN
2437LANGUAGE_GERMAN_AUSTRIAN = _gdi_.LANGUAGE_GERMAN_AUSTRIAN
2438LANGUAGE_GERMAN_BELGIUM = _gdi_.LANGUAGE_GERMAN_BELGIUM
2439LANGUAGE_GERMAN_LIECHTENSTEIN = _gdi_.LANGUAGE_GERMAN_LIECHTENSTEIN
2440LANGUAGE_GERMAN_LUXEMBOURG = _gdi_.LANGUAGE_GERMAN_LUXEMBOURG
2441LANGUAGE_GERMAN_SWISS = _gdi_.LANGUAGE_GERMAN_SWISS
2442LANGUAGE_GREEK = _gdi_.LANGUAGE_GREEK
2443LANGUAGE_GREENLANDIC = _gdi_.LANGUAGE_GREENLANDIC
2444LANGUAGE_GUARANI = _gdi_.LANGUAGE_GUARANI
2445LANGUAGE_GUJARATI = _gdi_.LANGUAGE_GUJARATI
2446LANGUAGE_HAUSA = _gdi_.LANGUAGE_HAUSA
2447LANGUAGE_HEBREW = _gdi_.LANGUAGE_HEBREW
2448LANGUAGE_HINDI = _gdi_.LANGUAGE_HINDI
2449LANGUAGE_HUNGARIAN = _gdi_.LANGUAGE_HUNGARIAN
2450LANGUAGE_ICELANDIC = _gdi_.LANGUAGE_ICELANDIC
2451LANGUAGE_INDONESIAN = _gdi_.LANGUAGE_INDONESIAN
2452LANGUAGE_INTERLINGUA = _gdi_.LANGUAGE_INTERLINGUA
2453LANGUAGE_INTERLINGUE = _gdi_.LANGUAGE_INTERLINGUE
2454LANGUAGE_INUKTITUT = _gdi_.LANGUAGE_INUKTITUT
2455LANGUAGE_INUPIAK = _gdi_.LANGUAGE_INUPIAK
2456LANGUAGE_IRISH = _gdi_.LANGUAGE_IRISH
2457LANGUAGE_ITALIAN = _gdi_.LANGUAGE_ITALIAN
2458LANGUAGE_ITALIAN_SWISS = _gdi_.LANGUAGE_ITALIAN_SWISS
2459LANGUAGE_JAPANESE = _gdi_.LANGUAGE_JAPANESE
2460LANGUAGE_JAVANESE = _gdi_.LANGUAGE_JAVANESE
2461LANGUAGE_KANNADA = _gdi_.LANGUAGE_KANNADA
2462LANGUAGE_KASHMIRI = _gdi_.LANGUAGE_KASHMIRI
2463LANGUAGE_KASHMIRI_INDIA = _gdi_.LANGUAGE_KASHMIRI_INDIA
2464LANGUAGE_KAZAKH = _gdi_.LANGUAGE_KAZAKH
2465LANGUAGE_KERNEWEK = _gdi_.LANGUAGE_KERNEWEK
2466LANGUAGE_KINYARWANDA = _gdi_.LANGUAGE_KINYARWANDA
2467LANGUAGE_KIRGHIZ = _gdi_.LANGUAGE_KIRGHIZ
2468LANGUAGE_KIRUNDI = _gdi_.LANGUAGE_KIRUNDI
2469LANGUAGE_KONKANI = _gdi_.LANGUAGE_KONKANI
2470LANGUAGE_KOREAN = _gdi_.LANGUAGE_KOREAN
2471LANGUAGE_KURDISH = _gdi_.LANGUAGE_KURDISH
2472LANGUAGE_LAOTHIAN = _gdi_.LANGUAGE_LAOTHIAN
2473LANGUAGE_LATIN = _gdi_.LANGUAGE_LATIN
2474LANGUAGE_LATVIAN = _gdi_.LANGUAGE_LATVIAN
2475LANGUAGE_LINGALA = _gdi_.LANGUAGE_LINGALA
2476LANGUAGE_LITHUANIAN = _gdi_.LANGUAGE_LITHUANIAN
2477LANGUAGE_MACEDONIAN = _gdi_.LANGUAGE_MACEDONIAN
2478LANGUAGE_MALAGASY = _gdi_.LANGUAGE_MALAGASY
2479LANGUAGE_MALAY = _gdi_.LANGUAGE_MALAY
2480LANGUAGE_MALAYALAM = _gdi_.LANGUAGE_MALAYALAM
2481LANGUAGE_MALAY_BRUNEI_DARUSSALAM = _gdi_.LANGUAGE_MALAY_BRUNEI_DARUSSALAM
2482LANGUAGE_MALAY_MALAYSIA = _gdi_.LANGUAGE_MALAY_MALAYSIA
2483LANGUAGE_MALTESE = _gdi_.LANGUAGE_MALTESE
2484LANGUAGE_MANIPURI = _gdi_.LANGUAGE_MANIPURI
2485LANGUAGE_MAORI = _gdi_.LANGUAGE_MAORI
2486LANGUAGE_MARATHI = _gdi_.LANGUAGE_MARATHI
2487LANGUAGE_MOLDAVIAN = _gdi_.LANGUAGE_MOLDAVIAN
2488LANGUAGE_MONGOLIAN = _gdi_.LANGUAGE_MONGOLIAN
2489LANGUAGE_NAURU = _gdi_.LANGUAGE_NAURU
2490LANGUAGE_NEPALI = _gdi_.LANGUAGE_NEPALI
2491LANGUAGE_NEPALI_INDIA = _gdi_.LANGUAGE_NEPALI_INDIA
2492LANGUAGE_NORWEGIAN_BOKMAL = _gdi_.LANGUAGE_NORWEGIAN_BOKMAL
2493LANGUAGE_NORWEGIAN_NYNORSK = _gdi_.LANGUAGE_NORWEGIAN_NYNORSK
2494LANGUAGE_OCCITAN = _gdi_.LANGUAGE_OCCITAN
2495LANGUAGE_ORIYA = _gdi_.LANGUAGE_ORIYA
2496LANGUAGE_OROMO = _gdi_.LANGUAGE_OROMO
2497LANGUAGE_PASHTO = _gdi_.LANGUAGE_PASHTO
2498LANGUAGE_POLISH = _gdi_.LANGUAGE_POLISH
2499LANGUAGE_PORTUGUESE = _gdi_.LANGUAGE_PORTUGUESE
2500LANGUAGE_PORTUGUESE_BRAZILIAN = _gdi_.LANGUAGE_PORTUGUESE_BRAZILIAN
2501LANGUAGE_PUNJABI = _gdi_.LANGUAGE_PUNJABI
2502LANGUAGE_QUECHUA = _gdi_.LANGUAGE_QUECHUA
2503LANGUAGE_RHAETO_ROMANCE = _gdi_.LANGUAGE_RHAETO_ROMANCE
2504LANGUAGE_ROMANIAN = _gdi_.LANGUAGE_ROMANIAN
2505LANGUAGE_RUSSIAN = _gdi_.LANGUAGE_RUSSIAN
2506LANGUAGE_RUSSIAN_UKRAINE = _gdi_.LANGUAGE_RUSSIAN_UKRAINE
2507LANGUAGE_SAMOAN = _gdi_.LANGUAGE_SAMOAN
2508LANGUAGE_SANGHO = _gdi_.LANGUAGE_SANGHO
2509LANGUAGE_SANSKRIT = _gdi_.LANGUAGE_SANSKRIT
2510LANGUAGE_SCOTS_GAELIC = _gdi_.LANGUAGE_SCOTS_GAELIC
2511LANGUAGE_SERBIAN = _gdi_.LANGUAGE_SERBIAN
2512LANGUAGE_SERBIAN_CYRILLIC = _gdi_.LANGUAGE_SERBIAN_CYRILLIC
2513LANGUAGE_SERBIAN_LATIN = _gdi_.LANGUAGE_SERBIAN_LATIN
2514LANGUAGE_SERBO_CROATIAN = _gdi_.LANGUAGE_SERBO_CROATIAN
2515LANGUAGE_SESOTHO = _gdi_.LANGUAGE_SESOTHO
2516LANGUAGE_SETSWANA = _gdi_.LANGUAGE_SETSWANA
2517LANGUAGE_SHONA = _gdi_.LANGUAGE_SHONA
2518LANGUAGE_SINDHI = _gdi_.LANGUAGE_SINDHI
2519LANGUAGE_SINHALESE = _gdi_.LANGUAGE_SINHALESE
2520LANGUAGE_SISWATI = _gdi_.LANGUAGE_SISWATI
2521LANGUAGE_SLOVAK = _gdi_.LANGUAGE_SLOVAK
2522LANGUAGE_SLOVENIAN = _gdi_.LANGUAGE_SLOVENIAN
2523LANGUAGE_SOMALI = _gdi_.LANGUAGE_SOMALI
2524LANGUAGE_SPANISH = _gdi_.LANGUAGE_SPANISH
2525LANGUAGE_SPANISH_ARGENTINA = _gdi_.LANGUAGE_SPANISH_ARGENTINA
2526LANGUAGE_SPANISH_BOLIVIA = _gdi_.LANGUAGE_SPANISH_BOLIVIA
2527LANGUAGE_SPANISH_CHILE = _gdi_.LANGUAGE_SPANISH_CHILE
2528LANGUAGE_SPANISH_COLOMBIA = _gdi_.LANGUAGE_SPANISH_COLOMBIA
2529LANGUAGE_SPANISH_COSTA_RICA = _gdi_.LANGUAGE_SPANISH_COSTA_RICA
2530LANGUAGE_SPANISH_DOMINICAN_REPUBLIC = _gdi_.LANGUAGE_SPANISH_DOMINICAN_REPUBLIC
2531LANGUAGE_SPANISH_ECUADOR = _gdi_.LANGUAGE_SPANISH_ECUADOR
2532LANGUAGE_SPANISH_EL_SALVADOR = _gdi_.LANGUAGE_SPANISH_EL_SALVADOR
2533LANGUAGE_SPANISH_GUATEMALA = _gdi_.LANGUAGE_SPANISH_GUATEMALA
2534LANGUAGE_SPANISH_HONDURAS = _gdi_.LANGUAGE_SPANISH_HONDURAS
2535LANGUAGE_SPANISH_MEXICAN = _gdi_.LANGUAGE_SPANISH_MEXICAN
2536LANGUAGE_SPANISH_MODERN = _gdi_.LANGUAGE_SPANISH_MODERN
2537LANGUAGE_SPANISH_NICARAGUA = _gdi_.LANGUAGE_SPANISH_NICARAGUA
2538LANGUAGE_SPANISH_PANAMA = _gdi_.LANGUAGE_SPANISH_PANAMA
2539LANGUAGE_SPANISH_PARAGUAY = _gdi_.LANGUAGE_SPANISH_PARAGUAY
2540LANGUAGE_SPANISH_PERU = _gdi_.LANGUAGE_SPANISH_PERU
2541LANGUAGE_SPANISH_PUERTO_RICO = _gdi_.LANGUAGE_SPANISH_PUERTO_RICO
2542LANGUAGE_SPANISH_URUGUAY = _gdi_.LANGUAGE_SPANISH_URUGUAY
2543LANGUAGE_SPANISH_US = _gdi_.LANGUAGE_SPANISH_US
2544LANGUAGE_SPANISH_VENEZUELA = _gdi_.LANGUAGE_SPANISH_VENEZUELA
2545LANGUAGE_SUNDANESE = _gdi_.LANGUAGE_SUNDANESE
2546LANGUAGE_SWAHILI = _gdi_.LANGUAGE_SWAHILI
2547LANGUAGE_SWEDISH = _gdi_.LANGUAGE_SWEDISH
2548LANGUAGE_SWEDISH_FINLAND = _gdi_.LANGUAGE_SWEDISH_FINLAND
2549LANGUAGE_TAGALOG = _gdi_.LANGUAGE_TAGALOG
2550LANGUAGE_TAJIK = _gdi_.LANGUAGE_TAJIK
2551LANGUAGE_TAMIL = _gdi_.LANGUAGE_TAMIL
2552LANGUAGE_TATAR = _gdi_.LANGUAGE_TATAR
2553LANGUAGE_TELUGU = _gdi_.LANGUAGE_TELUGU
2554LANGUAGE_THAI = _gdi_.LANGUAGE_THAI
2555LANGUAGE_TIBETAN = _gdi_.LANGUAGE_TIBETAN
2556LANGUAGE_TIGRINYA = _gdi_.LANGUAGE_TIGRINYA
2557LANGUAGE_TONGA = _gdi_.LANGUAGE_TONGA
2558LANGUAGE_TSONGA = _gdi_.LANGUAGE_TSONGA
2559LANGUAGE_TURKISH = _gdi_.LANGUAGE_TURKISH
2560LANGUAGE_TURKMEN = _gdi_.LANGUAGE_TURKMEN
2561LANGUAGE_TWI = _gdi_.LANGUAGE_TWI
2562LANGUAGE_UIGHUR = _gdi_.LANGUAGE_UIGHUR
2563LANGUAGE_UKRAINIAN = _gdi_.LANGUAGE_UKRAINIAN
2564LANGUAGE_URDU = _gdi_.LANGUAGE_URDU
2565LANGUAGE_URDU_INDIA = _gdi_.LANGUAGE_URDU_INDIA
2566LANGUAGE_URDU_PAKISTAN = _gdi_.LANGUAGE_URDU_PAKISTAN
2567LANGUAGE_UZBEK = _gdi_.LANGUAGE_UZBEK
2568LANGUAGE_UZBEK_CYRILLIC = _gdi_.LANGUAGE_UZBEK_CYRILLIC
2569LANGUAGE_UZBEK_LATIN = _gdi_.LANGUAGE_UZBEK_LATIN
2570LANGUAGE_VIETNAMESE = _gdi_.LANGUAGE_VIETNAMESE
2571LANGUAGE_VOLAPUK = _gdi_.LANGUAGE_VOLAPUK
2572LANGUAGE_WELSH = _gdi_.LANGUAGE_WELSH
2573LANGUAGE_WOLOF = _gdi_.LANGUAGE_WOLOF
2574LANGUAGE_XHOSA = _gdi_.LANGUAGE_XHOSA
2575LANGUAGE_YIDDISH = _gdi_.LANGUAGE_YIDDISH
2576LANGUAGE_YORUBA = _gdi_.LANGUAGE_YORUBA
2577LANGUAGE_ZHUANG = _gdi_.LANGUAGE_ZHUANG
2578LANGUAGE_ZULU = _gdi_.LANGUAGE_ZULU
2579LANGUAGE_USER_DEFINED = _gdi_.LANGUAGE_USER_DEFINED
d14a1e28 2580class LanguageInfo(object):
093d3ff1 2581 """Proxy of C++ LanguageInfo class"""
0085ce49
RD
2582 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
2583 def __init__(self): raise AttributeError, "No constructor defined"
2584 __repr__ = _swig_repr
54f9ee45
RD
2585 Language = property(_gdi_.LanguageInfo_Language_get, _gdi_.LanguageInfo_Language_set)
2586 CanonicalName = property(_gdi_.LanguageInfo_CanonicalName_get, _gdi_.LanguageInfo_CanonicalName_set)
2587 Description = property(_gdi_.LanguageInfo_Description_get, _gdi_.LanguageInfo_Description_set)
2131d850 2588_gdi_.LanguageInfo_swigregister(LanguageInfo)
54f9ee45
RD
2589
2590LOCALE_CAT_NUMBER = _gdi_.LOCALE_CAT_NUMBER
2591LOCALE_CAT_DATE = _gdi_.LOCALE_CAT_DATE
2592LOCALE_CAT_MONEY = _gdi_.LOCALE_CAT_MONEY
2593LOCALE_CAT_MAX = _gdi_.LOCALE_CAT_MAX
2594LOCALE_THOUSANDS_SEP = _gdi_.LOCALE_THOUSANDS_SEP
2595LOCALE_DECIMAL_POINT = _gdi_.LOCALE_DECIMAL_POINT
2596LOCALE_LOAD_DEFAULT = _gdi_.LOCALE_LOAD_DEFAULT
2597LOCALE_CONV_ENCODING = _gdi_.LOCALE_CONV_ENCODING
d14a1e28 2598class Locale(object):
093d3ff1 2599 """Proxy of C++ Locale class"""
0085ce49
RD
2600 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
2601 __repr__ = _swig_repr
2602 def __init__(self, *args, **kwargs):
41e2b43e 2603 """__init__(self, int language=-1, int flags=wxLOCALE_LOAD_DEFAULT|wxLOCALE_CONV_ENCODING) -> Locale"""
0085ce49
RD
2604 _gdi_.Locale_swiginit(self,_gdi_.new_Locale(*args, **kwargs))
2605 __swig_destroy__ = _gdi_.delete_Locale
2606 __del__ = lambda self : None;
e811c8ce 2607 def Init1(*args, **kwargs):
0df68c9f 2608 """
a95a7133 2609 Init1(self, String szName, String szShort=EmptyString, String szLocale=EmptyString,
196addbf 2610 bool bLoadDefault=True,
0df68c9f
RD
2611 bool bConvertEncoding=False) -> bool
2612 """
54f9ee45 2613 return _gdi_.Locale_Init1(*args, **kwargs)
e811c8ce
RD
2614
2615 def Init2(*args, **kwargs):
a95a7133 2616 """Init2(self, int language=LANGUAGE_DEFAULT, int flags=wxLOCALE_LOAD_DEFAULT|wxLOCALE_CONV_ENCODING) -> bool"""
54f9ee45 2617 return _gdi_.Locale_Init2(*args, **kwargs)
e811c8ce 2618
d14a1e28
RD
2619 def Init(self, *_args, **_kwargs):
2620 if type(_args[0]) in [type(''), type(u'')]:
2621 val = self.Init1(*_args, **_kwargs)
2622 else:
2623 val = self.Init2(*_args, **_kwargs)
2624 return val
2625
e811c8ce 2626 def GetSystemLanguage(*args, **kwargs):
66c033b4 2627 """GetSystemLanguage() -> int"""
54f9ee45 2628 return _gdi_.Locale_GetSystemLanguage(*args, **kwargs)
e811c8ce
RD
2629
2630 GetSystemLanguage = staticmethod(GetSystemLanguage)
2631 def GetSystemEncoding(*args, **kwargs):
66c033b4 2632 """GetSystemEncoding() -> int"""
54f9ee45 2633 return _gdi_.Locale_GetSystemEncoding(*args, **kwargs)
e811c8ce
RD
2634
2635 GetSystemEncoding = staticmethod(GetSystemEncoding)
2636 def GetSystemEncodingName(*args, **kwargs):
66c033b4 2637 """GetSystemEncodingName() -> String"""
54f9ee45 2638 return _gdi_.Locale_GetSystemEncodingName(*args, **kwargs)
e811c8ce
RD
2639
2640 GetSystemEncodingName = staticmethod(GetSystemEncodingName)
2641 def IsOk(*args, **kwargs):
a95a7133 2642 """IsOk(self) -> bool"""
54f9ee45 2643 return _gdi_.Locale_IsOk(*args, **kwargs)
e811c8ce 2644
d14a1e28 2645 def __nonzero__(self): return self.IsOk()
e811c8ce 2646 def GetLocale(*args, **kwargs):
a95a7133 2647 """GetLocale(self) -> String"""
54f9ee45 2648 return _gdi_.Locale_GetLocale(*args, **kwargs)
e811c8ce
RD
2649
2650 def GetLanguage(*args, **kwargs):
a95a7133 2651 """GetLanguage(self) -> int"""
54f9ee45 2652 return _gdi_.Locale_GetLanguage(*args, **kwargs)
e811c8ce
RD
2653
2654 def GetSysName(*args, **kwargs):
a95a7133 2655 """GetSysName(self) -> String"""
54f9ee45 2656 return _gdi_.Locale_GetSysName(*args, **kwargs)
e811c8ce
RD
2657
2658 def GetCanonicalName(*args, **kwargs):
a95a7133 2659 """GetCanonicalName(self) -> String"""
54f9ee45 2660 return _gdi_.Locale_GetCanonicalName(*args, **kwargs)
e811c8ce
RD
2661
2662 def AddCatalogLookupPathPrefix(*args, **kwargs):
66c033b4 2663 """AddCatalogLookupPathPrefix(String prefix)"""
54f9ee45 2664 return _gdi_.Locale_AddCatalogLookupPathPrefix(*args, **kwargs)
e811c8ce
RD
2665
2666 AddCatalogLookupPathPrefix = staticmethod(AddCatalogLookupPathPrefix)
2667 def AddCatalog(*args, **kwargs):
a95a7133 2668 """AddCatalog(self, String szDomain) -> bool"""
54f9ee45 2669 return _gdi_.Locale_AddCatalog(*args, **kwargs)
e811c8ce 2670
33d6fd3b
RD
2671 def IsAvailable(*args, **kwargs):
2672 """IsAvailable(int lang) -> bool"""
2673 return _gdi_.Locale_IsAvailable(*args, **kwargs)
2674
2675 IsAvailable = staticmethod(IsAvailable)
e811c8ce 2676 def IsLoaded(*args, **kwargs):
a95a7133 2677 """IsLoaded(self, String szDomain) -> bool"""
54f9ee45 2678 return _gdi_.Locale_IsLoaded(*args, **kwargs)
e811c8ce
RD
2679
2680 def GetLanguageInfo(*args, **kwargs):
66c033b4 2681 """GetLanguageInfo(int lang) -> LanguageInfo"""
54f9ee45 2682 return _gdi_.Locale_GetLanguageInfo(*args, **kwargs)
e811c8ce
RD
2683
2684 GetLanguageInfo = staticmethod(GetLanguageInfo)
2685 def GetLanguageName(*args, **kwargs):
66c033b4 2686 """GetLanguageName(int lang) -> String"""
54f9ee45 2687 return _gdi_.Locale_GetLanguageName(*args, **kwargs)
e811c8ce
RD
2688
2689 GetLanguageName = staticmethod(GetLanguageName)
2690 def FindLanguageInfo(*args, **kwargs):
66c033b4 2691 """FindLanguageInfo(String locale) -> LanguageInfo"""
54f9ee45 2692 return _gdi_.Locale_FindLanguageInfo(*args, **kwargs)
e811c8ce
RD
2693
2694 FindLanguageInfo = staticmethod(FindLanguageInfo)
2695 def AddLanguage(*args, **kwargs):
66c033b4 2696 """AddLanguage(LanguageInfo info)"""
54f9ee45 2697 return _gdi_.Locale_AddLanguage(*args, **kwargs)
e811c8ce
RD
2698
2699 AddLanguage = staticmethod(AddLanguage)
2700 def GetString(*args, **kwargs):
a95a7133 2701 """GetString(self, String szOrigString, String szDomain=EmptyString) -> String"""
54f9ee45 2702 return _gdi_.Locale_GetString(*args, **kwargs)
e811c8ce
RD
2703
2704 def GetName(*args, **kwargs):
a95a7133 2705 """GetName(self) -> String"""
54f9ee45 2706 return _gdi_.Locale_GetName(*args, **kwargs)
e811c8ce 2707
97ab0f6a
RD
2708 CanonicalName = property(GetCanonicalName,doc="See `GetCanonicalName`")
2709 Language = property(GetLanguage,doc="See `GetLanguage`")
2710 Locale = property(GetLocale,doc="See `GetLocale`")
2711 Name = property(GetName,doc="See `GetName`")
2712 String = property(GetString,doc="See `GetString`")
2713 SysName = property(GetSysName,doc="See `GetSysName`")
2131d850 2714_gdi_.Locale_swigregister(Locale)
5e40f9dd 2715
0085ce49
RD
2716def Locale_GetSystemLanguage(*args):
2717 """Locale_GetSystemLanguage() -> int"""
2718 return _gdi_.Locale_GetSystemLanguage(*args)
5e40f9dd 2719
0085ce49
RD
2720def Locale_GetSystemEncoding(*args):
2721 """Locale_GetSystemEncoding() -> int"""
2722 return _gdi_.Locale_GetSystemEncoding(*args)
5e40f9dd 2723
0085ce49
RD
2724def Locale_GetSystemEncodingName(*args):
2725 """Locale_GetSystemEncodingName() -> String"""
2726 return _gdi_.Locale_GetSystemEncodingName(*args)
d14a1e28 2727
e811c8ce 2728def Locale_AddCatalogLookupPathPrefix(*args, **kwargs):
0085ce49
RD
2729 """Locale_AddCatalogLookupPathPrefix(String prefix)"""
2730 return _gdi_.Locale_AddCatalogLookupPathPrefix(*args, **kwargs)
d14a1e28 2731
33d6fd3b
RD
2732def Locale_IsAvailable(*args, **kwargs):
2733 """Locale_IsAvailable(int lang) -> bool"""
2734 return _gdi_.Locale_IsAvailable(*args, **kwargs)
2735
e811c8ce 2736def Locale_GetLanguageInfo(*args, **kwargs):
0085ce49
RD
2737 """Locale_GetLanguageInfo(int lang) -> LanguageInfo"""
2738 return _gdi_.Locale_GetLanguageInfo(*args, **kwargs)
d14a1e28 2739
e811c8ce 2740def Locale_GetLanguageName(*args, **kwargs):
0085ce49
RD
2741 """Locale_GetLanguageName(int lang) -> String"""
2742 return _gdi_.Locale_GetLanguageName(*args, **kwargs)
d14a1e28 2743
e811c8ce 2744def Locale_FindLanguageInfo(*args, **kwargs):
0085ce49
RD
2745 """Locale_FindLanguageInfo(String locale) -> LanguageInfo"""
2746 return _gdi_.Locale_FindLanguageInfo(*args, **kwargs)
d14a1e28 2747
e811c8ce 2748def Locale_AddLanguage(*args, **kwargs):
0085ce49
RD
2749 """Locale_AddLanguage(LanguageInfo info)"""
2750 return _gdi_.Locale_AddLanguage(*args, **kwargs)
d14a1e28 2751
fc46b7f3
RD
2752class PyLocale(Locale):
2753 """Proxy of C++ PyLocale class"""
2754 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
2755 __repr__ = _swig_repr
2756 def __init__(self, *args, **kwargs):
2757 """__init__(self, int language=-1, int flags=wxLOCALE_LOAD_DEFAULT|wxLOCALE_CONV_ENCODING) -> PyLocale"""
2758 _gdi_.PyLocale_swiginit(self,_gdi_.new_PyLocale(*args, **kwargs))
2759 self._setCallbackInfo(self, PyLocale)
2760
2761 __swig_destroy__ = _gdi_.delete_PyLocale
2762 __del__ = lambda self : None;
2763 def _setCallbackInfo(*args, **kwargs):
2764 """_setCallbackInfo(self, PyObject self, PyObject _class)"""
2765 return _gdi_.PyLocale__setCallbackInfo(*args, **kwargs)
2766
2767 def GetSingularString(*args, **kwargs):
2768 """GetSingularString(self, wxChar szOrigString, wxChar szDomain=None) -> wxChar"""
2769 return _gdi_.PyLocale_GetSingularString(*args, **kwargs)
2770
2771 def GetPluralString(*args, **kwargs):
2772 """
2773 GetPluralString(self, wxChar szOrigString, wxChar szOrigString2, size_t n,
2774 wxChar szDomain=None) -> wxChar
2775 """
2776 return _gdi_.PyLocale_GetPluralString(*args, **kwargs)
2777
2778_gdi_.PyLocale_swigregister(PyLocale)
2779
d14a1e28 2780
0085ce49
RD
2781def GetLocale(*args):
2782 """GetLocale() -> Locale"""
2783 return _gdi_.GetLocale(*args)
d14a1e28
RD
2784#---------------------------------------------------------------------------
2785
54f9ee45
RD
2786CONVERT_STRICT = _gdi_.CONVERT_STRICT
2787CONVERT_SUBSTITUTE = _gdi_.CONVERT_SUBSTITUTE
2788PLATFORM_CURRENT = _gdi_.PLATFORM_CURRENT
2789PLATFORM_UNIX = _gdi_.PLATFORM_UNIX
2790PLATFORM_WINDOWS = _gdi_.PLATFORM_WINDOWS
2791PLATFORM_OS2 = _gdi_.PLATFORM_OS2
2792PLATFORM_MAC = _gdi_.PLATFORM_MAC
2793class EncodingConverter(_core.Object):
093d3ff1 2794 """Proxy of C++ EncodingConverter class"""
0085ce49
RD
2795 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
2796 __repr__ = _swig_repr
2797 def __init__(self, *args, **kwargs):
a95a7133 2798 """__init__(self) -> EncodingConverter"""
0085ce49
RD
2799 _gdi_.EncodingConverter_swiginit(self,_gdi_.new_EncodingConverter(*args, **kwargs))
2800 __swig_destroy__ = _gdi_.delete_EncodingConverter
2801 __del__ = lambda self : None;
e811c8ce 2802 def Init(*args, **kwargs):
a95a7133 2803 """Init(self, int input_enc, int output_enc, int method=CONVERT_STRICT) -> bool"""
54f9ee45 2804 return _gdi_.EncodingConverter_Init(*args, **kwargs)
e811c8ce
RD
2805
2806 def Convert(*args, **kwargs):
a95a7133 2807 """Convert(self, String input) -> String"""
54f9ee45 2808 return _gdi_.EncodingConverter_Convert(*args, **kwargs)
e811c8ce
RD
2809
2810 def GetPlatformEquivalents(*args, **kwargs):
66c033b4 2811 """GetPlatformEquivalents(int enc, int platform=PLATFORM_CURRENT) -> wxFontEncodingArray"""
54f9ee45 2812 return _gdi_.EncodingConverter_GetPlatformEquivalents(*args, **kwargs)
e811c8ce
RD
2813
2814 GetPlatformEquivalents = staticmethod(GetPlatformEquivalents)
2815 def GetAllEquivalents(*args, **kwargs):
66c033b4 2816 """GetAllEquivalents(int enc) -> wxFontEncodingArray"""
54f9ee45 2817 return _gdi_.EncodingConverter_GetAllEquivalents(*args, **kwargs)
e811c8ce
RD
2818
2819 GetAllEquivalents = staticmethod(GetAllEquivalents)
2820 def CanConvert(*args, **kwargs):
66c033b4 2821 """CanConvert(int encIn, int encOut) -> bool"""
54f9ee45 2822 return _gdi_.EncodingConverter_CanConvert(*args, **kwargs)
e811c8ce
RD
2823
2824 CanConvert = staticmethod(CanConvert)
d14a1e28 2825 def __nonzero__(self): return self.IsOk()
2131d850 2826_gdi_.EncodingConverter_swigregister(EncodingConverter)
d14a1e28 2827
e811c8ce 2828def GetTranslation(*args):
0085ce49 2829 """
3adfb63b 2830 GetTranslation(String str) -> String
fc46b7f3 2831 GetTranslation(String str, String domain) -> String
3adfb63b 2832 GetTranslation(String str, String strPlural, size_t n) -> String
fc46b7f3 2833 GetTranslation(String str, String strPlural, size_t n, String domain) -> String
0df68c9f 2834 """
0085ce49 2835 return _gdi_.GetTranslation(*args)
d14a1e28 2836
e811c8ce 2837def EncodingConverter_GetPlatformEquivalents(*args, **kwargs):
0085ce49
RD
2838 """EncodingConverter_GetPlatformEquivalents(int enc, int platform=PLATFORM_CURRENT) -> wxFontEncodingArray"""
2839 return _gdi_.EncodingConverter_GetPlatformEquivalents(*args, **kwargs)
d14a1e28 2840
e811c8ce 2841def EncodingConverter_GetAllEquivalents(*args, **kwargs):
0085ce49
RD
2842 """EncodingConverter_GetAllEquivalents(int enc) -> wxFontEncodingArray"""
2843 return _gdi_.EncodingConverter_GetAllEquivalents(*args, **kwargs)
d14a1e28 2844
e811c8ce 2845def EncodingConverter_CanConvert(*args, **kwargs):
0085ce49
RD
2846 """EncodingConverter_CanConvert(int encIn, int encOut) -> bool"""
2847 return _gdi_.EncodingConverter_CanConvert(*args, **kwargs)
d14a1e28
RD
2848
2849#----------------------------------------------------------------------------
89c876de 2850# On MSW add the directory where the wxWidgets catalogs were installed
d14a1e28
RD
2851# to the default catalog path.
2852if wx.Platform == "__WXMSW__":
2853 import os
72ef6efb 2854 _localedir = os.path.join(os.path.split(__file__)[0], "locale")
8fb0e70a 2855 Locale.AddCatalogLookupPathPrefix(_localedir)
d14a1e28
RD
2856 del os
2857
2858#----------------------------------------------------------------------------
2859
2860#---------------------------------------------------------------------------
2861
54f9ee45 2862class DC(_core.Object):
f5b96ee1
RD
2863 """
2864 A wx.DC is a device context onto which graphics and text can be
2865 drawn. It is intended to represent a number of output devices in a
2866 generic way, so a window can have a device context associated with it,
2867 and a printer also has a device context. In this way, the same piece
2868 of code may write to a number of different devices, if the device
2869 context is used as a parameter.
2870
2871 Derived types of wxDC have documentation for specific features only,
2872 so refer to this section for most device context information.
2873
2874 The wx.DC class is abstract and can not be instantiated, you must use
2875 one of the derived classes instead. Which one will depend on the
2876 situation in which it is used.
2877 """
0085ce49
RD
2878 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
2879 def __init__(self): raise AttributeError, "No constructor defined"
2880 __repr__ = _swig_repr
2881 __swig_destroy__ = _gdi_.delete_DC
2882 __del__ = lambda self : None;
c26d9ab4
RD
2883 # These have been deprecated in wxWidgets. Since they never
2884 # really did anything to begin with, just make them be NOPs.
2885 def BeginDrawing(self): pass
2886 def EndDrawing(self): pass
e811c8ce 2887
e811c8ce 2888 def FloodFill(*args, **kwargs):
f5b96ee1
RD
2889 """
2890 FloodFill(self, int x, int y, Colour col, int style=FLOOD_SURFACE) -> bool
2891
2892 Flood fills the device context starting from the given point, using
2893 the current brush colour, and using a style:
2894
2895 - **wxFLOOD_SURFACE**: the flooding occurs until a colour other than
2896 the given colour is encountered.
2897
2898 - **wxFLOOD_BORDER**: the area to be flooded is bounded by the given
2899 colour.
2900
2901 Returns False if the operation failed.
2902
2903 Note: The present implementation for non-Windows platforms may fail to
2904 find colour borders if the pixels do not match the colour
2905 exactly. However the function will still return true.
2906 """
54f9ee45 2907 return _gdi_.DC_FloodFill(*args, **kwargs)
e811c8ce 2908
03e37cd5 2909 def FloodFillPoint(*args, **kwargs):
f5b96ee1
RD
2910 """
2911 FloodFillPoint(self, Point pt, Colour col, int style=FLOOD_SURFACE) -> bool
2912
2913 Flood fills the device context starting from the given point, using
2914 the current brush colour, and using a style:
2915
2916 - **wxFLOOD_SURFACE**: the flooding occurs until a colour other than
2917 the given colour is encountered.
2918
2919 - **wxFLOOD_BORDER**: the area to be flooded is bounded by the given
2920 colour.
2921
2922 Returns False if the operation failed.
2923
2924 Note: The present implementation for non-Windows platforms may fail to
2925 find colour borders if the pixels do not match the colour
2926 exactly. However the function will still return true.
2927 """
03e37cd5 2928 return _gdi_.DC_FloodFillPoint(*args, **kwargs)
e811c8ce 2929
b1fcee84
RD
2930 def GradientFillConcentric(*args, **kwargs):
2931 """
2932 GradientFillConcentric(self, Rect rect, Colour initialColour, Colour destColour,
2933 Point circleCenter)
2934
2935 Fill the area specified by rect with a radial gradient, starting from
2936 initialColour in the center of the circle and fading to destColour on
2937 the outside of the circle. The circleCenter argument is the relative
2938 coordinants of the center of the circle in the specified rect.
2939
2940 Note: Currently this function is very slow, don't use it for real-time
2941 drawing.
2942 """
2943 return _gdi_.DC_GradientFillConcentric(*args, **kwargs)
2944
2945 def GradientFillLinear(*args, **kwargs):
2946 """
2947 GradientFillLinear(self, Rect rect, Colour initialColour, Colour destColour,
2948 int nDirection=EAST)
2949
2950 Fill the area specified by rect with a linear gradient, starting from
2951 initialColour and eventually fading to destColour. The nDirection
2952 parameter specifies the direction of the colour change, default is to
2953 use initialColour on the left part of the rectangle and destColour on
2954 the right side.
2955 """
2956 return _gdi_.DC_GradientFillLinear(*args, **kwargs)
2957
e811c8ce 2958 def GetPixel(*args, **kwargs):
f5b96ee1
RD
2959 """
2960 GetPixel(self, int x, int y) -> Colour
2961
2962 Gets the colour at the specified location on the DC.
2963 """
54f9ee45 2964 return _gdi_.DC_GetPixel(*args, **kwargs)
e811c8ce 2965
03e37cd5
RD
2966 def GetPixelPoint(*args, **kwargs):
2967 """GetPixelPoint(self, Point pt) -> Colour"""
2968 return _gdi_.DC_GetPixelPoint(*args, **kwargs)
e811c8ce
RD
2969
2970 def DrawLine(*args, **kwargs):
f5b96ee1
RD
2971 """
2972 DrawLine(self, int x1, int y1, int x2, int y2)
2973
2974 Draws a line from the first point to the second. The current pen is
2975 used for drawing the line. Note that the second point is *not* part of
2976 the line and is not drawn by this function (this is consistent with
2977 the behaviour of many other toolkits).
2978 """
54f9ee45 2979 return _gdi_.DC_DrawLine(*args, **kwargs)
e811c8ce 2980
03e37cd5 2981 def DrawLinePoint(*args, **kwargs):
f5b96ee1
RD
2982 """
2983 DrawLinePoint(self, Point pt1, Point pt2)
2984
2985 Draws a line from the first point to the second. The current pen is
2986 used for drawing the line. Note that the second point is *not* part of
2987 the line and is not drawn by this function (this is consistent with
2988 the behaviour of many other toolkits).
2989 """
03e37cd5 2990 return _gdi_.DC_DrawLinePoint(*args, **kwargs)
e811c8ce
RD
2991
2992 def CrossHair(*args, **kwargs):
f5b96ee1
RD
2993 """
2994 CrossHair(self, int x, int y)
2995
2996 Displays a cross hair using the current pen. This is a vertical and
2997 horizontal line the height and width of the window, centred on the
2998 given point.
2999 """
54f9ee45 3000 return _gdi_.DC_CrossHair(*args, **kwargs)
e811c8ce 3001
03e37cd5 3002 def CrossHairPoint(*args, **kwargs):
f5b96ee1
RD
3003 """
3004 CrossHairPoint(self, Point pt)
3005
3006 Displays a cross hair using the current pen. This is a vertical and
3007 horizontal line the height and width of the window, centred on the
3008 given point.
3009 """
03e37cd5 3010 return _gdi_.DC_CrossHairPoint(*args, **kwargs)
e811c8ce
RD
3011
3012 def DrawArc(*args, **kwargs):
f5b96ee1
RD
3013 """
3014 DrawArc(self, int x1, int y1, int x2, int y2, int xc, int yc)
3015
3016 Draws an arc of a circle, centred on the *center* point (xc, yc), from
3017 the first point to the second. The current pen is used for the outline
3018 and the current brush for filling the shape.
3019
3020 The arc is drawn in an anticlockwise direction from the start point to
3021 the end point.
3022 """
54f9ee45 3023 return _gdi_.DC_DrawArc(*args, **kwargs)
e811c8ce 3024
03e37cd5 3025 def DrawArcPoint(*args, **kwargs):
f5b96ee1
RD
3026 """
3027 DrawArcPoint(self, Point pt1, Point pt2, Point center)
3028
3029 Draws an arc of a circle, centred on the *center* point (xc, yc), from
3030 the first point to the second. The current pen is used for the outline
3031 and the current brush for filling the shape.
3032
3033 The arc is drawn in an anticlockwise direction from the start point to
3034 the end point.
3035 """
03e37cd5 3036 return _gdi_.DC_DrawArcPoint(*args, **kwargs)
e811c8ce
RD
3037
3038 def DrawCheckMark(*args, **kwargs):
f5b96ee1
RD
3039 """
3040 DrawCheckMark(self, int x, int y, int width, int height)
3041
3042 Draws a check mark inside the given rectangle.
3043 """
54f9ee45 3044 return _gdi_.DC_DrawCheckMark(*args, **kwargs)
e811c8ce 3045
03e37cd5 3046 def DrawCheckMarkRect(*args, **kwargs):
f5b96ee1
RD
3047 """
3048 DrawCheckMarkRect(self, Rect rect)
3049
3050 Draws a check mark inside the given rectangle.
3051 """
03e37cd5 3052 return _gdi_.DC_DrawCheckMarkRect(*args, **kwargs)
e811c8ce
RD
3053
3054 def DrawEllipticArc(*args, **kwargs):
f5b96ee1
RD
3055 """
3056 DrawEllipticArc(self, int x, int y, int w, int h, double start, double end)
3057
3058 Draws an arc of an ellipse, with the given rectangle defining the
3059 bounds of the ellipse. The current pen is used for drawing the arc and
3060 the current brush is used for drawing the pie.
3061
3062 The *start* and *end* parameters specify the start and end of the arc
3063 relative to the three-o'clock position from the center of the
3064 rectangle. Angles are specified in degrees (360 is a complete
3065 circle). Positive values mean counter-clockwise motion. If start is
3066 equal to end, a complete ellipse will be drawn.
3067 """
54f9ee45 3068 return _gdi_.DC_DrawEllipticArc(*args, **kwargs)
e811c8ce 3069
03e37cd5 3070 def DrawEllipticArcPointSize(*args, **kwargs):
f5b96ee1
RD
3071 """
3072 DrawEllipticArcPointSize(self, Point pt, Size sz, double start, double end)
3073
3074 Draws an arc of an ellipse, with the given rectangle defining the
3075 bounds of the ellipse. The current pen is used for drawing the arc and
3076 the current brush is used for drawing the pie.
3077
3078 The *start* and *end* parameters specify the start and end of the arc
3079 relative to the three-o'clock position from the center of the
3080 rectangle. Angles are specified in degrees (360 is a complete
3081 circle). Positive values mean counter-clockwise motion. If start is
3082 equal to end, a complete ellipse will be drawn.
3083 """
03e37cd5 3084 return _gdi_.DC_DrawEllipticArcPointSize(*args, **kwargs)
e811c8ce
RD
3085
3086 def DrawPoint(*args, **kwargs):
f5b96ee1
RD
3087 """
3088 DrawPoint(self, int x, int y)
3089
3090 Draws a point using the current pen.
3091 """
54f9ee45 3092 return _gdi_.DC_DrawPoint(*args, **kwargs)
e811c8ce 3093
03e37cd5 3094 def DrawPointPoint(*args, **kwargs):
f5b96ee1
RD
3095 """
3096 DrawPointPoint(self, Point pt)
3097
3098 Draws a point using the current pen.
3099 """
03e37cd5 3100 return _gdi_.DC_DrawPointPoint(*args, **kwargs)
e811c8ce
RD
3101
3102 def DrawRectangle(*args, **kwargs):
f5b96ee1
RD
3103 """
3104 DrawRectangle(self, int x, int y, int width, int height)
3105
3106 Draws a rectangle with the given top left corner, and with the given
3107 size. The current pen is used for the outline and the current brush
3108 for filling the shape.
3109 """
54f9ee45 3110 return _gdi_.DC_DrawRectangle(*args, **kwargs)
e811c8ce
RD
3111
3112 def DrawRectangleRect(*args, **kwargs):
f5b96ee1
RD
3113 """
3114 DrawRectangleRect(self, Rect rect)
3115
3116 Draws a rectangle with the given top left corner, and with the given
3117 size. The current pen is used for the outline and the current brush
3118 for filling the shape.
3119 """
54f9ee45 3120 return _gdi_.DC_DrawRectangleRect(*args, **kwargs)
e811c8ce 3121
03e37cd5 3122 def DrawRectanglePointSize(*args, **kwargs):
f5b96ee1
RD
3123 """
3124 DrawRectanglePointSize(self, Point pt, Size sz)
3125
3126 Draws a rectangle with the given top left corner, and with the given
3127 size. The current pen is used for the outline and the current brush
3128 for filling the shape.
3129 """
03e37cd5 3130 return _gdi_.DC_DrawRectanglePointSize(*args, **kwargs)
e811c8ce
RD
3131
3132 def DrawRoundedRectangle(*args, **kwargs):
f5b96ee1
RD
3133 """
3134 DrawRoundedRectangle(self, int x, int y, int width, int height, double radius)
3135
3136 Draws a rectangle with the given top left corner, and with the given
3137 size. The corners are quarter-circles using the given radius. The
3138 current pen is used for the outline and the current brush for filling
3139 the shape.
3140
3141 If radius is positive, the value is assumed to be the radius of the
3142 rounded corner. If radius is negative, the absolute value is assumed
3143 to be the proportion of the smallest dimension of the rectangle. This
3144 means that the corner can be a sensible size relative to the size of
3145 the rectangle, and also avoids the strange effects X produces when the
3146 corners are too big for the rectangle.
3147 """
54f9ee45 3148 return _gdi_.DC_DrawRoundedRectangle(*args, **kwargs)
e811c8ce
RD
3149
3150 def DrawRoundedRectangleRect(*args, **kwargs):
f5b96ee1
RD
3151 """
3152 DrawRoundedRectangleRect(self, Rect r, double radius)
3153
3154 Draws a rectangle with the given top left corner, and with the given
3155 size. The corners are quarter-circles using the given radius. The
3156 current pen is used for the outline and the current brush for filling
3157 the shape.
3158
3159 If radius is positive, the value is assumed to be the radius of the
3160 rounded corner. If radius is negative, the absolute value is assumed
3161 to be the proportion of the smallest dimension of the rectangle. This
3162 means that the corner can be a sensible size relative to the size of
3163 the rectangle, and also avoids the strange effects X produces when the
3164 corners are too big for the rectangle.
3165 """
54f9ee45 3166 return _gdi_.DC_DrawRoundedRectangleRect(*args, **kwargs)
e811c8ce 3167
03e37cd5 3168 def DrawRoundedRectanglePointSize(*args, **kwargs):
f5b96ee1
RD
3169 """
3170 DrawRoundedRectanglePointSize(self, Point pt, Size sz, double radius)
3171
3172 Draws a rectangle with the given top left corner, and with the given
3173 size. The corners are quarter-circles using the given radius. The
3174 current pen is used for the outline and the current brush for filling
3175 the shape.
3176
3177 If radius is positive, the value is assumed to be the radius of the
3178 rounded corner. If radius is negative, the absolute value is assumed
3179 to be the proportion of the smallest dimension of the rectangle. This
3180 means that the corner can be a sensible size relative to the size of
3181 the rectangle, and also avoids the strange effects X produces when the
3182 corners are too big for the rectangle.
3183 """
03e37cd5 3184 return _gdi_.DC_DrawRoundedRectanglePointSize(*args, **kwargs)
e811c8ce
RD
3185
3186 def DrawCircle(*args, **kwargs):
f5b96ee1
RD
3187 """
3188 DrawCircle(self, int x, int y, int radius)
3189
3190 Draws a circle with the given center point and radius. The current
3191 pen is used for the outline and the current brush for filling the
3192 shape.
3193 """
54f9ee45 3194 return _gdi_.DC_DrawCircle(*args, **kwargs)
e811c8ce 3195
03e37cd5 3196 def DrawCirclePoint(*args, **kwargs):
f5b96ee1
RD
3197 """
3198 DrawCirclePoint(self, Point pt, int radius)
3199
3200 Draws a circle with the given center point and radius. The current
3201 pen is used for the outline and the current brush for filling the
3202 shape.
3203 """
03e37cd5 3204 return _gdi_.DC_DrawCirclePoint(*args, **kwargs)
e811c8ce
RD
3205
3206 def DrawEllipse(*args, **kwargs):
f5b96ee1
RD
3207 """
3208 DrawEllipse(self, int x, int y, int width, int height)
3209
3210 Draws an ellipse contained in the specified rectangle. The current pen
3211 is used for the outline and the current brush for filling the shape.
3212 """
54f9ee45 3213 return _gdi_.DC_DrawEllipse(*args, **kwargs)
e811c8ce
RD
3214
3215 def DrawEllipseRect(*args, **kwargs):
f5b96ee1
RD
3216 """
3217 DrawEllipseRect(self, Rect rect)
3218
3219 Draws an ellipse contained in the specified rectangle. The current pen
3220 is used for the outline and the current brush for filling the shape.
3221 """
54f9ee45 3222 return _gdi_.DC_DrawEllipseRect(*args, **kwargs)
e811c8ce 3223
03e37cd5 3224 def DrawEllipsePointSize(*args, **kwargs):
f5b96ee1
RD
3225 """
3226 DrawEllipsePointSize(self, Point pt, Size sz)
3227
3228 Draws an ellipse contained in the specified rectangle. The current pen
3229 is used for the outline and the current brush for filling the shape.
3230 """
03e37cd5 3231 return _gdi_.DC_DrawEllipsePointSize(*args, **kwargs)
e811c8ce
RD
3232
3233 def DrawIcon(*args, **kwargs):
f5b96ee1
RD
3234 """
3235 DrawIcon(self, Icon icon, int x, int y)
3236
3237 Draw an icon on the display (does nothing if the device context is
3238 PostScript). This can be the simplest way of drawing bitmaps on a
3239 window.
3240 """
54f9ee45 3241 return _gdi_.DC_DrawIcon(*args, **kwargs)
e811c8ce 3242
03e37cd5 3243 def DrawIconPoint(*args, **kwargs):
f5b96ee1
RD
3244 """
3245 DrawIconPoint(self, Icon icon, Point pt)
3246
3247 Draw an icon on the display (does nothing if the device context is
3248 PostScript). This can be the simplest way of drawing bitmaps on a
3249 window.
3250 """
03e37cd5 3251 return _gdi_.DC_DrawIconPoint(*args, **kwargs)
e811c8ce
RD
3252
3253 def DrawBitmap(*args, **kwargs):
f5b96ee1
RD
3254 """
3255 DrawBitmap(self, Bitmap bmp, int x, int y, bool useMask=False)
3256
3257 Draw a bitmap on the device context at the specified point. If
3258 *transparent* is true and the bitmap has a transparency mask, (or
3259 alpha channel on the platforms that support it) then the bitmap will
3260 be drawn transparently.
3261 """
54f9ee45 3262 return _gdi_.DC_DrawBitmap(*args, **kwargs)
e811c8ce 3263
03e37cd5 3264 def DrawBitmapPoint(*args, **kwargs):
f5b96ee1
RD
3265 """
3266 DrawBitmapPoint(self, Bitmap bmp, Point pt, bool useMask=False)
3267
3268 Draw a bitmap on the device context at the specified point. If
3269 *transparent* is true and the bitmap has a transparency mask, (or
3270 alpha channel on the platforms that support it) then the bitmap will
3271 be drawn transparently.
3272 """
03e37cd5 3273 return _gdi_.DC_DrawBitmapPoint(*args, **kwargs)
e811c8ce
RD
3274
3275 def DrawText(*args, **kwargs):
f5b96ee1
RD
3276 """
3277 DrawText(self, String text, int x, int y)
3278
3279 Draws a text string at the specified point, using the current text
3280 font, and the current text foreground and background colours.
3281
3282 The coordinates refer to the top-left corner of the rectangle bounding
3283 the string. See `GetTextExtent` for how to get the dimensions of a
3284 text string, which can be used to position the text more precisely.
3285
3286 **NOTE**: under wxGTK the current logical function is used by this
3287 function but it is ignored by wxMSW. Thus, you should avoid using
3288 logical functions with this function in portable programs.
3289 """
54f9ee45 3290 return _gdi_.DC_DrawText(*args, **kwargs)
e811c8ce 3291
03e37cd5 3292 def DrawTextPoint(*args, **kwargs):
f5b96ee1
RD
3293 """
3294 DrawTextPoint(self, String text, Point pt)
3295
3296 Draws a text string at the specified point, using the current text
3297 font, and the current text foreground and background colours.
3298
3299 The coordinates refer to the top-left corner of the rectangle bounding
3300 the string. See `GetTextExtent` for how to get the dimensions of a
3301 text string, which can be used to position the text more precisely.
3302
3303 **NOTE**: under wxGTK the current logical function is used by this
3304 function but it is ignored by wxMSW. Thus, you should avoid using
3305 logical functions with this function in portable programs.
3306 """
03e37cd5 3307 return _gdi_.DC_DrawTextPoint(*args, **kwargs)
e811c8ce
RD
3308
3309 def DrawRotatedText(*args, **kwargs):
f5b96ee1
RD
3310 """
3311 DrawRotatedText(self, String text, int x, int y, double angle)
3312
3313 Draws the text rotated by *angle* degrees, if supported by the platform.
3314
3315 **NOTE**: Under Win9x only TrueType fonts can be drawn by this
3316 function. In particular, a font different from ``wx.NORMAL_FONT``
3317 should be used as the it is not normally a TrueType
3318 font. ``wx.SWISS_FONT`` is an example of a font which is.
3319 """
54f9ee45 3320 return _gdi_.DC_DrawRotatedText(*args, **kwargs)
e811c8ce 3321
03e37cd5 3322 def DrawRotatedTextPoint(*args, **kwargs):
f5b96ee1
RD
3323 """
3324 DrawRotatedTextPoint(self, String text, Point pt, double angle)
3325
3326 Draws the text rotated by *angle* degrees, if supported by the platform.
3327
3328 **NOTE**: Under Win9x only TrueType fonts can be drawn by this
3329 function. In particular, a font different from ``wx.NORMAL_FONT``
3330 should be used as the it is not normally a TrueType
3331 font. ``wx.SWISS_FONT`` is an example of a font which is.
3332 """
03e37cd5
RD
3333 return _gdi_.DC_DrawRotatedTextPoint(*args, **kwargs)
3334
3335 def Blit(*args, **kwargs):
0df68c9f 3336 """
03e37cd5 3337 Blit(self, int xdest, int ydest, int width, int height, DC source,
0df68c9f
RD
3338 int xsrc, int ysrc, int rop=COPY, bool useMask=False,
3339 int xsrcMask=-1, int ysrcMask=-1) -> bool
f5b96ee1
RD
3340
3341 Copy from a source DC to this DC. Parameters specify the destination
3342 coordinates, size of area to copy, source DC, source coordinates,
3343 logical function, whether to use a bitmap mask, and mask source
3344 position.
0df68c9f 3345 """
03e37cd5 3346 return _gdi_.DC_Blit(*args, **kwargs)
e811c8ce 3347
03e37cd5 3348 def BlitPointSize(*args, **kwargs):
0df68c9f 3349 """
03e37cd5 3350 BlitPointSize(self, Point destPt, Size sz, DC source, Point srcPt, int rop=COPY,
0df68c9f 3351 bool useMask=False, Point srcPtMask=DefaultPosition) -> bool
f5b96ee1
RD
3352
3353 Copy from a source DC to this DC. Parameters specify the destination
3354 coordinates, size of area to copy, source DC, source coordinates,
3355 logical function, whether to use a bitmap mask, and mask source
3356 position.
0df68c9f 3357 """
03e37cd5
RD
3358 return _gdi_.DC_BlitPointSize(*args, **kwargs)
3359
3360 def SetClippingRegion(*args, **kwargs):
f5b96ee1
RD
3361 """
3362 SetClippingRegion(self, int x, int y, int width, int height)
3363
3364 Sets the clipping region for this device context to the intersection
3365 of the given region described by the parameters of this method and the
3366 previously set clipping region. You should call `DestroyClippingRegion`
3367 if you want to set the clipping region exactly to the region
3368 specified.
3369
3370 The clipping region is an area to which drawing is
3371 restricted. Possible uses for the clipping region are for clipping
3372 text or for speeding up window redraws when only a known area of the
3373 screen is damaged.
3374 """
03e37cd5
RD
3375 return _gdi_.DC_SetClippingRegion(*args, **kwargs)
3376
3377 def SetClippingRegionPointSize(*args, **kwargs):
f5b96ee1
RD
3378 """
3379 SetClippingRegionPointSize(self, Point pt, Size sz)
3380
3381 Sets the clipping region for this device context to the intersection
3382 of the given region described by the parameters of this method and the
3383 previously set clipping region. You should call `DestroyClippingRegion`
3384 if you want to set the clipping region exactly to the region
3385 specified.
3386
3387 The clipping region is an area to which drawing is
3388 restricted. Possible uses for the clipping region are for clipping
3389 text or for speeding up window redraws when only a known area of the
3390 screen is damaged.
3391 """
03e37cd5
RD
3392 return _gdi_.DC_SetClippingRegionPointSize(*args, **kwargs)
3393
3394 def SetClippingRegionAsRegion(*args, **kwargs):
f5b96ee1
RD
3395 """
3396 SetClippingRegionAsRegion(self, Region region)
3397
3398 Sets the clipping region for this device context to the intersection
3399 of the given region described by the parameters of this method and the
3400 previously set clipping region. You should call `DestroyClippingRegion`
3401 if you want to set the clipping region exactly to the region
3402 specified.
3403
3404 The clipping region is an area to which drawing is
3405 restricted. Possible uses for the clipping region are for clipping
3406 text or for speeding up window redraws when only a known area of the
3407 screen is damaged.
3408 """
03e37cd5
RD
3409 return _gdi_.DC_SetClippingRegionAsRegion(*args, **kwargs)
3410
3411 def SetClippingRect(*args, **kwargs):
f5b96ee1
RD
3412 """
3413 SetClippingRect(self, Rect rect)
3414
3415 Sets the clipping region for this device context to the intersection
3416 of the given region described by the parameters of this method and the
3417 previously set clipping region. You should call `DestroyClippingRegion`
3418 if you want to set the clipping region exactly to the region
3419 specified.
3420
3421 The clipping region is an area to which drawing is
3422 restricted. Possible uses for the clipping region are for clipping
3423 text or for speeding up window redraws when only a known area of the
3424 screen is damaged.
3425 """
03e37cd5 3426 return _gdi_.DC_SetClippingRect(*args, **kwargs)
e811c8ce
RD
3427
3428 def DrawLines(*args, **kwargs):
f5b96ee1
RD
3429 """
3430 DrawLines(self, List points, int xoffset=0, int yoffset=0)
3431
3432 Draws lines using a sequence of `wx.Point` objects, adding the
3433 optional offset coordinate. The current pen is used for drawing the
3434 lines.
3435 """
54f9ee45 3436 return _gdi_.DC_DrawLines(*args, **kwargs)
e811c8ce
RD
3437
3438 def DrawPolygon(*args, **kwargs):
0df68c9f 3439 """
f5b96ee1 3440 DrawPolygon(self, List points, int xoffset=0, int yoffset=0,
0df68c9f 3441 int fillStyle=ODDEVEN_RULE)
f5b96ee1
RD
3442
3443 Draws a filled polygon using a sequence of `wx.Point` objects, adding
3444 the optional offset coordinate. The last argument specifies the fill
3445 rule: ``wx.ODDEVEN_RULE`` (the default) or ``wx.WINDING_RULE``.
3446
3447 The current pen is used for drawing the outline, and the current brush
3448 for filling the shape. Using a transparent brush suppresses
3449 filling. Note that wxWidgets automatically closes the first and last
3450 points.
0df68c9f 3451 """
54f9ee45 3452 return _gdi_.DC_DrawPolygon(*args, **kwargs)
e811c8ce
RD
3453
3454 def DrawLabel(*args, **kwargs):
0df68c9f 3455 """
a95a7133 3456 DrawLabel(self, String text, Rect rect, int alignment=wxALIGN_LEFT|wxALIGN_TOP,
0df68c9f 3457 int indexAccel=-1)
f5b96ee1
RD
3458
3459 Draw *text* within the specified rectangle, abiding by the alignment
3460 flags. Will additionally emphasize the character at *indexAccel* if
3461 it is not -1.
0df68c9f 3462 """
54f9ee45 3463 return _gdi_.DC_DrawLabel(*args, **kwargs)
e811c8ce
RD
3464
3465 def DrawImageLabel(*args, **kwargs):
0df68c9f 3466 """
a95a7133 3467 DrawImageLabel(self, String text, Bitmap image, Rect rect, int alignment=wxALIGN_LEFT|wxALIGN_TOP,
0df68c9f 3468 int indexAccel=-1) -> Rect
f5b96ee1
RD
3469
3470 Draw *text* and an image (which may be ``wx.NullBitmap`` to skip
3471 drawing it) within the specified rectangle, abiding by the alignment
3472 flags. Will additionally emphasize the character at *indexAccel* if
3473 it is not -1. Returns the bounding rectangle.
0df68c9f 3474 """
54f9ee45 3475 return _gdi_.DC_DrawImageLabel(*args, **kwargs)
e811c8ce
RD
3476
3477 def DrawSpline(*args, **kwargs):
f5b96ee1
RD
3478 """
3479 DrawSpline(self, List points)
3480
3481 Draws a spline between all given control points, (a list of `wx.Point`
3482 objects) using the current pen. The spline is drawn using a series of
3483 lines, using an algorithm taken from the X drawing program 'XFIG'.
3484 """
54f9ee45 3485 return _gdi_.DC_DrawSpline(*args, **kwargs)
e811c8ce
RD
3486
3487 def Clear(*args, **kwargs):
f5b96ee1
RD
3488 """
3489 Clear(self)
3490
3491 Clears the device context using the current background brush.
3492 """
54f9ee45 3493 return _gdi_.DC_Clear(*args, **kwargs)
e811c8ce
RD
3494
3495 def StartDoc(*args, **kwargs):
f5b96ee1
RD
3496 """
3497 StartDoc(self, String message) -> bool
3498
3499 Starts a document (only relevant when outputting to a
3500 printer). *Message* is a message to show whilst printing.
3501 """
54f9ee45 3502 return _gdi_.DC_StartDoc(*args, **kwargs)
e811c8ce
RD
3503
3504 def EndDoc(*args, **kwargs):
f5b96ee1
RD
3505 """
3506 EndDoc(self)
3507
3508 Ends a document (only relevant when outputting to a printer).
3509 """
54f9ee45 3510 return _gdi_.DC_EndDoc(*args, **kwargs)
e811c8ce
RD
3511
3512 def StartPage(*args, **kwargs):
f5b96ee1
RD
3513 """
3514 StartPage(self)
3515
3516 Starts a document page (only relevant when outputting to a printer).
3517 """
54f9ee45 3518 return _gdi_.DC_StartPage(*args, **kwargs)
e811c8ce
RD
3519
3520 def EndPage(*args, **kwargs):
f5b96ee1
RD
3521 """
3522 EndPage(self)
3523
3524 Ends a document page (only relevant when outputting to a printer).
3525 """
54f9ee45 3526 return _gdi_.DC_EndPage(*args, **kwargs)
e811c8ce
RD
3527
3528 def SetFont(*args, **kwargs):
f5b96ee1
RD
3529 """
3530 SetFont(self, Font font)
3531
3532 Sets the current font for the DC. It must be a valid font, in
3533 particular you should not pass ``wx.NullFont`` to this method.
3534 """
54f9ee45 3535 return _gdi_.DC_SetFont(*args, **kwargs)
e811c8ce
RD
3536
3537 def SetPen(*args, **kwargs):
f5b96ee1
RD
3538 """
3539 SetPen(self, Pen pen)
3540
3541 Sets the current pen for the DC.
3542
3543 If the argument is ``wx.NullPen``, the current pen is selected out of the
3544 device context, and the original pen restored.
3545 """
54f9ee45 3546 return _gdi_.DC_SetPen(*args, **kwargs)
e811c8ce
RD
3547
3548 def SetBrush(*args, **kwargs):
f5b96ee1
RD
3549 """
3550 SetBrush(self, Brush brush)
3551
3552 Sets the current brush for the DC.
3553
3554 If the argument is ``wx.NullBrush``, the current brush is selected out
3555 of the device context, and the original brush restored, allowing the
3556 current brush to be destroyed safely.
3557 """
54f9ee45 3558 return _gdi_.DC_SetBrush(*args, **kwargs)
e811c8ce
RD
3559
3560 def SetBackground(*args, **kwargs):
f5b96ee1
RD
3561 """
3562 SetBackground(self, Brush brush)
3563
3564 Sets the current background brush for the DC.
3565 """
54f9ee45 3566 return _gdi_.DC_SetBackground(*args, **kwargs)
e811c8ce
RD
3567
3568 def SetBackgroundMode(*args, **kwargs):
f5b96ee1
RD
3569 """
3570 SetBackgroundMode(self, int mode)
3571
3572 *mode* may be one of ``wx.SOLID`` and ``wx.TRANSPARENT``. This setting
3573 determines whether text will be drawn with a background colour or
3574 not.
3575 """
54f9ee45 3576 return _gdi_.DC_SetBackgroundMode(*args, **kwargs)
e811c8ce
RD
3577
3578 def SetPalette(*args, **kwargs):
f5b96ee1
RD
3579 """
3580 SetPalette(self, Palette palette)
3581
3582 If this is a window DC or memory DC, assigns the given palette to the
3583 window or bitmap associated with the DC. If the argument is
3584 ``wx.NullPalette``, the current palette is selected out of the device
3585 context, and the original palette restored.
3586 """
54f9ee45 3587 return _gdi_.DC_SetPalette(*args, **kwargs)
e811c8ce 3588
e811c8ce 3589 def DestroyClippingRegion(*args, **kwargs):
f5b96ee1
RD
3590 """
3591 DestroyClippingRegion(self)
3592
3593 Destroys the current clipping region so that none of the DC is
3594 clipped.
3595 """
54f9ee45 3596 return _gdi_.DC_DestroyClippingRegion(*args, **kwargs)
e811c8ce
RD
3597
3598 def GetClippingBox(*args, **kwargs):
f5b96ee1
RD
3599 """
3600 GetClippingBox() -> (x, y, width, height)
3601
3602 Gets the rectangle surrounding the current clipping region.
3603 """
54f9ee45 3604 return _gdi_.DC_GetClippingBox(*args, **kwargs)
e811c8ce
RD
3605
3606 def GetClippingRect(*args, **kwargs):
f5b96ee1
RD
3607 """
3608 GetClippingRect(self) -> Rect
3609
3610 Gets the rectangle surrounding the current clipping region.
3611 """
54f9ee45 3612 return _gdi_.DC_GetClippingRect(*args, **kwargs)
e811c8ce
RD
3613
3614 def GetCharHeight(*args, **kwargs):
f5b96ee1
RD
3615 """
3616 GetCharHeight(self) -> int
3617
3618 Gets the character height of the currently set font.
3619 """
54f9ee45 3620 return _gdi_.DC_GetCharHeight(*args, **kwargs)
e811c8ce
RD
3621
3622 def GetCharWidth(*args, **kwargs):
f5b96ee1
RD
3623 """
3624 GetCharWidth(self) -> int
3625
3626 Gets the average character width of the currently set font.
3627 """
54f9ee45 3628 return _gdi_.DC_GetCharWidth(*args, **kwargs)
e811c8ce
RD
3629
3630 def GetTextExtent(*args, **kwargs):
fd2dc343
RD
3631 """
3632 GetTextExtent(wxString string) -> (width, height)
3633
3634 Get the width and height of the text using the current font. Only
3635 works for single line strings.
3636 """
54f9ee45 3637 return _gdi_.DC_GetTextExtent(*args, **kwargs)
e811c8ce
RD
3638
3639 def GetFullTextExtent(*args, **kwargs):
0df68c9f
RD
3640 """
3641 GetFullTextExtent(wxString string, Font font=None) ->
3642 (width, height, descent, externalLeading)
322913ce 3643
41e2b43e
RD
3644 Get the width, height, decent and leading of the text using the
3645 current or specified font. Only works for single line strings.
0df68c9f 3646 """
54f9ee45 3647 return _gdi_.DC_GetFullTextExtent(*args, **kwargs)
e811c8ce
RD
3648
3649 def GetMultiLineTextExtent(*args, **kwargs):
0df68c9f
RD
3650 """
3651 GetMultiLineTextExtent(wxString string, Font font=None) ->
fc46b7f3 3652 (width, height, lineHeight)
fd2dc343 3653
777e547f 3654 Get the width, height, and line height of the text using the
fd2dc343
RD
3655 current or specified font. Works for single as well as multi-line
3656 strings.
0df68c9f 3657 """
54f9ee45 3658 return _gdi_.DC_GetMultiLineTextExtent(*args, **kwargs)
e811c8ce 3659
db914595 3660 def GetPartialTextExtents(*args, **kwargs):
f5b96ee1
RD
3661 """
3662 GetPartialTextExtents(self, text) -> [widths]
3663
3664 Returns a list of integers such that each value is the distance in
3665 pixels from the begining of text to the coresponding character of
3666 *text*. The generic version simply builds a running total of the widths
3667 of each character using GetTextExtent, however if the various
3668 platforms have a native API function that is faster or more accurate
43e8916f 3669 than the generic implementation then it will be used instead.
f5b96ee1 3670 """
54f9ee45 3671 return _gdi_.DC_GetPartialTextExtents(*args, **kwargs)
db914595 3672
e811c8ce 3673 def GetSize(*args, **kwargs):
0df68c9f 3674 """
a95a7133 3675 GetSize(self) -> Size
322913ce 3676
f5b96ee1
RD
3677 This gets the horizontal and vertical resolution in device units. It
3678 can be used to scale graphics to fit the page. For example, if *maxX*
3679 and *maxY* represent the maximum horizontal and vertical 'pixel' values
3680 used in your application, the following code will scale the graphic to
3681 fit on the printer page::
3682
3683 w, h = dc.GetSize()
3684 scaleX = maxX*1.0 / w
3685 scaleY = maxY*1.0 / h
3686 dc.SetUserScale(min(scaleX,scaleY),min(scaleX,scaleY))
3687
0df68c9f 3688 """
54f9ee45 3689 return _gdi_.DC_GetSize(*args, **kwargs)
e811c8ce 3690
322913ce 3691 def GetSizeTuple(*args, **kwargs):
0df68c9f
RD
3692 """
3693 GetSizeTuple() -> (width, height)
322913ce 3694
f5b96ee1
RD
3695 This gets the horizontal and vertical resolution in device units. It
3696 can be used to scale graphics to fit the page. For example, if *maxX*
3697 and *maxY* represent the maximum horizontal and vertical 'pixel' values
3698 used in your application, the following code will scale the graphic to
3699 fit on the printer page::
3700
3701 w, h = dc.GetSize()
3702 scaleX = maxX*1.0 / w
3703 scaleY = maxY*1.0 / h
3704 dc.SetUserScale(min(scaleX,scaleY),min(scaleX,scaleY))
3705
0df68c9f 3706 """
54f9ee45 3707 return _gdi_.DC_GetSizeTuple(*args, **kwargs)
e811c8ce
RD
3708
3709 def GetSizeMM(*args, **kwargs):
0df68c9f 3710 """
a95a7133 3711 GetSizeMM(self) -> Size
322913ce 3712
0df68c9f
RD
3713 Get the DC size in milimeters.
3714 """
54f9ee45 3715 return _gdi_.DC_GetSizeMM(*args, **kwargs)
e811c8ce 3716
322913ce 3717 def GetSizeMMTuple(*args, **kwargs):
0df68c9f
RD
3718 """
3719 GetSizeMMTuple() -> (width, height)
322913ce 3720
0df68c9f
RD
3721 Get the DC size in milimeters.
3722 """
54f9ee45 3723 return _gdi_.DC_GetSizeMMTuple(*args, **kwargs)
322913ce 3724
e811c8ce 3725 def DeviceToLogicalX(*args, **kwargs):
f5b96ee1
RD
3726 """
3727 DeviceToLogicalX(self, int x) -> int
3728
3729 Convert device X coordinate to logical coordinate, using the current
3730 mapping mode.
3731 """
54f9ee45 3732 return _gdi_.DC_DeviceToLogicalX(*args, **kwargs)
e811c8ce
RD
3733
3734 def DeviceToLogicalY(*args, **kwargs):
f5b96ee1
RD
3735 """
3736 DeviceToLogicalY(self, int y) -> int
3737
3738 Converts device Y coordinate to logical coordinate, using the current
3739 mapping mode.
3740 """
54f9ee45 3741 return _gdi_.DC_DeviceToLogicalY(*args, **kwargs)
e811c8ce
RD
3742
3743 def DeviceToLogicalXRel(*args, **kwargs):
f5b96ee1
RD
3744 """
3745 DeviceToLogicalXRel(self, int x) -> int
3746
3747 Convert device X coordinate to relative logical coordinate, using the
3748 current mapping mode but ignoring the x axis orientation. Use this
3749 function for converting a width, for example.
3750 """
54f9ee45 3751 return _gdi_.DC_DeviceToLogicalXRel(*args, **kwargs)
e811c8ce
RD
3752
3753 def DeviceToLogicalYRel(*args, **kwargs):
f5b96ee1
RD
3754 """
3755 DeviceToLogicalYRel(self, int y) -> int
3756
3757 Convert device Y coordinate to relative logical coordinate, using the
3758 current mapping mode but ignoring the y axis orientation. Use this
3759 function for converting a height, for example.
3760 """
54f9ee45 3761 return _gdi_.DC_DeviceToLogicalYRel(*args, **kwargs)
e811c8ce
RD
3762
3763 def LogicalToDeviceX(*args, **kwargs):
f5b96ee1
RD
3764 """
3765 LogicalToDeviceX(self, int x) -> int
3766
3767 Converts logical X coordinate to device coordinate, using the current
3768 mapping mode.
3769 """
54f9ee45 3770 return _gdi_.DC_LogicalToDeviceX(*args, **kwargs)
e811c8ce
RD
3771
3772 def LogicalToDeviceY(*args, **kwargs):
f5b96ee1
RD
3773 """
3774 LogicalToDeviceY(self, int y) -> int
3775
3776 Converts logical Y coordinate to device coordinate, using the current
3777 mapping mode.
3778 """
54f9ee45 3779 return _gdi_.DC_LogicalToDeviceY(*args, **kwargs)
e811c8ce
RD
3780
3781 def LogicalToDeviceXRel(*args, **kwargs):
f5b96ee1
RD
3782 """
3783 LogicalToDeviceXRel(self, int x) -> int
3784
3785 Converts logical X coordinate to relative device coordinate, using the
3786 current mapping mode but ignoring the x axis orientation. Use this for
3787 converting a width, for example.
3788 """
54f9ee45 3789 return _gdi_.DC_LogicalToDeviceXRel(*args, **kwargs)
e811c8ce
RD
3790
3791 def LogicalToDeviceYRel(*args, **kwargs):
f5b96ee1
RD
3792 """
3793 LogicalToDeviceYRel(self, int y) -> int
3794
3795 Converts logical Y coordinate to relative device coordinate, using the
3796 current mapping mode but ignoring the y axis orientation. Use this for
3797 converting a height, for example.
3798 """
54f9ee45 3799 return _gdi_.DC_LogicalToDeviceYRel(*args, **kwargs)
e811c8ce
RD
3800
3801 def CanDrawBitmap(*args, **kwargs):
a95a7133 3802 """CanDrawBitmap(self) -> bool"""
54f9ee45 3803 return _gdi_.DC_CanDrawBitmap(*args, **kwargs)
e811c8ce
RD
3804
3805 def CanGetTextExtent(*args, **kwargs):
a95a7133 3806 """CanGetTextExtent(self) -> bool"""
54f9ee45 3807 return _gdi_.DC_CanGetTextExtent(*args, **kwargs)
e811c8ce
RD
3808
3809 def GetDepth(*args, **kwargs):
f5b96ee1
RD
3810 """
3811 GetDepth(self) -> int
3812
3813 Returns the colour depth of the DC.
3814 """
54f9ee45 3815 return _gdi_.DC_GetDepth(*args, **kwargs)
e811c8ce
RD
3816
3817 def GetPPI(*args, **kwargs):
f5b96ee1
RD
3818 """
3819 GetPPI(self) -> Size
3820
453fb36b 3821 Resolution in pixels per inch
f5b96ee1 3822 """
54f9ee45 3823 return _gdi_.DC_GetPPI(*args, **kwargs)
e811c8ce
RD
3824
3825 def Ok(*args, **kwargs):
f5b96ee1
RD
3826 """
3827 Ok(self) -> bool
3828
3829 Returns true if the DC is ok to use.
3830 """
54f9ee45 3831 return _gdi_.DC_Ok(*args, **kwargs)
e811c8ce
RD
3832
3833 def GetBackgroundMode(*args, **kwargs):
f5b96ee1
RD
3834 """
3835 GetBackgroundMode(self) -> int
3836
3837 Returns the current background mode, either ``wx.SOLID`` or
3838 ``wx.TRANSPARENT``.
3839 """
54f9ee45 3840 return _gdi_.DC_GetBackgroundMode(*args, **kwargs)
e811c8ce
RD
3841
3842 def GetBackground(*args, **kwargs):
f5b96ee1
RD
3843 """
3844 GetBackground(self) -> Brush
3845
3846 Gets the brush used for painting the background.
3847 """
54f9ee45 3848 return _gdi_.DC_GetBackground(*args, **kwargs)
e811c8ce
RD
3849
3850 def GetBrush(*args, **kwargs):
f5b96ee1
RD
3851 """
3852 GetBrush(self) -> Brush
3853
3854 Gets the current brush
3855 """
54f9ee45 3856 return _gdi_.DC_GetBrush(*args, **kwargs)
e811c8ce
RD
3857
3858 def GetFont(*args, **kwargs):
f5b96ee1
RD
3859 """
3860 GetFont(self) -> Font
3861
3862 Gets the current font
3863 """
54f9ee45 3864 return _gdi_.DC_GetFont(*args, **kwargs)
e811c8ce
RD
3865
3866 def GetPen(*args, **kwargs):
f5b96ee1
RD
3867 """
3868 GetPen(self) -> Pen
3869
3870 Gets the current pen
3871 """
54f9ee45 3872 return _gdi_.DC_GetPen(*args, **kwargs)
e811c8ce
RD
3873
3874 def GetTextBackground(*args, **kwargs):
f5b96ee1
RD
3875 """
3876 GetTextBackground(self) -> Colour
3877
3878 Gets the current text background colour
3879 """
54f9ee45 3880 return _gdi_.DC_GetTextBackground(*args, **kwargs)
e811c8ce
RD
3881
3882 def GetTextForeground(*args, **kwargs):
f5b96ee1
RD
3883 """
3884 GetTextForeground(self) -> Colour
3885
3886 Gets the current text foreground colour
3887 """
54f9ee45 3888 return _gdi_.DC_GetTextForeground(*args, **kwargs)
e811c8ce
RD
3889
3890 def SetTextForeground(*args, **kwargs):
f5b96ee1
RD
3891 """
3892 SetTextForeground(self, Colour colour)
3893
3894 Sets the current text foreground colour for the DC.
3895 """
54f9ee45 3896 return _gdi_.DC_SetTextForeground(*args, **kwargs)
e811c8ce
RD
3897
3898 def SetTextBackground(*args, **kwargs):
f5b96ee1
RD
3899 """
3900 SetTextBackground(self, Colour colour)
3901
3902 Sets the current text background colour for the DC.
3903 """
54f9ee45 3904 return _gdi_.DC_SetTextBackground(*args, **kwargs)
e811c8ce
RD
3905
3906 def GetMapMode(*args, **kwargs):
f5b96ee1
RD
3907 """
3908 GetMapMode(self) -> int
3909
3910 Gets the current *mapping mode* for the device context
3911 """
54f9ee45 3912 return _gdi_.DC_GetMapMode(*args, **kwargs)
e811c8ce
RD
3913
3914 def SetMapMode(*args, **kwargs):
f5b96ee1
RD
3915 """
3916 SetMapMode(self, int mode)
3917
3918 The *mapping mode* of the device context defines the unit of
3919 measurement used to convert logical units to device units. The
3920 mapping mode can be one of the following:
3921
3922 ================ =============================================
3923 wx.MM_TWIPS Each logical unit is 1/20 of a point, or 1/1440
3924 of an inch.
3925 wx.MM_POINTS Each logical unit is a point, or 1/72 of an inch.
3926 wx.MM_METRIC Each logical unit is 1 mm.
3927 wx.MM_LOMETRIC Each logical unit is 1/10 of a mm.
3928 wx.MM_TEXT Each logical unit is 1 pixel.
3929 ================ =============================================
3930
3931 """
54f9ee45 3932 return _gdi_.DC_SetMapMode(*args, **kwargs)
e811c8ce
RD
3933
3934 def GetUserScale(*args, **kwargs):
f5b96ee1
RD
3935 """
3936 GetUserScale(self) -> (xScale, yScale)
3937
3938 Gets the current user scale factor (set by `SetUserScale`).
3939 """
54f9ee45 3940 return _gdi_.DC_GetUserScale(*args, **kwargs)
e811c8ce
RD
3941
3942 def SetUserScale(*args, **kwargs):
f5b96ee1
RD
3943 """
3944 SetUserScale(self, double x, double y)
3945
3946 Sets the user scaling factor, useful for applications which require
3947 'zooming'.
3948 """
54f9ee45 3949 return _gdi_.DC_SetUserScale(*args, **kwargs)
e811c8ce
RD
3950
3951 def GetLogicalScale(*args, **kwargs):
322913ce 3952 """GetLogicalScale() -> (xScale, yScale)"""
54f9ee45 3953 return _gdi_.DC_GetLogicalScale(*args, **kwargs)
e811c8ce
RD
3954
3955 def SetLogicalScale(*args, **kwargs):
a95a7133 3956 """SetLogicalScale(self, double x, double y)"""
54f9ee45 3957 return _gdi_.DC_SetLogicalScale(*args, **kwargs)
e811c8ce 3958
e811c8ce 3959 def GetLogicalOrigin(*args, **kwargs):
a95a7133 3960 """GetLogicalOrigin(self) -> Point"""
54f9ee45 3961 return _gdi_.DC_GetLogicalOrigin(*args, **kwargs)
e811c8ce 3962
322913ce
RD
3963 def GetLogicalOriginTuple(*args, **kwargs):
3964 """GetLogicalOriginTuple() -> (x,y)"""
54f9ee45 3965 return _gdi_.DC_GetLogicalOriginTuple(*args, **kwargs)
322913ce 3966
e811c8ce 3967 def SetLogicalOrigin(*args, **kwargs):
a95a7133 3968 """SetLogicalOrigin(self, int x, int y)"""
54f9ee45 3969 return _gdi_.DC_SetLogicalOrigin(*args, **kwargs)
e811c8ce 3970
03e37cd5
RD
3971 def SetLogicalOriginPoint(*args, **kwargs):
3972 """SetLogicalOriginPoint(self, Point point)"""
3973 return _gdi_.DC_SetLogicalOriginPoint(*args, **kwargs)
3974
e811c8ce 3975 def GetDeviceOrigin(*args, **kwargs):
a95a7133 3976 """GetDeviceOrigin(self) -> Point"""
54f9ee45 3977 return _gdi_.DC_GetDeviceOrigin(*args, **kwargs)
e811c8ce 3978
322913ce
RD
3979 def GetDeviceOriginTuple(*args, **kwargs):
3980 """GetDeviceOriginTuple() -> (x,y)"""
54f9ee45 3981 return _gdi_.DC_GetDeviceOriginTuple(*args, **kwargs)
322913ce 3982
e811c8ce 3983 def SetDeviceOrigin(*args, **kwargs):
a95a7133 3984 """SetDeviceOrigin(self, int x, int y)"""
54f9ee45 3985 return _gdi_.DC_SetDeviceOrigin(*args, **kwargs)
e811c8ce 3986
03e37cd5
RD
3987 def SetDeviceOriginPoint(*args, **kwargs):
3988 """SetDeviceOriginPoint(self, Point point)"""
3989 return _gdi_.DC_SetDeviceOriginPoint(*args, **kwargs)
3990
e811c8ce 3991 def SetAxisOrientation(*args, **kwargs):
f5b96ee1
RD
3992 """
3993 SetAxisOrientation(self, bool xLeftRight, bool yBottomUp)
3994
3995 Sets the x and y axis orientation (i.e., the direction from lowest to
3996 highest values on the axis). The default orientation is the natural
3997 orientation, e.g. x axis from left to right and y axis from bottom up.
3998 """
54f9ee45 3999 return _gdi_.DC_SetAxisOrientation(*args, **kwargs)
e811c8ce
RD
4000
4001 def GetLogicalFunction(*args, **kwargs):
f5b96ee1
RD
4002 """
4003 GetLogicalFunction(self) -> int
4004
4005 Gets the current logical function (set by `SetLogicalFunction`).
4006 """
54f9ee45 4007 return _gdi_.DC_GetLogicalFunction(*args, **kwargs)
e811c8ce
RD
4008
4009 def SetLogicalFunction(*args, **kwargs):
f5b96ee1
RD
4010 """
4011 SetLogicalFunction(self, int function)
4012
4013 Sets the current logical function for the device context. This
4014 determines how a source pixel (from a pen or brush colour, or source
4015 device context if using `Blit`) combines with a destination pixel in
4016 the current device context.
4017
4018 The possible values and their meaning in terms of source and
4019 destination pixel values are as follows:
4020
4021 ================ ==========================
4022 wx.AND src AND dst
4023 wx.AND_INVERT (NOT src) AND dst
4024 wx.AND_REVERSE src AND (NOT dst)
4025 wx.CLEAR 0
4026 wx.COPY src
4027 wx.EQUIV (NOT src) XOR dst
4028 wx.INVERT NOT dst
4029 wx.NAND (NOT src) OR (NOT dst)
4030 wx.NOR (NOT src) AND (NOT dst)
4031 wx.NO_OP dst
4032 wx.OR src OR dst
4033 wx.OR_INVERT (NOT src) OR dst
4034 wx.OR_REVERSE src OR (NOT dst)
4035 wx.SET 1
4036 wx.SRC_INVERT NOT src
4037 wx.XOR src XOR dst
4038 ================ ==========================
4039
4040 The default is wx.COPY, which simply draws with the current
4041 colour. The others combine the current colour and the background using
4042 a logical operation. wx.INVERT is commonly used for drawing rubber
4043 bands or moving outlines, since drawing twice reverts to the original
4044 colour.
4045
4046 """
54f9ee45 4047 return _gdi_.DC_SetLogicalFunction(*args, **kwargs)
e811c8ce 4048
5cbf236d 4049 def ComputeScaleAndOrigin(*args, **kwargs):
f5b96ee1 4050 """
5cbf236d 4051 ComputeScaleAndOrigin(self)
f5b96ee1 4052
5cbf236d
RD
4053 Performs all necessary computations for given platform and context
4054 type after each change of scale and origin parameters. Usually called
4055 automatically internally after such changes.
f5b96ee1 4056
f5b96ee1 4057 """
5cbf236d 4058 return _gdi_.DC_ComputeScaleAndOrigin(*args, **kwargs)
e811c8ce 4059
5cbf236d
RD
4060 def SetOptimization(self, optimize):
4061 pass
4062 def GetOptimization(self):
4063 return False
f5b96ee1 4064
5cbf236d
RD
4065 SetOptimization = wx._deprecated(SetOptimization)
4066 GetOptimization = wx._deprecated(GetOptimization)
e811c8ce
RD
4067
4068 def CalcBoundingBox(*args, **kwargs):
f5b96ee1
RD
4069 """
4070 CalcBoundingBox(self, int x, int y)
4071
4072 Adds the specified point to the bounding box which can be retrieved
4073 with `MinX`, `MaxX` and `MinY`, `MaxY` or `GetBoundingBox` functions.
4074 """
54f9ee45 4075 return _gdi_.DC_CalcBoundingBox(*args, **kwargs)
e811c8ce 4076
03e37cd5 4077 def CalcBoundingBoxPoint(*args, **kwargs):
f5b96ee1
RD
4078 """
4079 CalcBoundingBoxPoint(self, Point point)
4080
4081 Adds the specified point to the bounding box which can be retrieved
4082 with `MinX`, `MaxX` and `MinY`, `MaxY` or `GetBoundingBox` functions.
4083 """
03e37cd5
RD
4084 return _gdi_.DC_CalcBoundingBoxPoint(*args, **kwargs)
4085
e811c8ce 4086 def ResetBoundingBox(*args, **kwargs):
f5b96ee1
RD
4087 """
4088 ResetBoundingBox(self)
4089
4090 Resets the bounding box: after a call to this function, the bounding
4091 box doesn't contain anything.
4092 """
54f9ee45 4093 return _gdi_.DC_ResetBoundingBox(*args, **kwargs)
e811c8ce
RD
4094
4095 def MinX(*args, **kwargs):
f5b96ee1
RD
4096 """
4097 MinX(self) -> int
4098
4099 Gets the minimum horizontal extent used in drawing commands so far.
4100 """
54f9ee45 4101 return _gdi_.DC_MinX(*args, **kwargs)
e811c8ce
RD
4102
4103 def MaxX(*args, **kwargs):
f5b96ee1
RD
4104 """
4105 MaxX(self) -> int
4106
4107 Gets the maximum horizontal extent used in drawing commands so far.
4108 """
54f9ee45 4109 return _gdi_.DC_MaxX(*args, **kwargs)
e811c8ce
RD
4110
4111 def MinY(*args, **kwargs):
f5b96ee1
RD
4112 """
4113 MinY(self) -> int
4114
4115 Gets the minimum vertical extent used in drawing commands so far.
4116 """
54f9ee45 4117 return _gdi_.DC_MinY(*args, **kwargs)
e811c8ce
RD
4118
4119 def MaxY(*args, **kwargs):
f5b96ee1
RD
4120 """
4121 MaxY(self) -> int
4122
4123 Gets the maximum vertical extent used in drawing commands so far.
4124 """
54f9ee45 4125 return _gdi_.DC_MaxY(*args, **kwargs)
e811c8ce
RD
4126
4127 def GetBoundingBox(*args, **kwargs):
f5b96ee1
RD
4128 """
4129 GetBoundingBox() -> (x1,y1, x2,y2)
4130
4131 Returns the min and max points used in drawing commands so far.
4132 """
54f9ee45 4133 return _gdi_.DC_GetBoundingBox(*args, **kwargs)
e811c8ce 4134
d14a1e28 4135 def __nonzero__(self): return self.Ok()
e811c8ce 4136 def _DrawPointList(*args, **kwargs):
a95a7133 4137 """_DrawPointList(self, PyObject pyCoords, PyObject pyPens, PyObject pyBrushes) -> PyObject"""
54f9ee45 4138 return _gdi_.DC__DrawPointList(*args, **kwargs)
e811c8ce
RD
4139
4140 def _DrawLineList(*args, **kwargs):
a95a7133 4141 """_DrawLineList(self, PyObject pyCoords, PyObject pyPens, PyObject pyBrushes) -> PyObject"""
54f9ee45 4142 return _gdi_.DC__DrawLineList(*args, **kwargs)
e811c8ce
RD
4143
4144 def _DrawRectangleList(*args, **kwargs):
a95a7133 4145 """_DrawRectangleList(self, PyObject pyCoords, PyObject pyPens, PyObject pyBrushes) -> PyObject"""
54f9ee45 4146 return _gdi_.DC__DrawRectangleList(*args, **kwargs)
e811c8ce
RD
4147
4148 def _DrawEllipseList(*args, **kwargs):
a95a7133 4149 """_DrawEllipseList(self, PyObject pyCoords, PyObject pyPens, PyObject pyBrushes) -> PyObject"""
54f9ee45 4150 return _gdi_.DC__DrawEllipseList(*args, **kwargs)
e811c8ce
RD
4151
4152 def _DrawPolygonList(*args, **kwargs):
a95a7133 4153 """_DrawPolygonList(self, PyObject pyCoords, PyObject pyPens, PyObject pyBrushes) -> PyObject"""
54f9ee45 4154 return _gdi_.DC__DrawPolygonList(*args, **kwargs)
e811c8ce
RD
4155
4156 def _DrawTextList(*args, **kwargs):
0df68c9f 4157 """
a95a7133 4158 _DrawTextList(self, PyObject textList, PyObject pyPoints, PyObject foregroundList,
0df68c9f
RD
4159 PyObject backgroundList) -> PyObject
4160 """
54f9ee45 4161 return _gdi_.DC__DrawTextList(*args, **kwargs)
e811c8ce 4162
3bcd5e1c 4163 def DrawPointList(self, points, pens=None):
f5b96ee1
RD
4164 """
4165 Draw a list of points as quickly as possible.
4166
4167 :param points: A sequence of 2-element sequences representing
4168 each point to draw, (x,y).
4169 :param pens: If None, then the current pen is used. If a
4170 single pen then it will be used for all points. If
4171 a list of pens then there should be one for each point
4172 in points.
4173 """
3bcd5e1c
RD
4174 if pens is None:
4175 pens = []
d14a1e28 4176 elif isinstance(pens, wx.Pen):
3bcd5e1c
RD
4177 pens = [pens]
4178 elif len(pens) != len(points):
4179 raise ValueError('points and pens must have same length')
b67a9327
RD
4180 return self._DrawPointList(points, pens, [])
4181
3bcd5e1c
RD
4182
4183 def DrawLineList(self, lines, pens=None):
f5b96ee1
RD
4184 """
4185 Draw a list of lines as quickly as possible.
4186
4187 :param lines: A sequence of 4-element sequences representing
4188 each line to draw, (x1,y1, x2,y2).
4189 :param pens: If None, then the current pen is used. If a
4190 single pen then it will be used for all lines. If
4191 a list of pens then there should be one for each line
4192 in lines.
4193 """
3bcd5e1c
RD
4194 if pens is None:
4195 pens = []
d14a1e28 4196 elif isinstance(pens, wx.Pen):
3bcd5e1c
RD
4197 pens = [pens]
4198 elif len(pens) != len(lines):
4199 raise ValueError('lines and pens must have same length')
b67a9327
RD
4200 return self._DrawLineList(lines, pens, [])
4201
4202
4203 def DrawRectangleList(self, rectangles, pens=None, brushes=None):
f5b96ee1
RD
4204 """
4205 Draw a list of rectangles as quickly as possible.
4206
4207 :param rectangles: A sequence of 4-element sequences representing
4208 each rectangle to draw, (x,y, w,h).
4209 :param pens: If None, then the current pen is used. If a
4210 single pen then it will be used for all rectangles.
4211 If a list of pens then there should be one for each
4212 rectangle in rectangles.
4213 :param brushes: A brush or brushes to be used to fill the rectagles,
4214 with similar semantics as the pens parameter.
4215 """
b67a9327
RD
4216 if pens is None:
4217 pens = []
d14a1e28 4218 elif isinstance(pens, wx.Pen):
b67a9327
RD
4219 pens = [pens]
4220 elif len(pens) != len(rectangles):
4221 raise ValueError('rectangles and pens must have same length')
4222 if brushes is None:
4223 brushes = []
d14a1e28 4224 elif isinstance(brushes, wx.Brush):
b67a9327
RD
4225 brushes = [brushes]
4226 elif len(brushes) != len(rectangles):
4227 raise ValueError('rectangles and brushes must have same length')
4228 return self._DrawRectangleList(rectangles, pens, brushes)
4229
4230
4231 def DrawEllipseList(self, ellipses, pens=None, brushes=None):
f5b96ee1
RD
4232 """
4233 Draw a list of ellipses as quickly as possible.
4234
4235 :param ellipses: A sequence of 4-element sequences representing
4236 each ellipse to draw, (x,y, w,h).
4237 :param pens: If None, then the current pen is used. If a
4238 single pen then it will be used for all ellipses.
4239 If a list of pens then there should be one for each
4240 ellipse in ellipses.
4241 :param brushes: A brush or brushes to be used to fill the ellipses,
4242 with similar semantics as the pens parameter.
4243 """
b67a9327
RD
4244 if pens is None:
4245 pens = []
d14a1e28 4246 elif isinstance(pens, wx.Pen):
b67a9327
RD
4247 pens = [pens]
4248 elif len(pens) != len(ellipses):
4249 raise ValueError('ellipses and pens must have same length')
4250 if brushes is None:
4251 brushes = []
d14a1e28 4252 elif isinstance(brushes, wx.Brush):
b67a9327
RD
4253 brushes = [brushes]
4254 elif len(brushes) != len(ellipses):
4255 raise ValueError('ellipses and brushes must have same length')
4256 return self._DrawEllipseList(ellipses, pens, brushes)
4257
4258
4259 def DrawPolygonList(self, polygons, pens=None, brushes=None):
f5b96ee1
RD
4260 """
4261 Draw a list of polygons, each of which is a list of points.
4262
4263 :param polygons: A sequence of sequences of sequences.
4264 [[(x1,y1),(x2,y2),(x3,y3)...],
4265 [(x1,y1),(x2,y2),(x3,y3)...]]
4266
4267 :param pens: If None, then the current pen is used. If a
4268 single pen then it will be used for all polygons.
4269 If a list of pens then there should be one for each
4270 polygon.
4271 :param brushes: A brush or brushes to be used to fill the polygons,
4272 with similar semantics as the pens parameter.
4273 """
b67a9327
RD
4274 if pens is None:
4275 pens = []
d14a1e28 4276 elif isinstance(pens, wx.Pen):
b67a9327
RD
4277 pens = [pens]
4278 elif len(pens) != len(polygons):
4279 raise ValueError('polygons and pens must have same length')
4280 if brushes is None:
4281 brushes = []
d14a1e28 4282 elif isinstance(brushes, wx.Brush):
b67a9327
RD
4283 brushes = [brushes]
4284 elif len(brushes) != len(polygons):
4285 raise ValueError('polygons and brushes must have same length')
4286 return self._DrawPolygonList(polygons, pens, brushes)
4287
4288
f5b96ee1
RD
4289 def DrawTextList(self, textList, coords, foregrounds = None, backgrounds = None):
4290 """
4291 Draw a list of strings using a list of coordinants for positioning each string.
4292
4293 :param textList: A list of strings
4294 :param coords: A list of (x,y) positions
4295 :param foregrounds: A list of `wx.Colour` objects to use for the
4296 foregrounds of the strings.
4297 :param backgrounds: A list of `wx.Colour` objects to use for the
4298 backgrounds of the strings.
4299
4300 NOTE: Make sure you set Background mode to wx.Solid (DC.SetBackgroundMode)
4301 If you want backgrounds to do anything.
4302 """
b67a9327
RD
4303 if type(textList) == type(''):
4304 textList = [textList]
4305 elif len(textList) != len(coords):
4306 raise ValueError('textlist and coords must have same length')
4307 if foregrounds is None:
4308 foregrounds = []
fd3f2efe 4309 elif isinstance(foregrounds, wx.Colour):
b67a9327
RD
4310 foregrounds = [foregrounds]
4311 elif len(foregrounds) != len(coords):
4312 raise ValueError('foregrounds and coords must have same length')
4313 if backgrounds is None:
4314 backgrounds = []
fd3f2efe 4315 elif isinstance(backgrounds, wx.Colour):
b67a9327
RD
4316 backgrounds = [backgrounds]
4317 elif len(backgrounds) != len(coords):
4318 raise ValueError('backgrounds and coords must have same length')
4319 return self._DrawTextList(textList, coords, foregrounds, backgrounds)
3bcd5e1c 4320
2bf58437
RD
4321 Background = property(GetBackground,SetBackground,doc="See `GetBackground` and `SetBackground`")
4322 BackgroundMode = property(GetBackgroundMode,SetBackgroundMode,doc="See `GetBackgroundMode` and `SetBackgroundMode`")
4323 BoundingBox = property(GetBoundingBox,doc="See `GetBoundingBox`")
4324 Brush = property(GetBrush,SetBrush,doc="See `GetBrush` and `SetBrush`")
4325 CharHeight = property(GetCharHeight,doc="See `GetCharHeight`")
4326 CharWidth = property(GetCharWidth,doc="See `GetCharWidth`")
4327 ClippingBox = property(GetClippingBox,doc="See `GetClippingBox`")
4328 ClippingRect = property(GetClippingRect,SetClippingRect,doc="See `GetClippingRect` and `SetClippingRect`")
4329 Depth = property(GetDepth,doc="See `GetDepth`")
4330 DeviceOrigin = property(GetDeviceOrigin,SetDeviceOrigin,doc="See `GetDeviceOrigin` and `SetDeviceOrigin`")
4331 Font = property(GetFont,SetFont,doc="See `GetFont` and `SetFont`")
4332 FullTextExtent = property(GetFullTextExtent,doc="See `GetFullTextExtent`")
4333 LogicalFunction = property(GetLogicalFunction,SetLogicalFunction,doc="See `GetLogicalFunction` and `SetLogicalFunction`")
4334 LogicalOrigin = property(GetLogicalOrigin,SetLogicalOrigin,doc="See `GetLogicalOrigin` and `SetLogicalOrigin`")
4335 LogicalScale = property(GetLogicalScale,SetLogicalScale,doc="See `GetLogicalScale` and `SetLogicalScale`")
4336 MapMode = property(GetMapMode,SetMapMode,doc="See `GetMapMode` and `SetMapMode`")
4337 MultiLineTextExtent = property(GetMultiLineTextExtent,doc="See `GetMultiLineTextExtent`")
4338 Optimization = property(GetOptimization,SetOptimization,doc="See `GetOptimization` and `SetOptimization`")
4339 PPI = property(GetPPI,doc="See `GetPPI`")
4340 PartialTextExtents = property(GetPartialTextExtents,doc="See `GetPartialTextExtents`")
4341 Pen = property(GetPen,SetPen,doc="See `GetPen` and `SetPen`")
4342 Pixel = property(GetPixel,doc="See `GetPixel`")
4343 PixelPoint = property(GetPixelPoint,doc="See `GetPixelPoint`")
4344 Size = property(GetSize,doc="See `GetSize`")
4345 SizeMM = property(GetSizeMM,doc="See `GetSizeMM`")
4346 TextBackground = property(GetTextBackground,SetTextBackground,doc="See `GetTextBackground` and `SetTextBackground`")
4347 TextExtent = property(GetTextExtent,doc="See `GetTextExtent`")
4348 TextForeground = property(GetTextForeground,SetTextForeground,doc="See `GetTextForeground` and `SetTextForeground`")
4349 UserScale = property(GetUserScale,SetUserScale,doc="See `GetUserScale` and `SetUserScale`")
2131d850 4350_gdi_.DC_swigregister(DC)
70551f47 4351
d14a1e28 4352#---------------------------------------------------------------------------
70551f47 4353
d14a1e28 4354class MemoryDC(DC):
f5b96ee1
RD
4355 """
4356 A memory device context provides a means to draw graphics onto a
4357 bitmap. A bitmap must be selected into the new memory DC before it may
4358 be used for anything. Typical usage is as follows::
4359
4360 dc = wx.MemoryDC()
4361 dc.SelectObject(bitmap)
4362 # draw on the dc usign any of the Draw methods
4363 dc.SelectObject(wx.NullBitmap)
4364 # the bitmap now contains wahtever was drawn upon it
4365
4366 Note that the memory DC *must* be deleted (or the bitmap selected out
4367 of it) before a bitmap can be reselected into another memory DC.
4368
4369 """
0085ce49
RD
4370 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4371 __repr__ = _swig_repr
4372 def __init__(self, *args, **kwargs):
f5b96ee1
RD
4373 """
4374 __init__(self) -> MemoryDC
4375
4376 Constructs a new memory device context.
4377
4378 Use the Ok member to test whether the constructor was successful in
4379 creating a usable device context. Don't forget to select a bitmap into
4380 the DC before drawing on it.
4381 """
0085ce49 4382 _gdi_.MemoryDC_swiginit(self,_gdi_.new_MemoryDC(*args, **kwargs))
e811c8ce 4383 def SelectObject(*args, **kwargs):
f5b96ee1
RD
4384 """
4385 SelectObject(self, Bitmap bitmap)
4386
4387 Selects the bitmap into the device context, to use as the memory
4388 bitmap. Selecting the bitmap into a memory DC allows you to draw into
4389 the DC, and therefore the bitmap, and also to use Blit to copy the
4390 bitmap to a window.
4391
4392 If the argument is wx.NullBitmap (or some other uninitialised
4393 `wx.Bitmap`) the current bitmap is selected out of the device context,
4394 and the original bitmap restored, allowing the current bitmap to be
4395 destroyed safely.
4396 """
54f9ee45 4397 return _gdi_.MemoryDC_SelectObject(*args, **kwargs)
e811c8ce 4398
2131d850 4399_gdi_.MemoryDC_swigregister(MemoryDC)
70551f47 4400
d14a1e28 4401def MemoryDCFromDC(*args, **kwargs):
f5b96ee1
RD
4402 """
4403 MemoryDCFromDC(DC oldDC) -> MemoryDC
4404
4405 Creates a DC that is compatible with the oldDC.
4406 """
54f9ee45 4407 val = _gdi_.new_MemoryDCFromDC(*args, **kwargs)
d14a1e28 4408 return val
70551f47 4409
d14a1e28 4410#---------------------------------------------------------------------------
70551f47 4411
e2950dbb
RD
4412BUFFER_VIRTUAL_AREA = _gdi_.BUFFER_VIRTUAL_AREA
4413BUFFER_CLIENT_AREA = _gdi_.BUFFER_CLIENT_AREA
d14a1e28 4414class BufferedDC(MemoryDC):
f5b96ee1
RD
4415 """
4416 This simple class provides a simple way to avoid flicker: when drawing
4417 on it, everything is in fact first drawn on an in-memory buffer (a
4418 `wx.Bitmap`) and then copied to the screen only once, when this object
4419 is destroyed.
4420
6a223074
RD
4421 It can be used in the same way as any other device context.
4422 wx.BufferedDC itself typically replaces `wx.ClientDC`, if you want to
4423 use it in your EVT_PAINT handler, you should look at
f5b96ee1
RD
4424 `wx.BufferedPaintDC`.
4425
6a223074
RD
4426 Please note that GTK+ 2.0 and OS X provide double buffering themselves
4427 natively so using this class on those platforms will normally result
4428 in an unneeded level of buffering.
4429
f5b96ee1 4430 """
0085ce49
RD
4431 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4432 __repr__ = _swig_repr
4433 def __init__(self, *args):
3adfb63b 4434 """
8f4d7c19 4435 __init__(self, DC dc, Bitmap buffer=NullBitmap, int style=BUFFER_CLIENT_AREA) -> BufferedDC
e2950dbb 4436 __init__(self, DC dc, Size area, int style=BUFFER_CLIENT_AREA) -> BufferedDC
f5b96ee1
RD
4437
4438 Constructs a buffered DC.
3adfb63b 4439 """
0085ce49 4440 _gdi_.BufferedDC_swiginit(self,_gdi_.new_BufferedDC(*args))
f5b96ee1 4441 self.__dc = args[0] # save a ref so the other dc will not be deleted before self
e811c8ce 4442
0085ce49
RD
4443 __swig_destroy__ = _gdi_.delete_BufferedDC
4444 __del__ = lambda self : None;
e811c8ce 4445 def UnMask(*args, **kwargs):
f5b96ee1
RD
4446 """
4447 UnMask(self)
4448
4449 Blits the buffer to the dc, and detaches the dc from the buffer (so it
4450 can be effectively used once only). This is usually only called in
4451 the destructor.
4452 """
54f9ee45 4453 return _gdi_.BufferedDC_UnMask(*args, **kwargs)
e811c8ce 4454
2131d850 4455_gdi_.BufferedDC_swigregister(BufferedDC)
a884bee5 4456
d14a1e28 4457class BufferedPaintDC(BufferedDC):
f5b96ee1
RD
4458 """
4459 This is a subclass of `wx.BufferedDC` which can be used inside of an
4460 EVT_PAINT event handler. Just create an object of this class instead
4461 of `wx.PaintDC` and that's all you have to do to (mostly) avoid
4462 flicker. The only thing to watch out for is that if you are using this
4463 class together with `wx.ScrolledWindow`, you probably do **not** want
4464 to call `wx.Window.PrepareDC` on it as it already does this internally
4465 for the real underlying `wx.PaintDC`.
4466
4467 If your window is already fully buffered in a `wx.Bitmap` then your
4468 EVT_PAINT handler can be as simple as just creating a
4469 ``wx.BufferedPaintDC`` as it will `Blit` the buffer to the window
4470 automatically when it is destroyed. For example::
4471
4472 def OnPaint(self, event):
4473 dc = wx.BufferedPaintDC(self, self.buffer)
4474
4475
4476
e2950dbb
RD
4477
4478
f5b96ee1 4479 """
0085ce49
RD
4480 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4481 __repr__ = _swig_repr
4482 def __init__(self, *args, **kwargs):
f5b96ee1 4483 """
e2950dbb 4484 __init__(self, Window window, Bitmap buffer=NullBitmap, int style=BUFFER_CLIENT_AREA) -> BufferedPaintDC
f5b96ee1
RD
4485
4486 Create a buffered paint DC. As with `wx.BufferedDC`, you may either
4487 provide the bitmap to be used for buffering or let this object create
4488 one internally (in the latter case, the size of the client part of the
4489 window is automatically used).
4490
4491
4492 """
0085ce49 4493 _gdi_.BufferedPaintDC_swiginit(self,_gdi_.new_BufferedPaintDC(*args, **kwargs))
2131d850 4494_gdi_.BufferedPaintDC_swigregister(BufferedPaintDC)
a884bee5 4495
d14a1e28 4496#---------------------------------------------------------------------------
a884bee5 4497
d14a1e28 4498class ScreenDC(DC):
f5b96ee1
RD
4499 """
4500 A wxScreenDC can be used to paint anywhere on the screen. This should
4501 normally be constructed as a temporary stack object; don't store a
4502 wxScreenDC object.
4503
4504 """
0085ce49
RD
4505 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4506 __repr__ = _swig_repr
4507 def __init__(self, *args, **kwargs):
f5b96ee1
RD
4508 """
4509 __init__(self) -> ScreenDC
4510
4511 A wxScreenDC can be used to paint anywhere on the screen. This should
4512 normally be constructed as a temporary stack object; don't store a
4513 wxScreenDC object.
4514
4515 """
0085ce49 4516 _gdi_.ScreenDC_swiginit(self,_gdi_.new_ScreenDC(*args, **kwargs))
e811c8ce 4517 def StartDrawingOnTopWin(*args, **kwargs):
f5b96ee1
RD
4518 """
4519 StartDrawingOnTopWin(self, Window window) -> bool
4520
4521 Specify that the area of the screen to be drawn upon coincides with
4522 the given window.
4523
4524 :see: `EndDrawingOnTop`
4525 """
54f9ee45 4526 return _gdi_.ScreenDC_StartDrawingOnTopWin(*args, **kwargs)
e811c8ce
RD
4527
4528 def StartDrawingOnTop(*args, **kwargs):
f5b96ee1
RD
4529 """
4530 StartDrawingOnTop(self, Rect rect=None) -> bool
4531
4532 Specify that the area is the given rectangle, or the whole screen if
4533 ``None`` is passed.
4534
4535 :see: `EndDrawingOnTop`
4536 """
54f9ee45 4537 return _gdi_.ScreenDC_StartDrawingOnTop(*args, **kwargs)
e811c8ce
RD
4538
4539 def EndDrawingOnTop(*args, **kwargs):
f5b96ee1
RD
4540 """
4541 EndDrawingOnTop(self) -> bool
4542
4543 Use this in conjunction with `StartDrawingOnTop` or
4544 `StartDrawingOnTopWin` to ensure that drawing to the screen occurs on
4545 top of existing windows. Without this, some window systems (such as X)
4546 only allow drawing to take place underneath other windows.
4547
4548 You might use this pair of functions when implementing a drag feature,
4549 for example as in the `wx.SplitterWindow` implementation.
4550
4551 These functions are probably obsolete since the X implementations
4552 allow drawing directly on the screen now. However, the fact that this
4553 function allows the screen to be refreshed afterwards may be useful
4554 to some applications.
4555 """
54f9ee45 4556 return _gdi_.ScreenDC_EndDrawingOnTop(*args, **kwargs)
e811c8ce 4557
2131d850 4558_gdi_.ScreenDC_swigregister(ScreenDC)
70551f47 4559
d14a1e28 4560#---------------------------------------------------------------------------
70551f47 4561
72ef6efb
RD
4562class WindowDC(DC):
4563 """
4564 A wx.WindowDC must be constructed if an application wishes to paint on
4565 the whole area of a window (client and decorations). This should
4566 normally be constructed as a temporary stack object; don't store a
4567 wx.WindowDC object.
4568 """
4569 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4570 __repr__ = _swig_repr
4571 def __init__(self, *args, **kwargs):
4572 """
4573 __init__(self, Window win) -> WindowDC
4574
4575 Constructor. Pass the window on which you wish to paint.
4576 """
4577 _gdi_.WindowDC_swiginit(self,_gdi_.new_WindowDC(*args, **kwargs))
4578_gdi_.WindowDC_swigregister(WindowDC)
4579
4580#---------------------------------------------------------------------------
4581
4582class ClientDC(WindowDC):
f5b96ee1
RD
4583 """
4584 A wx.ClientDC must be constructed if an application wishes to paint on
4585 the client area of a window from outside an EVT_PAINT event. This should
4586 normally be constructed as a temporary stack object; don't store a
4587 wx.ClientDC object long term.
4588
4589 To draw on a window from within an EVT_PAINT handler, construct a
4590 `wx.PaintDC` object.
4591
4592 To draw on the whole window including decorations, construct a
4593 `wx.WindowDC` object (Windows only).
4594
4595 """
0085ce49
RD
4596 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4597 __repr__ = _swig_repr
4598 def __init__(self, *args, **kwargs):
f5b96ee1
RD
4599 """
4600 __init__(self, Window win) -> ClientDC
4601
4602 Constructor. Pass the window on which you wish to paint.
4603 """
0085ce49 4604 _gdi_.ClientDC_swiginit(self,_gdi_.new_ClientDC(*args, **kwargs))
2131d850 4605_gdi_.ClientDC_swigregister(ClientDC)
70551f47 4606
d14a1e28 4607#---------------------------------------------------------------------------
70551f47 4608
72ef6efb 4609class PaintDC(ClientDC):
f5b96ee1
RD
4610 """
4611 A wx.PaintDC must be constructed if an application wishes to paint on
4612 the client area of a window from within an EVT_PAINT event
4613 handler. This should normally be constructed as a temporary stack
4614 object; don't store a wx.PaintDC object. If you have an EVT_PAINT
4615 handler, you **must** create a wx.PaintDC object within it even if you
4616 don't actually use it.
4617
4618 Using wx.PaintDC within EVT_PAINT handlers is important because it
4619 automatically sets the clipping area to the damaged area of the
4620 window. Attempts to draw outside this area do not appear.
4621
4622 To draw on a window from outside EVT_PAINT handlers, construct a
4623 `wx.ClientDC` object.
4624
4625 """
0085ce49
RD
4626 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4627 __repr__ = _swig_repr
4628 def __init__(self, *args, **kwargs):
f5b96ee1
RD
4629 """
4630 __init__(self, Window win) -> PaintDC
4631
4632 Constructor. Pass the window on which you wish to paint.
4633 """
0085ce49 4634 _gdi_.PaintDC_swiginit(self,_gdi_.new_PaintDC(*args, **kwargs))
2131d850 4635_gdi_.PaintDC_swigregister(PaintDC)
70551f47 4636
d14a1e28 4637#---------------------------------------------------------------------------
70551f47 4638
d14a1e28 4639class MirrorDC(DC):
f5b96ee1
RD
4640 """
4641 wx.MirrorDC is a simple wrapper class which is always associated with a
4642 real `wx.DC` object and either forwards all of its operations to it
4643 without changes (no mirroring takes place) or exchanges x and y
4644 coordinates which makes it possible to reuse the same code to draw a
4645 figure and its mirror -- i.e. reflection related to the diagonal line
4646 x == y.
4647 """
0085ce49
RD
4648 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4649 __repr__ = _swig_repr
4650 def __init__(self, *args, **kwargs):
f5b96ee1
RD
4651 """
4652 __init__(self, DC dc, bool mirror) -> MirrorDC
4653
4654 Creates a mirrored DC associated with the real *dc*. Everything drawn
4655 on the wx.MirrorDC will appear on the *dc*, and will be mirrored if
4656 *mirror* is True.
4657 """
0085ce49 4658 _gdi_.MirrorDC_swiginit(self,_gdi_.new_MirrorDC(*args, **kwargs))
2131d850 4659_gdi_.MirrorDC_swigregister(MirrorDC)
3ef86e32 4660
d14a1e28 4661#---------------------------------------------------------------------------
3ef86e32 4662
d14a1e28 4663class PostScriptDC(DC):
f5b96ee1 4664 """This is a `wx.DC` that can write to PostScript files on any platform."""
0085ce49
RD
4665 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4666 __repr__ = _swig_repr
4667 def __init__(self, *args, **kwargs):
f5b96ee1
RD
4668 """
4669 __init__(self, wxPrintData printData) -> PostScriptDC
4670
4671 Constructs a PostScript printer device context from a `wx.PrintData`
4672 object.
4673 """
0085ce49 4674 _gdi_.PostScriptDC_swiginit(self,_gdi_.new_PostScriptDC(*args, **kwargs))
e811c8ce 4675 def GetPrintData(*args, **kwargs):
a95a7133 4676 """GetPrintData(self) -> wxPrintData"""
54f9ee45 4677 return _gdi_.PostScriptDC_GetPrintData(*args, **kwargs)
e811c8ce
RD
4678
4679 def SetPrintData(*args, **kwargs):
a95a7133 4680 """SetPrintData(self, wxPrintData data)"""
54f9ee45 4681 return _gdi_.PostScriptDC_SetPrintData(*args, **kwargs)
e811c8ce
RD
4682
4683 def SetResolution(*args, **kwargs):
f5b96ee1
RD
4684 """
4685 SetResolution(int ppi)
4686
4687 Set resolution (in pixels per inch) that will be used in PostScript
4688 output. Default is 720ppi.
4689 """
54f9ee45 4690 return _gdi_.PostScriptDC_SetResolution(*args, **kwargs)
e811c8ce
RD
4691
4692 SetResolution = staticmethod(SetResolution)
4693 def GetResolution(*args, **kwargs):
f5b96ee1
RD
4694 """
4695 GetResolution() -> int
4696
4697 Return resolution used in PostScript output.
4698 """
54f9ee45 4699 return _gdi_.PostScriptDC_GetResolution(*args, **kwargs)
e811c8ce
RD
4700
4701 GetResolution = staticmethod(GetResolution)
33d6fd3b 4702 PrintData = property(GetPrintData,SetPrintData,doc="See `GetPrintData` and `SetPrintData`")
2131d850 4703_gdi_.PostScriptDC_swigregister(PostScriptDC)
105e45b9 4704
e811c8ce 4705def PostScriptDC_SetResolution(*args, **kwargs):
0085ce49 4706 """
f5b96ee1
RD
4707 PostScriptDC_SetResolution(int ppi)
4708
4709 Set resolution (in pixels per inch) that will be used in PostScript
4710 output. Default is 720ppi.
4711 """
0085ce49 4712 return _gdi_.PostScriptDC_SetResolution(*args, **kwargs)
105e45b9 4713
0085ce49
RD
4714def PostScriptDC_GetResolution(*args):
4715 """
f5b96ee1
RD
4716 PostScriptDC_GetResolution() -> int
4717
4718 Return resolution used in PostScript output.
4719 """
0085ce49 4720 return _gdi_.PostScriptDC_GetResolution(*args)
105e45b9 4721
d14a1e28 4722#---------------------------------------------------------------------------
105e45b9 4723
54f9ee45 4724class MetaFile(_core.Object):
093d3ff1 4725 """Proxy of C++ MetaFile class"""
0085ce49
RD
4726 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4727 __repr__ = _swig_repr
4728 def __init__(self, *args, **kwargs):
a95a7133 4729 """__init__(self, String filename=EmptyString) -> MetaFile"""
0085ce49 4730 _gdi_.MetaFile_swiginit(self,_gdi_.new_MetaFile(*args, **kwargs))
2131d850 4731_gdi_.MetaFile_swigregister(MetaFile)
d14a1e28
RD
4732
4733class MetaFileDC(DC):
093d3ff1 4734 """Proxy of C++ MetaFileDC class"""
0085ce49
RD
4735 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4736 __repr__ = _swig_repr
4737 def __init__(self, *args, **kwargs):
0df68c9f 4738 """
a95a7133 4739 __init__(self, String filename=EmptyString, int width=0, int height=0,
196addbf 4740 String description=EmptyString) -> MetaFileDC
0df68c9f 4741 """
0085ce49 4742 _gdi_.MetaFileDC_swiginit(self,_gdi_.new_MetaFileDC(*args, **kwargs))
2131d850 4743_gdi_.MetaFileDC_swigregister(MetaFileDC)
d14a1e28
RD
4744
4745class PrinterDC(DC):
093d3ff1 4746 """Proxy of C++ PrinterDC class"""
0085ce49
RD
4747 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4748 __repr__ = _swig_repr
4749 def __init__(self, *args, **kwargs):
a95a7133 4750 """__init__(self, wxPrintData printData) -> PrinterDC"""
0085ce49 4751 _gdi_.PrinterDC_swiginit(self,_gdi_.new_PrinterDC(*args, **kwargs))
2131d850 4752_gdi_.PrinterDC_swigregister(PrinterDC)
d14a1e28
RD
4753
4754#---------------------------------------------------------------------------
4755
72ef6efb
RD
4756class GraphicsPath(object):
4757 """Proxy of C++ GraphicsPath class"""
4758 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4759 def __init__(self): raise AttributeError, "No constructor defined"
4760 __repr__ = _swig_repr
4761 __swig_destroy__ = _gdi_.delete_GraphicsPath
4762 __del__ = lambda self : None;
4763 def MoveToPoint(*args, **kwargs):
4764 """
4765 MoveToPoint(self, Double x, Double y)
4766
4767 Begins a new subpath at (x,y)
4768 """
4769 return _gdi_.GraphicsPath_MoveToPoint(*args, **kwargs)
4770
4771 def AddLineToPoint(*args, **kwargs):
4772 """
4773 AddLineToPoint(self, Double x, Double y)
4774
4775 Adds a straight line from the current point to (x,y)
4776 """
4777 return _gdi_.GraphicsPath_AddLineToPoint(*args, **kwargs)
4778
4779 def AddCurveToPoint(*args, **kwargs):
4780 """
4781 AddCurveToPoint(self, Double cx1, Double cy1, Double cx2, Double cy2, Double x,
4782 Double y)
4783
4784 Adds a cubic Bezier curve from the current point, using two control
4785 points and an end point
4786 """
4787 return _gdi_.GraphicsPath_AddCurveToPoint(*args, **kwargs)
4788
4789 def CloseSubpath(*args, **kwargs):
4790 """
4791 CloseSubpath(self)
4792
4793 closes the current sub-path
4794 """
4795 return _gdi_.GraphicsPath_CloseSubpath(*args, **kwargs)
4796
4797 def GetCurrentPoint(*args, **kwargs):
4798 """
4799 GetCurrentPoint(self) -> Point2D
4800
4801 Gets the last point of the current path, (0,0) if not yet set
4802 """
4803 return _gdi_.GraphicsPath_GetCurrentPoint(*args, **kwargs)
4804
4805 def AddArc(*args, **kwargs):
4806 """
4807 AddArc(self, Double x, Double y, Double r, Double startAngle, Double endAngle,
4808 bool clockwise)
4809
4810 Adds an arc of a circle centering at (x,y) with radius (r) from
4811 startAngle to endAngle
4812 """
4813 return _gdi_.GraphicsPath_AddArc(*args, **kwargs)
4814
4815 def AddQuadCurveToPoint(*args, **kwargs):
4816 """
4817 AddQuadCurveToPoint(self, Double cx, Double cy, Double x, Double y)
4818
4819 Adds a quadratic Bezier curve from the current point, using a control
4820 point and an end point
4821 """
4822 return _gdi_.GraphicsPath_AddQuadCurveToPoint(*args, **kwargs)
4823
4824 def AddRectangle(*args, **kwargs):
4825 """
4826 AddRectangle(self, Double x, Double y, Double w, Double h)
4827
4828 Appends a rectangle as a new closed subpath
4829 """
4830 return _gdi_.GraphicsPath_AddRectangle(*args, **kwargs)
4831
4832 def AddCircle(*args, **kwargs):
4833 """
4834 AddCircle(self, Double x, Double y, Double r)
4835
4836 Appends an ellipsis as a new closed subpath fitting the passed rectangle
4837 """
4838 return _gdi_.GraphicsPath_AddCircle(*args, **kwargs)
4839
4840 def AddArcToPoint(*args, **kwargs):
4841 """
4842 AddArcToPoint(self, Double x1, Double y1, Double x2, Double y2, Double r)
4843
4844 Draws a an arc to two tangents connecting (current) to (x1,y1) and (x1,y1)
4845 to (x2,y2), also a straight line from (current) to (x1,y1)
4846 """
4847 return _gdi_.GraphicsPath_AddArcToPoint(*args, **kwargs)
4848
4849_gdi_.GraphicsPath_swigregister(GraphicsPath)
4850
4851class GraphicsContext(object):
4852 """Proxy of C++ GraphicsContext class"""
4853 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4854 def __init__(self): raise AttributeError, "No constructor defined"
4855 __repr__ = _swig_repr
4856 __swig_destroy__ = _gdi_.delete_GraphicsContext
4857 __del__ = lambda self : None;
4858 def Create(*args, **kwargs):
4859 """Create(WindowDC dc) -> GraphicsContext"""
4860 val = _gdi_.GraphicsContext_Create(*args, **kwargs)
4861 val.__dc = args[0] # save a ref so the other dc will not be deleted before self
4862 return val
4863
4864 Create = staticmethod(Create)
4865 def CreatePath(*args, **kwargs):
4866 """CreatePath(self) -> GraphicsPath"""
4867 return _gdi_.GraphicsContext_CreatePath(*args, **kwargs)
4868
4869 def PushState(*args, **kwargs):
4870 """PushState(self)"""
4871 return _gdi_.GraphicsContext_PushState(*args, **kwargs)
4872
4873 def PopState(*args, **kwargs):
4874 """PopState(self)"""
4875 return _gdi_.GraphicsContext_PopState(*args, **kwargs)
4876
4877 def Clip(*args, **kwargs):
4878 """Clip(self, Region region)"""
4879 return _gdi_.GraphicsContext_Clip(*args, **kwargs)
4880
4881 def Translate(*args, **kwargs):
4882 """Translate(self, Double dx, Double dy)"""
4883 return _gdi_.GraphicsContext_Translate(*args, **kwargs)
4884
4885 def Scale(*args, **kwargs):
4886 """Scale(self, Double xScale, Double yScale)"""
4887 return _gdi_.GraphicsContext_Scale(*args, **kwargs)
4888
4889 def Rotate(*args, **kwargs):
4890 """Rotate(self, Double angle)"""
4891 return _gdi_.GraphicsContext_Rotate(*args, **kwargs)
4892
4893 def SetPen(*args, **kwargs):
4894 """SetPen(self, Pen pen)"""
4895 return _gdi_.GraphicsContext_SetPen(*args, **kwargs)
4896
4897 def SetBrush(*args, **kwargs):
4898 """SetBrush(self, Brush brush)"""
4899 return _gdi_.GraphicsContext_SetBrush(*args, **kwargs)
4900
4901 def SetLinearGradientBrush(*args, **kwargs):
4902 """
4903 SetLinearGradientBrush(self, Double x1, Double y1, Double x2, Double y2, Colour c1,
4904 Colour c2)
4905 """
4906 return _gdi_.GraphicsContext_SetLinearGradientBrush(*args, **kwargs)
4907
4908 def SetRadialGradientBrush(*args, **kwargs):
4909 """
4910 SetRadialGradientBrush(self, Double xo, Double yo, Double xc, Double yc, Double radius,
4911 Colour oColor, Colour cColor)
4912 """
4913 return _gdi_.GraphicsContext_SetRadialGradientBrush(*args, **kwargs)
4914
4915 def SetFont(*args, **kwargs):
4916 """SetFont(self, Font font)"""
4917 return _gdi_.GraphicsContext_SetFont(*args, **kwargs)
4918
4919 def SetTextColor(*args, **kwargs):
4920 """SetTextColor(self, Colour col)"""
4921 return _gdi_.GraphicsContext_SetTextColor(*args, **kwargs)
4922
4923 def StrokePath(*args, **kwargs):
4924 """StrokePath(self, GraphicsPath path)"""
4925 return _gdi_.GraphicsContext_StrokePath(*args, **kwargs)
4926
4927 def FillPath(*args, **kwargs):
4928 """FillPath(self, GraphicsPath path, int fillStyle=WINDING_RULE)"""
4929 return _gdi_.GraphicsContext_FillPath(*args, **kwargs)
4930
4931 def DrawPath(*args, **kwargs):
4932 """DrawPath(self, GraphicsPath path, int fillStyle=WINDING_RULE)"""
4933 return _gdi_.GraphicsContext_DrawPath(*args, **kwargs)
4934
4935 def DrawText(*args):
4936 """
4937 DrawText(self, String str, Double x, Double y)
4938 DrawText(self, String str, Double x, Double y, Double angle)
4939 """
4940 return _gdi_.GraphicsContext_DrawText(*args)
4941
4942 def GetTextExtent(*args, **kwargs):
4943 """
4944 GetTextExtent(self, String text, Double OUTPUT, Double OUTPUT, Double OUTPUT,
4945 Double OUTPUT)
4946 """
4947 return _gdi_.GraphicsContext_GetTextExtent(*args, **kwargs)
4948
4949 def GetPartialTextExtents(*args, **kwargs):
4950 """GetPartialTextExtents(self, String text, wxArrayDouble widths)"""
4951 return _gdi_.GraphicsContext_GetPartialTextExtents(*args, **kwargs)
4952
4953 def DrawBitmap(*args, **kwargs):
4954 """DrawBitmap(self, Bitmap bmp, Double x, Double y, Double w, Double h)"""
4955 return _gdi_.GraphicsContext_DrawBitmap(*args, **kwargs)
4956
4957 def DrawIcon(*args, **kwargs):
4958 """DrawIcon(self, Icon icon, Double x, Double y, Double w, Double h)"""
4959 return _gdi_.GraphicsContext_DrawIcon(*args, **kwargs)
4960
4961 def StrokeLine(*args, **kwargs):
4962 """StrokeLine(self, Double x1, Double y1, Double x2, Double y2)"""
4963 return _gdi_.GraphicsContext_StrokeLine(*args, **kwargs)
4964
4965 def StrokeLines(*args):
4966 """
4967 StrokeLines(self, size_t n, Point2D points)
4968 StrokeLines(self, size_t n, Point2D beginPoints, Point2D endPoints)
4969 """
4970 return _gdi_.GraphicsContext_StrokeLines(*args)
4971
4972 def DrawLines(*args, **kwargs):
4973 """DrawLines(self, size_t n, Point2D points, int fillStyle=WINDING_RULE)"""
4974 return _gdi_.GraphicsContext_DrawLines(*args, **kwargs)
4975
4976 def DrawRectangle(*args, **kwargs):
4977 """DrawRectangle(self, Double x, Double y, Double w, Double h)"""
4978 return _gdi_.GraphicsContext_DrawRectangle(*args, **kwargs)
4979
4980 def DrawEllipse(*args, **kwargs):
4981 """DrawEllipse(self, Double x, Double y, Double w, Double h)"""
4982 return _gdi_.GraphicsContext_DrawEllipse(*args, **kwargs)
4983
4984 def DrawRoundedRectangle(*args, **kwargs):
4985 """DrawRoundedRectangle(self, Double x, Double y, Double w, Double h, Double radius)"""
4986 return _gdi_.GraphicsContext_DrawRoundedRectangle(*args, **kwargs)
4987
4988_gdi_.GraphicsContext_swigregister(GraphicsContext)
4989
4990def GraphicsContext_Create(*args, **kwargs):
4991 """GraphicsContext_Create(WindowDC dc) -> GraphicsContext"""
4992 val = _gdi_.GraphicsContext_Create(*args, **kwargs)
4993 val.__dc = args[0] # save a ref so the other dc will not be deleted before self
4994 return val
4995
4996class GCDC(DC):
4997 """Proxy of C++ GCDC class"""
4998 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
4999 __repr__ = _swig_repr
5000 def __init__(self, *args, **kwargs):
5001 """__init__(self, WindowDC dc) -> GCDC"""
5002 _gdi_.GCDC_swiginit(self,_gdi_.new_GCDC(*args, **kwargs))
5003 self.__dc = args[0] # save a ref so the other dc will not be deleted before self
5004
5005 __swig_destroy__ = _gdi_.delete_GCDC
5006 __del__ = lambda self : None;
5007 def GetGraphicContext(*args, **kwargs):
5008 """GetGraphicContext(self) -> GraphicsContext"""
5009 return _gdi_.GCDC_GetGraphicContext(*args, **kwargs)
5010
5011_gdi_.GCDC_swigregister(GCDC)
5012
5013#---------------------------------------------------------------------------
5014
54f9ee45
RD
5015IMAGELIST_DRAW_NORMAL = _gdi_.IMAGELIST_DRAW_NORMAL
5016IMAGELIST_DRAW_TRANSPARENT = _gdi_.IMAGELIST_DRAW_TRANSPARENT
5017IMAGELIST_DRAW_SELECTED = _gdi_.IMAGELIST_DRAW_SELECTED
5018IMAGELIST_DRAW_FOCUSED = _gdi_.IMAGELIST_DRAW_FOCUSED
5019IMAGE_LIST_NORMAL = _gdi_.IMAGE_LIST_NORMAL
5020IMAGE_LIST_SMALL = _gdi_.IMAGE_LIST_SMALL
5021IMAGE_LIST_STATE = _gdi_.IMAGE_LIST_STATE
5022class ImageList(_core.Object):
093d3ff1 5023 """Proxy of C++ ImageList class"""
0085ce49
RD
5024 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5025 __repr__ = _swig_repr
5026 def __init__(self, *args, **kwargs):
a95a7133 5027 """__init__(self, int width, int height, int mask=True, int initialCount=1) -> ImageList"""
0085ce49
RD
5028 _gdi_.ImageList_swiginit(self,_gdi_.new_ImageList(*args, **kwargs))
5029 __swig_destroy__ = _gdi_.delete_ImageList
5030 __del__ = lambda self : None;
e811c8ce 5031 def Add(*args, **kwargs):
a95a7133 5032 """Add(self, Bitmap bitmap, Bitmap mask=NullBitmap) -> int"""
54f9ee45 5033 return _gdi_.ImageList_Add(*args, **kwargs)
e811c8ce
RD
5034
5035 def AddWithColourMask(*args, **kwargs):
a95a7133 5036 """AddWithColourMask(self, Bitmap bitmap, Colour maskColour) -> int"""
54f9ee45 5037 return _gdi_.ImageList_AddWithColourMask(*args, **kwargs)
e811c8ce
RD
5038
5039 def AddIcon(*args, **kwargs):
a95a7133 5040 """AddIcon(self, Icon icon) -> int"""
54f9ee45 5041 return _gdi_.ImageList_AddIcon(*args, **kwargs)
e811c8ce 5042
b9d6a5f3
RD
5043 def GetBitmap(*args, **kwargs):
5044 """GetBitmap(self, int index) -> Bitmap"""
5045 return _gdi_.ImageList_GetBitmap(*args, **kwargs)
5046
5047 def GetIcon(*args, **kwargs):
5048 """GetIcon(self, int index) -> Icon"""
5049 return _gdi_.ImageList_GetIcon(*args, **kwargs)
5050
e811c8ce 5051 def Replace(*args, **kwargs):
01f6b6d3 5052 """Replace(self, int index, Bitmap bitmap, Bitmap mask=NullBitmap) -> bool"""
54f9ee45 5053 return _gdi_.ImageList_Replace(*args, **kwargs)
e811c8ce
RD
5054
5055 def Draw(*args, **kwargs):
0df68c9f 5056 """
a95a7133 5057 Draw(self, int index, DC dc, int x, int x, int flags=IMAGELIST_DRAW_NORMAL,
0df68c9f
RD
5058 bool solidBackground=False) -> bool
5059 """
54f9ee45 5060 return _gdi_.ImageList_Draw(*args, **kwargs)
e811c8ce
RD
5061
5062 def GetImageCount(*args, **kwargs):
a95a7133 5063 """GetImageCount(self) -> int"""
54f9ee45 5064 return _gdi_.ImageList_GetImageCount(*args, **kwargs)
e811c8ce
RD
5065
5066 def Remove(*args, **kwargs):
a95a7133 5067 """Remove(self, int index) -> bool"""
54f9ee45 5068 return _gdi_.ImageList_Remove(*args, **kwargs)
e811c8ce
RD
5069
5070 def RemoveAll(*args, **kwargs):
a95a7133 5071 """RemoveAll(self) -> bool"""
54f9ee45 5072 return _gdi_.ImageList_RemoveAll(*args, **kwargs)
e811c8ce
RD
5073
5074 def GetSize(*args, **kwargs):
b850e7f3 5075 """GetSize(index) -> (width,height)"""
54f9ee45 5076 return _gdi_.ImageList_GetSize(*args, **kwargs)
e811c8ce 5077
97ab0f6a
RD
5078 ImageCount = property(GetImageCount,doc="See `GetImageCount`")
5079 Size = property(GetSize,doc="See `GetSize`")
2131d850 5080_gdi_.ImageList_swigregister(ImageList)
d14a1e28
RD
5081
5082#---------------------------------------------------------------------------
5083
50efceee
RD
5084class StockGDI(object):
5085 """Proxy of C++ StockGDI class"""
0085ce49 5086 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
0085ce49 5087 __repr__ = _swig_repr
50efceee
RD
5088 BRUSH_BLACK = _gdi_.StockGDI_BRUSH_BLACK
5089 BRUSH_BLUE = _gdi_.StockGDI_BRUSH_BLUE
5090 BRUSH_CYAN = _gdi_.StockGDI_BRUSH_CYAN
5091 BRUSH_GREEN = _gdi_.StockGDI_BRUSH_GREEN
5092 BRUSH_GREY = _gdi_.StockGDI_BRUSH_GREY
5093 BRUSH_LIGHTGREY = _gdi_.StockGDI_BRUSH_LIGHTGREY
5094 BRUSH_MEDIUMGREY = _gdi_.StockGDI_BRUSH_MEDIUMGREY
5095 BRUSH_RED = _gdi_.StockGDI_BRUSH_RED
5096 BRUSH_TRANSPARENT = _gdi_.StockGDI_BRUSH_TRANSPARENT
5097 BRUSH_WHITE = _gdi_.StockGDI_BRUSH_WHITE
5098 COLOUR_BLACK = _gdi_.StockGDI_COLOUR_BLACK
5099 COLOUR_BLUE = _gdi_.StockGDI_COLOUR_BLUE
5100 COLOUR_CYAN = _gdi_.StockGDI_COLOUR_CYAN
5101 COLOUR_GREEN = _gdi_.StockGDI_COLOUR_GREEN
5102 COLOUR_LIGHTGREY = _gdi_.StockGDI_COLOUR_LIGHTGREY
5103 COLOUR_RED = _gdi_.StockGDI_COLOUR_RED
5104 COLOUR_WHITE = _gdi_.StockGDI_COLOUR_WHITE
5105 CURSOR_CROSS = _gdi_.StockGDI_CURSOR_CROSS
5106 CURSOR_HOURGLASS = _gdi_.StockGDI_CURSOR_HOURGLASS
5107 CURSOR_STANDARD = _gdi_.StockGDI_CURSOR_STANDARD
5108 FONT_ITALIC = _gdi_.StockGDI_FONT_ITALIC
5109 FONT_NORMAL = _gdi_.StockGDI_FONT_NORMAL
5110 FONT_SMALL = _gdi_.StockGDI_FONT_SMALL
5111 FONT_SWISS = _gdi_.StockGDI_FONT_SWISS
5112 PEN_BLACK = _gdi_.StockGDI_PEN_BLACK
5113 PEN_BLACKDASHED = _gdi_.StockGDI_PEN_BLACKDASHED
5114 PEN_CYAN = _gdi_.StockGDI_PEN_CYAN
5115 PEN_GREEN = _gdi_.StockGDI_PEN_GREEN
5116 PEN_GREY = _gdi_.StockGDI_PEN_GREY
5117 PEN_LIGHTGREY = _gdi_.StockGDI_PEN_LIGHTGREY
5118 PEN_MEDIUMGREY = _gdi_.StockGDI_PEN_MEDIUMGREY
5119 PEN_RED = _gdi_.StockGDI_PEN_RED
5120 PEN_TRANSPARENT = _gdi_.StockGDI_PEN_TRANSPARENT
5121 PEN_WHITE = _gdi_.StockGDI_PEN_WHITE
5122 ITEMCOUNT = _gdi_.StockGDI_ITEMCOUNT
5123 def __init__(self, *args, **kwargs):
5124 """__init__(self) -> StockGDI"""
5125 _gdi_.StockGDI_swiginit(self,_gdi_.new_StockGDI(*args, **kwargs))
5126 __swig_destroy__ = _gdi_.delete_StockGDI
5127 __del__ = lambda self : None;
5128 def DeleteAll(*args, **kwargs):
5129 """DeleteAll()"""
5130 return _gdi_.StockGDI_DeleteAll(*args, **kwargs)
e811c8ce 5131
50efceee
RD
5132 DeleteAll = staticmethod(DeleteAll)
5133 def instance(*args, **kwargs):
5134 """instance() -> StockGDI"""
5135 return _gdi_.StockGDI_instance(*args, **kwargs)
e811c8ce 5136
50efceee
RD
5137 instance = staticmethod(instance)
5138 def GetBrush(*args, **kwargs):
5139 """GetBrush(int item) -> Brush"""
5140 return _gdi_.StockGDI_GetBrush(*args, **kwargs)
e811c8ce 5141
50efceee
RD
5142 GetBrush = staticmethod(GetBrush)
5143 def GetColour(*args, **kwargs):
5144 """GetColour(int item) -> Colour"""
5145 return _gdi_.StockGDI_GetColour(*args, **kwargs)
e811c8ce 5146
50efceee
RD
5147 GetColour = staticmethod(GetColour)
5148 def GetCursor(*args, **kwargs):
5149 """GetCursor(int item) -> Cursor"""
5150 return _gdi_.StockGDI_GetCursor(*args, **kwargs)
5151
5152 GetCursor = staticmethod(GetCursor)
5153 def GetPen(*args, **kwargs):
5154 """GetPen(int item) -> Pen"""
5155 return _gdi_.StockGDI_GetPen(*args, **kwargs)
5156
5157 GetPen = staticmethod(GetPen)
5158 def GetFont(*args, **kwargs):
5159 """GetFont(self, int item) -> Font"""
5160 return _gdi_.StockGDI_GetFont(*args, **kwargs)
5161
01f6b6d3
RD
5162 def _initStockObjects():
5163 import wx
704eda0c
RD
5164 wx.ITALIC_FONT.this = StockGDI.instance().GetFont(StockGDI.FONT_ITALIC).this
5165 wx.NORMAL_FONT.this = StockGDI.instance().GetFont(StockGDI.FONT_NORMAL).this
5166 wx.SMALL_FONT.this = StockGDI.instance().GetFont(StockGDI.FONT_SMALL).this
5167 wx.SWISS_FONT.this = StockGDI.instance().GetFont(StockGDI.FONT_SWISS).this
01f6b6d3 5168
704eda0c
RD
5169 wx.BLACK_DASHED_PEN.this = StockGDI.GetPen(StockGDI.PEN_BLACKDASHED).this
5170 wx.BLACK_PEN.this = StockGDI.GetPen(StockGDI.PEN_BLACK).this
5171 wx.CYAN_PEN.this = StockGDI.GetPen(StockGDI.PEN_CYAN).this
5172 wx.GREEN_PEN.this = StockGDI.GetPen(StockGDI.PEN_GREEN).this
5173 wx.GREY_PEN.this = StockGDI.GetPen(StockGDI.PEN_GREY).this
5174 wx.LIGHT_GREY_PEN.this = StockGDI.GetPen(StockGDI.PEN_LIGHTGREY).this
5175 wx.MEDIUM_GREY_PEN.this = StockGDI.GetPen(StockGDI.PEN_MEDIUMGREY).this
5176 wx.RED_PEN.this = StockGDI.GetPen(StockGDI.PEN_RED).this
5177 wx.TRANSPARENT_PEN.this = StockGDI.GetPen(StockGDI.PEN_TRANSPARENT).this
5178 wx.WHITE_PEN.this = StockGDI.GetPen(StockGDI.PEN_WHITE).this
5179
5180 wx.BLACK_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_BLACK).this
5181 wx.BLUE_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_BLUE).this
5182 wx.CYAN_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_CYAN).this
5183 wx.GREEN_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_GREEN).this
5184 wx.GREY_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_GREY).this
5185 wx.LIGHT_GREY_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_LIGHTGREY).this
5186 wx.MEDIUM_GREY_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_MEDIUMGREY).this
5187 wx.RED_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_RED).this
5188 wx.TRANSPARENT_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_TRANSPARENT).this
5189 wx.WHITE_BRUSH.this = StockGDI.GetBrush(StockGDI.BRUSH_WHITE).this
5190
5191 wx.BLACK.this = StockGDI.GetColour(StockGDI.COLOUR_BLACK).this
5192 wx.BLUE.this = StockGDI.GetColour(StockGDI.COLOUR_BLUE).this
5193 wx.CYAN.this = StockGDI.GetColour(StockGDI.COLOUR_CYAN).this
5194 wx.GREEN.this = StockGDI.GetColour(StockGDI.COLOUR_GREEN).this
5195 wx.LIGHT_GREY.this = StockGDI.GetColour(StockGDI.COLOUR_LIGHTGREY).this
5196 wx.RED.this = StockGDI.GetColour(StockGDI.COLOUR_RED).this
5197 wx.WHITE.this = StockGDI.GetColour(StockGDI.COLOUR_WHITE).this
5198
5199 wx.CROSS_CURSOR.this = StockGDI.GetCursor(StockGDI.CURSOR_CROSS).this
5200 wx.HOURGLASS_CURSOR.this = StockGDI.GetCursor(StockGDI.CURSOR_HOURGLASS).this
5201 wx.STANDARD_CURSOR.this = StockGDI.GetCursor(StockGDI.CURSOR_STANDARD).this
5202
5203 wx.TheFontList.this = _wxPyInitTheFontList().this
5204 wx.ThePenList.this = _wxPyInitThePenList().this
5205 wx.TheBrushList.this = _wxPyInitTheBrushList().this
5206 wx.TheColourDatabase.this = _wxPyInitTheColourDatabase().this
5207
01f6b6d3
RD
5208
5209 _initStockObjects = staticmethod(_initStockObjects)
5210
2131d850 5211_gdi_.StockGDI_swigregister(StockGDI)
50efceee
RD
5212
5213def StockGDI_DeleteAll(*args):
5214 """StockGDI_DeleteAll()"""
5215 return _gdi_.StockGDI_DeleteAll(*args)
5216
5217def StockGDI_instance(*args):
5218 """StockGDI_instance() -> StockGDI"""
5219 return _gdi_.StockGDI_instance(*args)
5220
5221def StockGDI_GetBrush(*args, **kwargs):
5222 """StockGDI_GetBrush(int item) -> Brush"""
5223 return _gdi_.StockGDI_GetBrush(*args, **kwargs)
5224
5225def StockGDI_GetColour(*args, **kwargs):
5226 """StockGDI_GetColour(int item) -> Colour"""
5227 return _gdi_.StockGDI_GetColour(*args, **kwargs)
5228
5229def StockGDI_GetCursor(*args, **kwargs):
5230 """StockGDI_GetCursor(int item) -> Cursor"""
5231 return _gdi_.StockGDI_GetCursor(*args, **kwargs)
5232
5233def StockGDI_GetPen(*args, **kwargs):
5234 """StockGDI_GetPen(int item) -> Pen"""
5235 return _gdi_.StockGDI_GetPen(*args, **kwargs)
5236
704eda0c
RD
5237# Create an uninitialized instance for the stock objects, they will
5238# be initialized later when the wx.App object is created.
5239ITALIC_FONT = Font.__new__(Font)
5240NORMAL_FONT = Font.__new__(Font)
5241SMALL_FONT = Font.__new__(Font)
5242SWISS_FONT = Font.__new__(Font)
5243
5244BLACK_DASHED_PEN = Pen.__new__(Pen)
5245BLACK_PEN = Pen.__new__(Pen)
5246CYAN_PEN = Pen.__new__(Pen)
5247GREEN_PEN = Pen.__new__(Pen)
5248GREY_PEN = Pen.__new__(Pen)
5249LIGHT_GREY_PEN = Pen.__new__(Pen)
5250MEDIUM_GREY_PEN = Pen.__new__(Pen)
5251RED_PEN = Pen.__new__(Pen)
5252TRANSPARENT_PEN = Pen.__new__(Pen)
5253WHITE_PEN = Pen.__new__(Pen)
5254
5255BLACK_BRUSH = Brush.__new__(Brush)
5256BLUE_BRUSH = Brush.__new__(Brush)
5257CYAN_BRUSH = Brush.__new__(Brush)
5258GREEN_BRUSH = Brush.__new__(Brush)
5259GREY_BRUSH = Brush.__new__(Brush)
5260LIGHT_GREY_BRUSH = Brush.__new__(Brush)
5261MEDIUM_GREY_BRUSH = Brush.__new__(Brush)
5262RED_BRUSH = Brush.__new__(Brush)
5263TRANSPARENT_BRUSH = Brush.__new__(Brush)
5264WHITE_BRUSH = Brush.__new__(Brush)
5265
5266BLACK = Colour.__new__(Colour)
5267BLUE = Colour.__new__(Colour)
5268CYAN = Colour.__new__(Colour)
5269GREEN = Colour.__new__(Colour)
5270LIGHT_GREY = Colour.__new__(Colour)
5271RED = Colour.__new__(Colour)
5272WHITE = Colour.__new__(Colour)
5273
5274CROSS_CURSOR = Cursor.__new__(Cursor)
5275HOURGLASS_CURSOR = Cursor.__new__(Cursor)
5276STANDARD_CURSOR = Cursor.__new__(Cursor)
5277
50efceee
RD
5278class GDIObjListBase(object):
5279 """Proxy of C++ GDIObjListBase class"""
5280 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5281 __repr__ = _swig_repr
5282 def __init__(self, *args, **kwargs):
5283 """__init__(self) -> GDIObjListBase"""
5284 _gdi_.GDIObjListBase_swiginit(self,_gdi_.new_GDIObjListBase(*args, **kwargs))
5285 __swig_destroy__ = _gdi_.delete_GDIObjListBase
5286 __del__ = lambda self : None;
2131d850 5287_gdi_.GDIObjListBase_swigregister(GDIObjListBase)
54f9ee45 5288cvar = _gdi_.cvar
994141e6
RD
5289NullBitmap = cvar.NullBitmap
5290NullIcon = cvar.NullIcon
5291NullCursor = cvar.NullCursor
5292NullPen = cvar.NullPen
5293NullBrush = cvar.NullBrush
5294NullPalette = cvar.NullPalette
5295NullFont = cvar.NullFont
5296NullColour = cvar.NullColour
d14a1e28 5297
50efceee
RD
5298class PenList(GDIObjListBase):
5299 """Proxy of C++ PenList class"""
0085ce49
RD
5300 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5301 def __init__(self): raise AttributeError, "No constructor defined"
5302 __repr__ = _swig_repr
50efceee
RD
5303 def FindOrCreatePen(*args, **kwargs):
5304 """FindOrCreatePen(self, Colour colour, int width, int style) -> Pen"""
5305 return _gdi_.PenList_FindOrCreatePen(*args, **kwargs)
5306
5307 def AddPen(*args, **kwargs):
5308 """AddPen(self, Pen pen)"""
5309 return _gdi_.PenList_AddPen(*args, **kwargs)
e811c8ce 5310
50efceee
RD
5311 def RemovePen(*args, **kwargs):
5312 """RemovePen(self, Pen pen)"""
5313 return _gdi_.PenList_RemovePen(*args, **kwargs)
5314
5315 AddPen = wx._deprecated(AddPen)
5316 RemovePen = wx._deprecated(RemovePen)
5317
2131d850 5318_gdi_.PenList_swigregister(PenList)
50efceee
RD
5319
5320class BrushList(GDIObjListBase):
5321 """Proxy of C++ BrushList class"""
5322 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5323 def __init__(self): raise AttributeError, "No constructor defined"
5324 __repr__ = _swig_repr
e811c8ce 5325 def FindOrCreateBrush(*args, **kwargs):
61d07ac7 5326 """FindOrCreateBrush(self, Colour colour, int style=SOLID) -> Brush"""
54f9ee45 5327 return _gdi_.BrushList_FindOrCreateBrush(*args, **kwargs)
e811c8ce 5328
50efceee
RD
5329 def AddBrush(*args, **kwargs):
5330 """AddBrush(self, Brush brush)"""
5331 return _gdi_.BrushList_AddBrush(*args, **kwargs)
5332
e811c8ce 5333 def RemoveBrush(*args, **kwargs):
a95a7133 5334 """RemoveBrush(self, Brush brush)"""
54f9ee45 5335 return _gdi_.BrushList_RemoveBrush(*args, **kwargs)
e811c8ce 5336
50efceee
RD
5337 AddBrush = wx._deprecated(AddBrush)
5338 RemoveBrush = wx._deprecated(RemoveBrush)
e811c8ce 5339
2131d850 5340_gdi_.BrushList_swigregister(BrushList)
d14a1e28 5341
50efceee
RD
5342class FontList(GDIObjListBase):
5343 """Proxy of C++ FontList class"""
5344 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5345 def __init__(self): raise AttributeError, "No constructor defined"
5346 __repr__ = _swig_repr
5347 def FindOrCreateFont(*args, **kwargs):
5348 """
5349 FindOrCreateFont(self, int point_size, int family, int style, int weight,
5350 bool underline=False, String facename=EmptyString,
5351 int encoding=FONTENCODING_DEFAULT) -> Font
5352 """
5353 return _gdi_.FontList_FindOrCreateFont(*args, **kwargs)
5354
5355 def AddFont(*args, **kwargs):
5356 """AddFont(self, Font font)"""
5357 return _gdi_.FontList_AddFont(*args, **kwargs)
5358
5359 def RemoveFont(*args, **kwargs):
5360 """RemoveFont(self, Font font)"""
5361 return _gdi_.FontList_RemoveFont(*args, **kwargs)
5362
5363 AddFont = wx._deprecated(AddFont)
5364 RemoveFont = wx._deprecated(RemoveFont)
5365
2131d850 5366_gdi_.FontList_swigregister(FontList)
50efceee
RD
5367
5368class ColourDatabase(object):
093d3ff1 5369 """Proxy of C++ ColourDatabase class"""
0085ce49
RD
5370 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5371 __repr__ = _swig_repr
5372 def __init__(self, *args, **kwargs):
a95a7133 5373 """__init__(self) -> ColourDatabase"""
0085ce49
RD
5374 _gdi_.ColourDatabase_swiginit(self,_gdi_.new_ColourDatabase(*args, **kwargs))
5375 __swig_destroy__ = _gdi_.delete_ColourDatabase
5376 __del__ = lambda self : None;
e811c8ce 5377 def Find(*args, **kwargs):
a95a7133 5378 """Find(self, String name) -> Colour"""
54f9ee45 5379 return _gdi_.ColourDatabase_Find(*args, **kwargs)
e811c8ce
RD
5380
5381 def FindName(*args, **kwargs):
a95a7133 5382 """FindName(self, Colour colour) -> String"""
54f9ee45 5383 return _gdi_.ColourDatabase_FindName(*args, **kwargs)
e811c8ce 5384
d14a1e28 5385 FindColour = Find
e811c8ce 5386 def AddColour(*args, **kwargs):
a95a7133 5387 """AddColour(self, String name, Colour colour)"""
54f9ee45 5388 return _gdi_.ColourDatabase_AddColour(*args, **kwargs)
e811c8ce
RD
5389
5390 def Append(*args, **kwargs):
a95a7133 5391 """Append(self, String name, int red, int green, int blue)"""
54f9ee45 5392 return _gdi_.ColourDatabase_Append(*args, **kwargs)
e811c8ce 5393
2131d850 5394_gdi_.ColourDatabase_swigregister(ColourDatabase)
d14a1e28 5395
50efceee 5396#---------------------------------------------------------------------------
e811c8ce 5397
e811c8ce 5398
50efceee
RD
5399def _wxPyInitTheFontList(*args):
5400 """_wxPyInitTheFontList() -> FontList"""
5401 return _gdi_._wxPyInitTheFontList(*args)
e811c8ce 5402
50efceee
RD
5403def _wxPyInitThePenList(*args):
5404 """_wxPyInitThePenList() -> PenList"""
5405 return _gdi_._wxPyInitThePenList(*args)
e811c8ce 5406
50efceee
RD
5407def _wxPyInitTheBrushList(*args):
5408 """_wxPyInitTheBrushList() -> BrushList"""
5409 return _gdi_._wxPyInitTheBrushList(*args)
70551f47 5410
50efceee
RD
5411def _wxPyInitTheColourDatabase(*args):
5412 """_wxPyInitTheColourDatabase() -> ColourDatabase"""
5413 return _gdi_._wxPyInitTheColourDatabase(*args)
704eda0c
RD
5414# Create an uninitialized instance for the stock objects, they will
5415# be initialized later when the wx.App object is created.
5416TheFontList = FontList.__new__(FontList)
5417ThePenList = PenList.__new__(PenList)
5418TheBrushList = BrushList.__new__(BrushList)
5419TheColourDatabase = ColourDatabase.__new__(ColourDatabase)
fbcadfca 5420
994141e6 5421NullColor = NullColour
d14a1e28 5422#---------------------------------------------------------------------------
fbcadfca 5423
54f9ee45 5424class Effects(_core.Object):
093d3ff1 5425 """Proxy of C++ Effects class"""
0085ce49
RD
5426 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5427 __repr__ = _swig_repr
5428 def __init__(self, *args, **kwargs):
a95a7133 5429 """__init__(self) -> Effects"""
0085ce49 5430 _gdi_.Effects_swiginit(self,_gdi_.new_Effects(*args, **kwargs))
e811c8ce 5431 def GetHighlightColour(*args, **kwargs):
a95a7133 5432 """GetHighlightColour(self) -> Colour"""
54f9ee45 5433 return _gdi_.Effects_GetHighlightColour(*args, **kwargs)
e811c8ce
RD
5434
5435 def GetLightShadow(*args, **kwargs):
a95a7133 5436 """GetLightShadow(self) -> Colour"""
54f9ee45 5437 return _gdi_.Effects_GetLightShadow(*args, **kwargs)
e811c8ce
RD
5438
5439 def GetFaceColour(*args, **kwargs):
a95a7133 5440 """GetFaceColour(self) -> Colour"""
54f9ee45 5441 return _gdi_.Effects_GetFaceColour(*args, **kwargs)
e811c8ce
RD
5442
5443 def GetMediumShadow(*args, **kwargs):
a95a7133 5444 """GetMediumShadow(self) -> Colour"""
54f9ee45 5445 return _gdi_.Effects_GetMediumShadow(*args, **kwargs)
e811c8ce
RD
5446
5447 def GetDarkShadow(*args, **kwargs):
a95a7133 5448 """GetDarkShadow(self) -> Colour"""
54f9ee45 5449 return _gdi_.Effects_GetDarkShadow(*args, **kwargs)
e811c8ce
RD
5450
5451 def SetHighlightColour(*args, **kwargs):
a95a7133 5452 """SetHighlightColour(self, Colour c)"""
54f9ee45 5453 return _gdi_.Effects_SetHighlightColour(*args, **kwargs)
e811c8ce
RD
5454
5455 def SetLightShadow(*args, **kwargs):
a95a7133 5456 """SetLightShadow(self, Colour c)"""
54f9ee45 5457 return _gdi_.Effects_SetLightShadow(*args, **kwargs)
e811c8ce
RD
5458
5459 def SetFaceColour(*args, **kwargs):
a95a7133 5460 """SetFaceColour(self, Colour c)"""
54f9ee45 5461 return _gdi_.Effects_SetFaceColour(*args, **kwargs)
e811c8ce
RD
5462
5463 def SetMediumShadow(*args, **kwargs):
a95a7133 5464 """SetMediumShadow(self, Colour c)"""
54f9ee45 5465 return _gdi_.Effects_SetMediumShadow(*args, **kwargs)
e811c8ce
RD
5466
5467 def SetDarkShadow(*args, **kwargs):
a95a7133 5468 """SetDarkShadow(self, Colour c)"""
54f9ee45 5469 return _gdi_.Effects_SetDarkShadow(*args, **kwargs)
e811c8ce
RD
5470
5471 def Set(*args, **kwargs):
0df68c9f 5472 """
a95a7133 5473 Set(self, Colour highlightColour, Colour lightShadow, Colour faceColour,
0df68c9f
RD
5474 Colour mediumShadow, Colour darkShadow)
5475 """
54f9ee45 5476 return _gdi_.Effects_Set(*args, **kwargs)
e811c8ce
RD
5477
5478 def DrawSunkenEdge(*args, **kwargs):
a95a7133 5479 """DrawSunkenEdge(self, DC dc, Rect rect, int borderSize=1)"""
54f9ee45 5480 return _gdi_.Effects_DrawSunkenEdge(*args, **kwargs)
4be61064 5481
e811c8ce 5482 def TileBitmap(*args, **kwargs):
a95a7133 5483 """TileBitmap(self, Rect rect, DC dc, Bitmap bitmap) -> bool"""
54f9ee45 5484 return _gdi_.Effects_TileBitmap(*args, **kwargs)
e811c8ce 5485
97ab0f6a
RD
5486 DarkShadow = property(GetDarkShadow,SetDarkShadow,doc="See `GetDarkShadow` and `SetDarkShadow`")
5487 FaceColour = property(GetFaceColour,SetFaceColour,doc="See `GetFaceColour` and `SetFaceColour`")
5488 HighlightColour = property(GetHighlightColour,SetHighlightColour,doc="See `GetHighlightColour` and `SetHighlightColour`")
5489 LightShadow = property(GetLightShadow,SetLightShadow,doc="See `GetLightShadow` and `SetLightShadow`")
5490 MediumShadow = property(GetMediumShadow,SetMediumShadow,doc="See `GetMediumShadow` and `SetMediumShadow`")
2131d850 5491_gdi_.Effects_swigregister(Effects)
d14a1e28 5492
8d38bd1d
RD
5493#---------------------------------------------------------------------------
5494
5495CONTROL_DISABLED = _gdi_.CONTROL_DISABLED
5496CONTROL_FOCUSED = _gdi_.CONTROL_FOCUSED
5497CONTROL_PRESSED = _gdi_.CONTROL_PRESSED
79df624a 5498CONTROL_SPECIAL = _gdi_.CONTROL_SPECIAL
8d38bd1d
RD
5499CONTROL_ISDEFAULT = _gdi_.CONTROL_ISDEFAULT
5500CONTROL_ISSUBMENU = _gdi_.CONTROL_ISSUBMENU
5501CONTROL_EXPANDED = _gdi_.CONTROL_EXPANDED
79df624a 5502CONTROL_SIZEGRIP = _gdi_.CONTROL_SIZEGRIP
8d38bd1d
RD
5503CONTROL_CURRENT = _gdi_.CONTROL_CURRENT
5504CONTROL_SELECTED = _gdi_.CONTROL_SELECTED
5505CONTROL_CHECKED = _gdi_.CONTROL_CHECKED
5506CONTROL_CHECKABLE = _gdi_.CONTROL_CHECKABLE
5507CONTROL_UNDETERMINED = _gdi_.CONTROL_UNDETERMINED
5508CONTROL_FLAGS_MASK = _gdi_.CONTROL_FLAGS_MASK
5509CONTROL_DIRTY = _gdi_.CONTROL_DIRTY
5510class SplitterRenderParams(object):
5511 """
5512 This is just a simple struct used as a return value of
5513 `wx.RendererNative.GetSplitterParams` and contains some platform
5514 specific metrics about splitters.
5515
5516 * widthSash: the width of the splitter sash.
5517 * border: the width of the border of the splitter window.
5518 * isHotSensitive: ``True`` if the splitter changes its
5519 appearance when the mouse is over it.
5520
5521
5522 """
0085ce49
RD
5523 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5524 __repr__ = _swig_repr
5525 def __init__(self, *args, **kwargs):
8d38bd1d
RD
5526 """
5527 __init__(self, int widthSash_, int border_, bool isSens_) -> SplitterRenderParams
5528
5529 This is just a simple struct used as a return value of
5530 `wx.RendererNative.GetSplitterParams` and contains some platform
5531 specific metrics about splitters.
5532
5533 * widthSash: the width of the splitter sash.
5534 * border: the width of the border of the splitter window.
5535 * isHotSensitive: ``True`` if the splitter changes its
5536 appearance when the mouse is over it.
5537
5538
5539 """
0085ce49
RD
5540 _gdi_.SplitterRenderParams_swiginit(self,_gdi_.new_SplitterRenderParams(*args, **kwargs))
5541 __swig_destroy__ = _gdi_.delete_SplitterRenderParams
5542 __del__ = lambda self : None;
8d38bd1d
RD
5543 widthSash = property(_gdi_.SplitterRenderParams_widthSash_get)
5544 border = property(_gdi_.SplitterRenderParams_border_get)
5545 isHotSensitive = property(_gdi_.SplitterRenderParams_isHotSensitive_get)
2131d850 5546_gdi_.SplitterRenderParams_swigregister(SplitterRenderParams)
8d38bd1d 5547
33d6fd3b
RD
5548class HeaderButtonParams(object):
5549 """Extra (optional) parameters for `wx.RendererNative.DrawHeaderButton`"""
5550 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5551 __repr__ = _swig_repr
5552 def __init__(self, *args, **kwargs):
5553 """
5554 __init__(self) -> HeaderButtonParams
5555
5556 Extra (optional) parameters for `wx.RendererNative.DrawHeaderButton`
5557 """
5558 _gdi_.HeaderButtonParams_swiginit(self,_gdi_.new_HeaderButtonParams(*args, **kwargs))
5559 __swig_destroy__ = _gdi_.delete_HeaderButtonParams
5560 __del__ = lambda self : None;
5561 m_arrowColour = property(_gdi_.HeaderButtonParams_m_arrowColour_get, _gdi_.HeaderButtonParams_m_arrowColour_set)
5562 m_selectionColour = property(_gdi_.HeaderButtonParams_m_selectionColour_get, _gdi_.HeaderButtonParams_m_selectionColour_set)
5563 m_labelText = property(_gdi_.HeaderButtonParams_m_labelText_get, _gdi_.HeaderButtonParams_m_labelText_set)
5564 m_labelFont = property(_gdi_.HeaderButtonParams_m_labelFont_get, _gdi_.HeaderButtonParams_m_labelFont_set)
5565 m_labelColour = property(_gdi_.HeaderButtonParams_m_labelColour_get, _gdi_.HeaderButtonParams_m_labelColour_set)
5566 m_labelBitmap = property(_gdi_.HeaderButtonParams_m_labelBitmap_get, _gdi_.HeaderButtonParams_m_labelBitmap_set)
5567 m_labelAlignment = property(_gdi_.HeaderButtonParams_m_labelAlignment_get, _gdi_.HeaderButtonParams_m_labelAlignment_set)
5568_gdi_.HeaderButtonParams_swigregister(HeaderButtonParams)
5569
5570HDR_SORT_ICON_NONE = _gdi_.HDR_SORT_ICON_NONE
5571HDR_SORT_ICON_UP = _gdi_.HDR_SORT_ICON_UP
5572HDR_SORT_ICON_DOWN = _gdi_.HDR_SORT_ICON_DOWN
8d38bd1d
RD
5573class RendererVersion(object):
5574 """
5575 This simple struct represents the `wx.RendererNative` interface
5576 version and is only used as the return value of
5577 `wx.RendererNative.GetVersion`.
5578 """
0085ce49
RD
5579 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5580 __repr__ = _swig_repr
5581 def __init__(self, *args, **kwargs):
8d38bd1d
RD
5582 """
5583 __init__(self, int version_, int age_) -> RendererVersion
5584
5585 This simple struct represents the `wx.RendererNative` interface
5586 version and is only used as the return value of
5587 `wx.RendererNative.GetVersion`.
5588 """
0085ce49
RD
5589 _gdi_.RendererVersion_swiginit(self,_gdi_.new_RendererVersion(*args, **kwargs))
5590 __swig_destroy__ = _gdi_.delete_RendererVersion
5591 __del__ = lambda self : None;
8d38bd1d
RD
5592 Current_Version = _gdi_.RendererVersion_Current_Version
5593 Current_Age = _gdi_.RendererVersion_Current_Age
5594 def IsCompatible(*args, **kwargs):
5595 """IsCompatible(RendererVersion ver) -> bool"""
5596 return _gdi_.RendererVersion_IsCompatible(*args, **kwargs)
5597
5598 IsCompatible = staticmethod(IsCompatible)
5599 version = property(_gdi_.RendererVersion_version_get)
5600 age = property(_gdi_.RendererVersion_age_get)
2131d850 5601_gdi_.RendererVersion_swigregister(RendererVersion)
8d38bd1d
RD
5602
5603def RendererVersion_IsCompatible(*args, **kwargs):
0085ce49
RD
5604 """RendererVersion_IsCompatible(RendererVersion ver) -> bool"""
5605 return _gdi_.RendererVersion_IsCompatible(*args, **kwargs)
8d38bd1d
RD
5606
5607class RendererNative(object):
5608 """
33d6fd3b
RD
5609 One of the design principles of wxWidgets is to use the native
5610 widgets on every platform in order to be as close as possible to
5611 the native look and feel on every platform. However there are
5612 still cases when some generic widgets are needed for various
5613 reasons, but it can sometimes take a lot of messy work to make
5614 them conform to the native LnF.
8d38bd1d
RD
5615
5616 The wx.RendererNative class is a collection of functions that have
5617 platform-specific implementations for drawing certain parts of
5618 genereic controls in ways that are as close to the native look as
5619 possible.
5620
f05326ba
RD
5621 Note that each drawing function restores the `wx.DC` attributes if it
5622 changes them, so it is safe to assume that the same pen, brush and
5623 colours that were active before the call to this function are still in
5624 effect after it.
5625
8d38bd1d 5626 """
0085ce49
RD
5627 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5628 def __init__(self): raise AttributeError, "No constructor defined"
5629 __repr__ = _swig_repr
8d38bd1d
RD
5630 def DrawHeaderButton(*args, **kwargs):
5631 """
33d6fd3b
RD
5632 DrawHeaderButton(self, Window win, DC dc, Rect rect, int flags=0, int sortArrow=HDR_SORT_ICON_NONE,
5633 HeaderButtonParams params=None)
8d38bd1d 5634
75219dcb 5635 Draw the header control button (such as what is used by `wx.ListCtrl`
8d38bd1d
RD
5636 in report mode.)
5637 """
5638 return _gdi_.RendererNative_DrawHeaderButton(*args, **kwargs)
5639
33d6fd3b
RD
5640 def DrawHeaderButtonContents(*args, **kwargs):
5641 """
5642 DrawHeaderButtonContents(self, Window win, DC dc, Rect rect, int flags=0, int sortArrow=HDR_SORT_ICON_NONE,
5643 HeaderButtonParams params=None)
5644
5645 Draw the contents of a header control button, (label, sort
5646 arrows, etc.) Normally this is only called by `DrawHeaderButton`.
5647 """
5648 return _gdi_.RendererNative_DrawHeaderButtonContents(*args, **kwargs)
5649
5650 def GetHeaderButtonHeight(*args, **kwargs):
5651 """
5652 GetHeaderButtonHeight(self, Window win) -> int
5653
5654 Returns the default height of a header button, either a fixed platform
5655 height if available, or a generic height based on the window's font.
5656 """
5657 return _gdi_.RendererNative_GetHeaderButtonHeight(*args, **kwargs)
5658
8d38bd1d
RD
5659 def DrawTreeItemButton(*args, **kwargs):
5660 """
5661 DrawTreeItemButton(self, Window win, DC dc, Rect rect, int flags=0)
5662
5663 Draw the expanded/collapsed icon for a tree control item.
5664 """
5665 return _gdi_.RendererNative_DrawTreeItemButton(*args, **kwargs)
5666
5667 def DrawSplitterBorder(*args, **kwargs):
5668 """
5669 DrawSplitterBorder(self, Window win, DC dc, Rect rect, int flags=0)
5670
5671 Draw the border for a sash window: this border must be such that the
5672 sash drawn by `DrawSplitterSash` blends into it well.
5673 """
5674 return _gdi_.RendererNative_DrawSplitterBorder(*args, **kwargs)
5675
5676 def DrawSplitterSash(*args, **kwargs):
5677 """
5678 DrawSplitterSash(self, Window win, DC dc, Size size, int position, int orient,
5679 int flags=0)
5680
5681 Draw a sash. The orient parameter defines whether the sash should be
5682 vertical or horizontal and how the position should be interpreted.
5683 """
5684 return _gdi_.RendererNative_DrawSplitterSash(*args, **kwargs)
5685
5686 def DrawComboBoxDropButton(*args, **kwargs):
5687 """
5688 DrawComboBoxDropButton(self, Window win, DC dc, Rect rect, int flags=0)
5689
5690 Draw a button like the one used by `wx.ComboBox` to show a drop down
5691 window. The usual appearance is a downwards pointing arrow.
5692
5693 The ``flags`` parameter may have the ``wx.CONTROL_PRESSED`` or
5694 ``wx.CONTROL_CURRENT`` bits set.
5695 """
5696 return _gdi_.RendererNative_DrawComboBoxDropButton(*args, **kwargs)
5697
5698 def DrawDropArrow(*args, **kwargs):
5699 """
5700 DrawDropArrow(self, Window win, DC dc, Rect rect, int flags=0)
5701
5702 Draw a drop down arrow that is suitable for use outside a combo
5703 box. Arrow will have a transparent background.
5704
5705 ``rect`` is not entirely filled by the arrow. Instead, you should use
5706 bounding rectangle of a drop down button which arrow matches the size
5707 you need. ``flags`` may have the ``wx.CONTROL_PRESSED`` or
5708 ``wx.CONTROL_CURRENT`` bit set.
5709 """
5710 return _gdi_.RendererNative_DrawDropArrow(*args, **kwargs)
5711
01f6b6d3 5712 def DrawCheckBox(*args, **kwargs):
50efceee 5713 """
01f6b6d3 5714 DrawCheckBox(self, Window win, DC dc, Rect rect, int flags=0)
50efceee
RD
5715
5716 Draw a check button. Flags may use wx.CONTROL_CHECKED,
5717 wx.CONTROL_UNDETERMINED and wx.CONTROL_CURRENT.
5718 """
01f6b6d3
RD
5719 return _gdi_.RendererNative_DrawCheckBox(*args, **kwargs)
5720
5721 def DrawPushButton(*args, **kwargs):
5722 """
5723 DrawPushButton(self, Window win, DC dc, Rect rect, int flags=0)
5724
5725 Draw a blank button. Flags may be wx.CONTROL_PRESSED, wx.CONTROL_CURRENT and
5726 wx.CONTROL_ISDEFAULT
5727 """
5728 return _gdi_.RendererNative_DrawPushButton(*args, **kwargs)
5729
5730 def DrawItemSelectionRect(*args, **kwargs):
5731 """
5732 DrawItemSelectionRect(self, Window win, DC dc, Rect rect, int flags=0)
5733
5734 Draw rectangle indicating that an item in e.g. a list control has been
5735 selected or focused
5736
5737 The flags parameter may be:
5738
5739 ==================== ============================================
5740 wx.CONTROL_SELECTED item is selected, e.g. draw background
5741 wx.CONTROL_CURRENT item is the current item, e.g. dotted border
5742 wx.CONTROL_FOCUSED the whole control has focus, e.g. blue
5743 background vs. grey otherwise
5744 ==================== ============================================
5745
5746 """
5747 return _gdi_.RendererNative_DrawItemSelectionRect(*args, **kwargs)
50efceee 5748
8d38bd1d
RD
5749 def GetSplitterParams(*args, **kwargs):
5750 """
5751 GetSplitterParams(self, Window win) -> SplitterRenderParams
5752
5753 Get the splitter parameters, see `wx.SplitterRenderParams`.
5754 """
5755 return _gdi_.RendererNative_GetSplitterParams(*args, **kwargs)
5756
5757 def Get(*args, **kwargs):
5758 """
5759 Get() -> RendererNative
5760
5761 Return the currently used renderer
5762 """
5763 return _gdi_.RendererNative_Get(*args, **kwargs)
5764
5765 Get = staticmethod(Get)
5766 def GetGeneric(*args, **kwargs):
5767 """
5768 GetGeneric() -> RendererNative
5769
5770 Return the generic implementation of the renderer. Under some
5771 platforms, this is the default renderer implementation, others have
5772 platform-specific default renderer which can be retrieved by calling
1d5ee749 5773 `wx.RendererNative.GetDefault`.
8d38bd1d
RD
5774 """
5775 return _gdi_.RendererNative_GetGeneric(*args, **kwargs)
5776
5777 GetGeneric = staticmethod(GetGeneric)
5778 def GetDefault(*args, **kwargs):
5779 """
5780 GetDefault() -> RendererNative
5781
5782 Return the default (native) implementation for this platform -- this
1d5ee749
RD
5783 is also the one used by default but this may be changed by calling
5784 `wx.RendererNative.Set` in which case the return value of this method
5785 may be different from the return value of `wx.RendererNative.Get`.
8d38bd1d
RD
5786 """
5787 return _gdi_.RendererNative_GetDefault(*args, **kwargs)
5788
5789 GetDefault = staticmethod(GetDefault)
5790 def Set(*args, **kwargs):
5791 """
5792 Set(RendererNative renderer) -> RendererNative
5793
5794 Set the renderer to use, passing None reverts to using the default
5795 renderer. Returns the previous renderer used with Set or None.
5796 """
5797 return _gdi_.RendererNative_Set(*args, **kwargs)
5798
5799 Set = staticmethod(Set)
5800 def GetVersion(*args, **kwargs):
5801 """
5802 GetVersion(self) -> RendererVersion
5803
5804 Returns the version of the renderer. Will be used for ensuring
5805 compatibility of dynamically loaded renderers.
5806 """
5807 return _gdi_.RendererNative_GetVersion(*args, **kwargs)
5808
33d6fd3b
RD
5809 SplitterParams = property(GetSplitterParams,doc="See `GetSplitterParams`")
5810 Version = property(GetVersion,doc="See `GetVersion`")
2131d850 5811_gdi_.RendererNative_swigregister(RendererNative)
8d38bd1d 5812
0085ce49
RD
5813def RendererNative_Get(*args):
5814 """
8d38bd1d
RD
5815 RendererNative_Get() -> RendererNative
5816
5817 Return the currently used renderer
5818 """
0085ce49 5819 return _gdi_.RendererNative_Get(*args)
8d38bd1d 5820
0085ce49
RD
5821def RendererNative_GetGeneric(*args):
5822 """
8d38bd1d
RD
5823 RendererNative_GetGeneric() -> RendererNative
5824
5825 Return the generic implementation of the renderer. Under some
5826 platforms, this is the default renderer implementation, others have
5827 platform-specific default renderer which can be retrieved by calling
1d5ee749 5828 `wx.RendererNative.GetDefault`.
8d38bd1d 5829 """
0085ce49 5830 return _gdi_.RendererNative_GetGeneric(*args)
8d38bd1d 5831
0085ce49
RD
5832def RendererNative_GetDefault(*args):
5833 """
8d38bd1d
RD
5834 RendererNative_GetDefault() -> RendererNative
5835
5836 Return the default (native) implementation for this platform -- this
1d5ee749
RD
5837 is also the one used by default but this may be changed by calling
5838 `wx.RendererNative.Set` in which case the return value of this method
5839 may be different from the return value of `wx.RendererNative.Get`.
8d38bd1d 5840 """
0085ce49 5841 return _gdi_.RendererNative_GetDefault(*args)
8d38bd1d
RD
5842
5843def RendererNative_Set(*args, **kwargs):
0085ce49 5844 """
8d38bd1d
RD
5845 RendererNative_Set(RendererNative renderer) -> RendererNative
5846
5847 Set the renderer to use, passing None reverts to using the default
5848 renderer. Returns the previous renderer used with Set or None.
5849 """
0085ce49 5850 return _gdi_.RendererNative_Set(*args, **kwargs)
8d38bd1d 5851
27e45892
RD
5852#---------------------------------------------------------------------------
5853
5854class PseudoDC(_core.Object):
5855 """
5856 A PseudoDC is an object that can be used as if it were a `wx.DC`. All
5857 commands issued to the PseudoDC are stored in a list. You can then
5858 play these commands back to a real DC object using the DrawToDC
5859 method. Commands in the command list are indexed by ID. You can use
5860 this to clear the operations associated with a single ID and then
5861 re-draw the object associated with that ID.
5862 """
5863 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
5864 __repr__ = _swig_repr
5865 def __init__(self, *args, **kwargs):
5866 """
5867 __init__(self) -> PseudoDC
5868
5869 Constructs a new Pseudo device context for recording dc operations
5870 """
5871 _gdi_.PseudoDC_swiginit(self,_gdi_.new_PseudoDC(*args, **kwargs))
5872 def BeginDrawing(*args, **kwargs):
5873 """
5874 BeginDrawing(self)
5875
5876 Allows for optimization of drawing code on platforms that need it. On
5877 other platforms this is just an empty function and is harmless. To
5878 take advantage of this postential optimization simply enclose each
5879 group of calls to the drawing primitives within calls to
5880 `BeginDrawing` and `EndDrawing`.
5881 """
5882 return _gdi_.PseudoDC_BeginDrawing(*args, **kwargs)
5883
5884 def EndDrawing(*args, **kwargs):
5885 """
5886 EndDrawing(self)
5887
5888 Ends the group of drawing primitives started with `BeginDrawing`, and
5889 invokes whatever optimization is available for this DC type on the
5890 current platform.
5891 """
5892 return _gdi_.PseudoDC_EndDrawing(*args, **kwargs)
5893
5894 __swig_destroy__ = _gdi_.delete_PseudoDC
5895 __del__ = lambda self : None;
5896 def RemoveAll(*args, **kwargs):
5897 """
5898 RemoveAll(self)
5899
5900 Removes all objects and operations from the recorded list.
5901 """
5902 return _gdi_.PseudoDC_RemoveAll(*args, **kwargs)
5903
5904 def GetLen(*args, **kwargs):
5905 """
5906 GetLen(self) -> int
5907
5908 Returns the number of operations in the recorded list.
5909 """
5910 return _gdi_.PseudoDC_GetLen(*args, **kwargs)
5911
5912 def SetId(*args, **kwargs):
5913 """
5914 SetId(self, int id)
5915
5916 Sets the id to be associated with subsequent operations.
5917 """
5918 return _gdi_.PseudoDC_SetId(*args, **kwargs)
5919
5920 def ClearId(*args, **kwargs):
5921 """
5922 ClearId(self, int id)
5923
5924 Removes all operations associated with id so the object can be redrawn.
5925 """
5926 return _gdi_.PseudoDC_ClearId(*args, **kwargs)
5927
5928 def RemoveId(*args, **kwargs):
5929 """
5930 RemoveId(self, int id)
5931
5932 Remove the object node (and all operations) associated with an id.
5933 """
5934 return _gdi_.PseudoDC_RemoveId(*args, **kwargs)
5935
5936 def TranslateId(*args, **kwargs):
5937 """
5938 TranslateId(self, int id, int dx, int dy)
5939
5940 Translate the operations of id by dx,dy.
5941 """
5942 return _gdi_.PseudoDC_TranslateId(*args, **kwargs)
5943
72ef6efb
RD
5944 def SetIdGreyedOut(*args, **kwargs):
5945 """
5946 SetIdGreyedOut(self, int id, bool greyout=True)
5947
5948 Set whether an object is drawn greyed out or not.
5949 """
5950 return _gdi_.PseudoDC_SetIdGreyedOut(*args, **kwargs)
5951
5952 def GetIdGreyedOut(*args, **kwargs):
5953 """
5954 GetIdGreyedOut(self, int id) -> bool
5955
5956 Get whether an object is drawn greyed out or not.
5957 """
5958 return _gdi_.PseudoDC_GetIdGreyedOut(*args, **kwargs)
5959
5960 def FindObjects(*args, **kwargs):
5961 """
5962 FindObjects(self, int x, int y, int radius=1, wxColor bg=*wxWHITE) -> PyObject
5963
5964 Returns a list of all the id's that draw a pixel with color
5965 not equal to bg within radius of (x,y).
5966 Returns an empty list if nothing is found. The list is in
5967 reverse drawing order so list[0] is the top id.
5968 """
5969 return _gdi_.PseudoDC_FindObjects(*args, **kwargs)
5970
5971 def FindObjectsByBBox(*args, **kwargs):
5972 """
5973 FindObjectsByBBox(self, int x, int y) -> PyObject
5974
5975 Returns a list of all the id's whose bounding boxes include (x,y).
5976 Returns an empty list if nothing is found. The list is in
5977 reverse drawing order so list[0] is the top id.
5978 """
5979 return _gdi_.PseudoDC_FindObjectsByBBox(*args, **kwargs)
5980
27e45892
RD
5981 def DrawIdToDC(*args, **kwargs):
5982 """
5983 DrawIdToDC(self, int id, DC dc)
5984
5985 Draw recorded operations of id to dc.
5986 """
5987 return _gdi_.PseudoDC_DrawIdToDC(*args, **kwargs)
5988
5989 def SetIdBounds(*args, **kwargs):
5990 """
5991 SetIdBounds(self, int id, Rect rect)
5992
5993 Set the bounding rect of a given object. This will create
5994 an object node if one doesn't exist.
5995 """
5996 return _gdi_.PseudoDC_SetIdBounds(*args, **kwargs)
5997
5998 def GetIdBounds(*args, **kwargs):
5999 """
6000 GetIdBounds(self, int id) -> Rect
6001
6002 Returns the bounding rectangle previouly set with SetIdBounds. If
6003 no bounds have been set, it returns wx.Rect(0,0,0,0).
6004 """
6005 return _gdi_.PseudoDC_GetIdBounds(*args, **kwargs)
6006
6007 def DrawToDCClipped(*args, **kwargs):
6008 """
6009 DrawToDCClipped(self, DC dc, Rect rect)
6010
6011 Draws the recorded operations to dc unless the operation is known to
6012 be outside rect.
6013 """
6014 return _gdi_.PseudoDC_DrawToDCClipped(*args, **kwargs)
6015
6016 def DrawToDCClippedRgn(*args, **kwargs):
6017 """
6018 DrawToDCClippedRgn(self, DC dc, Region region)
6019
6020 Draws the recorded operations to dc unless the operation is known to
6021 be outside rect.
6022 """
6023 return _gdi_.PseudoDC_DrawToDCClippedRgn(*args, **kwargs)
6024
6025 def DrawToDC(*args, **kwargs):
6026 """
6027 DrawToDC(self, DC dc)
6028
6029 Draws the recorded operations to dc.
6030 """
6031 return _gdi_.PseudoDC_DrawToDC(*args, **kwargs)
6032
6033 def FloodFill(*args, **kwargs):
6034 """
6035 FloodFill(self, int x, int y, Colour col, int style=FLOOD_SURFACE)
6036
6037 Flood fills the device context starting from the given point, using
6038 the current brush colour, and using a style:
6039
6040 - **wxFLOOD_SURFACE**: the flooding occurs until a colour other than
6041 the given colour is encountered.
6042
6043 - **wxFLOOD_BORDER**: the area to be flooded is bounded by the given
6044 colour.
6045
6046 Returns False if the operation failed.
6047
6048 Note: The present implementation for non-Windows platforms may fail to
6049 find colour borders if the pixels do not match the colour
6050 exactly. However the function will still return true.
6051 """
6052 return _gdi_.PseudoDC_FloodFill(*args, **kwargs)
6053
6054 def FloodFillPoint(*args, **kwargs):
6055 """
6056 FloodFillPoint(self, Point pt, Colour col, int style=FLOOD_SURFACE)
6057
6058 Flood fills the device context starting from the given point, using
6059 the current brush colour, and using a style:
6060
6061 - **wxFLOOD_SURFACE**: the flooding occurs until a colour other than
6062 the given colour is encountered.
6063
6064 - **wxFLOOD_BORDER**: the area to be flooded is bounded by the given
6065 colour.
6066
6067 Returns False if the operation failed.
6068
6069 Note: The present implementation for non-Windows platforms may fail to
6070 find colour borders if the pixels do not match the colour
6071 exactly. However the function will still return true.
6072 """
6073 return _gdi_.PseudoDC_FloodFillPoint(*args, **kwargs)
6074
6075 def DrawLine(*args, **kwargs):
6076 """
6077 DrawLine(self, int x1, int y1, int x2, int y2)
6078
6079 Draws a line from the first point to the second. The current pen is
6080 used for drawing the line. Note that the second point is *not* part of
6081 the line and is not drawn by this function (this is consistent with
6082 the behaviour of many other toolkits).
6083 """
6084 return _gdi_.PseudoDC_DrawLine(*args, **kwargs)
6085
6086 def DrawLinePoint(*args, **kwargs):
6087 """
6088 DrawLinePoint(self, Point pt1, Point pt2)
6089
6090 Draws a line from the first point to the second. The current pen is
6091 used for drawing the line. Note that the second point is *not* part of
6092 the line and is not drawn by this function (this is consistent with
6093 the behaviour of many other toolkits).
6094 """
6095 return _gdi_.PseudoDC_DrawLinePoint(*args, **kwargs)
6096
6097 def CrossHair(*args, **kwargs):
6098 """
6099 CrossHair(self, int x, int y)
6100
6101 Displays a cross hair using the current pen. This is a vertical and
6102 horizontal line the height and width of the window, centred on the
6103 given point.
6104 """
6105 return _gdi_.PseudoDC_CrossHair(*args, **kwargs)
6106
6107 def CrossHairPoint(*args, **kwargs):
6108 """
6109 CrossHairPoint(self, Point pt)
6110
6111 Displays a cross hair using the current pen. This is a vertical and
6112 horizontal line the height and width of the window, centred on the
6113 given point.
6114 """
6115 return _gdi_.PseudoDC_CrossHairPoint(*args, **kwargs)
6116
6117 def DrawArc(*args, **kwargs):
6118 """
6119 DrawArc(self, int x1, int y1, int x2, int y2, int xc, int yc)
6120
6121 Draws an arc of a circle, centred on the *center* point (xc, yc), from
6122 the first point to the second. The current pen is used for the outline
6123 and the current brush for filling the shape.
6124
6125 The arc is drawn in an anticlockwise direction from the start point to
6126 the end point.
6127 """
6128 return _gdi_.PseudoDC_DrawArc(*args, **kwargs)
6129
6130 def DrawArcPoint(*args, **kwargs):
6131 """
6132 DrawArcPoint(self, Point pt1, Point pt2, Point center)
6133
6134 Draws an arc of a circle, centred on the *center* point (xc, yc), from
6135 the first point to the second. The current pen is used for the outline
6136 and the current brush for filling the shape.
6137
6138 The arc is drawn in an anticlockwise direction from the start point to
6139 the end point.
6140 """
6141 return _gdi_.PseudoDC_DrawArcPoint(*args, **kwargs)
6142
6143 def DrawCheckMark(*args, **kwargs):
6144 """
6145 DrawCheckMark(self, int x, int y, int width, int height)
6146
6147 Draws a check mark inside the given rectangle.
6148 """
6149 return _gdi_.PseudoDC_DrawCheckMark(*args, **kwargs)
6150
6151 def DrawCheckMarkRect(*args, **kwargs):
6152 """
6153 DrawCheckMarkRect(self, Rect rect)
6154
6155 Draws a check mark inside the given rectangle.
6156 """
6157 return _gdi_.PseudoDC_DrawCheckMarkRect(*args, **kwargs)
6158
6159 def DrawEllipticArc(*args, **kwargs):
6160 """
6161 DrawEllipticArc(self, int x, int y, int w, int h, double start, double end)
6162
6163 Draws an arc of an ellipse, with the given rectangle defining the
6164 bounds of the ellipse. The current pen is used for drawing the arc and
6165 the current brush is used for drawing the pie.
6166
6167 The *start* and *end* parameters specify the start and end of the arc
6168 relative to the three-o'clock position from the center of the
6169 rectangle. Angles are specified in degrees (360 is a complete
6170 circle). Positive values mean counter-clockwise motion. If start is
6171 equal to end, a complete ellipse will be drawn.
6172 """
6173 return _gdi_.PseudoDC_DrawEllipticArc(*args, **kwargs)
6174
6175 def DrawEllipticArcPointSize(*args, **kwargs):
6176 """
6177 DrawEllipticArcPointSize(self, Point pt, Size sz, double start, double end)
6178
6179 Draws an arc of an ellipse, with the given rectangle defining the
6180 bounds of the ellipse. The current pen is used for drawing the arc and
6181 the current brush is used for drawing the pie.
6182
6183 The *start* and *end* parameters specify the start and end of the arc
6184 relative to the three-o'clock position from the center of the
6185 rectangle. Angles are specified in degrees (360 is a complete
6186 circle). Positive values mean counter-clockwise motion. If start is
6187 equal to end, a complete ellipse will be drawn.
6188 """
6189 return _gdi_.PseudoDC_DrawEllipticArcPointSize(*args, **kwargs)
6190
6191 def DrawPoint(*args, **kwargs):
6192 """
6193 DrawPoint(self, int x, int y)
6194
6195 Draws a point using the current pen.
6196 """
6197 return _gdi_.PseudoDC_DrawPoint(*args, **kwargs)
6198
6199 def DrawPointPoint(*args, **kwargs):
6200 """
6201 DrawPointPoint(self, Point pt)
6202
6203 Draws a point using the current pen.
6204 """
6205 return _gdi_.PseudoDC_DrawPointPoint(*args, **kwargs)
6206
6207 def DrawRectangle(*args, **kwargs):
6208 """
6209 DrawRectangle(self, int x, int y, int width, int height)
6210
6211 Draws a rectangle with the given top left corner, and with the given
6212 size. The current pen is used for the outline and the current brush
6213 for filling the shape.
6214 """
6215 return _gdi_.PseudoDC_DrawRectangle(*args, **kwargs)
6216
6217 def DrawRectangleRect(*args, **kwargs):
6218 """
6219 DrawRectangleRect(self, Rect rect)
6220
6221 Draws a rectangle with the given top left corner, and with the given
6222 size. The current pen is used for the outline and the current brush
6223 for filling the shape.
6224 """
6225 return _gdi_.PseudoDC_DrawRectangleRect(*args, **kwargs)
6226
6227 def DrawRectanglePointSize(*args, **kwargs):
6228 """
6229 DrawRectanglePointSize(self, Point pt, Size sz)
6230
6231 Draws a rectangle with the given top left corner, and with the given
6232 size. The current pen is used for the outline and the current brush
6233 for filling the shape.
6234 """
6235 return _gdi_.PseudoDC_DrawRectanglePointSize(*args, **kwargs)
6236
6237 def DrawRoundedRectangle(*args, **kwargs):
6238 """
6239 DrawRoundedRectangle(self, int x, int y, int width, int height, double radius)
6240
6241 Draws a rectangle with the given top left corner, and with the given
6242 size. The corners are quarter-circles using the given radius. The
6243 current pen is used for the outline and the current brush for filling
6244 the shape.
6245
6246 If radius is positive, the value is assumed to be the radius of the
6247 rounded corner. If radius is negative, the absolute value is assumed
6248 to be the proportion of the smallest dimension of the rectangle. This
6249 means that the corner can be a sensible size relative to the size of
6250 the rectangle, and also avoids the strange effects X produces when the
6251 corners are too big for the rectangle.
6252 """
6253 return _gdi_.PseudoDC_DrawRoundedRectangle(*args, **kwargs)
6254
6255 def DrawRoundedRectangleRect(*args, **kwargs):
6256 """
6257 DrawRoundedRectangleRect(self, Rect r, double radius)
6258
6259 Draws a rectangle with the given top left corner, and with the given
6260 size. The corners are quarter-circles using the given radius. The
6261 current pen is used for the outline and the current brush for filling
6262 the shape.
6263
6264 If radius is positive, the value is assumed to be the radius of the
6265 rounded corner. If radius is negative, the absolute value is assumed
6266 to be the proportion of the smallest dimension of the rectangle. This
6267 means that the corner can be a sensible size relative to the size of
6268 the rectangle, and also avoids the strange effects X produces when the
6269 corners are too big for the rectangle.
6270 """
6271 return _gdi_.PseudoDC_DrawRoundedRectangleRect(*args, **kwargs)
6272
6273 def DrawRoundedRectanglePointSize(*args, **kwargs):
6274 """
6275 DrawRoundedRectanglePointSize(self, Point pt, Size sz, double radius)
6276
6277 Draws a rectangle with the given top left corner, and with the given
6278 size. The corners are quarter-circles using the given radius. The
6279 current pen is used for the outline and the current brush for filling
6280 the shape.
6281
6282 If radius is positive, the value is assumed to be the radius of the
6283 rounded corner. If radius is negative, the absolute value is assumed
6284 to be the proportion of the smallest dimension of the rectangle. This
6285 means that the corner can be a sensible size relative to the size of
6286 the rectangle, and also avoids the strange effects X produces when the
6287 corners are too big for the rectangle.
6288 """
6289 return _gdi_.PseudoDC_DrawRoundedRectanglePointSize(*args, **kwargs)
6290
6291 def DrawCircle(*args, **kwargs):
6292 """
6293 DrawCircle(self, int x, int y, int radius)
6294
6295 Draws a circle with the given center point and radius. The current
6296 pen is used for the outline and the current brush for filling the
6297 shape.
6298 """
6299 return _gdi_.PseudoDC_DrawCircle(*args, **kwargs)
6300
6301 def DrawCirclePoint(*args, **kwargs):
6302 """
6303 DrawCirclePoint(self, Point pt, int radius)
6304
6305 Draws a circle with the given center point and radius. The current
6306 pen is used for the outline and the current brush for filling the
6307 shape.
6308 """
6309 return _gdi_.PseudoDC_DrawCirclePoint(*args, **kwargs)
6310
6311 def DrawEllipse(*args, **kwargs):
6312 """
6313 DrawEllipse(self, int x, int y, int width, int height)
6314
6315 Draws an ellipse contained in the specified rectangle. The current pen
6316 is used for the outline and the current brush for filling the shape.
6317 """
6318 return _gdi_.PseudoDC_DrawEllipse(*args, **kwargs)
6319
6320 def DrawEllipseRect(*args, **kwargs):
6321 """
6322 DrawEllipseRect(self, Rect rect)
6323
6324 Draws an ellipse contained in the specified rectangle. The current pen
6325 is used for the outline and the current brush for filling the shape.
6326 """
6327 return _gdi_.PseudoDC_DrawEllipseRect(*args, **kwargs)
6328
6329 def DrawEllipsePointSize(*args, **kwargs):
6330 """
6331 DrawEllipsePointSize(self, Point pt, Size sz)
6332
6333 Draws an ellipse contained in the specified rectangle. The current pen
6334 is used for the outline and the current brush for filling the shape.
6335 """
6336 return _gdi_.PseudoDC_DrawEllipsePointSize(*args, **kwargs)
6337
6338 def DrawIcon(*args, **kwargs):
6339 """
6340 DrawIcon(self, Icon icon, int x, int y)
6341
6342 Draw an icon on the display (does nothing if the device context is
6343 PostScript). This can be the simplest way of drawing bitmaps on a
6344 window.
6345 """
6346 return _gdi_.PseudoDC_DrawIcon(*args, **kwargs)
6347
6348 def DrawIconPoint(*args, **kwargs):
6349 """
6350 DrawIconPoint(self, Icon icon, Point pt)
6351
6352 Draw an icon on the display (does nothing if the device context is
6353 PostScript). This can be the simplest way of drawing bitmaps on a
6354 window.
6355 """
6356 return _gdi_.PseudoDC_DrawIconPoint(*args, **kwargs)
6357
6358 def DrawBitmap(*args, **kwargs):
6359 """
6360 DrawBitmap(self, Bitmap bmp, int x, int y, bool useMask=False)
6361
6362 Draw a bitmap on the device context at the specified point. If
6363 *transparent* is true and the bitmap has a transparency mask, (or
6364 alpha channel on the platforms that support it) then the bitmap will
6365 be drawn transparently.
6366 """
6367 return _gdi_.PseudoDC_DrawBitmap(*args, **kwargs)
6368
6369 def DrawBitmapPoint(*args, **kwargs):
6370 """
6371 DrawBitmapPoint(self, Bitmap bmp, Point pt, bool useMask=False)
6372
6373 Draw a bitmap on the device context at the specified point. If
6374 *transparent* is true and the bitmap has a transparency mask, (or
6375 alpha channel on the platforms that support it) then the bitmap will
6376 be drawn transparently.
6377 """
6378 return _gdi_.PseudoDC_DrawBitmapPoint(*args, **kwargs)
6379
6380 def DrawText(*args, **kwargs):
6381 """
6382 DrawText(self, String text, int x, int y)
6383
6384 Draws a text string at the specified point, using the current text
6385 font, and the current text foreground and background colours.
6386
6387 The coordinates refer to the top-left corner of the rectangle bounding
1d5ee749
RD
6388 the string. See `wx.DC.GetTextExtent` for how to get the dimensions of
6389 a text string, which can be used to position the text more precisely,
6390 (you will need to use a real DC with GetTextExtent as wx.PseudoDC does
6391 not implement it.)
27e45892
RD
6392
6393 **NOTE**: under wxGTK the current logical function is used by this
6394 function but it is ignored by wxMSW. Thus, you should avoid using
6395 logical functions with this function in portable programs.
6396 """
6397 return _gdi_.PseudoDC_DrawText(*args, **kwargs)
6398
6399 def DrawTextPoint(*args, **kwargs):
6400 """
6401 DrawTextPoint(self, String text, Point pt)
6402
6403 Draws a text string at the specified point, using the current text
6404 font, and the current text foreground and background colours.
6405
6406 The coordinates refer to the top-left corner of the rectangle bounding
1d5ee749
RD
6407 the string. See `wx.DC.GetTextExtent` for how to get the dimensions of
6408 a text string, which can be used to position the text more precisely,
6409 (you will need to use a real DC with GetTextExtent as wx.PseudoDC does
6410 not implement it.)
27e45892
RD
6411
6412 **NOTE**: under wxGTK the current logical function is used by this
6413 function but it is ignored by wxMSW. Thus, you should avoid using
6414 logical functions with this function in portable programs.
6415 """
6416 return _gdi_.PseudoDC_DrawTextPoint(*args, **kwargs)
6417
6418 def DrawRotatedText(*args, **kwargs):
6419 """
6420 DrawRotatedText(self, String text, int x, int y, double angle)
6421
6422 Draws the text rotated by *angle* degrees, if supported by the platform.
6423
6424 **NOTE**: Under Win9x only TrueType fonts can be drawn by this
6425 function. In particular, a font different from ``wx.NORMAL_FONT``
6426 should be used as the it is not normally a TrueType
6427 font. ``wx.SWISS_FONT`` is an example of a font which is.
6428 """
6429 return _gdi_.PseudoDC_DrawRotatedText(*args, **kwargs)
6430
6431 def DrawRotatedTextPoint(*args, **kwargs):
6432 """
6433 DrawRotatedTextPoint(self, String text, Point pt, double angle)
6434
6435 Draws the text rotated by *angle* degrees, if supported by the platform.
6436
6437 **NOTE**: Under Win9x only TrueType fonts can be drawn by this
6438 function. In particular, a font different from ``wx.NORMAL_FONT``
6439 should be used as the it is not normally a TrueType
6440 font. ``wx.SWISS_FONT`` is an example of a font which is.
6441 """
6442 return _gdi_.PseudoDC_DrawRotatedTextPoint(*args, **kwargs)
6443
6444 def DrawLines(*args, **kwargs):
6445 """
6446 DrawLines(self, List points, int xoffset=0, int yoffset=0)
6447
6448 Draws lines using a sequence of `wx.Point` objects, adding the
6449 optional offset coordinate. The current pen is used for drawing the
6450 lines.
6451 """
6452 return _gdi_.PseudoDC_DrawLines(*args, **kwargs)
6453
6454 def DrawPolygon(*args, **kwargs):
6455 """
6456 DrawPolygon(self, List points, int xoffset=0, int yoffset=0,
6457 int fillStyle=ODDEVEN_RULE)
6458
6459 Draws a filled polygon using a sequence of `wx.Point` objects, adding
6460 the optional offset coordinate. The last argument specifies the fill
6461 rule: ``wx.ODDEVEN_RULE`` (the default) or ``wx.WINDING_RULE``.
6462
6463 The current pen is used for drawing the outline, and the current brush
6464 for filling the shape. Using a transparent brush suppresses
6465 filling. Note that wxWidgets automatically closes the first and last
6466 points.
6467 """
6468 return _gdi_.PseudoDC_DrawPolygon(*args, **kwargs)
6469
6470 def DrawLabel(*args, **kwargs):
6471 """
6472 DrawLabel(self, String text, Rect rect, int alignment=wxALIGN_LEFT|wxALIGN_TOP,
6473 int indexAccel=-1)
6474
6475 Draw *text* within the specified rectangle, abiding by the alignment
6476 flags. Will additionally emphasize the character at *indexAccel* if
6477 it is not -1.
6478 """
6479 return _gdi_.PseudoDC_DrawLabel(*args, **kwargs)
6480
6481 def DrawImageLabel(*args, **kwargs):
6482 """
6483 DrawImageLabel(self, String text, Bitmap image, Rect rect, int alignment=wxALIGN_LEFT|wxALIGN_TOP,
6484 int indexAccel=-1)
6485
6486 Draw *text* and an image (which may be ``wx.NullBitmap`` to skip
6487 drawing it) within the specified rectangle, abiding by the alignment
6488 flags. Will additionally emphasize the character at *indexAccel* if
6489 it is not -1.
6490 """
6491 return _gdi_.PseudoDC_DrawImageLabel(*args, **kwargs)
6492
6493 def DrawSpline(*args, **kwargs):
6494 """
6495 DrawSpline(self, List points)
6496
6497 Draws a spline between all given control points, (a list of `wx.Point`
6498 objects) using the current pen. The spline is drawn using a series of
6499 lines, using an algorithm taken from the X drawing program 'XFIG'.
6500 """
6501 return _gdi_.PseudoDC_DrawSpline(*args, **kwargs)
6502
6503 def Clear(*args, **kwargs):
6504 """
6505 Clear(self)
6506
6507 Clears the device context using the current background brush.
6508 """
6509 return _gdi_.PseudoDC_Clear(*args, **kwargs)
6510
6511 def SetFont(*args, **kwargs):
6512 """
6513 SetFont(self, Font font)
6514
6515 Sets the current font for the DC. It must be a valid font, in
6516 particular you should not pass ``wx.NullFont`` to this method.
6517 """
6518 return _gdi_.PseudoDC_SetFont(*args, **kwargs)
6519
6520 def SetPen(*args, **kwargs):
6521 """
6522 SetPen(self, Pen pen)
6523
6524 Sets the current pen for the DC.
6525
6526 If the argument is ``wx.NullPen``, the current pen is selected out of the
6527 device context, and the original pen restored.
6528 """
6529 return _gdi_.PseudoDC_SetPen(*args, **kwargs)
6530
6531 def SetBrush(*args, **kwargs):
6532 """
6533 SetBrush(self, Brush brush)
6534
6535 Sets the current brush for the DC.
6536
6537 If the argument is ``wx.NullBrush``, the current brush is selected out
6538 of the device context, and the original brush restored, allowing the
6539 current brush to be destroyed safely.
6540 """
6541 return _gdi_.PseudoDC_SetBrush(*args, **kwargs)
6542
6543 def SetBackground(*args, **kwargs):
6544 """
6545 SetBackground(self, Brush brush)
6546
6547 Sets the current background brush for the DC.
6548 """
6549 return _gdi_.PseudoDC_SetBackground(*args, **kwargs)
6550
6551 def SetBackgroundMode(*args, **kwargs):
6552 """
6553 SetBackgroundMode(self, int mode)
6554
6555 *mode* may be one of ``wx.SOLID`` and ``wx.TRANSPARENT``. This setting
6556 determines whether text will be drawn with a background colour or
6557 not.
6558 """
6559 return _gdi_.PseudoDC_SetBackgroundMode(*args, **kwargs)
6560
6561 def SetPalette(*args, **kwargs):
6562 """
6563 SetPalette(self, Palette palette)
6564
6565 If this is a window DC or memory DC, assigns the given palette to the
6566 window or bitmap associated with the DC. If the argument is
6567 ``wx.NullPalette``, the current palette is selected out of the device
6568 context, and the original palette restored.
6569 """
6570 return _gdi_.PseudoDC_SetPalette(*args, **kwargs)
6571
6572 def SetTextForeground(*args, **kwargs):
6573 """
6574 SetTextForeground(self, Colour colour)
6575
6576 Sets the current text foreground colour for the DC.
6577 """
6578 return _gdi_.PseudoDC_SetTextForeground(*args, **kwargs)
6579
6580 def SetTextBackground(*args, **kwargs):
6581 """
6582 SetTextBackground(self, Colour colour)
6583
6584 Sets the current text background colour for the DC.
6585 """
6586 return _gdi_.PseudoDC_SetTextBackground(*args, **kwargs)
6587
6588 def SetLogicalFunction(*args, **kwargs):
6589 """
6590 SetLogicalFunction(self, int function)
6591
6592 Sets the current logical function for the device context. This
1d5ee749
RD
6593 determines how a source pixel (from a pen or brush colour, combines
6594 with a destination pixel in the current device context.
27e45892
RD
6595
6596 The possible values and their meaning in terms of source and
6597 destination pixel values are as follows:
6598
6599 ================ ==========================
6600 wx.AND src AND dst
6601 wx.AND_INVERT (NOT src) AND dst
6602 wx.AND_REVERSE src AND (NOT dst)
6603 wx.CLEAR 0
6604 wx.COPY src
6605 wx.EQUIV (NOT src) XOR dst
6606 wx.INVERT NOT dst
6607 wx.NAND (NOT src) OR (NOT dst)
6608 wx.NOR (NOT src) AND (NOT dst)
6609 wx.NO_OP dst
6610 wx.OR src OR dst
6611 wx.OR_INVERT (NOT src) OR dst
6612 wx.OR_REVERSE src OR (NOT dst)
6613 wx.SET 1
6614 wx.SRC_INVERT NOT src
6615 wx.XOR src XOR dst
6616 ================ ==========================
6617
6618 The default is wx.COPY, which simply draws with the current
6619 colour. The others combine the current colour and the background using
6620 a logical operation. wx.INVERT is commonly used for drawing rubber
6621 bands or moving outlines, since drawing twice reverts to the original
6622 colour.
6623
6624 """
6625 return _gdi_.PseudoDC_SetLogicalFunction(*args, **kwargs)
6626
33d6fd3b
RD
6627 IdBounds = property(GetIdBounds,SetIdBounds,doc="See `GetIdBounds` and `SetIdBounds`")
6628 Len = property(GetLen,doc="See `GetLen`")
27e45892
RD
6629_gdi_.PseudoDC_swigregister(PseudoDC)
6630
70551f47 6631
32fe5131 6632