Description
Activates the object in an OLE container, allowing the user to work with the object using the server's commands.
Applies to
OLE controls and OLE DWObjects (objects within a DataWindow object that is within a DataWindow control)
Syntax
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:
For the OLE control, activationtype is required. |
Return value
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.
Examples
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!)
See also
OLEActivate method for DataWindows in the section called “OLEActivate” in DataWindow Reference.
