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.
The quality of the scaled image is controlled by the iscobol.bitmap_scale.best_quality (boolean) configuration property.
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.
 
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
   .