OBJECT SET DATA SOURCE
OBJECT SET DATA SOURCE ( {* ;} objeto ; fonteDados )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável |
| objeto | any | → | Nome de objeto (se * for especificado) o Campo ou variável (se * for omitido) |
| fonteDados | Pointer | → | Ponteiro a nova fonte de dados do objeto |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando OBJECT SET DATA SOURCE modifica a fonte de dados dos objetos designados pelos parâmetros objeto e * .
Se passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passar este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, se passar uma referência de campo ou variável no lugar de uma cadeia (campo ou variável objeto unicamente).
A fonte de dados é o campo ou a variável cujo valor é representado pelo objeto quando se executa o formulário. Em modo Desenho, a fonte de dados se define na lista de propriedades, geralmente através das linhas Fonte e Campo fonte (campos) ou Nome de variável (variáveis):
A exceção dos list box (ver mais adiante), todas as fontes de dados do formulário podem ser modificadas por este comando. É responsabilidade do desenvolvedor assegurar a consistência das mudanças realizadas.
En el caso de los list box, se deben tener en cuenta los siguientes puntos:
- Los cambios de fuentes de datos deben tener en cuenta el tipo de list box: por ejemplo, no es posible utilizar un campo como fuente de datos de una columna de en un list box de tipo array.
- Para los list box de tipo selección, no es posible modificar o leer la fuente de datos del objeto list box en sí: en este caso, se trata de una referencia interna y no de una fuente de datos.
- Este comando se utiliza en el contexto de los list box de tipo array. Para los list box de tipo selección, puede en vez utilizar el comando [LISTBOX SET COLUMN FORMULA
Si este comando se aplica a una fuente de datos que no se puede editar, no hace nada.
Exemplo
Mudança da fonte de dados para uma área de entrada:
var $ptrField : Pointer
$ptrField:=Field(3;2)
OBJECT SET DATA SOURCE(*;"Input";$ptrField)