| 1 | ///////////////////////////////////////////////////////////////////////////// |
| 2 | // Name: wx/toplevel.h |
| 3 | // Purpose: Top level window, abstraction of wxFrame and wxDialog |
| 4 | // Author: Vaclav Slavik |
| 5 | // Id: $Id$ |
| 6 | // Copyright: (c) 2001-2002 SciTech Software, Inc. (www.scitechsoft.com) |
| 7 | // Licence: wxWindows licence |
| 8 | ///////////////////////////////////////////////////////////////////////////// |
| 9 | |
| 10 | |
| 11 | #ifndef __WX_UNIV_TOPLEVEL_H__ |
| 12 | #define __WX_UNIV_TOPLEVEL_H__ |
| 13 | |
| 14 | #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA) |
| 15 | #pragma interface "univtoplevel.h" |
| 16 | #endif |
| 17 | |
| 18 | #include "wx/univ/inpcons.h" |
| 19 | #include "wx/univ/inphand.h" |
| 20 | #include "wx/icon.h" |
| 21 | |
| 22 | // ---------------------------------------------------------------------------- |
| 23 | // constants |
| 24 | // ---------------------------------------------------------------------------- |
| 25 | |
| 26 | // frame decorations type flags used in wxRenderer and wxColourScheme |
| 27 | enum |
| 28 | { |
| 29 | wxTOPLEVEL_ACTIVE = 0x00000001, |
| 30 | wxTOPLEVEL_MAXIMIZED = 0x00000002, |
| 31 | wxTOPLEVEL_TITLEBAR = 0x00000004, |
| 32 | wxTOPLEVEL_ICON = 0x00000008, |
| 33 | wxTOPLEVEL_RESIZEABLE = 0x00000010, |
| 34 | wxTOPLEVEL_BORDER = 0x00000020, |
| 35 | wxTOPLEVEL_BUTTON_CLOSE = 0x01000000, |
| 36 | wxTOPLEVEL_BUTTON_MAXIMIZE = 0x02000000, |
| 37 | wxTOPLEVEL_BUTTON_ICONIZE = 0x04000000, |
| 38 | wxTOPLEVEL_BUTTON_RESTORE = 0x08000000, |
| 39 | wxTOPLEVEL_BUTTON_HELP = 0x10000000 |
| 40 | }; |
| 41 | |
| 42 | // frame hit test return values: |
| 43 | enum |
| 44 | { |
| 45 | wxHT_TOPLEVEL_NOWHERE = 0x00000000, |
| 46 | wxHT_TOPLEVEL_CLIENT_AREA = 0x00000001, |
| 47 | wxHT_TOPLEVEL_ICON = 0x00000002, |
| 48 | wxHT_TOPLEVEL_TITLEBAR = 0x00000004, |
| 49 | |
| 50 | wxHT_TOPLEVEL_BORDER_N = 0x00000010, |
| 51 | wxHT_TOPLEVEL_BORDER_S = 0x00000020, |
| 52 | wxHT_TOPLEVEL_BORDER_E = 0x00000040, |
| 53 | wxHT_TOPLEVEL_BORDER_W = 0x00000080, |
| 54 | wxHT_TOPLEVEL_BORDER_NE = wxHT_TOPLEVEL_BORDER_N | wxHT_TOPLEVEL_BORDER_E, |
| 55 | wxHT_TOPLEVEL_BORDER_SE = wxHT_TOPLEVEL_BORDER_S | wxHT_TOPLEVEL_BORDER_E, |
| 56 | wxHT_TOPLEVEL_BORDER_NW = wxHT_TOPLEVEL_BORDER_N | wxHT_TOPLEVEL_BORDER_W, |
| 57 | wxHT_TOPLEVEL_BORDER_SW = wxHT_TOPLEVEL_BORDER_S | wxHT_TOPLEVEL_BORDER_W, |
| 58 | wxHT_TOPLEVEL_ANY_BORDER = 0x000000F0, |
| 59 | |
| 60 | wxHT_TOPLEVEL_BUTTON_CLOSE = /*0x01000000*/ wxTOPLEVEL_BUTTON_CLOSE, |
| 61 | wxHT_TOPLEVEL_BUTTON_MAXIMIZE = /*0x02000000*/ wxTOPLEVEL_BUTTON_MAXIMIZE, |
| 62 | wxHT_TOPLEVEL_BUTTON_ICONIZE = /*0x04000000*/ wxTOPLEVEL_BUTTON_ICONIZE, |
| 63 | wxHT_TOPLEVEL_BUTTON_RESTORE = /*0x08000000*/ wxTOPLEVEL_BUTTON_RESTORE, |
| 64 | wxHT_TOPLEVEL_BUTTON_HELP = /*0x10000000*/ wxTOPLEVEL_BUTTON_HELP, |
| 65 | wxHT_TOPLEVEL_ANY_BUTTON = 0x1F000000 |
| 66 | }; |
| 67 | |
| 68 | // Flags for interactive frame manipulation functions (only in wxUniversal): |
| 69 | enum |
| 70 | { |
| 71 | wxINTERACTIVE_MOVE = 0x00000001, |
| 72 | wxINTERACTIVE_RESIZE = 0x00000002, |
| 73 | wxINTERACTIVE_RESIZE_S = 0x00000010, |
| 74 | wxINTERACTIVE_RESIZE_N = 0x00000020, |
| 75 | wxINTERACTIVE_RESIZE_W = 0x00000040, |
| 76 | wxINTERACTIVE_RESIZE_E = 0x00000080, |
| 77 | wxINTERACTIVE_WAIT_FOR_INPUT = 0x10000000 |
| 78 | }; |
| 79 | |
| 80 | // ---------------------------------------------------------------------------- |
| 81 | // the actions supported by this control |
| 82 | // ---------------------------------------------------------------------------- |
| 83 | |
| 84 | #define wxACTION_TOPLEVEL_ACTIVATE _T("activate") // (de)activate the frame |
| 85 | #define wxACTION_TOPLEVEL_BUTTON_PRESS _T("pressbtn") // press titlebar btn |
| 86 | #define wxACTION_TOPLEVEL_BUTTON_RELEASE _T("releasebtn") // press titlebar btn |
| 87 | #define wxACTION_TOPLEVEL_BUTTON_CLICK _T("clickbtn") // press titlebar btn |
| 88 | #define wxACTION_TOPLEVEL_MOVE _T("move") // move the frame |
| 89 | #define wxACTION_TOPLEVEL_RESIZE _T("resize") // resize the frame |
| 90 | |
| 91 | //----------------------------------------------------------------------------- |
| 92 | // wxTopLevelWindow |
| 93 | //----------------------------------------------------------------------------- |
| 94 | |
| 95 | class WXDLLEXPORT wxTopLevelWindow : public wxTopLevelWindowNative, |
| 96 | public wxInputConsumer |
| 97 | { |
| 98 | public: |
| 99 | // construction |
| 100 | wxTopLevelWindow() { Init(); } |
| 101 | wxTopLevelWindow(wxWindow *parent, |
| 102 | wxWindowID id, |
| 103 | const wxString& title, |
| 104 | const wxPoint& pos = wxDefaultPosition, |
| 105 | const wxSize& size = wxDefaultSize, |
| 106 | long style = wxDEFAULT_FRAME_STYLE, |
| 107 | const wxString& name = wxFrameNameStr) |
| 108 | { |
| 109 | Init(); |
| 110 | |
| 111 | Create(parent, id, title, pos, size, style, name); |
| 112 | } |
| 113 | |
| 114 | bool Create(wxWindow *parent, |
| 115 | wxWindowID id, |
| 116 | const wxString& title, |
| 117 | const wxPoint& pos = wxDefaultPosition, |
| 118 | const wxSize& size = wxDefaultSize, |
| 119 | long style = wxDEFAULT_FRAME_STYLE, |
| 120 | const wxString& name = wxFrameNameStr); |
| 121 | |
| 122 | // implement base class pure virtuals |
| 123 | virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL); |
| 124 | virtual wxPoint GetClientAreaOrigin() const; |
| 125 | virtual void DoGetClientSize(int *width, int *height) const; |
| 126 | virtual void DoSetClientSize(int width, int height); |
| 127 | virtual void SetIcon(const wxIcon& icon) { SetIcons( wxIconBundle( icon ) ); } |
| 128 | virtual void SetIcons(const wxIconBundle& icons); |
| 129 | |
| 130 | // implementation from now on |
| 131 | // -------------------------- |
| 132 | |
| 133 | // tests for frame's part at given point |
| 134 | long HitTest(const wxPoint& pt) const; |
| 135 | |
| 136 | virtual bool PerformAction(const wxControlAction& action, |
| 137 | long numArg = -1, |
| 138 | const wxString& strArg = wxEmptyString); |
| 139 | |
| 140 | // move/resize the frame interactively, i.e. let the user do it |
| 141 | virtual void InteractiveMove(int flags = wxINTERACTIVE_MOVE); |
| 142 | |
| 143 | virtual int GetMinWidth() const; |
| 144 | virtual int GetMinHeight() const; |
| 145 | |
| 146 | virtual bool ProvidesBackground() const { return true; } |
| 147 | |
| 148 | protected: |
| 149 | // handle titlebar button click event |
| 150 | virtual void ClickTitleBarButton(long button); |
| 151 | |
| 152 | virtual wxWindow *GetInputWindow() const { return (wxWindow*)this; } |
| 153 | |
| 154 | // return wxTOPLEVEL_xxx combination based on current state of the frame |
| 155 | long GetDecorationsStyle() const; |
| 156 | |
| 157 | // common part of all ctors |
| 158 | void Init(); |
| 159 | |
| 160 | void RefreshTitleBar(); |
| 161 | void OnNcPaint(wxNcPaintEvent& event); |
| 162 | void OnSystemMenu(wxCommandEvent& event); |
| 163 | |
| 164 | // true if wxTLW should render decorations (aka titlebar) itself |
| 165 | static int ms_drawDecorations; |
| 166 | // true if wxTLW can be iconized |
| 167 | static int ms_canIconize; |
| 168 | // true for currently active frame |
| 169 | bool m_isActive:1; |
| 170 | // version of icon for titlebar (16x16) |
| 171 | wxIcon m_titlebarIcon; |
| 172 | // saved window style in fullscreen mdoe |
| 173 | long m_fsSavedStyle; |
| 174 | // currently pressed titlebar button |
| 175 | long m_pressedButton; |
| 176 | |
| 177 | DECLARE_DYNAMIC_CLASS(wxTopLevelWindow) |
| 178 | DECLARE_EVENT_TABLE() |
| 179 | WX_DECLARE_INPUT_CONSUMER() |
| 180 | }; |
| 181 | |
| 182 | // ---------------------------------------------------------------------------- |
| 183 | // wxStdFrameInputHandler: handles focus, resizing and titlebar buttons clicks |
| 184 | // ---------------------------------------------------------------------------- |
| 185 | |
| 186 | class WXDLLEXPORT wxStdFrameInputHandler : public wxStdInputHandler |
| 187 | { |
| 188 | public: |
| 189 | wxStdFrameInputHandler(wxInputHandler *inphand); |
| 190 | |
| 191 | virtual bool HandleMouse(wxInputConsumer *consumer, |
| 192 | const wxMouseEvent& event); |
| 193 | virtual bool HandleMouseMove(wxInputConsumer *consumer, const wxMouseEvent& event); |
| 194 | virtual bool HandleActivation(wxInputConsumer *consumer, bool activated); |
| 195 | |
| 196 | private: |
| 197 | // the window (button) which has capture or NULL and the last hittest result |
| 198 | wxTopLevelWindow *m_winCapture; |
| 199 | long m_winHitTest; |
| 200 | long m_winPressed; |
| 201 | bool m_borderCursorOn; |
| 202 | wxCursor m_origCursor; |
| 203 | }; |
| 204 | |
| 205 | #endif // __WX_UNIV_TOPLEVEL_H__ |