ListView

Описание

Область с вертикальной прокруткой, которая создает визуальные элементы только для видимых элементов, позволяя привязывать гораздо больше элементов. По мере прокрутки пользователем визуальные элементы перерабатываются и привязываются к новым элементам данных.

using System; using System.Collections.Generic;

using UnityEditor; using UnityEngine; using UnityEngine.UIElements;

namespace UIElementsExamples { public class ListViewExampleWindow : EditorWindow { [MenuItem("Window/ListViewExampleWindow")] public static void OpenDemoManual() { GetWindow().Show(); }

public void OnEnable() { // Создаем список данных, здесь просто числа в интервале [1, 1000] const int itemCount = 1000; var items = new List(itemCount); for (int i = 1; i <= itemCount; i++) items.Add(i.ToString());

// Функция makeItem будет вызываться по мере необходимости // когда the ListView требуется больше элементов для рендера Func<VisualElement> makeItem = () => new Label();

// Когда пользователь прокручивает список объектов ListView // будет перерабатывать элементы, созданные "makeItem" // и вызывать обратный вызов "bindItem", чтобы связать // элемент с соответствующим элементом данных (указанный как индекс в списке) Action<VisualElement, int> bindItem = (e, i) => (e as Label).text = items[i];

// Предоставляем списковому представлению явную высоту для каждой строки // чтобы он мог рассчитать, сколько элементов нужно отобразить на самом деле const int itemHeight = 16;

var listView = new ListView(items, itemHeight, makeItem, bindItem);

listView.selectionType = SelectionType.Multiple;

listView.onItemChosen += obj => Debug.Log(obj); listView.onSelectionChanged += objects => Debug.Log(objects);

listView.style.flexGrow = 1.0f;

rootVisualElement.Add(listView); } } }

Статические Свойства

borderUssClassName	Имя класса USS. Включите свойство showBorder, чтобы применить этот класс к ListView.
dragHoverBarUssClassName	Имя класса USS для полосы перетаскивания.
itemAlternativeBackgroundUssClassName	Имя класса USS для нечетных строк в ListView.
itemDragHoverUssClassName	Имя класса USS, которое применяется к элементу при перетаскивании.
itemSelectedVariantUssClassName	Имя класса USS элементов элемента в элементах этого типа, когда они выбраны.
itemUssClassName	Имя класса USS элементов элемента в элементах этого типа.
ussClassName	Имя класса USS для элементов этого типа.

Свойства

bindItem	Обратный вызов для привязки элемента данных к визуальному элементу.
horizontalScrollingEnabled	Этот флаг указывает, должен ли ListView отображать горизонтальную полосу прокрутки, когда его содержимое не помещается. Значение по умолчанию неверно.
itemHeight	ListView требует, чтобы все визуальные элементы имели одинаковую высоту, чтобы он мог вычислить разумный размер прокрутки. Это свойство должно быть установлено для работы представления списка.
itemsSource	Источник данных товаров. Это свойство должно быть установлено для работы представления списка.
makeItem	Обратный вызов для построения VisualElement, который будет служить шаблоном для каждого повторно используемого и повторно связанного элемента в списке. Это свойство должно быть установлено для работы представления списка.
reorderable	Получает или задает значение, указывающее, может ли пользователь перетаскивать элементы списка, чтобы изменить их порядок.
resolvedItemHeight	Вычисленная высота с выравниванием по пикселям для элементов списка. Это значение будет меняться в зависимости от масштабирования текущей панели в dpi. Смотрите так же: ListView.itemHeight.
selectedIndex	Возвращает индекс выбранного элемента в источнике элементов. Если выбрано несколько элементов, возвращает индекс первого выбранного элемента.
selectedIndices	Индексы выбранных элементов в источнике элементов.
selectedItem	Возвращает выбранный элемент из источника элементов. Если выбрано несколько элементов, возвращает первый выбранный элемент.
selectedItems	Выбранные элементы из источника элементов.
selectionType	Управляет состоянием выбора. Вы можете установить состояние для отключения выбора, иметь один выбираемый элемент или иметь несколько выбираемых элементов.
showAlternatingRowBackgrounds	Включает это свойство, чтобы отображать чередующиеся цвета фона для строк в ListView.
showBorder	Включает это свойство, чтобы отобразить границу вокруг ListView.
showBoundCollectionSize	Когда вы привязываете представление списка к массиву, это свойство определяет, будет ли представление списка отображать размер коллекции в качестве первого элемента списка. Установите значение true, чтобы отобразить размер коллекции, и значение false, чтобы пропустить его. Значение по умолчанию - true. Смотрите так же: UnityEditor.UIElements.BindingExtensions.Bind
unbindItem	Обратный вызов для отвязки элемента данных от визуального элемента.

Публичные Методы

AddToSelection	Добавляет элемент в коллекцию выбранных элементов.
ClearSelection	Отменяет выбор любых выбранных элементов.
Refresh	Очищает, воссоздайте все видимые визуальные элементы и заново привяжите все элементы. Это должно вызываться всякий раз, когда изменяется источник элементов..
RemoveFromSelection	Удаляет элемент из коллекции выбранных элементов.
ScrollTo	Прокручивает до определенного визуального элемента.
ScrollToItem	Прокручивает до определенного индекса элемента и сделайте его видимым.
SetSelection	Устанавливает текущий выбранный элемент.
SetSelectionWithoutNotify	Устанавливает коллекцию выбранных элементов без запуска обратного вызова изменения выбора.

События

onItemChosen	Обратный вызов при выборе элемента (двойной щелчок). Это отличается от простого выбора.
onItemsChosen	Обратный вызов запускается, когда пользователь «воздействует» на выбор одного или нескольких элементов, например, дважды щелкнув или нажав Enter.
onSelectionChange	Обратный вызов срабатывает при изменении выбора.
onSelectionChanged	Обратный вызов срабатывает при изменении выбора.