Pular para o conteúdo
AstraDOCS

Astra.GuiInteraction

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

Target is a stable ID in the same UI document; zero means this element.

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

readonly record struct Astra.GuiInteraction

Target is a stable ID in the same UI document; zero means this element.

Interfaces: System.IEquatable<Astra.GuiInteraction>.

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

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.

Membro Categoria
.ctor Method
Action Property
Clickable Property
Target Property
Value Property

.ctor

public GuiInteraction(bool Clickable, Astra.GuiClickAction Action = Astra.GuiClickAction.Notify, uint Target = 0, float Value = 0)

Target is a stable ID in the same UI document; zero means this element.

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
Clickable bool
Action Astra.GuiClickAction · Opcional: 0
Target uint · Opcional: 0
Value float · Opcional: 0

Action

public Astra.GuiClickAction Action { get; init; }

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

Uso: Ação primária ao clicar.

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

Clickable

public bool Clickable { get; init; }

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

Uso: Habilita clique opcional de Image/Text/Panel/container.

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

Target

public uint Target { get; init; }

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

Uso: ID local no mesmo documento; zero = próprio elemento.

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

Value

public float Value { get; init; }

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

Uso: Argumento numérico da ação.

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