gdk_popup_layout_new ()

GdkPopupLayout *
gdk_popup_layout_new (const GdkRectangle *anchor_rect,
                      GdkGravity rect_anchor,
                      GdkGravity surface_anchor);

Create a popup layout description. Used together with gdk_popup_present() to describe how a popup surface should be placed and behave on-screen.

anchor_rect is relative to the top-left corner of the surface's parent. rect_anchor and surface_anchor determine anchor points on anchor_rect and surface to pin together.

The position of anchor_rect 's anchor point can optionally be offset using gdk_popup_layout_set_offset(), which is equivalent to offsetting the position of surface.

[constructor]

gdk_popup_layout_ref ()

GdkPopupLayout *
gdk_popup_layout_ref (GdkPopupLayout *layout);

Increases the reference count of value .

gdk_popup_layout_unref ()

void
gdk_popup_layout_unref (GdkPopupLayout *layout);

Decreases the reference count of value .

gdk_popup_layout_copy ()

GdkPopupLayout *
gdk_popup_layout_copy (GdkPopupLayout *layout);

Create a new GdkPopupLayout and copy the contents of layout into it.

gdk_popup_layout_equal ()

gboolean
gdk_popup_layout_equal (GdkPopupLayout *layout,
                        GdkPopupLayout *other);

Check whether layout and other has identical layout properties.

gdk_popup_layout_set_anchor_rect ()

void
gdk_popup_layout_set_anchor_rect (GdkPopupLayout *layout,
                                  const GdkRectangle *anchor_rect);

Set the anchor rectangle.

gdk_popup_layout_get_anchor_rect ()

const GdkRectangle *
gdk_popup_layout_get_anchor_rect (GdkPopupLayout *layout);

Get the anchor rectangle.

gdk_popup_layout_set_rect_anchor ()

void
gdk_popup_layout_set_rect_anchor (GdkPopupLayout *layout,
                                  GdkGravity anchor);

Set the anchor on the anchor rectangle.

gdk_popup_layout_get_rect_anchor ()

GdkGravity
gdk_popup_layout_get_rect_anchor (GdkPopupLayout *layout);

Returns the anchor position on the anchor rectangle.

gdk_popup_layout_set_surface_anchor ()

void
gdk_popup_layout_set_surface_anchor (GdkPopupLayout *layout,
                                     GdkGravity anchor);

Set the anchor on the popup surface.

gdk_popup_layout_get_surface_anchor ()

GdkGravity
gdk_popup_layout_get_surface_anchor (GdkPopupLayout *layout);

Returns the anchor position on the popup surface.

gdk_popup_layout_set_anchor_hints ()

void
gdk_popup_layout_set_anchor_hints (GdkPopupLayout *layout,
                                   GdkAnchorHints anchor_hints);

Set new anchor hints.

The set anchor_hints determines how surface will be moved if the anchor points cause it to move off-screen. For example, GDK_ANCHOR_FLIP_X will replace GDK_GRAVITY_NORTH_WEST with GDK_GRAVITY_NORTH_EAST and vice versa if surface extends beyond the left or right edges of the monitor.

gdk_popup_layout_get_anchor_hints ()

GdkAnchorHints
gdk_popup_layout_get_anchor_hints (GdkPopupLayout *layout);

Get the GdkAnchorHints.

gdk_popup_layout_set_offset ()

void
gdk_popup_layout_set_offset (GdkPopupLayout *layout,
                             int dx,
                             int dy);

Offset the position of the anchor rectangle with the given delta.

gdk_popup_layout_get_offset ()

void
gdk_popup_layout_get_offset (GdkPopupLayout *layout,
                             int *dx,
                             int *dy);

Retrieves the offset for the anchor rectangle.

GdkPopupLayout

typedef struct _GdkPopupLayout GdkPopupLayout;

Struct containing information for gdk_popup_present()

enum GdkAnchorHints

Positioning hints for aligning a surface relative to a rectangle.

These hints determine how the surface should be positioned in the case that the surface would fall off-screen if placed in its ideal position.

For example, GDK_ANCHOR_FLIP_X will replace GDK_GRAVITY_NORTH_WEST with GDK_GRAVITY_NORTH_EAST and vice versa if the surface extends beyond the left or right edges of the monitor.

If GDK_ANCHOR_SLIDE_X is set, the surface can be shifted horizontally to fit on-screen. If GDK_ANCHOR_RESIZE_X is set, the surface can be shrunken horizontally to fit.

In general, when multiple flags are set, flipping should take precedence over sliding, which should take precedence over resizing.