Activates the object in an OLE container, allowing the user to work with the object using the server’s commands.
OLE controls and OLE DWObjects (objects within a DataWindow object that is within a DataWindow control)
objectref.Activate ( activationtype )
Argument |
Description |
---|---|
objectref |
The name of the OLE control or the fully qualified name of a OLE DWObject within a DataWindow control that contains the object you want to activate. The fully qualified name for a DWObject has this syntax: dwcontrol.Object.dwobjectname
|
activationtype (optional) |
A value of the enumerated datatype omActivateType specifying where the user will work with the OLE object. Values are:
|
Integer. Returns 0 if it succeeds and one of the following negative values if an error occurs:
-1 Container is empty
-2 Invalid verb for object
-3 Verb not implemented by object
-4 No verbs supported by object
-5 Object cannot execute verb now
-9 Other error
If any argument’s value is null, Activate returns null.
This example activates the object in ole_1 in the server application:
integer result
result = ole_1.Activate(OffSite!)
This example activates the OLE DWObject ole_graph in the DataWindow control dw_1 in the Microsoft Graph server application:
integer result
result = dw_1.Object.ole_graph.Activate(OffSite!)
OLEActivate in the DataWindow Reference or the online Help