X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/d6af57d4d2b2336aa0196d5c1b3833ea98b89a78..ce756cb06a93facb4faa35a1d57c7038fc26e8e1:/docs/latex/wx/bufferdc.tex diff --git a/docs/latex/wx/bufferdc.tex b/docs/latex/wx/bufferdc.tex index 8d9e3171b7..31058d7500 100644 --- a/docs/latex/wx/bufferdc.tex +++ b/docs/latex/wx/bufferdc.tex @@ -6,14 +6,14 @@ %% Created: 07.02.04 %% RCS-ID: $Id$ %% Copyright: (c) 2004 Vadim Zeitlin -%% License: wxWindows license +%% License: wxWidgets license %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{\class{wxBufferedDC}}\label{wxbuffereddc} This simple class provides a simple way to avoid flicker: when drawing on it, -everything is in fact drawn on an in-memory buffer (a -\helpref{wxBitmap}{wxbitmap}) and copied to the screen only once, when this +everything is in fact first drawn on an in-memory buffer (a +\helpref{wxBitmap}{wxbitmap}) and then copied to the screen only once, when this object is destroyed. It can be used in the same way as any other device context. wxBufferedDC itself @@ -23,8 +23,8 @@ your \texttt{OnPaint()} handler, you should look at \wxheading{Derived from} -\helpref{wxMemoryDC}{wxmemorydc} -\helpref{wxDC}{wxdc} +\helpref{wxMemoryDC}{wxmemorydc}\\ +\helpref{wxDC}{wxdc}\\ \helpref{wxObject}{wxobject} \wxheading{Include files} @@ -38,16 +38,16 @@ your \texttt{OnPaint()} handler, you should look at \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxBufferedDC::wxBufferedDC}\label{wxbufferedtdcctor} +\membersection{wxBufferedDC::wxBufferedDC}\label{wxbuffereddcctor} \func{}{wxBufferedDC}{\void} -\func{}{wxBufferedDC}{\param{wxDC *}{dc}, \param{const wxSize\& }{area}, \param{int }{flags}} +\func{}{wxBufferedDC}{\param{wxDC *}{dc}, \param{const wxSize\& }{area}} \func{}{wxBufferedDC}{\param{wxDC *}{dc}, \param{const wxBitmap\& }{buffer}} If you use the first, default, constructor, you must call one of the -\helpref{Init}{wxbufferedtdcinit} methods later in order to use the object. +\helpref{Init}{wxbuffereddcinit} methods later in order to use the object. The other constructors initialize the object immediately and \texttt{Init()} must not be called after using them. @@ -55,15 +55,11 @@ must not be called after using them. \wxheading{Parameters} \docparam{dc}{The underlying DC: everything drawn to this object will be -flushed to this DC when this object is destroyed.} +flushed to this DC when this object is destroyed. You may pass NULL +in order to just initialize the buffer, and not flush it.} \docparam{area}{The size of the bitmap to be used for buffering (this bitmap is -created internally when it is not given explicitely).} - -\docparam{flags}{Can currently only include the flag -\texttt{wxBUFFER\_DC\_PRESERVE\_BG} which means that the existing background -of \arg{dc} must be copied to this object before doing anything else, otherwise -the background is overwritten (which is more efficient).} +created internally when it is not given explicitly).} \docparam{buffer}{Explicitly provided bitmap to be used for buffering: this is the most efficient solution as the bitmap doesn't have to be recreated each @@ -71,14 +67,14 @@ time but it also requires more memory as the bitmap is never freed. The bitmap should have appropriate size, anything drawn outside of its bounds is clipped.} -\membersection{wxBufferedDC::Init}\label{wxbufferedtdcinit} +\membersection{wxBufferedDC::Init}\label{wxbuffereddcinit} -\func{void}{Init}{\param{wxDC *}{dc}, \param{const wxSize\& }{area}, \param{int }{flags}} +\func{void}{Init}{\param{wxDC *}{dc}, \param{const wxSize\& }{area}} \func{void}{Init}{\param{wxDC *}{dc}, \param{const wxBitmap\& }{buffer}} These functions initialize the object created using the default constructor. -Please see \helpref{constructors documentation}{wxbufferedtdcctor} for details. +Please see \helpref{constructors documentation}{wxbuffereddcctor} for details. % VZ: UnMask() intentionally not documented, we might want to make it private @@ -87,7 +83,7 @@ Please see \helpref{constructors documentation}{wxbufferedtdcctor} for details. \membersection{wxBufferedDC::\destruct{wxBufferedDC}}\label{wxbuffereddcdtor} Copies everything drawn on the DC so far to the underlying DC associated with -this object. +this object, if any. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -95,17 +91,17 @@ this object. \section{\class{wxBufferedPaintDC}}\label{wxbufferedpaintdc} This is a subclass of \helpref{wxBufferedDC}{wxbuffereddc} which can be used -inside \texttt{OnPaint()} handler. Just create an object of this class instead +inside of an \texttt{OnPaint()} event handler. Just create an object of this class instead of \helpref{wxPaintDC}{wxpaintdc} and that's all you have to do to (mostly) avoid flicker. The only thing to watch out for is that if you are using this class together with \helpref{wxScrolledWindow}{wxscrolledwindow}, you probably -do \textbf{not} want to call \helpref{PrepareDC}{wxwindowpreparedc} on it as it +do \textbf{not} want to call \helpref{PrepareDC}{wxscrolledwindowpreparedc} on it as it already does this internally for the real underlying wxPaintDC. \wxheading{Derived from} -\helpref{wxMemoryDC}{wxmemorydc} -\helpref{wxDC}{wxdc} +\helpref{wxMemoryDC}{wxmemorydc}\\ +\helpref{wxDC}{wxdc}\\ \helpref{wxObject}{wxobject} \wxheading{Include files} @@ -117,9 +113,7 @@ already does this internally for the real underlying wxPaintDC. \membersection{wxBufferedPaintDC::wxBufferedPaintDC}\label{wxbufferedpaintdcctor} -\func{}{wxBufferedPaintDC}{\param{wxWindow *}{window}, \param{int }{flags}} - -\func{}{wxBufferedPaintDC}{\param{wxWindow *}{window}, \param{const wxBitmap\& }{buffer}} +\func{}{wxBufferedPaintDC}{\param{wxWindow *}{window}, \param{const wxBitmap\& }{buffer = wxNullBitmap}} As with \helpref{wxBufferedDC}{wxbuffereddcctor}, you may either provide the bitmap to be used for buffering or let this object create one internally (in @@ -129,6 +123,6 @@ the latter case, the size of the client part of the window is used). \membersection{wxBufferedPaintDC::\destruct{wxBufferedPaintDC}}\label{wxbufferedpaintdcdtor} Copies everything drawn on the DC so far to the window associated with this -object. +object, using a \helpref{wxPaintDC}{wxpaintdc}.