Activation

Description

The way the server for the OLE object in the OLE Object control is activated. Choices include letting the user activate the object by double-clicking or putting activation under program control.

Applies to

OLE Object controls

Syntax

PowerBuilder dot notation:

dw_control.Object.olecontrolname.Activation

Describe and Modify argument:

"olecontrolname.Activation { = ' activationtype ' }"

Parameter	Description
olecontrolname	The name of the OLE Object control for which you want to get or set the activation method.
activationtype	(exp) A number specifying the method of activation for the OLE object. Activationtype can be a quoted DataWindow expression. Values are: 0 – The object has to be activated with the Activate method. 1 – The user can activate the object by double-clicking on it. 2 – The object activates when the container gets focus.

Parameter

Description

olecontrolname

The name of the OLE Object control for which you want to get or set the activation method.

activationtype

(exp) A number specifying the method of activation for the OLE object. Activationtype can be a quoted DataWindow expression.

Values are:

0 – The object has to be activated with the Activate method.
1 – The user can activate the object by double-clicking on it.
2 – The object activates when the container gets focus.

Usage

In the painter

Select the control and set the value in the Properties view, Options tab.

Examples

Example 1

dw1.Object.ole_report.Activation
ls_data = dw1.Describe("ole_report.Activation")
dw1.Modify("ole_report.Activation='2'")