Defining a Checkbox Control 

Use

You use this procedure to define the properties and event handlers for a checkbox control. A checkbox control. At runtime, the user can select or clear an option in this checkbox.

A checkbox control:

·        Can be bound (associated with a data source property) or left unbound

·        Can be associated with a hyperlink

Prerequisites

You have:

·        Added a checkbox control in a tile

·        Identified the property and its business object or business query. This property will be associated with the checkbox control.

Ensure that the property assigned to the control has one of the following data types:

·         Boolean

·         String attribute that contains True or False

·         Number attribute that contains 1 or 0

·        Identified the business anchor that references this data source

·        Switched to the required change list

Procedure

...

       1.      In the Solution Explorer, locate the tile for which you want to design the checkbox

                   1.control, click the tile with the secondary mouse button, and choose View Designer.

The Tile Designer window appears.

       2.      Select the checkbox control.

The Properties panel displays the values for the checkbox control.

       3.      Enter the appropriate values for the checkbox control.

For information on each of the properties, see Properties of a Checkbox Control.

       4.      If you do not want to associate a hyperlink, continue with step 5. If you want to associate a hyperlink with the checkbox control, click the control with the secondary mouse button and choose View Hyperlinks.

For more information, see Model a Hyperlink.

       5.      If you do not need to create an event handler, continue with step 6. If you want to create an event handler, perform the following steps:

                            a.      In the Tile Designer, click the control with the secondary mouse button and choose Add Handler.

The New Event Handler dialog box appears with default values in the fields.

                            b.      In the Event field, select the event you want to use.

The following table provides information about the events.

Event Name	Description
onBoundAttributeChanged	The value of the checkbox changes because the value of the associated BO attribute changed.
onHyperlinkClicked	The user selects the hyperlink. This event occurs before the hyperlink is executed.
onValueChanged2	The value of the checkbox changed.

The onValueChanged event is not supported in this release. Use onValueChanged2 event.

                            c.      Select Edit this handler code after creation and choose OK.

                            d.      Enter the code you require for the event handler.

                            e.      Save the code.

       6.      Save your entries.

Result

You have defined a checkbox control by specifying the properties and event handlers.

See also:

 

Adding Controls to a Tile

Defining a Radio Button Control