Standard Widget Toolkit for GTK 3.125.0 · org.eclipse.swt.widgets.Menu

Modifier and Type	Class and Description
pack-priv class	Menu.Section

Modifier and Type	Field and Description
pack-priv long	actionGroup GTK4 only fields
pack-priv MenuItem	cascade
pack-priv boolean	hasLocation
pack-priv ImageList	imageList
pack-priv LinkedList<MenuItem>	items
pack-priv long	menuHandle
pack-priv long	modelHandle GTK4 only fields
pack-priv Decorations	parent
pack-priv int	poppedUpCount
pack-priv LinkedList<Menu.Section>	sections
pack-priv MenuItem	selectedItem
pack-priv long	shortcutController GTK4 only fields
pack-priv int	x
pack-priv int	y

Access	Constructor and Description
public	Menu(Control a control which will be the parent of the new instance (cannot be null) parent) 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.
public	Menu(Decorations a decorations control which will be the parent of the new instance (cannot be null) parent, int the style of menu to construct style) Constructs a new instance of this class given its parent (which must be a `Decorations`) and a style value describing its behavior and appearance.
public	Menu(Menu a menu which will be the parent of the new instance (cannot be null) parentMenu) 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.
public	Menu(MenuItem a menu item which will be the parent of the new instance (cannot be null) parentItem) 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.

Method Summary

Modifier and Type	Method and Description
pack-priv void	_setOrientation(int orientation)
pack-priv void	_setVisible(boolean visible)
pack-priv boolean	Returns: true iff the location of menu is set and can be used successfully ableToSetLocation() Bug 532074: setLocation method is limited on Wayland since Wayland has no global coordinates and we cannot use gdk_popup_at_rect if GdkWindow of getShell is not mapped.
pack-priv void	addAccelerators(long accelGroup)
public void	addHelpListener(HelpListener the listener which should be notified listener) 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.
public void	addMenuListener(MenuListener the listener which should be notified listener) 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.
pack-priv void	adjustParentWindowWayland(long a pointer to the GdkEvent eventPtr) Lack of absolute coordinates make Wayland event windows inaccurate.
pack-priv static Control	checkNull(Control control)
pack-priv static Menu	checkNull(Menu menu)
pack-priv static MenuItem	checkNull(MenuItem item)
pack-priv static int	checkStyle(int style)
pack-priv void	createHandle(int index) Overrides org.eclipse.swt.widgets.Widget.createHandle.
pack-priv void	createWidget(int index) Overrides org.eclipse.swt.widgets.Widget.createWidget.
pack-priv void	destroyWidget() Overrides org.eclipse.swt.widgets.Widget.destroyWidget. Overridden to fix memory leak on GTK3, see bug 573983
pack-priv void	fixMenus(Decorations newParent)
public MenuItem	Returns: the default menu item. getDefaultItem() Returns the default menu item or null if none has been previously set.
public boolean	Returns: the receiver's enabled state getEnabled() Returns `true` if the receiver is enabled, and `false` otherwise.
public MenuItem	Returns: the item at the given index getItem(int the index of the item to return index) Returns the item at the given, zero-relative index in the receiver.
public int	Returns: the number of items getItemCount() Returns the number of items contained in the receiver.
public MenuItem[]	Returns: the items in the receiver getItems() Returns a (possibly empty) array of `MenuItem`s which are the items in the receiver.
pack-priv String	getNameText() Overrides org.eclipse.swt.widgets.Widget.getNameText.
public int	Returns: the orientation style getOrientation() Returns the orientation of the receiver, which will be one of the constants `SWT.LEFT_TO_RIGHT` or `SWT.RIGHT_TO_LEFT`.
public Decorations	Returns: the receiver's parent getParent() Returns the receiver's parent, which must be a `Decorations`.
public MenuItem	Returns: the receiver's parent item getParentItem() Returns the receiver's parent item, which must be a `MenuItem` or null when the receiver is a root.
public Menu	Returns: the receiver's parent item getParentMenu() Returns the receiver's parent item, which must be a `Menu` or null when the receiver is a root.
public Shell	Returns: the receiver's shell or null getShell() Returns the receiver's shell.
public boolean	Returns: the receiver's visibility state getVisible() Returns `true` if the receiver is visible, and `false` otherwise.
pack-priv long	gtk3_show_help(long widget, long helpType) Overrides org.eclipse.swt.widgets.Widget.gtk3_show_help.
pack-priv long	gtk_hide(long widget) Overrides org.eclipse.swt.widgets.Widget.gtk_hide.
pack-priv long	gtk_menu_popped_up(long the memory address of the menu which was popped up widget, long a pointer to the GdkRectangle containing the flipped location and size of the menu flipped_rect, long a pointer to the GdkRectangle containing the final (after all internal adjustments) location and size of the menu final_rect, long a boolean flag indicating whether the menu has been inverted along the X-axis flipped_x, long a boolean flag indicating whether the menu has been inverted along the Y-axis flipped_y) Overrides org.eclipse.swt.widgets.Widget.gtk_menu_popped_up. GTK3.22+ has API which allows clients of GTK to connect a menu to the "popped-up" signal.
pack-priv long	gtk_show(long widget) Overrides org.eclipse.swt.widgets.Widget.gtk_show.
pack-priv void	hookEvents() Overrides org.eclipse.swt.widgets.Widget.hookEvents.
public int	Returns: the index of the item indexOf(MenuItem the search item item) Searches the receiver's list starting at the first item (index 0) until an item is found that is equal to the argument, and returns the index of that item.
public boolean	Returns: the receiver's enabled state isEnabled() Returns `true` if the receiver is enabled and all of the receiver's ancestors are enabled, and `false` otherwise.
public boolean	Returns: the receiver's visibility state isVisible() Returns `true` if the receiver is visible and all of the receiver's ancestors are visible and `false` otherwise.
pack-priv void	releaseChildren(boolean destroy) Overrides org.eclipse.swt.widgets.Widget.releaseChildren.
pack-priv void	releaseParent() Overrides org.eclipse.swt.widgets.Widget.releaseParent.
pack-priv void	releaseWidget() Overrides org.eclipse.swt.widgets.Widget.releaseWidget.
pack-priv void	removeAccelerators(long accelGroup)
public void	removeHelpListener(HelpListener the listener which should no longer be notified listener) Removes the listener from the collection of listeners who will be notified when the help events are generated for the control.
public void	removeMenuListener(MenuListener the listener which should no longer be notified listener) Removes the listener from the collection of listeners who will be notified when the menu events are generated for the control.
pack-priv void	reskinChildren(int flags) Overrides org.eclipse.swt.widgets.Widget.reskinChildren.
pack-priv boolean	sendHelpEvent(long helpType)
public void	setDefaultItem(MenuItem the default menu item or null item) Sets the default menu item to the argument or removes the default emphasis when the argument is `null`.
public void	setEnabled(boolean the new enabled state enabled) Enables the receiver if the argument is `true`, and disables it otherwise.
public void	setLocation(int the new x coordinate for the receiver x, int the new y coordinate for the receiver y) Sets the location of the receiver, which must be a popup, to the point specified by the arguments which are relative to the display.
public void	setLocation(Point the new location for the receiver location) Sets the location of the receiver, which must be a popup, to the point specified by the argument which is relative to the display.
pack-priv void	setLocationInPixels(int x, int y)
pack-priv void	setLocationInPixels(Point location)
public void	setOrientation(int new orientation style orientation) Sets the orientation of the receiver, which must be one of the constants `SWT.LEFT_TO_RIGHT` or `SWT.RIGHT_TO_LEFT`.
pack-priv void	setOrientation(boolean create) Overrides org.eclipse.swt.widgets.Widget.setOrientation.
public void	setVisible(boolean the new visibility state visible) Marks the receiver as visible if the argument is `true`, and marks it invisible otherwise.
pack-priv void	verifyMenuPosition(int the current number of items in the menu, just before it's about to be shown/popped-up itemCount) Feature in GTK3 on X11: context menus in SWT are populated dynamically, sometimes asynchronously outside of SWT (i.e. in Platform UI).

Inherited from org.eclipse.swt.widgets.Widget:: _addListener addDisposeListener addListener cellDataProc checkBits checkOpen checkOrientation checkParent checkSubclass checkWidget convertPangoFontDescriptionToCss cssHandle deregister dispose dpiChanged enterMotionProc error filterProc filters fixMnemonic fixMnemonic fixMnemonic focusProc fontHeight gdk_event_free gdk_event_get_state gdk_event_get_surface_or_window gdk_pointer_grab gdk_pointer_ungrab gdk_surface_get_size gdk_window_get_size GdkSeatGrabPrepareFunc gesturePressReleaseProc getData getData getDisplay getListeners getName getStyle gtk4_draw gtk4_enter_event gtk4_focus_enter_event gtk4_focus_leave_event gtk4_focus_window_event gtk4_key_press_event gtk4_key_release_event gtk4_leave_event gtk4_motion_event gtk4_scroll_event gtk_activate gtk_adjustment_get gtk_box_new gtk_box_pack_end gtk_box_set_child_packing gtk_button_press_event gtk_button_release_event gtk_cell_renderer_get_preferred_size gtk_change_value gtk_changed gtk_clicked gtk_close_request gtk_commit gtk_configure_event gtk_container_get_border_width_or_margin gtk_container_set_border_width gtk_create_menu_proxy gtk_day_selected gtk_day_selected_double_click gtk_delete_event gtk_delete_range gtk_delete_text gtk_draw gtk_enter_notify_event gtk_event_after gtk_expand_collapse_cursor_row gtk_focus gtk_focus_in_event gtk_focus_out_event gtk_gesture_press_event gtk_gesture_release_event gtk_grab_focus gtk_icon_release gtk_input gtk_insert_text gtk_key_press_event gtk_key_release_event gtk_leave_notify_event gtk_map gtk_map_event gtk_mnemonic_activate gtk_month_changed gtk_motion_notify_event gtk_move_focus gtk_output gtk_populate_popup gtk_popup_menu gtk_preedit_changed gtk_realize gtk_row_activated gtk_row_has_child_toggled gtk_scroll_child gtk_scroll_event gtk_select gtk_selection_done gtk_size_allocate gtk_start_interactive_search gtk_status_icon_popup_menu gtk_style_updated gtk_switch_page gtk_test_collapse_row gtk_test_expand_row gtk_text_buffer_insert_text gtk_timer gtk_toggled gtk_tree_view_column_cell_get_position gtk_unmap gtk_unmap_event gtk_unrealize gtk_value_changed gtk_widget_get_preferred_size gtk_widget_get_surface gtk_widget_get_window gtk_widget_size_allocate gtk_window_state_event hooks hoverProc isActive isAutoDirection isDisposed isListening isValidSubclass isValidThread keyPressReleaseProc leaveProc mnemonicHit mnemonicMatch notifyCreationTracker notifyDisposalTracker notifyListeners notifyProc notifyState paintSurface paintWindow postEvent postEvent register release releaseHandle removeDisposeListener removeListener removeListener rendererGetPreferredWidthProc rendererRenderProc rendererSnapshotProc reskin reskinWidget scrollProc sendEvent sendEvent sendEvent sendEvent sendIMKeyEvent sendKeyEvent sendSelectionEvent sendSelectionEvent setButtonState setData setData setFontDescription setInputState setKeyState setLocationState setTabGroupFocus setTabItemFocus setToolTipText shellMapProc sizeAllocateProc sizeRequestProc snapshotToDraw timerProc topHandle toString translateTraversal windowActiveProc windowProc windowProc windowProc windowProc windowProc

public Class Menu

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary