4D Doc Center : LISTBOX SET FOOTER CALCULATION

4D v14.3

LISTBOX SET FOOTER CALCULATION


LISTBOX SET FOOTER CALCULATION ( {* ;} objeto ; calculo )

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto(cadeia) Se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome de objeto (se especificado ) ou Variável (se omitido )
calculo	Inteiro longo	Calculo para à área de rodapé

Descrição

O comando LISTBOX SET FOOTER CALCULATION permite definir o cálculo automático associado à área de rodapé do list box designado pelos parâmetros objeto e *.

Se passado o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (uma cadeia). Se não passa este parâmetro, indica que o parâmetro objeto é uma variável. Neste caso, passe uma referencia de variável no lugar de uma cadeia.
O parâmetro objeto pode designar:

a variável ou o nome de uma área de rodapé de página. Neste caso, o comando aplica a esta área.
a variável ou o nome de uma coluna de list box. Neste caso, o comando aplica à área de rodapé desta coluna.
a variável ou o nome de um list box. Neste caso, o comando aplica as áreas de rodapé do listbox.

No parâmetro calculo, passe uma das seguintes constantes do tema Listbox Footer Calculation, com a finalidade de definir o cálculo a realizar:

Constante	Tipo	Valor	Comentário
Listbox footer average	Inteiro longo	6	Utilizável com as colunas de tipo numérico, hora Tipo de resultado por padrão:Real
Listbox footer count	Inteiro longo	5	Utilizável com as colunas de tipo numérico, texto, data, hora, booleano, imagem Tipo de resultado por padrão: Inteiro longo
Listbox footer custom	Inteiro longo	1	Nenhum cálculo é realizado por 4D. A variável do rodapé deve ser calculada por programação. Tipo por padrão do resultado do cálculo: tipo da variável
Listbox footer max	Inteiro longo	3	Utilizável com as colunas de tipo numérico, data, hora, booleano Tipo de resultado por padrão: tipo do array ou campo da coluna
Listbox footer min	Inteiro longo	2	Utilizável com as colunas de tipo numérico, data, hora, booleano Tipo por padrão do resultado: tipo do array ou campo da coluna
Listbox footer std deviation	Inteiro longo	7	Utilizável com as colunas de tipo numérico, hora (list boxes de tipo array unicamente) Tipo de resultado por padrão: Real
Listbox footer sum	Inteiro longo	4	Utilizável com as colunas de tipo numérico, data, hora, booleano Tipo de resultado por padrão: tipo do array ou campo da coluna
Listbox footer sum squares	Inteiro longo	9	Utilizável com as colunas de tipo numérico, hora (listbox de tipo array unicamente) Tipo por padrão do resultado: Real
Listbox footer variance	Inteiro longo	8	Utilizável com as colunas de tipo numérico, hora (listbox de tipo array unicamente) Tipo por padrão do resultado: Real

Note que os cálculos predefinidos tem em conta todos os valores da coluna do list box, incluindo os valores das possíveis linhas ocultas. Se deseja restringir um cálculo as linhas visíveis, deve utilizar a constante Listbox footer custom e realizar um cálculo personalizado.

Se o tipo de dados da coluna ou de pelo menos uma coluna do list box (se objeto designa um list box) não é compatível com o calculo definido, o rodapé não será modificado e formará um erro 18. Se uma coluna contém una fórmula (list box de tipo seleção), será gerado o erro 10.

Nota: As variáveis da área rodapé se definem automaticamente (quando não se definem por programação) em função do tipo de cálculo definido na Lista de propriedades (Specific properties of List box footers). Se o tipo da variável não corresponde ao resultado esperado pelo comando LISTBOX SET FOOTER CALCULATION, é gerado um erro. Por exemplo, para uma coluna que mostra datas, se o rodapé faz um cálculo 'Maximum', a variável rodapé será definida em data. Se executar a instrução LISTBOX SET FOOTER CALCULATION (rodapé;Listbox footer count), é gerado um erro pelo tipo do resultado esperado (inteiro largo) varia do tipo da variável.