Declaration [src]

gtk_menu_popup_at_rect (
  GtkMenu* menu,
  GdkWindow* rect_window,
  const GdkRectangle* rect,
  GdkGravity rect_anchor,
  GdkGravity menu_anchor,
  const GdkEvent* trigger_event

Description [src]

Displays menu and makes it available for selection.

See gtk_menu_popup_at_widget () and gtk_menu_popup_at_pointer (), which handle more common cases for popping up menus.

menu will be positioned at rect, aligning their anchor points. rect is relative to the top-left corner of rect_window. rect_anchor and menu_anchor determine anchor points on rect and menu to pin together. menu can optionally be offset by GtkMenu:rect-anchor-dx and GtkMenu:rect-anchor-dy.

Anchors should be specified under the assumption that the text direction is left-to-right; they will be flipped horizontally automatically if the text direction is right-to-left.

Other properties that influence the behaviour of this function are GtkMenu:anchor-hints and GtkMenu:menu-type-hint. Connect to the GtkMenu::popped-up signal to find out how it was actually positioned.

Available since:3.22


rect_window GdkWindow

The GdkWindow rect is relative to.

 The data is owned by the caller of the function.
rect GdkRectangle

The GdkRectangle to align menu with.

 The data is owned by the caller of the function.
rect_anchor GdkGravity

The point on rect to align with menus anchor point.

menu_anchor GdkGravity

The point on menu to align with rects anchor point.

trigger_event GdkEvent

The GdkEvent that initiated this request or NULL if it’s the current event.

 The argument can be NULL.
 The data is owned by the caller of the function.