Popup

class Popup(*args, **kwargs)

A GdkPopup is a surface that is attached to another surface.

The GdkPopup is positioned relative to its parent surface.

GdkPopup’s are typically used to implement menus and similar popups. They can be modal, which is indicated by the autohide property.

Methods

class Popup

get_autohide() → bool

Returns whether this popup is set to hide on outside clicks.

get_parent() → Surface | None

Returns the parent surface of a popup.

get_position_x() → int

Obtains the position of the popup relative to its parent.

get_position_y() → int

Obtains the position of the popup relative to its parent.

get_rect_anchor() → Gravity

Gets the current popup rectangle anchor.

The value returned may change after calling present, or after the layout signal is emitted.

get_surface_anchor() → Gravity

Gets the current popup surface anchor.

The value returned may change after calling present, or after the layout signal is emitted.

present(width: int, height: int, layout: PopupLayout) → bool

Present popup after having processed the GdkPopupLayout rules.

If the popup was previously now showing, it will be showed, otherwise it will change position according to layout.

After calling this function, the result should be handled in response to the layout signal being emitted. The resulting popup position can be queried using get_position_x, get_position_y, and the resulting size will be sent as parameters in the layout signal. Use get_rect_anchor and get_surface_anchor to get the resulting anchors.

Presenting may fail, for example if the popup is set to autohide and is immediately hidden upon being presented. If presenting failed, the layout signal will not me emitted.

Parameters:

• width – the unconstrained popup width to layout

• height – the unconstrained popup height to layout

• layout – the GdkPopupLayout object used to layout

Properties

class Popup

props.autohide: bool

Whether to hide on outside clicks.

props.parent: Surface

The parent surface.