X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/6b30a44ed0be21bd0cf26f609d4ca50fb8b965c0..dabb05ac5bfaee014e1118c465d5348e545a6dc4:/docs/latex/wx/tlw.tex?ds=sidebyside diff --git a/docs/latex/wx/tlw.tex b/docs/latex/wx/tlw.tex index be43aa4c93..dba609ba32 100644 --- a/docs/latex/wx/tlw.tex +++ b/docs/latex/wx/tlw.tex @@ -6,12 +6,12 @@ %% Created: 2004-09-07 (partly extracted from frame.tex) %% RCS-ID: $Id$ %% Copyright: (c) 2004 Vadim Zeitlin -%% License: wxWidgets license +%% License: wxWindows license %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{\class{wxTopLevelWindow}}\label{wxtoplevelwindow} -wxTopLevelWindow is a common base class for \helpref{wxDialog}{wxdialog} and +wxTopLevelWindow is a common base class for \helpref{wxDialog}{wxdialog} and \helpref{wxFrame}{wxframe}. It is an abstract base class meaning that you never work with objects of this class directly, but all of its methods are also applicable for the two classes above. @@ -29,6 +29,24 @@ applicable for the two classes above. \latexignore{\rtfignore{\wxheading{Members}}} +\membersection{wxTopLevelWindow::CanSetTransparent}\label{wxtoplevelwindowcansettransparent} + +\func{virtual bool}{CanSetTransparent}{\void} + +Returns \true if the platform supports making the window translucent. + +\wxheading{See also} + +\helpref{wxTopLevelWindow::SetTransparent}{wxtoplevelwindowsettransparent} + + +\membersection{wxTopLevelWindow::GetDefaultItem}\label{wxtoplevelwindowgetdefaultitem} + +\constfunc{wxWindow *}{GetDefaultItem}{\void} + +Returns a pointer to the button which is the default for this window, or \NULL. +The default button is the one activated by pressing the Enter key. + \membersection{wxTopLevelWindow::GetIcon}\label{wxtoplevelwindowgeticon} @@ -47,7 +65,7 @@ been previously set by \helpref{SetIcon}{wxtoplevelwindowseticon}. \constfunc{const wxIconBundle\&}{GetIcons}{\void} Returns all icons associated with the window, there will be none of them if -neither \helpref{SetIcon}{wxtoplevelwindowseticon} nor +neither \helpref{SetIcon}{wxtoplevelwindowseticon} nor \helpref{SetIcons}{wxtoplevelwindowseticons} had been called before. Use \helpref{GetIcon}{wxtoplevelwindowgeticon} to get the main icon of the @@ -64,7 +82,18 @@ window. Gets a string containing the window title. -See \helpref{wxTopLevelWindow::SetTitle}{wxtoplevelwindowsettitle}. +\wxheading{See also} + +\helpref{wxTopLevelWindow::SetTitle}{wxtoplevelwindowsettitle} + + +\membersection{wxTopLevelWindow::HandleSettingChange}\label{wxtoplevelwindowhandlesettingchange} + +\func{virtual bool}{HandleSettingChange}{\param{WXWPARAM}{ wParam}, \param{WXLPARAM}{ lParam}} + +Unique to the wxWinCE port. Responds to showing/hiding SIP (soft input panel) area and resize +window accordingly. Override this if you want to avoid resizing or do additional +operations. \membersection{wxTopLevelWindow::IsActive}\label{wxtoplevelwindowisactive} @@ -75,6 +104,14 @@ Returns \true if this window is currently active, i.e. if the user is currently working with it. +\membersection{wxTopLevelWindow::IsAlwaysMaximized}\label{wxtoplevelwindowisalwaysmaximized} + +\constfunc{virtual bool}{IsAlwaysMaximized}{\void} + +Returns \true if this window is expected to be always maximized, either due to platform policy +or due to local policy regarding particular class. + + \membersection{wxTopLevelWindow::Iconize}\label{wxtoplevelwindowiconize} \func{void}{Iconize}{\param{bool}{ iconize}} @@ -125,10 +162,6 @@ Maximizes or restores the window. \docparam{maximize}{If \true, maximizes the window, otherwise it restores it.} -\wxheading{Remarks} - -This function only works under Windows. - \wxheading{See also} \helpref{wxTopLevelWindow::Iconize}{wxtoplevelwindowiconize} @@ -148,8 +181,19 @@ action. When in doubt, use the default value. Note that this function should normally be only used when the application is not already in foreground. -This function is currently only implemented for Win32 where it flashes the -window icon in the taskbar. +This function is currently implemented for Win32 where it flashes the +window icon in the taskbar, and for wxGTK with task bars supporting it. + + +\membersection{wxTopLevelWindow::SetDefaultItem}\label{wxtoplevelwindowsetdefaultitem} + +\func{void}{SetDefaultItem}{\param{wxWindow }{*win}} + +Changes the default item for the panel, usually \arg{win} is a button. + +\wxheading{See also} + +\helpref{GetDefaultItem}{wxtoplevelwindowgetdefaultitem} \membersection{wxTopLevelWindow::SetIcon}\label{wxtoplevelwindowseticon} @@ -189,6 +233,46 @@ only icon set by \helpref{SetIcon}{wxtoplevelwindowseticon}. \helpref{wxIconBundle}{wxiconbundle}. +\membersection{wxTopLevelWindow::SetLeftMenu}\label{wxtoplevelwindowsetleftmenu} + +\func{void}{SetLeftMenu}{\param{int}{ id = wxID\_ANY}, \param{const wxString\&}{ label = wxEmptyString}, \param{wxMenu *}{ subMenu = NULL}} + +Sets action or menu activated by pressing left hardware button on the smart phones. +Unavailable on full keyboard machines. + +\wxheading{Parameters} + +\docparam{id}{Identifier for this button.} + +\docparam{label}{Text to be displayed on the screen area dedicated to this hardware button.} + +\docparam{subMenu}{The menu to be opened after pressing this hardware button.} + +\wxheading{See also} + +\helpref{wxTopLevelWindow::SetRightMenu}{wxtoplevelwindowsetrightmenu}. + + +\membersection{wxTopLevelWindow::SetRightMenu}\label{wxtoplevelwindowsetrightmenu} + +\func{void}{SetRightMenu}{\param{int}{ id = wxID\_ANY}, \param{const wxString\&}{ label = wxEmptyString}, \param{wxMenu *}{ subMenu = NULL}} + +Sets action or menu activated by pressing right hardware button on the smart phones. +Unavailable on full keyboard machines. + +\wxheading{Parameters} + +\docparam{id}{Identifier for this button.} + +\docparam{label}{Text to be displayed on the screen area dedicated to this hardware button.} + +\docparam{subMenu}{The menu to be opened after pressing this hardware button.} + +\wxheading{See also} + +\helpref{wxTopLevelWindow::SetLeftMenu}{wxtoplevelwindowsetleftmenu}. + + \membersection{wxTopLevelWindow::SetShape}\label{wxtoplevelwindowsetshape} \func{bool}{SetShape}{\param{const wxRegion\&}{ region}} @@ -197,7 +281,7 @@ 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 +call {\it SetShape} again with an empty region. Returns true if the operation is successful. @@ -216,6 +300,34 @@ Sets the window title. \helpref{wxTopLevelWindow::GetTitle}{wxtoplevelwindowgettitle} +\membersection{wxTopLevelWindow::SetTransparent}\label{wxtoplevelwindowsettransparent} + +\func{virtual bool}{SetTransparent}{\param{int }{ alpha}} + +If the platform supports it will set the window to be translucent + +\wxheading{Parameters} + +\docparam{alpha}{Determines how opaque or transparent the window will + be, if the platform supports the opreration. A value of 0 sets the + window to be fully transparent, and a value of 255 sets the window + to be fully opaque.} + +Returns \true if the transparency was successfully changed. + + + +\membersection{wxTopLevelWindow::ShouldPreventAppExit}\label{wxtoplevelwindowshouldpreventappexit} + +\constfunc{virtual bool}{ShouldPreventAppExit}{\void} + +This virtual function is not meant to be called directly but can be overridden +to return \false (it returns \true by default) to allow the application to +close even if this, presumably not very important, window is still opened. +By default, the application stays alive as long as there are any open top level +windows. + + \membersection{wxTopLevelWindow::ShowFullScreen}\label{wxtoplevelwindowshowfullscreen} \func{bool}{ShowFullScreen}{\param{bool}{ show}, \param{long}{ style = wxFULLSCREEN\_ALL}} @@ -242,4 +354,3 @@ Note that showing a window full screen also actually \wxheading{See also} \helpref{wxTopLevelWindow::IsFullScreen}{wxtoplevelwindowisfullscreen} -