X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/5a8e93c455321689ccdc0d7f7a0ae124bb65d592..21dc4be5d27fd73cda55795ab9d1e7e02b494c46:/docs/latex/wx/tlw.tex diff --git a/docs/latex/wx/tlw.tex b/docs/latex/wx/tlw.tex index 71ae9bc300..6cada953fe 100644 --- a/docs/latex/wx/tlw.tex +++ b/docs/latex/wx/tlw.tex @@ -6,16 +6,26 @@ %% 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 -\helpref{wxTopLevelWindow}{wxtoplevelwindow}. It is an abstract base class meaning that you never +\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. +\wxheading{Derived from} + +\helpref{wxWindow}{wxwindow}\\ +\helpref{wxEvtHandler}{wxevthandler}\\ +\helpref{wxObject}{wxobject} + +\wxheading{Include files} + + + \latexignore{\rtfignore{\wxheading{Members}}} @@ -57,6 +67,14 @@ Gets a string containing the window title. See \helpref{wxTopLevelWindow::SetTitle}{wxtoplevelwindowsettitle}. +\membersection{wxTopLevelWindow::IsActive}\label{wxtoplevelwindowisactive} + +\constfunc{bool}{IsActive}{\void} + +Returns \true if this window is currently active, i.e. if the user is currently +working with it. + + \membersection{wxTopLevelWindow::Iconize}\label{wxtoplevelwindowiconize} \func{void}{Iconize}{\param{bool}{ iconize}} @@ -116,6 +134,24 @@ This function only works under Windows. \helpref{wxTopLevelWindow::Iconize}{wxtoplevelwindowiconize} +\membersection{wxTopLevelWindow::RequestUserAttention}\label{wxtoplevelwindowrequestuserattention} + +\func{void}{RequestUserAttention}{\param{int }{flags = wxUSER\_ATTENTION\_INFO}} + +Use a system-dependent way to attract users attention to the window when it is +in background. + +\arg{flags} may have the value of either \texttt{wxUSER\_ATTENTION\_INFO} +(default) or \texttt{wxUSER\_ATTENTION\_ERROR} which results in a more drastic +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. + + \membersection{wxTopLevelWindow::SetIcon}\label{wxtoplevelwindowseticon} \func{void}{SetIcon}{\param{const wxIcon\& }{icon}} @@ -153,6 +189,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}}