Свойства GraphPlot

Внешний вид и поведение графика графика

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

G = graph([1 1 1 1 5 5 5 5],[2 3 4 5 6 7 8 9]);
h = plot(G);
c = h.EdgeColor;
h.EdgeColor = 'k';

Узлы

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

Цвет узла, заданный как одно из этих значений:

  • 'none' Узлы не чертятся.

  • 'flat' — Цвет каждого узла зависит от значения NodeCData.

  • Триплет RGB или название цвета — Все узлы используют заданный цвет.

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

    ОпцияОписаниеЭквивалентный триплет RGB
    'красный' или 'r'Красный[1 0 0]
    'green' или 'g'Зеленый[0 1 0]
    'blue' или 'b'Синий[0 0 1]
    'yellow' или 'y'Желтый[1 1 0]
    'пурпурный' или 'm'Пурпурный[1 0 1]
    'голубой' или 'c'Голубой[0 1 1]
    'white' или 'w'Белый[1 1 1]
    'black' или 'k'Черный[0 0 0]

  • матрица — Каждой строкой является триплет RGB, представляющий цвет одного узла. Размером матрицы является numnodes(G)-by-3.

Пример: график (G, 'NodeColor', 'k') создает график графика с узлами с неизвестным потоком.

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

ЗначениеОписание
OКруг
'+'Знак «плюс»
'*'Звездочка
'.'Точка
XКрест
square' или 's'Квадрат
'diamond' или 'd'Ромб
'^'Треугольник, направленный вверх
VНисходящий треугольник
'>'Треугольник, указывающий вправо
'<'Треугольник, указывающий влево
pentagram' или 'p'Пятиконечная звезда (пентаграмма)
'hexagram' or 'h'Шестиконечная звезда (гексаграмма)
'none'Никакие маркеры

Пример: '+'

Пример: 'ромб'

Размер маркера узла, заданный как положительное значение в модулях точки или как вектор таких значений. Задайте вектор, чтобы использовать различные размеры маркера для каждого узла в графике. Значение по умолчанию MarkerSize 4 для графиков с 100 или меньшим количеством узлов и 2 для графиков больше чем с 100 узлами.

Пример: 10

Цветные данные маркеров узла, заданных как вектор с длиной, равняются количеству узлов в графике. Значения в NodeCData отображаются линейно в цветах в текущей палитре, приводящей к различным цветам для каждого узла в построенной диаграмме.

Края

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

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

  • 'none' Края не чертятся.

  • 'flat' — Цвет каждого края зависит от значения EdgeCData.

  • Триплет RGB или название цвета — Все края используют заданный цвет.

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

    ОпцияОписаниеЭквивалентный триплет RGB
    'красный' или 'r'Красный[1 0 0]
    'green' или 'g'Зеленый[0 1 0]
    'blue' или 'b'Синий[0 0 1]
    'yellow' или 'y'Желтый[1 1 0]
    'пурпурный' или 'm'Пурпурный[1 0 1]
    'голубой' или 'c'Голубой[0 1 1]
    'white' или 'w'Белый[1 1 1]
    'black' или 'k'Черный[0 0 0]

  • матрица — Каждой строкой является триплет RGB, представляющий цвет одного края. Размером матрицы является numedges(G)-by-3.

Пример: график (G, 'EdgeColor', 'r') создает график графика с красными краями.

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

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

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

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

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

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

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

Пример: 0.75

Прозрачность краев графика, заданных как скалярное значение между 0 и 1 включительно. Значение 1 означает полностью непрозрачный, и 0 означает абсолютно прозрачная (невидимая операция).

Пример: 0.25

Цветные данные граничных строк, заданных как вектор с длиной, равняются количеству краев в графике. Значения в EdgeCData отображаются линейно в цветах в текущей палитре, приводящей к различным цветам для каждого края в построенной диаграмме.

Размер стрелки, заданный как положительное значение в модулях точки или как вектор таких значений. Как вектор, ArrowSize задает размер стрелки для каждого края в графике. Значением по умолчанию ArrowSize является 7 для графиков с 100 или меньшим количеством узлов и 4 для графиков больше чем с 100 узлами.

ArrowSize только влияет на ориентированных графов.

Пример: 15

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

ArrowPosition только влияет на ориентированных графов.

Переключите отображение стрелок на ориентированных ребрах, заданных как 'on' или 'off'. Для ориентированных графов значением по умолчанию является 'on' так, чтобы стрелки были отображены, но можно задать значение 'off', чтобы спрятать стрелки на ориентированных ребрах. Для неориентированных графов ShowArrows всегда является 'off'.

Положение

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

Примечание

XData и YData должны быть заданы вместе так, чтобы каждый узел имел допустимое (x, y) координата. Опционально, можно задать ZData для 3-D координат.

x-координата узлов, заданных как вектор с длиной, равняется количеству узлов в графике.

Примечание

XData и YData должны быть заданы вместе так, чтобы каждый узел имел допустимое (x, y) координата. Опционально, можно задать ZData для 3-D координат.

y-координата узлов, заданных как вектор с длиной, равняется количеству узлов в графике.

Примечание

XData и YData должны быть заданы вместе так, чтобы каждый узел имел допустимое (x, y) координата. Опционально, можно задать ZData для 3-D координат.

z-координата узлов, заданных как вектор с длиной, равняется количеству узлов в графике.

Узел и граничные метки

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

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

  • Для узлов без имен (то есть, G.Nodes не содержит переменную Name), метки узла являются значениями unique(G.Edges.EndNodes), содержавшийся в массиве ячеек.

  • Для именованных узлов метками узла является G.Nodes.Name' Имя.

Пример: A, B, C

Пример: [1 2 3]

Пример: график (G, 'NodeLabels', G.Nodes. Назовите), маркирует узлы их именами.

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

Режим выбора для меток узла, заданных как 'auto' (значение по умолчанию) или 'manual'. Задайте NodeLabelMode как 'auto', чтобы заполнить NodeLabel с идентификаторами узла для вершин графика (числовые индексы узла или имена узла). При определении NodeLabelMode, когда 'manual' не изменяет значения в NodeLabel.

Цвет метки узла, заданный как одно из этих значений:

  • Триплет RGB или название цвета — Все метки узла используют заданный цвет.

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

    ОпцияОписаниеЭквивалентный триплет RGB
    'красный' или 'r'Красный[1 0 0]
    'green' или 'g'Зеленый[0 1 0]
    'blue' или 'b'Синий[0 0 1]
    'yellow' или 'y'Желтый[1 1 0]
    'пурпурный' или 'm'Пурпурный[1 0 1]
    'голубой' или 'c'Голубой[0 1 1]
    'white' или 'w'Белый[1 1 1]
    'black' или 'k'Черный[0 0 0]

  • матрица — Каждой строкой является триплет RGB, представляющий цвет одной метки узла. Размером матрицы является numnodes(G)-by-3.

Пример: график (G, 'NodeLabel', C, 'NodeLabelColor', 'm') создает график графика с пурпурными метками узла.

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

Пример: A, B, C

Пример: [1 2 3]

Пример: график (G, 'EdgeLabels', G.Edges.Weight) маркирует края графика их весами.

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

Режим выбора для граничных меток, заданных как 'manual' (значение по умолчанию) или 'auto'. Задайте EdgeLabelMode как 'auto', чтобы заполнить EdgeLabel с весом ребра в G.Edges.Weight (при наличии) или граничные индексы G.Edges(k,:) (если никакие веса не доступны). При определении EdgeLabelMode, когда 'manual' не изменяет значения в EdgeLabel.

Граничный цвет метки, заданный как одно из этих значений:

  • Триплет RGB или название цвета — Все граничные метки используют заданный цвет.

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

    ОпцияОписаниеЭквивалентный триплет RGB
    'красный' или 'r'Красный[1 0 0]
    'green' или 'g'Зеленый[0 1 0]
    'blue' или 'b'Синий[0 0 1]
    'yellow' или 'y'Желтый[1 1 0]
    'пурпурный' или 'm'Пурпурный[1 0 1]
    'голубой' или 'c'Голубой[0 1 1]
    'white' или 'w'Белый[1 1 1]
    'black' или 'k'Черный[0 0 0]

  • матрица — Каждой строкой является триплет RGB, представляющий цвет одной граничной метки. Размером матрицы является numedges(G)-by-3.

Пример: график (G, 'EdgeLabel', C, 'EdgeLabelColor', 'm') создает график графика с пурпурными граничными метками.

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

  • 'tex' — Интерпретируйте символы с помощью подмножества разметки TeX.

  • 'latex' — Интерпретируйте символы, использующие разметку LATEX.

  • 'none' Отобразите буквенные символы.

TeX Markup

По умолчанию MATLAB® поддерживает подмножество разметки TeX. Используйте синтаксис TeX, чтобы добавить верхние индексы и индексы, изменить тип шрифта и окрасить и включать специальные символы в текст.

Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете свойство Interpreter на 'tex', поддерживаемые модификаторы следующие.

МодификаторОписаниеПример
^{ }Верхний индексtext^{superscript}
_{ }Индексtext_{subscript}
\bfBold font'\bf text'
\itКурсивный шрифт\it text
\slНаклонный шрифт (обычно то же самое как курсивный шрифт)\sl text
\rmОбычный шрифт\rm text
\fontname{specifier}Название шрифта — Замена specifier с именем семейства шрифтов. Можно использовать это в сочетании с другими модификаторами.\fontname{Courier} text
\fontsize{specifier}Размер шрифта — Замена specifier со значением числового скаляра в модулях точки.\fontsize{15} text
\color{specifier}Цвет шрифта — Замена specifier с одним из этих цветов: red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange или lightBlue.\color{magenta} text
\color[rgb]{specifier}Цвет пользовательского шрифта — Замена specifier с трехэлементным триплетом RGB.\color[rgb]{0,0.5,0.5} text

В этой таблице перечислены поддерживаемые специальные символы со свойством Interpreter, установленным на 'tex'.

Последовательность символовСимволПоследовательность символовСимволПоследовательность символовСимвол

\alpha

α

\Upsilon

υ

\sim

~

\angle

\phi

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\Gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\delta

Δ

\spadesuit

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\lambda

Λ

\leftarrow

\theta

θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\sigma

Σ

\Rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\psi

Ψ

\circ

º

\nu

ν

\omega

Ω

\pm

±

\Xi

ξ

\forall

\geq

\Pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

O

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

Разметка LaTeX

Чтобы использовать разметку LATEX, установите свойство Interpreter на 'latex'. Используйте долларовые символы вокруг текста, например, используйте '$\int_1^{20} x^2 dx$' для встроенного режима или '$$\int_1^{20} x^2 dx$$' для режима отображения.

Отображаемый текст использует стиль шрифта LATEX по умолчанию. FontName, FontWeight и свойства FontAngle не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LATEX.

Максимальный размер текста, который можно использовать с интерпретатором LATEX, является 1 200 символами.

Для получения дополнительной информации о системе LATEX, смотрите веб-сайт Проекта LATEX по https://www.latex-project.org/.

Шрифт

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

Название шрифта меток узла, заданных как поддерживаемое название шрифта или 'FixedWidth'. Для меток, чтобы отобразиться и распечатать правильно, необходимо выбрать шрифт, который поддерживает система. Шрифт по умолчанию зависит от конкретной операционной системы и локали. Например, Windows® и Linux®systems в английской локализации используют шрифт Helvetica по умолчанию.

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

Пример: 'Cambria'

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

Толщина текста в метках узла, заданных как 'normal', 'bold', или как вектор строки или массив ячеек из символьных векторов, задающий 'normal' или 'bold' для каждого узла.

  • 'bold' — более тонкие контуры символов, чем 'normal'

  • 'normal' — Нормальный вес, как задано конкретным шрифтом

Не все шрифты имеют полужирное начертание шрифта.

Типы данных: ячейка | char | строка

Символьный наклон текста в метках узла, заданных как 'normal', 'italic', или как вектор строки или массив ячеек из символьных векторов, задающий 'normal' или 'italic' для каждого узла.

  • 'italic'Наклонные символы

  • 'normal' — Никакой символьный наклон

Не все шрифты имеют оба стилей шрифтов.

Типы данных: ячейка | char | строка

Название шрифта граничных меток, заданных как поддерживаемое название шрифта или 'FixedWidth'. Для меток, чтобы отобразиться и распечатать правильно, необходимо выбрать шрифт, который поддерживает система. Шрифт по умолчанию зависит от конкретной операционной системы и локали. Например, Windows и Linuxsystems в английской локализации используют шрифт Helvetica по умолчанию.

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

Пример: 'Cambria'

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

Толщина текста в граничных метках, заданных как 'normal', 'bold', или как вектор строки или массив ячеек из символьных векторов, задающий 'normal' или 'bold' для каждого края.

  • 'bold' — более тонкие контуры символов, чем 'normal'

  • 'normal' — Нормальный вес, как задано конкретным шрифтом

Не все шрифты имеют полужирное начертание шрифта.

Типы данных: ячейка | char | строка

Символьный наклон текста в граничных метках, заданных как 'normal', 'italic', или как вектор строки или массив ячеек из символьных векторов, задающий 'normal' или 'italic' для каждого края.

  • 'italic'Наклонные символы

  • 'normal' — Никакой символьный наклон

Не все шрифты имеют оба стилей шрифтов.

Типы данных: ячейка | char | строка

Легенда

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

Текст используется легендой, заданной как вектор символа. Текст появляется рядом со значком GraphPlot.

Пример: 'Текстовое описание'

Для многострочного текста создайте вектор символа с помощью sprintf с символом новой строки \n.

Пример: sprintf ('строка one\nline два')

Также можно задать текст легенды с помощью функции legend.

  • Если вы задаете текст как входной параметр к функции legend, то легенда использует заданный текст и устанавливает свойство DisplayName на то же значение.

  • Если вы не задаете текст как входной параметр к функции legend, то легенда использует текст в свойстве DisplayName. Если свойство DisplayName не содержит текста, то легенда генерирует вектор символа. Вектор символа имеет форму 'dataN', где N является номером, присвоенным GraphPlot, основанному на объектах на его местоположении в списке записей легенды.

Если вы редактируете в интерактивном режиме вектор символа в существующей легенде, то MATLAB обновляет свойство DisplayName к отредактированному вектору символа.

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

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

  1. Запросите свойство Annotation получить объект Annotation.

  2. Запросите свойство LegendInformation объекта Annotation получить объект LegendEntry.

  3. Задайте свойство IconDisplayStyle объекта LegendEntry к одному из этих значений:

    • 'on' — Включайте объект GraphPlot в легенду как одна запись (значение по умолчанию).

    • 'off' Не включайте объект GraphPlot в легенду.

    • 'children' — Включайте только дочерние элементы объекта GraphPlot как отдельные записи в легенде.

Если легенда уже существует, и вы изменяете настройки IconDisplayStyle, то необходимо вызвать legend, чтобы обновить отображение.

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

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

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

  • 'on' — Отобразите GraphPlot.

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Объект GraphPlot — можно получить доступ к свойствам объекта GraphPlot из функции обратного вызова.

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

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

Примечание

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

Пример: @myCallback

Пример: {@myCallback, arg3}

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

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

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

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

Используйте это свойство выполнить код, когда вы создадите GraphPlot. Установка свойства CreateFcn на существующем GraphPlot не имеет никакого эффекта. Необходимо задать значение по умолчанию для этого свойства или задать это свойство с помощью пары Name,Value во время создания GraphPlot. MATLAB выполняет обратный вызов после создания GraphPlot и установки всех ее свойств.

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

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

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

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

Пример: @myCallback

Пример: {@myCallback, arg3}

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

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

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

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

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

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

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

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

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

Пример: @myCallback

Пример: {@myCallback, arg3}

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

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

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

Примечание

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

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

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

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

Если обратный вызов ButtonDownFcn GraphPlot является рабочим обратным вызовом, то свойство Interruptible определяет, может ли это другой обратный вызов прервать его:

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

  • 'off' Инициируйте обратные вызовы для самого близкого предка GraphPlot, который имеет набор свойств HitTest к 'on' и значению свойства PickableParts, которое позволяет предку захватить клики мыши.

Примечание

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

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

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

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

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

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

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

GraphPlot не имеет никаких дочерних элементов. Вы не можете задать это свойство.

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

  • 'on' — Указатель на объект GraphPlot всегда видим.

  • 'off' Указатель на объект GraphPlot невидим в любом случае. This option is useful for preventing unintended changes to the UI by another function. Set the HandleVisibility to 'off' to temporarily hide the handle during the execution of that function.

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

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

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

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

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

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

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

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

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

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

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

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

Пример: 1:100

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический | char | struct | таблица | ячейка

Введенный в R2015b

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