Skip to main content

XGameUiShowMessageDialogAsync

Exibe a interface do usuário de uma caixa de diálogo de mensagem personalizável. O índice do botão pressionado pelo usuário está contido no resultado.

Sintaxe

Parâmetros

async _In_
Tipo: XAsyncBlock*
Um ponteiro para o XAsyncBlock que é passado para XAsyncRun. titleText _In_
Tipo: char*
O texto do título da caixa de diálogo de mensagem. contentText _In_
Tipo: char*
O texto exibido dentro da caixa de diálogo de mensagem. firstButtonText _In_opt_
Tipo: char*
O texto exibido no primeiro botão da caixa de diálogo de mensagem. secondButtonText _In_opt_
Tipo: char*
O texto exibido no segundo botão da caixa de diálogo de mensagem. thirdButtonText _In_opt_
Tipo: char*
O texto exibido no terceiro botão da caixa de diálogo de mensagem. defaultButton _In_
Tipo: XGameUiMessageDialogButton
Indica qual botão é selecionado por padrão quando a caixa de diálogo de mensagem é exibida pela primeira vez. cancelButton _In_
Tipo: XGameUiMessageDialogButton
Indica qual botão representa a ação de cancelamento.

Valor retornado

Tipo: HRESULT Código HRESULT de êxito ou erro da chamada assíncrona.  Para obter o resultado, chame XGameUiShowMessageDialogResult dentro do retorno de chamada de XAsyncBlock ou após a conclusão de XAsyncBlock.

Comentários

Assim como outras funções XGameUI*, XGameUiShowMessageDialogAsync renderiza a interface do usuário fora da partição do título, e o resultado é composto com a saída do título antes que cada quadro seja enviado ao dispositivo de exibição. Isso significa que XGameUiShowMessageDialogAsync pode ser usada para apresentar informações a um usuário independentemente de o jogo estar renderizando ou não. Chamar a interface do usuário fará com que o jogo entre no modo restrito. No modo restrito, o título receberá menos recursos do sistema enquanto estiver em segundo plano em relação à interface do usuário chamada. Para saber mais sobre o modo restrito e outros modos operacionais do título, leia Ciclo de vida do jogo XBOX (tópico sob NDA). O código de exemplo a seguir ilustra o uso desse método em um cenário de desenvolvimento para criar uma interface do usuário de bloqueio que aguarda entrada. Isso pode ser particularmente útil para pausar a execução atual no local de uma falha e relatar o local da falha ou solicitar que o desenvolvedor anexe um depurador.

Requisitos

Cabeçalho: XGameUI.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XGameUI
XGameUIShowMessageDialogResult
Ciclo de vida do jogo XBOX (tópico sob NDA)
Last modified on October 6, 2026