X-Git-Url: https://gerrit.simantics.org/r/gitweb?a=blobdiff_plain;f=bundles%2Forg.eclipse.swt.win32.win32.x86_64%2Fsrc%2Forg%2Feclipse%2Fswt%2Fwidgets%2FMenu.java;fp=bundles%2Forg.eclipse.swt.win32.win32.x86_64%2Fsrc%2Forg%2Feclipse%2Fswt%2Fwidgets%2FMenu.java;h=0d55d5aef1371bdb48887e490c93ccbbd09406e4;hb=6b98970d0458754dd67f789afbd0a39e1e7ac6eb;hp=0000000000000000000000000000000000000000;hpb=56a61575ce0d27b340cb12438c8a7f303842095e;p=simantics%2Fplatform.git diff --git a/bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/widgets/Menu.java b/bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/widgets/Menu.java new file mode 100644 index 000000000..0d55d5aef --- /dev/null +++ b/bundles/org.eclipse.swt.win32.win32.x86_64/src/org/eclipse/swt/widgets/Menu.java @@ -0,0 +1,1360 @@ +/******************************************************************************* + * Copyright (c) 2000, 2014 IBM Corporation and others. + * + * This program and the accompanying materials + * are made available under the terms of the Eclipse Public License 2.0 + * which accompanies this distribution, and is available at + * https://www.eclipse.org/legal/epl-2.0/ + * + * SPDX-License-Identifier: EPL-2.0 + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ +package org.eclipse.swt.widgets; + + +import org.eclipse.swt.*; +import org.eclipse.swt.events.*; +import org.eclipse.swt.graphics.*; +import org.eclipse.swt.internal.*; +import org.eclipse.swt.internal.win32.*; + +/** + * Instances of this class are user interface objects that contain + * menu items. + *
+ *
Styles:
+ *
BAR, DROP_DOWN, POP_UP, NO_RADIO_GROUP
+ *
LEFT_TO_RIGHT, RIGHT_TO_LEFT
+ *
Events:
+ *
Help, Hide, Show
+ *
+ *

+ * Note: Only one of BAR, DROP_DOWN and POP_UP may be specified. + * Only one of LEFT_TO_RIGHT or RIGHT_TO_LEFT may be specified. + *

+ * IMPORTANT: This class is not intended to be subclassed. + *

+ * + * @see Menu snippets + * @see SWT Example: ControlExample + * @see Sample code and further information + * @noextend This class is not intended to be subclassed by clients. + */ +public class Menu extends Widget { + /** + * the handle to the OS resource + * (Warning: This field is platform dependent) + *

+ * IMPORTANT: This field is not part of the SWT + * public API. It is marked public only so that it can be shared + * within the packages provided by SWT. It is not available on all + * platforms and should never be accessed from application code. + *

+ * + * @noreference This field is not intended to be referenced by clients. + */ + public long handle; + + int x, y; + long hBrush; + int id0, id1; + int foreground = -1, background = -1; + Image backgroundImage; + boolean hasLocation; + MenuItem cascade; + Decorations parent; + MenuItem selectedMenuItem; + + /* Timer ID for MenuItem ToolTip */ + static final int ID_TOOLTIP_TIMER = 110; + +/** + * Constructs a new instance of this class given its parent, + * and sets the style for the instance so that the instance + * will be a popup menu on the given parent's shell. + *

+ * After constructing a menu, it can be set into its parent + * using parent.setMenu(menu). In this case, the parent may + * be any control in the same widget tree as the parent. + *

+ * + * @param parent a control which will be the parent of the new instance (cannot be null) + * + * @exception IllegalArgumentException + * @exception SWTException + * + * @see SWT#POP_UP + * @see Widget#checkSubclass + * @see Widget#getStyle + */ +public Menu (Control parent) { + this (checkNull (parent).menuShell (), SWT.POP_UP); +} + +/** + * Constructs a new instance of this class given its parent + * (which must be a Decorations) and a style value + * describing its behavior and appearance. + *

+ * The style value is either one of the style constants defined in + * class SWT which is applicable to instances of this + * class, or must be built by bitwise OR'ing together + * (that is, using the int "|" operator) two or more + * of those SWT style constants. The class description + * lists the style constants that are applicable to the class. + * Style bits are also inherited from superclasses. + *

+ * After constructing a menu or menuBar, it can be set into its parent + * using parent.setMenu(menu) or parent.setMenuBar(menuBar). + *

+ * + * @param parent a decorations control which will be the parent of the new instance (cannot be null) + * @param style the style of menu to construct + * + * @exception IllegalArgumentException + * @exception SWTException + * + * @see SWT#BAR + * @see SWT#DROP_DOWN + * @see SWT#POP_UP + * @see SWT#NO_RADIO_GROUP + * @see SWT#LEFT_TO_RIGHT + * @see SWT#RIGHT_TO_LEFT + * @see Widget#checkSubclass + * @see Widget#getStyle + */ +public Menu (Decorations parent, int style) { + this (parent, checkStyle (style), 0); +} + +/** + * Constructs a new instance of this class given its parent + * (which must be a Menu) and sets the style + * for the instance so that the instance will be a drop-down + * menu on the given parent's parent. + *

+ * After constructing a drop-down menu, it can be set into its parentMenu + * using parentMenu.setMenu(menu). + *

+ * + * @param parentMenu a menu which will be the parent of the new instance (cannot be null) + * + * @exception IllegalArgumentException + * @exception SWTException + * + * @see SWT#DROP_DOWN + * @see Widget#checkSubclass + * @see Widget#getStyle + */ +public Menu (Menu parentMenu) { + this (checkNull (parentMenu).parent, SWT.DROP_DOWN); +} + +/** + * Constructs a new instance of this class given its parent + * (which must be a MenuItem) and sets the style + * for the instance so that the instance will be a drop-down + * menu on the given parent's parent menu. + *

+ * After constructing a drop-down menu, it can be set into its parentItem + * using parentItem.setMenu(menu). + *

+ * + * @param parentItem a menu item which will be the parent of the new instance (cannot be null) + * + * @exception IllegalArgumentException + * @exception SWTException + * + * @see SWT#DROP_DOWN + * @see Widget#checkSubclass + * @see Widget#getStyle + */ +public Menu (MenuItem parentItem) { + this (checkNull (parentItem).parent); +} + +Menu (Decorations parent, int style, long handle) { + super (parent, checkStyle (style)); + this.parent = parent; + this.handle = handle; + /* + * Bug in IBM JVM 1.3.1. For some reason, when the checkOrientation() is + * called from createWidget(), the JVM issues this error: + * + * JVM Exception 0x2 (subcode 0x0) occurred in thread "main" (TID:0x9F19D8) + * + * In addition, on Windows XP, a dialog appears with following error message, + * indicating that the problem may be in the JIT: + * + * AppName: java.exe AppVer: 0.0.0.0 ModName: jitc.dll + * ModVer: 0.0.0.0 Offset: 000b6912 + * + * The fix is to call checkOrientation() from here. + */ + checkOrientation (parent); + createWidget (); +} + +void _setVisible (boolean visible) { + if ((style & (SWT.BAR | SWT.DROP_DOWN)) != 0) return; + long hwndParent = parent.handle; + if (visible) { + int flags = OS.TPM_LEFTBUTTON; + if (OS.GetKeyState (OS.VK_LBUTTON) >= 0) flags |= OS.TPM_RIGHTBUTTON; + if ((style & SWT.RIGHT_TO_LEFT) != 0) flags |= OS.TPM_RIGHTALIGN; + if ((parent.style & SWT.MIRRORED) != 0) { + flags &= ~OS.TPM_RIGHTALIGN; + if ((style & SWT.LEFT_TO_RIGHT) != 0) flags |= OS.TPM_RIGHTALIGN; + } + int nX = x, nY = y; + if (!hasLocation) { + int pos = OS.GetMessagePos (); + nX = OS.GET_X_LPARAM (pos); + nY = OS.GET_Y_LPARAM (pos); + } + hasLocation = false; + Display display = this.display; + display.sendPreExternalEventDispatchEvent (); + /* + * Feature in Windows. It is legal use TrackPopupMenu() + * to display an empty menu as long as menu items are added + * inside of WM_INITPOPUPMENU. If no items are added, then + * TrackPopupMenu() fails and does not send an indication + * that the menu has been closed. This is not strictly a + * bug but leads to unwanted behavior when application code + * assumes that every WM_INITPOPUPMENU will eventually result + * in a WM_MENUSELECT, wParam=MAKEWPARAM (0, 0xFFFF), lParam=0 to + * indicate that the menu has been closed. The fix is to detect + * the case when TrackPopupMenu() fails and the number of items in + * the menu is zero and issue a fake WM_MENUSELECT. + */ + boolean success = OS.TrackPopupMenu (handle, flags, nX, nY, 0, hwndParent, null); + // widget could be disposed at this point + display.sendPostExternalEventDispatchEvent (); + if (!success && OS.GetMenuItemCount (handle) == 0) { + OS.SendMessage (hwndParent, OS.WM_MENUSELECT, OS.MAKEWPARAM (0, 0xFFFF), 0); + } + } else { + OS.SendMessage (hwndParent, OS.WM_CANCELMODE, 0, 0); + } + /* + * Bug in Windows. After closing a popup menu, the accessibility focus + * is not returned to the focus control. This causes confusion for AT users. + * The fix is to explicitly set the accessibility focus back to the focus control. + */ + long hFocus = OS.GetFocus(); + if (hFocus != 0) { + OS.NotifyWinEvent (OS.EVENT_OBJECT_FOCUS, hFocus, OS.OBJID_CLIENT, 0); + } +} + +/** + * Adds the listener to the collection of listeners who will + * be notified when help events are generated for the control, + * by sending it one of the messages defined in the + * HelpListener interface. + * + * @param listener the listener which should be notified + * + * @exception IllegalArgumentException + * @exception SWTException + * + * @see HelpListener + * @see #removeHelpListener + */ +public void addHelpListener (HelpListener listener) { + checkWidget (); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + TypedListener typedListener = new TypedListener (listener); + addListener (SWT.Help, typedListener); +} + +/** + * Adds the listener to the collection of listeners who will + * be notified when menus are hidden or shown, by sending it + * one of the messages defined in the MenuListener + * interface. + * + * @param listener the listener which should be notified + * + * @exception IllegalArgumentException + * @exception SWTException + * + * @see MenuListener + * @see #removeMenuListener + */ +public void addMenuListener (MenuListener listener) { + checkWidget (); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + TypedListener typedListener = new TypedListener (listener); + addListener (SWT.Hide,typedListener); + addListener (SWT.Show,typedListener); +} + +static Control checkNull (Control control) { + if (control == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); + return control; +} + +static Menu checkNull (Menu menu) { + if (menu == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); + return menu; +} + +static MenuItem checkNull (MenuItem item) { + if (item == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); + return item; +} + +static int checkStyle (int style) { + return checkBits (style, SWT.POP_UP, SWT.BAR, SWT.DROP_DOWN, 0, 0, 0); +} + +void createHandle () { + if (handle != 0) return; + if ((style & SWT.BAR) != 0) { + handle = OS.CreateMenu (); + } else { + handle = OS.CreatePopupMenu (); + } + if (handle == 0) error (SWT.ERROR_NO_HANDLES); +} + +void createItem (MenuItem item, int index) { + int count = OS.GetMenuItemCount (handle); + if (!(0 <= index && index <= count)) error (SWT.ERROR_INVALID_RANGE); + display.addMenuItem (item); + /* + * Bug in Windows. For some reason, when InsertMenuItem() + * is used to insert an item without text, it is not possible + * to use SetMenuItemInfo() to set the text at a later time. + * The fix is to insert the item with some text. + * + * Feature in Windows. When an empty string is used instead + * of a space and InsertMenuItem() is used to set a submenu + * before setting text to a non-empty string, the menu item + * becomes unexpectedly disabled. The fix is to insert a + * space. + */ + long hHeap = OS.GetProcessHeap (); + long pszText = OS.HeapAlloc (hHeap, OS.HEAP_ZERO_MEMORY, 4); + OS.MoveMemory (pszText, new char [] {' ', '\0'}, 4); + MENUITEMINFO info = new MENUITEMINFO (); + info.cbSize = MENUITEMINFO.sizeof; + info.fMask = OS.MIIM_ID | OS.MIIM_TYPE | OS.MIIM_DATA; + info.wID = item.id; + info.dwItemData = item.id; + info.fType = item.widgetStyle (); + info.dwTypeData = pszText; + boolean success = OS.InsertMenuItem (handle, index, true, info); + if (pszText != 0) OS.HeapFree (hHeap, 0, pszText); + if (!success) { + display.removeMenuItem (item); + error (SWT.ERROR_ITEM_NOT_ADDED); + } + redraw (); +} + +void createWidget () { + /* + * Bug in IBM JVM 1.3.1. For some reason, when the following code is called + * from this method, the JVM issues this error: + * + * JVM Exception 0x2 (subcode 0x0) occurred in thread "main" (TID:0x9F19D8) + * + * In addition, on Windows XP, a dialog appears with following error message, + * indicating that the problem may be in the JIT: + * + * AppName: java.exe AppVer: 0.0.0.0 ModName: jitc.dll + * ModVer: 0.0.0.0 Offset: 000b6912 + * + * The fix is to move the code to the caller of this method. + */ +// checkOrientation (parent); + createHandle (); + parent.addMenu (this); +} + +int defaultBackground () { + return OS.GetSysColor (OS.COLOR_MENU); +} + +int defaultForeground () { + return OS.GetSysColor (OS.COLOR_MENUTEXT); +} + +void destroyAccelerators () { + parent.destroyAccelerators (); +} + +void destroyItem (MenuItem item) { + if (!OS.DeleteMenu (handle, item.id, OS.MF_BYCOMMAND)) { + error (SWT.ERROR_ITEM_NOT_REMOVED); + } + redraw (); +} + +@Override +void destroyWidget () { + MenuItem cascade = this.cascade; + long hMenu = handle; + releaseHandle (); + if (cascade != null) { + cascade.setMenu (null, true); + } else { + if (hMenu != 0) OS.DestroyMenu (hMenu); + } +} + +void fixMenus (Decorations newParent) { + if (isDisposed()) { + return; + } + MenuItem [] items = getItems (); + for (int i=0; i + *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • + *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • + * + * + * @since 3.3 + */ +/*public*/ Color getBackground () { + checkWidget (); + return Color.win32_new (display, background != -1 ? background : defaultBackground ()); +} + +/** + * Returns the receiver's background image. + * + * @return the background image + * + * @exception SWTException + * + * @since 3.3 + */ +/*public*/ Image getBackgroundImage () { + checkWidget (); + return backgroundImage; +} + +/** + * Returns a rectangle describing the receiver's size and location + * relative to its parent (or its display if its parent is null), + * unless the receiver is a menu or a shell. In this case, the + * location is relative to the display. + *

    + * Note that the bounds of a menu or menu item are undefined when + * the menu is not visible. This is because most platforms compute + * the bounds of a menu dynamically just before it is displayed. + *

    + * + * @return the receiver's bounding rectangle + * + * @exception SWTException + * + * @since 3.1 + */ +/*public*/ Rectangle getBounds () { + checkWidget (); + if ((style & SWT.BAR) != 0) { + if (parent.menuBar != this) { + return new Rectangle (0, 0, 0, 0); + } + long hwndShell = parent.handle; + MENUBARINFO info = new MENUBARINFO (); + info.cbSize = MENUBARINFO.sizeof; + if (OS.GetMenuBarInfo (hwndShell, OS.OBJID_MENU, 0, info)) { + int width = info.right - info.left; + int height = info.bottom - info.top; + return new Rectangle (info.left, info.top, width, height); + } + } else { + int count = OS.GetMenuItemCount (handle); + if (count != 0) { + RECT rect1 = new RECT (); + if (OS.GetMenuItemRect (0, handle, 0, rect1)) { + RECT rect2 = new RECT (); + if (OS.GetMenuItemRect (0, handle, count - 1, rect2)) { + int x = rect1.left - 2, y = rect1.top - 2; + int width = (rect2.right - rect2.left) + 4; + int height = (rect2.bottom - rect1.top) + 4; + return new Rectangle (x, y, width, height); + } + } + } + } + return new Rectangle (0, 0, 0, 0); +} + +/** + * Returns the default menu item or null if none has + * been previously set. + * + * @return the default menu item. + * + * @exception SWTException + */ +public MenuItem getDefaultItem () { + checkWidget (); + int id = OS.GetMenuDefaultItem (handle, OS.MF_BYCOMMAND, OS.GMDI_USEDISABLED); + if (id == -1) return null; + MENUITEMINFO info = new MENUITEMINFO (); + info.cbSize = MENUITEMINFO.sizeof; + info.fMask = OS.MIIM_ID; + if (OS.GetMenuItemInfo (handle, id, false, info)) { + return display.getMenuItem (info.wID); + } + return null; +} + +/** + * Returns true if the receiver is enabled, and + * false otherwise. A disabled menu is typically + * not selectable from the user interface and draws with an + * inactive or "grayed" look. + * + * @return the receiver's enabled state + * + * @exception SWTException + * + * @see #isEnabled + */ +public boolean getEnabled () { + checkWidget (); + return (state & DISABLED) == 0; +} + +/** + * Returns the foreground color that the receiver will use to draw. + * + * @return the receiver's foreground color + * + * @exception SWTException + */ +/*public*/ Color getForeground () { + checkWidget (); + return Color.win32_new (display, foreground != -1 ? foreground : defaultForeground ()); +} + +/** + * Returns the item at the given, zero-relative index in the + * receiver. Throws an exception if the index is out of range. + * + * @param index the index of the item to return + * @return the item at the given index + * + * @exception IllegalArgumentException + * @exception SWTException + */ +public MenuItem getItem (int index) { + checkWidget (); + int id = 0; + MENUITEMINFO info = new MENUITEMINFO (); + info.cbSize = MENUITEMINFO.sizeof; + info.fMask = OS.MIIM_DATA; + if (!OS.GetMenuItemInfo (handle, index, true, info)) { + error (SWT.ERROR_INVALID_RANGE); + } + id = (int)info.dwItemData; + return display.getMenuItem (id); +} + +/** + * Returns the number of items contained in the receiver. + * + * @return the number of items + * + * @exception SWTException + */ +public int getItemCount () { + checkWidget (); + return OS.GetMenuItemCount (handle); +} + +/** + * Returns a (possibly empty) array of MenuItems which + * are the items in the receiver. + *

    + * Note: This is not the actual structure used by the receiver + * to maintain its list of items, so modifying the array will + * not affect the receiver. + *

    + * + * @return the items in the receiver + * + * @exception SWTException + */ +public MenuItem [] getItems () { + checkWidget (); + int index = 0, count = 0; + int length = OS.GetMenuItemCount (handle); + if (length < 0) { + int error = OS.GetLastError(); + SWT.error(SWT.ERROR_CANNOT_GET_COUNT, null, " [GetLastError=0x" + Integer.toHexString(error) + "]");//$NON-NLS-1$ $NON-NLS-2$ + } + MenuItem [] items = new MenuItem [length]; + MENUITEMINFO info = new MENUITEMINFO (); + info.cbSize = MENUITEMINFO.sizeof; + info.fMask = OS.MIIM_DATA; + while (OS.GetMenuItemInfo (handle, index, true, info)) { + if (count == items.length) { + MenuItem [] newItems = new MenuItem [count + 4]; + System.arraycopy (items, 0, newItems, 0, count); + items = newItems; + } + MenuItem item = display.getMenuItem ((int)info.dwItemData); + if (item != null) items [count++] = item; + index++; + } + if (count == items.length) return items; + MenuItem [] result = new MenuItem [count]; + System.arraycopy (items, 0, result, 0, count); + return result; +} + +@Override +String getNameText () { + String result = ""; + MenuItem [] items = getItems (); + int length = items.length; + if (length > 0) { + for (int i=0; i<=length-1; i++) { + result += (items [i] == null ? "null" : items [i].getNameText()) + + (i < (length - 1) ? ", " : ""); + } + } + return result; +} + +/** + * Returns the orientation of the receiver, which will be one of the + * constants SWT.LEFT_TO_RIGHT or SWT.RIGHT_TO_LEFT. + * + * @return the orientation style + * + * @exception SWTException + * + * @since 3.7 + */ +public int getOrientation () { + checkWidget (); + return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT); +} + +/** + * Returns the receiver's parent, which must be a Decorations. + * + * @return the receiver's parent + * + * @exception SWTException + */ +public Decorations getParent () { + checkWidget (); + return parent; +} + +/** + * Returns the receiver's parent item, which must be a + * MenuItem or null when the receiver is a + * root. + * + * @return the receiver's parent item + * + * @exception SWTException + */ +public MenuItem getParentItem () { + checkWidget (); + return cascade; +} + +/** + * Returns the receiver's parent item, which must be a + * Menu or null when the receiver is a + * root. + * + * @return the receiver's parent item + * + * @exception SWTException + */ +public Menu getParentMenu () { + checkWidget (); + if (cascade != null) return cascade.parent; + return null; +} + +/** + * Returns the receiver's shell. For all controls other than + * shells, this simply returns the control's nearest ancestor + * shell. Shells return themselves, even if they are children + * of other shells. Returns null if receiver or its ancestor + * is the application menubar. + * + * @return the receiver's shell or null + * + * @exception SWTException + * + * @see #getParent + */ +public Shell getShell () { + checkWidget (); + return parent.getShell (); +} + +/** + * Returns true if the receiver is visible, and + * false otherwise. + *

    + * If one of the receiver's ancestors is not visible or some + * other condition makes the receiver not visible, this method + * may still indicate that it is considered visible even though + * it may not actually be showing. + *

    + * + * @return the receiver's visibility state + * + * @exception SWTException + */ +public boolean getVisible () { + checkWidget (); + if ((style & SWT.BAR) != 0) { + return this == parent.menuShell ().menuBar; + } + if ((style & SWT.POP_UP) != 0) { + Menu [] popups = display.popups; + if (popups == null) return false; + for (int i=0; i + *
  • ERROR_NULL_ARGUMENT - if the item is null
    • + * + * @exception SWTException + */ +public int indexOf (MenuItem item) { + checkWidget (); + if (item == null) error (SWT.ERROR_NULL_ARGUMENT); + if (item.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); + if (item.parent != this) return -1; + int index = 0; + MENUITEMINFO info = new MENUITEMINFO (); + info.cbSize = MENUITEMINFO.sizeof; + info.fMask = OS.MIIM_DATA; + while (OS.GetMenuItemInfo (handle, index, true, info)) { + if (info.dwItemData == item.id) return index; + index++; + } + return -1; +} + +/** + * Returns true if the receiver is enabled and all + * of the receiver's ancestors are enabled, and false + * otherwise. A disabled menu is typically not selectable from the + * user interface and draws with an inactive or "grayed" look. + * + * @return the receiver's enabled state + * + * @exception SWTException + * + * @see #getEnabled + */ +public boolean isEnabled () { + checkWidget (); + Menu parentMenu = getParentMenu (); + if (parentMenu == null) { + return getEnabled () && parent.isEnabled (); + } + return getEnabled () && parentMenu.isEnabled (); +} + +/** + * Returns true if the receiver is visible and all + * of the receiver's ancestors are visible and false + * otherwise. + * + * @return the receiver's visibility state + * + * @exception SWTException + * + * @see #getVisible + */ +public boolean isVisible () { + checkWidget (); + return getVisible (); +} + +void redraw () { + if (!isVisible ()) return; + if ((style & SWT.BAR) != 0) { + display.addBar (this); + } else { + update (); + } +} + +@Override +void releaseHandle () { + super.releaseHandle (); + handle = 0; + cascade = null; +} + +@Override +void releaseChildren (boolean destroy) { + MenuItem [] items = getItems (); + for (int i=0; i + *
  • ERROR_NULL_ARGUMENT - if the listener is null
    • + * + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + * + * @see HelpListener + * @see #addHelpListener + */ +public void removeHelpListener (HelpListener listener) { + checkWidget (); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + if (eventTable == null) return; + eventTable.unhook (SWT.Help, listener); +} + +/** + * Removes the listener from the collection of listeners who will + * be notified when the menu events are generated for the control. + * + * @param listener the listener which should no longer be notified + * + * @exception IllegalArgumentException
      + *
    • ERROR_NULL_ARGUMENT - if the listener is null
      • + *
    + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + * + * @see MenuListener + * @see #addMenuListener + */ +public void removeMenuListener (MenuListener listener) { + checkWidget (); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + if (eventTable == null) return; + eventTable.unhook (SWT.Hide, listener); + eventTable.unhook (SWT.Show, listener); +} + +@Override +void reskinChildren (int flags) { + MenuItem [] items = getItems (); + for (int i=0; i + *
  • ERROR_INVALID_ARGUMENT - if the argument has been disposed
    • + * + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + * + * @since 3.3 + */ +/*public*/ void setBackground (Color color) { + checkWidget (); + int pixel = -1; + if (color != null) { + if (color.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); + pixel = color.handle; + } + if (pixel == background) return; + background = pixel; + updateBackground (); +} + +/** + * Sets the receiver's background image to the image specified + * by the argument, or to the default system color for the control + * if the argument is null. The background image is tiled to fill + * the available space. + * + * @param image the new image (or null) + * + * @exception IllegalArgumentException
      + *
    • ERROR_INVALID_ARGUMENT - if the argument has been disposed
      • + *
    • ERROR_INVALID_ARGUMENT - if the argument is not a bitmap
      • + *
    + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + * + * @since 3.3 + */ +/*public*/ void setBackgroundImage (Image image) { + checkWidget (); + if (image != null) { + if (image.isDisposed ()) error (SWT.ERROR_INVALID_ARGUMENT); + if (image.type != SWT.BITMAP) error (SWT.ERROR_INVALID_ARGUMENT); + } + if (backgroundImage == image) return; + backgroundImage = image; + updateBackground (); +} + +/** + * Sets the receiver's foreground color to the color specified + * by the argument, or to the default system color for the control + * if the argument is null. + * + * @param color the new color (or null) + * + * @exception IllegalArgumentException
      + *
    • ERROR_INVALID_ARGUMENT - if the argument has been disposed
      • + *
    + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + * + * @since 3.3 + */ +/*public*/ void setForeground (Color color) { + checkWidget (); + int pixel = -1; + if (color != null) { + if (color.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); + pixel = color.handle; + } + if (pixel == foreground) return; + foreground = pixel; + updateForeground (); +} + +/** + * Sets the default menu item to the argument or removes + * the default emphasis when the argument is null. + * + * @param item the default menu item or null + * + * @exception IllegalArgumentException
      + *
    • ERROR_INVALID_ARGUMENT - if the menu item has been disposed
      • + *
    + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + */ +public void setDefaultItem (MenuItem item) { + checkWidget (); + int newID = -1; + if (item != null) { + if (item.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); + if (item.parent != this) return; + newID = item.id; + } + int oldID = OS.GetMenuDefaultItem (handle, OS.MF_BYCOMMAND, OS.GMDI_USEDISABLED); + if (newID == oldID) return; + OS.SetMenuDefaultItem (handle, newID, OS.MF_BYCOMMAND); + redraw (); +} + +/** + * Enables the receiver if the argument is true, + * and disables it otherwise. A disabled menu is typically + * not selectable from the user interface and draws with an + * inactive or "grayed" look. + * + * @param enabled the new enabled state + * + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + */ +public void setEnabled (boolean enabled) { + checkWidget (); + state &= ~DISABLED; + if (!enabled) state |= DISABLED; +} + +/** + * Sets the location of the receiver, which must be a popup, + * to the point specified by the arguments which are relative + * to the display. + *

    + * Note that this is different from most widgets where the + * location of the widget is relative to the parent. + *

    + * Also note that the actual location of the menu is dependent + * on platform specific behavior. For example: on Linux with + * Wayland this operation is a hint due to lack of global + * coordinates. + *

    + * + * @param x the new x coordinate for the receiver + * @param y the new y coordinate for the receiver + * + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + */ +public void setLocation (int x, int y) { + checkWidget (); + setLocationInPixels(DPIUtil.autoScaleUp(x), DPIUtil.autoScaleUp(y)); +} + +void setLocationInPixels (int x, int y) { + if ((style & (SWT.BAR | SWT.DROP_DOWN)) != 0) return; + this.x = x; + this.y = y; + hasLocation = true; +} + +/** + * Sets the location of the receiver, which must be a popup, + * to the point specified by the argument which is relative + * to the display. + *

    + * Note that this is different from most widgets where the + * location of the widget is relative to the parent. + *

    + * Note that the platform window manager ultimately has control + * over the location of popup menus. + *

    + * + * @param location the new location for the receiver + * + * @exception IllegalArgumentException
      + *
    • ERROR_NULL_ARGUMENT - if the point is null
      • + *
    + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + * + * @since 2.1 + */ +public void setLocation (Point location) { + checkWidget (); + if (location == null) error (SWT.ERROR_NULL_ARGUMENT); + location = DPIUtil.autoScaleUp(location); + setLocationInPixels(location.x, location.y); +} + +/** + * Sets the orientation of the receiver, which must be one + * of the constants SWT.LEFT_TO_RIGHT or SWT.RIGHT_TO_LEFT. + *

    + * + * @param orientation new orientation style + * + * @exception SWTException

      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + * + * @since 3.7 + */ +public void setOrientation (int orientation) { + checkWidget (); + if ((style & (SWT.BAR | SWT.DROP_DOWN)) != 0) return; + _setOrientation (orientation); +} + +void _setOrientation (int orientation) { + int flags = SWT.RIGHT_TO_LEFT | SWT.LEFT_TO_RIGHT; + if ((orientation & flags) == 0 || (orientation & flags) == flags) return; + style &= ~flags; + style |= orientation & flags; + style &= ~SWT.FLIP_TEXT_DIRECTION; + MenuItem [] itms = getItems (); + for (int i=0; itrue, + * and marks it invisible otherwise. + *

    + * If one of the receiver's ancestors is not visible or some + * other condition makes the receiver not visible, marking + * it visible may not actually cause it to be displayed. + *

    + * + * @param visible the new visibility state + * + * @exception SWTException
      + *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
      • + *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
      • + *
    + */ +public void setVisible (boolean visible) { + checkWidget (); + if ((style & (SWT.BAR | SWT.DROP_DOWN)) != 0) return; + if (visible) { + display.addPopup (this); + } else { + display.removePopup (this); + _setVisible (false); + } +} + +void update () { + if ((style & SWT.BAR) != 0) { + if (this == parent.menuBar) OS.DrawMenuBar (parent.handle); + return; + } + boolean hasCheck = false, hasImage = false; + MenuItem [] items = getItems (); + for (int i=0; i