Отображение строки меню рисунка, указанное как 'figure' или 'none'. MenuBar позволяет отображать или скрывать меню по умолчанию в верхней части окна фигуры. Определить 'figure' для отображения строки меню. Определить 'none' чтобы скрыть его.

Это свойство влияет только на меню по умолчанию и не влияет на меню, определенные с помощью uimenu команда.

Строки меню не отображаются в рисунках, WindowStyle свойство имеет значение 'Modal'. Если фигура, содержащая нижестоящие элементы меню, изменена на 'Modal', дочерние элементы меню все еще существуют в Children свойство фигуры. Однако меню не отображаются, пока WindowStyle имеет значение 'Modal'.

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

Это свойство влияет только на панель инструментов по умолчанию. Это не влияет на другие панели инструментов, такие как панель «Камера» или панель «Редактирование печати». При выборе панели инструментов «Фигура» в меню «Вид фигуры» для этого свойства устанавливается значение 'figure'.

Панели инструментов не отображаются в рисунках, WindowStyle свойство имеет значение 'Modal'. Если фигура, содержащая панель инструментов, изменена на 'Modal', дочерние элементы панели инструментов все еще существуют в Children свойство фигуры. Однако панель инструментов не отображается, пока WindowStyle имеет значение 'Modal'.

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

Установка DockControls не поддерживается в Online™ MATLAB.

Цвет фона, определяемый как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя. При указании 'none'цвет фона отображается черным на экране, но при печати фигуры фон печатается так, как будто окно фигуры прозрачное.

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

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

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

Типы данных: double | char

Стиль окна, указанный как один из следующих:

Поведение стиля модального окна

Когда WindowStyle имеет значение 'modal', окно рисунка перехватывает все действия клавиатуры и мыши над всеми окнами MATLAB, пока окна видны. Не затрагиваются окна, принадлежащие приложениям, отличным от MATLAB.

Ввод Ctrl + C, когда модальная фигура имеет фокус, приводит к тому, что эта фигура возвращается к 'normal' WindowStyle параметр свойства. Это позволяет пользователю вводить в командной строке.

Цифры с WindowStyle свойство имеет значение 'modal' и Visible свойство имеет значение 'off' не ведите себя модально, пока MATLAB не сделает их видимыми. Поэтому модальное окно можно скрыть для последующего повторного использования, а не уничтожать.

Модальные фигуры не отображают дочерние элементы меню, встроенные меню или панели инструментов. Но не является ошибкой создание меню в модальной фигуре или изменение WindowStyle значение свойства 'modal' на рисунке с потомками меню. Menu объекты существуют, и фигура сохраняет их. Если сбросить рисунок WindowStyle свойство для 'normal', меню отображаются.

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

Нажатие кнопки «Свернуть», «Развернуть» или «Восстановить» операционной системы устанавливает значение WindowState соответственно собственности. Нажатие клавиш Ctrl + F11 (^Windows ® и ^Linux ®) или Ctrl + Command + f (Mac OS) приводит к переключению'fullscreen' состояние.

Установка WindowState свойство закрепленной фигуры или в MATLAB Online не поддерживается.

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

Эта таблица описывает каждый элемент в Position вектор.

Все измерения в единицах, указанных Units собственность.

Невозможно указать фигуру Position свойство при закреплении фигуры.

В MATLAB Online, bottom и left элементы Position векторы игнорируются.

Для размещения полного окна, включая границы, строку заголовка, строку меню, панели инструментов, используйте OuterPosition собственность.

Единицы измерения, указанные в данной таблице в качестве одного из значений.

MATLAB измеряет все единицы измерения из левого нижнего угла родительского объекта.

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

Порядок, в котором указывается Units и Position свойства имеют следующие эффекты:

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

Это значение свойства идентично значению Position значение свойства.

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

В этой таблице описывается каждый элемент вектора.

Все измерения в единицах, указанных Units собственность.

Невозможно указать фигуру OuterPosition свойство при закреплении фигуры.

Это свойство не влияет на фигуры.

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

Если для этого свойства установлено значение 'on', размер фигуры можно изменить. В противном случае размер не может быть изменен.

Цветовая карта для содержимого осей фигуры, заданная как mоколо-3 массив RGB (красный, зеленый, синий) триплетов, которые определяют m отдельные цвета.

Пример: figure('Colormap',[1 0 1; 0 0 1; 1 1 0]) устанавливает для карты цветов три цвета: пурпурный, синий и желтый.

MATLAB получает доступ к этим цветам по их номеру строки.

Карты цветов влияют на визуализацию объектов, созданных с помощью surface, image, и patch функции, но, как правило, не влияют на другие графические объекты.

При установке Colormap свойство фигуры, затем оси и диаграммы на фигуре используют одну и ту же карту цветов.

Карта прозрачности для Axes содержимое, указанное как массив конечных альфа-значений, которые линейно переходят из 0 кому 1. Размер массива может быть m-by-1 или 1-by-m. MATLAB обращается к альфа-значениям по их индексу в массиве. Альфамапы могут быть любой длины.

Alphamaps влияют на визуализацию объектов, созданных с помощью surface, image, и patch функции, но не влияют на другие графические объекты.

При установке Alphamap свойство фигуры, затем оси и диаграммы на фигуре используют одну и ту же альфа-карту.

Директива о порядке добавления следующего участка, указанная как 'add', 'new', 'replace', или 'replacechildren'.

В этой таблице описываются эффекты каждого значения.

Рассмотрите возможность использования newplot для обработки NextPlot собственность. Дополнительные сведения см. в разделе Оси NextPlot свойства и «Подготовка рисунков и осей для графиков».

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

Установка Renderer не поддерживается в MATLAB Online.

Аппаратные и программные реализации OpenGL

OpenGL доступен на всех компьютерах, на которых работает MATLAB, так как программная версия OpenGL встроена в MATLAB. Однако при наличии графического оборудования, поддерживающего аппаратно ускоренную версию OpenGL, MATLAB автоматически использует аппаратно ускоренную версию для повышения производительности.

В некоторых случаях MATLAB автоматически использует программное обеспечение OpenGL даже при наличии аппаратной версии. Например, MATLAB использует версию программного обеспечения, если он обнаруживает графическое оборудование с известными проблемами драйверов или обнаруживает, что вы используете виртуальную машину или удаленный рабочий стол в Windows.

MATLAB выдает предупреждение, если не удается найти используемую библиотеку OpenGL.

Выбор программного обеспечения OpenGL

Чтобы переключиться с аппаратного обеспечения на программное обеспечение OpenGL, выполните следующие действия:

Доступны следующие версии программного обеспечения:

Определение версии библиотеки OpenGL

Чтобы определить версию и поставщика библиотеки OpenGL, используемой в системе MATLAB, вызовите rendererinfo функция. Например, эта команда получает информацию для текущих осей и сохраняет ее в структуре с именем info.

info = rendererinfo(gca)

Эта структура также предоставляет имя графического средства визуализации в GraphicsRenderer поле. Например, если MATLAB использует OpenGL с аппаратным ускорением, поле возвращает 'OpenGL Hardware'. Если MATLAB использует программное обеспечение OpenGL, поле возвращает значение 'OpenGL Software'.

Потеряно подключение XServer

При использовании Linux, если происходит разрыв соединения с XServer, MATLAB может произойти сбой с нарушением сегментации. В этом случае убедитесь, что в системе установлена последняя версия XServer.

В системе Linux также можно попытаться обновить драйвер OpenGL или запустить MATLAB с помощью программного обеспечения OpenGL, используя следующую команду:

 matlab -softwareopengl

Выбор средства визуализации, указанный как:

MATLAB устанавливает RendererMode свойство для 'manual' при явном задании Renderer свойство для 'painters' или 'opengl'.

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

Сглаживание уменьшает появление линий с зазубринами на графике осей. MATLAB применяет метод сглаживания к рисунку осей (и линейкам осей), если GraphicsSmoothing имеет значение 'on', и любое из этих условий верно:

Если графика осей содержит в основном вертикальные или горизонтальные линии, рекомендуется установить GraphicsSmoothing свойство для 'on' и строка или строки AlignVertexCenters свойство для 'on'. Техника сглаживания жертвует некоторой резкостью для сглаживания, что может быть особенно заметно в такой графике.

Установка GraphicsSmoothing не поддерживается в MATLAB Online.

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

PaperUnits определяет единицы измерения PaperPosition значения. Рассмотрите возможность установки PaperUnits свойство для 'normalized'. Этот параметр позволяет MATLAB автоматически увеличивать размер фигуры, занимая один и тот же относительный размер печатаемой страницы, независимо от размера страницы.

Пример: figure('PaperPosition',[.25 .25 8 6]) установить размер и расположение фигуры для печати в [.25 .25 8 6].

Директива об использовании отображаемого размера фигуры при печати или сохранении, указанная как 'auto' или 'manual'.

Для создания выходных данных, имеющих тот же размер и разрешение (DPI), что и отображаемый рисунок, установите PaperPositionMode свойство фигуры для 'auto' и сохраните фигуру с помощью print с -r0 вариант. -r0 параметр гарантирует, что разрешение вывода совпадает с разрешением отображения. Если разрешения различны, то сгенерированный выходной размер совпадает с отображаемым размером фигуры в измеренных единицах (дюймах, сантиметрах, точках), но не в пикселях. Например, если разрешение дисплея составляет 100 DPI, то цифра 4 на 5 дюймов равна 400 на 500 пикселей. Если разрешение вывода составляет 200 DPI, то напечатанный или сохраненный рисунок имеет одинаковый размер в дюймах, но 800 на 1000 пикселей.

Чтобы изменить значение по умолчанию, используйте один из следующих методов.

Пользовательский размер страницы при печати рисунка или сохранении его в формате страницы (формат PDF и PostScript ®), заданный как двухэлементный вектор формы[width height]. В США значением по умолчанию является [8.5 11]. В Европе и Азии значение по умолчанию - [21 29.7].

PaperUnits определяет единицы измерения для PaperSize собственность. Вы не можете установить PaperSize свойство, если PaperUnits свойство имеет значение 'normalized'. Попытка сделать это приводит к ошибке.

Указание PaperSize устанавливает свойство PaperType к соответствующему типу, если он существует, или к 'custom' в противном случае.

Единицы, используемые для PaperSize и PaperPosition, указанное как одно из следующих значений:

Ориентация страницы при печати фигуры или ее сохранении в формате страницы (формат PDF и PostScript), указанное как одно из следующих значений:

См. раздел orient для получения дополнительной информации.

Стандартные размеры страниц при печати рисунка или сохранении его в формате подкачки (PDF и PostScript), указанные как одно из значений в этой таблице. Указание PaperType устанавливает свойство PaperSize соответствующего размера страницы.

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

Символ указателя, указанный как одно из значений в следующей таблице или как 'custom'. Внешний вид символа зависит от операционной системы.

Пользовательский символ указателя

Чтобы создать пользовательский символ указателя, программно задайте Pointer свойство для 'custom' и используйте PointerShapeCData для определения символа. См. раздел PointerShapeCData для получения дополнительной информации.

Ограничения

Пользовательский символ указателя, указанный как 16около-16 матрица (для указателя 16 на 16 пикселей) или как 32около-32 матрица (для указателя 32 на 32 пиксела). Рисунок использует этот символ указателя при установке Pointer свойство для 'custom'.

Каждый элемент матрицы определяет уровень яркости для 1 пиксела в указателе. Элемент (1,1) матрицы соответствует пикселю в левом верхнем углу указателя. Установите для элементов матрицы одно из следующих значений:

Активный пиксель указателя, заданный как двухэлементный вектор. Вектор содержит индексы строк и столбцов определенного элемента в PointerShapeCData матрицу, которая соответствует требуемому активному пикселю. Значение по умолчанию [1 1] соответствует пикселю в левом верхнем углу указателя.

Если указано значение за пределами диапазона PointerShapeCData матрица, то указатель использует активный пиксель по умолчанию [1 1] вместо этого.

Это свойство применяется только в том случае, если Pointer свойство имеет значение 'custom'.

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

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

Изменение размера невидимого контейнера запускает SizeChangedFcn обратный вызов, когда он становится видимым.

Изменение Visible свойство контейнера не изменяет значения Visible свойств дочерних компонентов. Это верно, даже если скрытие контейнера приводит к скрытию дочерних компонентов.

Целевые оси на текущем рисунке, указанные как Axes объект, a PolarAxes объект или графический объект, такой как HeatmapChart.

На всех рисунках, для которых существуют дочерние оси, всегда есть текущие оси. Текущие оси не обязательно должны быть самыми верхними, и установка осей в качестве текущих осей не приводит к их повторному отображению над всеми остальными осями. Если фигура не содержит осей, get(gcf,'CurrentAxes') возвращает пустой массив.

Запрос CurrentAxes для получения текущего объекта-оси без принудительного создания осей, если таковая не существует.

Текущий объект, возвращаемый как дочерний объект фигуры. MATLAB устанавливает CurrentObject свойство последнего объекта, нажатого на рисунке. Этот объект является самым передним объектом в представлении.

HitTest свойство дочернего объекта определяет, может ли этот объект стать CurrentObject.

Щелчок по объекту, HandleVisibility свойство - 'off' устанавливает CurrentObject свойство в пустое GraphicsPlaceholder массив. Чтобы избежать возврата пустого массива при щелчке скрытого объекта, задайте HitTest свойства скрытого объекта для 'off'.

Используйте gco в качестве альтернативы для получения значения этого свойства.

Текущая точка, возвращаемая как двухэлементный вектор. Вектор содержит координаты (x, y) указателя мыши, измеренные от нижнего левого угла фигуры. Значения в единицах, указанных Units собственность.

Координаты обновляются при выполнении любого из следующих действий.

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

Если вы используете CurrentPoint для печати точек, значения координат могут содержать ошибку округления.

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

Тип выбора мыши, возвращенный как 'normal', 'extend', 'alt', или 'open'. Это свойство предоставляет информацию о последнем нажатии кнопки мыши, которое произошло на рисунке.

В этой таблице перечислены возможные SelectionType значения и действия пользователя, которые создают эти значения.

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

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

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

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

Используйте SelectionType для определения того, нажал ли пользователь клавиши-модификаторы.

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

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

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

Используйте gcbo функция в вашей CreateFcn для получения создаваемого объекта компонента.

Установка CreateFcn свойство для существующего объекта-компонента не влияет.

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

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

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

Используйте gcbo функция в вашей DeleteFcn для получения удаляемого объекта компонента.

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

Эта функция обратного вызова выполняется, когда пользователь нажимает клавишу, в то время как фигура или дочерний объект имеет фокус. Если пользователь нажимает клавишу на UIControl или Table , обратный вызов не выполняется, если Enable свойство имеет значение 'off' или 'inactive'.

Если пользователь нажимает несколько клавиш приблизительно одновременно, MATLAB обнаруживает все клавиши.

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

Дополнительные сведения об указании значений свойств обратного вызова и использовании аргументов обратного вызова см. в разделе Как задать значения свойств обратного вызова.

CurrentCharacter свойство также возвращает символьную информацию.

Обратный вызов с освобождением ключа, указанный как одно из этих значений

Эта функция обратного вызова выполняется, когда пользователь нажимает клавишу, в то время как фигура или дочерний объект имеет фокус. Если пользователь отпускает клавишу на UIControl или Table , обратный вызов не выполняется, если Enable свойство имеет значение 'off' или 'inactive'.

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

Дополнительные сведения об указании значений свойств обратного вызова и использовании аргументов обратного вызова см. в разделе Как задать значения свойств обратного вызова.

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

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

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

Основным механизмом является:

closereq функция чтит ShowHiddenHandles параметр свойства во время удаления фигуры и не удаляет скрытые фигуры.

Если функция запроса закрытия не вызывает delete или close функция MATLAB никогда не закрывает фигуру. (Вы можете позвонить delete(f) из командной строки, если создано окно с функцией неразрушающего запроса закрытия.)

Пример: Диалоговое окно «Код CloseRequestFcn для отображения»

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

function my_closereq(src,callbackdata)
% Close request function 
% to display a question dialog box 
   selection = questdlg('Close This Figure?',...
      'Close Request Function',...
      'Yes','No','Yes'); 
   switch selection 
      case 'Yes'
         delete(gcf)
      case 'No'
      return 
   end
end

Теперь создайте фигуру, задающую my_closereq для CloseRequestFcn:

figure('CloseRequestFcn',@my_closereq)

Закройте окно рисунка и откроется диалоговое окно вопросов.

Размер измененного обратного вызова, указанного как одно из следующих значений:

Определите этот обратный вызов для настройки макета приложения при изменении размера контейнера (например, при изменении размера окна пользователем).

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

Другие важные моменты, которые следует учитывать при определении SizeChangedFcn обратный вызов:

Пример: Редактировать поле с постоянной высотой

Используйте SizeChangedFcn обратный вызов для ограничения размера компонентов пользовательского интерфейса. Например, следующий код создает пользовательский интерфейс с полем редактирования в верхней части окна. Когда пользователь изменяет размер окна, sbar функция ограничивает свою высоту 20 пикселями. Функция также устанавливает ширину поля редактирования как ширину фигуры. Используйте точечную нотацию для задания и запроса свойств.

function myui
f = figure('Visible','off','SizeChangedFcn',@sbar); 
u = uicontrol('Style','edit','Tag','StatusBar');
f.Visible = 'on';
    function sbar(src,callbackdata)
       old_units = src.Units;
       src.Units = 'pixels';
       sbar_units = u.Units;
       u.Units = 'pixels';
       fpos = src.Position;
       upos = [1 fpos(4) - 20 fpos(3) 20];
       u.Position = upos;
       u.Units = sbar_units;
       src.Units = old_units;
       u.Visible = 'on';
    end
end

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

Этот обратный вызов выполняется, когда пользователь щелкает в любом месте фигуры или одного из своих дочерних объектов. Если пользователь щелкает UIControl или Table , обратный вызов не выполняется, если Enable свойство имеет значение 'off' или 'inactive'.

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

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

Обычно эта функция обратного вызова выполняется всякий раз, когда пользователь перемещает указатель в пределах фигуры. Однако если пользователь щелкает и удерживает кнопку мыши и перемещает указатель за пределы фигуры, WindowButtonMotionFcn обратный вызов выполняется, пока указатель находится вне фигуры.

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

Пример: Простое приложение для рисования

В этом примере показано, как создать приложение для рисования, использующее WindowButtonMotionFcn обратный вызов. Скопируйте и вставьте следующий код в редактор и запустите его. Затем с помощью мыши нарисуйте набор соединенных сегментов линий:

function drawing_app
figure('WindowButtonDownFcn',@wbdcb)
ah = axes('SortMethod','childorder');
axis ([1 10 1 10])
title('Click and drag')
   function wbdcb(src,callbackdata)
     seltype = src.SelectionType;
     if strcmp(seltype,'normal')
        src.Pointer = 'circle';
        cp = ah.CurrentPoint;
        xinit = cp(1,1);
        yinit = cp(1,2);
        hl = line('XData',xinit,'YData',yinit,...
        'Marker','p','color','b');
        src.WindowButtonMotionFcn = @wbmcb;
        src.WindowButtonUpFcn = @wbucb;
     end    
 
        function wbmcb(src,callbackdata)
           cp = ah.CurrentPoint;
           xdat = [xinit,cp(1,1)];
           ydat = [yinit,cp(1,2)];
           hl.XData = xdat;
           hl.YData = ydat;
           drawnow
        end
   
        function wbucb(src,callbackdata)
           last_seltype = src.SelectionType;
           if strcmp(last_seltype,'alt')
              src.Pointer = 'arrow';
              src.WindowButtonMotionFcn = '';
              src.WindowButtonUpFcn = '';
           else
              return
           end
        end
  end
end

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

Этот обратный вызов выполняется, когда пользователь отпускает кнопку мыши в любом месте рисунка или одного из его дочерних объектов. Если пользователь отпускает кнопку мыши на UIControl или Table , обратный вызов не выполняется, если Enable свойство имеет значение 'off' или 'inactive'.

Действия «кнопка вверх» связаны с действиями «кнопка вниз» на рисунке. Указатель мыши должен находиться внутри фигуры, когда происходит действие «кнопка вниз», но он может находиться вне фигуры, когда происходит действие «кнопка вверх».

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

Окно (Window) - обратный вызов нажатием клавиши, указанное как одно из этих значений

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

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

Дополнительные сведения об указании значений свойств обратного вызова и использовании аргументов обратного вызова см. в разделе Как задать значения свойств обратного вызова.

Обратный вызов с освобождением ключа окна, указанный как одно из этих значений

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

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

Дополнительные сведения об указании значений свойств обратного вызова и использовании аргументов обратного вызова см. в разделе Как задать значения свойств обратного вызова.

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

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

Выполнение этого обратного вызова не влияет на CurrentObject и SelectionType свойства.

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

Дополнительные сведения об указании значений свойств обратного вызова и использовании аргументов обратного вызова см. в разделе Как задать значения свойств обратного вызова.

Пример: Приложение для изменения пределов оси X

В этом примере показано, как создать приложение, отображающее график. Пользователь может выполнить прокрутку для изменения пределов оси X. Скопируйте и вставьте следующий код в редактор и запустите его.

function scroll_wheel
% Shows how to use WindowScrollWheelFcn property
%
   f = figure('WindowScrollWheelFcn',@figScroll,'Name','Scroll Wheel Demo');
   x = [0:.1:40];
   y = 4.*cos(x)./(x+2);
   a = axes; 
   h = plot(x,y);
   title('Rotate the scroll wheel')

   function figScroll(src,callbackdata)
      if callbackdata.VerticalScrollCount > 0 
         xd = h.XData;
         inc = xd(end)/20;
         x = [0:.1:xd(end)+inc];
         re_eval(x)
      elseif callbackdata.VerticalScrollCount < 0 
         xd = h.XData;
         inc = xd(end)/20;
         x = [0:.1:xd(end)-inc+.1]; % Don't let xd = 0;
         re_eval(x)
      end
   end

   function re_eval(x)
      y = 4.*cos(x)./(x+2);
      h.YData = y;
      h.XData = x;
      a.XLim = [0 x(end)];
      drawnow
   end
end

Изменить размер функции обратного вызова, указанной как одно из следующих значений:

Типы данных: function_handle | cell | char

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

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

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

Пример, показывающий, как Interruptible и BusyAction свойства влияют на поведение программы.

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

BusyAction свойство источника обратного вызова прерывания определяет, как MATLAB обрабатывает его выполнение. BusyAction свойство имеет следующие значения:

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

Пример, показывающий, как BusyAction и Interruptible свойства влияют на поведение программы.

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

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

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

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

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

Родительский объект фигуры, возвращенный как корневой объект.

Дети Figure, возвращено как пустое GraphicsPlaceholder или 1-D массив объектов.

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

Чтобы добавить дочерний элемент в этот список, установите Parent свойства дочернего компонента для Figure объект.

Объекты с HandleVisibility свойство имеет значение 'off' не перечислены в Children собственность.

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

Это свойство определяет, входит ли фигура в родительский (корневой) список нижестоящих элементов. HandleVisibility полезен для предотвращения случайного рисования пользователем командной строки или удаления фигуры, содержащей только компоненты интерфейса пользователя (например, диалоговое окно).

Если объект отсутствует в списке нижестоящих элементов родительского объекта, функции, которые находят объекты путем поиска в иерархии объектов или запроса свойств, не могут вернуть этот объект. К таким функциям относятся get, findobj, gca, gcf, gco, newplot, cla, clf, и close.

Когда HandleVisibility значение свойства ограничено с помощью 'callback' или 'off' параметры, объект не отображается в родительском объекте Children свойство, фигуры не отображаются в корне CurrentFigure свойство, объекты не отображаются в корне CallbackObject свойства или на рисунке CurrentObject свойства и оси не отображаются в родительских CurrentAxes собственность.

Установка корня ShowHiddenHandles свойство для 'on' чтобы сделать видимыми все объекты, независимо от их HandleVisibility (это не влияет на значения HandleVisibility свойства).

Имя фигуры, указанное как символьный вектор или строковый скаляр.

Пример: figure('Name','Results') задает имя фигуры как 'Results'.

По умолчанию имя: 'Figure n', где n - целое число. При указании Name свойство, название фигуры становится 'Figure n: name'. Если вы хотите только Name значение для отображения, установка IntegerHandle или NumberTitle кому 'off'.

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

Число фигуры, возвращаемое в виде целого или пустого массива. Это значение используется для ссылки на рисунок. Например, figure(2) делает фигуру с Number значение свойства 2 текущий показатель.

Если IntegerHandle свойство имеет значение 'off', Number пустое свойство.

Если IntegerHandle является 'on', Number свойство является целым числом. При удалении фигуры MATLAB повторно использует номер для следующей фигуры.

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

При установке для этого свойства значения 'on', название фигуры включает фразу 'Figure n', где n - значение Number собственность.

Оба NumberTitle и IntegerHandle необходимо установить значение 'on' для отображения номера в заголовке.

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

Если установить IntegerHandle свойство для 'on', MATLAB находит наименьшее целое значение, которое не используется существующим рисунком, и устанавливает Number свойство для этого значения. При удалении фигуры MATLAB может повторно использовать ее номер на новой фигуре.

Если установить IntegerHandle свойство для 'off', MATLAB не присваивает цифре целое значение и устанавливает значение Number для пустого массива.

Для отображения номера фигуры в строке заголовка: IntegerHandle и NumberTitle необходимо установить значение 'on'.

Имя файла для сохранения фигуры, указанное как символьный вектор или строковый скаляр. GUIDE использует это свойство для хранения имени файла макета пользовательского интерфейса, который он сохраняет.

Пример: figure('FileName','myfile.fig') устанавливает имя файла на myfile.fig.

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

Тип объекта Figure, возвращенный как 'figure'. Это свойство используется для поиска всех объектов данного типа в иерархии печати.

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

Пользовательские данные, указанные как любой массив. Определение UserData может быть полезен для совместного использования данных в приложениях. Дополнительные сведения см. в разделе Совместное использование данных среди обратных вызовов.