ItemList¶
Inherits: Control < CanvasItem < Node < Object
A vertical list of selectable items with one or multiple columns.
Description¶
This control provides a vertical list of selectable items that may be in a single or in multiple columns, with each item having options for text and an icon. Tooltips are supported and may be different for every item in the list.
Selectable items in the list may be selected or deselected and multiple selection may be enabled. Selection with right mouse button may also be enabled to allow use of popup context menus. Items may also be "activated" by double-clicking them or by pressing Enter.
Item text only supports single-line strings. Newline characters (e.g. \n
) in the string won't produce a newline. Text wrapping is enabled in ICON_MODE_TOP mode, but the column's width is adjusted to fully fit its content by default. You need to set fixed_column_width greater than zero to wrap the text.
All set_*
methods allow negative item indices, i.e. -1
to access the last item, -2
to select the second-to-last item, and so on.
Incremental search: Like PopupMenu and Tree, ItemList supports searching within the list while the control is focused. Press a key that matches the first letter of an item's name to select the first item starting with the given letter. After that point, there are two ways to perform incremental search: 1) Press the same key again before the timeout duration to select the next item starting with the same letter. 2) Press letter keys that match the rest of the word before the timeout duration to match to select the item in question directly. Both of these actions will be reset to the beginning of the list if the timeout duration has passed since the last keystroke was registered. You can adjust the timeout duration by changing ProjectSettings.gui/timers/incremental_search_max_interval_msec.
Properties¶
|
||
|
||
|
||
|
||
clip_contents |
|
|
|
||
|
||
focus_mode |
|
|
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Methods¶
add_icon_item ( Texture2D icon, bool selectable=true ) |
|
add_item ( String text, Texture2D icon=null, bool selectable=true ) |
|
void |
clear ( ) |
void |
|
void |
deselect_all ( ) |
void |
|
get_item_at_position ( Vector2 position, bool exact=false ) const |
|
get_item_custom_bg_color ( int idx ) const |
|
get_item_custom_fg_color ( int idx ) const |
|
get_item_icon ( int idx ) const |
|
get_item_icon_modulate ( int idx ) const |
|
get_item_icon_region ( int idx ) const |
|
get_item_language ( int idx ) |