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

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

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

Отображение панели инструментов фигуры, заданное как одно из следующего:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Нажатие кнопки минимизации, максимизации или восстановления, предоставляемой операционной системой, устанавливает WindowState соответственно. Нажатие Ctrl+F11 (Окна^® и 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

MATLAB обращается к этим цветам по их номеру строки.

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

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

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

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

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

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

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

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

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

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

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

OpenGL доступна на всех компьютерах, которые запускают MATLAB, так как в MATLAB встроена версия программного обеспечения OpenGL. Однако, если у вас есть графическое оборудование, поддерживающее аппаратно ускоренную версию 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

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

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

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

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

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

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

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

The 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

Ограничения

Пользовательский символ указателя, заданный как 16-by- 16 матрица (для указателя на 16 пикселей) или как 32-by- 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

Установка CreateFcn свойство существующего объекта компонента не имеет эффекта.

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

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

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

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

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

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

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

Key-release коллбэк, заданный в качестве одного из следующих значений

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

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

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

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

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

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

Пример: Диалоговое окно Code 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)

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

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

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

The 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'.

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

Клавиша окна - обратный коллбэк, заданный как одно из следующих значений

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

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

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

Window key-release callback, заданный как одно из следующих значений

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

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

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

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

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

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

The 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

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

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

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

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

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

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

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

MATLAB устанавливает BeingDeleted свойство к 'on' когда DeleteFcn коллбэк начинает выполняться. The 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

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

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

Чтобы отобразить номер рисунка в строке заголовка, оба IntegerHandle и NumberTitle должно быть установлено в 'on'.

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

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

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

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

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

Пользовательские данные, заданные как любой массив. Определение UserData может быть полезным для обмена данными в приложениях См. Раздел «Обмен данными между коллбэками» для получения дополнительной информации.