Управляйте внешним видом и поведением управления пользовательским интерфейсом
Свойства, перечисленные здесь, допустимы для объектов UIControl
в GUIDE или в приложениях, созданных с функцией figure
. App Designer является рекомендуемой средой для создания приложений. Для получения дополнительной информации см. Мигрирующие Приложения GUIDE к App Designer.
Средства управления пользовательским интерфейсом являются компонентами, такими как кнопки и ползунки, с которыми могут взаимодействовать пользователи. Функция uicontrol
создает управление пользовательским интерфейсом и устанавливает любые необходимые свойства прежде, чем отобразить его. Путем изменения значений свойств можно изменить внешний вид и поведение средств управления пользовательским интерфейсом. Используйте запись через точку, чтобы относиться к конкретному объекту и свойству.
f = figure; b = uicontrol(f,'Style','pushbutton'); b.Position = [100 100 50 20];
Style
— Стиль UIControl
'pushbutton'
(значение по умолчанию) | 'togglebutton'
| 'checkbox'
| 'radiobutton'
|...Стиль UIControl
, заданного как значение из следующей таблицы.
Разработайте значение | Описание |
---|---|
'pushbutton' | Кнопка, которая, кажется, снижает, пока вы не отпускаете кнопку мыши. |
'togglebutton' | Кнопка, которая может иметь два состояния: или подавленный. Состояние кнопки-переключателя изменяется каждый раз, когда вы кликаете по нему. |
'checkbox' | Флажок, который может иметь два состояния: проверяемый или неконтролируемый. Изменения состояния, когда пользователь кликает и отпускает кнопку мыши по нему. |
'radiobutton' | Кнопка, которая может иметь два состояния: выбранный или невыбранный. Переключатели предназначаются, чтобы быть взаимоисключающими в группе связанных переключателей. |
'edit' | Доступное для редактирования текстовое поле. |
'text' | Поле статического текста. |
'slider' | Кнопка, что пользователь уходит горизонтальная или вертикальная панель. Положение кнопки указывает на значение в заданной области значений. |
'listbox' | Список элементов, из которых пользователь может выбрать один или несколько элементов. В отличие от всплывающих меню, поля списков не расширяются, когда кликнувшийся. |
'popupmenu' | Изолированное меню, которое расширяется, чтобы отобразить список выбора, когда вы кликаете по нему. Когда это сворачивается, меню показывает текущий выбор. |
Значение
Текущее значениеТекущее значение, заданное как номер. Свойство Value
полезно в запросе или изменении состояния определенных uicontrol:
Стиль uicontrol | Описание свойства значения |
---|---|
'togglebutton' |
|
'checkbox' |
|
'radiobutton' |
|
'slider' | Свойство Value равняется соответствующему значению ползунка. |
'listbox' | Свойство Value равняется индексу массива, соответствующему выбранному пункту в поле списка. Значение 1 соответствует первому элементу в списке. |
'popupmenu' | Свойство Value равняется индексу массива, соответствующему выбранному пункту во всплывающем меню. Значение 1 соответствует первому элементу во всплывающем меню. |
Max
Максимальное значение1
(значение по умолчанию) | номерМаксимальное значение, заданное как номер. Свойство Max
влияет на представление определенных uicontrol:
Стиль uicontrol | Описание свойства значения |
---|---|
'togglebutton' | Когда кнопка-переключатель подавлена, изменения свойства Value в значении свойства Max . |
'checkbox' | Когда флажок проверяется, изменения свойства Value в значении свойства Max . |
'radiobutton' | Когда переключатель устанавливается, изменения свойства Value в значении свойства Max . |
'edit' | Текстовое поле редактирования принимает несколько строк входа когда Абсолютные значения |
'slider' | Значение свойства Max является максимальным значением ползунка, которое должно быть больше, чем значение свойства Min . |
'listbox' | Значение свойства Max помогает определить, может ли пользователь выбрать несколько элементов в поле списка одновременно. Если Max – Min > 1, то пользователь может выбрать несколько элементов одновременно. В противном случае пользователь не может выбрать несколько элементов одновременно. Если вы устанавливаете свойства Max и Min позволить множественные выборы, то значение свойства Value может быть вектором индексов. |
Min
Минимальное значение0
(значение по умолчанию) | номерМинимальное значение, заданное как номер. Свойство Min
влияет на представление определенных uicontrol:
Стиль uicontrol | Описание свойства значения |
---|---|
'togglebutton' | Когда кнопка-переключатель повышена, изменения свойства Value в значении свойства Min . |
'checkbox' | Когда флажок неконтролируем, изменения свойства Value в значении свойства Min . |
'radiobutton' | Когда переключатель снимается, изменения свойства Value в значении свойства Min . |
'edit' | Текстовое поле редактирования принимает несколько строк входа когда Абсолютные значения |
'slider' | Значение свойства Min является минимальным значением ползунка, которое должно быть меньше, чем значение свойства Max . |
'listbox' | Значение свойства Max помогает определить, может ли пользователь выбрать несколько элементов в поле списка одновременно. Если Max – Min > 1, то пользователь может выбрать несколько элементов одновременно. В противном случае пользователь не может выбрать несколько элементов одновременно. Если вы устанавливаете свойства Max и Min позволить множественные выборы, то значение свойства Value может быть вектором индексов. |
SliderStep
Размер шага ползунка[0.01 0.10]
(значение по умолчанию) | [minorstep majorstep]
Размер шага ползунка, заданный как массив, [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]);
ListboxTop
Индекс главного элемента в поле списка1
(значение по умолчанию) | целочисленное значениеИндекс главного элемента в поле списка, заданном как целочисленное значение. Это свойство применяется только к стилю поля списка UIControl
. Это свойство задает, какой элемент появляется в самом верхнем положении в поле списка, которое не является достаточно большим, чтобы отобразить все записи списка. Значение ListboxTop
является индексом в массив вас, задают как значение свойства String
. Значение ListboxTop
должно быть между 1
и числом элементов в массиве. Значения нецелого числа фиксируются к следующему самому низкому целому числу.
Свойства String
и Value
могут заменить значение свойства ListboxTop
независимо от значения ListboxTop
, которое вы задаете. Значение ListboxTop
может измениться в зависимости от значения других свойств UIControl
. Например, явным образом установка свойства Value
прокручивает список к тому значению.
Для самых надежных результатов запросите или измените свойство ListboxTop
после того, как MATLAB® закончит чертить управление пользовательским интерфейсом на экране.
Строка
Текст, чтобы отобразитьсяТекст, чтобы отобразиться, заданный как вектор символов, массив ячеек из символьных векторов, массив строк, категориальный массив или разграниченный каналом вектор - строка. Свойство Style
диктует формат массивов, который можно использовать.
Свойство стиля | Форматы поддерживаемого массива | Примеры |
---|---|---|
'pushbutton' | Символьный вектор Массив ячеек из символьных векторов StringArray Категориальный массив |
|
'togglebutton' | ||
'checkbox' | ||
'radiobutton' | ||
'edit' | ||
'text' | ||
'listbox' | Символьный вектор Массив ячеек из символьных векторов StringArray Категориальный массив Разграниченный каналом вектор - строка |
|
'popupmenu' |
Если вы задаете массив ячеек или категориальный массив для кнопки, кнопки-переключателя, флажка или переключателя, MATLAB отображает только первый элемент в массиве.
ForegroundColor
TextColor [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' |
Если вы изменяете значение ForegroundColor
для поля списка, то использование MATLAB, которое окрашивает для всех элементов поля списка, за исключением в настоящее время выбранного элемента поля списка. Для выбранных пунктов MATLAB использует цвет, который гарантирует хороший контраст между текстом выбранных пунктов и цветом выделения.
Пример: [0 0 1]
Пример: 'b'
Пример: 'blue'
Типы данных: double
| char
BackgroundColor
BackgroundColor [.94 .94 .94]
(значение по умолчанию) | триплет 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' |
CData
Необязательный значокНеобязательный значок, заданный как трехмерный массив значений RGB истинного цвета. Значения в массиве могут быть:
Значения с двойной точностью между 0.0
и 1.0
Значения uint8
между 0
и 255
Кнопки и кнопки-переключатели являются единственными объектами UIControl
, это полностью поддерживает CData
. Если вы задаете свойство CData
для переключателя или флажка, изображение может наложиться с текстом. Кроме того, определение изображения для переключателя или флажка отключает способность показать, когда они выбраны или невыбранные.
Типы данных: double
| uint8
FontName
FontName 'FixedWidth'
Название шрифта, заданное как система, поддержало название шрифта или 'FixedWidth'
. Шрифт по умолчанию зависит от конкретной операционной системы и локали.
Чтобы использовать шрифт фиксированной ширины, который выглядит хорошим в любой локали, задайте 'FixedWidth'
. Фактический используемый шрифт фиксированной ширины зависит от свойства FixedWidthFontName
корневого объекта. Изменение свойства FixedWidthFontName
заставляет незамедлительное обновление отображения использовать новый шрифт.
Пример: 'Arial'
'FontSize'
'FontSize' Размер шрифта, заданный в виде положительного числа. Свойство FontUnits
задает модули. Размер по умолчанию системно-зависим.
Пример: 12
Пример: 12.5
FontWeight
FontWeight 'normal'
(значение по умолчанию) | 'bold'
Толщина шрифта, заданная как значение из следующей таблицы.
normal' — Насыщенность по умолчанию, определяемая конкретным видом шрифта
'bold' — более тонкие контуры символов, чем 'normal'
MATLAB использует свойство FontWeight
выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирное начертание шрифта. Поэтому установка жирного шрифта все еще привести к установке обычного шрифта.
'light'
и значения толщины шрифта 'demi'
были удалены в R2014b. Если вы задаете любое из этих значений, результатом является обычная толщина шрифта.
FontAngle
FontAngle 'normal'
(значение по умолчанию) | 'italic'
Угол шрифта, заданный как 'normal'
или 'italic'
. MATLAB использует это свойство выбрать шрифт от доступных в вашей системе. Установка этого свойства к 'italic'
выбирает наклонную версию шрифта, если это доступно в вашей системе.
Значение 'oblique'
было удалено. Используйте 'italic'
вместо этого.
'FontUnits'
'FontUnits' 'points'
(значение по умолчанию) | 'normalized'
| 'inches'
| 'centimeters'
| 'pixels'
Модули шрифта, заданные как одно из значений из этой таблицы.
Модульное значение | Описание |
---|---|
'points' | 'points'. Одна точка является 1/72-й из дюйма. |
'normalized' | Нормированные значения для определения размера шрифта как часть высоты. Когда вы изменяете размер компонента пользовательского интерфейса, MATLAB масштабирует отображенный шрифт, чтобы поддержать ту часть. |
'inches' | 'inches'. |
'centimeters' | 'centimeters'. |
'pixels' | 'pixels'. Начиная с версии R2015b, значения размеров в пикселях не зависят от вашего системного разрешения в системах Windows® и Macintosh:
В системах Linux® размер пикселя определяется вашим системным разрешением. |
Visible
— Видимость управления пользовательским интерфейсом'on'
(значение по умолчанию) | 'off'
Видимость управления пользовательским интерфейсом, заданная как 'on'
или 'off'
. Когда Visible
является 'off'
, управление пользовательским интерфейсом не видимо, но можно запросить и установить его свойства.
Чтобы заставить ваше приложение запуститься быстрее, установите свойство Visible
всех средств управления пользовательским интерфейсом, которые первоначально не отображены к 'off'
.
Enable
— Рабочее состояние управления пользовательским интерфейсом'on'
(значение по умолчанию) | 'off'
| 'inactive'
Рабочее состояние управления пользовательским интерфейсом, заданного как 'on'
, 'off'
или 'inactive'
. Свойство Enable
управляет, отвечает ли управление пользовательским интерфейсом на взаимодействие с пользователем. Это возможные значения:
'on'
– Управление пользовательским интерфейсом является операционным.
'off'
Управление пользовательским интерфейсом не является операционным и появляется grayed.
'inactive'
– Управление пользовательским интерфейсом не является операционным, но оно имеет тот же внешний вид как тогда, когда Enable
установлен в 'on'
.
Tooltip
— ПодсказкаПодсказка, заданная как вектор символов, представляет в виде строки скаляр или категориальный массив. Используйте это свойство отобразить сообщение, когда пользователь наведет указатель на компонент во время выполнения. Подсказка не отображается, когда компонент отключен. Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, не полный набор категорий.
Чтобы создать несколько строк текста, используйте функцию sprintf
, чтобы вставить символы новой строки ('\n'
) в ваш текст. Например:
txt = sprintf('Line 1\nLine 2');
Затем установите свойство Tooltip
на значение, возвращенное sprintf
.
UIContextMenu
Контекстное менюGraphicsPlaceholder
(значение по умолчанию) | uicontextmenu объектКонтекстное меню, заданное как объект ContextMenu.
Используйте это свойство отобразить контекстное меню, когда пользователь щелкнет правой кнопкой по компоненту UI. Создайте контекстное меню с помощью функции uicontextmenu.
TooltipString
Подсказка (не рекомендуемый)Подсказка, заданная как вектор символов, представляет в виде строки скаляр или категориальный массив. Подсказка отображается, когда пользователь наводит указатель мыши на компонент в приложении. Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, не полный набор категорий.
Свойство TooltipString
не рекомендуется, начиная в R2018b. Используйте свойство Tooltip
вместо этого.
Selected
— Состояние выбора (не рекомендуемый)'off'
(значение по умолчанию) | 'on'
Поведение свойства Selected
, измененного в R2014b, и это не рекомендуется. Это больше не имеет эффекта на объекты UIControl
. Это свойство может быть удалено в будущем релизе.
SelectionHighlight
Отображение маркеров выделения (не рекомендуемый)'on'
(значение по умолчанию) | 'off'
Поведение свойства SelectionHighlight
, измененного в R2014b, и это не рекомендуется. Это больше не имеет эффекта на объекты UIControl
. Это свойство может быть удалено в будущем релизе.
Position
— Расположение и размер[left bottom width height]
Местоположение и размер, заданный как четырехэлементный вектор формы [left bottom width height]
. В этой таблице описываются каждый элемент в векторе.
Элемент | Описание |
---|---|
left | Расстояние от внутреннего левого края родительского контейнера к внешнему левому краю управления пользовательским интерфейсом |
bottom | Расстояние от внутреннего базового края родительского контейнера к внешнему базовому краю управления пользовательским интерфейсом |
width | Расстояние между правыми и левыми внешними краями управления пользовательским интерфейсом |
height | Расстояние между верхними и нижними внешними краями управления пользовательским интерфейсом |
Все измерения указаны в единицах, заданных свойством Units.
Значения Position
относительно drawable area родительского контейнера. Область векторной и растровой графики является областью в границах контейнера и не включает область, занятую заголовком. Если родительский контейнер является фигурой, то область векторной и растровой графики также исключает панель меню и панель инструментов.
Можно объединить запись через точку и индексацию массива когда это необходимо, чтобы изменить одно значение в векторе Position
. Например, этот код изменяет ширину управления пользовательским интерфейсом к 52
:
b = uicontrol; b.Position(3) = 52; b.Position
ans = 20 20 52 20
InnerPosition
Расположение и размер[left bottom width height]
Местоположение и размер, заданный как четырехэлементный вектор формы [left bottom width height]
. Все измерения указаны в единицах, заданных свойством Units.
Это значение свойства идентично значениям свойств OuterPosition
и Position
.
OuterPosition
Расположение и размер[left bottom width height]
Местоположение и размер, заданный как четырехэлементный вектор формы [left bottom width height]
. Все измерения указаны в единицах, заданных свойством Units.
Это значение свойства идентично значениям свойств InnerPosition
и Position
.
Extent
— Размер включения прямоугольникаЭто свойство доступно только для чтения.
Размер включения прямоугольника, возвращенного как четырехэлементный вектор - строка. Первые два элемента вектора всегда являются нулем. Третьи и четвертые элементы являются шириной и высотой прямоугольника, соответственно. Все измерения указаны в единицах, заданных свойством Units.
MATLAB определяет размер прямоугольника на основе размера значения свойства String
и характеристик шрифта. Чтобы настроить ширину и высоту, чтобы разместить размер значения String
, установите значения ширины и высоты Position
быть немного больше, чем значения ширины и высоты Extent
.
Для значения String
, которое является одной строкой текста, элемент высоты свойства Extent
указывает на высоту одной строки. Элемент ширины указывает на ширину самой длинной строки, даже если текст переносится, когда отображено на управлении. Для нескольких строк текста прямоугольник Extent
охватывает все строки текста. Доступные для редактирования текстовые поля рассматриваются мультилинией если Max
– Min
> 1
.
Модули
Модули измерения'pixels'
(значение по умолчанию) | 'normalized'
| 'inches'
| 'centimeters'
| 'points'
| 'characters'
Модули измерения, заданного как одно из значений из этой таблицы.
Модульное значение | Описание |
---|---|
'pixels' (значение по умолчанию) | 'pixels'. Начиная в R2015b, расстояния в пикселях независимы от вашего системного разрешения по системам Макинтоша и Windows:
В системах Linux размер пикселя определяется вашим системным разрешением. |
'normalized' | Эти модули нормированы относительно родительского контейнера. Нижний левый угол контейнера сопоставляет с (0,0) , и верхний правый угол сопоставляет с (1,1) . |
'inches' | 'inches'. |
'centimeters' | 'centimeters'. |
'points' | 'points'. Одна точка равняется 1/72-й из дюйма. |
'characters' | Эти модули основаны на шрифте uicontrol по умолчанию графического корневого объекта:
Чтобы получить доступ к шрифту uicontrol по умолчанию, используйте |
MATLAB измеряет все модули от левого нижнего угла родительского объекта.
Это свойство влияет на свойство Position
. Если вы изменяете свойство Units
, полагаете, что возвращение его значения к значению по умолчанию после завершения вашего вычисления старается не влиять на другие функции, которые принимают значение по умолчанию.
Порядок, в котором вы задаете свойства Units
и Position
, имеет эти эффекты:
Если вы задаете Units
перед свойством Position
, то MATLAB устанавливает Position
с помощью модулей, которые вы задаете.
Если вы задаете свойство Units
после того, как свойство Position
, MATLAB установит положение с помощью Units
по умолчанию. Затем MATLAB преобразовывает значение Position
в эквивалентную стоимость в модулях, которые вы задаете.
HorizontalAlignment
Выравнивание текста uicontrol'center'
(значение по умолчанию) | 'left'
| 'right'
Выравнивание текста uicontrol, заданного как 'center'
, 'left'
или 'right'
. Это свойство определяет выравнивание текста свойства String
.
Свойство HorizontalAlignment
влияет только на 'text'
и стили 'edit'
uicontrol.
'callback'
Первичная функция обратного вызова''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовПервичная функция обратного вызова, заданная как одно из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Эта функция выполняется в ответ на взаимодействие с пользователем, такое как кнопка щелкает, перемещения ползунка или выборы флажка. Эта функция может выполниться только, когда свойство Enable
объекта UIControl
установлено в 'on'
.
Типы данных: function_handle
| cell
| char
'ButtonDownFcn'
Функция обратного вызова нажатия кнопки''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция обратного вызова нажатия кнопки, заданная как одно из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Коллбэк ButtonDownFcn
является функцией, которая выполняется, когда пользователь щелкает кнопкой мыши по компоненту пользовательского интерфейса. Коллбэк выполняется в следующих ситуациях:
Пользователь щелкает правой кнопкой по компоненту пользовательского интерфейса, и свойство Enable
установлено в 'on'
.
Пользователь щелкает правой кнопкой или щелкает левой кнопкой по компоненту пользовательского интерфейса, и свойство Enable
установлено в 'off'
или 'inactive'
.
KeyPressFcn
Функция обратного вызова нажатия клавиши''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция обратного вызова нажатия клавиши, заданная как одно из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Эта функция обратного вызова выполняется, когда объект UIControl
фокусируется, и пользователь нажимает клавишу. Если вы не задаете функцию для этого свойства, MATLAB передает нажатия клавиш родительской фигуре. Повторные нажатия клавиш сохраняют особое внимание объекта UIControl
, и функция выполняется с каждым нажатием клавиши. Если пользователь нажимает несколько клавиш приблизительно в то же время, MATLAB обнаруживает нажатие клавиши для последней нажатой клавиши.
Если вы задаете это свойство как указатель на функцию (или массив ячеек, содержащий указатель на функцию), MATLAB передает объект, содержащий данные о коллбэке в качестве второго аргумента к функции обратного вызова. Этот объект содержит свойства, описанные в следующей таблице. Можно получить доступ к этим свойствам в функции обратного вызова с помощью записи через точку.
Свойство | Описание | Примеры: | |||
---|---|---|---|---|---|
a | = | Сдвиг | Shift-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
фигуры определить, которые изображают нажатого пользователя.
KeyReleaseFcn
Функция обратного вызова ключевого релиза''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция обратного вызова ключевого релиза, заданная как одно из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Эта функция обратного вызова выполняется, когда объект UIControl
фокусируется, и пользователь отпускает клавишу.
Если вы задаете это свойство как указатель на функцию (или массив ячеек, содержащий указатель на функцию), MATLAB передает объект, содержащий данные о коллбэке в качестве второго аргумента к функции обратного вызова. Этот объект содержит свойства, описанные в следующей таблице. Можно получить доступ к этим свойствам в функции обратного вызова с помощью записи через точку.
Свойство | Описание | Примеры: | |||
---|---|---|---|---|---|
a | = | Сдвиг | Shift-a | ||
Character | Символьная интерпретация клавиши, которая была отпущена. | 'a' | '=' | '' | 'A' |
Modifier | Текущий модификатор, такой как | {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
фигуры определить, которые изображают нажатого пользователя.
CreateFcn — функция создания компонентов
''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция создания компонентов, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Это свойство задает функцию обратного вызова, чтобы выполниться, когда MATLAB создает компонент. MATLAB инициализирует все значения свойства компонентов прежде, чем выполнить коллбэк CreateFcn
. Если вы не задаете свойство CreateFcn, то MATLAB выполняет функцию создания по умолчанию.
Используйте функцию gcbo
в своем коде CreateFcn
, чтобы получить объект компонента, который создается.
Установка свойства CreateFcn
на существующем объекте компонента не имеет никакого эффекта.
DeleteFcn — функция удаления компонентов
''
(значение по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция удаления компонента, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Свойство DeleteFcn
задает функцию обратного вызова, чтобы выполниться, когда MATLAB удаляет компонент (например, когда пользователь закрывает окно). MATLAB выполняет коллбэк DeleteFcn
прежде, чем уничтожить свойства объекта компонента. Если вы не задаете свойство DeleteFcn, то MATLAB выполняет функцию удаления по умолчанию.
Используйте функцию gcbo
в своем коде DeleteFcn
, чтобы получить объект компонента, который удаляется.
Interruptible
— Прерывание коллбэка'on'
(значение по умолчанию) | 'off'
Прерывание обратного вызова, обозначаемое как 'on' или 'off'.
Свойство «Прерывание» определяет, можно ли прерывать выполняемый обратный вызов.
Существует два состояния обратного вызова:
Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.
Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.
Каждый раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать текущий обратный вызов (если он существует). Свойство «Прерывание» объекта, имеющего текущий обратный вызов, определяет, разрешено ли прерывание:
Значение 'on' позволяет другим обратным вызовам прерывать обратные вызовы объекта.
Прерывание происходит на следующем этапе, где MATLAB обрабатывает очередь, такой как тогда, когда существует drawnow
, figure
, getframe
, waitfor
или pause
.
Если текущий обратный вызов содержит одну из этих команд, MATLAB останавливает выполнение обратного вызова в этой точке и выполняет прерывание обратного вызова. MATLAB возобновляет выполнение обратного вызова при завершении прерывания.
Если текущий обратный вызов не содержит одну из этих команд, MATLAB завершает выполнение обратного вызова без прерывания.
Значение 'off' блокирует все попытки прерывания.
Свойство BusyAction объекта, владеющего прерывистым обратным вызовом, определяет, отменяется ли прерывание обратного вызова или помещается в очередь.
Прерывание и выполнение обратного вызова происходят по-разному в таких ситуациях:
Если прерывающий обратный вызов является обратным вызовом DeleteFcn, CloseRequestFcn или SizeChangedFcn, то прерывание происходит независимо от значения свойства прерывания.
Если текущий обратный вызов выполняет функцию waitfor, то прерывание происходит независимо от значения свойства прерывания.
Объекты-таймеры выполняются в соответствии с расписанием независимо от значения свойства прерывания.
MATLAB не сохраняет состояние свойств или отображения, когда прерывание происходит. Например, объект, возвращенный командой gca или gcf, может измениться при выполнении другого обратного вызова.
Смотрите Выполнение обратного вызова Прерывания для примера, который показывает, как свойства Interruptible
и BusyAction
влияют на поведение программы.
BusyAction
Постановка в очередь коллбэка'queue'
(значение по умолчанию) | 'cancel'
Постановка в очередь коллбэка, заданная как 'queue'
(значение по умолчанию) или 'cancel'
. Свойство BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов.
Существует два состояния обратного вызова:
Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.
Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.
Свойство BusyAction
источника прерывания обратного вызова определяет, как MATLAB обрабатывает свое выполнение. Свойство BusyAction
имеет эти значения:
'queue' — поместите прерывающий обратный вызов в очередь вызовов, подлежащих обработке после завершения обратного вызова.
cancel' — не выполнять прерывание обратного вызова.
Каждый раз, когда MATLAB вызывает коллбэк, тот коллбэк всегда пытается прервать выполняющийся коллбэк. Свойство Interruptible
объекта, коллбэк которого запускается, определяет, позволено ли прерывание. Если Interruptible
установлен в:
'on' — Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь.
Это значение по умолчанию.
Свойство off
— The BusyAction
(объекта, владеющего прерыванием обратного вызова), определяет, ставит ли MATLAB в очередь или игнорирует прерывание обратного вызова.
Смотрите Выполнение обратного вызова Прерывания для примера, который показывает, как свойства BusyAction
и Interruptible
влияют на поведение программы.
BeingDeleted
— Deletion'off'
| 'on'
Это свойство доступно только для чтения.
Удаление статуса, возврат на 'off' или 'on'.
MATLAB задает значение свойства BeingDeleted 'on', когда обратный вызов DeleteFcn начинает выполнение.
Значение свойства BeingDeleted остается 'on' до того момента, как объект перестанет существовать.
Проверьте значение свойства BeingDeleted, чтобы убедиться, что объект не будет удален до запроса или изменения.
HitTest
Способность стать текущим объектом'on'
(значение по умолчанию) | 'off'
Способность стать текущим объектом, заданным как 'on'
или 'off'
:
'on'
— Устанавливает текущий объект на UIControl
, когда пользователь кликает по компоненту в запущенном приложении. И свойство CurrentObject
Figure
и gco
функциональный возврат UIControl
как текущий объект.
'off'
Устанавливает текущий объект быть самым близким предком UIControl
, HitTest
которого является 'on'
, когда пользователь кликает по компоненту в запущенном приложении.
Используйте свойство Enable включить или отключить компонент.
Parent
— Родительский объектFigure
| Panel
| ButtonGroup
| Tab
Родительский объект, заданный как Figure
, Panel
, ButtonGroup
или объект Tab
. Используйте это свойство задать родительский контейнер при создании компонента пользовательского интерфейса или переместить существующий компонент пользовательского интерфейса в различный родительский контейнер.
Children
— дочерние элементы UIControl
Дочерние элементы UIControl
, возвращенные как пустой массив. объекты UIControl
не имеют никаких дочерних элементов. Установка этого свойства не имеет никакого эффекта.
HandleVisibility
Видимость указателя UIControl
'on'
(значение по умолчанию) | 'callback'
| 'off'
Видимость указателя UIControl
, заданного как 'on'
, 'callback'
или 'off'
.
Это свойство управляет видимостью указателя UIControl
в его родительском списке дочерних элементов. Когда указатель не видим в своем родительском списке дочерних элементов, он не возвращен функциями, которые получают указатели путем поиска иерархии объектов или запроса свойств указателя. Эти функции включают get
, findobj
, gca
, gcf
, gco
, newplot
, cla
, clf
и close
. Свойство HandleVisibility
также управляет видимостью указателя объекта в свойстве CurrentObject
родительской фигуры. Указатели все еще допустимы, даже если они не видимы. Если вы знаете указатель объекта, можно установить и получить его свойства и передать его любой функции, которая работает с указателями.
Значение HandleVisibility | Описание |
---|---|
'on' | Указатель UIControl всегда видим. |
'callback' | Указатель UIControl видим из коллбэков или функций, вызванных коллбэками, но не из функций, вызванных из командной строки. Эта опция блокирует доступ к UIControl в командной строке, но позволяет функциям обратного вызова получать доступ к нему. |
'off' | Указатель UIControl невидим в любом случае. Эта опция предназначена для предотвращения непреднамеренных изменений в пользовательском интерфейсе другой функцией. Установите значение 'off' в HandleVisibility, чтобы временно скрыть указатель в течение выполнения этой функции. |
Установите графическое корневое свойство ShowHiddenHandles
на 'on'
делать все указатели видимыми, независимо от их значения HandleVisibility
. Эта установка не имеет никакого эффекта на их значения HandleVisibility
.
Не пытайтесь получить доступ к переключателям и кнопкам-переключателям, которые управляемы uibuttongroup
за пределами группы кнопок. Установите HandleVisibility
тех переключателей и кнопок-переключателей к 'off'
предотвращать случайный доступ.
Ввод
Тип графического объекта'uicontrol'
Это свойство доступно только для чтения.
Тип графического объекта, возвращенного как 'uicontrol'
.
Тег
Идентификатор объекта''
(значение по умолчанию) | вектор символов | представляет скаляр в виде строкиИдентификатор объекта, заданный как вектор символов или скаляр строки. Можно задать уникальное значение Tag
, чтобы служить идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте вашего кода, вы можете использовать функцию findobj для поиска объекта на основе значения тега.
UserData
UserData []
(значение по умолчанию) | массивПользовательские данные, заданные как любой массив. Определение UserData
может быть полезно для обмена данными в рамках приложений. Смотрите Осуществляют обмен данными Среди Коллбэков для получения дополнительной информации.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.