X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/7c913512a4c9f36e11e07ea707002fab1608d324..3201a1046ba71ba8e5ef2ed694fde34d12f743f3:/interface/mdi.h diff --git a/interface/mdi.h b/interface/mdi.h index 7444b51a85..3d5f3b80bc 100644 --- a/interface/mdi.h +++ b/interface/mdi.h @@ -1,6 +1,6 @@ ///////////////////////////////////////////////////////////////////////////// // Name: mdi.h -// Purpose: documentation for wxMDIClientWindow class +// Purpose: interface of wxMDIClientWindow // Author: wxWidgets team // RCS-ID: $Id$ // Licence: wxWindows license @@ -16,8 +16,7 @@ @library{wxcore} @category{FIXME} - @seealso - wxMDIChildFrame, wxMDIParentFrame, wxFrame + @see wxMDIChildFrame, wxMDIParentFrame, wxFrame */ class wxMDIClientWindow : public wxWindow { @@ -25,17 +24,16 @@ public: //@{ /** Constructor, creating the window. - + @param parent - The window parent. - + The window parent. @param style - The window style. Currently unused. - + The window style. Currently unused. + @remarks The second style of constructor is called within - wxMDIParentFrame::OnCreateClient. - - @sa wxMDIParentFrame::wxMDIParentFrame, wxMDIParentFrame::OnCreateClient + wxMDIParentFrame::OnCreateClient. + + @see wxMDIParentFrame::wxMDIParentFrame, wxMDIParentFrame::OnCreateClient */ wxMDIClientWindow(); wxMDIClientWindow(wxMDIParentFrame* parent, long style = 0); @@ -54,6 +52,7 @@ public: }; + /** @class wxMDIParentFrame @wxheader{mdi.h} @@ -64,37 +63,37 @@ public: and is used in many popular Windows applications, such as Microsoft Word(TM). @beginStyleTable - @style{wxCAPTION}: + @style{wxCAPTION} Puts a caption on the frame. - @style{wxDEFAULT_FRAME_STYLE}: + @style{wxDEFAULT_FRAME_STYLE} Defined as wxMINIMIZE_BOX | wxMAXIMIZE_BOX | wxTHICK_FRAME | wxSYSTEM_MENU | wxCAPTION. - @style{wxHSCROLL}: + @style{wxHSCROLL} Displays a horizontal scrollbar in the client window, allowing the user to view child frames that are off the current view. - @style{wxICONIZE}: + @style{wxICONIZE} Display the frame iconized (minimized) (Windows only). - @style{wxMAXIMIZE}: + @style{wxMAXIMIZE} Displays the frame maximized (Windows only). - @style{wxMAXIMIZE_BOX}: + @style{wxMAXIMIZE_BOX} Displays a maximize box on the frame (Windows and Motif only). - @style{wxMINIMIZE}: + @style{wxMINIMIZE} Identical to wxICONIZE. - @style{wxMINIMIZE_BOX}: + @style{wxMINIMIZE_BOX} Displays a minimize box on the frame (Windows and Motif only). - @style{wxRESIZE_BORDER}: + @style{wxRESIZE_BORDER} Displays a resizeable border around the window (Motif only; for Windows, it is implicit in wxTHICK_FRAME). - @style{wxSTAY_ON_TOP}: + @style{wxSTAY_ON_TOP} Stay on top of other windows (Windows only). - @style{wxSYSTEM_MENU}: + @style{wxSYSTEM_MENU} Displays a system menu (Windows and Motif only). - @style{wxTHICK_FRAME}: + @style{wxTHICK_FRAME} Displays a thick frame around the window (Windows and Motif only). - @style{wxVSCROLL}: + @style{wxVSCROLL} Displays a vertical scrollbar in the client window, allowing the user to view child frames that are off the current view. - @style{wxFRAME_NO_WINDOW_MENU}: + @style{wxFRAME_NO_WINDOW_MENU} Under Windows, removes the Window menu that is normally added automatically. @endStyleTable @@ -102,8 +101,7 @@ public: @library{wxcore} @category{managedwnd} - @seealso - wxMDIChildFrame, wxMDIClientWindow, wxFrame, wxDialog + @see wxMDIChildFrame, wxMDIClientWindow, wxFrame, wxDialog */ class wxMDIParentFrame : public wxFrame { @@ -111,46 +109,42 @@ public: //@{ /** Constructor, creating the window. - + @param parent - The window parent. This should be @NULL. - + The window parent. This should be @NULL. @param id - The window identifier. It may take a value of -1 to indicate a default value. - + The window identifier. It may take a value of -1 to indicate a default + value. @param title - The caption to be displayed on the frame's title bar. - + The caption to be displayed on the frame's title bar. @param pos - The window position. The value wxDefaultPosition indicates a default position, chosen by - either the windowing system or wxWidgets, depending on platform. - + The window position. The value wxDefaultPosition indicates a default position, + chosen by + either the windowing system or wxWidgets, depending on platform. @param size - The window size. The value wxDefaultSize indicates a default size, chosen by - either the windowing system or wxWidgets, depending on platform. - + The window size. The value wxDefaultSize indicates a default size, chosen by + either the windowing system or wxWidgets, depending on platform. @param style - The window style. See wxMDIParentFrame. - + The window style. See wxMDIParentFrame. @param name - The name of the window. This parameter is used to associate a name with the + The name of the window. This parameter is used to associate a name with the item, - allowing the application user to set Motif resource values for - individual windows. - + allowing the application user to set Motif resource values for + individual windows. + @remarks During the construction of the frame, the client window will be - created. To use a different class from - wxMDIClientWindow, override - OnCreateClient(). - - @sa Create(), OnCreateClient() + created. To use a different class from + wxMDIClientWindow, override + OnCreateClient(). + + @see Create(), OnCreateClient() */ wxMDIParentFrame(); wxMDIParentFrame(wxWindow* parent, wxWindowID id, const wxString& title, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, - long style = wxDEFAULT_FRAME_STYLE | wxVSCROLL | wxHSCROLL, + long style = wxDEFAULT_FRAME_STYLE | wxVSCROLL | wxHSCROLL, const wxString& name = "frame"); //@} @@ -161,29 +155,29 @@ public: /** Activates the MDI child following the currently active one. - - @sa ActivatePrevious() + + @see ActivatePrevious() */ void ActivateNext(); /** Activates the MDI child preceding the currently active one. - - @sa ActivateNext() + + @see ActivateNext() */ void ActivatePrevious(); /** Arranges any iconized (minimized) MDI child windows. - - @sa Cascade(), Tile() + + @see Cascade(), Tile() */ void ArrangeIcons(); /** Arranges the MDI child windows in a cascade. - - @sa Tile(), ArrangeIcons() + + @see Tile(), ArrangeIcons() */ void Cascade(); @@ -195,52 +189,51 @@ public: const wxString& title, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, - long style = wxDEFAULT_FRAME_STYLE | wxVSCROLL | wxHSCROLL, + long style = wxDEFAULT_FRAME_STYLE | wxVSCROLL | wxHSCROLL, const wxString& name = "frame"); /** Returns a pointer to the active MDI child, if there is one. */ - wxMDIChildFrame* GetActiveChild(); + wxMDIChildFrame* GetActiveChild() const; /** This gets the size of the frame 'client area' in pixels. - + @param width - Receives the client width in pixels. - + Receives the client width in pixels. @param height - Receives the client height in pixels. - + Receives the client height in pixels. + @remarks The client area is the area which may be drawn on by the - programmer, excluding title bar, border, status bar, - and toolbar if present. - - @sa GetToolBar(), SetToolBar(), - wxMDIClientWindow + programmer, excluding title bar, border, status bar, + and toolbar if present. + + @see GetToolBar(), SetToolBar(), + wxMDIClientWindow */ - virtual void GetClientSize(int* width, int* height); + virtual void GetClientSize(int* width, int* height) const; /** Returns a pointer to the client window. - - @sa OnCreateClient() + + @see OnCreateClient() */ - wxMDIClientWindow* GetClientWindow(); + wxMDIClientWindow* GetClientWindow() const; /** Returns the window being used as the toolbar for this frame. - - @sa SetToolBar() + + @see SetToolBar() */ - virtual wxWindow* GetToolBar(); + virtual wxWindow* GetToolBar() const; /** Returns the current Window menu (added by wxWidgets to the menubar). This function is available under Windows only. */ - wxMenu* GetWindowMenu(); + wxMenu* GetWindowMenu() const; /** Override this to return a different kind of client window. If you override this @@ -249,12 +242,12 @@ public: called, due to the way C++ treats virtual functions called from constructors. For example: - + @remarks You might wish to derive from wxMDIClientWindow in order to - implement different erase behaviour, for example, - such as painting a bitmap on the background. - - @sa GetClientWindow(), wxMDIClientWindow + implement different erase behaviour, for example, such + as painting a bitmap on the background. + + @see GetClientWindow(), wxMDIClientWindow */ virtual wxMDIClientWindow* OnCreateClient(); @@ -262,15 +255,15 @@ public: Sets the window to be used as a toolbar for this MDI parent window. It saves the application having to manage the positioning of the toolbar MDI client window. - + @param toolbar - Toolbar to manage. - + Toolbar to manage. + @remarks When the frame is resized, the toolbar is resized to be the - width of the frame client area, and the toolbar - height is kept the same. - - @sa GetToolBar(), GetClientSize() + width of the frame client area, and the toolbar height + is kept the same. + + @see GetToolBar(), GetClientSize() */ virtual void SetToolBar(wxWindow* toolbar); @@ -278,23 +271,21 @@ public: Call this to change the current Window menu. Ownership of the menu object passes to the frame when you call this function. - This call is available under Windows only. - To remove the window completely, use the wxFRAME_NO_WINDOW_MENU window style. */ void SetWindowMenu(wxMenu* menu); /** Tiles the MDI child windows either horizontally or vertically depending on - whether @e orient is wxHORIZONTAL or wxVERTICAL. - + whether @a orient is wxHORIZONTAL or wxVERTICAL. Currently only implemented for MSW, does nothing under the other platforms. */ void Tile(wxOrientation orient = wxHORIZONTAL); }; + /** @class wxMDIChildFrame @wxheader{mdi.h} @@ -303,37 +294,36 @@ public: which is itself a child of wxMDIParentFrame. @beginStyleTable - @style{wxCAPTION}: + @style{wxCAPTION} Puts a caption on the frame. - @style{wxDEFAULT_FRAME_STYLE}: + @style{wxDEFAULT_FRAME_STYLE} Defined as wxMINIMIZE_BOX | wxMAXIMIZE_BOX | wxTHICK_FRAME | wxSYSTEM_MENU | wxCAPTION. - @style{wxICONIZE}: + @style{wxICONIZE} Display the frame iconized (minimized) (Windows only). - @style{wxMAXIMIZE}: + @style{wxMAXIMIZE} Displays the frame maximized (Windows only). - @style{wxMAXIMIZE_BOX}: + @style{wxMAXIMIZE_BOX} Displays a maximize box on the frame (Windows and Motif only). - @style{wxMINIMIZE}: + @style{wxMINIMIZE} Identical to wxICONIZE. - @style{wxMINIMIZE_BOX}: + @style{wxMINIMIZE_BOX} Displays a minimize box on the frame (Windows and Motif only). - @style{wxRESIZE_BORDER}: + @style{wxRESIZE_BORDER} Displays a resizeable border around the window (Motif only; for Windows, it is implicit in wxTHICK_FRAME). - @style{wxSTAY_ON_TOP}: + @style{wxSTAY_ON_TOP} Stay on top of other windows (Windows only). - @style{wxSYSTEM_MENU}: + @style{wxSYSTEM_MENU} Displays a system menu (Windows and Motif only). - @style{wxTHICK_FRAME}: + @style{wxTHICK_FRAME} Displays a thick frame around the window (Windows and Motif only). @endStyleTable @library{wxcore} @category{managedwnd} - @seealso - wxMDIClientWindow, wxMDIParentFrame, wxFrame + @see wxMDIClientWindow, wxMDIParentFrame, wxFrame */ class wxMDIChildFrame : public wxFrame { @@ -341,36 +331,32 @@ public: //@{ /** Constructor, creating the window. - + @param parent - The window parent. This should not be @NULL. - + The window parent. This should not be @NULL. @param id - The window identifier. It may take a value of -1 to indicate a default value. - + The window identifier. It may take a value of -1 to indicate a default + value. @param title - The caption to be displayed on the frame's title bar. - + The caption to be displayed on the frame's title bar. @param pos - The window position. The value wxDefaultPosition indicates a default position, chosen by - either the windowing system or wxWidgets, depending on platform. - + The window position. The value wxDefaultPosition indicates a default position, + chosen by + either the windowing system or wxWidgets, depending on platform. @param size - The window size. The value wxDefaultSize indicates a default size, chosen by - either the windowing system or wxWidgets, depending on platform. - + The window size. The value wxDefaultSize indicates a default size, chosen by + either the windowing system or wxWidgets, depending on platform. @param style - The window style. See wxMDIChildFrame. - + The window style. See wxMDIChildFrame. @param name - The name of the window. This parameter is used to associate a name with the + The name of the window. This parameter is used to associate a name with the item, - allowing the application user to set Motif resource values for - individual windows. - + allowing the application user to set Motif resource values for + individual windows. + @remarks None. - - @sa Create() + + @see Create() */ wxMDIChildFrame(); wxMDIChildFrame(wxMDIParentFrame* parent, wxWindowID id, @@ -388,8 +374,8 @@ public: /** Activates this MDI child frame. - - @sa Maximize(), Restore() + + @see Maximize(), Restore() */ void Activate(); @@ -406,8 +392,8 @@ public: /** Maximizes this MDI child frame. - - @sa Activate(), Restore() + + @see Activate(), Restore() */ void Maximize(bool maximize); @@ -416,3 +402,4 @@ public: */ void Restore(); }; +