⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.10
Server IP:
157.245.101.34
Server:
Linux skvinfotech-website 5.4.0-131-generic #147-Ubuntu SMP Fri Oct 14 17:07:22 UTC 2022 x86_64
Server Software:
Apache/2.4.41 (Ubuntu)
PHP Version:
7.4.33
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
usr
/
share
/
doc
/
libgtk-3-doc
/
gtk3
/
View File Name :
GtkCellArea.html
<!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: GTK+ 3 Reference Manual</title> <meta name="generator" content="DocBook XSL Stylesheets V1.79.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.32 (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="5"><tr valign="middle"> <td width="100%" align="left" class="shortcuts"> <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> <a href="#GtkCellArea.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> <a href="#GtkCellArea.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> <a href="#GtkCellArea.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> <a href="#GtkCellArea.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span> <a href="#GtkCellArea.signals" class="shortcut">Signals</a></span> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> <td><a accesskey="u" href="TreeWidgetObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> <td><a accesskey="p" href="GtkCellLayout.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> <td><a accesskey="n" href="GtkCellAreaBox.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></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 class="gallery_image" valign="top" align="right"></td> </tr></table></div> <div class="refsect1"> <a name="GtkCellArea.functions"></a><h2>Functions</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="functions_proto_type"> <col class="functions_proto_name"> </colgroup> <tbody> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <span class="c_punctuation">(</span><a class="link" href="GtkCellArea.html#GtkCellCallback" title="GtkCellCallback ()">*GtkCellCallback</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <span class="c_punctuation">(</span><a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()">*GtkCellAllocCallback</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="define_keyword">#define</td> <td class="function_name"> <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><span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-add" title="gtk_cell_area_add ()">gtk_cell_area_add</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-remove" title="gtk_cell_area_remove ()">gtk_cell_area_remove</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-has-renderer" title="gtk_cell_area_has_renderer ()">gtk_cell_area_has_renderer</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach" title="gtk_cell_area_foreach ()">gtk_cell_area_foreach</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-foreach-alloc" title="gtk_cell_area_foreach_alloc ()">gtk_cell_area_foreach_alloc</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-event" title="gtk_cell_area_event ()">gtk_cell_area_event</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-render" title="gtk_cell_area_render ()">gtk_cell_area_render</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="returnvalue">GtkCellAreaContext</span></a> * </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-create-context" title="gtk_cell_area_create_context ()">gtk_cell_area_create_context</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="returnvalue">GtkCellAreaContext</span></a> * </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-copy-context" title="gtk_cell_area_copy_context ()">gtk_cell_area_copy_context</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkWidget.html#GtkSizeRequestMode" title="enum GtkSizeRequestMode"><span class="returnvalue">GtkSizeRequestMode</span></a> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-apply-attributes" title="gtk_cell_area_apply_attributes ()">gtk_cell_area_apply_attributes</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-attribute-connect" title="gtk_cell_area_attribute_connect ()">gtk_cell_area_attribute_connect</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-attribute-disconnect" title="gtk_cell_area_attribute_disconnect ()">gtk_cell_area_attribute_disconnect</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-attribute-get-column" title="gtk_cell_area_attribute_get_column ()">gtk_cell_area_attribute_get_column</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> ** </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-set" title="gtk_cell_area_cell_set ()">gtk_cell_area_cell_set</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-cell-get" title="gtk_cell_area_cell_get ()">gtk_cell_area_cell_get</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-is-activatable" title="gtk_cell_area_is_activatable ()">gtk_cell_area_is_activatable</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-activate" title="gtk_cell_area_activate ()">gtk_cell_area_activate</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-focus" title="gtk_cell_area_focus ()">gtk_cell_area_focus</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="returnvalue">GtkCellEditable</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-activate-cell" title="gtk_cell_area_activate_cell ()">gtk_cell_area_activate_cell</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-stop-editing" title="gtk_cell_area_stop_editing ()">gtk_cell_area_stop_editing</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="GtkCellArea.html#gtk-cell-area-request-renderer" title="gtk_cell_area_request_renderer ()">gtk_cell_area_request_renderer</a> <span class="c_punctuation">()</span> </td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="GtkCellArea.properties"></a><h2>Properties</h2> <div class="informaltable"><table class="informaltable" border="0"> <colgroup> <col width="150px" class="properties_type"> <col width="300px" class="properties_name"> <col width="200px" class="properties_flags"> </colgroup> <tbody> <tr> <td class="property_type"> <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> *</td> <td class="property_name"><a class="link" href="GtkCellArea.html#GtkCellArea--edit-widget" title="The “edit-widget” property">edit-widget</a></td> <td class="property_flags">Read</td> </tr> <tr> <td class="property_type"> <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *</td> <td class="property_name"><a class="link" href="GtkCellArea.html#GtkCellArea--edited-cell" title="The “edited-cell” property">edited-cell</a></td> <td class="property_flags">Read</td> </tr> <tr> <td class="property_type"> <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *</td> <td class="property_name"><a class="link" href="GtkCellArea.html#GtkCellArea--focus-cell" title="The “focus-cell” property">focus-cell</a></td> <td class="property_flags">Read / Write</td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="GtkCellArea.signals"></a><h2>Signals</h2> <div class="informaltable"><table class="informaltable" border="0"> <colgroup> <col width="150px" class="signal_proto_type"> <col width="300px" class="signal_proto_name"> <col width="200px" class="signal_proto_flags"> </colgroup> <tbody> <tr> <td class="signal_type"><span class="returnvalue">void</span></td> <td class="signal_name"><a class="link" href="GtkCellArea.html#GtkCellArea-add-editable" title="The “add-editable” signal">add-editable</a></td> <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td> </tr> <tr> <td class="signal_type"><span class="returnvalue">void</span></td> <td class="signal_name"><a class="link" href="GtkCellArea.html#GtkCellArea-apply-attributes" title="The “apply-attributes” signal">apply-attributes</a></td> <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td> </tr> <tr> <td class="signal_type"><span class="returnvalue">void</span></td> <td class="signal_name"><a class="link" href="GtkCellArea.html#GtkCellArea-focus-changed" title="The “focus-changed” signal">focus-changed</a></td> <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td> </tr> <tr> <td class="signal_type"><span class="returnvalue">void</span></td> <td class="signal_name"><a class="link" href="GtkCellArea.html#GtkCellArea-remove-editable" title="The “remove-editable” signal">remove-editable</a></td> <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="GtkCellArea.other"></a><h2>Types and Values</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="other_proto_type"> <col class="other_proto_name"> </colgroup> <tbody> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="GtkCellArea.html#GtkCellArea-struct" title="struct GtkCellArea">GtkCellArea</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass">GtkCellAreaClass</a></td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="GtkCellArea.object-hierarchy"></a><h2>Object Hierarchy</h2> <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> <span class="lineart">╰──</span> GtkCellArea <span class="lineart">╰──</span> <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.includes"></a><h2>Includes</h2> <pre class="synopsis">#include <gtk/gtk.h> </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#GtkCellRenderer-struct"><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> <div class="refsect2"> <a name="id-1.3.12.14.10.5"></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="informalexample"> <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="n">GtkTreeIter</span> <span class="n">iter</span><span class="p">;</span> <span class="n">gint</span> <span class="n">minimum_width</span><span class="p">;</span> <span class="n">gint</span> <span class="n">natural_width</span><span class="p">;</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_get_iter_first</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="k">while</span> <span class="p">(</span><span class="n">valid</span><span class="p">)</span> <span class="p">{</span> <span class="n">gtk_cell_area_apply_attributes</span> <span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">);</span> <span class="n">gtk_cell_area_get_preferred_width</span> <span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">context</span><span class="p">,</span> <span class="n">widget</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_iter_next</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="p">}</span> <span class="n">gtk_cell_area_context_get_preferred_width</span> <span class="p">(</span><span class="n">context</span><span class="p">,</span> <span class="o">&</span><span class="n">minimum_width</span><span class="p">,</span> <span class="o">&</span><span class="n">natural_width</span><span class="p">);</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p>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="/usr/share/gtk-doc/html/glib/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="informalexample"> <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="k">static</span> <span class="kt">void</span> <span class="nf">foo_get_preferred_width</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">widget</span><span class="p">,</span> <span class="n">gint</span> <span class="o">*</span><span class="n">minimum_size</span><span class="p">,</span> <span class="n">gint</span> <span class="o">*</span><span class="n">natural_size</span><span class="p">)</span> <span class="p">{</span> <span class="n">Foo</span> <span class="o">*</span><span class="n">foo</span> <span class="o">=</span> <span class="n">FOO</span> <span class="p">(</span><span class="n">widget</span><span class="p">);</span> <span class="n">FooPrivate</span> <span class="o">*</span><span class="n">priv</span> <span class="o">=</span> <span class="n">foo</span><span class="o">-></span><span class="n">priv</span><span class="p">;</span> <span class="n">foo_ensure_at_least_one_handfull_of_rows_have_been_requested</span> <span class="p">(</span><span class="n">foo</span><span class="p">);</span> <span class="n">gtk_cell_area_context_get_preferred_width</span> <span class="p">(</span><span class="n">priv</span><span class="o">-></span><span class="n">context</span><span class="p">,</span> <span class="n">minimum_size</span><span class="p">,</span> <span class="n">natural_size</span><span class="p">);</span> <span class="p">}</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p>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="informalexample"> <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="n">GtkTreeIter</span> <span class="n">iter</span><span class="p">;</span> <span class="n">gint</span> <span class="n">minimum_height</span><span class="p">;</span> <span class="n">gint</span> <span class="n">natural_height</span><span class="p">;</span> <span class="n">gint</span> <span class="n">full_minimum_height</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">gint</span> <span class="n">full_natural_height</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_get_iter_first</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="k">while</span> <span class="p">(</span><span class="n">valid</span><span class="p">)</span> <span class="p">{</span> <span class="n">gtk_cell_area_apply_attributes</span> <span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">);</span> <span class="n">gtk_cell_area_get_preferred_height_for_width</span> <span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">context</span><span class="p">,</span> <span class="n">widget</span><span class="p">,</span> <span class="n">width</span><span class="p">,</span> <span class="o">&</span><span class="n">minimum_height</span><span class="p">,</span> <span class="o">&</span><span class="n">natural_height</span><span class="p">);</span> <span class="k">if</span> <span class="p">(</span><span class="n">width_is_for_allocation</span><span class="p">)</span> <span class="n">cache_row_height</span> <span class="p">(</span><span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="n">minimum_height</span><span class="p">,</span> <span class="n">natural_height</span><span class="p">);</span> <span class="n">full_minimum_height</span> <span class="o">+=</span> <span class="n">minimum_height</span><span class="p">;</span> <span class="n">full_natural_height</span> <span class="o">+=</span> <span class="n">natural_height</span><span class="p">;</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_iter_next</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="p">}</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p>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 scrollbar values while more and more height is required for the row heights that are calculated in the background.</p> </div> <hr> <div class="refsect2"> <a name="id-1.3.12.14.10.6"></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="informalexample"> <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="n">GtkAllocation</span> <span class="n">allocation</span><span class="p">;</span> <span class="n">GdkRectangle</span> <span class="n">cell_area</span> <span class="o">=</span> <span class="p">{</span> <span class="mi">0</span><span class="p">,</span> <span class="p">};</span> <span class="n">GtkTreeIter</span> <span class="n">iter</span><span class="p">;</span> <span class="n">gint</span> <span class="n">minimum_width</span><span class="p">;</span> <span class="n">gint</span> <span class="n">natural_width</span><span class="p">;</span> <span class="n">gtk_widget_get_allocation</span> <span class="p">(</span><span class="n">widget</span><span class="p">,</span> <span class="o">&</span><span class="n">allocation</span><span class="p">);</span> <span class="n">cell_area</span><span class="p">.</span><span class="n">width</span> <span class="o">=</span> <span class="n">allocation</span><span class="p">.</span><span class="n">width</span><span class="p">;</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_get_iter_first</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="k">while</span> <span class="p">(</span><span class="n">valid</span><span class="p">)</span> <span class="p">{</span> <span class="n">cell_area</span><span class="p">.</span><span class="n">height</span> <span class="o">=</span> <span class="n">get_cached_height_for_row</span> <span class="p">(</span><span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="n">gtk_cell_area_apply_attributes</span> <span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">);</span> <span class="n">gtk_cell_area_render</span> <span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">context</span><span class="p">,</span> <span class="n">widget</span><span class="p">,</span> <span class="n">cr</span><span class="p">,</span> <span class="o">&</span><span class="n">cell_area</span><span class="p">,</span> <span class="o">&</span><span class="n">cell_area</span><span class="p">,</span> <span class="n">state_flags</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">);</span> <span class="n">cell_area</span><span class="p">.</span><span class="n">y</span> <span class="o">+=</span> <span class="n">cell_area</span><span class="p">.</span><span class="n">height</span><span class="p">;</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_iter_next</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="p">}</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p>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> <hr> <div class="refsect2"> <a name="id-1.3.12.14.10.7"></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="informalexample"> <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="k">static</span> <span class="n">gboolean</span> <span class="nf">foo_focus</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">widget</span><span class="p">,</span> <span class="n">GtkDirectionType</span> <span class="n">direction</span><span class="p">)</span> <span class="p">{</span> <span class="n">Foo</span> <span class="o">*</span><span class="n">foo</span> <span class="o">=</span> <span class="n">FOO</span> <span class="p">(</span><span class="n">widget</span><span class="p">);</span> <span class="n">FooPrivate</span> <span class="o">*</span><span class="n">priv</span> <span class="o">=</span> <span class="n">foo</span><span class="o">-></span><span class="n">priv</span><span class="p">;</span> <span class="n">gint</span> <span class="n">focus_row</span><span class="p">;</span> <span class="n">gboolean</span> <span class="n">have_focus</span> <span class="o">=</span> <span class="n">FALSE</span><span class="p">;</span> <span class="n">focus_row</span> <span class="o">=</span> <span class="n">priv</span><span class="o">-></span><span class="n">focus_row</span><span class="p">;</span> <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">gtk_widget_has_focus</span> <span class="p">(</span><span class="n">widget</span><span class="p">))</span> <span class="n">gtk_widget_grab_focus</span> <span class="p">(</span><span class="n">widget</span><span class="p">);</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_iter_nth_child</span> <span class="p">(</span><span class="n">priv</span><span class="o">-></span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="n">priv</span><span class="o">-></span><span class="n">focus_row</span><span class="p">);</span> <span class="k">while</span> <span class="p">(</span><span class="n">valid</span><span class="p">)</span> <span class="p">{</span> <span class="n">gtk_cell_area_apply_attributes</span> <span class="p">(</span><span class="n">priv</span><span class="o">-></span><span class="n">area</span><span class="p">,</span> <span class="n">priv</span><span class="o">-></span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">);</span> <span class="k">if</span> <span class="p">(</span><span class="n">gtk_cell_area_focus</span> <span class="p">(</span><span class="n">priv</span><span class="o">-></span><span class="n">area</span><span class="p">,</span> <span class="n">direction</span><span class="p">))</span> <span class="p">{</span> <span class="n">priv</span><span class="o">-></span><span class="n">focus_row</span> <span class="o">=</span> <span class="n">focus_row</span><span class="p">;</span> <span class="n">have_focus</span> <span class="o">=</span> <span class="n">TRUE</span><span class="p">;</span> <span class="k">break</span><span class="p">;</span> <span class="p">}</span> <span class="k">else</span> <span class="p">{</span> <span class="k">if</span> <span class="p">(</span><span class="n">direction</span> <span class="o">==</span> <span class="n">GTK_DIR_RIGHT</span> <span class="o">||</span> <span class="n">direction</span> <span class="o">==</span> <span class="n">GTK_DIR_LEFT</span><span class="p">)</span> <span class="k">break</span><span class="p">;</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="n">direction</span> <span class="o">==</span> <span class="n">GTK_DIR_UP</span> <span class="o">||</span> <span class="n">direction</span> <span class="o">==</span> <span class="n">GTK_DIR_TAB_BACKWARD</span><span class="p">)</span> <span class="p">{</span> <span class="k">if</span> <span class="p">(</span><span class="n">focus_row</span> <span class="o">==</span> <span class="mi">0</span><span class="p">)</span> <span class="k">break</span><span class="p">;</span> <span class="k">else</span> <span class="p">{</span> <span class="n">focus_row</span><span class="o">--</span><span class="p">;</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_iter_nth_child</span> <span class="p">(</span><span class="n">priv</span><span class="o">-></span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="n">focus_row</span><span class="p">);</span> <span class="p">}</span> <span class="p">}</span> <span class="k">else</span> <span class="p">{</span> <span class="k">if</span> <span class="p">(</span><span class="n">focus_row</span> <span class="o">==</span> <span class="n">last_row</span><span class="p">)</span> <span class="k">break</span><span class="p">;</span> <span class="k">else</span> <span class="p">{</span> <span class="n">focus_row</span><span class="o">++</span><span class="p">;</span> <span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_iter_next</span> <span class="p">(</span><span class="n">priv</span><span class="o">-></span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">);</span> <span class="p">}</span> <span class="p">}</span> <span class="p">}</span> <span class="p">}</span> <span class="k">return</span> <span class="n">have_focus</span><span class="p">;</span> <span class="p">}</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p>Note that the layouting widget is responsible for matching the GtkDirectionType values to the way it lays out its cells.</p> </div> <hr> <div class="refsect2"> <a name="id-1.3.12.14.10.8"></a><h3>Cell Properties</h3> <p>The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> introduces cell properties for <a href="GtkCellRenderer.html#GtkCellRenderer-struct"><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 child properties for <a href="GtkWidget.html#GtkWidget-struct"><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> </div> <div class="refsect1"> <a name="GtkCellArea.functions_details"></a><h2>Functions</h2> <div class="refsect2"> <a name="GtkCellCallback"></a><h3>GtkCellCallback ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <span class="c_punctuation">(</span>*GtkCellCallback<span class="c_punctuation">)</span> (<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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="GtkCellCallback.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the cell renderer to operate on</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>data</p></td> <td class="parameter_description"><p>user-supplied data. </p></td> <td class="parameter_annotations"><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> </tbody> </table></div> </div> <div class="refsect3"> <a name="GtkCellCallback.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop iterating over cells.</p> </div> </div> <hr> <div class="refsect2"> <a name="GtkCellAllocCallback"></a><h3>GtkCellAllocCallback ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <span class="c_punctuation">(</span>*GtkCellAllocCallback<span class="c_punctuation">)</span> (<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="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, <em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_background</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="GtkCellAllocCallback.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the cell renderer to operate on</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>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>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_background</p></td> <td class="parameter_description"><p>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>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>data</p></td> <td class="parameter_description"><p>user-supplied data. </p></td> <td class="parameter_annotations"><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> </tbody> </table></div> </div> <div class="refsect3"> <a name="GtkCellAllocCallback.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop iterating over cells.</p> </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="refsect3"> <a name="GTK-CELL-AREA-WARN-INVALID-CELL-PROPERTY-ID.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>object</p></td> <td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> on which <code class="function">set_cell_property()</code> or <code class="function">get_cell_property()</code> was called</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_id</p></td> <td class="parameter_description"><p>the numeric id of the property</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>pspec</p></td> <td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the property</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </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="refsect3"> <a name="gtk-cell-area-add.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>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> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-remove.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>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> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-has-renderer.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to check</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-has-renderer.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/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> .</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-foreach.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>callback</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html#GtkCellCallback" title="GtkCellCallback ()"><span class="type">GtkCellCallback</span></a> to call. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>callback_data</p></td> <td class="parameter_description"><p>user provided data pointer</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, <em class="parameter"><code>const <a href="../html/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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-foreach-alloc.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> for this row of data.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the <em class="parameter"><code>widget</code></em> relative coordinates and size for <em class="parameter"><code>area</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>background_area</p></td> <td class="parameter_description"><p>the <em class="parameter"><code>widget</code></em> relative coordinates of the background area</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>callback</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()"><span class="type">GtkCellAllocCallback</span></a> to call. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>callback_data</p></td> <td class="parameter_description"><p>user provided data pointer</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p> </div> <hr> <div class="refsect2"> <a name="gtk-cell-area-event"></a><h3>gtk_cell_area_event ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, <em class="parameter"><code>const <a href="../html/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="refsect3"> <a name="gtk-cell-area-event.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> for this row of data.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>event</p></td> <td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to handle</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the <em class="parameter"><code>widget</code></em> relative coordinates for <em class="parameter"><code>area</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>flags</p></td> <td class="parameter_description"><p>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.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-event.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/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> .</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>, <em class="parameter"><code>const <a href="../html/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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-render.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> for this row of data.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cr</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>background_area</p></td> <td class="parameter_description"><p>the <em class="parameter"><code>widget</code></em> relative coordinates for <em class="parameter"><code>area</code></em> ’s background</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the <em class="parameter"><code>widget</code></em> relative coordinates for <em class="parameter"><code>area</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>flags</p></td> <td class="parameter_description"><p>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.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>paint_focus</p></td> <td class="parameter_description"><p>whether <em class="parameter"><code>area</code></em> should paint focus on focused cells for focused rows or not.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, <em class="parameter"><code><a href="../html/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="refsect3"> <a name="gtk-cell-area-get-cell-allocation.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>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> .</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to get the allocation for</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the whole allocated area for <em class="parameter"><code>area</code></em> in <em class="parameter"><code>widget</code></em> for this row</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>allocation</p></td> <td class="parameter_description"><p>where to store the allocation for <em class="parameter"><code>renderer</code></em> . </p></td> <td class="parameter_annotations"><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> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>, <em class="parameter"><code><a href="../html/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="refsect3"> <a name="gtk-cell-area-get-cell-at-position.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>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> .</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the whole allocated area for <em class="parameter"><code>area</code></em> in <em class="parameter"><code>widget</code></em> for this row</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>x</p></td> <td class="parameter_description"><p>the x position</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>y</p></td> <td class="parameter_description"><p>the y position</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>alloc_area</p></td> <td class="parameter_description"><p>where to store the inner allocated area of the returned cell renderer, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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> </div> <div class="refsect3"> <a name="gtk-cell-area-get-cell-at-position.returns"></a><h4>Returns</h4> <p>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> . </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-create-context.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-create-context.returns"></a><h4>Returns</h4> <p>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> . </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-copy-context.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> to copy</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-copy-context.returns"></a><h4>Returns</h4> <p>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> . </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-get-request-mode.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-get-request-mode.returns"></a><h4>Returns</h4> <p> 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> .</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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, it’s 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="refsect3"> <a name="gtk-cell-area-get-preferred-width.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> to perform this request with</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum_width</p></td> <td class="parameter_description"><p>location to store the minimum width, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>natural_width</p></td> <td class="parameter_description"><p>location to store the natural width, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-get-preferred-height-for-width.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> which has already been requested for widths.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>width</p></td> <td class="parameter_description"><p>the width for which to check the height of this area</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum_height</p></td> <td class="parameter_description"><p>location to store the minimum height, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>natural_height</p></td> <td class="parameter_description"><p>location to store the natural height, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_height</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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, it’s 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="refsect3"> <a name="gtk-cell-area-get-preferred-height.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> to perform this request with</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum_height</p></td> <td class="parameter_description"><p>location to store the minimum height, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>natural_height</p></td> <td class="parameter_description"><p>location to store the natural height, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_width</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-get-preferred-width-for-height.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> which has already been requested for widths.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>height</p></td> <td class="parameter_description"><p>the height for which to check the width of this area</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum_width</p></td> <td class="parameter_description"><p>location to store the minimum width, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>natural_width</p></td> <td class="parameter_description"><p>location to store the natural width, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-get-current-path-string.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-get-current-path-string.returns"></a><h4>Returns</h4> <p> 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.</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expander</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-apply-attributes.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>tree_model</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> to pull values from</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>iter</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>is_expander</p></td> <td class="parameter_description"><p>whether <em class="parameter"><code>iter</code></em> has children</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>is_expanded</p></td> <td class="parameter_description"><p>whether <em class="parameter"><code>iter</code></em> is expanded in the view and children are visible</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-attribute-connect.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to connect an attribute for</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>attribute</p></td> <td class="parameter_description"><p>the attribute name</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>column</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> column to fetch attribute values from</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-attribute-disconnect.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to disconnect an attribute for</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>attribute</p></td> <td class="parameter_description"><p>the attribute name</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p> </div> <hr> <div class="refsect2"> <a name="gtk-cell-area-attribute-get-column"></a><h3>gtk_cell_area_attribute_get_column ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_cell_area_attribute_get_column (<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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>);</pre> <p>Returns the model column that an attribute has been mapped to, or -1 if the attribute is not mapped.</p> <div class="refsect3"> <a name="gtk-cell-area-attribute-get-column.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>attribute</p></td> <td class="parameter_description"><p>an attribute on the renderer</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-attribute-get-column.returns"></a><h4>Returns</h4> <p> the model column, or -1</p> </div> <p class="since">Since: <a class="link" href="api-index-3-14.html#api-index-3.14">3.14</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/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="refsect3"> <a name="gtk-cell-area-class-install-cell-property.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>aclass</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_id</p></td> <td class="parameter_description"><p>the id for the property</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>pspec</p></td> <td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/gobject/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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-class-find-cell-property.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>aclass</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>the name of the child property to find</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-class-find-cell-property.returns"></a><h4>Returns</h4> <p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the child property or <a href="/usr/share/gtk-doc/html/glib/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. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/gobject/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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-class-list-cell-properties.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>aclass</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html#GtkCellAreaClass" title="struct GtkCellAreaClass"><span class="type">GtkCellAreaClass</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>n_properties</p></td> <td class="parameter_description"><p>location to return the number of cell properties found. </p></td> <td class="parameter_annotations"><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> </div> <div class="refsect3"> <a name="gtk-cell-area-class-list-cell-properties.returns"></a><h4>Returns</h4> <p>a newly allocated <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>*. The array must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p> <p><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></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-add-with-properties.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>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> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>first_prop_name</p></td> <td class="parameter_description"><p>the name of the first cell property to set</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>...</p></td> <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/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> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-cell-set.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>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> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>first_prop_name</p></td> <td class="parameter_description"><p>the name of the first cell property to set</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>...</p></td> <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/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> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-cell-get.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>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> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>first_prop_name</p></td> <td class="parameter_description"><p>the name of the first cell property to get</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>...</p></td> <td class="parameter_description"><p>return location for the first cell property, followed optionally by more name/return location pairs, followed by <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-cell-set-valist.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> which inside <em class="parameter"><code>area</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>first_property_name</p></td> <td class="parameter_description"><p>the name of the first cell property to set</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>var_args</p></td> <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/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> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-cell-get-valist.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> inside <em class="parameter"><code>area</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>first_property_name</p></td> <td class="parameter_description"><p>the name of the first property to get</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>var_args</p></td> <td class="parameter_description"><p>return location for the first property, followed optionally by more name/return location pairs, followed by <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>, <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><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="refsect3"> <a name="gtk-cell-area-cell-set-property.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> inside <em class="parameter"><code>area</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>the name of the cell property to set</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>value</p></td> <td class="parameter_description"><p>the value to set the cell property to</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><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="refsect3"> <a name="gtk-cell-area-cell-get-property.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> inside <em class="parameter"><code>area</code></em> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>the name of the property to get</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>value</p></td> <td class="parameter_description"><p>a location to return the value</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-is-activatable.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-is-activatable.returns"></a><h4>Returns</h4> <p> whether <em class="parameter"><code>area</code></em> can do anything when activated.</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p> </div> <hr> <div class="refsect2"> <a name="gtk-cell-area-activate"></a><h3>gtk_cell_area_activate ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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="../html/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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-activate.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>context</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> in context with the current row data</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the size and location of <em class="parameter"><code>area</code></em> relative to <em class="parameter"><code>widget</code></em> ’s allocation</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>flags</p></td> <td class="parameter_description"><p>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.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>edit_only</p></td> <td class="parameter_description"><p>if <a href="/usr/share/gtk-doc/html/glib/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.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-activate.returns"></a><h4>Returns</h4> <p> Whether <em class="parameter"><code>area</code></em> was successfully activated.</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p> </div> <hr> <div class="refsect2"> <a name="gtk-cell-area-focus"></a><h3>gtk_cell_area_focus ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-focus.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>direction</p></td> <td class="parameter_description"><p>the <a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-focus.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/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.</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-set-focus-cell.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to give focus to</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-get-focus-cell.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-get-focus-cell.returns"></a><h4>Returns</h4> <p>the currently focused cell in <em class="parameter"><code>area</code></em> . </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-add-focus-sibling.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>sibling</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-remove-focus-sibling.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>sibling</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-is-focus-sibling.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>sibling</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-is-focus-sibling.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/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> </p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-get-focus-siblings.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> expected to have focus</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-get-focus-siblings.returns"></a><h4>Returns</h4> <p>A <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a href="GtkCellRenderer.html#GtkCellRenderer-struct"><span class="type">GtkCellRenderers</span></a>. The returned list is internal and should not be freed. </p> <p><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></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-get-focus-from-sibling.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-get-focus-from-sibling.returns"></a><h4>Returns</h4> <p>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="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-get-edited-cell.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-get-edited-cell.returns"></a><h4>Returns</h4> <p>The currently edited <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="refsect3"> <a name="gtk-cell-area-get-edit-widget.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-get-edit-widget.returns"></a><h4>Returns</h4> <p>The currently active <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> widget. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, <em class="parameter"><code>const <a href="../html/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="refsect3"> <a name="gtk-cell-area-activate-cell.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>event</p></td> <td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> for which cell activation should occur</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the <a href="../html/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.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>flags</p></td> <td class="parameter_description"><p>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> </p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-cell-area-activate-cell.returns"></a><h4>Returns</h4> <p> whether cell activation was successful</p> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-stop-editing.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>canceled</p></td> <td class="parameter_description"><p>whether editing was canceled.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>, <em class="parameter"><code><a href="../html/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="refsect3"> <a name="gtk-cell-area-inner-cell-area.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>inner_area</p></td> <td class="parameter_description"><p>the return location for the inner cell area. </p></td> <td class="parameter_annotations"><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> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> for_size</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *minimum_size</code></em>, <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-cell-area-request-renderer.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to request size for</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>orientation</p></td> <td class="parameter_description"><p>the <a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> in which to request size</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>for_size</p></td> <td class="parameter_description"><p>the allocation contextual size to request for, or -1 if the base request for the orientation is to be returned.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum_size</p></td> <td class="parameter_description"><p>location to store the minimum size, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>natural_size</p></td> <td class="parameter_description"><p>location to store the natural size, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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> </div> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p> </div> </div> <div class="refsect1"> <a name="GtkCellArea.other_details"></a><h2>Types and Values</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="refsect3"> <a name="GtkCellAreaClass.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="struct_members_name"> <col class="struct_members_description"> <col width="200px" class="struct_members_annotations"> </colgroup> <tbody> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.add"></a>add</code></em> ()</p></td> <td class="struct_member_description"><p>adds a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> to the area.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.remove"></a>remove</code></em> ()</p></td> <td class="struct_member_description"><p>removes a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> from the area.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.foreach"></a>foreach</code></em> ()</p></td> <td class="struct_member_description"><p>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="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.foreach-alloc"></a>foreach_alloc</code></em> ()</p></td> <td class="struct_member_description"><p>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="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.event"></a>event</code></em> ()</p></td> <td class="struct_member_description"><p>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#GtkWidget-struct"><span class="type">GtkWidgets</span></a> drawn onto the area.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.render"></a>render</code></em> ()</p></td> <td class="struct_member_description"><p>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.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.apply-attributes"></a>apply_attributes</code></em> ()</p></td> <td class="struct_member_description"><p>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.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.create-context"></a>create_context</code></em> ()</p></td> <td class="struct_member_description"><p>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.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.copy-context"></a>copy_context</code></em> ()</p></td> <td class="struct_member_description"><p>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.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.get-request-mode"></a>get_request_mode</code></em> ()</p></td> <td class="struct_member_description"><p>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.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-width"></a>get_preferred_width</code></em> ()</p></td> <td class="struct_member_description"><p>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>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-height-for-width"></a>get_preferred_height_for_width</code></em> ()</p></td> <td class="struct_member_description"><p>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.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-height"></a>get_preferred_height</code></em> ()</p></td> <td class="struct_member_description"><p>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>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.get-preferred-width-for-height"></a>get_preferred_width_for_height</code></em> ()</p></td> <td class="struct_member_description"><p>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.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.set-cell-property"></a>set_cell_property</code></em> ()</p></td> <td class="struct_member_description"><p>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>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.get-cell-property"></a>get_cell_property</code></em> ()</p></td> <td class="struct_member_description"><p>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>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.focus"></a>focus</code></em> ()</p></td> <td class="struct_member_description"><p>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="/usr/share/gtk-doc/html/glib/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>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.is-activatable"></a>is_activatable</code></em> ()</p></td> <td class="struct_member_description"><p>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#GtkCellRenderer-struct"><span class="type">GtkCellRenderers</span></a>.</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkCellAreaClass.activate"></a>activate</code></em> ()</p></td> <td class="struct_member_description"><p>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>).</p></td> <td class="struct_member_annotations"> </td> </tr> </tbody> </table></div> </div> </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> *</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>Owner: GtkCellArea</p> <p>Flags: Read</p> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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> *</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>Owner: GtkCellArea</p> <p>Flags: Read</p> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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> *</pre> <p>The cell in the area that currently has focus</p> <p>Owner: GtkCellArea</p> <p>Flags: Read / Write</p> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area, <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path, <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</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="refsect3"> <a name="GtkCellArea-add-editable.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> where editing started</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> that started the edited</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>editable</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> widget to add</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>cell_area</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> relative <a href="../html/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</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>path</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> string this edit was initiated for</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>user_data</p></td> <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expander, <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_expanded, <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</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="refsect3"> <a name="GtkCellArea-apply-attributes.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> to apply the attributes to</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>model</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> to apply the attributes from</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>iter</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> indicating which row to apply the attributes of</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>is_expander</p></td> <td class="parameter_description"><p>whether the view shows children for this row</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>is_expanded</p></td> <td class="parameter_description"><p>whether the view is currently showing the children of this row</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>user_data</p></td> <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path, <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</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="refsect3"> <a name="GtkCellArea-focus-changed.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> where focus changed</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> that has focus</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>path</p></td> <td class="parameter_description"><p>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> </p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>user_data</p></td> <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</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="refsect3"> <a name="GtkCellArea-remove-editable.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>area</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> where editing finished</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>renderer</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> that finished editeding</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>editable</p></td> <td class="parameter_description"><p>the <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> widget to remove</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>user_data</p></td> <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p> <p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p> </div> </div> </div> <div class="footer"> <hr>Generated by GTK-Doc V1.32</div> </body> </html>