LayoutManager

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_layout_manager_get_type ()" ) ]
public abstract class LayoutManager : Object

Layout managers are delegate classes that handle the preferred size and the allocation of a widget.

You typically subclass `GtkLayoutManager` if you want to implement a layout policy for the children of a widget, or if you want to determine the size of a widget depending on its contents.

Each `GtkWidget` can only have a `GtkLayoutManager` instance associated to it at any given time; it is possible, though, to replace the layout manager instance using [method@Gtk.Widget.set_layout_manager].

Layout properties

A layout manager can expose properties for controlling the layout of each child, by creating an object type derived from [class@Gtk.LayoutChild ] and installing the properties on it as normal `GObject` properties.

Each `GtkLayoutChild` instance storing the layout properties for a specific child is created through the [ method@Gtk.LayoutManager.get_layout_child] method; a `GtkLayoutManager` controls the creation of its `GtkLayoutChild` instances by overriding the GtkLayoutManagerClass.create_layout_child() virtual function. The typical implementation should look like:

```c static GtkLayoutChild * create_layout_child (GtkLayoutManager *manager, GtkWidget *container, GtkWidget *child) { return g_object_new ( your_layout_child_get_type (), "layout-manager", manager, "child-widget", child, NULL); } ```

The [property@Gtk.LayoutChild:layout-manager] and [property@Gtk.LayoutChild:child-widget] properties on the newly created `GtkLayoutChild` instance are mandatory. The `GtkLayoutManager` will cache the newly created `GtkLayoutChild` instance until the widget is removed from its parent, or the parent removes the layout manager.

Each `GtkLayoutManager` instance creating a `GtkLayoutChild` should use [method@Gtk.LayoutManager.get_layout_child] every time it needs to query the layout properties; each `GtkLayoutChild` instance should call [method@Gtk.LayoutManager.layout_changed] every time a property is updated, in order to queue a new size measuring and allocation.

All known sub-classes:

Namespace: Gtk

Package: gtk4

Content:

Creation methods:

protected LayoutManager ()

Methods:

public virtual void allocate (Widget widget, int width, int height, int baseline)
Assigns the given width, height, and baseline to a widget, and computes the position and sizes of the children of the widget using the layout management policy of this.
public virtual LayoutChild create_layout_child (Widget widget, Widget for_child)
Create a `GtkLayoutChild` instance for the given for_child widget.
public unowned LayoutChild get_layout_child (Widget child)
Retrieves a `GtkLayoutChild` instance for the `GtkLayoutManager`, creating one if necessary.
public virtual SizeRequestMode get_request_mode (Widget widget)
a virtual function, used to return the preferred request mode for the layout manager; for instance, "width for height" or "height for width"; see `GtkSizeRequestMode`
public SizeRequestMode get_size_request_mode ()
Retrieves the request mode of this.
public unowned Widget? get_widget ()
Retrieves the `GtkWidget` using the given `GtkLayoutManager`.
public void layout_changed ()
Queues a resize on the `GtkWidget` using this , if any.
public virtual void measure (Widget widget, Orientation orientation, int for_size, out int minimum, out int natural, out int minimum_baseline, out int natural_baseline)
Measures the size of the widget using this, for the given orientation and size.
public virtual void root ()
a virtual function, called when the widget using the layout manager is attached to a `GtkRoot`
public virtual void unroot ()
a virtual function, called when the widget using the layout manager is detached from a `GtkRoot`

Inherited Members:

All known members inherited from class GLib.Object