GeographicAxes Properties

Управляйте географическим внешним видом и поведением осей

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

Некоторые графические функции создают географические оси при графическом изображении. Используйте gca, чтобы получить доступ к недавно созданным осям. Чтобы создать географические оси со значениями по умолчанию для всех свойств, используйте функцию geoaxes.

gx = geoaxes;

Карты

развернуть все

Сопоставьте, по которому можно отобразить на графике данные, заданные как один из скаляров строки или векторов символов в следующей таблице или 'none'. По умолчанию географические оси используют основную карту 'darkwater', которая установлена с продуктом. Если вы выбираете один из других basemaps, географические оси получает доступ к карте по Интернету. MathWorks® размещает эти basemaps. Если у вас нет сопоставимого доступа к Интернету, можно загрузить эти basemaps на локальную систему. Для получения дополнительной информации о загрузке basemaps, см. Доступ к базовым картам в MATLAB. Если вы задаете 'none', географические оси отображает ваши данные на графике, с сеткой долготы широты, метками деления и метками, но не включает карту.

Basemaps

Двухцветный BasemapsОписаниеЕстественная земля BasemapsОписание

'darkwater' (значение по умолчанию)

Контактные площадки: серый свет-к-умеренному

Океанские и водные области: более темно-серый

'colorterrain'

Теневая вспомогательная карта смешивается с палитрой растительного покрова. Влажная низменность является зеленой и засушливой коричневой низменностью.

'grayland'

Контактные площадки: свет-к-умеренному серая земля

Океанские и водные области: белый

'grayterrain'

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

'bluegreen'

Контактные площадки: светло-зеленый

Океанские и водные области: голубой

'landcover'

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

Пример: gx = geoaxes (__, 'Основная карта', 'bluegreen')

Пример: gx. Основная карта = 'bluegreen'

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

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

Пределы широты карты, заданной как 1 2 вектор действительных, конечных значений формы [southern_limit northern_limit] в области значений [-90,90].

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

Пример: [-85 85]

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

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

Пределы долготы карты, заданной как 1 2 вектор действительных, конечных значений формы [western_limit eastern_limit]. Значения должны быть в области значений (-Inf, Inf).

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

Пример: [-100 100]

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

Центральная точка карты в широте и долготе, заданной как двухэлементный вектор действительных, конечных значений формы [center_latitude center_longitude].

Пример: [38.6292 - 95.2520]

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

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

  • 'auto' Автоматически выберите центр карты на основе области значений данных для оси.

  • 'manual' — Вручную задайте центр карты. Чтобы задать значения, установите свойство MapCenter.

Пример: gx. MapCenterMode = 'auto'

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

Уровень увеличения карты, заданной в виде действительного, конечного, числа от 0 до 25, включительно. Значение является основой 2 логарифмических шкалы карты. При увеличении значения ZoomLevel каждый удваивает шкалу карты.

Типы данных: единственный | удваиваются | uint8 | uint16 | uint32 | uint64 | int8 | int16 | int32 | int64

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

  • 'auto' Автоматически выберите уровень изменения масштаба на основе области значений данных для оси.

  • 'manual' — Вручную задайте уровень изменения масштаба. Чтобы задать значения, установите свойство ZoomLevel.

Пример: gx. ZoomLevelMode = 'руководство'

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

Шрифт

развернуть все

Название шрифта, заданное как поддерживаемое название шрифта или 'FixedWidth'. Чтобы отобразить и распечатать текст правильно, необходимо выбрать шрифт, который поддерживает система. Стандартный шрифт зависит от вашей операционной системы и локали.

Чтобы использовать шрифт фиксированной ширины, который выглядит хорошим в любой локали, используйте 'FixedWidth'. Шрифт фиксированной ширины полагается на корневое свойство FixedWidthFontName. Установка корневого свойства FixedWidthFontName заставляет незамедлительное обновление отображения использовать новый шрифт.

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

MATLAB® автоматически масштабирует часть текста к проценту размера шрифта осей.

  • Заголовки — 110% размера шрифта осей по умолчанию. Чтобы управлять масштабированием, используйте свойства TitleFontSizeMultiplier и LabelFontSizeMultiplier.

  • Легенды и шкалы палитры — 90% размера шрифта осей по умолчанию. Чтобы задать различный размер шрифта, установите свойство FontSize для объекта Legend или Colorbar вместо этого.

Пример: gx. FontSize = 12

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

  • 'auto' Размер шрифта задан MATLAB. Если вы изменяете размер осей, чтобы быть меньшими, чем размер по умолчанию, размер шрифта может уменьшиться, чтобы улучшить удобочитаемость и размещение.

  • 'manual' — Размер шрифта задан вручную. Не масштабируйте размер шрифта, когда размер осей изменяется. Чтобы задать размер шрифта, установите свойство FontSize.

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

Символьная толщина, заданная как 'normal' или 'bold'.

MATLAB использует свойство FontWeight выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирный вес. Поэтому определение полужирной толщины шрифта может все еще привести к обычной толщине шрифта.

Наклонные символы, заданные как 'normal' или 'italic'.

Не все шрифты имеют оба стилей шрифтов. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

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

Пример: gx. LabelFontSizeMultiplier = 1.75

Типы данных: единственный | удваиваются | uint8 | uint16 | uint32 | uint64 | int8 | int16 | int32 | int64

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

Пример: gx. TitleFontSizeMultiplier = 1.75

Типы данных: единственный | удваиваются | uint8 | uint16 | uint32 | uint64 | int8 | int16 | int32 | int64

Толщина заглавного героя, заданная как одно из этих значений:

  • 'bold' — Более толстые основы символов, чем нормальный

  • normal' — Насыщенность по умолчанию, определяемая конкретным видом шрифта

Пример: gx. TitleFontWeight = 'normal'

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

Модули размера шрифта, заданные как одно из этих значений.

МодулиОписание
'points''points'. Один пункт равен 1/72 дюйма.
'inches''inches'.
'centimeters''centimeters'.
'normalized' Интерпретируйте размер шрифта как часть высоты осей. Если вы изменяете размер осей, размер шрифта изменяет соответственно. Например, если FontSize является 0.1 в нормированных единицах, то текст является 1/10 значения высоты, сохраненного в свойстве Position осей.
'pixels'

'pixels'.

Расстояния в пикселях независимы от вашего системного разрешения.

  • В системах Windows® пиксель является 1/96-м из дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

  • В системах Linux® размер пикселя определяется вашим системным разрешением.

Чтобы установить и размер шрифта и модули шрифта в единственном вызове функции, сначала необходимо установить свойство FontUnits так, чтобы объект Axes правильно интерпретировал заданный размер шрифта.

Метки деления

развернуть все

Направление отметки деления, заданное как одно из этих значений:

  • \in Направьте отметки деления внутрь от схемы осей.

  • 'out' — Направьте отметки деления, исходящие от схемы осей.

  • 'both' — Центрируйте отметки деления по схеме осей.

Пример: gx. TickDir =;

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

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

  • 'auto' Автоматически выберите направление метки деления на основе текущего представления.

  • 'manual' — Вручную задайте направление метки деления. Чтобы задать направление метки деления, установите свойство TickDir.

Пример: gx. TickDirMode = 'auto'

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

Сетки

развернуть все

Отображение линий сетки широты и долготы, заданных как 'on', показывает, что линии сетки или 'off', не показывают линии сетки.

Пример: gx. Сетка = 'off';

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

Стиль линии для линий сетки, заданных как один из стилей линии в этой таблице.

Стиль линииОписаниеПолучившаяся строка
'-'Сплошная линия

'--'Пунктирная линия

':'Пунктирная линия

'-.'Штрих-пунктирная линия

'none'Никакая строкаНикакая строка

Чтобы отобразить линии сетки, используйте команду grid on или установите свойство Grid на 'on'.

Пример: gx. GridLineStyle = '-'

Цвет фона, заданный как триплет RGB или ColorSpec (Color Specification) MATLAB. Фактический цвет сетки зависит от значений свойств GridColorMode и RColorMode. Смотрите GridColorMode для получения дополнительной информации.

Пример: gx. GridColor = [0 0 1]

Пример: gx. GridColor = 'b'

Пример: gx. GridColor = 'синий'

Свойство для установки цвета сетки, заданного как одно из этих значений:

  • 'auto' Проверьте значения свойств RColorMode и ThetaColorMode определить цвета линий сетки для направлений теты и r.

  • 'manual' — Используйте GridColor, чтобы установить цвет линий сетки для всех направлений.

Прозрачность линии сетки, заданная как значение в области значений [0,1]. Значение 1 означает непрозрачный и значение абсолютно прозрачных средних значений 0.

Пример: gx. GridAlpha = 0.5

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

  • 'auto' Значение прозрачности по умолчанию 0.15.

  • 'manual' — Вручную задайте значение прозрачности. Чтобы задать значение, установите свойство GridAlpha.

Пример: gx. GridAlphaMode = 'auto'

Метки

развернуть все

Заголовок осей, заданный как объект Text. Чтобы добавить заголовок, установите свойство String текстового объекта. Чтобы изменить внешний вид заголовка, такой как стиль шрифта или цвет, устанавливают другие свойства. Для полного списка смотрите Text Properties.

Пример: gx. Заголовок = 'Мой Географический График"

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

Легенда сопоставлена с географическим объектом осей, заданным как объект Legend. Чтобы добавить легенду к географическим осям, используйте функцию legend. Затем можно использовать это свойство изменить легенду. Для полного списка свойств смотрите Legend Properties.

geoplot(rand(3))
legend({'Line 1','Line 2','Line 3'},'FontSize',12)
gx = gca;
gx.Legend.TextColor = 'red';

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

gx = gca;
lgd = gx.Legend
if ~isempty(lgd)
    disp('Legend Exists')
end

Несколько графиков

развернуть все

Последовательность цветов, заданная как матрица с тремя столбцами триплетов RGB. Каждая строка матрицы задает один цвет в последовательности цветов. Порядок цвета по умолчанию имеет семь цветов.

Порядок цвета по умолчаниюСвязанные триплеты RGB

    [    0    0.4470    0.7410
    0.8500    0.3250    0.0980
    0.9290    0.6940    0.1250
    0.4940    0.1840    0.5560
    0.4660    0.6740    0.1880
    0.3010    0.7450    0.9330
    0.6350    0.0780    0.1840]

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

Если вы использовали команду hold on или если свойство NextPlot осей установлено в 'add', индексное значение последовательности цветов увеличивается каждый раз, когда новый график добавляется. Сбросьте последовательность цветов путем установки свойства ColorOrderIndex на 1.

Пример: gx. ColorOrderIndex = 5

Порядок LineStyle, заданный как вектор символа, массив ячеек из символьных векторов или массив строк. Создайте каждый элемент с помощью одного или нескольких перечисленных в таблице спецификаторов LineStyle. Можно объединить строку и спецификатор маркера в единственном элементе, таком как '-*'.

Пример: O

Циклы MATLAB через стили линии только после использования всех цветов содержатся в свойстве ColorOrder. LineStyleOrder по умолчанию имеет только один стиль линии, '-'.

СпецификаторСтиль линии
'-' (значение по умолчанию) Сплошная линия
'--'Пунктирная линия
':'Пунктирная линия
'-.'Штрих-пунктирная линия
'+'Маркеры знака "плюс"
OКруговые маркеры
'*'Маркеры-звездочки
'.'Укажите маркеры
XПерекрестные маркеры
SКвадратные маркеры
DРомбовидные маркеры
'^'Маркеры Треугольника, направленного вверх
VМаркеры Нисходящего треугольника
'>'Маркеры треугольника, указывающего вправо
'<'Маркеры треугольника, указывающего влево
PПятиконечная звезда (пентаграмма) маркеры
HМаркеры Шестиконечной звезды (гексаграмма)

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

Если вы использовали команду hold on или если свойство NextPlot осей установлено в 'add', то индексное значение увеличивается каждый раз, когда вы добавляете новый график. Последующий цикл графиков через порядок LineStyle. Сбросьте порядок LineStyle путем установки свойства LineStyleOrderIndex на 1.

Пример: gx. LineStyleOrderIndex = 1

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

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

  • 'replacechildren' — Удалите существующие графики прежде, чем отобразить новый график. Сбросьте свойства ColorOrderIndex и LineStyleOrderIndex к 1, но не сбрасывайте другие свойства осей. Следующий график, добавленный к осям, использует первый цветной и стиль линии на основе ColorOrder и свойств порядка LineStyle. Это значение подобно использованию cla перед каждым новым графиком.

  • замена Удалите существующие графики и сбросьте свойства осей, кроме Position и Units, к их значениям по умолчанию прежде, чем отобразить новый график.

  • 'replaceall' — Удалите существующие графики и сбросьте свойства осей, кроме Position и Units, к их значениям по умолчанию прежде, чем отобразить новый график. Это значение подобно использованию cla reset перед каждым новым графиком.

Фигуры также имеют свойство NextPlot. Также можно использовать функцию newplot, чтобы подготовить фигуры и оси для последующих графических команд.

Порядок для рендеринга объектов, заданных как одно из этих значений:

  • 'depth' — Графические объекты в наоборот заказывают на основе текущего представления. Используйте это значение, чтобы гарантировать, что объекты перед другими объектами чертятся правильно.

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

Цвет и карты прозрачности

развернуть все

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

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

Пример: gx. Палитра = [1 0 1; 0 0 1; 1 1 0] наборы карта цветов к трем цветам: пурпурный, синий цвет, и желтый.

Масштабируйтесь для цветного отображения, заданного как одно из этих значений:

  • 'linear' — Линейная шкала. Значения деления вдоль шкалы палитры также используют линейную шкалу.

  • журнал Логарифмическая шкала. Значения деления вдоль шкалы палитры также используют логарифмическую шкалу.

Пример: gx. ColorScale = 'журнал'

Цветные пределы для палитры, заданной как двухэлементный вектор формы [cmin cmax].

Если связанный режим свойство установлено в 'auto', то MATLAB выбирает цветные пределы. Если вы присваиваете значение этому свойству, то MATLAB устанавливает режим на 'manual' и автоматически не выбирает цветные пределы.

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

  • 'auto' Автоматически выберите пределы на основе цветных данных графических объектов, содержавшихся в осях.

  • 'manual' — Вручную задайте значения. Чтобы задать значения, установите свойство CLim. Значения не изменяются, когда пределы дочерних элементов осей изменяются.

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

Масштабируйтесь для отображения прозрачности, заданного как одно из этих значений:

  • 'linear' — Линейная шкала

  • журнал Логарифмическая шкала

Пример: ax. AlphaScale = 'журнал'

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

Альфа ограничивает для alphamap, заданного как двухэлементный вектор формы [amin amax].

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

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

  • 'auto' Автоматически выберите пределы на основе значений AlphaData графических объектов, содержавшихся в осях.

  • 'manual' — Вручную задайте альфа-пределы. Чтобы задать альфа-пределы, установите свойство ALim.

Моделирование поля

развернуть все

Цвет фона, заданный как триплет RGB или ColorSpec (Color Specification) MATLAB. Цвет фона только видим когда Basemap свойство установлено в 'none'.

Пример: gx. Цвет = 'красный'

Ширина строк, заданных как положительное скалярное значение в модулях точки. Один пункт равен 1/72 дюйма.

Пример: gx. LineWidth = 1.5

Обрисуйте в общих чертах вокруг географических осей, заданных или как 'on' или как 'off'.

Пример: gx. Поле = 'off'

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

Положение

развернуть все

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

По умолчанию значения измеряются в модулях, нормализованных к контейнеру. Чтобы изменить модули, установите свойство Units. Значение по умолчанию [0 0 1 1] включает целую внутреннюю часть контейнера.

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

По умолчанию значения измеряются в модулях, нормализованных к контейнеру. Чтобы изменить модули, установите свойство Units.

Пример: gx. Положение = [0 0 1 1]

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

Поля для текстовых меток, возвращенных как четырехэлементный вектор формы [left bottom right top]. Элементы задают расстояния между границами свойства Position и степенью географических текстовых меток осей и заголовка. По умолчанию значения измеряются в модулях, нормализованных фигуре или uipanel, который содержит географические оси. Чтобы изменить модули, установите свойство Units.

Свойство Position и свойство TightInset задают самую трудную ограничительную рамку, которая заключает географические оси и ее метки и заголовок.

Свойство активной позиции во время изменяет размер операции, заданной как одно из этих значений:

  • OuterPosition Содержите постоянное свойство OuterPosition.

  • 'position' — Содержите постоянное свойство Position.

Фигура может изменить размер, если вы в интерактивном режиме изменяете размер его или во время печати или экспорта операции.

Модули положения, заданные как одно из этих значений.

МодулиОписание
'normalized' (значение по умолчанию)Нормализованный относительно контейнера, который обычно является фигурой или панелью. Левый нижний угол контейнера сопоставляет с (0,0), и правый верхний угол сопоставляет с (1,1).
'inches''inches'.
'centimeters''centimeters'.
'characters'

На основе шрифта uicontrol по умолчанию графического корневого объекта:

  • Ширина символов = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'points'Точки книгопечатания. Один пункт равен 1/72 дюйма.
'pixels'

'pixels'.

  • В системах Windows пиксель составляет 1/72 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

  • В системах Linux размер пикселя определяется вашим системным разрешением.

При определении модулей как пары Name,Value во время создания объекта необходимо установить свойство Units прежде, чем задать свойства, что вы хотите использовать эти модули, такие как Position.

Интерактивность

развернуть все

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

Если вы не хотите, чтобы панель инструментов появилась, когда вы нависаете над географическими осями, устанавливаете свойство Visible объекта AxesToolbar к 'off'. Для получения дополнительной информации о свойствах объекта AxesToolbar, смотрите AxesToolbar Properties.

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

  • 'on' — Отображать объект.

  • 'off' — Скрыть объект, не удаляя его. Вы по-прежнему можете получать доступ к свойствам невидимого объекта.

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

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

Примечание

Если для свойства PickableParts задано значение 'none', или если для свойства HitTest установлено значение 'off', контекстное меню не отображается.

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

  • 'on' — Выбран. Если вы кликаете на объект, находясь в режиме редактирования графика, MATLAB устанавливает для свойства Selected значение 'on'. Если для свойства SelectionHighlight задано значение 'on', MATLAB отображает маркеры выделения вокруг объекта.

  • off' — Не выбран.

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

  • 'on' — Отображать маркеры выделения, если для свойства Selected задано значение 'on'.

  • 'off' — Никогда не отображать маркеры выделения, даже если для свойства Selected задано значение 'on'.

Обратные вызовы

развернуть все

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

  • Указатель на функцию

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

  • Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)

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

  • Объект, по которому кликают — свойства Access объекта, по которому кликают, из функции обратного вызова.

  • Данные о событиях — Пустой аргумент. Замените его на символ тильды (~) в функциональном определении, чтобы указать, что этот аргумент не используется.

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

Примечание

Если для свойства PickableParts задано значение 'none', или если для свойства HitTest задано значение 'off', этот обратный вызов не выполняется.

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

  • Указатель на функцию

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

  • Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)

Используйте это свойство для выполнения кода при создании объекта. MATLAB выполняет обратный вызов после создания объекта и настройки всех его свойств. Установка значения свойства CreateFcn не влияет на существующий объект . Для того, чтобы действие было эффективным, вам необходимо задать свойство CreateFcn во время создания объекта. Один из способов задать свойство во время создания объекта — задать значение свойства по умолчанию для объекта. Для получения дополнительной информации см. Раздел "Значения свойств по умолчанию".

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

  • Созданный объект — свойства Access объекта из функции обратного вызова. Также можно получить доступ к объекту через свойство CallbackObject графического корневого объекта, который может быть запрошен с помощью функции gcbo.

  • Данные о событиях — Пустой аргумент. Замените его на символ тильды (~) в функциональном определении, чтобы указать, что этот аргумент не используется.

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

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

  • Указатель на функцию

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

  • Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)

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

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

  • Удаленный объект — свойства Access объекта из функции обратного вызова. Также можно получить доступ к объекту через свойство CallbackObject графического корневого объекта, который может быть запрошен с помощью функции gcbo.

  • Данные о событиях — Пустой аргумент. Замените его на символ тильды (~) в функциональном определении, чтобы указать, что этот аргумент не используется.

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

Контроль выполнения обратного вызова

развернуть все

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

Примечание

Рассмотрите эти состояния обратного вызова где:

  • Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.

  • Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.

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

Свойство Interruptible определяет, может ли другой обратный вызов прервать обратный вызов ButtonDownFcn объекта GeographicAxes. Свойство Interruptible имеет два значения:

  • 'on' — Прервать. Прерывание происходит на следующем этапе, где MATLAB обрабатывает очередь. Например, очереди обрабатываются командами, такими как drawnow, фигура, getframe, waitfor, делают паузу, и waitbar.

  • 'off' — Не прерывать. MATLAB завершает выполнение обратного вызова без каких-либо прерываний.

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

Рассмотрите эти состояния обратного вызова где:

  • Выполняемый обратный вызов — это актуальный на данный момент обратный вызов.

  • Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.

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

Если обратный вызов объекта GeographicAxes пытается прервать рабочий обратный вызов, который не может быть прерван, то свойство BusyAction определяет, отбрасывается ли это или вставило очередь. Задайте свойство BusyAction как одно из следующих значений:

  • 'queue' — поместите прерывающий обратный вызов в очередь вызовов, подлежащих обработке после завершения обратного вызова. (поведение по умолчанию)

  • cancel' — Отменить прерывание обратного вызова.

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

  • 'visible' — Захватите клики мыши только, когда видимый. Свойство Visible должно быть установлено в 'on'. Свойство HitTest определяет, отвечает ли объект GeographicAxes на нажатие кнопки или если предок делает.

  • все Захватите клики мыши независимо от видимости. Свойство Visible может быть установлено в 'on' или 'off'. Свойство HitTest определяет, отвечает ли объект GeographicAxes на нажатие кнопки или если предок делает.

  • 'none' — Невозможно захватить клики мыши. Нажатие на объект GeographicAxes передает нажатие кнопки объекту ниже его в текущем представлении окна фигуры, которое обычно является осями или фигурой. Свойство hittest не имеет никакого эффекта.

Если вы хотите объект быть активируемыми кликом мыши, когда это под другими объектами, что вы не хотите быть активируемыми кликом мыши, то установленный свойство PickableParts других объектов к 'none' так, чтобы нажатие кнопки прошло через них.

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

  • 'on' — Инициируйте обратный вызов ButtonDownFcn объекта GeographicAxes. Если вы определили свойство UIContextMenu, активируйте контекстное меню.

  • 'off' Инициируйте обратные вызовы для самого близкого предка объекта GeographicAxes, который имеет один из них:

    • Набор свойств HitTest к 'on'

    • Набор свойств PickableParts к значению, которое позволяет предку захватить клики мыши

Примечание

Свойство PickableParts определяет, может ли объект GeographicAxes захватить клики мыши. Если это невозможно, свойство HitTest никоим образом на это не влияет.

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

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

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

Родительский элемент/Дочерний элемент

развернуть все

Родительский элемент географических осей, заданных как объект Figure, объект Panel или объект Tab.

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

Вы не можете добавить или удалить дочерние элементы, использующие свойство Children. Чтобы добавить дочерний элемент к этому списку, установите свойство Parent дочернего графического объекта к объекту GeographicAxes.

Видимость указателя на объект в свойстве Children родителя, заданная как одно из следующих значений:

  • on' — указатель на объект всегда отображается.

  • off' — указатель на объект всегда невидим. Эта опция предназначена для предотвращения непреднамеренных изменений в пользовательском интерфейсе другой функцией. Установите значение 'off' в HandleVisibility, чтобы временно скрыть указатель в течение выполнения этой функции.

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

Если объект не указан в свойстве Children родителя, то функции, которые получают указатели на объекты путем поиска иерархии объектов или запросов свойств указателя, не могут вернуть его. Примеры таких функций включают получать, findobj, gca, gcf, gco, newplot, cla, clf, и близко функционирует.

Скрытые указатели на объекты все еще действительны. Установите значение корневого свойства ShowHiddenHandles на 'on', чтобы отобразить все указатели на объекты независимо от значения свойства HandleVisibility.

Идентификаторы

развернуть все

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

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

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

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

Используйте это свойство найти объекты Geographic Axes в иерархии. Например, можно использовать функцию findobj, чтобы найти объекты Geographic Axes, которые имеют определенное значение свойства Tag.

Пример: 'Данные в январе'

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

Чтобы связать несколько наборов данных или прикрепить имя поля к данным, используйте функции getappdata и setappdata.

Пример: 1:100

Представленный в R2018b

Была ли эта тема полезной?