Package: gtk

Class gtk-cell-view

Superclasses

gtk-widget, gtk-buildable, gtk-cell-layout, gtk-orientable, g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

background
The background property of type :string (Write)
Background color as a string.
Default value: nil
background-gdk
The background-gdk property of type gdk-color (Read / Write)
The gdk-color background color.
Warning: The background-gdk property has been deprecated since version 3.4 and should not be used in newly written code. Use the background-rgba property instead.
background-rgba
The background-rgba property of type gdk-rgba (Read / Write)
The gdk-rgba background color.
background-set
The background-set property of type :boolean (Read / Write)
Whether this tag affects the background color.
Default value: false
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 function gtk-cell-view-new-with-context 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

A 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).

CSS nodes

The gtk-cell-view widget has a single CSS node with name cellview.
 

Slot Access Functions

Inherited Slot Access Functions

See also

2021-5-4