DeskBmpFilename

Purpose

This property identifies a file name or resource ID for a background bitmap to be placed onto the desk area of the control.

If you want to use your own bitmap, then use this property to identify your filename. You can include a path with your filename if needed. The bitmap format must be a standard windows BMP which can be loaded via the Windows LoadBitmap API call.

If you want to use a built-in bitmap, possible resource IDs range from 1700 to 1710 which represent various built-in bitmaps included in the ProEssentials DLL. For example, setting this property to the string "1702" fills the desk area with the resource bitmap identified by resource ID 1702. The built-in bitmaps are small bitmaps designed to be tiled by setting DeskBmpStyle to PEBS_TILED_BITBLT.

Comments

This property is only effective if BitmapGradientMode is TRUE, DeskBmpStyle is non-zero, and DeskColor is set to 1. For more information on background bitmaps and gradients, see commonly asked Question 36.

See Also: DeskBmpStyle, BitmapGradientMode, DeskColor.