X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/6ba68e8852eb470a8040fd0a8fc15fc625f54faf..a9249b2eb2a40d8c71f828669045c4ddaa8dc5ff:/docs/latex/wx/window.tex?ds=sidebyside diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex index 8d2e39bcb6..106ff9e65d 100644 --- a/docs/latex/wx/window.tex +++ b/docs/latex/wx/window.tex @@ -466,6 +466,20 @@ implements the following methods:\par Sizes the window so that it fits around its subwindows. This function won't do anything if there are no subwindows. +\membersection{wxWindow::Freeze}\label{wxwindowfreeze} + +\func{virtual void}{Freeze}{\void} + +Freezes the window or, in other words, prevents any updates from taking place +on screen, the window is not redrawn at all. \helpref{Thaw}{wxwindowthaw} must +be called to reenable window redrawing. + +This method is useful for visual appearance optimization (for example, it +is a good idea to use it before inserting large amount of text into a +wxTextCtrl under wxGTK) but is not implemented on all platforms nor for all +controls so it is mostly just a hint to wxWindows and not a mandatory +directive. + \membersection{wxWindow::GetBackgroundColour}\label{wxwindowgetbackgroundcolour} \constfunc{virtual wxColour}{GetBackgroundColour}{\void} @@ -1104,8 +1118,10 @@ the window won't get the event. \wxheading{See also} -\helpref{wxKeyEvent}{wxkeyevent}, \helpref{wxWindow::OnCharHook}{wxwindowoncharhook},\rtfsp -\helpref{wxApp::OnCharHook}{wxapponcharhook},\rtfsp +\helpref{wxKeyEvent}{wxkeyevent},\rtfsp +\helpref{wxWindow::OnCharHook}{wxwindowoncharhook},\rtfsp +%% GD: OnXXX functions are not documented +%%\helpref{wxApp::OnCharHook}{wxapponcharhook},\rtfsp \helpref{Event handling overview}{eventhandlingoverview} \membersection{wxWindow::OnCommand}\label{wxwindowoncommand} @@ -1193,8 +1209,9 @@ destroying the window if it returns TRUE or if the close is being forced. \helpref{wxWindow::OnClose}{wxwindowonclose},\rtfsp \helpref{wxWindow::Destroy}{wxwindowdestroy},\rtfsp \helpref{wxCloseEvent}{wxcloseevent},\rtfsp -\helpref{wxApp::OnQueryEndSession}{wxapponqueryendsession},\rtfsp -\helpref{wxApp::OnEndSession}{wxapponendsession} +\helpref{wxApp::OnQueryEndSession}{wxapponqueryendsession} +%% GD: OnXXX functions are not documented +%%\helpref{wxApp::OnEndSession}{wxapponendsession} \membersection{wxWindow::OnDropFiles}\label{wxwindowondropfiles} @@ -1335,7 +1352,9 @@ when the application is idle. \wxheading{See also} -\helpref{wxApp::OnIdle}{wxapponidle}, \helpref{wxIdleEvent}{wxidleevent} +%% GD: OnXXX functions are not documented +%%\helpref{wxApp::OnIdle}{wxapponidle} +\helpref{wxIdleEvent}{wxidleevent} \membersection{wxWindow::OnInitDialog}\label{wxwindowoninitdialog} @@ -1791,6 +1810,49 @@ implements the following methods:\par \end{twocollist}} } +\membersection{wxWindow::ScrollLines}\label{wxwindowscrolllines} + +\func{virtual bool}{ScrollLines}{\param{int }{lines}} + +Scrolls the window by the given number of lines down (if {\it lines} is +positive) or up. + +\wxheading{Return value} + +Returns {\tt TRUE} if the window was scrolled, {\tt FALSE} if it was already +on top/bottom and nothing was done. + +\wxheading{Remarks} + +This function is currently only implemented under MSW and wxTextCtrl under +wxGTK (it also works for wxScrolledWindow derived classes under all +platforms). + +\wxheading{See also} + +\helpref{ScrollPages}{wxwindowscrollpages} + +\membersection{wxWindow::ScrollPages}\label{wxwindowscrollpages} + +\func{virtual bool}{ScrollPages}{\param{int }{pages}} + +Scrolls the window by the given number of pages down (if {\it pages} is +positive) or up. + +\wxheading{Return value} + +Returns {\tt TRUE} if the window was scrolled, {\tt FALSE} if it was already +on top/bottom and nothing was done. + +\wxheading{Remarks} + +This function is currently only implemented under MSW and wxTextCtrl under +wxGTK (it also works for wxScrolledWindow derived classes under all +platforms). + +\wxheading{See also} + +\helpref{ScrollLines}{wxwindowscrolllines} \membersection{wxWindow::ScrollWindow}\label{wxwindowscrollwindow} @@ -2000,6 +2062,16 @@ bits are: \twocolitem{\windowstyle{wxWS\_EX\_VALIDATE\_RECURSIVELY}}{TransferDataTo/FromWindow() and Validate() methods will recursively descend into all children of the window if it has this style flag set.} +\twocolitem{\windowstyle{wxWS\_EX\_BLOCK\_EVENTS}}{Normally, the command +events are propagared upwards to the window parent recursively until a handler +for them is found. Using this style allows to prevent them from being +propagated beyond this window. Notice that wxDialog has this style on by +default for the reasons explained in the +\helpref{event processing overview}{eventprocessing}.} +\twocolitem{\windowstyle{wxWS\_EX\_TRANSIENT}}{This can be used to prevent a +window from being used as an implicit parent for the dialogs which were +created without a parent. It is useful for the windows which can disappear at +any moment as creating childs of such windows results in fatal problems.} \end{twocollist} \membersection{wxWindow::SetFocus}\label{wxwindowsetfocus} @@ -2441,6 +2513,13 @@ needed if Show() is called immediately after the frame creation. \helpref{wxWindow::IsShown}{wxwindowisshown} +\membersection{wxWindow::Thaw}\label{wxwindowthaw} + +\func{virtual void}{Thaw}{\void} + +Reenables window updating after a previous call to +\helpref{Freeze}{wxwindowfreeze}. + \membersection{wxWindow::TransferDataFromWindow}\label{wxwindowtransferdatafromwindow} \func{virtual bool}{TransferDataFromWindow}{\void}