uitree

Создайте древовидный компонент

Описание

t = uitree создает дерево в новом окне рисунка и возвращает Tree объект. MATLAB® вызывает uifigure функция, чтобы создать фигуру.

пример

t = uitree(Name,Value) задает Tree значения свойств с помощью одного или нескольких Name,Value парные аргументы.

t = uitree(parent) создает дерево в заданном родительском контейнере. Родительским элементом может быть Figure созданное использование uifigure функция или один из ее дочерних контейнеров.

пример

t = uitree(parent,Name,Value) создает дерево в заданном контейнере и устанавливает один или несколько Tree значения свойств.

Примеры

свернуть все

Создайте дерево, которое содержит один узел под названием Sample Data.

t = uitree('Position',[20 20 150 150]);
node = uitreenode(t,'Text','Sample Data');

Создайте программный файл под названием mytreeapp.m это содержит следующие команды, чтобы создать дерево, набор вложенных древовидных узлов и функцию обратного вызова для дерева. SelectionChangedFcn свойство задает функцию, чтобы выполниться, когда пользователь кликает по узлу в дереве.

function mytreeapp
    fig = uifigure;
    t = uitree(fig,'Position',[20 20 150 150]);

    % Assign Tree callback in response to node selection
    t.SelectionChangedFcn = @nodechange;

    % First level nodes
    category1 = uitreenode(t,'Text','Runners','NodeData',[]);
    category2 = uitreenode(t,'Text','Cyclists','NodeData',[]);

    % Second level nodes.
    % Node data is age (y), height (m), weight (kg)
    p1 = uitreenode(category1,'Text','Joe','NodeData',[40 1.67 58] );
    p2 = uitreenode(category1,'Text','Linda','NodeData',[49 1.83 90]);
    p3 = uitreenode(category2,'Text','Rajeev','NodeData',[25 1.47 53]);
    p4 = uitreenode(category2,'Text','Anne','NodeData',[88 1.92 100]);

    % Expand the tree
    expand(t);
    
    function nodechange(src,event)
        node = event.SelectedNodes;
        display(node.NodeData);
    end
end

Когда пользователь запускает mytreeapp и кликает по узлу в дереве, MATLAB отображает NodeData для того узла.

Входные параметры

свернуть все

Родительский контейнер в виде Figure объект создал использование uifigure функция или один из ее дочерних контейнеров: TabПанельГруппа кнопок, или GridLayout. Если вы не задаете родительский контейнер, MATLAB вызывает uifigure функция, чтобы создать новый Figure объект, который служит родительским контейнером.

Аргументы в виде пар имя-значение

Пример: t = uitree('Position',[100 100 150 150]) создает дерево с определенным местоположением и размером.

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в одинарных кавычках (' '). Можно задать несколько имен и аргументов пары значения как Name1,Value1,...,NameN,ValueN.

Свойства, перечисленные здесь, являются подмножеством. Для полного списка см. Свойства объекта Tree.

Выбранные узлы в виде TreeNode возразите или массив TreeNode объекты. Используйте это свойство получить или установить выбранные узлы в дереве.

Чтобы позволить пользователям выбирать несколько узлов, установите Multiselect свойство к 'on'. MATLAB всегда возвращает SelectedNodes как вектор-столбец, когда дерево имеет несколько выбранных узлов.

Несколько выбор узла в виде 'off' или 'on', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

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

Выбор изменил коллбэк в виде одного из этих значений:

  • Указатель на функцию.

  • Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Используйте эту функцию обратного вызова, чтобы выполнить команды, когда пользователь выберет различный узел в дереве.

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с деревом, таким как выбранные узлы. MATLAB передает эту информацию в SelectedNodesChangedData возразите в качестве второго аргумента против своей функции обратного вызова. В App Designer аргумент называется событиемВы можете запросить свойства объекта с помощью записи через точку. Например, event.SelectedNodes возвращает выбранный TreeNode объект или объекты. SelectedNodesChangedData объект не доступен для функций обратного вызова, заданных как векторы символов.

Следующая таблица описывает свойства SelectedNodesChangedData объект.

Свойство

Описание

SelectedNodes

Последний раз выбрал TreeNode объект или объекты

PreviousSelectedNodes

Ранее выбрал TreeNode объект или объекты

Source

Компонент, который выполняет обратный вызов

EventName

'SelectionChanged'

Для получения дополнительной информации о записи коллбэков, смотрите Коллбэки Записи в App Designer.

Местоположение и размер в виде четырехэлементного вектора из формы [left bottom width height]В этой таблице описываются каждый элемент в векторе. Все измерения указаны в пикселях.

ЭлементОписание
leftРасстояние от внутреннего левого края родительского контейнера к левому краю ограничительной рамки, которая заключает дерево
bottomРасстояние от внутреннего базового края родительского контейнера к базовому краю ограничительной рамки, которая заключает дерево
widthРасстояние между правыми и левыми ребрами ограничительной рамки
heightРасстояние между верхними и нижними ребрами ограничительной рамки

Введенный в R2017b