Usina BRAdvPL Guia
Entrar
← Todos os tópicos
COMANDOEm revisão

ADD DBCOLUMN

ADD DBCOLUMN <oCol> TO DBBROWSE <oBrw> FIELD <cField> [HEADER <cHead>] [WIDTH <nWidth>]

Acrescenta uma coluna associada a um campo de dados.

ADD DBCOLUMNAdvPL
01 · VISÃO GERAL

Visão geral

Referência histórica eAdvpl, §3.20, p. 19. A sintaxe depende das definições desse ambiente; não é garantia de compatibilidade com qualquer include Protheus atual. FIELD identifica o campo no alias associado ao DBBROWSE. A área deve permanecer aberta enquanto o componente a utilizar. Diferentemente da coluna de array, a origem é um campo; não substituir sua identificação por uma posição numérica. O exemplo usa uma coluna de leitura de SA1. (Guia de referência eAdvpl, s.d., ref. 1)

02 · SINTAXE

Sintaxe

ADD DBCOLUMN <oCol> TO DBBROWSE <oBrw> FIELD <cField> [HEADER <cHead>] [WIDTH <nWidth>]

Parâmetros

oCol
ObjetoObrigatório

Objeto criado para a coluna.

oBrw
ObjetoObrigatório

DBBROWSE existente com alias válido.

cField
CaractereObrigatório

Nome do campo.

cHead
CaractereOpcional

Cabeçalho visível.

nWidth
NuméricoOpcional

Largura conforme o ambiente.

Retorno

Sem retorno de negócio documentado para esta operação de interface.

03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento historico: oBrw usa SA1 ja aberta.
Local oCol
ADD DBCOLUMN oCol TO DBBROWSE oBrw FIELD "A1_COD" ;
    HEADER "Codigo" WIDTH 12
// Nao habilita edicao nem fecha o alias do chamador.
Resultado esperado

Propõe uma coluna para A1_COD. Alias, janela e browse são pré-condições do fragmento. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir existência do campo, escopo de filial e regras de acesso. Não confundir apresentação de campo com autorização de alteração.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. Guia de referência eAdvpl. §3.20, p. 19. Referência histórica; autoria e compatibilidade atual não confirmadas. Consulta em 2026-10-25.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha