Sets whether the widget would like any available extra horizontal space. When a user resizes a gtk.Window, widgets with expand=TRUE generally receive the extra space. For example, a list or scrollable area or document in your window would often be set to expand.

Call this function to set the expand flag if you would like your widget to become larger horizontally when the window has extra room.

By default, widgets automatically expand if any of their children want to expand. (To see if a widget will automatically expand given its current children and state, call Widget.computeExpand. A container can decide how the expandability of children affects the expansion of the container by overriding the compute_expand virtual method on gtk.Widget).

Setting hexpand explicitly with this function will override the automatic expand behavior.

This function forces the widget to expand or not to expand, regardless of children. The override occurs because Widget.setHexpand sets the hexpand-set property (see Widget.setHexpandSet) which causes the widget’s hexpand value to be used, rather than looking at children and widget state.

class Widget
bool expand


expand bool

whether to expand