Form Design
The Form Designer is where you will add the controls that you want displayed on your forms. It provides a great deal of flexibility as it supports X/Y positioning for all Form Controls, including fonts, colors, and more.

The main areas of the Form Designer are:
To Add/Delete/Edit forms in Form Design, right click in the Form Design area for a menu to select an option from.
The Property Grid
If you click on a control, the property grid changes to show all of the properties of that control, and their current values. The image below shows an example of the property grid for a text box:

The property grid is made up of the following areas:
- Two buttons which toggle between categorized and alphabetical views
- Two columns, property names on the left, and property values on the right.
- A description of the currently selected property.
User Form Properties
Properties for each User Form can be set by clicking on the form in Form Design mode.
These include:
- Background Color - Sets the background color of the User Form.
- Default Font - Sets the default font for all controls placed on the form.
- Show Standard Navigation
The Standard Navigation buttons found at the bottom of the User Form during specifying are turned off with the Show Standard Navigation property.
Standard Navigation buttons look like the image below:

Customizable In Form Navigation can be created using Macro buttons with appropriate Specification Tasks associated to them.
Before turning Standard Navigation off be sure your alternative navigation works as expected.
Please refer to the article How To: Create In Form Navigation for more information.
Show Standard Navigation is a User Form property.
To display the properties of a User Form click in any blank space on the User Form in the Form Designer.
User Form properties must be set for each User Form in the project.
- Show Task List - Determines if the Task List that displays Form Messages is shown during specification.
- On Enter - Allows a Specification Macro to be selected to run when the User Form is loaded.
- On Next - Allows a Specification Macro to be selected to run when the User Form transitions to the Next Form.
- On Previous - Allows a Specification Macro to be selected to run when the User Form transitions to the Previous Form.
- (Tag) - Allows an alternative name or description for the User Form to be entered.

Examples
Show Standard Navigation Property Value | Result |
---|
True | Will use the standard navigation buttons. |
False | Will not use the standard navigation buttons. |
Zoom
The Form in view can have the zoom level set by selecting the required buttons from the command bar.
- Zoom +
Increases the zoom level, in 10% increments, to maximum 500%
- Zoom -
Decreases the zoom level, in 10% increments, to a maximum of 20%
- Reset Zoom
Resets the zoom scale to 100%.
This option is only available when the Form in view is not at 100%.
100% is the level that the User Form will always be displayed at when in a Specification.
The above options are also available by right clicking on the User Form.
Zoom Level
When the zoom level is not 100% the current zoom level is indicated at the top right of the Form Designer.

The zoom level is hidden when the current view is at 100%.
Resolution Guides
Resolution Guides help you to design User Forms within a specified boundary.
These are particularly useful when designing your User Forms for use on a common device.
There are a number of preset resolution guides available, these are:
- iPhone 5 Portrait
- iPhone 5 Landscape
- iPhone 2/3 Portrait
- iPhone 2/3 Landscape
The width and height of the presets match the screen resolution of the products they are named after, these can be adjusted on creation.

Add a Resolution Guide
To add a Resolution Guide:
- Select Form Design from Stage 2: User Interface.
- Click the Add Resolution Guide button.

- Enter a Name, Width and Height for the guide or select from the list in the Templates drop-down.

- Click Create. The Resolution Guide will be applied to all User Forms.
Edit a Resolution Guide
To edit a Resolution Guide:
- Right click on either the start or end Node of the guide.

- Select Edit from the menu.
- Make the required changes in the Edit resolution guide dialog.

Delete a Resolution Guide
To delete a Resolution Guide:
- Right click on either the start or end Node of the guide.

- Select Delete from the menu.
Resolution Guide Settings
Resolution Guides can have further settings applied.
See Settings to access the Settings dialog and Form Designer Settings for more information on Resolution Guide Settings.
Form Controls
Add a Form Control to a User Form
To create a new Form Control:
- Make sure that a form is selected in the Forms List
- Click the Toolbox entry for the type of control you want to create.
- Give the control a name.
- Click OK
DriveWorks Pro Form Control Types
The Form Controls that DriveWorks Pro supports are:
Type | Icon | Description |
---|
3D Preview Box |  | A control that displays an interactive 3D Model during specification. |
---|
Check Box |  | A control which allows a user to toggle between TRUE/FALSE. |
---|
Child Specification List |  | A list used to support nesting of specifications inside other specifications. |
---|
Combo Box |  | A list of data presented as a drop-down menu. |
---|
Data Table |  | A table of selectable data retrieved from a data source. |
---|
Date Picker |  | A control that allows a date to be selected from an interactive calendar. |
---|
Dialog Button |  | Provides support for launching a dialog to show information to the user, and ask for input. |
---|
Frame Control |  | A control in which any User Form, within the project can be displayed. |
---|
Hyperlink |  | Provides a clickable link to a URL. |
---|
Item List |  | A list of data created or edited using dialogs. |
---|
Label |  | Provides a way of displaying fixed or dynamic text on a form. |
---|
List Box |  | A list of options from which the user can select a single item. |
---|
Macro Button |  | Provides support for running a Macro in the design master when clicked. |
---|
Measurement Text Box |  | Provides support for entering linear dimensions in a variety of units. |
---|
Numeric Text Box |  | A text box which only supports numeric input within a fixed or dynamic range of values. |
---|
Option Button |  | A single option, in the form of radio buttons, from which the user can select a single item. Option Buttons can be grouped outside a frame and across different forms. |
---|
Option Group |  | A list of options grouped within a single frame, in the form of radio buttons, from which the user can select a single item. |
---|
Picture Box |  | A control which can display a picture whose path can either be a fixed value, or the result of a Rule. |
---|
Slider |  | A horizontal or vertical bar with an indicator that can be dragged to represent a numeric unit. |
---|
Specification Host |  | A control that allows you to host a Specification or a Child Specification. |
---|
Spin Button |  | A control which supports numeric input within a fixed or dynamic range of values, and with buttons that increment or decrement the value of the control by a certain amount. |
---|
Text Box |  | A control which supports textual input. |
---|
Upload Control |  | A control that allows a client side file to be uploaded. |
---|
Web Frame |  | A control that allows external web content to be rendered onto a User Form. |
---|
Form Control Properties
Each Form Control has various properties that can be set or have rules applied to them that will dynamically change the behavior of each property during specification.
Fixed and Active properties
When a control is added to the User Form and selected various properties become available in the property grid. All control properties have the following possible states:
- Fixed
Fixed properties set certain behavioral properties or define the actual name of the control. These properties can only be changed in the form design stage.
- Active
Active properties can be set to be one of the following states:
- Dynamic
A property set to be dynamic gives the option to apply a Rule to the property that will be evaluated during the running of a specification.
This allows the property to change during specification.
For example this could be a change to data in a list type control, the position of the control on the user form or if the control is visible or not. Dynamic properties applied by DriveWorks cannot be made static, but they do not necessarily require a Rule.
- Static
A static property, like a fixed property, is set during Form Design.
Unlike fixed properties there is the option to make this dynamic. Static properties can be made dynamic.
All control properties can be used in Rules. See How To: Reference Control Properties for more information.
Caption or Text property
The position of the Caption in relation to the control differs between control types.
By default the Caption takes the name given to the control when the control is created (not on renaming the control).
As control names cannot include spaces capitalized words are automatically separated with a space for the Caption.
For example:
When the name shown in the image below is given to a control.

The Caption displayed will be:
Please Enter The Length
Static properties can only be changed to Dynamic properties on DriveWorks projects.
This functionality is not available for Microsoft Excel based projects.
For information on changing a static property to a dynamic property please see How To: Change A Static Property To A Dynamic Property.
Set the Value of a Dynamic Property
- With the User Form active in the Form Design area select the control that you want to set the value for.
- Locate and select the dynamic property in the property grid
- Click the button that appears to the right of the property value.

- This launches the Rule Builder from which the value can be set.
Set the Value of a Fixed or Static Property
- With the User Form active in the Form Design area select the control that you want to set the value for.
- Locate and select the property in the property grid.
- The selected property value can be changed by swiping over the current value and entering a new value.
- Or select the drop-down box to the right of the property value and select the new value from the list of options.
User Forms can be exported as a template, for re-using in other Projects.
User Form template creation allows data within a Project to be included in the template.
Multiple User Forms can be included in the template. Use Ctrl + select to choose the required User Forms from the Forms List.
- Select the User Form(s) to be exported.
- Click the Export Form As Template button from the command bar.
- Enter Template Details:
- Select Project Constants.
This lists all Constants in the Project. Constants can be selected individually or all at once (right click, Select All).
- Select Project Variables.
This lists all Variables in the Project. Variables can be selected individually or all at once (right click, Select All).
- Select Calculation Tables.
This lists all Calculation Tables in the Project. Calculation Tables can be selected individually or all at once (right click, Select All).
- Select Specification Macros.
This lists all Specification Macros in the Project. Specification Macros can be selected individually or all at once (right click, Select All).
- Select Additional Content.
This allows any other file to be selected for inclusion in the template.
Its primary purpose is to allow the inclusion of images, DriveWorks 3D files.
Do not include Individual Group or Project files, temporary files, other templates, etc.
Install a Form Template
Once the template has been created, it must be installed on each DriveWorks Administrator machine it is required to be added from.
DriveWorks templates can only be installed on machines that have DriveWorks Administrator installed.
- Locate the template created above, for example this will be:
<SaveLocation><TemplateName>.drivefort
- Double click the file.
- Follow the steps in the Install wizard.
To add the template to a Project, see Creating a Form from a Template.
Control Guides
Control Guides allow quick and accurate alignment of controls when designing User Forms.
Control Guides appear when controls are moved on the User Form.

Control Guides align to other controls in two ways:
- Margin Guides - Snap a set distance away from another control.
- Alignment Guides - Snap to the edges of another control.
Control Guides can also snap to any Resolution Guide in use on the User Form.
Adjust Control Guide Settings
Control Guides settings allow the following properties to be changed to suit your preferences.
- Enable/ Disable.
- Margin and Alignment Guide Color.
- Snap Range.
See Settings to access the Settings dialog and Form Designer Settings for more information on Control Guide Settings.
Group Controls
Form Controls can be grouped so they move as one when repositioning is required.
To Group Controls
Controls can be grouped by:
- Select two or more controls from the same User Form.
- Right click on one of the selected controls.
- Select Group Controls from the menu.

To Ungroup Controls
Controls can be ungrouped by:
- Selecting a group of controls from the User Form.
- Right click on the group.
- Select Ungroup Controls from the menu.
Keyboard Control Positioning
Accurate Positioning of Form Controls Using Keyboard Arrows.
To fine-tune a controls position, use the keyboard arrow keys to move the selected control one pixel at a time.
- Select a single control or multiple controls to be moved.
- Press and hold the Alt key on the keyboard and the arrow key that corresponds to the direction the control is to be moved.
- Alt +
- Move the control(s) 1 pixel up. - Alt +
- Move the control(s) 1 pixel left. - Alt +
- Move the control(s) 1 pixel down. - Alt +
- Move the control(s) 1 pixel right.
Multi-Selection of Controls
Multiple form controls can be selected by the following methods:
- Fence Selection - Click in a blank area of the form and drag a fence around the controls to be selected.
- Ctrl or Shift Select - Select a control and then hold the Ctrl or Shift key down to select other controls.
When multiple form controls are selected from the form designer all properties that are shared between the controls will be displayed in the property list.
Also if any properties have the same value or rule, this will be displayed in the property list.
Aligning Form ControlsTo align two or more Form Controls, either box select (by click-dragging over the controls you want to align), or ctrl-select them individually, and then select the relevant alignment button.
The following alignment tools are available:
- Align Lefts
- Align Vertical Centers
- Align Rights
- Align Horizontal Centers
- Align Middles
- Align Bottoms
- Space Evenly Vertically
- Space Evenly Horizontally
Testing a Form
You can use the Test button on the Command Bar to try out your form, and to set default values for controls.
You can also use the keyboard shortcut Ctrl + T to toggle between Test Mode.
See Info: Keyboard Shortcuts for more shortcut tips.
DriveWorks Tech Tips Portal |
Frame Control The Frame Control displays a box in which any User Form, within the project, can be displayed. This can be used to create tabs which display different forms when clicked. View all Tech Tips |
DriveWorks Tech Tips Portal is available to DriveWorks Pro customers with an active subscription and support contract. Tech Tips provide cut down projects that highlight specific functionality for faster and more effective learning. To access the portal: - Go to https://my.driveworks.co.uk/learn/tech-tips/
- Login with your DriveWorks Pro account credentials, if asked
- Click the Visit Tech Tips Portal button for access
The portal provides a search facility, start typing the name of the Tech Tip (as indicated above) to display the Tip you require. |