FILENAMES property (Image)

When used with Get_Property this property returns the names of the files that are used by the image object. When used with Set_Property it sets the names of the files used by the image object.

This property is an @Fm-delimited array of file names used to display the image at different DPI/Scaled settings. The position of a filename in the array corresponds to the DPI value for which it should be used, as illustrated in the following table.

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, along with its resource ID.

• 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

At runtime the Presentation Server takes the product of the parent form's SCALEFACTOR property and the DPI of the monitor on which it is displayed to calculate a "required DPI". This value is then compared to the items in the FILENAMES property to find the closest fit.

At runtime the actual file selected for display is determined by the product of the parent form's SCALEFACTOR property and the DPI of the monitor on which it is displayed, which results in a "required DPI".

The position of a filename in the array corresponds to a DPI value. At runtime the Presentation Server calculates a "required DPI" from the product of the

 
$Insert Logical

   

   // Example: Set the auto-scaling of the background image for the

   // current window to FALSE$

   Call Set_Property_Only( @Window, "AUTOSCALE", FALSE$ )
 
 
 

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