{"name":"BIS_fnc_3DENShowMessage","operator":null,"title":"BIS fnc 3DENShowMessage","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_3DENShowMessage","revid":376078,"updated":"2025-07-30T11:33:25Z","groups":["Eden Editor"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.58"}],"since":{"game":"arma3","name":"Arma 3","version":"1.58"},"arma3_since":"1.58","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Shows a pop-up message.\nIn order to skip any optional parameter in between other parameters, send nil as parameter.\n\n> [!NOTE]\n> The following stringtable entries are useful to add custom Code but keep the default button texts:\n> - `\"STR_DISP_OK\"`\n> - `\"STR_DISP_CLOSE\"`\n> - `\"STR_DISP_CANCEL\"`","syntaxes":[{"syntax":"[text, title, buttonOK, buttonCancel, icon, parentDisplay] call BIS_fnc_3DENShowMessage","since":null,"effect":null,"exec":null,"params":[{"name":"text","type":"String","optional":false,"default":null,"description":"text to display. Text is parsed and therefore supports Structured Text tags","types":["String"],"since":null,"text":"text: String - text to display. Text is parsed and therefore supports Structured Text tags"},{"name":"title","type":"String","optional":true,"default":"\"\"","description":"title header","types":["String"],"since":null,"text":"title: String - (Optional, default \"\") title header"},{"name":"buttonOK","type":"String, Boolean or Array","optional":true,"default":"\"\"","description":"can be one of:\n- String - button's text\n- Boolean - show button or not\n- Array - in format [String or Boolean, Code]:\n  - String or Boolean - same as above\n  - Code - code executed when button is pressed","types":["String","Boolean","Array"],"since":null,"text":"buttonOK: String, Boolean or Array - (Optional, default \"\") can be one of:\n- String - button's text\n- Boolean - show button or not\n- Array - in format [String or Boolean, Code]:\n  - String or Boolean - same as above\n  - Code - code executed when button is pressed"},{"name":"buttonCancel","type":"String, Boolean or Array","optional":true,"default":"\"\"","description":"can be one of:\n- String - button's text\n- Boolean - show button or not\n- Array - in format [String or Boolean, Code]:\n  - String or Boolean - same as above\n  - Code - code executed when button is pressed","types":["String","Boolean","Array"],"since":null,"text":"buttonCancel: String, Boolean or Array - (Optional, default \"\") can be one of:\n- String - button's text\n- Boolean - show button or not\n- Array - in format [String or Boolean, Code]:\n  - String or Boolean - same as above\n  - Code - code executed when button is pressed"},{"name":"icon","type":"String","optional":true,"default":"\"\"","description":"path to an icon which will be shown on the left side of the message","types":["String"],"since":null,"text":"icon: String - (Optional, default \"\") path to an icon which will be shown on the left side of the message"},{"name":"parentDisplay","type":"Display","optional":true,"default":"`findDisplay 313` (Eden Display)","description":"display from which the window is opened","types":["Display"],"since":null,"text":"parentDisplay: Display - (Optional, default `findDisplay 313` (Eden Display)) display from which the window is opened"}],"returns":{"type":"Display","types":["Display"],"description":null,"text":"Display"}}],"examples":[{"text":"```sqf\n[\"Message\",\"Title of the Message\"] call BIS_fnc_3DENShowMessage;\n```","code":["[\"Message\",\"Title of the Message\"] call BIS_fnc_3DENShowMessage;"]},{"text":"```sqf\n[\n    \"Are you sure you want to delete / modify the selected variables?\",\n    \"Delete / Modify\",\n    [\n        \"Yes\",\n        { BIS_Message_Confirmed = true }\n    ],\n    [\n        \"No\",\n        { BIS_Message_Confirmed = false }\n    ],\n    \"\\A3\\ui_f\\data\\map\\markers\\handdrawn\\warning_CA.paa\",\n    findDisplay 313\n] call BIS_fnc_3DENShowMessage;\n```","code":["[\n\t\"Are you sure you want to delete / modify the selected variables?\",\n\t\"Delete / Modify\",\n\t[\n\t\t\"Yes\",\n\t\t{ BIS_Message_Confirmed = true }\n\t],\n\t[\n\t\t\"No\",\n\t\t{ BIS_Message_Confirmed = false }\n\t],\n\t\"\\A3\\ui_f\\data\\map\\markers\\handdrawn\\warning_CA.paa\",\n\tfindDisplay 313\n] call BIS_fnc_3DENShowMessage;"]},{"text":"```sqf\n// Only change the OK button's code\n[\n    \"Are you sure you want to delete / modify the selected variables?\",\n    \"Delete / Modify\",\n    [\n        nil,\n        { BIS_Message_Confirmed = true }\n    ],\n    nil,\n    \"\\A3\\ui_f\\data\\map\\markers\\handdrawn\\warning_CA.paa\",\n    findDisplay 313\n] call BIS_fnc_3DENShowMessage;\n```","code":["// Only change the OK button's code\n[\n\t\"Are you sure you want to delete / modify the selected variables?\",\n\t\"Delete / Modify\",\n\t[\n\t\tnil,\n\t\t{ BIS_Message_Confirmed = true }\n\t],\n\tnil,\n\t\"\\A3\\ui_f\\data\\map\\markers\\handdrawn\\warning_CA.paa\",\n\tfindDisplay 313\n] call BIS_fnc_3DENShowMessage;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["BIS_fnc_guiMessage"],"notes":[],"categories":["Arma 3: Functions","Arma 3: New Functions","Function Group: Eden Editor","Functions","Introduced with Arma 3 version 1.58"],"docblock":null,"filled_from_docblock":[]}