1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: SWIG definitions of various window classes
9 // Copyright: (c) 1998 by Total Control Software
10 // Licence: wxWindows license
11 /////////////////////////////////////////////////////////////////////////////
18 #include <wx/menuitem.h>
19 #include <wx/tooltip.h>
22 //----------------------------------------------------------------------
25 %include my_typemaps.i
27 // Import some definitions of other classes, etc.
33 %pragma(python) code = "import wx"
36 //---------------------------------------------------------------------------
38 class wxEvtHandler : public wxObject {
42 bool ProcessEvent(wxEvent& event);
43 void AddPendingEvent(wxEvent& event);
44 //bool SearchEventTable(wxEventTable& table, wxEvent& event);
46 bool GetEvtHandlerEnabled();
47 void SetEvtHandlerEnabled(bool enabled);
49 wxEvtHandler* GetNextHandler();
50 wxEvtHandler* GetPreviousHandler();
51 void SetNextHandler(wxEvtHandler* handler);
52 void SetPreviousHandler(wxEvtHandler* handler);
56 void Connect( int id, int lastId, int eventType, PyObject* func) {
57 if (PyCallable_Check(func)) {
58 self->Connect(id, lastId, eventType,
59 (wxObjectEventFunction) &wxPyCallback::EventThunker,
60 new wxPyCallback(func));
62 else if (func == Py_None) {
63 self->Disconnect(id, lastId, eventType,
64 (wxObjectEventFunction)
65 &wxPyCallback::EventThunker);
68 PyErr_SetString(PyExc_TypeError, "Expected callable object or None.");
72 bool Disconnect(int id, int lastId = -1,
73 wxEventType eventType = wxEVT_NULL) {
74 return self->Disconnect(id, lastId, eventType,
75 (wxObjectEventFunction)
76 &wxPyCallback::EventThunker);
81 void _setOORInfo(PyObject* _self) {
82 self->SetClientObject(new wxPyClientData(_self));
88 //----------------------------------------------------------------------
90 class wxValidator : public wxEvtHandler {
95 %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
98 wxWindow* GetWindow();
99 void SetWindow(wxWindow* window);
101 static bool IsSilent();
102 static void SetBellOnError(int doIt = TRUE);
107 //----------------------------------------------------------------------
109 class wxPyValidator : public wxValidator {
110 DECLARE_DYNAMIC_CLASS(wxPyValidator);
118 wxObject* Clone() const {
119 wxPyValidator* ptr = NULL;
120 wxPyValidator* self = (wxPyValidator*)this;
122 wxPyBeginBlockThreads();
123 if (self->m_myInst.findCallback("Clone")) {
125 ro = self->m_myInst.callCallbackObj(Py_BuildValue("()"));
127 SWIG_GetPtrObj(ro, (void **)&ptr, "_wxPyValidator_p");
131 wxPyEndBlockThreads();
133 // This is very dangerous!!! But is the only way I could find
134 // to squash a memory leak. Currently it is okay, but if the
135 // validator architecture in wxWindows ever changes, problems
142 DEC_PYCALLBACK_BOOL_WXWIN(Validate);
143 DEC_PYCALLBACK_BOOL_(TransferToWindow);
144 DEC_PYCALLBACK_BOOL_(TransferFromWindow);
149 IMP_PYCALLBACK_BOOL_WXWIN(wxPyValidator, wxValidator, Validate);
150 IMP_PYCALLBACK_BOOL_(wxPyValidator, wxValidator, TransferToWindow);
151 IMP_PYCALLBACK_BOOL_(wxPyValidator, wxValidator, TransferFromWindow);
153 IMPLEMENT_DYNAMIC_CLASS(wxPyValidator, wxValidator);
157 class wxPyValidator : public wxValidator {
161 void _setCallbackInfo(PyObject* self, PyObject* _class, int incref=TRUE);
162 %pragma(python) addtomethod = "__init__:self._setCallbackInfo(self, wxPyValidator, 1)"
164 %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
167 //----------------------------------------------------------------------
169 %apply int * INOUT { int* x, int* y };
171 class wxWindow : public wxEvtHandler {
173 wxWindow(wxWindow* parent, const wxWindowID id,
174 const wxPoint& pos = wxDefaultPosition,
175 const wxSize& size = wxDefaultSize,
177 char* name = "panel");
178 %name(wxPreWindow)wxWindow();
180 bool Create(wxWindow* parent, const wxWindowID id,
181 const wxPoint& pos = wxDefaultPosition,
182 const wxSize& size = wxDefaultSize,
184 char* name = "panel");
186 %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
187 %pragma(python) addtomethod = "wxPreWindow:val._setOORInfo(val)"
191 void Center(int direction = wxBOTH);
192 void Centre(int direction = wxBOTH);
193 void CentreOnParent(int direction = wxBOTH );
194 void CenterOnParent(int direction = wxBOTH );
195 void CentreOnScreen(int direction = wxBOTH );
196 void CenterOnScreen(int direction = wxBOTH );
200 // (uses apply'ed INOUT typemap, see above)
201 %name(ClientToScreenXY)void ClientToScreen(int* x, int* y);
202 wxPoint ClientToScreen(const wxPoint& pt);
204 bool Close(int force = FALSE);
206 void DestroyChildren();
207 bool IsBeingDeleted();
209 void DragAcceptFiles(bool accept);
211 void Enable(bool enable);
212 //bool FakePopupMenu(wxMenu* menu, int x, int y);
213 %name(FindWindowById) wxWindow* FindWindow(long id);
214 %name(FindWindowByName) wxWindow* FindWindow(const wxString& name);
216 wxColour GetBackgroundColour();
217 wxBorder GetBorder() const;
219 //wxList& GetChildren();
221 PyObject* GetChildren() {
222 wxWindowList& list = self->GetChildren();
223 return wxPy_ConvertList(&list, "wxWindow");
229 %name(GetClientSizeTuple) void GetClientSize(int *OUTPUT, int *OUTPUT);
230 wxSize GetClientSize();
232 // get the origin of the client area of the window relative to the
233 // window top left corner (the client area may be shifted because of
234 // the borders, scrollbars, other decorations...)
235 wxPoint GetClientAreaOrigin() const;
237 // get the client rectangle in window (i.e. client) coordinates
238 wxRect GetClientRect() const;
240 wxLayoutConstraints * GetConstraints();
241 wxEvtHandler* GetEventHandler();
244 wxColour GetForegroundColour();
245 wxWindow * GetGrandParent();
248 return wxPyGetWinHandle(self); //(long)self->GetHandle();
253 void SetLabel(const wxString& label);
255 wxWindow * GetParent();
256 %name(GetPositionTuple) void GetPosition(int *OUTPUT, int *OUTPUT);
257 wxPoint GetPosition();
259 int GetScrollThumb(int orientation);
260 int GetScrollPos(int orientation);
261 int GetScrollRange(int orientation);
262 %name(GetSizeTuple) void GetSize(int *OUTPUT, int *OUTPUT);
264 void GetTextExtent(const wxString& string, int *OUTPUT, int *OUTPUT);
265 %name(GetFullTextExtent)void GetTextExtent(const wxString& string,
266 int *OUTPUT, int *OUTPUT, int *OUTPUT, int* OUTPUT,
267 const wxFont* font = NULL); //, bool use16 = FALSE)
269 wxRegion GetUpdateRegion();
270 long GetWindowStyleFlag();
271 void SetWindowStyleFlag(long style);
272 void SetWindowStyle(long style);
273 bool HasScrollbar(int orient) const;
275 wxHitTest HitTest(const wxPoint& pt);
278 bool IsExposed( int x, int y, int w=0, int h=0 );
279 %name(IsExposedPoint) bool IsExposed( const wxPoint& pt );
280 %name(IsExposedRect) bool IsExposed( const wxRect& rect );
285 bool LoadFromResource(wxWindow* parent, const wxString& resourceName, const wxResourceTable* resourceTable = NULL);
287 void MakeModal(bool flag=TRUE);
288 %name(MoveXY)void Move(int x, int y, int flags = wxSIZE_USE_EXISTING);
289 void Move(const wxPoint& point, int flags = wxSIZE_USE_EXISTING);
291 wxEvtHandler* PopEventHandler(bool deleteHandler = FALSE);
292 void PushEventHandler(wxEvtHandler* handler);
294 // find the given handler in the event handler chain and remove (but
295 // not delete) it from the event handler chain, return TRUE if it was
296 // found and FALSE otherwise (this also results in an assert failure so
297 // this function should only be called when the handler is supposed to
299 bool RemoveEventHandler(wxEvtHandler *handler);
301 %name(PopupMenuXY)bool PopupMenu(wxMenu *menu, int x, int y);
302 bool PopupMenu(wxMenu *menu, const wxPoint& pos);
305 void Refresh(bool eraseBackground = TRUE, const wxRect* rect = NULL);
306 void RefreshRect(const wxRect& rect);
309 void RemoveChild(wxWindow* child);
310 bool Reparent( wxWindow* newParent );
312 // (uses apply'ed INOUT typemap, see above)
313 %name(ScreenToClientXY)void ScreenToClient(int *x, int *y);
314 wxPoint ScreenToClient(const wxPoint& pt);
316 void ScrollWindow(int dx, int dy, const wxRect* rect = NULL);
317 void SetAutoLayout(bool autoLayout);
318 bool GetAutoLayout();
319 void SetBackgroundColour(const wxColour& colour);
320 void SetConstraints(wxLayoutConstraints *constraints);
321 void UnsetConstraints(wxLayoutConstraints *constraints);
324 void SetFont(const wxFont& font);
325 void SetForegroundColour(const wxColour& colour);
327 void SetName(const wxString& name);
328 void SetScrollbar(int orientation, int position, int thumbSize, int range, int refresh = TRUE);
329 void SetScrollPos(int orientation, int pos, bool refresh = TRUE);
331 %name(SetDimensions) void SetSize(int x, int y, int width, int height, int sizeFlags=wxSIZE_AUTO);
333 void SetSize(const wxSize& size) {
337 void SetPosition(const wxPoint& pos, int flags = wxSIZE_USE_EXISTING) {
338 self->Move(pos, flags);
341 void SetRect(const wxRect& rect, int sizeFlags=wxSIZE_AUTO) {
342 self->SetSize(rect, sizeFlags);
346 void SetSizeHints(int minW=-1, int minH=-1, int maxW=-1, int maxH=-1, int incW=-1, int incH=-1);
347 %name(SetClientSizeWH)void SetClientSize(int width, int height);
348 void SetClientSize(const wxSize& size);
349 //void SetPalette(wxPalette* palette);
350 void SetCursor(const wxCursor& cursor);
351 void SetEventHandler(wxEvtHandler* handler);
352 void SetExtraStyle(long exStyle);
353 void SetTitle(const wxString& title);
354 bool Show(bool show=TRUE);
355 bool TransferDataFromWindow();
356 bool TransferDataToWindow();
357 void UpdateWindowUI();
359 void WarpPointer(int x, int y);
361 %name(ConvertDialogPointToPixels) wxPoint ConvertDialogToPixels(const wxPoint& pt);
362 %name(ConvertDialogSizeToPixels) wxSize ConvertDialogToPixels(const wxSize& sz);
364 %name(DLG_PNT) wxPoint ConvertDialogToPixels(const wxPoint& pt);
365 %name(DLG_SZE) wxSize ConvertDialogToPixels(const wxSize& sz);
367 %name(ConvertPixelPointToDialog) wxPoint ConvertPixelsToDialog(const wxPoint& pt);
368 %name(ConvertPixelSizeToDialog) wxSize ConvertPixelsToDialog(const wxSize& sz);
370 %name(SetToolTipString)void SetToolTip(const wxString &tip);
371 void SetToolTip(wxToolTip *tooltip);
372 wxToolTip* GetToolTip();
374 void SetSizer(wxSizer* sizer);
377 wxValidator* GetValidator();
378 void SetValidator(const wxValidator& validator);
381 void SetDropTarget(wxDropTarget* target);
382 wxDropTarget* GetDropTarget();
383 %pragma(python) addtomethod = "SetDropTarget:_args[0].thisown = 0"
386 wxSize GetBestSize();
388 void SetCaret(wxCaret *caret);
390 %pragma(python) addtoclass = "# replaces broken shadow method
391 def GetCaret(self, *_args, **_kwargs):
392 from misc2 import wxCaretPtr
393 val = apply(windowsc.wxWindow_GetCaret,(self,) + _args, _kwargs)
394 if val: val = wxCaretPtr(val)
402 wxString GetHelpText();
403 void SetHelpText(const wxString& helpText);
404 void SetHelpTextForId(const wxString& text);
406 bool ScrollLines(int lines);
407 bool ScrollPages(int pages);
413 static wxWindow* FindFocus();
414 static int NewControlId();
415 static int NextControlId(int id);
416 static int PrevControlId(int id);
418 void SetAcceleratorTable(const wxAcceleratorTable& accel);
419 wxAcceleratorTable *GetAcceleratorTable();
422 // A way to do the native draw first... Too bad it isn't in wxGTK too.
423 void OnPaint(wxPaintEvent& event);
426 wxButton* GetDefaultItem();
427 void SetDefaultItem(wxButton *btn);
433 %pragma(python) code = "
434 def wxDLG_PNT(win, point_or_x, y=None):
436 return win.ConvertDialogPointToPixels(point_or_x)
438 return win.ConvertDialogPointToPixels(wxPoint(point_or_x, y))
440 def wxDLG_SZE(win, size_width, height=None):
442 return win.ConvertDialogSizeToPixels(size_width)
444 return win.ConvertDialogSizeToPixels(wxSize(size_width, height))
450 wxWindow* wxWindow_FromHWND(unsigned long hWnd) {
451 wxWindow* win = new wxWindow;
453 win->SubclassWin(hWnd);
460 //---------------------------------------------------------------------------
462 class wxPanel : public wxWindow {
464 wxPanel(wxWindow* parent,
466 const wxPoint& pos = wxDefaultPosition,
467 const wxSize& size = wxDefaultSize,
468 long style = wxTAB_TRAVERSAL,
469 const char* name = "panel");
470 %name(wxPrePanel)wxPanel();
472 bool Create(wxWindow* parent,
474 const wxPoint& pos = wxDefaultPosition,
475 const wxSize& size = wxDefaultSize,
476 long style = wxTAB_TRAVERSAL,
477 const char* name = "panel");
479 %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
480 %pragma(python) addtomethod = "wxPrePanel:val._setOORInfo(val)"
486 //---------------------------------------------------------------------------
489 // TODO: Add wrappers for the wxScrollHelper class, make wxScrolledWindow
490 // derive from it and wxPanel.
493 class wxScrolledWindow : public wxPanel {
495 wxScrolledWindow(wxWindow* parent,
496 const wxWindowID id = -1,
497 const wxPoint& pos = wxDefaultPosition,
498 const wxSize& size = wxDefaultSize,
499 long style = wxHSCROLL | wxVSCROLL,
500 char* name = "scrolledWindow");
501 %name(wxPreScrolledWindow)wxScrolledWindow();
503 bool Create(wxWindow* parent,
504 const wxWindowID id = -1,
505 const wxPoint& pos = wxDefaultPosition,
506 const wxSize& size = wxDefaultSize,
507 long style = wxHSCROLL | wxVSCROLL,
508 char* name = "scrolledWindow");
510 %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
511 %pragma(python) addtomethod = "wxPreScrolledWindow:val._setOORInfo(val)"
513 void EnableScrolling(bool xScrolling, bool yScrolling);
514 int GetScrollPageSize(int orient);
515 void GetScrollPixelsPerUnit(int* OUTPUT, int* OUTPUT);
516 wxWindow* GetTargetWindow();
517 void GetVirtualSize(int* OUTPUT, int* OUTPUT);
519 void PrepareDC(wxDC& dc);
520 void Scroll(int x, int y);
521 void SetScrollbars(int pixelsPerUnitX, int pixelsPerUnitY,
522 int noUnitsX, int noUnitsY,
523 int xPos = 0, int yPos = 0, int noRefresh=FALSE);
524 void SetScrollPageSize(int orient, int pageSize);
525 void SetTargetWindow(wxWindow* window);
526 void GetViewStart(int* OUTPUT, int* OUTPUT);
527 %pragma(python) addtoclass = "ViewStart = GetViewStart"
529 void CalcScrolledPosition( int x, int y, int *OUTPUT, int *OUTPUT);
530 void CalcUnscrolledPosition( int x, int y, int *OUTPUT, int *OUTPUT);
532 void SetScale(double xs, double ys);
536 void AdjustScrollbars();
539 //----------------------------------------------------------------------
542 class wxMenu : public wxEvtHandler {
544 wxMenu(const wxString& title = wxEmptyString, long style = 0);
546 %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
548 void Append(int id, const wxString& item,
549 const wxString& helpString = wxEmptyString,
550 int checkable = FALSE);
551 %name(AppendMenu)void Append(int id, const wxString& item, wxMenu *subMenu,
552 const wxString& helpString = wxEmptyString);
553 %name(AppendItem)void Append(const wxMenuItem* item);
555 void AppendSeparator();
557 void Check(int id, bool flag);
558 bool IsChecked(int id);
559 void Enable(int id, bool enable);
560 bool IsEnabled(int id);
562 int FindItem(const wxString& itemString);
563 %name(FindItemById)wxMenuItem* FindItem(int id/*, wxMenu **menu = NULL*/);
566 void SetTitle(const wxString& title);
568 wxString GetLabel(int id);
569 void SetLabel(int id, const wxString& label);
571 wxString GetHelpString(int id);
572 void SetHelpString(int id, const wxString& helpString);
573 void UpdateUI(wxEvtHandler* source = NULL);
576 %name(DeleteItem)bool Delete(wxMenuItem *item);
577 bool Insert(size_t pos, wxMenuItem *item);
578 wxMenuItem *Remove(int id);
579 %name(RemoveItem) wxMenuItem *Remove(wxMenuItem *item);
582 void Destroy() { delete self; }
584 %name(DestroyId)bool Destroy(int id);
585 %name(DestroyItem)bool Destroy(wxMenuItem *item);
587 size_t GetMenuItemCount();
588 //wxMenuItemList& GetMenuItems();
590 PyObject* GetMenuItems() {
591 wxMenuItemList& list = self->GetMenuItems();
592 return wxPy_ConvertList(&list, "wxMenuItem");
596 void SetEventHandler(wxEvtHandler *handler);
597 wxEvtHandler *GetEventHandler();
599 void SetInvokingWindow(wxWindow *win);
600 wxWindow *GetInvokingWindow();
606 void SetParent(wxMenu *parent);
611 //----------------------------------------------------------------------
613 class wxMenuBar : public wxWindow {
615 wxMenuBar(long style = 0);
617 %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
619 bool Append(wxMenu *menu, const wxString& title);
620 bool Insert(size_t pos, wxMenu *menu, const wxString& title);
621 size_t GetMenuCount();
622 wxMenu *GetMenu(size_t pos);
623 wxMenu *Replace(size_t pos, wxMenu *menu, const wxString& title);
624 wxMenu *Remove(size_t pos);
625 void EnableTop(size_t pos, bool enable);
626 void SetLabelTop(size_t pos, const wxString& label);
627 wxString GetLabelTop(size_t pos);
628 int FindMenu(const wxString& title);
629 int FindMenuItem(const wxString& menuString, const wxString& itemString);
630 %name(FindItemById)wxMenuItem* FindItem(int id/*, wxMenu **menu = NULL*/);
631 void Enable(int id, bool enable);
632 void Check(int id, bool check);
633 bool IsChecked(int id);
634 bool IsEnabled(int id);
636 void SetLabel(int id, const wxString &label);
637 wxString GetLabel(int id);
639 void SetHelpString(int id, const wxString& helpString);
640 wxString GetHelpString(int id);
645 //----------------------------------------------------------------------
647 class wxMenuItem : public wxObject {
649 wxMenuItem(wxMenu* parentMenu=NULL, int id=wxID_SEPARATOR,
650 const wxString& text = wxEmptyString,
651 const wxString& help = wxEmptyString,
652 bool isCheckable = FALSE, wxMenu* subMenu = NULL);
659 void SetText(const wxString& str);
661 const wxString& GetText();
662 void SetCheckable(bool checkable);
665 void SetSubMenu(wxMenu *menu);
666 wxMenu *GetSubMenu();
667 void Enable(bool enable = TRUE);
669 void Check(bool check = TRUE);
672 void SetHelp(const wxString& str);
673 const wxString& GetHelp();
674 wxAcceleratorEntry *GetAccel();
675 void SetAccel(wxAcceleratorEntry *accel);
677 static wxString GetLabelFromText(const wxString& text);
679 // wxOwnerDrawn methods
681 void SetFont(const wxFont& font);
683 void SetTextColour(const wxColour& colText);
684 wxColour GetTextColour();
685 void SetBackgroundColour(const wxColour& colBack);
686 wxColour GetBackgroundColour();
687 void SetBitmaps(const wxBitmap& bmpChecked,
688 const wxBitmap& bmpUnchecked = wxNullBitmap);
689 void SetBitmap(const wxBitmap& bmpChecked);
690 wxBitmap GetBitmap(bool bChecked = TRUE);
691 void SetMarginWidth(int nWidth);
692 int GetMarginWidth();
693 static int GetDefaultMarginWidth();
694 //void SetName(const wxString& strName);
695 //const wxString& GetName();
696 //void SetCheckable(bool checkable);
697 //bool IsCheckable();
699 void ResetOwnerDrawn();
703 //---------------------------------------------------------------------------