tvSortByValue: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(format)
mNo edit summary
 
(45 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 0.74


|0.74|= Game version
|gr1= GUI Control - Tree View
____________________________________________________________________________________________


| Sorts children of given item by [[tvValue]] from highest to lowest. IDC means id of parent Tree View.
|descr= Sorts all children of given path. Value of [[CT_TREE|Tree View]] entries is used for sorting. [[tvSetValue]] can be used to set the value for a given path.
<br>|= Description
____________________________________________________________________________________________


| control [[tvSortByValue]] [path, reversed] |= Syntax
|s1= control [[tvSortByValue]] [path, ascending]


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


| p2= [path, reversed]: [[Array]] |= PARAMETER2
|p2= path: [[Array]] - [[Tree View Path]] of the parent item to sort
| p3= path: [[Array]] - [[Tree View Path]] of the parent item to sort |= PARAMETER2
| p4= reversed (Optional): [[Boolean]] - [[true]] to reverse sort it. Default: [[false]]  |= PARAMETER2


| [[Nothing]] |= RETURNVALUE
|p3= ascending: [[Boolean]] - (Optional, default [[false]]) [[true]] to sort ascending, else descending


|s2 =[[tvSortByValue]] [idc, path, reversed] |= Syntax
|r1= [[Nothing]]


| p21= [idc, path, reversed]: [[Array]] |= PARAMETER2
|s2= [[tvSortByValue]] [idc, path, ascending]
| p22= idc: [[Number]] - control idc |= PARAMETER2
| p23= path: [[Array]] - [[Tree View Path]] of the parent item to sort |= PARAMETER2
| p24= reversed (Optional): [[Boolean]] - [[true]] to reverse sort it. Default: [[false]]  |= PARAMETER2


|r2= [[Nothing]] |= RETURNVALUE
|p21= idc: [[Number]] - control idc


|p22= path: [[Array]] - [[Tree View Path]] of the parent item to sort


|x1= <code>control [[tvSortByValue]] <nowiki>[</nowiki>[0], [[false]]];</code> |= Example 1
|p23= ascending: [[Boolean]] - (Optional) [[true]] to sort ascending, else descending. Default: [[false]]
|x2= <code>[[tvSortByValue]] [102, [0], [[false]]];</code> |= Example 1
____________________________________________________________________________________________


| [[lbSort]], [[lnbSort]], [[tvSort]], [[lbSortByValue]], [[lnbSortByValue]], [[tvAdd]], [[tvClear]], [[tvCollapse]], [[tvCount]], [[tvCurSel]], [[tvData]], [[tvDelete]], [[tvExpand]], [[tvPicture]], [[tvSetCurSel]], [[tvSetData]], [[tvSetPicture]], [[tvSetValue]], [[tvText]], [[tvValue]] |= See Also
|r2= [[Nothing]]


| |= MPBEHAVIOUR
|x1= <sqf>control tvSortByValue [[0], false];</sqf>
____________________________________________________________________________________________
}}


<h3 style='display:none'>Notes</h3>
|x2= <sqf>tvSortByValue [102, [0], false];</sqf>
<dl class='command_description'>
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|seealso= [[lbSortBy]] [[lnbSortBy]] [[tvSortAll]] [[tvSort]] [[tvSortByValueAll]]
</dl>
}}
 
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on May 24, 2015 - 22:02 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dd class="note">
Seems to only affect sorting of parent tree (path [])
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 21:55, 28 September 2023

Hover & click on the images for description

Description

Description:
Sorts all children of given path. Value of Tree View entries is used for sorting. tvSetValue can be used to set the value for a given path.
Groups:
GUI Control - Tree View

Syntax

Syntax:
control tvSortByValue [path, ascending]
Parameters:
control: Control
path: Array - Tree View Path of the parent item to sort
ascending: Boolean - (Optional, default false) true to sort ascending, else descending
Return Value:
Nothing

Alternative Syntax

Syntax:
tvSortByValue [idc, path, ascending]
Parameters:
idc: Number - control idc
path: Array - Tree View Path of the parent item to sort
ascending: Boolean - (Optional) true to sort ascending, else descending. Default: false
Return Value:
Nothing

Examples

Example 1:
control tvSortByValue [[0], false];
Example 2:
tvSortByValue [102, [0], false];

Additional Information

See also:
lbSortBy lnbSortBy tvSortAll tvSort tvSortByValueAll

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