/////////////////////////////////////////////////////////////////////////////// // Name: wx/toplevel.h // Purpose: declares wxTopLevelWindow class, the base class for all // top level windows (such as frames and dialogs) // Author: Vadim Zeitlin, Vaclav Slavik // Modified by: // Created: 06.08.01 // RCS-ID: $Id$ // Copyright: (c) 2001 Vadim Zeitlin // Vaclav Slavik // Licence: wxWindows licence /////////////////////////////////////////////////////////////////////////////// #ifndef _WX_TOPLEVEL_BASE_H_ #define _WX_TOPLEVEL_BASE_H_ #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA) #pragma interface "toplevelbase.h" #endif // ---------------------------------------------------------------------------- // headers // ---------------------------------------------------------------------------- #include "wx/window.h" #include "wx/iconbndl.h" // the default names for various classs WXDLLEXPORT_DATA(extern const wxChar*) wxFrameNameStr; class WXDLLEXPORT wxTopLevelWindowBase; // ---------------------------------------------------------------------------- // constants // ---------------------------------------------------------------------------- // Dialogs are created in a special way #define wxTOPLEVEL_EX_DIALOG 0x00000008 // Styles for ShowFullScreen // (note that wxTopLevelWindow only handles wxFULLSCREEN_NOBORDER and // wxFULLSCREEN_NOCAPTION; the rest is handled by wxTopLevelWindow) enum { wxFULLSCREEN_NOMENUBAR = 0x0001, wxFULLSCREEN_NOTOOLBAR = 0x0002, wxFULLSCREEN_NOSTATUSBAR = 0x0004, wxFULLSCREEN_NOBORDER = 0x0008, wxFULLSCREEN_NOCAPTION = 0x0010, wxFULLSCREEN_ALL = wxFULLSCREEN_NOMENUBAR | wxFULLSCREEN_NOTOOLBAR | wxFULLSCREEN_NOSTATUSBAR | wxFULLSCREEN_NOBORDER | wxFULLSCREEN_NOCAPTION }; // ---------------------------------------------------------------------------- // wxTopLevelWindow: a top level (as opposed to child) window // ---------------------------------------------------------------------------- class WXDLLEXPORT wxTopLevelWindowBase : public wxWindow { public: // construction wxTopLevelWindowBase(); virtual ~wxTopLevelWindowBase(); // top level wnd state // -------------------- // maximize = TRUE => maximize, otherwise - restore virtual void Maximize(bool maximize = TRUE) = 0; // undo Maximize() or Iconize() virtual void Restore() = 0; // iconize = TRUE => iconize, otherwise - restore virtual void Iconize(bool iconize = TRUE) = 0; // return TRUE if the frame is maximized virtual bool IsMaximized() const = 0; // return TRUE if the frame is iconized virtual bool IsIconized() const = 0; // get the frame icon const wxIcon& GetIcon() const { return m_icons.GetIcon( -1 ); } // get the frame icons const wxIconBundle& GetIcons() const { return m_icons; } // set the frame icon virtual void SetIcon(const wxIcon& icon) { m_icons = wxIconBundle( icon ); } // set the frame icons virtual void SetIcons(const wxIconBundle& icons ) { m_icons = icons; } // maximize the window to cover entire screen virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL) = 0; // return TRUE if the frame is in fullscreen mode virtual bool IsFullScreen() const = 0; /* for now we already have them in wxWindow, but this is wrong: these methods really only make sense for wxTopLevelWindow! virtual void SetTitle(const wxString& title) = 0; virtual wxString GetTitle() const = 0; */ // Set the shape of the window to the given region. // Returns TRUE if the platform supports this feature (and the // operation is successful.) virtual bool SetShape(const wxRegion& WXUNUSED(region)) { return FALSE; } // old functions, use the new ones instead! #if WXWIN_COMPATIBILITY_2 bool Iconized() const { return IsIconized(); } #endif // WXWIN_COMPATIBILITY_2 // implementation only from now on // ------------------------------- // override some base class virtuals virtual bool Destroy(); virtual bool IsTopLevel() const { return TRUE; } virtual wxSize GetMaxSize() const; // event handlers void OnCloseWindow(wxCloseEvent& event); void OnSize(wxSizeEvent& event); // this should go away, but for now it's called from docview.cpp, // so should be there for all platforms void OnActivate(wxActivateEvent &WXUNUSED(event)) { } // do the window-specific processing after processing the update event virtual void DoUpdateWindowUI(wxUpdateUIEvent& event) ; protected: // the frame client to screen translation should take account of the // toolbar which may shift the origin of the client area virtual void DoClientToScreen(int *x, int *y) const; virtual void DoScreenToClient(int *x, int *y) const; // test whether this window makes part of the frame // (menubar, toolbar and statusbar are excluded from automatic layout) virtual bool IsOneOfBars(const wxWindow *WXUNUSED(win)) const { return FALSE; } // check if we should exit the program after deleting this top level // window (this is used in common dtor and wxMSW code) bool IsLastBeforeExit() const; // send the iconize event, return TRUE if processed bool SendIconizeEvent(bool iconized = TRUE); // the frame icon wxIconBundle m_icons; DECLARE_NO_COPY_CLASS(wxTopLevelWindowBase) DECLARE_EVENT_TABLE() }; // include the real class declaration #if defined(__WXMSW__) #include "wx/msw/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowMSW #elif defined(__WXGTK__) #include "wx/gtk/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowGTK #elif defined(__WXX11__) #include "wx/x11/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowX11 #elif defined(__WXMGL__) #include "wx/mgl/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowMGL #elif defined(__WXMAC__) #include "wx/mac/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowMac #elif defined(__WXCOCOA__) #include "wx/cocoa/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowCocoa #elif defined(__WXPM__) #include "wx/os2/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowOS2 #elif defined(__WXMOTIF__) #include "wx/motif/toplevel.h" #define wxTopLevelWindowNative wxTopLevelWindowMotif #endif #ifdef __WXUNIVERSAL__ #include "wx/univ/toplevel.h" #else // !__WXUNIVERSAL__ #ifdef wxTopLevelWindowNative class WXDLLEXPORT wxTopLevelWindow : public wxTopLevelWindowNative { public: // construction wxTopLevelWindow() { Init(); } wxTopLevelWindow(wxWindow *parent, wxWindowID winid, const wxString& title, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, long style = wxDEFAULT_FRAME_STYLE, const wxString& name = wxFrameNameStr) { Init(); Create(parent, winid, title, pos, size, style, name); } DECLARE_DYNAMIC_CLASS_NO_COPY(wxTopLevelWindow) }; #endif // wxTopLevelWindowNative #endif // __WXUNIVERSAL__/!__WXUNIVERSAL__ #endif // _WX_TOPLEVEL_BASE_H_