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

@ ... COMBOBOX

@ nRow, nCol COMBOBOX oCbx [VAR nVar] ITEMS aItems [SIZE nWidth, nHeight] OF oWnd

Oferece uma seleção entre opções conhecidas.

@ ... COMBOBOXAdvPL
01 · VISÃO GERAL

Visão geral

O Guia de referência eAdvpl, §3.13, p. 15, registra a variante histórica apresentada na sintaxe. Os fragmentos pressupõem o ambiente e as definições de comandos correspondentes; não são um aplicativo completo. A variante histórica usa um índice numérico em VAR e um array em ITEMS. TComboBox documenta também modelos de vinculação por valor e comportamento relacionado a F4; esse contrato não deve ser transferido automaticamente para a macro histórica. Mantenha separado o rótulo visível do código de negócio e confira o índice antes de acessar o array. (Refs. 1–2)

02 · SINTAXE

Sintaxe

@ nRow, nCol COMBOBOX oCbx [VAR nVar] ITEMS aItems [SIZE nWidth, nHeight] OF oWnd

Parâmetros

nRow, nCol
NuméricoObrigatório

Posição de origem na unidade da variante utilizada.

oWnd / oDlg
ObjetoObrigatório

Janela pai existente; o nome deve corresponder ao código real.

aItems
ArrayObrigatório

Opções exibidas.

nVar
NuméricoOpcional

Índice da seleção na variante histórica; validar antes de indexar.

Retorno

Comando de interface/impressão; não usar como expressão com retorno de função.

03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento historico; oDlg ja existe.
Local oCbx
Local nOpcao := 1
Local aOpcoes := {"Aberto", "Concluido"}
@ 2, 2 COMBOBOX oCbx VAR nOpcao ITEMS aOpcoes ;
    SIZE 20, 1 OF oDlg
// Ler nOpcao somente apos a interacao e validar 1..Len(aOpcoes).
Resultado esperado

Seleção inicial proposta: primeiro item. A leitura após interação depende da confirmação da janela, não é demonstrada pelo 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
  • Prever lista vazia e cancelamento. Se os itens forem recarregados, revalidar a seleção antes de persistir o código correspondente.
  • 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.13, p. 15. Cópia pública histórica; autoria e compatibilidade atual não confirmadas. Consulta em 2026-10-24.
  2. TOTVS. Classe TComboBox. TOTVSTEC/TDN. Consulta em 2026-10-24.
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