Activate
PowerScript function
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
|
1 |
objectref.Activate ( activationtype ) |
|
Argument |
Description |
||
|---|---|---|---|
|
objectref |
The name of the OLE control or the fully qualified name of The fully qualified name for a DWObject has this
|
||
|
activationtype (optional) |
A value of the enumerated datatype omActivateType
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:
|
1 2 |
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:
|
1 2 |
integer result result = dw_1.Object.ole_graph.Activate(OffSite!) |
See also
OLEActivate method for DataWindows in the section called “OLEActivate” in DataWindow Reference.