ContentsIndexPreviousNext

STYLES

BITMAP This style causes the radio button to be drawn with a bitmap instead of its usual appearance. See Chapter 3, section 3.8 for a complete description.

FRAMED This style is used only with bitmap buttons. It requests that a thin frame be drawn around the button. Typically this appears as a thin black line. Not all systems support frames, in which case the request is ignored. By default, buttons are framed under Windows NT/Windows 2000.

UNFRAMED This style is used only with bitmap buttons. It requests that the button be drawn without a frame. Not all systems support unframed buttons, in which case the request is ignored. By default, buttons are not framed under Windows 95/98.

SQUARE This style is used only with framed bitmap buttons. It forces the button to have square corners. Without this style, the button will have slightly rounded corners.

SELF-ACT This style creates a self-activating radio button. The behavior of the SELF-ACT radio button is the same as that of the SELF-ACT push button (see section 5.5). Self-activating radio buttons return control to the previously active control or window when they are clicked. Usually, you will want to use the NOTIFY style in conjunction with SELF-ACT so that your program is informed whenever the radio button is clicked.

NOTIFY This style tells the runtime to generate a CMD-CLICKED event whenever the value of the radio button is changed by the user. This allows your program to respond immediately to the change. In essence, the radio button will now act like a combination radio button and push button. Without the NOTIFY style, the radio button remains active after it has been changed (exception: see SELF-ACT above).

NO-GROUP-TAB Normally, radio buttons that belong to a button group treat the "Tab" and "Backtab" keys in a special fashion. Any time a radio button has a non-zero GROUP special property, it acts as if it also has the NO-TAB style unless it is the group leader. The group leader is the radio button that is currently "on," or the first radio button in the group if they are all "off." The effect is that when you tab to a radio button group, control passes to the button that is on, or to the first button in the group if none is on. Note that the NO-GROUP-TAB style suppresses this special handling.

LEFT-TEXT Radio buttons with this style display their text to the left of the box instead of to the right. Note that if you use this style and try to vertically align several radio buttons, the buttons may not align vertically. This is because the default behavior of the runtime is to place the right edge of the button at the minimum distance needed from its left edge to accommodate the control's text. This results in the buttons being placed in different columns depending on the text of each control. Supplying a uniform width using the SIZE property overrides this behavior. (create, modify)

FLAT This style is used only with bitmap buttons. It creates a radio button without visible borders on Windows systems. On non-Windows systems, this style has no effect.