Exponenta Banner
exponenta event banner

Свойства ButureGroup

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

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

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

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

f = figure;
b = uibuttongroup(f);
b.BackgroundColor = [.5 .5 .5];

Название

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

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

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

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

Расположение заголовка, указанное как 'lefttop', 'centertop', 'righttop', 'leftbottom', 'centerbottom', или 'rightbottom'.

Цвет и стиль

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

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

Пример: [0 0 1]

Пример: 'b'

Пример: 'blue'

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

Тип границы, указанный как 'etchedin', 'none', 'etchedout', 'beveledin', 'beveledout', или 'line'.

  • Для 3-D внешнего вида используйте вытравленные или скошенные границы.

    Используйте HighlightColor и ShadowColor для указания цвета границ 3-D.

  • Для упрощения внешнего вида используйте границу линии.

    Используйте HighlightColor для указания цвета границы линии.

Ширина границы, заданная как положительное целое значение. Единица измерения - пиксели. Вытравленные и скошенные границы, ширина которых превышает три пикселя, могут отображаться неправильно в углах.

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

Примечание

Поведение Clipping свойство изменилось. Это больше не влияет на ButtonGroup объекты. Дочерние объекты теперь подрезаны к границам родительского контейнера независимо от значения этого свойства. Это свойство может быть удалено в следующем выпуске.

Шрифт

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

Имя шрифта, указанное как имя поддерживаемого системой шрифта или 'FixedWidth'. Шрифт по умолчанию зависит от конкретной операционной системы и языка.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любом языковом стандарте, укажите 'FixedWidth'. Фактически используемый шрифт фиксированной ширины зависит от FixedWidthFontName свойства корневого объекта. Изменение FixedWidthFontName приводит к немедленному обновлению отображения для использования нового шрифта.

Пример: 'Arial'

Размер шрифта, указанный как положительное число. FontUnits свойство определяет единицы измерения. Размер по умолчанию зависит от системы.

Пример: 12

Пример: 12.5

Вес шрифта, указанный как значение из следующей таблицы.

  • 'normal' - Вес по умолчанию, определенный определенным шрифтом

  • 'bold' - Более толстые очертания символов, чем обычно

MATLAB использует FontWeight для выбора шрифта из доступных в системе. Не все шрифты имеют жирный вес. Поэтому задание полужирного веса шрифта может привести к нормальному весу шрифта.

Примечание

'light' и 'demi' значения веса шрифта удалены в R2014b. При указании любого из этих значений получается обычный вес шрифта.

Угол шрифта, указанный как 'normal' или 'italic'. MATLAB использует это свойство для выбора шрифта из доступных в системе. Установка для этого свойства значения 'italic' выбирает наклонную версию шрифта, если она доступна в системе.

Примечание

'oblique' значение удалено. Использовать 'italic' вместо этого.

Единицы шрифта, указанные как одно из значений из этой таблицы.

Значение единицОписание
'points'Очки. Одна точка равна 1/72 дюйма.
'normalized'Нормализованные значения для указания размера шрифта как доли высоты. При изменении размера компонента пользовательского интерфейса MATLAB масштабирует отображаемый шрифт для сохранения этой дроби.
'inches'Дюймов.
'centimeters'Сантиметров.
'pixels'

Пикселы.

Начиная с R2015b, расстояния в пикселях не зависят от разрешения системы в системах Windows ® и Macintosh :

  • В системах Windows пиксель равен 1/96 дюйма.

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

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

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

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

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

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

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

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

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

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

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

Текущий переключатель или переключатель, указанный как UIControl объект.

Это свойство используется для определения выбранной кнопки в группе кнопок. Это свойство также можно использовать для установки выбора кнопки по умолчанию. Если выделение не требуется, установите для этого свойства значение [].

Значение по умолчанию для SelectedObject свойство является первым переключателем или переключателем, добавляемым в группу кнопок.

Примечание

SelectionChangedFcn обратный вызов не выполняется при установке SelectedObject программно.

Примечание

Поведение Selected свойство изменено в R2014b и не рекомендуется. Он больше не влияет на объекты этого типа. Это свойство может быть удалено в следующем выпуске.

Примечание

Поведение SelectionHighlight свойство изменено в R2014b и не рекомендуется. Он больше не влияет на объекты этого типа. Это свойство может быть удалено в следующем выпуске.

Положение

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

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

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

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

Примечание

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

Пример: Изменение одного значения в векторе положения

Можно комбинировать точечную нотацию и индексацию массива, если требуется изменить одно значение в Position вектор. Например, этот код устанавливает ширину в 0.5:

b = uibuttongroup;
b.Position(3) = 0.5;
b.Position
ans =

      0   0   0.5000  1.0000

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

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

СтоимостьОписание
leftРасстояние от внутреннего левого края родительского контейнера до внутреннего левого края группы кнопок.
bottomРасстояние от внутреннего нижнего края родительского контейнера до внутреннего нижнего края группы кнопок.
widthРасстояние между внутренними краями правой и левой границ группы кнопок.
heightРасстояние между внутренними краями верхней и нижней границ группы кнопок. Это расстояние исключает заголовок, если он существует.

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

Примечание

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

  • InnerPosition на значения влияет наличие заголовка, характеристики шрифта, BorderType, и BorderWidth.

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

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

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

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

Значение единицОписание
'normalized'Эти единицы нормализуются относительно родительского контейнера. Нижний левый угол контейнера соответствует (0,0) и карты верхнего правого угла для (1,1).
'pixels'

Пикселы.

Начиная с R2015b, расстояния в пикселях не зависят от разрешения системы в системах Windows и Macintosh:

  • В системах Windows пиксель равен 1/96 дюйма.

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

В системах Linux размер пикселя определяется разрешением вашей системы.

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

Эти единицы основаны на стандартном шрифте uicontrol объекта graphics root:

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

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

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

MATLAB измеряет все единицы измерения из левого нижнего угла родительского объекта.

При изменении значения Units свойство, рекомендуется вернуть ему значение по умолчанию после завершения вычисления, чтобы избежать влияния на другие функции, которые принимают Units свойство имеет значение по умолчанию.

Порядок, в котором задаются свойства Единицы измерения (Units) и Положение (Position), имеет следующие эффекты:

  • При указании Units перед Position свойство, затем наборы MATLAB Position с использованием указанных единиц измерения.

  • При указании Units после Position MATLAB устанавливает положение с использованием значения по умолчанию Units. Затем MATLAB преобразует Position значений эквивалентных значений в указанных единицах измерения.

Отзывы

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

Примечание

Имя этого свойства изменено с SelectionChangeFcn кому SelectionChangedFcn в R2014b.

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

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

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

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

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

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

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

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

Описание

OldValue

Ранее выбранная кнопка или [] если ни один не был выбран

NewValue

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

Source

Родитель ButtonGroup объект

EventName

'SelectionChanged'

Определение SelectionChangedFcn обратный вызов, чтобы программа ответила, когда пользователь выбирает различные кнопки в группе кнопок. Не кодируйте ответ в функциях обратного вызова отдельных компонентов.

Если вы хотите, чтобы другой компонент ответил на выбор, то функция обратного вызова этого компонента может получить доступ к выбранному переключателю или переключить кнопку из SelectedObject имущества ButtonGroup объект.

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

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

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

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

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

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

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

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

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

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

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

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

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

Совет

В качестве простой альтернативы заданию SizeChangedFcn обратный вызов, можно установить Units свойства всех объектов, помещенных в контейнер 'normalized'. При этом эти компоненты масштабируются пропорционально контейнеру.

Дополнительные сведения об управлении компоновками с помощью см. в разделе Программная компоновка пользовательского интерфейса SizeChangedFcn обратные вызовы.

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

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

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

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

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

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

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

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

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

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

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

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

Используйте gcbo функция в вашей CreateFcn для получения создаваемого объекта компонента.

Установка CreateFcn свойство для существующего объекта-компонента не влияет.

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

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

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

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

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

DeleteFcn свойство определяет функцию обратного вызова, выполняемую при удалении компонента MATLAB (например, при закрытии окна пользователем). MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта компонента. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.

Используйте gcbo функция в вашей DeleteFcn для получения удаляемого объекта компонента.

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

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

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

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

Примечание

Использование ResizeFcn свойство не рекомендуется. Он может быть удален в следующем выпуске. Использовать SizeChangedFcn вместо этого.

Типы данных: function_handle | cell | char

Управление выполнением обратного вызова

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

Пример, показывающий, как Interruptible и BusyAction свойства влияют на поведение программы.

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

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

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

BusyAction свойство источника обратного вызова прерывания определяет, как MATLAB обрабатывает его выполнение. BusyAction свойство имеет следующие значения:

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

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

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

  • on - Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь. Это значение по умолчанию.

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

Пример, показывающий, как BusyAction и Interruptible свойства влияют на поведение программы.

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

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

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

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

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

  • 'on' - устанавливает текущий объект в ButtonGroup когда пользователь щелкает компонент в запущенном приложении. CurrentObject имущества Figure и gco функция возвращает ButtonGroup в качестве текущего объекта.

  • 'off' - задает текущий объект в качестве ближайшего предка ButtonGroup чей HitTest является 'on' когда пользователь щелкает компонент в запущенном приложении.

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

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

Родительский объект, указанный как Figure, Panel, ButtonGroup, или Tab объект. Это свойство используется для указания родительского контейнера при создании компонента пользовательского интерфейса или для перемещения существующего компонента пользовательского интерфейса в другой родительский контейнер.

ButtonGroup children, возвращено как пустое GraphicsPlaceholder или 1-D массив компонентных объектов. Хотя группа кнопок управляет только выбором переключателей и переключателей, ее дочерними элементами могут быть экземпляры Axes, Panel, ButtonGroup, или любой стиль UIControl объекты.

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

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

Объекты с HandleVisibility свойство имеет значение 'off' не перечислены в Children собственность.

Видимость ButtonGroup дескриптор, указанный как 'on', 'callback', или 'off'.

Это свойство управляет видимостью ButtonGroup дескриптор в родительском списке потомков. Если дескриптор не виден в списке нижестоящих элементов родительского элемента, он не возвращается функциями, получающими дескрипторы путем поиска в иерархии объектов или запроса свойств дескриптора. Эти функции включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close. HandleVisibility свойство также управляет видимостью дескриптора объекта в родительском рисунке CurrentObject собственность. Дескрипторы остаются действительными, даже если они не видны. Если вы знаете дескриптор объекта, вы можете задать и получить его свойства и передать его любой функции, которая работает с дескрипторами.

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

Установка корня графики ShowHiddenHandles свойство для 'on' чтобы сделать видимыми все маркеры, независимо от их HandleVisibility значение. Этот параметр не влияет на их HandleVisibility значения.

Примечание

Не пытайтесь получить доступ к переключателям и переключателям, управляемым uibuttongroup вне группы кнопок. Установите HandleVisibility этих переключателей и переключателей 'off' для предотвращения случайного доступа.

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

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

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

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

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

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

Вопросы совместимости

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

Не рекомендуется начинать с R2020a

См. также

|

Темы

Представлен до R2006a

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

Поддержка