4D Doc Center : OBJECT SET DATA SOURCE

4D v14.3

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	Objeto de formulário	Nome de objeto (se * for especificado) o Campo ou variável (se * for omitido)
fonteDados	Ponteiro	Ponteiro a nova fonte de dados do objeto

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:

 C_POINTER($ptrField)

 $ptrField:=Field(3;2)

 OBJECT SET DATA SOURCE(*;"Input";$ptrField)