<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
<!ENTITY tutorial SYSTEM "lang-tutorial.sgml">
<!ENTITY reference SYSTEM "lang-reference.sgml">
]>
<refentry id="GtkSourceGutter">
<refmeta>
<refentrytitle role="top_of_page" id="GtkSourceGutter.top_of_page">GtkSourceGutter</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTKSOURCEVIEW-2.0 Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkSourceGutter</refname>
<refpurpose>Gutter object for <link linkend="GtkSourceView"><type>GtkSourceView</type></link></refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkSourceGutter.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtksourceview/gtksourcegutter.h&gt;

                    <link linkend="GtkSourceGutter-struct">GtkSourceGutter</link>;
<link linkend="void">void</link>                (<link linkend="GtkSourceGutterDataFunc">*GtkSourceGutterDataFunc</link>)          (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                                         <link linkend="gint">gint</link> line_number,
                                                         <link linkend="gboolean">gboolean</link> current_line,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                (<link linkend="GtkSourceGutterSizeFunc">*GtkSourceGutterSizeFunc</link>)          (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="GdkWindow">GdkWindow</link> *         <link linkend="gtk-source-gutter-get-window">gtk_source_gutter_get_window</link>        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter);
<link linkend="void">void</link>                <link linkend="gtk-source-gutter-insert">gtk_source_gutter_insert</link>            (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="gint">gint</link> position);
<link linkend="void">void</link>                <link linkend="gtk-source-gutter-reorder">gtk_source_gutter_reorder</link>           (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="gint">gint</link> position);
<link linkend="void">void</link>                <link linkend="gtk-source-gutter-remove">gtk_source_gutter_remove</link>            (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer);
<link linkend="void">void</link>                <link linkend="gtk-source-gutter-set-cell-data-func">gtk_source_gutter_set_cell_data_func</link>
                                                        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="GtkSourceGutterDataFunc">GtkSourceGutterDataFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> func_data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
<link linkend="void">void</link>                <link linkend="gtk-source-gutter-set-cell-size-func">gtk_source_gutter_set_cell_size_func</link>
                                                        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="GtkSourceGutterSizeFunc">GtkSourceGutterSizeFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> func_data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
<link linkend="void">void</link>                <link linkend="gtk-source-gutter-queue-draw">gtk_source_gutter_queue_draw</link>        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkSourceGutter.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----GtkSourceGutter
</synopsis>
</refsect1>





<refsect1 id="GtkSourceGutter.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkSourceGutter--view">view</link>&quot;                     <link linkend="GtkSourceView">GtkSourceView</link>*        : Read / Write / Construct Only
  &quot;<link linkend="GtkSourceGutter--window-type">window-type</link>&quot;              <link linkend="GtkTextWindowType">GtkTextWindowType</link>     : Read / Write / Construct Only
</synopsis>
</refsect1>

<refsect1 id="GtkSourceGutter.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkSourceGutter-cell-activated">cell-activated</link>&quot;                                 : Run Last
  &quot;<link linkend="GtkSourceGutter-query-tooltip">query-tooltip</link>&quot;                                  : Run Last
</synopsis>
</refsect1>


<refsect1 id="GtkSourceGutter.description" role="desc">
<title role="desc.title">Description</title>
<para>
The <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link> object represents the left and right gutters of the
text view. It is used by <link linkend="GtkSourceView"><type>GtkSourceView</type></link> to draw the line numbers and category
marks that might be present on a line. By packing additional <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
objects in the gutter, you can extend the gutter by your own custom drawings.
</para>
<para>
The gutter works very much the same way as cells rendered in a <link linkend="GtkTreeView"><type>GtkTreeView</type></link>.
The concept is similar, with the exception that the gutter does not have an
underlying <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>. Instead, you should use
<link linkend="gtk-source-gutter-set-cell-data-func"><type>gtk_source_gutter_set_cell_data_func</type></link> to set a callback to fill in any
of the cell renderers properties, given the line for which the cell is to be
rendered. Renderers are inserted into the gutter at a certain position.
The builtin line number renderer is at position
<link linkend="GTK-SOURCE-VIEW-GUTTER-POSITION-LINES--CAPS"><type>GTK_SOURCE_VIEW_GUTTER_POSITION_LINES</type></link> (-30) and the marks renderer is at
<link linkend="GTK-SOURCE-VIEW-GUTTER-POSITION-MARKS--CAPS"><type>GTK_SOURCE_VIEW_GUTTER_POSITION_MARKS</type></link> (-20). You can use these values to
position custom renderers accordingly.
</para>
<para>
The width of a cell renderer can be specified as either fixed (using
<link linkend="gtk-cell-renderer-set-fixed-size"><type>gtk_cell_renderer_set_fixed_size</type></link>) or dynamic, in which case you
<emphasis>MUST</emphasis> set
<link linkend="gtk-source-gutter-set-cell-size-func"><type>gtk_source_gutter_set_cell_size_func</type></link>. This callback is used to set the
properties of the renderer such that <link linkend="gtk-cell-renderer-get-size"><type>gtk_cell_renderer_get_size</type></link> yields the
maximum width of the cell.
</para>
</refsect1>

<refsect1 id="GtkSourceGutter.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkSourceGutter-struct" role="struct">
<title>GtkSourceGutter</title>
<indexterm zone="GtkSourceGutter-struct"><primary sortas="GtkSourceGutter">GtkSourceGutter</primary></indexterm><programlisting>typedef struct _GtkSourceGutter GtkSourceGutter;</programlisting>
<para>
</para></refsect2>
<refsect2 id="GtkSourceGutterDataFunc" role="function">
<title>GtkSourceGutterDataFunc ()</title>
<indexterm zone="GtkSourceGutterDataFunc"><primary sortas="GtkSourceGutterDataFunc">GtkSourceGutterDataFunc</primary></indexterm><programlisting><link linkend="void">void</link>                (*GtkSourceGutterDataFunc)          (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                                         <link linkend="gint">gint</link> line_number,
                                                         <link linkend="gboolean">gboolean</link> current_line,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>line_number</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>current_line</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GtkSourceGutterSizeFunc" role="function">
<title>GtkSourceGutterSizeFunc ()</title>
<indexterm zone="GtkSourceGutterSizeFunc"><primary sortas="GtkSourceGutterSizeFunc">GtkSourceGutterSizeFunc</primary></indexterm><programlisting><link linkend="void">void</link>                (*GtkSourceGutterSizeFunc)          (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-source-gutter-get-window" role="function" condition="since:2.8">
<title>gtk_source_gutter_get_window ()</title>
<indexterm zone="gtk-source-gutter-get-window" role="2.8"><primary sortas="gtk_source_gutter_get_window">gtk_source_gutter_get_window</primary></indexterm><programlisting><link linkend="GdkWindow">GdkWindow</link> *         gtk_source_gutter_get_window        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter);</programlisting>
<para>
Get the <link linkend="GdkWindow"><type>GdkWindow</type></link> of the gutter. The window will only be available when the
gutter has at least one, non-zero width, cell renderer packed.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the <link linkend="GdkWindow"><type>GdkWindow</type></link> of the gutter, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the gutter has no window.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-source-gutter-insert" role="function" condition="since:2.8">
<title>gtk_source_gutter_insert ()</title>
<indexterm zone="gtk-source-gutter-insert" role="2.8"><primary sortas="gtk_source_gutter_insert">gtk_source_gutter_insert</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_source_gutter_insert            (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<para>
Inserts <parameter>renderer</parameter> into <parameter>gutter</parameter> at <parameter>position</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>renderer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the renderers position
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-source-gutter-reorder" role="function" condition="since:2.8">
<title>gtk_source_gutter_reorder ()</title>
<indexterm zone="gtk-source-gutter-reorder" role="2.8"><primary sortas="gtk_source_gutter_reorder">gtk_source_gutter_reorder</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_source_gutter_reorder           (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<para>
Reorders <parameter>renderer</parameter> in <parameter>gutter</parameter> to new <parameter>position</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>renderer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the new renderer position
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-source-gutter-remove" role="function" condition="since:2.8">
<title>gtk_source_gutter_remove ()</title>
<indexterm zone="gtk-source-gutter-remove" role="2.8"><primary sortas="gtk_source_gutter_remove">gtk_source_gutter_remove</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_source_gutter_remove            (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer);</programlisting>
<para>
Removes <parameter>renderer</parameter> from <parameter>gutter</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>renderer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-source-gutter-set-cell-data-func" role="function" condition="since:2.8">
<title>gtk_source_gutter_set_cell_data_func ()</title>
<indexterm zone="gtk-source-gutter-set-cell-data-func" role="2.8"><primary sortas="gtk_source_gutter_set_cell_data_func">gtk_source_gutter_set_cell_data_func</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_source_gutter_set_cell_data_func
                                                        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="GtkSourceGutterDataFunc">GtkSourceGutterDataFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> func_data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
<para>
Sets the <link linkend="GtkSourceGutterDataFunc"><type>GtkSourceGutterDataFunc</type></link> to use for <parameter>renderer</parameter>. This function is
used to setup the cell renderer properties for rendering the current cell.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>renderer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkSourceGutterDataFunc"><type>GtkSourceGutterDataFunc</type></link> to use
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func_data</parameter>&#160;:</term>
<listitem><simpara> the user data for <parameter>func</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
<listitem><simpara> the destroy notification for <parameter>func_data</parameter>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-source-gutter-set-cell-size-func" role="function" condition="since:2.8">
<title>gtk_source_gutter_set_cell_size_func ()</title>
<indexterm zone="gtk-source-gutter-set-cell-size-func" role="2.8"><primary sortas="gtk_source_gutter_set_cell_size_func">gtk_source_gutter_set_cell_size_func</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_source_gutter_set_cell_size_func
                                                        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                         <link linkend="GtkSourceGutterSizeFunc">GtkSourceGutterSizeFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> func_data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
<para>
Sets the <link linkend="GtkSourceGutterSizeFunc"><type>GtkSourceGutterSizeFunc</type></link> to use for <parameter>renderer</parameter>. This function is
used to setup the cell renderer properties for measuring the maximum size
of the cell.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>renderer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkSourceGutterSizeFunc"><type>GtkSourceGutterSizeFunc</type></link> to use
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func_data</parameter>&#160;:</term>
<listitem><simpara> the user data for <parameter>func</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
<listitem><simpara> the destroy notification for <parameter>func_data</parameter>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-source-gutter-queue-draw" role="function" condition="since:2.8">
<title>gtk_source_gutter_queue_draw ()</title>
<indexterm zone="gtk-source-gutter-queue-draw" role="2.8"><primary sortas="gtk_source_gutter_queue_draw">gtk_source_gutter_queue_draw</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_source_gutter_queue_draw        (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter);</programlisting>
<para>
Invalidates the drawable area of the gutter. You can use this to force a
redraw of the gutter if something has changed and needs to be redrawn.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>

</refsect1>
<refsect1 id="GtkSourceGutter.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkSourceGutter--view" role="property"><title>The <literal>&quot;view&quot;</literal> property</title>
<indexterm zone="GtkSourceGutter--view"><primary sortas="GtkSourceGutter:view">GtkSourceGutter:view</primary></indexterm><programlisting>  &quot;view&quot;                     <link linkend="GtkSourceView">GtkSourceView</link>*        : Read / Write / Construct Only</programlisting>
<para>
The <link linkend="GtkSourceView"><type>GtkSourceView</type></link> of the gutter</para>
<para>
</para></refsect2>
<refsect2 id="GtkSourceGutter--window-type" role="property"><title>The <literal>&quot;window-type&quot;</literal> property</title>
<indexterm zone="GtkSourceGutter--window-type"><primary sortas="GtkSourceGutter:window-type">GtkSourceGutter:window-type</primary></indexterm><programlisting>  &quot;window-type&quot;              <link linkend="GtkTextWindowType">GtkTextWindowType</link>     : Read / Write / Construct Only</programlisting>
<para>
The text window type on which the window is placed</para>
<para>
</para><para>Default value: GTK_TEXT_WINDOW_PRIVATE</para>
</refsect2>
</refsect1>

<refsect1 id="GtkSourceGutter.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkSourceGutter-cell-activated" role="signal"><title>The <literal>&quot;cell-activated&quot;</literal> signal</title>
<indexterm zone="GtkSourceGutter-cell-activated"><primary sortas="GtkSourceGutter::cell-activated">GtkSourceGutter::cell-activated</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                        <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                        <link linkend="GtkTextIter">GtkTextIter</link>     *iter,
                                                        <link linkend="gpointer">gpointer</link>         event,
                                                        <link linkend="gpointer">gpointer</link>         user_data)      : Run Last</programlisting>
<para>
Emitted when a cell has been activated (for instance when there was
a button press on the cell). The signal is only emitted for cells
that have the <link linkend="activatable"><type>activatable</type></link> property set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>renderer</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> which was activated
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkTextIter"><type>GtkTextIter</type></link> at which the cell was activated
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>event</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GdkEvent"><type>GdkEvent</type></link> with which the cell was activated
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkSourceGutter-query-tooltip" role="signal"><title>The <literal>&quot;query-tooltip&quot;</literal> signal</title>
<indexterm zone="GtkSourceGutter-query-tooltip"><primary sortas="GtkSourceGutter::query-tooltip">GtkSourceGutter::query-tooltip</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            user_function                      (<link linkend="GtkSourceGutter">GtkSourceGutter</link> *gutter,
                                                        <link linkend="GtkCellRenderer">GtkCellRenderer</link> *renderer,
                                                        <link linkend="GtkTextIter">GtkTextIter</link>     *iter,
                                                        <link linkend="GtkTooltip">GtkTooltip</link>      *tooltip,
                                                        <link linkend="gpointer">gpointer</link>         user_data)      : Run Last</programlisting>
<para>
Emitted when a tooltip is requested for a specific cell. Signal
handlers can return <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> to notify the tooltip has been handled.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>gutter</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkSourceGutter"><type>GtkSourceGutter</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>renderer</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> which was activated
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkTextIter"><type>GtkTextIter</type></link> at which the cell was activated
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkTooltip"><type>GtkTooltip</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
