Retorna para o primeiro registro de uma fonte de dados.
Figura 1 - Bloco Ir para Primeiro Registro
Compatibilidade
- Bloco cliente: cronapi.screen.firstRecord()
- Bloco servidor: cronapi.screen.firstRecord() - executado a partir da chamada do bloco cliente.
Retorno
O bloco não possui retorno.
Parâmetros
Fonte de dados
Componente Fonte de dados que será vinculado ao bloco. A utilização da função Fonte de Dados depende da forma correta de vinculação do bloco de programação ao formulário contendo os componentes com os quais se deseja interagir. Acesse o tópico "propriedades do blockly", da documentação Bloco de programação, para mais detalhes.
- Posição: 1
- Inglês: Datasource
- Tipo: Fonte de dados / Datasource
- Exemplo: Fonte de dados Aluno
Exemplo
A função abaixo utiliza um laço de repetição para percorrer todos os registros da fonte de dados Aluno, com base no número total de registros. Em seguida, verifica se há um próximo registro na fonte usando o bloco Existe Próximo Registro?. A verificação começa a partir do primeiro elemento. Caso a condição seja verdadeira, obtemos o nome do aluno e o imprimimos no console do navegador.
Após isso, avançamos para o próximo registro da fonte. A função continua executando até que o bloco "Existe Próximo Registro" retorne false, indicando que o registro atual é o último da lista. Nesse caso, o bloco Ir para Primeiro Registro é acionado, fazendo com que o primeiro registro da fonte de dados seja exibido novamente, finalizando a execução.
Figura 2 - Função que imprime o nome dos alunos no console do navegador
Adicionamos a função no evento Ao Clicar em um botão presente na view Aluno, o resultado da execução da função pode ser conferido abaixo. Observe que o quarto registro não foi retornado pois a verificação feita no bloco condicional deu false, então a função acionou o bloco Ir para Primeiro Registro, fazendo com que o primeiro registro fosse exibido novamente.
Figura 2.1 - Resultado da execução da função da figura 2
Nesta página
Índice