ctrlSetTextSelection: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " {3,}\|" to " |")
m (Some wiki formatting)
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| arma3
|game1= arma3
 
|version1= 2.00
|2.00


|gr1= GUI Control
|gr1= GUI Control


|Selects <tt>length</tt> characters of edit control from the <tt>start</tt> position and places cursor at the end of selection.
|descr=Selects {{hl|length}} characters of edit control from the {{hl|start}} position and places cursor at the end of selection.
{{Informative | To move cursor only, set <tt>length</tt> to 0. To select text from right to left, use negative <tt>length</tt> (See [[ctrlTextSelection]] for more info)}}
{{Feature|informative|To only move the cursor, set ''length'' to 0. To select text from right to left, use negative ''length'' (See [[ctrlTextSelection]] for more info)}}


| control [[ctrlSetTextSelection]] [start, length]
|s1= control [[ctrlSetTextSelection]] [start, length]


|p1= control: [[Control]]
|p1= control: [[Control]]


|p2= [start, length]: [[Array]]
|p2= start: [[Number]] - selection start position
|p3= start: [[Number]] - selection start position
|p4= length: [[Number]] - length of characters to select (0 to only move the cursor). Negative length will select text from right to left (see example 3)


| [[Nothing]]
|p3= length: [[Number]] - length of characters to select (0 to only move the cursor). Negative length will select text from right to left (see example 3)


|x1= <code>_control [[ctrlSetTextSelection]] [5, 10]</code>
|r1= [[Nothing]]


|x2= <code>[[disableSerialization]];
|x1= <sqf>_control ctrlSetTextSelection [5, 10];</sqf>
[[private]] _ctrl = [[findDisplay]] 46 [[createDisplay]] "RscDisplayEmpty" [[ctrlCreate]] ["RscEditMulti", -1];
_ctrl [[ctrlSetPosition]] [0,0,0.5,0.3];
_ctrl [[ctrlCommit]] 0;
_ctrl [[ctrlSetText]] "Hello World";
_ctrl [[ctrlSetTextSelection]] [6, 5]; // selects World
[[ctrlSetFocus]] _ctrl;</code>


|x3= Select text from right to left:<code>_control [[ctrlSetTextSelection]] [5, -4]</code>
|x2= <sqf>
disableSerialization;
private _ctrl = findDisplay 46 createDisplay "RscDisplayEmpty" ctrlCreate ["RscEditMulti", -1];
_ctrl ctrlSetPosition [0,0,0.5,0.3];
_ctrl ctrlCommit 0;
_ctrl ctrlSetText "Hello World";
_ctrl ctrlSetTextSelection [6, 5]; // selects World
ctrlSetFocus _ctrl;
</sqf>


| [[ctrlTextSelection]] [[ctrlSetText]]
|x3= Select text from right to left:
<sqf>_control ctrlSetTextSelection [5, -4];</sqf>


|seealso= [[ctrlTextSelection]] [[ctrlSetText]]
}}
}}
{{GameCategory|arma3|Scripting Commands}}

Latest revision as of 11:30, 4 May 2022

Hover & click on the images for description

Description

Description:
Selects length characters of edit control from the start position and places cursor at the end of selection.
To only move the cursor, set length to 0. To select text from right to left, use negative length (See ctrlTextSelection for more info)
Groups:
GUI Control

Syntax

Syntax:
control ctrlSetTextSelection [start, length]
Parameters:
control: Control
start: Number - selection start position
length: Number - length of characters to select (0 to only move the cursor). Negative length will select text from right to left (see example 3)
Return Value:
Nothing

Examples

Example 1:
_control ctrlSetTextSelection [5, 10];
Example 2:
disableSerialization; private _ctrl = findDisplay 46 createDisplay "RscDisplayEmpty" ctrlCreate ["RscEditMulti", -1]; _ctrl ctrlSetPosition [0,0,0.5,0.3]; _ctrl ctrlCommit 0; _ctrl ctrlSetText "Hello World"; _ctrl ctrlSetTextSelection [6, 5]; // selects World ctrlSetFocus _ctrl;
Example 3:
Select text from right to left:
_control ctrlSetTextSelection [5, -4];

Additional Information

See also:
ctrlTextSelection ctrlSetText

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