Pular para o conteúdo
AstraDOCS

Astra.GuiActionBinding

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

Additional listeners execute in order after the primary OnClick action.

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

readonly record struct Astra.GuiActionBinding

Additional listeners execute in order after the primary OnClick action.

Interfaces: System.IEquatable<Astra.GuiActionBinding>.

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. GuiActionBinding 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
Event Property
Target Property
Value Property

.ctor

public GuiActionBinding(Astra.GuiEventKind Event, Astra.GuiClickAction Action, uint Target = 0, float Value = 0)

Additional listeners execute in order after the primary OnClick action.

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
Event Astra.GuiEventKind
Action Astra.GuiClickAction
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 nativa executada na ordem da lista.

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

Event

public Astra.GuiEventKind Event { get; init; }

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

Uso: Evento que dispara o listener: Click ou ValueChanged.

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: Alvo local no mesmo documento; não é objeto de cena.

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 da ação, como valor de Progress.

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