]> git.saurik.com Git - wxWidgets.git/blame - include/wx/toplevel.h
blind attempt to fix wxMac compilation (__UNIX__ defined on OS X?)
[wxWidgets.git] / include / wx / toplevel.h
CommitLineData
ec4f95c4
VZ
1///////////////////////////////////////////////////////////////////////////////
2// Name: wx/toplevel.h
3// Purpose: declares wxTopLevelWindow class, the base class for all
4// top level windows (such as frames and dialogs)
7d9f12f3 5// Author: Vadim Zeitlin, Vaclav Slavik
ec4f95c4
VZ
6// Modified by:
7// Created: 06.08.01
8// RCS-ID: $Id$
9// Copyright: (c) 2001 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
7d9f12f3 10// Vaclav Slavik <vaclav@wxwindows.org>
ec4f95c4
VZ
11// Licence: wxWindows licence
12///////////////////////////////////////////////////////////////////////////////
13
7d9f12f3
VS
14#ifndef _WX_TOPLEVEL_BASE_H_
15#define _WX_TOPLEVEL_BASE_H_
16
12028905 17#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
af49c4b8
GD
18 #pragma interface "toplevelbase.h"
19#endif
20
7d9f12f3
VS
21// ----------------------------------------------------------------------------
22// headers
23// ----------------------------------------------------------------------------
24
ec4f95c4 25#include "wx/window.h"
f618020a 26#include "wx/iconbndl.h"
7d9f12f3
VS
27
28// the default names for various classs
29WXDLLEXPORT_DATA(extern const wxChar*) wxFrameNameStr;
30
31class WXDLLEXPORT wxTopLevelWindowBase;
32
b22d16ad
VS
33// ----------------------------------------------------------------------------
34// constants
35// ----------------------------------------------------------------------------
36
7d9f12f3 37// Dialogs are created in a special way
21f4383a 38#define wxTOPLEVEL_EX_DIALOG 0x00000008
7d9f12f3
VS
39
40// Styles for ShowFullScreen
41// (note that wxTopLevelWindow only handles wxFULLSCREEN_NOBORDER and
42// wxFULLSCREEN_NOCAPTION; the rest is handled by wxTopLevelWindow)
b22d16ad
VS
43enum
44{
45 wxFULLSCREEN_NOMENUBAR = 0x0001,
46 wxFULLSCREEN_NOTOOLBAR = 0x0002,
47 wxFULLSCREEN_NOSTATUSBAR = 0x0004,
48 wxFULLSCREEN_NOBORDER = 0x0008,
49 wxFULLSCREEN_NOCAPTION = 0x0010,
d4597e13
VZ
50
51 wxFULLSCREEN_ALL = wxFULLSCREEN_NOMENUBAR | wxFULLSCREEN_NOTOOLBAR |
52 wxFULLSCREEN_NOSTATUSBAR | wxFULLSCREEN_NOBORDER |
b22d16ad
VS
53 wxFULLSCREEN_NOCAPTION
54};
55
ec4f95c4
VZ
56// ----------------------------------------------------------------------------
57// wxTopLevelWindow: a top level (as opposed to child) window
58// ----------------------------------------------------------------------------
59
7d9f12f3 60class WXDLLEXPORT wxTopLevelWindowBase : public wxWindow
ec4f95c4
VZ
61{
62public:
7d9f12f3
VS
63 // construction
64 wxTopLevelWindowBase();
799ea011 65 virtual ~wxTopLevelWindowBase();
b22d16ad 66
7d9f12f3
VS
67 // top level wnd state
68 // --------------------
69
70 // maximize = TRUE => maximize, otherwise - restore
71 virtual void Maximize(bool maximize = TRUE) = 0;
72
73 // undo Maximize() or Iconize()
74 virtual void Restore() = 0;
75
76 // iconize = TRUE => iconize, otherwise - restore
77 virtual void Iconize(bool iconize = TRUE) = 0;
78
79 // return TRUE if the frame is maximized
80 virtual bool IsMaximized() const = 0;
81
82 // return TRUE if the frame is iconized
83 virtual bool IsIconized() const = 0;
84
85 // get the frame icon
f618020a
MB
86 const wxIcon& GetIcon() const { return m_icons.GetIcon( -1 ); }
87
88 // get the frame icons
89 const wxIconBundle& GetIcons() const { return m_icons; }
7d9f12f3
VS
90
91 // set the frame icon
f618020a
MB
92 virtual void SetIcon(const wxIcon& icon) { m_icons = wxIconBundle( icon ); }
93
94 // set the frame icons
95 virtual void SetIcons(const wxIconBundle& icons ) { m_icons = icons; }
7d9f12f3 96
c8e8ae85
VS
97 // maximize the window to cover entire screen
98 virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL) = 0;
d4597e13 99
c8e8ae85
VS
100 // return TRUE if the frame is in fullscreen mode
101 virtual bool IsFullScreen() const = 0;
102
ec4f95c4
VZ
103 /*
104 for now we already have them in wxWindow, but this is wrong: these
105 methods really only make sense for wxTopLevelWindow!
106
7d9f12f3 107 virtual void SetTitle(const wxString& title) = 0;
ec4f95c4
VZ
108 virtual wxString GetTitle() const = 0;
109 */
7d9f12f3 110
1542ea39
RD
111 // Set the shape of the window to the given region.
112 // Returns TRUE if the platform supports this feature (and the
113 // operation is successful.)
fc7a2a60 114 virtual bool SetShape(const wxRegion& WXUNUSED(region)) { return FALSE; }
1542ea39 115
7d9f12f3
VS
116 // implementation only from now on
117 // -------------------------------
118
119 // override some base class virtuals
120 virtual bool Destroy();
121 virtual bool IsTopLevel() const { return TRUE; }
34c3ffca 122 virtual wxSize GetMaxSize() const;
7d9f12f3
VS
123
124 // event handlers
125 void OnCloseWindow(wxCloseEvent& event);
126 void OnSize(wxSizeEvent& event);
127
128 // this should go away, but for now it's called from docview.cpp,
129 // so should be there for all platforms
130 void OnActivate(wxActivateEvent &WXUNUSED(event)) { }
131
e39af974
JS
132 // do the window-specific processing after processing the update event
133 virtual void DoUpdateWindowUI(wxUpdateUIEvent& event) ;
134
7d9f12f3
VS
135protected:
136 // the frame client to screen translation should take account of the
137 // toolbar which may shift the origin of the client area
138 virtual void DoClientToScreen(int *x, int *y) const;
139 virtual void DoScreenToClient(int *x, int *y) const;
140
1cbee0b4
VZ
141 // test whether this window makes part of the frame
142 // (menubar, toolbar and statusbar are excluded from automatic layout)
143 virtual bool IsOneOfBars(const wxWindow *WXUNUSED(win)) const
144 { return FALSE; }
145
5c363878 146 // check if we should exit the program after deleting this top level
1cbee0b4 147 // window (this is used in common dtor and wxMSW code)
5c363878 148 bool IsLastBeforeExit() const;
1cbee0b4 149
7d9f12f3
VS
150 // send the iconize event, return TRUE if processed
151 bool SendIconizeEvent(bool iconized = TRUE);
152
153 // the frame icon
f618020a 154 wxIconBundle m_icons;
7d9f12f3 155
fc7a2a60 156 DECLARE_NO_COPY_CLASS(wxTopLevelWindowBase)
7d9f12f3 157 DECLARE_EVENT_TABLE()
ec4f95c4
VZ
158};
159
7d9f12f3
VS
160
161// include the real class declaration
82c9f85c
VZ
162#if defined(__WXMSW__)
163 #include "wx/msw/toplevel.h"
164 #define wxTopLevelWindowNative wxTopLevelWindowMSW
165#elif defined(__WXGTK__)
7d9f12f3
VS
166 #include "wx/gtk/toplevel.h"
167 #define wxTopLevelWindowNative wxTopLevelWindowGTK
83df96d6
JS
168#elif defined(__WXX11__)
169 #include "wx/x11/toplevel.h"
170 #define wxTopLevelWindowNative wxTopLevelWindowX11
7d9f12f3
VS
171#elif defined(__WXMGL__)
172 #include "wx/mgl/toplevel.h"
173 #define wxTopLevelWindowNative wxTopLevelWindowMGL
93b4dc4b
SC
174#elif defined(__WXMAC__)
175 #include "wx/mac/toplevel.h"
176 #define wxTopLevelWindowNative wxTopLevelWindowMac
e64df9bc
DE
177#elif defined(__WXCOCOA__)
178 #include "wx/cocoa/toplevel.h"
179 #define wxTopLevelWindowNative wxTopLevelWindowCocoa
c9782ca3
DW
180#elif defined(__WXPM__)
181 #include "wx/os2/toplevel.h"
182 #define wxTopLevelWindowNative wxTopLevelWindowOS2
798a4529
MB
183#elif defined(__WXMOTIF__)
184 #include "wx/motif/toplevel.h"
185 #define wxTopLevelWindowNative wxTopLevelWindowMotif
7d9f12f3
VS
186#endif
187
188#ifdef __WXUNIVERSAL__
189 #include "wx/univ/toplevel.h"
190#else // !__WXUNIVERSAL__
191 #ifdef wxTopLevelWindowNative
192 class WXDLLEXPORT wxTopLevelWindow : public wxTopLevelWindowNative
193 {
194 public:
195 // construction
196 wxTopLevelWindow() { Init(); }
197 wxTopLevelWindow(wxWindow *parent,
d9e2e4c2 198 wxWindowID winid,
7d9f12f3
VS
199 const wxString& title,
200 const wxPoint& pos = wxDefaultPosition,
201 const wxSize& size = wxDefaultSize,
202 long style = wxDEFAULT_FRAME_STYLE,
203 const wxString& name = wxFrameNameStr)
204 {
205 Init();
d9e2e4c2 206 Create(parent, winid, title, pos, size, style, name);
7d9f12f3
VS
207 }
208
fc7a2a60 209 DECLARE_DYNAMIC_CLASS_NO_COPY(wxTopLevelWindow)
7d9f12f3
VS
210 };
211 #endif // wxTopLevelWindowNative
212#endif // __WXUNIVERSAL__/!__WXUNIVERSAL__
213
214
215#endif // _WX_TOPLEVEL_BASE_H_