ctrlPosition: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| *((\[\[[a-zA-Z0-9_ |()]+\]\],? ?)+) * \}\}" to "|seealso= $1 }}")
m (Fix note)
 
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma1
|game1= arma1
|version1= 1.00


|1.00
|game2= arma2
|version2= 1.00


|gr1= GUI Control
|game3= arma2oa
|version3= 1.50


| Returns the current position of 2D control as [x, y, w, h] array. For 3D control it returns relative [x,y,z].
|game4= tkoh
|version4= 1.00


| '''ctrlPosition''' controlName
|game5= arma3
|version5= 0.50


|p1= controlName: [[Control]]
|gr1= GUI Control - Positioning


| [[Array]]
|descr= Returns the current position of 2D control as {{hl|[x, y, w, h]}} array. For 3D control it returns relative {{hl|[x, y, z]}}.<br>
 
If the control is within a [[CT_CONTROLS_GROUP]], the returned position will be relative to the group's position.<br>
|x1= <code>_pos = [[ctrlPosition]] _control;</code>
If the control is a [[CT_CONTROLS_TABLE]] header or row the returned position is relative to the table's position.


|seealso= [[ctrlCreate]], [[ctrlDelete]], [[ctrlModel]], [[ctrlSetModel]], [[ctrlSetPosition]], [[ctrlClassName]], [[displayCtrl]], [[ctrlModelScale]], [[ctrlSetModelScale]], [[ctrlModelDirAndUp]], [[ctrlSetModelDirAndUp]]
|s1= [[ctrlPosition]] controlName
}}


|p1= controlName: [[Control]]


|r1= [[Array]] in format {{hl|[x, y, w, h]}} (2D) or {{hl|[x, y, z]}} (3D)


{{GameCategory|arma1|Scripting Commands}}
|x1= <sqf>_pos = ctrlPosition _control;</sqf>
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}


<!-- CONTINUE Notes -->
|seealso= [[ctrlCreate]] [[ctrlDelete]] [[ctrlModel]] [[ctrlSetModel]] [[ctrlSetPosition]] [[ctrlClassName]] [[displayCtrl]] [[ctrlModelScale]] [[ctrlSetModelScale]] [[ctrlModelDirAndUp]] [[ctrlSetModelDirAndUp]]
<dl class="command_description">
}}
<dd class="notedate">Posted on May 22, 2017 - 23:02 (UTC)</dd>
<dt class="note">[[User:Lucian|Lucian]]</dt>
<dd class="note">
If the ctrl is part of a CtrlGroup the returned position is relative to the ctrlGroups position.
</dd>
 
<dd class="notedate">Posted on November 7, 2020 - 01:23 (UTC)</dd>
<dt class="note">[[User:Larrow|Larrow]]</dt>
<dd class="note">
If the control is a ControlsTable header or row control the returned position is relative to the ControlsTable position.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 12:28, 22 March 2024

Hover & click on the images for description

Description

Description:
Returns the current position of 2D control as [x, y, w, h] array. For 3D control it returns relative [x, y, z].
If the control is within a CT_CONTROLS_GROUP, the returned position will be relative to the group's position.
If the control is a CT_CONTROLS_TABLE header or row the returned position is relative to the table's position.
Groups:
GUI Control - Positioning

Syntax

Syntax:
ctrlPosition controlName
Parameters:
controlName: Control
Return Value:
Array in format [x, y, w, h] (2D) or [x, y, z] (3D)

Examples

Example 1:
_pos = ctrlPosition _control;

Additional Information

See also:
ctrlCreate ctrlDelete ctrlModel ctrlSetModel ctrlSetPosition ctrlClassName displayCtrl ctrlModelScale ctrlSetModelScale ctrlModelDirAndUp ctrlSetModelDirAndUp

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