11.1 Parameterizing a Property using an Input Control
To parameterize a component property using an input control, follow these steps:
1. Create and configure the input control. Follow the steps below:
a. Add the desired input control (RadioButton, CheckBox, etc.) to the Viewsheet.
b. Right-click the input component, and select 'Properties' from the context menu. This opens the 'Properties' dialog box for the input component.
c. Under the General tab, use the 'Name' field to assign the input component a meaningful name. This is the name used to refer to the component.
d. Specify the 'List Values' for the input component by manually entering 'Embedded' values or by specifying a 'Query' to provide the values. (See Input Components for further details.)
e. Click 'OK' to close the input component 'Properties' dialog box.
2. Link the input control to the component property you want to manipulate. Follow the steps below:
a. Right-click the component you wish to control, and select 'Properties' from the context menu. This opens the 'Properties' dialog box for the controlled component.
You can specify an input control for any property that offers the 'Variable' option.
b. Locate the property that you wish to control, and select 'Variable' from the adjacent pop-up menu.

c. From the corresponding pop-up menu, select the input component that should control the property.

d. Click 'OK' to close the 'Properties' dialog box for the controlled component.
The specified input control will now provide the value of the selected property.
In this example, you will add a RadioButton input that allows the user to set the Y-axis field of a chart to either 'Quantity Purchased' or 'Total Revenue'.
1. Create a Viewsheet based on the 'ProductSales' Data Worksheet in the 'Tutorial' folder.
2. Add a radio button to the Viewsheet, with two embedded values ('Quantity Purchased' and 'Total').
3. Add a chart to the Viewsheet and bind it to the 'SalesByDate' Data Block. Add the 'State' field as the X-axis and the 'Quantity Purchased' field as the Y-axis.
4. Click the 'Quantity Purchased' menu to select it.
5. Click the 'down arrow' next to the menu, and choose the 'Variable' option. This populates the menu with all of the available variable names.

6. From the list of variables, choose '$(RadioButton)'.
7. Now click the radio buttons. Note that the chart displays the Y-axis field that you choose using the radio button control.

See Also
Matching Dynamic Values to Property Values, for input value constraints.
| << 11 Dynamic Properties | © 1996-2013 InetSoft Technology Corporation (v11.5) | 11.2 Parameterizing a Condition using an Input Control >> |