Bookshelf Home | Contents | Index | Search | PDF

Siebel Interactive Designer API Reference > Pageset Functions > BuildWidget >

Radio Button Input UI Controls

---

You can create a radio button input UI control that uses a graphic caption for the radio button instead of a text caption.The graphic specified for the imageFile argument will be used for the button caption.

The syntax used to create a radio button input UI control with a text caption is:

ISS.BuildWidget("RADIO",window,name,indexRow[,imageFile])

Argument	Description
name	Defines the source of the content that populates the input UI control. For list box input UI controls, this is the name of a Feature table in the Interactive Designer project. A radio button input UI control is associated with a particular row in the table. The row is specified by the indexRow argument.
indexRow	The row in the specified Feature table for which the button is created. (Note that the first row in the table is considered row `0'.)
imageFile	Optional. Interactive Designer data column, such as PICT, that contains information about the graphic, such as the name of the image file.

Notes

A separate BuildWidget function call is required for each row in a Feature table that is associated with a radio button.
The DEFAULT column in the associated Feature table determines which radio button is selected when the pageset is initially loaded. If no row in the table contains the value DEFAULT, the radio button that corresponds to the first row in the table is selected.

Examples

The following sample code creates a radio button input UI control. This input UI control is based on the first row of the Feature table BODY, and the indexRow argument is set to 0. The caption text is created using a separate HTML entry.

<SCRIPT>

document.write(ISS.BuildWidget("RADIO",window,"BODY",0));

</SCRIPT>2-Door Coupe

The following sample code creates the same 2-Door Coupe radio button as in the previous example, but with a graphic caption.

<SCRIPT>

document.write(ISS.BuildWidget("RADIO",window,
"BODY",0,"PICT"));

</SCRIPT>

The PICT argument will first attempt to get the graphic from BODY.PICT. If there is no PICT column in BODY, it will get the graphic directly.

<SCRIPT>

document.write(ISS.BuildWidget("RADIO",window,"BODY",0,
"TwoDoorCoupe.gif"));

</SCRIPT>

TwoDoorCoupe.gif should reside in the pg directory.

Bookshelf Home | Contents | Index | Search | PDF