BIS fnc guiMessage: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "_{10,} " to "") |
Lou Montana (talk | contribs) m (Text replacement - " *\| *([Cc]omments|COMMENTS|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments \("local" or "global"\)|Multiplayer Effects \("local" or "global"\)|Multiplayer Execution \("server" o...) |
||
| Line 1: | Line 1: | ||
{{Function | {{Function | ||
| arma3 | | arma3 | ||
|1.00 | |1.00 | ||
|gr1= GUI | |gr1= GUI | ||
| [[File:BIS fnc guiMessage.jpg|thumb|right|GUI message in {{arma3}}]] Shows customized native message box to user. | | [[File:BIS fnc guiMessage.jpg|thumb|right|GUI message in {{arma3}}]] Shows customized native message box to user. | ||
{{Informative | This syntax is for {{arma3}}. For the {{tkoh}} version, see [[BIS_fnc_guiMessage TKOH]].}} | {{Informative | This syntax is for {{arma3}}. For the {{tkoh}} version, see [[BIS_fnc_guiMessage TKOH]].}} | ||
| [message, header, okButton, cancelButton, parent, useParentBox, pause)] spawn [[BIS_fnc_guiMessage]] | | [message, header, okButton, cancelButton, parent, useParentBox, pause)] spawn [[BIS_fnc_guiMessage]] | ||
| Line 30: | Line 30: | ||
|p7= pause: [[Boolean]] - (Optional, default [[true]]) pause simulation when message box is open (no effect in multiplayer) | |p7= pause: [[Boolean]] - (Optional, default [[true]]) pause simulation when message box is open (no effect in multiplayer) | ||
| [[Boolean]] - [[true]] if "OK" button was pressed, otherwise false. Returned only after message box is closed. | | [[Boolean]] - [[true]] if "OK" button was pressed, otherwise false. Returned only after message box is closed. | ||
|x1= <code>["Hello World"] [[spawn]] [[BIS_fnc_guiMessage]];</code> | |x1= <code>["Hello World"] [[spawn]] [[BIS_fnc_guiMessage]];</code> | ||
|x2= <code>_result = ["Are you sure?", "Confirm", [[true]], [[true]]] [[call]] [[BIS_fnc_guiMessage]];</code> | |x2= <code>_result = ["Are you sure?", "Confirm", [[true]], [[true]]] [[call]] [[BIS_fnc_guiMessage]];</code> | ||
| [[hintC]], [[BIS_fnc_GUIhint]] [[BIS_fnc_3DENShowMessage]] | | [[hintC]], [[BIS_fnc_GUIhint]] [[BIS_fnc_3DENShowMessage]] | ||
Revision as of 23:00, 17 January 2021
Description
Syntax
- Syntax:
- [message, header, okButton, cancelButton, parent, useParentBox, pause)] spawn BIS_fnc_guiMessage
- Parameters:
- message: String or Structured Text - (Optional, default "") message
- header: String - (Optional) header text
- okButton: Boolean or String (Optional, default true)
- cancelButton: Boolean or String - (Optional, default false)
- parent: Display - (Optional, default displayNull) parent display
- useParentBox: Boolean - (Optional, default false) try to use control inherited from "RscMessageBox" in parent instead of creating a new one
- pause: Boolean - (Optional, default true) pause simulation when message box is open (no effect in multiplayer)
- Return Value:
- Boolean - true if "OK" button was pressed, otherwise false. Returned only after message box is closed.
Examples
- Example 1:
["Hello World"] spawn BIS_fnc_guiMessage;- Example 2:
_result = ["Are you sure?", "Confirm", true, true] call BIS_fnc_guiMessage;
Additional Information
- See also:
- hintCBIS_fnc_GUIhint BIS_fnc_3DENShowMessage
Notes
-
Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Notes
- Posted on June 24, 2014 - 00:43 (UTC)
- AgentRev
-
Message boxes can be force-closed with:
uiNamespace setVariable ["BIS_fnc_guiMessage_status", false]; - Posted on January 13, 2016 - 15:16 (UTC)
- Eden
-
Calling this function can cause an game crash. When doing this you have to spawn the function or add an spawn around it so you can use the result:
[] spawn { private _result = ["Are you sure?", "Confirm", true, true] call BIS_fnc_guiMessage; // Use _result here }; - Posted on November 1, 2017 - 18:35 (UTC)
- demellion
- NOTE: This function only exists along with mission display (findDisplay 46). If this function is called before with -skipIntro parameter enabled (see Arma 3 Startup Parameters) it will result as Void.