DriveWorks Pro 15: Specification Host [send feedback...]

Specification Host

The Specification Host allows you to host a Specification or child specification in your form.

The properties on the control do not determine what specification is shown. The Specification Host control is a placeholder for where the specification is going to be shown.

The Specification Host control receives what specification to show from a Specification Macro called Set Specification Host Control. With this Specification Macro you can create new specifications or edit existing ones.

Dialogs from Macro Buttons or Item Lists are not supported inside of a Specification Host Control.

Passing Data

Data is passed to the specification through the Input Values property on the Specification Host Control. The data is passed to the control as an array. The array is structured as Name and Value, where Name in the name of the Control or Constant to store the value in.

These will be continuously synchronized between the host specification and the hosted specification. This means that values can be passed from the host to the hosted specification seamlessly.

Values can also be passed back to the host specification through the return value of the Specification Host Control. The return value of the control is an Array containing Specification Details and Specification Properties that the specification can store.

Through the use on Input Values and the controls Return value, you can pass data from a Specification to another specification and back again.

Running Specification Macros

Specification Macros can be ran in the hosted specification by the host specification. And likewise, the hosted specification can run Specification Macros in the host specification.

This is achieved using two Specification Macros tasks. These are called Run Macro in Hosted Specification and Run Macro in Host Specification. These tasks allow you to run macros between the Specifications you have open. This allows you to interact with the host and hosted Specifications and run macros in each of them.

Return Value

The return value from the Specification Host Control is an array of data that contains the hosted specifications Specification Properties. Specification Id, Specification Name, Specification State, and any other custom Specification Properties.

This control does not have a caption. Consider adding a label control if a caption is required.

Appearance PropertiesBehavior Properties
Enabled
Input Values
Tab Index
Visible
General PropertiesLayout Properties
(Name)Height
(Tag)Left
Top
Width

Using the Specification Host Control

To learn more about how to use the Specification Host control, please see the Help File topic How To: Use the Specification Host Control.

Table of Contents