BIS_fnc_initListNBoxSorting

Game1 needed - Version1 needed

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 controlContent
  • The amount of columns and their size should be identical with the ones of controlContent.
  • 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 ones 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