47
46
Changing Button-Specific Properties
In addition to the common settings, a Form Button has the following additional
settings:
Layout:Define the location of the button icon and label. If your button has an
icon as well, click Advanced…to access its scaling settings. You can set the
conditions on when to allow icon scaling; whether it is to be carried out
proportionally; or use the slides in the panel for the precise placement of the icon
on the face of the button.
Behavior:Specify the visual effects the button should display when pushed:
None, Push, Outline, or Invert.
State:Push buttons (Behavior: Push) have 3 distinct states.If your button has
only a label but no icon, you can assign a different label to each state. To assign
different labels to each button state, do the following:
o Click Layoutand choose Label only.
o Click Behaviorand select Push.
o Click State, and choose Up.Click Labeland specify the label that will display
on the button when no mouse interaction occurs with it.
o Click Stateand select Down. Click Label and type in the button label that will
be displayed when the mouse button is pushed on the button.
o Click Stateand choose Rollover. Click Label and specify the button label
that will display when the mouse moves over the button.
Label:Enter a label for your button. Fora Pushbutton you can assign a different
label to each button state, as describedabove.
Icon:Select the image that you will use as the icon for your button. Icons can be
created from a variety of file formats.
Changing Check Box Properties
In addition to common settings, a Check Box field has the following additional
settings:
Check Box Style:Choose the checkmark for your Check Box. The following
types are available: Check (default), Circle, Cross, Diamond, Square, Star.
Export Value:Enter a value for the chosen item to be exported to a CGI
(Common Gateway Interface) application. CGI is a standard for data transfer
between client web browsers and web servers. Using CGI scripts you can
retrieve data from forms displayed in web browsers.
Check box is checked by default:Decide whether to have the check box
selected (checked) by default
.
46
47
Changing ComboBox Properties
In addition to common settings, a Combo Box and List Box fields have the following
additional settings:
Options
Item:Click Item, then give it a name. Click Add. Your new item will appear in the
combo box Items List (below in the panel).
Export Value:Enter a value for the chosen item to be exported to a CGI
(Common Gateway Interface) application during web-based data transfer from
your form.
It is useful practice to specify the export value for each of your items right after
you have added them to the combo box list.
Items List:Select an item to move it up or down the list. You can also delete
combo box items here, one by one.
Sort Items:Mark this check box to sort your list items in an alphabetical order.
Allow user to enter custom text:When checked, the combo box list becomes
editable for users of the form.
Commit selected value immediately:Combo boxes can be connected to text
fields in such a way that the items selected in the combo box will display in the
corresponding text fields. If you mark this checkbox, as soon as a combo box
item is selected, it will display in the connected text box. If you leave it
unchecked, the chosen item will only display in the text field when focus has
moved over from the combo box (either by mouse movement or tabbing).
To make a text box display the item selected a combo box, write a custom
calculation script for your text box that captures the input of the combo box.
The following script uses a text field (Text Field 1) and a combo box (Combo Box 1).
For Text Field 1 to capture the input of Combo Box 1,
1. Select Text Field 1.
2. Click Calculatein the Form Properties panel of the Organizer.
3. Mark Custom calculation script.
4. Click Edit, and enter the following:
event.value=this.getField(“Combo Box 1”).value;
Format (Combo Boxes only)
Use Format settingsto control the type of data users can enter into the form field.
For details see Setting Format
.
Validate (Combo Boxes only)
Run a custom validation script to ensure that the value entered by a user is correct.
For details see Setting Validation
.
49
48
Calculate (Combo Boxes only)
Use Calculate settingsto perform mathematical operations on form fields. For
details see Setting Calculation
.
Options for List Boxes only
Multiple Selection: If you mark this check box, users of your form will be able to
select more than one item in the list box.
Changing Radio Button Properties
Radio buttons can be grouped together under a common field name but with
different export values. (Unique export values are needed for CGI applications on a
Web server to identify each field.) To group radio buttons, create them one by one,
then give them all the same name. Grouped radio buttons are mutually exclusive –
i.e. only one of them can be selected.
Options
Radio Button Style: Check, Circle(default), Cross, Diamond, Square, Star.
Export value:Enter a value for the chosen item to be exported to a CGI
(Common Gateway Interface) application during web-based data transfer from
your form.
Radio buttonis checked by default: Decide whether to have the radio button
selected (checked) by default.
The same name and value are selected in unions:Use this option if you want
to make the behavior of one radio button driven by another one. Create two radio
buttons, give them the same name, then mark this check box. This way,
whenever the user of your form marksor unmarkseither of them, the other one
will follow suit.
Actions
See Setting Actions
for details.
Changing Text Field Properties
In addition to common settings, the Text Field has additional settings:
Options
Alignment:Specify text alignment in the text field.
Default Text:You can enter default text for the text field here (not required).
Multiple line:Mark this checkbox to allow multi-line text.
Scroll long text:Allow scrolling to show text that is too long to fit in the text field.
Limit of characters:Specify the upper limit on the number of characters that
can be entered into the text field.
Password:Mark this checkbox to have the text displayed as asterisks.
39
49
Format
Use Format settingsto control the type of data users can enter into the form field.
For details see Setting Format
.
Validate
Run a custom validation script to ensure that the value entered by users is correct.
For details see Setting Validation
.
Calculate
Use Calculate settingsto perform mathematical operations on form fields. For
details see Setting Calculation
for details.
If you want to use cookies for your text fields, set their lifecycle in the Preferences
panel ofthe Organizer. For details seePreferences / Option Settings /
Miscellaneous
.
Setting Format
Choose the format fordata entered in text and combo boxes –such as number,
percentage, date, and time. Choose Specialfor entering ZIP Codes (Postcodes),
Phone Numbers, Social Security Numbers, or create an arbitrary mask.
Arbitrary Mask
Use the Arbitrary mask to specify a pattern of different types of characters users can
enter in a given position. Here you can also define how data displays in the field.Use
the following codes in the Enter maskfield:
A: represents letters.
X: stands for all characters on the standard keyboard and ANSI characters within
the ranges of: 32-126 and 128-255 (spaces and most printable characters).
O: represents alphanumeric characters (A-Z, a-z, and 0-9).
9: stands for numeric characters (0-9).
For example the mask AAA-#999-XXX: will accept the input DNN-#123-(9)
Custom Format
Usecustom format to create your own custom JavaScript for data formats and
keystroke validation. You can also define a special currency format and a special set
of related keystrokes.
33
50
Setting Validation
You can choose to validate a form field by marking the Run custom validation
scriptcheck box. This way you can control the data that users can enter into a given
field. Form field validation helps avoiding typing errors.
Mark the check box, then click Editand create your own Java Script in the dialog.
For numeric fields (Format category: number or percentage) you can also choose
the Field value is in rangeoption. Mark the radio button, then specify the range of
values that the field accepts.
Setting Calculation
You can perform mathematical operations in text fields of your form. If you choose to
assign calculations to a text field, you can either choose a pre-defined one, or write
your own calculating Java Script. Otherwise mark Value is not calculated.
Using Pre-defined Operations
Click Value is the type of the following fieldsand choose a calculation from the
list. Click Pickto select the form fields used in the given calculation. The following
choices are available:
Sum(+): The form field will display the sum of all the fields specified in the list.
Product(x): The values in the fields you specify will by multiplied by each other, and
the result will display in the calculation field.
Average: The calculation field will display the average of the values that users enter
into the fields in the calculation list.
Minimum:The smallest value in the selected fields will display in the calculation
field.
Maximum: The highest value in the selected fields will display in the calculation field.
Using Custom Java Script
Mark Simplified field notation or Custom calculation script. Click Edit to create
or modify your script.
Setting Actions
To make form fields dynamic, you can assign different actions to them and set their
parameters. Actions can include opening a web link, a file, importing and submitting
form data and more. To assign actions to form fields, use Set Actionin the
Organizer.
Documents you may be interested
Documents you may be interested