Package: gtk

Function gtk:cell-renderer-size

Lambda List

gtk:cell-renderer-size (cell widget area)

Syntax

(gtk:cell-renderer-size cell widget area) => xoffset, yoffset, width, height

Arguments

renderer -- a gtk:cell-renderer object
widget -- a gtk:widget object the cell renderer is rendering to
area -- a gdk:rectangle instance for the area a cell will be allocated, or nil
xoffset -- an integer for the x offset of cell relative to area, or nil
yoffset -- an integer for the y offset of cell relative to area, or nil
width -- an integer for the width needed to render a cell, or nil
height -- an integer for the height needed to render a cell, or nil

Details

Obtains the width and height needed to render the cell. Used by tree view widgets to determine the appropriate size for the cell area passed to the gtk:cell-renderer-render function. If the area argument is not nil, fills in the x and y offsets (if set) of the cell relative to this location.

Please note that the values set in width and height, as well as those in xoffset and yoffset are inclusive of the xpad and ypad properties.

Warning

The gtk:cell-renderer-size function has been deprecated since version 3.0 and should not be used in newly written code. Use the gtk:cell-renderer-preferred-size function instead.
 

See also

2025-07-06