3885 lines
232 KiB
HTML
3885 lines
232 KiB
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 Vsnapshot">
|
||
<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.33.1 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gint</span>
|
||
</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 <span class="returnvalue">gchar</span> *
|
||
</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">
|
||
<span class="returnvalue">gint</span>
|
||
</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">
|
||
<span class="returnvalue">GParamSpec</span> *
|
||
</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">
|
||
<span class="returnvalue">GParamSpec</span> **
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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 <span class="returnvalue">GList</span> *
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">Run First</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">Run First</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">Run First</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">Run First</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"> GObject
|
||
<span class="lineart">╰──</span> GInitiallyUnowned
|
||
<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="w"> </span><span class="n">iter</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">minimum_width</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">natural_width</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_get_iter_first</span><span class="w"> </span><span class="p">(</span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
<span class="k">while</span><span class="w"> </span><span class="p">(</span><span class="n">valid</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gtk_cell_area_apply_attributes</span><span class="w"> </span><span class="p">(</span><span class="n">area</span><span class="p">,</span><span class="w"> </span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gtk_cell_area_get_preferred_width</span><span class="w"> </span><span class="p">(</span><span class="n">area</span><span class="p">,</span><span class="w"> </span><span class="n">context</span><span class="p">,</span><span class="w"> </span><span class="n">widget</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_iter_next</span><span class="w"> </span><span class="p">(</span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="n">gtk_cell_area_context_get_preferred_width</span><span class="w"> </span><span class="p">(</span><span class="n">context</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">minimum_width</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">natural_width</span><span class="p">);</span><span class="w"></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 <code class="function">g_timeout_add()</code>) 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="w"> </span><span class="kt">void</span><span class="w"></span>
|
||
<span class="nf">foo_get_preferred_width</span><span class="w"> </span><span class="p">(</span><span class="n">GtkWidget</span><span class="w"> </span><span class="o">*</span><span class="n">widget</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gint</span><span class="w"> </span><span class="o">*</span><span class="n">minimum_size</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gint</span><span class="w"> </span><span class="o">*</span><span class="n">natural_size</span><span class="p">)</span><span class="w"></span>
|
||
<span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">Foo</span><span class="w"> </span><span class="o">*</span><span class="n">foo</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">FOO</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">FooPrivate</span><span class="w"> </span><span class="o">*</span><span class="n">priv</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">foo</span><span class="o">-></span><span class="n">priv</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">foo_ensure_at_least_one_handfull_of_rows_have_been_requested</span><span class="w"> </span><span class="p">(</span><span class="n">foo</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">gtk_cell_area_context_get_preferred_width</span><span class="w"> </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="w"> </span><span class="n">minimum_size</span><span class="p">,</span><span class="w"> </span><span class="n">natural_size</span><span class="p">);</span><span class="w"></span>
|
||
<span class="p">}</span><span class="w"></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="w"> </span><span class="n">iter</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">minimum_height</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">natural_height</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">full_minimum_height</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">full_natural_height</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_get_iter_first</span><span class="w"> </span><span class="p">(</span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
<span class="k">while</span><span class="w"> </span><span class="p">(</span><span class="n">valid</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gtk_cell_area_apply_attributes</span><span class="w"> </span><span class="p">(</span><span class="n">area</span><span class="p">,</span><span class="w"> </span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gtk_cell_area_get_preferred_height_for_width</span><span class="w"> </span><span class="p">(</span><span class="n">area</span><span class="p">,</span><span class="w"> </span><span class="n">context</span><span class="p">,</span><span class="w"> </span><span class="n">widget</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">width</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">minimum_height</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">natural_height</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">width_is_for_allocation</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">cache_row_height</span><span class="w"> </span><span class="p">(</span><span class="o">&</span><span class="n">iter</span><span class="p">,</span><span class="w"> </span><span class="n">minimum_height</span><span class="p">,</span><span class="w"> </span><span class="n">natural_height</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">full_minimum_height</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="n">minimum_height</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">full_natural_height</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="n">natural_height</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_iter_next</span><span class="w"> </span><span class="p">(</span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></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="w"> </span><span class="n">allocation</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">GdkRectangle</span><span class="w"> </span><span class="n">cell_area</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="p">};</span><span class="w"></span>
|
||
<span class="n">GtkTreeIter</span><span class="w"> </span><span class="n">iter</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">minimum_width</span><span class="p">;</span><span class="w"></span>
|
||
<span class="n">gint</span><span class="w"> </span><span class="n">natural_width</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="n">gtk_widget_get_allocation</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">allocation</span><span class="p">);</span><span class="w"></span>
|
||
<span class="n">cell_area</span><span class="p">.</span><span class="n">width</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">allocation</span><span class="p">.</span><span class="n">width</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_get_iter_first</span><span class="w"> </span><span class="p">(</span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
<span class="k">while</span><span class="w"> </span><span class="p">(</span><span class="n">valid</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">cell_area</span><span class="p">.</span><span class="n">height</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">get_cached_height_for_row</span><span class="w"> </span><span class="p">(</span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">gtk_cell_area_apply_attributes</span><span class="w"> </span><span class="p">(</span><span class="n">area</span><span class="p">,</span><span class="w"> </span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gtk_cell_area_render</span><span class="w"> </span><span class="p">(</span><span class="n">area</span><span class="p">,</span><span class="w"> </span><span class="n">context</span><span class="p">,</span><span class="w"> </span><span class="n">widget</span><span class="p">,</span><span class="w"> </span><span class="n">cr</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="o">&</span><span class="n">cell_area</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">cell_area</span><span class="p">,</span><span class="w"> </span><span class="n">state_flags</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">cell_area</span><span class="p">.</span><span class="n">y</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="n">cell_area</span><span class="p">.</span><span class="n">height</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_iter_next</span><span class="w"> </span><span class="p">(</span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></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="w"> </span><span class="n">gboolean</span><span class="w"></span>
|
||
<span class="nf">foo_focus</span><span class="w"> </span><span class="p">(</span><span class="n">GtkWidget</span><span class="w"> </span><span class="o">*</span><span class="n">widget</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">GtkDirectionType</span><span class="w"> </span><span class="n">direction</span><span class="p">)</span><span class="w"></span>
|
||
<span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">Foo</span><span class="w"> </span><span class="o">*</span><span class="n">foo</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">FOO</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">FooPrivate</span><span class="w"> </span><span class="o">*</span><span class="n">priv</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">foo</span><span class="o">-></span><span class="n">priv</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gint</span><span class="w"> </span><span class="n">focus_row</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gboolean</span><span class="w"> </span><span class="n">have_focus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">FALSE</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">focus_row</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">priv</span><span class="o">-></span><span class="n">focus_row</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">gtk_widget_has_focus</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">))</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gtk_widget_grab_focus</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_iter_nth_child</span><span class="w"> </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="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">,</span><span class="w"> </span><span class="n">priv</span><span class="o">-></span><span class="n">focus_row</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">while</span><span class="w"> </span><span class="p">(</span><span class="n">valid</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gtk_cell_area_apply_attributes</span><span class="w"> </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="w"> </span><span class="n">priv</span><span class="o">-></span><span class="n">model</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">,</span><span class="w"> </span><span class="n">FALSE</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">gtk_cell_area_focus</span><span class="w"> </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="w"> </span><span class="n">direction</span><span class="p">))</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">priv</span><span class="o">-></span><span class="n">focus_row</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">focus_row</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">have_focus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">TRUE</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">break</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">else</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">direction</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GTK_DIR_RIGHT</span><span class="w"> </span><span class="o">||</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">direction</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GTK_DIR_LEFT</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">break</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">direction</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GTK_DIR_UP</span><span class="w"> </span><span class="o">||</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">direction</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GTK_DIR_TAB_BACKWARD</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">focus_row</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">break</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">else</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">focus_row</span><span class="o">--</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_iter_nth_child</span><span class="w"> </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="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">,</span><span class="w"> </span><span class="n">focus_row</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">else</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">focus_row</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">last_row</span><span class="p">)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">break</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">else</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">focus_row</span><span class="o">++</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">valid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_tree_model_iter_next</span><span class="w"> </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="w"> </span><span class="o">&</span><span class="n">iter</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">have_focus</span><span class="p">;</span><span class="w"></span>
|
||
<span class="p">}</span><span class="w"></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"><span class="returnvalue">gboolean</span>
|
||
<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><span class="type">gpointer</span> 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> <code class="literal">TRUE</code> to stop iterating over cells.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkCellAllocCallback"></a><h3>GtkCellAllocCallback ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
<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 <span class="type">GdkRectangle</span> *cell_area</code></em>,
|
||
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_background</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> 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> <code class="literal">TRUE</code> 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 <span class="type">GObject</span> 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 <span class="type">GParamSpec</span> 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"><span class="returnvalue">gboolean</span>
|
||
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> <code class="literal">TRUE</code> 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><span class="type">gpointer</span> 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 <span class="type">GdkRectangle</span> *cell_area</code></em>,
|
||
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *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><span class="type">gpointer</span> 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"><span class="returnvalue">gint</span>
|
||
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><span class="type">GdkEvent</span> *event</code></em>,
|
||
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *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 <span class="type">GdkEvent</span> 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> <code class="literal">TRUE</code> 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 <span class="type">GdkRectangle</span> *background_area</code></em>,
|
||
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *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><span class="type">gboolean</span> 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 <span class="type">GdkRectangle</span> *cell_area</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkRectangle</span> *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 <span class="type">GdkRectangle</span> *cell_area</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> y</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkRectangle</span> *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 <code class="literal">NULL</code>. </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="The data is owned by the callee, which is responsible of freeing it."><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="The caller owns the data, and is responsible for free it."><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="The caller owns the data, and is responsible for free it."><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><span class="type">gint</span> *minimum_width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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><span class="type">gint</span> width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *minimum_height</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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><span class="type">gint</span> *minimum_height</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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><span class="type">gint</span> height</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *minimum_width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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 <span class="returnvalue">gchar</span> *
|
||
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><span class="type">gboolean</span> is_expander</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> 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 <span class="type">gchar</span> *attribute</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> 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 <span class="type">gchar</span> *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"><span class="returnvalue">gint</span>
|
||
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 <span class="type">gchar</span> *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><span class="type">guint</span> property_id</code></em>,
|
||
<em class="parameter"><code><span class="type">GParamSpec</span> *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 <span class="type">GParamSpec</span> 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"><span class="returnvalue">GParamSpec</span> *
|
||
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 <span class="type">gchar</span> *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 <span class="type">GParamSpec</span> of the child property
|
||
or <code class="literal">NULL</code> if <em class="parameter"><code>aclass</code></em>
|
||
has no child property with that name. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><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"><span class="returnvalue">GParamSpec</span> **
|
||
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><span class="type">guint</span> *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 <code class="literal">NULL</code>-terminated array of <span class="type">GParamSpec</span>*. The array
|
||
must be freed with <code class="function">g_free()</code>. </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="The caller owns the data container, but not the data inside it."><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 <span class="type">gchar</span> *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 <code class="literal">NULL</code>-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 <span class="type">gchar</span> *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 <code class="literal">NULL</code>-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 <span class="type">gchar</span> *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 <code class="literal">NULL</code></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 <span class="type">gchar</span> *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 <code class="literal">NULL</code>-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 <span class="type">gchar</span> *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 <code class="literal">NULL</code></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 <span class="type">gchar</span> *property_name</code></em>,
|
||
<em class="parameter"><code>const <span class="type">GValue</span> *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 <span class="type">gchar</span> *property_name</code></em>,
|
||
<em class="parameter"><code><span class="type">GValue</span> *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"><span class="returnvalue">gboolean</span>
|
||
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"><span class="returnvalue">gboolean</span>
|
||
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 <span class="type">GdkRectangle</span> *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><span class="type">gboolean</span> 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 <code class="literal">TRUE</code> 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"><span class="returnvalue">gboolean</span>
|
||
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> <code class="literal">TRUE</code> 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="The data is owned by the callee, which is responsible of freeing it."><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"><span class="returnvalue">gboolean</span>
|
||
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> <code class="literal">TRUE</code> 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 <span class="returnvalue">GList</span> *
|
||
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 <span class="type">GList</span> 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="The data is owned by the callee, which is responsible of freeing it."><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 <code class="literal">NULL</code>. </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="The data is owned by the callee, which is responsible of freeing it."><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="The data is owned by the callee, which is responsible of freeing it."><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="The data is owned by the callee, which is responsible of freeing it."><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"><span class="returnvalue">gboolean</span>
|
||
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><span class="type">GdkEvent</span> *event</code></em>,
|
||
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *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 <span class="type">GdkEvent</span> 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 <span class="type">GdkRectangle</span> 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><span class="type">gboolean</span> 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 <code class="literal">TRUE</code>, 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 <span class="type">GdkRectangle</span> *cell_area</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkRectangle</span> *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><span class="type">gint</span> for_size</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *minimum_size</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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 <code class="literal">TRUE</code>.</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 <code class="literal">TRUE</code>.</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 <code class="literal">FALSE</code> 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,
|
||
<span class="type">GdkRectangle</span> *cell_area,
|
||
<span class="type">char</span> *path,
|
||
<span class="type">gpointer</span> 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 <span class="type">GdkRectangle</span> 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: Run First</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,
|
||
<span class="type">gboolean</span> is_expander,
|
||
<span class="type">gboolean</span> is_expanded,
|
||
<span class="type">gpointer</span> 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: Run First</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,
|
||
<span class="type">char</span> *path,
|
||
<span class="type">gpointer</span> 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: Run First</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,
|
||
<span class="type">gpointer</span> 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: Run First</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.33.1</div>
|
||
</body>
|
||
</html> |