void CBCGPCaptionBar::SetBitmap	(	HBITMAP	hBitmap,
		COLORREF	clrTransparent,
		BOOL	bStretch = FALSE,
		BarElementAlignment	bmpAlignment = ALIGN_RIGHT,
		BOOL	bAutoScale = FALSE
	)

Set the bitmap image on the caption bar.

Use this member function to set a bitmap on a caption bar.

The previous bitmap is destroyed automatically. If the caption bar displays an icon (you have called SetIcon()), the bitmap will not be displayed unless you remove the icon by RemoveIcon().

The bitmap is aligned according to the bmpAlignment parameter, which can be one of the following BarElementAlignment enumerated values:

• ALIGN_LEFT
• ALIGN_RIGHT
• ALIGN_CENTER

Parameters

hBitmap	Specifies the handle to the bitmap to set.
clrTransparent	An RGB value which specifies the transparent color of the bitmap.
bStretch	If TRUE, the bitmap will be stretched if it doesn't fit to the image bounding rectangle.
bmpAlignment	Specifies the alignment of the bitmap.
bAutoScale	If TRUE, the bitmap will be scaled according to current DPI.