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

SDL_ShowSimpleMessageBox

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

構文

int SDL_ShowSimpleMessageBox(Uint32 flags, const char* title, const char* message, SDL_Window* window)

引数

flagsSDL_MessageBoxFlag (詳細を参照すること)
titleタイトルのUTF-8文字列
messageメッセージのUTF-8文字列
window親ウィンドウ, NULLのとき親ウィンドウを持たない

戻り値

成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()を呼んで詳細を知ることができる.

サンプルコード

SDL_ShowSimpleMessageBox(SDL_MESSAGEBOX_ERROR, 
                         "ファイルが失われている",
                         "ファイルが失われています。プログラムを再インストールしてください。",
                         NULL);

詳細

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

flagは以下の値である.

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

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

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

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

バージョン

SDL 2.0.0以降

SDL Wikiへのリンク

SDL_ShowSimpleMessageBox - SDL Wiki