uiimage
Создайте компонент изображения
Синтаксис
im = uiimageim = uiimage(Name,Value)im = uiimage(parent)im = uiimage(parent,Name,Value)Описание
im = uiimage создает компонент изображения в новой фигуре и возвращает объект Image. MATLAB® вызывает функцию uifigure, чтобы создать новую фигуру. Используйте uiimage, чтобы отобразить изображение, значок или логотип в вашем приложении.
im = uiimage( задает значения свойств Name,Value)Image с помощью одного или нескольких аргументов пары "имя-значение".
im = uiimage( задает родительский контейнер и одни или несколько значений свойств.parent,Name,Value)
Примеры
Отобразите изображение
Создайте компонент изображения в фигуре. Отображения изображений по умолчанию.
f = uifigure; im = uiimage(f);
Теперь, добавьте изображение в компонент изображения.
im.ImageSource = 'peppers.png';
Отобразите анимированный GIF с добавлением черных полос сверху и снизу
Создайте компонент изображения, который отображает анимированный GIF с помощью фактического размера изображения.
f = uifigure; im = uiimage(f,'ImageSource','questions.gif'); im.ScaleMethod = 'none';
Теперь, масштабируйте изображение так, чтобы оно соответствовало в области компонента по умолчанию, сохраняя соотношение сторон и без усечения. Затем примените черный фон, чтобы создать видимость добавления черных полос сверху и снизу (черные полосы выше и ниже изображения).
im.ScaleMethod = 'scaledown'; im.BackgroundColor = 'black';
Сконфигурируйте изображение, чтобы выполнить действие, когда кликнувшийся
Создайте изображение и коллбэк, который выполняется, когда на изображение нажимают. В этом случае изображение открывает веб-сайт MathWorks®.
Этот программный файл, названный imagetoURL.m, показывает вам как:
Создайте компонент изображения с коллбэком
ImageClickedFcn.Используйте функцию
webв коллбэке, чтобы открыть URL в браузере MATLAB®.Создайте подсказку, которая появляется, когда вы наводите на изображение.
Когда вы запускаете программный файл, нажимаете на изображение, чтобы открыть веб-сайт MathWorks®.
function imagetoURL f = uifigure('Visible','off'); f.Position(3:4) = [333 239]; im = uiimage(f); im.Position = [20 120 100 100]; im.ImageSource = 'membrane.png'; im.ImageClickedFcn = @ImageClicked; im.Tooltip = 'Go to www.mathworks.com'; function ImageClicked(src,event) url = 'https://www.mathworks.com/'; web(url); end f.Visible = 'on'; end
Входные параметры
parent — Родительский контейнер
Объект Figure (значение по умолчанию) | объект Panel | объект Tab | объект ButtonGroup | объект GridLayout
Родительский контейнер, заданный как Figure, создал использование функции uifigure или одного из ее дочерних контейнеров: Tab, Panel, ButtonGroup или GridLayout. Если никакой контейнер не задан, MATLAB вызывает функцию uifigure, чтобы создать новый объект Figure, который служит родительским контейнером.
Аргументы в виде пар имя-значение
Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.
im = uiimage('ScaleMethod','none')Примечание
Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите Свойства изображения.
'ImageSource' — Источник изображения или файл
'' (значение по умолчанию) | путь к файлу | m-by-n-by-3 матрица изображений истинного цвета
Источник изображения или файл, заданный как путь к файлу или m-by-n-by-3 матрица изображений истинного цвета. Поддерживаемые форматы изображения включают JPEG, PNG, GIF, SVG или m-by-n-by-3 матрица изображений истинного цвета.
Для получения дополнительной информации о матрицах изображений истинного цвета смотрите Типы изображения.
Пример: im = uiimage('ImageSource','peppers.png');
Пример: im.ImageSource = 'C:\TEMP\ngc6543a.jpg';
'ScaleMethod' — Отобразите метод масштабирования
'fit' (значение по умолчанию) | 'fill' | 'none' | 'scaledown' | 'scaleup' | 'stretch'
Отобразите метод масштабирования, заданный как одно из перечисленных в таблице значений. Используйте этот аргумент пары "имя-значение", чтобы задать, как вы хотите, чтобы ваше изображение представило в области компонента.
Таблица также демонстрирует каждый метод шкалы с изображением в качестве примера. В представленных примерах изображений свойство BackgroundColor компонента изображения было установлено в 'magenta'. Масштабирующееся поведение файлов изображения SVG может отличаться на основе того, как файл задан.
| Значение | Описание | Пример | Масштабирует | Уменьшается | Поддерживает соотношение сторон | Изображение клипов | |
|---|---|---|---|---|---|---|---|
| Оригинальное изображение | Представленное изображение | ||||||
'fit' | Шкалы в любом направлении, чтобы отобразить изображение в области компонента, и поддерживают соотношение сторон без усечения. |
|
| Да | Да | Да | Нет |
'fill' | Шкалы в любом направлении, чтобы заполнить область компонента, поддерживая соотношение сторон и отсекая при необходимости. |
|
| Да | Да | Да | Да |
'none' | Использует фактический размер изображения и поддерживает соотношение сторон. Если область компонента меньше, чем изображение, изображение отсекается. |
|
| Нет | Нет | Да | Да |
'scaledown' | Уменьшается и поддерживает соотношение сторон без усечения. Если оригинальное изображение больше, чем область компонента, изображение уменьшается и представляет, как будто |
|
| Нет | Да | Да | Нет |
'scaleup' | Масштабирует и поддерживает соотношение сторон с усечением. Если оригинальное изображение меньше, чем область компонента, изображение масштабирует и представляет, как будто |
|
| Да | Нет | Да | Да |
'stretch' | Шкалы в любом направлении, чтобы заполнить область компонента, не поддерживая соотношение сторон и без усечения. |
|
| Да | Да | Нет | Нет |
'ImageClickedFcn' — Отобразите коллбэк, по которому кликают,
'' (значение по умолчанию) | указатель на функцию | массив ячеек | вектор символов
Отобразите коллбэк, по которому кликают, заданный как одно из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Этот коллбэк выполняется, когда пользователь нажимает на изображение в приложении.
Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с изображением. MATLAB передает эту информацию в объекте ImageClickedData в качестве второго аргумента к вашей функции обратного вызова. В App Designer аргумент называется событием. Вы можете запросить свойства объекта с помощью записи через точку. Например, event.Source возвращает объект Image, что пользователь взаимодействует с инициировать коллбэк. Объект ImageClickedData не доступен функциям обратного вызова, заданным как векторы символов.
В следующей таблице перечислены свойства объекта ImageClickedData.
| Свойство | Значение |
|---|---|
EventName | 'ImageClicked' |
Source | Компонент, выполняющий коллбэк |
Для получения дополнительной информации о записи коллбэков, смотрите Коллбэки Записи в App Designer.
'Position' — Местоположение и размер компонента изображения
[100 100 100 100] (значение по умолчанию) | [left bottom width height]
Местоположение и размер компонента изображения относительно родительского элемента, заданного как четыре вектора элемента формы [left bottom width height]. В этой таблице описываются каждый элемент в векторе.
| Элемент | Описание |
|---|---|
left | Расстояние от внутреннего левого края родительского контейнера к внешнему левому краю компонента изображения |
bottom | Расстояние от внутреннего базового края родительского контейнера к внешнему базовому краю компонента изображения |
width | Расстояние между правыми и левыми внешними краями компонента изображения |
height | Расстояние между верхними и нижними внешними краями компонента изображения |
Значения Position соответствуют выделенной области родительского контейнера. Область векторной и растровой графики является областью в границах контейнера и не включает область, занятую художественными оформлениями, такими как панель меню или заголовок.
Все измерения указаны в пикселях.