]> git.saurik.com Git - wxWidgets.git/blame_incremental - docs/latex/wx/bmpdatob.tex
new VC++ workspace file for wxBase
[wxWidgets.git] / docs / latex / wx / bmpdatob.tex
... / ...
CommitLineData
1\section{\class{wxBitmapDataObject}}\label{wxbitmapdataobject}
2
3wxBitmapDataObject is a specialization of wxDataObject for bitmap data. It can
4be used without change to paste data into the
5\helpref{wxClipboard}{wxclipboard} or a \helpref{wxDropSource}{wxdropsource}. A
6user may wish to derive a new class from this class for providing a bitmap
7on-demand in order to minimize memory consumption when offering data in several
8formats, such as a bitmap and GIF.
9
10\pythonnote{If you wish to create a derived wxBitmapDataObject class in
11wxPython you should derive the class from wxPyBitmapDataObject
12in order to get Python-aware capabilities for the various virtual
13methods.}
14
15\wxheading{Virtual functions to override}
16
17This class may be used as is, but
18\helpref{GetBitmap}{wxbitmapdataobjectgetbitmap} may be overridden to increase
19efficiency.
20
21\wxheading{Derived from}
22
23\helpref{wxDataObjectSimple}{wxdataobjectsimple}\\
24\helpref{wxDataObject}{wxdataobject}
25
26\wxheading{Include files}
27
28<wx/dataobj.h>
29
30\wxheading{See also}
31
32\helpref{Clipboard and drag and drop overview}{wxdndoverview},
33\helpref{wxDataObject}{wxdataobject},
34\helpref{wxDataObjectSimple}{wxdataobjectsimple},
35\helpref{wxFileDataObject}{wxfiledataobject},
36\helpref{wxTextDataObject}{wxtextdataobject},
37\helpref{wxDataObject}{wxdataobject}
38
39\func{}{wxBitmapDataObject}{\param{const wxBitmap\& }{bitmap = wxNullBitmap}}
40
41Constructor, optionally passing a bitmap (otherwise use
42\helpref{SetBitmap}{wxbitmapdataobjectsetbitmap} later).
43
44\membersection{wxBitmapDataObject::GetBitmap}\label{wxbitmapdataobjectgetbitmap}
45
46\constfunc{virtual wxBitmap}{GetBitmap}{\void}
47
48Returns the bitmap associated with the data object. You may wish to override
49this method when offering data on-demand, but this is not required by
50wxWindows' internals. Use this method to get data in bitmap form from
51the \helpref{wxClipboard}{wxclipboard}.
52
53\membersection{wxBitmapDataObject::SetBitmap}\label{wxbitmapdataobjectsetbitmap}
54
55\func{virtual void}{SetBitmap}{\param{const wxBitmap\& }{bitmap}}
56
57Sets the bitmap associated with the data object. This method is called when the
58data object receives data. Usually there will be no reason to override this
59function.
60