ctrlPosition: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(see also)
m (Fix note)
 
(53 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Returns the current position of 2D control as [x, y, w, h] array. For 3D control it returns relative [x,y,z]. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| '''ctrlPosition''' controlName|= Syntax
|game4= tkoh
|version4= 1.00


|p1= controlName: [[Control]] |= Parameter 1
|game5= arma3
|version5= 0.50


| [[Array]] |= Return value
|gr1= GUI Control - Positioning
____________________________________________________________________________________________
 
|x1= <code>_pos = [[ctrlPosition]] _control;</code> |= Example 1
____________________________________________________________________________________________


| [[ctrlCreate]], [[ctrlDelete]], [[ctrlSetDirection]], [[ctrlModel]], [[ctrlSetModel]], [[ctrlModelDirection]], [[ctrlModelUp]], [[ctrlModelSide]], [[ctrlSetPosition]], [[ctrlClassName]], [[displayCtrl]] |= See also
|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>
If the control is a [[CT_CONTROLS_TABLE]] header or row the returned position is relative to the table's position.


}}
|s1= [[ctrlPosition]] controlName


<h3 style="display:none">Notes</h3>
|p1= controlName: [[Control]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|r1= [[Array]] in format {{hl|[x, y, w, h]}} (2D) or {{hl|[x, y, z]}} (3D)
</dl>


<h3 style="display:none">Bottom Section</h3>
|x1= <sqf>_pos = ctrlPosition _control;</sqf>


[[Category:Scripting Commands|CTRLPOSITION]]
|seealso= [[ctrlCreate]] [[ctrlDelete]] [[ctrlModel]] [[ctrlSetModel]] [[ctrlSetPosition]] [[ctrlClassName]] [[displayCtrl]] [[ctrlModelScale]] [[ctrlSetModelScale]] [[ctrlModelDirAndUp]] [[ctrlSetModelDirAndUp]]
[[Category:Scripting Commands ArmA|CTRLPOSITION]]
}}
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11: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