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.
Defining the Part
Interface Using Part Information Statements
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