VBComposerInfo Statement

The VBComposerInfo statement specifies the information needed to use a part in the Composition Editor.

{ //VBComposerInfo: partType, iconResId?, iconResDll?, viewType?, interfaceDll?, viewAttribute*, interfaceVersion? }

partType
Optional parameter that indicates the part type.

( visual | nonvisual | class | functions )

visual
The part is a visual part. It can be placed on other parts in the Composition Editor. Visual parts are notifiers, so they can have events as well as attributes and actions.

nonvisual
The part is a nonvisual part. It cannot be placed on other parts. Nonvisual parts are notifiers, so they can have events as well as attributes and actions.

class
The part is a class interface part. It cannot be placed on other parts in the Composition Editor. Class interface parts are not notifiers, so they can have only attributes and actions.

functions
The part is a group of related C functions that you want to use in visual composition. It cannot be placed on other parts in the Composition Editor. Each function is represented as an action.

iconResId
Optional resource number of the icon to be used to represent the part. The icon represents the part in a VBVariable part. It also represents the part on the part palette if you add the part to the palette. For nonvisual parts, class interface parts, and function group parts, the icon represents the part on the free-form surface.

If you specify an icon resource ID, you must also specify the icon resource DLL name. If not specified, the base class icon is used.

iconResDll
Optional icon resource DLL name containing the icon to be used. You must specify the DLL name if you specify an icon resource ID. Do not include the .dll extension.

viewType
Optional parameter that indicates how the part can be used in the Composition Editor.

( abstract | composer | primitive )

abstract
An abstract part is a visual, nonvisual, or class interface part that contains functions and data for other parts to inherit. You cannot place an abstract part in the Composition Editor as a part instance, but you can add it as a Variable part.

composer
A composer is a visual part that can accept child windows. You can place visual primitive and composer parts on a composer.

primitive
A primitive is a visual part that does not accept child windows. If you place another primitive part on a primitive part, the parts are siblings, not parent and child. You cannot place a composer on a primitive part.

interfaceDll
Optional interface DLL name. The DLL provides composition objects for the part, and implements a C interface to the part runtime DLL. Do not include the .dll extension. If this parameter is specified, the view type should also be specified.

For a visual part, the interface DLL creates an instance of the part for visual placement in the Composition Editor. The DLL can also create objects for attribute parts that supply values for part attributes. This enables the Composition Editor to reflect property settings for complex attributes that affect the appearance of the part.

If you do not provide an interface DLL for a visual part, the part appears in the Composition Editor as a gray box. If your DLL creates a visual part instance but does not create objects defining complex attributes, the part does not reflect property settings for these attributes. However, code generated for the part reflects these property settings in your applications regardless of whether they appear in the Composition Editor.

viewAttribute
Optional composition attribute for visual, nonvisual, and class interface parts. The only currently defined composition attribute is outline.

( outline )

outline
The Composition Editor draws an outline around the part to indicate its boundary.

interfaceVersion
Optional incremental version number of the interface. The version number is incremented each time the part is saved if an interface DLL is been specified. If the interface number does not match the version in the interface DLL, a gray box is displayed for the part in the Composition Editor.


Related procedures
Defining the Part Interface Using Part Information Statements

Related references
Visual Part Information Statements
Nonvisual Part Information Statements
Class Interface Part Information Statements
Function Group Part Information Statements
Part Information Statement Descriptions
Part Information Statement Examples