uitabgroup

Создайте контейнер для панелей с вкладками

Описание

tg = uitabgroup создает группу вкладки в текущей фигуре и возвращает TabGroup объект. Если нет никакой доступной фигуры, MATLAB® вызывает figure функция, чтобы создать ту. Группы вкладки являются контейнерами для вкладок. Они позволяют вам идентифицировать выбранную вкладку и обнаруживать, когда пользователь выбирает различную вкладку.

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

tg = uitabgroup(parent) создает группу вкладки в заданном родительском контейнере. Родительский контейнер может быть фигурой, созданной с любым figure или uifigure функция или дочерний контейнер, такой как панель. Значения свойств для uitabgroup варьируйтесь немного в зависимости от того, создано ли приложение с figure или uifigure функция. Для получения дополнительной информации см. Аргументы в виде пар имя-значение.

пример

tg = uitabgroup(parent,Name,Value) задает родительский контейнер и одни или несколько значений свойств.

Примеры

свернуть все

Создайте фигуру, содержащую группу вкладки и две вкладки.

f = figure;
tabgp = uitabgroup(f,'Position',[.05 .05 .3 .8]);
tab1 = uitab(tabgp,'Title','settings');
tab2 = uitab(tabgp,'Title','Options');

Получите в настоящее время выбранную вкладку.

currenttab = tabgp.SelectedTab
currenttab = 

  Tab (settings) with properties:

              Title: 'settings'
    BackgroundColor: [0.9400 0.9400 0.9400]
           Position: [0.0119 0.0089 0.9702 0.9107]
              Units: 'normalized'

Scrollable свойство позволяет прокрутить во вкладке, которая имеет компоненты вне ее границ. Чтобы использовать прокрутку, фигура должна быть создана с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.

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

fig = uifigure;
tg = uitabgroup(fig,'Position',[20 20 196 145]);
t = uitab(tg,'Title','Member Informaion');
ef1 = uieditfield(t,'text','Position',[11 165 140 22],'Value','First Name');
ef2 = uieditfield(t,'text','Position',[11 140 140 22],'Value','Last Name');
ef3 = uieditfield(t,'text','Position',[11 115 140 22],'Value','Addess');
dd = uidropdown(t,'Position',[11 90 140 22],'Items',{'Male','Female'});
cb = uicheckbox(t,'Position',[11 65 140 22],'Text','Member');
b = uibutton(t,'Position',[11 40 140 22],'Text','Send');

Позвольте прокрутить путем установки Scrollable свойство вкладки к 'on'. По умолчанию полоса прокрутки отображается наверху.

t.Scrollable = 'on';

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

свернуть все

Родительский контейнер в виде фигуры, созданной с любым figure или uifigure функция или дочерний контейнер:

  • Панели, вкладки и группы кнопок могут быть контейнерами в любом типе фигуры.

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

Аргументы name-value

Пример: uitabgroup('TabLocation','bottom') указывает, что метки вкладки в нижней части группы вкладки.

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

Примечание

Свойства, перечисленные здесь, являются подмножеством доступных свойств. Для полного списка смотрите TabGroup Properties.

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

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

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

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

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

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

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

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

Свойство

Описание

OldValue

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

NewValue

В настоящее время выбрал Tab

Source

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

EventName

'SelectionChanged'

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

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

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

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

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

Все измерения находятся в модулях, заданных Units свойство.

Position значения относительно drawable area родительского контейнера. Область векторной и растровой графики является областью в границах контейнера и не включает область, занятую художественными оформлениями, такими как панель меню или заголовок.

Единицы измерения в виде одного из значений в этой таблице.

Модульное значениеОписание
'pixels' (значение по умолчанию)

Расстояния в пикселях независимы от вашего системного разрешения по Windows® и системы Макинтоша:

  • В системах Windows пиксель составляет 1/72 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

На Linux® системы, размер пикселя определяется вашим системным разрешением.

'normalized'

Эти модули нормированы относительно родительского контейнера. Нижний левый угол контейнера сопоставляет с (0,0) и верхний правый угол сопоставляет с (1,1).

'inches''inches'.
'centimeters''centimeters'.
'points''points'. Одна точка равняется 1/72-й из дюйма.

Рекомендуемым значением является 'pixels', потому что большая часть функциональности создания приложений MATLAB измеряет расстояния в пикселях. Можно создать панель, которая перемасштабирует на основе размера родительского контейнера путем порождения панели менеджеру по размещению сетки, созданному с помощью uigridlayout функция. Для получения дополнительной информации смотрите, Размечают Приложения Программно.

figure- Основанные Приложения

Для групп вкладки в приложениях, созданных с помощью figure функция, значение по умолчанию Units 'normalized'.

Кроме того, можно задать Units как 'characters'. Символьные модули основаны на шрифте uicontrol по умолчанию графического корневого объекта:

  • Ширина символов = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

Чтобы получить доступ к шрифту uicontrol по умолчанию, используйте get(groot,'defaultuicontrolFontName') или set(groot,'defaultuicontrolFontName').

Смотрите также

Функции

Свойства

Введенный в R2014b