O comando DataDialog oferece uma ferramenta poderosa e cheia de recursos, pois constrói, de forma automática, uma Caixa de Diálogo, uma Barra de navegação e uma lógica completa para processamento de arquivos do Banco de Dados.
O comando DataDialog gera uma Caixa de Diálogo com os seguintes controles:
Sintaxe do comando DataDialog:
DataBase <banco> <segurança> <nivel> <modo>
[use <arquivo>]
DataDialog [file(<arquivo>)] [itens(<item1>, <item2> ..., <itemn>)]
[window(<xi>,<yi>,<xl>,<yl>)]
[headers (<cab1>, <cab2>, ..., <cabn>)]
Onde:
DataBase <Banco>
Informa o Banco cujos arquivos vão ser processados.
use <arquivo>
Prepara o arquivo <arquivo> para processamento.
file(<arquivo>)
Informa o nome de arquivo a ser processado pelo comando DataDialog.
itens(<item1>, ... ,<itemn>)
A lista itens(<item1>, ... ,<itemn>) é opcional. Não sendo especificada a opção itens, serão processados todos os itens de cada registro, conforme definido no esquema do Banco de Dados.
window(<xi>,<yi>,<xl>,<yl>)
A opção window especifica, opcionalmente, as coordenadas e tamanhos da Caixa de Diálogo onde serão colocados todos os controles necessários. Não havendo especificação deste parâmetro, a OpusWin constrói uma Dialog Box na posição e tamanhos adequados.
headers (<expc1>, ..., <expcn>)
A opção headers especifica os títulos a serem associados aos itens relacionados na opção itens. A especificação de headers é opcional. Quando não for especificado, serão exibidos os nomes dos itens do arquivo constantes no esquema do Banco de Dados.
Veja, a seguir, como é fácil codificar um programa (completo !) que utiliza DataDialog.
prog
DataBase .\exemplo 1 a 2
use PESSOA
DataDialog file("PESSOA") itens(NOME_P,IDADE) headers("Nome:","Idade:")
Observação
Na figura a seguir (recortada), mostramos os campos e a Barra de Navegação gerados pelo programa acima.
Na figura acima, produzida pelo programa acima (que nós recortamos) são exibidos os campos do arquivo PESSOA, do Banco de Dados EXEMPLO.
Na parte de baixo da figura, é mostrada um Barra de Navegação com as seguintes funções associadas aos ícones, pela ordem de apresentação, da esquerda para a direita: Primeiro Registro, Último Registro, Próximo Registro, Registro Anterior, Limpar campos na tela, Incluir Registro, Alterar Registro e Excluir Registro.