Progress
Language Reference
COM Object References
Because a chain of COM object property and method references ultimately resolve to a single property or method reference, the syntax diagrams that describe COM object references begin with the three basic types of statements that reference properties and methods:
Property Write
Property Read
Method Call
Com-Handle-Var is any COM-HANDLE variable set to the handle of an instantiated COM object; field
is any Progress variable, database field, or widget attribute reference of a compatible data type;
expression is any combination of 4GL elements that results in a single value.
NOTE: You can invoke both a property read and a method call as part of an expression in another statement (such as in a DISPLAY statement). You can also directly invoke both property reads and method calls as statements in themselves. However, direct invocation is meaningful only for method calls.The following syntax boxes describe the remaining components of these basic statements:
COMProperty
Property-Name is the name of the referenced property. The optional multi-level index is an integer expression as required by the property. You must not follow the colon separator by a space.
COMMethod
Method-Name is the effective name of the referenced method. COMparm
is a parameter as required by the method. You must not follow the colon separator by a space.
COMParm
A null-parm is any amount of white space.
NOTE: There is currently no support for named parameters, for example:
Method-Name(Color="GREEN", Shape="SQUARE")DatatypeDatatype
The requirements for using the OUTPUT, INPUT-OUTPUT, BY-VARIANT-POINTER, BY-POINTER, and AS Datatype options depend on the COM object method or property, the implementation of the COM object, and how you plan to use the parameter or property in your application. In many cases, expression is all that you require for a property write or method parameter. For more information and examples of COM object references, see the chapter on ActiveX Automation and the chapter on control container support in the Progress External Program Interfaces manual.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |