Top | ![]() |
![]() |
![]() |
![]() |
GtkOverlay is a container which contains a single main child, on top
of which it can place “overlay” widgets. The position of each overlay
widget is determined by its “halign” and “valign”
properties. E.g. a widget with both alignments set to GTK_ALIGN_START
will be placed at the top left corner of the GtkOverlay container,
whereas an overlay with halign set to GTK_ALIGN_CENTER
and valign set
to GTK_ALIGN_END
will be placed a the bottom edge of the GtkOverlay,
horizontally centered. The position can be adjusted by setting the margin
properties of the child to non-zero values.
More complicated placement of overlays is possible by connecting to the “get-child-position” signal.
void gtk_overlay_add_overlay (GtkOverlay *overlay
,GtkWidget *widget
);
Adds widget
to overlay
.
The widget will be stacked on top of the main widget
added with gtk_container_add()
.
The position at which widget
is placed is determined
from its “halign” and “valign” properties.
Since: 3.2
void gtk_overlay_reorder_overlay (GtkOverlay *overlay
,GtkWidget *child
,gint position
);
Moves child
to a new index
in the list of overlay
children.
The list contains overlays in the order that these were
added to overlay
.
A widget’s index in the overlay
children list determines which order
the children are drawn if they overlap. The first child is drawn at
the bottom. It also affects the default focus chain order.
overlay |
||
child |
the overlaid GtkWidget to move |
|
position |
the new index for |
Since: 3.18
gboolean gtk_overlay_get_overlay_pass_through (GtkOverlay *overlay
,GtkWidget *widget
);
Convenience function to get the value of the “pass-through”
child property for widget
.
Since: 3.18
void gtk_overlay_set_overlay_pass_through (GtkOverlay *overlay
,GtkWidget *widget
,gboolean pass_through
);
Convenience function to set the value of the “pass-through”
child property for widget
.
overlay |
||
widget |
an overlay child of GtkOverlay |
|
pass_through |
whether the child should pass the input through |
Since: 3.18