---
title: "Botão de UI"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/receitas/botao-de-ui/
---

# Botão de UI

Consuma o evento do controle certo.

## Composição da cena

Canvas com um botão chamado Comecar e Behavior consultando esse canvas.

## Implementação

```csharp
while (Gui.Poll(out var message))
{
    if (message.Kind == GuiEventKind.Click &&
        message.Element.Name == "Comecar")
    {
        Object.Name = "Botão acionado";
    }
}
```

## Resultado esperado

Um click no controle nomeado altera o objeto receptor.

## Cuidados

Trecho de Update. Se houver vários canvases, obtenha o GuiAccess correto. Esta receita consome a fila; coordene os consumidores para não retirar eventos de outro sistema.

Consulte [GuiAccess](/pt-br/snapshot-2026-10-06/api/astra-guiaccess/). As instruções descrevem o cenário proposto; a execução em dispositivo não foi realizada nesta publicação.