---

15.3.3.7 图像属性 ¶

image 对象的属性（参见 image）：

类别： ¶

回调执行 | 创建/删除 | 显示 | 图像数据 | 鼠标交互 | 对象标识 | 父级/子级

回调执行 ¶

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

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

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

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

创建/删除 ¶

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

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

createfcn: 字符串 | 函数句柄，默认 [](0x0) ¶

在图像对象创建后立即执行的回调函数。该函数通过在根对象上设置默认属性来配置，例如 set (groot, "defaultimagecreatefcn", 'disp ("image created!")')。

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

deletefcn: 字符串 | 函数句柄，默认 [](0x0) ¶

在图像对象被删除之前立即执行的回调函数。

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

显示 ¶

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

如果 clipping 为 "on"，图像将在其父坐标轴限制内进行裁剪。

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

如果 visible 为 "off"，图像将不会在屏幕上渲染。

图像数据 ¶

alphadata: 标量 | 矩阵，默认 1 ¶

图像对象的透明度尚未实现。alphadata 未使用。

alphadatamapping: "direct" | {"none"} | "scaled" ¶

图像对象的透明度尚未实现。alphadatamapping 未使用。

cdata: 数组，默认 64×64 double ¶

图像对象的颜色数据。数据可以存储为二维矩阵，其中每个元素的值根据当前颜色图确定该像素的颜色；也可以存储为三维数组，其中第三维度包含每个像素独立的红色、蓝色和绿色分量。对于 RGB 数组，映射到最小和最大颜色值的取值取决于 "cdata" 的类。浮点值和逻辑值的取值范围为 0 到 1，而整数值的范围从该整数类型的 intmin 到 intmax。

cdatamapping: {"direct"} | "scaled" ¶

设置如何将 "cdata" 属性 中的数据映射到当前颜色图。"Direct" 映射将 "cdata" 值作为索引直接选择颜色图中的颜色。"Scaled" 映射将 "cdata" 值缩放到 "clim" 坐标轴属性 指定的范围内。

xdata: 向量，默认 [1, 64] ¶

两个元素的向量 [xfirst, xlast]，指定 cdata 第一列和最后一列的 x 坐标位置。

将 xdata 设置为空矩阵 ([]) 将恢复默认值 [1 columns(image)]。

ydata: 向量，默认 [1, 64] ¶

两个元素的向量 [yfirst, ylast]，指定 cdata 第一行和最后一行的 y 坐标位置。

将 ydata 设置为空矩阵 ([]) 将恢复默认值 [1 rows(image)]。

鼠标交互 ¶

buttondownfcn: 字符串 | 函数句柄，默认 [](0x0) ¶

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

contextmenu: 图形句柄，默认 [](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: 字符串，默认 "" ¶

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

type（只读）: 字符串 ¶

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

userdata: 任意 Octave 数据，默认 [](0x0) ¶

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

父级/子级 ¶

children（只读）: 图形句柄向量，默认 [](0x0) ¶

图像对象的子对象尚未实现。children 未使用。

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

如果 handlevisibility 为 "off"，图像的句柄在其父对象的 "children" 属性中不可见。

parent: 图形句柄 ¶

父级图形对象的句柄。