docs/latex/wx/bmphand.tex

   1 \section{\class{wxBitmapHandler}}\label{wxbitmaphandler}
   2
   3 \overview{Overview}{wxbitmapoverview}
   4
   5 This is the base class for implementing bitmap file loading/saving, and bitmap creation from data.
   6 It is used within wxBitmap and is not normally seen by the application.
   7
   8 If you wish to extend the capabilities of wxBitmap, derive a class from wxBitmapHandler
   9 and add the handler using \helpref{wxBitmap::AddHandler}{wxbitmapaddhandler} in your
  10 application initialisation.
  11
  12 \wxheading{Derived from}
  13
  14 \helpref{wxObject}{wxobject}
  15
  16 \wxheading{Include files}
  17
  18 <wx/bitmap.h>
  19
  20 \wxheading{See also}
  21
  22 \helpref{wxBitmap}{wxbitmap}, \helpref{wxIcon}{wxicon}, \helpref{wxCursor}{wxcursor}
  23
  24 \latexignore{\rtfignore{\wxheading{Members}}}
  25
  26 \membersection{wxBitmapHandler::wxBitmapHandler}\label{wxbitmaphandlerctor}
  27
  28 \func{}{wxBitmapHandler}{\void}
  29
  30 Default constructor. In your own default constructor, initialise the members
  31 m\_name, m\_extension and m\_type.
  32
  33 \membersection{wxBitmapHandler::\destruct{wxBitmapHandler}}\label{wxbitmaphandlerdtor}
  34
  35 \func{}{\destruct{wxBitmapHandler}}{\void}
  36
  37 Destroys the wxBitmapHandler object.
  38
  39 \membersection{wxBitmapHandler::Create}\label{wxbitmaphandlercreate}
  40
  41 \func{virtual bool}{Create}{\param{wxBitmap* }{bitmap}, \param{void*}{ data}, \param{int}{ type}, \param{int}{ width}, \param{int}{ height}, \param{int}{ depth = -1}}
  42
  43 Creates a bitmap from the given data, which can be of arbitrary type. The wxBitmap object {\it bitmap} is
  44 manipulated by this function.
  45
  46 \wxheading{Parameters}
  47
  48 \docparam{bitmap}{The wxBitmap object.}
  49
  50 \docparam{width}{The width of the bitmap in pixels.}
  51
  52 \docparam{height}{The height of the bitmap in pixels.}
  53
  54 \docparam{depth}{The depth of the bitmap in pixels. If this is -1, the screen depth is used.}
  55
  56 \docparam{data}{Data whose type depends on the value of {\it type}.}
  57
  58 \docparam{type}{A bitmap type identifier - see \helpref{wxBitmapHandler::wxBitmapHandler}{wxbitmapctor} for a list
  59 of possible values.}
  60
  61 \wxheading{Return value}
  62
  63 true if the call succeeded, false otherwise (the default).
  64
  65 \membersection{wxBitmapHandler::GetName}\label{wxbitmaphandlergetname}
  66
  67 \constfunc{wxString}{GetName}{\void}
  68
  69 Gets the name of this handler.
  70
  71 \membersection{wxBitmapHandler::GetExtension}\label{wxbitmaphandlergetextension}
  72
  73 \constfunc{wxString}{GetExtension}{\void}
  74
  75 Gets the file extension associated with this handler.
  76
  77 \membersection{wxBitmapHandler::GetType}\label{wxbitmaphandlergettype}
  78
  79 \constfunc{long}{GetType}{\void}
  80
  81 Gets the bitmap type associated with this handler.
  82
  83 \membersection{wxBitmapHandler::LoadFile}\label{wxbitmaphandlerloadfile}
  84
  85 \func{bool}{LoadFile}{\param{wxBitmap* }{bitmap}, \param{const wxString\&}{ name}, \param{long}{ type}}
  86
  87 Loads a bitmap from a file or resource, putting the resulting data into {\it bitmap}.
  88
  89 \wxheading{Parameters}
  90
  91 \docparam{bitmap}{The bitmap object which is to be affected by this operation.}
  92
  93 \docparam{name}{Either a filename or a Windows resource name.
  94 The meaning of {\it name} is determined by the {\it type} parameter.}
  95
  96 \docparam{type}{See \helpref{wxBitmap::wxBitmap}{wxbitmapctor} for values this can take.}
  97
  98 \wxheading{Return value}
  99
 100 true if the operation succeeded, false otherwise.
 101
 102 \wxheading{See also}
 103
 104 \helpref{wxBitmap::LoadFile}{wxbitmaploadfile}\\
 105 \helpref{wxBitmap::SaveFile}{wxbitmapsavefile}\\
 106 \helpref{wxBitmapHandler::SaveFile}{wxbitmaphandlersavefile}
 107
 108 \membersection{wxBitmapHandler::SaveFile}\label{wxbitmaphandlersavefile}
 109
 110 \func{bool}{SaveFile}{\param{wxBitmap* }{bitmap}, \param{const wxString\& }{name}, \param{int}{ type}, \param{wxPalette* }{palette = NULL}}
 111
 112 Saves a bitmap in the named file.
 113
 114 \wxheading{Parameters}
 115
 116 \docparam{bitmap}{The bitmap object which is to be affected by this operation.}
 117
 118 \docparam{name}{A filename. The meaning of {\it name} is determined by the {\it type} parameter.}
 119
 120 \docparam{type}{See \helpref{wxBitmap::wxBitmap}{wxbitmapctor} for values this can take.}
 121
 122 \docparam{palette}{An optional palette used for saving the bitmap.}
 123
 124 \wxheading{Return value}
 125
 126 true if the operation succeeded, false otherwise.
 127
 128 \wxheading{See also}
 129
 130 \helpref{wxBitmap::LoadFile}{wxbitmaploadfile}\\
 131 \helpref{wxBitmap::SaveFile}{wxbitmapsavefile}\\
 132 \helpref{wxBitmapHandler::LoadFile}{wxbitmaphandlerloadfile}
 133
 134 \membersection{wxBitmapHandler::SetName}\label{wxbitmaphandlersetname}
 135
 136 \func{void}{SetName}{\param{const wxString\& }{name}}
 137
 138 Sets the handler name.
 139
 140 \wxheading{Parameters}
 141
 142 \docparam{name}{Handler name.}
 143
 144 \membersection{wxBitmapHandler::SetExtension}\label{wxbitmaphandlersetextension}
 145
 146 \func{void}{SetExtension}{\param{const wxString\& }{extension}}
 147
 148 Sets the handler extension.
 149
 150 \wxheading{Parameters}
 151
 152 \docparam{extension}{Handler extension.}
 153
 154 \membersection{wxBitmapHandler::SetType}\label{wxbitmaphandlersettype}
 155
 156 \func{void}{SetType}{\param{long }{type}}
 157
 158 Sets the handler type.
 159
 160 \wxheading{Parameters}
 161
 162 \docparam{name}{Handler type.}
 163
 164
 165