CheckBoxTree Properties

Флажок Управление внешним видом и поведением дерева

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

Например, этот код создает базовое дерево флажков с двумя вложенными узлами, сохраняет CheckBoxTree объект как cbt, и затем устанавливает CheckedNodes свойство с использованием записи через точку.

fig = uifigure;
cbt = uitree(fig,'checkbox');
n1 = uitreenode(cbt);
n1.Text = 'Node 1';
n2 = uitreenode(n1);
n2.Text = 'Node 2';
cbt.CheckedNodes = [n1 n2];

Дополнительные примеры создания и настройки деревьев флажков см. в uitree.

Узлы

расширить все

Проверенные узлы, заданные как TreeNode объект или массив TreeNode объекты. Используйте это свойство для программного получения или установки проверенных узлов в дереве флажков.

Если CheckedNodes содержит родительский узел, все дочерние узлы родительского узла автоматически добавляются в CheckedNodes. Если CheckedNodes содержит все дочерние элементы родительского узла, родительский узел автоматически добавляется в CheckedNodes.

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

В компоненте пользовательского интерфейса дерева флажков выбранный узел обозначается синей подсветкой.

Шрифт и цвет

расширить все

Название шрифта, заданная как поддерживаемая системой название шрифта. Шрифт по умолчанию зависит от конкретной операционной системы и локали.

Если указанный шрифт недоступен, то MATLAB® использует лучшие шрифты из всех шрифтов, доступных в той системе, в которой работает приложение.

Пример: 'Arial'

Размер шрифта, заданный в виде положительного числа. Единицами измерения являются пиксели. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали.

Пример: 14

Толщина шрифта, заданный как одно из следующих значений:

  • 'normal' - Вес по умолчанию, определяемый конкретным шрифтом

  • 'bold' - более тонкие контуры символов, чем 'normal'

Не все шрифты имеют полужирный шрифт вес. Поэтому установка полужирного шрифта веса может привести к нормальной толщине шрифта.

Угол шрифта, заданный как 'normal' или 'italic'. Установка значения свойства italic выбирает наклонную версию шрифта, если она доступна в системе пользователя приложения.

Цвет шрифта, заданный как триплет RGB, шестнадцатеричный цветовой код или один из опций, перечисленных в таблице.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для определения пользовательских цветов.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный код цвета - это вектор символов или строковый скаляр, который начинается с хэш-символа (#), за которым следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 на F. Значения не зависят от регистра. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' являются эквивалентными.

Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены именованные опции цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Цвет фона, заданный как триплет RGB, шестнадцатеричный цветовой код или один из опций, перечисленных в таблице.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для определения пользовательских цветов.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный код цвета - это вектор символов или строковый скаляр, который начинается с хэш-символа (#), за которым следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 на F. Значения не зависят от регистра. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' являются эквивалентными.

Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены именованные опции цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Интерактивность

расширить все

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

  • 'on' - Отобразите объект.

  • 'off' - Скрыть объект, не удаляя его. Вы по-прежнему можете получить доступ к свойствам невидимого компонента пользовательского интерфейса.

Чтобы ускорить запуск приложения, установите Visible свойство к 'off' для всех компонентов пользовательского интерфейса, которые не должны появляться при запуске.

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

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

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

  • Если вы задаете это свойство равным 'on'пользователь приложения может взаимодействовать с деревом и его узлами.

  • Если вы задаете это свойство равным 'off'компонент появляется затемненным, что указывает на то, что пользователь приложения не может взаимодействовать с ним или его узлами и что он не будет запускать коллбэк.

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

Подсказка, заданная как вектор символов, массив ячеек из векторов символов, строковые массивы или 1-D категориальный массив. Используйте это свойство для отображения сообщения при наведении указателя мыши на компонент во время выполнения. Подсказка отображается, даже когда компонент отключен. Чтобы отобразить несколько линии текста, задайте массив ячеек из векторов символов или строковые массивы. Каждый элемент массива становится отдельной строкой текста. Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.

Контекстное меню, заданное как ContextMenu объект, созданный с использованием uicontextmenu функция. Используйте это свойство для отображения контекстного меню при щелчке правой кнопкой мыши по компоненту.

Положение

расширить все

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

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

Расположение и размер, заданные как четырехэлементный вектор формы, [left bottom width height]. Значения в векторе относятся к родительскому контейнеру. Все измерения указаны в пикселях модулей. Это значение свойства идентично Position свойство.

Это свойство доступно только для чтения.

Расположение и размер, возвращенные как четырехэлементный вектор формы, [left bottom width height]. Значения в векторе относятся к родительскому контейнеру. Все измерения указаны в пикселях модулей. Это значение свойства идентично Position свойство.

Опции размещения, заданные как GridLayoutOptions объект. Это свойство задает опции для компонентов, являющихся дочерними элементами контейнеров размещения сетки. Если компонент не является дочерним элементом контейнера сетки размещения (для примера он является дочерним элементом рисунка или панели), то это свойство пустое и не имеет эффекта. Однако, если компонент является дочерним элементом контейнера размещения сетки, можно поместить компонент в нужную строку и столбец сетки путем установки Row и Column свойства на GridLayoutOptions объект.

Например, этот код помещает дерево флажков в третью строку и второй столбец его родительской сетки.

g = uigridlayout([4 3]);
cbt = uitree(g,'checkbox');
cbt.Layout.Row = 3;
cbt.Layout.Column = 2;

Чтобы дерево охватывало несколько строк или столбцов, задайте Row или Column свойство как двухэлементный вектор. Для примера это дерево охватывает столбцы 2 через 3:

cbt.Layout.Column = [2 3];

Коллбэки

расширить все

Проверенные узлы изменили коллбэк, заданный как одно из следующих значений:

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

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

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

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

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

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

Свойство

Описание

CheckedNodes

Проверенные TreeNode объекты

PreviousCheckedNodes

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

IndeterminateCheckedNodes

Родительские TreeNode объекты, которые в настоящее время имеют как проверенные, так и не проверенные дочерние объекты

PreviousIndeterminateCheckedNodes

Родительские TreeNode объекты, которые ранее проверяли и не проверяли дочерние объекты

LeafCheckedNodes

Проверенные TreeNode объекты без дочерних узлов

PreviousLeafCheckedNodes

Ранее проверенные TreeNode объекты без дочерних узлов

ParentCheckedNodes

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

PreviousParentCheckedNodes

Ранее проверенные TreeNode объекты с дочерними узлами

Source

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

EventName

'CheckedNodesChanged'

Свойства, которые возвращают список узлов, возвращают их в иерархическом порядке. Для примера, CheckedNodes свойство сначала приводит список всех проверенных узлов на первом уровне дерева в том порядке, в котором они появляются в компоненте дерева. Затем в нем перечисляются все проверенные узлы на втором уровне дерева, снова в том порядке, в котором они появляются. Этот шаблон продолжается до тех пор, пока, наконец, он не опишет узлы на последнем уровне дерева. Это соответствует порядку, в котором findall функция возвращает узлы в.

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

Выбор изменил коллбэк, заданный как одно из следующих значений:

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

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

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

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

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

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

Свойство

Описание

SelectedNodes

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

PreviousSelectedNodes

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

Source

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

EventName

'SelectionChanged'

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

Коллбэк узла, заданный как одно из следующих значений:

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

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

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

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

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

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

Свойство

Описание

Node

TreeNode объект, который расширил пользователь

Source

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

EventName

'NodeExpanded'

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

Узел свернул коллбэк, заданный как одно из следующих значений:

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

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

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

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

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

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

Свойство

Описание

Node

TreeNode объект, который свернул пользователь

Source

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

EventName

'NodeCollapsed'

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

Текст узла изменил коллбэк, заданный как одно из следующих значений:

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

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

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

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

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

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

Свойство

Описание

Node

TreeNode объект, который изменил текст

Text

Новый текст узла

PreviousText

Предыдущий текст узла

Source

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

EventName

'NodeTextChanged'

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

Функция создания объектов, заданная в качестве одного из следующих значений:

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

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

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

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

Это свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB создает объект. MATLAB инициализирует все значения свойств перед выполнением CreateFcn коллбэк. Если вы не задаете CreateFcn свойство, затем MATLAB выполняет функцию создания по умолчанию.

Установка CreateFcn свойство в существующем компоненте не имеет никакого эффекта.

Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к объекту, который создается с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo функция для доступа к объекту.

Функция удаления объектов, заданная в качестве одного из следующих значений:

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

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

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

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

Это свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB удаляет объект. MATLAB выполняет DeleteFcn коллбэк перед уничтожением свойств объекта. Если вы не задаете DeleteFcn свойство, затем MATLAB выполняет функцию удаления по умолчанию.

Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к удаляемому объекту с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo функция для доступа к объекту.

Контроль выполнения обратного вызова

расширить все

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

Это свойство определяет, можно ли прерывать выполняемый коллбэк. Существует два состояния коллбэка:

  • Обратный коллбэк running - это актуальный на данный момент коллбэк.

  • Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.

Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк (если он существует). The Interruptible свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание.

  • Значение 'on' позволяет другим коллбэкам прерывать коллбэки объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, когда есть drawnow, figure, uifigure, getframe, waitfor, или pause команда.

    • Если текущий коллбэк содержит одну из этих команд, MATLAB останавливает выполнение коллбэка в этой точке и выполняет прерывание обратного вызова MATLAB возобновляет выполнение текущего коллбэка после завершения прерывания обратного вызова.

    • Если текущий коллбэк не содержит одну из этих команд, MATLAB завершает выполнение коллбэка без прерывания.

  • Значение 'off' блокирует все попытки прерывания. The BusyAction свойство объекта, имеющего прерывание обратного вызова, определяет, отменяется ли прерывание обратного вызова или помещается в очередь.

Примечание

Прерывание и выполнение коллбэка происходят по-разному в таких ситуациях:

  • Если прерывание обратного вызова является DeleteFcn, CloseRequestFcn или SizeChangedFcn коллбэк, тогда прерывание происходит независимо от Interruptible значение свойства.

  • Если текущий коллбэк выполняющегося в данного момента, waitfor function, тогда прерывание происходит независимо от Interruptible значение свойства.

  • Timer объекты выполняются в соответствии с расписанием независимо от Interruptible значение свойства.

Когда происходит прерывание, MATLAB не сохраняет состояние свойств или отображения. Для примера, объект, возвращенный gca или gcf команда может измениться при выполнении другого коллбэка.

Постановка в очередь коллбэков, заданная как 'queue' или 'cancel'. The BusyAction свойство определяет, как MATLAB обрабатывает выполнение прерываний обратного вызова. Существует два состояния коллбэка:

  • Обратный коллбэк running - это актуальный на данный момент коллбэк.

  • Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.

Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк. The Interruptible свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, имеющего прерывание обратного вызова, определяет, будет ли оно сброшено или помещено в очередь. Это возможные значения BusyAction свойство:

  • 'queue' - помещает прерывание обратного вызова в очередь вызовов, подлежащих обработке после концов обратного коллбэка.

  • 'cancel' - Не выполняет прерывание обратного вызова.

Это свойство доступно только для чтения.

Статус удаления, возвращенный как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство к 'on' когда DeleteFcn коллбэк начинает выполняться. The BeingDeleted свойство остается установленным на 'on' пока объект компонента не перестанет существовать.

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

Родитель/ребенок

расширить все

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

Дети, возвращенные как массив TreeNode объекты.

Вы не можете добавить или удалить дочерние элементы, используя Children свойство, но вы можете использовать свойство для просмотра списка дочерних элементов. Порядок дочерних узлов отражает порядок дочерних узлов, отображаемых на экране. Чтобы добавить дочерний элемент в этот список, установите Parent свойство дочернего компонента, которое должно быть Tree объект.

Чтобы переупорядочить дочерние элементы, используйте move функция.

Объекты с HandleVisibility значение свойства установлено в 'off' не указаны в Children свойство.

Видимость указателя на объект, заданная как 'on', 'callback', или 'off'.

Это свойство контролирует видимость объекта в его родительский список дочерних элементов. Когда объект не отображается в родительский список дочерних элементов, он не возвращается с помощью функций, которые получают объекты, просматривая иерархию объектов или запрашивая свойства. Эти функции включают get, findobj, clf, и close. Объекты действительны, даже если они не видны. Если вы можете получить доступ к объекту, можно задать и получить его свойства, и передать его в любую функцию, которая работает с объектами.

Значение HandleVisibilityОписание
'on'Объект всегда отображается.
'callback'Объект виден из обратных коллбэков или функций, вызываемых коллбэками, но не из функций, инициируемых из командной строки. Эта опция блокирует доступ к объекту в командной строке, но позволяет функциям обратного вызова обращаться к нему.
'off'Объект невидим в любое время. Эта опция используется для предотвращения непреднамеренных изменений пользовательского интерфейса другой функцией. Установите HandleVisibility на 'off' временно скрыть объект во время выполнения этой функции.

Идентификаторы

расширить все

Это свойство доступно только для чтения.

Тип графического объекта, возвращенный как 'uicheckboxtree'.

Идентификатор объекта, заданный как вектор символов или строковый скаляр. Можно задать уникальное Tag значение, которое служит идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте вашего кода, вы можете использовать findobj функция для поиска объекта на основе Tag значение.

Пользовательские данные, заданные как любой массив MATLAB. Для примера можно задать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Используйте это свойство для хранения произвольных данных на объекте.

Если вы работаете в App Designer, создайте общие или частную собственность в приложении, чтобы делиться данными вместо использования UserData свойство. Для получения дополнительной информации см. раздел «Обмен данными в приложениях App Designer».

См. также

Функции

Введенный в R2021a
Для просмотра документации необходимо авторизоваться на сайте