---
title: "HBox: 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/hbox/
---

# HBox: uso e campos

Distribui filhos em uma linha.

## Para que serve

Distribui filhos em uma linha.

## Onde fica

**Interface → criar elemento → HBox**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → HBox**. 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, 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.HBox**.

## Exemplo prático

Uma fileira de corações com tamanho preferido 48 × 48.

## Limitações e roadmap

Fora do fluxo retira o filho da distribuição; wrap automático não está documentado como suporte atual.

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.