---

15.3.3.20 拨动开关工具属性 ¶

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

类别： ¶

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

外观 ¶

__named_icon__：字符串，默认值 "" ¶

用作拨动开关工具对象图像的捆绑图标文件名。

cdata：数组，默认值 [](0x0) ¶

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

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

设置后在拨动开关工具左侧绘制一条垂直线。

回调执行 ¶

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

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

clickedcallback：字符串，默认值 [](0x0) ¶

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

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

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

offcallback：字符串，默认值 [](0x0) ¶

一个由有效 Octave 表达式组成的字符串，当此控件对象被切换为关闭状态时将执行该表达式。

oncallback：字符串，默认值 [](0x0) ¶

一个由有效 Octave 表达式组成的字符串，当此控件对象被切换为打开状态时将执行该表达式。

创建/删除 ¶

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

指示某个函数已启动删除该对象的属性。在对象不再存在之前，beingdeleted 一直为 "on"。

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

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

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

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

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

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

显示 ¶

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

如果 clipping 为 "on"，则对象渲染会被裁剪到坐标轴的边界框内。

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

如果 visible 为 "off"，则在屏幕上渲染图形时该对象不可见，但仍然存在，并且其属性仍可查询和修改。

鼠标交互 ¶

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

buttondownfcn 未使用。

contextmenu：图形句柄，默认值 [](0x0) ¶

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

hittest："off" | {"on"} ¶

指定 uitoggletool 是处理鼠标事件还是将事件传递给对象的祖先。启用时，对象可以通过执行 "buttondownfcn"、显示 uicontextmenu 以及最终成为根对象的 "currentobject" 来响应鼠标点击。此属性仅在对象可以接受鼠标点击时相关，这由 "pickableparts" 属性决定。参见 pickableparts 属性。

pickableparts："all" | "none" | {"visible"} ¶

指定 uitoggletool 是否接受鼠标点击。默认情况下，pickableparts 为 "visible"，只有 uitoggletool 或其子对象的可见部分可以响应鼠标点击。当 pickableparts 为 "all" 时，可见和不可见部分（或子对象）都可能响应鼠标点击。当 pickableparts 为 "none" 时，对象上的鼠标点击被忽略，并传递到其下方的任何对象。当对象配置为接受鼠标点击时，"hittest" 属性将决定如何处理它们。参见 hittest 属性。

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

属性指示此 uitoggletool 是否被选中。

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

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

tooltipstring：字符串，默认值 "" ¶

当鼠标指针悬停在拨动开关工具对象上时，出现在工具提示中的文本字符串。

对象标识 ¶

tag：字符串，默认值 "" ¶

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

type（只读）：字符串 ¶

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

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

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

父级/子级 ¶

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

uitoggletool 的子对象的图形句柄。

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

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

parent：图形句柄 ¶

父级图形对象的句柄。

切换操作 ¶

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

设置此拨动开关工具对象是激活状态还是灰显状态。

state：{"off"} | "on" ¶

拨动开关工具对象的当前 "on" 或 "off" 状态。