Establishes a link between an OLE control and a file or an item within the file.
olecontrol.LinkTo ( filename {, sourceitem } )
Argument |
Description |
---|---|
olecontrol |
The name of the OLE control in which you want to insert a linked object. |
filename |
A string whose value is the file name containing the data that you want to insert in olecontrol, with a link connecting the object in PowerBuilder to the original data. If you do not specify sourceitem, a link is established with the whole file. |
sourceitem (optional) |
A string that names an item within file name to which you want to link. The way you specify sourceitem is determined by the OLE server application. |
Integer. Returns 0 if it succeeds and one of the following negative values if an error occurs:
-1 File not found
-2 Item not found
-9 Other error
If any argument’s value is null, LinkTo returns null.
This example creates an object in the OLE control, ole_1. The object is linked to the file C:\XLS\EXPENSE.XLS:
integer result
result = ole_1.LinkTo("c:\xls\expense.xls")
This example links to a section of rows and columns in the same spreadsheet as in the previous example:
integer result
result = ole_1.LinkTo("c:\xls\expense.xls", &
"R1C1:R5C5")