目次 - SDL 3.0 API(機能別) - メッセージボックス - SDL_ShowSimpleMessageBox

SDL_ShowSimpleMessageBox

単純なモーダルメッセージボックスを表示する

ヘッダ

SDL3/SDL_messagebox.h

構文

bool SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags flags, const char *title, const char *message, SDL_Window *window);

引数

SDL_MessageBoxFlagsflagsSDL_MessageBoxFlagsの値
const char *titleタイトルのUTF-8文字列
const char *messageメッセージのUTF-8文字列
SDL_Window *window親ウィンドウ, NULLのとき親ウィンドウを持たない

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

複雑なものが必要でなければ, この関数はSDL_ShowMessageBox()よりも適している.

flagは以下の値である.

SDL_MESSAGEBOX_ERRORエラーダイアログ
SDL_MESSAGEBOX_WARNING警告ダイアログ
SDL_MESSAGEBOX_INFORMATION情報ダイアログ

この関数はSDL_Init()の前でも呼べる. このことはレンダラーやOpenGLコンテキストの生成の失敗を報告するときに役立つ.

X11では, GTK+やQtのようなツールキットではなくX11そのものでダイアログボックスを表示する.

利用できるビデオがなくSDL_Init()が失敗した場合, この関数も同じ理由で失敗することに注意する必要がある. これが問題になるならば, この関数の戻り値をチェックし, 失敗を戻したならstderrに書き込むこと.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_ShowSimpleMessageBox - SDL Wiki