Virtual Method

Gtk.CellArea.get_preferred_height_for_width

Declaration [src]

void
get_preferred_height_for_width (
  GtkCellArea* area,
  GtkCellAreaContext* context,
  GtkWidget* widget,
  int width,
  int* minimum_height,
  int* natural_height
)

Description [src]

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

area stores some geometrical information in context along the way while calling gtk_cell_area_get_preferred_width(). It’s important to perform a series of gtk_cell_area_get_preferred_width() requests with context first and then call gtk_cell_area_get_preferred_height_for_width() 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 gtk_cell_area_get_preferred_width() again and then the full width of the requested rows checked again with gtk_cell_area_context_get_preferred_width().

Parameters

context GtkCellAreaContext
 

the GtkCellAreaContext which has already been requested for widths.

 Ownership is not transferred to the callee
widget GtkWidget
 

the GtkWidget where area will be rendering

 Ownership is not transferred to the callee
width int
 

the width for which to check the height of this area

minimum_height int*
 

location to store the minimum height, or NULL

 Direction: out
 Ownership of the data is transferred to the callee
natural_height int*
 

location to store the natural height, or NULL

 Direction: out
 Ownership of the data is transferred to the callee