4.12 The OLE-AUTOMATION module

<coclass-type-info>

Sealed concrete class

Summary

Implements the COM ITypeInfo interface.

Superclasses

<LPUNKNOWN>

name:

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

uuid:

The GUID that identifies the COM object class. Required.

class:

The instance of <class> that is to be instantiated to implement the COM object. Defaults to <simple-component-object>. Usually it would be overridden only by a user-defined subclass of <simple-component-object>, but the only requirement is that it implement the IUnknown interface and that it accept a typeinfo: init argument with the instance of <coclass-type-info> as the value.

args:

A <sequence> of initialization keyword arguments for instantiating the class (in addition to typeinfo:). Defaults to the empty sequence. There are no init arguments applicable to <simple-component-object>, so use this only if you also specify class:.

interfaces:

A <vector> in which each element is an instance of <component-interface-description> describing an interface that is supported by the compound object (COM object).

documentation:

A string describing the type library.

This string will appear as the name of the type library in the Microsoft OLE2VIEW utility, which assumes a single line that will be truncated at about 45 characters.

help-file:

Name of a Help file containing help for the object class and its interfaces. The default is no help file.

help-context:

Position in the Help file where the documentation appears.

major-version:

Major version number. Default value: 0.

minor-version:

Minor version number. Default value: 0.

locale:

Internationalization locale. Default value: neutral.

Description

Implements the COM ITypeInfo interface. Automation servers instantiate this class to provide an ITypeInfo interface describing a component object class (COM class) that can contain any number of dispinterfaces.

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.