popup_for_device
Description:
public void popup_for_device (Device? device, Widget? parent_menu_shell, Widget? parent_menu_item, owned MenuPositionFunc? func, uint button, uint32 activate_time)
Warning: popup_for_device is deprecated since 3.22.
Displays a menu and makes it available for selection.
Please use popup_at_widget, popup_at_pointer. or popup_at_rect instead
Applications can use this function to display context-sensitive menus, and will typically supply null for the
parent_menu_shell, parent_menu_item, func, data and destroy parameters. The
default menu positioning function will position the menu at the current position of device (or its corresponding pointer).
The button parameter should be the mouse button pressed to initiate the menu popup. If the menu popup was initiated by something
other than a mouse button press, such as a mouse button release or a keypress, button should be 0.
The activate_time parameter is used to conflict-resolve initiation of concurrent requests for mouse/keyboard grab requests. To
function properly, this needs to be the time stamp of the user event (such as a mouse click or key press) that caused the initiation of the
popup. Only if no such event is available, get_current_event_time can be
used instead.
Note that this function does not work very well on GDK backends that do not have global coordinates, such as Wayland or Mir. You should probably use one of the gtk_menu_popup_at_ variants, which do not have this problem.
Parameters:
| this |
a Menu |
| device |
a Device |
| parent_menu_shell |
the menu shell containing the triggering menu item, or null |
| parent_menu_item |
the menu item whose activation triggered the popup, or null |
| func |
a user supplied function used to position the menu, or null |
| button |
the mouse button which was pressed to initiate the event |
| activate_time |
the time at which the activation event occurred |
| data |
user supplied data to be passed to |
| destroy |
destroy notify for |