RubyGems - gdk3 - Versions diffs - 1.2.0-x86-mingw32 - Mend

gdk3 1.2.0-x86-mingw32

Files changed (1337) hide show

data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkSymbolicColor.html ADDED Viewed

@@ -0,0 +1,420 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkSymbolicColor</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="theming.html" title="Part III. Theming in GTK+">
+<link rel="prev" href="gtk3-GtkWidgetPath.html" title="GtkWidgetPath">
+<link rel="next" href="gtk3-GtkGradient.html" title="GtkGradient">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="gtk3-GtkWidgetPath.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="theming.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="gtk3-GtkGradient.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#gtk3-GtkSymbolicColor.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#gtk3-GtkSymbolicColor.description" class="shortcut">Description</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="gtk3-GtkSymbolicColor"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="gtk3-GtkSymbolicColor.top_of_page"></a>GtkSymbolicColor</span></h2>
+<p>GtkSymbolicColor — Symbolic colors</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="gtk3-GtkSymbolicColor.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+                    <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor">GtkSymbolicColor</a>;
+<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-new-literal" title="gtk_symbolic_color_new_literal ()">gtk_symbolic_color_new_literal</a>      (<em class="parameter"><code>const <a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);
+<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-new-name" title="gtk_symbolic_color_new_name ()">gtk_symbolic_color_new_name</a>         (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
+<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-new-shade" title="gtk_symbolic_color_new_shade ()">gtk_symbolic_color_new_shade</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> factor</code></em>);
+<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-new-alpha" title="gtk_symbolic_color_new_alpha ()">gtk_symbolic_color_new_alpha</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> factor</code></em>);
+<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-new-mix" title="gtk_symbolic_color_new_mix ()">gtk_symbolic_color_new_mix</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color1</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color2</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> factor</code></em>);
+<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-new-win32" title="gtk_symbolic_color_new_win32 ()">gtk_symbolic_color_new_win32</a>        (<em class="parameter"><code>const <span class="type">gchar</span> *theme_class</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> id</code></em>);
+<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-ref" title="gtk_symbolic_color_ref ()">gtk_symbolic_color_ref</a>              (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-unref" title="gtk_symbolic_color_unref ()">gtk_symbolic_color_unref</a>            (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-resolve" title="gtk_symbolic_color_resolve ()">gtk_symbolic_color_resolve</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
+                                                         <em class="parameter"><code><a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *resolved_color</code></em>);
+<span class="returnvalue">char</span> *              <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-to-string" title="gtk_symbolic_color_to_string ()">gtk_symbolic_color_to_string</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="gtk3-GtkSymbolicColor.description"></a><h2>Description</h2>
+<p>
+GtkSymbolicColor is a boxed type that represents a symbolic color.
+It is the result of parsing a
+<a class="link" href="GtkCssProvider.html#gtkcssprovider-symbolic-colors" title="Symbolic colors">color expression</a>.
+To obtain the color represented by a GtkSymbolicColor, it has to
+be resolved with <a class="link" href="gtk3-GtkSymbolicColor.html#gtk-symbolic-color-resolve" title="gtk_symbolic_color_resolve ()"><code class="function">gtk_symbolic_color_resolve()</code></a>, which replaces all
+symbolic color references by the colors they refer to (in a given
+context) and evaluates mix, shade and other expressions, resulting
+in a <a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> value.
+</p>
+<p>
+It is not normally necessary to deal directly with <a href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor"><span class="type">GtkSymbolicColors</span></a>,
+since they are mostly used behind the scenes by <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and
+<a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>.
+</p>
+</div>
+<div class="refsect1">
+<a name="gtk3-GtkSymbolicColor.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkSymbolicColor"></a><h3>GtkSymbolicColor</h3>
+<pre class="programlisting">typedef struct _GtkSymbolicColor GtkSymbolicColor;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-new-literal"></a><h3>gtk_symbolic_color_new_literal ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  gtk_symbolic_color_new_literal      (<em class="parameter"><code>const <a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
+<p>
+Creates a symbolic color pointing to a literal color.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
+<td>a <a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a newly created <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-new-name"></a><h3>gtk_symbolic_color_new_name ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  gtk_symbolic_color_new_name         (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
+<p>
+Creates a symbolic color pointing to an unresolved named
+color. See <a class="link" href="GtkStyleContext.html#gtk-style-context-lookup-color" title="gtk_style_context_lookup_color ()"><code class="function">gtk_style_context_lookup_color()</code></a> and
+<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-lookup-color" title="gtk_style_properties_lookup_color ()"><code class="function">gtk_style_properties_lookup_color()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
+<td>color name</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a newly created <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-new-shade"></a><h3>gtk_symbolic_color_new_shade ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  gtk_symbolic_color_new_shade        (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> factor</code></em>);</pre>
+<p>
+Creates a symbolic color defined as a shade of
+another color. A factor &gt; 1.0 would resolve to
+a brighter color, while &lt; 1.0 would resolve to
+a darker color.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
+<td>another <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>factor</code></em> :</span></p></td>
+<td>shading factor to apply to <em class="parameter"><code>color</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly created <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-new-alpha"></a><h3>gtk_symbolic_color_new_alpha ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  gtk_symbolic_color_new_alpha        (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> factor</code></em>);</pre>
+<p>
+Creates a symbolic color by modifying the relative alpha
+value of <em class="parameter"><code>color</code></em>. A factor &lt; 1.0 would resolve to a more
+transparent color, while &gt; 1.0 would resolve to a more
+opaque color.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
+<td>another <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>factor</code></em> :</span></p></td>
+<td>factor to apply to <em class="parameter"><code>color</code></em> alpha</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly created <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-new-mix"></a><h3>gtk_symbolic_color_new_mix ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  gtk_symbolic_color_new_mix          (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color1</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color2</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> factor</code></em>);</pre>
+<p>
+Creates a symbolic color defined as a mix of another
+two colors. a mix factor of 0 would resolve to <em class="parameter"><code>color1</code></em>,
+while a factor of 1 would resolve to <em class="parameter"><code>color2</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color1</code></em> :</span></p></td>
+<td>color to mix</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color2</code></em> :</span></p></td>
+<td>another color to mix</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>factor</code></em> :</span></p></td>
+<td>mix factor</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly created <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-new-win32"></a><h3>gtk_symbolic_color_new_win32 ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  gtk_symbolic_color_new_win32        (<em class="parameter"><code>const <span class="type">gchar</span> *theme_class</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> id</code></em>);</pre>
+<p>
+Creates a symbolic color based on the current win32
+theme.
+</p>
+<p>
+Note that while this call is available on all platforms
+the actual value returned is not reliable on non-win32
+platforms.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>theme_class</code></em> :</span></p></td>
+<td>The theme class to pull color from</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
+<td>The color id</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A newly created <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-ref"></a><h3>gtk_symbolic_color_ref ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *  gtk_symbolic_color_ref              (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>);</pre>
+<p>
+Increases the reference count of <em class="parameter"><code>color</code></em>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the same <em class="parameter"><code>color</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-unref"></a><h3>gtk_symbolic_color_unref ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_symbolic_color_unref            (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>);</pre>
+<p>
+Decreases the reference count of <em class="parameter"><code>color</code></em>, freeing its memory if the
+reference count reaches 0.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-resolve"></a><h3>gtk_symbolic_color_resolve ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_symbolic_color_resolve          (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
+                                                         <em class="parameter"><code><a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *resolved_color</code></em>);</pre>
+<p>
+If <em class="parameter"><code>color</code></em> is resolvable, <em class="parameter"><code>resolved_color</code></em> will be filled in
+with the resolved color, and <code class="literal">TRUE</code> will be returned. Generally,
+if <em class="parameter"><code>color</code></em> can't be resolved, it is due to it being defined on
+top of a named color that doesn't exist in <em class="parameter"><code>props</code></em>.
+</p>
+<p>
+When <em class="parameter"><code>props</code></em> is <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, resolving of named colors will fail, so if
+your <em class="parameter"><code>color</code></em> is or references such a color, this function will
+return <code class="literal">FALSE</code>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>props</code></em> :</span></p></td>
+<td>
+<a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> to use when resolving
+named colors, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>resolved_color</code></em> :</span></p></td>
+<td>return location for the resolved color. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the color has been resolved</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-symbolic-color-to-string"></a><h3>gtk_symbolic_color_to_string ()</h3>
+<pre class="programlisting"><span class="returnvalue">char</span> *              gtk_symbolic_color_to_string        (<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>);</pre>
+<p>
+Converts the given <em class="parameter"><code>color</code></em> to a string representation. This is useful
+both for debugging and for serialization of strings. The format of
+the string may change between different versions of GTK, but it is
+guaranteed that the GTK css parser is able to read the string and
+create the same symbolic color from it.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
+<td>color to convert to a string</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new string representing <em class="parameter"><code>color</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkTreeView-drag-and-drop.html ADDED Viewed

@@ -0,0 +1,452 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkTreeView drag-and-drop</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<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="GtkTreeView.html" title="GtkTreeView">
+<link rel="next" href="GtkCellView.html" title="GtkCellView">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkTreeView.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="TreeWidgetObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="GtkCellView.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#gtk3-GtkTreeView-drag-and-drop.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#gtk3-GtkTreeView-drag-and-drop.description" class="shortcut">Description</a>
+                   |
+                  <a href="#gtk3-GtkTreeView-drag-and-drop.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#gtk3-GtkTreeView-drag-and-drop.implementations" class="shortcut">Known Implementations</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="gtk3-GtkTreeView-drag-and-drop"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="gtk3-GtkTreeView-drag-and-drop.top_of_page"></a>GtkTreeView drag-and-drop</span></h2>
+<p>GtkTreeView drag-and-drop — Interfaces for drag-and-drop support in GtkTreeView</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="gtk3-GtkTreeView-drag-and-drop.synopsis"></a><h2>Synopsis</h2>
+<a name="GtkTreeDragSource"></a><a name="GtkTreeDragDest"></a><pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+                    <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource-struct" title="GtkTreeDragSource">GtkTreeDragSource</a>;
+struct              <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSourceIface" title="struct GtkTreeDragSourceIface">GtkTreeDragSourceIface</a>;
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-drag-source-drag-data-delete" title="gtk_tree_drag_source_drag_data_delete ()">gtk_tree_drag_source_drag_data_delete</a>
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> *drag_source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-drag-source-drag-data-get" title="gtk_tree_drag_source_drag_data_get ()">gtk_tree_drag_source_drag_data_get</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> *drag_source</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="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-drag-source-row-draggable" title="gtk_tree_drag_source_row_draggable ()">gtk_tree_drag_source_row_draggable</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> *drag_source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);
+                    <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest-struct" title="GtkTreeDragDest">GtkTreeDragDest</a>;
+struct              <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDestIface" title="struct GtkTreeDragDestIface">GtkTreeDragDestIface</a>;
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-drag-dest-drag-data-received" title="gtk_tree_drag_dest_drag_data_received ()">gtk_tree_drag_dest_drag_data_received</a>
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a> *drag_dest</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *dest</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-drag-dest-row-drop-possible" title="gtk_tree_drag_dest_row_drop_possible ()">gtk_tree_drag_dest_row_drop_possible</a>
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a> *drag_dest</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *dest_path</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-set-row-drag-data" title="gtk_tree_set_row_drag_data ()">gtk_tree_set_row_drag_data</a>          (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</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#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-get-row-drag-data" title="gtk_tree_get_row_drag_data ()">gtk_tree_get_row_drag_data</a>          (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</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#GtkTreePath"><span class="type">GtkTreePath</span></a> **path</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="gtk3-GtkTreeView-drag-and-drop.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GInterface
+   +----GtkTreeDragSource
+</pre>
+<pre class="synopsis">
+  GInterface
+   +----GtkTreeDragDest
+</pre>
+</div>
+<div class="refsect1">
+<a name="gtk3-GtkTreeView-drag-and-drop.implementations"></a><h2>Known Implementations</h2>
+<p>
+GtkTreeDragSource is implemented by
+ <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>,  <a class="link" href="GtkTreeModelFilter.html" title="GtkTreeModelFilter">GtkTreeModelFilter</a>,  <a class="link" href="GtkTreeModelSort.html" title="GtkTreeModelSort">GtkTreeModelSort</a> and  <a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a>.</p>
+<p>
+GtkTreeDragDest is implemented by
+ <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> and  <a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a>.</p>
+</div>
+<div class="refsect1">
+<a name="gtk3-GtkTreeView-drag-and-drop.description"></a><h2>Description</h2>
+<p>
+GTK+ supports Drag-and-Drop in tree views with a high-level and a low-level
+API.
+</p>
+<p>
+The low-level API consists of the GTK+ DND API, augmented by some treeview
+utility functions: <a class="link" href="GtkTreeView.html#gtk-tree-view-set-drag-dest-row" title="gtk_tree_view_set_drag_dest_row ()"><code class="function">gtk_tree_view_set_drag_dest_row()</code></a>,
+<a class="link" href="GtkTreeView.html#gtk-tree-view-get-drag-dest-row" title="gtk_tree_view_get_drag_dest_row ()"><code class="function">gtk_tree_view_get_drag_dest_row()</code></a>, <a class="link" href="GtkTreeView.html#gtk-tree-view-get-dest-row-at-pos" title="gtk_tree_view_get_dest_row_at_pos ()"><code class="function">gtk_tree_view_get_dest_row_at_pos()</code></a>,
+<a class="link" href="GtkTreeView.html#gtk-tree-view-create-row-drag-icon" title="gtk_tree_view_create_row_drag_icon ()"><code class="function">gtk_tree_view_create_row_drag_icon()</code></a>, <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-set-row-drag-data" title="gtk_tree_set_row_drag_data ()"><code class="function">gtk_tree_set_row_drag_data()</code></a> and
+<a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#gtk-tree-get-row-drag-data" title="gtk_tree_get_row_drag_data ()"><code class="function">gtk_tree_get_row_drag_data()</code></a>. This API leaves a lot of flexibility, but
+nothing is done automatically, and implementing advanced features like
+hover-to-open-rows or autoscrolling on top of this API is a lot of work.
+</p>
+<p>
+On the other hand, if you write to the high-level API, then all the
+bookkeeping of rows is done for you, as well as things like hover-to-open
+and auto-scroll, but your models have to implement the
+<a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> and <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a> interfaces.
+</p>
+</div>
+<div class="refsect1">
+<a name="gtk3-GtkTreeView-drag-and-drop.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkTreeDragSource-struct"></a><h3>GtkTreeDragSource</h3>
+<pre class="programlisting">typedef struct _GtkTreeDragSource GtkTreeDragSource;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkTreeDragSourceIface"></a><h3>struct GtkTreeDragSourceIface</h3>
+<pre class="programlisting">struct GtkTreeDragSourceIface {
+  GTypeInterface g_iface;
+  /* VTable - not signals */
+  gboolean     (* row_draggable)        (GtkTreeDragSource   *drag_source,
+                                         GtkTreePath         *path);
+  gboolean     (* drag_data_get)        (GtkTreeDragSource   *drag_source,
+                                         GtkTreePath         *path,
+                                         GtkSelectionData    *selection_data);
+  gboolean     (* drag_data_delete)     (GtkTreeDragSource *drag_source,
+                                         GtkTreePath       *path);
+};
+</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-tree-drag-source-drag-data-delete"></a><h3>gtk_tree_drag_source_drag_data_delete ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_tree_drag_source_drag_data_delete
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> *drag_source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
+<p>
+Asks the <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> to delete the row at <em class="parameter"><code>path</code></em>, because
+it was moved somewhere else via drag-and-drop. Returns <code class="literal">FALSE</code>
+if the deletion fails because <em class="parameter"><code>path</code></em> no longer exists, or for
+some model-specific reason. Should robustly handle a <em class="parameter"><code>path</code></em> no
+longer found in the model!
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>drag_source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
+<td>row that was being dragged</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the row was successfully deleted</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-tree-drag-source-drag-data-get"></a><h3>gtk_tree_drag_source_drag_data_get ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_tree_drag_source_drag_data_get  (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> *drag_source</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="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
+<p>
+Asks the <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> to fill in <em class="parameter"><code>selection_data</code></em> with a
+representation of the row at <em class="parameter"><code>path</code></em>. <em class="parameter"><code>selection_data-&gt;target</code></em> gives
+the required type of the data.  Should robustly handle a <em class="parameter"><code>path</code></em> no
+longer found in the model!
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>drag_source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
+<td>row that was dragged</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> to fill with data
+from the dragged row. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if data of the required type was provided</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-tree-drag-source-row-draggable"></a><h3>gtk_tree_drag_source_row_draggable ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_tree_drag_source_row_draggable  (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> *drag_source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
+<p>
+Asks the <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a> whether a particular row can be used as
+the source of a DND operation. If the source doesn't implement
+this interface, the row is assumed draggable.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>drag_source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSource"><span class="type">GtkTreeDragSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
+<td>row on which user is initiating a drag</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the row can be dragged</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkTreeDragDest-struct"></a><h3>GtkTreeDragDest</h3>
+<pre class="programlisting">typedef struct _GtkTreeDragDest GtkTreeDragDest;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkTreeDragDestIface"></a><h3>struct GtkTreeDragDestIface</h3>
+<pre class="programlisting">struct GtkTreeDragDestIface {
+  GTypeInterface g_iface;
+  /* VTable - not signals */
+  gboolean     (* drag_data_received) (GtkTreeDragDest   *drag_dest,
+                                       GtkTreePath       *dest,
+                                       GtkSelectionData  *selection_data);
+  gboolean     (* row_drop_possible)  (GtkTreeDragDest   *drag_dest,
+                                       GtkTreePath       *dest_path,
+				       GtkSelectionData  *selection_data);
+};
+</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-tree-drag-dest-drag-data-received"></a><h3>gtk_tree_drag_dest_drag_data_received ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_tree_drag_dest_drag_data_received
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a> *drag_dest</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *dest</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
+<p>
+Asks the <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a> to insert a row before the path <em class="parameter"><code>dest</code></em>,
+deriving the contents of the row from <em class="parameter"><code>selection_data</code></em>. If <em class="parameter"><code>dest</code></em> is
+outside the tree so that inserting before it is impossible, <code class="literal">FALSE</code>
+will be returned. Also, <code class="literal">FALSE</code> may be returned if the new row is
+not created for some model-specific reason.  Should robustly handle
+a <em class="parameter"><code>dest</code></em> no longer found in the model!
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>drag_dest</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
+<td>row to drop in front of</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
+<td>data to drop</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>whether a new row was created before position <em class="parameter"><code>dest</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-tree-drag-dest-row-drop-possible"></a><h3>gtk_tree_drag_dest_row_drop_possible ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_tree_drag_dest_row_drop_possible
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a> *drag_dest</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *dest_path</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
+<p>
+Determines whether a drop is possible before the given <em class="parameter"><code>dest_path</code></em>,
+at the same depth as <em class="parameter"><code>dest_path</code></em>. i.e., can we drop the data in
+<em class="parameter"><code>selection_data</code></em> at that location. <em class="parameter"><code>dest_path</code></em> does not have to
+exist; the return value will almost certainly be <code class="literal">FALSE</code> if the
+parent of <em class="parameter"><code>dest_path</code></em> doesn't exist, though.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>drag_dest</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>dest_path</code></em> :</span></p></td>
+<td>destination row</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
+<td>the data being dragged</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if a drop is possible before <em class="parameter"><code>dest_path</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-tree-set-row-drag-data"></a><h3>gtk_tree_set_row_drag_data ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_tree_set_row_drag_data          (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</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#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
+<p>
+Sets selection data of target type <code class="literal">GTK_TREE_MODEL_ROW</code>. Normally used
+in a drag_data_get handler.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
+<td>some <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>tree_model</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
+<td>a row in <em class="parameter"><code>tree_model</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> had the proper target type to allow us to set a tree row</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-tree-get-row-drag-data"></a><h3>gtk_tree_get_row_drag_data ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_tree_get_row_drag_data          (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</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#GtkTreePath"><span class="type">GtkTreePath</span></a> **path</code></em>);</pre>
+<p>
+Obtains a <em class="parameter"><code>tree_model</code></em> and <em class="parameter"><code>path</code></em> from selection data of target type
+<code class="literal">GTK_TREE_MODEL_ROW</code>. Normally called from a drag_data_received handler.
+This function can only be used if <em class="parameter"><code>selection_data</code></em> originates from the same
+process that's calling this function, because a pointer to the tree model
+is being passed around. If you aren't in the same process, then you'll
+get memory corruption. In the <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDest"><span class="type">GtkTreeDragDest</span></a> drag_data_received handler,
+you can assume that selection data of type <code class="literal">GTK_TREE_MODEL_ROW</code> is
+in from the current process. The returned path must be freed with
+<a class="link" href="GtkTreeModel.html#gtk-tree-path-free" title="gtk_tree_path_free ()"><code class="function">gtk_tree_path_free()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>tree_model</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
+<td>row in <em class="parameter"><code>tree_model</code></em>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if <em class="parameter"><code>selection_data</code></em> had target type <code class="literal">GTK_TREE_MODEL_ROW</code> and
+is otherwise valid</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>