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 SeriesDocumentação conceitual
Confira também
XGameUIXGameUIShowMessageDialogResult
Ciclo de vida do jogo XBOX (tópico sob NDA)
