Back to Seed Clases

Gtk

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker Gtk.CellAreaContext

Class Gtk.CellAreaContext

Import line:	Gtk = imports.gi.Gtk;
GIR File:	Gtk-3.0.gir
C documentation:	GtkCellAreaContext
Class :	CellAreaContext
Extends:	GObject.Object

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 its 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().

Properties
Properties		Defined By
	area : Gtk.CellArea The GtkCellArea this context was created by The GtkCellArea this context was created by	Gtk.CellAreaContext
	minimum_height : gint32 read only 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(). 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().	Gtk.CellAreaContext
	minimum_width : gint32 read only 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(). 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().	Gtk.CellAreaContext
	natural_height : gint32 read only 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(). 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().	Gtk.CellAreaContext
	natural_width : gint32 read only 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(). 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().	Gtk.CellAreaContext
	parent_instance : GObject.Object read only	Gtk.CellAreaContext
	priv : Gtk.CellAreaContextPrivate read only	Gtk.CellAreaContext

Methods / Constructors
Method / Constructor		Defined By
	new Gtk.CellAreaContext (Object *properties) Create a new Gtk.CellAreaContext Create a new Gtk.CellAreaContext Parameters: Object properties*
	allocate (gint32 *width, gint32 height) : none Allocates a width and/or a height for all rows which are to be rendered with context. Allocates a width and/or a height for all rows which are to be rendered with context. Usually allocation is performed only horizontally or sometimes vertically since a group of rows are usually rendered side by side vertically or horizontally and share either the same width or the same height. Sometimes they are allocated in both horizontal and vertical orientations producing a homogeneous effect of the rows. This is generally the case for GtkTreeView* when GtkTreeView:fixed-height-mode is enabled. Since 3.0 Parameters: gint32 width Required (not null) the allocated width for all GtkTreeModel rows rendered with context, or -1. gint32 height Required (not null) the allocated height for all GtkTreeModel rows rendered with context, or -1. Returns: none	Gtk.CellAreaContext
	get_allocation () : Object Fetches the current allocation size for context. Fetches the current allocation size for context. If the context was not allocated in width or height, or if the context was recently reset with gtk_cell_area_context_reset(), the returned value will be -1. Returns: width: gint32 height: gint32	Gtk.CellAreaContext
	get_area () : Gtk.CellArea Fetches the GtkCellArea this context was created by. Fetches the GtkCellArea this context was created by. This is generally unneeded by layouting widgets; however it is important for the context implementation itself to fetch information about the area it is being used for. For instance at GtkCellAreaContextClass.allocate() time its important to know details about any cell spacing that the GtkCellArea is configured with in order to compute a proper allocation. Returns: Gtk.CellArea the GtkCellArea this context was created by.	Gtk.CellAreaContext
	get_preferred_height () : Object Gets the accumulative preferred height for all rows which have been requested with this context. Gets the accumulative preferred height for all rows which have been requested with this context. After gtk_cell_area_context_reset() is called and/or before ever requesting the size of a GtkCellArea, the returned values are -1. Returns: minimum_height: gint32 natural_height: gint32	Gtk.CellAreaContext
	get_preferred_height_for_width (gint32 *width) : Object Gets the accumulative preferred height for width* for all rows which have been requested for the same said width with this context. Gets the accumulative preferred height for width for all rows which have been requested for the same said width with this context. After gtk_cell_area_context_reset() is called and/or before ever requesting the size of a GtkCellArea, the returned values are -1. Parameters: gint32 width Required (not null) a proposed width for allocation Returns: minimum_height: gint32 natural_height: gint32	Gtk.CellAreaContext
	get_preferred_width () : Object Gets the accumulative preferred width for all rows which have been requested with this context. Gets the accumulative preferred width for all rows which have been requested with this context. After gtk_cell_area_context_reset() is called and/or before ever requesting the size of a GtkCellArea, the returned values are -1. Returns: minimum_width: gint32 natural_width: gint32	Gtk.CellAreaContext
	get_preferred_width_for_height (gint32 *height) : Object Gets the accumulative preferred width for height* for all rows which have been requested for the same said height with this context. Gets the accumulative preferred width for height for all rows which have been requested for the same said height with this context. After gtk_cell_area_context_reset() is called and/or before ever requesting the size of a GtkCellArea, the returned values are -1. Parameters: gint32 height Required (not null) a proposed height for allocation Returns: minimum_width: gint32 natural_width: gint32	Gtk.CellAreaContext
	push_preferred_height (gint32 *minimum_height, gint32 natural_height) : none Causes the minimum and/or natural height to grow if the new proposed sizes exceed the current minimum and natural height. Causes the minimum and/or natural height to grow if the new proposed sizes exceed the current minimum and natural height. This is used by GtkCellAreaContext* implementations during the request process over a series of GtkTreeModel rows to progressively push the requested height over a series of gtk_cell_area_get_preferred_height() requests. Parameters: gint32 minimum_height Required (not null) the proposed new minimum height for context gint32 natural_height Required (not null) the proposed new natural height for context Returns: none	Gtk.CellAreaContext
	push_preferred_width (gint32 *minimum_width, gint32 natural_width) : none Causes the minimum and/or natural width to grow if the new proposed sizes exceed the current minimum and natural width. Causes the minimum and/or natural width to grow if the new proposed sizes exceed the current minimum and natural width. This is used by GtkCellAreaContext* implementations during the request process over a series of GtkTreeModel rows to progressively push the requested width over a series of gtk_cell_area_get_preferred_width() requests. Parameters: gint32 minimum_width Required (not null) the proposed new minimum width for context gint32 natural_width Required (not null) the proposed new natural width for context Returns: none	Gtk.CellAreaContext
	reset () : none Resets any previously cached request and allocation data. Resets any previously cached request and allocation data. When underlying GtkTreeModel data changes its important to reset the context if the content size is allowed to shrink. If the content size is only allowed to grow (this is usually an option for views rendering large data stores as a measure of optimization), then only the row that changed or was inserted needs to be (re)requested with gtk_cell_area_get_preferred_width(). When the new overall size of the context requires that the allocated size changes (or whenever this allocation changes at all), the variable row sizes need to be re-requested for every row. For instance, if the rows are displayed all with the same width from top to bottom then a change in the allocated width necessitates a recalculation of all the displayed row heights using gtk_cell_area_get_preferred_height_for_width(). Since 3.0 Returns: none	Gtk.CellAreaContext

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gtk.CellArea Method	activate (CellAreaContext *context, Widget widget, RectangleInt cell_area, CellRendererState flags, gboolean edit_only) : gboolean Activates area*, usually by activating the currently focused cell, however some subclasses which embed widgets in the area can also activate a widget if it currently has the focus.
Gtk.CellArea Method	copy_context (CellAreaContext *context*) : Gtk.CellAreaContext This is sometimes needed for cases where rows need to share alignments in one orientation but may be separately grouped in the opposing orientation.
Gtk.CellArea Method	create_context () : Gtk.CellAreaContext Creates a GtkCellAreaContext to be used with area for all purposes.
Gtk.CellArea Method	event (CellAreaContext *context, Widget widget, Event event, RectangleInt cell_area, CellRendererState flags) : gint32 Delegates event handling to a GtkCellArea*.
Gtk.CellArea Method	foreach_alloc (CellAreaContext *context, Widget widget, RectangleInt cell_area, RectangleInt background_area, Function callback, void *callback_data) : none Calls callback* for every GtkCellRenderer in area with the allocated rectangle inside cell_area.
Gtk.CellArea Method	get_cell_allocation (CellAreaContext *context, Widget widget, CellRenderer renderer, RectangleInt cell_area) : cairo.RectangleInt Derives the allocation of renderer* inside area if area were to be renderered in cell_area.
Gtk.CellArea Method	get_cell_at_position (CellAreaContext *context, Widget widget, RectangleInt cell_area, gint32 x, gint32 y, Object out_values) : Gtk.CellRenderer Gets the GtkCellRenderer* at x and y coordinates inside area and optionally returns the full cell allocation for it inside cell_area.
Gtk.CellArea Method	get_preferred_height (CellAreaContext *context, Widget widget*) : Object Retrieves a cell area's initial minimum and natural height.
Gtk.CellArea Method	get_preferred_height_for_width (CellAreaContext *context, Widget widget, gint32 width) : Object Retrieves a cell area's minimum and natural height if it would be given the specified width*.
Gtk.CellArea Method	get_preferred_width (CellAreaContext *context, Widget widget*) : Object Retrieves a cell area's initial minimum and natural width.
Gtk.CellArea Method	get_preferred_width_for_height (CellAreaContext *context, Widget widget, gint32 height) : Object Retrieves a cell area's minimum and natural width if it would be given the specified height*.
Gtk.CellArea Method	render (CellAreaContext *context, Widget widget, Context cr, RectangleInt background_area, RectangleInt cell_area, CellRendererState flags, gboolean paint_focus) : none Renders area's cells according to area's layout onto widget* at the given coordinates.
Gtk.CellView Property	cell_area_context : Gtk.CellAreaContext The GtkCellAreaContext used to compute the geometry of the cell view.
Gtk.CellView Method	new Gtk.CellView.with_context (CellArea *area, CellAreaContext context*) : Gtk.Widget Create a new Gtk.CellView