include/wx/popupwin.h

   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>
   9 // License:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_POPUPWIN_H_BASE_
  13 #define _WX_POPUPWIN_H_BASE_
  14
  15 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  16     #pragma interface "popupwinbase.h"
  17 #endif
  18
  19 #include "wx/window.h"
  20
  21 #if wxUSE_POPUPWIN
  22 // ----------------------------------------------------------------------------
  23 // wxPopupWindow: a special kind of top level window used for popup menus,
  24 // combobox popups and such.
  25 // ----------------------------------------------------------------------------
  26
  27 class WXDLLEXPORT wxPopupWindowBase : public wxWindow
  28 {
  29 public:
  30     wxPopupWindowBase() { }
  31     virtual ~wxPopupWindowBase();
  32
  33     // create the popup window
  34     //
  35     // style may only contain border flags
  36     bool Create(wxWindow *parent, int style = wxBORDER_NONE);
  37
  38     // move the popup window to the right position, i.e. such that it is
  39     // entirely visible
  40     //
  41     // the popup is positioned at ptOrigin + size if it opens below and to the
  42     // right (default), at ptOrigin - sizePopup if it opens above and to the
  43     // left &c
  44     //
  45     // the point must be given in screen coordinates!
  46     virtual void Position(const wxPoint& ptOrigin,
  47                           const wxSize& size);
  48
  49     virtual bool IsTopLevel() const { return true; }
  50
  51     DECLARE_NO_COPY_CLASS(wxPopupWindowBase)
  52 };
  53
  54
  55 // include the real class declaration
  56 #ifdef __WXMSW__
  57     #include "wx/msw/popupwin.h"
  58 #elif __WXPM__
  59     #include "wx/os2/popupwin.h"
  60 #elif __WXGTK__
  61     #include "wx/gtk/popupwin.h"
  62 #elif __WXX11__
  63     #include "wx/x11/popupwin.h"
  64 #elif __WXMOTIF__
  65     #include "wx/motif/popupwin.h"
  66 #elif __WXMGL__
  67     #include "wx/mgl/popupwin.h"
  68 #else
  69     #error "wxPopupWindow is not supported under this platform."
  70 #endif
  71
  72 // ----------------------------------------------------------------------------
  73 // wxPopupTransientWindow: a wxPopupWindow which disappears automatically
  74 // when the user clicks mouse outside it or if it loses focus in any other way
  75 // ----------------------------------------------------------------------------
  76
  77 class WXDLLEXPORT wxPopupWindowHandler;
  78 class WXDLLEXPORT wxPopupFocusHandler;
  79
  80 class WXDLLEXPORT wxPopupTransientWindow : public wxPopupWindow
  81 {
  82 public:
  83     // ctors
  84     wxPopupTransientWindow() { Init(); }
  85     wxPopupTransientWindow(wxWindow *parent, int style = wxBORDER_NONE);
  86
  87     virtual ~wxPopupTransientWindow();
  88
  89     // popup the window (this will show it too) and keep focus at winFocus
  90     // (or itself if it's NULL), dismiss the popup if we lose focus
  91     virtual void Popup(wxWindow *focus = NULL);
  92
  93     // hide the window
  94     virtual void Dismiss();
  95
  96     // can the window be dismissed now?
  97     //
  98     // VZ: where is this used??
  99     virtual bool CanDismiss()
 100         { return true; }
 101
 102     // called when a mouse is pressed while the popup is shown: return true
 103     // from here to prevent its normal processing by the popup (which consists
 104     // in dismissing it if the mouse is cilcked outside it)
 105     virtual bool ProcessLeftDown(wxMouseEvent& event);
 106
 107     // Overridden to grab the input on some plaforms
 108     virtual bool Show( bool show = true );
 109
 110 protected:
 111     // common part of all ctors
 112     void Init();
 113
 114     // this is called when the popup is disappeared because of anything
 115     // else but direct call to Dismiss()
 116     virtual void OnDismiss();
 117
 118     // dismiss and notify the derived class
 119     void DismissAndNotify();
 120
 121     // remove our event handlers
 122     void PopHandlers();
 123
 124     // the child of this popup if any
 125     wxWindow *m_child;
 126
 127     // the window which has the focus while we're shown
 128     wxWindow *m_focus;
 129
 130     // these classes may call our DismissAndNotify()
 131     friend class wxPopupWindowHandler;
 132     friend class wxPopupFocusHandler;
 133
 134     // the handlers we created, may be NULL (if not, must be deleted)
 135     wxPopupWindowHandler *m_handlerPopup;
 136     wxPopupFocusHandler  *m_handlerFocus;
 137
 138     DECLARE_DYNAMIC_CLASS(wxPopupTransientWindow)
 139     DECLARE_NO_COPY_CLASS(wxPopupTransientWindow)
 140 };
 141
 142 #if wxUSE_COMBOBOX && defined(__WXUNIVERSAL__)
 143
 144 // ----------------------------------------------------------------------------
 145 // wxPopupComboWindow: wxPopupTransientWindow used by wxComboBox
 146 // ----------------------------------------------------------------------------
 147
 148 class WXDLLEXPORT wxComboBox;
 149 class WXDLLEXPORT wxComboControl;
 150
 151 class WXDLLEXPORT wxPopupComboWindow : public wxPopupTransientWindow
 152 {
 153 public:
 154     wxPopupComboWindow() { m_combo = NULL; }
 155     wxPopupComboWindow(wxComboControl *parent);
 156
 157     bool Create(wxComboControl *parent);
 158
 159     // position the window correctly relatively to the combo
 160     void PositionNearCombo();
 161
 162 protected:
 163     // notify the combo here
 164     virtual void OnDismiss();
 165
 166     // forward the key presses to the combobox
 167     void OnKeyDown(wxKeyEvent& event);
 168
 169     // the parent combobox
 170     wxComboControl *m_combo;
 171
 172     DECLARE_EVENT_TABLE()
 173     DECLARE_DYNAMIC_CLASS(wxPopupComboWindow)
 174 };
 175
 176 #endif // wxUSE_COMBOBOX && defined(__WXUNIVERSAL__)
 177
 178 #endif // wxUSE_POPUPWIN
 179
 180 #endif // _WX_POPUPWIN_H_BASE_
 181