Raster/Metafile Location

Constant

Raster or metafile location

Argument srcLocationVARIANT

Argument destLocationVARIANT

gdbImageStream

Raster or metafile is retrieved or saved from/to a stream. The stream is specified by the IStream interface.

The srcLocationVARIANT argument must contain a pointer to an interface through which the stream interface IStream can be retrieved.

A raster is retrieved from the current position in a stream (the current position must point to the BITMAPINFO structure).

The destLocationVARIANT must contain a pointer to an interface (through which the stream interface IStream can be retrieved), VT_NULL, or VT_EMPTY. The interface IStream defines a stream to which a raster or metafile is saved.

If the destLocationVARIANT argument equals VT_NULL or VT_EMPTY, a stream will be created in global memory and a raster or metafile will be saved to this stream. The destLocationVARIANT argument returns a pointer to the IUnknown interface of created stream.

A raster or metafile is saved starting from the current position of the stream.

gdbImageStreamBMP

Raster is retrieved/saved from/to a stream. The stream is specified by the IStream interface.

The srcLocationVARIANT argument must contain a pointer to an interface through which the IStream interface can be retrieved.

A raster is retrieved from the current position in a stream (the current position must point to the BITMAPFILEHEADER structure).

The destLocationVARIANT must contain a pointer to an interface (through which the stream interface IStream can be retrieved), VT_NULL, or VT_EMPTY. The interface IStream defines a stream to which a raster is saved.

If the destLocationVARIANT argument equals VT_NULL or VT_EMPTY, a stream will be created in global memory and a raster will be saved to this stream. The destLocationVARIANT argument returns a pointer to the IUnknown interface of created stream.

A raster is saved starting at the current position of the stream.

gdbImageArray

Raster or metafile is retrieved/saved from/to a byte array.

The srcLocationVARIANT argument must contain a SAFEARRAY with elements of type VT_UI1.

A raster is retrieved from the first element of the array.

The BITMAPINFO structure begins from the first element of the array.

The destLocationVARIANT argument must contain a SAFEARRAY with elements of type VT_UI1, VT_NULL or VT_EMPTY. This array is used to save a raster or metafile.

If the destLocationVARIANT argument equals VT_NULL or VT_EMPTY, a SAFEARRAY with elements of type VT_UI1 will be created and will be used to save a raster or metafile. The destLocationVARIANT argument returns this array.

A raster or metafile is saved starting at the first element of the array.

gdbImageArrayBMP

Raster is retrieved/saved from/to a byte array.

The srcLocationVARIANT argument must contain a SAFEARRAY with elements of type VT_UI1.

A raster is retrieved from the first element of the array.

The BITMAPFILEHEADER structure begins from the first element of the array.

The destLocationVARIANT must contain a SAFEARRAY with elements of type VT_UI1, VT_NULL or VT_EMPTY. This array is used to save a raster.

If the destLocationVARIANT argument equals VT_NULL or VT_EMPTY, a SAFEARRAY with elements of type VT_UI1 will be created and used to save a raster. The destLocationVARIANT argument returns this array.

A raster is saved starting at the first element of the array.

gdbImageFile

Raster or metafile is retrieved/saved from/to a BMP/EMF file.

The srcLocationVARIANT argument must contain a string (of VT_BSTR type) that specifies the path and the name for BMP file.

The destLocationVARIANT argument must contain a string (of VT_BSTR type) specifying the path and the name for BMP or EMF file to which a raster or metafile is saved.

gdbImageClipboard

Raster or metafile is retrieved/saved from/to the clipboard in DIB or EMF format.

The srcLocationVARIANT argument is ignored.

A raster is in the clipboard.

The destLocationVARIANT argument is ignored.

A raster or metafile is placed into the clipboard.