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

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

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

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

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

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

Интерактивная фигура, прикрепляющаяся, заданный как одно из следующего:

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

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

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

Типы данных: удвойтесь | char

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

Модальное поведение стиля окна

Когда WindowStyle установлен в 'modal', окно фигуры захватывает всю клавиатуру и действия мыши по всем окнам MATLAB, пока окна видимы. Windows, принадлежащий приложениям кроме 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'. Когда это свойство установлено в 'on', фигура изменяемого размера. В противном случае это не изменяемого размера.

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

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

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

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

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

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

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 пользуется в вашей системе, введите следующую команду в посдказке MATLAB:

opengl info

Возвращенная информация содержит строку, которая указывает, использует ли MATLAB программное обеспечение OpenGL (Software = true) или аппаратно ускорил OpenGL (Software = false).

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

Знайте, что издание команды opengl info заставляет MATLAB, инициализируют OpenGL.

Потерянная связь XServer

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

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

 matlab -softwareopengl

Выбор средства отображения, заданный как:

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

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

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

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

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

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

Пример: фигура ('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 к соответствующему размеру страницы.

Изобразите цвет фона при сохранении или печати, заданный как одно из этих значений:

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

Символ пользовательского указателя

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

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

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

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

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

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

Целевые оси в текущей фигуре, заданной как объект Axes, объект 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. Используйте это свойство отобразить контекстное меню, когда пользователь щелкнет правой кнопкой по компоненту UI. Создайте контекстное меню с помощью функции uicontextmenu.

Изобразите видимость, заданную как 'on' или 'off'. Свойство Visible определяет, отображается ли фигура на экране. Если свойство Visible фигуры установлено в 'off', целая фигура невидима, но можно все еще задать и получить доступ к его свойствам.

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

Кнопка вниз обратный вызов, заданный как одно из этих значений:

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

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

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

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

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

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

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

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

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

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

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

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

Обратный вызов нажатия клавиши, заданный как одно из этих значений:

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

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

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

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

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

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

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

Обратный вызов 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)

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

Размер изменил обратный вызов, заданный как одно из этих значений:

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

Обратный вызов SizeChangedFcn выполняется когда:

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

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

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

При использовании R2014b или позже, используйте запись через точку, чтобы установить и запросить свойства:

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

При использовании R2014a или более ранний релиз, используйте этот код вместо этого.

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

Кнопка Window вниз обратный вызов, заданный как одно из этих значений:

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

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

Обратный вызов движения кнопки Window, заданный как одно из этих значений:

Как правило, эта функция обратного вызова выполняется каждый раз, когда пользователь перемещает указатель в фигуре. Однако, если пользователь кликает и удерживает кнопку мыши и перемещает указатель вне фигуры, обратный вызов 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;
     % This code uses dot notation to set properties
     % Dot notation runs in R2014b and later.
     % For R2014a and earlier: seltype = get(src,'SelectionType');
     if strcmp(seltype,'normal')
        src.Pointer = 'circle';
        cp = ah.CurrentPoint;
        % For R2014a and earlier: 
        % set(src,'Pointer','circle');
        % cp = get(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;
        % For R2014a and earlier: 
        % set(src,'WindowButtonMotionFcn',@wbmcb);
        % set(src,'WindowButtonUpFcn',@wbucb);

     end    
 
        function wbmcb(src,callbackdata)
           cp = ah.CurrentPoint;
           % For R2014a and earlier: 
           % cp = get(ah,'CurrentPoint');
           xdat = [xinit,cp(1,1)];
           ydat = [yinit,cp(1,2)];
           hl.XData = xdat;
           hl.YData = ydat;
           % For R2014a and earlier: 
           % set(hl,'XData',xdat);
           % set(hl,'YData',ydat);
           drawnow
        end
   
        function wbucb(src,callbackdata)
           last_seltype = src.SelectionType;
           % For R2014a and earlier: 
           % last_seltype = get(src,'SelectionType');
           if strcmp(last_seltype,'alt')
              src.Pointer = 'arrow';
              src.WindowButtonMotionFcn = '';
              src.WindowButtonUpFcn = '';
              % For R2014a and earlier:
              % set(src,'Pointer','arrow');
              % set(src,'WindowButtonMotionFcn','');
              % set(src,'WindowButtonUpFcn','');
           else
              return
           end
        end
  end
end

Обратный вызов кнопки окна, заданный как одно из этих значений:

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

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

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

Обратный вызов нажатия клавиши окна, заданный как одно из этих значений

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

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с клавиатурой. 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;
         % This code uses dot notation to set properties
         % Dot notation runs in R2014b and later.
         % For R2014a and earlier: xd = get(h,'XData');
         inc = xd(end)/20;
         x = [0:.1:xd(end)+inc];
         re_eval(x)
      elseif callbackdata.VerticalScrollCount < 0 
         xd = h.XData;
         % For R2014a and earlier: xd = get(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)];
      % For R2014a and earlier: 
      % set(h,'YData',y);
      % set(h,'XData',x);
      % set(a,'XLim',[0 x(end)]);
      drawnow
   end
end

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

Типы данных: function_handle | ячейка | char

Прерывание обратного вызова, обозначаемое как 'on' или 'off'. Свойство «Прерывание» определяет, можно ли прерывать выполняемый обратный вызов.

Существует два состояния обратного вызова:

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

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

Постановка в очередь обратного вызова, заданная как 'queue' (значение по умолчанию) или 'cancel'. The BusyAction property determines how MATLAB handles the execution of interrupting callbacks. There are two callback states to consider:

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

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

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

Способность стать текущим объектом, заданным как 'on' или 'off':

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

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

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

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

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

Вы не можете добавить или удалить дочерние элементы, использующие свойство 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 n', где n является целым числом. Когда вы задаете свойство Name, заголовок фигуры становится 'Figure n: name' имя. Если вы хотите только, чтобы значение Name появилось, установите IntegerHandle или NumberTitle к 'off'.

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

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

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

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

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

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

Используйте целочисленный указатель, заданный как 'on' или 'off'.

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

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

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

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

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

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

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

Идентификатор объекта, заданный как вектор символа или скаляр строки. You can specify a unique Tag value to serve as an identifier for any component object in your app. When you need access to the object elsewhere in your code, you can use the findobj function to search for the object based on the Tag value.

Пример: фигура ('Тег', 'plotwindow') создает фигуру, идентификатор тега которой является 'plotwindow'.

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