15.3.3.5 线条属性

line 对象的属性(参见 line):

类别:

回调执行 | 坐标数据 | 创建/删除 | 显示 | 图例选项 | 线条外观 | 标记外观 | 鼠标交互 | 对象标识 | 父/子对象

回调执行

busyaction: "cancel" | {"queue"}

定义 Octave 在无法中断另一个对象正在执行的回调时,如何处理此对象回调属性的执行。这仅在当前正在执行回调的对象的 interruptible 属性设置为 "off" 时相关。中断回调对象的 busyaction 属性指示中断回调是排队("queue"(默认))还是丢弃("cancel")。参见 回调章节

interruptible: "off" | {"on"}

指定此对象的回调函数是否可以被其他回调中断。默认情况下,interruptible"on",使用 drawnowfigurewaitforgetframepause 函数的回调最终会被中断。参见 回调章节

坐标数据

xdata: vector, def. [0 1]

要绘制的 x 数据向量。

xdatasource: string, def. ""

当前基本工作空间中要用作 x 数据的向量名称。

ydata: vector, def. [0 1]

要绘制的 y 数据向量。

ydatasource: string, def. ""

当前基本工作空间中要用作 y 数据的向量名称。

zdata: vector, def. [](0x0)

要绘制的 z 数据向量。

zdatasource: string, def. ""

当前基本工作空间中要用作 z 数据的向量名称。

创建/删除

beingdeleted: {"off"} | "on"

指示某个函数已启动删除对象的属性。beingdeleted 设置为 true,直到对象不再存在。

createfcn: string | function handle, def. [](0x0)

在线条创建后立即执行的回调函数。通过使用根对象的默认属性来设置,例如 set (groot, "defaultlinecreatefcn", 'disp ("line created!")')

有关如何编写图形监听器函数的信息,参见 回调章节

deletefcn: string | function handle, def. [](0x0)

在线条删除之前立即执行的回调函数。

有关如何编写图形监听器函数的信息,参见 回调章节

显示

clipping: "off" | {"on"}

如果 clipping"on",则线条在其父坐标轴范围内被裁剪。

visible: "off" | {"on"}

如果 visible"off",则线条不会在屏幕上渲染。

图例选项

displayname: string | cell array of strings, def. ""

与此线条对应的图例条目的文本。

线条外观

color: colorspec, def. [0 0 0]

线条对象的颜色。参见 颜色规格

linejoin: "chamfer" | "miter" | {"round"}

控制线段连接处的形状。此属性当前仅影响打印输出。

linestyle: {"-"} | "--" | "-." | ":" | "none"

参见 线条样式

linewidth: scalar, def. 0.5000

线条对象的宽度,以点为单位。

标记外观

marker: "*" | "+" | "." | "<" | ">" | "^" | "_" | "d" | "diamond" | "h" | "hexagram" | {"none"} | "o" | "p" | "pentagram" | "s" | "square" | "v" | "x" | "|"

每个数据点的标记形状。参见 标记样式

markeredgecolor: {"auto"} | "none"

标记边缘的颜色。当设置为 "auto" 时,标记边缘与线条颜色相同。如果设置为 "none",则不显示标记边缘。此属性也可以设置为任意颜色。参见 颜色规格

markerfacecolor: "auto" | {"none"}

标记表面的颜色。当设置为 "auto" 时,标记表面与线条颜色相同。如果设置为 "none",则不显示标记表面。此属性也可以设置为任意颜色。参见 颜色规格

markersize: scalar, def. 6

标记的大小,以点为单位。

鼠标交互

buttondownfcn: string | function handle, def. [](0x0)

有关如何编写图形监听器函数的信息,参见 回调章节

contextmenu: graphics handle, def. [](0x0)

当前与此线条对象关联的 uicontextmenu 对象的图形句柄。

hittest: "off" | {"on"}

指定线条是处理鼠标事件还是将其传递给对象的祖先。启用后,对象可以通过评估 "buttondownfcn"、显示 uicontextmenu 并最终成为根对象的 "currentobject" 来响应鼠标单击。此属性仅在对象可以接受鼠标单击时相关,而鼠标单击的接受由 "pickableparts" 属性决定。参见 pickableparts 属性

pickableparts: "all" | "none" | {"visible"}

指定线条是否接受鼠标单击。默认情况下,pickableparts"visible",只有线条的可见部分或其子对象可以对鼠标单击做出反应。当 pickableparts"all" 时,可见和不可见部分(或子对象)都可能对鼠标单击做出反应。当 pickableparts"none" 时,对象上的鼠标单击被忽略并传递给该对象下方的任何对象。当对象配置为接受鼠标单击时,"hittest" 属性将决定如何处理它们。参见 hittest 属性

selected: {"off"} | "on"

属性指示此线条是否被选中。

selectionhighlight: "off" | {"on"}

如果 selectionhighlight"on",则线条的选中状态会在视觉上高亮显示。

对象标识

tag: string, def. ""

用于标记图形对象的用户定义字符串。

type (read-only): string

图形对象的类名。type 始终为 "line"

userdata: Any Octave data, def. [](0x0)

要与图形对象关联的用户定义数据。

父/子对象

children (read-only): vector of graphics handles, def. [](0x0)

线条对象的子对象尚未实现。children 未使用。

handlevisibility: "callback" | "off" | {"on"}

如果 handlevisibility"off",则线条的句柄在其父对象的 "children" 属性中不可见。

parent: graphics handle

父级图形对象的句柄。