This property identifies a particular bitmap image to use with the radio button. If you explicitly name this property when creating a 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.
This property identifies the bitmap image strip to use with the radio button. See Paged List Boxes for more information.
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.
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.
This property works in a manner identical to the TERMINATION-VALUE push button property. This property is used only when the NOTIFY style is also used. The compiler applies the NOTIFY style automatically if you explicitly name this property when creating a 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).
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 applies the NOTIFY style automatically if you explicitly name this property when creating a 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).
Radio buttons usually operate in groups of related buttons. Normally, only one button of the group may be selected. When a button is selected, all other buttons of the same group are unselected. The GROUP property describes which buttons belong together. In any one floating window, all radio buttons with the same non-zero GROUP property value are treated as a single group. The runtime will ensure that only one button in a group is selected at any one time.
The default GROUP value is 1. If all radio buttons on the same floating window retain the default value, they will be treated as a single group.
Radio buttons with a GROUP value of 0 do not perform any checks to ensure that only one button is selected. These buttons behave much like check boxes; each one may be independently selected.
This property simplifies the process of managing a group of radio buttons. Normally, the program must determine which button in a group is selected by examining the value of each button. The button with a value of 1 is the selected button. The GROUP-VALUE property is used to turn the value checking process into a single operation. You assign each radio button in a group a distinct GROUP-VALUE number. This links each button with its corresponding GROUP-VALUE. In this way, you can determine which button is selected by assigning all of the buttons in the group the same VALUE data item. The data item will hold the GROUP-VALUE number of the selected radio button.
Technically, this works as follows. For any radio button with a non-zero GROUP-VALUE property, a selected button will update its VALUE data item only during an ACCEPT. A selected button will return its GROUP-VALUE property as its VALUE. During a DISPLAY, a radio button will be selected only if its VALUE matches its GROUP-VALUE. Any other VALUE will be treated as a VALUE of zero.
Use this by assigning distinct GROUP-VALUE numbers to each button in a group, and by assigning all the buttons to the same VALUE data item. Then you can select a button by moving the button's GROUP-VALUE number to the VALUE data item and updating all the buttons. On input, you can determine which button is currently selected by simply examining the VALUE data item. It will contain the GROUP-VALUE number of the selected button.
The default value for GROUP-VALUE is zero, which disables the GROUP-VALUE mechanism.