Menu
菜单 UI 组件
说明
菜单 UI 组件在图窗窗口顶部或上下文菜单中显示选项。在创建菜单后，使用 Menu 对象修改其外观和行为。
创建对象
使用 uimenu 函数在图窗中创建一个菜单。
属性
菜单
菜单标签，指定为字符向量或字符串标量。此属性指定显示在菜单（或菜单项）上的标签。
避免使用以下区分大小写的保留字：'default'、'remove' 和 'factory'。如果必须使用保留字，请在单词前面指定反斜杠字符。例如，将 'default' 指定为 '\default'。
您可以在标签文本中使用“与”(&) 字符来指定助记键盘快捷方式 (Alt+mnemonic)。按下 Alt 键时，“与”符号后的字符在菜单中带下划线显示。您可以通过按住 Alt 键并键入显示的字符来选择菜单项。
要使用助记键，您必须为在 App 中定义的所有菜单和菜单项指定助记键。如果您只为部分菜单或菜单项定义助记键，按 Alt 键不会有任何效果。
下表显示了一些示例：
| 文本值 | 具有助记键提示的菜单标签 |
|---|---|
'&Open Selection' |
|
'O&pen Selection' |
|
'&Save && Go' |
|
键盘快捷方式，指定为一个字符或包含一个字符的字符串。使用此属性定义用于选择菜单项的键盘快捷方式。
示例: mitem.Accelerator = "H"
指定快捷键值后，用户可以通过按下字符和另一个键来选择菜单项，而不是用鼠标选择菜单项。按键顺序是针对特定平台的。
Windows® 系统：Ctrl+
acceleratorMacintosh 系统：Command+
acceleratorLinux® 系统：Ctrl+
accelerator
使用快捷键时要牢记的事项：
输入快捷键序列时，App 窗口必须已获得焦点。
快捷键不能用于顶级菜单。
仅当菜单项符合所有以下条件时，快捷键才能正常工作。
它不包含任何子菜单项。
它执行回调函数。
它的
Visible属性设置为'on'。其加速值尚未分配给同一图窗中的不同活动菜单项。
分隔线模式，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
将此属性设置为 'on' 会在菜单项上方绘制一条分隔线。
注意
当菜单项是顶级菜单项时，将忽略 Separator 属性。
菜单复选标记指示符，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
将此属性设置为 'on' 会在相应菜单项旁边放置一个复选标记。将此属性设置为 'off' 可移除复选标记。可使用此功能显示启用或禁用应用程序功能的菜单项的状态。
注意
当菜单项是以下项时，将忽略 Checked 属性：
顶级菜单项
包含一个或多个子菜单项的菜单项
菜单标签颜色，指定为 RGB 三元组、十六进制颜色代码或下表中列出的颜色选项之一。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]范围内，例如[0.4 0.6 0.7]。十六进制颜色代码是字符向量或字符串标量，以井号 (
#) 开头，后跟三个或六个十六进制数字，范围可以是0到F。这些值不区分大小写。因此，颜色代码"#FF8800"与"#ff8800"、"#F80"与"#f80"是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。
交互性
工具提示，指定为字符向量、字符串标量、字符向量元胞数组、字符串数组或一维分类数组。如果使用此属性，则在运行时当用户将指针悬停在组件上时，将显示消息。要显示多行文本，请指定字符向量元胞数组或字符串数组。数组中的每个元素变为一行文本。如果将此属性指定为分类数组，MATLAB® 将使用数组中的值，而不是完整的类别集。
设置此属性对此类型的对象没有影响。
回调
选定菜单时触发的回调函数，指定为下列值之一：
函数句柄。
第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参量。
包含有效 MATLAB 表达式的字符向量（不推荐）。MATLAB 在基础工作区计算此表达式。
有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Specify a Callback Function。
此回调根据菜单项的位置和交互类型进行响应：
左键点击菜单将展开该菜单并触发其回调。
当任一菜单处于展开状态时，如果将光标在其他任何父级菜单（或顶级菜单）上暂停，将会展开该菜单并触发其回调。
注意
请勿使用回调动态更改菜单项。在回调中删除、添加和替换菜单项可能会生成空菜单。此时，可以使用 Visible 属性隐藏或显示菜单项。您还可以通过设置 Enable 属性来启用和禁用菜单项。要完全重新填充菜单项，请在回调外删除这些菜单项并重新创建。
与上下文菜单关联的菜单
当菜单组件与上下文菜单（而不是图窗窗口顶部的菜单项）相关联时，此回调函数可以访问有关用户与 App 交互的特定信息。MATLAB 将 MenuSelectedData 对象中的此信息作为第二个参量传递给回调函数。在 App 设计工具中，该参量名为 event。您可以使用圆点表示法查询对象属性。例如，event.ContextObject 返回有关用户右键点击哪个组件以打开关联的上下文菜单的信息。
注意
您可以为任何 Menu 对象指定 MenuSelectedFcn 回调。但是，回调事件数据中的 MenuSelectedData 对象仅在菜单所属的上下文菜单与 UI 组件（而不是图形对象，如 Axes 或 Line 对象）关联或与仅包含 UI 组件的容器关联时才可用。
下表列出了 MenuSelectedData 对象的属性。
| 属性 | 值 |
|---|---|
ContextObject | App 用户打开上下文菜单时右键点击的对象 |
InteractionInformation | 有关 App 用户在组件中打开上下文菜单时右键点击的位置的信息。根据 例如，如果 |
Source | 执行回调的上下文菜单对象 |
EventName | 'MenuSelected' |
下表列出了 InteractionInformation 对象的属性。这些属性取决于 App 用户打开上下文菜单时右键点击的对象。
ContextObject | InteractionInformation 属性 | 值 |
|---|---|---|
| 任一值 | Location | 用户右键点击的位置相对于
|
ScreenLocation | 用户右键点击的位置相对于其主显示画面左下角的位置，以
| |
Table | DisplayRow | 用户右键点击的在表中直观显示的行，以数值标量形式返回。 如果用户没有对表进行排序，则 |
DisplayColumn | 用户右键点击的在表中直观显示的列，以数值标量形式返回。 如果用户没有重新排列表，则 | |
Row | 用户右键点击的对应于原始表数据的行，以数值标量形式返回。 如果用户没有对表进行排序，则 | |
Column | 用户右键点击的对应于原始表数据的列，以数值标量形式返回。 如果用户没有重新排列表，则 | |
RowHeader | 用户是否右键点击了表的行标题，以逻辑值 0 (false) 或 1 (true) 形式返回。 | |
ColumnHeader | 用户是否右键点击了表的列标题，以逻辑值 0 (false) 或 1 (true) 形式返回。 | |
Tree | Node | 右键点击的节点，以 如果用户右键点击了树中未关联到节点的区域，则 |
Level | 所右键点击节点的级别，以数值标量形式返回。 如果用户右键点击了树中未关联到节点的区域，则 | |
ListBox | Item | 右键点击的列表框项的索引，以数值标量形式返回。 如果用户右键点击了列表框中与项无关的区域，则 |
回调执行控件
父级/子级
父对象，指定为 Figure 对象、另一个 Menu 对象或 ContextMenu 对象。您可以将菜单项移动到其他窗口，或者通过设置此属性将其移动到其他菜单下。将父容器指定为一个现有 Menu 对象，以将菜单项添加到菜单，或者嵌套菜单项。
菜单的子级，返回空的 GraphicsPlaceholder 或一维的 Menu 对象数组。
不能使用 Children 属性添加或删除子组件。可以使用此属性查看子级列表或对子菜单项重新排序。
要向此列表添加子菜单，请将另一个 Menu 对象的 Parent 属性设置为此 Menu 对象。
标识符
此 属性 为只读。
图形对象的类型，以 'uimenu' 形式返回。
示例
将具有键盘快捷方式的菜单项添加到菜单栏，并定义选择该菜单项时执行的回调。
首先，创建一个名为 importmenu.m 的程序文件。在该程序文件中：
创建一个图窗。
添加一个名为 Import 的菜单。通过将
'&Import'指定为文本标签，为菜单创建助记键键盘快捷方式。创建一个菜单项并指定助记键和快捷键键盘快捷方式。
定义当用户点击菜单项或使用助记键或快捷键键盘快捷方式时执行的
MenuSelectedFcn回调。
运行程序文件。
function importmenu fig = uifigure; m = uimenu(fig,'Text','&Import'); mitem = uimenu(m,'Text','&Text File'); mitem.Accelerator = 'T'; mitem.MenuSelectedFcn = @MenuSelected; function MenuSelected(src,event) file = uigetfile('*.txt'); end end
您可以使用键盘以下列方式与菜单和菜单项交互：
通过按 Alt+I 选择 Import 菜单。
选择 Text File 菜单项，并通过按 Alt+I+T 执行回调。
选择 Text File 菜单项，并通过使用快捷键 Ctrl+T 执行回调。
当您选择 Text File 菜单项时，“选择要打开的文件”对话框打开，扩展名字段限定为文本文件。
创建一个选中菜单项，可以选中或清除该菜单项以在坐标区上显示网格。共享具有普通按钮的回调，这样按下该普通按钮也可以显示或隐藏网格。
首先，创建一个名为 plotOptions.m 的程序文件。在该程序文件中：
创建一个图窗，其中包含一个普通按钮和用于显示网格的坐标区。
添加一个菜单和一个具有助记键的菜单项。指定该菜单项已选中。
定义一个
MenuSelectedFcn回调，当用户与菜单项交互时该回调会隐藏或显示网格。定义一个
ButtonPushedFcn，它与该菜单项使用相同的回调函数。
运行程序文件。
function plotOptions fig = uifigure; ax = uiaxes(fig); grid(ax); btn = uibutton(fig,'Text','Show Grid'); btn.Position = [155 325 100 20]; m = uimenu(fig,'Text','&Plot Options'); mitem = uimenu(m,'Text','Show &Grid','Checked','on'); mitem.MenuSelectedFcn = @ShowGrid; btn.ButtonPushedFcn = @ShowGrid; function ShowGrid(src,event) grid(ax); if strcmp(mitem.Checked,'on') mitem.Checked = 'off'; else mitem.Checked = 'on'; end end end
