---

15.3.3.9 散点对象属性¶

scatter对象的属性（另请参阅散点）：

类别：¶

回调执行 | 颜色数据 | 坐标数据 | 创建/删除 | 显示 | 图例参数 | 符号外观 | 鼠标交互 | 对象标识 | 父级对象/子级对象

回调执行¶

busyaction: "cancel" | {"queue"} ¶

定义Octave在无法中断另一个对象正在执行的回调时如何处理此对象的回调属性执行。只有当当前执行的回调对象的interruptible属性设置为"off"时，这才相关。中断回调对象的busyaction属性指示中断回调是排队（"queue"，默认）还是被丢弃（"cancel"）。另请参阅回调部分。

interruptible: "off" | {"on"} ¶

指定此对象的回调函数是否可以被其他回调中断。默认情况下，interruptible为"on"，使用drawnow、figure、waitfor、getframe或pause函数的回调最终会被中断。另请参阅回调部分。

颜色数据¶

cdata: scalar | matrix, def. [0 0.4470 0.7410] ¶

定义散点对象颜色的数据。

如果cdata是当前颜色图或RGB三元组的标量索引，它定义所有散点符号的颜色。

如果cdata是索引的N×1向量或N×3（RGB）矩阵，它定义了N个散点符号中每一个的颜色。

cdatamode: {"auto"} | "manual" ¶

如果cdatamode是"auto"，cdata被设置为祖先轴的colororder中对应于seriesindex的颜色。

cdatasource: string, def. "" ¶

包含将用于"cdata"属性的数据的工作区变量的名称。数据使用refreshdata函数传输到"cdata"。

seriesindex: def. 1 ¶

同一轴上的每个散点对象都被分配了一个递增的整数。如果cdatamode设置为"auto"，这对应于祖先轴colororder中的索引。

坐标数据¶

latitudedata: def. [](0x0) ¶

散点对象的地理坐标散点绘图尚未实现。latitudedata未使用。

latitudedatasource: def. "" ¶

散点对象的地理坐标散点绘图尚未实现。latitudedatasource未使用。

longitudedata: def. [](0x0) ¶

散点对象的地理坐标散点绘图尚未实现。longitudedata未使用。

longitudedatasource: def. "" ¶

散点对象的地理坐标散点绘图尚未实现。longitudedatasource未使用。

rdata: def. [](0x0) ¶

散点对象的极坐标散点绘图尚未实现。rdata未使用。

rdatasource: def. "" ¶

散点对象的极坐标散点绘图尚未实现。rdatasource未使用。

thetadata: def. [](0x0) ¶

散点对象的极坐标散点绘图尚未实现。thetadata未使用。

thetadatasource: def. "" ¶

散点对象的极坐标散点绘图尚未实现。thetadatasource未使用。

xdata: vector, def. [](0x0) ¶

包含散点对象x坐标的向量。

xdatasource: string, def. "" ¶

包含将用于"xdata"属性的数据的工作区变量的名称。数据使用refreshdata函数传输到"xdata"。

ydata: vector, def. [](0x0) ¶

包含散点对象y坐标的向量。

ydatasource: string, def. "" ¶

包含将用于"ydata"属性的数据的工作区变量的名称。数据使用refreshdata函数传输到"ydata"。

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

对于3-D数据，包含散点对象z坐标的向量。

zdatasource: string, def. "" ¶

包含将用于"zdata"属性的数据的工作区变量的名称。数据使用refreshdata函数传输到"zdata"。

创建/删除¶

beingdeleted: {"off"} | "on" ¶

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

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

散点创建后立即执行的回调函数。函数通过使用根对象的默认属性来设置，例如set (groot, "defaultscattercreatefcn", 'disp ("scatter created!")')。

有关如何编写图形监听器函数的信息，另请参阅回调部分。

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

在删除散点之前立即执行的回调函数。

有关如何编写图形监听器函数的信息，另请参阅回调部分。

显示¶

clipping: "off" | {"on"} ¶

如果clipping是"on"，散点在其父轴限制中被剪裁。

visible: "off" | {"on"} ¶

如果visible是"off"，散点不在屏幕上渲染。

图例参数¶

annotation: def. [](0x0) ¶

从散点对象内切换图例外观尚未为散点对象实现。annotation未使用。

displayname: def. "" ¶

与此散点对象对应的图例条目的文本。

符号外观¶

linewidth: scalar, def. 0.5000 ¶

符号边缘的线宽。

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

另请参阅线条符号属性。

markeredgealpha: scalar, def. 1 ¶

符号边缘的透明度级别，其中值0表示完全透明，值1表示没有透明度的实体边缘。请注意，符号不是从后向前排序的，这可能会在渲染分层透明符号或与其他透明对象组合时导致意外结果。

markeredgecolor: {"none"} | {"flat"} | colorspec ¶

符号边缘的颜色。"none"意味着边缘是透明的，"flat"表示使用来自cdata的值。另请参阅线条符号边缘颜色属性。

markerfacealpha: scalar, def. 1 ¶

符号面的透明度级别，其中值0表示完全透明，值1表示没有透明度的实体面。请注意，符号不是从后向前排序的，这可能会在渲染分层透明符号或与其他透明对象组合时导致意外结果。

markerfacecolor: {"none"} | "flat" | "auto" | colorspec ¶

符号面的颜色。"none"意味着面是透明的，"flat"表示使用来自cdata的值，"auto"使用祖先轴的color属性。另请参阅线条符号表面颜色属性。

sizedata: [] | scalar | vector, def. [](0x0) ¶

符号区域的大小。标量值应用于所有符号。如果sizedata是N×1向量，它定义了N个散点符号中每一个的大小。

sizedatasource: def. "" ¶

散点对象的工作区变量数据源尚未实现。sizedatasource未使用。

鼠标交互¶

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

有关如何编写图形监听器函数的信息，另请参阅回调部分。

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

当前与此散点对象关联的uicontextmenu对象的图形句柄。

datatiptemplate: def. [](0x0) ¶

数据提示对象尚未为散点对象实现。datatiptemplate未使用。

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总是"scatter"。

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 ¶

父图形对象的句柄。