O procedimento AdicionaCampo adiciona no final da estrutura de uma tabela um campo com as informações recebidas nos parâmetros.
Pacote
O procedimento AdicionaCampo está definido dentro do pacote AdicionaCampo.pkg.
Sintaxe
Send AdicionaCampo {hNrTabela} {sNmCampo} {iTipo} ;
{iTamanho} {iPrecision} ;
{hoCallBack} {hoStatusPanel}
Onde:
- {hNrTabela} é o número da tabela onde será adicionado o campo;
- {sNmCampo} é o nome do campo que será adicionado, e se já existir um campo com o nome informado na tabela, nada será feito;
- {iTipo} é o tipo do campo, podendo ser informado:
- DF_ASCII
- DF_BCD
- DF_BINARY
- DF_DATE
- DF_TEXT
- {iTamanho} é o tamanho total do campo;
- {iPrecision} é a quantidade de casas decimais e só é usado se {iTipo} for DF_BCD;
- {hoCallBack} é o identificador do objeto onde será definida a função CallBack para mostrar o progresso da reestruturação;
- {hoStatusPanel} informe o identificador de um objeto StatusPanel para que o progresso da execução seja exibido nele, ou informe 0 (zero) se não deseja usá-lo.
Exemplo
Um exemplo de uso do procedimento pode ser encontrado dentro do Projeto padrão de atualização da versão 17.0.9 arquivo AtualizaTabelas17_0_9.src:
Observações
- Para que este procedimento funcione a tabela já deve estar aberta em modo exclusivo quando este procedimento for chamado;
- Para testar se o campo foi criado após a execução do procedimento basta utilizar a função ProcuraCampo;
- Para mais detalhes sobre como implementar a função de Callback (parâmetro {hoCallBack}) consulte a documentação do comando Set_Attribute no Help do DataFlex.
Tópicos relacionados
Não encontrou o que precisava, entre em contato conosco.