love.window.showMessageBox
Available since LÖVE 0.9.2 |
This function is not supported in earlier versions. |
Displays a message box dialog above the love window. The message box contains a title, optional text, and buttons.
This function will pause all execution of the main thread until the user has clicked a button to exit the message box. Calling the function from a different thread may cause love to crash. |
Contents
Function
Displays a simple message box with a single 'OK' button.
Synopsis
success = love.window.showMessageBox( title, message, type, attachtowindow )
Arguments
string title
- The title of the message box.
string message
- The text inside the message box.
MessageBoxType type ("info")
- The type of the message box.
boolean attachtowindow (true)
- Whether the message box should be attached to the love window or free-floating.
Returns
boolean success
- Whether the message box was successfully displayed.
Function
Displays a message box with a customized list of buttons.
Synopsis
pressedbutton = love.window.showMessageBox( title, message, buttonlist, type, attachtowindow )
Arguments
string title
- The title of the message box.
string message
- The text inside the message box.
table buttonlist
- A table containing a list of button names to show. The table can also contain the fields
enterbutton
andescapebutton
, which should be the index of the default button to use when the user presses 'enter' or 'escape', respectively. MessageBoxType type ("info")
- The type of the message box.
boolean attachtowindow (true)
- Whether the message box should be attached to the love window or free-floating.
Returns
number pressedbutton
- The index of the button pressed by the user. May be 0 if the message box dialog was closed without pressing a button.
Examples
Display a simple message box if the user's system doesn't support shaders
local errortitle = "Shader support is required for the game to run"
local errormessage = "This system is below the minimum system requirements for the game.\
If your graphics drivers aren't up-to-date, try updating them and running the game again."
if not love.graphics.isSupported("shader") then
love.window.showMessageBox(errortitle, errormessage, "error")
end
Display a message box with customized buttons
local title = "This is a title"
local message = "This is some text"
local buttons = {"OK", "No!", "Help", escapebutton = 2}
local pressedbutton = love.window.showMessageBox(title, message, buttons)
if pressedbutton == 1 then
-- "OK" was pressed
elseif pressedbutton == 2 then
-- etc.
end
See Also
Other Languages
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info