Class cell-view - cl-cffi-gtk4 API documentation

Package: gtk

Class gtk:cell-view

Superclasses

gtk:widget, gobject:initially-unowned, gtk:accessible, gtk:buildable, gtk:constraint-target, gtk:cell-layout, gtk:orientable, gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

cell-area

The cell-area property of type gtk:cell-area (Read / Write / Construct)
The cell area rendering cells. If no cell area is specified when creating the cell view with the gtk:cell-view-new-with-context function a horizontally oriented gtk:cell-area-box object will be used.

cell-area-context

The cell-area-context property of type gtk:cell-area-context (Read / Write / Construct)
The cell area used to compute the geometry of the cell view. A group of cell views can be assigned the same context in order to ensure the sizes and cell alignments match across all the views with the same context. The gtk:combo-box menus uses this to assign the same context to all cell views in the menu items for a single menu, each submenu creates its own context since the size of each submenu does not depend on parent or sibling menus.

draw-sensitive

The draw-sensitive property of type :boolean (Read / Write)
Whether all cells should be draw as sensitive for this view regardless of the actual cell properties. Used to make menus with submenus appear sensitive when the items in submenus might be insensitive.
Default value: false

fit-model

The fit-model property of type :boolean (Read / Write)
Whether the view should request enough space to always fit the size of every row in the model, used by the combo box to ensure the combo box size does not change when different items are selected.
Default value: false

model

The model property of type gtk:tree-model (Read / Write)
The model for the cell view.

Details

The gtk:cell-view widget displays a single row of a gtk:tree-model object using a gtk:cell-area object and gtk:cell-area-context object. A gtk:cell-area-context object can be provided to the gtk:cell-view widget at construction time in order to keep the cell view in context of a group of cell views, this ensures that the renderers displayed will be properly aligned with each other like the aligned cells in the menus of a gtk:combo-box widget.

The gtk:cell-view widget is a gtk:orientable widget in order to decide in which orientation the underlying gtk:cell-area-context object should be allocated. Taking the gtk:combo-box menu as an example, cell views should be oriented horizontally if the menus are listed top-to-bottom and thus all share the same width but may have separate individual heights (left-to-right menus should be allocated vertically since they all share the same height but may have variable widths).