// This file was generated by Cpp2Beef

using System;
using System.Interop;
using static SDL3.SDL;

namespace SDL3;

extension SDL
{
/*
  Simple DirectMedia Layer
  Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.
*/

/**
 * # 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()) 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()),
 * 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.
 */






/* For SDL_Window */


/* Set up for C function definitions, even when using C++ */




/**
 * Message box flags.
 *
 * If supported will display warning icon, etc.
 *
 * \since This datatype is available since SDL 3.2.0.
 */
public enum MessageBoxFlags : Uint32 {}
	

public const let MESSAGEBOX_ERROR                    = 0x00000010u;/**< error dialog */
public const let MESSAGEBOX_WARNING                  = 0x00000020u;/**< warning dialog */
public const let MESSAGEBOX_INFORMATION              = 0x00000040u;/**< informational dialog */
public const let MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT    = 0x00000080u;/**< buttons placed left to right */
public const let MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT    = 0x00000100u;/**< buttons placed right to left */

/**
 * SDL_MessageBoxButtonData flags.
 *
 * \since This datatype is available since SDL 3.2.0.
 */
public enum MessageBoxButtonFlags : Uint32 {}
	

public const let MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT = 0x00000001u;/**< Marks the default button when return is hit */
public const let MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT = 0x00000002u;/**< Marks the default button when escape is hit */

/**
 * Individual button data.
 *
 * \since This struct is available since SDL 3.2.0.
 */
[CRepr] public struct MessageBoxButtonData
{
    public MessageBoxButtonFlags flags;
    public c_int buttonID;       /**< User defined button id (value returned via SDL_ShowMessageBox) */
    public c_char* text;   /**< The UTF-8 button text */
}

/**
 * RGB value used in a message box color scheme
 *
 * \since This struct is available since SDL 3.2.0.
 */
[CRepr] public struct MessageBoxColor
{
    public Uint8 r; public Uint8 g; public Uint8 b;
}

/**
 * An enumeration of indices inside the colors array of
 * SDL_MessageBoxColorScheme.
 */
[AllowDuplicates] public enum MessageBoxColorType : c_int
{
    Background,
    ext,
    ButtonBorder,
    ButtonBackground,
    ButtonSelected,
    Count,                    /**< Size of the colors array of SDL_MessageBoxColorScheme. */
}

/**
 * A set of colors to use for message box dialogs
 *
 * \since This struct is available since SDL 3.2.0.
 */
[CRepr] public struct MessageBoxColorScheme
{
    public MessageBoxColor[5] colors;
}

/**
 * MessageBox structure containing title, text, window, etc.
 *
 * \since This struct is available since SDL 3.2.0.
 */
[CRepr] public struct MessageBoxData
{
    public MessageBoxFlags flags;
    public Window* window;                 /**< Parent window, can be NULL */
    public c_char* title;                  /**< UTF-8 title */
    public c_char* message;                /**< UTF-8 message text */

    public c_int numbuttons;
    public MessageBoxButtonData* buttons;

    public MessageBoxColorScheme* colorScheme;   /**< SDL_MessageBoxColorScheme, can be NULL to use system settings */
}

/**
 * Create a modal message box.
 *
 * If your needs aren't complex, it might be easier to use
 * SDL_ShowSimpleMessageBox.
 *
 * 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.
 *
 * This function may be called at any time, even before SDL_Init(). This makes
 * it useful for reporting errors like a failure to create a renderer or
 * OpenGL context.
 *
 * On X11, SDL rolls its own dialog box with X11 primitives instead of a
 * formal toolkit like GTK+ or Qt.
 *
 * Note that if SDL_Init() would fail because there isn't any available video
 * target, this function is likely to fail for the same reasons. If this is a
 * concern, check the return value from this function and fall back to writing
 * to stderr if you can.
 *
 * \param messageboxdata the SDL_MessageBoxData structure with title, text and
 *                       other options.
 * \param buttonid the pointer to which user id of hit button should be
 *                 copied.
 * \returns true on success or false on failure; call SDL_GetError() for more
 *          information.
 *
 * \since This function is available since SDL 3.2.0.
 *
 * \sa SDL_ShowSimpleMessageBox
 */
[LinkName("SDL_ShowMessageBox")] public static extern bool ShowMessageBox(MessageBoxData* messageboxdata, c_int* buttonid);

/**
 * Display a simple modal message box.
 *
 * If your needs aren't complex, this function is preferred over
 * SDL_ShowMessageBox.
 *
 * `flags` may be any of the following:
 *
 * - `SDL_MESSAGEBOX_ERROR`: error dialog
 * - `SDL_MESSAGEBOX_WARNING`: warning dialog
 * - `SDL_MESSAGEBOX_INFORMATION`: informational dialog
 *
 * 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.
 *
 * This function may be called at any time, even before SDL_Init(). This makes
 * it useful for reporting errors like a failure to create a renderer or
 * OpenGL context.
 *
 * On X11, SDL rolls its own dialog box with X11 primitives instead of a
 * formal toolkit like GTK+ or Qt.
 *
 * Note that if SDL_Init() would fail because there isn't any available video
 * target, this function is likely to fail for the same reasons. If this is a
 * concern, check the return value from this function and fall back to writing
 * to stderr if you can.
 *
 * \param flags an SDL_MessageBoxFlags value.
 * \param title UTF-8 title text.
 * \param message UTF-8 message text.
 * \param window the parent window, or NULL for no parent.
 * \returns true on success or false on failure; call SDL_GetError() for more
 *          information.
 *
 * \since This function is available since SDL 3.2.0.
 *
 * \sa SDL_ShowMessageBox
 */
[LinkName("SDL_ShowSimpleMessageBox")] public static extern bool ShowSimpleMessageBox(MessageBoxFlags flags, c_char* title, c_char* message, Window* window);
}

/* Ends C function definitions when using C++ */





/* SDL_messagebox_h_ */