# CategoryMessagebox

SDL offers a simple message box API, which is useful for simple alerts,
such as informing the user when something fatal happens at startup without
the need to build a UI for it (or informing the user _before_ your UI is
ready).

These message boxes are native system dialogs where possible.

There is both a customizable function
([SDL_ShowMessageBox](SDL_ShowMessageBox)()) that offers lots of options
for what to display and reports on what choice the user made, and also a
much-simplified version
([SDL_ShowSimpleMessageBox](SDL_ShowSimpleMessageBox)()), merely takes a
text message and title, and waits until the user presses a single "OK" UI
button. Often, this is all that is necessary.

<!-- END CATEGORY DOCUMENTATION -->

## Functions

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryMessagebox, CategoryAPIFunction -->
- [SDL_ShowMessageBox](SDL_ShowMessageBox)
- [SDL_ShowSimpleMessageBox](SDL_ShowSimpleMessageBox)
<!-- END CATEGORY LIST -->

## Datatypes

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryMessagebox, CategoryAPIDatatype -->
- [SDL_MessageBoxButtonFlags](SDL_MessageBoxButtonFlags)
- [SDL_MessageBoxFlags](SDL_MessageBoxFlags)
<!-- END CATEGORY LIST -->

## Structs

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryMessagebox, CategoryAPIStruct -->
- [SDL_MessageBoxButtonData](SDL_MessageBoxButtonData)
- [SDL_MessageBoxColor](SDL_MessageBoxColor)
- [SDL_MessageBoxColorScheme](SDL_MessageBoxColorScheme)
- [SDL_MessageBoxData](SDL_MessageBoxData)
<!-- END CATEGORY LIST -->

## Enums

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryMessagebox, CategoryAPIEnum -->
- [SDL_MessageBoxColorType](SDL_MessageBoxColorType)
<!-- END CATEGORY LIST -->

## Macros

<!-- DO NOT HAND-EDIT CATEGORY LISTS, THEY ARE AUTOGENERATED AND WILL BE OVERWRITTEN, BASED ON TAGS IN INDIVIDUAL PAGE FOOTERS. EDIT THOSE INSTEAD. -->
<!-- BEGIN CATEGORY LIST: CategoryMessagebox, CategoryAPIMacro -->
- (none.)
<!-- END CATEGORY LIST -->


----
[CategoryAPICategory](CategoryAPICategory)