UQueryBuilder<T0>

Утилита Объект, который конструирует набор правил выбора для запуска на корневом визуальном элементе.

Обобщённый класс, позволяющий строить запросы к элементам интерфейса типа T. Запросы можно уточнять селекторами по имени, классу и другим условиям. Он позволяет искать элементы и выполнять запрос к любому VisualElement, упрощая навигацию и фильтрацию дерева VisualElement в крупных интерфейсах — по типу, имени, классу и условиям иерархии.

Дополнительную информацию см. в Страница инструкции UQuery.

В следующем примере показано, как использовать UQueryBuilder для поиска определенных элементов в иерархии UI и итерации над ними:

using UnityEngine;
using UnityEngine.UIElements;

public class UQueryBuilderExample : MonoBehaviour
{
    public UIDocument uiDocument;

    private void OnEnable()
    {
        // Get the root visual element
        var root = uiDocument.rootVisualElement;

        // Example query: Find all buttons with a specific class name
        var buttonQuery = new UQueryBuilder<Button>(root)
            .Class("my-button-class")
            .Build();

        // Iterate over those buttons and add click handlers
        buttonQuery.ForEach(button => button.clicked += () => OnButtonClick(button));

        // Another query: Find all labels that are descendants of elements with the class "container"
        var labelQuery = new UQueryBuilder<Label>(root)
            .Descendents<VisualElement>("container")
            .Build();

        // Change the text color of each label found
        labelQuery.ForEach(label => label.style.color = Color.green);
    }

    private void OnButtonClick(Button button)
    {
        Debug.Log($"Button with name {button.name} clicked.");
    }
}