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 三元组,表示一个节点的颜色。矩阵的大小为
numnodes(G)
×3
。RGB 三元组、十六进制颜色代码或颜色名称 - 所有节点都使用指定的颜色。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 短名称 RGB 三元组 十六进制颜色代码 外观 "red"
"r"
[1 0 0]
"#FF0000"
"green"
"g"
[0 1 0]
"#00FF00"
"blue"
"b"
[0 0 1]
"#0000FF"
"cyan"
"c"
[0 1 1]
"#00FFFF"
"magenta"
"m"
[1 0 1]
"#FF00FF"
"yellow"
"y"
[1 1 0]
"#FFFF00"
"black"
"k"
[0 0 0]
"#000000"
"white"
"w"
[1 1 1]
"#FFFFFF"
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 调色板颜色 "gem"
- 浅色主题默认值在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。
"glow"
- 深色主题默认值您可以使用
orderedcolors
和rgb2hex
函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取"gem"
调色板的 RGB 三元组并将其转换为十六进制颜色代码。RGB = orderedcolors("gem"); H = rgb2hex(RGB);
在 R2023b 之前的版本中: 使用
RGB = get(groot,"FactoryAxesColorOrder")
获取 RGB 三元组。在 R2024a 之前的版本中: 使用
H = compose("#%02X%02X%02X",round(RGB*255))
获取十六进制颜色代码。
示例: plot(G,'NodeColor','k')
创建一个具有黑色节点的图论图。
控制如何设置 NodeColor
属性,指定为下列值之一:
'auto'
- MATLAB® 通过使用GraphPlot
对象的SeriesIndex
属性和坐标区的ColorOrder
属性来控制NodeColor
属性的值。'manual'
- 您可以手动控制NodeColor
属性的值,方法是直接设置对象的NodeColor
属性的值,或在调用绘图函数时在LineSpec
参量中包含颜色。
如果您手动更改 NodeColor
或 NodeCData
属性的值,MATLAB 会将 NodeColorMode
属性的值更改为 'manual'
。
边颜色,指定为下列值之一:
'none'
- 不绘制边。'flat'
- 每条边的颜色取决于EdgeCData
的值。矩阵 - 每行都是一个 RGB 三元组,表示一条边的颜色。矩阵的大小为
numedges(G)
×3
。RGB 三元组、十六进制颜色代码或颜色名称 - 所有边都使用指定的颜色。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 短名称 RGB 三元组 十六进制颜色代码 外观 "red"
"r"
[1 0 0]
"#FF0000"
"green"
"g"
[0 1 0]
"#00FF00"
"blue"
"b"
[0 0 1]
"#0000FF"
"cyan"
"c"
[0 1 1]
"#00FFFF"
"magenta"
"m"
[1 0 1]
"#FF00FF"
"yellow"
"y"
[1 1 0]
"#FFFF00"
"black"
"k"
[0 0 0]
"#000000"
"white"
"w"
[1 1 1]
"#FFFFFF"
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 调色板颜色 "gem"
- 浅色主题默认值在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。
"glow"
- 深色主题默认值您可以使用
orderedcolors
和rgb2hex
函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取"gem"
调色板的 RGB 三元组并将其转换为十六进制颜色代码。RGB = orderedcolors("gem"); H = rgb2hex(RGB);
在 R2023b 之前的版本中: 使用
RGB = get(groot,"FactoryAxesColorOrder")
获取 RGB 三元组。在 R2024a 之前的版本中: 使用
H = compose("#%02X%02X%02X",round(RGB*255))
获取十六进制颜色代码。
示例: plot(G,'EdgeColor','r')
创建一个具有红色边的图论图。
控制如何设置 EdgeColor
属性,指定为下列值之一:
'auto'
- MATLAB 通过使用GraphPlot
对象的SeriesIndex
属性和坐标区的ColorOrder
属性来控制EdgeColor
属性的值。'manual'
- 您可以手动控制EdgeColor
属性的值,方法是直接设置对象的EdgeColor
属性的值,或在调用绘图函数时在LineSpec
参量中包含颜色。
如果您手动更改 EdgeColor
或 EdgeCData
属性的值,MATLAB 会将 EdgeColorMode
属性的值更改为 'manual'
。
节点标记的颜色数据,指定为一个向量,其长度等于图中的节点数。NodeCData
中的值线性映射到当前颜色图中的颜色,使得绘制的图中的每个节点具有不同颜色。
边线条的颜色数据,指定为一个向量,其长度等于图中的边数。EdgeCData
中的值线性映射到当前颜色图中的颜色,导致绘制的图中的每条边具有不同颜色。
序列索引,指定为正整数或 "none"
。此属性可用于重新分配几个 GraphPlot
对象的节点或边颜色,使它们相互匹配。默认情况下,GraphPlot
对象的 SeriesIndex
属性是一个与其创建顺序对应的数字,从 1
开始。在您调用绘图函数时,MATLAB 使用该数字计算用于分配颜色的索引。索引引用存储在坐标区的 ColorOrder
属性中的数组的行。
SeriesIndex
值 "none"
对应于不参与索引方案的中性颜色。 (自 R2023b 起)
当您更改 GraphPlot
对象的 SeriesIndex
或在坐标区上更改 ColorOrder
属性时,MATLAB 会自动更新该对象的节点和边颜色。但是,要使更改生效,必须满足以下条件:
如果
NodeColorMode
为'auto'
,则SeriesIndex
影响节点的颜色。如果
EdgeColorMode
为'auto'
,则SeriesIndex
影响边的颜色。GraphPlot
对象的SeriesIndex
属性的值必须大于 0。Axes
对象的NextSeriesIndex
属性的值必须大于 0。
节点和边样式
节点标记符号,指定为下表中列出的值之一,或者指定为由此类值构成的元胞数组或字符串向量。默认为对图节点使用圆形标记。指定字符向量元胞数组或字符串向量,以便为每个节点使用不同标记。
标记 | 描述 | 生成的标记 |
---|---|---|
"o" | 圆圈 |
|
"+" | 加号 |
|
"*" | 星号 |
|
"." | 点 |
|
"x" | 叉号 |
|
"_" | 水平线条 |
|
"|" | 垂直线条 |
|
"square" | 方形 |
|
"diamond" | 菱形 |
|
"^" | 上三角 |
|
"v" | 下三角 |
|
">" | 右三角 |
|
"<" | 左三角 |
|
"pentagram" | 五角形 |
|
"hexagram" | 六角形 |
|
"none" | 无标记 | 不适用 |
示例: '+'
示例: 'diamond'
节点标记大小,指定为以磅为单位的正值或指定为由此类值组成的向量。指定一个向量以对图中的每个节点使用不同标记大小。对于具有 100 个或更少节点的图,MarkerSize
的默认值是 4,对于超过 100 个节点的图,默认值是 2
。
示例: 10
线型,指定为下表中列出的线型之一,或者指定为由此类值构成的元胞数组或字符串向量。指定字符向量元胞数组或字符串向量,以便为每条边使用不同线型。
字符 | 线型 | 表示的线条 |
---|---|---|
'-' | 实线 |
|
'--' | 虚线 |
|
':' | 点线 |
|
'-.' | 点划线 |
|
'none' | 无线条 | 无线条 |
边线宽,指定为以磅为单位的正值,或指定为由此类值组成的向量。指定一个向量以对图中的每条边使用不同线宽。
示例: 0.75
图边的透明度,指定为介于 0
和 1
(包含这两个边界值)之间的标量值。值 1
表示完全不透明,0
则表示完全透明(不可见)。
示例: 0.25
箭头大小,指定为以磅为单位的正值或指定为由此类值组成的向量。作为向量,ArrowSize
指定图中每条边的箭头的大小。对于具有 100 个或更少节点的图,ArrowSize
的默认值是 7
,对于超过 100 个节点的图,默认值是 4
。
ArrowSize
仅影响有向图。
示例: 15
箭头在边上的位置,指定为 [0 1]
范围内的值,或者指定为长度等于边数的此类值组成的向量。接近 0 的值表示箭头更靠近源节点,接近 1 的值表示箭头更靠近目标节点。默认值为 0.5
,表示箭头位于源节点和目标节点的中间。
ArrowPosition
仅影响有向图。
切换显示有向边上的箭头,指定为 'off'
或 'on'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
对于有向图,默认值为 'on'
,即显示箭头,但您可以指定值 'off'
,以隐藏有向边上的箭头。对于无向图,ShowArrows
始终为 'off'
。
位置
注意
XData
和 YData
必须同时指定,以使每个节点具有一个有效的 (x,y) 坐标。您还可以选择为三维坐标指定 ZData
。
节点的 x 坐标,指定为向量,其长度等于图中的节点数。
注意
XData
和 YData
必须同时指定,以使每个节点具有一个有效的 (x,y) 坐标。您还可以选择为三维坐标指定 ZData
。
节点的 y 坐标,指定为向量,其长度等于图中的节点数。
注意
XData
和 YData
必须同时指定,以使每个节点具有一个有效的 (x,y) 坐标。您还可以选择为三维坐标指定 ZData
。
节点的 z 坐标,指定为向量,其长度等于图形中的节点数。
节点和边标签
节点标签,指定为数值向量或字符向量元胞数组。NodeLabel
的长度必须等于图中的节点数。默认情况下,NodeLabel
是包含图节点的节点 ID 的元胞数组:
对于不带名称的节点(即
G.Nodes
不包含Name
变量),节点标签是元胞数组中包含的值unique(G.Edges.EndNodes)
。对于具有名称的节点,节点标签是
G.Nodes.Name'
。
示例: {'A', 'B', 'C'}
示例: [1 2 3]
示例: plot(G,'NodeLabel',G.Nodes.Name)
将节点名称作为其标签。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| cell
节点标签的选择模式,指定为 'auto'
(默认值)或 'manual'
。将 NodeLabelMode
指定为 'auto'
,以使用图节点的节点 ID(数值节点索引或节点名称)填充 NodeLabel
。将 NodeLabelMode
指定为 'manual'
不会更改 NodeLabel
中的值。
节点标签颜色,指定为下列值之一:
矩阵 - 每行是一个 RGB 三元组,表示一个节点标签的颜色。矩阵的大小为
numnodes(G)
×3
。RGB 三元组、十六进制颜色代码或颜色名称 - 所有节点标签都使用指定的颜色。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 短名称 RGB 三元组 十六进制颜色代码 外观 "red"
"r"
[1 0 0]
"#FF0000"
"green"
"g"
[0 1 0]
"#00FF00"
"blue"
"b"
[0 0 1]
"#0000FF"
"cyan"
"c"
[0 1 1]
"#00FFFF"
"magenta"
"m"
[1 0 1]
"#FF00FF"
"yellow"
"y"
[1 1 0]
"#FFFF00"
"black"
"k"
[0 0 0]
"#000000"
"white"
"w"
[1 1 1]
"#FFFFFF"
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 调色板颜色 "gem"
- 浅色主题默认值在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。
"glow"
- 深色主题默认值您可以使用
orderedcolors
和rgb2hex
函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取"gem"
调色板的 RGB 三元组并将其转换为十六进制颜色代码。RGB = orderedcolors("gem"); H = rgb2hex(RGB);
在 R2023b 之前的版本中: 使用
RGB = get(groot,"FactoryAxesColorOrder")
获取 RGB 三元组。在 R2024a 之前的版本中: 使用
H = compose("#%02X%02X%02X",round(RGB*255))
获取十六进制颜色代码。
示例: plot(G,'NodeLabel',C,'NodeLabelColor','m')
创建一个具有品红色节点标签的图论图。
边标签,指定为数值向量或字符向量元胞数组。EdgeLabel
的长度必须等于图中的边数。默认情况下,EdgeLabel
是空元胞数组(不显示边标签)。
示例: {'A', 'B', 'C'}
示例: [1 2 3]
示例: plot(G,'EdgeLabels',G.Edges.Weight)
使用图边的权重作为其标签。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| cell
边标签的选择模式,指定为 'manual'
(默认值)或 'auto'
。将 EdgeLabelMode
指定为 'auto'
会使用 G.Edges.Weight
中的边权重(如果有)或边索引 G.Edges(k,:)
(如果权重不可用)填充 EdgeLabel
。将 EdgeLabelMode
指定为 'manual'
不会更改 EdgeLabel
中的值。
边标签颜色,指定为下列值之一:
矩阵 - 每行是一个 RGB 三元组,表示一个边标签的颜色。矩阵的大小为
numedges(G)
×3
。RGB 三元组、十六进制颜色代码或颜色名称 - 所有边标签都使用指定的颜色。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 短名称 RGB 三元组 十六进制颜色代码 外观 "red"
"r"
[1 0 0]
"#FF0000"
"green"
"g"
[0 1 0]
"#00FF00"
"blue"
"b"
[0 0 1]
"#0000FF"
"cyan"
"c"
[0 1 1]
"#00FFFF"
"magenta"
"m"
[1 0 1]
"#FF00FF"
"yellow"
"y"
[1 1 0]
"#FFFF00"
"black"
"k"
[0 0 0]
"#000000"
"white"
"w"
[1 1 1]
"#FFFFFF"
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 调色板颜色 "gem"
- 浅色主题默认值在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。
"glow"
- 深色主题默认值您可以使用
orderedcolors
和rgb2hex
函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取"gem"
调色板的 RGB 三元组并将其转换为十六进制颜色代码。RGB = orderedcolors("gem"); H = rgb2hex(RGB);
在 R2023b 之前的版本中: 使用
RGB = get(groot,"FactoryAxesColorOrder")
获取 RGB 三元组。在 R2024a 之前的版本中: 使用
H = compose("#%02X%02X%02X",round(RGB*255))
获取十六进制颜色代码。
示例: plot(G,'EdgeLabel',C,'EdgeLabelColor','m')
创建一个具有品红色边标签的图论图。
文本字符的解释,指定为下列值之一:
'tex'
- 使用 TeX 标记子集解释字符。'latex'
- 使用 LaTeX 标记解释字符。'none'
- 显示字面字符。
TeX 标记
默认情况下,MATLAB 支持一部分 TeX 标记。使用 TeX 标记可添加下标和上标,修改字体类型和颜色,并在文本中包括特殊字符。
修饰符会一直作用到文本结尾,但上标和下标除外,因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex"
时,支持的修饰符如下所示。
修饰符 | 描述 | 示例 |
---|---|---|
^{ } | 上标 | "text^{superscript}" |
_{ } | 下标 | "text_{subscript}" |
\bf | 粗体 | "\bf text" |
\it | 斜体 | "\it text" |
\sl | 伪斜体(通常与斜体相同) | "\sl text" |
\rm | 常规字体 | "\rm text" |
\fontname{ | 字体名称 - 将 替换为字体系列的名称。您可以将此说明符与其他修饰符结合使用。 | "\fontname{Courier} text" |
\fontsize{ | 字体大小 - 将 替换为以磅为单位的数值标量值。 | "\fontsize{15} text" |
\color{ | 字体颜色 - 将 替换为以下颜色之一:red 、green 、yellow 、magenta 、blue 、black 、white 、gray 、darkGreen 、orange 或 lightBlue 。 | "\color{magenta} text" |
\color[rgb]{specifier} | 自定义字体颜色 - 将 替换为三元素 RGB 三元组。 | "\color[rgb]{0,0.5,0.5} text" |
下表列出了 "tex"
解释器所支持的特殊字符。
字符序列 | 符号 | 字符序列 | 符号 | 字符序列 | 符号 |
---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
| ϕ |
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
LaTeX 标记
要使用 LaTeX 标记,请将 Interpreter
属性设置为 'latex'
。使用美元符号将文本括起来,例如,对于内联模式,使用 '$\int_1^{20} x^2 dx$'
;对于显示模式,使用 '$$\int_1^{20} x^2 dx$$'
。
显示的文本将使用默认的 LaTeX 字体样式。FontName
、FontWeight
和 FontAngle
属性不起任何作用。要更改字体样式,请使用 LaTeX 标记。
用于 LaTeX 解释器的文本最多可以包含 1200 个字符。
有关 LaTeX 系统的详细信息,请访问 LaTeX Project 网站:https://www.latex-project.org/。
字体
节点标签的字体名称,指定为支持的字体名称或 'FixedWidth'
。要正确显示和打印标签,您必须选择系统支持的字体。默认字体取决于具体操作系统和区域设置。例如,Windows® 和 Linux® 英文系统默认使用 Helvetica 字体。
要使用在任何区域设置中都有较好显示效果的等宽字体,请指定 'FixedWidth'
。
示例: 'Cambria'
节点标签的字体大小,指定为正数或正数向量。如果 NodeFontSize
是向量,则每个元素指定一个节点标签的字体大小。默认字体大小取决于具体操作系统和区域设置。
节点标签中文本的粗细,指定为 'normal'
、'bold'
,或指定为字符串向量或字符向量元胞数组(用于为每个节点指定 'normal'
或 'bold'
)。
'bold'
- 字符轮廓比普通字符粗'normal'
- 由特定字体定义的普通粗细
并非所有字体都有加粗字体。
数据类型: cell
| char
| string
节点标签中文本的字符倾斜,指定为 'normal'
、'italic'
,或指定为字符串向量或字符向量元胞数组(用于为每个节点指定 'normal'
或 'italic'
)。
'italic'
- 字符倾斜'normal'
- 字符不倾斜
并非所有字体都有两种字体样式。
数据类型: cell
| char
| string
边标签的字体名称,指定为支持的字体名称或 'FixedWidth'
。要正确显示和打印标签,您必须选择系统支持的字体。默认字体取决于具体操作系统和区域设置。例如,Windows 和 Linux 英文系统默认使用 Helvetica 字体。
要使用在任何区域设置中都有较好显示效果的等宽字体,请指定 'FixedWidth'
。
示例: 'Cambria'
边标签的字体大小,指定为正数或正数向量。如果 EdgeFontSize
是向量,则每个元素指定一个边标签的字体大小。默认字体大小取决于具体操作系统和区域设置。
边标签中文本的粗细,指定为 'normal'
、'bold'
,或指定为字符串向量或字符向量元胞数组(用于为每条边指定 'normal'
或 'bold'
)。
'bold'
- 字符轮廓比普通字符粗'normal'
- 由特定字体定义的普通粗细
并非所有字体都有加粗字体。
数据类型: cell
| char
| string
边标签中文本的字符倾斜,指定为 'normal'
、'italic'
,或指定为字符串向量或字符向量元胞数组(用于为每条边指定 'normal'
或 'italic'
)。
'italic'
- 字符倾斜'normal'
- 字符不倾斜
并非所有字体都有两种字体样式。
数据类型: cell
| char
| string
图例
图例使用的文本,指定为字符向量。文本显示在 GraphPlot 的图标旁边。
示例: 'Text Description'
对于多行文本,请使用 sprintf
和换行符 \n
创建字符向量。
示例: sprintf('line one\nline two')
您也可以使用 legend
函数指定图例文本。
如果您以交互方式编辑现有图例中的字符向量,则 MATLAB 会将 DisplayName
属性更新为编辑的字符向量。
此 属性 为只读。
图例图标显示样式,以 Annotation
对象的形式返回。使用该对象包括或排除图例中的 GraphPlot。
查询
Annotation
属性以获取Annotation
对象。查询
Annotation
对象的LegendInformation
属性以获取LegendEntry
对象。将
LegendEntry
对象的IconDisplayStyle
属性指定为下列值之一:'on'
- 将 GraphPlot 对象作为一个条目(默认)包括在图例中。'off'
- 不在图例中包含 GraphPlot 对象。'children'
- 仅将 GraphPlot 对象的子级作为独立项包含在图例中。
如果图例已存在,并且您更改了 IconDisplayStyle
设置,则必须调用 legend
更新显示内容。
交互性
数据提示内容,指定为 DataTipTemplate
对象。您可以通过修改底层 DataTipTemplate
对象的属性来控制数据提示中显示的内容。有关属性列表,请参阅 DataTipTemplate 属性。
有关修改数据提示的示例,请参阅创建自定义数据提示。
注意
findobj
或 findall
不返回 DataTipTemplate
对象,copyobj
也不复制该对象。
可见性状态,指定为 "on"
或 "off"
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 "on"
等效于 true
,"off"
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
"on"
- 显示对象。"off"
- 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。
上下文菜单,指定为 ContextMenu
对象。使用此属性在您右键点击对象时显示上下文菜单。使用 uicontextmenu
函数创建上下文菜单。
注意
如果 PickableParts
属性设置为 'none'
或者 HitTest
属性设置为 'off'
,该上下文菜单将不显示。
选择状态,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
'on'
- 已选择。如果您在绘图编辑模式下点击对象,则 MATLAB 会将其Selected
属性设置为'on'
。如果SelectionHighlight
属性也设置为'on'
,则 MATLAB 将在对象周围显示选择句柄。'off'
- 未选择。
选择时显示选择句柄,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
'on'
- 在Selected
属性设置为'on'
时显示选择句柄。'off'
- 永远不显示选择句柄,即使Selected
属性设置为'on'
也是如此。
回调
鼠标点击回调,指定为下列值之一:
函数句柄
元胞数组,包含一个函数句柄和其他参量
作为有效 MATLAB 命令或函数(在基础工作区中计算)的字符向量(不推荐)
使用该属性以在您点击 GraphPlot 时执行代码。如果使用函数句柄指定此属性,则 MATLAB 在执行回调时将向回调函数传递两个参量:
GraphPlot 对象 - 您可以从回调函数中访问 GraphPlot 对象的属性。
事件数据 - 此参量对于此属性为空。在函数定义中将其替换为波浪号字符 (
~
) 以指示不使用此参量。
有关如何使用函数句柄定义回调函数的详细信息,请参阅Create Callbacks for Graphics Objects。
注意
如果 PickableParts
属性设置为 'none'
或者 HitTest
属性设置为 'off'
,则不执行此回调。
示例: @myCallback
示例: {@myCallback,arg3}
创建回调,指定为下列值之一:
函数句柄
元胞数组,包含一个函数句柄和其他参量
作为有效 MATLAB 命令或函数(在基础工作区中计算)的字符向量(不推荐)
使用该属性以在您创建 GraphPlot 时执行代码。对现有 GraphPlot 设置 CreateFcn
属性没有任何作用。必须为该属性定义默认值,或使用 Name,Value
对组在 GraphPlot 创建期间定义该属性。MATLAB 会在创建 GraphPlot 并设置它的所有属性之后执行回调。
如果使用函数句柄指定此回调,则 MATLAB 在执行回调时将向回调函数传递两个参量:
GraphPlot 对象 - 您可以从回调函数中访问 GraphPlot 对象的属性。您还可以通过根的
CallbackObject
属性访问 GraphPlot 对象,该属性可以通过gcbo
函数进行查询。事件数据 - 此参量对于此属性为空。在函数定义中将其替换为波浪号字符 (
~
) 以指示不使用此参量。
有关如何使用函数句柄定义回调函数的详细信息,请参阅Create Callbacks for Graphics Objects。
示例: @myCallback
示例: {@myCallback,arg3}
删除回调,指定为下列值之一:
函数句柄
元胞数组,包含一个函数句柄和其他参量
作为有效 MATLAB 命令或函数(在基础工作区中计算)的字符向量(不推荐)
使用此属性在删除 GraphPlot 时执行代码。MATLAB 在销毁 GraphPlot 之前执行回调以便回调可以访问其属性值。
如果使用函数句柄指定此回调,则 MATLAB 在执行回调时将向回调函数传递两个参量:
GraphPlot 对象 - 您可以从回调函数中访问 GraphPlot 对象的属性。您还可以通过根的
CallbackObject
属性访问 GraphPlot 对象,该属性可以通过gcbo
函数进行查询。事件数据 - 此参量对于此属性为空。在函数定义中将其替换为波浪号字符 (
~
) 以指示不使用此参量。
有关如何使用函数句柄定义回调函数的详细信息,请参阅Create Callbacks for Graphics Objects。
示例: @myCallback
示例: {@myCallback,arg3}
回调执行控件
回调中断,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
此属性确定是否可以中断运行中回调。有以下两种回调状态要考虑:
运行中回调是当前正在执行的回调。
中断回调是试图中断运行中回调的回调。
每次执行处理回调队列的命令时,MATLAB 都会确定回调中断行为。这些命令包括 drawnow
、figure
、uifigure
、getframe
、waitfor
和 pause
。
如果运行中回调不包含上述命令之一,则不会发生中断。MATLAB 首先完成执行运行中回调,然后执行中断回调。
如果运行中回调确实包含上述命令之一,则由运行中回调所属对象的 Interruptible
属性来确定是否发生中断:
如果
Interruptible
的值为'off'
,则不会发生中断。此时,由中断回调所属对象的BusyAction
属性确定中断回调是被丢弃还是添加到回调队列中。如果
Interruptible
的值为'on'
,则发生中断。下次 MATLAB 处理回调队列时,它会停止运行中回调的执行,并执行中断回调。在中断回调完成后,MATLAB 将继续执行运行中回调。
注意
回调的中断和执行在以下情况下会有不同的表现:
如果中断回调是
DeleteFcn
、CloseRequestFcn
或SizeChangedFcn
回调,则无论是否存在Interruptible
属性值都会发生中断。如果运行中回调当前正在执行
waitfor
函数,则无论是否存在Interruptible
属性值都会发生中断。如果中断回调由
Timer
对象所有,则回调将根据调度执行,而不考虑Interruptible
属性值。
回调排队,指定为 'queue'
或 'cancel'
。BusyAction
属性决定 MATLAB 如何处理中断回调的执行。
注意
有以下两种回调状态要考虑:
运行中回调是当前正在执行的回调。
中断回调是试图中断运行中回调的回调。
无论何时 MATLAB 调用回调,该回调都会试图中断运行中回调。运行中回调所属对象的 Interruptible
属性决定着是否允许中断。如果不允许中断,则中断回调所属对象的属性 BusyAction
将决定是放弃该回调还是将回调放入队列中。
如果 GraphPlot 的 ButtonDownFcn
回调尝试中断一个无法中断的运行中回调,则 BusyAction
属性将决定是放弃该回调还是将该回调放入队列中。将 BusyAction
属性指定为下列值之一:
'queue'
- 将中断回调放入队列中,以便在运行中回调执行完毕后进行处理。这是默认行为。'cancel'
- 放弃中断回调。
捕获鼠标点击的能力,指定为以下值之一:
'visible'
- 仅当可见时才可以捕获鼠标点击。Visible
属性必须设置为'on'
。HitTest
属性确定 GraphPlot 是否响应点击或者前代是否响应点击。'none'
- 无法捕获鼠标点击。点击 GraphPlot 会将点击操作传递到图窗窗口的当前视图中其下方的对象。GraphPlot 的HitTest
属性没有任何作用。
对捕获的鼠标点击的响应,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
'on'
- 触发GraphPlot
对象的ButtonDownFcn
回调。如果您已定义ContextMenu
属性,则调用上下文菜单。'off'
- 触发满足以下条件之一的GraphPlot
对象的最近前代的回调:HitTest
属性设置为'on'
。PickableParts
属性设置为允许前代捕获鼠标点击的值。
注意
PickableParts
属性决定 GraphPlot
对象是否可以捕获鼠标点击。如果无法捕获,则 HitTest
属性没有任何作用。
此 属性 为只读。
删除状态,以 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值形式返回。
当 DeleteFcn
回调开始执行时,MATLAB 会将 BeingDeleted
属性设置为 'on'
。BeingDeleted
属性将一直保持 'on'
设置状态,直到组件对象不再存在为止。
在查询或修改对象之前,请先检查其 BeingDeleted
属性的值,以确认它不是待删除项。
父级/子级
GraphPlot 的父级,指定为坐标区、组或变换对象。
子级,以空的 GraphicsPlaceholder
数组或 DataTip
对象数组形式返回。使用此属性来查看在图上绘制的数据提示的列表。
不能使用 Children
属性添加或删除子级。要向此列表中添加子级,请将 DataTip
对象的 Parent
属性设置为图对象。
GraphPlot 对象句柄在父级的 Children
属性中的可见性,指定为下列值之一:
'on'
- GraphPlot 对象句柄始终可见。'off'
- GraphPlot 对象句柄始终不可见。该选项用于防止另一函数无意中对 UI 进行更改。将HandleVisibility
设置为'off'
可在执行该函数时暂时隐藏句柄。'callback'
- GraphPlot 对象句柄对于回调或回调所调用的函数可见,但对于命令行调用的函数不可见。该选项阻止通过命令行访问 GraphPlot,但允许回调函数访问它。
如果父级的 Children
属性中未列出 GraphPlot 对象,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回该对象。这包括 get
、findobj
、gca
、gcf
、gco
、newplot
、cla
、clf
和 close
。
隐藏的对象句柄仍有效。将根 ShowHiddenHandles
属性设置为 'on'
以列出所有对象句柄,而不管其 HandleVisibility
属性设置如何。
标识符
此 属性 为只读。
图形对象的类型,以 'graphplot'
形式返回。使用该属性在绘制层次结构中查找指定类型的所有对象,例如,使用 findobj
搜索该类型。
要与 GraphPlot 关联的标记,指定为字符向量。标记提供了一种标识图形对象的方式。使用该属性在绘制层次结构中查找带特定标记的所有对象,例如,使用 findobj
搜索该标记。
示例: 'January Data'
数据类型: char
要与 GraphPlot 对象关联的数据,指定为标量、向量、矩阵、元胞数组、字符数组、表或结构体。MATLAB 不使用这些数据。
要关联多组数据或将字段名称附加到这些数据,请使用 getappdata
和 setappdata
函数。
示例: 1:100
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| char
| struct
| table
| cell
版本历史记录
在 R2015b 中推出通过将 SeriesIndex
属性设置为 "none"
退出 GraphPlot
对象的自动颜色选择。当您指定 "none"
时,GraphPlot
对象具有中性颜色。
要再次启用自动颜色选择,请将 SeriesIndex
属性设置为一个正整数。
通过设置 SeriesIndex
属性来控制 GraphPlot
对象的颜色变化。当您要匹配坐标区中不同对象的颜色时,此属性很有用。
从 R2020a 开始,不推荐使用 UIContextMenu
属性将上下文菜单分配给图形对象或 UI 组件。请改用 ContextMenu
属性。属性值是相同的。
目前没有停止支持 UIContextMenu
属性的计划。但是,UIContextMenu
属性将不再出现在对图形对象或 UI 组件调用 get
函数时所返回的列表中。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)