238 lines
7.8 KiB
Beef
238 lines
7.8 KiB
Beef
// 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_ */
|
|
|