OBJECT Get data source
OBJECT Get data source ( {* ;} object ) : Pointer
| Parameter | Type | Description | |
|---|---|---|---|
| * | Operator | → | If specified, object is an object name (string) If omitted, object is a field or variable |
| object | any | → | Object name (if * is specified) or Field or variable (if * is omitted) |
| Function result | Pointer | ← | Pointer to current data source of object |
This command is not thread-safe, it cannot be used in preemptive code.
Description
The OBJECT Get data source command returns the current data source of the object(s) designated by the object and * parameters.
You can define the data source for an object in Design mode using the Property List, or using the OBJECT SET DATA SOURCE command.
Passing the optional * parameter indicates that the object parameter is an object name (string). If you do not pass this parameter, it indicates that the object parameter is a field or variable. In this case, you pass a field or variable reference instead of a string (field or variable object only).
Example
Given a combo box object defined in a form:
You execute the following code:
$vPtr :=OBJECT Get data source(*;"vCombo")
// $vPtr contains -> vCombo