findDisplay: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(finding a displays manual)
(14 intermediate revisions by 9 users not shown)
Line 7: Line 7:
____________________________________________________________________________________________
____________________________________________________________________________________________


| Find display by its IDD (which is defined in the description.ext or config).<br>
| Find display by its IDD (which is defined in the [[description.ext]] or config).<br>
If the specified display can't be found [[displayNull]] ("No display") is returned, (which can be tested with the [[isNull]] command.)
If the specified display can't be found [[displayNull]] ("No display") is returned, (which can be tested with the [[isNull]] command.)


Line 20: Line 20:
____________________________________________________________________________________________
____________________________________________________________________________________________
   
   
|x1= <pre>_display = findDisplay 1</pre> |= Example 1
|x1= <code>_display = [[findDisplay]] 1;</code> |= Example 1
____________________________________________________________________________________________
____________________________________________________________________________________________


| [[displayCtrl]], [[isNull]] |= See also
| [[displayCtrl]], [[createDisplay]], [[createDialog]], [[dialog]], [[displayNull]], [[controlNull]], [[isNull]], [[createDisplay]], [[ctrlCreate]], [[displayParent]] |= See also


}}
}}
Line 31: Line 31:
<!-- Note Section BEGIN -->
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on 15 June 2008</dd>
<dd class="notedate">Posted on 15 June 2008
<dt class="note>'''[[User:Kronzky|Kronzky]]'''</dt>
<dt class="note>'''[[User:Kronzky|Kronzky]]'''
<dd class="note">
<dd class="note">
findDisplay does ''not'' find displays defined under RscTitles (even when they are visible).<br>
findDisplay does ''not'' find displays defined under RscTitles (even when they are visible).<br>
Line 42: Line 42:
     ...
     ...
</pre>
</pre>
You can then use the stored value as you would for regular dialogs, e.g.<code>(myDisplay displayCtrl 1111) ctrlSetText "hello there");</code>
You can then use the stored value as you would for regular dialogs:
</dd>
<code>(myDisplay [[displayCtrl]] 1111) [[ctrlSetText]] "hello there");</code>


<dd class="notedate">Posted on 15 June 2008</dd>
<dd class="notedate">Posted on 17 March 2010
<dt class="note>'''[[User:Hendo|Hendo]]'''</dt>
<dt class="note>'''[[User:Hendo|Hendo]]'''
<dd class="note">
<dd class="note">
I posted a tutorial on finding and using displays [[User:Hendo:Tutorials:Display|here.]]
I posted a tutorial on finding and using displays [[User:Hendo:Tutorials:Display|here.]]
</dd>


<dd class="notedate">Posted on 07 March 2014
<dt class="note>'''[[User:EUTWtrnapster|EUTWtrnapster]]'''
<dd class="note">
The Zeus Display uses IDD 312
<!-- Note Section END -->
<!-- Note Section END -->
</dl>
</dl>
Line 63: Line 64:
[[Category:Command_Group:_System_Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_System_Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands VBS2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on March 25, 2015 - 22:04 (UTC)</dd>
<dt class="note">[[User:Austin medic|Austin medic]]</dt>
<dd class="note">
Display 12 is map<br>
</dd>
</dl>
<!-- DISCONTINUE Notes -->
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on June 25, 2017 - 09:32 (UTC)</dd>
<dt class="note">[[User:IT07|IT07]]</dt>
 
<dd class="note">
I have tested the behavior of this command and I found out that it [ findDisplay ] appears to only return the display AFTER any onLoad event handler of that display is done. So, using findDisplay inside an onLoad event handler is useless. 
</dd>
</dl>
<!-- DISCONTINUE Notes -->
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on August 14, 2017 - 12:22 (UTC)</dd>
<dt class="note">[[User:Demellion|Demellion]]</dt>
<dd class="note">
There are some specific cases, where '''findDisplay''' will not be able to find an existing display. Here's the cases and how to act on them:<br/>
<code>//Your display has IDD= -1.
 
class RscDisplayNew
{
    idd=-1;
    scriptName = "RscDisplayNew";
    ...
};</code>
<code>//Your display doesn't have IDD
 
class RscDisplayNew
{
    scriptName = "RscDisplayNew";
    ...
};</code>
<code>//Your display doesn't have scriptname with IDD = -1
 
class RscDisplayNew
{
    idd=-1;
    ...
};</code>
<code>//Your display doesn't have scriptname, neither IDD
 
class RscDisplayNew
{
    ...
};</code>
 
 
== 1. ==
You actually can find a -1 display, but this means finding a display with this IDD might be a problem, when there are a few displays marked as -1.
So as you can see, theres an entry called '''scriptName'''. You can get a reference to this display by using [[uiNamespace]]:
<code>(uiNamespace getVariable "RscDisplayNew")</code>
'''NOTE''': Variables are overwritten with a reference of the last declared display under the same scriptName entry. Take a look at case 3 for solution.
== 2. ==
Displays without IDD's can actually exist. They can be manipulated only in a way described in the first case using [[uiNamespace]].
== 3. ==
You can really have this display seeking it manually in a [[allDisplays]] return. This is experimental, but working option.
== 4. ==
You will have a problem finding this display, since this display doesn't exist even in [[allDisplays]](?) return. Behaviour unknown.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 12:07, 14 August 2017

-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Find display by its IDD (which is defined in the description.ext or config).
If the specified display can't be found displayNull ("No display") is returned, (which can be tested with the isNull command.) The primary display uses IDD 46. (eg: findDisplay 46). This will return displayNull on a dedicated server (so be sure to check isDedicated if using this in a waitUntil condition).
Groups:
Uncategorised

Syntax

Syntax:
Display = findDisplay idd
Parameters:
idd: Number
Return Value:
Display

Examples

Example 1:
_display = findDisplay 1;

Additional Information

See also:
displayCtrlcreateDisplaycreateDialogdialogdisplayNullcontrolNullisNullcreateDisplayctrlCreatedisplayParent

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 15 June 2008
Kronzky
findDisplay does not find displays defined under RscTitles (even when they are visible).
To access those types of displays, either assign the resource to a global variable, or pass its this value to a script, during the onLoad event: e.g.
class RscTitles {
  class MyRsc {
     onLoad = "myDisplay = (_this select 0)"; // or
     // onLoad = "_this execVM 'myDialog.sqf'";
     ...

You can then use the stored value as you would for regular dialogs: (myDisplay displayCtrl 1111) ctrlSetText "hello there");

Posted on 17 March 2010
Hendo
I posted a tutorial on finding and using displays here.
Posted on 07 March 2014
EUTWtrnapster
The Zeus Display uses IDD 312

Bottom Section

Posted on March 25, 2015 - 22:04 (UTC)
Austin medic
Display 12 is map
Posted on June 25, 2017 - 09:32 (UTC)
IT07
I have tested the behavior of this command and I found out that it [ findDisplay ] appears to only return the display AFTER any onLoad event handler of that display is done. So, using findDisplay inside an onLoad event handler is useless.
Posted on August 14, 2017 - 12:22 (UTC)
Demellion
There are some specific cases, where findDisplay will not be able to find an existing display. Here's the cases and how to act on them:
//Your display has IDD= -1. class RscDisplayNew { idd=-1; scriptName = "RscDisplayNew"; ... }; //Your display doesn't have IDD class RscDisplayNew { scriptName = "RscDisplayNew"; ... }; //Your display doesn't have scriptname with IDD = -1 class RscDisplayNew { idd=-1; ... }; //Your display doesn't have scriptname, neither IDD class RscDisplayNew { ... };

1.

You actually can find a -1 display, but this means finding a display with this IDD might be a problem, when there are a few displays marked as -1. So as you can see, theres an entry called scriptName. You can get a reference to this display by using uiNamespace: (uiNamespace getVariable "RscDisplayNew") NOTE: Variables are overwritten with a reference of the last declared display under the same scriptName entry. Take a look at case 3 for solution.

2.

Displays without IDD's can actually exist. They can be manipulated only in a way described in the first case using uiNamespace.

3.

You can really have this display seeking it manually in a allDisplays return. This is experimental, but working option.

4.

You will have a problem finding this display, since this display doesn't exist even in allDisplays(?) return. Behaviour unknown.