Control.LinkDF Method

Request Example View Source

Parameters

oDS (Optional)

Type: Usual
The server that the field is to be linked to. Ordinarily, this is the common server that the entire window is linked to, but it is possible to link individual fields to other servers.

siDF (Optional)

Type: Usual
The number of the data field within the server.

Return Value

Type: Usual

Control:LinkDF() should ordinarily not be called directly by the application. It is called by the DataWindow:Use() method; Use() connects an entire client to an entire server. You can use Control:LinkDF() to link a control to a data field explicitly, perhaps if the control's name doesn't match the data field's name so the automatic linkage of the Use() method doesn't work. It is even possible to use Control:LinkDF() to link individual controls to different servers; however, this is not recommended, because none of the automatic behavior of the data window and none of its cooperation with the data server applies to more than one server. Notifications are not to be received for servers other than the main server that the window is registered with, and actions such as DataWindow:Delete() and DataWindow:Append() apply to the main server. To link a window to more than one database, use the techniques described in the "GUI Classes" chapter of the Programmer's Guide.