Управление внешним видом и поведением группы вкладок в figure
- основанные на приложениях
Перечисленные здесь свойства действительны для групп вкладок в GUIDE или в приложениях, созданных с помощью figure
функция. Если вы используете App Designer или uifigure
вместо этого см. раздел Свойства TabGroup. Для получения дополнительной информации см. GUIDE Стратегии миграции.
Группы табуляций являются контейнерами для группировок и управления вкладками. Свойства управляют внешним видом и поведением группы вкладок. Используйте запись через точку для ссылки на конкретный объект и свойство.
f = figure; tg = uitabgroup(f); tg.Position = [.1 .1 .8 .8];
TabLocation
- Расположение метки вкладки'top'
(по умолчанию) | 'bottom'
| 'left'
| 'right'
Расположение метки вкладки, заданное как 'top'
, 'bottom'
, 'left'
, или 'right'
. Это свойство задает расположение меток вкладок относительно группы вкладок.
SelectedTab
- Выбранная вкладкаTab
объектТекущая выбранная вкладка, заданная как Tab
объект.
Используйте это свойство для определения текущей выбранной вкладки в группе вкладок. Можно также использовать это свойство, чтобы задать выбор по умолчанию.
Значение по умолчанию SelectedTab
свойство является первой вкладкой, которую вы добавляете в группу табуляций.
Visible
- Состояние видимости'on'
(по умолчанию) | логическое значение включения/выключенияСостояние видимости, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
'on'
- Отобразите объект.
'off'
- Скрыть объект, не удаляя его. Вы по-прежнему можете получить доступ к свойствам невидимого компонента пользовательского интерфейса.
Чтобы ускорить запуск приложения, установите Visible
свойство к 'off'
для всех компонентов, которые не должны появляться при запуске.
Изменение размера невидимого контейнера запускает SizeChangedFcn
коллбэк, когда он становится видимым.
Изменение Visible
свойство контейнера не изменяет значения Visible
свойства дочерних компонентов. Это верно, хотя скрытие контейнера приводит к скрытию дочерних компонентов.
ContextMenu
- Контекстное менюGraphicsPlaceholder
массив (по умолчанию) | ContextMenu
объектКонтекстное меню, заданное как ContextMenu
объект, созданный с использованием uicontextmenu
функция. Используйте это свойство для отображения контекстного меню при щелчке правой кнопкой мыши по компоненту.
Position
- Расположение и размер[left bottom width height]
Расположение и размер, заданные как четырехэлементный вектор формы [left bottom width height]
. Эта таблица описывает каждый элемент в векторе.
Элемент | Описание |
---|---|
left | Расстояние от внутреннего левого края родительского контейнера до внешнего левого края группы тегов |
bottom | Расстояние от внутреннего нижнего ребра родительского контейнера до внешнего нижнего ребра вкладки |
width | Расстояние между правым и левым внешними краями группы вкладок |
height | Расстояние между верхним и нижним внешними краями группы вкладок |
Все измерения указаны в модулях, заданных Units
свойство.
Примечание
The Position
значения относятся к drawable area родительского контейнера. Область векторной и растровой графики является областью внутри границ контейнера и не включает площадь, занимаемую заголовком. Если родительский контейнер является рисунком, то область векторной и растровой графики также исключает панель меню и панель инструментов.
Вы можете объединить запись через точку и индексацию массива, когда хотите изменить одно значение в Position
вектор. Для примера этот код устанавливает ширину группы вкладки равной .5
не меняя никаких других Position
значения:
tg = uitabgroup; tg.Position(3) = .5;
InnerPosition
- Расположение и размер[left bottom width height]
Расположение и размер, заданные как четырехэлементный вектор формы [left bottom width height]
. Все измерения указаны в модулях, заданных Units
свойство.
Это значение свойства идентично Position
и OuterPosition
значения свойств.
OuterPosition
- Расположение и размер[left bottom width height]
Расположение и размер, заданные как четырехэлементный вектор формы [left bottom width height]
. Все измерения указаны в модулях, заданных Units
свойство.
Это значение свойства идентично Position
и InnerPosition
значения свойств.
Units
- Единицы измерения'normalized'
(по умолчанию) | 'pixels'
| 'inches'
| 'centimeters'
| 'points'
| 'characters'
Единицы измерения, заданные одно из значений из этой таблицы.
Модули измерения | Описание |
---|---|
'normalized' | Эти модули измерения нормированы относительно родительского контейнера. Нижний левый угол контейнера сопоставлен с (0,0) и правый верхний угол преобразуется в (1,1) . |
'pixels' | Пиксели. Начиная с R2015b, расстояния в пикселях не зависят от вашего системного разрешения в Windows® и системы Macintosh:
На Linux® систем, размер пикселя определяется вашим системным разрешением. |
'inches' | Дюймы. |
'centimeters' | Сантиметры. |
'points' | Точки. Одна точка равна 1/72 дюйма. |
'characters' | Эти модули основаны на шрифте uicontrol по умолчанию графического корневого объекта:
Для доступа к шрифту uicontrol по умолчанию используйте |
MATLAB® измеряет все модули из нижнего левого угла родительского объекта.
Если вы измените значение Units
свойство, это хорошая практика, чтобы вернуть его к своему значению по умолчанию после завершения вашего расчета, чтобы избежать влияния на другие функции, которые предполагают Units
для свойства задано значение по умолчанию.
Порядок, в котором вы задаете свойства Units и Position, имеет следующие эффекты:
Если вы задаете Units
свойство перед Position
свойство, затем MATLAB устанавливает Position
используя указанные вами модули.
Если вы задаете Units
свойство после Position
свойство, MATLAB устанавливает положение используя значение по умолчанию Units
. Затем MATLAB преобразует Position
значения эквивалентных значений в заданных модулях.
SelectionChangedFcn
- Выбор изменил коллбэк''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовВыбор изменил коллбэк, заданный как одно из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Эта функция обратного вызова выполняется, когда пользователь выбирает другую вкладку в группе табуляций.
Если вы задаете SelectionChangedFcn
свойство указателю на функцию (или массиву ячеек, содержащему указатель на функцию), MATLAB передает SelectionChangedData
объект, содержащий данные о событиях в качестве второго аргумента функции обратного вызова. Этот объект содержит свойства, описанные в следующей таблице. Вы можете получить доступ к этим свойствам внутри функции обратного вызова с помощью записи через точку. Например, если вызывается второй аргумент в вашем коллбэке event
, затем event.NewValue
возвращает текущую выбранную Tab
.
Свойство | Описание |
---|---|
OldValue | Ранее выбранные |
NewValue | Выбранные на данный момент |
Source | Компонент, который выполняет коллбэк |
EventName |
|
Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».
SizeChangedFcn
- Изменение размера функции обратного вызова''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовИзмените размер функции обратного вызова, заданной в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Задайте этот коллбэк, чтобы настроить размещение приложения при изменении размера этого контейнера (например, когда пользователь изменяет размер окна).
The SizeChangedFcn
коллбэк выполняется в следующих случаях:
Этот контейнер становится видимым впервые.
Этот контейнер отображается при изменении его размера.
Этот контейнер становится видимым впервые после изменения его размера. Эта ситуация возникает, когда размер изменяется, пока контейнер невидим, и затем он становится видимым позже.
Другие важные точки, которые следует учитывать при определении SizeChangedFcn
коллбэк:
Рассмотрите задержку отображения этого контейнера до тех пор, пока все переменные, которые SizeChangedFcn
использование задано. Эта практика может предотвратить SizeChangedFcn
коллбэк после возврата ошибки. Чтобы задержать отображение контейнера, установите его Visible
свойство к 'off'
. Затем установите Visible
свойство к 'on'
после определения переменных, которые SizeChangedFcn
используется коллбэк.
Если ваше приложение содержит вложенные контейнеры, они изменяются в размере изнутри.
Чтобы получить доступ к контейнеру, который изменяет размер из SizeChangedFcn
, обратитесь к исходному объекту (первому входному параметру в коллбэке) или используйте gcbo
функция.
Совет
Как простая альтернатива указанию SizeChangedFcn
коллбэк, можно задать Units
свойство всех объектов, которые вы помещаете в контейнер, чтобы 'normalized'
. Это делает эти компоненты масштабируемыми пропорционально контейнеру.
Для получения дополнительной информации об управлении размещениями с помощью функции SizeChangedFcn
коллбэки.
ButtonDownFcn
- Функция обратного вызова при нажатии кнопки''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция обратного вызова с нажатием кнопки, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».
The ButtonDownFcn
коллбэк - это функция, которая выполняется при нажатии пользователем кнопки мыши в контейнере.
CreateFcn
- Функция создания компонентов''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция создания компонентов, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».
Это свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB создает компонент. MATLAB инициализирует все значения свойств компонентов перед выполнением CreateFcn
коллбэк. Если вы не задаете CreateFcn
свойство, затем MATLAB выполняет функцию создания по умолчанию.
Используйте gcbo
функция в вашем CreateFcn
код для получения объекта компонента, который создается.
Установка CreateFcn
свойство существующего объекта компонента не имеет эффекта.
DeleteFcn
- Функция удаления компонентов''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция удаления компонента, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».
The DeleteFcn
свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB удаляет компонент (для примера, когда пользователь закрывает окно). MATLAB выполняет DeleteFcn
коллбэк перед уничтожением свойств объекта компонента. Если вы не задаете DeleteFcn
свойство, затем MATLAB выполняет функцию удаления по умолчанию.
Используйте gcbo
функция в вашем DeleteFcn
код для получения удаляемого объекта компонента.
Interruptible
- Прерывание коллбэка'on'
(по умолчанию) | логические значения включения/выключенияПрерывание коллбэка, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
The Interruptible
свойство определяет, можно ли прерывать выполняемый коллбэк. Существует два состояния коллбэка:
Обратный коллбэк running - это актуальный на данный момент коллбэк.
Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.
Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк (если он существует). The Interruptible
свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание:
Значение 'on'
позволяет другим коллбэкам прерывать коллбэки объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, когда есть drawnow
, figure
, getframe
, waitfor
, или pause
.
Если текущий коллбэк содержит одну из этих команд, MATLAB останавливает выполнение коллбэка в этой точке и выполняет прерывание обратного вызова. MATLAB возобновляет выполнение текущего коллбэка после завершения прерывания обратного вызова.
Если текущий коллбэк не содержит одну из этих команд, MATLAB завершает выполнение коллбэка без прерывания.
Значение 'off'
блокирует все попытки прерывания. The BusyAction
свойство объекта, имеющего прерывание обратного вызова, определяет, отменяется ли прерывание обратного вызова или помещается в очередь.
Примечание
Прерывание и выполнение коллбэка происходят по-разному в таких ситуациях:
Если прерывание обратного вызова является DeleteFcn
, CloseRequestFcn
, или SizeChangedFcn
коллбэк, тогда прерывание происходит независимо от Interruptible
значение свойства.
Если текущий коллбэк выполняющегося в данного момента, waitfor
function, тогда прерывание происходит независимо от Interruptible
значение свойства.
Timer
объекты выполняются в соответствии с расписанием независимо от Interruptible
значение свойства.
MATLAB не сохраняет состояние свойств или отображения при прерывании. Для примера, объект, возвращенный gca
или gcf
команда может измениться при выполнении другого коллбэка.
См. пример выполнения прерывания обратного вызова, показывающий, как Interruptible
и BusyAction
свойства влияют на поведение программы.
BusyAction
- постановка в очередь коллбэков'queue'
(по умолчанию) | 'cancel'
Организация очереди коллбэков задается как 'queue'
(по умолчанию) или 'cancel'
. The BusyAction
свойство определяет, как MATLAB обрабатывает выполнение прерываний обратного вызова. Существует два состояния коллбэка:
Обратный коллбэк running - это актуальный на данный момент коллбэк.
Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.
The BusyAction
свойство источника прерывания обратного вызова определяет, как MATLAB обрабатывает его выполнение. The BusyAction
свойство имеет следующие значения:
'queue'
- Поместите прерывание обратного вызова в очередь вызовов, подлежащих обработке после концов обратного коллбэка.
'cancel'
- Не выполнять прерывание обратного вызова.
Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк всегда пытается прервать выполнение текущего коллбэка. The Interruptible
свойство объекта, чей коллбэк выполняется, определяет, разрешено ли прерывание. Если Interruptible
установлено в:
on
- Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь. Это значение по умолчанию.
off
- The BusyAction
свойство (объекта, имеющего прерывающий обратный вызов) определяет, будет ли MATLAB ставить в очередь или игнорировать прерывание обратного вызова.
См. пример выполнения прерывания обратного вызова, показывающий, как BusyAction
и Interruptible
свойства влияют на поведение программы.
BeingDeleted
- Статус удаленияЭто свойство доступно только для чтения.
Статус удаления, возвращенный как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState
.
MATLAB устанавливает BeingDeleted
свойство к 'on'
когда DeleteFcn
коллбэк начинает выполняться. The BeingDeleted
свойство остается установленным на 'on'
пока объект компонента не перестанет существовать.
Проверьте значение BeingDeleted
свойство, чтобы убедиться, что объект не будет удален до запроса или изменения.
Parent
- Родительский объектFigure
| Panel
| Tab
Родительский объект, заданный как Figure
, Panel
, или Tab
объект. Используйте это свойство, чтобы задать родительский контейнер при создании группы вкладок или переместить существующую группу вкладок в другой родительский контейнер.
Children
— TabGroup
детиGraphicsPlaceholder
array (по умолчанию) | 1-D массив объектов компонентаTabGroup
дети, возвращенные как пустые GraphicsPlaceholder
или 1-D массив объектов компонента. Дети TabGroup
объекты Tab
объекты.
Вы не можете добавить или удалить дочерние элементы, используя Children
свойство. Используйте это свойство для просмотра списка дочерних элементов или для изменения порядка дочерних элементов. Порядок дочерних элементов в этом массиве отражает порядок вкладок, отображаемых на экране.
Чтобы добавить дочерний элемент в этот список, установите Parent
свойство дочернего компонента к TabGroup
объект.
Объекты с HandleVisibility
значение свойства установлено в 'off'
не указаны в Children
свойство.
HandleVisibility
- Видимость указателя на объект'on'
(по умолчанию) | 'callback'
| 'off'
Видимость указателя на объект, заданная как 'on'
, 'callback'
, или 'off'
.
Это свойство контролирует видимость указателя на объект в его родительский список дочерних элементов. Когда указатель не отображается в его родительский список дочерних элементов, он не возвращается с помощью функций, которые получают указатели, просматривая иерархию объектов или запрашивая свойства указателя. Эти функции включают get
, findobj
, gca
, gcf
, gco
, newplot
, cla
, clf
, и close
. The HandleVisibility
свойство также контролирует видимость указателя на объект в родительском рисунке CurrentObject
свойство. Указатели все еще действительны, даже если они не видны. Если вы можете получить доступ к объекту, можно задать и получить его свойства, и передать его в любую функцию, которая работает с объектами.
Значение HandleVisibility | Описание |
---|---|
'on' | Указатель на объект всегда отображается. |
'callback' | Указатель на объект виден из коллбэков или функций, вызываемых коллбэками, но не из функций, инициируемых из командной строки. Эта опция блокирует доступ к объекту в командной строке, но позволяет функциям обратного вызова обращаться к нему. |
'off' | Указатель на объект всегда невидим. Эта опция используется для предотвращения непреднамеренных изменений пользовательского интерфейса другой функцией. Установите HandleVisibility на 'off' временно скрыть указатель во время выполнения этой функции. |
Установите корень графики ShowHiddenHandles
свойство к 'on'
сделать все указатели видимыми, независимо от их HandleVisibility
значение. Эта настройка не влияет на их HandleVisibility
значения.
Type
- Тип графического объекта'uitabgroup'
Это свойство доступно только для чтения.
Тип графического объекта, возвращенный как 'uitabgroup'
.
Tag
- Идентификатор объекта''
(по умолчанию) | символьный вектор | строковый скалярИдентификатор объекта, заданный как вектор символов или строковый скаляр. Можно задать уникальное Tag
значение, которое служит идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте вашего кода, вы можете использовать findobj
функция для поиска объекта на основе Tag
значение.
UserData
- Пользовательские данные[]
(по умолчанию) | массивПользовательские данные, заданные как любой массив. Определение UserData
может быть полезным для обмена данными в приложениях См. Раздел «Обмен данными между коллбэками» для получения дополнительной информации.
UIContextMenu
свойство не рекомендуетсяНе рекомендуемый запуск в R2020a
Начиная с R2020a, используя UIContextMenu
свойство назначения контекстного меню графическому объекту или компоненту пользовательского интерфейса не рекомендуется. Используйте ContextMenu
вместо этого свойство. Значения свойств те же.
Нет планов по удалению поддержки UIContextMenu
свойство в это время. Однако UIContextMenu
свойство больше не отображается в списке, возвращенном вызовом get
функция для графического объекта или компонента пользовательского интерфейса.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.