---

15.3.3.19 按钮工具属性¶

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

类别：¶

外观 | 回调执行 | 创建/删除 | 显示 | 鼠标交互 | 对象标识 | 父级/子级 | 按钮操作

外观¶

__named_icon__: string, def. "" ¶

用作按钮工具图像的捆绑图标文件的名称。

cdata: array, def. [](0x0) ¶

用于表示按钮工具对象的图像数据，存储为 M x N x 3 的 RGB 数组。

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

指示是否在当前按钮工具位置旁边绘制分隔线的状态。

回调执行¶

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

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

clickedcallback: string, def. [](0x0) ¶

一个由有效 Octave 表达式组成的字符串，当此控件对象被点击时将执行该表达式。

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

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

创建/删除¶

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

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

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

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

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

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

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

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

显示¶

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

如果 clipping 为 "on"，则 uipushtool 会被裁剪到其父坐标轴的范围内。

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

如果 visible 为 "off"，则 uipushtool 不会被渲染到屏幕上。

鼠标交互¶

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

当在 uipushtool 对象上按下鼠标按钮时执行的回调函数。

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

如果 selectionhighlight 为 "on"，则 uipushtool 的选择状态会在视觉上高亮显示。

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

指示此 uipushtool 是否被选中的属性。

tooltipstring: string, def. "" ¶

当鼠标指针悬停在按钮工具对象上时，在工具提示中显示的文本字符串。

对象标识¶

tag: string, def. "" ¶

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

type (read-only): string ¶

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

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

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

父级/子级¶

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

uipushtool 的子对象的图形句柄向量。

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

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

parent: graphics handle ¶

父图形对象的句柄。

按钮操作¶

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

设置此按钮工具对象是活动状态还是灰显状态。