mdi.tex

很牛的GUI源码wxWidgets-2.8.0.zip 可在多种平台下运行.

See also \helpref{window styles overview}{windowstyles}.

\wxheading{See also}

\helpref{wxMDIChildFrame}{wxmdichildframe}, \helpref{wxMDIClientWindow}{wxmdiclientwindow},\rtfsp
\helpref{wxFrame}{wxframe}, \helpref{wxDialog}{wxdialog}

\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxMDIParentFrame::wxMDIParentFrame}\label{wxmdiparentframector}

\func{}{wxMDIParentFrame}{\void}

Default constructor.

\func{}{wxMDIParentFrame}{\param{wxWindow* }{parent}, \param{wxWindowID }{id},\rtfsp
\param{const wxString\& }{title}, \param{const wxPoint\&}{ pos = wxDefaultPosition},\rtfsp
\param{const wxSize\&}{ size = wxDefaultSize}, \param{long}{ style = wxDEFAULT\_FRAME\_STYLE \pipe wxVSCROLL \pipe wxHSCROLL},\rtfsp
\param{const wxString\& }{name = ``frame"}}

Constructor, creating the window.

\wxheading{Parameters}

\docparam{parent}{The window parent. This should be NULL.}

\docparam{id}{The window identifier. It may take a value of -1 to indicate a default value.}

\docparam{title}{The caption to be displayed on the frame's title bar.}

\docparam{pos}{The window position. A value of (-1, -1) indicates a default position, chosen by
either the windowing system or wxWidgets, depending on platform.}

\docparam{size}{The window size. A value of (-1, -1) indicates a default size, chosen by
either the windowing system or wxWidgets, depending on platform.}

\docparam{style}{The window style. See \helpref{wxMDIParentFrame}{wxmdiparentframe}.}

\docparam{name}{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.}

\wxheading{Remarks}

During the construction of the frame, the client window will be created. To use a different class
from \helpref{wxMDIClientWindow}{wxmdiclientwindow}, override\rtfsp
\helpref{wxMDIParentFrame::OnCreateClient}{wxmdiparentframeoncreateclient}.

Under Windows 95, the client window will automatically have a sunken border style when
the active child is not maximized, and no border style when a child is maximized.

\wxheading{See also}

\helpref{wxMDIParentFrame::Create}{wxmdiparentframecreate},\rtfsp
\helpref{wxMDIParentFrame::OnCreateClient}{wxmdiparentframeoncreateclient}

\membersection{wxMDIParentFrame::\destruct{wxMDIParentFrame}}\label{wxmdiparentframedtor}

\func{}{\destruct{wxMDIParentFrame}}{\void}

Destructor. Destroys all child windows and menu bar if present.

\membersection{wxMDIParentFrame::ActivateNext}\label{wxmdiparentframeactivatenext}

\func{void}{ActivateNext}{\void}

Activates the MDI child following the currently active one.

\wxheading{See also}

\helpref{wxMDIParentFrame::ActivatePrevious}{wxmdiparentframeactivateprevious}

\membersection{wxMDIParentFrame::ActivatePrevious}\label{wxmdiparentframeactivateprevious}

\func{void}{ActivatePrevious}{\void}

Activates the MDI child preceding the currently active one.

\wxheading{See also}

\helpref{wxMDIParentFrame::ActivateNext}{wxmdiparentframeactivatenext}


\membersection{wxMDIParentFrame::ArrangeIcons}\label{wxmdiparentframearrangeicons}

\func{void}{ArrangeIcons}{\void}

Arranges any iconized (minimized) MDI child windows.

\wxheading{See also}

\helpref{wxMDIParentFrame::Cascade}{wxmdiparentframecascade},\rtfsp
\helpref{wxMDIParentFrame::Tile}{wxmdiparentframetile}

\membersection{wxMDIParentFrame::Cascade}\label{wxmdiparentframecascade}

\func{void}{Cascade}{\void}

Arranges the MDI child windows in a cascade.

\wxheading{See also}

\helpref{wxMDIParentFrame::Tile}{wxmdiparentframetile},\rtfsp
\helpref{wxMDIParentFrame::ArrangeIcons}{wxmdiparentframearrangeicons}

\membersection{wxMDIParentFrame::Create}\label{wxmdiparentframecreate}

\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id},\rtfsp
\param{const wxString\& }{title}, \param{const wxPoint\&}{ pos = wxDefaultPosition},\rtfsp
\param{const wxSize\&}{ size = wxDefaultSize}, \param{long}{ style = wxDEFAULT\_FRAME\_STYLE \pipe wxVSCROLL \pipe wxHSCROLL},\rtfsp
\param{const wxString\& }{name = ``frame"}}

Used in two-step frame construction. See \helpref{wxMDIParentFrame::wxMDIParentFrame}{wxmdiparentframector}\rtfsp
for further details.

\membersection{wxMDIParentFrame::GetClientSize}\label{wxmdiparentframegetclientsize}

\constfunc{virtual void}{GetClientSize}{\param{int* }{width}, \param{int* }{height}}

This gets the size of the frame `client area' in pixels.

\wxheading{Parameters}

\docparam{width}{Receives the client width in pixels.}

\docparam{height}{Receives the client height in pixels.}

\wxheading{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.

If you wish to manage your own toolbar (or perhaps you have more than one),
provide an {\bf OnSize} event handler. Call {\bf GetClientSize} to
find how much space there is for your windows and don't forget to set the size and position
of the MDI client window as well as your toolbar and other windows (but not the status bar).

If you have set a toolbar with \helpref{wxMDIParentFrame::SetToolbar}{wxmdiparentframesettoolbar},
the client size returned will have subtracted the toolbar height. However, the available positions
for the client window and other windows of the frame do not start at zero - you must add the toolbar height.

The position and size of the status bar and toolbar (if known to the frame) are always managed
by {\bf wxMDIParentFrame}, regardless of what behaviour is defined in your {\bf OnSize} event handler.
However, the client window position and size are always set in {\bf OnSize}, so if you override this
event handler, make sure you deal with the client window.

You do not have to manage the size and position of MDI child windows, since they are managed
automatically by the client window.

\wxheading{See also}

\helpref{wxMDIParentFrame::GetToolBar}{wxmdiparentframegettoolbar},\rtfsp
\helpref{wxMDIParentFrame::SetToolBar}{wxmdiparentframesettoolbar},\rtfsp
\helpref{wxMDIClientWindow}{wxmdiclientwindow}


\pythonnote{The wxPython version of this method takes no arguments and
returns a tuple containing width and height.}

\membersection{wxMDIParentFrame::GetActiveChild}\label{wxmdiparentframegetactivechild}

\constfunc{wxMDIChildFrame*}{GetActiveChild}{\void}

Returns a pointer to the active MDI child, if there is one.

\membersection{wxMDIParentFrame::GetClientWindow}\label{wxmdiparentframegetclientwindow}

\constfunc{wxMDIClientWindow*}{GetClientWindow}{\void}

Returns a pointer to the client window.

\wxheading{See also}

\helpref{wxMDIParentFrame::OnCreateClient}{wxmdiparentframeoncreateclient}

\membersection{wxMDIParentFrame::GetToolBar}\label{wxmdiparentframegettoolbar}

\constfunc{virtual wxWindow*}{GetToolBar}{\void}

Returns the window being used as the toolbar for this frame.

\wxheading{See also}

\helpref{wxMDIParentFrame::SetToolBar}{wxmdiparentframesettoolbar}

\membersection{wxMDIParentFrame::GetWindowMenu}\label{wxmdiparentframegetwindowmenu}

\constfunc{wxMenu*}{GetWindowMenu}{\void}

Returns the current Window menu (added by wxWidgets to the menubar). This function
is available under Windows only.

\membersection{wxMDIParentFrame::OnCreateClient}\label{wxmdiparentframeoncreateclient}

\func{virtual wxMDIClientWindow*}{OnCreateClient}{\void}

Override this to return a different kind of client window. If you override this function,
you must create your parent frame in two stages, or your function will never be called,
due to the way C++ treats virtual functions called from constructors. For example:

\begin{verbatim}
  frame = new MyParentFrame;
  frame->Create(parent, myParentFrameId, wxT("My Parent Frame"));
\end{verbatim}

\wxheading{Remarks}

You might wish to derive from \helpref{wxMDIClientWindow}{wxmdiclientwindow} in order
to implement different erase behaviour, for example, such as painting a bitmap
on the background.

Note that it is probably impossible to have a client window that scrolls as well as painting
a bitmap or pattern, since in {\bf OnScroll}, the scrollbar positions always return zero.
(Solutions to: {\tt [e-mail]}).

\wxheading{See also}

\helpref{wxMDIParentFrame::GetClientWindow}{wxmdiparentframegetclientwindow},\rtfsp
\helpref{wxMDIClientWindow}{wxmdiclientwindow}

\membersection{wxMDIParentFrame::SetToolBar}\label{wxmdiparentframesettoolbar}

\func{virtual void}{SetToolBar}{\param{wxWindow*}{ toolbar}}

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.

\wxheading{Parameters}

\docparam{toolbar}{Toolbar to manage.}

\wxheading{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.

The parent of the toolbar must be this frame.

If you wish to manage your own toolbar (or perhaps you have more than one),
don't call this function, and instead manage your subwindows and the MDI client window by
providing an {\bf OnSize} event handler. Call \helpref{wxMDIParentFrame::GetClientSize}{wxmdiparentframegetclientsize} to
find how much space there is for your windows.

Note that SDI (normal) frames and MDI child windows must always have their
toolbars managed by the application.

\wxheading{See also}

\helpref{wxMDIParentFrame::GetToolBar}{wxmdiparentframegettoolbar},\rtfsp
\helpref{wxMDIParentFrame::GetClientSize}{wxmdiparentframegetclientsize}

\membersection{wxMDIParentFrame::SetWindowMenu}\label{wxmdiparentframesetwindowmenu}

\func{void}{SetWindowMenu}{\param{wxMenu*}{ menu}}

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.

\membersection{wxMDIParentFrame::Tile}\label{wxmdiparentframetile}

\func{void}{Tile}{\param{wxOrientation}{ orient = wxHORIZONTAL}}

Tiles the MDI child windows either horizontally or vertically depending on
whether \arg{orient} is wxHORIZONTAL or wxVERTICAL.

Currently only implemented for MSW, does nothing under the other platforms.

\wxheading{See also}

\helpref{wxMDIParentFrame::Cascade}{wxmdiparentframecascade},\rtfsp
\helpref{wxMDIParentFrame::ArrangeIcons}{wxmdiparentframearrangeicons}