gtk4/org.gtkkn.bindings.gtk/CellRendererPixbuf

CellRendererPixbuf

open class CellRendererPixbuf(pointer: <Error class: unknown class><<Error class: unknown class>>) : CellRenderer

Renders a pixbuf in a cell

A GtkCellRendererPixbuf can be used to render an image in a cell. It allows to render either a given GdkPixbuf (set via the GtkCellRendererPixbuf:pixbuf property) or a named icon (set via the GtkCellRendererPixbuf:icon-name property).

To support the tree view, GtkCellRendererPixbuf also supports rendering two alternative pixbufs, when the GtkCellRenderer:is-expander property is true. If the GtkCellRenderer:is-expanded property is true and the GtkCellRendererPixbuf:pixbuf-expander-open property is set to a pixbuf, it renders that pixbuf, if the GtkCellRenderer:is-expanded property is false and the GtkCellRendererPixbuf:pixbuf-expander-closed property is set to a pixbuf, it renders that one.

Skipped during bindings generation

method gicon: Property has no getter nor setter
method icon-name: Property has no getter nor setter
method icon-size: Property has no getter nor setter
method pixbuf: Property has no getter nor setter
method pixbuf-expander-closed: Property has no getter nor setter
method pixbuf-expander-open: Property has no getter nor setter
method texture: Property has no getter nor setter

Constructors

CellRendererPixbuf

constructor()

Creates a new GtkCellRendererPixbuf. Adjust rendering parameters using object properties. Object properties can be set globally (with g_object_set()). Also, with GtkTreeViewColumn, you can bind a property to a value in a GtkTreeModel. For example, you can bind the “pixbuf” property on the cell renderer to a pixbuf value in the model, thus rendering a different image in each row of the GtkTreeView.

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Companion

object Companion

Properties

gtkCellRendererPixbufPointer

val gtkCellRendererPixbufPointer: <Error class: unknown class><<Error class: unknown class>>

gtkCellRendererPointer

val gtkCellRendererPointer: <Error class: unknown class><<Error class: unknown class>>

isExpanded

open var isExpanded: Boolean

isExpander

open var isExpander: Boolean

sensitive

open var sensitive: Boolean

visible

open var visible: Boolean

Functions

activate

open fun activate(event: <Error class: unknown class>, widget: Widget, path: String, backgroundArea: <Error class: unknown class>, cellArea: <Error class: unknown class>, flags: CellRendererState): Boolean

Passes an activate event to the cell renderer for possible processing. Some cell renderers may use events; for example, GtkCellRendererToggle toggles when it gets a mouse click.

connectEditingCanceled

fun connectEditingCanceled(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: () -> Unit): <Error class: unknown class>

This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel editing when the user presses Escape.

connectEditingStarted

fun connectEditingStarted(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (editable: CellEditable, path: String) -> Unit): <Error class: unknown class>

This signal gets emitted when a cell starts to be edited. The intended use of this signal is to do special setup on @editable, e.g. adding a GtkEntryCompletion or setting up additional columns in a GtkComboBox.

getAlignedArea

open fun getAlignedArea(widget: Widget, flags: CellRendererState, cellArea: <Error class: unknown class>, alignedArea: <Error class: unknown class>)

Gets the aligned area used by @cell inside @cell_area. Used for finding the appropriate edit and focus rectangle.

getPreferredSize

open fun getPreferredSize(widget: Widget, minimumSize: Requisition?, naturalSize: Requisition?)

Retrieves the minimum and natural size of a cell taking into account the widget’s preference for height-for-width management.

getRequestMode

open fun getRequestMode(): SizeRequestMode

Gets whether the cell renderer prefers a height-for-width layout or a width-for-height layout.

getState

open fun getState(widget: Widget? = null, cellState: CellRendererState): StateFlags

Translates the cell renderer state to GtkStateFlags, based on the cell renderer and widget sensitivity, and the given GtkCellRendererState.

isActivatable

open fun isActivatable(): Boolean

Checks whether the cell renderer can do something when activated.

setAlignment

open fun setAlignment(xalign: <Error class: unknown class>, yalign: <Error class: unknown class>)

Sets the renderer’s alignment within its available space.

setFixedSize

open fun setFixedSize(width: <Error class: unknown class>, height: <Error class: unknown class>)

Sets the renderer size to be explicit, independent of the properties set.

setPadding

open fun setPadding(xpad: <Error class: unknown class>, ypad: <Error class: unknown class>)

Sets the renderer’s padding.

startEditing

open fun startEditing(event: <Error class: unknown class>? = null, widget: Widget, path: String, backgroundArea: <Error class: unknown class>, cellArea: <Error class: unknown class>, flags: CellRendererState): CellEditable?

Starts editing the contents of this @cell, through a new GtkCellEditable widget created by the GtkCellRendererClass.start_editing virtual function.

stopEditing

open fun stopEditing(canceled: Boolean)

Informs the cell renderer that the editing is stopped. If @canceled is true, the cell renderer will emit the GtkCellRenderer::editing-canceled signal.