File: wupdlock.tex

package info (click to toggle)
wxwidgets2.8 2.8.10.1-3
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 239,052 kB
  • ctags: 289,550
  • sloc: cpp: 1,838,857; xml: 396,717; python: 282,506; ansic: 126,171; makefile: 51,406; sh: 14,581; asm: 299; sql: 258; lex: 194; perl: 139; yacc: 128; pascal: 95; php: 39; lisp: 38; tcl: 24; haskell: 20; java: 18; cs: 18; erlang: 17; ruby: 16; ada: 9; ml: 9; csh: 9
file content (62 lines) | stat: -rw-r--r-- 1,995 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Name:        wupdlock.tex
%% Purpose:     wxWindowUpdateLocker documentation
%% Author:      Vadim Zeitlin
%% Modified by:
%% Created:     2006-03-06
%% RCS-ID:      $Id: wupdlock.tex 37842 2006-03-07 01:50:21Z VZ $
%% Copyright:   (c) 2006 Vadim Zeitlin <vadim@wxwindows.org>
%% License:     wxWindows license
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{\class{wxWindowUpdateLocker}}\label{wxwindowupdatelocker}

This tiny class prevents redrawing of a \helpref{wxWindow}{wxwindow} during its
lifetime by using \helpref{wxWindow::Freeze}{wxwindowfreeze} and 
\helpref{Thaw}{wxwindowthaw} methods. It is typically used for creating
automatic objects to temporarily suppress window updates before a batch of
operations is performed:
{\small
\begin{verbatim}
    void MyFrame::Foo()
    {
        m_text = new wxTextCtrl(this, ...);

        wxWindowUpdateLocker noUpdates(m_text);
        m_text->AppendText();
        ... many other operations with m_text...
        m_text->WriteText();
    }
\end{verbatim}
}

Using this class is easier and safer than calling 
\helpref{Freeze}{wxwindowfreeze} and \helpref{Thaw}{wxwindowthaw} because you
don't risk to forget calling the latter.

\wxheading{Derived from}

None.

\wxheading{Include files}

<wx/wupdlock.h>

\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxWindowUpdateLocker::wxWindowUpdateLocker}\label{wxwindowupdatelockerctor}

\func{}{wxWindowUpdateLocker}{\param{wxWindow *}{win}}

Creates an object preventing the updates of the specified \arg{win}. The
parameter must be non-\NULL and the window must exist for longer than
wxWindowUpdateLocker object itself.


\membersection{wxWindowUpdateLocker::\destruct{wxWindowUpdateLocker}}\label{wxwindowupdatelockerdtor}

\func{}{\destruct{wxWindowUpdateLocker}}{\void}

Destructor reenables updates for the window this object is associated with.