GraphBmpFilename

Purpose

This property identifies a file name or resource ID for a background bitmap to be placed onto the graphs charting or axis area.

For .NET developers, there's a simlar feature GraphBackgroundImage.

Individual axes can each have their own bitmap and/or gradient parameters by utilizing WorkingAxis.

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 graphs area with the resource bitmap identified by resource ID 1702. The built-in bitmaps are small bitmaps designed to be tiled by setting GraphBmpStyle to PEBS_TILED_BITBLT.

Comments

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

See Also: GraphBmpStyle, BitmapGradientMode, GraphBackColor, WorkingAxis.