TBitmap class - Reference Guide

Constructor

An ObjectWindows struct equivalent to BANDINFOSTRUCT, TBandlnfo is used to pass information to a printer driver that supports banding.

TBandlnfo is declared as follows:

struct TBandlnfo { BOOL HasGraphics;

BOOL HasText;

TRect GraphicsRect;

};

Has Graphics is TRUE if graphics are (or are expected to be) on the page or in the band; otherwise, it is FALSE. HasText is TRUE if text is (or is expected to be) on the page or in the band; otherwise, it is FALSE. GraphicsRect defines the bounding region for all graphics on the page.

See also: TPrintDC::Bandlnfo, TPrintDC::NextBand

gdiobjec.h

TBitmap is the CDI bitmap class derived from TGdiObject. TBitMap can construct a bitmap from many sources. TBitmap objects are DDBs dependent bitmaps), which are different from the DIBs

(device-independent bitmaps) represented by TDib objects.

Public constructors

TBitmap(HBITMAP handle, TAutoDelete autoDelete

=

NoAutoDelete);

Creates a TBitmap object and sets the Handle data member to the given borrowed handle. The ShouldDelete data member defaults to FALSE,

ensuring that the borrowed handle will not be deleted when the C++ object is destroyed.

See also: TGdiObject::Handle, TGdiObject::ShouldDelete

ObjecfWindows 2.0 Reference Guide

Constructor

TBitmap(const TClipboard& clipboard);

Creates a TBitmap object with values from the given Clipboard.

See also: TClipBoard::GetClipboardData TBitmap(const TBitmap& bitmap);

Creates a copy of the given bitmap object.

See also: TBitmap::GetObject, ::CreateCompatibleBitmap, ::CreateBitmap TBitmap(int width, int height, BYTE planes, BYTE bitCount = 1,

void far* bits

=

0);

TBitmap

Creates a bitmap object from bitCount bits in the bits buffer with the given width, height, and planes argument values.

=

FALSE);

Creates a bitmap object for the given device context with the given argument values.

See also: : :CreateDiscardableBitmap, TDC

TBitmap(const TDC& Dc, const TDib& dib, DWORD usage

=

CMB_INIT)i

Creates a bitmap object for the given device context with the given dib and usage argument values.

See also: ::CreateDIBBitmap, TDC, TDib

TBitmap(const TMetaF;ilepict& metaFile, TPalette& palette, const TSize& size);

Creates a bitmap object from the given metaFile, using the given palette and size arguments.

Public member functions

BYTE BitsPixel() const;

Returns the number of bits per pixel in this bitmap.

See. also: TBitmap::GetObject

inline DWORD GetBitmapBits(DWORD count, void far* ,bits) const;

Copies up to count bits of this bitmap to the buffer bits.

See also: ::GetBitmapBits, TBitmap::GetObject, GetBitmapDimension inline BOOL GetBitmapDimension (TSize& size) const;

GetObject

Height

operator«

operator HBITMAP()

Retrieves the size of this bitmap (width and height, measured in tenths of millimeters) and sets it in the size argument. Returns TRUE if the call is successful; otherwise returns FALSE.

See also: ::GetBitmapDimensionEx, TBitmap::SetBitmapDimension, TSize inline BOOL GetObject(BITMAP far& bitmap) const;

Retrieves data (width, height, and color format) for this bitmap and sets it in the given BITMAP structure. To retrieve the bit pattern, use

GetBitmapBits.

See also: TBitMap::GetBitmapBits, struct BITMAP int Height() const;

Returns the height of this bitmap.

Protected member functions

void HandleCreate(const TDib& dib, const TPalette &palette);

void HandleCreate(const TBitmap &src);

Creates a bitmap handle from the given argument objects.

TBitmapGadget class bitmapga.h

Derived from TGadget, TBitmapGadget is a simple gadget that can display an array of bitmap images one at a time.

TBitmapGadget class

Constructor

Destructor

Selectlmage

SysColorChange

GetDesiredSize

Paint

SetBounds

Public constructors and destructor

TBitrnapGadget(TResld brnpResld, int Id, TBorderStyle borderStyle, TResld bitrnapNarne, int nurnlrnages, int startlrnage);

Constructs a TBitmapGadget and sets the current image to the beginning image in the array of images. Then, sets the border style to the current TGadget border style and numlmages to the number of images in the arr'ay.

~TBitrnapGadget() ;

Deletes the array of images.

Public member functions

int Seleetlrnage(int irnageNurn, BOOL immediate);

Determines the current image and repaints the client area if the image has changed. Calls the Windows API function ::UpdateWindow to update the client area if the image has changed.

void SysColorChange() i

When the system colors have been changed, SysColorChange is called by the gadget window's EvSysColorChange so that bitmap gadgets can be rebuilt and repainted.

Protected member functions

void GetDesiredSize(TSize& size) i

Calls TGadget::GetDesiredSize, which determines how big the bitmap gadget can be. The gadget window sends this message to query the gadget'S size. If shrink-wrapping is requested, GetDesiredSize returns the size needed to accommodate the borders and margins. If shrink-wrapping is not

requested, it returns the gadget's current width and height. TGadget Window needs this information to determine how big the gadget needs to be, but it can adjust these dimensions if necessary. If WideAsPossible is TRUE, then the width parameter (size.ex) is ignored.

void Paint (TDC& de);

Paints the gadget's border and the contents of the bitmap.

void SetBounds(TReet& r);

ObjectWindows 2.0 Reference Guide

Im Dokument Reference Guide (Seite 53-58)