support for huge files (patch 1002226)

[wxWidgets.git] / docs / latex / wx / tlw.tex

diff --git a/docs/latex/wx/tlw.tex b/docs/latex/wx/tlw.tex
index b511d7db4bb62f5bcf82d811642b45597f6f2213..17404418fedf6dd61b1e7f01a857b4c52ed29bae 100644 (file)
--- a/docs/latex/wx/tlw.tex
+++ b/docs/latex/wx/tlw.tex
@@ -12,14 +12,52 @@
 \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}
+
+<wx/toplevel.h>
+
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
+\membersection{wxTopLevelWindow::GetIcon}\label{wxtoplevelwindowgeticon}
+
+\constfunc{const wxIcon\&}{GetIcon}{\void}
+
+Returns the standard icon of the window. The icon will be invalid if it hadn't
+been previously set by \helpref{SetIcon}{wxtoplevelwindowseticon}.
+
+\wxheading{See also}
+
+\helpref{GetIcons}{wxtoplevelwindowgeticons}
+
+
+\membersection{wxTopLevelWindow::GetIcons}\label{wxtoplevelwindowgeticons}
+
+\constfunc{const wxIconBundle\&}{GetIcons}{\void}
+
+Returns all icons associated with the window, there will be none of them if
+neither \helpref{SetIcon}{wxtoplevelwindowseticon} nor 
+\helpref{SetIcons}{wxtoplevelwindowseticons} had been called before.
+
+Use \helpref{GetIcon}{wxtoplevelwindowgeticon} to get the main icon of the
+window.
+
+\wxheading{See also}
+
+\helpref{wxIconBundle}{wxiconbundle}
+
+
 \membersection{wxTopLevelWindow::GetTitle}\label{wxtoplevelwindowgettitle}
 
 \constfunc{wxString}{GetTitle}{\void}
@@ -88,6 +126,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}}
@@ -111,13 +167,18 @@ See also \helpref{wxIcon}{wxicon}.
 
 \func{void}{SetIcons}{\param{const wxIconBundle\& }{icons}}
 
-Sets the icons for this window.
+Sets several icons of different sizes for this window: this allows to use
+different icons for different situations (e.g. task switching bar, taskbar,
+window title bar) instead of scaling, with possibly bad looking results, the
+only icon set by \helpref{SetIcon}{wxtoplevelwindowseticon}.
 
 \wxheading{Parameters}
 
 \docparam{icons}{The icons to associate with this window.}
 
-See also \helpref{wxIconBundle}{wxiconbundle}.
+\wxheading{See also}
+
+\helpref{wxIconBundle}{wxiconbundle}.
 
 
 \membersection{wxTopLevelWindow::SetShape}\label{wxtoplevelwindowsetshape}