Special Properties

CLSID (alphanumeric) This special property is provided for advanced programming tasks that require a generic interface to ActiveX controls. You may create, modify, inquire and destroy an ActiveX control using the ACTIVE-X control type, but with certain restrictions. The compiler will not recognize symbolic property, method, or event names provided by the ActiveX control. You must specify properties and methods by their dispatch identifier ("dispid") using the PROPERTY phrase, and you must identify events by their dispatch identifier in your event procedure. ACTIVE-X controls are identified by a globally unique identifier called a "class id" (CLSID). In order to create an instance of an ACTIVE-X control, you must provide this class id. Set CLSID to the class id of the control when you create the control (either in the screen section definition or in the DISPLAY statement).

LICENSE-KEY (alphanumeric) Some ActiveX controls are licensed for run time using a license key that is provided to you by the control vendor. This license key is a text string usually located in a ".lic" file. By setting the value of the LICENSE-KEY property to this license key, you embed this license key in your COBOL program. Then when you run your COBOL program, the license key is passed to the ActiveX control for verification. You do not send the ".lic" file or license key to the end-user. Set LICENSE-KEY when you create the control (either in the screen section definition or in the DISPLAY statement). The default value is " ". When LICENSE-KEY is " " (i.e., the default) and the ActiveX control supports the licensing mechanism, the control performs its own license verification. Some controls require a ".lic" file to do this. Others may check the system registry or hard disk for other properly installed and licensed software. Many ActiveX controls from Microsoft are available for installation and redistribution on all computers with validly licensed copies of Microsoft operating system products.

INITIAL-STATE (multiple parameters) Use INITIAL-STATE in conjunction with the C$RESOURCE library routine to establish the ActiveX control's initial state.

          { INITIAL-STATE } { Is  } ( resource-handle, resource-name )
                            ( Are }
                            { =   }

where

'resource-handle' is a HANDLE OF RESOURCE;

'resource-name' is a literal or data-item.

More:

Events