---
title: "VBox: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/vbox/
---

# VBox: uso e campos

Distribui filhos em uma coluna.

## Para que serve

Distribui filhos em uma coluna.

## Onde fica

**Interface → criar elemento → VBox**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → VBox**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Padding, Espaçamento e Alinhamento; filhos usam tamanho mínimo/preferido e peso.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.VBox**.

## Exemplo prático

Lista de instruções ou opções do menu.

## Limitações e roadmap

Para arrastar um filho manualmente, use Fora do fluxo; isso muda o contrato do layout.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.