Exponenta Banner
exponenta event banner

Свойства UICcontrol

Управление внешним видом и поведением элементов управления пользовательского интерфейса

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

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

Элементы управления пользовательского интерфейса - это такие компоненты, как кнопки и ползунки, с которыми пользователи могут взаимодействовать. uicontrol создает элемент управления пользовательского интерфейса и задает все необходимые свойства перед его отображением. Изменяя значения свойств, можно изменять внешний вид и поведение элементов управления пользовательского интерфейса. Используйте точечную нотацию для ссылки на определенный объект и свойство.

f = figure;
b = uicontrol(f,'Style','pushbutton');
b.Position = [100 100 50 20];

Тип управления

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

Стиль UIControl, указанное как значение из следующей таблицы.

Значение стиляОписание
'pushbutton'Кнопка, которая нажимается до тех пор, пока не будет отпущена кнопка мыши.
'togglebutton'Кнопка, которая может иметь два состояния: вверх или вниз. Состояние кнопки переключения изменяется при каждом нажатии на нее.
'checkbox'Флажок, который может иметь два состояния: установлен или снят. Состояние изменяется при нажатии и отпускании кнопки мыши.
'radiobutton'Кнопка, которая может иметь два состояния: выбранная или невыбранная. Переключатели должны быть взаимоисключающими в группе связанных переключателей.
'edit'Редактируемое текстовое поле.
'text'Статическое текстовое поле.
'slider'Кнопка, которую пользователь нажимает вдоль горизонтальной или вертикальной полосы. Положение кнопки указывает значение в указанном диапазоне.
'listbox'Список элементов, из которых пользователь может выбрать один или несколько элементов. В отличие от всплывающих меню, список не расширяется при щелчке.
'popupmenu'Изолированное меню, которое разворачивается для отображения списка вариантов при щелчке на нем. При сворачивании в меню отображается текущий выбор.

Текущее значение, указанное как число. Value полезно для запроса или изменения состояния некоторых uicontrols:

Стиль uicontrolОписание свойства Value
'togglebutton'

  • Поднято: Value свойство равно значению Min собственность.

  • В депрессии: Value свойство равно значению Max собственность.

'checkbox'

  • Без флажка: Value изменение свойства на значение Min собственность.

  • Проверено: Value изменение свойства на значение Max собственность.

'radiobutton'

  • Отмена выбора: Value изменение свойства на значение Min собственность.

  • Выбрано: Value изменение свойства на значение Max собственность.

'slider'Value свойство равно соответствующему значению ползунка.
'listbox'Value свойство равно индексу массива, соответствующему выбранному элементу в списке. Значение 1 соответствует первому элементу списка.
'popupmenu'Value свойство равно индексу массива, соответствующему выбранному элементу во всплывающем меню. Значение 1 соответствует первому пункту всплывающего меню.

Максимальное значение, указанное как число. Max свойство влияет на представление определенных uiccontrols:

Стиль uicontrolОписание свойства Value
'togglebutton'При нажатии кнопки переключения Value изменение свойства на значение Max собственность.
'checkbox'Если флажок установлен, Value изменение свойства на значение Max собственность.
'radiobutton'Когда переключатель установлен, Value изменение свойства на значение Max собственность.
'edit'

Текстовое поле редактирования принимает несколько строк ввода, когда Max – Min > 1. В противном случае текстовое поле редактирования принимает одну строку ввода.

Абсолютные значения Max и Min не влияют на количество возможных строк. Если разница больше, чем 1, поле редактирования может содержать любое количество строк.

'slider' Max значение свойства - максимальное значение ползунка, которое должно быть больше, чем Min значение свойства.
'listbox' Max значение свойства помогает определить, может ли пользователь выбрать несколько элементов в списке одновременно. Если Max – Min > 1, то пользователь может выбрать несколько элементов одновременно. В противном случае пользователь не может выбрать несколько элементов одновременно. Если установить Max и Min чтобы разрешить несколько вариантов выбора, затем Value значение свойства может быть вектором индексов.

Минимальное значение, указанное как число. Min свойство влияет на представление определенных uiccontrols:

Стиль uicontrolОписание свойства Value
'togglebutton'При поднятой кнопке переключения Value изменение свойства на значение Min собственность.
'checkbox'Если флажок снят, Value изменение свойства на значение Min собственность.
'radiobutton'Когда переключатель снят, Value изменение свойства на значение Min собственность.
'edit'

Текстовое поле редактирования принимает несколько строк ввода, когда Max – Min > 1. В противном случае текстовое поле редактирования принимает одну строку ввода.

Абсолютные значения Max и Min не влияют на количество возможных строк. Если разница больше, чем 1, поле редактирования может содержать любое количество строк.

'slider' Min значение свойства - минимальное значение ползунка, которое должно быть меньше Max значение свойства.
'listbox' Max значение свойства помогает определить, может ли пользователь выбрать несколько элементов в списке одновременно. Если Max – Min > 1, то пользователь может выбрать несколько элементов одновременно. В противном случае пользователь не может выбрать несколько элементов одновременно. Если установить Max и Min чтобы разрешить несколько вариантов выбора, затем Value значение свойства может быть вектором индексов.

Размер шага ползунка, указанный как массив, [minorstep majorstep]. Это свойство управляет величиной изменения значения ползунка, когда пользователь нажимает кнопки со стрелками или ползунок (канал ползунка):

  • minorstep - доля диапазона ползунка, на которую Value увеличивается или уменьшается при нажатии пользователем одной из кнопок со стрелками.

  • majorstep - доля диапазона ползунка, на которую Value увеличивается или уменьшается, когда пользователь щелкает ползунок.

Когда значение majorstep больше 1, доля ползуна не больше 100%.

Оба minorstep и majorstep должно быть больше, чем 1e-6, и minorstep должно быть меньше или равно majorstep.

Как majorstep увеличивается, индикатор ползунка увеличивается. Когда majorstep равно 1индикатор большого пальца в два раза длиннее желоба. Индикатор большого пальца больше для majorstep значения, превышающие 1.

Пример

Этот ползунок имеет диапазон Max – Min = 1. Ползунок Value при нажатии пользователем кнопки со стрелкой свойство изменяется на 1%. Он изменяется на 10%, когда пользователь щелкает в желобе.

s = uicontrol('Style','Slider','Min',0,'Max',1,'SliderStep',[0.01 0.10]);

Индекс верхнего элемента в списке, указанный как целое число. Это свойство применяется только к стилю listbox UIControl. Это свойство указывает, какой элемент отображается в самом верхнем поле списка, которое недостаточно велико для отображения всех записей списка. ListboxTop значение является индексом в массиве, указанном как String значение свойства. ListboxTop значение должно быть между 1 и количество элементов в массиве. Неинтегренные значения фиксируются следующим наименьшим целым числом.

Примечание

String и Value свойства могут переопределять значение ListboxTop независимо от свойства ListboxTop значение, которое вы указываете. ListboxTop значение может изменяться в зависимости от значения другого UIControl свойства. Например, явная установка Value свойство прокручивает список до этого значения.

Для получения наиболее надежных результатов выполните запрос или измените ListboxTop свойство после того, как MATLAB ® завершит рисование элемента управления пользовательского интерфейса на экране.

Текст и стиль

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

Текст для отображения, заданный как символьный вектор, массив ячеек из символьных векторов, строковый массив, категориальный массив или вектор строки с разделителями. Style свойство определяет формат массива, который можно использовать.

Свойство стиляПоддерживаемые форматы массивовПримеры
'pushbutton'

Символьный вектор


Массив ячеек символьных векторов


Строковый массив


Категориальный массив

'Option 1'


{'Option 1'}


"Option 1"


categorical({'Option 1'})

'togglebutton'
'checkbox'
'radiobutton'
'edit'
'text'
'listbox'

Символьный вектор


Массив ячеек символьных векторов


Строковый массив


Категориальный массив


Вектор строки с разделителями-трубами

'One'


{'One','Two','Three'}


["One" "Two" "Three"]


categorical({'one','two','three'})


'One|Two|Three'

'popupmenu'

Примечание

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

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

Примечание

При изменении значения ForegroundColor для listbox, то MATLAB использует этот цвет для всех элементов listbox, за исключением текущего выбранного элемента listbox. Для выбранных элементов MATLAB использует цвет, который обеспечивает хороший контраст между текстом выбранных элементов и цветом выбора.

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

Пример: 'b'

Пример: 'blue'

Типы данных: double | char

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

Необязательный значок, заданный как 3-D массив значений truecolor RGB. Значения в массиве могут быть следующими:

  • Значения двойной точности между 0.0 и 1.0

  • uint8 значения между 0 и 255

Кнопки и переключатели являются единственными UIControl объекты, полностью поддерживающие CData. При указании CData для переключателя или флажка, изображение может перекрываться с текстом. Кроме того, указание изображения для переключателя или флажка отключает возможность отображения при выборе или отмене выбора.

Типы данных: double | uint8

Шрифт

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

Имя шрифта, указанное как имя поддерживаемого системой шрифта или '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' для всех компонентов пользовательского интерфейса, которые не должны появляться при запуске.

Рабочее состояние управления пользовательским интерфейсом, указанное как 'on', 'off', или 'inactive'. Enable определяет, реагирует ли элемент управления пользовательского интерфейса на взаимодействие с пользователем. Возможны следующие значения:

  • 'on' - Управление пользовательским интерфейсом работает.

  • 'off' - элемент управления пользовательского интерфейса не работает и отображается серым цветом.

  • 'inactive' - Управление пользовательским интерфейсом не работает, но имеет тот же вид, что и когда Enable имеет значение 'on'.

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

Для создания нескольких строк текста используйте sprintf для вставки новых символов строки ('\n') в вашем тексте. Например:

txt = sprintf('Line 1\nLine 2');

Затем установите Tooltip свойство к значению, возвращенному sprintf.

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

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

Примечание

TooltipString не рекомендуется запускать свойство в R2018b. Используйте Tooltip вместо этого свойство.

Примечание

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

Примечание

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

Положение

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

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

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

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

Примечание

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

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

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

b = uicontrol;
b.Position(3) = 52;
b.Position
ans =

    20    20    52    20

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

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

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

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

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

Размер охватывающего прямоугольника, возвращаемого в виде четырехэлементного вектора строки. Первые два элемента вектора всегда равны нулю. Третий и четвертый элементы - ширина и высота прямоугольника соответственно. Все измерения в единицах, указанных Units собственность.

MATLAB определяет размер прямоугольника на основе размера String значение свойства и характеристики шрифта. Настройка ширины и высоты в соответствии с размером String значение, установите Position значения ширины и высоты должны быть немного больше, чем Extent значения ширины и высоты.

Для String значение, которое является одной строкой текста, элемент высоты Extent свойство указывает высоту одной строки. Элемент width указывает ширину самой длинной строки, даже если текст переносится при отображении на элементе управления. Для нескольких строк текста: Extent прямоугольник охватывает все строки текста. Редактируемые текстовые поля считаются многострочными, если Max – Min > 1.

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

Значение единицОписание
'pixels' (по умолчанию)

Пикселы.

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

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

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

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

'normalized'Эти единицы нормализуются относительно родительского контейнера. Нижний левый угол контейнера соответствует (0,0) и карты верхнего правого угла для (1,1).
'inches'Дюймов.
'centimeters'Сантиметров.
'points'Очки. Одна точка равна 1/72-й дюйма.
'characters'

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

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

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

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

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

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

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

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

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

Выравнивание текста uicontrol, указанного как 'center', 'left', или 'right'. Это свойство определяет выравнивание String текст свойства.

HorizontalAlignment свойство влияет только на 'text' и 'edit' стили uiccontrols.

Отзывы

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

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

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

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

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

Эта функция выполняется в ответ на действия пользователя, такие как нажатие кнопки, перемещение ползунка или выбор флажка. Эта функция может выполняться только в том случае, если Enable имущества UIControl объект имеет значение 'on'.

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

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

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

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

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

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

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

ButtonDownFcn Обратный вызов - это функция, выполняемая при нажатии кнопки мыши на компоненте пользовательского интерфейса. Обратный вызов выполняется в следующих ситуациях:

  • Пользователь щелкает правой кнопкой мыши компонент пользовательского интерфейса и Enable свойство имеет значение 'on'.

  • Пользователь щелкает правой кнопкой мыши или левой кнопкой мыши компонент пользовательского интерфейса и Enable свойство имеет значение 'off' или 'inactive'.

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

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

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

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

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

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

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

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

Описание

Примеры:

a

=

Изменение

Смена-а

CharacterСимвол, отображаемый в результате нажатия клавиши или клавиш. Символ может быть пустым или непечатаемым.'a''=''''A'
ModifierМассив ячеек, содержащий имена одной или нескольких клавиш-модификаторов, которые нажимаются (например, Ctrl, Alt, Shift).{1x0 cell}{1x0 cell}{'shift'}{'shift'}
KeyНажимаемая клавиша, обозначаемая меткой (в нижнем регистре) на клавише или текстовым описанием.'a''equal''shift''a'
SourceОбъект, имеющий фокус при нажатии пользователем клавиши.UIControl объектUIControl объектUIControl объектUIControl объект
EventNameДействие, вызвавшее выполнение функции обратного вызова.'KeyPress''KeyPress''KeyPress''KeyPress'

Нажатие клавиш-модификаторов влияет на данные обратного вызова следующими способами:

  • Клавиши-модификаторы могут влиять на Character свойство, но не изменять Key собственность.

  • Некоторые клавиши и клавиши, измененные с помощью Ctrl, помещают непечатаемые символы в Character собственность.

  • Клавиши Ctrl, Alt, Shift и некоторые другие клавиши не генерируются Character данные свойств.

Также можно запросить CurrentCharacter свойство фигуры, чтобы определить, какой символ нажал пользователь.

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

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

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

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

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

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

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

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

Описание

Примеры:

a

=

Изменение

Смена-а

Character

Интерпретация символов ключа, который был выпущен.

'a''=''''A'
Modifier

Текущий модификатор, например 'control'или пустой массив ячеек, если модификатор отсутствует.

{1x0 cell}{1x0 cell}{1x0 cell}{1x0 cell}
Key

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

'a''equal''shift''a'
SourceОбъект, имеющий фокус при нажатии пользователем клавиши.UIControl объектUIControl объектUIControl объектUIControl объект
EventNameДействие, вызвавшее выполнение функции обратного вызова.'ase''ase''ase''ase'

Нажатие клавиш-модификаторов влияет на данные обратного вызова следующими способами:

  • Клавиши-модификаторы могут влиять на Character свойство, но не изменять Key собственность.

  • Некоторые клавиши и клавиши, измененные с помощью Ctrl, помещают непечатаемые символы в Character собственность.

  • Клавиши Ctrl, Alt, Shift и некоторые другие клавиши не генерируются Character данные свойств.

Также можно запросить CurrentCharacter свойство фигуры, чтобы определить, какой символ нажал пользователь.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Прерывание обратного вызова, указанное как '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' - устанавливает текущий объект в UIControl когда пользователь щелкает компонент в запущенном приложении. CurrentObject имущества Figure и gco функция возвращает UIControl в качестве текущего объекта.

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

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

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

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

UIControl потомков, возвращенных в виде пустого массива. UIControl объекты не имеют потомков. Установка этого свойства не влияет.

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

См. также

Темы

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

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

Поддержка