> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Paleta de cores

> Paleta de cores

# Paleta de cores

Uma coleção de cores reutilizáveis que podem ser referenciadas em layouts.

## Propriedades

`default` - *object*, *opcional*. Uma coleção de definições de [cor hexadecimal](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-hexcolor) que podem ser referenciadas usando uma [referência de cor](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference).

`highContrast` - *object*, *opcional*. Uma coleção de definições de [cor hexadecimal](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-hexcolor) que podem ser referenciadas usando uma [referência de cor](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference). Substitui as definições em `default` quando o [modo de alto contraste](/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode) está habilitado.

<a id="sample" />

## Exemplo

```JSON theme={null}
{
  "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/layout/4.0/layout.json",
  "styles": {
    "colors": {
      "default": {
        "myColor1": "#ff0000ff",
        "myColor2": "#00ff00ff",
        "system_contentPrimary": "#0000ffff"
      },
      "highContrast": {
        "myColor1": "#00ff00ff",
        "system_contrastPrimary": "#0000ffaa"
      }
    }
  },
  "content": {
    "left": {
      "inner": [
        {
          "type": "directionalPad",
          "styles": {
            "idle": {
              "background": {
                "type": "color",
                "value": "colors/myColor1"
              }
            }
          }
        }
      ]
    },
    "right": {
      "inner": [
          {
              "type": "button",
              "action": "gamepadY"
          },
          {
              "type": "button",
              "action": "gamepadB"
          },
          {
              "type": "button",
              "action": "gamepadA",
              "styles": {
                "idle": {
                  "background": {
                    "type": "color",
                    "value": "colors/myColor2"
                  }
                }
              }
          },
          {
              "type": "button",
              "action": "gamepadX"
          }
      ]
    }
  }
}
```

O layout acima com o modo de alto contraste **desabilitado**:

<img src="https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/game-streaming-tak-color-palette-reference-hc-disabled.png?fit=max&auto=format&n=-_0FrcE2bDxzGxv-&q=85&s=dba732004eecd1db8fc9a608c31248cd" alt="Layout de toque com paleta de cores e modo de alto contraste desabilitado" width="1006" height="506" data-path="images/gdk/reference/game-streaming-tak-color-palette-reference-hc-disabled.png" />

E com o modo de alto contraste **habilitado**:

<img src="https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/game-streaming-tak-color-palette-reference-hc-enabled.png?fit=max&auto=format&n=-_0FrcE2bDxzGxv-&q=85&s=fff468e0eba734e9edec6527e7584262" alt="Layout de toque com paleta de cores e modo de alto contraste habilitado" width="1000" height="502" data-path="images/gdk/reference/game-streaming-tak-color-palette-reference-hc-enabled.png" />

<a id="remarks" />

## Comentários

O [exemplo](#sample) acima inclui definições de cores que substituem as [cores do sistema](#system-colors) (por exemplo, `system_contentPrimary`, `system_accentPrimary` etc.), bem como definições de cores personalizadas (`myColor1`, `myColor2`). Os controles amostram **implicitamente** as cores do sistema ao aplicar estilos, o que significa que quaisquer substituições afetarão o estilo global de todos os controles (a menos que um controle tenha sua própria substituição dentro de um bloco `styles` personalizado). As cores personalizadas devem ser referenciadas **explicitamente** usando uma [referência de cor](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-colorreference) (por exemplo, `colors/myColor1`). Além disso, as definições de cores personalizadas **não podem** usar o prefixo reservado `system_`, pois ele é reservado para cores do sistema.

As definições de cores são declaradas nos objetos `default` e `highContrast` e são ativadas quando o [modo de alto contraste](/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode) está desabilitado ou habilitado, respectivamente. Quando o modo de alto contraste está desabilitado, as cores são amostradas de `default`. Quando habilitado, as cores são amostradas primeiro de `highContrast`, recorrendo a `default` se não existir nenhuma definição. Se uma substituição de cor do sistema não estiver presente em `default`, um padrão do sistema será usado, enquanto as cores personalizadas **devem** ser definidas em `default`. A tabela a seguir descreve como as definições de cores acima serão resolvidas, dependendo de o modo de alto contraste (HC) estar habilitado ou não:

| Definição de cor | Modo HC desabilitado | Modo HC habilitado |
| :- | - | - |
| myColor1 | `#ff0000ff` | `#00ff00ff` |
| myColor2 | `#00ff00ff` | `#00ff00ff` |
| system\_contentPrimary | `#0000ffff` | `#0000ffff` |
| system\_contrastPrimary | padrão do sistema | `#0000ffaa` |

<a id="system-colors" />

## Cores do sistema

A tabela a seguir resume a lista de cores do sistema no touch adaptation kit, uma descrição de como elas são usadas para estilizar controles, bem como seus valores padrão do sistema quando o modo de alto contraste (HC) está desabilitado/habilitado.

| Cor do sistema | Descrição | Modo HC desabilitado | Modo HC habilitado |
| :- | :- | :- | :- |
| system\_contentPrimary | Cor usada para estilizar componentes como traços intermediários, tonalidades de ícones e gradientes do direcional. | `#ffffffff` | `#ffffffff` |
| system\_contentSecondary | Cor usada para estilizar componentes como fundos e preenchimentos. | `#ffffff1a` | `#ffffffff` |
| system\_contrastPrimary | Cor usada para estilizar componentes de contraste, como traços internos/externos e placas de fundo de imagens frontais. | `#00000000` | `#000000bf` |
| system\_contrastSecondary | Cor usada para estilizar componentes de contraste, como traços do touchpad. | `#00000000` | `#ffffffff` |
| system\_actionColorDefault | Cor usada para estilizar componentes em controles nos quais o campo `action` está definido como uma ação que não é de gamepad. | `#ffffffff` | `#ffffffe6` |
| system\_actionColorA | Cor usada para estilizar componentes em controles nos quais o campo `action` está definido como `gamepadA`. | `#7eb902ff` | `#ffffffe6` |
| system\_actionColorB | Cor usada para estilizar componentes em controles nos quais o campo `action` está definido como `gamepadB`. | `#f25127ff` | `#ffffffe6` |
| system\_actionColorX | Cor usada para estilizar componentes em controles nos quais o campo `action` está definido como `gamepadX`. | `#00a2eeff` | `#ffffffe6` |
| system\_actionColorY | Cor usada para estilizar componentes em controles nos quais o campo `action` está definido como `gamepadY`. | `#ffb807ff` | `#ffffffe6` |
| system\_accentPrimary | Cor usada para estilizar componentes como a roda interna de edição ergonômica. | `#8cc08cff` | `#8cc08cff` |
| system\_accentSecondary | Cor usada para estilizar componentes como a roda externa de edição ergonômica. | `#61ab61ff` | `#61ab61ff` |

Para obter uma lista atualizada, consulte as definições prefixadas com `_SystemColor` no [esquema mais recente](https://github.com/microsoft/xbox-game-streaming-tools/blob/main/touch-adaptation-kit/schemas/layout/v4.0/layout.json).

## Consulte também

[Referência do Touch Adaptation Kit](/pt-BR/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Modo de alto contraste para layouts do Touch Adaptation Kit](/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode)


## Related topics

- [Touch Adaptation Kit](/pt-BR/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Personalización de la vista previa de controles táctiles](/es/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-customize-preview.md)
- [Personalização da visualização dos controles por toque](/pt-BR/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-customize-preview.md)
- [Modo de alto contraste](/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode.md)
- [Información general de la API de C de Services - PFCore.h](/es/services/playfab/api-references/c/pfcore/pfcore_members.md)
