<refentry id="GtkTextTag">
<refmeta>
<refentrytitle>GtkTextTag</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkTextTag</refname><refpurpose>
A tag that can be applied to text in a <link linkend="GtkTextBuffer">GtkTextBuffer</link></refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gtk/gtk.h&gt;


struct      <link linkend="GtkTextTag-struct">GtkTextTag</link>;
enum        <link linkend="GtkWrapMode">GtkWrapMode</link>;
struct      <link linkend="GtkTextAttributes">GtkTextAttributes</link>;
<link linkend="GtkTextTag">GtkTextTag</link>* <link linkend="gtk-text-tag-new">gtk_text_tag_new</link>                (const <link linkend="gchar">gchar</link> *name);
<link linkend="gint">gint</link>        <link linkend="gtk-text-tag-get-priority">gtk_text_tag_get_priority</link>       (<link linkend="GtkTextTag">GtkTextTag</link> *tag);
void        <link linkend="gtk-text-tag-set-priority">gtk_text_tag_set_priority</link>       (<link linkend="GtkTextTag">GtkTextTag</link> *tag,
                                             <link linkend="gint">gint</link> priority);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-text-tag-event">gtk_text_tag_event</link>              (<link linkend="GtkTextTag">GtkTextTag</link> *tag,
                                             <link linkend="GObject">GObject</link> *event_object,
                                             <link linkend="GdkEvent">GdkEvent</link> *event,
                                             const <link linkend="GtkTextIter">GtkTextIter</link> *iter);
struct      <link linkend="GtkTextAppearance">GtkTextAppearance</link>;
<link linkend="GtkTextAttributes">GtkTextAttributes</link>* <link linkend="gtk-text-attributes-new">gtk_text_attributes_new</link>  (void);
<link linkend="GtkTextAttributes">GtkTextAttributes</link>* <link linkend="gtk-text-attributes-copy">gtk_text_attributes_copy</link> (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *src);
void        <link linkend="gtk-text-attributes-copy-values">gtk_text_attributes_copy_values</link> (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *src,
                                             <link linkend="GtkTextAttributes">GtkTextAttributes</link> *dest);
void        <link linkend="gtk-text-attributes-unref">gtk_text_attributes_unref</link>       (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *values);
void        <link linkend="gtk-text-attributes-ref">gtk_text_attributes_ref</link>         (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *values);


</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----GtkTextTag
</synopsis>

</refsect1>

<refsect1>
<title>Properties</title>
<synopsis>

  &quot;<link linkend="GtkTextTag--name">name</link>&quot;                 <link linkend="gchararray">gchararray</link>           : Read / Write / Construct Only
  &quot;<link linkend="GtkTextTag--background">background</link>&quot;           <link linkend="gchararray">gchararray</link>           : Write
  &quot;<link linkend="GtkTextTag--foreground">foreground</link>&quot;           <link linkend="gchararray">gchararray</link>           : Write
  &quot;<link linkend="GtkTextTag--background-gdk">background-gdk</link>&quot;       <link linkend="GdkColor">GdkColor</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--foreground-gdk">foreground-gdk</link>&quot;       <link linkend="GdkColor">GdkColor</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--background-stipple">background-stipple</link>&quot;   <link linkend="GdkPixmap">GdkPixmap</link>            : Read / Write
  &quot;<link linkend="GtkTextTag--foreground-stipple">foreground-stipple</link>&quot;   <link linkend="GdkPixmap">GdkPixmap</link>            : Read / Write
  &quot;<link linkend="GtkTextTag--font">font</link>&quot;                 <link linkend="gchararray">gchararray</link>           : Read / Write
  &quot;<link linkend="GtkTextTag--font-desc">font-desc</link>&quot;            <link linkend="PangoFontDescription">PangoFontDescription</link> : Read / Write
  &quot;<link linkend="GtkTextTag--family">family</link>&quot;               <link linkend="gchararray">gchararray</link>           : Read / Write
  &quot;<link linkend="GtkTextTag--style">style</link>&quot;                <link linkend="PangoStyle">PangoStyle</link>           : Read / Write
  &quot;<link linkend="GtkTextTag--variant">variant</link>&quot;              <link linkend="PangoVariant">PangoVariant</link>         : Read / Write
  &quot;<link linkend="GtkTextTag--weight">weight</link>&quot;               <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--stretch">stretch</link>&quot;              <link linkend="PangoStretch">PangoStretch</link>         : Read / Write
  &quot;<link linkend="GtkTextTag--size">size</link>&quot;                 <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--size-points">size-points</link>&quot;          <link linkend="gdouble">gdouble</link>              : Read / Write
  &quot;<link linkend="GtkTextTag--scale">scale</link>&quot;                <link linkend="gdouble">gdouble</link>              : Read / Write
  &quot;<link linkend="GtkTextTag--pixels-above-lines">pixels-above-lines</link>&quot;   <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--pixels-below-lines">pixels-below-lines</link>&quot;   <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--pixels-inside-wrap">pixels-inside-wrap</link>&quot;   <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--editable">editable</link>&quot;             <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--wrap-mode">wrap-mode</link>&quot;            <link linkend="GtkWrapMode">GtkWrapMode</link>          : Read / Write
  &quot;<link linkend="GtkTextTag--justification">justification</link>&quot;        <link linkend="GtkJustification">GtkJustification</link>     : Read / Write
  &quot;<link linkend="GtkTextTag--direction">direction</link>&quot;            <link linkend="GtkTextDirection">GtkTextDirection</link>     : Read / Write
  &quot;<link linkend="GtkTextTag--left-margin">left-margin</link>&quot;          <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--indent">indent</link>&quot;               <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--strikethrough">strikethrough</link>&quot;        <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--right-margin">right-margin</link>&quot;         <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--underline">underline</link>&quot;            <link linkend="PangoUnderline">PangoUnderline</link>       : Read / Write
  &quot;<link linkend="GtkTextTag--rise">rise</link>&quot;                 <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTextTag--background-full-height">background-full-height</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--language">language</link>&quot;             <link linkend="gchararray">gchararray</link>           : Read / Write
  &quot;<link linkend="GtkTextTag--tabs">tabs</link>&quot;                 <link linkend="PangoTabArray">PangoTabArray</link>        : Read / Write
  &quot;<link linkend="GtkTextTag--invisible">invisible</link>&quot;            <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--background-set">background-set</link>&quot;       <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--foreground-set">foreground-set</link>&quot;       <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--background-stipple-set">background-stipple-set</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--foreground-stipple-set">foreground-stipple-set</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--family-set">family-set</link>&quot;           <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--style-set">style-set</link>&quot;            <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--variant-set">variant-set</link>&quot;          <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--weight-set">weight-set</link>&quot;           <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--stretch-set">stretch-set</link>&quot;          <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--size-set">size-set</link>&quot;             <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--scale-set">scale-set</link>&quot;            <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--pixels-above-lines-set">pixels-above-lines-set</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--pixels-below-lines-set">pixels-below-lines-set</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--pixels-inside-wrap-set">pixels-inside-wrap-set</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--editable-set">editable-set</link>&quot;         <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--wrap-mode-set">wrap-mode-set</link>&quot;        <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--justification-set">justification-set</link>&quot;    <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--left-margin-set">left-margin-set</link>&quot;      <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--indent-set">indent-set</link>&quot;           <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--strikethrough-set">strikethrough-set</link>&quot;    <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--right-margin-set">right-margin-set</link>&quot;     <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--underline-set">underline-set</link>&quot;        <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--rise-set">rise-set</link>&quot;             <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--background-full-height-set">background-full-height-set</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--language-set">language-set</link>&quot;         <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--tabs-set">tabs-set</link>&quot;             <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTextTag--invisible-set">invisible-set</link>&quot;        <link linkend="gboolean">gboolean</link>             : Read / Write
</synopsis>
</refsect1>

<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GtkTextTag-event">event</link>&quot;     <link linkend="gboolean">gboolean</link>    user_function      (<link linkend="GtkTextTag">GtkTextTag</link> *texttag,
                                            <link linkend="GObject">GObject</link> *arg1,
                                            <link linkend="GdkEvent">GdkEvent</link> *event,
                                            <link linkend="GtkTextIter">GtkTextIter</link> arg2,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
You may wish to begin by reading the <link linkend="TextWidget">text widget
conceptual overview</link> which gives an overview of all the objects and data
types related to the text widget and how they work together.
</para>

<para>
Tags should be in the <link linkend="GtkTextTagTable">GtkTextTagTable</link> for a given <link linkend="GtkTextBuffer">GtkTextBuffer</link>
before using them with that buffer.
</para>

<para>
<link linkend="gtk-text-buffer-create-tag">gtk_text_buffer_create_tag</link>() is the best way to create tags.
See <application>gtk-demo</application> for numerous examples.
</para>

<para>
The "invisible" property was not implemented for GTK+ 2.0; it's
planned to be implemented in future releases.
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkTextTag-struct">struct GtkTextTag</title>
<programlisting>struct GtkTextTag;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GtkWrapMode">enum GtkWrapMode</title>
<programlisting>typedef enum
{
  GTK_WRAP_NONE,
  GTK_WRAP_CHAR,
  GTK_WRAP_WORD
} GtkWrapMode;
</programlisting>
<para>
Describes a type of line wrapping.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GTK_WRAP_NONE</literal></entry>
<entry>do not wrap lines; just make the text area wider
</entry>
</row>
<row>
<entry><literal>GTK_WRAP_CHAR</literal></entry>
<entry>wrap text, breaking lines anywhere the cursor can
                appear (between characters, usually - if you want to
                be technical, between graphemes, see
                <link linkend="pango-get-log-attrs">pango_get_log_attrs</link>())
</entry>
</row>
<row>
<entry><literal>GTK_WRAP_WORD</literal></entry>
<entry>wrap text, breaking lines in between words

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkTextAttributes">struct GtkTextAttributes</title>
<programlisting>struct GtkTextAttributes
{
  guint refcount;

  GtkTextAppearance appearance;

  GtkJustification justification;
  GtkTextDirection direction;

  /* Individual chunks of this can be set/unset as a group */
  PangoFontDescription *font;

  gdouble font_scale;
  
  gint left_margin;

  gint indent;  

  gint right_margin;

  gint pixels_above_lines;

  gint pixels_below_lines;

  gint pixels_inside_wrap;

  PangoTabArray *tabs;

  GtkWrapMode wrap_mode;        /* How to handle wrap-around for this tag.
                                 * Must be GTK_WRAPMODE_CHAR,
                                 * GTK_WRAPMODE_NONE, GTK_WRAPMODE_WORD
                                 */

  PangoLanguage *language;

  /* I'm not sure this can really be used without breaking some things
   * an app might do :-/
   */
  gpointer padding1;
  
  /* hide the text  */
  guint invisible : 1;

  /* Background is fit to full line height rather than
   * baseline +/- ascent/descent (font height)
   */
  guint bg_full_height : 1;

  /* can edit this text */
  guint editable : 1;

  /* colors are allocated etc. */
  guint realized : 1;

  guint pad1 : 1;
  guint pad2 : 1;
  guint pad3 : 1;
  guint pad4 : 1;
};
</programlisting>
<para>
Using <link linkend="GtkTextAttributes">GtkTextAttributes</link> directly should rarely be necessary. It's
primarily useful with <link linkend="gtk-text-iter-get-attributes">gtk_text_iter_get_attributes</link>(). As with most
GTK+ structs, the fields in this struct should only be read, never
modified directly.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="guint">guint</link> <structfield>refcount</structfield></entry>
<entry>private field, ignore
</entry>
</row>
<row>
<entry><link linkend="GtkTextAppearance">GtkTextAppearance</link> <structfield>appearance</structfield></entry>
<entry>pointer to sub-struct containing certain attributes
</entry>
</row>
<row>
<entry><link linkend="GtkJustification">GtkJustification</link> <structfield>justification</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="GtkTextDirection">GtkTextDirection</link> <structfield>direction</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="PangoFontDescription">PangoFontDescription</link> *<structfield>font</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>font_scale</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>left_margin</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>indent</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>right_margin</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>pixels_above_lines</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>pixels_below_lines</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>pixels_inside_wrap</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="PangoTabArray">PangoTabArray</link> *<structfield>tabs</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="GtkWrapMode">GtkWrapMode</link> <structfield>wrap_mode</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="PangoLanguage">PangoLanguage</link> *<structfield>language</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="gpointer">gpointer</link> <structfield>padding1</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>invisible</structfield> : 1</entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>bg_full_height</structfield> : 1</entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>editable</structfield> : 1</entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>realized</structfield> : 1</entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>pad1</structfield> : 1</entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>pad2</structfield> : 1</entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>pad3</structfield> : 1</entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>pad4</structfield> : 1</entry>
<entry>

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-tag-new">gtk_text_tag_new ()</title>
<programlisting><link linkend="GtkTextTag">GtkTextTag</link>* gtk_text_tag_new                (const <link linkend="gchar">gchar</link> *name);</programlisting>
<para>
Creates a <link linkend="GtkTextTag">GtkTextTag</link>. Configure the tag using object arguments,
i.e. using <link linkend="g-object-set">g_object_set</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>name</parameter>&nbsp;:</entry>
<entry> tag name, or <literal>NULL</literal>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> a new <link linkend="GtkTextTag">GtkTextTag</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-tag-get-priority">gtk_text_tag_get_priority ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_text_tag_get_priority       (<link linkend="GtkTextTag">GtkTextTag</link> *tag);</programlisting>
<para>
Get the tag priority.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tag</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTextTag">GtkTextTag</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The tag's priority.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-tag-set-priority">gtk_text_tag_set_priority ()</title>
<programlisting>void        gtk_text_tag_set_priority       (<link linkend="GtkTextTag">GtkTextTag</link> *tag,
                                             <link linkend="gint">gint</link> priority);</programlisting>
<para>
Sets the priority of a <link linkend="GtkTextTag">GtkTextTag</link>. Valid priorities are
start at 0 and go to one less than <link linkend="gtk-text-tag-table-get-size">gtk_text_tag_table_get_size</link>().
Each tag in a table has a unique priority; setting the priority
of one tag shifts the priorities of all the other tags in the
table to maintain a unique priority for each tag. Higher priority
tags "win" if two tags both set the same text attribute. When adding
a tag to a tag table, it will be assigned the highest priority in
the table by default; so normally the precedence of a set of tags
is the order in which they were added to the table, or created with
<link linkend="gtk-text-buffer-create-tag">gtk_text_buffer_create_tag</link>(), which adds the tag to the buffer's table
automatically.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tag</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTextTag">GtkTextTag</link>
</entry></row>
<row><entry align="right"><parameter>priority</parameter>&nbsp;:</entry>
<entry> the new priority
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-tag-event">gtk_text_tag_event ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_text_tag_event              (<link linkend="GtkTextTag">GtkTextTag</link> *tag,
                                             <link linkend="GObject">GObject</link> *event_object,
                                             <link linkend="GdkEvent">GdkEvent</link> *event,
                                             const <link linkend="GtkTextIter">GtkTextIter</link> *iter);</programlisting>
<para>
Emits the "event" signal on the <link linkend="GtkTextTag">GtkTextTag</link>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tag</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTextTag">GtkTextTag</link>
</entry></row>
<row><entry align="right"><parameter>event_object</parameter>&nbsp;:</entry>
<entry> object that received the event, such as a widget
</entry></row>
<row><entry align="right"><parameter>event</parameter>&nbsp;:</entry>
<entry> the event
</entry></row>
<row><entry align="right"><parameter>iter</parameter>&nbsp;:</entry>
<entry> location where the event was received
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> result of signal emission (whether the event was handled)
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkTextAppearance">struct GtkTextAppearance</title>
<programlisting>struct GtkTextAppearance
{
  GdkColor bg_color;
  GdkColor fg_color;
  GdkBitmap *bg_stipple;
  GdkBitmap *fg_stipple;

  /* super/subscript rise, can be negative */
  gint rise;

  /* I'm not sure this can really be used without breaking some things
   * an app might do :-/
   */
  gpointer padding1;
  
  guint underline : 4;          /* PangoUnderline */
  guint strikethrough : 1;

  /* Whether to use background-related values; this is irrelevant for
   * the values struct when in a tag, but is used for the composite
   * values struct; it's true if any of the tags being composited
   * had background stuff set.
   */
  guint draw_bg : 1;
  
  /* These are only used when we are actually laying out and rendering
   * a paragraph; not when a GtkTextAppearance is part of a
   * GtkTextAttributes.
   */
  guint inside_selection : 1;
  guint is_text : 1;

  guint pad1 : 1;
  guint pad2 : 1;
  guint pad3 : 1;
  guint pad4 : 1;
};
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gtk-text-attributes-new">gtk_text_attributes_new ()</title>
<programlisting><link linkend="GtkTextAttributes">GtkTextAttributes</link>* gtk_text_attributes_new  (void);</programlisting>
<para>
Creates a <link linkend="GtkTextAttributes">GtkTextAttributes</link>, which describes
a set of properties on some text.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> a new <link linkend="GtkTextAttributes">GtkTextAttributes</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-attributes-copy">gtk_text_attributes_copy ()</title>
<programlisting><link linkend="GtkTextAttributes">GtkTextAttributes</link>* gtk_text_attributes_copy (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *src);</programlisting>
<para>
Copies <parameter>src</parameter> and returns a new <link linkend="GtkTextAttributes">GtkTextAttributes</link>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>src</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTextAttributes">GtkTextAttributes</link> to be copied
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> a copy of <parameter>src</parameter>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-attributes-copy-values">gtk_text_attributes_copy_values ()</title>
<programlisting>void        gtk_text_attributes_copy_values (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *src,
                                             <link linkend="GtkTextAttributes">GtkTextAttributes</link> *dest);</programlisting>
<para>
Copies the values from <parameter>src</parameter> to <parameter>dest</parameter> so that <parameter>dest</parameter> has the same values
as <parameter>src</parameter>. Frees existing values in <parameter>dest</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>src</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTextAttributes">GtkTextAttributes</link>
</entry></row>
<row><entry align="right"><parameter>dest</parameter>&nbsp;:</entry>
<entry> another <link linkend="GtkTextAttributes">GtkTextAttributes</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-attributes-unref">gtk_text_attributes_unref ()</title>
<programlisting>void        gtk_text_attributes_unref       (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *values);</programlisting>
<para>
Decrements the reference count on <parameter>values</parameter>, freeing the structure
if the reference count reaches 0.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>values</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTextAttributes">GtkTextAttributes</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-text-attributes-ref">gtk_text_attributes_ref ()</title>
<programlisting>void        gtk_text_attributes_ref         (<link linkend="GtkTextAttributes">GtkTextAttributes</link> *values);</programlisting>
<para>
Increments the reference count on <parameter>values</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>values</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTextAttributes">GtkTextAttributes</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GtkTextTag--name">&quot;<literal>name</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read / Write / Construct Only)</term>
<listitem>
<para>
Name of the tag, or <literal>NULL</literal> for anonymous tags. Can only be set
when the tag is created.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--background">&quot;<literal>background</literal>&quot; (<link linkend="gchararray">gchararray</link> : Write)</term>
<listitem>
<para>
Background color, as a string such as "red" or "<link linkend="FFFFFF-CAPS">FFFFFF</link>"
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--foreground">&quot;<literal>foreground</literal>&quot; (<link linkend="gchararray">gchararray</link> : Write)</term>
<listitem>
<para>
Foreground color as a string such as "red" or "<link linkend="FFFFFF-CAPS">FFFFFF</link>".
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--background-gdk">&quot;<literal>background-gdk</literal>&quot; (<link linkend="GdkColor">GdkColor</link> : Read / Write)</term>
<listitem>
<para>
Background color, as a <link linkend="GdkColor">GdkColor</link>. The color need not be allocated.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--foreground-gdk">&quot;<literal>foreground-gdk</literal>&quot; (<link linkend="GdkColor">GdkColor</link> : Read / Write)</term>
<listitem>
<para>
Foreground color as a <link linkend="GdkColor">GdkColor</link>. The color need not be allocated.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--background-stipple">&quot;<literal>background-stipple</literal>&quot; (<link linkend="GdkPixmap">GdkPixmap</link> : Read / Write)</term>
<listitem>
<para>
A <link linkend="GdkBitmap">GdkBitmap</link> to use for stippling the background color.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--foreground-stipple">&quot;<literal>foreground-stipple</literal>&quot; (<link linkend="GdkPixmap">GdkPixmap</link> : Read / Write)</term>
<listitem>
<para>
A <link linkend="GdkBitmap">GdkBitmap</link> to use as a stipple pattern for the foreground.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--font">&quot;<literal>font</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read / Write)</term>
<listitem>
<para>
Font as a Pango font name, e.g. "Sans Italic 12"
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--font-desc">&quot;<literal>font-desc</literal>&quot; (<link linkend="PangoFontDescription">PangoFontDescription</link> : Read / Write)</term>
<listitem>
<para>
Font as a <link linkend="PangoFontDescription">PangoFontDescription</link>.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--family">&quot;<literal>family</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read / Write)</term>
<listitem>
<para>
Font family as a string.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--style">&quot;<literal>style</literal>&quot; (<link linkend="PangoStyle">PangoStyle</link> : Read / Write)</term>
<listitem>
<para>
Font style as a <link linkend="PangoStyle">PangoStyle</link>, e.g. <link linkend="PANGO-STYLE-ITALIC-CAPS">PANGO_STYLE_ITALIC</link>.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--variant">&quot;<literal>variant</literal>&quot; (<link linkend="PangoVariant">PangoVariant</link> : Read / Write)</term>
<listitem>
<para>
Font variant as a <link linkend="PangoVariant">PangoVariant</link>, e.g. <link linkend="PANGO-VARIANT-SMALL-CAPS-CAPS">PANGO_VARIANT_SMALL_CAPS</link>.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--weight">&quot;<literal>weight</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Font weight as an integer, see predefined values in <link linkend="PangoWeight">PangoWeight</link>; 
for example, <link linkend="PANGO-WEIGHT-BOLD-CAPS">PANGO_WEIGHT_BOLD</link>.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--stretch">&quot;<literal>stretch</literal>&quot; (<link linkend="PangoStretch">PangoStretch</link> : Read / Write)</term>
<listitem>
<para>
Font stretch as a <link linkend="PangoStretch">PangoStretch</link>, e.g. <link linkend="PANGO-STRETCH-CONDENSED-CAPS">PANGO_STRETCH_CONDENSED</link>.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--size">&quot;<literal>size</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Font size as an integer in Pango units, as for
<link linkend="pango-font-description-set-size">pango_font_description_set_size</link>(). Using the "scale" property is
usually better.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--size-points">&quot;<literal>size-points</literal>&quot; (<link linkend="gdouble">gdouble</link> : Read / Write)</term>
<listitem>
<para>
Font size as a double, in points. Using the "scale" property is
usually better.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--scale">&quot;<literal>scale</literal>&quot; (<link linkend="gdouble">gdouble</link> : Read / Write)</term>
<listitem>
<para>
Font size as a scale factor relative to the default font size.
This properly adapts to theme changes etc. so is recommended. 
Pango predefines some scales such as <link linkend="PANGO-SCALE-X-LARGE-CAPS">PANGO_SCALE_X_LARGE</link>.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--pixels-above-lines">&quot;<literal>pixels-above-lines</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Pixels of blank space to leave above each newline-terminated line.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--pixels-below-lines">&quot;<literal>pixels-below-lines</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Pixels of blank space to leave below each newline-terminated line.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--pixels-inside-wrap">&quot;<literal>pixels-inside-wrap</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Pixels of blank space to leave between wrapped lines inside the same
newline-terminated line (paragraph).
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--editable">&quot;<literal>editable</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
Whether the user can modify the tagged text.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--wrap-mode">&quot;<literal>wrap-mode</literal>&quot; (<link linkend="GtkWrapMode">GtkWrapMode</link> : Read / Write)</term>
<listitem>
<para>
A <link linkend="GtkWrapMode">GtkWrapMode</link> value. Only used if the tag applies to the first
character in a paragraph.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--justification">&quot;<literal>justification</literal>&quot; (<link linkend="GtkJustification">GtkJustification</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--direction">&quot;<literal>direction</literal>&quot; (<link linkend="GtkTextDirection">GtkTextDirection</link> : Read / Write)</term>
<listitem>
<para>
The <link linkend="GtkTextDirection">GtkTextDirection</link> for the tagged text.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--left-margin">&quot;<literal>left-margin</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Pixel width of left margin of the text.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--indent">&quot;<literal>indent</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Pixel size of paragraph indentation; may be negative.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--strikethrough">&quot;<literal>strikethrough</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
<literal>TRUE</literal> to draw a line through the text.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--right-margin">&quot;<literal>right-margin</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Pixel width of right margin.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--underline">&quot;<literal>underline</literal>&quot; (<link linkend="PangoUnderline">PangoUnderline</link> : Read / Write)</term>
<listitem>
<para>
A <link linkend="PangoUnderline">PangoUnderline</link> value.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--rise">&quot;<literal>rise</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
Used for superscript or subscript; value is given in pixels.
Negative rise means subscript.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--background-full-height">&quot;<literal>background-full-height</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
Whether to make the background color for each character the height of
the highest font used on the current line, or the height of the font 
used for the current character.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--language">&quot;<literal>language</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read / Write)</term>
<listitem>
<para>
The language this text is in, as an ISO code. Pango can use this as a
hint when rendering the text. If you don't understand this argument, 
you probably don't need it.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--tabs">&quot;<literal>tabs</literal>&quot; (<link linkend="PangoTabArray">PangoTabArray</link> : Read / Write)</term>
<listitem>
<para>
A <link linkend="PangoTabArray">PangoTabArray</link> indicating tabs for this text.  Only used if the tag
applies to the first character in a paragraph.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--invisible">&quot;<literal>invisible</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
Not implemented in GTK 2.0. Would make text disappear.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--background-set">&quot;<literal>background-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
If <literal>TRUE</literal>, honor the background property. Automatically toggled
on when setting the background property.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--foreground-set">&quot;<literal>foreground-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
If <literal>TRUE</literal>, honor the foreground property. Automatically toggled
on when setting the foreground property.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--background-stipple-set">&quot;<literal>background-stipple-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--foreground-stipple-set">&quot;<literal>foreground-stipple-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--family-set">&quot;<literal>family-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--style-set">&quot;<literal>style-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--variant-set">&quot;<literal>variant-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--weight-set">&quot;<literal>weight-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--stretch-set">&quot;<literal>stretch-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--size-set">&quot;<literal>size-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--scale-set">&quot;<literal>scale-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--pixels-above-lines-set">&quot;<literal>pixels-above-lines-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--pixels-below-lines-set">&quot;<literal>pixels-below-lines-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--pixels-inside-wrap-set">&quot;<literal>pixels-inside-wrap-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--editable-set">&quot;<literal>editable-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--wrap-mode-set">&quot;<literal>wrap-mode-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--justification-set">&quot;<literal>justification-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--left-margin-set">&quot;<literal>left-margin-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--indent-set">&quot;<literal>indent-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--strikethrough-set">&quot;<literal>strikethrough-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--right-margin-set">&quot;<literal>right-margin-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--underline-set">&quot;<literal>underline-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--rise-set">&quot;<literal>rise-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--background-full-height-set">&quot;<literal>background-full-height-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--language-set">&quot;<literal>language-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--tabs-set">&quot;<literal>tabs-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTextTag--invisible-set">&quot;<literal>invisible-set</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>

</variablelist>
</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GtkTextTag-event">The &quot;event&quot; signal</title>
<programlisting><link linkend="gboolean">gboolean</link>    user_function                  (<link linkend="GtkTextTag">GtkTextTag</link> *texttag,
                                            <link linkend="GObject">GObject</link> *arg1,
                                            <link linkend="GdkEvent">GdkEvent</link> *event,
                                            <link linkend="GtkTextIter">GtkTextIter</link> arg2,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>texttag</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>arg1</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>event</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>arg2</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>

</entry></row>
</tbody></tgroup></informaltable></refsect2>
</refsect1>



</refentry>
