IBM SWT 菜单

除了最基本的 GUI 应用程序之外，几乎所有的 GUI 应用程序都需要菜单。菜单增加了任何 GUI 的可用性。菜单是动态呈现的选择列表，它对应于可用的函数（常称为命令）或 GUI 状态。正如您所期望的，您可以使用菜单小部件创建菜单。菜单可以包含其他菜单或者menuItems（菜单项），而 menuItems 也可以包含菜单（即分层的菜单）。menuItems 表示您可以执行的命令或您所选择的 GUI 状态。菜单可以与应用程序（即 shell）的菜单栏相关，或者，这些菜单可以是漂浮在应用程序窗口之上的弹出式菜单。

必须将菜单定义为以下三种互斥样式之一：

1. BAR 充当 shell 的菜单栏。
2. DROP_DOWN 从菜单栏或一个菜单项往下拉。
3. POP_UP 从 shell 弹出，但上下文则针对于一个特定的控件。

菜单支持一些附加的可选样式：

• NO_RADIO_GROUP 不充当单选按钮组；当菜单中包含 RADIO 样式的菜单项时可以使用它。
• LEFT_TO_RIGHT 或 RIGHT_TO_LEFT 负责选择文本方向。

必须将菜单项定义为以下 5 种互斥样式之一：

1. CHECK 可以是持久选定的（即复选的）。
2. CASCADE 包含一个应该以下拉方式出现的菜单。
3. PUSH 行为类似于造成某一直接动作的按钮。
4. RADIO 行为类似于一个 CHECK，但是只有一个这种类型的项被选中。
5. SEPARATOR 充当菜单项的组之间的隔离物（通常是一个条），这一项没有任何功能。

创建一个菜单系统是相当复杂的。清单 1 显示了一个代码示例，该示例创建了一个可操作的菜单系统。

清单 1. 创建一个菜单系统和一个弹出菜单

import org.eclipse.swt.SWT;import org.eclipse.swt.widgets.*;import org.eclipse.swt.events.*;import org.eclipse.swt.graphics.*;  :Shell shell = ...;  :Label body = ...;  :// Create the menu bar systemMenu main = createMenu(shell, SWT.BAR | SWT.LEFT_TO_RIGHT);shell.setMenuBar(main);MenuItem fileMenuItem = createMenuItem(main, SWT.CASCADE, "&File",                                        null, -1, true, null);Menu fileMenu = createMenu(shell, SWT.DROP_DOWN, fileMenuItem, true);MenuItem exitMenuItem = createMenuItem(fileMenu, SWT.PUSH, "E&xit/tCtrl+X",                                        null, SWT.CTRL + 'X', true, "doExit");MenuItem helpMenuItem = createMenuItem(main, SWT.CASCADE, "&Help",                                        null, -1, true, null);Menu helpMenu = createMenu(shell, SWT.DROP_DOWN, helpMenuItem, true);MenuItem aboutMenuItem = createMenuItem(helpMenu, SWT.PUSH, "&About/tCtrl+A",                                         null, SWT.CTRL + 'A', true, "doAbout");// add popup menuMenu popup = createPopupMenu(shell, body);MenuItem popupMenuItem1 = createMenuItem(popup, SWT.PUSH, "&About",                                          null, -1, true, "doAbout");MenuItem popupMenuItem2 = createMenuItem(popup, SWT.PUSH, "&Noop",                                          null, -1, true, "doNothing");

 

此代码序列创建了以下菜单栏，该菜单栏中包含一些子菜单和一个弹出菜单。body 值是一个标签控件，包含文本“Sample body”。弹出菜单与这个控件在上下文上存在关联。

 

正如您所见，菜单项可以具有加速器（Ctrl+?）和记忆术（给通过 & 标识的字符加下划线），帮助用户使用键盘选择一些项。

我使用一组 helper 方法创建了这些菜单，如清单 2 中所示。最佳实践是创建与这些 helper 方法类似的方法，用这些方法创建重复的 GUI 部分，如菜单。随着时间的推移，您可以向这些 helper 方法添加更多的支持功能，并将它们应用到所有使用点。这些方法还有助于提示您获得所有需要的值。

清单 2. 菜单创建 helper 例程

protected Menu createMenu(Menu parent, boolean enabled) {    Menu m = new Menu(parent);    m.setEnabled(enabled);    return m;}protected Menu createMenu(MenuItem parent, boolean enabled) {    Menu m = new Menu(parent);    m.setEnabled(enabled);    return m;}protected Menu createMenu(Shell parent, int style) {    Menu m = new Menu(parent, style);    return m;}protected Menu createMenu(Shell parent, int style,                           MenuItem container, boolean enabled) {    Menu m = createMenu(parent, style);    m.setEnabled(enabled);    container.setMenu(m);    return m;}protected Menu createPopupMenu(Shell shell) {    Menu m = new Menu(shell, SWT.POP_UP);    shell.setMenu(m);    return m;}protected Menu createPopupMenu(Shell shell, Control owner) {    Menu m = createPopupMenu(shell);    owner.setMenu(m);    return m;}protected MenuItem createMenuItem(Menu parent, int style, String text,                                   Image icon, int accel, boolean enabled,                                   String callback) {    MenuItem mi = new MenuItem(parent, style);    if (text != null) {        mi.setText(text);    }    if (icon != null) {        mi.setImage(icon);    }    if (accel != -1) {        mi.setAccelerator(accel);    }    mi.setEnabled(enabled);    if (callback != null) {        registerCallback(mi, this, callback);    }    return mi;}

清单 3 显示了如何使用 Java 的反射 功能，利用处理菜单项的代码来链接菜单项。此功能创建了一个易于使用的方法，在这个方法中，只需要给应用程序类添加一个 public 方法（比如 doExit、doAbout 或 doNothing），就可以处理菜单命令。

清单 3. 处理菜单命令的 Callback 例程

protected void registerCallback(final MenuItem mi,                                 final Object handler,                                 final String handlerName) {    mi.addSelectionListener(new SelectionAdapter() {        public void widgetSelected(SelectionEvent e) {            try {                Method m = handler.getClass().getMethod(handlerName, null);                m.invoke(handler, null);            }            catch (Exception ex) {                ex.printStackTrace();            }        }    });}

请注意，菜单项（以及稍后讨论的列表、表、和树控件中的项）只支持字符串值；在添加其他类型的值之前，这些值将被转换成字符串值。