Special Properties

BITMAP-NUMBER (number)

This property identifies the particular bitmap image to use with the check box. If you explicitly name this property when creating the control, the BITMAP style is automatically applied by the compiler. Note that this does not occur if you use the PROPERTY phrase to specify this property (by giving its identifying number). See Paged List Boxes for more information.

BITMAP-HANDLE (handle)

This property identifies the bitmap image strip to use with the check box.

BITMAP-SCALE

This property is used to enable resizing of bitmaps. If not set, or set to its default value of 0, the bitmap cannot be resized. This means if the size of the interior of the image is smaller than the image, the image is cut to fit. If the interior is larger than the image size, the image size does not increase to fill the interior.

If set to 1, the bitmap will scale up or down to fit the interior given, and no cutting of the bitmap occurs.

When setting this property, you must set it prior to setting the property BITMAP-HANDLE to have any effect. For example:

SCREEN      SECTION.
01  TEMPLATE-SCREEN.
  03      bmp              BITMAP
          BITMAP-SCALE     1 
          BITMAP-HANDLE    GT-BITMAP
          SIZE             100 pixels
          LINES            200 pixels
          LINE             1
          placeStateCOL              1.

With this new property, if you perform a MODIFY statement such as

MODIFY bmp SIZE = 200 LINES = 400.

the bitmap is resized accordingly and automatically. Note that you are not limited to specifying pixel units; you may specify any legal display unit.

Important:

To keep the image from becoming blurred in the resizing process, do not scale up or down in just one direction. For example, if you have an image that is 200x300, increase or decrease the width and height, not just one or the other.

If you enter an invalid resizing value for either the width or height, the invalid entry will be ignored and the previous width or height value will be used.

Resizing images is based on the image size, not the interior size. With multiple resizes, you always will be resizing based on the original image size, not the last resizing that you performed. This is done to maintain the best image quality, as resizing a resized image can degrade image quality.

Currently, only 24-bit colors are supported. If your bitmap is not 24 bit, you can use Microsoft paint to store the bitmap as 24 bit.

We recommend that jpeg files be used whenever possible, as they appear to give the best resizing capability.

TERMINATION-VALUE (numeric)

This property works in a manner identical to the push button property of the same name (see Special Properties paragraph for the push button control. This property is used only when the NOTIFY style is also used. The compiler applies the NOTIFY style automatically if this property is named when the control is created. Note that the NOTIFY style is not automatically applied if you use the PROPERTY phrase to specify this property (by giving its identifying number). See Push Button for more information.

EXCEPTION-VALUE (numeric)

This property works in a manner identical to the push button property of the same name. This property is used only when the NOTIFY style is also used. The compiler will apply the NOTIFY style automatically if you explicitly name this property when you create the control. Note that the NOTIFY style is not automatically applied if you use the PROPERTY phrase to specify this property (by giving its identifying number).