Package: gtk

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

Lambda List

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

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
width -- an integer with the width for which to check the height of this area

Return Value

minimum-heigth -- an integer with the minimum height, or nil
natural-height -- an integer with the natural height, or nil

Details

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

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

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

See also

2021-12-20