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

@ ... LISTBOX

@ nRow, nCol LISTBOX oLbx [VAR nVar] ITEMS aItems [SIZE nWidth, nHeight] OF oWnd

Apresenta itens em uma lista com seleção.

@ ... LISTBOXAdvPL
01 · VISÃO GERAL

Visão geral

O Guia de referência eAdvpl, §3.12, 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. O comando histórico associa ITEMS a uma seleção numérica em VAR. A classe TListBox oferece construção direta e métodos como SetArray; consultar a assinatura do método antes de trocar dados de um componente existente. Uma posição selecionada não comprova a existência de um código de negócio nem deve ser mantida quando a lista muda de ordem. (Refs. 1–2)

02 · SINTAXE

Sintaxe

@ nRow, nCol LISTBOX oLbx [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 oLbx
Local nItem := 1
Local aItens := {"Documentacao", "Exemplos", "Testes"}
@ 2, 2 LISTBOX oLbx VAR nItem ITEMS aItens SIZE 28, 5 OF oDlg
// Validar nItem antes de consultar aItens[nItem].
Resultado esperado

Propõe lista de três itens, inicialmente no primeiro. Nenhum dado é gravado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Tratar cancelamento e lista vazia; ao recarregar, restabelecer uma seleção válida ou informar que não há seleçã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.12, p. 15. Cópia pública histórica; autoria e compatibilidade atual não confirmadas. Consulta em 2026-10-24.
  2. TOTVS. Classe TListBox. 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