]>
git.saurik.com Git - wxWidgets.git/blob - interface/wx/popupwin.h
4c1476d1712b1ad42c030e6cbb68e99c47a4417c
1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: interface of wxPopupWindow
4 // Author: wxWidgets team
6 // Licence: wxWindows licence
7 /////////////////////////////////////////////////////////////////////////////
12 A special kind of top level window used for popup menus,
13 combobox popups and such.
18 @see wxDialog, wxFrame
21 class wxPopupWindow
: public wxNonOwnedWindow
33 wxPopupWindow(wxWindow
*parent
, int flags
= wxBORDER_NONE
);
36 Create method for two-step creation
38 bool Create(wxWindow
*parent
, int flags
= wxBORDER_NONE
);
41 Move the popup window to the right position, i.e.\ such that it is
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
49 Must be given in screen coordinates!
51 The size of the popup window
53 virtual void Position(const wxPoint
& ptOrigin
,
54 const wxSize
& sizePopup
);
58 @class wxPopupTransientWindow
60 A wxPopupWindow which disappears automatically when the user clicks mouse
61 outside it or if it loses focus in any other way.
63 This window can be useful for implementing custom combobox-like controls
72 class wxPopupTransientWindow
: public wxPopupWindow
78 wxPopupTransientWindow();
83 wxPopupTransientWindow(wxWindow
*parent
, int flags
= wxBORDER_NONE
);
86 Popup the window (this will show it too).
88 If @a winFocus is non-@NULL, it will be kept focused while this window
89 is shown, otherwise this window itself will receive focus. In any case,
90 the popup will disappear automatically if it loses focus because of a
95 virtual void Popup(wxWindow
*focus
= NULL
);
100 virtual void Dismiss();
103 Called when a mouse is pressed while the popup is shown.
105 Return @true from here to prevent its normal processing by the popup
106 (which consists in dismissing it if the mouse is clicked outside it).
108 virtual bool ProcessLeftDown(wxMouseEvent
& event
);
112 This is called when the popup is disappeared because of anything
113 else but direct call to Dismiss().
115 virtual void OnDismiss();