UE3:UIComp_ListElementSorter (UT3)

From Unreal Wiki, The Unreal Engine Documentation Site
UT3 Object >> Component >> UIComponent >> UIComp_ListComponentBase >> UIComp_ListElementSorter
Package:
Engine
Within class:
UIList
This class in other games:

Handles information about a collection of list elements are sorted. Responsible for invoking the UISortableItem on each element to allow the element to perform the comparison. Copyright 1998-2007 Epic Games, Inc. All Rights Reserved.

Properties

Property group 'UIComp_ListElementSorter'

bAllowCompoundSorting

Type: bool

Indicates whether sorting by multiple columns is allowed in this list

Default value: True

bReversePrimarySorting

Type: bool

indicates that the primary sort column should be sorted in reverse order

bReverseSecondarySorting

Type: bool

indicates that the secondary sort column should be sorted in reverse order

InitialSecondarySortColumn

Type: int

the index of the column (or row) to use for performing the initial secondary sorting of the list's elements when SecondarySortColumn is INDEX_NONE

Default value: -1

InitialSortColumn

Type: int

the index of the column (or row) to use for sorting the list's elements when SortColumn is INDEX_NONE

Default value: -1

PrimarySortColumn

Type: int

Modifiers: editconst, transient, const

the index of the column (or row) being used for sorting the list's items

Default value: -1

SecondarySortColumn

Type: int

Modifiers: editconst, transient, const

the index of the column (or row) of the previous SortColumn

Default value: -1

Structs

UIListSortingParameters

Modifiers: native, transient

Contains parameters for a list sorting operation.

int PrimaryIndex
the index of the column/row that should be used for first-pass sorting
int SecondaryIndex
the index of the column/row that should be used when first pass sorting encounters two identical elements
bool bReversePrimarySorting
indicates that the elements should be sorted in reverse for first-pass
bool bReverseSecondarySorting
indicates that the elements should be sorted in reverse for second-pass
bool bCaseSensitive
indicates that sorting should be case sensitive
bool bIntSortPrimary
indicates that the strings should be converted into integers for sorting purposes
bool bIntSortSecondary
bool bFloatSortPrimary
indicates that the strings should be converted into floats for sorting purposes
bool bFloatSortSecondary

Native functions

ResetSortColumns

native final function ResetSortColumns (optional bool bResort)

Resets the PrimarySortColumn and SecondarySortColumn to the Initial* values.

Parameters:

  • bResort - specify TRUE to re-sort the list's elements after resetting the sort columns.

ResortItems

native final function bool ResortItems (optional bool bCaseSensitive)

Sorts the owning list's items without modifying any sorting parameters.

Parameters:

  • bCaseSensitive - specify TRUE to perform case-sensitive comparison

Returns:

TRUE if the items were sorted successfully.

SortItems

native final function bool SortItems (int ColumnIndex, optional bool bSecondarySort, optional bool bCaseSensitive)

Sorts the owning list's items using the parameters specified.

Parameters:

  • ColumnIndex - the column (when CellLinkType is LINKED_Columns) or row (when CellLinkType is LINKED_Rows) to use for sorting. Specify INDEX_NONE to clear sorting.
  • bSecondarySort - specify TRUE to set ColumnIndex as the SecondarySortColumn. If FALSE, resets the value of SecondarySortColumn
  • bCaseSensitive - specify TRUE to perform case-sensitive comparison

Returns:

TRUE if the items were sorted successfully.