diff options
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gtk3/GtkCellArea.html')
| -rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gtk3/GtkCellArea.html | 3065 |
1 files changed, 0 insertions, 3065 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkCellArea.html b/gtk+-mingw/share/gtk-doc/html/gtk3/GtkCellArea.html deleted file mode 100644 index 0f5553b..0000000 --- a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkCellArea.html +++ /dev/null @@ -1,3065 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>GtkCellArea</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> -<link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> -<link rel="up" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets"> -<link rel="prev" href="GtkCellLayout.html" title="GtkCellLayout"> -<link rel="next" href="GtkCellAreaBox.html" title="GtkCellAreaBox"> -<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> -<tr valign="middle"> -<td><a accesskey="p" href="GtkCellLayout.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> -<td><a accesskey="u" href="TreeWidgetObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> -<th width="100%" align="center">GTK+ 3 Reference Manual</th> -<td><a accesskey="n" href="GtkCellAreaBox.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#GtkCellArea.synopsis" class="shortcut">Top</a> - | - <a href="#GtkCellArea.description" class="shortcut">Description</a> - | - <a href="#GtkCellArea.object-hierarchy" class="shortcut">Object Hierarchy</a> - | - <a href="#GtkCellArea.implemented-interfaces" class="shortcut">Implemented Interfaces</a> - | - <a href="#GtkCellArea.properties" class="shortcut">Properties</a> - | - <a href="#GtkCellArea.signals" class="shortcut">Signals</a> -</td></tr> -</table> -<div class="refentry"> -<a name="GtkCellArea"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="GtkCellArea.top_of_page"></a>GtkCellArea</span></h2> -<p>GtkCellArea — An abstract class for laying out GtkCellRenderers</p> -</td> -<td valign="top" align="right"></td> -</tr></table></div> -<div class="refsynopsisdiv"> -<a name="GtkCellArea.synopsis"></a><h2>Synopsis</h2> -<pre class="synopsis"> -#include <gtk/gtk.h> - -struct <a class="link" href="GtkCellArea.html#GtkCellArea-struct" title="struct GtkCellArea">GtkCellArea</a>; -struct <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass">GtkCellAreaClass</a>; -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="GtkCellArea.html#GtkCellCallback" title="GtkCellCallback ()">*GtkCellCallback</a>) (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()">*GtkCellAllocCallback</a>) (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_background</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>); -#define <a class="link" href="GtkCellArea.html#GTK-CELL-AREA-WARN-INVALID-CELL-PROPERTY-ID:CAPS" title="GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID()">GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID</a>(object, - property_id, - pspec) -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-add" title="gtk_cell_area_add ()">gtk_cell_area_add</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-remove" title="gtk_cell_area_remove ()">gtk_cell_area_remove</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-has-renderer" title="gtk_cell_area_has_renderer ()">gtk_cell_area_has_renderer</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach" title="gtk_cell_area_foreach ()">gtk_cell_area_foreach</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellCallback" title="GtkCellCallback ()"><span class="type">GtkCellCallback</span></a> callback</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach-alloc" title="gtk_cell_area_foreach_alloc ()">gtk_cell_area_foreach_alloc</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()"><span class="type">GtkCellAllocCallback</span></a> callback</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-event" title="gtk_cell_area_event ()">gtk_cell_area_event</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-render" title="gtk_cell_area_render ()">gtk_cell_area_render</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> paint_focus</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-get-cell-allocation" title="gtk_cell_area_get_cell_allocation ()">gtk_cell_area_get_cell_allocation</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *allocation</code></em>); -<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-get-cell-at-position" title="gtk_cell_area_get_cell_at_position ()">gtk_cell_area_get_cell_at_position</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *alloc_area</code></em>); -<a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="returnvalue">GtkCellAreaContext</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-create-context" title="gtk_cell_area_create_context ()">gtk_cell_area_create_context</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>); -<a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="returnvalue">GtkCellAreaContext</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-copy-context" title="gtk_cell_area_copy_context ()">gtk_cell_area_copy_context</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>); -<a class="link" href="GtkWidget.html#GtkSizeRequestMode" title="enum GtkSizeRequestMode"><span class="returnvalue">GtkSizeRequestMode</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-get-request-mode" title="gtk_cell_area_get_request_mode ()">gtk_cell_area_get_request_mode</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()">gtk_cell_area_get_preferred_width</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height-for-width" title="gtk_cell_area_get_preferred_height_for_width ()">gtk_cell_area_get_preferred_height_for_width</a> - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height" title="gtk_cell_area_get_preferred_height ()">gtk_cell_area_get_preferred_height</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width-for-height" title="gtk_cell_area_get_preferred_width_for_height ()">gtk_cell_area_get_preferred_width_for_height</a> - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-get-current-path-string" title="gtk_cell_area_get_current_path_string ()">gtk_cell_area_get_current_path_string</a> - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-apply-attributes" title="gtk_cell_area_apply_attributes ()">gtk_cell_area_apply_attributes</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *tree_model</code></em>, - <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expander</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expanded</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-attribute-connect" title="gtk_cell_area_attribute_connect ()">gtk_cell_area_attribute_connect</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-attribute-disconnect" title="gtk_cell_area_attribute_disconnect ()">gtk_cell_area_attribute_disconnect</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-class-install-cell-property" title="gtk_cell_area_class_install_cell_property ()">gtk_cell_area_class_install_cell_property</a> - (<em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> *aclass</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-class-find-cell-property" title="gtk_cell_area_class_find_cell_property ()">gtk_cell_area_class_find_cell_property</a> - (<em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> *aclass</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> ** <a class="link" href="GtkCellArea.html#gtk-cell-area-class-list-cell-properties" title="gtk_cell_area_class_list_cell_properties ()">gtk_cell_area_class_list_cell_properties</a> - (<em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> *aclass</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-add-with-properties" title="gtk_cell_area_add_with_properties ()">gtk_cell_area_add_with_properties</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>, - <em class="parameter"><code>...</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set" title="gtk_cell_area_cell_set ()">gtk_cell_area_cell_set</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>, - <em class="parameter"><code>...</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-get" title="gtk_cell_area_cell_get ()">gtk_cell_area_cell_get</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>, - <em class="parameter"><code>...</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set-valist" title="gtk_cell_area_cell_set_valist ()">gtk_cell_area_cell_set_valist</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>, - <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-get-valist" title="gtk_cell_area_cell_get_valist ()">gtk_cell_area_cell_get_valist</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>, - <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set-property" title="gtk_cell_area_cell_set_property ()">gtk_cell_area_cell_set_property</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-get-property" title="gtk_cell_area_cell_get_property ()">gtk_cell_area_cell_get_property</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-is-activatable" title="gtk_cell_area_is_activatable ()">gtk_cell_area_is_activatable</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-activate" title="gtk_cell_area_activate ()">gtk_cell_area_activate</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> edit_only</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-focus" title="gtk_cell_area_focus ()">gtk_cell_area_focus</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a> direction</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-set-focus-cell" title="gtk_cell_area_set_focus_cell ()">gtk_cell_area_set_focus_cell</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>); -<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-get-focus-cell" title="gtk_cell_area_get_focus_cell ()">gtk_cell_area_get_focus_cell</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-add-focus-sibling" title="gtk_cell_area_add_focus_sibling ()">gtk_cell_area_add_focus_sibling</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *sibling</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-remove-focus-sibling" title="gtk_cell_area_remove_focus_sibling ()">gtk_cell_area_remove_focus_sibling</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *sibling</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-is-focus-sibling" title="gtk_cell_area_is_focus_sibling ()">gtk_cell_area_is_focus_sibling</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *sibling</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-get-focus-siblings" title="gtk_cell_area_get_focus_siblings ()">gtk_cell_area_get_focus_siblings</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>); -<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-get-focus-from-sibling" title="gtk_cell_area_get_focus_from_sibling ()">gtk_cell_area_get_focus_from_sibling</a> - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>); -<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-get-edited-cell" title="gtk_cell_area_get_edited_cell ()">gtk_cell_area_get_edited_cell</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>); -<a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="returnvalue">GtkCellEditable</span></a> * <a class="link" href="GtkCellArea.html#gtk-cell-area-get-edit-widget" title="gtk_cell_area_get_edit_widget ()">gtk_cell_area_get_edit_widget</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkCellArea.html#gtk-cell-area-activate-cell" title="gtk_cell_area_activate_cell ()">gtk_cell_area_activate_cell</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-stop-editing" title="gtk_cell_area_stop_editing ()">gtk_cell_area_stop_editing</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> canceled</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-inner-cell-area" title="gtk_cell_area_inner_cell_area ()">gtk_cell_area_inner_cell_area</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *inner_area</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkCellArea.html#gtk-cell-area-request-renderer" title="gtk_cell_area_request_renderer ()">gtk_cell_area_request_renderer</a> (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> for_size</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_size</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_size</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="GtkCellArea.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="synopsis"> - <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> - +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> - +----GtkCellArea - +----<a class="link" href="GtkCellAreaBox.html" title="GtkCellAreaBox">GtkCellAreaBox</a> -</pre> -</div> -<div class="refsect1"> -<a name="GtkCellArea.implemented-interfaces"></a><h2>Implemented Interfaces</h2> -<p> -GtkCellArea implements - <a class="link" href="GtkCellLayout.html" title="GtkCellLayout">GtkCellLayout</a> and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p> -</div> -<div class="refsect1"> -<a name="GtkCellArea.properties"></a><h2>Properties</h2> -<pre class="synopsis"> - "<a class="link" href="GtkCellArea.html#GtkCellArea--edit-widget" title='The "edit-widget" property'>edit-widget</a>" <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a>* : Read - "<a class="link" href="GtkCellArea.html#GtkCellArea--edited-cell" title='The "edited-cell" property'>edited-cell</a>" <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>* : Read - "<a class="link" href="GtkCellArea.html#GtkCellArea--focus-cell" title='The "focus-cell" property'>focus-cell</a>" <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>* : Read / Write -</pre> -</div> -<div class="refsect1"> -<a name="GtkCellArea.signals"></a><h2>Signals</h2> -<pre class="synopsis"> - "<a class="link" href="GtkCellArea.html#GtkCellArea-add-editable" title='The "add-editable" signal'>add-editable</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a> - "<a class="link" href="GtkCellArea.html#GtkCellArea-apply-attributes" title='The "apply-attributes" signal'>apply-attributes</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a> - "<a class="link" href="GtkCellArea.html#GtkCellArea-focus-changed" title='The "focus-changed" signal'>focus-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a> - "<a class="link" href="GtkCellArea.html#GtkCellArea-remove-editable" title='The "remove-editable" signal'>remove-editable</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a> -</pre> -</div> -<div class="refsect1"> -<a name="GtkCellArea.description"></a><h2>Description</h2> -<p> -The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> is an abstract class for <a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> widgets -(also referred to as "layouting widgets") to interface with an -arbitrary number of <a href="GtkCellRenderer.html"><span class="type">GtkCellRenderers</span></a> and interact with the user -for a given <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> row. -</p> -<p> -The cell area handles events, focus navigation, drawing and -size requests and allocations for a given row of data. -</p> -<p> -Usually users dont have to interact with the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> directly -unless they are implementing a cell-layouting widget themselves. -</p> -<p> -</p> -<div class="refsect2"> -<a name="cell-area-geometry-management"></a><h3>Requesting area sizes</h3> -<p> -As outlined in <a class="link" href="GtkWidget.html#geometry-management" title="Height-for-width Geometry Management">GtkWidget's -geometry management section</a>, GTK+ uses a height-for-width -geometry management system to compute the sizes of widgets and user -interfaces. <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> uses the same semantics to calculate the -size of an area for an arbitrary number of <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows. -</p> -<p> -When requesting the size of a cell area one needs to calculate -the size for a handful of rows, and this will be done differently by -different layouting widgets. For instance a <a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> -always lines up the areas from top to bottom while a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> -on the other hand might enforce that all areas received the same -width and wrap the areas around, requesting height for more cell -areas when allocated less width. -</p> -<p> -It's also important for areas to maintain some cell -alignments with areas rendered for adjacent rows (cells can -appear "columnized" inside an area even when the size of -cells are different in each row). For this reason the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -uses a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> object to store the alignments -and sizes along the way (as well as the overall largest minimum -and natural size for all the rows which have been calculated -with the said context). -</p> -<p> -The <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> is an opaque object specific to the -<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> which created it (see <a class="link" href="GtkCellArea.html#gtk-cell-area-create-context" title="gtk_cell_area_create_context ()"><code class="function">gtk_cell_area_create_context()</code></a>). -The owning cell-layouting widget can create as many contexts as -it wishes to calculate sizes of rows which should receive the -same size in at least one orientation (horizontally or vertically), -However, it's important that the same <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> which -was used to request the sizes for a given <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> row be -used when rendering or processing events for that row. -</p> -<p> -In order to request the width of all the rows at the root level -of a <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> one would do the following: -</p> -<div class="example"> -<a name="id1036754"></a><p class="title"><b>Example 66. Requesting the width of a handful of GtkTreeModel rows</b></p> -<div class="example-contents"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkTreeIter</span><span class="normal"> iter</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> minimum_width</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> natural_width</span><span class="symbol">;</span> - -<span class="normal">valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get-iter-first">gtk_tree_model_get_iter_first</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span> -<span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">valid</span><span class="symbol">)</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-apply-attributes">gtk_cell_area_apply_attributes</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span> -<span class="normal"> </span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-get-preferred-width">gtk_cell_area_get_preferred_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> context</span><span class="symbol">,</span><span class="normal"> widget</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span> - -<span class="normal"> valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-next">gtk_tree_model_iter_next</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="function"><a href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-width">gtk_cell_area_context_get_preferred_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">minimum_width</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">natural_width</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -</div> -<p><br class="example-break"> -Note that in this example it's not important to observe the -returned minimum and natural width of the area for each row -unless the cell-layouting object is actually interested in the -widths of individual rows. The overall width is however stored -in the accompanying <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> object and can be consulted -at any time. -</p> -<p> -This can be useful since <a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> widgets usually have to -support requesting and rendering rows in treemodels with an -exceedingly large amount of rows. The <a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> widget in -that case would calculate the required width of the rows in an -idle or timeout source (see <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-timeout-add"><code class="function">g_timeout_add()</code></a>) and when the widget -is requested its actual width in <a class="link" href="GtkWidget.html#GtkWidgetClass.get-preferred-width"><code class="function">GtkWidgetClass.get_preferred_width()</code></a> -it can simply consult the width accumulated so far in the -<a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> object. -</p> -<p> -A simple example where rows are rendered from top to bottom and -take up the full width of the layouting widget would look like: -</p> -<div class="example"> -<a name="id1036823"></a><p class="title"><b>Example 67. A typical <code class="function">get_preferred_width()</code> implementation</b></p> -<div class="example-contents"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span> -<span class="function">foo_get_preferred_width</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span> -<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">minimum_size</span><span class="symbol">,</span> -<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">natural_size</span><span class="symbol">)</span> -<span class="cbracket">{</span> -<span class="normal"> </span><span class="usertype">Foo</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">foo </span><span class="symbol">=</span><span class="normal"> </span><span class="function">FOO</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span> -<span class="normal"> </span><span class="usertype">FooPrivate</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">priv </span><span class="symbol">=</span><span class="normal"> foo</span><span class="symbol">-></span><span class="normal">priv</span><span class="symbol">;</span> - -<span class="normal"> </span><span class="function">foo_ensure_at_least_one_handfull_of_rows_have_been_requested</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">foo</span><span class="symbol">);</span> - -<span class="normal"> </span><span class="function"><a href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-width">gtk_cell_area_context_get_preferred_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-></span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> minimum_size</span><span class="symbol">,</span><span class="normal"> natural_size</span><span class="symbol">);</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -</div> -<p><br class="example-break"> -In the above example the Foo widget has to make sure that some -row sizes have been calculated (the amount of rows that Foo judged -was appropriate to request space for in a single timeout iteration) -before simply returning the amount of space required by the area via -the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>. -</p> -<p> -Requesting the height for width (or width for height) of an area is -a similar task except in this case the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> does not -store the data (actually, it does not know how much space the layouting -widget plans to allocate it for every row. It's up to the layouting -widget to render each row of data with the appropriate height and -width which was requested by the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>). -</p> -<p> -In order to request the height for width of all the rows at the -root level of a <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> one would do the following: -</p> -<div class="example"> -<a name="id1036883"></a><p class="title"><b>Example 68. Requesting the height for width of a handful of GtkTreeModel rows</b></p> -<div class="example-contents"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkTreeIter</span><span class="normal"> iter</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> minimum_height</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> natural_height</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> full_minimum_height </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> full_natural_height </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span> - -<span class="normal">valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get-iter-first">gtk_tree_model_get_iter_first</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span> -<span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">valid</span><span class="symbol">)</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-apply-attributes">gtk_cell_area_apply_attributes</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span> -<span class="normal"> </span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-get-preferred-height-for-width">gtk_cell_area_get_preferred_height_for_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> context</span><span class="symbol">,</span><span class="normal"> widget</span><span class="symbol">,</span> -<span class="normal"> width</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">minimum_height</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">natural_height</span><span class="symbol">);</span> - -<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">width_is_for_allocation</span><span class="symbol">)</span> -<span class="normal"> </span><span class="function">cache_row_height</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> minimum_height</span><span class="symbol">,</span><span class="normal"> natural_height</span><span class="symbol">);</span> - -<span class="normal"> full_minimum_height </span><span class="symbol">+=</span><span class="normal"> minimum_height</span><span class="symbol">;</span> -<span class="normal"> full_natural_height </span><span class="symbol">+=</span><span class="normal"> natural_height</span><span class="symbol">;</span> - -<span class="normal"> valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-next">gtk_tree_model_iter_next</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span> -<span class="normal"> </span><span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -</div> -<p><br class="example-break"> -Note that in the above example we would need to cache the heights -returned for each row so that we would know what sizes to render the -areas for each row. However we would only want to really cache the -heights if the request is intended for the layouting widgets real -allocation. -</p> -<p> -In some cases the layouting widget is requested the height for an -arbitrary for_width, this is a special case for layouting widgets -who need to request size for tens of thousands of rows. For this -case it's only important that the layouting widget calculate -one reasonably sized chunk of rows and return that height -synchronously. The reasoning here is that any layouting widget is -at least capable of synchronously calculating enough height to fill -the screen height (or scrolled window height) in response to a single -call to <a class="link" href="GtkWidget.html#GtkWidgetClass.get-preferred-height-for-width"><code class="function">GtkWidgetClass.get_preferred_height_for_width()</code></a>. Returning -a perfect height for width that is larger than the screen area is -inconsequential since after the layouting receives an allocation -from a scrolled window it simply continues to drive the the scrollbar -values while more and more height is required for the row heights -that are calculated in the background. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="cell-area-rendering"></a><h3>Rendering Areas</h3> -<p> -Once area sizes have been aquired at least for the rows in the -visible area of the layouting widget they can be rendered at -<a class="link" href="GtkWidget.html#GtkWidgetClass.draw"><code class="function">GtkWidgetClass.draw()</code></a> time. -</p> -<p> -A crude example of how to render all the rows at the root level -runs as follows: -</p> -<div class="example"> -<a name="id1036947"></a><p class="title"><b>Example 69. Requesting the width of a handful of GtkTreeModel rows</b></p> -<div class="example-contents"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkAllocation</span><span class="normal"> allocation</span><span class="symbol">;</span> -<span class="usertype">GdkRectangle</span><span class="normal"> cell_area </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span> -<span class="usertype">GtkTreeIter</span><span class="normal"> iter</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> minimum_width</span><span class="symbol">;</span> -<span class="usertype">gint</span><span class="normal"> natural_width</span><span class="symbol">;</span> - -<span class="function"><a href="GtkWidget.html#gtk-widget-get-allocation">gtk_widget_get_allocation</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">allocation</span><span class="symbol">);</span> -<span class="normal">cell_area</span><span class="symbol">.</span><span class="normal">width </span><span class="symbol">=</span><span class="normal"> allocation</span><span class="symbol">.</span><span class="normal">width</span><span class="symbol">;</span> - -<span class="normal">valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get-iter-first">gtk_tree_model_get_iter_first</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span> -<span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">valid</span><span class="symbol">)</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> cell_area</span><span class="symbol">.</span><span class="normal">height </span><span class="symbol">=</span><span class="normal"> </span><span class="function">get_cached_height_for_row</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">iter</span><span class="symbol">);</span> - -<span class="normal"> </span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-apply-attributes">gtk_cell_area_apply_attributes</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span> -<span class="normal"> </span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-render">gtk_cell_area_render</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> context</span><span class="symbol">,</span><span class="normal"> widget</span><span class="symbol">,</span><span class="normal"> cr</span><span class="symbol">,</span> -<span class="normal"> </span><span class="symbol">&</span><span class="normal">cell_area</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">cell_area</span><span class="symbol">,</span><span class="normal"> state_flags</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span> - -<span class="normal"> cell_area</span><span class="symbol">.</span><span class="normal">y </span><span class="symbol">+=</span><span class="normal"> cell_area</span><span class="symbol">.</span><span class="normal">height</span><span class="symbol">;</span> - -<span class="normal"> valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-next">gtk_tree_model_iter_next</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span> -<span class="normal"> </span><span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -</div> -<p><br class="example-break"> -Note that the cached height in this example really depends on how -the layouting widget works. The layouting widget might decide to -give every row its minimum or natural height or, if the model content -is expected to fit inside the layouting widget without scrolling, it -would make sense to calculate the allocation for each row at -<a class="link" href="GtkWidget.html#GtkWidget-size-allocate" title='The "size-allocate" signal'><span class="type">"size-allocate"</span></a> time using <a class="link" href="GtkWidget.html#gtk-distribute-natural-allocation" title="gtk_distribute_natural_allocation ()"><code class="function">gtk_distribute_natural_allocation()</code></a>. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="cell-area-events-and-focus"></a><h3>Handling Events and Driving Keyboard Focus</h3> -<p> -Passing events to the area is as simple as handling events on any -normal widget and then passing them to the <a class="link" href="GtkCellArea.html#gtk-cell-area-event" title="gtk_cell_area_event ()"><code class="function">gtk_cell_area_event()</code></a> -API as they come in. Usually <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> is only interested in -button events, however some customized derived areas can be implemented -who are interested in handling other events. Handling an event can -trigger the <a class="link" href="GtkCellArea.html#GtkCellArea-focus-changed" title='The "focus-changed" signal'><span class="type">"focus-changed"</span></a> signal to fire; as well as -<a class="link" href="GtkCellArea.html#GtkCellArea-add-editable" title='The "add-editable" signal'><span class="type">"add-editable"</span></a> in the case that an editable cell was -clicked and needs to start editing. You can call -<a class="link" href="GtkCellArea.html#gtk-cell-area-stop-editing" title="gtk_cell_area_stop_editing ()"><code class="function">gtk_cell_area_stop_editing()</code></a> at any time to cancel any cell editing -that is currently in progress. -</p> -<p> -The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> drives keyboard focus from cell to cell in a way -similar to <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>. For layouting widgets that support giving -focus to cells it's important to remember to pass <a class="link" href="GtkCellRenderer.html#GTK-CELL-RENDERER-FOCUSED:CAPS"><code class="literal">GTK_CELL_RENDERER_FOCUSED</code></a> -to the area functions for the row that has focus and to tell the -area to paint the focus at render time. -</p> -<p> -Layouting widgets that accept focus on cells should implement the -<a class="link" href="GtkWidget.html#GtkWidgetClass.focus"><code class="function">GtkWidgetClass.focus()</code></a> virtual method. The layouting widget is always -responsible for knowing where <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> rows are rendered inside -the widget, so at <a class="link" href="GtkWidget.html#GtkWidgetClass.focus"><code class="function">GtkWidgetClass.focus()</code></a> time the layouting widget -should use the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> methods to navigate focus inside the area -and then observe the GtkDirectionType to pass the focus to adjacent -rows and areas. -</p> -<p> -A basic example of how the <a class="link" href="GtkWidget.html#GtkWidgetClass.focus"><code class="function">GtkWidgetClass.focus()</code></a> virtual method -should be implemented: -</p> -<div class="example"> -<a name="id1037103"></a><p class="title"><b>Example 70. Implementing keyboard focus navigation</b></p> -<div class="example-contents"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a></span> -<span class="function">foo_focus</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span> -<span class="normal"> </span><span class="usertype">GtkDirectionType</span><span class="normal"> direction</span><span class="symbol">)</span> -<span class="cbracket">{</span> -<span class="normal"> </span><span class="usertype">Foo</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">foo </span><span class="symbol">=</span><span class="normal"> </span><span class="function">FOO</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span> -<span class="normal"> </span><span class="usertype">FooPrivate</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">priv </span><span class="symbol">=</span><span class="normal"> foo</span><span class="symbol">-></span><span class="normal">priv</span><span class="symbol">;</span> -<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> focus_row</span><span class="symbol">;</span> -<span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> have_focus </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span> - -<span class="normal"> focus_row </span><span class="symbol">=</span><span class="normal"> priv</span><span class="symbol">-></span><span class="normal">focus_row</span><span class="symbol">;</span> - -<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="GtkWidget.html#gtk-widget-has-focus">gtk_widget_has_focus</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">))</span> -<span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-grab-focus">gtk_widget_grab_focus</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span> - -<span class="normal"> valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-nth-child">gtk_tree_model_iter_nth_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-></span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> priv</span><span class="symbol">-></span><span class="normal">focus_row</span><span class="symbol">);</span> -<span class="normal"> </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">valid</span><span class="symbol">)</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-apply-attributes">gtk_cell_area_apply_attributes</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-></span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> priv</span><span class="symbol">-></span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span> - -<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkCellArea.html#gtk-cell-area-focus">gtk_cell_area_focus</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-></span><span class="normal">area</span><span class="symbol">,</span><span class="normal"> direction</span><span class="symbol">))</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> priv</span><span class="symbol">-></span><span class="normal">focus_row </span><span class="symbol">=</span><span class="normal"> focus_row</span><span class="symbol">;</span> -<span class="normal"> have_focus </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span> -<span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="keyword">else</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">direction </span><span class="symbol">==</span><span class="normal"> GTK_DIR_RIGHT </span><span class="symbol">||</span> -<span class="normal"> direction </span><span class="symbol">==</span><span class="normal"> GTK_DIR_LEFT</span><span class="symbol">)</span> -<span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span> -<span class="normal"> </span><span class="keyword">else</span><span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">direction </span><span class="symbol">==</span><span class="normal"> GTK_DIR_UP </span><span class="symbol">||</span> -<span class="normal"> direction </span><span class="symbol">==</span><span class="normal"> GTK_DIR_TAB_BACKWARD</span><span class="symbol">)</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">focus_row </span><span class="symbol">==</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span> -<span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span> -<span class="normal"> </span><span class="keyword">else</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> focus_row</span><span class="symbol">--;</span> -<span class="normal"> valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-nth-child">gtk_tree_model_iter_nth_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-></span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> focus_row</span><span class="symbol">);</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="keyword">else</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">focus_row </span><span class="symbol">==</span><span class="normal"> last_row</span><span class="symbol">)</span> -<span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span> -<span class="normal"> </span><span class="keyword">else</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> focus_row</span><span class="symbol">++;</span> -<span class="normal"> valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-next">gtk_tree_model_iter_next</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-></span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="keyword">return</span><span class="normal"> have_focus</span><span class="symbol">;</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -</div> -<p><br class="example-break"> -Note that the layouting widget is responsible for matching the -GtkDirectionType values to the way it lays out its cells. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="cell-properties"></a><h3>Cell Properties</h3> -<p> -The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> introduces <span class="emphasis"><em>cell properties</em></span> -for <a href="GtkCellRenderer.html"><span class="type">GtkCellRenderers</span></a> in very much the same way that <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> -introduces <a class="link" href="GtkContainer.html#child-properties" title="Child properties">child properties</a> -for <a href="GtkWidget.html"><span class="type">GtkWidgets</span></a>. This provides some general interfaces for defining -the relationship cell areas have with their cells. For instance in a -<a class="link" href="GtkCellAreaBox.html" title="GtkCellAreaBox"><span class="type">GtkCellAreaBox</span></a> a cell might "expand" and receive extra space when -the area is allocated more than its full natural request, or a cell -might be configured to "align" with adjacent rows which were requested -and rendered with the same <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>. -</p> -<p> -Use <a class="link" href="GtkCellArea.html#gtk-cell-area-class-install-cell-property" title="gtk_cell_area_class_install_cell_property ()"><code class="function">gtk_cell_area_class_install_cell_property()</code></a> to install cell -properties for a cell area class and <a class="link" href="GtkCellArea.html#gtk-cell-area-class-find-cell-property" title="gtk_cell_area_class_find_cell_property ()"><code class="function">gtk_cell_area_class_find_cell_property()</code></a> -or <a class="link" href="GtkCellArea.html#gtk-cell-area-class-list-cell-properties" title="gtk_cell_area_class_list_cell_properties ()"><code class="function">gtk_cell_area_class_list_cell_properties()</code></a> to get information about -existing cell properties. -</p> -<p> -To set the value of a cell property, use <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set-property" title="gtk_cell_area_cell_set_property ()"><code class="function">gtk_cell_area_cell_set_property()</code></a>, -<a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set" title="gtk_cell_area_cell_set ()"><code class="function">gtk_cell_area_cell_set()</code></a> or <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set-valist" title="gtk_cell_area_cell_set_valist ()"><code class="function">gtk_cell_area_cell_set_valist()</code></a>. To obtain -the value of a cell property, use <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-get-property" title="gtk_cell_area_cell_get_property ()"><code class="function">gtk_cell_area_cell_get_property()</code></a>, -<a class="link" href="GtkCellArea.html#gtk-cell-area-cell-get" title="gtk_cell_area_cell_get ()"><code class="function">gtk_cell_area_cell_get()</code></a> or <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-get-valist" title="gtk_cell_area_cell_get_valist ()"><code class="function">gtk_cell_area_cell_get_valist()</code></a>. -</p> -</div> -<p> -</p> -</div> -<div class="refsect1"> -<a name="GtkCellArea.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="GtkCellArea-struct"></a><h3>struct GtkCellArea</h3> -<pre class="programlisting">struct GtkCellArea;</pre> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellAreaClass"></a><h3>struct GtkCellAreaClass</h3> -<pre class="programlisting">struct GtkCellAreaClass { - /* Basic methods */ - void (* add) (GtkCellArea *area, - GtkCellRenderer *renderer); - void (* remove) (GtkCellArea *area, - GtkCellRenderer *renderer); - void (* foreach) (GtkCellArea *area, - GtkCellCallback callback, - gpointer callback_data); - void (* foreach_alloc) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - const GdkRectangle *cell_area, - const GdkRectangle *background_area, - GtkCellAllocCallback callback, - gpointer callback_data); - gint (* event) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - GdkEvent *event, - const GdkRectangle *cell_area, - GtkCellRendererState flags); - void (* render) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - cairo_t *cr, - const GdkRectangle *background_area, - const GdkRectangle *cell_area, - GtkCellRendererState flags, - gboolean paint_focus); - void (* apply_attributes) (GtkCellArea *area, - GtkTreeModel *tree_model, - GtkTreeIter *iter, - gboolean is_expander, - gboolean is_expanded); - - /* Geometry */ - GtkCellAreaContext *(* create_context) (GtkCellArea *area); - GtkCellAreaContext *(* copy_context) (GtkCellArea *area, - GtkCellAreaContext *context); - GtkSizeRequestMode (* get_request_mode) (GtkCellArea *area); - void (* get_preferred_width) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - gint *minimum_width, - gint *natural_width); - void (* get_preferred_height_for_width) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - gint width, - gint *minimum_height, - gint *natural_height); - void (* get_preferred_height) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - gint *minimum_height, - gint *natural_height); - void (* get_preferred_width_for_height) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - gint height, - gint *minimum_width, - gint *natural_width); - - /* Cell Properties */ - void (* set_cell_property) (GtkCellArea *area, - GtkCellRenderer *renderer, - guint property_id, - const GValue *value, - GParamSpec *pspec); - void (* get_cell_property) (GtkCellArea *area, - GtkCellRenderer *renderer, - guint property_id, - GValue *value, - GParamSpec *pspec); - - /* Focus */ - gboolean (* focus) (GtkCellArea *area, - GtkDirectionType direction); - gboolean (* is_activatable) (GtkCellArea *area); - gboolean (* activate) (GtkCellArea *area, - GtkCellAreaContext *context, - GtkWidget *widget, - const GdkRectangle *cell_area, - GtkCellRendererState flags, - gboolean edit_only); -}; -</pre> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.add"></a>add</code></em> ()</span></p></td> -<td>adds a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to the area.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.remove"></a>remove</code></em> ()</span></p></td> -<td>removes a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> from the area.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.foreach"></a>foreach</code></em> ()</span></p></td> -<td>calls the <a class="link" href="GtkCellArea.html#GtkCellCallback" title="GtkCellCallback ()"><span class="type">GtkCellCallback</span></a> function on every <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> in -the area with the provided user data until the callback returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.foreach-alloc"></a>foreach_alloc</code></em> ()</span></p></td> -<td>Calls the <a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()"><span class="type">GtkCellAllocCallback</span></a> function on every -<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> in the area with the allocated area for the cell -and the provided user data until the callback returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.event"></a>event</code></em> ()</span></p></td> -<td>Handle an event in the area, this is generally used to activate -a cell at the event location for button events but can also be used -to generically pass events to <a href="GtkWidget.html"><span class="type">GtkWidgets</span></a> drawn onto the area.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.render"></a>render</code></em> ()</span></p></td> -<td>Actually render the area's cells to the specified rectangle, -<em class="parameter"><code>background_area</code></em> should be correctly distributed to the cells -corresponding background areas.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.apply-attributes"></a>apply_attributes</code></em> ()</span></p></td> -<td>Apply the cell attributes to the cells. This is -implemented as a signal and generally <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> subclasses don't -need to implement it since it is handled by the base class.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.create-context"></a>create_context</code></em> ()</span></p></td> -<td>Creates and returns a class specific <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> -to store cell alignment and allocation details for a said <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -class.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.copy-context"></a>copy_context</code></em> ()</span></p></td> -<td>Creates a new <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> in the same state as -the passed <em class="parameter"><code>context</code></em> with any cell alignment data and allocations intact.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.get-request-mode"></a>get_request_mode</code></em> ()</span></p></td> -<td>This allows an area to tell its layouting widget whether -it prefers to be allocated in <a class="link" href="GtkWidget.html#GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS"><code class="literal">GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</code></a> or -<a class="link" href="GtkWidget.html#GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><code class="literal">GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</code></a> mode.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-width"></a>get_preferred_width</code></em> ()</span></p></td> -<td>Calculates the minimum and natural width of the -areas cells with the current attributes applied while considering -the particular layouting details of the said <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>. While -requests are performed over a series of rows, alignments and overall -minimum and natural sizes should be stored in the corresponding -<a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-height-for-width"></a>get_preferred_height_for_width</code></em> ()</span></p></td> -<td>Calculates the minimum and natural height -for the area if the passed <em class="parameter"><code>context</code></em> would be allocated the given width. -When implementing this virtual method it is safe to assume that <em class="parameter"><code>context</code></em> -has already stored the aligned cell widths for every <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> row -that <em class="parameter"><code>context</code></em> will be allocated for since this information was stored -at <a class="link" href="GtkCellArea.html#GtkCellAreaClass.get-preferred-width"><code class="function">GtkCellAreaClass.get_preferred_width()</code></a> time. This virtual method -should also store any necessary alignments of cell heights for the -case that the context is allocated a height.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-height"></a>get_preferred_height</code></em> ()</span></p></td> -<td>Calculates the minimum and natural height of the -areas cells with the current attributes applied. Essentially this is -the same as <a class="link" href="GtkCellArea.html#GtkCellAreaClass.get-preferred-width"><code class="function">GtkCellAreaClass.get_preferred_width()</code></a> only for areas -that are being requested as <a class="link" href="GtkWidget.html#GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><code class="literal">GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-width-for-height"></a>get_preferred_width_for_height</code></em> ()</span></p></td> -<td>Calculates the minimum and natural width -for the area if the passed <em class="parameter"><code>context</code></em> would be allocated the given -height. The same as <a class="link" href="GtkCellArea.html#GtkCellAreaClass.get-preferred-height-for-width"><code class="function">GtkCellAreaClass.get_preferred_height_for_width()</code></a> -only for handling requests in the <a class="link" href="GtkWidget.html#GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><code class="literal">GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</code></a> -mode.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.set-cell-property"></a>set_cell_property</code></em> ()</span></p></td> -<td>This should be implemented to handle changes in child -cell properties for a given <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> that were previously -installed on the <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> with <a class="link" href="GtkCellArea.html#gtk-cell-area-class-install-cell-property" title="gtk_cell_area_class_install_cell_property ()"><code class="function">gtk_cell_area_class_install_cell_property()</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.get-cell-property"></a>get_cell_property</code></em> ()</span></p></td> -<td>This should be implemented to report the values of -child cell properties for a given child <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.focus"></a>focus</code></em> ()</span></p></td> -<td>This virtual method should be implemented to navigate focus from -cell to cell inside the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>. The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> should move -focus from cell to cell inside the area and return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if focus -logically leaves the area with the following exceptions: When the -area contains no activatable cells, the entire area recieves focus. -Focus should not be given to cells that are actually "focus siblings" -of other sibling cells (see <a class="link" href="GtkCellArea.html#gtk-cell-area-get-focus-from-sibling" title="gtk_cell_area_get_focus_from_sibling ()"><code class="function">gtk_cell_area_get_focus_from_sibling()</code></a>). -Focus is set by calling <a class="link" href="GtkCellArea.html#gtk-cell-area-set-focus-cell" title="gtk_cell_area_set_focus_cell ()"><code class="function">gtk_cell_area_set_focus_cell()</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.is-activatable"></a>is_activatable</code></em> ()</span></p></td> -<td>Returns whether the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> can respond to -<a class="link" href="GtkCellArea.html#GtkCellAreaClass.activate"><code class="function">GtkCellAreaClass.activate()</code></a>, usually this does not need to be -implemented since the base class takes care of this however it can -be enhanced if the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> subclass can handle activation in -other ways than activating its <a href="GtkCellRenderer.html"><span class="type">GtkCellRenderers</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="structfield"><code><a name="GtkCellAreaClass.activate"></a>activate</code></em> ()</span></p></td> -<td>This is called when the layouting widget rendering the -<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> activates the focus cell (see <a class="link" href="GtkCellArea.html#gtk-cell-area-get-focus-cell" title="gtk_cell_area_get_focus_cell ()"><code class="function">gtk_cell_area_get_focus_cell()</code></a>).</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellCallback"></a><h3>GtkCellCallback ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GtkCellCallback) (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> -<p> -The type of the callback functions used for iterating over -the cell renderers of a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>, see <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach" title="gtk_cell_area_foreach ()"><code class="function">gtk_cell_area_foreach()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the cell renderer to operate on</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> -<td>user-supplied data. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop iterating over cells.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellAllocCallback"></a><h3>GtkCellAllocCallback ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GtkCellAllocCallback) (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_background</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> -<p> -The type of the callback functions used for iterating over the -cell renderers and their allocated areas inside a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>, -see <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach-alloc" title="gtk_cell_area_foreach_alloc ()"><code class="function">gtk_cell_area_foreach_alloc()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the cell renderer to operate on</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the area allocated to <em class="parameter"><code>renderer</code></em> inside the rectangle -provided to <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach-alloc" title="gtk_cell_area_foreach_alloc ()"><code class="function">gtk_cell_area_foreach_alloc()</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_background</code></em> :</span></p></td> -<td>the background area for <em class="parameter"><code>renderer</code></em> inside the -background area provided to <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach-alloc" title="gtk_cell_area_foreach_alloc ()"><code class="function">gtk_cell_area_foreach_alloc()</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> -<td>user-supplied data. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop iterating over cells.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GTK-CELL-AREA-WARN-INVALID-CELL-PROPERTY-ID:CAPS"></a><h3>GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID()</h3> -<pre class="programlisting">#define GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID(object, property_id, pspec)</pre> -<p> -This macro should be used to emit a standard warning about unexpected -properties in <code class="function">set_cell_property()</code> and <code class="function">get_cell_property()</code> implementations. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> on which <code class="function">set_cell_property()</code> or <code class="function">get_get_property()</code> -was called</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>property_id</code></em> :</span></p></td> -<td>the numeric id of the property</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the property</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-add"></a><h3>gtk_cell_area_add ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_add (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>);</pre> -<p> -Adds <em class="parameter"><code>renderer</code></em> to <em class="parameter"><code>area</code></em> with the default child cell properties. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to add to <em class="parameter"><code>area</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-remove"></a><h3>gtk_cell_area_remove ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_remove (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>);</pre> -<p> -Removes <em class="parameter"><code>renderer</code></em> from <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to remove from <em class="parameter"><code>area</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-has-renderer"></a><h3>gtk_cell_area_has_renderer ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_cell_area_has_renderer (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>);</pre> -<p> -Checks if <em class="parameter"><code>area</code></em> contains <em class="parameter"><code>renderer</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to check</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>renderer</code></em> is in the <em class="parameter"><code>area</code></em>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-foreach"></a><h3>gtk_cell_area_foreach ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_foreach (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellCallback" title="GtkCellCallback ()"><span class="type">GtkCellCallback</span></a> callback</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre> -<p> -Calls <em class="parameter"><code>callback</code></em> for every <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> in <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellArea.html#GtkCellCallback" title="GtkCellCallback ()"><span class="type">GtkCellCallback</span></a> to call. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td> -<td>user provided data pointer</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-foreach-alloc"></a><h3>gtk_cell_area_foreach_alloc ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_foreach_alloc (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()"><span class="type">GtkCellAllocCallback</span></a> callback</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre> -<p> -Calls <em class="parameter"><code>callback</code></em> for every <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> in <em class="parameter"><code>area</code></em> with the -allocated rectangle inside <em class="parameter"><code>cell_area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> for this row of data.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering to</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the <em class="parameter"><code>widget</code></em> relative coordinates and size for <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>background_area</code></em> :</span></p></td> -<td>the <em class="parameter"><code>widget</code></em> relative coordinates of the background area</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()"><span class="type">GtkCellAllocCallback</span></a> to call. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td> -<td>user provided data pointer</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-event"></a><h3>gtk_cell_area_event ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_cell_area_event (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>);</pre> -<p> -Delegates event handling to a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> for this row of data.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering to</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td> -<td>the <a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to handle</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the <em class="parameter"><code>widget</code></em> relative coordinates for <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> for <em class="parameter"><code>area</code></em> in this row.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the event was handled by <em class="parameter"><code>area</code></em>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-render"></a><h3>gtk_cell_area_render ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_render (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> paint_focus</code></em>);</pre> -<p> -Renders <em class="parameter"><code>area</code></em>'s cells according to <em class="parameter"><code>area</code></em>'s layout onto <em class="parameter"><code>widget</code></em> at -the given coordinates. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> for this row of data.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering to</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td> -<td>the <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> to render with</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>background_area</code></em> :</span></p></td> -<td>the <em class="parameter"><code>widget</code></em> relative coordinates for <em class="parameter"><code>area</code></em>'s background</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the <em class="parameter"><code>widget</code></em> relative coordinates for <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> for <em class="parameter"><code>area</code></em> in this row.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>paint_focus</code></em> :</span></p></td> -<td>whether <em class="parameter"><code>area</code></em> should paint focus on focused cells for focused rows or not.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-cell-allocation"></a><h3>gtk_cell_area_get_cell_allocation ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_get_cell_allocation (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *allocation</code></em>);</pre> -<p> -Derives the allocation of <em class="parameter"><code>renderer</code></em> inside <em class="parameter"><code>area</code></em> if <em class="parameter"><code>area</code></em> -were to be renderered in <em class="parameter"><code>cell_area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> used to hold sizes for <em class="parameter"><code>area</code></em>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering on</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to get the allocation for</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the whole allocated area for <em class="parameter"><code>area</code></em> in <em class="parameter"><code>widget</code></em> -for this row</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>allocation</code></em> :</span></p></td> -<td>where to store the allocation for <em class="parameter"><code>renderer</code></em>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-cell-at-position"></a><h3>gtk_cell_area_get_cell_at_position ()</h3> -<pre class="programlisting"><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * gtk_cell_area_get_cell_at_position (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *alloc_area</code></em>);</pre> -<p> -Gets the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> at <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> coordinates inside <em class="parameter"><code>area</code></em> and optionally -returns the full cell allocation for it inside <em class="parameter"><code>cell_area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> used to hold sizes for <em class="parameter"><code>area</code></em>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering on</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the whole allocated area for <em class="parameter"><code>area</code></em> in <em class="parameter"><code>widget</code></em> -for this row</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>the x position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>the y position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>alloc_area</code></em> :</span></p></td> -<td>where to store the inner allocated area of the -returned cell renderer, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> at <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-create-context"></a><h3>gtk_cell_area_create_context ()</h3> -<pre class="programlisting"><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="returnvalue">GtkCellAreaContext</span></a> * gtk_cell_area_create_context (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre> -<p> -Creates a <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> to be used with <em class="parameter"><code>area</code></em> for -all purposes. <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> stores geometry information -for rows for which it was operated on, it is important to use -the same context for the same row of data at all times (i.e. -one should render and handle events with the same <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> -which was used to request the size of those rows of data). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a newly created <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> which can be used with <em class="parameter"><code>area</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-copy-context"></a><h3>gtk_cell_area_copy_context ()</h3> -<pre class="programlisting"><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="returnvalue">GtkCellAreaContext</span></a> * gtk_cell_area_copy_context (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>);</pre> -<p> -This is sometimes needed for cases where rows need to share -alignments in one orientation but may be separately grouped -in the opposing orientation. -</p> -<p> -For instance, <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> creates all icons (rows) to have -the same width and the cells theirin to have the same -horizontal alignments. However each row of icons may have -a separate collective height. <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> uses this to -request the heights of each row based on a context which -was already used to request all the row widths that are -to be displayed. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> to copy</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a newly created <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> copy of <em class="parameter"><code>context</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-request-mode"></a><h3>gtk_cell_area_get_request_mode ()</h3> -<pre class="programlisting"><a class="link" href="GtkWidget.html#GtkSizeRequestMode" title="enum GtkSizeRequestMode"><span class="returnvalue">GtkSizeRequestMode</span></a> gtk_cell_area_get_request_mode (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre> -<p> -Gets whether the area prefers a height-for-width layout -or a width-for-height layout. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The <a class="link" href="GtkWidget.html#GtkSizeRequestMode" title="enum GtkSizeRequestMode"><span class="type">GtkSizeRequestMode</span></a> preferred by <em class="parameter"><code>area</code></em>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-preferred-width"></a><h3>gtk_cell_area_get_preferred_width ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_get_preferred_width (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>);</pre> -<p> -Retrieves a cell area's initial minimum and natural width. -</p> -<p> -<em class="parameter"><code>area</code></em> will store some geometrical information in <em class="parameter"><code>context</code></em> along the way, -when requesting sizes over an arbitrary number of rows, its not important -to check the <em class="parameter"><code>minimum_width</code></em> and <em class="parameter"><code>natural_width</code></em> of this call but rather to -consult <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-width" title="gtk_cell_area_context_get_preferred_width ()"><code class="function">gtk_cell_area_context_get_preferred_width()</code></a> after a series of -requests. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> to perform this request with</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> where <em class="parameter"><code>area</code></em> will be rendering</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>minimum_width</code></em> :</span></p></td> -<td>location to store the minimum width, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>natural_width</code></em> :</span></p></td> -<td>location to store the natural width, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-preferred-height-for-width"></a><h3>gtk_cell_area_get_preferred_height_for_width ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_get_preferred_height_for_width - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>);</pre> -<p> -Retrieves a cell area's minimum and natural height if it would be given -the specified <em class="parameter"><code>width</code></em>. -</p> -<p> -<em class="parameter"><code>area</code></em> stores some geometrical information in <em class="parameter"><code>context</code></em> along the way -while calling <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()"><code class="function">gtk_cell_area_get_preferred_width()</code></a>. It's important to -perform a series of <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()"><code class="function">gtk_cell_area_get_preferred_width()</code></a> requests with -<em class="parameter"><code>context</code></em> first and then call <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height-for-width" title="gtk_cell_area_get_preferred_height_for_width ()"><code class="function">gtk_cell_area_get_preferred_height_for_width()</code></a> -on each cell area individually to get the height for width of each -fully requested row. -</p> -<p> -If at some point, the width of a single row changes, it should be -requested with <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width" title="gtk_cell_area_get_preferred_width ()"><code class="function">gtk_cell_area_get_preferred_width()</code></a> again and then -the full width of the requested rows checked again with -<a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-width" title="gtk_cell_area_context_get_preferred_width ()"><code class="function">gtk_cell_area_context_get_preferred_width()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> which has already been requested for widths.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> where <em class="parameter"><code>area</code></em> will be rendering</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> -<td>the width for which to check the height of this area</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>minimum_height</code></em> :</span></p></td> -<td>location to store the minimum height, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>natural_height</code></em> :</span></p></td> -<td>location to store the natural height, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-preferred-height"></a><h3>gtk_cell_area_get_preferred_height ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_get_preferred_height (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_height</code></em>);</pre> -<p> -Retrieves a cell area's initial minimum and natural height. -</p> -<p> -<em class="parameter"><code>area</code></em> will store some geometrical information in <em class="parameter"><code>context</code></em> along the way, -when requesting sizes over an arbitrary number of rows, its not important -to check the <em class="parameter"><code>minimum_height</code></em> and <em class="parameter"><code>natural_height</code></em> of this call but rather to -consult <a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-height" title="gtk_cell_area_context_get_preferred_height ()"><code class="function">gtk_cell_area_context_get_preferred_height()</code></a> after a series of -requests. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> to perform this request with</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> where <em class="parameter"><code>area</code></em> will be rendering</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>minimum_height</code></em> :</span></p></td> -<td>location to store the minimum height, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>natural_height</code></em> :</span></p></td> -<td>location to store the natural height, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-preferred-width-for-height"></a><h3>gtk_cell_area_get_preferred_width_for_height ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_get_preferred_width_for_height - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_width</code></em>);</pre> -<p> -Retrieves a cell area's minimum and natural width if it would be given -the specified <em class="parameter"><code>height</code></em>. -</p> -<p> -<em class="parameter"><code>area</code></em> stores some geometrical information in <em class="parameter"><code>context</code></em> along the way -while calling <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height" title="gtk_cell_area_get_preferred_height ()"><code class="function">gtk_cell_area_get_preferred_height()</code></a>. It's important to -perform a series of <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height" title="gtk_cell_area_get_preferred_height ()"><code class="function">gtk_cell_area_get_preferred_height()</code></a> requests with -<em class="parameter"><code>context</code></em> first and then call <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-width-for-height" title="gtk_cell_area_get_preferred_width_for_height ()"><code class="function">gtk_cell_area_get_preferred_width_for_height()</code></a> -on each cell area individually to get the height for width of each -fully requested row. -</p> -<p> -If at some point, the height of a single row changes, it should be -requested with <a class="link" href="GtkCellArea.html#gtk-cell-area-get-preferred-height" title="gtk_cell_area_get_preferred_height ()"><code class="function">gtk_cell_area_get_preferred_height()</code></a> again and then -the full height of the requested rows checked again with -<a class="link" href="GtkCellAreaContext.html#gtk-cell-area-context-get-preferred-height" title="gtk_cell_area_context_get_preferred_height ()"><code class="function">gtk_cell_area_context_get_preferred_height()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> which has already been requested for widths.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> where <em class="parameter"><code>area</code></em> will be rendering</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> -<td>the height for which to check the width of this area</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>minimum_width</code></em> :</span></p></td> -<td>location to store the minimum width, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>natural_width</code></em> :</span></p></td> -<td>location to store the natural width, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-current-path-string"></a><h3>gtk_cell_area_get_current_path_string ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_cell_area_get_current_path_string - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre> -<p> -Gets the current <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> string for the currently -applied <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, this is implicitly updated when -<a class="link" href="GtkCellArea.html#gtk-cell-area-apply-attributes" title="gtk_cell_area_apply_attributes ()"><code class="function">gtk_cell_area_apply_attributes()</code></a> is called and can be -used to interact with renderers from <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -subclasses. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The current <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> string for the current -attributes applied to <em class="parameter"><code>area</code></em>. This string belongs to the area and -should not be freed.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-apply-attributes"></a><h3>gtk_cell_area_apply_attributes ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_apply_attributes (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *tree_model</code></em>, - <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expander</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expanded</code></em>);</pre> -<p> -Applies any connected attributes to the renderers in -<em class="parameter"><code>area</code></em> by pulling the values from <em class="parameter"><code>tree_model</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>tree_model</code></em> :</span></p></td> -<td>the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> to pull values from</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td> -<td>the <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> in <em class="parameter"><code>tree_model</code></em> to apply values for</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>is_expander</code></em> :</span></p></td> -<td>whether <em class="parameter"><code>iter</code></em> has children</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>is_expanded</code></em> :</span></p></td> -<td>whether <em class="parameter"><code>iter</code></em> is expanded in the view and -children are visible</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-attribute-connect"></a><h3>gtk_cell_area_attribute_connect ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_attribute_connect (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre> -<p> -Connects an <em class="parameter"><code>attribute</code></em> to apply values from <em class="parameter"><code>column</code></em> for the -<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> in use. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to connect an attribute for</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td> -<td>the attribute name</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>column</code></em> :</span></p></td> -<td>the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> column to fetch attribute values from</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-attribute-disconnect"></a><h3>gtk_cell_area_attribute_disconnect ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_attribute_disconnect (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>);</pre> -<p> -Disconnects <em class="parameter"><code>attribute</code></em> for the <em class="parameter"><code>renderer</code></em> in <em class="parameter"><code>area</code></em> so that -attribute will no longer be updated with values from the -model. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to disconnect an attribute for</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td> -<td>the attribute name</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-class-install-cell-property"></a><h3>gtk_cell_area_class_install_cell_property ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_class_install_cell_property - (<em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> *aclass</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);</pre> -<p> -Installs a cell property on a cell area class. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>aclass</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>property_id</code></em> :</span></p></td> -<td>the id for the property</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-class-find-cell-property"></a><h3>gtk_cell_area_class_find_cell_property ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> * gtk_cell_area_class_find_cell_property - (<em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> *aclass</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre> -<p> -Finds a cell property of a cell area class by name. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>aclass</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td> -<td>the name of the child property to find</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the child property -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>aclass</code></em> has no child property with that name. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-class-list-cell-properties"></a><h3>gtk_cell_area_class_list_cell_properties ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> ** gtk_cell_area_class_list_cell_properties - (<em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> *aclass</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);</pre> -<p> -Returns all cell properties of a cell area class. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>aclass</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_properties</code></em> :</span></p></td> -<td>location to return the number of cell properties found</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a newly -allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>*. The array -must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-add-with-properties"></a><h3>gtk_cell_area_add_with_properties ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_add_with_properties (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>, - <em class="parameter"><code>...</code></em>);</pre> -<p> -Adds <em class="parameter"><code>renderer</code></em> to <em class="parameter"><code>area</code></em>, setting cell properties at the same time. -See <a class="link" href="GtkCellArea.html#gtk-cell-area-add" title="gtk_cell_area_add ()"><code class="function">gtk_cell_area_add()</code></a> and <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set" title="gtk_cell_area_cell_set ()"><code class="function">gtk_cell_area_cell_set()</code></a> for more details. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to be placed inside <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>first_prop_name</code></em> :</span></p></td> -<td>the name of the first cell property to set</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting -with <em class="parameter"><code>first_prop_name</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-cell-set"></a><h3>gtk_cell_area_cell_set ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_cell_set (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>, - <em class="parameter"><code>...</code></em>);</pre> -<p> -Sets one or more cell properties for <em class="parameter"><code>cell</code></em> in <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> which is a cell inside <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>first_prop_name</code></em> :</span></p></td> -<td>the name of the first cell property to set</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting -with <em class="parameter"><code>first_prop_name</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-cell-get"></a><h3>gtk_cell_area_cell_get ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_cell_get (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>, - <em class="parameter"><code>...</code></em>);</pre> -<p> -Gets the values of one or more cell properties for <em class="parameter"><code>renderer</code></em> in <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> which is inside <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>first_prop_name</code></em> :</span></p></td> -<td>the name of the first cell property to get</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> -<td>return location for the first cell property, followed -optionally by more name/return location pairs, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-cell-set-valist"></a><h3>gtk_cell_area_cell_set_valist ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_cell_set_valist (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>, - <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre> -<p> -Sets one or more cell properties for <em class="parameter"><code>renderer</code></em> in <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> which inside <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td> -<td>the name of the first cell property to set</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting -with <em class="parameter"><code>first_prop_name</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-cell-get-valist"></a><h3>gtk_cell_area_cell_get_valist ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_cell_get_valist (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>, - <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre> -<p> -Gets the values of one or more cell properties for <em class="parameter"><code>renderer</code></em> in <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> inside <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td> -<td>the name of the first property to get</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td> -<td>return location for the first property, followed -optionally by more name/return location pairs, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-cell-set-property"></a><h3>gtk_cell_area_cell_set_property ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_cell_set_property (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre> -<p> -Sets a cell property for <em class="parameter"><code>renderer</code></em> in <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> inside <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td> -<td>the name of the cell property to set</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>the value to set the cell property to</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-cell-get-property"></a><h3>gtk_cell_area_cell_get_property ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_cell_get_property (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre> -<p> -Gets the value of a cell property for <em class="parameter"><code>renderer</code></em> in <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> inside <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td> -<td>the name of the property to get</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a location to return the value</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-is-activatable"></a><h3>gtk_cell_area_is_activatable ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_cell_area_is_activatable (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre> -<p> -Returns whether the area can do anything when activated, -after applying new attributes to <em class="parameter"><code>area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>whether <em class="parameter"><code>area</code></em> can do anything when activated.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-activate"></a><h3>gtk_cell_area_activate ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_cell_area_activate (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> edit_only</code></em>);</pre> -<p> -Activates <em class="parameter"><code>area</code></em>, 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. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> in context with the current row data</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering on</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the size and location of <em class="parameter"><code>area</code></em> relative to <em class="parameter"><code>widget</code></em>'s allocation</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags for <em class="parameter"><code>area</code></em> for this row of data.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>edit_only</code></em> :</span></p></td> -<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then only cell renderers that are <a class="link" href="GtkCellRenderer.html#GTK-CELL-RENDERER-MODE-EDITABLE:CAPS"><code class="literal">GTK_CELL_RENDERER_MODE_EDITABLE</code></a> -will be activated.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>Whether <em class="parameter"><code>area</code></em> was successfully activated.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-focus"></a><h3>gtk_cell_area_focus ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_cell_area_focus (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a> direction</code></em>);</pre> -<p> -This should be called by the <em class="parameter"><code>area</code></em>'s owning layout widget -when focus is to be passed to <em class="parameter"><code>area</code></em>, or moved within <em class="parameter"><code>area</code></em> -for a given <em class="parameter"><code>direction</code></em> and row data. -</p> -<p> -Implementing <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> classes should implement this -method to receive and navigate focus in its own way particular -to how it lays out cells. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td> -<td>the <a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if focus remains inside <em class="parameter"><code>area</code></em> as a result of this call.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-set-focus-cell"></a><h3>gtk_cell_area_set_focus_cell ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_set_focus_cell (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>);</pre> -<p> -Explicitly sets the currently focused cell to <em class="parameter"><code>renderer</code></em>. -</p> -<p> -This is generally called by implementations of -<a class="link" href="GtkCellArea.html#GtkCellAreaClass.focus"><code class="function">GtkCellAreaClass.focus()</code></a> or <a class="link" href="GtkCellArea.html#GtkCellAreaClass.event"><code class="function">GtkCellAreaClass.event()</code></a>, -however it can also be used to implement functions such -as <a class="link" href="GtkTreeView.html#gtk-tree-view-set-cursor-on-cell" title="gtk_tree_view_set_cursor_on_cell ()"><code class="function">gtk_tree_view_set_cursor_on_cell()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to give focus to</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-focus-cell"></a><h3>gtk_cell_area_get_focus_cell ()</h3> -<pre class="programlisting"><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * gtk_cell_area_get_focus_cell (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre> -<p> -Retrieves the currently focused cell for <em class="parameter"><code>area</code></em> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the currently focused cell in <em class="parameter"><code>area</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-add-focus-sibling"></a><h3>gtk_cell_area_add_focus_sibling ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_add_focus_sibling (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *sibling</code></em>);</pre> -<p> -Adds <em class="parameter"><code>sibling</code></em> to <em class="parameter"><code>renderer</code></em>'s focusable area, focus will be drawn -around <em class="parameter"><code>renderer</code></em> and all of its siblings if <em class="parameter"><code>renderer</code></em> can -focus for a given row. -</p> -<p> -Events handled by focus siblings can also activate the given -focusable <em class="parameter"><code>renderer</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>sibling</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to add to <em class="parameter"><code>renderer</code></em>'s focus area</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-remove-focus-sibling"></a><h3>gtk_cell_area_remove_focus_sibling ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_remove_focus_sibling (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *sibling</code></em>);</pre> -<p> -Removes <em class="parameter"><code>sibling</code></em> from <em class="parameter"><code>renderer</code></em>'s focus sibling list -(see <a class="link" href="GtkCellArea.html#gtk-cell-area-add-focus-sibling" title="gtk_cell_area_add_focus_sibling ()"><code class="function">gtk_cell_area_add_focus_sibling()</code></a>). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>sibling</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to remove from <em class="parameter"><code>renderer</code></em>'s focus area</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-is-focus-sibling"></a><h3>gtk_cell_area_is_focus_sibling ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_cell_area_is_focus_sibling (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *sibling</code></em>);</pre> -<p> -Returns whether <em class="parameter"><code>sibling</code></em> is one of <em class="parameter"><code>renderer</code></em>'s focus siblings -(see <a class="link" href="GtkCellArea.html#gtk-cell-area-add-focus-sibling" title="gtk_cell_area_add_focus_sibling ()"><code class="function">gtk_cell_area_add_focus_sibling()</code></a>). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>sibling</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to check against <em class="parameter"><code>renderer</code></em>'s sibling list</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>sibling</code></em> is a focus sibling of <em class="parameter"><code>renderer</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-focus-siblings"></a><h3>gtk_cell_area_get_focus_siblings ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * gtk_cell_area_get_focus_siblings (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>);</pre> -<p> -Gets the focus sibling cell renderers for <em class="parameter"><code>renderer</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a href="GtkCellRenderer.html"><span class="type">GtkCellRenderers</span></a>. -The returned list is internal and should not be freed. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkCellRenderer][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-focus-from-sibling"></a><h3>gtk_cell_area_get_focus_from_sibling ()</h3> -<pre class="programlisting"><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * gtk_cell_area_get_focus_from_sibling - (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>);</pre> -<p> -Gets the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> which is expected to be focusable -for which <em class="parameter"><code>renderer</code></em> is, or may be a sibling. -</p> -<p> -This is handy for <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> subclasses when handling events, -after determining the renderer at the event location it can -then chose to activate the focus cell for which the event -cell may have been a sibling. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> for which <em class="parameter"><code>renderer</code></em> -is a sibling, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-edited-cell"></a><h3>gtk_cell_area_get_edited_cell ()</h3> -<pre class="programlisting"><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * gtk_cell_area_get_edited_cell (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre> -<p> -Gets the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> in <em class="parameter"><code>area</code></em> that is currently -being edited. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The currently edited <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-get-edit-widget"></a><h3>gtk_cell_area_get_edit_widget ()</h3> -<pre class="programlisting"><a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="returnvalue">GtkCellEditable</span></a> * gtk_cell_area_get_edit_widget (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre> -<p> -Gets the <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> widget currently used -to edit the currently edited cell. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The currently active <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> widget. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-activate-cell"></a><h3>gtk_cell_area_activate_cell ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_cell_area_activate_cell (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>);</pre> -<p> -This is used by <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> subclasses when handling events -to activate cells, the base <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> class activates cells -for keyboard events for free in its own GtkCellArea-><code class="function">activate()</code> -implementation. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering onto</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> in <em class="parameter"><code>area</code></em> to activate</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td> -<td>the <a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> for which cell activation should occur</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> in <em class="parameter"><code>widget</code></em> relative coordinates -of <em class="parameter"><code>renderer</code></em> for the current row.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> for <em class="parameter"><code>renderer</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>whether cell activation was successful</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-stop-editing"></a><h3>gtk_cell_area_stop_editing ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_stop_editing (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> canceled</code></em>);</pre> -<p> -Explicitly stops the editing of the currently edited cell. -</p> -<p> -If <em class="parameter"><code>canceled</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the currently edited cell renderer -will emit the ::editing-canceled signal, otherwise the -the ::editing-done signal will be emitted on the current -edit widget. -</p> -<p> -See <a class="link" href="GtkCellArea.html#gtk-cell-area-get-edited-cell" title="gtk_cell_area_get_edited_cell ()"><code class="function">gtk_cell_area_get_edited_cell()</code></a> and <a class="link" href="GtkCellArea.html#gtk-cell-area-get-edit-widget" title="gtk_cell_area_get_edit_widget ()"><code class="function">gtk_cell_area_get_edit_widget()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>canceled</code></em> :</span></p></td> -<td>whether editing was canceled.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-inner-cell-area"></a><h3>gtk_cell_area_inner_cell_area ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_inner_cell_area (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *inner_area</code></em>);</pre> -<p> -This is a convenience function for <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> implementations -to get the inner area where a given <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> will be -rendered. It removes any padding previously added by <a class="link" href="GtkCellArea.html#gtk-cell-area-request-renderer" title="gtk_cell_area_request_renderer ()"><code class="function">gtk_cell_area_request_renderer()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering onto</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the <em class="parameter"><code>widget</code></em> relative coordinates where one of <em class="parameter"><code>area</code></em>'s cells -is to be placed</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>inner_area</code></em> :</span></p></td> -<td>the return location for the inner cell area. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-cell-area-request-renderer"></a><h3>gtk_cell_area_request_renderer ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_cell_area_request_renderer (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>, - <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> for_size</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_size</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *natural_size</code></em>);</pre> -<p> -This is a convenience function for <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> implementations -to request size for cell renderers. It's important to use this -function to request size and then use <a class="link" href="GtkCellArea.html#gtk-cell-area-inner-cell-area" title="gtk_cell_area_inner_cell_area ()"><code class="function">gtk_cell_area_inner_cell_area()</code></a> -at render and event time since this function will add padding -around the cell for focus painting. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to request size for</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>orientation</code></em> :</span></p></td> -<td>the <a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> in which to request size</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that <em class="parameter"><code>area</code></em> is rendering onto</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>for_size</code></em> :</span></p></td> -<td>the allocation contextual size to request for, or -1 if -the base request for the orientation is to be returned.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>minimum_size</code></em> :</span></p></td> -<td>location to store the minimum size, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>natural_size</code></em> :</span></p></td> -<td>location to store the natural size, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkCellArea.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="GtkCellArea--edit-widget"></a><h3>The <code class="literal">"edit-widget"</code> property</h3> -<pre class="programlisting"> "edit-widget" <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a>* : Read</pre> -<p> -The widget currently editing the edited cell -</p> -<p> -This property is read-only and only changes as -a result of a call <a class="link" href="GtkCellArea.html#gtk-cell-area-activate-cell" title="gtk_cell_area_activate_cell ()"><code class="function">gtk_cell_area_activate_cell()</code></a>. -</p> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellArea--edited-cell"></a><h3>The <code class="literal">"edited-cell"</code> property</h3> -<pre class="programlisting"> "edited-cell" <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>* : Read</pre> -<p> -The cell in the area that is currently edited -</p> -<p> -This property is read-only and only changes as -a result of a call <a class="link" href="GtkCellArea.html#gtk-cell-area-activate-cell" title="gtk_cell_area_activate_cell ()"><code class="function">gtk_cell_area_activate_cell()</code></a>. -</p> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellArea--focus-cell"></a><h3>The <code class="literal">"focus-cell"</code> property</h3> -<pre class="programlisting"> "focus-cell" <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>* : Read / Write</pre> -<p> -The cell in the area that currently has focus -</p> -<p class="since">Since 3.0</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkCellArea.signal-details"></a><h2>Signal Details</h2> -<div class="refsect2"> -<a name="GtkCellArea-add-editable"></a><h3>The <code class="literal">"add-editable"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area, - <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer, - <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> *editable, - <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre> -<p> -Indicates that editing has started on <em class="parameter"><code>renderer</code></em> and that <em class="parameter"><code>editable</code></em> -should be added to the owning cell-layouting widget at <em class="parameter"><code>cell_area</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> where editing started</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> that started the edited</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>editable</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> widget to add</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td> -<td>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> relative <a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> coordinates -where <em class="parameter"><code>editable</code></em> should be added</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> -<td>the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> string this edit was initiated for</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellArea-apply-attributes"></a><h3>The <code class="literal">"apply-attributes"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area, - <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model, - <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expander, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expanded, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre> -<p> -This signal is emitted whenever applying attributes to <em class="parameter"><code>area</code></em> from <em class="parameter"><code>model</code></em> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> to apply the attributes to</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>model</code></em> :</span></p></td> -<td>the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> to apply the attributes from</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td> -<td>the <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> indicating which row to apply the attributes of</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>is_expander</code></em> :</span></p></td> -<td>whether the view shows children for this row</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>is_expanded</code></em> :</span></p></td> -<td>whether the view is currently showing the children of this row</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellArea-focus-changed"></a><h3>The <code class="literal">"focus-changed"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area, - <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre> -<p> -Indicates that focus changed on this <em class="parameter"><code>area</code></em>. This signal -is emitted either as a result of focus handling or event -handling. -</p> -<p> -It's possible that the signal is emitted even if the -currently focused renderer did not change, this is -because focus may change to the same renderer in the -same cell area for a different row of data. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> where focus changed</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> that has focus</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> -<td>the current <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> string set for <em class="parameter"><code>area</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkCellArea-remove-editable"></a><h3>The <code class="literal">"remove-editable"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area, - <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer, - <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> *editable, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre> -<p> -Indicates that editing finished on <em class="parameter"><code>renderer</code></em> and that <em class="parameter"><code>editable</code></em> -should be removed from the owning cell-layouting widget. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> where editing finished</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>renderer</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> that finished editeding</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>editable</code></em> :</span></p></td> -<td>the <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> widget to remove</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18.1</div> -</body> -</html>
\ No newline at end of file |