createDialog: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "description.ext" to "description.ext") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
(15 intermediate revisions by 2 users not shown) | |||
Line 27: | Line 27: | ||
|descr= Creates a dialog which is defined either in the mission's [[Description.ext|description.ext]], in the campaign's description.ext or in the global [[Resource.cpp/bin|resource.cpp]]. The given name has to be the class name used in one of these files. If another dialog is already opened, the desired dialog is created as a child dialog of the one already opened. | |descr= Creates a dialog which is defined either in the mission's [[Description.ext|description.ext]], in the campaign's description.ext or in the global [[Resource.cpp/bin|resource.cpp]]. The given name has to be the class name used in one of these files. If another dialog is already opened, the desired dialog is created as a child dialog of the one already opened. | ||
{{Feature|informative|By default, displays created with [[createDisplay]] are rendered on top of dialogs created with [[createDialog]]. If ''forceOnTop'' is set to [[true]], the dialog will be rendered on top of displays.}} | |||
|s1= [[createDialog]] dialogName | |s1= [[createDialog]] dialogName | ||
|p1= dialogName: [[String]] - | |p1= dialogName: [[String]] - class name used in the description.ext, resource.cpp or config.cpp | ||
|r1= [[Boolean]] - [[true]] when the dialog was created successfully | |||
|s2= [[createDialog]] [dialogName, forceOnTop] | |||
| | |s2since= arma3 2.08 | ||
| | |p21= dialogName: [[String]] - class name used in the description.ext, resource.cpp or config.cpp | ||
| | |p22= forceOnTop: [[Boolean]] - (Optional, default [[false]]) if [[true]], dialog will be rendered on top of displays | ||
|r2= [[Display]] - created dialog | |||
< | |x1= <sqf> | ||
private _ok = createDialog "RscDisplayGame"; | |||
if (!_ok) then { hint "Dialog could not be opened!" }; | |||
</sqf> | |||
|seealso= [[displayCtrl]] [[createDisplay]] [[closeDialog]] [[dialog]] [[displayNull]] [[controlNull]] [[ctrlCreate]] [[displayParent]] | |||
}} | |||
{{Note | |||
|user= Killzone_Kid | |||
|timestamp= 20170729090400 | |||
|text= A user dialog created with [[createDisplay]] over mission display ([[findDisplay]] 46) will stop [[displayAddEventHandler|display event handlers]] added to mission display from firing. However if it is created with [[createDialog]] then the event handlers continue to work. | |||
}} |
Latest revision as of 01:02, 19 March 2023
Description
- Description:
- Creates a dialog which is defined either in the mission's description.ext, in the campaign's description.ext or in the global resource.cpp. The given name has to be the class name used in one of these files. If another dialog is already opened, the desired dialog is created as a child dialog of the one already opened.
- Groups:
- GUI Control
Syntax
- Syntax:
- createDialog dialogName
- Parameters:
- dialogName: String - class name used in the description.ext, resource.cpp or config.cpp
- Return Value:
- Boolean - true when the dialog was created successfully
Alternative Syntax
- Syntax:
- createDialog [dialogName, forceOnTop]
- Parameters:
- dialogName: String - class name used in the description.ext, resource.cpp or config.cpp
- forceOnTop: Boolean - (Optional, default false) if true, dialog will be rendered on top of displays
- Return Value:
- Display - created dialog
Examples
- Example 1:
Additional Information
- See also:
- displayCtrl createDisplay closeDialog dialog displayNull controlNull ctrlCreate displayParent
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
- Posted on Jul 29, 2017 - 09:04 (UTC)
- A user dialog created with createDisplay over mission display (findDisplay 46) will stop display event handlers added to mission display from firing. However if it is created with createDialog then the event handlers continue to work.
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.75
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Operation Flashpoint: Elite: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: GUI Control
- Scripting Commands: Local Effect