Overview

Used before entering a group of controls that will act as a subroutine. When the subroutine is complete, a SubEnd control is used to return the call back to the SubStart control. This may be a different SubStart control because the subroutine may have started from various entry points.

The subroutine defines one or more exit nodes, each by a SubEnd controls. Corresponding exit nodes are created automatically in the SubStart when the ProgID is set on the property page. When the subroutine executes one of the SubEnd controls the SubStart exits out the corresponding exit node.

Initial Setup Properties

Note that all of these properties are only valid when composite controls are in use.

ProgID

(String)

IProgId contains the COM name of the composite control that will be used by this SubStart control.

CompositeProps

Array of String

This property contains an array of properties that will be sent to the control when it is loaded. Normally these properties are set by the property page for the composite control. The SubStart control store these properties on behalf of the composite control.

Preload

(Boolean)

If set, the composite control is loaded when the system is started. It must be set for in-process DLLs but is optional for out-of-process EXEs.

CompositeObject

(Object)

This is a reference to the composite control object referenced by the SubStart control.

Type

(Integer)

If 0, specifies that composite controls are not in use, and the sub should be connected directly to the Done output.

Methods

ChannelData

(ChannelData(ByVal index as Integer, ByVal propname as String, ByVal propval as String)

This method sets data into the composite control at runtime. A corresponding method in the class module for the control receives the data and loads it into the required destination.

TakeCall

This method allows the programmer to override the graphical connections and transfer a call to any other control. See TakeCall.

Events

Enter

See Enter Event.

Exit

See Exit Event.

ObjectCreated

This event occurs when the Composite control is first created. It allows initialization to occur.