> ## 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.

# Elemento do MicrosoftGame.config - ShellVisuals

> Elemento do MicrosoftGame.config - ShellVisuals

# Elemento do MicrosoftGame.config - ShellVisuals

Define a presença do título no Shell. Por exemplo, Imagens e Nomes. Usado durante o registro para exibir o título no Shell.

## Pai

O pai deste elemento é o elemento Game.

## Requisito

Este elemento é opcional e não é obrigatório defini-lo.

## Plataforma

Este elemento se aplica a PC e console.

## Comportamento

* Os atributos são:
  * DefaultDisplayName
  * PublisherDisplayName
  * StoreLogo
  * Square150x150Logo
  * Square44x44Logo
  * Square480x480Logo
  * Description
  * ForegroundText
  * BackgroundColor
  * SplashScreenImage
* O valor padrão do atributo ForegroundText é 'light'. O valor padrão do atributo BackgroundColor é 'transparent'. Todos os outros atributos não têm valores padrão.
* Valores permitidos para:
  * O atributo DefaultDisplayName é uma cadeia de caracteres com até 256 caracteres.
  * O atributo PublisherDisplayName é uma cadeia de caracteres com até 256 caracteres.
  * O atributo StoreLogo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
  * O atributo Square150x150Logo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
  * O atributo Square44x44Logo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
  * Square480x480Logo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
  * Description é uma cadeia de caracteres
  * O atributo ForegroundText é light e dark.
  * O atributo BackgroundColor é um valor de cor usando o formato de nome comum ou código hexadecimal (#RRGGBB).
  * O atributo SplashScreenImage é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.

## Comentários

* Os atributos StoreLogo, Square150x150Logo, Square44x44Logo, Square480x480Logo e SplashScreenImage são todos obrigatórios para o empacotamento.
* O atributo SplashScreenImage não é obrigatório para títulos de PC, mas é recomendado como prática recomendada.
* Todos os outros atributos são opcionais.
* Confira a seção ST\_Color no Esquema do MicrosoftGame.config para obter uma lista completa de nomes comuns para valores de cor.

### Logotipos em ShellVisuals e Executable

O elemento OverrideLogo em Executable está associado ao elemento Logo em ShellVisuals. Se OverrideLogo estiver definido, ele terá prioridade, para aquele executável, sobre o que está definido em Logo. O Logo em ShellVisuals deve ser definido em uma camada de pacote. Para um pacote de executável único, somente o elemento Logo é necessário. O tamanho do Logo deve ser de 150x150 pixels para o atributo Square150x150Logo.

O atributo OverrideLogo substituirá o arquivo .png designado por Square150x150Logo em ShellVisuals para aquele Executable específico. Além do atributo OverrideLogo, também há atributos para OverrideSquare480x480Logo e Square44x44Logo, que podem ser especificados para substituir os arquivos .png designados por Square480x480Logo e Square44x44Logo, respectivamente, em ShellVisuals para aquele Executable específico.

O exemplo a seguir detalha a configuração de elementos e atributos especificamente para substituições de Logo/DisplayName.

```xml theme={null}
<ShellVisuals DefaultDisplayName="MyGame"
                Square150x150Logo="GraphicsLogo.png"
                Square44x44Logo="SmallLogo.png"
                Square480x480Logo="LargeLogo.png"
                SplashScreenImage="SplashScreen.png"
                StoreLogo="StoreLogo.png"/>

<ExecutableList>
    <Executable Name="MyGame.exe"
                OverrideDisplayName="MyGameOverride"
                OverrideLogo="GraphicsLogoOverride.png"
                OverrideSquare44x44Logo="SmallLogoOverride.png"
                OverrideSquare480x480Logo="LargeLogoOverride.png"
                OverrideSplashScreenImage="SplashScreenOverride.png"/>
</ExecutableList>
```

`OverrideDisplayName` e `OverrideSplashScreenImage` funcionam de forma semelhante a OverrideLogo.

#### Requisitos de imagem

Square150x150Logo, Square44x44Logo e StoreLogo são obrigatórios para um pacote que não seja de DLC tanto no PC quanto no console. SplashScreenImage é obrigatório para console, mas agora, a partir do GDK de fevereiro de 2021, é opcional para PC. Para pacotes de DLC, somente StoreLogo é obrigatório.

#### Resolução e formato da imagem

O formato de logotipo exigido é .png e há requisitos quanto ao formato de pixel (RGB de 24 bpp ou ARGB/PARGB de 32 bpp). Esses requisitos são impostos pelo SubmissionValidator.

Cada imagem tem uma resolução de imagem obrigatória. São elas:

* Square150x150Logo: 150x150
* Square44x44Logo: 44x44
* Square480x480Logo: 480x480
* StoreLogo: 100x100
* SplashScreenImage: 1920x1080

#### SplashScreenImage

SplashScreenImage é a imagem usada quando o seu título está sendo iniciado.

O atributo OverrideSplashScreenImage, do elemento Executable, é usado para substituir a imagem da tela inicial exibida ao iniciar o seu título. Essa substituição agora permite imagens de tela inicial específicas por executável durante o desenvolvimento.

<Note>Embora o atributo SplashScreenImage não seja específico de plataforma, atualmente ele é obrigatório para o desenvolvimento em console XBOX e opcional para o desenvolvimento em PC.</Note>

#### BackgroundColor

BackgroundColor é um atributo do elemento ShellVisuals. Ele usa um código de cor HTML para definir o plano de fundo do título no PC. Isso aparecerá como uma borda ao redor do logotipo na Barra de Tarefas e no Menu Iniciar.

## Confira também

[Referência do MicrosoftGame.config - Sumário](/pt-BR/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)


## Related topics

- [Elemento de MicrosoftGame.config - ShellVisuals](/es/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-shellvisuals.md)
- [Elemento de MicrosoftGame.config - Executable](/es/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable.md)
- [MicrosoftGame.config Element - ShellVisuals](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-shellvisuals.md)
- [MicrosoftGame.config 元素 - ShellVisuals](/zh-CN/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-shellvisuals.md)
- [MicrosoftGame.config 要素 - ShellVisuals](/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-shellvisuals.md)