---
title: "Astra.GuiSnapshot"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guisnapshot/
---

# Astra.GuiSnapshot

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.GuiSnapshot
```

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

## 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. **GuiSnapshot** 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-34cdc0b4b4e2c0f0) | Method |
| [Enabled](#member-8be8228b328b0b1f) | Property |
| [Id](#member-3d7be55575765382) | Property |
| [Kind](#member-39424b3222fab13c) | Property |
| [Maximum](#member-f86ac2b969288554) | Property |
| [Minimum](#member-af895a7c2f336de0) | Property |
| [Value](#member-8fcb07b7f705a27f) | Property |
| [Visible](#member-e6b9527d6623e144) | Property |
| [World](#member-7db537d4365349f3) | Property |

<h3 id="member-34cdc0b4b4e2c0f0" class="astra-member">.ctor</h3>

```csharp
public GuiSnapshot(uint World, uint Id, Astra.GuiKind Kind, bool Visible, bool Enabled, float Value, float Minimum, float Maximum)
```

**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 |
|---|---|---|
| `World` | `uint` |  |
| `Id` | `uint` |  |
| `Kind` | `Astra.GuiKind` |  |
| `Visible` | `bool` |  |
| `Enabled` | `bool` |  |
| `Value` | `float` |  |
| `Minimum` | `float` |  |
| `Maximum` | `float` |  |

<h3 id="member-8be8228b328b0b1f" class="astra-member">Enabled</h3>

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

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

**Uso:** Habilitação do estado local.

**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-3d7be55575765382" class="astra-member">Id</h3>

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

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

**Uso:** ID local do nó.

**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-39424b3222fab13c" class="astra-member">Kind</h3>

```csharp
public Astra.GuiKind Kind { get; init; }
```

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

**Uso:** Tipo de nó.

**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-f86ac2b969288554" class="astra-member">Maximum</h3>

```csharp
public float Maximum { get; init; }
```

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

**Uso:** Extremo superior autorado.

**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-af895a7c2f336de0" class="astra-member">Minimum</h3>

```csharp
public float Minimum { get; init; }
```

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

**Uso:** Extremo inferior autorado.

**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-8fcb07b7f705a27f" class="astra-member">Value</h3>

```csharp
public float Value { get; init; }
```

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

**Uso:** Valor de Toggle/Slider/Progress.

**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-e6b9527d6623e144" class="astra-member">Visible</h3>

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

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

**Uso:** Visibilidade do estado local.

**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-7db537d4365349f3" class="astra-member">World</h3>

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

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

**Uso:** Mundo da execução.

**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.