Источник изображения или файл, указанный как вектор символа, скаляр строки или mоколо-n-на-3 массив цветных изображений. Если указано имя файла, оно может быть именем файла изображения по пути MATLAB ® или полным путем к файлу изображения. Если вы планируете предоставить доступ к приложению другим пользователям, поместите файл изображения в путь MATLAB, чтобы упростить упаковку приложения.

Поддерживаемые форматы изображений: JPEG, PNG, GIF, SVG или mоколо-n-на-3 массив цветных изображений. Дополнительные сведения о массивах изображений truecolor см. в разделе Типы изображений.

Пример: im = uiimage('ImageSource','peppers.png');

Пример: im.ImageSource = 'C:\TEMP\ngc6543a.jpg';

Выравнивание тонированного изображения по горизонтали в области компонента изображения, указанное как 'center', 'left', или 'right'. Выравнивание в плане выполняется относительно внутренних границ компонента изображения. Установка этого свойства не действует, если ScaleMethod значение свойства равно 'stretch'.

Например, в таблице отображаются визуализированные изображения для каждого HorizontalAlignment значение, где ScaleMethod значение свойства равно 'none' и VerticalAlignment свойство имеет значение по умолчанию, 'center'. Можно реализовать множество других комбинаций, которые здесь не показаны.

Вертикальное выравнивание тонированного изображения в области компонента изображения, указанное как 'center', 'left', или 'right'. Вертикальное выравнивание выполняется относительно внутренних границ компонента изображения. Установка этого свойства не действует, если ScaleMethod значение свойства равно 'stretch'.

Например, в таблице отображаются визуализированные изображения для каждого VerticalAlignment значение, где ScaleMethod значение свойства равно 'none' и HorizontalAlignment свойство имеет значение по умолчанию, 'center'. Можно реализовать множество других комбинаций, которые здесь не показаны.

Метод масштабирования изображения, указанный как одно из значений, перечисленных в таблице. Этот аргумент пары «имя-значение» используется для указания способа визуализации изображения в области компонента.

Таблица также демонстрирует каждый метод масштабирования с примером изображения. В примерах тонированного изображения BackgroundColor для свойства компонента изображения установлено значение 'magenta'. Режим масштабирования файлов изображений SVG может варьироваться в зависимости от способа определения файла.

Цвет фона, указанный как триплет RGB, шестнадцатеричный код цвета или один из параметров цвета, перечисленных в таблице.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Состояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Чтобы приложение начиналось быстрее, установите Visible свойство для 'off' для всех компонентов пользовательского интерфейса, которые не должны появляться при запуске.

Рабочее состояние, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

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

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

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

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

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

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

Внешнее местоположение и размер компонента изображения, возвращаемого в виде четырехэлементного вектора формы [left bottom width height]. Все измерения представлены в единицах пикселей. Это значение свойства идентично значению Position собственность.

Параметры компоновки, указанные как 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];

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

Этот обратный вызов выполняется, когда пользователь щелкает изображение в приложении.

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с изображением. MATLAB передает эту информацию в ImageClickedData объект в качестве второго аргумента функции обратного вызова. В App Designer аргумент называется event. Можно запросить свойства объекта с помощью точечной нотации. Например, event.Source возвращает значение Image объект, с которым пользователь взаимодействует для запуска обратного вызова. ImageClickedData недоступен для функций обратного вызова, указанных как векторы символов.

В следующей таблице перечислены свойства ImageClickedData объект.

Дополнительные сведения о записи обратных вызовов см. в разделе Запись обратных вызовов в App Designer.

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

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

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

Установка CreateFcn свойство существующего компонента не оказывает никакого влияния.

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

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

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

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

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

Прерывание обратного вызова, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Это свойство определяет, можно ли прервать выполняющийся обратный вызов. Существует два состояния обратного вызова:

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов (если он существует). Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание.

Очередь обратного вызова, указанная как 'queue' или 'cancel'. BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов. Существует два состояния обратного вызова:

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов. Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается он или помещается в очередь. Это возможные значения BusyAction свойство:

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

Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.

Проверьте значение BeingDeleted для проверки того, что объект не будет удален перед запросом или изменением.

Родительский контейнер, указанный как Figure объект, созданный с помощью uifigure функцию или один из ее дочерних контейнеров: Tab, Panel, ButtonGroup, или GridLayout. Если контейнер не указан, MATLAB вызывает uifigure для создания новой функции Figure объект, который служит родительским контейнером.

Видимость дескриптора объекта, указанного как 'on', 'callback', или 'off'.

Это свойство управляет видимостью объекта в родительском списке потомков. Если объект не виден в списке нижестоящих элементов родительского объекта, он не возвращается функциями, получающими объекты путем поиска в иерархии объектов или запроса свойств. Эти функции включают get, findobj, clf, и close. Объекты действительны, даже если они не видны. При наличии доступа к объекту можно задать и получить его свойства и передать его любой функции, которая работает с объектами.

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

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

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

Пользовательские данные, указанные как любой массив MATLAB. Например, можно указать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Это свойство используется для хранения произвольных данных объекта.

Если вы работаете в App Designer, создайте открытые или частные свойства в приложении для совместного использования данных вместо использования UserData собственность. Дополнительные сведения см. в разделе Общий доступ к данным в приложениях App Designer.