X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/b325f27f23fa675189be3cd33b9582809ad57362..e2d5abbf527ae760cf65467bf94b914ba9974657:/docs/latex/wx/frame.tex?ds=sidebyside diff --git a/docs/latex/wx/frame.tex b/docs/latex/wx/frame.tex index 4ef9bd18f7..b7e00593e3 100644 --- a/docs/latex/wx/frame.tex +++ b/docs/latex/wx/frame.tex @@ -12,6 +12,7 @@ application windows. \wxheading{Derived from} +\helpref{wxTopLevelWindow}{wxtoplevelwindow}\\ \helpref{wxWindow}{wxwindow}\\ \helpref{wxEvtHandler}{wxevthandler}\\ \helpref{wxObject}{wxobject} @@ -20,11 +21,15 @@ application windows. +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{Window styles} \twocolwidtha{5cm} \begin{twocollist}\itemsep=0pt -\twocolitem{\windowstyle{wxDEFAULT\_FRAME\_STYLE}}{Defined as {\bf wxMINIMIZE\_BOX \pipe wxMAXIMIZE\_BOX \pipe wxRESIZE\_BORDER \pipe wxSYSTEM\_MENU \pipe wxCAPTION \pipe wxCLOSE\_BOX}.} +\twocolitem{\windowstyle{wxDEFAULT\_FRAME\_STYLE}}{Defined as {\bf wxMINIMIZE\_BOX \pipe wxMAXIMIZE\_BOX \pipe wxRESIZE\_BORDER \pipe wxSYSTEM\_MENU \pipe wxCAPTION \pipe wxCLOSE\_BOX \pipe wxCLIP\_CHILDREN}.} \twocolitem{\windowstyle{wxICONIZE}}{Display the frame iconized (minimized). Windows only. } \twocolitem{\windowstyle{wxCAPTION}}{Puts a caption on the frame.} \twocolitem{\windowstyle{wxMINIMIZE}}{Identical to {\bf wxICONIZE}. Windows only.} @@ -33,15 +38,18 @@ application windows. \twocolitem{\windowstyle{wxMAXIMIZE\_BOX}}{Displays a maximize box on the frame.} \twocolitem{\windowstyle{wxCLOSE\_BOX}}{Displays a close box on the frame.} \twocolitem{\windowstyle{wxSTAY\_ON\_TOP}}{Stay on top of all other windows, -see also wxFRAME\_FLOAT\_ON\_PARENT. Windows only.} +see also wxFRAME\_FLOAT\_ON\_PARENT.} \twocolitem{\windowstyle{wxSYSTEM\_MENU}}{Displays a system menu.} \twocolitem{\windowstyle{wxRESIZE\_BORDER}}{Displays a resizeable border around the window.} \twocolitem{\windowstyle{wxFRAME\_TOOL\_WINDOW}}{Causes a frame with a small -titlebar to be created; the frame does not appear in the taskbar under Windows.} +titlebar to be created; the frame does not appear in the taskbar under Windows or GTK+.} \twocolitem{\windowstyle{wxFRAME\_NO\_TASKBAR}}{Creates an otherwise normal -frame but it does not appear in the taskbar under Windows (note that it will -minimize to the desktop window which may seem strange to the users and thus it -might be better to use this style only without wxMINIMIZE\_BOX style). +frame but it does not appear in the taskbar under Windows or GTK+ (note that it +will minimize to the desktop window under Windows which may seem strange to the +users and thus it might be better to use this style only without +wxMINIMIZE\_BOX style). In wxGTK, the flag is respected only if GTK+ is at +least version 2.2 and the window manager supports +\urlref{\_NET\_WM\_STATE\_SKIP\_TASKBAR}{http://freedesktop.org/Standards/wm-spec/1.3/ar01s05.html} hint. Has no effect under other platforms.} \twocolitem{\windowstyle{wxFRAME\_FLOAT\_ON\_PARENT}}{The frame will always be on top of its parent (unlike wxSTAY\_ON\_TOP). A frame created with this style @@ -56,7 +64,8 @@ you should use\rtfsp frames having this style (the dialogs don't have a minimize or a maximize box by default)} \twocolitem{\windowstyle{wxFRAME\_SHAPED}}{Windows with this style are - allowed to have their shape changed with the \helpref{SetShape}{wxframesetshape} method.} + allowed to have their shape changed with the \helpref{SetShape}{wxtoplevelwindowsetshape} method.} +\twocolitem{\windowstyle{wxFRAME\_EX\_METAL}}{On Mac OS X, frames with this style will be shown with a metallic look. This is an {\it extra} style.} \end{twocollist} The default frame style is for normal, resizeable frames. To create a frame @@ -94,7 +103,7 @@ frame to respond to system close events, for example so that related data and su \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxFrame::wxFrame}\label{wxframeconstr} +\membersection{wxFrame::wxFrame}\label{wxframector} \func{}{wxFrame}{\void} @@ -137,7 +146,7 @@ For Motif, MWM (the Motif Window Manager) should be running for any window style \helpref{wxFrame::Create}{wxframecreate} -\membersection{wxFrame::\destruct{wxFrame}} +\membersection{wxFrame::\destruct{wxFrame}}\label{wxframedtor} \func{void}{\destruct{wxFrame}}{\void} @@ -153,16 +162,6 @@ Centres the frame on the display. \docparam{direction}{The parameter may be {\tt wxHORIZONTAL}, {\tt wxVERTICAL} or {\tt wxBOTH}.} -\membersection{wxFrame::Command}\label{wxframecommand} - -\func{void}{Command}{\param{int }{id}} - -Simulate a menu command. - -\wxheading{Parameters} - -\docparam{id}{The identifier for a menu item.} - \membersection{wxFrame::Create}\label{wxframecreate} \func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id},\rtfsp @@ -170,7 +169,7 @@ Simulate a menu command. \param{const wxSize\&}{ size = wxDefaultSize}, \param{long}{ style = wxDEFAULT\_FRAME\_STYLE},\rtfsp \param{const wxString\& }{name = ``frame"}} -Used in two-step frame construction. See \helpref{wxFrame::wxFrame}{wxframeconstr}\rtfsp +Used in two-step frame construction. See \helpref{wxFrame::wxFrame}{wxframector}\rtfsp for further details. \membersection{wxFrame::CreateStatusBar}\label{wxframecreatestatusbar} @@ -196,7 +195,7 @@ wxWidgets.} \wxheading{Return value} -A pointer to the the status bar if it was created successfully, NULL otherwise. +A pointer to the status bar if it was created successfully, NULL otherwise. \wxheading{Remarks} @@ -216,7 +215,7 @@ Note that you can put controls and other windows on the status bar if you wish. \membersection{wxFrame::CreateToolBar}\label{wxframecreatetoolbar} -\func{virtual wxToolBar*}{CreateToolBar}{\param{long}{ style = wxNO\_BORDER \pipe wxTB\_HORIZONTAL}, +\func{virtual wxToolBar*}{CreateToolBar}{\param{long}{ style = wxBORDER\_NONE \pipe wxTB\_HORIZONTAL}, \param{wxWindowID}{ id = -1}, \param{const wxString\&}{ name = "toolBar"}} Creates a toolbar at the top or left of the frame. @@ -233,7 +232,7 @@ wxWidgets.} \wxheading{Return value} -A pointer to the the toolbar if it was created successfully, NULL otherwise. +A pointer to the toolbar if it was created successfully, NULL otherwise. \wxheading{Remarks} @@ -246,6 +245,11 @@ with \helpref{wxFrame::SetToolBar}{wxframesettoolbar}, the frame will manage the position and adjust the return value from \helpref{wxWindow::GetClientSize}{wxwindowgetclientsize} to reflect the available space for application windows. +Under Pocket PC, you should {\it always} use this function for creating the toolbar +to be managed by the frame, so that wxWidgets can use a combined +menubar and toolbar. Where you manage your own toolbars, create a wxToolBar +as usual. + \wxheading{See also} \helpref{wxFrame::CreateStatusBar}{wxframecreatestatusbar},\rtfsp @@ -290,12 +294,6 @@ Returns the status bar pane used to display menu and toolbar help. \helpref{wxFrame::SetStatusBarPane}{wxframesetstatusbarpane} -\membersection{wxFrame::GetTitle}\label{wxframegettitle} - -\constfunc{wxString}{GetTitle}{\void} - -Gets a string containing the frame title. See \helpref{wxFrame::SetTitle}{wxframesettitle}. - \membersection{wxFrame::GetToolBar}\label{wxframegettoolbar} \constfunc{wxToolBar*}{GetToolBar}{\void} @@ -307,60 +305,6 @@ Returns a pointer to the toolbar currently associated with the frame (if any). \helpref{wxFrame::CreateToolBar}{wxframecreatetoolbar}, \helpref{wxToolBar}{wxtoolbar},\rtfsp \helpref{wxFrame::SetToolBar}{wxframesettoolbar} -\membersection{wxFrame::Iconize}\label{wxframeiconize} - -\func{void}{Iconize}{\param{bool}{ iconize}} - -Iconizes or restores the frame. - -\wxheading{Parameters} - -\docparam{iconize}{If true, iconizes the frame; if false, shows and restores it.} - -\wxheading{See also} - -\helpref{wxFrame::IsIconized}{wxframeisiconized}, \helpref{wxFrame::Maximize}{wxframemaximize}. - -\membersection{wxFrame::IsFullScreen}\label{wxframeisfullscreen} - -\func{bool}{IsFullScreen}{\void} - -Returns true if the frame is in fullscreen mode. - -\wxheading{See also} - -\helpref{wxFrame::ShowFullScreen}{wxframeshowfullscreen} - -\membersection{wxFrame::IsIconized}\label{wxframeisiconized} - -\constfunc{bool}{IsIconized}{\void} - -Returns true if the frame is iconized. - -\membersection{wxFrame::IsMaximized}\label{wxframeismaximized} - -\constfunc{bool}{IsMaximized}{\void} - -Returns true if the frame is maximized. - -\membersection{wxFrame::Maximize}\label{wxframemaximize} - -\func{void}{Maximize}{\param{bool }{maximize}} - -Maximizes or restores the frame. - -\wxheading{Parameters} - -\docparam{maximize}{If true, maximizes the frame, otherwise it restores it.} - -\wxheading{Remarks} - -This function only works under Windows. - -\wxheading{See also} - -\helpref{wxFrame::Iconize}{wxframeiconize} - \membersection{wxFrame::OnCreateStatusBar}\label{wxframeoncreatestatusbar} \func{virtual wxStatusBar*}{OnCreateStatusBar}{\param{int }{number}, @@ -424,6 +368,18 @@ implementation returns an instance of \helpref{wxToolBar}{wxtoolbar}. \helpref{wxFrame::CreateToolBar}{wxframecreatetoolbar}, \helpref{wxToolBar}{wxtoolbar}. + +\membersection{wxFrame::ProcessCommand}\label{wxframeprocesscommand} + +\func{void}{ProcessCommand}{\param{int }{id}} + +Simulate a menu command. + +\wxheading{Parameters} + +\docparam{id}{The identifier for a menu item.} + + \membersection{wxFrame::SendSizeEvent}\label{wxframesendsizeevent} \func{void}{SendSizeEvent}{\void} @@ -437,36 +393,6 @@ Note that if the frame is using either sizers or constraints for the children layout, it is enough to call \helpref{Layout()}{wxwindowlayout} directly and this function should not be used in this case. -\membersection{wxFrame::SetIcon}\label{wxframeseticon} - -\func{void}{SetIcon}{\param{const wxIcon\& }{icon}} - -Sets the icon for this frame. - -\wxheading{Parameters} - -\docparam{icon}{The icon to associate with this frame.} - -\wxheading{Remarks} - -The frame takes a `copy' of {\it icon}, but since it uses reference -counting, the copy is very quick. It is safe to delete {\it icon} after -calling this function. - -See also \helpref{wxIcon}{wxicon}. - -\membersection{wxFrame::SetIcons}\label{wxframeseticons} - -\func{void}{SetIcons}{\param{const wxIconBundle\& }{icons}} - -Sets the icons for this frame. - -\wxheading{Parameters} - -\docparam{icons}{The icons to associate with this frame.} - -See also \helpref{wxIconBundle}{wxiconbundle}. - % VZ: we don't have all this any more (18.08.00) % %Under Windows, instead of using {\bf SetIcon}, you can add the @@ -520,17 +446,6 @@ Note that on some platforms, it is not possible to call this function twice for \helpref{wxFrame::GetMenuBar}{wxframegetmenubar}, \helpref{wxMenuBar}{wxmenubar}, \helpref{wxMenu}{wxmenu}. -\membersection{wxFrame::SetShape}\label{wxframesetshape} - -\func{bool}{SetShape}{\param{const wxRegion\&}{ region}} - -If the platform supports it, sets the shape of the window to that -depicted by {\it region}. The system will not display or -respond to any mouse event for the pixels that lie outside of the -region. To reset the window to the normal rectangular shape simply -call {\it SetShape} again with an empty region. Returns TRUE if the -operation is successful. - \membersection{wxFrame::SetStatusBar}\label{wxframesetstatusbar} \func{void}{SetStatusBar}{\param{wxStatusBar*}{ statusBar}} @@ -577,7 +492,7 @@ Sets the widths of the fields in the status bar. \wxheading{Parameters} -\wxheading{n}{The number of fields in the status bar. It must be the +\docparam{n}{The number of fields in the status bar. It must be the same used in \helpref{CreateStatusBar}{wxframecreatestatusbar}.} \docparam{widths}{Must contain an array of {\it n} integers, each of which is a status field width @@ -606,44 +521,3 @@ Associates a toolbar with the frame. \helpref{wxFrame::CreateToolBar}{wxframecreatetoolbar}, \helpref{wxToolBar}{wxtoolbar},\rtfsp \helpref{wxFrame::GetToolBar}{wxframegettoolbar} -\membersection{wxFrame::SetTitle}\label{wxframesettitle} - -\func{virtual void}{SetTitle}{\param{const wxString\& }{ title}} - -Sets the frame title. - -\wxheading{Parameters} - -\docparam{title}{The frame title.} - -\wxheading{See also} - -\helpref{wxFrame::GetTitle}{wxframegettitle} - -\membersection{wxFrame::ShowFullScreen}\label{wxframeshowfullscreen} - -\func{bool}{ShowFullScreen}{\param{bool}{ show}, \param{long}{ style = wxFULLSCREEN\_ALL}} - -Depending on the value of {\it show} parameter the frame is either shown full -screen or restored to its normal state. {\it style} is a bit list containing -some or all of the following values, which indicate what elements of the frame -to hide in full-screen mode: - -\begin{itemize}\itemsep=0pt -\item wxFULLSCREEN\_NOMENUBAR -\item wxFULLSCREEN\_NOTOOLBAR -\item wxFULLSCREEN\_NOSTATUSBAR -\item wxFULLSCREEN\_NOBORDER -\item wxFULLSCREEN\_NOCAPTION -\item wxFULLSCREEN\_ALL (all of the above) -\end{itemize} - -This function has not been tested with MDI frames. - -Note that showing a frame full screen also actually -\helpref{Show()s}{wxwindowshow} if it hadn't been shown yet. - -\wxheading{See also} - -\helpref{wxFrame::IsFullScreen}{wxframeisfullscreen} -