---
title: "Toggle: uso e campos"
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/ui/toggle/
---

# Toggle: uso e campos

Guarda um valor marcado/desmarcado e emite ValueChanged.

## Para que serve

Guarda um valor marcado/desmarcado e emite ValueChanged.

## Onde fica

**Interface → criar elemento → Toggle**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Toggle**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Marcado, Texto e Destaque; GuiElement.Value lê o valor.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Toggle**.

## Exemplo prático

Ligar/desligar uma opção do jogo.

## Limitações e roadmap

A opção precisa de um consumidor no seu script para alterar o gameplay.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.