---
title: "Astra.GuiSizing"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-guisizing/
---

# Astra.GuiSizing

Struct da API C# da Astra. 9 membros declarados neste snapshot.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiSizing
```

**Interfaces:** `System.IEquatable<Astra.GuiSizing>`.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiSizing** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-629470cb17c806bb) | Method |
| [Alignment](#member-625ba8b008032543) | Property |
| [Columns](#member-ccaf220f5f5dd289) | Property |
| [Flexible](#member-5f30812bbd0f9d8a) | Property |
| [Ignore](#member-2109ac25ef615c3a) | Property |
| [Minimum](#member-011482100f894b01) | Property |
| [Padding](#member-853356d0ab9c5148) | Property |
| [Preferred](#member-c9fd6e122352256c) | Property |
| [Spacing](#member-3f63d7bd166c4e3e) | Property |

<h3 id="member-629470cb17c806bb" class="astra-member">.ctor</h3>

```csharp
public GuiSizing(System.Numerics.Vector2 Minimum, System.Numerics.Vector2 Preferred, System.Numerics.Vector2 Flexible, System.Numerics.Vector4 Padding, System.Numerics.Vector2 Spacing, Astra.GuiAlignment Alignment, uint Columns, bool Ignore)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Minimum` | `System.Numerics.Vector2` |  |
| `Preferred` | `System.Numerics.Vector2` |  |
| `Flexible` | `System.Numerics.Vector2` |  |
| `Padding` | `System.Numerics.Vector4` |  |
| `Spacing` | `System.Numerics.Vector2` |  |
| `Alignment` | `Astra.GuiAlignment` |  |
| `Columns` | `uint` |  |
| `Ignore` | `bool` |  |

<h3 id="member-625ba8b008032543" class="astra-member">Alignment</h3>

```csharp
public Astra.GuiAlignment Alignment { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Início, Centro, Fim ou Esticar no container.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ccaf220f5f5dd289" class="astra-member">Columns</h3>

```csharp
public uint Columns { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Colunas do Grid.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5f30812bbd0f9d8a" class="astra-member">Flexible</h3>

```csharp
public System.Numerics.Vector2 Flexible { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Peso de expansão dos filhos HBox/VBox.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2109ac25ef615c3a" class="astra-member">Ignore</h3>

```csharp
public bool Ignore { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Fora do fluxo automático; libera layout manual.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-011482100f894b01" class="astra-member">Minimum</h3>

```csharp
public System.Numerics.Vector2 Minimum { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tamanho mínimo XY do filho.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-853356d0ab9c5148" class="astra-member">Padding</h3>

```csharp
public System.Numerics.Vector4 Padding { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Margens internas esquerda/topo/direita/base.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c9fd6e122352256c" class="astra-member">Preferred</h3>

```csharp
public System.Numerics.Vector2 Preferred { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Tamanho preferido XY; zero mede conteúdo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f63d7bd166c4e3e" class="astra-member">Spacing</h3>

```csharp
public System.Numerics.Vector2 Spacing { get; init; }
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Distância XY entre filhos; HBox usa X e VBox usa Y.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.