Professional User Interface Suite, Copyright FOSS Software Inc. Help Published with Permission.

Properties

g_bIsAutoPreMultiplyRGBChannels Indicates that RGB values stored in the CExtBitmap objects for representing 32-bit bitmaps with alpha channel should be treated as R*A/255, G*A/255, and B*A/255 if this property is true; as not multiplied values otherwise. By default, this property is set to true.
g_strExtBitmapClipboardFormatName Specifies the clipboard format name used by the CExtBitmap class for storing enhanced bitmap data including alpha channel.

Classes

AdjustAlpha Increases or decreases the transparency of the entire bitmap or its part enclosed by the specified rectangle and returns true if the transparency was adjusted successfully or false otherwise. The method affects the alpha channel only.
AdjustHLS Adjusts hue, luminance and/or saturation of the entire bitmap or its part enclosed by the specified rectangle and returns true if the bitmap was adjusted successfully or false otherwise. In addition, the method optionally makes pixels of the specified color transparent.
AlphaBlend Paints the specified alpha-blended bitmap and returns TRUE if successful or FALSE otherwise. For bitmaps without alpha channel, the method paints the bitmap in a way similar to how the Win32 API's StretchBlt() does it. The method works on any Windows OS.
AlphaBlendSkinParts Paints the bitmap in different ways including stretching and tiling and returns true if successful or false otherwise. The method supports alpha channel blending. For bitmaps without alpha channel, the method uses DrawSkinParts() and paints the bitmap in a way similar to how the Win32 API's StretchBlt() does it. The method works on any Windows OS.
AlphaColor Sets the alpha channel value for all pixels of the specified color.
AlphaFrame Sets the alpha channel value for all pixels but those with the colors specified by clrTransparent and clrOpaque. The method makes pixels with the clrTransparent color transparent and pixels with the clrOpaque color opaque. The method affects only the pixels inside the rectangle bounded by rcPadding and rcFrame.
AlphaRect Sets the alpha channel value for all pixels but those with the colors specified by clrTransparent and clrOpaque. The method makes pixels with the clrTransparent color transparent and pixels with the clrOpaque color opaque.
AssignFromHICON Assigns the bitmap object from the specified Win32 icon handle and returns true if successful or false otherwise.
AssignFromOther Assigns the bitmap to this object from another object and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
CExtBitmap Default and copy constructors.
~CExtBitmap Destructor.
Clipboard_CanCopy Returns true if the bitmap is not empty and can be copied into clipboard. Returns false otherwise.
Clipboard_CanPaste Returns true if the bitmap content can be paste from the Windows clipboard. Returns false otherwise.
Clipboard_Copy Copies bitmap data to the Windows clipboard. Returns true if operation successful, false otherwise.
Clipboard_GetExtFormat Returns the bitmap extended clipboard format. Default implementation registers and returns the clipboard format based on the format name returned by the CExtBitmap::Clipboard_GetExtFormatName() method.
Clipboard_GetExtFormatName Returns the name of the bitmap extended clipboard format. Default implementation returns the string object containing the same text as the CExtBitmap::g_strExtBitmapClipboardFormatName static property.
Clipboard_Paste Performs paste bitmap data from the Windows clipboard into the CExtBitmap object. Returns true if operation successful, false otherwise.
ColorizeMono Makes the bitmap or its part mono colored and returns true if successful or false otherwise.
ColorRect Fills the rectangle inside the bitmap with the specified color and alpha.
CreateBitmap Creates and returns a Win32 bitmap handle from the bitmap object. The method returns NULL if failed.
CreateHICON Creates and returns a Win32 icon handle from the bitmap object. The method also optionally makes all pixels of the specified color transparent. The method returns NULL if failed.
Draw Paints the bitmap and returns a non-zero value if successful or zero otherwise. The method ignores the alpha channel.
DrawImpl Paints the bitmap and returns a non-zero value if successful or zero otherwise. The method ignores the alpha channel if any.
DrawNcFrame Draws the bitmap-based non-client border for a window and returns true if successful or false otherwise.
DrawSkinParts Paints the bitmap in different ways including stretching and tiling and returns true if successful or false otherwise. The method ignores the alpha channel if any.
Empty Empties the bitmap.
ExtractEditableBitmap Creates a Win32 bitmap handle that is compatible with the CExtImageEditWnd image editor control and returns true if successful or false otherwise.
FromBitmap Initializes the bitmap with the data from another bitmap specified by the Win32 bitmap handle or its MFC wrapper and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
FromColor Initializes the bitmap with specified color and size. Returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
FromGradient Initializes the bitmap with specified gradient color fill and size. Returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
FromSurface Initializes the bitmap with data from the specified GDI device context and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
FromColor Initializes the bitmap of specified size with the pixels of specified color and alpha channel. Returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
GenerateColorHRGN Returns a handle to the newly created GDI region that covers the pixels of any color but the clrTransparent plus/minus the specified color tolerance.
GenerateSkinFrameAlphaRGN Returns a handle to the newly created GDI region for a skinned window. The region is specified by pixels with alpha channel values within the range of nAlphaMin to nAlphaMax.
GenerateSkinFrameColorRGN Returns a handle to the newly created GDI region for a skinned window. The region is specified by pixels with colors not equal to clrTransparent.
GetBitmapColorArray Gets values of the colors used in the bitmap object and returns the number of these colors. The returned values are saved into the specified array.
GetBitmapColorMap Gets values of the colors used in the bitmap object and returns the number of these colors. The returned values are saved into the specified map.
GetBPP Returns the number of bits used for representing each pixel in the bitmap or 0 if the bitmap is empty.
GetPixel Gets the color information about the bitmap pixel at the specified location and returns true or a valid COLORREF value if successful or false or COLORREF(-1) if the bitmap is empty.
GetSize Returns the bitmap size. The returned CSize with zero width and height indicates that the bitmap object is empty.
GradientRect Fills the rectangle inside the bitmap with the specified gradient fill and alpha.
IsEmpty Returns true if flag which indicates whether the bitmap object is empty.
LoadBMP Loads the bitmap object from the specified MFC archive and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
LoadBMP_Buffer Loads the bitmap object from the specified memory buffer and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
LoadBMP_File Loads the bitmap object from the specified MFC file object or the file on disk and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
LoadBMP_Resource Loads the bitmap object from the resources and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
Make32 Converts the bitmap to a 32-bit bitmap with alpha channel and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
MakeMono Makes the bitmap or its part monochrome or mono colored.
MaskAlpha Returns the mask value for accessing alpha channel values or 0 if the bitmap has no alpha channel or it is a low color bitmap (less than 15 bits per pixel).
MaskBlue Returns the mask value for accessing blue channel values or 0 if the bitmap has no blue channel or it is a low color bitmap (less than 15 bits per pixel).
MaskGreen Returns the mask value for accessing green channel values or 0 if the bitmap has no green channel or it is a low color bitmap (less than 15 bits per pixel).
MaskRed Returns the mask value for accessing red channel values or 0 if the bitmap has no red channel or it is a low color bitmap (less than 15 bits per pixel).
OlePictureLoad Loads the bitmap object using the OleLoadPicture() OLE API and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
PreMultipliedRGBChannelsGet Returns true if the RGB color values are premultiplied by alpha color values or false if the RGB colors are intact. See CExtBitmap::g_bIsAutoPreMultiplyRGBChannels for details.
PreMultipliedRGBChannelsSet Sets the flag that indicates if the RGB color values are premultiplied by alpha color values or false if the RGB colors are intact. See CExtBitmap::g_bIsAutoPreMultiplyRGBChannels for details.
PreMultiplyRGBChannels Multiplies RGB values by corresponding alpha channel values or divides these multiplied RGB values by alpha channel values.
RunTimeFlagsGet Returns the numeric value with run time flags of the bitmap object.
RunTimeFlagsSet Sets the run time flags of the bitmap object.
SaveBMP Saves the bitmap object to the MFC archive and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
SaveBMP_File Saves the bitmap object to the MFC file object or the file on disk and returns true if successful or false otherwise. If bEnableThrowException is set to true, the method throws an exception if it encounters an error.
Scale Scales the bitmap to the desired size and returns true if successful or false otherwise.
SerializeUnpacked Serializes the bitmap object using a raw (uncompressed) format.
SetPixel Sets the color information about the bitmap pixel at the specified location and returns true or a valid COLORREF value if successful or false or COLORREF(-1) if the bitmap is empty.
stat_CMYtoRGB Converts the CMY color value to the RGB color value.
stat_GetDrawMethodFromString Returns the constant from the e_DrawMethod_t enumeration by its string name.
stat_GetDrawMethodName Gets the string name of the painting method by the constant from the e_DrawMethod_t enumeration.
stat_HLS_Adjust Returns the RGB color value with the adjusted hue, luminance and saturation color components.
stat_HLStoRGB Returns the RGB color value computed from the hue, luminance and saturation color components.
stat_RGB_Blend Computes the RGB color as a result of mixing two other colors.
stat_RGB_Enlight Computes the RGB color as a result of mixing two other colors.
stat_RGBtoCMY Converts the RGB color value to the CMY color value.
stat_RGBtoHSL Converts the RGB color value to its hue, luminance and saturation components.

Overridables

IsAutoPreMultiplyRGBChannels Returns true if premultiplied RGB color values should be used for painting or false if the initial colors are multiplied by alpha channel values each time the AlphaBlend() and AlphaBlendSkinParts() methods are called. See g_bIsAutoPreMultiplyRGBChannels for details.
OnLoad Called when the bitmap data is loaded.
OnContentChanged Called when any bitmap data changes.

Operators

operator= Copies the content of another bitmap object into this one.

See Also

CExtBitmap Overview | Hierarchy Chart