ctrlSetPosition: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - ";[ ]+ " to "; ")
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(16 intermediate revisions by 2 users not shown)
Line 20: Line 20:
|descr= Sets wanted position and size for 2D control animation. Width and height are optional. [[ctrlCommit]] is required to complete the operation. For 3D control, param is relative [x, y, z] and no [[ctrlCommit]] is required as it cannot be animated. If target control is inside a [[CT_CONTROLS_GROUP]], the position needs to be relative to it.
|descr= Sets wanted position and size for 2D control animation. Width and height are optional. [[ctrlCommit]] is required to complete the operation. For 3D control, param is relative [x, y, z] and no [[ctrlCommit]] is required as it cannot be animated. If target control is inside a [[CT_CONTROLS_GROUP]], the position needs to be relative to it.


{{Feature|Important| This command doesn't work well with [[CT_MAP]] control. Use [[ctrlMapSetPosition]] instead. }}
{{Feature|important| This command doesn't work well with [[CT_MAP]] control. Use [[ctrlMapSetPosition]] instead. }}


|s1= controlName [[ctrlSetPosition]] [x, y]
|s1= controlName [[ctrlSetPosition]] [x, y]


|p1= controlName: [[Control]] - 2D control
|p1= controlName: [[Control]] - 2D control


|p2= x: [[Number]] - Position in x
|p2= x: [[Number]] - position in x


|p3= y: [[Number]] - Position in y
|p3= y: [[Number]] - position in y


|r1= [[Nothing]]
|r1= [[Nothing]]


|s2= controlName [[ctrlSetPosition]] [x, y, w, h]
|s2= controlName [[ctrlSetPosition]] [x, y, w, h]


|p21= controlName: [[Control]] - 2D control
|p21= controlName: [[Control]] - 2D control


|p22= x: [[Number]] - Position in x
|p22= x: [[Number]] - position in x


|p23= y: [[Number]] - Position in y
|p23= y: [[Number]] - position in y


|p24= w: [[Number]] - Width of the control
|p24= w: [[Number]] - width of the control


|p25= h: [[Number]] - Height of the control
|p25= h: [[Number]] - height of the control


|r2= [[Nothing]]
|r2= [[Nothing]]


|s3= controlName [[ctrlSetPosition]] [x, y, z]
|s3= controlName [[ctrlSetPosition]] [x, z, y]


|p41= controlName: [[Control]] - 3D control
|p41= controlName: [[Control]] - 3D control


|p42= x: [[Number]] - Position in x
|p42= x: [[Number]] - screen x


|p43= y: [[Number]] - Position in y (Distance from the screen)
|p43= z: [[Number]] - distance from the screen (depth). If object is too far, it cannot be dragged by the mouse.


|p44= z: [[Number]] - Position in z
|p44= y: [[Number]] - screen y


|r3= [[Nothing]]
|r3= [[Nothing]]


|x1= Move control: <code>_control2D [[ctrlSetPosition]] [0, 0];
|x1= Move control:
_control2D [[ctrlCommit]] 0;</code>
<sqf>
_control2D ctrlSetPosition [0, 0];
_control2D ctrlCommit 0;
</sqf>


|x2= Move control and resize:<code>_control2D [[ctrlSetPosition]] [0, 0, 1, 1];
|x2= Move control and resize:
_control2D [[ctrlCommit]] 0;</code>
<sqf>
_control2D ctrlSetPosition [0, 0, 1, 1];
_control2D ctrlCommit 0;
</sqf>


|x3= <code>_control3D [[ctrlSetPosition]] [0.5, 1, 0.5]; //centered and 1m away from screen</code>
|x3= <sqf>_control3D ctrlSetPosition [0.5, 1, 0.5]; //centered and 1m away from screen</sqf>


|x4= Typewriter effect: <code>[[with]] [[uiNamespace]] [[do]]
|x4= Typewriter effect:
{  
<sqf>
[] [[spawn]]
with uiNamespace do
{
0 spawn
{
{
_text1 = "This is a simple demo of typewriter text effect with various speed.";
_text1 = "This is a simple demo of typewriter text effect with various speed.";
_text2 = "This took 10 seconds.";
_text2 = "This took 10 seconds.";
_text3 = "This is a fast one, set for 2 seconds.";
_text3 = "This is a fast one, set for 2 seconds.";
 
ctrl = [[findDisplay]] 46 [[ctrlCreate]] ["RscStructuredText", -1];
ctrl = findDisplay 46 ctrlCreate ["RscStructuredText", -1];
 
ctrl [[ctrlSetPosition]] [0,0,0,0.1];
ctrl ctrlSetPosition [0,0,0,0.1];
ctrl [[ctrlCommit]] 0;
ctrl ctrlCommit 0;
ctrl [[ctrlSetStructuredText]] [[parseText]] [[format]] ["<t color='#ff0000' size='2.1'>%1</t>", _text1 [[splitString]] " " [[joinString]] "&amp;#160;"];
ctrl ctrlSetStructuredText parseText format ["<t color='#ff0000' size='2.1'>%1</t>", _text1 splitString " " joinString "&#160;"];
ctrl [[ctrlSetPosition]] [0,0,[[ctrlTextWidth]] ctrl,0.1];
ctrl ctrlSetPosition [0,0,ctrlTextWidth ctrl,0.1];
ctrl [[ctrlCommit]] 8;
ctrl ctrlCommit 8;
 
[[waitUntil]] {[[ctrlCommitted]] ctrl};
waitUntil {ctrlCommitted ctrl};
[[sleep]] 0.5;
sleep 0.5;
 
ctrl [[ctrlSetPosition]] [0,0,0,0.1];
ctrl ctrlSetPosition [0,0,0,0.1];
ctrl [[ctrlCommit]] 0;
ctrl ctrlCommit 0;
ctrl [[ctrlSetStructuredText]] [[parseText]] [[format]] ["<t color='#ff0000' size='2.1'>%1</t>", _text2 [[splitString]] " " [[joinString]] "&amp;#160;"];
ctrl ctrlSetStructuredText parseText format ["<t color='#ff0000' size='2.1'>%1</t>", _text2 splitString " " joinString "&#160;"];
ctrl [[ctrlSetPosition]] [0,0,[[ctrlTextWidth]] ctrl,0.1];
ctrl ctrlSetPosition [0,0,ctrlTextWidth ctrl,0.1];
ctrl [[ctrlCommit]] 2;
ctrl ctrlCommit 2;
 
[[waitUntil]] {[[ctrlCommitted]] ctrl};
waitUntil {ctrlCommitted ctrl};
[[sleep]] 2;
sleep 2;
 
ctrl [[ctrlSetPosition]] [0,0,0,0.1];
ctrl ctrlSetPosition [0,0,0,0.1];
ctrl [[ctrlCommit]] 0;
ctrl ctrlCommit 0;
ctrl [[ctrlSetStructuredText]] [[parseText]] [[format]] ["<t color='#00ff00' size='2.1'>%1</t>", _text3 [[splitString]] " " [[joinString]] "&amp;#160;"];
ctrl ctrlSetStructuredText parseText format ["<t color='#00ff00' size='2.1'>%1</t>", _text3 splitString " " joinString "&#160;"];
ctrl [[ctrlSetPosition]] [0,0,[[ctrlTextWidth]] ctrl,0.1];
ctrl ctrlSetPosition [0,0,ctrlTextWidth ctrl,0.1];
ctrl [[ctrlCommit]] 2;
ctrl ctrlCommit 2;
 
[[waitUntil]] {[[ctrlCommitted]] ctrl};
waitUntil {ctrlCommitted ctrl};
[[sleep]] 2;
sleep 2;
 
[[ctrlDelete]] ctrl;
ctrlDelete ctrl;
};
};
};</code>
};
</sqf>


|seealso= [[ctrlMapSetPosition]], [[ctrlCommit]] [[ctrlCreate]] [[ctrlDelete]] [[ctrlModel]] [[ctrlSetModel]] [[ctrlPosition]] [[ctrlClassName]] [[displayCtrl]] [[ctrlModelScale]] [[ctrlSetModelScale]] [[ctrlModelDirAndUp]] [[ctrlSetModelDirAndUp]]
|seealso= [[ctrlMapSetPosition]] [[ctrlCommit]] [[ctrlCreate]] [[ctrlDelete]] [[ctrlModel]] [[ctrlSetModel]] [[ctrlPosition]] [[ctrlClassName]] [[displayCtrl]] [[ctrlModelScale]] [[ctrlSetModelScale]] [[ctrlModelDirAndUp]] [[ctrlSetModelDirAndUp]]
}}
}}


<dl class="command_description">
{{Note
 
|user= Yuval
<dt></dt>
|timestamp= 20170620115600
<dd class="notedate">Posted on July 20, 2017 - 11:56 (UTC)</dd>
|text= If the target control is a controls' group, all the child controls of that group will be moved automatically (as their position is relative to the control group rather than the display).
<dt class="note">[[User:Yuval|Yuval]]</dt>
}}
<dd class="note">
If the target control is a controls' group, all the child controls of that group will be moved automatically (as their position is relative to the control group rather than the display)
</dd>
 
</dl>

Latest revision as of 11:34, 3 September 2024

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Sets wanted position and size for 2D control animation. Width and height are optional. ctrlCommit is required to complete the operation. For 3D control, param is relative [x, y, z] and no ctrlCommit is required as it cannot be animated. If target control is inside a CT_CONTROLS_GROUP, the position needs to be relative to it.
⚠
This command doesn't work well with CT_MAP control. Use ctrlMapSetPosition instead.
Groups:
GUI Control - Positioning

Syntax 1

Syntax:
controlName ctrlSetPosition [x, y]
Parameters:
controlName: Control - 2D control
x: Number - position in x
y: Number - position in y
Return Value:
Nothing

Syntax 2

Syntax:
controlName ctrlSetPosition [x, y, w, h]
Parameters:
controlName: Control - 2D control
x: Number - position in x
y: Number - position in y
w: Number - width of the control
h: Number - height of the control
Return Value:
Nothing

Syntax 3

Syntax:
controlName ctrlSetPosition [x, z, y]
Parameters:
controlName: Control - 3D control
x: Number - screen x
z: Number - distance from the screen (depth). If object is too far, it cannot be dragged by the mouse.
y: Number - screen y
Return Value:
Nothing

Examples

Example 1:
Move control:
_control2D ctrlSetPosition [0, 0]; _control2D ctrlCommit 0;
Example 2:
Move control and resize:
_control2D ctrlSetPosition [0, 0, 1, 1]; _control2D ctrlCommit 0;
Example 3:
_control3D ctrlSetPosition [0.5, 1, 0.5]; //centered and 1m away from screen
Example 4:
Typewriter effect:
with uiNamespace do { 0 spawn { _text1 = "This is a simple demo of typewriter text effect with various speed."; _text2 = "This took 10 seconds."; _text3 = "This is a fast one, set for 2 seconds."; ctrl = findDisplay 46 ctrlCreate ["RscStructuredText", -1]; ctrl ctrlSetPosition [0,0,0,0.1]; ctrl ctrlCommit 0; ctrl ctrlSetStructuredText parseText format ["<t color='#ff0000' size='2.1'>%1</t>", _text1 splitString " " joinString "&#160;"]; ctrl ctrlSetPosition [0,0,ctrlTextWidth ctrl,0.1]; ctrl ctrlCommit 8; waitUntil {ctrlCommitted ctrl}; sleep 0.5; ctrl ctrlSetPosition [0,0,0,0.1]; ctrl ctrlCommit 0; ctrl ctrlSetStructuredText parseText format ["<t color='#ff0000' size='2.1'>%1</t>", _text2 splitString " " joinString "&#160;"]; ctrl ctrlSetPosition [0,0,ctrlTextWidth ctrl,0.1]; ctrl ctrlCommit 2; waitUntil {ctrlCommitted ctrl}; sleep 2; ctrl ctrlSetPosition [0,0,0,0.1]; ctrl ctrlCommit 0; ctrl ctrlSetStructuredText parseText format ["<t color='#00ff00' size='2.1'>%1</t>", _text3 splitString " " joinString "&#160;"]; ctrl ctrlSetPosition [0,0,ctrlTextWidth ctrl,0.1]; ctrl ctrlCommit 2; waitUntil {ctrlCommitted ctrl}; sleep 2; ctrlDelete ctrl; }; };

Additional Information

See also:
ctrlMapSetPosition ctrlCommit ctrlCreate ctrlDelete ctrlModel ctrlSetModel ctrlPosition 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
Yuval - c
Posted on Jun 20, 2017 - 11:56 (UTC)
If the target control is a controls' group, all the child controls of that group will be moved automatically (as their position is relative to the control group rather than the display).
Retrieved from "https://community.bistudio.com/wiki?title=ctrlSetPosition&oldid=369188"