#include "SDL_stdinc.h"
#include "SDL_video.h"
#include "begin_code.h"
#include "close_code.h"

Classes
struct	SDL_MessageBoxButtonData
	Individual button data. More...

struct	SDL_MessageBoxColor
	RGB value used in a message box color scheme. More...

struct	SDL_MessageBoxColorScheme
	A set of colors to use for message box dialogs. More...

struct	SDL_MessageBoxData
	MessageBox structure containing title, text, window, etc. More...

Enumerations
enum	SDL_MessageBoxFlags { SDL_MESSAGEBOX_ERROR = 0x00000010, SDL_MESSAGEBOX_WARNING = 0x00000020, SDL_MESSAGEBOX_INFORMATION = 0x00000040, SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT = 0x00000080, SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT = 0x00000100 }
	SDL_MessageBox flags. If supported will display warning icon, etc. More...

enum	SDL_MessageBoxButtonFlags { SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT = 0x00000001, SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT = 0x00000002 }
	Flags for SDL_MessageBoxButtonData. More...

enum	SDL_MessageBoxColorType { SDL_MESSAGEBOX_COLOR_BACKGROUND, SDL_MESSAGEBOX_COLOR_TEXT, SDL_MESSAGEBOX_COLOR_BUTTON_BORDER, SDL_MESSAGEBOX_COLOR_BUTTON_BACKGROUND, SDL_MESSAGEBOX_COLOR_BUTTON_SELECTED, SDL_MESSAGEBOX_COLOR_MAX }

Functions
DECLSPEC int SDLCALL	SDL_ShowMessageBox (const SDL_MessageBoxData messageboxdata, int buttonid)
	Create a modal message box. More...

DECLSPEC int SDLCALL	SDL_ShowSimpleMessageBox (Uint32 flags, const char title, const char message, SDL_Window *window)
	Create a simple modal message box. More...

Enumeration Type Documentation

◆ SDL_MessageBoxButtonFlags

enum SDL_MessageBoxButtonFlags

Flags for SDL_MessageBoxButtonData.

Enumerator
SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT	Marks the default button when return is hit
SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT	Marks the default button when escape is hit

Definition at line 49 of file SDL_messagebox.h.

 {
     SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT = 0x00000001,  
     SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT = 0x00000002   
 } SDL_MessageBoxButtonFlags;

◆ SDL_MessageBoxColorType

enum SDL_MessageBoxColorType

Enumerator
SDL_MESSAGEBOX_COLOR_BACKGROUND
SDL_MESSAGEBOX_COLOR_TEXT
SDL_MESSAGEBOX_COLOR_BUTTON_BORDER
SDL_MESSAGEBOX_COLOR_BUTTON_BACKGROUND
SDL_MESSAGEBOX_COLOR_BUTTON_SELECTED
SDL_MESSAGEBOX_COLOR_MAX

Definition at line 73 of file SDL_messagebox.h.

 {
     SDL_MESSAGEBOX_COLOR_BACKGROUND,
     SDL_MESSAGEBOX_COLOR_TEXT,
     SDL_MESSAGEBOX_COLOR_BUTTON_BORDER,
     SDL_MESSAGEBOX_COLOR_BUTTON_BACKGROUND,
     SDL_MESSAGEBOX_COLOR_BUTTON_SELECTED,
     SDL_MESSAGEBOX_COLOR_MAX
 } SDL_MessageBoxColorType;

◆ SDL_MessageBoxFlags

enum SDL_MessageBoxFlags

SDL_MessageBox flags. If supported will display warning icon, etc.

Enumerator
SDL_MESSAGEBOX_ERROR	error dialog
SDL_MESSAGEBOX_WARNING	warning dialog
SDL_MESSAGEBOX_INFORMATION	informational dialog
SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT	buttons placed left to right
SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT	buttons placed right to left

Definition at line 37 of file SDL_messagebox.h.

 {
     SDL_MESSAGEBOX_ERROR                 = 0x00000010,   
     SDL_MESSAGEBOX_WARNING               = 0x00000020,   
     SDL_MESSAGEBOX_INFORMATION           = 0x00000040,   
     SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT = 0x00000080,   
     SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT = 0x00000100    
 } SDL_MessageBoxFlags;

Function Documentation

◆ SDL_ShowMessageBox()

DECLSPEC int SDLCALL SDL_ShowMessageBox	(	const SDL_MessageBoxData *	messageboxdata,
		int *	buttonid
	)

Create a modal message box.

Parameters

messageboxdata	The SDL_MessageBoxData structure with title, text, etc.
buttonid	The pointer to which user id of hit button should be copied.

Returns: -1 on error, otherwise 0 and buttonid contains user id of button hit or -1 if dialog was closed.

Note: This function should be called on the thread that created the parent window, or on the main thread if the messagebox has no parent. It will block execution of that thread until the user clicks a button or closes the messagebox.

◆ SDL_ShowSimpleMessageBox()

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

Create a simple modal message box.