Skip to main content

XGameUiShowMessageDialogAsync

显示可自定义消息对话框的 UI。用户按下的按钮的索引包含在结果中。

语法

参数

async _In_
类型:XAsyncBlock*
指向传递给 XAsyncRunXAsyncBlock 的指针。 titleText _In_
类型:char*
消息对话框的文本标题。 contentText _In_
类型:char*
在消息对话框内显示的文本。 firstButtonText _In_opt_
类型:char*
在消息对话框的第一个按钮上显示的文本。 secondButtonText _In_opt_
类型:char*
在消息对话框的第二个按钮上显示的文本。 thirdButtonText _In_opt_
类型:char*
在消息对话框的第三个按钮上显示的文本。 defaultButton _In_
类型:XGameUiMessageDialogButton
指示首次显示消息对话框时默认选择的按钮。 cancelButton _In_
类型:XGameUiMessageDialogButton
指示表示取消操作的按钮。

返回值

类型:HRESULT 异步调用的 HRESULT 成功或错误代码。 若要获取结果,请在 XAsyncBlock 回调内或 XAsyncBlock 完成后调用 XGameUiShowMessageDialogResult

备注

与其他 XGameUI* 函数一样,XGameUiShowMessageDialogAsync 在游戏分区之外呈现其 UI,结果与游戏的输出合成后再将每帧发送到显示设备。这意味着无论游戏是否正在呈现,都可以使用 XGameUiShowMessageDialogAsync 向用户呈现信息。 调用 UI 将使游戏进入_受限模式_。在受限模式下,当你的游戏处于所调用 UI 的后台时,它将获得较少的系统资源。若要详细了解受限模式和游戏的其他运行模式,请阅读 XBOX 游戏生命周期(NDA 主题) 以下示例代码演示如何在开发场景中使用此方法来创建等待输入的阻塞 UI。这在崩溃故障发生的位置暂停当前执行、报告崩溃位置或提示开发人员附加调试器时特别有用。

要求

标头: XGameUI.h 库: xgameruntime.lib 支持的平台: Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

概念文档

另请参阅

XGameUI
XGameUIShowMessageDialogResult
XBOX 游戏生命周期(NDA 主题)
最后修改于 2026年8月24日