<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkTextTag">
<refmeta>
<refentrytitle role="top_of_page" id="GtkTextTag.top_of_page">GtkTextTag</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkTextTag</refname>
<refpurpose>A tag that can be applied to text in a GtkTextBuffer</refpurpose>
</refnamediv>

<refsect1 id="GtkTextTag.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkTextTag"><returnvalue>GtkTextTag</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-text-tag-new">gtk_text_tag_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-text-tag-get-priority">gtk_text_tag_get_priority</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-text-tag-set-priority">gtk_text_tag_set_priority</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-text-tag-changed">gtk_text_tag_changed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkTextTag.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--accumulative-margin">accumulative-margin</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--allow-breaks">allow-breaks</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--allow-breaks-set">allow-breaks-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--background">background</link></entry><entry role="property_flags">Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--background-full-height">background-full-height</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--background-full-height-set">background-full-height-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--background-rgba">background-rgba</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--background-set">background-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkTextDirection"><type>GtkTextDirection</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--direction">direction</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--editable">editable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--editable-set">editable-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--fallback">fallback</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--fallback-set">fallback-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--family">family</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--family-set">family-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--font">font</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--font-desc">font-desc</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--font-features">font-features</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--font-features-set">font-features-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--foreground">foreground</link></entry><entry role="property_flags">Write</entry></row>
<row><entry role="property_type"><link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--foreground-rgba">foreground-rgba</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--foreground-set">foreground-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--indent">indent</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--indent-set">indent-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--insert-hyphens">insert-hyphens</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--insert-hyphens-set">insert-hyphens-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--invisible">invisible</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--invisible-set">invisible-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkJustification"><type>GtkJustification</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--justification">justification</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--justification-set">justification-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--language">language</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--language-set">language-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--left-margin">left-margin</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--left-margin-set">left-margin-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--letter-spacing">letter-spacing</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--letter-spacing-set">letter-spacing-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--name">name</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--paragraph-background">paragraph-background</link></entry><entry role="property_flags">Write</entry></row>
<row><entry role="property_type"><link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--paragraph-background-rgba">paragraph-background-rgba</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--paragraph-background-set">paragraph-background-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--pixels-above-lines">pixels-above-lines</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--pixels-above-lines-set">pixels-above-lines-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--pixels-below-lines">pixels-below-lines</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--pixels-below-lines-set">pixels-below-lines-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--pixels-inside-wrap">pixels-inside-wrap</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--pixels-inside-wrap-set">pixels-inside-wrap-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--right-margin">right-margin</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--right-margin-set">right-margin-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--rise">rise</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--rise-set">rise-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--scale">scale</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--scale-set">scale-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoShowFlags"><type>PangoShowFlags</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--show-spaces">show-spaces</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--show-spaces-set">show-spaces-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--size">size</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--size-points">size-points</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--size-set">size-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoStretch"><type>PangoStretch</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--stretch">stretch</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--stretch-set">stretch-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--strikethrough">strikethrough</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--strikethrough-rgba">strikethrough-rgba</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--strikethrough-rgba-set">strikethrough-rgba-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--strikethrough-set">strikethrough-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoStyle"><type>PangoStyle</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--style">style</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--style-set">style-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoTabArray"><type>PangoTabArray</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--tabs">tabs</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--tabs-set">tabs-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoUnderline"><type>PangoUnderline</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--underline">underline</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkTextTag--underline-rgba">underline-rgba</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--underline-rgba-set">underline-rgba-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--underline-set">underline-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoVariant"><type>PangoVariant</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--variant">variant</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--variant-set">variant-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--weight">weight</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--weight-set">weight-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkWrapMode"><type>GtkWrapMode</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--wrap-mode">wrap-mode</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkTextTag--wrap-mode-set">wrap-mode-set</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkTextTag.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkTextTag-struct">GtkTextTag</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkTextTag.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkTextTag
</screen>
</refsect1>

<refsect1 id="GtkTextTag.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkTextTag.description" role="desc">
<title role="desc.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"><type>GtkTextTagTable</type></link> for a given <link linkend="GtkTextBuffer"><type>GtkTextBuffer</type></link>
before using them with that buffer.</para>
<para>gtk_text_buffer_create_tag() is the best way to create tags.
See “gtk4-demo” for numerous examples.</para>
<para>For each property of <link linkend="GtkTextTag"><type>GtkTextTag</type></link>, there is a “set” property, e.g.
“font-set” corresponds to “font”. These “set” properties reflect
whether a property has been set or not.
They are maintained by GTK+ and you should not set them independently.</para>

</refsect1>
<refsect1 id="GtkTextTag.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-text-tag-new" role="function">
<title>gtk_text_tag_new&#160;()</title>
<indexterm zone="gtk-text-tag-new"><primary>gtk_text_tag_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkTextTag"><returnvalue>GtkTextTag</returnvalue></link>&#160;*
gtk_text_tag_new (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>);</programlisting>
<para>Creates a <link linkend="GtkTextTag"><type>GtkTextTag</type></link>. Configure the tag using object arguments,
i.e. using <link linkend="g-object-set"><function>g_object_set()</function></link>.</para>
<refsect3 id="gtk-text-tag-new.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>tag name, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-text-tag-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkTextTag"><type>GtkTextTag</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-text-tag-get-priority" role="function">
<title>gtk_text_tag_get_priority&#160;()</title>
<indexterm zone="gtk-text-tag-get-priority"><primary>gtk_text_tag_get_priority</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_text_tag_get_priority (<parameter><link linkend="GtkTextTag"><type>GtkTextTag</type></link> *tag</parameter>);</programlisting>
<para>Get the tag priority.</para>
<refsect3 id="gtk-text-tag-get-priority.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>tag</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTextTag"><type>GtkTextTag</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-text-tag-get-priority.returns" role="returns">
<title>Returns</title>
<para> The tag’s priority.</para>
</refsect3></refsect2>
<refsect2 id="gtk-text-tag-set-priority" role="function">
<title>gtk_text_tag_set_priority&#160;()</title>
<indexterm zone="gtk-text-tag-set-priority"><primary>gtk_text_tag_set_priority</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_text_tag_set_priority (<parameter><link linkend="GtkTextTag"><type>GtkTextTag</type></link> *tag</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> priority</parameter>);</programlisting>
<para>Sets the priority of a <link linkend="GtkTextTag"><type>GtkTextTag</type></link>. Valid priorities
start at 0 and go to one less than <link linkend="gtk-text-tag-table-get-size"><function>gtk_text_tag_table_get_size()</function></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"><function>gtk_text_buffer_create_tag()</function></link>, which adds the tag to the buffer’s table
automatically.</para>
<refsect3 id="gtk-text-tag-set-priority.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>tag</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTextTag"><type>GtkTextTag</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>priority</para></entry>
<entry role="parameter_description"><para>the new priority</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-text-tag-changed" role="function">
<title>gtk_text_tag_changed&#160;()</title>
<indexterm zone="gtk-text-tag-changed"><primary>gtk_text_tag_changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_text_tag_changed (<parameter><link linkend="GtkTextTag"><type>GtkTextTag</type></link> *tag</parameter>,
                      <parameter><link linkend="gboolean"><type>gboolean</type></link> size_changed</parameter>);</programlisting>
<para>Emits the <link linkend="GtkTextTagTable-tag-changed"><type>“tag-changed”</type></link> signal on the <link linkend="GtkTextTagTable"><type>GtkTextTagTable</type></link> where
the tag is included.</para>
<para>The signal is already emitted when setting a <link linkend="GtkTextTag"><type>GtkTextTag</type></link> property. This
function is useful for a <link linkend="GtkTextTag"><type>GtkTextTag</type></link> subclass.</para>
<refsect3 id="gtk-text-tag-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>tag</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTextTag"><type>GtkTextTag</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>size_changed</para></entry>
<entry role="parameter_description"><para>whether the change affects the <link linkend="GtkTextView"><type>GtkTextView</type></link> layout.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkTextTag.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkTextTag-struct" role="struct">
<title>struct GtkTextTag</title>
<indexterm zone="GtkTextTag-struct"><primary>GtkTextTag</primary></indexterm>
<programlisting language="C">struct GtkTextTag;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkTextTag.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkTextTag--accumulative-margin" role="property"><title>The <literal>“accumulative-margin”</literal> property</title>
<indexterm zone="GtkTextTag--accumulative-margin"><primary>GtkTextTag:accumulative-margin</primary></indexterm>
<programlisting>  “accumulative-margin”      <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the margins accumulate or override each other.</para>
<para>When set to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> the margins of this tag are added to the margins

of any other non-accumulative margins present. When set to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>

the margins override one another (the default).</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--allow-breaks" role="property"><title>The <literal>“allow-breaks”</literal> property</title>
<indexterm zone="GtkTextTag--allow-breaks"><primary>GtkTextTag:allow-breaks</primary></indexterm>
<programlisting>  “allow-breaks”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether breaks are allowed.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkTextTag--allow-breaks-set" role="property"><title>The <literal>“allow-breaks-set”</literal> property</title>
<indexterm zone="GtkTextTag--allow-breaks-set"><primary>GtkTextTag:allow-breaks-set</primary></indexterm>
<programlisting>  “allow-breaks-set”         <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects line breaks.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--background" role="property"><title>The <literal>“background”</literal> property</title>
<indexterm zone="GtkTextTag--background"><primary>GtkTextTag:background</primary></indexterm>
<programlisting>  “background”               <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Background color as a string.</para><para>Owner: GtkTextTag</para>
<para>Flags: Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--background-full-height" role="property"><title>The <literal>“background-full-height”</literal> property</title>
<indexterm zone="GtkTextTag--background-full-height"><primary>GtkTextTag:background-full-height</primary></indexterm>
<programlisting>  “background-full-height”   <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the background color fills the entire line height or only the height of the tagged characters.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--background-full-height-set" role="property"><title>The <literal>“background-full-height-set”</literal> property</title>
<indexterm zone="GtkTextTag--background-full-height-set"><primary>GtkTextTag:background-full-height-set</primary></indexterm>
<programlisting>  “background-full-height-set” <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects background height.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--background-rgba" role="property"><title>The <literal>“background-rgba”</literal> property</title>
<indexterm zone="GtkTextTag--background-rgba"><primary>GtkTextTag:background-rgba</primary></indexterm>
<programlisting>  “background-rgba”          <link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</programlisting>
<para>Background color as a <link linkend="GdkRGBA"><type>GdkRGBA</type></link>.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--background-set" role="property"><title>The <literal>“background-set”</literal> property</title>
<indexterm zone="GtkTextTag--background-set"><primary>GtkTextTag:background-set</primary></indexterm>
<programlisting>  “background-set”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the background color.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--direction" role="property"><title>The <literal>“direction”</literal> property</title>
<indexterm zone="GtkTextTag--direction"><primary>GtkTextTag:direction</primary></indexterm>
<programlisting>  “direction”                <link linkend="GtkTextDirection"><type>GtkTextDirection</type></link></programlisting>
<para>Text direction, e.g. right-to-left or left-to-right.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_TEXT_DIR_NONE</para>
</refsect2>
<refsect2 id="GtkTextTag--editable" role="property"><title>The <literal>“editable”</literal> property</title>
<indexterm zone="GtkTextTag--editable"><primary>GtkTextTag:editable</primary></indexterm>
<programlisting>  “editable”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the text can be modified by the user.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkTextTag--editable-set" role="property"><title>The <literal>“editable-set”</literal> property</title>
<indexterm zone="GtkTextTag--editable-set"><primary>GtkTextTag:editable-set</primary></indexterm>
<programlisting>  “editable-set”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects text editability.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--fallback" role="property"><title>The <literal>“fallback”</literal> property</title>
<indexterm zone="GtkTextTag--fallback"><primary>GtkTextTag:fallback</primary></indexterm>
<programlisting>  “fallback”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether font fallback is enabled.</para>
<para>When set to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, other fonts will be substituted
where the current font is missing glyphs.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkTextTag--fallback-set" role="property"><title>The <literal>“fallback-set”</literal> property</title>
<indexterm zone="GtkTextTag--fallback-set"><primary>GtkTextTag:fallback-set</primary></indexterm>
<programlisting>  “fallback-set”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects font fallback.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--family" role="property"><title>The <literal>“family”</literal> property</title>
<indexterm zone="GtkTextTag--family"><primary>GtkTextTag:family</primary></indexterm>
<programlisting>  “family”                   <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Name of the font family, e.g. Sans, Helvetica, Times, Monospace.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--family-set" role="property"><title>The <literal>“family-set”</literal> property</title>
<indexterm zone="GtkTextTag--family-set"><primary>GtkTextTag:family-set</primary></indexterm>
<programlisting>  “family-set”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font family.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--font" role="property"><title>The <literal>“font”</literal> property</title>
<indexterm zone="GtkTextTag--font"><primary>GtkTextTag:font</primary></indexterm>
<programlisting>  “font”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Font description as string, e.g. \"Sans Italic 12\". </para>
<para>Note that the initial value of this property depends on
the internals of <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--font-desc" role="property"><title>The <literal>“font-desc”</literal> property</title>
<indexterm zone="GtkTextTag--font-desc"><primary>GtkTextTag:font-desc</primary></indexterm>
<programlisting>  “font-desc”                <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>&#160;*</programlisting>
<para>Font description as a PangoFontDescription struct.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--font-features" role="property"><title>The <literal>“font-features”</literal> property</title>
<indexterm zone="GtkTextTag--font-features"><primary>GtkTextTag:font-features</primary></indexterm>
<programlisting>  “font-features”            <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>OpenType font features, as a string.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--font-features-set" role="property"><title>The <literal>“font-features-set”</literal> property</title>
<indexterm zone="GtkTextTag--font-features-set"><primary>GtkTextTag:font-features-set</primary></indexterm>
<programlisting>  “font-features-set”        <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects font features.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--foreground" role="property"><title>The <literal>“foreground”</literal> property</title>
<indexterm zone="GtkTextTag--foreground"><primary>GtkTextTag:foreground</primary></indexterm>
<programlisting>  “foreground”               <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Foreground color as a string.</para><para>Owner: GtkTextTag</para>
<para>Flags: Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--foreground-rgba" role="property"><title>The <literal>“foreground-rgba”</literal> property</title>
<indexterm zone="GtkTextTag--foreground-rgba"><primary>GtkTextTag:foreground-rgba</primary></indexterm>
<programlisting>  “foreground-rgba”          <link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</programlisting>
<para>Foreground color as a <link linkend="GdkRGBA"><type>GdkRGBA</type></link>.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--foreground-set" role="property"><title>The <literal>“foreground-set”</literal> property</title>
<indexterm zone="GtkTextTag--foreground-set"><primary>GtkTextTag:foreground-set</primary></indexterm>
<programlisting>  “foreground-set”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the foreground color.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--indent" role="property"><title>The <literal>“indent”</literal> property</title>
<indexterm zone="GtkTextTag--indent"><primary>GtkTextTag:indent</primary></indexterm>
<programlisting>  “indent”                   <link linkend="gint"><type>gint</type></link></programlisting>
<para>Amount to indent the paragraph, in pixels.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--indent-set" role="property"><title>The <literal>“indent-set”</literal> property</title>
<indexterm zone="GtkTextTag--indent-set"><primary>GtkTextTag:indent-set</primary></indexterm>
<programlisting>  “indent-set”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects indentation.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--insert-hyphens" role="property"><title>The <literal>“insert-hyphens”</literal> property</title>
<indexterm zone="GtkTextTag--insert-hyphens"><primary>GtkTextTag:insert-hyphens</primary></indexterm>
<programlisting>  “insert-hyphens”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to insert hyphens at breaks.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkTextTag--insert-hyphens-set" role="property"><title>The <literal>“insert-hyphens-set”</literal> property</title>
<indexterm zone="GtkTextTag--insert-hyphens-set"><primary>GtkTextTag:insert-hyphens-set</primary></indexterm>
<programlisting>  “insert-hyphens-set”       <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects insertion of hyphens.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--invisible" role="property"><title>The <literal>“invisible”</literal> property</title>
<indexterm zone="GtkTextTag--invisible"><primary>GtkTextTag:invisible</primary></indexterm>
<programlisting>  “invisible”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this text is hidden.</para>
<para>Note that there may still be problems with the support for invisible

text, in particular when navigating programmatically inside a buffer
containing invisible segments.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--invisible-set" role="property"><title>The <literal>“invisible-set”</literal> property</title>
<indexterm zone="GtkTextTag--invisible-set"><primary>GtkTextTag:invisible-set</primary></indexterm>
<programlisting>  “invisible-set”            <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects text visibility.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--justification" role="property"><title>The <literal>“justification”</literal> property</title>
<indexterm zone="GtkTextTag--justification"><primary>GtkTextTag:justification</primary></indexterm>
<programlisting>  “justification”            <link linkend="GtkJustification"><type>GtkJustification</type></link></programlisting>
<para>Left, right, or center justification.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_JUSTIFY_LEFT</para>
</refsect2>
<refsect2 id="GtkTextTag--justification-set" role="property"><title>The <literal>“justification-set”</literal> property</title>
<indexterm zone="GtkTextTag--justification-set"><primary>GtkTextTag:justification-set</primary></indexterm>
<programlisting>  “justification-set”        <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects paragraph justification.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--language" role="property"><title>The <literal>“language”</literal> property</title>
<indexterm zone="GtkTextTag--language"><primary>GtkTextTag:language</primary></indexterm>
<programlisting>  “language”                 <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The language this text is in, as an ISO code. Pango can use this as a

hint when rendering the text. If not set, an appropriate default will be

used.</para>
<para>Note that the initial value of this property depends on the current
locale, see also <link linkend="gtk-get-default-language"><function>gtk_get_default_language()</function></link>.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--language-set" role="property"><title>The <literal>“language-set”</literal> property</title>
<indexterm zone="GtkTextTag--language-set"><primary>GtkTextTag:language-set</primary></indexterm>
<programlisting>  “language-set”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the language the text is rendered as.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--left-margin" role="property"><title>The <literal>“left-margin”</literal> property</title>
<indexterm zone="GtkTextTag--left-margin"><primary>GtkTextTag:left-margin</primary></indexterm>
<programlisting>  “left-margin”              <link linkend="gint"><type>gint</type></link></programlisting>
<para>Width of the left margin in pixels.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--left-margin-set" role="property"><title>The <literal>“left-margin-set”</literal> property</title>
<indexterm zone="GtkTextTag--left-margin-set"><primary>GtkTextTag:left-margin-set</primary></indexterm>
<programlisting>  “left-margin-set”          <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the left margin.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--letter-spacing" role="property"><title>The <literal>“letter-spacing”</literal> property</title>
<indexterm zone="GtkTextTag--letter-spacing"><primary>GtkTextTag:letter-spacing</primary></indexterm>
<programlisting>  “letter-spacing”           <link linkend="gint"><type>gint</type></link></programlisting>
<para>Extra spacing between graphemes, in Pango units.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--letter-spacing-set" role="property"><title>The <literal>“letter-spacing-set”</literal> property</title>
<indexterm zone="GtkTextTag--letter-spacing-set"><primary>GtkTextTag:letter-spacing-set</primary></indexterm>
<programlisting>  “letter-spacing-set”       <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects letter spacing.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--name" role="property"><title>The <literal>“name”</literal> property</title>
<indexterm zone="GtkTextTag--name"><primary>GtkTextTag:name</primary></indexterm>
<programlisting>  “name”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Name used to refer to the text tag. NULL for anonymous tags.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--paragraph-background" role="property"><title>The <literal>“paragraph-background”</literal> property</title>
<indexterm zone="GtkTextTag--paragraph-background"><primary>GtkTextTag:paragraph-background</primary></indexterm>
<programlisting>  “paragraph-background”     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The paragraph background color as a string.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkTextTag--paragraph-background-rgba" role="property"><title>The <literal>“paragraph-background-rgba”</literal> property</title>
<indexterm zone="GtkTextTag--paragraph-background-rgba"><primary>GtkTextTag:paragraph-background-rgba</primary></indexterm>
<programlisting>  “paragraph-background-rgba” <link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</programlisting>
<para>The paragraph background color as a <link linkend="GdkRGBA"><type>GdkRGBA</type></link>.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--paragraph-background-set" role="property"><title>The <literal>“paragraph-background-set”</literal> property</title>
<indexterm zone="GtkTextTag--paragraph-background-set"><primary>GtkTextTag:paragraph-background-set</primary></indexterm>
<programlisting>  “paragraph-background-set” <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the paragraph background color.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--pixels-above-lines" role="property"><title>The <literal>“pixels-above-lines”</literal> property</title>
<indexterm zone="GtkTextTag--pixels-above-lines"><primary>GtkTextTag:pixels-above-lines</primary></indexterm>
<programlisting>  “pixels-above-lines”       <link linkend="gint"><type>gint</type></link></programlisting>
<para>Pixels of blank space above paragraphs.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--pixels-above-lines-set" role="property"><title>The <literal>“pixels-above-lines-set”</literal> property</title>
<indexterm zone="GtkTextTag--pixels-above-lines-set"><primary>GtkTextTag:pixels-above-lines-set</primary></indexterm>
<programlisting>  “pixels-above-lines-set”   <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the number of pixels above lines.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--pixels-below-lines" role="property"><title>The <literal>“pixels-below-lines”</literal> property</title>
<indexterm zone="GtkTextTag--pixels-below-lines"><primary>GtkTextTag:pixels-below-lines</primary></indexterm>
<programlisting>  “pixels-below-lines”       <link linkend="gint"><type>gint</type></link></programlisting>
<para>Pixels of blank space below paragraphs.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--pixels-below-lines-set" role="property"><title>The <literal>“pixels-below-lines-set”</literal> property</title>
<indexterm zone="GtkTextTag--pixels-below-lines-set"><primary>GtkTextTag:pixels-below-lines-set</primary></indexterm>
<programlisting>  “pixels-below-lines-set”   <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the number of pixels above lines.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--pixels-inside-wrap" role="property"><title>The <literal>“pixels-inside-wrap”</literal> property</title>
<indexterm zone="GtkTextTag--pixels-inside-wrap"><primary>GtkTextTag:pixels-inside-wrap</primary></indexterm>
<programlisting>  “pixels-inside-wrap”       <link linkend="gint"><type>gint</type></link></programlisting>
<para>Pixels of blank space between wrapped lines in a paragraph.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--pixels-inside-wrap-set" role="property"><title>The <literal>“pixels-inside-wrap-set”</literal> property</title>
<indexterm zone="GtkTextTag--pixels-inside-wrap-set"><primary>GtkTextTag:pixels-inside-wrap-set</primary></indexterm>
<programlisting>  “pixels-inside-wrap-set”   <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the number of pixels between wrapped lines.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--right-margin" role="property"><title>The <literal>“right-margin”</literal> property</title>
<indexterm zone="GtkTextTag--right-margin"><primary>GtkTextTag:right-margin</primary></indexterm>
<programlisting>  “right-margin”             <link linkend="gint"><type>gint</type></link></programlisting>
<para>Width of the right margin in pixels.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--right-margin-set" role="property"><title>The <literal>“right-margin-set”</literal> property</title>
<indexterm zone="GtkTextTag--right-margin-set"><primary>GtkTextTag:right-margin-set</primary></indexterm>
<programlisting>  “right-margin-set”         <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the right margin.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--rise" role="property"><title>The <literal>“rise”</literal> property</title>
<indexterm zone="GtkTextTag--rise"><primary>GtkTextTag:rise</primary></indexterm>
<programlisting>  “rise”                     <link linkend="gint"><type>gint</type></link></programlisting>
<para>Offset of text above the baseline (below the baseline if rise is negative) in Pango units.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--rise-set" role="property"><title>The <literal>“rise-set”</literal> property</title>
<indexterm zone="GtkTextTag--rise-set"><primary>GtkTextTag:rise-set</primary></indexterm>
<programlisting>  “rise-set”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the rise.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--scale" role="property"><title>The <literal>“scale”</literal> property</title>
<indexterm zone="GtkTextTag--scale"><primary>GtkTextTag:scale</primary></indexterm>
<programlisting>  “scale”                    <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<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 PANGO_SCALE_X_LARGE.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 1</para>
</refsect2>
<refsect2 id="GtkTextTag--scale-set" role="property"><title>The <literal>“scale-set”</literal> property</title>
<indexterm zone="GtkTextTag--scale-set"><primary>GtkTextTag:scale-set</primary></indexterm>
<programlisting>  “scale-set”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag scales the font size by a factor.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--show-spaces" role="property"><title>The <literal>“show-spaces”</literal> property</title>
<indexterm zone="GtkTextTag--show-spaces"><primary>GtkTextTag:show-spaces</primary></indexterm>
<programlisting>  “show-spaces”              <link linkend="PangoShowFlags"><type>PangoShowFlags</type></link></programlisting>
<para>How to render invisible characters.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--show-spaces-set" role="property"><title>The <literal>“show-spaces-set”</literal> property</title>
<indexterm zone="GtkTextTag--show-spaces-set"><primary>GtkTextTag:show-spaces-set</primary></indexterm>
<programlisting>  “show-spaces-set”          <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects rendering of invisible characters.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--size" role="property"><title>The <literal>“size”</literal> property</title>
<indexterm zone="GtkTextTag--size"><primary>GtkTextTag:size</primary></indexterm>
<programlisting>  “size”                     <link linkend="gint"><type>gint</type></link></programlisting>
<para>Font size in Pango units.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--size-points" role="property"><title>The <literal>“size-points”</literal> property</title>
<indexterm zone="GtkTextTag--size-points"><primary>GtkTextTag:size-points</primary></indexterm>
<programlisting>  “size-points”              <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>Font size in points.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTextTag--size-set" role="property"><title>The <literal>“size-set”</literal> property</title>
<indexterm zone="GtkTextTag--size-set"><primary>GtkTextTag:size-set</primary></indexterm>
<programlisting>  “size-set”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font size.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--stretch" role="property"><title>The <literal>“stretch”</literal> property</title>
<indexterm zone="GtkTextTag--stretch"><primary>GtkTextTag:stretch</primary></indexterm>
<programlisting>  “stretch”                  <link linkend="PangoStretch"><type>PangoStretch</type></link></programlisting>
<para>Font stretch as a PangoStretch, e.g. PANGO_STRETCH_CONDENSED.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_STRETCH_NORMAL</para>
</refsect2>
<refsect2 id="GtkTextTag--stretch-set" role="property"><title>The <literal>“stretch-set”</literal> property</title>
<indexterm zone="GtkTextTag--stretch-set"><primary>GtkTextTag:stretch-set</primary></indexterm>
<programlisting>  “stretch-set”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font stretch.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--strikethrough" role="property"><title>The <literal>“strikethrough”</literal> property</title>
<indexterm zone="GtkTextTag--strikethrough"><primary>GtkTextTag:strikethrough</primary></indexterm>
<programlisting>  “strikethrough”            <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to strike through the text.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--strikethrough-rgba" role="property"><title>The <literal>“strikethrough-rgba”</literal> property</title>
<indexterm zone="GtkTextTag--strikethrough-rgba"><primary>GtkTextTag:strikethrough-rgba</primary></indexterm>
<programlisting>  “strikethrough-rgba”       <link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</programlisting>
<para>This property modifies the color of strikeouts. If not set, strikeouts
will use the forground color.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--strikethrough-rgba-set" role="property"><title>The <literal>“strikethrough-rgba-set”</literal> property</title>
<indexterm zone="GtkTextTag--strikethrough-rgba-set"><primary>GtkTextTag:strikethrough-rgba-set</primary></indexterm>
<programlisting>  “strikethrough-rgba-set”   <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>If the <link linkend="GtkTextTag--strikethrough-rgba"><type>“strikethrough-rgba”</type></link> property has been set.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--strikethrough-set" role="property"><title>The <literal>“strikethrough-set”</literal> property</title>
<indexterm zone="GtkTextTag--strikethrough-set"><primary>GtkTextTag:strikethrough-set</primary></indexterm>
<programlisting>  “strikethrough-set”        <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects strikethrough.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--style" role="property"><title>The <literal>“style”</literal> property</title>
<indexterm zone="GtkTextTag--style"><primary>GtkTextTag:style</primary></indexterm>
<programlisting>  “style”                    <link linkend="PangoStyle"><type>PangoStyle</type></link></programlisting>
<para>Font style as a PangoStyle, e.g. PANGO_STYLE_ITALIC.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_STYLE_NORMAL</para>
</refsect2>
<refsect2 id="GtkTextTag--style-set" role="property"><title>The <literal>“style-set”</literal> property</title>
<indexterm zone="GtkTextTag--style-set"><primary>GtkTextTag:style-set</primary></indexterm>
<programlisting>  “style-set”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font style.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--tabs" role="property"><title>The <literal>“tabs”</literal> property</title>
<indexterm zone="GtkTextTag--tabs"><primary>GtkTextTag:tabs</primary></indexterm>
<programlisting>  “tabs”                     <link linkend="PangoTabArray"><type>PangoTabArray</type></link>&#160;*</programlisting>
<para>Custom tabs for this text.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--tabs-set" role="property"><title>The <literal>“tabs-set”</literal> property</title>
<indexterm zone="GtkTextTag--tabs-set"><primary>GtkTextTag:tabs-set</primary></indexterm>
<programlisting>  “tabs-set”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects tabs.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--underline" role="property"><title>The <literal>“underline”</literal> property</title>
<indexterm zone="GtkTextTag--underline"><primary>GtkTextTag:underline</primary></indexterm>
<programlisting>  “underline”                <link linkend="PangoUnderline"><type>PangoUnderline</type></link></programlisting>
<para>Style of underline for this text.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_UNDERLINE_NONE</para>
</refsect2>
<refsect2 id="GtkTextTag--underline-rgba" role="property"><title>The <literal>“underline-rgba”</literal> property</title>
<indexterm zone="GtkTextTag--underline-rgba"><primary>GtkTextTag:underline-rgba</primary></indexterm>
<programlisting>  “underline-rgba”           <link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</programlisting>
<para>This property modifies the color of underlines. If not set, underlines
will use the forground color.</para>
<para>If <link linkend="GtkTextTag--underline"><type>“underline”</type></link> is set to <link linkend="PANGO-UNDERLINE-ERROR:CAPS"><literal>PANGO_UNDERLINE_ERROR</literal></link>, an alternate
color may be applied instead of the foreground. Setting this property
will always override those defaults.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkTextTag--underline-rgba-set" role="property"><title>The <literal>“underline-rgba-set”</literal> property</title>
<indexterm zone="GtkTextTag--underline-rgba-set"><primary>GtkTextTag:underline-rgba-set</primary></indexterm>
<programlisting>  “underline-rgba-set”       <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>If the <link linkend="GtkTextTag--underline-rgba"><type>“underline-rgba”</type></link> property has been set.</para>
<para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--underline-set" role="property"><title>The <literal>“underline-set”</literal> property</title>
<indexterm zone="GtkTextTag--underline-set"><primary>GtkTextTag:underline-set</primary></indexterm>
<programlisting>  “underline-set”            <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects underlining.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--variant" role="property"><title>The <literal>“variant”</literal> property</title>
<indexterm zone="GtkTextTag--variant"><primary>GtkTextTag:variant</primary></indexterm>
<programlisting>  “variant”                  <link linkend="PangoVariant"><type>PangoVariant</type></link></programlisting>
<para>Font variant as a PangoVariant, e.g. PANGO_VARIANT_SMALL_CAPS.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_VARIANT_NORMAL</para>
</refsect2>
<refsect2 id="GtkTextTag--variant-set" role="property"><title>The <literal>“variant-set”</literal> property</title>
<indexterm zone="GtkTextTag--variant-set"><primary>GtkTextTag:variant-set</primary></indexterm>
<programlisting>  “variant-set”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font variant.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--weight" role="property"><title>The <literal>“weight”</literal> property</title>
<indexterm zone="GtkTextTag--weight"><primary>GtkTextTag:weight</primary></indexterm>
<programlisting>  “weight”                   <link linkend="gint"><type>gint</type></link></programlisting>
<para>Font weight as an integer, see predefined values in PangoWeight; for example, PANGO_WEIGHT_BOLD.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 400</para>
</refsect2>
<refsect2 id="GtkTextTag--weight-set" role="property"><title>The <literal>“weight-set”</literal> property</title>
<indexterm zone="GtkTextTag--weight-set"><primary>GtkTextTag:weight-set</primary></indexterm>
<programlisting>  “weight-set”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font weight.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTextTag--wrap-mode" role="property"><title>The <literal>“wrap-mode”</literal> property</title>
<indexterm zone="GtkTextTag--wrap-mode"><primary>GtkTextTag:wrap-mode</primary></indexterm>
<programlisting>  “wrap-mode”                <link linkend="GtkWrapMode"><type>GtkWrapMode</type></link></programlisting>
<para>Whether to wrap lines never, at word boundaries, or at character boundaries.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_WRAP_NONE</para>
</refsect2>
<refsect2 id="GtkTextTag--wrap-mode-set" role="property"><title>The <literal>“wrap-mode-set”</literal> property</title>
<indexterm zone="GtkTextTag--wrap-mode-set"><primary>GtkTextTag:wrap-mode-set</primary></indexterm>
<programlisting>  “wrap-mode-set”            <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects line wrap mode.</para><para>Owner: GtkTextTag</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>

</refsect1>

</refentry>
