Selecting Captions and Control Names

The ninth sheet of the Form Wizard dialog enables you to specify captions and names for the controls on your form.

The Form Wizard automatically provides a caption and a control name for each of the features that you selected on the previous sheet. You can accept the automatic names that are provided or you can overwrite them with the captions or names that you require.

The caption is built in the following way.

• The caption is based on the feature name

• It is assumed that the feature name is lowercase, except at the beginning of new words within the name; for example, customerAddressLine1.

• Capitalizing the first letter of the first word and inserting a space between the words then creates the default caption. For example, the caption for customerAddressLine1 becomes:

  Customer Address Line1

The control name is built in the following way.

• The feature name is prefixed by ctl_

• The name is truncated to 19 characters. For example, customerAddressLine1 becomes:

  ctl_customerAddress

• If the control name causes a conflict with another control, property, or method name, a number preceded by an underscore character (_) is appended to the name in the form. This number is increased by one until a valid unique name is found. For example, the truncation of customerAddressLine1 would conflict with customerAddressLine2, and so on. This is resolved automatically, so that the control name for customerAddressLine1 becomes:

  ctl_customerAddress_1

• Click the Next > button to affect your selection and display the next sheet.

For details about control name prefixes, see "Defining Control Name Prefixes" under "Creating a Form", earlier in this chapter.