Package: gtk

Function gtk-cell-area-preferred-width-for-height

Lambda List

gtk-cell-area-preferred-width-for-height (area context widget height)

Arguments

area -- a gtk-cell-area object
context -- a gtk-cell-area-context object which has already been requested for widths
widget -- a gtk-widget object where area will be rendering
height -- an integer with the height for which to check the width of this area

Return Value

minimum-width -- an integer with the minimum width, or nil
natural-width -- an integer with the natural width, or nil

Details

Retrieves a minimum and natural width of the cell area if it would be given the specified height.

The area argument stores some geometrical information in context along the way while calling the gtk-cell-area-preferred-height function. It is important to perform a series of the gtk-cell-area-preferred-height function requests with context first and then call the gtk-cell-area-preferred-width-for-height function on each cell area individually to get the height for width of each fully requested row.

If at some point, the height of a single row changes, it should be requested with the gtk-cell-area-preferred-height function again and then the full height of the requested rows checked again with the gtk-cell-area-context-preferred-height function.
 

See also

2021-12-20