Inserting objects into the panel

You can insert labels and web controls, which are used as variables, into the configuration panel. The web controls that can be inserted into the configuration panel of a library component are: text field, checkbox, drop-down list, and list.

Inserting a label

To insert a label into the configuration panel:

1. Do one of the following to insert the label:
   • Drag Label from the Toolbox panel to the destination.
   • On the menu bar, click Insert > Label, then drag the label to the required destination.
   • On the Insert toolbar, click the Insert Label button , then drag the label to the required destination.
2. Double-click the label to edit the text.

Inserting a text field

To insert a text field into the configuration panel and define its web options:

1. Do one of the following to insert the text field:

   • Drag Text Field from the Toolbox panel to the destination.
   • On the menu bar, click Insert > Web Controls > Text Field, then drag the text field to the required destination.
   • On the Insert toolbar, click the down arrow on the Insert Control Objects button and select Text Field from the drop-down list, then drag the text field to the required destination.
2. Right-click the text field and select Web Options from the shortcut menu. The Web Options dialog displays. See the dialog.

   

3. Select the type of the text field: Standard or Password.

   Standard means that the text field will be a normal text field. Password means that the text field will be a password box in which the typed characters will be displayed as asterisks.

4. Enter the name, value for the text field in the Name and Value fields.
5. In the Tool Tip field, enter the tip you want to show for the text field. When the component is displayed in a dashboard, when you hover the mouse over the text field, the tooltip will be displayed.
6. Set the character width in the Display Width field, and the maximum number of characters the user can enter in the Max Length field.
7. Check the Read Only option if you would like to set this text field to be read-only.
8. Check the Disabled checkbox if you want to make the text field disabled.
9. Upon finishing, click the OK button to close this dialog.

Inserting a checkbox

To insert a checkbox into the configuration panel and define its web options:

1. Do one of the following to insert the checkbox:

   • Drag Checkbox from the Toolbox panel to the destination.
   • On the menu bar, click Insert > Web Controls > Checkbox, then drag the checkbox to the required destination.
   • On the Insert toolbar, click the down arrow on the Insert Control Objects button and select Checkbox from the drop-down list, then drag the checkbox to the required destination.
2. Right-click the checkbox and select Web Options from the shortcut menu. The Web Options dialog displays. See the dialog.

   

3. Specify the name, value of the checkbox in the Name and Value fields.
4. In the Tool Tip field, enter the tip you want to show for the checkbox button. When the component is displayed in a dashboard, when you hover the mouse over the text field, the tooltip will be displayed.
5. Set Initially Checked to true if you want the checkbox to be selected by default.
6. Check the Disabled checkbox if you want to make the checkbox disabled.
7. Upon finishing, click OK to close this dialog.

Inserting a list/drop-down list

List and drop-down list are generally called multivalue containers. A list or drop-down list provides a list of values for users to select from. A drop-down list occupies a smaller space than a list box so that the configuration panel can be laid out more compactly.

To insert a list/drop-down list into the configuration panel and define its web options:

1. Do one of the following to insert the list/drop-down list:

   • Drag List/Drop-down List from the Toolbox panel to the destination.
   • On the menu bar, click Insert > Web Controls > List/Drop-down List , then drag the list/drop-down list to the required destination.
   • On the Insert toolbar, click the down arrow on the Insert Control Objects button and select List/Drop-down List from the drop-down list, then drag the list/drop-down list to the required destination.
2. Right-click the list/drop-down list and select Web Options from the shortcut menu. The Web Options dialog displays. See the dialog.

   

3. Specify the item labels and the value of each item in the items box by inputting some strings as the labels and values respectively.

   If you want to use a DBField/formula field/parameter field to control the value, click in the Value column to insert one with the Insert Fields dialog, and then select the format for the inserted field from the drop-down list in the Item Label column. Check the All radio button in the Insert Field dialog if you want to add an All value to the list/drop-down list. Then when All is selected as value of the list/drop-down list at runtime, all filter actions defined on the list/drop-down list will not take effect, and if you applied some other web action that needs value from the list/drop-down list, a Null value will be returned.

4. For a list web control, you can check the Allow Multiple Selections checkbox if you want to allow multiple items to be selected.
5. In the Selected field, specify the selected value for the list/drop-down list.
6. To use the runtime value as the selected value, check Use Runtime Value.
7. If you want to disable the list/drop-down list, check the Disabled option.
8. When done, click OK to apply the settings.