Class AutomationObject() Foundation

Class function of the AutomationObject class


Objects of the class AutomationObject serve as proxies to COM/ActiveX components. The properties and methods of the COM/ActiveX component can be accessed via instance variables and methods of the AutomationObject.

For an overview on how an AutomationObject can be used please also be referred to ActiveX Overview .

AutomationObjects can be created and connected to COM/ActiveX components by the functions GetObject() and CreateObject()and by calling the class method AutomationObject():create().

Once the AutomationObject is created and the connection to the COM/ActiveX object is established, calling methods and accessing properties of the COM/ActiveX component is as easy as with ordinary Xbase++ objects. The AutomationObject takes care of forwarding method and property calls to the COM/ActiveX object.

Class methods
Creates and connects to a COM/ActiveX object
Life cycle
Disconnects from a COM/ActiveX component.
Converts (casts) an AutomationObject instance to another class.
Increments the reference count.
Decrements the reference count.
Queries a dedicated interface
Queries the dispatch IDs of properties and methods
Invokes a method or property.
ActiveX access
Loads a typelibrary.
Gets the value of a property.
Sets the value of a property
Calls a method.
Automation Error Management
Default error handler for errors generated in the automation sub-system.
COM class management
Determines if a COM/ActiveX component is installed on the computer.
Requests the license key of a COM/ActiveX component.
Translates a COM/ActiveX color value to an Xbase++ color and vice versa
Instance variables
Interface of the connected COM/ActiveX object.
Name of the COM interface used to connect to the COM/ActiveX object.
Optional license string.
Class ID or ProgID identifying the COM object connected.
Name of the remote machine/server that hosts the COM/ActiveX component.
Instance variable for storing an application-defined value.

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.