BIS fnc initListNBoxSorting: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " it's" to "it is")
m (Text replacement - "[^ adhHkbgmnr(]it is " to "$1 it is ")
Line 16: Line 16:
** If a column of <tt>controlContent</tt> is supposed to be sorted by '''value''' instead of '''data''' (default), then something needs to be set in the data of corresponding <tt>controlFilter</tt> column
** If a column of <tt>controlContent</tt> is supposed to be sorted by '''value''' instead of '''data''' (default), then something needs to be set in the data of corresponding <tt>controlFilter</tt> column
** The control can also be part of a [[CT_CONTROLS_GROUP]], if that's the case, the buttons will be created as children of  that group
** The control can also be part of a [[CT_CONTROLS_GROUP]], if that's the case, the buttons will be created as children of  that group
** To keep a uniform style between vanilla controls and custom onesit is advisable to create a background with [[CT_STATIC]] behind the <tt>controlFilter</tt> with </tt>colorBackground[] {{=}} {0,0,0,1};</tt>}}
** To keep a uniform style between vanilla controls and custom one it is advisable to create a background with [[CT_STATIC]] behind the <tt>controlFilter</tt> with </tt>colorBackground[] {{=}} {0,0,0,1};</tt>}}
[[Image:A3_BIS_fnc_initListNBoxSorting_example.jpg|400px|thumb|center|Example GUI using this function]]
[[Image:A3_BIS_fnc_initListNBoxSorting_example.jpg|400px|thumb|center|Example GUI using this function]]



Revision as of 09:43, 18 January 2021

Hover & click on the images for description

Description

Description:
Automatically creates buttons and sets them up so they can be used to sort a CT_LISTNBOX. The buttons will automatically be resized to the column width of given controlFilter.
  • controlFilter
    • x, y, w and h define where the buttons for sorting are created
    • It should be placed above the controlFilter
    • The amount of columns and their size should be identical with the onces of controlFilter.
    • The text set in the columns is displayed as text for the buttons (The buttons are transparent actually). Icons which indicate how the list is currently sorted are also adjusted when the button is pressed.
    • If a column of controlContent is supposed to be sorted by value instead of data (default), then something needs to be set in the data of corresponding controlFilter column
    • The control can also be part of a CT_CONTROLS_GROUP, if that's the case, the buttons will be created as children of that group
    • To keep a uniform style between vanilla controls and custom one it is advisable to create a background with CT_STATIC behind the controlFilter with colorBackground[] = {0,0,0,1};
Example GUI using this function
Execution:
call
Groups:
GUI

Syntax

Syntax:
[controlFilter, controlContent, columnIndexes, idc] call BIS_fnc_initListNBoxSorting
Parameters:
controlFilter: Control - Dummy CT_LISTNBOX control used for setting up the filter. If parameter is controlNull function will show an error message.
controlContent: Control - The CT_LISTNBOX which actually contains the content. If parameter is controlNull function will show an error message.
columnIndexes: Array - Array of numbers. These are the indexes of the controlContent which should be filterable/sortable
idc: Number - (Optional, default 200) Will be used to assign idcs to the buttons which are automatically created. First button has idc, second button idc + 1 and so on
Return Value:
Boolean - true on success, otherwise false

Examples

Example 1:
[_lnbFilter, _lnbContent, [0,1,2,3]] call BIS_fnc_initListNBoxSorting;

Additional Information

See also:
BIS_fnc_initSliderValue

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