]> git.saurik.com Git - wxWidgets.git/blame - wxPython/src/_sizers.i
embedded sample's README updates
[wxWidgets.git] / wxPython / src / _sizers.i
CommitLineData
d14a1e28
RD
1/////////////////////////////////////////////////////////////////////////////
2// Name: _sizers.i
3// Purpose: SWIG interface defs for the Sizers
4//
5// Author: Robin Dunn
6//
7// Created: 18-Sept-1999
8// RCS-ID: $Id$
9// Copyright: (c) 2003 by Total Control Software
10// Licence: wxWindows license
11/////////////////////////////////////////////////////////////////////////////
12
13// Not a %module
14
15
16//---------------------------------------------------------------------------
17
18%{
19%}
20
21//---------------------------------------------------------------------------
22%newgroup;
23
24
25class wxSizerItem : public wxObject {
26public:
27 wxSizerItem();
28
29 %name(SizerItemSpacer) wxSizerItem( int width, int height, int proportion, int flag, int border, wxObject* userData);
30 %name(SizerItemWindow) wxSizerItem( wxWindow *window, int proportion, int flag, int border, wxObject* userData );
31 %name(SizerItemSizer) wxSizerItem( wxSizer *sizer, int proportion, int flag, int border, wxObject* userData );
32
33 void DeleteWindows();
34 void DetachSizer();
35
36 wxSize GetSize();
37 wxSize CalcMin();
38 void SetDimension( wxPoint pos, wxSize size );
39
40 wxSize GetMinSize();
41 void SetInitSize( int x, int y );
42
43 %name(SetRatioWH) void SetRatio( int width, int height );
44 %name(SetRatioSize) void SetRatio( wxSize size );
45 void SetRatio( float ratio );
46 float GetRatio();
47
48 bool IsWindow();
49 bool IsSizer();
50 bool IsSpacer();
51
52 void SetProportion( int proportion );
53 int GetProportion();
52868a75
RD
54 %pythoncode { SetOption = SetProportion}
55 %pythoncode { GetOption = GetProportion}
d14a1e28
RD
56
57 void SetFlag( int flag );
58 int GetFlag();
59
60 void SetBorder( int border );
61 int GetBorder();
62
63 wxWindow *GetWindow();
64 void SetWindow( wxWindow *window );
65
66 wxSizer *GetSizer();
67 void SetSizer( wxSizer *sizer );
68
69 const wxSize& GetSpacer();
70 void SetSpacer( const wxSize &size );
71
72 void Show( bool show );
73 bool IsShown();
74
75 wxPoint GetPosition();
76
77 // wxObject* GetUserData();
78 %extend {
79 // Assume that the user data is a wxPyUserData object and return the contents
80 PyObject* GetUserData() {
81 wxPyUserData* data = (wxPyUserData*)self->GetUserData();
82 if (data) {
83 Py_INCREF(data->m_obj);
84 return data->m_obj;
85 } else {
86 Py_INCREF(Py_None);
87 return Py_None;
88 }
89 }
90 }
91};
92
93
94//---------------------------------------------------------------------------
95
96%{
97// Figure out the type of the sizer item
98
99struct wxPySizerItemInfo {
100 wxPySizerItemInfo()
dd9f7fea
RD
101 : window(NULL), sizer(NULL), gotSize(False),
102 size(wxDefaultSize), gotPos(False), pos(-1)
d14a1e28
RD
103 {}
104
105 wxWindow* window;
106 wxSizer* sizer;
107 bool gotSize;
108 wxSize size;
109 bool gotPos;
110 int pos;
111};
112
113static wxPySizerItemInfo wxPySizerItemTypeHelper(PyObject* item, bool checkSize, bool checkIdx ) {
114
115 wxPySizerItemInfo info;
116 wxSize size;
117 wxSize* sizePtr = &size;
118
119 // Find out what the type of the item is
120 // try wxWindow
121 if ( ! wxPyConvertSwigPtr(item, (void**)&info.window, wxT("wxWindow")) ) {
122 PyErr_Clear();
123 info.window = NULL;
124
125 // try wxSizer
126 if ( ! wxPyConvertSwigPtr(item, (void**)&info.sizer, wxT("wxSizer")) ) {
127 PyErr_Clear();
128 info.sizer = NULL;
129
130 // try wxSize or (w,h)
131 if ( checkSize && wxSize_helper(item, &sizePtr)) {
132 info.size = *sizePtr;
dd9f7fea 133 info.gotSize = True;
d14a1e28
RD
134 }
135
136 // or a single int
137 if (checkIdx && PyInt_Check(item)) {
138 info.pos = PyInt_AsLong(item);
dd9f7fea 139 info.gotPos = True;
d14a1e28
RD
140 }
141 }
142 }
143
144 if ( !(info.window || info.sizer || (checkSize && info.gotSize) || (checkIdx && info.gotPos)) ) {
145 // no expected type, figure out what kind of error message to generate
146 if ( !checkSize && !checkIdx )
147 PyErr_SetString(PyExc_TypeError, "wxWindow or wxSizer expected for item");
148 else if ( checkSize && !checkIdx )
149 PyErr_SetString(PyExc_TypeError, "wxWindow, wxSizer, wxSize, or (w,h) expected for item");
150 else if ( !checkSize && checkIdx)
151 PyErr_SetString(PyExc_TypeError, "wxWindow, wxSizer or int (position) expected for item");
152 else
153 // can this one happen?
154 PyErr_SetString(PyExc_TypeError, "wxWindow, wxSizer, wxSize, or (w,h) or int (position) expected for item");
155 }
156
157 return info;
158}
159%}
160
161
162
163
164class wxSizer : public wxObject {
165public:
166 // wxSizer(); **** abstract, can't instantiate
167 // ~wxSizer();
168
169 %extend {
170 void _setOORInfo(PyObject* _self) {
171 self->SetClientObject(new wxPyOORClientData(_self));
172 }
173
174
175 void Add(PyObject* item, int proportion=0, int flag=0, int border=0,
176 PyObject* userData=NULL) {
177
178 wxPyUserData* data = NULL;
da32eb53 179 bool blocked = wxPyBeginBlockThreads();
dd9f7fea 180 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, True, False);
d14a1e28
RD
181 if ( userData && (info.window || info.sizer || info.gotSize) )
182 data = new wxPyUserData(userData);
da32eb53 183 wxPyEndBlockThreads(blocked);
d14a1e28
RD
184
185 // Now call the real Add method if a valid item type was found
186 if ( info.window )
187 self->Add(info.window, proportion, flag, border, data);
188 else if ( info.sizer )
189 self->Add(info.sizer, proportion, flag, border, data);
190 else if (info.gotSize)
191 self->Add(info.size.GetWidth(), info.size.GetHeight(),
192 proportion, flag, border, data);
193 }
194
195
196 void Insert(int before, PyObject* item, int proportion=0, int flag=0,
197 int border=0, PyObject* userData=NULL) {
198
199 wxPyUserData* data = NULL;
da32eb53 200 bool blocked = wxPyBeginBlockThreads();
dd9f7fea 201 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, True, False);
d14a1e28
RD
202 if ( userData && (info.window || info.sizer || info.gotSize) )
203 data = new wxPyUserData(userData);
da32eb53 204 wxPyEndBlockThreads(blocked);
d14a1e28
RD
205
206 // Now call the real Insert method if a valid item type was found
207 if ( info.window )
208 self->Insert(before, info.window, proportion, flag, border, data);
209 else if ( info.sizer )
210 self->Insert(before, info.sizer, proportion, flag, border, data);
211 else if (info.gotSize)
212 self->Insert(before, info.size.GetWidth(), info.size.GetHeight(),
213 proportion, flag, border, data);
214 }
215
216
217
218 void Prepend(PyObject* item, int proportion=0, int flag=0, int border=0,
219 PyObject* userData=NULL) {
220
221 wxPyUserData* data = NULL;
da32eb53 222 bool blocked = wxPyBeginBlockThreads();
dd9f7fea 223 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, True, False);
d14a1e28
RD
224 if ( userData && (info.window || info.sizer || info.gotSize) )
225 data = new wxPyUserData(userData);
da32eb53 226 wxPyEndBlockThreads(blocked);
d14a1e28
RD
227
228 // Now call the real Prepend method if a valid item type was found
229 if ( info.window )
230 self->Prepend(info.window, proportion, flag, border, data);
231 else if ( info.sizer )
232 self->Prepend(info.sizer, proportion, flag, border, data);
233 else if (info.gotSize)
234 self->Prepend(info.size.GetWidth(), info.size.GetHeight(),
235 proportion, flag, border, data);
236 }
237
238
239 bool Remove(PyObject* item) {
da32eb53 240 bool blocked = wxPyBeginBlockThreads();
dd9f7fea 241 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, True);
da32eb53 242 wxPyEndBlockThreads(blocked);
d14a1e28
RD
243 if ( info.window )
244 return self->Remove(info.window);
245 else if ( info.sizer )
246 return self->Remove(info.sizer);
247 else if ( info.gotPos )
248 return self->Remove(info.pos);
249 else
dd9f7fea 250 return False;
d14a1e28
RD
251 }
252
253
dd9f7fea 254 void _SetItemMinSize(PyObject* item, const wxSize& size) {
da32eb53 255 bool blocked = wxPyBeginBlockThreads();
dd9f7fea 256 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, True);
da32eb53 257 wxPyEndBlockThreads(blocked);
d14a1e28
RD
258 if ( info.window )
259 self->SetItemMinSize(info.window, size);
260 else if ( info.sizer )
261 self->SetItemMinSize(info.sizer, size);
262 else if ( info.gotPos )
263 self->SetItemMinSize(info.pos, size);
264 }
265 }
266
267 %name(AddItem) void Add( wxSizerItem *item );
268 %name(InsertItem) void Insert( size_t index, wxSizerItem *item );
269 %name(PrependItem) void Prepend( wxSizerItem *item );
270
271
272 %pythoncode {
273 def AddMany(self, widgets):
274 for childinfo in widgets:
dd9f7fea 275 if type(childinfo) != type(()) or (len(childinfo) == 2 and type(childinfo[0]) == type(1)):
d14a1e28
RD
276 childinfo = (childinfo, )
277 self.Add(*childinfo)
278
d147c724 279 %# for backwards compatibility only, please do not use in new code
d14a1e28
RD
280 AddWindow = AddSizer = AddSpacer = Add
281 PrependWindow = PrependSizer = PrependSpacer = Prepend
282 InsertWindow = InsertSizer = InsertSpacer = Insert
283 RemoveWindow = RemoveSizer = RemovePos = Remove
284
285
286 def SetItemMinSize(self, item, *args):
287 if len(args) == 2:
288 return self._SetItemMinSize(item, args)
289 else:
290 return self._SetItemMinSize(item, args[0])
291 }
292
293
294 void SetDimension( int x, int y, int width, int height );
e5e66a2d 295 void SetMinSize( const wxSize &size );
d14a1e28
RD
296
297 wxSize GetSize();
298 wxPoint GetPosition();
299 wxSize GetMinSize();
300
301 %pythoncode {
302 def GetSizeTuple(self):
303 return self.GetSize().asTuple()
304 def GetPositionTuple(self):
305 return self.GetPosition().asTuple()
306 def GetMinSizeTuple(self):
307 return self.GetMinSize().asTuple()
308 }
309
310 virtual void RecalcSizes();
311 virtual wxSize CalcMin();
312
313 void Layout();
314
315 wxSize Fit( wxWindow *window );
316 void FitInside( wxWindow *window );
317
318 void SetSizeHints( wxWindow *window );
319 void SetVirtualSizeHints( wxWindow *window );
320
dd9f7fea 321 void Clear( bool delete_windows=False );
d14a1e28
RD
322 void DeleteWindows();
323
324
325 // wxList& GetChildren();
326 %extend {
327 PyObject* GetChildren() {
328 wxSizerItemList& list = self->GetChildren();
329 return wxPy_ConvertList(&list);
330 }
331 }
332
333
334 // Manage whether individual windows or sub-sizers are considered
335 // in the layout calculations or not.
336
337 %extend {
dd9f7fea
RD
338 void Show(PyObject* item, bool show = True) {
339 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, False);
d14a1e28
RD
340 if ( info.window )
341 self->Show(info.window, show);
342 else if ( info.sizer )
343 self->Show(info.sizer, show);
344 }
345
346
347 void Hide(PyObject* item) {
dd9f7fea 348 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, False);
d14a1e28
RD
349 if ( info.window )
350 self->Hide(info.window);
351 else if ( info.sizer )
352 self->Hide(info.sizer);
353 }
354
355
356 bool IsShown(PyObject* item) {
dd9f7fea 357 wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, False);
d14a1e28
RD
358 if ( info.window )
359 return self->IsShown(info.window);
360 else if ( info.sizer )
361 return self->IsShown(info.sizer);
362 else
dd9f7fea 363 return False;
d14a1e28
RD
364 }
365 }
366
367
368 // Recursively call wxWindow::Show() on all sizer items.
369 void ShowItems(bool show);
370
371};
372
373
374//---------------------------------------------------------------------------
375// Use this one for deriving Python classes from
376%{
377// See pyclasses.h
378IMP_PYCALLBACK___pure(wxPySizer, wxSizer, RecalcSizes);
379IMP_PYCALLBACK_wxSize__pure(wxPySizer, wxSizer, CalcMin);
380IMPLEMENT_DYNAMIC_CLASS(wxPySizer, wxSizer);
381%}
382
383
384
385class wxPySizer : public wxSizer {
386public:
2b9048c5 387 %pythonAppend wxPySizer "self._setCallbackInfo(self, PySizer);self._setOORInfo(self)"
d14a1e28
RD
388
389 wxPySizer();
390 void _setCallbackInfo(PyObject* self, PyObject* _class);
391};
392
393
394//---------------------------------------------------------------------------
395%newgroup;
396
397class wxBoxSizer : public wxSizer {
398public:
2b9048c5 399 %pythonAppend wxBoxSizer "self._setOORInfo(self)"
d14a1e28
RD
400
401 wxBoxSizer(int orient = wxHORIZONTAL);
402
403 int GetOrientation();
404 void SetOrientation(int orient);
405 void RecalcSizes();
406 wxSize CalcMin();
407};
408
409//---------------------------------------------------------------------------
410%newgroup;
411
412class wxStaticBoxSizer : public wxBoxSizer {
413public:
2b9048c5 414 %pythonAppend wxStaticBoxSizer "self._setOORInfo(self)"
d14a1e28
RD
415
416 wxStaticBoxSizer(wxStaticBox *box, int orient = wxHORIZONTAL);
417
418 wxStaticBox *GetStaticBox();
419 void RecalcSizes();
420 wxSize CalcMin();
421};
422
423//---------------------------------------------------------------------------
424%newgroup;
425
426class wxGridSizer: public wxSizer
427{
428public:
2b9048c5 429 %pythonAppend wxGridSizer "self._setOORInfo(self)"
d14a1e28
RD
430
431 wxGridSizer( int rows=1, int cols=0, int vgap=0, int hgap=0 );
432
433 void RecalcSizes();
434 wxSize CalcMin();
435
436 void SetCols( int cols );
437 void SetRows( int rows );
438 void SetVGap( int gap );
439 void SetHGap( int gap );
440 int GetCols();
441 int GetRows();
442 int GetVGap();
443 int GetHGap();
444};
445
446//---------------------------------------------------------------------------
447%newgroup;
448
449enum wxFlexSizerGrowMode
450{
451 // don't resize the cells in non-flexible direction at all
452 wxFLEX_GROWMODE_NONE,
453
454 // uniformly resize only the specified ones (default)
455 wxFLEX_GROWMODE_SPECIFIED,
456
457 // uniformly resize all cells
458 wxFLEX_GROWMODE_ALL
459};
460
461
462class wxFlexGridSizer: public wxGridSizer
463{
464public:
2b9048c5 465 %pythonAppend wxFlexGridSizer "self._setOORInfo(self)"
d14a1e28
RD
466
467 wxFlexGridSizer( int rows=1, int cols=0, int vgap=0, int hgap=0 );
468
469 void RecalcSizes();
470 wxSize CalcMin();
471
472 void AddGrowableRow( size_t idx, int proportion = 0 );
473 void RemoveGrowableRow( size_t idx );
474 void AddGrowableCol( size_t idx, int proportion = 0 );
475 void RemoveGrowableCol( size_t idx );
476
477 // the sizer cells may grow in both directions, not grow at all or only
478 // grow in one direction but not the other
479
480 // the direction may be wxVERTICAL, wxHORIZONTAL or wxBOTH (default)
481 void SetFlexibleDirection(int direction);
482 int GetFlexibleDirection();
483
484 // note that the grow mode only applies to the direction which is not
485 // flexible
486 void SetNonFlexibleGrowMode(wxFlexSizerGrowMode mode);
487 wxFlexSizerGrowMode GetNonFlexibleGrowMode();
dd9f7fea
RD
488
489 // Read-only access to the row heights and col widths arrays
490 const wxArrayInt& GetRowHeights() const;
491 const wxArrayInt& GetColWidths() const;
d14a1e28
RD
492};
493
494//---------------------------------------------------------------------------