get_preferred_size


Description:

[ Version ( since = "3.0" ) ]
public void get_preferred_size (out Requisition minimum_size, out Requisition natural_size)

Retrieves the minimum and natural size of a widget, taking into account the widget’s preference for height-for-width management.

This is used to retrieve a suitable size by container widgets which do not impose any restrictions on the child placement. It can be used to deduce toplevel window and menu sizes as well as child widgets in free-form containers such as GtkLayout.

Handle with care. Note that the natural height of a height-for-width widget will generally be a smaller size than the minimum height, since the required height for the natural width is generally smaller than the required height for the minimum width.

Use get_preferred_height_and_baseline_for_width if you want to support baseline alignment.

Parameters:

this

a Widget instance

minimum_size

location for storing the minimum size, or null

natural_size

location for storing the natural size, or null




2022 vala-language.org