---

15.3.3.12 Uimenu属性¶

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

类别：¶

外观 | 回调执行 | 创建/删除 | 显示 | 键盘交互 | 菜单选项 | 鼠标交互 | 对象标识 | 对象位置 | 父级/子级

外观¶

foregroundcolor: colorspec, 默认值 [0 0 0] ¶

此菜单项文本的颜色值。

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

指示是否在当前菜单位置上方绘制分隔线的状态。

回调执行¶

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

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

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

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

menuselectedfcn: 字符串 | 函数句柄, 默认值 [](0x0) ¶

当此菜单项被执行时调用的函数。有关如何编写图形监听器函数的信息，请参见回调章节。

创建/删除¶

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

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

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

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

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

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

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

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

显示¶

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

如果 clipping 为 "on"，则 uimenu 在其父坐标轴限制内被裁剪。

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

如果 visible 为 "off"，则 uimenu 不会渲染在屏幕上。

键盘交互¶

accelerator: 字符, 默认值 "" ¶

与 CTRL 键同时按下时将触发此菜单项的字符。如果未设置（默认），则不使用加速键。

accelerator_EN: 字符串, 默认值 "" ¶

指定加速键的纯文本名称（例如 "Escape"、"Tab"、"F1"）。请参见accelerator 属性以了解基于字符的加速键系统。

菜单选项¶

callback: 字符串 | 函数句柄, 默认值 [](0x0) ¶

当菜单项被触发时调用的回调函数。有关如何编写图形监听器函数的信息，请参见回调章节。

label: 字符串, 默认值 "" ¶

菜单项的文本字符串。字符串中的 & 字符表示其后字符为助记键。例如，"&File" 中的 "F" 成为该菜单项的助记键，在菜单项上会显示为带下划线的 "F"。菜单打开时按下 "F" 键将触发该菜单项。

鼠标交互¶

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

指定此对象是否处理鼠标点击还是将其传递给其下方的对象。当 hittest 为 "on" 时，点击由此对象处理。当为 "off" 时，点击将传递给此对象下方的任何对象。仅当对象能够接受鼠标点击时，此属性才有效，这由 pickableparts 属性控制。请参见pickableparts 属性。

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

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

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

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

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

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

对象标识¶

tag: 字符串, 默认值 "" ¶

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

type（只读）：字符串 ¶

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

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

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

对象位置¶

position: 标量, 默认值 4 ¶

包含相对菜单位置的标量值，根据菜单的方向，从左侧或顶部开始计算。

父级/子级¶

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

uimenu 的子对象图形句柄。

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

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

parent: 图形句柄 ¶

父图形对象的句柄。