New upstream version 3.23.2
This commit is contained in:
Andrea Azzarone
@ -3,12 +3,12 @@
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||||
<title>GtkTreeView: GTK+ 3 Reference Manual</title>
|
||||
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
|
||||
<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="GtkTreeViewColumn.html" title="GtkTreeViewColumn">
|
||||
<link rel="next" href="gtk3-GtkTreeView-drag-and-drop.html" title="GtkTreeView drag-and-drop">
|
||||
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
|
||||
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
|
||||
<link rel="stylesheet" href="style.css" type="text/css">
|
||||
</head>
|
||||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||||
@ -510,7 +510,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
|
||||
<span class="returnvalue">GdkWindow</span> *
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkTreeView.html#gtk-tree-view-get-bin-window" title="gtk_tree_view_get_bin_window ()">gtk_tree_view_get_bin_window</a> <span class="c_punctuation">()</span>
|
||||
@ -1023,7 +1023,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="property_type">
|
||||
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
|
||||
<span class="type">GdkColor</span> *</td>
|
||||
<td class="property_name"><a class="link" href="GtkTreeView.html#GtkTreeView--s-even-row-color" title="The “even-row-color” style property">even-row-color</a></td>
|
||||
<td class="property_flags">Read</td>
|
||||
</tr>
|
||||
@ -1055,7 +1055,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="property_type">
|
||||
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
|
||||
<span class="type">GdkColor</span> *</td>
|
||||
<td class="property_name"><a class="link" href="GtkTreeView.html#GtkTreeView--s-odd-row-color" title="The “odd-row-color” style property">odd-row-color</a></td>
|
||||
<td class="property_flags">Read</td>
|
||||
</tr>
|
||||
@ -1205,7 +1205,7 @@
|
||||
<a name="GtkTreeView.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
|
||||
<p>
|
||||
GtkTreeView implements
|
||||
AtkImplementor, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a> and <a class="link" href="GtkScrollable.html" title="GtkScrollable">GtkScrollable</a>.</p>
|
||||
AtkImplementorIface, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a> and <a class="link" href="GtkScrollable.html" title="GtkScrollable">GtkScrollable</a>.</p>
|
||||
</div>
|
||||
<div class="refsect1">
|
||||
<a name="GtkTreeView.includes"></a><h2>Includes</h2>
|
||||
@ -1241,41 +1241,81 @@ former you can use <a class="link" href="GtkTreeView.html#gtk-tree-view-convert-
|
||||
<a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> objects as <child> elements and exposes the internal
|
||||
<a class="link" href="GtkTreeSelection.html" title="GtkTreeSelection"><span class="type">GtkTreeSelection</span></a> in UI definitions.</p>
|
||||
<p>An example of a UI definition fragment with GtkTreeView:</p>
|
||||
<div class="informalexample"><pre class="programlisting">
|
||||
<object class="GtkTreeView" id="treeview">
|
||||
<property name="model">liststore1</property>
|
||||
<child>
|
||||
<object class="GtkTreeViewColumn" id="test-column">
|
||||
<property name="title">Test</property>
|
||||
<child>
|
||||
<object class="GtkCellRendererText" id="test-renderer"/>
|
||||
<attributes>
|
||||
<attribute name="text">1</attribute>
|
||||
</attributes>
|
||||
</child>
|
||||
</object>
|
||||
</child>
|
||||
<child internal-child="selection">
|
||||
<object class="GtkTreeSelection" id="selection">
|
||||
<signal name="changed" handler="on_treeview_selection_changed"/>
|
||||
</object>
|
||||
</child>
|
||||
</object>
|
||||
</pre></div>
|
||||
<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</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkTreeView"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"treeview"</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"model"</span><span class="symbol">></span><span class="normal">liststore1</span><span class="symbol"></</span><span class="normal">property</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkTreeViewColumn"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"test-column"</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"title"</span><span class="symbol">></span><span class="normal">Test</span><span class="symbol"></</span><span class="normal">property</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkCellRendererText"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"test-renderer"</span><span class="symbol">/></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">attributes</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"text"</span><span class="symbol">></span><span class="number">1</span><span class="symbol"></</span><span class="normal">attribute</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">attributes</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">object</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">child</span><span class="normal"> internal</span><span class="symbol">-</span><span class="normal">child</span><span class="symbol">=</span><span class="string">"selection"</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkTreeSelection"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"selection"</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">signal</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"changed"</span><span class="normal"> handler</span><span class="symbol">=</span><span class="string">"on_treeview_selection_changed"</span><span class="symbol">/></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">object</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="symbol"></</span><span class="normal">object</span><span class="symbol">></span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<p></p>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="id-1.3.12.6.11.10"></a><h3>CSS nodes</h3>
|
||||
<div class="informalexample"><pre class="programlisting">
|
||||
treeview.view
|
||||
├── header
|
||||
│ ├── <column header>
|
||||
┊ ┊
|
||||
│ ╰── <column header>
|
||||
│
|
||||
╰── [rubberband]
|
||||
</pre></div>
|
||||
<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</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="normal">treeview</span><span class="symbol">.</span><span class="normal">view</span>
|
||||
<span class="normal">├── header</span>
|
||||
<span class="normal">│ ├── </span><span class="symbol"><</span><span class="usertype">column</span><span class="normal"> header</span><span class="symbol">></span>
|
||||
<span class="normal">┊ ┊</span>
|
||||
<span class="normal">│ ╰── </span><span class="symbol"><</span><span class="usertype">column</span><span class="normal"> header</span><span class="symbol">></span>
|
||||
<span class="normal">│</span>
|
||||
<span class="normal">╰── </span><span class="symbol">[</span><span class="normal">rubberband</span><span class="symbol">]</span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<p></p>
|
||||
<p>GtkTreeView has a main CSS node with name treeview and style class .view.
|
||||
It has a subnode with name header, which is the parent for all the column
|
||||
@ -3475,7 +3515,7 @@ cell can be placed, or <code class="literal">NULL</code>. </p></td>
|
||||
gtk_tree_view_get_cell_area (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> *column</code></em>,
|
||||
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
|
||||
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
|
||||
<p>Fills the bounding rectangle in bin_window coordinates for the cell at the
|
||||
row specified by <em class="parameter"><code>path</code></em>
|
||||
and the column specified by <em class="parameter"><code>column</code></em>
|
||||
@ -3535,7 +3575,7 @@ realized.</p>
|
||||
gtk_tree_view_get_background_area (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> *column</code></em>,
|
||||
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
|
||||
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
|
||||
<p>Fills the bounding rectangle in bin_window coordinates for the cell at the
|
||||
row specified by <em class="parameter"><code>path</code></em>
|
||||
and the column specified by <em class="parameter"><code>column</code></em>
|
||||
@ -3593,7 +3633,7 @@ itself, excluding surrounding borders and the tree expander area.</p>
|
||||
<a name="gtk-tree-view-get-visible-rect"></a><h3>gtk_tree_view_get_visible_rect ()</h3>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_tree_view_get_visible_rect (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
|
||||
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *visible_rect</code></em>);</pre>
|
||||
<em class="parameter"><code><span class="type">GdkRectangle</span> *visible_rect</code></em>);</pre>
|
||||
<p>Fills <em class="parameter"><code>visible_rect</code></em>
|
||||
with the currently-visible region of the
|
||||
buffer, in tree coordinates. Convert to bin_window coordinates with
|
||||
@ -3674,7 +3714,7 @@ and <em class="parameter"><code>end_path</code></em>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-tree-view-get-bin-window"></a><h3>gtk_tree_view_get_bin_window ()</h3>
|
||||
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
|
||||
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
|
||||
gtk_tree_view_get_bin_window (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>);</pre>
|
||||
<p>Returns the window that <em class="parameter"><code>tree_view</code></em>
|
||||
renders to.
|
||||
@ -3698,7 +3738,7 @@ to confirm that the event on <em class="parameter"><code>tree_view</code></em>
|
||||
</div>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-tree-view-get-bin-window.returns"></a><h4>Returns</h4>
|
||||
<p>A <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code> when <em class="parameter"><code>tree_view</code></em>
|
||||
<p>A <span class="type">GdkWindow</span>, or <code class="literal">NULL</code> when <em class="parameter"><code>tree_view</code></em>
|
||||
hasn’t been realized yet. </p>
|
||||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||||
</div>
|
||||
@ -4016,7 +4056,7 @@ tree (the full scrollable area of the tree).</p>
|
||||
gtk_tree_view_enable_model_drag_dest (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
|
||||
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
|
||||
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>,
|
||||
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
|
||||
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
|
||||
<p>Turns <em class="parameter"><code>tree_view</code></em>
|
||||
into a drop destination for automatic DND. Calling
|
||||
this method sets <a class="link" href="GtkTreeView.html#GtkTreeView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <code class="literal">FALSE</code>.</p>
|
||||
@ -4062,10 +4102,10 @@ widget</p></td>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_tree_view_enable_model_drag_source
|
||||
(<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
|
||||
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> start_button_mask</code></em>,
|
||||
<em class="parameter"><code><span class="type">GdkModifierType</span> start_button_mask</code></em>,
|
||||
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
|
||||
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>,
|
||||
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
|
||||
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
|
||||
<p>Turns <em class="parameter"><code>tree_view</code></em>
|
||||
into a drag source for automatic DND. Calling this
|
||||
method sets <a class="link" href="GtkTreeView.html#GtkTreeView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <code class="literal">FALSE</code>.</p>
|
||||
@ -5836,7 +5876,7 @@ in <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="GtkTreeView--s-even-row-color"></a><h3>The <code class="literal">“even-row-color”</code> style property</h3>
|
||||
<pre class="programlisting"> “even-row-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
|
||||
<pre class="programlisting"> “even-row-color” <span class="type">GdkColor</span> *</pre>
|
||||
<p>Color to use for even rows.</p>
|
||||
<p>Flags: Read</p>
|
||||
</div>
|
||||
@ -5886,7 +5926,7 @@ in <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="GtkTreeView--s-odd-row-color"></a><h3>The <code class="literal">“odd-row-color”</code> style property</h3>
|
||||
<pre class="programlisting"> “odd-row-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
|
||||
<pre class="programlisting"> “odd-row-color” <span class="type">GdkColor</span> *</pre>
|
||||
<p>Color to use for odd rows.</p>
|
||||
<p>Flags: Read</p>
|
||||
</div>
|
||||
@ -6347,6 +6387,6 @@ user_function (<a class="link" href="GtkTreeView.html" title="GtkTreeView"><span
|
||||
</div>
|
||||
</div>
|
||||
<div class="footer">
|
||||
<hr>Generated by GTK-Doc V1.27</div>
|
||||
<hr>Generated by GTK-Doc V1.28</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user