Управление внешним видом и поведением компонента изображения
Изображения являются компонентами пользовательского интерфейса, которые позволяют вам отображать изображение, например, значок или логотип в вашем приложении Image.
свойства управляют внешним видом и поведением изображения. Используйте запись через точку для ссылки на определенный объект и свойство.
fig = uifigure; im = uiimage(fig); im.ImageSource = 'peppers.png';
ImageSource
- Источник изображения или файл''
(по умолчанию) | вектор символов | строковый скаляр | m
-by- n
-by-3 truecolor массив изображенийИсточник изображения или файл, заданный как вектор символов, строковый скаляр или m
-by- n
-by-3 truecolor массив изображений. Если вы задаете имя файла, это может быть имя файла изображения на MATLAB® путь или полный путь к файлу изображения. Если вы планируете поделиться приложением с другими, поместите файл изображения на путь MATLAB, чтобы облегчить упаковку приложений.
Поддерживаемые форматы изображений включают JPEG, PNG, GIF, SVG или m
-by- n
-by-3 truecolor массив изображений. Дополнительные сведения о массивах изображений truecolor см. в разделе Типы изображений.
Пример: im = uiimage('ImageSource','peppers.png');
Пример: im.ImageSource = 'C:\TEMP\ngc6543a.jpg';
HorizontalAlignment
- Горизонтальное выравнивание визуализированного изображения'center'
(по умолчанию) | 'left'
| 'right'
Горизонтальное выравнивание визуализированного изображения в области компонента изображения, заданное как 'center'
, 'left'
, или 'right'
. Горизонтальное выравнивание соответствует внутренним границам компонента изображения. Установка этого свойства не влияет, когда ScaleMethod
значение свойства установлено в 'stretch'
.
Для примера в таблице показов визуализированные изображения для каждого HorizontalAlignment
значение, где ScaleMethod
значение свойства установлено в 'none'
и VerticalAlignment
свойство имеет значение по умолчанию, 'center'
. Можно реализовать множество других комбинаций, которые здесь не показаны.
Значение выравнивания по горизонтали | Описание | Визуализированное изображение |
---|---|---|
'center' | Левые и правые ребра изображения расположены на равном расстоянии от внутренних левой и внутренних правых границ компонента изображения, соответственно. |
|
'left' | Левый край изображения выравнивается по внутренней левой границе компонента изображения. |
|
'right' | Правое ребро изображения выравнивается по внутренней правой границе компонента изображения. |
|
VerticalAlignment
- Вертикальное выравнивание визуализированного изображения'center'
(по умолчанию) | 'top'
| 'bottom'
Вертикальное выравнивание визуализированного изображения в области компонента изображения, заданное как 'center'
, 'left'
, или 'right'
. Вертикальное выравнивание соответствует внутренним границам компонента изображения. Установка этого свойства не влияет, когда ScaleMethod
значение свойства установлено в 'stretch'
.
Для примера в таблице показов визуализированные изображения для каждого VerticalAlignment
значение, где ScaleMethod
значение свойства установлено в 'none'
и HorizontalAlignment
свойство имеет значение по умолчанию, 'center'
. Можно реализовать множество других комбинаций, которые здесь не показаны.
Значение выравнивания по вертикали | Описание | Визуализированное изображение |
---|---|---|
'center' | Верхние и нижние ребра изображения расположены на равном расстоянии от внутренних верхних и внутренних нижних границ компонента изображения, соответственно. |
|
'top' | Верхний край изображения выравнивается по внутренней верхней границе компонента изображения. |
|
'bottom' | Нижнее ребро изображения выравнивается по внутренней - нижней границе компонента изображения. |
|
ScaleMethod
- Метод масштабирования изображений'fit'
(по умолчанию) | 'fill'
| 'none'
| 'scaledown'
| 'scaleup'
| 'stretch'
Метод масштабирования изображений, заданный как одно из значений, перечисленных в таблице. Используйте этот аргумент пары "имя-значение", чтобы задать способ визуализации изображения в области компонента.
Таблица также демонстрирует каждый метод шкалы с помощью примера изображения. В примерах визуализированных изображений BackgroundColor
свойство компонента изображения установлено в 'magenta'
. Поведение масштабирования файлов изображений SVG может варьироваться в зависимости от того, как определен файл.
Значение | Описание | Пример | Шкалы вверх | Шкалы вниз | Поддерживает соотношение сторон | Изображение клипса | |
---|---|---|---|---|---|---|---|
Оригинальное изображение | Визуализированное изображение | ||||||
'fit' | Масштабирует в любом направлении, чтобы отобразить изображение в пределах области компонента, и поддерживает соотношение сторон без усечения. |
|
| Да | Да | Да | Нет |
'fill' | Масштабируется в любом направлении, чтобы заполнить область компонента, сохраняя соотношение сторон и при необходимости обрезку. |
|
| Да | Да | Да | Да |
'none' | Использует фактический размер изображения и поддерживает соотношение сторон. Если площадь компонента меньше изображения, изображение обрезается. |
|
| Нет | Нет | Да | Да |
'scaledown' | Масштабируется вниз и поддерживает соотношение сторон без усечения. Если оригинальное изображение больше, чем площадь компонента, изображение масштабируется вниз и визуализируется как |
|
| Нет | Да | Да | Нет |
'scaleup' | Шкалы и поддержание соотношения сторон с помощью усечения. Если оригинальное изображение меньше, чем площадь компонента, изображение шкал вверх и визуализируется как |
|
| Да | Нет | Да | Да |
'stretch' | Масштабируется в любом направлении, чтобы заполнить площадь компонента, без сохранения соотношения сторон и без усечения. |
|
| Да | Да | Нет | Нет |
BackgroundColor
- Цвет фона'none'
(по умолчанию) | триплет 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' | |
'none' | Не применяется | Не применяется | Не применяется | Нет цвета |
Вот триплеты 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' |
Visible
- Состояние видимости'on'
(по умолчанию) | логическое значение включения/выключенияСостояние видимости, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
'on'
- Отобразите объект.
'off'
- Скрыть объект, не удаляя его. Вы по-прежнему можете получить доступ к свойствам невидимого компонента пользовательского интерфейса.
Чтобы ускорить запуск приложения, установите Visible
свойство к 'off'
для всех компонентов пользовательского интерфейса, которые не должны появляться при запуске.
Enable
- Рабочее состояние'on'
(по умолчанию) | логическое значение включения/выключенияРабочее состояние, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
Если вы задаете это свойство равным 'on'
пользователь приложения может взаимодействовать с компонентом.
Если вы задаете это свойство равным 'off'
компонент появляется затемненным, что указывает на то, что пользователь приложения не может с ним взаимодействовать, и что он не будет запускать коллбэк.
Tooltip
- Подсказка''
(дефолт) | вектор символов | массив ячеек векторов символов | строковые массивы | 1-D категориальный массивПодсказка, заданная как вектор символов, массив ячеек из векторов символов, строковые массивы или 1-D категориальный массив. Используйте это свойство для отображения сообщения при наведении указателя мыши на компонент во время выполнения. Подсказка отображается, даже когда компонент отключен. Чтобы отобразить несколько линии текста, задайте массив ячеек из векторов символов или строковые массивы. Каждый элемент массива становится отдельной строкой текста. Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.
ContextMenu
- Контекстное менюGraphicsPlaceholder
массив (по умолчанию) | ContextMenu
объектКонтекстное меню, заданное как ContextMenu
объект, созданный с использованием uicontextmenu
функция. Используйте это свойство для отображения контекстного меню при щелчке правой кнопкой мыши по компоненту.
Position
- Расположение и размер компонента изображения[100 100 100 100]
(по умолчанию) | [left bottom width height]
Расположение и размер компонента изображения относительно родительского элемента, заданные как вектор четырех элементов формы [left bottom width height]
. Эта таблица описывает каждый элемент в векторе.
Элемент | Описание |
---|---|
left | Расстояние от внутреннего левого края родительского контейнера до внешнего левого края компонента изображения |
bottom | Расстояние от внутреннего нижнего ребра родительского контейнера до внешнего нижнего ребра компонента изображения |
width | Расстояние между правым и левым внешними краями компонента изображения |
height | Расстояние между верхним и нижним внешними краями компонента изображения |
The Position
значения относятся к drawable area родительского контейнера. Область векторной и растровой графики является областью внутри границ контейнера и не включает область, занимаемую украшениями, такими как панель меню или заголовок.
Все измерения указаны в пикселях модулей.
InnerPosition
- Внутреннее расположение и размер компонента изображения[100 100 100 100]
(по умолчанию) | [left bottom width height]
Внутреннее расположение и размер компонента изображения, заданные как вектор четырех элементов вида [left bottom width height]
. Все измерения указаны в пикселях модулей. Это значение свойства идентично Position
свойство.
OuterPosition
- Внешнее расположение и размер компонента изображения[100 100 100 100]
(по умолчанию) | [left bottom width height]
Это свойство доступно только для чтения.
Внешнее расположение и размер компонента изображения, возвращенные как вектор четырех элементов формы [left bottom width height]
. Все измерения указаны в пикселях модулей. Это значение свойства идентично Position
свойство.
Layout
- опции размещенияLayoutOptions
массив (по умолчанию) | GridLayoutOptions
объектОпции размещения, заданные как GridLayoutOptions
объект. Это свойство задает опции для компонентов, являющихся дочерними элементами контейнеров размещения сетки. Если компонент не является дочерним элементом контейнера сетки размещения (для примера он является дочерним элементом рисунка или панели), то это свойство пустое и не имеет эффекта. Однако, если компонент является дочерним элементом контейнера размещения сетки, можно поместить компонент в нужную строку и столбец сетки путем установки Row
и Column
свойства на GridLayoutOptions
объект.
Для примера этот код помещает компонент изображения в третью строку и второй столбец его родительской сетки.
g = uigridlayout([4 3]); im = uiimage(g); im.ImageSource = 'peppers.png'; im.ScaleMethod = 'fill'; im.Layout.Row = 3; im.Layout.Column = 2;
Чтобы изображение охватывало несколько строк или столбцов, задайте Row
или Column
свойство как двухэлементный вектор. Для примера это изображение охватывает столбцы 2
через 3
.
im.Layout.Column = [2 3];
ImageClickedFcn
- Изображение, кликнутое как обратный вызовИзображение кликнуло коллбэк, заданное как одно из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Этот коллбэк выполняется, когда пользователь кликает изображение в приложении.
Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с изображением. MATLAB передает эту информацию в ImageClickedData
объект как второй аргумент функции обратного вызова. В App Designer аргумент называется event
. Вы можете запросить свойства объекта с помощью записи через точку. Для примера, event.Source
возвращает Image
объект, с которым взаимодействует пользователь, чтобы вызвать коллбэк. The ImageClickedData
объект недоступен для функций обратного вызова, заданных как векторы символов.
В следующей таблице перечислены свойства ImageClickedData
объект.
Свойство | Значение |
---|---|
EventName | 'ImageClicked' |
Source | Компонент, выполняющий коллбэк |
Для получения дополнительной информации о записи коллбэков см. Раздел «Запись коллбэков в App Designer».
CreateFcn
- Функция создания''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция создания объектов, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Дополнительные сведения об указании коллбэка как указателя на функцию, массива ячеек или вектора символов см. в разделе Запись коллбэков в App Designer.
Это свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB создает объект. MATLAB инициализирует все значения свойств перед выполнением CreateFcn
коллбэк. Если вы не задаете CreateFcn
свойство, затем MATLAB выполняет функцию создания по умолчанию.
Установка CreateFcn
свойство в существующем компоненте не имеет никакого эффекта.
Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к объекту, который создается с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo
функция для доступа к объекту.
DeleteFcn
- Функция удаления''
(по умолчанию) | указатель на функцию | массив ячеек | вектор символовФункция удаления объектов, заданная в качестве одного из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Дополнительные сведения об указании коллбэка как указателя на функцию, массива ячеек или вектора символов см. в разделе Запись коллбэков в App Designer.
Это свойство задает функцию обратного вызова, которая должна выполняться, когда MATLAB удаляет объект. MATLAB выполняет DeleteFcn
коллбэк перед уничтожением свойств объекта. Если вы не задаете DeleteFcn
свойство, затем MATLAB выполняет функцию удаления по умолчанию.
Если вы задаете это свойство как указатель на функцию или массив ячеек, можно получить доступ к удаляемому объекту с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo
функция для доступа к объекту.
Interruptible
- Прерывание коллбэка'on'
(по умолчанию) | логическое значение включения/выключенияПрерывание коллбэка, заданное как 'on'
или 'off'
, или как числовое или логическое 1
(true
) или 0
(false
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState
.
Это свойство определяет, можно ли прерывать выполняемый коллбэк. Существует два состояния коллбэка:
Обратный коллбэк running - это актуальный на данный момент коллбэк.
Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.
Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк (если он существует). The Interruptible
свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание.
Значение 'on'
позволяет другим коллбэкам прерывать коллбэки объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, когда есть drawnow
, figure
, uifigure
, getframe
, waitfor
, или pause
команда.
Если текущий коллбэк содержит одну из этих команд, MATLAB останавливает выполнение коллбэка в этой точке и выполняет прерывание обратного вызова MATLAB возобновляет выполнение текущего коллбэка после завершения прерывания обратного вызова.
Если текущий коллбэк не содержит одну из этих команд, MATLAB завершает выполнение коллбэка без прерывания.
Значение 'off'
блокирует все попытки прерывания. The BusyAction
свойство объекта, имеющего прерывание обратного вызова, определяет, отменяется ли прерывание обратного вызова или помещается в очередь.
Примечание
Прерывание и выполнение коллбэка происходят по-разному в таких ситуациях:
Если прерывание обратного вызова является DeleteFcn
, CloseRequestFcn
или SizeChangedFcn
коллбэк, тогда прерывание происходит независимо от Interruptible
значение свойства.
Если текущий коллбэк выполняющегося в данного момента, waitfor
function, тогда прерывание происходит независимо от Interruptible
значение свойства.
Timer
объекты выполняются в соответствии с расписанием независимо от Interruptible
значение свойства.
Когда происходит прерывание, MATLAB не сохраняет состояние свойств или отображения. Для примера, объект, возвращенный gca
или gcf
команда может измениться при выполнении другого коллбэка.
BusyAction
- постановка в очередь коллбэков'queue'
(по умолчанию) | 'cancel'
Постановка в очередь коллбэков, заданная как 'queue'
или 'cancel'
. The BusyAction
свойство определяет, как MATLAB обрабатывает выполнение прерываний обратного вызова. Существует два состояния коллбэка:
Обратный коллбэк running - это актуальный на данный момент коллбэк.
Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.
Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк. The Interruptible
свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction
свойство объекта, имеющего прерывание обратного вызова, определяет, будет ли оно сброшено или помещено в очередь. Это возможные значения BusyAction
свойство:
'queue'
- помещает прерывание обратного вызова в очередь вызовов, подлежащих обработке после концов обратного коллбэка.
'cancel'
- Не выполняет прерывание обратного вызова.
BeingDeleted
- Статус удаленияЭто свойство доступно только для чтения.
Статус удаления, возвращенный как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState
.
MATLAB устанавливает BeingDeleted
свойство к 'on'
когда DeleteFcn
коллбэк начинает выполняться. The BeingDeleted
свойство остается установленным на 'on'
пока объект компонента не перестанет существовать.
Проверьте значение BeingDeleted
свойство, чтобы убедиться, что объект не будет удален до запроса или изменения.
Parent
- Родительский контейнерFigure
объект (по умолчанию) | Panel
| объекта Tab
| объекта ButtonGroup
| объекта GridLayout
объектРодительский контейнер, заданный как Figure
объект, созданный с использованием uifigure
функция, или один из ее дочерних контейнеров: Tab
, Panel
, ButtonGroup
, или GridLayout
. Если контейнер не задан, MATLAB вызывает uifigure
функция для создания нового Figure
объект, который служит родительским контейнером.
HandleVisibility
- Видимость указателя на объект'on'
(по умолчанию) | 'callback'
| 'off'
Видимость указателя на объект, заданная как 'on'
, 'callback'
, или 'off'
.
Это свойство контролирует видимость объекта в его родительский список дочерних элементов. Когда объект не отображается в родительский список дочерних элементов, он не возвращается с помощью функций, которые получают объекты, просматривая иерархию объектов или запрашивая свойства. Эти функции включают get
, findobj
, clf
, и close
. Объекты действительны, даже если они не видны. Если вы можете получить доступ к объекту, можно задать и получить его свойства, и передать его в любую функцию, которая работает с объектами.
Значение HandleVisibility | Описание |
---|---|
'on' | Объект всегда отображается. |
'callback' | Объект виден из обратных коллбэков или функций, вызываемых коллбэками, но не из функций, инициируемых из командной строки. Эта опция блокирует доступ к объекту в командной строке, но позволяет функциям обратного вызова обращаться к нему. |
'off' | Объект невидим в любое время. Эта опция используется для предотвращения непреднамеренных изменений пользовательского интерфейса другой функцией. Установите HandleVisibility на 'off' временно скрыть объект во время выполнения этой функции. |
Type
- Тип графического объекта'uiimage'
Это свойство доступно только для чтения.
Тип графического объекта, возвращенный как 'uiimage'
.
Tag
- Идентификатор объекта''
(по умолчанию) | символьный вектор | строковый скалярИдентификатор объекта, заданный как вектор символов или строковый скаляр. Можно задать уникальное Tag
значение, которое служит идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте вашего кода, вы можете использовать findobj
функция для поиска объекта на основе Tag
значение.
UserData
- Пользовательские данные[]
(по умолчанию) | массивПользовательские данные, заданные как любой массив MATLAB. Для примера можно задать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Используйте это свойство для хранения произвольных данных на объекте.
Если вы работаете в App Designer, создайте общие или частную собственность в приложении, чтобы делиться данными вместо использования UserData
свойство. Для получения дополнительной информации см. раздел «Обмен данными в приложениях App Designer».
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.