Tópico anterior: ca_pam_clearTableData(_id, startIndex, endIndex)Próximo tópico: ca_pam_getTableRowCount(_id)


ca_pam_getTableData(_id, startIndex, endIndex)

Retorna os dados da tabela a partir do índice de início até o índice final conforme fornecido no nome do método. Essa função retorna uma matriz de objetos JavaScript em que cada elemento da matriz representa uma linha da tabela. Para recuperar o valor de uma coluna específica, é possível acessar o valor usando a propriedade Nome do objeto JavaScript correspondente à linha.

Parâmetros de entrada
_id (string)

Especifica a identificação exclusiva de um elemento de formulário Tabela.

startIndex (integer)

Especifica o índice numérico da primeira linha da tabela a partir da qual os dados devem ser retornados.

endIndex (integer)

Especifica o índice numérico da última linha da tabela a partir da qual os dados devem ser retornados. Se você especificar um índice maior do que a última linha disponível, a função falhará.

Valor de retorno

Retorna uma matriz que é representada como um objeto de JavaScript.

Importante: Depois que o método retornar os dados da tabela, os nomes das variáveis usadas para acessar as colunas devem estar em minúsculas, independentemente de como você definir a propriedade Nome de cada campo da coluna no Criador de formulários.

Exemplo
ca_fd.js.PassData(ca_pam_getTableData('Form.tableRaceResults',0,4))

Esse exemplo usa o script de formulário a seguir para transmitir os cinco melhores tempos de finalização de uma disputa de um elemento de formulário Tabela para um banco de dados personalizado. O evento onClick da caixa de seleção Record Race Times inicia as chamadas de função para obter os dados da tabela, enviar os dados e registrar os resultados.

{ 
 PassData : function(result) { 
   for(i=0;i<result.length;i++)
   {
    var firstRow = result[i];
    alert(firstRow.var_0);
   }
 }
}

A ilustração a seguir mostra o formulário como será exibido no momento da criação.