{"name":"BIS_fnc_3DENShowMessage","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","games":{"arma3":"1.58"},"since":"arma3 1.58","arma3_since":"1.58","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>\n> - `\"STR_DISP_OK\"`\n> - `\"STR_DISP_CLOSE\"`\n> - `\"STR_DISP_CANCEL\"`","syntaxes":[{"syntax":"[text, title, buttonOK, buttonCancel, icon, parentDisplay] call BIS_fnc_3DENShowMessage","params":[{"name":"text","type":"String","description":"text to display. Text is parsed and therefore supports Structured Text tags","type_expr":"String"},{"name":"title","type":"String","optional":true,"default":"\"\"","description":"title header","type_expr":"String","text":"title: String - (Optional, default \"\") title header"},{"name":"buttonOK","type":"String, Boolean or Array","optional":true,"default":"\"\"","description":"can be one of:\n\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","type_expr":"String | Boolean | Array","text":"buttonOK: String, Boolean or Array - (Optional, default \"\") can be one of:\n\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\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","type_expr":"String | Boolean | Array","text":"buttonCancel: String, Boolean or Array - (Optional, default \"\") can be one of:\n\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","type_expr":"String","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","type_expr":"Display","text":"parentDisplay: Display - (Optional, default `findDisplay 313` (Eden Display)) display from which the window is opened"}],"returns":{"type":"Display","type_expr":"Display"}}],"examples":[{"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;"]}],"see_also":["BIS_fnc_guiMessage"]}