Creating Form Components

Creation of new form components is possible within Aptify. Each component is based on .NET assemblies that implement the Aptify's IFormComponent interface. New components require new objects and classes to be written and compiled. The creation of this code is beyond the scope of this guide. A sample Form Components record is shown below.
Form Components Record

1. Open a new record from the Form Components service.
2. Enter a name and description for the component.
3. Enter a Category. If necessary, you can create a new category. See "Creating Form Component Categories" on page 560.
4. Select the Run Mode from the list to indicate how the component is enabled for use in form template parts.

• All — The component is enabled for all records (new and saved) defined by the form template.
• New Only — The component is only available for new records.
• Saved Only — The component is only available for existing records.

1. If Run Mode is set to either New Only or Saved Only, the Disabled Behavior field is available. Available options are:

• Disable — Selected by default. This disables the template part, so it appears as read-only. For example, when a component is set to Saved Only, it appears as disabled until the record is saved (at which point it becomes enabled).
• Hide — Prevents the template part from being visible except during the run mode selected for the form template part. For example, if Run Mode is set to Saved Only and Disabled Behavior is set to Hide, the part is not visible on new records.

1. Enter any additional information in the Comments field.
2. If this component corresponds to a tab on a form, you can specify an icon from the Object Repository in the Icon field.

• Tab parts that use this component will automatically display the selected icon to the right of the tab name, as shown in Figure 10.58. Component's Icon –Appearance

1. Place a check mark in the Add to Designer Toolbox box if you want to include this component in the Visual Designer's Toolbox.

• This is only applicable for components that correspond to a field on a form, such as a Text Field.

1. Click the Windows Control tab.

• The Web Control tab is reserved for future use.

1. In the Object field, enter the component file's location in the Aptify Object Repository.
2. Enter the Class within the object that implements the component's functionality.
3. Enter the .NET Assembly Name for the component.
4. Enter a License key for the component (if implementing a control from a third-party -vendor).
5. Save the record.