Bitmap-Scale
This property specifies what to do if the image dimensions don’t fit the area identified by
Lines,
Size and
Bitmap-Width properties.
The possible values for this property are:
0 | The image is not altered. This is also the default behavior when Bitmap-Scale is not set. |
1 | The image is resized to fit completely the area. The aspect ratio may be altered. |
2 | The image is resized maintaining the aspect ratio. The resized image may not fit completely the area. |
If the Check-Box control is resized by a Layout-Manager and Bitmap-Scale is set to "1" or "2", then the image is resized along with the window.
When dealing with bitmap strips, the runtime first isolates the image from the strip, then it applies the scale to the isolated image.
The initial scaling of the bitmap to the dimensions of the Check-Box occurs only if the
Title-Position property is 0 or omitted. If
Title-Position is not 0, the bitmap will be scaled only when the dimensions of the Check-Box change.
Example - Define a checkbox in screen section, define the width of each bitmap on a image containing many and apply bitmap scaling
screen section. ... 03 screen-1-cb-2 Check-Box line 27.0 column 10.0 size 116 lines 31 id 11 flat title "My Check Box" bitmap-handle my-cb-png bitmap-number 1 bitmap-width 20 bitmap-scale 2 title-position 2 bitmap-selected 2 . |