Class

GtkCellAreaContext

Description [src]

class Gtk.CellAreaContext : GObject.Object
{
  /* No available fields */
}

The GtkCellAreaContext object is created by a given GtkCellArea implementation via its GtkCellAreaClass.create_context() virtual method and is used to store cell sizes and alignments for a series of GtkTreeModel rows that are requested and rendered in the same context.

GtkCellLayout widgets can create any number of contexts in which to request and render groups of data rows. However, it’s important that the same context which was used to request sizes for a given GtkTreeModel row also be used for the same row when calling other GtkCellArea APIs such as gtk_cell_area_render() and gtk_cell_area_event().

Hierarchy

hierarchy this GtkCellAreaContext ancestor_0 GObject ancestor_0--this

Ancestors

Instance methods

gtk_cell_area_context_allocate

Allocates a width and/or a height for all rows which are to be rendered with context.

gtk_cell_area_context_get_allocation

Fetches the current allocation size for context.

since: 3.0

gtk_cell_area_context_get_area

Fetches the GtkCellArea this context was created by.

since: 3.0

gtk_cell_area_context_get_preferred_height

Gets the accumulative preferred height for all rows which have been requested with this context.

since: 3.0

gtk_cell_area_context_get_preferred_height_for_width

Gets the accumulative preferred height for width for all rows which have been requested for the same said width with this context.

since: 3.0

gtk_cell_area_context_get_preferred_width

Gets the accumulative preferred width for all rows which have been requested with this context.

since: 3.0

gtk_cell_area_context_get_preferred_width_for_height

Gets the accumulative preferred width for height for all rows which have been requested for the same said height with this context.

since: 3.0

gtk_cell_area_context_push_preferred_height

Causes the minimum and/or natural height to grow if the new proposed sizes exceed the current minimum and natural height.

since: 3.0

gtk_cell_area_context_push_preferred_width

Causes the minimum and/or natural width to grow if the new proposed sizes exceed the current minimum and natural width.

since: 3.0

gtk_cell_area_context_reset

Resets any previously cached request and allocation data.

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Properties

Gtk.CellAreaContext:area

The GtkCellArea this context was created by.

since: 3.0

Gtk.CellAreaContext:minimum-height

The minimum height for the GtkCellArea in this context for all GtkTreeModel rows that this context was requested for using gtk_cell_area_get_preferred_height().

since: 3.0

Gtk.CellAreaContext:minimum-width

The minimum width for the GtkCellArea in this context for all GtkTreeModel rows that this context was requested for using gtk_cell_area_get_preferred_width().

since: 3.0

Gtk.CellAreaContext:natural-height

The natural height for the GtkCellArea in this context for all GtkTreeModel rows that this context was requested for using gtk_cell_area_get_preferred_height().

since: 3.0

Gtk.CellAreaContext:natural-width

The natural width for the GtkCellArea in this context for all GtkTreeModel rows that this context was requested for using gtk_cell_area_get_preferred_width().

since: 3.0

Signals

Signals inherited from GObject (1)
GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Class structure

struct GtkCellAreaContextClass {
  void (* allocate) (
    GtkCellAreaContext* context,
    gint width,
    gint height
  );
  void (* reset) (
    GtkCellAreaContext* context
  );
  void (* get_preferred_height_for_width) (
    GtkCellAreaContext* context,
    gint width,
    gint* minimum_height,
    gint* natural_height
  );
  void (* get_preferred_width_for_height) (
    GtkCellAreaContext* context,
    gint height,
    gint* minimum_width,
    gint* natural_width
  );
  void (* _gtk_reserved1) (
void
  );
  void (* _gtk_reserved2) (
void
  );
  void (* _gtk_reserved3) (
void
  );
  void (* _gtk_reserved4) (
void
  );
  void (* _gtk_reserved5) (
void
  );
  void (* _gtk_reserved6) (
void
  );
  
}

No description available.

Class members
allocate: void (* allocate) ( GtkCellAreaContext* context, gint width, gint height )

This tells the context that an allocation width or height (or both) have been decided for a group of rows. The context should store any allocations for internally aligned cells at this point so that they dont need to be recalculated at gtk_cell_area_render() time.

reset: void (* reset) ( GtkCellAreaContext* context )

Clear any previously stored information about requested and allocated sizes for the context.

get_preferred_height_for_width: void (* get_preferred_height_for_width) ( GtkCellAreaContext* context, gint width, gint* minimum_height, gint* natural_height )

Returns the aligned height for the given width that context must store while collecting sizes for it’s rows.

get_preferred_width_for_height: void (* get_preferred_width_for_height) ( GtkCellAreaContext* context, gint height, gint* minimum_width, gint* natural_width )

Returns the aligned width for the given height that context must store while collecting sizes for it’s rows.

_gtk_reserved1: void (* _gtk_reserved1) ( void )

No description available.

_gtk_reserved2: void (* _gtk_reserved2) ( void )

No description available.

_gtk_reserved3: void (* _gtk_reserved3) ( void )

No description available.

_gtk_reserved4: void (* _gtk_reserved4) ( void )

No description available.

_gtk_reserved5: void (* _gtk_reserved5) ( void )

No description available.

_gtk_reserved6: void (* _gtk_reserved6) ( void )

No description available.

Virtual methods

Gtk.CellAreaContextClass.allocate

Allocates a width and/or a height for all rows which are to be rendered with context.

Gtk.CellAreaContextClass.get_preferred_height_for_width

Gets the accumulative preferred height for width for all rows which have been requested for the same said width with this context.

since: 3.0

Gtk.CellAreaContextClass.get_preferred_width_for_height

Gets the accumulative preferred width for height for all rows which have been requested for the same said height with this context.

since: 3.0

Gtk.CellAreaContextClass.reset

Resets any previously cached request and allocation data.