ctrlSetTextSelection: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (2.00 update)
m (Text replacement - "<tt>([a-zA-Z0-9\. _"']+)<\/tt>" to "{{hl|$1}}")
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 2.00


|2.00 |Game version=
|gr1= GUI Control


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


|Selects <tt>length</tt> characters of edit control from the <tt>start</tt> position and places cursor at the end of selection.
|s1= control [[ctrlSetTextSelection]] [start, length]
{{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)}} |DESCRIPTION=
____________________________________________________________________________________________


| control [[ctrlSetTextSelection]] [start, length] |SYNTAX=
|p1= control: [[Control]]


|p1= control: [[Control]] |PARAMETER1=
|p2= [start, length]: [[Array]]
|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)


|p2= [start, length]: [[Array]] |PARAMETER2=
|r1= [[Nothing]]
|p3= start: [[Number]] - selection start position |PARAMETER3=
|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) |PARAMETER4=


| [[Nothing]] |RETURNVALUE=
|x1= <code>_control [[ctrlSetTextSelection]] [5, 10]</code>
 
____________________________________________________________________________________________
 
|x1= <code>_control [[ctrlSetTextSelection]] [5, 10]</code>|EXAMPLE1=


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


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


|seealso= [[ctrlTextSelection]] [[ctrlSetText]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]

Revision as of 00:44, 16 November 2021

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 move cursor only, 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, length]: Array
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