tab-stops.xml

Pango is a library for layout and rendering of text, with an emphasis on internationalization. Pang

<refentry id="pango-Tab-Stops">
<refmeta>
<refentrytitle role="top_of_page" id="pango-Tab-Stops.top_of_page">Tab Stops</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PANGO Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>Tab Stops</refname>
<refpurpose>Structures for storing tab stops</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="pango-Tab-Stops.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
                    <link linkend="PangoTabArray">PangoTabArray</link>;
#define             <link linkend="PANGO-TYPE-TAB-ARRAY:CAPS">PANGO_TYPE_TAB_ARRAY</link>
enum                <link linkend="PangoTabAlign">PangoTabAlign</link>;
#define             <link linkend="PANGO-TYPE-TAB-ALIGN:CAPS">PANGO_TYPE_TAB_ALIGN</link>
<link linkend="PangoTabArray">PangoTabArray</link>*      <link linkend="pango-tab-array-new">pango_tab_array_new</link>                 (<link linkend="gint">gint</link> initial_size,
                                                         <link linkend="gboolean">gboolean</link> positions_in_pixels);
<link linkend="PangoTabArray">PangoTabArray</link>*      <link linkend="pango-tab-array-new-with-positions">pango_tab_array_new_with_positions</link>  (<link linkend="gint">gint</link> size,
                                                         <link linkend="gboolean">gboolean</link> positions_in_pixels,
                                                         <link linkend="PangoTabAlign">PangoTabAlign</link> first_alignment,
                                                         <link linkend="gint">gint</link> first_position,
                                                         ...);
<link linkend="PangoTabArray">PangoTabArray</link>*      <link linkend="pango-tab-array-copy">pango_tab_array_copy</link>                (<link linkend="PangoTabArray">PangoTabArray</link> *src);
<link linkend="void">void</link>                <link linkend="pango-tab-array-free">pango_tab_array_free</link>                (<link linkend="PangoTabArray">PangoTabArray</link> *tab_array);
<link linkend="gint">gint</link>                <link linkend="pango-tab-array-get-size">pango_tab_array_get_size</link>            (<link linkend="PangoTabArray">PangoTabArray</link> *tab_array);
<link linkend="void">void</link>                <link linkend="pango-tab-array-resize">pango_tab_array_resize</link>              (<link linkend="PangoTabArray">PangoTabArray</link> *tab_array,
                                                         <link linkend="gint">gint</link> new_size);
<link linkend="void">void</link>                <link linkend="pango-tab-array-set-tab">pango_tab_array_set_tab</link>             (<link linkend="PangoTabArray">PangoTabArray</link> *tab_array,
                                                         <link linkend="gint">gint</link> tab_index,
                                                         <link linkend="PangoTabAlign">PangoTabAlign</link> alignment,
                                                         <link linkend="gint">gint</link> location);
<link linkend="void">void</link>                <link linkend="pango-tab-array-get-tab">pango_tab_array_get_tab</link>             (<link linkend="PangoTabArray">PangoTabArray</link> *tab_array,
                                                         <link linkend="gint">gint</link> tab_index,
                                                         <link linkend="PangoTabAlign">PangoTabAlign</link> *alignment,
                                                         <link linkend="gint">gint</link> *location);
<link linkend="void">void</link>                <link linkend="pango-tab-array-get-tabs">pango_tab_array_get_tabs</link>            (<link linkend="PangoTabArray">PangoTabArray</link> *tab_array,
                                                         <link linkend="PangoTabAlign">PangoTabAlign</link> **alignments,
                                                         <link linkend="gint">gint</link> **locations);
<link linkend="gboolean">gboolean</link>            <link linkend="pango-tab-array-get-positions-in-pixels">pango_tab_array_get_positions_in_pixels</link>
                                                        (<link linkend="PangoTabArray">PangoTabArray</link> *tab_array);
</synopsis>
</refsynopsisdiv>









<refsect1 id="pango-Tab-Stops.description" role="desc">
<title role="desc.title">Description</title>
<para>
Functions in this section are used to deal with <link linkend="PangoTabArray"><type>PangoTabArray</type></link> objects
that can be used to set tab stop positions in a <link linkend="PangoLayout"><type>PangoLayout</type></link>.
</para>
</refsect1>

<refsect1 id="pango-Tab-Stops.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="PangoTabArray" role="struct">
<title>PangoTabArray</title>
<indexterm zone="PangoTabArray"><primary>PangoTabArray</primary></indexterm><programlisting>typedef struct _PangoTabArray PangoTabArray;</programlisting>
<para>
A <link linkend="PangoTabArray"><type>PangoTabArray</type></link> struct contains an array
of tab stops. Each tab stop has an alignment and a position.
</para></refsect2>
<refsect2 id="PANGO-TYPE-TAB-ARRAY:CAPS" role="macro">
<title>PANGO_TYPE_TAB_ARRAY</title>
<indexterm zone="PANGO-TYPE-TAB-ARRAY:CAPS"><primary>PANGO_TYPE_TAB_ARRAY</primary></indexterm><programlisting>#define PANGO_TYPE_TAB_ARRAY (pango_tab_array_get_type ())
</programlisting>
<para>
The <link linkend="GObject"><type>GObject</type></link> type for <link linkend="PangoTabArray"><type>PangoTabArray</type></link>.
</para></refsect2>
<refsect2 id="PangoTabAlign" role="enum">
<title>enum PangoTabAlign</title>
<indexterm zone="PangoTabAlign"><primary>PangoTabAlign</primary></indexterm><programlisting>typedef enum
{
  PANGO_TAB_LEFT

  /* These are not supported now, but may be in the
   * future.
   *
   *  PANGO_TAB_RIGHT,
   *  PANGO_TAB_CENTER,
   *  PANGO_TAB_NUMERIC
   */
} PangoTabAlign;
</programlisting>
<para>
A <link linkend="PangoTabAlign"><type>PangoTabAlign</type></link> specifies where a tab stop appears relative to the text.
</para><variablelist role="enum">
<varlistentry id="PANGO-TAB-LEFT:CAPS" role="constant">
<term><literal>PANGO_TAB_LEFT</literal></term>
<listitem><simpara>the tab stop appears to the left of the text.

</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-TYPE-TAB-ALIGN:CAPS" role="macro">
<title>PANGO_TYPE_TAB_ALIGN</title>
<indexterm zone="PANGO-TYPE-TAB-ALIGN:CAPS"><primary>PANGO_TYPE_TAB_ALIGN</primary></indexterm><programlisting>#define PANGO_TYPE_TAB_ALIGN (pango_tab_align_get_type())
</programlisting>
<para>
The <link linkend="GObject"><type>GObject</type></link> type for <link linkend="PangoTabAlign"><type>PangoTabAlign</type></link>.
</para></refsect2>
<refsect2 id="pango-tab-array-new" role="function">
<title>pango_tab_array_new ()</title>
<indexterm zone="pango-tab-array-new"><primary>pango_tab_array_new</primary></indexterm><programlisting><link linkend="PangoTabArray">PangoTabArray</link>*      pango_tab_array_new                 (<link linkend="gint">gint</link> initial_size,
                                                         <link linkend="gboolean">gboolean</link> positions_in_pixels);</programlisting>
<para>
Creates an array of <parameter>initial_size</parameter> tab stops. Tab stops are specified in
pixel units if <parameter>positions_in_pixels</parameter> is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, otherwise in Pango
units. All stops are initially at position 0.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>initial_size</parameter>&nbsp;:</term>
<listitem><simpara> Initial number of tab stops to allocate, can be 0
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>positions_in_pixels</parameter>&nbsp;:</term>
<listitem><simpara> whether positions are in pixel units
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoTabArray"><type>PangoTabArray</type></link>, which should
              be freed with <link linkend="pango-tab-array-free"><function>pango_tab_array_free()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-tab-array-new-with-positions" role="function">
<title>pango_tab_array_new_with_positions ()</title>
<indexterm zone="pango-tab-array-new-with-positions"><primary>pango_tab_array_new_with_positions</primary></indexterm><programlisting><link linkend="PangoTabArray">PangoTabArray</link>*      pango_tab_array_new_with_positions  (<link linkend="gint">gint</link> size,
                                                         <link linkend="gboolean">gboolean</link> positions_in_pixels,
                                                         <link linkend="PangoTabAlign">PangoTabAlign</link> first_alignment,
                                                         <link linkend="gint">gint</link> first_position,
                                                         ...);</programlisting>
<para>
This is a convenience function that creates a <link linkend="PangoTabArray"><type>PangoTabArray</type></link>
and allows you to specify the alignment and position of each
tab stop. You <emphasis>must</emphasis> provide an alignment
and position for <parameter>size</parameter> tab stops.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>size</parameter>&nbsp;:</term>
<listitem><simpara> number of tab stops in the array
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>positions_in_pixels</parameter>&nbsp;:</term>
<listitem><simpara> whether positions are in pixel units
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>first_alignment</parameter>&nbsp;:</term>
<listitem><simpara> alignment of first tab stop
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>first_position</parameter>&nbsp;:</term>
<listitem><simpara> position of first tab stop
</simpara></listitem></varlistentry>