BBjRadioGroup

Creation Path


BBjAPI

|

+--BBjSysGui

|

+--BBjWindow

|

+--BBjRadioButton

|

+--BBjRadioGroup

 

Description

In BBj 5.0 and higher, the BBjRadioGroup object provides methods for manipulating a collection of related GUI radio button controls.

Implemented Interfaces

None.

Creation

A BBjRadioGroup object is created through the following BBjWindow methods:

Return Value

Method

BBjRadioGroup

addRadioGroup()

BBjRadioGroup

addRadioGroup(BBjVector radioButtons)

Methods of BBjRadioGroup

Return Value

Method

void

add(BBjRadioButton radioButton!)

BBjRadioButton

getSelected()

void

remove(BBjRadioButton radioButton!)

Events

None.

Remarks

The BBjRadioGroup is the structure that defines the mutual exclusivity of a set of radio buttons, such that selecting one causes all others in the group to become unselected. Radio buttons are also usually set to be in a keyboard navigation group .

Example

rem ' BBjRadioGroup
sysgui = unt
open (sysgui)"X0"
sysgui! = bbjapi().getSysGui()
window! = sysgui!.addWindow(25,25,200,200,"BBjRadioGroup",$00090003$)
window!.setCallback(window!.ON_CLOSE,"eoj")
rb1! = window!.addRadioButton(101,25,25,150,25,"RadioButton1",$0020$)
rb1!.setCallback(rb1!.ON_CHECK_ON,"event")
rb1!.setCallback(rb1!.ON_CHECK_OFF,"event")
rb2! = window!.addRadioButton(102,25,50,150,25,"RadioButton2",$0020$)
rb2!.setCallback(rb2!.ON_CHECK_ON,"event")
rb2!.setCallback(rb2!.ON_CHECK_OFF,"event")
rg1! = bbjapi().makeVector()
rg1!.add(rb1!)
rg1!.add(rb2!)
window!.addRadioGroup(rg1!)
rb3! = window!.addRadioButton(201,25,100,150,25,"RadioButton3",$0020$)
rb3!.setCallback(rb3!.ON_CHECK_ON,"event")
rb3!.setCallback(rb3!.ON_CHECK_OFF,"event")
rb4! = window!.addRadioButton(202,25,125,150,25,"RadioButton4",$0020$)
rb4!.setCallback(rb4!.ON_CHECK_ON,"event")
rb4!.setCallback(rb4!.ON_CHECK_OFF,"event")
rg2! = bbjapi().makeVector()
rg2!.add(rb3!)
rg2!.add(rb4!)
window!.addRadioGroup(rg2!)
process_events
event:
event! = sysgui!.getLastEvent()
i = msgbox(event!.getRadioButton().getText(),0,event!.getEventName())
return
eoj:
release

See Also

BBjAPI

BBjSysGui

BBjWindow

RADIOBUTTON Mnemonic - Create a Radio Button Control

RADIOGROUP Mnemonic - Create a Radio Button Group

CALLBACK Verb - Register BBj Subroutine

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.