X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/dd72e7678d1f4fd36c4753373b2b22b59491f5a7..1ec4e9c2b72a01a7ba7da569e0f8d04a81aaba10:/interface/wx/popupwin.h diff --git a/interface/wx/popupwin.h b/interface/wx/popupwin.h index 2db50e0071..f7e6aec56e 100644 --- a/interface/wx/popupwin.h +++ b/interface/wx/popupwin.h @@ -1,9 +1,9 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: popupwind.h -// Purpose: interface of wxPoppWindow +// Name: popupwin.h +// Purpose: interface of wxPopupWindow // Author: wxWidgets team -// RCS-ID: $Id:$ -// Licence: wxWindows license +// RCS-ID: $Id$ +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -22,6 +22,11 @@ class wxPopupWindow: public wxNonOwnedWindow { public: + /** + Default constructor + */ + wxPopupWindow(); + /** Constructor */ @@ -49,3 +54,64 @@ public: const wxSize& sizePopup); }; +/** + @class wxPopupTransientWindow + + A wxPopupWindow which disappears automatically when the user clicks mouse + outside it or if it loses focus in any other way. + + This window can be useful for implementing custom combobox-like controls + for example. + + @library{wxcore} + @category{managedwnd} + + @see wxPopupWindow +*/ + +class wxPopupTransientWindow : public wxPopupWindow +{ +public: + /** + Default constructor. + */ + wxPopupTransientWindow(); + + /** + Constructor. + */ + wxPopupTransientWindow(wxWindow *parent, int flags = wxBORDER_NONE); + + /** + Popup the window (this will show it too). + + If @a winFocus is non-@NULL, it will be kept focused while this window + is shown, otherwise this window itself will receive focus. In any case, + the popup will disappear automatically if it loses focus because of a + user action. + + @see Dismiss() + */ + virtual void Popup(wxWindow *focus = NULL); + + /** + Hide the window. + */ + virtual void Dismiss(); + + /** + Called when a mouse is pressed while the popup is shown. + + Return @true from here to prevent its normal processing by the popup + (which consists in dismissing it if the mouse is clicked outside it). + */ + virtual bool ProcessLeftDown(wxMouseEvent& event); + +protected: + /** + This is called when the popup is disappeared because of anything + else but direct call to Dismiss(). + */ + virtual void OnDismiss(); + +};