Управление внешним видом и поведением группы кнопок в uifigure
- основанные на приложениях
Группы кнопок являются контейнерами для управления эксклюзивным выбором переключателей и кнопок-переключателей. Свойства управляют внешним видом и поведением группы кнопок. Используйте запись через точку для ссылки на определенный объект и свойство.
fig = uifigure; bg = uibuttongroup(fig); bg.Title = 'Options';
Перечисленные здесь свойства действительны для групп кнопок в App Designer или в приложениях, созданных с помощью uifigure
функция. Для групп кнопок, используемых в GUIDE или в приложениях, созданных с помощью figure
, см. ButtonGroup Properties.
Title
- ЗаголовокЗаголовок, заданный как вектор символов, строковый скаляр или категориальный массив. Если вы задаете это свойство как категориальный массив, MATLAB® отображает только первый элемент массива.
MATLAB не интерпретирует вертикальную косую черту ('|'
) символ как пропуск линии, он отображается как вертикальная косая черта в заголовке.
Если необходимо задать Юникод® символ, передайте код десятичного числа Unicode в char
функция. Для примера, ['Multiples of ' char(960)]
отображается следующим Multiples of
π.
TitlePosition
- Расположение заголовка'lefttop'
(по умолчанию) | 'centertop'
| 'righttop'
Расположение заголовка, обозначаемое как 'lefttop'
, 'centertop'
, или 'righttop'
.
ForegroundColor
- Титульный цвет[0 0 0]
(по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | 'r'
| 'g'
| 'b'
| ...Заголовок цвета, заданный как триплет 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' |
BackgroundColor
- Цвет фона[0.94 0.94 0.94]
(по умолчанию) | RGB Triplet | шестнадцатеричный цветовой код | 'r'
| 'g'
| 'b'
| ...Цвет фона, заданный как триплет 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' |
BorderType
- Граница группы кнопок 'line'
(по умолчанию) | 'none'
Граница группы кнопок, заданная как 'line'
или 'none'
.
FontName
- Название шрифтаНазвание шрифта, заданная как поддерживаемая системой название шрифта. Шрифт по умолчанию зависит от конкретной операционной системы и локали.
Если указанный шрифт недоступен, MATLAB использует тот, который больше всего похож на него из всех шрифтов, доступных в той системе, в которой работает приложение.
Пример: 'Arial'
FontSize
- Размер шрифтаРазмер шрифта, заданный в виде положительного числа. Единицами измерения являются пиксели. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали.
Пример: 14
FontWeight
- Толщина шрифта'normal'
(по умолчанию) | 'bold'
Толщина шрифта, заданный как одно из следующих значений:
'normal'
- Вес по умолчанию, определяемый конкретным шрифтом
'bold'
- более тонкие контуры символов, чем 'normal'
Не все шрифты имеют полужирный шрифт вес. Поэтому установка полужирного шрифта веса может привести к нормальной толщине шрифта.
FontAngle
- Угол шрифта'normal'
(по умолчанию) | 'italic'
Угол шрифта, заданный как 'normal'
или 'italic'
. Установка значения свойства italic
выбирает наклонную версию шрифта, если она доступна в системе пользователя приложения.
FontUnits
- Единица измерения шрифта'pixels'
(по умолчанию)Единица измерения шрифта, заданная как 'pixels'
. Расстояния в пикселях не зависят от вашего системного разрешения в Windows® и системы Macintosh:
В системах Windows пиксель составляет 1/96 дюйма.
В системах Macintosh пиксель составляет 1/72 дюйма.
На Linux® систем, размер пикселя определяется вашим системным разрешением.
Visible
- Состояние видимости'on'
(по умолчанию) | логическое значение включения/выключенияСостояние видимости, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
'on'
- Отобразите объект.
'off'
- Скрыть объект, не удаляя его. Вы по-прежнему можете получить доступ к свойствам невидимого компонента пользовательского интерфейса.
Чтобы ускорить запуск приложения, установите Visible
свойство к 'off'
для всех компонентов, которые не должны появляться при запуске.
Изменение размера невидимого контейнера запускает SizeChangedFcn
коллбэк, когда он становится видимым.
Изменение Visible
свойство контейнера не изменяет значения Visible
свойства дочерних компонентов. Это верно, хотя скрытие контейнера приводит к скрытию дочерних компонентов.
Buttons
- Кнопки, управляемые группой кнопокRadioButton
объекты | массив ToggleButton
объектыЭто свойство доступно только для чтения.
Кнопки, управляемые группой кнопок, возвращенные как массив RadioButton
объекты или массив ToggleButton
объекты.
Это свойство не обязательно возвращает все дочерние компоненты ButtonGroup
объект. Если вам нужно получить доступ к дочерним компонентам, которые не RadioButton
или ToggleButton
объекты, используйте Children
свойство.
SelectedObject
- На данный момент выбран переключатель или переключательВыбранный на данный момент переключатель или кнопка-переключатель, заданный как RadioButton
или ToggleButton
объект.
Получите значение этого свойства, чтобы определить, какая кнопка в данный момент выбрана в группе кнопок.
Установите значение этого свойства, чтобы изменить текущую выбранную кнопку. Когда вы изменяете выбор с помощью этого свойства, MATLAB корректирует Value
свойство для других кнопок в группе кнопок соответственно.
Например, предположим, что группа кнопок содержит три переключателя, и вы устанавливаете SelectedObject
свойство к radiobutton3
. MATLAB устанавливает Value
свойство для каждого дочернего RadioButton
следующим образом:
radiobutton1.Value = false;
radiobutton2.Value = false;
radiobutton3.Value = true;
Другими словами, установка SelectedObject
свойство имеет тот же эффект что и установка Value
свойство RadioButton
или ToggleButton
.
Scrollable
- Возможность прокрутки'off'
(по умолчанию) | логическое значение включения/выключенияВозможность прокрутки, заданная как 'off'
или 'on'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
Установка значения свойства 'on'
включает прокрутку внутри контейнера. Однако существуют дополнительные требования:
Дочерние компоненты в контейнере должны занимать большую площадь, чем может отображаться контейнер одновременно.
Компоненты, которые не помещаются в контейнере, должны располагаться выше или справа от контейнера. Вы не можете прокрутить до компонентов, которые находятся ниже или слева от контейнера.
Некоторые типы графиков и осей не поддерживают прокручиваемые контейнеры. Однако можно поместить график или оси в нескролируемую панель, а затем поместить панель в прокручиваемый контейнер. Для получения дополнительной информации см. раздел «Отображение графики в App Designer».
Enable
- Рабочее состояние'on'
(по умолчанию) | логическое значение включения/выключенияРабочее состояние, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
Если вы задаете это свойство равным 'on'
пользователь приложения может взаимодействовать с компонентом.
Если вы задаете это свойство равным 'off'
компонент появляется затемненным, что указывает на то, что пользователь приложения не может с ним взаимодействовать, и что он не будет запускать коллбэк.
Изменение значения Enable
свойство для группы кнопок не изменяет значение Enable
свойство для компонентов пользовательского интерфейса, содержащихся в этой группе кнопок.
Tooltip
- Подсказка''
(дефолт) | вектор символов | массив ячеек векторов символов | строковые массивы | 1-D категориальный массивПодсказка, заданная как вектор символов, массив ячеек из векторов символов, строковые массивы или 1-D категориальный массив. Используйте это свойство для отображения сообщения при наведении указателя мыши на компонент во время выполнения. Чтобы отобразить несколько линии текста, задайте массив ячеек из векторов символов или строковые массивы. Каждый элемент массива становится отдельной строкой текста. Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.
ContextMenu
- Контекстное менюGraphicsPlaceholder
массив (по умолчанию) | ContextMenu
объектКонтекстное меню, заданное как ContextMenu
объект, созданный с использованием uicontextmenu
функция. Используйте это свойство для отображения контекстного меню при щелчке правой кнопкой мыши по компоненту.
Position
- Расположение и размер группы кнопок, включая границы и заголовок[left bottom width height]
Расположение и размер группы кнопок, включая границы и заголовок, заданные как вектор формы [left bottom width height]
. Эта таблица описывает каждый элемент в векторе.
Элемент | Описание |
---|---|
left | Расстояние от внутреннего левого края родительского контейнера до внешнего левого края группы кнопок |
bottom | Расстояние от внутреннего нижнего ребра родительского контейнера до внешнего нижнего ребра группы кнопок |
width | Расстояние между правым и левым внешними краями группы кнопок |
height | Расстояние между верхним и нижним внешними краями группы кнопок |
Все измерения, заданные Units
значение свойства.
The Position
значения относятся к drawable area родительского контейнера. Область векторной и растровой графики является областью внутри границ контейнера и не включает область, занимаемую украшениями, такими как панель меню или заголовок.
InnerPosition
- Расположение и размер группы кнопок, исключая границы и заголовок[left bottom width height]
Это свойство доступно только для чтения.
Расположение и размер группы кнопок, исключая границы и заголовок, возвращается как четырехэлементный вектор формы [left bottom width height]
. Эта таблица описывает каждый элемент в векторе.
Значение | Описание |
---|---|
left | Расстояние от внутреннего левого края родительского контейнера до внутреннего левого края группы кнопок. |
bottom | Расстояние от внутреннего нижнего ребра родительского контейнера до внутреннего нижнего ребра группы кнопок. |
width | Расстояние между внутренними краями правой и левой границ группы кнопок. |
height | Расстояние между внутренними краями верхней и нижней границ группы кнопок. Это расстояние исключает заголовок, если он существует. |
Все измерения указаны в модулях, заданных Units
свойство.
Примечание
Это некоторые важные точки, которые следует учитывать при использовании InnerPosition
свойство:
InnerPosition
значения зависят от наличия (или отсутствия) заголовка, характеристик шрифта и BorderType
.
InnerPosition
значения относятся к drawable area родительского контейнера. Область векторной и растровой графики является областью внутри границ контейнера и не включает площадь, занимаемую заголовком.
OuterPosition
- Расположение и размер группы кнопок, включая границы и заголовок[left bottom width height]
Расположение и размер группы кнопок, включая границы и заголовок, заданные как четырехэлементный вектор формы [left bottom width height]
. Все измерения указаны в модулях, заданных Units
свойство.
Это значение свойства идентично Position
значение свойства.
Units
- Единицы измерения'pixels'
(по умолчанию)Единицы измерения, заданные как 'pixels'
.
AutoResizeChildren
- Автоматическое изменение размера дочерних элементов'on'
(по умолчанию) | логическое значение включения/выключенияАвтоматическое изменение размера дочерних элементов, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
'on'
- Размер дочерних компонентов автоматически изменяется при изменении размера контейнера.
'off'
- Дочерние компоненты не изменяются в размере.
The AutoResizeChildren
свойство влияет на прямые дочерние элементы контейнера, а не на дочерние элементы вложенных контейнеров.
Чтобы настроить поведение изменения размера, установите AutoResizeChildren
свойство к 'off'
и создайте SizeChangedFcn
коллбэк для контейнера. Дополнительные сведения см. в разделе Управление изменяемыми размерами приложений в App Designer.
Чтобы отключить изменение размера приложения, установите Resize
свойство рисунка, чтобы 'off'
.
Layout
- опции размещенияLayoutOptions
массив (по умолчанию) | GridLayoutOptions
объектОпции размещения, заданные как GridLayoutOptions
объект. Это свойство задает опции для компонентов, являющихся дочерними элементами контейнеров размещения сетки. Если компонент не является дочерним элементом контейнера сетки размещения (для примера он является дочерним элементом рисунка или панели), то это свойство пустое и не имеет эффекта. Однако, если компонент является дочерним элементом контейнера размещения сетки, можно поместить компонент в нужную строку и столбец сетки путем установки Row
и Column
свойства на GridLayoutOptions
объект.
Например, этот код помещает группу кнопок в третью строку и второй столбец родительской сетки.
g = uigridlayout([4 3]); bg = uibuttongroup(g); bg.Layout.Row = 3; bg.Layout.Column = 2;
Чтобы группа кнопок охватывала несколько строк или столбцов, задайте Row
или Column
свойство как двухэлементный вектор. Для примера эта группа кнопок охватывает столбцы 2
через 3
:
bg.Layout.Column = [2 3];
SelectionChangedFcn
- Выбор изменил коллбэк''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовВыбор изменил коллбэк, заданный как одно из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Это коллбэк выполняется, когда пользователь выбирает другую кнопку в группе кнопок в приложении. Оно не выполняется, если радио или кнопка-переключатель Value
свойство изменяется программно.
Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с кнопками. MATLAB передает эту информацию в SelectionChangedData
объект как второй аргумент функции обратного вызова. В App Designer аргумент называется event
. Вы можете запросить свойства объекта с помощью записи через точку. Для примера, event.NewValue
возвращает текущую выбранную кнопку. The SelectionChangedData
объект недоступен для функций обратного вызова, заданных как векторы символов.
В следующей таблице перечислены свойства SelectionChangedData
объект.
Свойство | Описание |
---|---|
OldValue | Ранее выбранная кнопка |
NewValue | Текущая выбранная кнопка |
Source | Компонент, который выполняет коллбэк |
EventName |
|
Для получения дополнительной информации о записи коллбэков см. Раздел «Запись коллбэков в App Designer».
SizeChangedFcn
- Изменение размера коллбэка''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовИзменение размера коллбэка, заданное в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Задайте этот коллбэк, чтобы настроить размещение приложения при изменении размера этого контейнера (например, когда пользователь изменяет размер окна). В нем запишите код, чтобы настроить Position
свойство дочерних компонентов.
Примечание
The SizeChangedFcn
коллбэк не выполняется, если не AutoResizeChildren
свойство этого контейнера установлено в 'off'
. В App Designer можно сделать SizeChangedFcn
исполняемый файл путем установки контейнера и снятия флажка AutoResizeChildren на вкладке Inspector Component Browser.
The SizeChangedFcn
коллбэк выполняется в следующих случаях:
Этот контейнер становится видимым впервые.
Этот контейнер отображается при изменении его размера.
Этот контейнер становится видимым впервые после изменения его размера. Эта ситуация возникает, когда размер изменяется, пока контейнер невидим, и затем он становится видимым позже.
Другие важные точки, которые следует учитывать при определении SizeChangedFcn
коллбэк:
Рассмотрите задержку отображения этого контейнера до тех пор, пока все переменные, которые SizeChangedFcn
использование задано. Эта практика может предотвратить SizeChangedFcn
коллбэк после возврата ошибки. Чтобы задержать отображение контейнера, установите его Visible
свойство к 'off'
. Затем установите Visible
свойство к 'on'
после определения переменных, которые SizeChangedFcn
используется коллбэк.
Если ваше приложение содержит вложенные контейнеры, они изменяются в размере изнутри.
Чтобы получить доступ к контейнеру, который изменяет размер из SizeChangedFcn
, обратитесь к исходному объекту (первому входному параметру в коллбэке) или используйте gcbo
функция.
Альтернативные способы задать поведение изменения размера - создать GridLayout
объект или используйте опции автоматического переплавления в App Designer. Эти опции могут быть более простыми в использовании, чем SizeChangedFcn
коллбэки. Однако существуют некоторые преимущества, которые SizeChangedFcn
коллбэки имеют над этими опциями. Для примера:
Изменение размера компонента до заданного минимального или максимального размера.
Реализация нелинейного поведения изменения размера, например изменение размера компонента на основе размера родительского контейнера.
ButtonDownFcn
- Функция обратного вызова при нажатии кнопки''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция обратного вызова с нажатием кнопки, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».
The ButtonDownFcn
коллбэк - это функция, которая выполняется при нажатии пользователем кнопки мыши в контейнере.
CreateFcn
- Функция создания''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция создания объектов, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Дополнительные сведения об указании коллбэка как указателя на функцию, массива ячеек или вектора символов см. в разделе Запись коллбэков в App Designer.
Это свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB создает объект. MATLAB инициализирует все значения свойств перед выполнением CreateFcn
коллбэк. Если вы не задаете CreateFcn
свойство, затем MATLAB выполняет функцию создания по умолчанию.
Установка CreateFcn
свойство в существующем компоненте не имеет никакого эффекта.
Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к объекту, который создается с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo
функция для доступа к объекту.
DeleteFcn
- Функция удаления''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция удаления объектов, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Дополнительные сведения об указании коллбэка как указателя на функцию, массива ячеек или вектора символов см. в разделе Запись коллбэков в App Designer.
Это свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB удаляет объект. MATLAB выполняет DeleteFcn
коллбэк перед уничтожением свойств объекта. Если вы не задаете DeleteFcn
свойство, затем MATLAB выполняет функцию удаления по умолчанию.
Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к удаляемому объекту с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo
функция для доступа к объекту.
Interruptible
- Прерывание коллбэка'on'
(по умолчанию) | логическое значение включения/выключенияПрерывание коллбэка, заданное как '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
команда может измениться при выполнении другого коллбэка.
BusyAction
- постановка в очередь коллбэков'queue'
(по умолчанию) | 'cancel'
Постановка в очередь коллбэков, заданная как 'queue'
или 'cancel'
. The BusyAction
свойство определяет, как MATLAB обрабатывает выполнение прерываний обратного вызова. Существует два состояния коллбэка:
Обратный коллбэк running - это актуальный на данный момент коллбэк.
Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.
Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк. The Interruptible
свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction
свойство объекта, имеющего прерывание обратного вызова, определяет, будет ли оно сброшено или помещено в очередь. Это возможные значения BusyAction
свойство:
'queue'
- помещает прерывание обратного вызова в очередь вызовов, подлежащих обработке после концов обратного коллбэка.
'cancel'
- Не выполняет прерывание обратного вызова.
BeingDeleted
- Статус удаленияЭто свойство доступно только для чтения.
Статус удаления, возвращенный как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState
.
MATLAB устанавливает BeingDeleted
свойство к 'on'
когда DeleteFcn
коллбэк начинает выполняться. The BeingDeleted
свойство остается установленным на 'on'
пока объект компонента не перестанет существовать.
Проверьте значение BeingDeleted
свойство, чтобы убедиться, что объект не будет удален до запроса или изменения.
Parent
- Родительский контейнерFigure
объект (по умолчанию) | Panel
| объекта Tab
| объекта ButtonGroup
| объекта GridLayout
объектРодительский контейнер, заданный как Figure
объект, созданный с использованием uifigure
функция, или один из ее дочерних контейнеров: Tab
, Panel
, ButtonGroup
, или GridLayout
. Если контейнер не задан, MATLAB вызывает uifigure
функция для создания нового Figure
объект, который служит родительским контейнером.
Children
— ButtonGroup
детиGraphicsPlaceholder
array (по умолчанию) | 1-D массив объектов компонентаButtonGroup
дети, возвращенные как пустые GraphicsPlaceholder
или 1-D массив объектов компонента. Дети ButtonGroup
объект может быть любым объектом компонента пользовательского интерфейса, включая другой ButtonGroup
объект.
Вы не можете добавить или удалить дочерние компоненты с помощью Children
свойство ButtonGroup
. Используйте Children
значение свойства для просмотра списка дочерних элементов или для изменения порядка дочерних элементов. Порядок дочерних элементов в массиве значений свойств отражает порядок "от первого до последнего" (порядок размещения) компонентов на экране.
Чтобы добавить дочерний элемент в этот список, установите Parent
свойство дочернего компонента к ButtonGroup
.
HandleVisibility
- Видимость указателя на объект'on'
(по умолчанию) | 'callback'
| 'off'
Видимость указателя на объект, заданная как 'on'
, 'callback'
, или 'off'
.
Это свойство контролирует видимость объекта в его родительский список дочерних элементов. Когда объект не отображается в родительский список дочерних элементов, он не возвращается с помощью функций, которые получают объекты, просматривая иерархию объектов или запрашивая свойства. Эти функции включают get
, findobj
, clf
, и close
. Объекты действительны, даже если они не видны. Если вы можете получить доступ к объекту, можно задать и получить его свойства, и передать его в любую функцию, которая работает с объектами.
Значение HandleVisibility | Описание |
---|---|
'on' | Объект всегда отображается. |
'callback' | Объект виден из обратных коллбэков или функций, вызываемых коллбэками, но не из функций, инициируемых из командной строки. Эта опция блокирует доступ к объекту в командной строке, но позволяет функциям обратного вызова обращаться к нему. |
'off' | Объект невидим в любое время. Эта опция используется для предотвращения непреднамеренных изменений пользовательского интерфейса другой функцией. Установите HandleVisibility на 'off' временно скрыть объект во время выполнения этой функции. |
Type
- Тип графического объекта'uibuttongroup'
Это свойство доступно только для чтения.
Тип графического объекта, возвращенный как 'uibuttongroup'
.
Tag
- Идентификатор объекта''
(по умолчанию) | символьный вектор | строковый скалярИдентификатор объекта, заданный как вектор символов или строковый скаляр. Можно задать уникальное Tag
значение, которое служит идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте вашего кода, вы можете использовать findobj
функция для поиска объекта на основе Tag
значение.
UserData
- Пользовательские данные[]
(по умолчанию) | массивПользовательские данные, заданные как любой массив MATLAB. Для примера можно задать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Используйте это свойство для хранения произвольных данных на объекте.
Если вы работаете в App Designer, создайте общие или частную собственность в приложении, чтобы делиться данными вместо использования UserData
свойство. Для получения дополнительной информации см. раздел «Обмен данными в приложениях App Designer».
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.