:right-sidebar: True

Align
===================================================================

.. currentmodule:: gi.repository.Gtk





.. class:: Align
   :no-contents-entry:






Controls how a widget deals with extra space in a single dimension.

Alignment only matters if the widget receives a “too large” allocation,
for example if you packed the widget with the :obj:`~gi.repository.Gtk.Widget.props.hexpand`
property inside a :obj:`~gi.repository.Gtk.Box`, then the widget might get extra space.
If you have for example a 16x16 icon inside a 32x32 space, the icon
could be scaled and stretched, it could be centered, or it could be
positioned to one side of the space.

Note that in horizontal context ``GTK_ALIGN_START`` and ``GTK_ALIGN_END``
are interpreted relative to text direction.

Baseline support is optional for containers and widgets, and is only available
for vertical alignment. `GTK_ALIGN_BASELINE_CENTER and ``GTK_ALIGN_BASELINE_FILL``
are treated similar to ``GTK_ALIGN_CENTER`` and ``GTK_ALIGN_FILL``, except that it
positions the widget to line up the baselines, where that is supported.













Fields
------

.. rst-class:: interim-class

.. class:: Align
   :no-index:
   

   .. attribute:: BASELINE

      Align the widget according to the baseline.







   .. attribute:: BASELINE_CENTER

      Stretch to fill all space, but align the baseline.



      .. versionadded:: 4.12





   .. attribute:: BASELINE_FILL

      A different name for ``GTK_ALIGN_BASELINE``.



      .. versionadded:: 4.12





   .. attribute:: CENTER

      Center natural width of widget inside the allocation







   .. attribute:: END

      Snap to right or bottom side, leaving space on left or top







   .. attribute:: FILL

      Stretch to fill all space if possible, center if
      no meaningful way to stretch







   .. attribute:: START

      Snap to left or top side, leaving space on right or bottom