exponenta event banner

Свойства TabGroup

Внешний вид и поведение группы вкладок управления в uifigureПриложения на основе

Группы вкладок являются контейнерами для группирования и управления вкладками. Свойства управляют внешним видом и поведением группы вкладок. Используйте точечную нотацию для ссылки на определенный объект и свойство.

fig = uifigure;
tg = uitabgroup(fig);
tg.Position = [20 20 200 200];

Перечисленные здесь свойства действительны для групп вкладок в App Designer или в приложениях, созданных с помощью uifigure функция. Для групп вкладок, используемых в GUIDE или в приложениях, созданных с помощью figure см. раздел Свойства TabGroup.

Счета

развернуть все

Расположение метки табуляции, указанное как 'top', 'bottom', 'left', или 'right'. Это свойство определяет расположение меток вкладок относительно группы вкладок.

Выбранная вкладка, заданная как Tab объект. Это свойство используется для определения выбранной вкладки в группе вкладок. Это свойство также можно использовать для установки выбора вкладки по умолчанию. Значение по умолчанию для SelectedTab свойство является первым Tab который вы добавляете в TabGroup.

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

развернуть все

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

  • 'on' - Просмотр объекта.

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

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

Изменение размера невидимого контейнера запускает SizeChangedFcn обратный вызов, когда он становится видимым.

Изменение Visible свойство контейнера не изменяет значения Visible свойств дочерних компонентов. Это верно, даже если скрытие контейнера приводит к скрытию дочерних компонентов.

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

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

Положение

развернуть все

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

В этой таблице описывается каждый элемент вектора.

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

Все измерения в единицах, указанных Units собственность.

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

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

Это значение свойства идентично значению Position и OuterPosition значения свойств.

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

Это значение свойства идентично значению Position и InnerPosition значения свойств.

Единицы измерения, указанные как 'pixels'.

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

  • 'on' - размер дочерних компонентов автоматически изменяется при изменении размера контейнера.

  • 'off' - Размер дочерних компонентов не изменяется.

AutoResizeChildren влияет на прямые нижестоящие элементы контейнера, а не на нижестоящие элементы внутри вложенных контейнеров.

Чтобы настроить поведение изменения размера, задайте AutoResizeChildren свойство для 'off' и создать SizeChangedFcn обратный вызов для контейнера. Дополнительные сведения см. в разделе Управление приложениями с изменяемым размером в App Designer.

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

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

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

g = uigridlayout([4 3]);
tg = uitabgroup(g);
tg.Layout.Row = 3;
tg.Layout.Column = 2;

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

tg.Layout.Column = [2 3];

Отзывы

развернуть все

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

  • Дескриптор функции.

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

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

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

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

В следующей таблице перечислены свойства SelectionChangedData объект.

Собственность

Описание

OldValue

Ранее выбранные Tab, или [] если ни один не был выбран

NewValue

Выбрано в данный момент Tab

Source

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

EventName

'SelectionChanged'

Дополнительные сведения о записи обратных вызовов см. в разделе Запись обратных вызовов в App Designer.

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

  • Дескриптор функции.

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

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

Определите этот обратный вызов для настройки макета приложения при изменении размера контейнера (например, при изменении размера окна пользователем). В нем запишите код, чтобы настроить Position свойства дочерних компонентов.

Примечание

SizeChangedFcn обратный вызов не будет выполняться, если AutoResizeChildren свойство этого контейнера имеет значение 'off'. В App Designer вы можете сделать SizeChangedFcn путем выбора контейнера и снятия флажка AutoResityChildren на вкладке «Инспектор» обозревателя компонентов.

SizeChangedFcn обратный вызов выполняется в следующих случаях:

  • Этот контейнер становится видимым впервые.

  • Этот контейнер отображается при изменении его размера.

  • Этот контейнер становится видимым впервые после изменения его размера. Эта ситуация возникает, когда размер изменяется, когда контейнер невидим, а затем становится видимым позже.

Другие важные моменты, которые следует учитывать при определении SizeChangedFcn обратный вызов:

  • Рассмотрите возможность задержки отображения этого контейнера до тех пор, пока не появятся все переменные, SizeChangedFcn Определены виды использования. Эта практика может предотвратить SizeChangedFcn обратный вызов при возврате ошибки. Чтобы задержать отображение контейнера, установите его Visible свойство для 'off'. Затем установите Visible свойство для 'on' после определения переменных, которые SizeChangedFcn использует обратный вызов.

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

  • Доступ к контейнеру, размер которого изменяется из SizeChangedFcn, см. исходный объект (первый входной аргумент в обратном вызове) или используйте gcbo функция.

Альтернативными способами определения поведения изменения размера являются создание GridLayout или используйте параметры автозаполнения в App Designer. Эти параметры проще использовать, чем SizeChangedFcn обратные вызовы. Однако есть некоторые преимущества, которые SizeChangedFcn обратные вызовы имеют эти опции. Например:

  • Изменение размера компонента до заданного минимального или максимального размера.

  • Реализация нелинейных вариантов изменения размера, например, изменение размера компонента в зависимости от размера родительского контейнера.

Кнопка - нажмите функцию обратного вызова, заданную как одно из следующих значений:

  • Дескриптор функции.

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

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

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

ButtonDownFcn Обратный вызов - это функция, выполняемая при нажатии кнопки мыши в контейнере.

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

  • Дескриптор функции.

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

  • Вектор символов, содержащий допустимое выражение 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

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

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

  • 'queue' - помещает обратный вызов с прерыванием в очередь, подлежащую обработке после завершения выполнения обратного вызова.

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

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

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

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

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

Родительский/дочерний

развернуть все

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

TabGroup children, возвращено как пустое GraphicsPlaceholder или одномерный массив Tab объекты.

Нельзя добавлять или удалять вкладки с помощью Children имущества TabGroup. Это свойство используется для просмотра списка вкладок или изменения порядка вкладок. Порядок Tab объекты в этом массиве отражают порядок отображаемых на экране вкладок.

Чтобы добавить дочерний элемент в этот список, установите Parent свойство Tab объект, который должен быть TabGroup объект.

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

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

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

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

развернуть все

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

Тип графического объекта, возвращаемого как 'uitabgroup'.

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

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

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

См. также

Функции

Свойства

Представлен в R2016a