Создать компонент изображения
im = uiimage создает компонент изображения в новой фигуре и возвращает Image объект. MATLAB ® вызывает uifigure для создания новой фигуры. Использовать uiimage для отображения изображения, значка или логотипа в приложении.
im = uiimage( определяет Name,Value)Image значения свойств, использующие один или несколько аргументов пары имя-значение.
im = uiimage( задает родительский контейнер и одно или несколько значений свойств.parent,Name,Value)
Создайте компонент изображения внутри фигуры. Отображается изображение по умолчанию.
fig = uifigure; im = uiimage(fig);
Теперь добавьте изображение в компонент изображения.
im.ImageSource = 'peppers.png';
Создайте компонент изображения, отображающий анимированный GIF-файл, используя фактический размер изображения.
fig = uifigure; im = uiimage(fig,'ImageSource','questions.gif'); im.ScaleMethod = 'none';
Теперь масштабируйте изображение так, чтобы оно вписывалось в область компонента по умолчанию, сохраняя соотношение сторон и без отсечения. Затем нанесите черный фон для создания внешнего вида почтового ящика (черные полосы над и под изображением).
im.ScaleMethod = 'scaledown'; im.BackgroundColor = 'black';
Создайте изображение и обратный вызов, который выполняется при щелчке по изображению. В этом случае изображение открывает веб-сайт MathWorks ®.
Этот файл программы, называемый imagetoURL.m, показывает, как:
Создание компонента изображения с помощью ImageClickedFcn обратный вызов.
Используйте web для открытия внешнего URL-адреса в системном браузере.
Создайте подсказку, которая появится при наведении курсора на изображение.
При запуске файла программы щелкните изображение, чтобы открыть веб-сайт MathWorks ®.
function imagetoURL fig = uifigure('Visible','off'); fig.Position(3:4) = [333 239]; im = uiimage(fig); 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 fig.Visible = 'on'; end
parent - Родительский контейнерFigure объект (по умолчанию) | Panel объект | Tab объект | ButtonGroup объект | GridLayout объектРодительский контейнер, указанный как Figure объект, созданный с помощью uifigure функцию или один из ее дочерних контейнеров: Tab, Panel, ButtonGroup, или GridLayout. Если родительский контейнер не указан, MATLAB вызывает uifigure для создания новой функции Figure объект, который служит родительским контейнером.
Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.
im = uiimage('ScaleMethod','none')Примечание
Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойства изображения.
'ImageSource' - Источник изображения или файлmоколо-n-by-3 массив цветных изображенийИсточник изображения или файл, указанный как путь к файлу или mоколо-n-на-3 массив цветных изображений. Поддерживаемые форматы изображений: JPEG, PNG, GIF, SVG или mоколо-n-на-3 массив цветных изображений.
Дополнительные сведения о массивах изображений truecolor см. в разделе Типы изображений.
Пример: 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. Можно запросить свойства объекта с помощью точечной нотации. Например, 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 значения относятся к области извлечения родительского контейнера. Извлекаемая область представляет собой область внутри границ контейнера и не включает область, занятую украшениями, такими как строка меню или заголовок.
Все измерения представлены в единицах пикселей.