Method
Gdk.Popup.present
Declaration [src]
gboolean
gdk_popup_present (
GdkPopup* popup,
int width,
int height,
GdkPopupLayout* layout
)
Description [src]
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 GdkSurface::layout
signal being emitted. The resulting
popup position can be queried using gdk_popup_get_position_x()
,
gdk_popup_get_position_y()
, and the resulting size will be sent as
parameters in the layout signal. Use gdk_popup_get_rect_anchor()
and gdk_popup_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 GdkSurface::layout
signal will not me emitted.
Parameters
width |
int |
the unconstrained popup width to layout |
|
height |
int |
the unconstrained popup height to layout |
|
layout |
GdkPopupLayout |
the |
|
Ownership is not transferred to the callee |