4.12 The OLE-AUTOMATION module

<disp-type-info>

Sealed concrete class

Summary

Implements the COM ITypeInfo interface.

Superclasses

<LPUNKNOWN>

Init-keywords

name:

A string name for the dispinterface. It should be suitable for use as an identifier in programming languages that might refer to the object. See Description.

uuid:

A GUID that identifies the interface. The default is $IID-IDispatch.

This should preferably be an instance of <REFGUID> (from make-GUID) but can also be a string representation of the GUID (containing 32 hexadecimal digits within braces).

properties:

A <sequence> in which each element is an instance of <variable-description> or <constant-description> that specifies one dispinterface property. The default is no properties.

methods:

A <sequence> in which each element is an instance of <function-description> that specifies a dispatch method. The default is no dispinterface methods.

documentation:

A string describing the dispinterface. This is called a helpstring in IDL.

help-file:

A Help file name containing help for this dispinterface. The default is no help file.

help-context:

The position in the Help file (from help-file:) where this dispinterface is documented. Optional.

major-version:

Major version number. Default value: 0.

minor-version:

Minor version number. Default value: 0.

locale:

Internationalization locale. Default value: 0, meaning neutral.

inherit:

The base type from which this type information inherits information. Optional.

If specified, the value should be another instance of <disp-type-info> which the current type inherits from. The current type will support all of the dispatch properties and dispatch methods of the base type in addition to its own. Some of the other options will gain their default value from the base type where appropriate.

Note: Type information inheritance is implemented separately from the Dylan class hierarchy.

Description

Implements the COM ITypeInfo interface.

Automation server applications create an instance of this class to represent the type information for each dispinterface class (subclass of <simple-dispatch>) that they implement.

The string passed to the name: init-keyword should be suitable for use as an identifier in programming languages that might refer to the object. In particular, if the coclass object is to be used in a Visual Basic form, it will use this name as the class name in the generated Basic source code, and so must be a legal Basic identifier. This means it must begin with a letter; it must not contain any spaces or special characters such as ".", "$", "&", "%", "!", "#", or "@"; it must not be longer than 40 characters; and it must not conflict with a Visual Basic reserved keyword.