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

# Modos de exibição de janela e caixas de diálogo de UI chamável pelo título

> Configure os modos de exibição de janela de jogos para PC para que as caixas de diálogo de UI chamável pelo título (TCUI) sejam renderizadas corretamente e o Gaming Runtime impeça a minimização na perda de foco.

Este tópico aborda as considerações especiais necessárias para lidar com os modos de exibição de janela no PC e exibir com êxito as caixas de diálogo de UI chamável pelo título (TCUI).

Verifique se a janela do jogo está visível antes de invocar qualquer API que possa exibir a TCUI. Além disso, a janela do jogo deve usar o modo Janela em Tela Inteira/Sem Bordas ou Em Janela/Não Maximizada, em vez de Tela Inteira Exclusiva.

Os jogos devem ser executados na resolução nativa da tela, em vez de uma resolução personalizada do aplicativo/jogo. Algumas tecnologias (como DirectX 9) não lidam bem com a mudança de resolução quando a caixa de diálogo da TCUI é exibida.

Além disso, alguns mecanismos e wrappers de middleware, bem como o DirectX 9, minimizam automaticamente uma janela de jogo em tela inteira quando o foco em primeiro plano é perdido para a caixa de diálogo da TCUI. Para contornar esse comportamento indesejável para os jogadores, a plataforma nega explicitamente a minimização da janela ao exibir caixas de diálogo da TCUI. Para obter mais detalhes, consulte a seção Impedir a minimização da janela do jogo mais adiante neste tópico.

Para títulos de jogos que usam tecnologias gráficas que não são DirectX, nossas práticas recomendadas variam, conforme mostrado a seguir.

Se o título do jogo usar OpenGL ou Vulkan, será necessário um modo "em janela" que mostre uma borda de janela pertencente à área de trabalho para permitir que as caixas de diálogo da TCUI sejam renderizadas sobre o jogo. Isso ocorre porque, dependendo da implementação do driver da placa de vídeo, um jogo executado em qualquer tipo de modo de tela inteira pode ser renderizado sem o envolvimento do Gerenciador de Janelas da Área de Trabalho. Isso impede que a caixa de diálogo da TCUI seja exibida sobre a janela do jogo.

Para outras tecnologias gráficas, entre em contato com seu representante de suporte do XBOX.

## Impedir a minimização da janela do jogo

Alguns mecanismos de middleware e sistemas de camadas (por exemplo, Unity e Simple DirectMedia Layer (SDL)) minimizam automaticamente a janela de tela inteira do jogo quando o foco em primeiro plano é perdido para a caixa de diálogo da TCUI.

Para impedir esse comportamento, o Gaming Runtime usa [CBTProc](https://learn.microsoft.com/previous-versions/windows/desktop/legacy/ms644977\(v=vs.85\)) para negar quaisquer solicitações de minimização da janela do jogo. O Gaming Runtime só aplica esse padrão quando detecta que as sobreposições podem ser renderizadas sobre a janela de jogo DirectX em tela inteira e que a caixa de diálogo da TCUI está visível.

Além disso, o Gaming Runtime intercepta e modifica quaisquer mensagens de janela de alteração de estilo antes de exibir as caixas de diálogo da TCUI, para impedir que a janela do jogo renderize uma borda ou uma barra de título. Os estilos do grupo [WS\_OVERLAPPEDWINDOW](https://learn.microsoft.com/windows/win32/winmsg/window-styles) não são aplicados em uma alteração de estilo, a menos que já existissem no estilo antigo. Essa modificação só é implementada durante o tempo de vida da caixa de diálogo da TCUI.

## Considerações sobre o DirectX 9 com caixas de diálogo da TCUI

Embora o Gaming Runtime impeça que jogos DirectX 9 sejam minimizados, conforme descrito em Impedir a minimização da janela do jogo (anteriormente neste tópico), eles ainda perdem o foco em primeiro plano quando uma caixa de diálogo da TCUI é exibida. Seu jogo deve lidar com essa perda de foco de forma adequada, exatamente da mesma maneira que responderia a um jogador minimizando a janela do jogo durante a execução em tela inteira.

## Considerações sobre o Unity com caixas de diálogo da TCUI

Defina `Application.runInBackground` como true para qualquer jogo que pretenda exibir uma caixa de diálogo da TCUI.


## Related topics

- [Caixas de diálogo do sistema do Game Saves](/pt-BR/build/core-features/common/game-save/game-saves-dialogues.md)
- [XGameUiShowMessageDialogUiCallback](/pt-BR/reference/system/xgameui/functions/xgameuishowmessagedialoguicallback.md)
- [PFGameSaveFilesSetUiCallbacks](/pt-BR/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [Diretrizes de UX de conversão de fala em texto e exibição de texto do PlayFab Party](/pt-BR/services/playfab/community/voice-communications/party-speech-to-text-ux-guidelines.md)
- [XBOX Manager: controle remoto](/pt-BR/tools/tools-console/xbom/manager-tool-gamepad-input.md)