LinkUpdateOptions

Description

When the OLE Object control is linked, the method for updating the link information. If the user tries to activate the OLE object and PowerBuilder cannot find the linked file, which breaks the link, LinkUpdateOptions controls whether PowerBuilder automatically displays a dialog box prompting the user to find the file. If you turn off the automatic dialog box, you can reestablish the link by calling the LinkTo or LinkUpdateDialog in code.

Applies to

OLE Object controls

Syntax

PowerBuilder dot notation:

dw_control.Object.olecontrolname.LinkUpdateOptions

Describe and Modify argument:

"olecontrolname.LinkUpdateOptions { = 'updatetype ' }"

Parameter

Description

olecontrolname

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

updatetype

A number specifying how broken links will be reestablished. Updatetype can be a quoted DataWindow expression.

Values are:

  • LinkUpdateAutomatic!

  • LinkUpdateManual!


Usage

In the painter

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

Examples

string ls_data
ls_data = dw1.Object.ole_report.LinkUpdateOptions
dw1.Object.ole_report.LinkUpdateOptions = 0
ls_data = dw1.Describe("ole_report.LinkUpdateOptions")
dw1.Modify("ole_report.LinkUpdateOptions='0'")