---
title: "Astra.GuiStyle"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-guistyle/
---

# Astra.GuiStyle

Colors use 0xAARRGGBB, matching the native editor and .aeui file.

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

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly record struct Astra.GuiStyle
```

Colors use 0xAARRGGBB, matching the native editor and .aeui file.

**Interfaces:** `System.IEquatable<Astra.GuiStyle>`.

## 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. **GuiStyle** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): 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](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-18527f472f44b344) | Method |
| [Accent](#member-e5550e8c843f5457) | Property |
| [Background](#member-2eaff5057989f5c7) | Property |
| [ClipChildren](#member-6171f7c2237a7aa3) | Property |
| [FontSize](#member-f747c87feb5676c5) | Property |
| [Foreground](#member-f8c677b04be2f445) | Property |
| [Radius](#member-ed20f911f2696191) | Property |

<h3 id="member-18527f472f44b344" class="astra-member">.ctor</h3>

```csharp
public GuiStyle(uint Background, uint Foreground, uint Accent, bool ClipChildren, float FontSize, float Radius)
```

Colors use 0xAARRGGBB, matching the native editor and .aeui file.

**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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `Background` | `uint` |  |
| `Foreground` | `uint` |  |
| `Accent` | `uint` |  |
| `ClipChildren` | `bool` |  |
| `FontSize` | `float` |  |
| `Radius` | `float` |  |

<h3 id="member-e5550e8c843f5457" class="astra-member">Accent</h3>

```csharp
public uint Accent { get; init; }
```

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

**Uso:** Cor de destaque/preenchimento do controle.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2eaff5057989f5c7" class="astra-member">Background</h3>

```csharp
public uint Background { get; init; }
```

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

**Uso:** Cor de fundo 0xAARRGGBB; alpha zero não desenha fundo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6171f7c2237a7aa3" class="astra-member">ClipChildren</h3>

```csharp
public bool ClipChildren { get; init; }
```

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

**Uso:** Recorta desenho/hit de descendentes ao retângulo.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f747c87feb5676c5" class="astra-member">FontSize</h3>

```csharp
public float FontSize { get; init; }
```

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

**Uso:** Tamanho do texto em pixels.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f8c677b04be2f445" class="astra-member">Foreground</h3>

```csharp
public uint Foreground { get; init; }
```

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

**Uso:** Cor do texto/conteúdo do controle.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ed20f911f2696191" class="astra-member">Radius</h3>

```csharp
public float Radius { get; init; }
```

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

**Uso:** Raio do fundo/imagem desenhados; não é uma hit mask por alpha.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.