Bitmap

Object List Next Object

Definition:

A graphics object whose structure defines the height, width, color, format, and bit values of a logical bitmap.

Specialized Features:

The following tables list and describe the properties and methods added by Bitmap. There are no added events.

Properties Use to...

BytesPerScanline Reflect how many bytes there are per scanline in the bitmap.

CacheBitmap Request the fastest possible redisplay of a bitmap on the screen.

Compression Reflect what compression mode is in effect for the bits of the Bitmap.

Depth Reflect how many bits per pixel (bpp) the bitmap is.

FileName images/.gif Reflect the name of the disk file that corresponds to the bitmap (if the LoadType property is "FileBased." )

images/.gif Reflect the name of the .DLL or .EXE that contains the resource specified by the ResId property (if the LoadType is "ResourceBased.")

Height Reflect the height of the bitmap in pixels.

ImageSize Reflect the size of the bitmap in bytes.

LoadType Indicate how to create the bitmap, as: ResourceBased, FileBased, or MemoryBased.

Mode Reflect the type of colormap used by the bitmap.

NumColors Reflect the number of colors used by the bitmap.

Persistent Control whether a bitmap records information that allows it to reload the same picture (boolean).

ResId Specify the resource to load from the file given by FileName. The resource must be of the type RT_BITMAP.

Status Reflect the loaded status of the bitmap. A status of 0 means the bitmap is valid.

StretchBltMode Control how the bitmap is drawn onto the screen when it is drawn at a size that requires resizing the image. There are four settings available.

Width Reflect the width of the bitmap in pixels.

Methods Use to...

Draw Draw the entire image contained in the Bitmap to the specified window, in a specified rectangle of the window.

DrawClip Draw a portion of the image contained in the Bitmap to the specified window, in a specified rectangle of the window.

GetPicture Get an XferData object containing pictorial formats such as Metafile, Dib (Device Independent Bitmap), or Bitmap.

InitImage Initialize a bitmap object being created from scratch using the low-level read routines.

PropertyEdit Bring up a Load Picture dialog when the FileName property is double clicked.

ReadBits Read the raw pixel bits for a bitmap. InitImage must be called before using this method.

ReadCMap Read the raw colormap data for a bitmap. InitImage must be called before using this method.

ReadRGBScanlines Read the raw pixel bits for a bitmap. InitImage must be called before using this method.

SaveAs Save the current bitmap to the specified file in .BMP format.

SetPicture Set pictorial formats.

TextUnload Append to 'cmds' any statements necessary to regenerate the object from text. It is used by the text-based object saving mechanism that is used by the write module (as text) functions.

Copied Features:

Noneimages/Phx00010.gifthis is a top-level object.

Details:

Use this object to manipulate bitmaps stored as files and bitmaps from OLE sources (i.e. the Clipboard). This object is used in conjunction with the Image control to provide a way to display a picture on the screen. The Bitmap object can be used to load only .BMP files. The Bitmap object can be made to create/load any type of bitmap format through the creation interface (InitImage).