X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ae3c17b4013e80b99976c750c19fca47729517f6..71a0f42d2a5606098e3e7abbb50b9bb1cd718f9e:/interface/wx/dcmemory.h diff --git a/interface/wx/dcmemory.h b/interface/wx/dcmemory.h index e1e6a998eb..08985012bc 100644 --- a/interface/wx/dcmemory.h +++ b/interface/wx/dcmemory.h @@ -3,12 +3,11 @@ // Purpose: interface of wxMemoryDC // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @class wxMemoryDC - @wxheader{dcmemory.h} A memory device context provides a means to draw graphics onto a bitmap. When drawing in to a mono-bitmap, using @c wxWHITE, @c wxWHITE_PEN and @@ -51,16 +50,28 @@ public: /** Constructs a new memory device context. - Use the wxDC::Ok() member to test whether the constructor was + Use the wxDC::IsOk() member to test whether the constructor was successful in creating a usable device context. Don't forget to select a bitmap into the DC before drawing on it. */ wxMemoryDC(); + + /** + Constructs a new memory device context having the same characteristics + as the given existing device context. + + This constructor creates a memory device context @e compatible with @a + dc in wxMSW, the argument is ignored in the other ports. If @a dc is + @NULL, a device context compatible with the screen is created, just as + with the default constructor. + */ + wxMemoryDC(wxDC *dc); + /** Constructs a new memory device context and calls SelectObject() with the given bitmap. - Use the wxDC::Ok() member to test whether the constructor was + Use the wxDC::IsOk() member to test whether the constructor was successful in creating a usable device context. */ wxMemoryDC(wxBitmap& bitmap); @@ -75,7 +86,7 @@ public: @ref overview_refcount). Also, before using the updated bitmap data, make sure to select it out - of context first (for example by selecting wxNullBitmap into the device + of context first (for example by selecting ::wxNullBitmap into the device context). @see wxDC::DrawBitmap() @@ -89,7 +100,7 @@ public: the bitmap to a window. For this purpose, you may find wxDC::DrawIcon() easier to use instead. - If the argument is wxNullBitmap (or some other uninitialised wxBitmap) + If the argument is ::wxNullBitmap (or some other uninitialised wxBitmap) the current bitmap is selected out of the device context, and the original bitmap restored, allowing the current bitmap to be destroyed safely.