ctrlTextWidth: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (Text replacement - "Category:Eden Editor" to "Eden Editor")
 
(69 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 1.78


|1.78|= Game version
|gr1= GUI Control
____________________________________________________________________________________________


| Returns the control text width. Supported control [[ctrlType|types]] are:
|descr= Returns the width of the control text including left and right margins (0.008 each). Supported control [[ctrlType|types]] are:
* [[DialogControls-Text|CT_STATIC]] 0
{{Columns|2|
* [[DialogControls-EditBox|CT_EDIT]] 2
* [[CT_STATIC]] 0
* [[DialogControls-Text|CT_STRUCTURED_TEXT]] 13 |= Description
* [[CT_EDIT]] 2
____________________________________________________________________________________________
* [[CT_STRUCTURED_TEXT]] 13
* {{GVI|arma3|2.06|size= 0.75}} [[CT_XKEYDESC]] 40
* {{GVI|arma3|2.06|size= 0.75}} [[CT_XBUTTON]] 41
* {{GVI|arma3|2.06|size= 0.75}} [[CT_SHORTCUTBUTTON]] 16
* {{GVI|arma3|2.06|size= 0.75}} [[CT_BUTTON]] 1
* {{GVI|arma3|2.06|size= 0.75}} [[CT_ACTIVETEXT]] 11
}}
{{Feature|informative|For control-independent text width estimate see [[getTextWidth]].}}


| '''ctrlTextWidth''' control |= Syntax
|s1= [[ctrlTextWidth]] control


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


| [[Number]] |RETURNVALUE=
|r1= [[Number]]


|x1= <sqf>private _w = ctrlTextWidth _ctrl;</sqf>


|x1= <code>_w = [[ctrlTextWidth]] _ctrl;</code>|EXAMPLE1=
|seealso= [[getTextWidth]] [[ctrlTextHeight]] [[ctrlSetText]] [[ctrlType]] [[Arma: GUI Configuration]]
}}


____________________________________________________________________________________________
{{Note
|user= R3vo
|timestamp= 20201028221000
|text= When working with multiline controls [[ctrlTextWidth]] or [[getTextWidth]] will not return a proper value since the text will be treated as one long line.<br>


| [[ctrlTextHeight]], [[ctrlSetText]], [[ctrlType]], [[Dialog Control]] |SEEALSO=
'''Solution (Execute in [[:Category:Eden Editor|Eden Editor]]):'''


|  |MPBEHAVIOUR=
<sqf>
____________________________________________________________________________________________
disableSerialization;
}}


<h3 style='display:none'>Notes</h3>
private _display = findDisplay 313 createDisplay "RscDisplayEmpty";
<dl class='command_description'>
<!-- Note Section BEGIN -->


<!-- Note Section END -->
private _edit = _display ctrlCreate ["RscEditMulti", -1];
</dl>
_edit ctrlSetPosition [0,0,1,1];
_edit ctrlSetBackgroundColor [0,0,0,1];
_edit ctrlSetFont "EtelkaMonospacePro";
_edit ctrlSetFontHeight 0.03;
_edit ctrlCommit 0;


<h3 style='display:none'>Bottom Section</h3>
private _longestLineWidth = 0;
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
private _exampleString = "abcdefghijklmnopqrstuvxyz0134567890";
[[Category:Arma 3: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
private _text = "";
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
for "_lines" from 1 to 400 do // loop through all lines and find the longest one
{
_lineText = _exampleString select [round random 35];
_longestLineWidth = _longestLineWidth max (_lineText getTextWidth ["EtelkaMonospacePro", 0.03]);
_text = _text + _lineText + endl;
};


<!-- DISCONTINUE Notes -->
_edit ctrlSetPositionW (_longestLineWidth + 2 * 0.008); // width of longest line + left and right margin set in engine
_edit ctrlCommit 0;
_edit ctrlSetText _text;
</sqf>
}}

Latest revision as of 13:26, 9 July 2023

Hover & click on the images for description

Description

Description:
Returns the width of the control text including left and right margins (0.008 each). Supported control types are:
For control-independent text width estimate see getTextWidth.
Groups:
GUI Control

Syntax

Syntax:
ctrlTextWidth control
Parameters:
control: Control
Return Value:
Number

Examples

Example 1:
private _w = ctrlTextWidth _ctrl;

Additional Information

See also:
getTextWidth ctrlTextHeight ctrlSetText ctrlType Arma: GUI Configuration

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
R3vo - c
Posted on Oct 28, 2020 - 22:10 (UTC)
When working with multiline controls ctrlTextWidth or getTextWidth will not return a proper value since the text will be treated as one long line.
Solution (Execute in Eden Editor):
disableSerialization; private _display = findDisplay 313 createDisplay "RscDisplayEmpty"; private _edit = _display ctrlCreate ["RscEditMulti", -1]; _edit ctrlSetPosition [0,0,1,1]; _edit ctrlSetBackgroundColor [0,0,0,1]; _edit ctrlSetFont "EtelkaMonospacePro"; _edit ctrlSetFontHeight 0.03; _edit ctrlCommit 0; private _longestLineWidth = 0; private _exampleString = "abcdefghijklmnopqrstuvxyz0134567890"; private _text = ""; for "_lines" from 1 to 400 do // loop through all lines and find the longest one { _lineText = _exampleString select [round random 35]; _longestLineWidth = _longestLineWidth max (_lineText getTextWidth ["EtelkaMonospacePro", 0.03]); _text = _text + _lineText + endl; }; _edit ctrlSetPositionW (_longestLineWidth + 2 * 0.008); // width of longest line + left and right margin set in engine _edit ctrlCommit 0; _edit ctrlSetText _text;