wxmdichildframe

an mdi child frame is a frame that can only exist on a wxmdiclientwindow, which is itself a child of wxmdiparentframe.

derived from

wxframe
wxwindow
wxevthandler
wxobject

include files

<wx/mdi.h>

window styles

wxcaption	puts a caption on the frame.
wxdefault_frame_style	defined as wxminimize_box | wxmaximize_box | wxthick_frame | wxsystem_menu | wxcaption.
wxiconize	display the frame iconized (minimized) (windows only).
wxmaximize	displays the frame maximized (windows only).
wxmaximize_box	displays a maximize box on the frame (windows and motif only).
wxminimize	identical to wxiconize.
wxminimize_box	displays a minimize box on the frame (windows and motif only).
wxresize_border	displays a resizeable border around the window (motif only; for windows, it is implicit in wxthick_frame).
wxstay_on_top	stay on top of other windows (windows only).
wxsystem_menu	displays a system menu (windows and motif only).
wxthick_frame	displays a thick frame around the window (windows and motif only).

see also window styles overview.

remarks

although internally an mdi child frame is a child of the mdi client window, in wxwidgets you create it as a child of wxmdiparentframe. you can usually forget that the client window exists.

mdi child frames are clipped to the area of the mdi client window, and may be iconized on the client window.

you can associate a menubar with a child frame as usual, although an mdi child doesn't display its menubar under its own title bar. the mdi parent frame's menubar will be changed to reflect the currently active child frame. if there are currently no children, the parent frame's own menubar will be displayed.

see also

wxmdiclientwindow, wxmdiparentframe, wxframe

members

wxmdichildframe::wxmdichildframe
wxmdichildframe::~wxmdichildframe
wxmdichildframe::activate
wxmdichildframe::create
wxmdichildframe::maximize
wxmdichildframe::restore

wxmdichildframe::wxmdichildframe

wxmdichildframe()

default constructor.

wxmdichildframe(wxmdiparentframe* parent, wxwindowid id, const wxstring& title, const wxpoint& pos = wxdefaultposition, const wxsize& size = wxdefaultsize, long style = wxdefault_frame_style, const wxstring& name = "frame")

constructor, creating the window.

parameters

parent

the window parent. this should not be null.

id

the window identifier. it may take a value of -1 to indicate a default value.

title

the caption to be displayed on the frame's title bar.

pos

the window position. a value of (-1, -1) indicates a default position, chosen by either the windowing system or wxwidgets, depending on platform.

size

the window size. a value of (-1, -1) indicates a default size, chosen by either the windowing system or wxwidgets, depending on platform.

style

the window style. see wxmdichildframe.

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.

remarks

none.

see also

wxmdichildframe::create

wxmdichildframe::~wxmdichildframe

~wxmdichildframe()

destructor. destroys all child windows and menu bar if present.

wxmdichildframe::activate

void activate()

activates this mdi child frame.

see also

wxmdichildframe::maximize, wxmdichildframe::restore

wxmdichildframe::create

bool create(wxwindow* parent, wxwindowid id, const wxstring& title, const wxpoint& pos = wxdefaultposition, const wxsize& size = wxdefaultsize, long style = wxdefault_frame_style, const wxstring& name = "frame")

used in two-step frame construction. see wxmdichildframe::wxmdichildframe for further details.

wxmdichildframe::maximize

void maximize(boolmaximize)

maximizes this mdi child frame.

see also

wxmdichildframe::activate, wxmdichildframe::restore

wxmdichildframe::restore

void restore()

restores this mdi child frame (unmaximizes).

see also

wxmdichildframe::activate, wxmdichildframe::maximize