]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/memorydc.tex
Moved desktop margin options to a more sensible place
[wxWidgets.git] / docs / latex / wx / memorydc.tex
index d2fddb79d168281a3429bb2a14e371cb9fe2213f..e71262b954304a2cdea653263c94e76784989fa1 100644 (file)
@@ -15,6 +15,10 @@ foreground colour (i.e. 1).
 
 <wx/dcmemory.h>
 
 
 <wx/dcmemory.h>
 
+\wxheading{Library}
+
+\helpref{wxCore}{librarieslist}
+
 \wxheading{Remarks}
 
 A bitmap must be selected into the new memory DC before it may be used
 \wxheading{Remarks}
 
 A bitmap must be selected into the new memory DC before it may be used
@@ -33,6 +37,16 @@ for anything.  Typical usage is as follows:
 Note that the memory DC {\it must} be deleted (or the bitmap selected out of it) before a bitmap
 can be reselected into another memory DC.
 
 Note that the memory DC {\it must} be deleted (or the bitmap selected out of it) before a bitmap
 can be reselected into another memory DC.
 
+And, before performing any other operations on the bitmap data, the bitmap must
+be selected out of the memory DC:
+
+\begin{verbatim}
+    temp_dc.SelectObject(wxNullBitmap)
+\end{verbatim}
+
+(this happens automatically when wxMemoryDC object goes out of scope).
+
+
 \wxheading{See also}
 
 \helpref{wxBitmap}{wxbitmap}, \helpref{wxDC}{wxdc}
 \wxheading{See also}
 
 \helpref{wxBitmap}{wxbitmap}, \helpref{wxDC}{wxdc}
@@ -65,11 +79,13 @@ Works exactly like \helpref{SelectObjectAsSource}{wxmemorydcselectobjectassource
 this is the function you should use when you select a bitmap because you want to modify
 it, e.g. drawing on this DC.
 
 this is the function you should use when you select a bitmap because you want to modify
 it, e.g. drawing on this DC.
 
-Be careful to use this function and not \helpref{SelectObjectAsSource}{wxmemorydcselectobjectassource}
-when you want to modify the bitmap you are selecting otherwise you may incurr in some
-problems related to wxBitmap being a reference counted object
+Using \helpref{SelectObjectAsSource}{wxmemorydcselectobjectassource} when modifying
+the bitmap may incurr some problems related to wxBitmap being a reference counted object
 (see \helpref{reference counting overview}{trefcount}).
 
 (see \helpref{reference counting overview}{trefcount}).
 
+Also, before using the updated bitmap data, make sure to select it out of context first
+(for example by selecting wxNullBitmap into the device context).
+
 \wxheading{See also}
 
 \helpref{wxDC::DrawBitmap}{wxdcdrawbitmap}
 \wxheading{See also}
 
 \helpref{wxDC::DrawBitmap}{wxdcdrawbitmap}
@@ -93,3 +109,4 @@ be destroyed safely.
 \wxheading{See also}
 
 \helpref{wxMemoryDC::SelectObject}{wxmemorydcselectobject}
 \wxheading{See also}
 
 \helpref{wxMemoryDC::SelectObject}{wxmemorydcselectobject}
+