]> git.saurik.com Git - wxWidgets.git/blame - include/wx/popupwin.h
finally really fixes IRIX build:
[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>
65571936 9// License: wxWindows licence
1e6feb95
VZ
10///////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_POPUPWIN_H_BASE_
13#define _WX_POPUPWIN_H_BASE_
14
12028905 15#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
6522713c 16 #pragma interface "popupwinbase.h"
1e6feb95
VZ
17#endif
18
2ecf902b 19#include "wx/defs.h"
1e6feb95
VZ
20
21#if wxUSE_POPUPWIN
2ecf902b
WS
22
23#include "wx/window.h"
24
1e6feb95
VZ
25// ----------------------------------------------------------------------------
26// wxPopupWindow: a special kind of top level window used for popup menus,
27// combobox popups and such.
28// ----------------------------------------------------------------------------
29
30class WXDLLEXPORT wxPopupWindowBase : public wxWindow
31{
32public:
33 wxPopupWindowBase() { }
799ea011 34 virtual ~wxPopupWindowBase();
1e6feb95
VZ
35
36 // create the popup window
37 //
38 // style may only contain border flags
39 bool Create(wxWindow *parent, int style = wxBORDER_NONE);
40
41 // move the popup window to the right position, i.e. such that it is
42 // entirely visible
43 //
44 // the popup is positioned at ptOrigin + size if it opens below and to the
45 // right (default), at ptOrigin - sizePopup if it opens above and to the
46 // left &c
47 //
48 // the point must be given in screen coordinates!
49 virtual void Position(const wxPoint& ptOrigin,
50 const wxSize& size);
fc7a2a60 51
7e548f6b 52 virtual bool IsTopLevel() const { return true; }
bd507486 53
fc7a2a60 54 DECLARE_NO_COPY_CLASS(wxPopupWindowBase)
1e6feb95
VZ
55};
56
19193a2c 57
1e6feb95 58// include the real class declaration
0872eaf9 59#if defined(__WXMSW__)
1e6feb95 60 #include "wx/msw/popupwin.h"
0872eaf9 61#elif defined(__WXPM__)
19193a2c 62 #include "wx/os2/popupwin.h"
0872eaf9 63#elif defined(__WXGTK__)
9f41d601 64 #include "wx/gtk/popupwin.h"
0872eaf9 65#elif defined(__WXX11__)
83df96d6 66 #include "wx/x11/popupwin.h"
0872eaf9 67#elif defined(__WXMOTIF__)
833a51f6 68 #include "wx/motif/popupwin.h"
0872eaf9 69#elif defined(__WXMGL__)
544c782d 70 #include "wx/mgl/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
fbfb3fb3
VZ
80class WXDLLEXPORT wxPopupWindowHandler;
81class WXDLLEXPORT wxPopupFocusHandler;
82
1e6feb95
VZ
83class WXDLLEXPORT wxPopupTransientWindow : public wxPopupWindow
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
VZ
106 // from here to prevent its normal processing by the popup (which consists
107 // in dismissing it if the mouse is cilcked outside it)
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
1e6feb95
VZ
113protected:
114 // common part of all ctors
115 void Init();
116
117 // this is called when the popup is disappeared because of anything
118 // else but direct call to Dismiss()
119 virtual void OnDismiss();
120
121 // dismiss and notify the derived class
122 void DismissAndNotify();
123
124 // remove our event handlers
125 void PopHandlers();
126
276612f7
RD
127 // get alerted when child gets deleted from under us
128 void OnDestroy(wxWindowDestroyEvent& event);
129
414f2513
RD
130#ifdef __WXMSW__
131 // check if the mouse needs captured or released
132 void OnIdle(wxIdleEvent& event);
133#endif
0872eaf9 134
1e6feb95
VZ
135 // the child of this popup if any
136 wxWindow *m_child;
137
138 // the window which has the focus while we're shown
139 wxWindow *m_focus;
140
d7cff34d 141 // these classes may call our DismissAndNotify()
1e6feb95
VZ
142 friend class wxPopupWindowHandler;
143 friend class wxPopupFocusHandler;
6c3422e9 144
d7cff34d
VZ
145 // the handlers we created, may be NULL (if not, must be deleted)
146 wxPopupWindowHandler *m_handlerPopup;
147 wxPopupFocusHandler *m_handlerFocus;
148
414f2513 149 DECLARE_EVENT_TABLE()
6c3422e9 150 DECLARE_DYNAMIC_CLASS(wxPopupTransientWindow)
22f3361e 151 DECLARE_NO_COPY_CLASS(wxPopupTransientWindow)
1e6feb95
VZ
152};
153
c9cdd31d 154#if wxUSE_COMBOBOX && defined(__WXUNIVERSAL__)
1e6feb95
VZ
155
156// ----------------------------------------------------------------------------
157// wxPopupComboWindow: wxPopupTransientWindow used by wxComboBox
158// ----------------------------------------------------------------------------
159
160class WXDLLEXPORT wxComboBox;
161class WXDLLEXPORT wxComboControl;
162
163class WXDLLEXPORT wxPopupComboWindow : public wxPopupTransientWindow
164{
165public:
6b598e05 166 wxPopupComboWindow() { m_combo = NULL; }
1e6feb95
VZ
167 wxPopupComboWindow(wxComboControl *parent);
168
169 bool Create(wxComboControl *parent);
170
171 // position the window correctly relatively to the combo
172 void PositionNearCombo();
173
174protected:
175 // notify the combo here
176 virtual void OnDismiss();
177
e0c83227
VZ
178 // forward the key presses to the combobox
179 void OnKeyDown(wxKeyEvent& event);
180
1e6feb95
VZ
181 // the parent combobox
182 wxComboControl *m_combo;
6c3422e9 183
e0c83227 184 DECLARE_EVENT_TABLE()
6c3422e9 185 DECLARE_DYNAMIC_CLASS(wxPopupComboWindow)
1e6feb95
VZ
186};
187
c9cdd31d 188#endif // wxUSE_COMBOBOX && defined(__WXUNIVERSAL__)
1e6feb95
VZ
189
190#endif // wxUSE_POPUPWIN
191
192#endif // _WX_POPUPWIN_H_BASE_