FILENAME property (Image)

When used with Get_Property this property returns the name of the file being displayed. When used with Set_Property it operates the same as the FILENAMES property.

When used with Get_Property the value is the name of the selected image file name being displayed.

When used with Set_Property the value can be an @Fm-delimited array of file names as per the FILENAMES property.

Image file names can be in one of several formats:

• A path and file name of an image file.

• A path and file name to a resource file (such as a DLL) containing the image.

• The name of a "System Icon".

• The string "<memory> if the image has been set by the SETIMAGE method.

• The string "<HBITMAP>" if the image was set by the SETHBITMAP method.

(Note that the latter two formats cannot be used with Set_Property).

When a control has been given a set of multiple filenames to display the Presentation Server selects the closest match based on the current scaling information for the parent form. See the FILENAMES property for more details on this.

WINDOW SCALEFACTOR property, Image FILENAMES property, Appendix J - System Icons, Appendix K - High-DPI Programming