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

Zwraca 0 przy sukcesie lub ujemny kod błędu przy niepowodzeniu; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

SDL_ShowSimpleMessageBox(SDL_MESSAGEBOX_ERROR,
                         "Missing file",
                         "File is missing. Please reinstall the program.",
                         NULL);

Parametr flags może przyjąć dowolną z poniższych wartości:

SDL_MESSAGEBOX_ERROR	wiadomość o błędzie
SDL_MESSAGEBOX_WARNING	ostrzeżenie
SDL_MESSAGEBOX_INFORMATION	informacja

Tę funkcję można wywołać w dowolnej chwili, nawet przed SDL_Init(). Czyni ją to użyteczną przy zgłaszaniu błędów takich jak niepowodzenie utworzenia kontekstu graficznego lub kontekstu OpenGL.

W X11 SDL rozwija swoje własne okno dialogowe z elementami X11, zamiast formalnego okienka narzędziowego typu GTK+ lub Qt.

Zwróć uwagę, że jeśli SDL_Init() poniesie porażkę z powodu braku dostępności jakiegokolwiek środowiska graficznego, to ta funkcja prawdopodobnie również zawiedzie z tego samego powodu. Jeśli tak jest, sprawdź wartość zwracaną przez funkcję i zapisz ją do stderr, jeśli możesz.