Exponenta Banner
exponenta event banner

Свойства вкладки

Внешний вид вкладки «Control» в uifigureПриложения на основе

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

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

fig = uifigure;
tg = uitabgroup(fig);
t = uitab(tg);
t.Title = 'Data';

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

Название и цвет

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

Заголовок, указанный как символьный вектор, строковый скаляр или категориальный массив. Если это свойство указано как категориальный массив, MATLAB ® отображает только первый элемент в массиве.

MATLAB не интерпретирует вертикальную косую черту ('|') символ как разрыв строки, он отображается как вертикальная косая черта в заголовке.

Если требуется указать символ Юникода ®, передайте десятичный код Юникода вchar функция. Например, ['Multiples of ' char(960)] отображается как Multiples of π.

Цвет заголовка, указанный как триплет 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'

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

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

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

Установка для этого свойства значения 'on' включает прокрутку внутри контейнера. Однако существуют дополнительные потребности:

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

  • Компоненты, которые не помещаются в контейнер, должны находиться выше или справа от контейнера. Невозможно выполнить прокрутку к компонентам, расположенным ниже или слева от контейнера.

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

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

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

Положение

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

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

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

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

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

Примечание

Это некоторые важные моменты, которые следует учитывать при использовании Position свойство:

  • Position на значения влияет длина заголовка вкладки и TabLocation свойство родителя TabGroup объект.

  • Position значения относятся к извлекаемой области родительского элемента TabGroup, который является областью внутри его границ.

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

Местоположение и размер вкладки, возвращаемые в виде четырехэлементного вектора формы [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'.

Отзывы

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

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

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

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

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

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

Примечание

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

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

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

  • Отображается при изменении размера.

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

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

  • Рассмотрите возможность задержки отображения этого контейнера до тех пор, пока не появятся все переменные, SizeChangedFcn Определены виды использования. Эта практика может предотвратить SizeChangedFcn обратный вызов при возврате ошибки. Чтобы добиться этой задержки, задерживайте отображение родительского контейнера группы вкладок, установив его Visible свойство для 'off'. Затем установите Visible свойство для 'on' после определения переменных, которые 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 для проверки того, что объект не будет удален перед запросом или изменением.

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

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

Родительский объект, указанный как TabGroup объект. TabGroup должен быть потомком Figure создан с помощью uifigure функция.

Потомки вкладки, возвращенные как пустые GraphicsPlaceholder или 1-D массив объектов компонентов приложения.

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Функции

Свойства

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

Документация MATLAB

Поддержка