AdicionaCampo

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:

AdicionaCampo

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.