Astra.GuiControlSnapshot

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

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

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

Declaração

readonly record struct Astra.GuiControlSnapshot

Interfaces: System.IEquatable<Astra.GuiControlSnapshot>.

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. GuiControlSnapshot configura ou descreve dados de GUI. Leia campos e valores e use os records/enums com GuiElement ou GuiAccess. HUD completo.

Roadmap e uso

Canvas e UI de jogo: 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.

Membros

Membro	Categoria
.ctor	Method
Device	Property
Pointer	Property
Pressed	Property
Value	Property

.ctor

public GuiControlSnapshot(System.Numerics.Vector2 Value, bool Pressed, uint Pointer, uint Device)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`Value`	`System.Numerics.Vector2`
`Pressed`	`bool`
`Pointer`	`uint`
`Device`	`uint`

Device

public uint Device { get; init; }

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

Uso: Tipo/identidade de device; pointer igual não une mouse e touch.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Pointer

public uint Pointer { get; init; }

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

Uso: Identificador do ponteiro capturado.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Pressed

public bool Pressed { get; init; }

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

Uso: Captura/pressão atual.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Value

public System.Numerics.Vector2 Value { get; init; }

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

Uso: Vetor bruto do gesto, não velocidade física.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.