]> git.saurik.com Git - wxWidgets.git/blame - include/wx/popupwin.h
fix wxBitmapComboBox Gtk-CRITICAL assertion `GTK_IS_ENTRY (entry)' failed
[wxWidgets.git] / include / wx / popupwin.h
CommitLineData
1e6feb95
VZ
1///////////////////////////////////////////////////////////////////////////////
2// Name: wx/popupwin.h
3// Purpose: wxPopupWindow interface declaration
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 06.01.01
7// RCS-ID: $Id$
8// Copyright: (c) 2001 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
526954c5 9// Licence: wxWindows licence
1e6feb95
VZ
10///////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_POPUPWIN_H_BASE_
13#define _WX_POPUPWIN_H_BASE_
14
2ecf902b 15#include "wx/defs.h"
1e6feb95
VZ
16
17#if wxUSE_POPUPWIN
2ecf902b 18
42b0d8b9 19#include "wx/nonownedwnd.h"
2ecf902b 20
1e6feb95
VZ
21// ----------------------------------------------------------------------------
22// wxPopupWindow: a special kind of top level window used for popup menus,
23// combobox popups and such.
24// ----------------------------------------------------------------------------
25
53a2db12 26class WXDLLIMPEXP_CORE wxPopupWindowBase : public wxNonOwnedWindow
1e6feb95
VZ
27{
28public:
29 wxPopupWindowBase() { }
799ea011 30 virtual ~wxPopupWindowBase();
1e6feb95
VZ
31
32 // create the popup window
33 //
34 // style may only contain border flags
35 bool Create(wxWindow *parent, int style = wxBORDER_NONE);
36
37 // move the popup window to the right position, i.e. such that it is
38 // entirely visible
39 //
40 // the popup is positioned at ptOrigin + size if it opens below and to the
41 // right (default), at ptOrigin - sizePopup if it opens above and to the
42 // left &c
43 //
44 // the point must be given in screen coordinates!
45 virtual void Position(const wxPoint& ptOrigin,
46 const wxSize& size);
fc7a2a60 47
7e548f6b 48 virtual bool IsTopLevel() const { return true; }
bd507486 49
c0c133e1 50 wxDECLARE_NO_COPY_CLASS(wxPopupWindowBase);
1e6feb95
VZ
51};
52
19193a2c 53
1e6feb95 54// include the real class declaration
0872eaf9 55#if defined(__WXMSW__)
1e6feb95 56 #include "wx/msw/popupwin.h"
0872eaf9 57#elif defined(__WXPM__)
19193a2c 58 #include "wx/os2/popupwin.h"
1be7a35c 59#elif defined(__WXGTK20__)
9f41d601 60 #include "wx/gtk/popupwin.h"
1be7a35c
MR
61#elif defined(__WXGTK__)
62 #include "wx/gtk1/popupwin.h"
0872eaf9 63#elif defined(__WXX11__)
83df96d6 64 #include "wx/x11/popupwin.h"
0872eaf9 65#elif defined(__WXMOTIF__)
833a51f6 66 #include "wx/motif/popupwin.h"
42b0d8b9
VS
67#elif defined(__WXDFB__)
68 #include "wx/dfb/popupwin.h"
e4346967 69#elif defined(__WXMAC__)
ef0e9220 70 #include "wx/osx/popupwin.h"
1e6feb95
VZ
71#else
72 #error "wxPopupWindow is not supported under this platform."
73#endif
74
75// ----------------------------------------------------------------------------
76// wxPopupTransientWindow: a wxPopupWindow which disappears automatically
77// when the user clicks mouse outside it or if it loses focus in any other way
78// ----------------------------------------------------------------------------
79
b5dbe15d
VS
80class WXDLLIMPEXP_FWD_CORE wxPopupWindowHandler;
81class WXDLLIMPEXP_FWD_CORE wxPopupFocusHandler;
fbfb3fb3 82
53a2db12 83class WXDLLIMPEXP_CORE wxPopupTransientWindow : public wxPopupWindow
1e6feb95
VZ
84{
85public:
86 // ctors
87 wxPopupTransientWindow() { Init(); }
758bce95 88 wxPopupTransientWindow(wxWindow *parent, int style = wxBORDER_NONE);
1e6feb95
VZ
89
90 virtual ~wxPopupTransientWindow();
91
92 // popup the window (this will show it too) and keep focus at winFocus
93 // (or itself if it's NULL), dismiss the popup if we lose focus
94 virtual void Popup(wxWindow *focus = NULL);
95
96 // hide the window
97 virtual void Dismiss();
ea1ad04b 98
7e25f59e
VZ
99 // can the window be dismissed now?
100 //
101 // VZ: where is this used??
ea1ad04b 102 virtual bool CanDismiss()
7e548f6b 103 { return true; }
1e6feb95 104
7e548f6b 105 // called when a mouse is pressed while the popup is shown: return true
1e6feb95 106 // from here to prevent its normal processing by the popup (which consists
6d090da1 107 // in dismissing it if the mouse is clicked outside it)
1e6feb95
VZ
108 virtual bool ProcessLeftDown(wxMouseEvent& event);
109
537a0880
RR
110 // Overridden to grab the input on some plaforms
111 virtual bool Show( bool show = true );
2ecf902b 112
f9e19204
VZ
113 // Override to implement delayed destruction of this window.
114 virtual bool Destroy();
115
1e6feb95
VZ
116protected:
117 // common part of all ctors
118 void Init();
119
120 // this is called when the popup is disappeared because of anything
121 // else but direct call to Dismiss()
122 virtual void OnDismiss();
123
124 // dismiss and notify the derived class
125 void DismissAndNotify();
126
127 // remove our event handlers
128 void PopHandlers();
129
276612f7
RD
130 // get alerted when child gets deleted from under us
131 void OnDestroy(wxWindowDestroyEvent& event);
132
25fe875d
VZ
133#if defined(__WXMSW__) ||(defined(__WXMAC__) && wxOSX_USE_CARBON)
134 // Check if the mouse needs to be captured or released: we must release
135 // when it's inside our window if we want the embedded controls to work.
414f2513
RD
136 void OnIdle(wxIdleEvent& event);
137#endif
0872eaf9 138
1e6feb95
VZ
139 // the child of this popup if any
140 wxWindow *m_child;
141
142 // the window which has the focus while we're shown
143 wxWindow *m_focus;
144
d7cff34d 145 // these classes may call our DismissAndNotify()
1e6feb95
VZ
146 friend class wxPopupWindowHandler;
147 friend class wxPopupFocusHandler;
6c3422e9 148
d7cff34d
VZ
149 // the handlers we created, may be NULL (if not, must be deleted)
150 wxPopupWindowHandler *m_handlerPopup;
151 wxPopupFocusHandler *m_handlerFocus;
152
414f2513 153 DECLARE_EVENT_TABLE()
6c3422e9 154 DECLARE_DYNAMIC_CLASS(wxPopupTransientWindow)
c0c133e1 155 wxDECLARE_NO_COPY_CLASS(wxPopupTransientWindow);
1e6feb95
VZ
156};
157
c9cdd31d 158#if wxUSE_COMBOBOX && defined(__WXUNIVERSAL__)
1e6feb95
VZ
159
160// ----------------------------------------------------------------------------
161// wxPopupComboWindow: wxPopupTransientWindow used by wxComboBox
162// ----------------------------------------------------------------------------
163
b5dbe15d
VS
164class WXDLLIMPEXP_FWD_CORE wxComboBox;
165class WXDLLIMPEXP_FWD_CORE wxComboCtrl;
1e6feb95 166
53a2db12 167class WXDLLIMPEXP_CORE wxPopupComboWindow : public wxPopupTransientWindow
1e6feb95
VZ
168{
169public:
6b598e05 170 wxPopupComboWindow() { m_combo = NULL; }
a57d600f 171 wxPopupComboWindow(wxComboCtrl *parent);
1e6feb95 172
a57d600f 173 bool Create(wxComboCtrl *parent);
1e6feb95
VZ
174
175 // position the window correctly relatively to the combo
176 void PositionNearCombo();
177
178protected:
179 // notify the combo here
180 virtual void OnDismiss();
181
e0c83227
VZ
182 // forward the key presses to the combobox
183 void OnKeyDown(wxKeyEvent& event);
184
1e6feb95 185 // the parent combobox
a57d600f 186 wxComboCtrl *m_combo;
6c3422e9 187
e0c83227 188 DECLARE_EVENT_TABLE()
6c3422e9 189 DECLARE_DYNAMIC_CLASS(wxPopupComboWindow)
1e6feb95
VZ
190};
191
c9cdd31d 192#endif // wxUSE_COMBOBOX && defined(__WXUNIVERSAL__)
1e6feb95
VZ
193
194#endif // wxUSE_POPUPWIN
195
196#endif // _WX_POPUPWIN_H_BASE_