← Back to branch summary

~ubuntu-branches/debian/sid/pango1.0/sid

« back to all changes in this revision

Viewing changes to docs/html/pango-Text-Attributes.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-03-20 18:01:45 UTC
  • mfrom: (1.9.3)
  • Revision ID: package-import@ubuntu.com-20140320180145-y2zs0pzp6390a6y9
Tags: 1.36.3-1
* Add xauth test-dep, needed for xvfb-run
* New upstream release
  - Fix builddir != srdir builds
    + Drop 0001-Fix-tests-for-builddir-srcdir-by-setting-G_TEST_-SRC.patch,
      which was a cherry-pick of this fix.
  - Avoid a crash when FT_Face is NULL
  - Update pango_color_parse docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/html/pango-Text-Attributes.html
8
8
<link rel="up" href="pango.html" title="Basic Pango Interfaces">
9
9
<link rel="prev" href="pango-Fonts.html" title="Fonts">
10
10
<link rel="next" href="pango-Tab-Stops.html" title="Tab Stops">
11
 
<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.20.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left">
17
 
<a href="#" class="shortcut">Top</a>
18
 
                   | 
19
 
                  <a href="#pango-Text-Attributes.description" class="shortcut">Description</a>
20
 
                   | 
21
 
                  <a href="#pango-Text-Attributes.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
 
16
<td width="100%" align="left" class="shortcuts">
 
17
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
 
18
                  <a href="#pango-Text-Attributes.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
 
19
                  <a href="#pango-Text-Attributes.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
22
20
</td>
23
21
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24
22
<td><a accesskey="u" href="pango.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
32
30
<h2><span class="refentrytitle"><a name="pango-Text-Attributes.top_of_page"></a>Text Attributes</span></h2>
33
31
<p>Text Attributes — Font and other attributes for annotating text</p>
34
32
</td>
35
 
<td valign="top" align="right"></td>
 
33
<td class="gallery_image" valign="top" align="right"></td>
36
34
</tr></table></div>
37
 
<div class="refsynopsisdiv">
38
 
<a name="pango-Text-Attributes.synopsis"></a><h2>Synopsis</h2>
39
 
<a name="PangoAttrType"></a><a name="PangoUnderline"></a><a name="PangoColor"></a><a name="PangoAttrList"></a><pre class="synopsis">enum                <a class="link" href="pango-Text-Attributes.html#PangoAttrType-enum" title="enum PangoAttrType">PangoAttrType</a>;
40
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-ATTR-TYPE:CAPS" title="PANGO_TYPE_ATTR_TYPE">PANGO_TYPE_ATTR_TYPE</a>
41
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass">PangoAttrClass</a>;
42
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute">PangoAttribute</a>;
43
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-FROM-TEXT-BEGINNING:CAPS" title="PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING">PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING</a>
44
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-TO-TEXT-END:CAPS" title="PANGO_ATTR_INDEX_TO_TEXT_END">PANGO_ATTR_INDEX_TO_TEXT_END</a>
45
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString">PangoAttrString</a>;
46
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage">PangoAttrLanguage</a>;
47
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor">PangoAttrColor</a>;
48
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt">PangoAttrInt</a>;
49
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat">PangoAttrFloat</a>;
50
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc">PangoAttrFontDesc</a>;
51
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape">PangoAttrShape</a>;
52
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoAttrSize" title="struct PangoAttrSize">PangoAttrSize</a>;
53
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="pango-Text-Attributes.html#pango-parse-markup" title="pango_parse_markup ()">pango_parse_markup</a>                  (<em class="parameter"><code>const <span class="type">char</span> *markup_text</code></em>,
54
 
                                                         <em class="parameter"><code><span class="type">int</span> length</code></em>,
55
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> accel_marker</code></em>,
56
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
57
 
                                                         <em class="parameter"><code><span class="type">char</span> **text</code></em>,
58
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> *accel_char</code></em>,
59
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
60
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="returnvalue">GMarkupParseContext</span></a> * <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-new" title="pango_markup_parser_new ()">pango_markup_parser_new</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> accel_marker</code></em>);
61
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-finish" title="pango_markup_parser_finish ()">pango_markup_parser_finish</a>          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a> *context</code></em>,
62
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
63
 
                                                         <em class="parameter"><code><span class="type">char</span> **text</code></em>,
64
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> *accel_char</code></em>,
65
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
66
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="returnvalue">PangoAttrType</span></a>       <a class="link" href="pango-Text-Attributes.html#pango-attr-type-register" title="pango_attr_type_register ()">pango_attr_type_register</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
67
 
const <span class="returnvalue">char</span> *        <a class="link" href="pango-Text-Attributes.html#pango-attr-type-get-name" title="pango_attr_type_get_name ()">pango_attr_type_get_name</a>            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="type">PangoAttrType</span></a> type</code></em>);
68
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attribute-init" title="pango_attribute_init ()">pango_attribute_init</a>                (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>,
69
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a> *klass</code></em>);
70
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attribute-copy" title="pango_attribute_copy ()">pango_attribute_copy</a>                (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);
71
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="pango-Text-Attributes.html#pango-attribute-equal" title="pango_attribute_equal ()">pango_attribute_equal</a>               (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr1</code></em>,
72
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr2</code></em>);
73
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()">pango_attribute_destroy</a>             (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);
74
 
 
75
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-language-new" title="pango_attr_language_new ()">pango_attr_language_new</a>             (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);
76
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-family-new" title="pango_attr_family_new ()">pango_attr_family_new</a>               (<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);
77
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-style-new" title="pango_attr_style_new ()">pango_attr_style_new</a>                (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a> style</code></em>);
78
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-variant-new" title="pango_attr_variant_new ()">pango_attr_variant_new</a>              (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a> variant</code></em>);
79
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-stretch-new" title="pango_attr_stretch_new ()">pango_attr_stretch_new</a>              (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch"><span class="type">PangoStretch</span></a> stretch</code></em>);
80
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-weight-new" title="pango_attr_weight_new ()">pango_attr_weight_new</a>               (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight"><span class="type">PangoWeight</span></a> weight</code></em>);
81
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-size-new" title="pango_attr_size_new ()">pango_attr_size_new</a>                 (<em class="parameter"><code><span class="type">int</span> size</code></em>);
82
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-size-new-absolute" title="pango_attr_size_new_absolute ()">pango_attr_size_new_absolute</a>        (<em class="parameter"><code><span class="type">int</span> size</code></em>);
83
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-font-desc-new" title="pango_attr_font_desc_new ()">pango_attr_font_desc_new</a>            (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);
84
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-foreground-new" title="pango_attr_foreground_new ()">pango_attr_foreground_new</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
85
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
86
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);
87
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-background-new" title="pango_attr_background_new ()">pango_attr_background_new</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
88
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
89
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);
90
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-strikethrough-new" title="pango_attr_strikethrough_new ()">pango_attr_strikethrough_new</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> strikethrough</code></em>);
91
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-strikethrough-color-new" title="pango_attr_strikethrough_color_new ()">pango_attr_strikethrough_color_new</a>  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
92
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
93
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);
94
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-underline-new" title="pango_attr_underline_new ()">pango_attr_underline_new</a>            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoUnderline"><span class="type">PangoUnderline</span></a> underline</code></em>);
95
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-underline-color-new" title="pango_attr_underline_color_new ()">pango_attr_underline_color_new</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
96
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
97
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);
98
 
enum                <a class="link" href="pango-Text-Attributes.html#PangoUnderline-enum" title="enum PangoUnderline">PangoUnderline</a>;
99
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-UNDERLINE:CAPS" title="PANGO_TYPE_UNDERLINE">PANGO_TYPE_UNDERLINE</a>
100
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new" title="pango_attr_shape_new ()">pango_attr_shape_new</a>                (<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,
101
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);
102
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new-with-data" title="pango_attr_shape_new_with_data ()">pango_attr_shape_new_with_data</a>      (<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,
103
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>,
104
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
105
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrDataCopyFunc" title="PangoAttrDataCopyFunc ()"><span class="type">PangoAttrDataCopyFunc</span></a> copy_func</code></em>,
106
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_func</code></em>);
107
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            (<a class="link" href="pango-Text-Attributes.html#PangoAttrDataCopyFunc" title="PangoAttrDataCopyFunc ()">*PangoAttrDataCopyFunc</a>)            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> user_data</code></em>);
108
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-scale-new" title="pango_attr_scale_new ()">pango_attr_scale_new</a>                (<em class="parameter"><code><span class="type">double</span> scale_factor</code></em>);
109
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-XX-SMALL:CAPS" title="PANGO_SCALE_XX_SMALL">PANGO_SCALE_XX_SMALL</a>
110
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-X-SMALL:CAPS" title="PANGO_SCALE_X_SMALL">PANGO_SCALE_X_SMALL</a>
111
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-SMALL:CAPS" title="PANGO_SCALE_SMALL">PANGO_SCALE_SMALL</a>
112
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-MEDIUM:CAPS" title="PANGO_SCALE_MEDIUM">PANGO_SCALE_MEDIUM</a>
113
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-LARGE:CAPS" title="PANGO_SCALE_LARGE">PANGO_SCALE_LARGE</a>
114
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-X-LARGE:CAPS" title="PANGO_SCALE_X_LARGE">PANGO_SCALE_X_LARGE</a>
115
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-XX-LARGE:CAPS" title="PANGO_SCALE_XX_LARGE">PANGO_SCALE_XX_LARGE</a>
116
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-rise-new" title="pango_attr_rise_new ()">pango_attr_rise_new</a>                 (<em class="parameter"><code><span class="type">int</span> rise</code></em>);
117
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-letter-spacing-new" title="pango_attr_letter_spacing_new ()">pango_attr_letter_spacing_new</a>       (<em class="parameter"><code><span class="type">int</span> letter_spacing</code></em>);
118
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-fallback-new" title="pango_attr_fallback_new ()">pango_attr_fallback_new</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable_fallback</code></em>);
119
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-gravity-new" title="pango_attr_gravity_new ()">pango_attr_gravity_new</a>              (<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a> gravity</code></em>);
120
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-gravity-hint-new" title="pango_attr_gravity_hint_new ()">pango_attr_gravity_hint_new</a>         (<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravityHint"><span class="type">PangoGravityHint</span></a> hint</code></em>);
121
 
struct              <a class="link" href="pango-Text-Attributes.html#PangoColor-struct" title="struct PangoColor">PangoColor</a>;
122
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-COLOR:CAPS" title="PANGO_TYPE_COLOR">PANGO_TYPE_COLOR</a>
123
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="pango-Text-Attributes.html#pango-color-parse" title="pango_color_parse ()">pango_color_parse</a>                   (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>,
124
 
                                                         <em class="parameter"><code>const <span class="type">char</span> *spec</code></em>);
125
 
<a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="returnvalue">PangoColor</span></a> *        <a class="link" href="pango-Text-Attributes.html#pango-color-copy" title="pango_color_copy ()">pango_color_copy</a>                    (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *src</code></em>);
126
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-color-free" title="pango_color_free ()">pango_color_free</a>                    (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);
127
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="pango-Text-Attributes.html#pango-color-to-string" title="pango_color_to_string ()">pango_color_to_string</a>               (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);
128
 
 
129
 
                    <a class="link" href="pango-Text-Attributes.html#PangoAttrList-struct" title="PangoAttrList">PangoAttrList</a>;
130
 
#define             <a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-ATTR-LIST:CAPS" title="PANGO_TYPE_ATTR_LIST">PANGO_TYPE_ATTR_LIST</a>
131
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     <a class="link" href="pango-Text-Attributes.html#pango-attr-list-new" title="pango_attr_list_new ()">pango_attr_list_new</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
132
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     <a class="link" href="pango-Text-Attributes.html#pango-attr-list-ref" title="pango_attr_list_ref ()">pango_attr_list_ref</a>                 (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);
133
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-list-unref" title="pango_attr_list_unref ()">pango_attr_list_unref</a>               (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);
134
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     <a class="link" href="pango-Text-Attributes.html#pango-attr-list-copy" title="pango_attr_list_copy ()">pango_attr_list_copy</a>                (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);
135
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert" title="pango_attr_list_insert ()">pango_attr_list_insert</a>              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
136
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);
137
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert-before" title="pango_attr_list_insert_before ()">pango_attr_list_insert_before</a>       (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
138
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);
139
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-list-change" title="pango_attr_list_change ()">pango_attr_list_change</a>              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
140
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);
141
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-list-splice" title="pango_attr_list_splice ()">pango_attr_list_splice</a>              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
142
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *other</code></em>,
143
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>,
144
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> len</code></em>);
145
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     <a class="link" href="pango-Text-Attributes.html#pango-attr-list-filter" title="pango_attr_list_filter ()">pango_attr_list_filter</a>              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
146
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrFilterFunc" title="PangoAttrFilterFunc ()"><span class="type">PangoAttrFilterFunc</span></a> func</code></em>,
147
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
148
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="pango-Text-Attributes.html#PangoAttrFilterFunc" title="PangoAttrFilterFunc ()">*PangoAttrFilterFunc</a>)              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attribute</code></em>,
149
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
150
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> * <a class="link" href="pango-Text-Attributes.html#pango-attr-list-get-iterator" title="pango_attr_list_get_iterator ()">pango_attr_list_get_iterator</a>        (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);
151
 
                    <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator">PangoAttrIterator</a>;
152
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> * <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-copy" title="pango_attr_iterator_copy ()">pango_attr_iterator_copy</a>            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);
153
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-next" title="pango_attr_iterator_next ()">pango_attr_iterator_next</a>            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);
154
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-range" title="pango_attr_iterator_range ()">pango_attr_iterator_range</a>           (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
155
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>,
156
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);
157
 
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-get" title="pango_attr_iterator_get ()">pango_attr_iterator_get</a>             (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
158
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="type">PangoAttrType</span></a> type</code></em>);
159
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-get-font" title="pango_attr_iterator_get_font ()">pango_attr_iterator_get_font</a>        (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
160
 
                                                         <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,
161
 
                                                         <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> **language</code></em>,
162
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **extra_attrs</code></em>);
163
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-get-attrs" title="pango_attr_iterator_get_attrs ()">pango_attr_iterator_get_attrs</a>       (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);
164
 
<span class="returnvalue">void</span>                <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-destroy" title="pango_attr_iterator_destroy ()">pango_attr_iterator_destroy</a>         (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);
165
 
</pre>
 
35
<div class="refsect1">
 
36
<a name="pango-Text-Attributes.functions"></a><h2>Functions</h2>
 
37
<div class="informaltable"><table width="100%" border="0">
 
38
<colgroup>
 
39
<col width="150px" class="functions_return">
 
40
<col class="functions_name">
 
41
</colgroup>
 
42
<tbody>
 
43
<tr>
 
44
<td class="define_keyword">#define</td>
 
45
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-ATTR-TYPE:CAPS" title="PANGO_TYPE_ATTR_TYPE">PANGO_TYPE_ATTR_TYPE</a></td>
 
46
</tr>
 
47
<tr>
 
48
<td class="function_type">
 
49
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
50
</td>
 
51
<td class="function_name">
 
52
<a class="link" href="pango-Text-Attributes.html#pango-parse-markup" title="pango_parse_markup ()">pango_parse_markup</a> <span class="c_punctuation">()</span>
 
53
</td>
 
54
</tr>
 
55
<tr>
 
56
<td class="function_type">
 
57
<a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="returnvalue">GMarkupParseContext</span></a> *
 
58
</td>
 
59
<td class="function_name">
 
60
<a class="link" href="pango-Text-Attributes.html#pango-markup-parser-new" title="pango_markup_parser_new ()">pango_markup_parser_new</a> <span class="c_punctuation">()</span>
 
61
</td>
 
62
</tr>
 
63
<tr>
 
64
<td class="function_type">
 
65
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
66
</td>
 
67
<td class="function_name">
 
68
<a class="link" href="pango-Text-Attributes.html#pango-markup-parser-finish" title="pango_markup_parser_finish ()">pango_markup_parser_finish</a> <span class="c_punctuation">()</span>
 
69
</td>
 
70
</tr>
 
71
<tr>
 
72
<td class="function_type">
 
73
<a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="returnvalue">PangoAttrType</span></a>
 
74
</td>
 
75
<td class="function_name">
 
76
<a class="link" href="pango-Text-Attributes.html#pango-attr-type-register" title="pango_attr_type_register ()">pango_attr_type_register</a> <span class="c_punctuation">()</span>
 
77
</td>
 
78
</tr>
 
79
<tr>
 
80
<td class="function_type">const <span class="returnvalue">char</span> *
 
81
</td>
 
82
<td class="function_name">
 
83
<a class="link" href="pango-Text-Attributes.html#pango-attr-type-get-name" title="pango_attr_type_get_name ()">pango_attr_type_get_name</a> <span class="c_punctuation">()</span>
 
84
</td>
 
85
</tr>
 
86
<tr>
 
87
<td class="function_type">
 
88
<span class="returnvalue">void</span>
 
89
</td>
 
90
<td class="function_name">
 
91
<a class="link" href="pango-Text-Attributes.html#pango-attribute-init" title="pango_attribute_init ()">pango_attribute_init</a> <span class="c_punctuation">()</span>
 
92
</td>
 
93
</tr>
 
94
<tr>
 
95
<td class="function_type">
 
96
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
97
</td>
 
98
<td class="function_name">
 
99
<a class="link" href="pango-Text-Attributes.html#pango-attribute-copy" title="pango_attribute_copy ()">pango_attribute_copy</a> <span class="c_punctuation">()</span>
 
100
</td>
 
101
</tr>
 
102
<tr>
 
103
<td class="function_type">
 
104
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
105
</td>
 
106
<td class="function_name">
 
107
<a class="link" href="pango-Text-Attributes.html#pango-attribute-equal" title="pango_attribute_equal ()">pango_attribute_equal</a> <span class="c_punctuation">()</span>
 
108
</td>
 
109
</tr>
 
110
<tr>
 
111
<td class="function_type">
 
112
<span class="returnvalue">void</span>
 
113
</td>
 
114
<td class="function_name">
 
115
<a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()">pango_attribute_destroy</a> <span class="c_punctuation">()</span>
 
116
</td>
 
117
</tr>
 
118
<tr>
 
119
<td class="function_type">
 
120
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
121
</td>
 
122
<td class="function_name">
 
123
<a class="link" href="pango-Text-Attributes.html#pango-attr-language-new" title="pango_attr_language_new ()">pango_attr_language_new</a> <span class="c_punctuation">()</span>
 
124
</td>
 
125
</tr>
 
126
<tr>
 
127
<td class="function_type">
 
128
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
129
</td>
 
130
<td class="function_name">
 
131
<a class="link" href="pango-Text-Attributes.html#pango-attr-family-new" title="pango_attr_family_new ()">pango_attr_family_new</a> <span class="c_punctuation">()</span>
 
132
</td>
 
133
</tr>
 
134
<tr>
 
135
<td class="function_type">
 
136
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
137
</td>
 
138
<td class="function_name">
 
139
<a class="link" href="pango-Text-Attributes.html#pango-attr-style-new" title="pango_attr_style_new ()">pango_attr_style_new</a> <span class="c_punctuation">()</span>
 
140
</td>
 
141
</tr>
 
142
<tr>
 
143
<td class="function_type">
 
144
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
145
</td>
 
146
<td class="function_name">
 
147
<a class="link" href="pango-Text-Attributes.html#pango-attr-variant-new" title="pango_attr_variant_new ()">pango_attr_variant_new</a> <span class="c_punctuation">()</span>
 
148
</td>
 
149
</tr>
 
150
<tr>
 
151
<td class="function_type">
 
152
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
153
</td>
 
154
<td class="function_name">
 
155
<a class="link" href="pango-Text-Attributes.html#pango-attr-stretch-new" title="pango_attr_stretch_new ()">pango_attr_stretch_new</a> <span class="c_punctuation">()</span>
 
156
</td>
 
157
</tr>
 
158
<tr>
 
159
<td class="function_type">
 
160
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
161
</td>
 
162
<td class="function_name">
 
163
<a class="link" href="pango-Text-Attributes.html#pango-attr-weight-new" title="pango_attr_weight_new ()">pango_attr_weight_new</a> <span class="c_punctuation">()</span>
 
164
</td>
 
165
</tr>
 
166
<tr>
 
167
<td class="function_type">
 
168
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
169
</td>
 
170
<td class="function_name">
 
171
<a class="link" href="pango-Text-Attributes.html#pango-attr-size-new" title="pango_attr_size_new ()">pango_attr_size_new</a> <span class="c_punctuation">()</span>
 
172
</td>
 
173
</tr>
 
174
<tr>
 
175
<td class="function_type">
 
176
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
177
</td>
 
178
<td class="function_name">
 
179
<a class="link" href="pango-Text-Attributes.html#pango-attr-size-new-absolute" title="pango_attr_size_new_absolute ()">pango_attr_size_new_absolute</a> <span class="c_punctuation">()</span>
 
180
</td>
 
181
</tr>
 
182
<tr>
 
183
<td class="function_type">
 
184
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
185
</td>
 
186
<td class="function_name">
 
187
<a class="link" href="pango-Text-Attributes.html#pango-attr-font-desc-new" title="pango_attr_font_desc_new ()">pango_attr_font_desc_new</a> <span class="c_punctuation">()</span>
 
188
</td>
 
189
</tr>
 
190
<tr>
 
191
<td class="function_type">
 
192
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
193
</td>
 
194
<td class="function_name">
 
195
<a class="link" href="pango-Text-Attributes.html#pango-attr-foreground-new" title="pango_attr_foreground_new ()">pango_attr_foreground_new</a> <span class="c_punctuation">()</span>
 
196
</td>
 
197
</tr>
 
198
<tr>
 
199
<td class="function_type">
 
200
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
201
</td>
 
202
<td class="function_name">
 
203
<a class="link" href="pango-Text-Attributes.html#pango-attr-background-new" title="pango_attr_background_new ()">pango_attr_background_new</a> <span class="c_punctuation">()</span>
 
204
</td>
 
205
</tr>
 
206
<tr>
 
207
<td class="function_type">
 
208
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
209
</td>
 
210
<td class="function_name">
 
211
<a class="link" href="pango-Text-Attributes.html#pango-attr-strikethrough-new" title="pango_attr_strikethrough_new ()">pango_attr_strikethrough_new</a> <span class="c_punctuation">()</span>
 
212
</td>
 
213
</tr>
 
214
<tr>
 
215
<td class="function_type">
 
216
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
217
</td>
 
218
<td class="function_name">
 
219
<a class="link" href="pango-Text-Attributes.html#pango-attr-strikethrough-color-new" title="pango_attr_strikethrough_color_new ()">pango_attr_strikethrough_color_new</a> <span class="c_punctuation">()</span>
 
220
</td>
 
221
</tr>
 
222
<tr>
 
223
<td class="function_type">
 
224
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
225
</td>
 
226
<td class="function_name">
 
227
<a class="link" href="pango-Text-Attributes.html#pango-attr-underline-new" title="pango_attr_underline_new ()">pango_attr_underline_new</a> <span class="c_punctuation">()</span>
 
228
</td>
 
229
</tr>
 
230
<tr>
 
231
<td class="function_type">
 
232
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
233
</td>
 
234
<td class="function_name">
 
235
<a class="link" href="pango-Text-Attributes.html#pango-attr-underline-color-new" title="pango_attr_underline_color_new ()">pango_attr_underline_color_new</a> <span class="c_punctuation">()</span>
 
236
</td>
 
237
</tr>
 
238
<tr>
 
239
<td class="define_keyword">#define</td>
 
240
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-UNDERLINE:CAPS" title="PANGO_TYPE_UNDERLINE">PANGO_TYPE_UNDERLINE</a></td>
 
241
</tr>
 
242
<tr>
 
243
<td class="function_type">
 
244
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
245
</td>
 
246
<td class="function_name">
 
247
<a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new" title="pango_attr_shape_new ()">pango_attr_shape_new</a> <span class="c_punctuation">()</span>
 
248
</td>
 
249
</tr>
 
250
<tr>
 
251
<td class="function_type">
 
252
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
253
</td>
 
254
<td class="function_name">
 
255
<a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new-with-data" title="pango_attr_shape_new_with_data ()">pango_attr_shape_new_with_data</a> <span class="c_punctuation">()</span>
 
256
</td>
 
257
</tr>
 
258
<tr>
 
259
<td class="function_type">
 
260
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
 
261
</td>
 
262
<td class="function_name">
 
263
<span class="c_punctuation">(</span><a class="link" href="pango-Text-Attributes.html#PangoAttrDataCopyFunc" title="PangoAttrDataCopyFunc ()">*PangoAttrDataCopyFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
 
264
</td>
 
265
</tr>
 
266
<tr>
 
267
<td class="function_type">
 
268
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
269
</td>
 
270
<td class="function_name">
 
271
<a class="link" href="pango-Text-Attributes.html#pango-attr-scale-new" title="pango_attr_scale_new ()">pango_attr_scale_new</a> <span class="c_punctuation">()</span>
 
272
</td>
 
273
</tr>
 
274
<tr>
 
275
<td class="define_keyword">#define</td>
 
276
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-XX-SMALL:CAPS" title="PANGO_SCALE_XX_SMALL">PANGO_SCALE_XX_SMALL</a></td>
 
277
</tr>
 
278
<tr>
 
279
<td class="define_keyword">#define</td>
 
280
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-X-SMALL:CAPS" title="PANGO_SCALE_X_SMALL">PANGO_SCALE_X_SMALL</a></td>
 
281
</tr>
 
282
<tr>
 
283
<td class="define_keyword">#define</td>
 
284
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-SMALL:CAPS" title="PANGO_SCALE_SMALL">PANGO_SCALE_SMALL</a></td>
 
285
</tr>
 
286
<tr>
 
287
<td class="define_keyword">#define</td>
 
288
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-MEDIUM:CAPS" title="PANGO_SCALE_MEDIUM">PANGO_SCALE_MEDIUM</a></td>
 
289
</tr>
 
290
<tr>
 
291
<td class="define_keyword">#define</td>
 
292
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-LARGE:CAPS" title="PANGO_SCALE_LARGE">PANGO_SCALE_LARGE</a></td>
 
293
</tr>
 
294
<tr>
 
295
<td class="define_keyword">#define</td>
 
296
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-X-LARGE:CAPS" title="PANGO_SCALE_X_LARGE">PANGO_SCALE_X_LARGE</a></td>
 
297
</tr>
 
298
<tr>
 
299
<td class="define_keyword">#define</td>
 
300
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-SCALE-XX-LARGE:CAPS" title="PANGO_SCALE_XX_LARGE">PANGO_SCALE_XX_LARGE</a></td>
 
301
</tr>
 
302
<tr>
 
303
<td class="function_type">
 
304
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
305
</td>
 
306
<td class="function_name">
 
307
<a class="link" href="pango-Text-Attributes.html#pango-attr-rise-new" title="pango_attr_rise_new ()">pango_attr_rise_new</a> <span class="c_punctuation">()</span>
 
308
</td>
 
309
</tr>
 
310
<tr>
 
311
<td class="function_type">
 
312
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
313
</td>
 
314
<td class="function_name">
 
315
<a class="link" href="pango-Text-Attributes.html#pango-attr-letter-spacing-new" title="pango_attr_letter_spacing_new ()">pango_attr_letter_spacing_new</a> <span class="c_punctuation">()</span>
 
316
</td>
 
317
</tr>
 
318
<tr>
 
319
<td class="function_type">
 
320
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
321
</td>
 
322
<td class="function_name">
 
323
<a class="link" href="pango-Text-Attributes.html#pango-attr-fallback-new" title="pango_attr_fallback_new ()">pango_attr_fallback_new</a> <span class="c_punctuation">()</span>
 
324
</td>
 
325
</tr>
 
326
<tr>
 
327
<td class="function_type">
 
328
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
329
</td>
 
330
<td class="function_name">
 
331
<a class="link" href="pango-Text-Attributes.html#pango-attr-gravity-new" title="pango_attr_gravity_new ()">pango_attr_gravity_new</a> <span class="c_punctuation">()</span>
 
332
</td>
 
333
</tr>
 
334
<tr>
 
335
<td class="function_type">
 
336
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
337
</td>
 
338
<td class="function_name">
 
339
<a class="link" href="pango-Text-Attributes.html#pango-attr-gravity-hint-new" title="pango_attr_gravity_hint_new ()">pango_attr_gravity_hint_new</a> <span class="c_punctuation">()</span>
 
340
</td>
 
341
</tr>
 
342
<tr>
 
343
<td class="function_type">
 
344
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
345
</td>
 
346
<td class="function_name">
 
347
<a class="link" href="pango-Text-Attributes.html#pango-color-parse" title="pango_color_parse ()">pango_color_parse</a> <span class="c_punctuation">()</span>
 
348
</td>
 
349
</tr>
 
350
<tr>
 
351
<td class="function_type">
 
352
<a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="returnvalue">PangoColor</span></a> *
 
353
</td>
 
354
<td class="function_name">
 
355
<a class="link" href="pango-Text-Attributes.html#pango-color-copy" title="pango_color_copy ()">pango_color_copy</a> <span class="c_punctuation">()</span>
 
356
</td>
 
357
</tr>
 
358
<tr>
 
359
<td class="function_type">
 
360
<span class="returnvalue">void</span>
 
361
</td>
 
362
<td class="function_name">
 
363
<a class="link" href="pango-Text-Attributes.html#pango-color-free" title="pango_color_free ()">pango_color_free</a> <span class="c_punctuation">()</span>
 
364
</td>
 
365
</tr>
 
366
<tr>
 
367
<td class="function_type">
 
368
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
369
</td>
 
370
<td class="function_name">
 
371
<a class="link" href="pango-Text-Attributes.html#pango-color-to-string" title="pango_color_to_string ()">pango_color_to_string</a> <span class="c_punctuation">()</span>
 
372
</td>
 
373
</tr>
 
374
<tr>
 
375
<td class="function_type">
 
376
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
377
</td>
 
378
<td class="function_name">
 
379
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-new" title="pango_attr_list_new ()">pango_attr_list_new</a> <span class="c_punctuation">()</span>
 
380
</td>
 
381
</tr>
 
382
<tr>
 
383
<td class="function_type">
 
384
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
385
</td>
 
386
<td class="function_name">
 
387
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-ref" title="pango_attr_list_ref ()">pango_attr_list_ref</a> <span class="c_punctuation">()</span>
 
388
</td>
 
389
</tr>
 
390
<tr>
 
391
<td class="function_type">
 
392
<span class="returnvalue">void</span>
 
393
</td>
 
394
<td class="function_name">
 
395
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-unref" title="pango_attr_list_unref ()">pango_attr_list_unref</a> <span class="c_punctuation">()</span>
 
396
</td>
 
397
</tr>
 
398
<tr>
 
399
<td class="function_type">
 
400
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
401
</td>
 
402
<td class="function_name">
 
403
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-copy" title="pango_attr_list_copy ()">pango_attr_list_copy</a> <span class="c_punctuation">()</span>
 
404
</td>
 
405
</tr>
 
406
<tr>
 
407
<td class="function_type">
 
408
<span class="returnvalue">void</span>
 
409
</td>
 
410
<td class="function_name">
 
411
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert" title="pango_attr_list_insert ()">pango_attr_list_insert</a> <span class="c_punctuation">()</span>
 
412
</td>
 
413
</tr>
 
414
<tr>
 
415
<td class="function_type">
 
416
<span class="returnvalue">void</span>
 
417
</td>
 
418
<td class="function_name">
 
419
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert-before" title="pango_attr_list_insert_before ()">pango_attr_list_insert_before</a> <span class="c_punctuation">()</span>
 
420
</td>
 
421
</tr>
 
422
<tr>
 
423
<td class="function_type">
 
424
<span class="returnvalue">void</span>
 
425
</td>
 
426
<td class="function_name">
 
427
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-change" title="pango_attr_list_change ()">pango_attr_list_change</a> <span class="c_punctuation">()</span>
 
428
</td>
 
429
</tr>
 
430
<tr>
 
431
<td class="function_type">
 
432
<span class="returnvalue">void</span>
 
433
</td>
 
434
<td class="function_name">
 
435
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-splice" title="pango_attr_list_splice ()">pango_attr_list_splice</a> <span class="c_punctuation">()</span>
 
436
</td>
 
437
</tr>
 
438
<tr>
 
439
<td class="function_type">
 
440
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
441
</td>
 
442
<td class="function_name">
 
443
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-filter" title="pango_attr_list_filter ()">pango_attr_list_filter</a> <span class="c_punctuation">()</span>
 
444
</td>
 
445
</tr>
 
446
<tr>
 
447
<td class="function_type">
 
448
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
449
</td>
 
450
<td class="function_name">
 
451
<span class="c_punctuation">(</span><a class="link" href="pango-Text-Attributes.html#PangoAttrFilterFunc" title="PangoAttrFilterFunc ()">*PangoAttrFilterFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
 
452
</td>
 
453
</tr>
 
454
<tr>
 
455
<td class="function_type">
 
456
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> *
 
457
</td>
 
458
<td class="function_name">
 
459
<a class="link" href="pango-Text-Attributes.html#pango-attr-list-get-iterator" title="pango_attr_list_get_iterator ()">pango_attr_list_get_iterator</a> <span class="c_punctuation">()</span>
 
460
</td>
 
461
</tr>
 
462
<tr>
 
463
<td class="function_type">
 
464
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> *
 
465
</td>
 
466
<td class="function_name">
 
467
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-copy" title="pango_attr_iterator_copy ()">pango_attr_iterator_copy</a> <span class="c_punctuation">()</span>
 
468
</td>
 
469
</tr>
 
470
<tr>
 
471
<td class="function_type">
 
472
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
473
</td>
 
474
<td class="function_name">
 
475
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-next" title="pango_attr_iterator_next ()">pango_attr_iterator_next</a> <span class="c_punctuation">()</span>
 
476
</td>
 
477
</tr>
 
478
<tr>
 
479
<td class="function_type">
 
480
<span class="returnvalue">void</span>
 
481
</td>
 
482
<td class="function_name">
 
483
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-range" title="pango_attr_iterator_range ()">pango_attr_iterator_range</a> <span class="c_punctuation">()</span>
 
484
</td>
 
485
</tr>
 
486
<tr>
 
487
<td class="function_type">
 
488
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
489
</td>
 
490
<td class="function_name">
 
491
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-get" title="pango_attr_iterator_get ()">pango_attr_iterator_get</a> <span class="c_punctuation">()</span>
 
492
</td>
 
493
</tr>
 
494
<tr>
 
495
<td class="function_type">
 
496
<span class="returnvalue">void</span>
 
497
</td>
 
498
<td class="function_name">
 
499
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-get-font" title="pango_attr_iterator_get_font ()">pango_attr_iterator_get_font</a> <span class="c_punctuation">()</span>
 
500
</td>
 
501
</tr>
 
502
<tr>
 
503
<td class="function_type">
 
504
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
 
505
</td>
 
506
<td class="function_name">
 
507
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-get-attrs" title="pango_attr_iterator_get_attrs ()">pango_attr_iterator_get_attrs</a> <span class="c_punctuation">()</span>
 
508
</td>
 
509
</tr>
 
510
<tr>
 
511
<td class="function_type">
 
512
<span class="returnvalue">void</span>
 
513
</td>
 
514
<td class="function_name">
 
515
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-destroy" title="pango_attr_iterator_destroy ()">pango_attr_iterator_destroy</a> <span class="c_punctuation">()</span>
 
516
</td>
 
517
</tr>
 
518
</tbody>
 
519
</table></div>
 
520
</div>
 
521
<a name="PangoColor"></a><a name="PangoAttrList"></a><div class="refsect1">
 
522
<a name="pango-Text-Attributes.other"></a><h2>Types and Values</h2>
 
523
<div class="informaltable"><table width="100%" border="0">
 
524
<colgroup>
 
525
<col width="150px" class="name">
 
526
<col class="description">
 
527
</colgroup>
 
528
<tbody>
 
529
<tr>
 
530
<td class="datatype_keyword">enum</td>
 
531
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType">PangoAttrType</a></td>
 
532
</tr>
 
533
<tr>
 
534
<td class="datatype_keyword">struct</td>
 
535
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass">PangoAttrClass</a></td>
 
536
</tr>
 
537
<tr>
 
538
<td class="datatype_keyword">struct</td>
 
539
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute">PangoAttribute</a></td>
 
540
</tr>
 
541
<tr>
 
542
<td class="define_keyword">#define</td>
 
543
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-FROM-TEXT-BEGINNING:CAPS" title="PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING">PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING</a></td>
 
544
</tr>
 
545
<tr>
 
546
<td class="define_keyword">#define</td>
 
547
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-TO-TEXT-END:CAPS" title="PANGO_ATTR_INDEX_TO_TEXT_END">PANGO_ATTR_INDEX_TO_TEXT_END</a></td>
 
548
</tr>
 
549
<tr>
 
550
<td class="datatype_keyword">struct</td>
 
551
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString">PangoAttrString</a></td>
 
552
</tr>
 
553
<tr>
 
554
<td class="datatype_keyword">struct</td>
 
555
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage">PangoAttrLanguage</a></td>
 
556
</tr>
 
557
<tr>
 
558
<td class="datatype_keyword">struct</td>
 
559
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor">PangoAttrColor</a></td>
 
560
</tr>
 
561
<tr>
 
562
<td class="datatype_keyword">struct</td>
 
563
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt">PangoAttrInt</a></td>
 
564
</tr>
 
565
<tr>
 
566
<td class="datatype_keyword">struct</td>
 
567
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat">PangoAttrFloat</a></td>
 
568
</tr>
 
569
<tr>
 
570
<td class="datatype_keyword">struct</td>
 
571
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc">PangoAttrFontDesc</a></td>
 
572
</tr>
 
573
<tr>
 
574
<td class="datatype_keyword">struct</td>
 
575
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape">PangoAttrShape</a></td>
 
576
</tr>
 
577
<tr>
 
578
<td class="datatype_keyword">struct</td>
 
579
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrSize" title="struct PangoAttrSize">PangoAttrSize</a></td>
 
580
</tr>
 
581
<tr>
 
582
<td class="datatype_keyword">enum</td>
 
583
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoUnderline" title="enum PangoUnderline">PangoUnderline</a></td>
 
584
</tr>
 
585
<tr>
 
586
<td class="datatype_keyword">struct</td>
 
587
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoColor-struct" title="struct PangoColor">PangoColor</a></td>
 
588
</tr>
 
589
<tr>
 
590
<td class="define_keyword">#define</td>
 
591
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-COLOR:CAPS" title="PANGO_TYPE_COLOR">PANGO_TYPE_COLOR</a></td>
 
592
</tr>
 
593
<tr>
 
594
<td class="datatype_keyword"> </td>
 
595
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrList-struct" title="PangoAttrList">PangoAttrList</a></td>
 
596
</tr>
 
597
<tr>
 
598
<td class="define_keyword">#define</td>
 
599
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PANGO-TYPE-ATTR-LIST:CAPS" title="PANGO_TYPE_ATTR_LIST">PANGO_TYPE_ATTR_LIST</a></td>
 
600
</tr>
 
601
<tr>
 
602
<td class="datatype_keyword"> </td>
 
603
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator">PangoAttrIterator</a></td>
 
604
</tr>
 
605
</tbody>
 
606
</table></div>
166
607
</div>
167
608
<div class="refsect1">
168
609
<a name="pango-Text-Attributes.object-hierarchy"></a><h2>Object Hierarchy</h2>
169
 
<pre class="synopsis">
170
 
  GEnum
171
 
   +----PangoAttrType
172
 
</pre>
173
 
<pre class="synopsis">
174
 
  GEnum
175
 
   +----PangoUnderline
176
 
</pre>
177
 
<pre class="synopsis">
178
 
  GBoxed
179
 
   +----PangoColor
180
 
</pre>
181
 
<pre class="synopsis">
182
 
  GBoxed
183
 
   +----PangoAttrList
 
610
<pre class="screen">    GBoxed
 
611
    <span class="lineart">├──</span> PangoAttrList
 
612
    <span class="lineart">╰──</span> PangoColor
 
613
    GEnum
 
614
    <span class="lineart">├──</span> PangoAttrType
 
615
    <span class="lineart">╰──</span> PangoUnderline
184
616
</pre>
185
617
</div>
186
618
<div class="refsect1">
187
619
<a name="pango-Text-Attributes.description"></a><h2>Description</h2>
188
 
<p>
189
 
Attributed text is used in a number of places in Pango. It
 
620
<p>Attributed text is used in a number of places in Pango. It
190
621
is used as the input to the itemization process and also when
191
622
creating a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>. The data types and functions in
192
623
this section are used to represent and manipulate sets
193
624
of attributes applied to a portion of text.</p>
194
625
</div>
195
626
<div class="refsect1">
196
 
<a name="pango-Text-Attributes.details"></a><h2>Details</h2>
197
 
<div class="refsect2">
198
 
<a name="PangoAttrType-enum"></a><h3>enum PangoAttrType</h3>
199
 
<pre class="programlisting">typedef enum {
200
 
  PANGO_ATTR_INVALID,           /* 0 is an invalid attribute type */
201
 
  PANGO_ATTR_LANGUAGE,          /* PangoAttrLanguage */
202
 
  PANGO_ATTR_FAMILY,            /* PangoAttrString */
203
 
  PANGO_ATTR_STYLE,             /* PangoAttrInt */
204
 
  PANGO_ATTR_WEIGHT,            /* PangoAttrInt */
205
 
  PANGO_ATTR_VARIANT,           /* PangoAttrInt */
206
 
  PANGO_ATTR_STRETCH,           /* PangoAttrInt */
207
 
  PANGO_ATTR_SIZE,              /* PangoAttrSize */
208
 
  PANGO_ATTR_FONT_DESC,         /* PangoAttrFontDesc */
209
 
  PANGO_ATTR_FOREGROUND, /* PangoAttrColor */
210
 
  PANGO_ATTR_BACKGROUND, /* PangoAttrColor */
211
 
  PANGO_ATTR_UNDERLINE,         /* PangoAttrInt */
212
 
  PANGO_ATTR_STRIKETHROUGH, /* PangoAttrInt */
213
 
  PANGO_ATTR_RISE,              /* PangoAttrInt */
214
 
  PANGO_ATTR_SHAPE,             /* PangoAttrShape */
215
 
  PANGO_ATTR_SCALE,             /* PangoAttrFloat */
216
 
  PANGO_ATTR_FALLBACK,          /* PangoAttrInt */
217
 
  PANGO_ATTR_LETTER_SPACING,    /* PangoAttrInt */
218
 
  PANGO_ATTR_UNDERLINE_COLOR, /* PangoAttrColor */
219
 
  PANGO_ATTR_STRIKETHROUGH_COLOR,/* PangoAttrColor */
220
 
  PANGO_ATTR_ABSOLUTE_SIZE, /* PangoAttrSize */
221
 
  PANGO_ATTR_GRAVITY,           /* PangoAttrInt */
222
 
  PANGO_ATTR_GRAVITY_HINT /* PangoAttrInt */
223
 
} PangoAttrType;
224
 
</pre>
225
 
<p>
226
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="type">PangoAttrType</span></a>
 
627
<a name="pango-Text-Attributes.functions_details"></a><h2>Functions</h2>
 
628
<div class="refsect2">
 
629
<a name="PANGO-TYPE-ATTR-TYPE:CAPS"></a><h3>PANGO_TYPE_ATTR_TYPE</h3>
 
630
<pre class="programlisting">#define PANGO_TYPE_ATTR_TYPE (pango_attr_type_get_type ())
 
631
</pre>
 
632
</div>
 
633
<hr>
 
634
<div class="refsect2">
 
635
<a name="pango-parse-markup"></a><h3>pango_parse_markup ()</h3>
 
636
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
637
pango_parse_markup (<em class="parameter"><code>const <span class="type">char</span> *markup_text</code></em>,
 
638
                    <em class="parameter"><code><span class="type">int</span> length</code></em>,
 
639
                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> accel_marker</code></em>,
 
640
                    <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
 
641
                    <em class="parameter"><code><span class="type">char</span> **text</code></em>,
 
642
                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> *accel_char</code></em>,
 
643
                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
644
<p>Parses marked-up text (see</p>
 
645
<a href="PangoMarkupFormat.html">markup format</a>) to create
 
646
<p>a plain-text string and an attribute list.</p>
 
647
<p>If <em class="parameter"><code>accel_marker</code></em>
 
648
 is nonzero, the given character will mark the
 
649
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>
 
650
 
 
651
might be an ampersand or underscore. All characters marked
 
652
as an accelerator will receive a <a class="link" href="pango-Text-Attributes.html#PANGO-UNDERLINE-LOW:CAPS"><code class="literal">PANGO_UNDERLINE_LOW</code></a> attribute,
 
653
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>
 
654
.
 
655
Two <em class="parameter"><code>accel_marker</code></em>
 
656
 characters following each other produce a single
 
657
literal <em class="parameter"><code>accel_marker</code></em>
 
658
 character.</p>
 
659
<p>To parse a stream of pango markup incrementally, use <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-new" title="pango_markup_parser_new ()"><code class="function">pango_markup_parser_new()</code></a>.</p>
 
660
<p>If any error happens, none of the output arguments are touched except
 
661
for <em class="parameter"><code>error</code></em>
 
662
.</p>
 
663
<div class="refsect3">
 
664
<a name="id-1.2.5.9.3.10"></a><h4>Parameters</h4>
 
665
<div class="informaltable"><table width="100%" border="0">
 
666
<colgroup>
 
667
<col width="150px" class="parameters_name">
 
668
<col class="parameters_description">
 
669
<col width="200px" class="parameters_annotations">
 
670
</colgroup>
 
671
<tbody>
 
672
<tr>
 
673
<td class="parameter_name"><p>markup_text</p></td>
 
674
<td class="parameter_description"><p>markup to parse (see <a href="PangoMarkupFormat.html">markup format</a>)</p></td>
 
675
<td class="parameter_annotations"> </td>
 
676
</tr>
 
677
<tr>
 
678
<td class="parameter_name"><p>length</p></td>
 
679
<td class="parameter_description"><p>length of <em class="parameter"><code>markup_text</code></em>
 
680
, or -1 if nul-terminated</p></td>
 
681
<td class="parameter_annotations"> </td>
 
682
</tr>
 
683
<tr>
 
684
<td class="parameter_name"><p>accel_marker</p></td>
 
685
<td class="parameter_description"><p>character that precedes an accelerator, or 0 for none</p></td>
 
686
<td class="parameter_annotations"> </td>
 
687
</tr>
 
688
<tr>
 
689
<td class="parameter_name"><p>attr_list</p></td>
 
690
<td class="parameter_description"><p> address of return location for a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
691
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
692
</tr>
 
693
<tr>
 
694
<td class="parameter_name"><p>text</p></td>
 
695
<td class="parameter_description"><p> address of return location for text with tags stripped, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
696
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
697
</tr>
 
698
<tr>
 
699
<td class="parameter_name"><p>accel_char</p></td>
 
700
<td class="parameter_description"><p> address of return location for accelerator char, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
701
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
702
</tr>
 
703
<tr>
 
704
<td class="parameter_name"><p>error</p></td>
 
705
<td class="parameter_description"><p>address of return location for errors, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
706
<td class="parameter_annotations"> </td>
 
707
</tr>
 
708
</tbody>
 
709
</table></div>
 
710
</div>
 
711
<div class="refsect3">
 
712
<a name="id-1.2.5.9.3.11"></a><h4>Returns</h4>
 
713
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
 
714
is set, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a></p>
 
715
<p></p>
 
716
</div>
 
717
</div>
 
718
<hr>
 
719
<div class="refsect2">
 
720
<a name="pango-markup-parser-new"></a><h3>pango_markup_parser_new ()</h3>
 
721
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="returnvalue">GMarkupParseContext</span></a> *
 
722
pango_markup_parser_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> accel_marker</code></em>);</pre>
 
723
<p>Parses marked-up text (see</p>
 
724
<a href="PangoMarkupFormat.html">markup format</a>) to create
 
725
<p>a plain-text string and an attribute list.</p>
 
726
<p>If <em class="parameter"><code>accel_marker</code></em>
 
727
 is nonzero, the given character will mark the
 
728
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>
 
729
 
 
730
might be an ampersand or underscore. All characters marked
 
731
as an accelerator will receive a <a class="link" href="pango-Text-Attributes.html#PANGO-UNDERLINE-LOW:CAPS"><code class="literal">PANGO_UNDERLINE_LOW</code></a> attribute,
 
732
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>
 
733
,
 
734
when calling <code class="function">finish()</code>. Two <em class="parameter"><code>accel_marker</code></em>
 
735
 characters following each
 
736
other produce a single literal <em class="parameter"><code>accel_marker</code></em>
 
737
 character.</p>
 
738
<p>To feed markup to the parser, use <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-parse"><code class="function">g_markup_parse_context_parse()</code></a>
 
739
on the returned <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a>. When done with feeding markup
 
740
to the parser, use <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-finish" title="pango_markup_parser_finish ()"><code class="function">pango_markup_parser_finish()</code></a> to get the data out
 
741
of it, and then use <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-free"><code class="function">g_markup_parse_context_free()</code></a> to free it.</p>
 
742
<p>This function is designed for applications that read pango markup
 
743
from streams. To simply parse a string containing pango markup,
 
744
the simpler <a class="link" href="pango-Text-Attributes.html#pango-parse-markup" title="pango_parse_markup ()"><code class="function">pango_parse_markup()</code></a> API is recommended instead.</p>
 
745
<div class="refsect3">
 
746
<a name="id-1.2.5.9.4.10"></a><h4>Parameters</h4>
 
747
<div class="informaltable"><table width="100%" border="0">
 
748
<colgroup>
 
749
<col width="150px" class="parameters_name">
 
750
<col class="parameters_description">
 
751
<col width="200px" class="parameters_annotations">
 
752
</colgroup>
 
753
<tbody><tr>
 
754
<td class="parameter_name"><p>accel_marker</p></td>
 
755
<td class="parameter_description"><p>character that precedes an accelerator, or 0 for none</p></td>
 
756
<td class="parameter_annotations"> </td>
 
757
</tr></tbody>
 
758
</table></div>
 
759
</div>
 
760
<div class="refsect3">
 
761
<a name="id-1.2.5.9.4.11"></a><h4>Returns</h4>
 
762
<p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a> that should be
 
763
destroyed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-free"><code class="function">g_markup_parse_context_free()</code></a>. </p>
 
764
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 
765
</div>
 
766
<p class="since">Since 1.31.0</p>
 
767
</div>
 
768
<hr>
 
769
<div class="refsect2">
 
770
<a name="pango-markup-parser-finish"></a><h3>pango_markup_parser_finish ()</h3>
 
771
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
772
pango_markup_parser_finish (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a> *context</code></em>,
 
773
                            <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
 
774
                            <em class="parameter"><code><span class="type">char</span> **text</code></em>,
 
775
                            <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> *accel_char</code></em>,
 
776
                            <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
777
<p>After feeding a pango markup parser some data with <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-parse"><code class="function">g_markup_parse_context_parse()</code></a>,
 
778
use this function to get the list of pango attributes and text out of the
 
779
markup. This function will not free <em class="parameter"><code>context</code></em>
 
780
, use <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-free"><code class="function">g_markup_parse_context_free()</code></a>
 
781
to do so.</p>
 
782
<div class="refsect3">
 
783
<a name="id-1.2.5.9.5.5"></a><h4>Parameters</h4>
 
784
<div class="informaltable"><table width="100%" border="0">
 
785
<colgroup>
 
786
<col width="150px" class="parameters_name">
 
787
<col class="parameters_description">
 
788
<col width="200px" class="parameters_annotations">
 
789
</colgroup>
 
790
<tbody>
 
791
<tr>
 
792
<td class="parameter_name"><p>context</p></td>
 
793
<td class="parameter_description"><p>A valid parse context that was returned from <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-new" title="pango_markup_parser_new ()"><code class="function">pango_markup_parser_new()</code></a></p></td>
 
794
<td class="parameter_annotations"> </td>
 
795
</tr>
 
796
<tr>
 
797
<td class="parameter_name"><p>attr_list</p></td>
 
798
<td class="parameter_description"><p> address of return location for a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
799
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
800
</tr>
 
801
<tr>
 
802
<td class="parameter_name"><p>text</p></td>
 
803
<td class="parameter_description"><p> address of return location for text with tags stripped, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
804
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
805
</tr>
 
806
<tr>
 
807
<td class="parameter_name"><p>accel_char</p></td>
 
808
<td class="parameter_description"><p> address of return location for accelerator char, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
809
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
810
</tr>
 
811
<tr>
 
812
<td class="parameter_name"><p>error</p></td>
 
813
<td class="parameter_description"><p>address of return location for errors, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
814
<td class="parameter_annotations"> </td>
 
815
</tr>
 
816
</tbody>
 
817
</table></div>
 
818
</div>
 
819
<div class="refsect3">
 
820
<a name="id-1.2.5.9.5.6"></a><h4>Returns</h4>
 
821
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
 
822
is set, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a></p>
 
823
<p></p>
 
824
</div>
 
825
<p class="since">Since 1.31.0</p>
 
826
</div>
 
827
<hr>
 
828
<div class="refsect2">
 
829
<a name="pango-attr-type-register"></a><h3>pango_attr_type_register ()</h3>
 
830
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="returnvalue">PangoAttrType</span></a>
 
831
pango_attr_type_register (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 
832
<p>Allocate a new attribute type ID.  The attribute type name can be accessed
 
833
later by using <a class="link" href="pango-Text-Attributes.html#pango-attr-type-get-name" title="pango_attr_type_get_name ()"><code class="function">pango_attr_type_get_name()</code></a>.</p>
 
834
<div class="refsect3">
 
835
<a name="id-1.2.5.9.6.5"></a><h4>Parameters</h4>
 
836
<div class="informaltable"><table width="100%" border="0">
 
837
<colgroup>
 
838
<col width="150px" class="parameters_name">
 
839
<col class="parameters_description">
 
840
<col width="200px" class="parameters_annotations">
 
841
</colgroup>
 
842
<tbody><tr>
 
843
<td class="parameter_name"><p>name</p></td>
 
844
<td class="parameter_description"><p>an identifier for the type</p></td>
 
845
<td class="parameter_annotations"> </td>
 
846
</tr></tbody>
 
847
</table></div>
 
848
</div>
 
849
<div class="refsect3">
 
850
<a name="id-1.2.5.9.6.6"></a><h4>Returns</h4>
 
851
<p> the new type ID.</p>
 
852
<p></p>
 
853
</div>
 
854
</div>
 
855
<hr>
 
856
<div class="refsect2">
 
857
<a name="pango-attr-type-get-name"></a><h3>pango_attr_type_get_name ()</h3>
 
858
<pre class="programlisting">const <span class="returnvalue">char</span> *
 
859
pango_attr_type_get_name (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="type">PangoAttrType</span></a> type</code></em>);</pre>
 
860
<p>Fetches the attribute type name passed in when registering the type using
 
861
<a class="link" href="pango-Text-Attributes.html#pango-attr-type-register" title="pango_attr_type_register ()"><code class="function">pango_attr_type_register()</code></a>.</p>
 
862
<p>The returned value is an interned string (see <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-intern-string"><code class="function">g_intern_string()</code></a> for what
 
863
that means) that should not be modified or freed.</p>
 
864
<div class="refsect3">
 
865
<a name="id-1.2.5.9.7.6"></a><h4>Parameters</h4>
 
866
<div class="informaltable"><table width="100%" border="0">
 
867
<colgroup>
 
868
<col width="150px" class="parameters_name">
 
869
<col class="parameters_description">
 
870
<col width="200px" class="parameters_annotations">
 
871
</colgroup>
 
872
<tbody><tr>
 
873
<td class="parameter_name"><p>type</p></td>
 
874
<td class="parameter_description"><p>an attribute type ID to fetch the name for</p></td>
 
875
<td class="parameter_annotations"> </td>
 
876
</tr></tbody>
 
877
</table></div>
 
878
</div>
 
879
<div class="refsect3">
 
880
<a name="id-1.2.5.9.7.7"></a><h4>Returns</h4>
 
881
<p> the type ID name (which may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>type</code></em>
 
882
is
 
883
a built-in Pango attribute type or invalid. </p>
 
884
<p></p>
 
885
</div>
 
886
<p class="since">Since 1.22</p>
 
887
</div>
 
888
<hr>
 
889
<div class="refsect2">
 
890
<a name="pango-attribute-init"></a><h3>pango_attribute_init ()</h3>
 
891
<pre class="programlisting"><span class="returnvalue">void</span>
 
892
pango_attribute_init (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>,
 
893
                      <em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a> *klass</code></em>);</pre>
 
894
<p>Initializes <em class="parameter"><code>attr</code></em>
 
895
's klass to <em class="parameter"><code>klass</code></em>
 
896
,
 
897
it's start_index to <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-FROM-TEXT-BEGINNING:CAPS" title="PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING"><code class="literal">PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING</code></a>
 
898
and end_index to <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-TO-TEXT-END:CAPS" title="PANGO_ATTR_INDEX_TO_TEXT_END"><code class="literal">PANGO_ATTR_INDEX_TO_TEXT_END</code></a>
 
899
such that the attribute applies
 
900
to the entire text by default.</p>
 
901
<div class="refsect3">
 
902
<a name="id-1.2.5.9.8.5"></a><h4>Parameters</h4>
 
903
<div class="informaltable"><table width="100%" border="0">
 
904
<colgroup>
 
905
<col width="150px" class="parameters_name">
 
906
<col class="parameters_description">
 
907
<col width="200px" class="parameters_annotations">
 
908
</colgroup>
 
909
<tbody>
 
910
<tr>
 
911
<td class="parameter_name"><p>attr</p></td>
 
912
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a></p></td>
 
913
<td class="parameter_annotations"> </td>
 
914
</tr>
 
915
<tr>
 
916
<td class="parameter_name"><p>klass</p></td>
 
917
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a></p></td>
 
918
<td class="parameter_annotations"> </td>
 
919
</tr>
 
920
</tbody>
 
921
</table></div>
 
922
</div>
 
923
<p class="since">Since 1.20</p>
 
924
</div>
 
925
<hr>
 
926
<div class="refsect2">
 
927
<a name="pango-attribute-copy"></a><h3>pango_attribute_copy ()</h3>
 
928
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
929
pango_attribute_copy (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
 
930
<p>Make a copy of an attribute.</p>
 
931
<div class="refsect3">
 
932
<a name="id-1.2.5.9.9.5"></a><h4>Parameters</h4>
 
933
<div class="informaltable"><table width="100%" border="0">
 
934
<colgroup>
 
935
<col width="150px" class="parameters_name">
 
936
<col class="parameters_description">
 
937
<col width="200px" class="parameters_annotations">
 
938
</colgroup>
 
939
<tbody><tr>
 
940
<td class="parameter_name"><p>attr</p></td>
 
941
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a></p></td>
 
942
<td class="parameter_annotations"> </td>
 
943
</tr></tbody>
 
944
</table></div>
 
945
</div>
 
946
<div class="refsect3">
 
947
<a name="id-1.2.5.9.9.6"></a><h4>Returns</h4>
 
948
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
949
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
950
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
951
</div>
 
952
</div>
 
953
<hr>
 
954
<div class="refsect2">
 
955
<a name="pango-attribute-equal"></a><h3>pango_attribute_equal ()</h3>
 
956
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
957
pango_attribute_equal (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr1</code></em>,
 
958
                       <em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr2</code></em>);</pre>
 
959
<p>Compare two attributes for equality. This compares only the
 
960
actual value of the two attributes and not the ranges that the
 
961
attributes apply to.</p>
 
962
<div class="refsect3">
 
963
<a name="id-1.2.5.9.10.5"></a><h4>Parameters</h4>
 
964
<div class="informaltable"><table width="100%" border="0">
 
965
<colgroup>
 
966
<col width="150px" class="parameters_name">
 
967
<col class="parameters_description">
 
968
<col width="200px" class="parameters_annotations">
 
969
</colgroup>
 
970
<tbody>
 
971
<tr>
 
972
<td class="parameter_name"><p>attr1</p></td>
 
973
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a></p></td>
 
974
<td class="parameter_annotations"> </td>
 
975
</tr>
 
976
<tr>
 
977
<td class="parameter_name"><p>attr2</p></td>
 
978
<td class="parameter_description"><p>another <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a></p></td>
 
979
<td class="parameter_annotations"> </td>
 
980
</tr>
 
981
</tbody>
 
982
</table></div>
 
983
</div>
 
984
<div class="refsect3">
 
985
<a name="id-1.2.5.9.10.6"></a><h4>Returns</h4>
 
986
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the two attributes have the same value.</p>
 
987
<p></p>
 
988
</div>
 
989
</div>
 
990
<hr>
 
991
<div class="refsect2">
 
992
<a name="pango-attribute-destroy"></a><h3>pango_attribute_destroy ()</h3>
 
993
<pre class="programlisting"><span class="returnvalue">void</span>
 
994
pango_attribute_destroy (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
 
995
<p>Destroy a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> and free all associated memory.</p>
 
996
<div class="refsect3">
 
997
<a name="id-1.2.5.9.11.5"></a><h4>Parameters</h4>
 
998
<div class="informaltable"><table width="100%" border="0">
 
999
<colgroup>
 
1000
<col width="150px" class="parameters_name">
 
1001
<col class="parameters_description">
 
1002
<col width="200px" class="parameters_annotations">
 
1003
</colgroup>
 
1004
<tbody><tr>
 
1005
<td class="parameter_name"><p>attr</p></td>
 
1006
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>.</p></td>
 
1007
<td class="parameter_annotations"> </td>
 
1008
</tr></tbody>
 
1009
</table></div>
 
1010
</div>
 
1011
</div>
 
1012
<hr>
 
1013
<div class="refsect2">
 
1014
<a name="pango-attr-language-new"></a><h3>pango_attr_language_new ()</h3>
 
1015
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1016
pango_attr_language_new (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>
 
1017
<p>Create a new language tag attribute.</p>
 
1018
<div class="refsect3">
 
1019
<a name="id-1.2.5.9.12.5"></a><h4>Parameters</h4>
 
1020
<div class="informaltable"><table width="100%" border="0">
 
1021
<colgroup>
 
1022
<col width="150px" class="parameters_name">
 
1023
<col class="parameters_description">
 
1024
<col width="200px" class="parameters_annotations">
 
1025
</colgroup>
 
1026
<tbody><tr>
 
1027
<td class="parameter_name"><p>language</p></td>
 
1028
<td class="parameter_description"><p>language tag</p></td>
 
1029
<td class="parameter_annotations"> </td>
 
1030
</tr></tbody>
 
1031
</table></div>
 
1032
</div>
 
1033
<div class="refsect3">
 
1034
<a name="id-1.2.5.9.12.6"></a><h4>Returns</h4>
 
1035
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1036
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1037
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1038
</div>
 
1039
</div>
 
1040
<hr>
 
1041
<div class="refsect2">
 
1042
<a name="pango-attr-family-new"></a><h3>pango_attr_family_new ()</h3>
 
1043
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1044
pango_attr_family_new (<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);</pre>
 
1045
<p>Create a new font family attribute.</p>
 
1046
<div class="refsect3">
 
1047
<a name="id-1.2.5.9.13.5"></a><h4>Parameters</h4>
 
1048
<div class="informaltable"><table width="100%" border="0">
 
1049
<colgroup>
 
1050
<col width="150px" class="parameters_name">
 
1051
<col class="parameters_description">
 
1052
<col width="200px" class="parameters_annotations">
 
1053
</colgroup>
 
1054
<tbody><tr>
 
1055
<td class="parameter_name"><p>family</p></td>
 
1056
<td class="parameter_description"><p>the family or comma separated list of families</p></td>
 
1057
<td class="parameter_annotations"> </td>
 
1058
</tr></tbody>
 
1059
</table></div>
 
1060
</div>
 
1061
<div class="refsect3">
 
1062
<a name="id-1.2.5.9.13.6"></a><h4>Returns</h4>
 
1063
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1064
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1065
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1066
</div>
 
1067
</div>
 
1068
<hr>
 
1069
<div class="refsect2">
 
1070
<a name="pango-attr-style-new"></a><h3>pango_attr_style_new ()</h3>
 
1071
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1072
pango_attr_style_new (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> style</code></em>);</pre>
 
1073
<p>Create a new font slant style attribute.</p>
 
1074
<div class="refsect3">
 
1075
<a name="id-1.2.5.9.14.5"></a><h4>Parameters</h4>
 
1076
<div class="informaltable"><table width="100%" border="0">
 
1077
<colgroup>
 
1078
<col width="150px" class="parameters_name">
 
1079
<col class="parameters_description">
 
1080
<col width="200px" class="parameters_annotations">
 
1081
</colgroup>
 
1082
<tbody><tr>
 
1083
<td class="parameter_name"><p>style</p></td>
 
1084
<td class="parameter_description"><p>the slant style</p></td>
 
1085
<td class="parameter_annotations"> </td>
 
1086
</tr></tbody>
 
1087
</table></div>
 
1088
</div>
 
1089
<div class="refsect3">
 
1090
<a name="id-1.2.5.9.14.6"></a><h4>Returns</h4>
 
1091
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1092
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1093
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1094
</div>
 
1095
</div>
 
1096
<hr>
 
1097
<div class="refsect2">
 
1098
<a name="pango-attr-variant-new"></a><h3>pango_attr_variant_new ()</h3>
 
1099
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1100
pango_attr_variant_new (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a> variant</code></em>);</pre>
 
1101
<p>Create a new font variant attribute (normal or small caps)</p>
 
1102
<div class="refsect3">
 
1103
<a name="id-1.2.5.9.15.5"></a><h4>Parameters</h4>
 
1104
<div class="informaltable"><table width="100%" border="0">
 
1105
<colgroup>
 
1106
<col width="150px" class="parameters_name">
 
1107
<col class="parameters_description">
 
1108
<col width="200px" class="parameters_annotations">
 
1109
</colgroup>
 
1110
<tbody><tr>
 
1111
<td class="parameter_name"><p>variant</p></td>
 
1112
<td class="parameter_description"><p>the variant</p></td>
 
1113
<td class="parameter_annotations"> </td>
 
1114
</tr></tbody>
 
1115
</table></div>
 
1116
</div>
 
1117
<div class="refsect3">
 
1118
<a name="id-1.2.5.9.15.6"></a><h4>Returns</h4>
 
1119
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1120
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1121
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1122
</div>
 
1123
</div>
 
1124
<hr>
 
1125
<div class="refsect2">
 
1126
<a name="pango-attr-stretch-new"></a><h3>pango_attr_stretch_new ()</h3>
 
1127
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1128
pango_attr_stretch_new (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="type">PangoStretch</span></a> stretch</code></em>);</pre>
 
1129
<p>Create a new font stretch attribute</p>
 
1130
<div class="refsect3">
 
1131
<a name="id-1.2.5.9.16.5"></a><h4>Parameters</h4>
 
1132
<div class="informaltable"><table width="100%" border="0">
 
1133
<colgroup>
 
1134
<col width="150px" class="parameters_name">
 
1135
<col class="parameters_description">
 
1136
<col width="200px" class="parameters_annotations">
 
1137
</colgroup>
 
1138
<tbody><tr>
 
1139
<td class="parameter_name"><p>stretch</p></td>
 
1140
<td class="parameter_description"><p>the stretch</p></td>
 
1141
<td class="parameter_annotations"> </td>
 
1142
</tr></tbody>
 
1143
</table></div>
 
1144
</div>
 
1145
<div class="refsect3">
 
1146
<a name="id-1.2.5.9.16.6"></a><h4>Returns</h4>
 
1147
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1148
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1149
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1150
</div>
 
1151
</div>
 
1152
<hr>
 
1153
<div class="refsect2">
 
1154
<a name="pango-attr-weight-new"></a><h3>pango_attr_weight_new ()</h3>
 
1155
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1156
pango_attr_weight_new (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> weight</code></em>);</pre>
 
1157
<p>Create a new font weight attribute.</p>
 
1158
<div class="refsect3">
 
1159
<a name="id-1.2.5.9.17.5"></a><h4>Parameters</h4>
 
1160
<div class="informaltable"><table width="100%" border="0">
 
1161
<colgroup>
 
1162
<col width="150px" class="parameters_name">
 
1163
<col class="parameters_description">
 
1164
<col width="200px" class="parameters_annotations">
 
1165
</colgroup>
 
1166
<tbody><tr>
 
1167
<td class="parameter_name"><p>weight</p></td>
 
1168
<td class="parameter_description"><p>the weight</p></td>
 
1169
<td class="parameter_annotations"> </td>
 
1170
</tr></tbody>
 
1171
</table></div>
 
1172
</div>
 
1173
<div class="refsect3">
 
1174
<a name="id-1.2.5.9.17.6"></a><h4>Returns</h4>
 
1175
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1176
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1177
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1178
</div>
 
1179
</div>
 
1180
<hr>
 
1181
<div class="refsect2">
 
1182
<a name="pango-attr-size-new"></a><h3>pango_attr_size_new ()</h3>
 
1183
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1184
pango_attr_size_new (<em class="parameter"><code><span class="type">int</span> size</code></em>);</pre>
 
1185
<p>Create a new font-size attribute in fractional points.</p>
 
1186
<div class="refsect3">
 
1187
<a name="id-1.2.5.9.18.5"></a><h4>Parameters</h4>
 
1188
<div class="informaltable"><table width="100%" border="0">
 
1189
<colgroup>
 
1190
<col width="150px" class="parameters_name">
 
1191
<col class="parameters_description">
 
1192
<col width="200px" class="parameters_annotations">
 
1193
</colgroup>
 
1194
<tbody><tr>
 
1195
<td class="parameter_name"><p>size</p></td>
 
1196
<td class="parameter_description"><p>the font size, in <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a>ths of a point.</p></td>
 
1197
<td class="parameter_annotations"> </td>
 
1198
</tr></tbody>
 
1199
</table></div>
 
1200
</div>
 
1201
<div class="refsect3">
 
1202
<a name="id-1.2.5.9.18.6"></a><h4>Returns</h4>
 
1203
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1204
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1205
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1206
</div>
 
1207
</div>
 
1208
<hr>
 
1209
<div class="refsect2">
 
1210
<a name="pango-attr-size-new-absolute"></a><h3>pango_attr_size_new_absolute ()</h3>
 
1211
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1212
pango_attr_size_new_absolute (<em class="parameter"><code><span class="type">int</span> size</code></em>);</pre>
 
1213
<p>Create a new font-size attribute in device units.</p>
 
1214
<div class="refsect3">
 
1215
<a name="id-1.2.5.9.19.5"></a><h4>Parameters</h4>
 
1216
<div class="informaltable"><table width="100%" border="0">
 
1217
<colgroup>
 
1218
<col width="150px" class="parameters_name">
 
1219
<col class="parameters_description">
 
1220
<col width="200px" class="parameters_annotations">
 
1221
</colgroup>
 
1222
<tbody><tr>
 
1223
<td class="parameter_name"><p>size</p></td>
 
1224
<td class="parameter_description"><p>the font size, in <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a>ths of a device unit.</p></td>
 
1225
<td class="parameter_annotations"> </td>
 
1226
</tr></tbody>
 
1227
</table></div>
 
1228
</div>
 
1229
<div class="refsect3">
 
1230
<a name="id-1.2.5.9.19.6"></a><h4>Returns</h4>
 
1231
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>, which should be
 
1232
freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>.</p>
 
1233
<p></p>
 
1234
</div>
 
1235
<p class="since">Since 1.8</p>
 
1236
</div>
 
1237
<hr>
 
1238
<div class="refsect2">
 
1239
<a name="pango-attr-font-desc-new"></a><h3>pango_attr_font_desc_new ()</h3>
 
1240
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1241
pango_attr_font_desc_new (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>
 
1242
<p>Create a new font description attribute. This attribute
 
1243
allows setting family, style, weight, variant, stretch,
 
1244
and size simultaneously.</p>
 
1245
<div class="refsect3">
 
1246
<a name="id-1.2.5.9.20.5"></a><h4>Parameters</h4>
 
1247
<div class="informaltable"><table width="100%" border="0">
 
1248
<colgroup>
 
1249
<col width="150px" class="parameters_name">
 
1250
<col class="parameters_description">
 
1251
<col width="200px" class="parameters_annotations">
 
1252
</colgroup>
 
1253
<tbody><tr>
 
1254
<td class="parameter_name"><p>desc</p></td>
 
1255
<td class="parameter_description"><p>the font description</p></td>
 
1256
<td class="parameter_annotations"> </td>
 
1257
</tr></tbody>
 
1258
</table></div>
 
1259
</div>
 
1260
<div class="refsect3">
 
1261
<a name="id-1.2.5.9.20.6"></a><h4>Returns</h4>
 
1262
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1263
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1264
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1265
</div>
 
1266
</div>
 
1267
<hr>
 
1268
<div class="refsect2">
 
1269
<a name="pango-attr-foreground-new"></a><h3>pango_attr_foreground_new ()</h3>
 
1270
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1271
pango_attr_foreground_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
 
1272
                           <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
 
1273
                           <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
 
1274
<p>Create a new foreground color attribute.</p>
 
1275
<div class="refsect3">
 
1276
<a name="id-1.2.5.9.21.5"></a><h4>Parameters</h4>
 
1277
<div class="informaltable"><table width="100%" border="0">
 
1278
<colgroup>
 
1279
<col width="150px" class="parameters_name">
 
1280
<col class="parameters_description">
 
1281
<col width="200px" class="parameters_annotations">
 
1282
</colgroup>
 
1283
<tbody>
 
1284
<tr>
 
1285
<td class="parameter_name"><p>red</p></td>
 
1286
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
 
1287
<td class="parameter_annotations"> </td>
 
1288
</tr>
 
1289
<tr>
 
1290
<td class="parameter_name"><p>green</p></td>
 
1291
<td class="parameter_description"><p>the green value</p></td>
 
1292
<td class="parameter_annotations"> </td>
 
1293
</tr>
 
1294
<tr>
 
1295
<td class="parameter_name"><p>blue</p></td>
 
1296
<td class="parameter_description"><p>the blue value</p></td>
 
1297
<td class="parameter_annotations"> </td>
 
1298
</tr>
 
1299
</tbody>
 
1300
</table></div>
 
1301
</div>
 
1302
<div class="refsect3">
 
1303
<a name="id-1.2.5.9.21.6"></a><h4>Returns</h4>
 
1304
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1305
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1306
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1307
</div>
 
1308
</div>
 
1309
<hr>
 
1310
<div class="refsect2">
 
1311
<a name="pango-attr-background-new"></a><h3>pango_attr_background_new ()</h3>
 
1312
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1313
pango_attr_background_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
 
1314
                           <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
 
1315
                           <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
 
1316
<p>Create a new background color attribute.</p>
 
1317
<div class="refsect3">
 
1318
<a name="id-1.2.5.9.22.5"></a><h4>Parameters</h4>
 
1319
<div class="informaltable"><table width="100%" border="0">
 
1320
<colgroup>
 
1321
<col width="150px" class="parameters_name">
 
1322
<col class="parameters_description">
 
1323
<col width="200px" class="parameters_annotations">
 
1324
</colgroup>
 
1325
<tbody>
 
1326
<tr>
 
1327
<td class="parameter_name"><p>red</p></td>
 
1328
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
 
1329
<td class="parameter_annotations"> </td>
 
1330
</tr>
 
1331
<tr>
 
1332
<td class="parameter_name"><p>green</p></td>
 
1333
<td class="parameter_description"><p>the green value</p></td>
 
1334
<td class="parameter_annotations"> </td>
 
1335
</tr>
 
1336
<tr>
 
1337
<td class="parameter_name"><p>blue</p></td>
 
1338
<td class="parameter_description"><p>the blue value</p></td>
 
1339
<td class="parameter_annotations"> </td>
 
1340
</tr>
 
1341
</tbody>
 
1342
</table></div>
 
1343
</div>
 
1344
<div class="refsect3">
 
1345
<a name="id-1.2.5.9.22.6"></a><h4>Returns</h4>
 
1346
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1347
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1348
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1349
</div>
 
1350
</div>
 
1351
<hr>
 
1352
<div class="refsect2">
 
1353
<a name="pango-attr-strikethrough-new"></a><h3>pango_attr_strikethrough_new ()</h3>
 
1354
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1355
pango_attr_strikethrough_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> strikethrough</code></em>);</pre>
 
1356
<p>Create a new strike-through attribute.</p>
 
1357
<div class="refsect3">
 
1358
<a name="id-1.2.5.9.23.5"></a><h4>Parameters</h4>
 
1359
<div class="informaltable"><table width="100%" border="0">
 
1360
<colgroup>
 
1361
<col width="150px" class="parameters_name">
 
1362
<col class="parameters_description">
 
1363
<col width="200px" class="parameters_annotations">
 
1364
</colgroup>
 
1365
<tbody><tr>
 
1366
<td class="parameter_name"><p>strikethrough</p></td>
 
1367
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the text should be struck-through.</p></td>
 
1368
<td class="parameter_annotations"> </td>
 
1369
</tr></tbody>
 
1370
</table></div>
 
1371
</div>
 
1372
<div class="refsect3">
 
1373
<a name="id-1.2.5.9.23.6"></a><h4>Returns</h4>
 
1374
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1375
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1376
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1377
</div>
 
1378
</div>
 
1379
<hr>
 
1380
<div class="refsect2">
 
1381
<a name="pango-attr-strikethrough-color-new"></a><h3>pango_attr_strikethrough_color_new ()</h3>
 
1382
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1383
pango_attr_strikethrough_color_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
 
1384
                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
 
1385
                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
 
1386
<p>Create a new strikethrough color attribute. This attribute
 
1387
modifies the color of strikethrough lines. If not set, strikethrough
 
1388
lines will use the foreground color.</p>
 
1389
<div class="refsect3">
 
1390
<a name="id-1.2.5.9.24.5"></a><h4>Parameters</h4>
 
1391
<div class="informaltable"><table width="100%" border="0">
 
1392
<colgroup>
 
1393
<col width="150px" class="parameters_name">
 
1394
<col class="parameters_description">
 
1395
<col width="200px" class="parameters_annotations">
 
1396
</colgroup>
 
1397
<tbody>
 
1398
<tr>
 
1399
<td class="parameter_name"><p>red</p></td>
 
1400
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
 
1401
<td class="parameter_annotations"> </td>
 
1402
</tr>
 
1403
<tr>
 
1404
<td class="parameter_name"><p>green</p></td>
 
1405
<td class="parameter_description"><p>the green value</p></td>
 
1406
<td class="parameter_annotations"> </td>
 
1407
</tr>
 
1408
<tr>
 
1409
<td class="parameter_name"><p>blue</p></td>
 
1410
<td class="parameter_description"><p>the blue value</p></td>
 
1411
<td class="parameter_annotations"> </td>
 
1412
</tr>
 
1413
</tbody>
 
1414
</table></div>
 
1415
</div>
 
1416
<div class="refsect3">
 
1417
<a name="id-1.2.5.9.24.6"></a><h4>Returns</h4>
 
1418
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1419
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1420
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1421
</div>
 
1422
<p class="since">Since 1.8</p>
 
1423
</div>
 
1424
<hr>
 
1425
<div class="refsect2">
 
1426
<a name="pango-attr-underline-new"></a><h3>pango_attr_underline_new ()</h3>
 
1427
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1428
pango_attr_underline_new (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoUnderline" title="enum PangoUnderline"><span class="type">PangoUnderline</span></a> underline</code></em>);</pre>
 
1429
<p>Create a new underline-style attribute.</p>
 
1430
<div class="refsect3">
 
1431
<a name="id-1.2.5.9.25.5"></a><h4>Parameters</h4>
 
1432
<div class="informaltable"><table width="100%" border="0">
 
1433
<colgroup>
 
1434
<col width="150px" class="parameters_name">
 
1435
<col class="parameters_description">
 
1436
<col width="200px" class="parameters_annotations">
 
1437
</colgroup>
 
1438
<tbody><tr>
 
1439
<td class="parameter_name"><p>underline</p></td>
 
1440
<td class="parameter_description"><p>the underline style.</p></td>
 
1441
<td class="parameter_annotations"> </td>
 
1442
</tr></tbody>
 
1443
</table></div>
 
1444
</div>
 
1445
<div class="refsect3">
 
1446
<a name="id-1.2.5.9.25.6"></a><h4>Returns</h4>
 
1447
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1448
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1449
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1450
</div>
 
1451
</div>
 
1452
<hr>
 
1453
<div class="refsect2">
 
1454
<a name="pango-attr-underline-color-new"></a><h3>pango_attr_underline_color_new ()</h3>
 
1455
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1456
pango_attr_underline_color_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
 
1457
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
 
1458
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
 
1459
<p>Create a new underline color attribute. This attribute
 
1460
modifies the color of underlines. If not set, underlines
 
1461
will use the foreground color.</p>
 
1462
<div class="refsect3">
 
1463
<a name="id-1.2.5.9.26.5"></a><h4>Parameters</h4>
 
1464
<div class="informaltable"><table width="100%" border="0">
 
1465
<colgroup>
 
1466
<col width="150px" class="parameters_name">
 
1467
<col class="parameters_description">
 
1468
<col width="200px" class="parameters_annotations">
 
1469
</colgroup>
 
1470
<tbody>
 
1471
<tr>
 
1472
<td class="parameter_name"><p>red</p></td>
 
1473
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
 
1474
<td class="parameter_annotations"> </td>
 
1475
</tr>
 
1476
<tr>
 
1477
<td class="parameter_name"><p>green</p></td>
 
1478
<td class="parameter_description"><p>the green value</p></td>
 
1479
<td class="parameter_annotations"> </td>
 
1480
</tr>
 
1481
<tr>
 
1482
<td class="parameter_name"><p>blue</p></td>
 
1483
<td class="parameter_description"><p>the blue value</p></td>
 
1484
<td class="parameter_annotations"> </td>
 
1485
</tr>
 
1486
</tbody>
 
1487
</table></div>
 
1488
</div>
 
1489
<div class="refsect3">
 
1490
<a name="id-1.2.5.9.26.6"></a><h4>Returns</h4>
 
1491
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1492
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1493
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1494
</div>
 
1495
<p class="since">Since 1.8</p>
 
1496
</div>
 
1497
<hr>
 
1498
<div class="refsect2">
 
1499
<a name="PANGO-TYPE-UNDERLINE:CAPS"></a><h3>PANGO_TYPE_UNDERLINE</h3>
 
1500
<pre class="programlisting">#define PANGO_TYPE_UNDERLINE (pango_underline_get_type ())
 
1501
</pre>
 
1502
</div>
 
1503
<hr>
 
1504
<div class="refsect2">
 
1505
<a name="pango-attr-shape-new"></a><h3>pango_attr_shape_new ()</h3>
 
1506
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1507
pango_attr_shape_new (<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,
 
1508
                      <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);</pre>
 
1509
<p>Create a new shape attribute. A shape is used to impose a
 
1510
particular ink and logical rectangle on the result of shaping a
 
1511
particular glyph. This might be used, for instance, for
 
1512
embedding a picture or a widget inside a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.</p>
 
1513
<div class="refsect3">
 
1514
<a name="id-1.2.5.9.28.5"></a><h4>Parameters</h4>
 
1515
<div class="informaltable"><table width="100%" border="0">
 
1516
<colgroup>
 
1517
<col width="150px" class="parameters_name">
 
1518
<col class="parameters_description">
 
1519
<col width="200px" class="parameters_annotations">
 
1520
</colgroup>
 
1521
<tbody>
 
1522
<tr>
 
1523
<td class="parameter_name"><p>ink_rect</p></td>
 
1524
<td class="parameter_description"><p>ink rectangle to assign to each character</p></td>
 
1525
<td class="parameter_annotations"> </td>
 
1526
</tr>
 
1527
<tr>
 
1528
<td class="parameter_name"><p>logical_rect</p></td>
 
1529
<td class="parameter_description"><p>logical rectangle to assign to each character</p></td>
 
1530
<td class="parameter_annotations"> </td>
 
1531
</tr>
 
1532
</tbody>
 
1533
</table></div>
 
1534
</div>
 
1535
<div class="refsect3">
 
1536
<a name="id-1.2.5.9.28.6"></a><h4>Returns</h4>
 
1537
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1538
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1539
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1540
</div>
 
1541
</div>
 
1542
<hr>
 
1543
<div class="refsect2">
 
1544
<a name="pango-attr-shape-new-with-data"></a><h3>pango_attr_shape_new_with_data ()</h3>
 
1545
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1546
pango_attr_shape_new_with_data (<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,
 
1547
                                <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>,
 
1548
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
1549
                                <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrDataCopyFunc" title="PangoAttrDataCopyFunc ()"><span class="type">PangoAttrDataCopyFunc</span></a> copy_func</code></em>,
 
1550
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_func</code></em>);</pre>
 
1551
<p>Like <a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new" title="pango_attr_shape_new ()"><code class="function">pango_attr_shape_new()</code></a>, but a user data pointer is also
 
1552
provided; this pointer can be accessed when later
 
1553
rendering the glyph.</p>
 
1554
<div class="refsect3">
 
1555
<a name="id-1.2.5.9.29.5"></a><h4>Parameters</h4>
 
1556
<div class="informaltable"><table width="100%" border="0">
 
1557
<colgroup>
 
1558
<col width="150px" class="parameters_name">
 
1559
<col class="parameters_description">
 
1560
<col width="200px" class="parameters_annotations">
 
1561
</colgroup>
 
1562
<tbody>
 
1563
<tr>
 
1564
<td class="parameter_name"><p>ink_rect</p></td>
 
1565
<td class="parameter_description"><p>ink rectangle to assign to each character</p></td>
 
1566
<td class="parameter_annotations"> </td>
 
1567
</tr>
 
1568
<tr>
 
1569
<td class="parameter_name"><p>logical_rect</p></td>
 
1570
<td class="parameter_description"><p>logical rectangle to assign to each character</p></td>
 
1571
<td class="parameter_annotations"> </td>
 
1572
</tr>
 
1573
<tr>
 
1574
<td class="parameter_name"><p>data</p></td>
 
1575
<td class="parameter_description"><p>user data pointer</p></td>
 
1576
<td class="parameter_annotations"> </td>
 
1577
</tr>
 
1578
<tr>
 
1579
<td class="parameter_name"><p>copy_func</p></td>
 
1580
<td class="parameter_description"><p> function to copy <em class="parameter"><code>data</code></em>
 
1581
when the
 
1582
attribute is copied. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>data</code></em>
 
1583
is simply
 
1584
copied as a pointer. </p></td>
 
1585
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
1586
</tr>
 
1587
<tr>
 
1588
<td class="parameter_name"><p>destroy_func</p></td>
 
1589
<td class="parameter_description"><p> function to free <em class="parameter"><code>data</code></em>
 
1590
when the
 
1591
attribute is freed, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1592
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
1593
</tr>
 
1594
</tbody>
 
1595
</table></div>
 
1596
</div>
 
1597
<div class="refsect3">
 
1598
<a name="id-1.2.5.9.29.6"></a><h4>Returns</h4>
 
1599
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>, which should be
 
1600
freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>.</p>
 
1601
<p></p>
 
1602
</div>
 
1603
<p class="since">Since 1.8</p>
 
1604
</div>
 
1605
<hr>
 
1606
<div class="refsect2">
 
1607
<a name="PangoAttrDataCopyFunc"></a><h3>PangoAttrDataCopyFunc ()</h3>
 
1608
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
 
1609
<span class="c_punctuation">(</span>*PangoAttrDataCopyFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> user_data</code></em>);</pre>
 
1610
<p>Type of a function that can duplicate user data for an attribute.</p>
 
1611
<div class="refsect3">
 
1612
<a name="id-1.2.5.9.30.5"></a><h4>Parameters</h4>
 
1613
<div class="informaltable"><table width="100%" border="0">
 
1614
<colgroup>
 
1615
<col width="150px" class="parameters_name">
 
1616
<col class="parameters_description">
 
1617
<col width="200px" class="parameters_annotations">
 
1618
</colgroup>
 
1619
<tbody><tr>
 
1620
<td class="parameter_name"><p>user_data</p></td>
 
1621
<td class="parameter_description"><p>user data to copy</p></td>
 
1622
<td class="parameter_annotations"> </td>
 
1623
</tr></tbody>
 
1624
</table></div>
 
1625
</div>
 
1626
<div class="refsect3">
 
1627
<a name="id-1.2.5.9.30.6"></a><h4>Returns</h4>
 
1628
<p> new copy of <em class="parameter"><code>user_data</code></em>
 
1629
.</p>
 
1630
<p></p>
 
1631
</div>
 
1632
</div>
 
1633
<hr>
 
1634
<div class="refsect2">
 
1635
<a name="pango-attr-scale-new"></a><h3>pango_attr_scale_new ()</h3>
 
1636
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1637
pango_attr_scale_new (<em class="parameter"><code><span class="type">double</span> scale_factor</code></em>);</pre>
 
1638
<p>Create a new font size scale attribute. The base font for the
 
1639
affected text will have its size multiplied by <em class="parameter"><code>scale_factor</code></em>
 
1640
.</p>
 
1641
<div class="refsect3">
 
1642
<a name="id-1.2.5.9.31.5"></a><h4>Parameters</h4>
 
1643
<div class="informaltable"><table width="100%" border="0">
 
1644
<colgroup>
 
1645
<col width="150px" class="parameters_name">
 
1646
<col class="parameters_description">
 
1647
<col width="200px" class="parameters_annotations">
 
1648
</colgroup>
 
1649
<tbody><tr>
 
1650
<td class="parameter_name"><p>scale_factor</p></td>
 
1651
<td class="parameter_description"><p>factor to scale the font</p></td>
 
1652
<td class="parameter_annotations"> </td>
 
1653
</tr></tbody>
 
1654
</table></div>
 
1655
</div>
 
1656
<div class="refsect3">
 
1657
<a name="id-1.2.5.9.31.6"></a><h4>Returns</h4>
 
1658
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1659
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1660
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1661
</div>
 
1662
</div>
 
1663
<hr>
 
1664
<div class="refsect2">
 
1665
<a name="PANGO-SCALE-XX-SMALL:CAPS"></a><h3>PANGO_SCALE_XX_SMALL</h3>
 
1666
<pre class="programlisting">#define PANGO_SCALE_XX_SMALL ((double)0.5787037037037)
 
1667
</pre>
 
1668
<p>The scale factor for three shrinking steps (1 / (1.2 * 1.2 * 1.2)).</p>
 
1669
</div>
 
1670
<hr>
 
1671
<div class="refsect2">
 
1672
<a name="PANGO-SCALE-X-SMALL:CAPS"></a><h3>PANGO_SCALE_X_SMALL</h3>
 
1673
<pre class="programlisting">#define PANGO_SCALE_X_SMALL  ((double)0.6444444444444)
 
1674
</pre>
 
1675
<p>The scale factor for two shrinking steps (1 / (1.2 * 1.2)).</p>
 
1676
</div>
 
1677
<hr>
 
1678
<div class="refsect2">
 
1679
<a name="PANGO-SCALE-SMALL:CAPS"></a><h3>PANGO_SCALE_SMALL</h3>
 
1680
<pre class="programlisting">#define PANGO_SCALE_SMALL    ((double)0.8333333333333)
 
1681
</pre>
 
1682
<p>The scale factor for one shrinking step (1 / 1.2).</p>
 
1683
</div>
 
1684
<hr>
 
1685
<div class="refsect2">
 
1686
<a name="PANGO-SCALE-MEDIUM:CAPS"></a><h3>PANGO_SCALE_MEDIUM</h3>
 
1687
<pre class="programlisting">#define PANGO_SCALE_MEDIUM   ((double)1.0)
 
1688
</pre>
 
1689
<p>The scale factor for normal size (1.0).</p>
 
1690
</div>
 
1691
<hr>
 
1692
<div class="refsect2">
 
1693
<a name="PANGO-SCALE-LARGE:CAPS"></a><h3>PANGO_SCALE_LARGE</h3>
 
1694
<pre class="programlisting">#define PANGO_SCALE_LARGE    ((double)1.2)
 
1695
</pre>
 
1696
<p>The scale factor for one magnification step (1.2).</p>
 
1697
</div>
 
1698
<hr>
 
1699
<div class="refsect2">
 
1700
<a name="PANGO-SCALE-X-LARGE:CAPS"></a><h3>PANGO_SCALE_X_LARGE</h3>
 
1701
<pre class="programlisting">#define PANGO_SCALE_X_LARGE  ((double)1.4399999999999)
 
1702
</pre>
 
1703
<p>The scale factor for two magnification steps (1.2 * 1.2).</p>
 
1704
</div>
 
1705
<hr>
 
1706
<div class="refsect2">
 
1707
<a name="PANGO-SCALE-XX-LARGE:CAPS"></a><h3>PANGO_SCALE_XX_LARGE</h3>
 
1708
<pre class="programlisting">#define PANGO_SCALE_XX_LARGE ((double)1.728)
 
1709
</pre>
 
1710
<p>The scale factor for three magnification steps (1.2 * 1.2 * 1.2).</p>
 
1711
</div>
 
1712
<hr>
 
1713
<div class="refsect2">
 
1714
<a name="pango-attr-rise-new"></a><h3>pango_attr_rise_new ()</h3>
 
1715
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1716
pango_attr_rise_new (<em class="parameter"><code><span class="type">int</span> rise</code></em>);</pre>
 
1717
<p>Create a new baseline displacement attribute.</p>
 
1718
<div class="refsect3">
 
1719
<a name="id-1.2.5.9.39.5"></a><h4>Parameters</h4>
 
1720
<div class="informaltable"><table width="100%" border="0">
 
1721
<colgroup>
 
1722
<col width="150px" class="parameters_name">
 
1723
<col class="parameters_description">
 
1724
<col width="200px" class="parameters_annotations">
 
1725
</colgroup>
 
1726
<tbody><tr>
 
1727
<td class="parameter_name"><p>rise</p></td>
 
1728
<td class="parameter_description"><p>the amount that the text should be displaced vertically,
 
1729
in Pango units. Positive values displace the text upwards.</p></td>
 
1730
<td class="parameter_annotations"> </td>
 
1731
</tr></tbody>
 
1732
</table></div>
 
1733
</div>
 
1734
<div class="refsect3">
 
1735
<a name="id-1.2.5.9.39.6"></a><h4>Returns</h4>
 
1736
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1737
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1738
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1739
</div>
 
1740
</div>
 
1741
<hr>
 
1742
<div class="refsect2">
 
1743
<a name="pango-attr-letter-spacing-new"></a><h3>pango_attr_letter_spacing_new ()</h3>
 
1744
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1745
pango_attr_letter_spacing_new (<em class="parameter"><code><span class="type">int</span> letter_spacing</code></em>);</pre>
 
1746
<p>Create a new letter-spacing attribute.</p>
 
1747
<div class="refsect3">
 
1748
<a name="id-1.2.5.9.40.5"></a><h4>Parameters</h4>
 
1749
<div class="informaltable"><table width="100%" border="0">
 
1750
<colgroup>
 
1751
<col width="150px" class="parameters_name">
 
1752
<col class="parameters_description">
 
1753
<col width="200px" class="parameters_annotations">
 
1754
</colgroup>
 
1755
<tbody><tr>
 
1756
<td class="parameter_name"><p>letter_spacing</p></td>
 
1757
<td class="parameter_description"><p>amount of extra space to add between graphemes
 
1758
of the text, in Pango units.</p></td>
 
1759
<td class="parameter_annotations"> </td>
 
1760
</tr></tbody>
 
1761
</table></div>
 
1762
</div>
 
1763
<div class="refsect3">
 
1764
<a name="id-1.2.5.9.40.6"></a><h4>Returns</h4>
 
1765
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1766
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1767
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1768
</div>
 
1769
<p class="since">Since 1.6</p>
 
1770
</div>
 
1771
<hr>
 
1772
<div class="refsect2">
 
1773
<a name="pango-attr-fallback-new"></a><h3>pango_attr_fallback_new ()</h3>
 
1774
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1775
pango_attr_fallback_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable_fallback</code></em>);</pre>
 
1776
<p>Create a new font fallback attribute.</p>
 
1777
<p>If fallback is disabled, characters will only be used from the
 
1778
closest matching font on the system. No fallback will be done to
 
1779
other fonts on the system that might contain the characters in the
 
1780
text.</p>
 
1781
<div class="refsect3">
 
1782
<a name="id-1.2.5.9.41.6"></a><h4>Parameters</h4>
 
1783
<div class="informaltable"><table width="100%" border="0">
 
1784
<colgroup>
 
1785
<col width="150px" class="parameters_name">
 
1786
<col class="parameters_description">
 
1787
<col width="200px" class="parameters_annotations">
 
1788
</colgroup>
 
1789
<tbody><tr>
 
1790
<td class="parameter_name"><p>enable_fallback</p></td>
 
1791
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if we should fall back on other fonts
 
1792
for characters the active font is missing.</p></td>
 
1793
<td class="parameter_annotations"> </td>
 
1794
</tr></tbody>
 
1795
</table></div>
 
1796
</div>
 
1797
<div class="refsect3">
 
1798
<a name="id-1.2.5.9.41.7"></a><h4>Returns</h4>
 
1799
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1800
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1801
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1802
</div>
 
1803
<p class="since">Since 1.4</p>
 
1804
</div>
 
1805
<hr>
 
1806
<div class="refsect2">
 
1807
<a name="pango-attr-gravity-new"></a><h3>pango_attr_gravity_new ()</h3>
 
1808
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1809
pango_attr_gravity_new (<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravity" title="enum PangoGravity"><span class="type">PangoGravity</span></a> gravity</code></em>);</pre>
 
1810
<p>Create a new gravity attribute.</p>
 
1811
<div class="refsect3">
 
1812
<a name="id-1.2.5.9.42.5"></a><h4>Parameters</h4>
 
1813
<div class="informaltable"><table width="100%" border="0">
 
1814
<colgroup>
 
1815
<col width="150px" class="parameters_name">
 
1816
<col class="parameters_description">
 
1817
<col width="200px" class="parameters_annotations">
 
1818
</colgroup>
 
1819
<tbody><tr>
 
1820
<td class="parameter_name"><p>gravity</p></td>
 
1821
<td class="parameter_description"><p>the gravity value; should not be <a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a>.</p></td>
 
1822
<td class="parameter_annotations"> </td>
 
1823
</tr></tbody>
 
1824
</table></div>
 
1825
</div>
 
1826
<div class="refsect3">
 
1827
<a name="id-1.2.5.9.42.6"></a><h4>Returns</h4>
 
1828
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1829
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1830
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1831
</div>
 
1832
<p class="since">Since 1.16</p>
 
1833
</div>
 
1834
<hr>
 
1835
<div class="refsect2">
 
1836
<a name="pango-attr-gravity-hint-new"></a><h3>pango_attr_gravity_hint_new ()</h3>
 
1837
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
1838
pango_attr_gravity_hint_new (<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravityHint" title="enum PangoGravityHint"><span class="type">PangoGravityHint</span></a> hint</code></em>);</pre>
 
1839
<p>Create a new gravity hint attribute.</p>
 
1840
<div class="refsect3">
 
1841
<a name="id-1.2.5.9.43.5"></a><h4>Parameters</h4>
 
1842
<div class="informaltable"><table width="100%" border="0">
 
1843
<colgroup>
 
1844
<col width="150px" class="parameters_name">
 
1845
<col class="parameters_description">
 
1846
<col width="200px" class="parameters_annotations">
 
1847
</colgroup>
 
1848
<tbody><tr>
 
1849
<td class="parameter_name"><p>hint</p></td>
 
1850
<td class="parameter_description"><p>the gravity hint value.</p></td>
 
1851
<td class="parameter_annotations"> </td>
 
1852
</tr></tbody>
 
1853
</table></div>
 
1854
</div>
 
1855
<div class="refsect3">
 
1856
<a name="id-1.2.5.9.43.6"></a><h4>Returns</h4>
 
1857
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
 
1858
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. </p>
 
1859
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
1860
</div>
 
1861
<p class="since">Since 1.16</p>
 
1862
</div>
 
1863
<hr>
 
1864
<div class="refsect2">
 
1865
<a name="pango-color-parse"></a><h3>pango_color_parse ()</h3>
 
1866
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
1867
pango_color_parse (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>,
 
1868
                   <em class="parameter"><code>const <span class="type">char</span> *spec</code></em>);</pre>
 
1869
<p>Fill in the fields of a color from a string specification. The
 
1870
string can either one of a large set of standard names. (Taken
 
1871
from the CSS <a class="ulink" href="http://dev.w3.org/csswg/css-color/#named-colors" target="_top">specification</a>), or it can be a hexadecimal
 
1872
value in the
 
1873
form '#rgb' '#rrggbb' '#rrrgggbbb' or '#rrrrggggbbbb' where
 
1874
'r', 'g' and 'b' are hex digits of the red, green, and blue
 
1875
components of the color, respectively. (White in the four
 
1876
forms is '#fff' '#ffffff' '#fffffffff' and '#ffffffffffff')</p>
 
1877
<div class="refsect3">
 
1878
<a name="id-1.2.5.9.44.5"></a><h4>Parameters</h4>
 
1879
<div class="informaltable"><table width="100%" border="0">
 
1880
<colgroup>
 
1881
<col width="150px" class="parameters_name">
 
1882
<col class="parameters_description">
 
1883
<col width="200px" class="parameters_annotations">
 
1884
</colgroup>
 
1885
<tbody>
 
1886
<tr>
 
1887
<td class="parameter_name"><p>color</p></td>
 
1888
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> structure in which to store the result, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
1889
<td class="parameter_annotations"> </td>
 
1890
</tr>
 
1891
<tr>
 
1892
<td class="parameter_name"><p>spec</p></td>
 
1893
<td class="parameter_description"><p>a string specifying the new color</p></td>
 
1894
<td class="parameter_annotations"> </td>
 
1895
</tr>
 
1896
</tbody>
 
1897
</table></div>
 
1898
</div>
 
1899
<div class="refsect3">
 
1900
<a name="id-1.2.5.9.44.6"></a><h4>Returns</h4>
 
1901
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if parsing of the specifier succeeded,
 
1902
otherwise false.</p>
 
1903
<p></p>
 
1904
</div>
 
1905
</div>
 
1906
<hr>
 
1907
<div class="refsect2">
 
1908
<a name="pango-color-copy"></a><h3>pango_color_copy ()</h3>
 
1909
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="returnvalue">PangoColor</span></a> *
 
1910
pango_color_copy (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *src</code></em>);</pre>
 
1911
<p>Creates a copy of <em class="parameter"><code>src</code></em>
 
1912
, which should be freed with
 
1913
<a class="link" href="pango-Text-Attributes.html#pango-color-free" title="pango_color_free ()"><code class="function">pango_color_free()</code></a>. Primarily used by language bindings,
 
1914
not that useful otherwise (since colors can just be copied
 
1915
by assignment in C).</p>
 
1916
<div class="refsect3">
 
1917
<a name="id-1.2.5.9.45.5"></a><h4>Parameters</h4>
 
1918
<div class="informaltable"><table width="100%" border="0">
 
1919
<colgroup>
 
1920
<col width="150px" class="parameters_name">
 
1921
<col class="parameters_description">
 
1922
<col width="200px" class="parameters_annotations">
 
1923
</colgroup>
 
1924
<tbody><tr>
 
1925
<td class="parameter_name"><p>src</p></td>
 
1926
<td class="parameter_description"><p>color to copy, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
1927
<td class="parameter_annotations"> </td>
 
1928
</tr></tbody>
 
1929
</table></div>
 
1930
</div>
 
1931
<div class="refsect3">
 
1932
<a name="id-1.2.5.9.45.6"></a><h4>Returns</h4>
 
1933
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>, which should
 
1934
be freed with <a class="link" href="pango-Text-Attributes.html#pango-color-free" title="pango_color_free ()"><code class="function">pango_color_free()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
1935
if <em class="parameter"><code>src</code></em>
 
1936
was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
 
1937
<p></p>
 
1938
</div>
 
1939
</div>
 
1940
<hr>
 
1941
<div class="refsect2">
 
1942
<a name="pango-color-free"></a><h3>pango_color_free ()</h3>
 
1943
<pre class="programlisting"><span class="returnvalue">void</span>
 
1944
pango_color_free (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);</pre>
 
1945
<p>Frees a color allocated by <a class="link" href="pango-Text-Attributes.html#pango-color-copy" title="pango_color_copy ()"><code class="function">pango_color_copy()</code></a>.</p>
 
1946
<div class="refsect3">
 
1947
<a name="id-1.2.5.9.46.5"></a><h4>Parameters</h4>
 
1948
<div class="informaltable"><table width="100%" border="0">
 
1949
<colgroup>
 
1950
<col width="150px" class="parameters_name">
 
1951
<col class="parameters_description">
 
1952
<col width="200px" class="parameters_annotations">
 
1953
</colgroup>
 
1954
<tbody><tr>
 
1955
<td class="parameter_name"><p>color</p></td>
 
1956
<td class="parameter_description"><p>an allocated <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
1957
<td class="parameter_annotations"> </td>
 
1958
</tr></tbody>
 
1959
</table></div>
 
1960
</div>
 
1961
</div>
 
1962
<hr>
 
1963
<div class="refsect2">
 
1964
<a name="pango-color-to-string"></a><h3>pango_color_to_string ()</h3>
 
1965
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
1966
pango_color_to_string (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);</pre>
 
1967
<p>Returns a textual specification of <em class="parameter"><code>color</code></em>
 
1968
 in the hexadecimal form
 
1969
<code class="literal">#rrrrggggbbbb</code>, where <code class="literal">r</code>,
 
1970
<code class="literal">g</code> and <code class="literal">b</code> are hex digits representing
 
1971
the red, green, and blue components respectively.</p>
 
1972
<div class="refsect3">
 
1973
<a name="id-1.2.5.9.47.5"></a><h4>Parameters</h4>
 
1974
<div class="informaltable"><table width="100%" border="0">
 
1975
<colgroup>
 
1976
<col width="150px" class="parameters_name">
 
1977
<col class="parameters_description">
 
1978
<col width="200px" class="parameters_annotations">
 
1979
</colgroup>
 
1980
<tbody><tr>
 
1981
<td class="parameter_name"><p>color</p></td>
 
1982
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a></p></td>
 
1983
<td class="parameter_annotations"> </td>
 
1984
</tr></tbody>
 
1985
</table></div>
 
1986
</div>
 
1987
<div class="refsect3">
 
1988
<a name="id-1.2.5.9.47.6"></a><h4>Returns</h4>
 
1989
<p> a newly-allocated text string that must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
 
1990
<p></p>
 
1991
</div>
 
1992
<p class="since">Since 1.16</p>
 
1993
</div>
 
1994
<hr>
 
1995
<div class="refsect2">
 
1996
<a name="pango-attr-list-new"></a><h3>pango_attr_list_new ()</h3>
 
1997
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
1998
pango_attr_list_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
1999
<p>Create a new empty attribute list with a reference count of one.</p>
 
2000
<div class="refsect3">
 
2001
<a name="id-1.2.5.9.48.5"></a><h4>Returns</h4>
 
2002
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>,
 
2003
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attr-list-unref" title="pango_attr_list_unref ()"><code class="function">pango_attr_list_unref()</code></a>. </p>
 
2004
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
2005
</div>
 
2006
</div>
 
2007
<hr>
 
2008
<div class="refsect2">
 
2009
<a name="pango-attr-list-ref"></a><h3>pango_attr_list_ref ()</h3>
 
2010
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
2011
pango_attr_list_ref (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
 
2012
<p>Increase the reference count of the given attribute list by one.</p>
 
2013
<div class="refsect3">
 
2014
<a name="id-1.2.5.9.49.5"></a><h4>Parameters</h4>
 
2015
<div class="informaltable"><table width="100%" border="0">
 
2016
<colgroup>
 
2017
<col width="150px" class="parameters_name">
 
2018
<col class="parameters_description">
 
2019
<col width="200px" class="parameters_annotations">
 
2020
</colgroup>
 
2021
<tbody><tr>
 
2022
<td class="parameter_name"><p>list</p></td>
 
2023
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
2024
<td class="parameter_annotations"> </td>
 
2025
</tr></tbody>
 
2026
</table></div>
 
2027
</div>
 
2028
<div class="refsect3">
 
2029
<a name="id-1.2.5.9.49.6"></a><h4>Returns</h4>
 
2030
<p> The attribute list passed in</p>
 
2031
<p></p>
 
2032
</div>
 
2033
<p class="since">Since 1.10</p>
 
2034
</div>
 
2035
<hr>
 
2036
<div class="refsect2">
 
2037
<a name="pango-attr-list-unref"></a><h3>pango_attr_list_unref ()</h3>
 
2038
<pre class="programlisting"><span class="returnvalue">void</span>
 
2039
pango_attr_list_unref (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
 
2040
<p>Decrease the reference count of the given attribute list by one.
 
2041
If the result is zero, free the attribute list and the attributes
 
2042
it contains.</p>
 
2043
<div class="refsect3">
 
2044
<a name="id-1.2.5.9.50.5"></a><h4>Parameters</h4>
 
2045
<div class="informaltable"><table width="100%" border="0">
 
2046
<colgroup>
 
2047
<col width="150px" class="parameters_name">
 
2048
<col class="parameters_description">
 
2049
<col width="200px" class="parameters_annotations">
 
2050
</colgroup>
 
2051
<tbody><tr>
 
2052
<td class="parameter_name"><p>list</p></td>
 
2053
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
2054
<td class="parameter_annotations"> </td>
 
2055
</tr></tbody>
 
2056
</table></div>
 
2057
</div>
 
2058
</div>
 
2059
<hr>
 
2060
<div class="refsect2">
 
2061
<a name="pango-attr-list-copy"></a><h3>pango_attr_list_copy ()</h3>
 
2062
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
2063
pango_attr_list_copy (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
 
2064
<p>Copy <em class="parameter"><code>list</code></em>
 
2065
 and return an identical new list.</p>
 
2066
<div class="refsect3">
 
2067
<a name="id-1.2.5.9.51.5"></a><h4>Parameters</h4>
 
2068
<div class="informaltable"><table width="100%" border="0">
 
2069
<colgroup>
 
2070
<col width="150px" class="parameters_name">
 
2071
<col class="parameters_description">
 
2072
<col width="200px" class="parameters_annotations">
 
2073
</colgroup>
 
2074
<tbody><tr>
 
2075
<td class="parameter_name"><p>list</p></td>
 
2076
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
2077
<td class="parameter_annotations"> </td>
 
2078
</tr></tbody>
 
2079
</table></div>
 
2080
</div>
 
2081
<div class="refsect3">
 
2082
<a name="id-1.2.5.9.51.6"></a><h4>Returns</h4>
 
2083
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, with a
 
2084
reference count of one, which should
 
2085
be freed with <a class="link" href="pango-Text-Attributes.html#pango-attr-list-unref" title="pango_attr_list_unref ()"><code class="function">pango_attr_list_unref()</code></a>.
 
2086
Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>list</code></em>
 
2087
was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
 
2088
<p></p>
 
2089
</div>
 
2090
</div>
 
2091
<hr>
 
2092
<div class="refsect2">
 
2093
<a name="pango-attr-list-insert"></a><h3>pango_attr_list_insert ()</h3>
 
2094
<pre class="programlisting"><span class="returnvalue">void</span>
 
2095
pango_attr_list_insert (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
 
2096
                        <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
 
2097
<p>Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
 
2098
be inserted after all other attributes with a matching
 
2099
<em class="parameter"><code>start_index</code></em>
 
2100
.</p>
 
2101
<div class="refsect3">
 
2102
<a name="id-1.2.5.9.52.5"></a><h4>Parameters</h4>
 
2103
<div class="informaltable"><table width="100%" border="0">
 
2104
<colgroup>
 
2105
<col width="150px" class="parameters_name">
 
2106
<col class="parameters_description">
 
2107
<col width="200px" class="parameters_annotations">
 
2108
</colgroup>
 
2109
<tbody>
 
2110
<tr>
 
2111
<td class="parameter_name"><p>list</p></td>
 
2112
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
 
2113
<td class="parameter_annotations"> </td>
 
2114
</tr>
 
2115
<tr>
 
2116
<td class="parameter_name"><p>attr</p></td>
 
2117
<td class="parameter_description"><p> the attribute to insert. Ownership of this
 
2118
value is assumed by the list. </p></td>
 
2119
<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 
2120
</tr>
 
2121
</tbody>
 
2122
</table></div>
 
2123
</div>
 
2124
</div>
 
2125
<hr>
 
2126
<div class="refsect2">
 
2127
<a name="pango-attr-list-insert-before"></a><h3>pango_attr_list_insert_before ()</h3>
 
2128
<pre class="programlisting"><span class="returnvalue">void</span>
 
2129
pango_attr_list_insert_before (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
 
2130
                               <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
 
2131
<p>Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
 
2132
be inserted before all other attributes with a matching
 
2133
<em class="parameter"><code>start_index</code></em>
 
2134
.</p>
 
2135
<div class="refsect3">
 
2136
<a name="id-1.2.5.9.53.5"></a><h4>Parameters</h4>
 
2137
<div class="informaltable"><table width="100%" border="0">
 
2138
<colgroup>
 
2139
<col width="150px" class="parameters_name">
 
2140
<col class="parameters_description">
 
2141
<col width="200px" class="parameters_annotations">
 
2142
</colgroup>
 
2143
<tbody>
 
2144
<tr>
 
2145
<td class="parameter_name"><p>list</p></td>
 
2146
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
 
2147
<td class="parameter_annotations"> </td>
 
2148
</tr>
 
2149
<tr>
 
2150
<td class="parameter_name"><p>attr</p></td>
 
2151
<td class="parameter_description"><p> the attribute to insert. Ownership of this
 
2152
value is assumed by the list. </p></td>
 
2153
<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 
2154
</tr>
 
2155
</tbody>
 
2156
</table></div>
 
2157
</div>
 
2158
</div>
 
2159
<hr>
 
2160
<div class="refsect2">
 
2161
<a name="pango-attr-list-change"></a><h3>pango_attr_list_change ()</h3>
 
2162
<pre class="programlisting"><span class="returnvalue">void</span>
 
2163
pango_attr_list_change (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
 
2164
                        <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
 
2165
<p>Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
 
2166
replace any attributes of the same type on that segment
 
2167
and be merged with any adjoining attributes that are identical.</p>
 
2168
<p>This function is slower than <a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert" title="pango_attr_list_insert ()"><code class="function">pango_attr_list_insert()</code></a> for
 
2169
creating a attribute list in order (potentially much slower
 
2170
for large lists). However, <a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert" title="pango_attr_list_insert ()"><code class="function">pango_attr_list_insert()</code></a> is not
 
2171
suitable for continually changing a set of attributes
 
2172
since it never removes or combines existing attributes.</p>
 
2173
<div class="refsect3">
 
2174
<a name="id-1.2.5.9.54.6"></a><h4>Parameters</h4>
 
2175
<div class="informaltable"><table width="100%" border="0">
 
2176
<colgroup>
 
2177
<col width="150px" class="parameters_name">
 
2178
<col class="parameters_description">
 
2179
<col width="200px" class="parameters_annotations">
 
2180
</colgroup>
 
2181
<tbody>
 
2182
<tr>
 
2183
<td class="parameter_name"><p>list</p></td>
 
2184
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
 
2185
<td class="parameter_annotations"> </td>
 
2186
</tr>
 
2187
<tr>
 
2188
<td class="parameter_name"><p>attr</p></td>
 
2189
<td class="parameter_description"><p> the attribute to insert. Ownership of this
 
2190
value is assumed by the list. </p></td>
 
2191
<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 
2192
</tr>
 
2193
</tbody>
 
2194
</table></div>
 
2195
</div>
 
2196
</div>
 
2197
<hr>
 
2198
<div class="refsect2">
 
2199
<a name="pango-attr-list-splice"></a><h3>pango_attr_list_splice ()</h3>
 
2200
<pre class="programlisting"><span class="returnvalue">void</span>
 
2201
pango_attr_list_splice (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
 
2202
                        <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *other</code></em>,
 
2203
                        <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>,
 
2204
                        <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> len</code></em>);</pre>
 
2205
<p>This function opens up a hole in <em class="parameter"><code>list</code></em>
 
2206
, fills it in with attributes from
 
2207
the left, and then merges <em class="parameter"><code>other</code></em>
 
2208
 on top of the hole.</p>
 
2209
<p>This operation is equivalent to stretching every attribute
 
2210
that applies at position <em class="parameter"><code>pos</code></em>
 
2211
 in <em class="parameter"><code>list</code></em>
 
2212
 by an amount <em class="parameter"><code>len</code></em>
 
2213
,
 
2214
and then calling <a class="link" href="pango-Text-Attributes.html#pango-attr-list-change" title="pango_attr_list_change ()"><code class="function">pango_attr_list_change()</code></a> with a copy
 
2215
of each attribute in <em class="parameter"><code>other</code></em>
 
2216
 in sequence (offset in position by <em class="parameter"><code>pos</code></em>
 
2217
).</p>
 
2218
<p>This operation proves useful for, for instance, inserting
 
2219
a pre-edit string in the middle of an edit buffer.</p>
 
2220
<div class="refsect3">
 
2221
<a name="id-1.2.5.9.55.7"></a><h4>Parameters</h4>
 
2222
<div class="informaltable"><table width="100%" border="0">
 
2223
<colgroup>
 
2224
<col width="150px" class="parameters_name">
 
2225
<col class="parameters_description">
 
2226
<col width="200px" class="parameters_annotations">
 
2227
</colgroup>
 
2228
<tbody>
 
2229
<tr>
 
2230
<td class="parameter_name"><p>list</p></td>
 
2231
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
 
2232
<td class="parameter_annotations"> </td>
 
2233
</tr>
 
2234
<tr>
 
2235
<td class="parameter_name"><p>other</p></td>
 
2236
<td class="parameter_description"><p>another <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
 
2237
<td class="parameter_annotations"> </td>
 
2238
</tr>
 
2239
<tr>
 
2240
<td class="parameter_name"><p>pos</p></td>
 
2241
<td class="parameter_description"><p>the position in <em class="parameter"><code>list</code></em>
 
2242
at which to insert <em class="parameter"><code>other</code></em>
 
2243
</p></td>
 
2244
<td class="parameter_annotations"> </td>
 
2245
</tr>
 
2246
<tr>
 
2247
<td class="parameter_name"><p>len</p></td>
 
2248
<td class="parameter_description"><p>the length of the spliced segment. (Note that this
 
2249
must be specified since the attributes in <em class="parameter"><code>other</code></em>
 
2250
may only be present at some subsection of this range)</p></td>
 
2251
<td class="parameter_annotations"> </td>
 
2252
</tr>
 
2253
</tbody>
 
2254
</table></div>
 
2255
</div>
 
2256
</div>
 
2257
<hr>
 
2258
<div class="refsect2">
 
2259
<a name="pango-attr-list-filter"></a><h3>pango_attr_list_filter ()</h3>
 
2260
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
 
2261
pango_attr_list_filter (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
 
2262
                        <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrFilterFunc" title="PangoAttrFilterFunc ()"><span class="type">PangoAttrFilterFunc</span></a> func</code></em>,
 
2263
                        <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
2264
<p>Given a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> and callback function, removes any elements
 
2265
of <em class="parameter"><code>list</code></em>
 
2266
 for which <em class="parameter"><code>func</code></em>
 
2267
 returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and inserts them into
 
2268
a new list.</p>
 
2269
<div class="refsect3">
 
2270
<a name="id-1.2.5.9.56.5"></a><h4>Parameters</h4>
 
2271
<div class="informaltable"><table width="100%" border="0">
 
2272
<colgroup>
 
2273
<col width="150px" class="parameters_name">
 
2274
<col class="parameters_description">
 
2275
<col width="200px" class="parameters_annotations">
 
2276
</colgroup>
 
2277
<tbody>
 
2278
<tr>
 
2279
<td class="parameter_name"><p>list</p></td>
 
2280
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
 
2281
<td class="parameter_annotations"> </td>
 
2282
</tr>
 
2283
<tr>
 
2284
<td class="parameter_name"><p>func</p></td>
 
2285
<td class="parameter_description"><p> callback function; returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
 
2286
if an attribute should be filtered out. </p></td>
 
2287
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> data]</span></td>
 
2288
</tr>
 
2289
<tr>
 
2290
<td class="parameter_name"><p>data</p></td>
 
2291
<td class="parameter_description"><p> Data to be passed to <em class="parameter"><code>func</code></em>
 
2292
. </p></td>
 
2293
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
 
2294
</tr>
 
2295
</tbody>
 
2296
</table></div>
 
2297
</div>
 
2298
<div class="refsect3">
 
2299
<a name="id-1.2.5.9.56.6"></a><h4>Returns</h4>
 
2300
<p> the new <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
2301
no attributes of the given types were found. </p>
 
2302
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
2303
</div>
 
2304
<p class="since">Since 1.2</p>
 
2305
</div>
 
2306
<hr>
 
2307
<div class="refsect2">
 
2308
<a name="PangoAttrFilterFunc"></a><h3>PangoAttrFilterFunc ()</h3>
 
2309
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
2310
<span class="c_punctuation">(</span>*PangoAttrFilterFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attribute</code></em>,
 
2311
                        <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
2312
<p>Type of a function filtering a list of attributes.</p>
 
2313
<div class="refsect3">
 
2314
<a name="id-1.2.5.9.57.5"></a><h4>Parameters</h4>
 
2315
<div class="informaltable"><table width="100%" border="0">
 
2316
<colgroup>
 
2317
<col width="150px" class="parameters_name">
 
2318
<col class="parameters_description">
 
2319
<col width="200px" class="parameters_annotations">
 
2320
</colgroup>
 
2321
<tbody>
 
2322
<tr>
 
2323
<td class="parameter_name"><p>attribute</p></td>
 
2324
<td class="parameter_description"><p>a Pango attribute</p></td>
 
2325
<td class="parameter_annotations"> </td>
 
2326
</tr>
 
2327
<tr>
 
2328
<td class="parameter_name"><p>user_data</p></td>
 
2329
<td class="parameter_description"><p>user data passed to the function</p></td>
 
2330
<td class="parameter_annotations"> </td>
 
2331
</tr>
 
2332
</tbody>
 
2333
</table></div>
 
2334
</div>
 
2335
<div class="refsect3">
 
2336
<a name="id-1.2.5.9.57.6"></a><h4>Returns</h4>
 
2337
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attribute should be selected for
 
2338
filtering, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 
2339
<p></p>
 
2340
</div>
 
2341
</div>
 
2342
<hr>
 
2343
<div class="refsect2">
 
2344
<a name="pango-attr-list-get-iterator"></a><h3>pango_attr_list_get_iterator ()</h3>
 
2345
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> *
 
2346
pango_attr_list_get_iterator (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
 
2347
<p>Create a iterator initialized to the beginning of the list.
 
2348
<em class="parameter"><code>list</code></em>
 
2349
 must not be modified until this iterator is freed.</p>
 
2350
<div class="refsect3">
 
2351
<a name="id-1.2.5.9.58.5"></a><h4>Parameters</h4>
 
2352
<div class="informaltable"><table width="100%" border="0">
 
2353
<colgroup>
 
2354
<col width="150px" class="parameters_name">
 
2355
<col class="parameters_description">
 
2356
<col width="200px" class="parameters_annotations">
 
2357
</colgroup>
 
2358
<tbody><tr>
 
2359
<td class="parameter_name"><p>list</p></td>
 
2360
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
 
2361
<td class="parameter_annotations"> </td>
 
2362
</tr></tbody>
 
2363
</table></div>
 
2364
</div>
 
2365
<div class="refsect3">
 
2366
<a name="id-1.2.5.9.58.6"></a><h4>Returns</h4>
 
2367
<p> the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>, which should
 
2368
be freed with <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-destroy" title="pango_attr_iterator_destroy ()"><code class="function">pango_attr_iterator_destroy()</code></a>. </p>
 
2369
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
2370
</div>
 
2371
</div>
 
2372
<hr>
 
2373
<div class="refsect2">
 
2374
<a name="pango-attr-iterator-copy"></a><h3>pango_attr_iterator_copy ()</h3>
 
2375
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> *
 
2376
pango_attr_iterator_copy (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
 
2377
<p>Copy a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p>
 
2378
<div class="refsect3">
 
2379
<a name="id-1.2.5.9.59.5"></a><h4>Parameters</h4>
 
2380
<div class="informaltable"><table width="100%" border="0">
 
2381
<colgroup>
 
2382
<col width="150px" class="parameters_name">
 
2383
<col class="parameters_description">
 
2384
<col width="200px" class="parameters_annotations">
 
2385
</colgroup>
 
2386
<tbody><tr>
 
2387
<td class="parameter_name"><p>iterator</p></td>
 
2388
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>.</p></td>
 
2389
<td class="parameter_annotations"> </td>
 
2390
</tr></tbody>
 
2391
</table></div>
 
2392
</div>
 
2393
<div class="refsect3">
 
2394
<a name="id-1.2.5.9.59.6"></a><h4>Returns</h4>
 
2395
<p> the newly allocated
 
2396
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>, which should be freed with
 
2397
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-destroy" title="pango_attr_iterator_destroy ()"><code class="function">pango_attr_iterator_destroy()</code></a>. </p>
 
2398
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
2399
</div>
 
2400
</div>
 
2401
<hr>
 
2402
<div class="refsect2">
 
2403
<a name="pango-attr-iterator-next"></a><h3>pango_attr_iterator_next ()</h3>
 
2404
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
2405
pango_attr_iterator_next (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
 
2406
<p>Advance the iterator until the next change of style.</p>
 
2407
<div class="refsect3">
 
2408
<a name="id-1.2.5.9.60.5"></a><h4>Parameters</h4>
 
2409
<div class="informaltable"><table width="100%" border="0">
 
2410
<colgroup>
 
2411
<col width="150px" class="parameters_name">
 
2412
<col class="parameters_description">
 
2413
<col width="200px" class="parameters_annotations">
 
2414
</colgroup>
 
2415
<tbody><tr>
 
2416
<td class="parameter_name"><p>iterator</p></td>
 
2417
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p></td>
 
2418
<td class="parameter_annotations"> </td>
 
2419
</tr></tbody>
 
2420
</table></div>
 
2421
</div>
 
2422
<div class="refsect3">
 
2423
<a name="id-1.2.5.9.60.6"></a><h4>Returns</h4>
 
2424
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the iterator is at the end of the list, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a></p>
 
2425
<p></p>
 
2426
</div>
 
2427
</div>
 
2428
<hr>
 
2429
<div class="refsect2">
 
2430
<a name="pango-attr-iterator-range"></a><h3>pango_attr_iterator_range ()</h3>
 
2431
<pre class="programlisting"><span class="returnvalue">void</span>
 
2432
pango_attr_iterator_range (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
 
2433
                           <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>,
 
2434
                           <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);</pre>
 
2435
<p>Get the range of the current segment. Note that the
 
2436
stored return values are signed, not unsigned like
 
2437
the values in <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>. To deal with this API
 
2438
oversight, stored return values that wouldn't fit into
 
2439
a signed integer are clamped to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a>.</p>
 
2440
<div class="refsect3">
 
2441
<a name="id-1.2.5.9.61.5"></a><h4>Parameters</h4>
 
2442
<div class="informaltable"><table width="100%" border="0">
 
2443
<colgroup>
 
2444
<col width="150px" class="parameters_name">
 
2445
<col class="parameters_description">
 
2446
<col width="200px" class="parameters_annotations">
 
2447
</colgroup>
 
2448
<tbody>
 
2449
<tr>
 
2450
<td class="parameter_name"><p>iterator</p></td>
 
2451
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p></td>
 
2452
<td class="parameter_annotations"> </td>
 
2453
</tr>
 
2454
<tr>
 
2455
<td class="parameter_name"><p>start</p></td>
 
2456
<td class="parameter_description"><p> location to store the start of the range. </p></td>
 
2457
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
 
2458
</tr>
 
2459
<tr>
 
2460
<td class="parameter_name"><p>end</p></td>
 
2461
<td class="parameter_description"><p> location to store the end of the range. </p></td>
 
2462
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
 
2463
</tr>
 
2464
</tbody>
 
2465
</table></div>
 
2466
</div>
 
2467
</div>
 
2468
<hr>
 
2469
<div class="refsect2">
 
2470
<a name="pango-attr-iterator-get"></a><h3>pango_attr_iterator_get ()</h3>
 
2471
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
 
2472
pango_attr_iterator_get (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
 
2473
                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="type">PangoAttrType</span></a> type</code></em>);</pre>
 
2474
<p>Find the current attribute of a particular type at the iterator
 
2475
location. When multiple attributes of the same type overlap,
 
2476
the attribute whose range starts closest to the current location
 
2477
is used.</p>
 
2478
<div class="refsect3">
 
2479
<a name="id-1.2.5.9.62.5"></a><h4>Parameters</h4>
 
2480
<div class="informaltable"><table width="100%" border="0">
 
2481
<colgroup>
 
2482
<col width="150px" class="parameters_name">
 
2483
<col class="parameters_description">
 
2484
<col width="200px" class="parameters_annotations">
 
2485
</colgroup>
 
2486
<tbody>
 
2487
<tr>
 
2488
<td class="parameter_name"><p>iterator</p></td>
 
2489
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p></td>
 
2490
<td class="parameter_annotations"> </td>
 
2491
</tr>
 
2492
<tr>
 
2493
<td class="parameter_name"><p>type</p></td>
 
2494
<td class="parameter_description"><p>the type of attribute to find.</p></td>
 
2495
<td class="parameter_annotations"> </td>
 
2496
</tr>
 
2497
</tbody>
 
2498
</table></div>
 
2499
</div>
 
2500
<div class="refsect3">
 
2501
<a name="id-1.2.5.9.62.6"></a><h4>Returns</h4>
 
2502
<p> the current attribute of the given type, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
2503
no attribute of that type applies to the current
 
2504
location.</p>
 
2505
<p></p>
 
2506
</div>
 
2507
</div>
 
2508
<hr>
 
2509
<div class="refsect2">
 
2510
<a name="pango-attr-iterator-get-font"></a><h3>pango_attr_iterator_get_font ()</h3>
 
2511
<pre class="programlisting"><span class="returnvalue">void</span>
 
2512
pango_attr_iterator_get_font (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
 
2513
                              <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,
 
2514
                              <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> **language</code></em>,
 
2515
                              <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **extra_attrs</code></em>);</pre>
 
2516
<p>Get the font and other attributes at the current iterator position.</p>
 
2517
<div class="refsect3">
 
2518
<a name="id-1.2.5.9.63.5"></a><h4>Parameters</h4>
 
2519
<div class="informaltable"><table width="100%" border="0">
 
2520
<colgroup>
 
2521
<col width="150px" class="parameters_name">
 
2522
<col class="parameters_description">
 
2523
<col width="200px" class="parameters_annotations">
 
2524
</colgroup>
 
2525
<tbody>
 
2526
<tr>
 
2527
<td class="parameter_name"><p>iterator</p></td>
 
2528
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p></td>
 
2529
<td class="parameter_annotations"> </td>
 
2530
</tr>
 
2531
<tr>
 
2532
<td class="parameter_name"><p>desc</p></td>
 
2533
<td class="parameter_description"><p>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to fill in with the current values.
 
2534
The family name in this structure will be set using
 
2535
<a class="link" href="pango-Fonts.html#pango-font-description-set-family-static" title="pango_font_description_set_family_static ()"><code class="function">pango_font_description_set_family_static()</code></a> using values from
 
2536
an attribute in the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> associated with the iterator,
 
2537
so if you plan to keep it around, you must call:
 
2538
<code class="literal">pango_font_description_set_family (desc, pango_font_description_get_family (desc))</code>.</p></td>
 
2539
<td class="parameter_annotations"> </td>
 
2540
</tr>
 
2541
<tr>
 
2542
<td class="parameter_name"><p>language</p></td>
 
2543
<td class="parameter_description"><p> if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, location to store language tag for item, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
2544
if none is found. </p></td>
 
2545
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 
2546
</tr>
 
2547
<tr>
 
2548
<td class="parameter_name"><p>extra_attrs</p></td>
 
2549
<td class="parameter_description"><p> if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
 
2550
location in which to store a list of non-font
 
2551
attributes at the the current position; only the highest priority
 
2552
value of each attribute will be added to this list. In order
 
2553
to free this value, you must call <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a> on
 
2554
each member. </p></td>
 
2555
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Attribute][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 
2556
</tr>
 
2557
</tbody>
 
2558
</table></div>
 
2559
</div>
 
2560
</div>
 
2561
<hr>
 
2562
<div class="refsect2">
 
2563
<a name="pango-attr-iterator-get-attrs"></a><h3>pango_attr_iterator_get_attrs ()</h3>
 
2564
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
 
2565
pango_attr_iterator_get_attrs (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
 
2566
<p>Gets a list of all attributes at the current position of the
 
2567
iterator.</p>
 
2568
<div class="refsect3">
 
2569
<a name="id-1.2.5.9.64.5"></a><h4>Parameters</h4>
 
2570
<div class="informaltable"><table width="100%" border="0">
 
2571
<colgroup>
 
2572
<col width="150px" class="parameters_name">
 
2573
<col class="parameters_description">
 
2574
<col width="200px" class="parameters_annotations">
 
2575
</colgroup>
 
2576
<tbody><tr>
 
2577
<td class="parameter_name"><p>iterator</p></td>
 
2578
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p></td>
 
2579
<td class="parameter_annotations"> </td>
 
2580
</tr></tbody>
 
2581
</table></div>
 
2582
</div>
 
2583
<div class="refsect3">
 
2584
<a name="id-1.2.5.9.64.6"></a><h4>Returns</h4>
 
2585
<p> a list of
 
2586
all attributes for the current range.
 
2587
To free this value, call <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a> on
 
2588
each value and <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> on the list. </p>
 
2589
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Attribute][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
2590
</div>
 
2591
<p class="since">Since 1.2</p>
 
2592
</div>
 
2593
<hr>
 
2594
<div class="refsect2">
 
2595
<a name="pango-attr-iterator-destroy"></a><h3>pango_attr_iterator_destroy ()</h3>
 
2596
<pre class="programlisting"><span class="returnvalue">void</span>
 
2597
pango_attr_iterator_destroy (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
 
2598
<p>Destroy a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> and free all associated memory.</p>
 
2599
<div class="refsect3">
 
2600
<a name="id-1.2.5.9.65.5"></a><h4>Parameters</h4>
 
2601
<div class="informaltable"><table width="100%" border="0">
 
2602
<colgroup>
 
2603
<col width="150px" class="parameters_name">
 
2604
<col class="parameters_description">
 
2605
<col width="200px" class="parameters_annotations">
 
2606
</colgroup>
 
2607
<tbody><tr>
 
2608
<td class="parameter_name"><p>iterator</p></td>
 
2609
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>.</p></td>
 
2610
<td class="parameter_annotations"> </td>
 
2611
</tr></tbody>
 
2612
</table></div>
 
2613
</div>
 
2614
</div>
 
2615
</div>
 
2616
<div class="refsect1">
 
2617
<a name="pango-Text-Attributes.other_details"></a><h2>Types and Values</h2>
 
2618
<div class="refsect2">
 
2619
<a name="PangoAttrType"></a><h3>enum PangoAttrType</h3>
 
2620
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="type">PangoAttrType</span></a>
227
2621
distinguishes between different types of attributes. Along with the
228
2622
predefined values, it is possible to allocate additional values
229
 
for custom attributes using <a class="link" href="pango-Text-Attributes.html#pango-attr-type-register" title="pango_attr_type_register ()"><code class="function">pango_attr_type_register()</code></a>. The predefined
 
2623
for custom attributes using <a class="link" href="pango-Text-Attributes.html#pango-attr-type-register" title="pango_attr_type_register ()"><code class="function">pango_attr_type_register()</code></a>. The predefined
230
2624
values are given below. The type of structure used to store the
231
2625
attribute is listed in parentheses after the description.</p>
232
 
<div class="variablelist"><table border="0" class="variablelist">
 
2626
<div class="refsect3">
 
2627
<a name="id-1.2.5.10.2.4"></a><h4>Members</h4>
 
2628
<div class="informaltable"><table width="100%" border="0">
233
2629
<colgroup>
234
 
<col align="left" valign="top">
235
 
<col>
 
2630
<col width="300px" class="enum_members_name">
 
2631
<col class="enum_members_description">
 
2632
<col width="200px" class="enum_members_annotations">
236
2633
</colgroup>
237
2634
<tbody>
238
2635
<tr>
239
 
<td><p><a name="PANGO-ATTR-INVALID:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_INVALID</code></span></p></td>
240
 
<td>does not happen
241
 
</td>
242
 
</tr>
243
 
<tr>
244
 
<td><p><a name="PANGO-ATTR-LANGUAGE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_LANGUAGE</code></span></p></td>
245
 
<td>language (<a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage"><span class="type">PangoAttrLanguage</span></a>)
246
 
</td>
247
 
</tr>
248
 
<tr>
249
 
<td><p><a name="PANGO-ATTR-FAMILY:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_FAMILY</code></span></p></td>
250
 
<td>font family name list (<a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString"><span class="type">PangoAttrString</span></a>)
251
 
</td>
252
 
</tr>
253
 
<tr>
254
 
<td><p><a name="PANGO-ATTR-STYLE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_STYLE</code></span></p></td>
255
 
<td>font slant style (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
256
 
</td>
257
 
</tr>
258
 
<tr>
259
 
<td><p><a name="PANGO-ATTR-WEIGHT:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_WEIGHT</code></span></p></td>
260
 
<td>font weight (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
261
 
</td>
262
 
</tr>
263
 
<tr>
264
 
<td><p><a name="PANGO-ATTR-VARIANT:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_VARIANT</code></span></p></td>
265
 
<td>font variant (normal or small caps) (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
266
 
</td>
267
 
</tr>
268
 
<tr>
269
 
<td><p><a name="PANGO-ATTR-STRETCH:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_STRETCH</code></span></p></td>
270
 
<td>font stretch (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
271
 
</td>
272
 
</tr>
273
 
<tr>
274
 
<td><p><a name="PANGO-ATTR-SIZE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_SIZE</code></span></p></td>
275
 
<td>font size in points scaled by <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
276
 
</td>
277
 
</tr>
278
 
<tr>
279
 
<td><p><a name="PANGO-ATTR-FONT-DESC:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_FONT_DESC</code></span></p></td>
280
 
<td>font description (<a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc"><span class="type">PangoAttrFontDesc</span></a>)
281
 
</td>
282
 
</tr>
283
 
<tr>
284
 
<td><p><a name="PANGO-ATTR-FOREGROUND:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_FOREGROUND</code></span></p></td>
285
 
<td>foreground color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)
286
 
</td>
287
 
</tr>
288
 
<tr>
289
 
<td><p><a name="PANGO-ATTR-BACKGROUND:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_BACKGROUND</code></span></p></td>
290
 
<td>background color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)
291
 
</td>
292
 
</tr>
293
 
<tr>
294
 
<td><p><a name="PANGO-ATTR-UNDERLINE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_UNDERLINE</code></span></p></td>
295
 
<td>whether the text has an underline (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
296
 
</td>
297
 
</tr>
298
 
<tr>
299
 
<td><p><a name="PANGO-ATTR-STRIKETHROUGH:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_STRIKETHROUGH</code></span></p></td>
300
 
<td>whether the text is struck-through (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
301
 
</td>
302
 
</tr>
303
 
<tr>
304
 
<td><p><a name="PANGO-ATTR-RISE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_RISE</code></span></p></td>
305
 
<td>baseline displacement (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
306
 
</td>
307
 
</tr>
308
 
<tr>
309
 
<td><p><a name="PANGO-ATTR-SHAPE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_SHAPE</code></span></p></td>
310
 
<td>shape (<a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape"><span class="type">PangoAttrShape</span></a>)
311
 
</td>
312
 
</tr>
313
 
<tr>
314
 
<td><p><a name="PANGO-ATTR-SCALE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_SCALE</code></span></p></td>
315
 
<td>font size scale factor (<a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat"><span class="type">PangoAttrFloat</span></a>)
316
 
</td>
317
 
</tr>
318
 
<tr>
319
 
<td><p><a name="PANGO-ATTR-FALLBACK:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_FALLBACK</code></span></p></td>
320
 
<td>whether fallback is enabled (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
321
 
</td>
322
 
</tr>
323
 
<tr>
324
 
<td><p><a name="PANGO-ATTR-LETTER-SPACING:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_LETTER_SPACING</code></span></p></td>
325
 
<td>letter spacing (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
326
 
</td>
327
 
</tr>
328
 
<tr>
329
 
<td><p><a name="PANGO-ATTR-UNDERLINE-COLOR:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_UNDERLINE_COLOR</code></span></p></td>
330
 
<td>underline color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)
331
 
</td>
332
 
</tr>
333
 
<tr>
334
 
<td><p><a name="PANGO-ATTR-STRIKETHROUGH-COLOR:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_STRIKETHROUGH_COLOR</code></span></p></td>
335
 
<td>strikethrough color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)
336
 
</td>
337
 
</tr>
338
 
<tr>
339
 
<td><p><a name="PANGO-ATTR-ABSOLUTE-SIZE:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></span></p></td>
340
 
<td>font size in pixels scaled by <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
341
 
</td>
342
 
</tr>
343
 
<tr>
344
 
<td><p><a name="PANGO-ATTR-GRAVITY:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_GRAVITY</code></span></p></td>
345
 
<td>base text gravity (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
346
 
</td>
347
 
</tr>
348
 
<tr>
349
 
<td><p><a name="PANGO-ATTR-GRAVITY-HINT:CAPS"></a><span class="term"><code class="literal">PANGO_ATTR_GRAVITY_HINT</code></span></p></td>
350
 
<td>gravity hint (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)
351
 
</td>
 
2636
<td class="enum_member_name"><p><a name="PANGO-ATTR-INVALID:CAPS"></a>PANGO_ATTR_INVALID</p></td>
 
2637
<td class="enum_member_description">
 
2638
<p>does not happen</p>
 
2639
</td>
 
2640
<td class="enum_member_annotations"> </td>
 
2641
</tr>
 
2642
<tr>
 
2643
<td class="enum_member_name"><p><a name="PANGO-ATTR-LANGUAGE:CAPS"></a>PANGO_ATTR_LANGUAGE</p></td>
 
2644
<td class="enum_member_description">
 
2645
<p>language (<a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage"><span class="type">PangoAttrLanguage</span></a>)</p>
 
2646
</td>
 
2647
<td class="enum_member_annotations"> </td>
 
2648
</tr>
 
2649
<tr>
 
2650
<td class="enum_member_name"><p><a name="PANGO-ATTR-FAMILY:CAPS"></a>PANGO_ATTR_FAMILY</p></td>
 
2651
<td class="enum_member_description">
 
2652
<p>font family name list (<a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString"><span class="type">PangoAttrString</span></a>)</p>
 
2653
</td>
 
2654
<td class="enum_member_annotations"> </td>
 
2655
</tr>
 
2656
<tr>
 
2657
<td class="enum_member_name"><p><a name="PANGO-ATTR-STYLE:CAPS"></a>PANGO_ATTR_STYLE</p></td>
 
2658
<td class="enum_member_description">
 
2659
<p>font slant style (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2660
</td>
 
2661
<td class="enum_member_annotations"> </td>
 
2662
</tr>
 
2663
<tr>
 
2664
<td class="enum_member_name"><p><a name="PANGO-ATTR-WEIGHT:CAPS"></a>PANGO_ATTR_WEIGHT</p></td>
 
2665
<td class="enum_member_description">
 
2666
<p>font weight (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2667
</td>
 
2668
<td class="enum_member_annotations"> </td>
 
2669
</tr>
 
2670
<tr>
 
2671
<td class="enum_member_name"><p><a name="PANGO-ATTR-VARIANT:CAPS"></a>PANGO_ATTR_VARIANT</p></td>
 
2672
<td class="enum_member_description">
 
2673
<p>font variant (normal or small caps) (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2674
</td>
 
2675
<td class="enum_member_annotations"> </td>
 
2676
</tr>
 
2677
<tr>
 
2678
<td class="enum_member_name"><p><a name="PANGO-ATTR-STRETCH:CAPS"></a>PANGO_ATTR_STRETCH</p></td>
 
2679
<td class="enum_member_description">
 
2680
<p>font stretch (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2681
</td>
 
2682
<td class="enum_member_annotations"> </td>
 
2683
</tr>
 
2684
<tr>
 
2685
<td class="enum_member_name"><p><a name="PANGO-ATTR-SIZE:CAPS"></a>PANGO_ATTR_SIZE</p></td>
 
2686
<td class="enum_member_description">
 
2687
<p>font size in points scaled by <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2688
</td>
 
2689
<td class="enum_member_annotations"> </td>
 
2690
</tr>
 
2691
<tr>
 
2692
<td class="enum_member_name"><p><a name="PANGO-ATTR-FONT-DESC:CAPS"></a>PANGO_ATTR_FONT_DESC</p></td>
 
2693
<td class="enum_member_description">
 
2694
<p>font description (<a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc"><span class="type">PangoAttrFontDesc</span></a>)</p>
 
2695
</td>
 
2696
<td class="enum_member_annotations"> </td>
 
2697
</tr>
 
2698
<tr>
 
2699
<td class="enum_member_name"><p><a name="PANGO-ATTR-FOREGROUND:CAPS"></a>PANGO_ATTR_FOREGROUND</p></td>
 
2700
<td class="enum_member_description">
 
2701
<p>foreground color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
 
2702
</td>
 
2703
<td class="enum_member_annotations"> </td>
 
2704
</tr>
 
2705
<tr>
 
2706
<td class="enum_member_name"><p><a name="PANGO-ATTR-BACKGROUND:CAPS"></a>PANGO_ATTR_BACKGROUND</p></td>
 
2707
<td class="enum_member_description">
 
2708
<p>background color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
 
2709
</td>
 
2710
<td class="enum_member_annotations"> </td>
 
2711
</tr>
 
2712
<tr>
 
2713
<td class="enum_member_name"><p><a name="PANGO-ATTR-UNDERLINE:CAPS"></a>PANGO_ATTR_UNDERLINE</p></td>
 
2714
<td class="enum_member_description">
 
2715
<p>whether the text has an underline (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2716
</td>
 
2717
<td class="enum_member_annotations"> </td>
 
2718
</tr>
 
2719
<tr>
 
2720
<td class="enum_member_name"><p><a name="PANGO-ATTR-STRIKETHROUGH:CAPS"></a>PANGO_ATTR_STRIKETHROUGH</p></td>
 
2721
<td class="enum_member_description">
 
2722
<p>whether the text is struck-through (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2723
</td>
 
2724
<td class="enum_member_annotations"> </td>
 
2725
</tr>
 
2726
<tr>
 
2727
<td class="enum_member_name"><p><a name="PANGO-ATTR-RISE:CAPS"></a>PANGO_ATTR_RISE</p></td>
 
2728
<td class="enum_member_description">
 
2729
<p>baseline displacement (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2730
</td>
 
2731
<td class="enum_member_annotations"> </td>
 
2732
</tr>
 
2733
<tr>
 
2734
<td class="enum_member_name"><p><a name="PANGO-ATTR-SHAPE:CAPS"></a>PANGO_ATTR_SHAPE</p></td>
 
2735
<td class="enum_member_description">
 
2736
<p>shape (<a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape"><span class="type">PangoAttrShape</span></a>)</p>
 
2737
</td>
 
2738
<td class="enum_member_annotations"> </td>
 
2739
</tr>
 
2740
<tr>
 
2741
<td class="enum_member_name"><p><a name="PANGO-ATTR-SCALE:CAPS"></a>PANGO_ATTR_SCALE</p></td>
 
2742
<td class="enum_member_description">
 
2743
<p>font size scale factor (<a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat"><span class="type">PangoAttrFloat</span></a>)</p>
 
2744
</td>
 
2745
<td class="enum_member_annotations"> </td>
 
2746
</tr>
 
2747
<tr>
 
2748
<td class="enum_member_name"><p><a name="PANGO-ATTR-FALLBACK:CAPS"></a>PANGO_ATTR_FALLBACK</p></td>
 
2749
<td class="enum_member_description">
 
2750
<p>whether fallback is enabled (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2751
</td>
 
2752
<td class="enum_member_annotations"> </td>
 
2753
</tr>
 
2754
<tr>
 
2755
<td class="enum_member_name"><p><a name="PANGO-ATTR-LETTER-SPACING:CAPS"></a>PANGO_ATTR_LETTER_SPACING</p></td>
 
2756
<td class="enum_member_description">
 
2757
<p>letter spacing (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2758
</td>
 
2759
<td class="enum_member_annotations"> </td>
 
2760
</tr>
 
2761
<tr>
 
2762
<td class="enum_member_name"><p><a name="PANGO-ATTR-UNDERLINE-COLOR:CAPS"></a>PANGO_ATTR_UNDERLINE_COLOR</p></td>
 
2763
<td class="enum_member_description">
 
2764
<p>underline color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
 
2765
</td>
 
2766
<td class="enum_member_annotations"> </td>
 
2767
</tr>
 
2768
<tr>
 
2769
<td class="enum_member_name"><p><a name="PANGO-ATTR-STRIKETHROUGH-COLOR:CAPS"></a>PANGO_ATTR_STRIKETHROUGH_COLOR</p></td>
 
2770
<td class="enum_member_description">
 
2771
<p>strikethrough color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
 
2772
</td>
 
2773
<td class="enum_member_annotations"> </td>
 
2774
</tr>
 
2775
<tr>
 
2776
<td class="enum_member_name"><p><a name="PANGO-ATTR-ABSOLUTE-SIZE:CAPS"></a>PANGO_ATTR_ABSOLUTE_SIZE</p></td>
 
2777
<td class="enum_member_description">
 
2778
<p>font size in pixels scaled by <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2779
</td>
 
2780
<td class="enum_member_annotations"> </td>
 
2781
</tr>
 
2782
<tr>
 
2783
<td class="enum_member_name"><p><a name="PANGO-ATTR-GRAVITY:CAPS"></a>PANGO_ATTR_GRAVITY</p></td>
 
2784
<td class="enum_member_description">
 
2785
<p>base text gravity (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2786
</td>
 
2787
<td class="enum_member_annotations"> </td>
 
2788
</tr>
 
2789
<tr>
 
2790
<td class="enum_member_name"><p><a name="PANGO-ATTR-GRAVITY-HINT:CAPS"></a>PANGO_ATTR_GRAVITY_HINT</p></td>
 
2791
<td class="enum_member_description">
 
2792
<p>gravity hint (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
 
2793
</td>
 
2794
<td class="enum_member_annotations"> </td>
352
2795
</tr>
353
2796
</tbody>
354
2797
</table></div>
355
2798
</div>
356
 
<hr>
357
 
<div class="refsect2">
358
 
<a name="PANGO-TYPE-ATTR-TYPE:CAPS"></a><h3>PANGO_TYPE_ATTR_TYPE</h3>
359
 
<pre class="programlisting">#define PANGO_TYPE_ATTR_TYPE (pango_attr_type_get_type ())
360
 
</pre>
361
2799
</div>
362
2800
<hr>
363
2801
<div class="refsect2">
369
2807
  gboolean         (*equal) (const PangoAttribute *attr1, const PangoAttribute *attr2);
370
2808
};
371
2809
</pre>
372
 
<p>
373
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a> structure stores the type and operations for
 
2810
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a> structure stores the type and operations for
374
2811
a particular type of attribute. The functions in this structure should
375
2812
not be called directly. Instead, one should use the wrapper functions
376
2813
provided for <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>.</p>
377
 
<div class="variablelist"><table border="0" class="variablelist">
 
2814
<div class="refsect3">
 
2815
<a name="id-1.2.5.10.3.5"></a><h4>Members</h4>
 
2816
<div class="informaltable"><table width="100%" border="0">
378
2817
<colgroup>
379
 
<col align="left" valign="top">
380
 
<col>
 
2818
<col width="300px" class="struct_members_name">
 
2819
<col class="struct_members_description">
 
2820
<col width="200px" class="struct_members_annotations">
381
2821
</colgroup>
382
2822
<tbody>
383
2823
<tr>
384
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="type">PangoAttrType</span></a> <em class="structfield"><code><a name="PangoAttrClass.type"></a>type</code></em>;</span></p></td>
385
 
<td>the type ID for this attribute</td>
386
 
</tr>
387
 
<tr>
388
 
<td><p><span class="term"><em class="structfield"><code><a name="PangoAttrClass.copy"></a>copy</code></em> ()</span></p></td>
389
 
<td>function to duplicate an attribute of this type (see <a class="link" href="pango-Text-Attributes.html#pango-attribute-copy" title="pango_attribute_copy ()"><code class="function">pango_attribute_copy()</code></a>)</td>
390
 
</tr>
391
 
<tr>
392
 
<td><p><span class="term"><em class="structfield"><code><a name="PangoAttrClass.destroy"></a>destroy</code></em> ()</span></p></td>
393
 
<td>function to free an attribute of this type (see <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>)</td>
394
 
</tr>
395
 
<tr>
396
 
<td><p><span class="term"><em class="structfield"><code><a name="PangoAttrClass.equal"></a>equal</code></em> ()</span></p></td>
397
 
<td>function to check two attributes of this type for equality (see <a class="link" href="pango-Text-Attributes.html#pango-attribute-equal" title="pango_attribute_equal ()"><code class="function">pango_attribute_equal()</code></a>)</td>
 
2824
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="type">PangoAttrType</span></a> <em class="structfield"><code><a name="PangoAttrClass.type"></a>type</code></em>;</p></td>
 
2825
<td class="struct_member_description"><p>the type ID for this attribute</p></td>
 
2826
<td class="struct_member_annotations"> </td>
 
2827
</tr>
 
2828
<tr>
 
2829
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoAttrClass.copy"></a>copy</code></em> ()</p></td>
 
2830
<td class="struct_member_description"><p>function to duplicate an attribute of this type (see <a class="link" href="pango-Text-Attributes.html#pango-attribute-copy" title="pango_attribute_copy ()"><code class="function">pango_attribute_copy()</code></a>)</p></td>
 
2831
<td class="struct_member_annotations"> </td>
 
2832
</tr>
 
2833
<tr>
 
2834
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoAttrClass.destroy"></a>destroy</code></em> ()</p></td>
 
2835
<td class="struct_member_description"><p>function to free an attribute of this type (see <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>)</p></td>
 
2836
<td class="struct_member_annotations"> </td>
 
2837
</tr>
 
2838
<tr>
 
2839
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoAttrClass.equal"></a>equal</code></em> ()</p></td>
 
2840
<td class="struct_member_description"><p>function to check two attributes of this type for equality (see <a class="link" href="pango-Text-Attributes.html#pango-attribute-equal" title="pango_attribute_equal ()"><code class="function">pango_attribute_equal()</code></a>)</p></td>
 
2841
<td class="struct_member_annotations"> </td>
398
2842
</tr>
399
2843
</tbody>
400
2844
</table></div>
401
2845
</div>
 
2846
</div>
402
2847
<hr>
403
2848
<div class="refsect2">
404
2849
<a name="PangoAttribute"></a><h3>struct PangoAttribute</h3>
408
2853
  guint end_index; /* in bytes. The character at this index is not included */
409
2854
};
410
2855
</pre>
411
 
<p>
412
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> structure represents the common portions of all
 
2856
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> structure represents the common portions of all
413
2857
attributes. Particular types of attributes include this structure
414
2858
as their initial portion. The common portion of the attribute holds
415
2859
the range to which the value in the type-specific part of the attribute
416
 
applies and should be initialized using <a class="link" href="pango-Text-Attributes.html#pango-attribute-init" title="pango_attribute_init ()"><code class="function">pango_attribute_init()</code></a>.
 
2860
applies and should be initialized using <a class="link" href="pango-Text-Attributes.html#pango-attribute-init" title="pango_attribute_init ()"><code class="function">pango_attribute_init()</code></a>.
417
2861
By default an attribute will have an all-inclusive range of [0,<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXUINT:CAPS"><code class="literal">G_MAXUINT</code></a>].</p>
418
 
<div class="variablelist"><table border="0" class="variablelist">
 
2862
<div class="refsect3">
 
2863
<a name="id-1.2.5.10.4.5"></a><h4>Members</h4>
 
2864
<div class="informaltable"><table width="100%" border="0">
419
2865
<colgroup>
420
 
<col align="left" valign="top">
421
 
<col>
 
2866
<col width="300px" class="struct_members_name">
 
2867
<col class="struct_members_description">
 
2868
<col width="200px" class="struct_members_annotations">
422
2869
</colgroup>
423
2870
<tbody>
424
2871
<tr>
425
 
<td><p><span class="term">const <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a> *<em class="structfield"><code><a name="PangoAttribute.klass"></a>klass</code></em>;</span></p></td>
426
 
<td>the class structure holding information about the type of the attribute</td>
427
 
</tr>
428
 
<tr>
429
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="PangoAttribute.start-index"></a>start_index</code></em>;</span></p></td>
430
 
<td>the start index of the range (in bytes).</td>
431
 
</tr>
432
 
<tr>
433
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="PangoAttribute.end-index"></a>end_index</code></em>;</span></p></td>
434
 
<td>end index of the range (in bytes). The character at this index
435
 
is not included in the range.</td>
 
2872
<td class="struct_member_name"><p>const <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a> *<em class="structfield"><code><a name="PangoAttribute.klass"></a>klass</code></em>;</p></td>
 
2873
<td class="struct_member_description"><p>the class structure holding information about the type of the attribute</p></td>
 
2874
<td class="struct_member_annotations"> </td>
 
2875
</tr>
 
2876
<tr>
 
2877
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="PangoAttribute.start-index"></a>start_index</code></em>;</p></td>
 
2878
<td class="struct_member_description"><p>the start index of the range (in bytes).</p></td>
 
2879
<td class="struct_member_annotations"> </td>
 
2880
</tr>
 
2881
<tr>
 
2882
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="PangoAttribute.end-index"></a>end_index</code></em>;</p></td>
 
2883
<td class="struct_member_description"><p>end index of the range (in bytes). The character at this index
 
2884
is not included in the range.</p></td>
 
2885
<td class="struct_member_annotations"> </td>
436
2886
</tr>
437
2887
</tbody>
438
2888
</table></div>
439
2889
</div>
 
2890
</div>
440
2891
<hr>
441
2892
<div class="refsect2">
442
2893
<a name="PANGO-ATTR-INDEX-FROM-TEXT-BEGINNING:CAPS"></a><h3>PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING</h3>
443
2894
<pre class="programlisting">#define PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING 0
444
2895
</pre>
445
 
<p>
446
 
This value can be used to set the start_index member of a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
 
2896
<p>This value can be used to set the start_index member of a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
447
2897
such that the attribute covers from the beginning of the text.</p>
448
2898
<p class="since">Since 1.24</p>
449
2899
</div>
452
2902
<a name="PANGO-ATTR-INDEX-TO-TEXT-END:CAPS"></a><h3>PANGO_ATTR_INDEX_TO_TEXT_END</h3>
453
2903
<pre class="programlisting">#define PANGO_ATTR_INDEX_TO_TEXT_END                G_MAXUINT
454
2904
</pre>
455
 
<p>
456
 
This value can be used to set the end_index member of a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
 
2905
<p>This value can be used to set the end_index member of a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
457
2906
such that the attribute covers to the end of the text.</p>
458
2907
<p class="since">Since 1.24</p>
459
2908
</div>
465
2914
  char *value;
466
2915
};
467
2916
</pre>
468
 
<p>
469
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString"><span class="type">PangoAttrString</span></a> structure is used to represent attributes with
 
2917
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString"><span class="type">PangoAttrString</span></a> structure is used to represent attributes with
470
2918
a string value.</p>
471
 
<div class="variablelist"><table border="0" class="variablelist">
 
2919
<div class="refsect3">
 
2920
<a name="id-1.2.5.10.7.5"></a><h4>Members</h4>
 
2921
<div class="informaltable"><table width="100%" border="0">
472
2922
<colgroup>
473
 
<col align="left" valign="top">
474
 
<col>
 
2923
<col width="300px" class="struct_members_name">
 
2924
<col class="struct_members_description">
 
2925
<col width="200px" class="struct_members_annotations">
475
2926
</colgroup>
476
2927
<tbody>
477
2928
<tr>
478
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrString.attr"></a>attr</code></em>;</span></p></td>
479
 
<td>the common portion of the attribute</td>
 
2929
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrString.attr"></a>attr</code></em>;</p></td>
 
2930
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
2931
<td class="struct_member_annotations"> </td>
480
2932
</tr>
481
2933
<tr>
482
 
<td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="PangoAttrString.value"></a>value</code></em>;</span></p></td>
483
 
<td>the string which is the value of the attribute</td>
 
2934
<td class="struct_member_name"><p><span class="type">char</span> *<em class="structfield"><code><a name="PangoAttrString.value"></a>value</code></em>;</p></td>
 
2935
<td class="struct_member_description"><p>the string which is the value of the attribute</p></td>
 
2936
<td class="struct_member_annotations"> </td>
484
2937
</tr>
485
2938
</tbody>
486
2939
</table></div>
487
2940
</div>
 
2941
</div>
488
2942
<hr>
489
2943
<div class="refsect2">
490
2944
<a name="PangoAttrLanguage"></a><h3>struct PangoAttrLanguage</h3>
493
2947
  PangoLanguage *value;
494
2948
};
495
2949
</pre>
496
 
<p>
497
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage"><span class="type">PangoAttrLanguage</span></a> structure is used to represent attributes that
 
2950
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage"><span class="type">PangoAttrLanguage</span></a> structure is used to represent attributes that
498
2951
are languages.</p>
499
 
<div class="variablelist"><table border="0" class="variablelist">
 
2952
<div class="refsect3">
 
2953
<a name="id-1.2.5.10.8.5"></a><h4>Members</h4>
 
2954
<div class="informaltable"><table width="100%" border="0">
500
2955
<colgroup>
501
 
<col align="left" valign="top">
502
 
<col>
 
2956
<col width="300px" class="struct_members_name">
 
2957
<col class="struct_members_description">
 
2958
<col width="200px" class="struct_members_annotations">
503
2959
</colgroup>
504
2960
<tbody>
505
2961
<tr>
506
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrLanguage.attr"></a>attr</code></em>;</span></p></td>
507
 
<td>the common portion of the attribute</td>
 
2962
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrLanguage.attr"></a>attr</code></em>;</p></td>
 
2963
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
2964
<td class="struct_member_annotations"> </td>
508
2965
</tr>
509
2966
<tr>
510
 
<td><p><span class="term"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *<em class="structfield"><code><a name="PangoAttrLanguage.value"></a>value</code></em>;</span></p></td>
511
 
<td>the <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> which is the value of the attribute</td>
 
2967
<td class="struct_member_name"><p><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *<em class="structfield"><code><a name="PangoAttrLanguage.value"></a>value</code></em>;</p></td>
 
2968
<td class="struct_member_description"><p>the <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> which is the value of the attribute</p></td>
 
2969
<td class="struct_member_annotations"> </td>
512
2970
</tr>
513
2971
</tbody>
514
2972
</table></div>
515
2973
</div>
 
2974
</div>
516
2975
<hr>
517
2976
<div class="refsect2">
518
2977
<a name="PangoAttrColor"></a><h3>struct PangoAttrColor</h3>
521
2980
  PangoColor color;
522
2981
};
523
2982
</pre>
524
 
<p>
525
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a> structure is used to represent attributes that
 
2983
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a> structure is used to represent attributes that
526
2984
are colors.</p>
527
 
<div class="variablelist"><table border="0" class="variablelist">
 
2985
<div class="refsect3">
 
2986
<a name="id-1.2.5.10.9.5"></a><h4>Members</h4>
 
2987
<div class="informaltable"><table width="100%" border="0">
528
2988
<colgroup>
529
 
<col align="left" valign="top">
530
 
<col>
 
2989
<col width="300px" class="struct_members_name">
 
2990
<col class="struct_members_description">
 
2991
<col width="200px" class="struct_members_annotations">
531
2992
</colgroup>
532
2993
<tbody>
533
2994
<tr>
534
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrColor.attr"></a>attr</code></em>;</span></p></td>
535
 
<td>the common portion of the attribute</td>
 
2995
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrColor.attr"></a>attr</code></em>;</p></td>
 
2996
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
2997
<td class="struct_member_annotations"> </td>
536
2998
</tr>
537
2999
<tr>
538
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> <em class="structfield"><code><a name="PangoAttrColor.color"></a>color</code></em>;</span></p></td>
539
 
<td>the <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> which is the value of the attribute</td>
 
3000
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> <em class="structfield"><code><a name="PangoAttrColor.color"></a>color</code></em>;</p></td>
 
3001
<td class="struct_member_description"><p>the <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> which is the value of the attribute</p></td>
 
3002
<td class="struct_member_annotations"> </td>
540
3003
</tr>
541
3004
</tbody>
542
3005
</table></div>
543
3006
</div>
 
3007
</div>
544
3008
<hr>
545
3009
<div class="refsect2">
546
3010
<a name="PangoAttrInt"></a><h3>struct PangoAttrInt</h3>
549
3013
  int value;
550
3014
};
551
3015
</pre>
552
 
<p>
553
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a> structure is used to represent attributes with
 
3016
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a> structure is used to represent attributes with
554
3017
an integer or enumeration value.</p>
555
 
<div class="variablelist"><table border="0" class="variablelist">
 
3018
<div class="refsect3">
 
3019
<a name="id-1.2.5.10.10.5"></a><h4>Members</h4>
 
3020
<div class="informaltable"><table width="100%" border="0">
556
3021
<colgroup>
557
 
<col align="left" valign="top">
558
 
<col>
 
3022
<col width="300px" class="struct_members_name">
 
3023
<col class="struct_members_description">
 
3024
<col width="200px" class="struct_members_annotations">
559
3025
</colgroup>
560
3026
<tbody>
561
3027
<tr>
562
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrInt.attr"></a>attr</code></em>;</span></p></td>
563
 
<td>the common portion of the attribute</td>
 
3028
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrInt.attr"></a>attr</code></em>;</p></td>
 
3029
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
3030
<td class="struct_member_annotations"> </td>
564
3031
</tr>
565
3032
<tr>
566
 
<td><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="PangoAttrInt.value"></a>value</code></em>;</span></p></td>
567
 
<td>the value of the attribute</td>
 
3033
<td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="PangoAttrInt.value"></a>value</code></em>;</p></td>
 
3034
<td class="struct_member_description"><p>the value of the attribute</p></td>
 
3035
<td class="struct_member_annotations"> </td>
568
3036
</tr>
569
3037
</tbody>
570
3038
</table></div>
571
3039
</div>
 
3040
</div>
572
3041
<hr>
573
3042
<div class="refsect2">
574
3043
<a name="PangoAttrFloat"></a><h3>struct PangoAttrFloat</h3>
577
3046
  double value;
578
3047
};
579
3048
</pre>
580
 
<p>
581
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat"><span class="type">PangoAttrFloat</span></a> structure is used to represent attributes with
 
3049
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat"><span class="type">PangoAttrFloat</span></a> structure is used to represent attributes with
582
3050
a float or double value.</p>
583
 
<div class="variablelist"><table border="0" class="variablelist">
 
3051
<div class="refsect3">
 
3052
<a name="id-1.2.5.10.11.5"></a><h4>Members</h4>
 
3053
<div class="informaltable"><table width="100%" border="0">
584
3054
<colgroup>
585
 
<col align="left" valign="top">
586
 
<col>
 
3055
<col width="300px" class="struct_members_name">
 
3056
<col class="struct_members_description">
 
3057
<col width="200px" class="struct_members_annotations">
587
3058
</colgroup>
588
3059
<tbody>
589
3060
<tr>
590
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrFloat.attr"></a>attr</code></em>;</span></p></td>
591
 
<td>the common portion of the attribute</td>
 
3061
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrFloat.attr"></a>attr</code></em>;</p></td>
 
3062
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
3063
<td class="struct_member_annotations"> </td>
592
3064
</tr>
593
3065
<tr>
594
 
<td><p><span class="term"><span class="type">double</span> <em class="structfield"><code><a name="PangoAttrFloat.value"></a>value</code></em>;</span></p></td>
595
 
<td>the value of the attribute</td>
 
3066
<td class="struct_member_name"><p><span class="type">double</span> <em class="structfield"><code><a name="PangoAttrFloat.value"></a>value</code></em>;</p></td>
 
3067
<td class="struct_member_description"><p>the value of the attribute</p></td>
 
3068
<td class="struct_member_annotations"> </td>
596
3069
</tr>
597
3070
</tbody>
598
3071
</table></div>
599
3072
</div>
 
3073
</div>
600
3074
<hr>
601
3075
<div class="refsect2">
602
3076
<a name="PangoAttrFontDesc"></a><h3>struct PangoAttrFontDesc</h3>
605
3079
  PangoFontDescription *desc;
606
3080
};
607
3081
</pre>
608
 
<p>
609
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc"><span class="type">PangoAttrFontDesc</span></a> structure is used to store an attribute that
 
3082
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc"><span class="type">PangoAttrFontDesc</span></a> structure is used to store an attribute that
610
3083
sets all aspects of the font description at once.</p>
611
 
<div class="variablelist"><table border="0" class="variablelist">
 
3084
<div class="refsect3">
 
3085
<a name="id-1.2.5.10.12.5"></a><h4>Members</h4>
 
3086
<div class="informaltable"><table width="100%" border="0">
612
3087
<colgroup>
613
 
<col align="left" valign="top">
614
 
<col>
 
3088
<col width="300px" class="struct_members_name">
 
3089
<col class="struct_members_description">
 
3090
<col width="200px" class="struct_members_annotations">
615
3091
</colgroup>
616
3092
<tbody>
617
3093
<tr>
618
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrFontDesc.attr"></a>attr</code></em>;</span></p></td>
619
 
<td>the common portion of the attribute</td>
 
3094
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrFontDesc.attr"></a>attr</code></em>;</p></td>
 
3095
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
3096
<td class="struct_member_annotations"> </td>
620
3097
</tr>
621
3098
<tr>
622
 
<td><p><span class="term"><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *<em class="structfield"><code><a name="PangoAttrFontDesc.desc"></a>desc</code></em>;</span></p></td>
623
 
<td>the font description which is the value of this attribute</td>
 
3099
<td class="struct_member_name"><p><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *<em class="structfield"><code><a name="PangoAttrFontDesc.desc"></a>desc</code></em>;</p></td>
 
3100
<td class="struct_member_description"><p>the font description which is the value of this attribute</p></td>
 
3101
<td class="struct_member_annotations"> </td>
624
3102
</tr>
625
3103
</tbody>
626
3104
</table></div>
627
3105
</div>
 
3106
</div>
628
3107
<hr>
629
3108
<div class="refsect2">
630
3109
<a name="PangoAttrShape"></a><h3>struct PangoAttrShape</h3>
638
3117
  GDestroyNotify        destroy_func;
639
3118
};
640
3119
</pre>
641
 
<p>
642
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape"><span class="type">PangoAttrShape</span></a> structure is used to represent attributes which
 
3120
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape"><span class="type">PangoAttrShape</span></a> structure is used to represent attributes which
643
3121
impose shape restrictions.</p>
644
 
<div class="variablelist"><table border="0" class="variablelist">
 
3122
<div class="refsect3">
 
3123
<a name="id-1.2.5.10.13.5"></a><h4>Members</h4>
 
3124
<div class="informaltable"><table width="100%" border="0">
645
3125
<colgroup>
646
 
<col align="left" valign="top">
647
 
<col>
 
3126
<col width="300px" class="struct_members_name">
 
3127
<col class="struct_members_description">
 
3128
<col width="200px" class="struct_members_annotations">
648
3129
</colgroup>
649
3130
<tbody>
650
3131
<tr>
651
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrShape.attr"></a>attr</code></em>;</span></p></td>
652
 
<td>the common portion of the attribute</td>
653
 
</tr>
654
 
<tr>
655
 
<td><p><span class="term"><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> <em class="structfield"><code><a name="PangoAttrShape.ink-rect"></a>ink_rect</code></em>;</span></p></td>
656
 
<td>the ink rectangle to restrict to</td>
657
 
</tr>
658
 
<tr>
659
 
<td><p><span class="term"><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> <em class="structfield"><code><a name="PangoAttrShape.logical-rect"></a>logical_rect</code></em>;</span></p></td>
660
 
<td>the logical rectangle to restrict to</td>
661
 
</tr>
662
 
<tr>
663
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="PangoAttrShape.data"></a>data</code></em>;</span></p></td>
664
 
<td>user data set (see <a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new-with-data" title="pango_attr_shape_new_with_data ()"><code class="function">pango_attr_shape_new_with_data()</code></a>)</td>
665
 
</tr>
666
 
<tr>
667
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttrDataCopyFunc" title="PangoAttrDataCopyFunc ()"><span class="type">PangoAttrDataCopyFunc</span></a> <em class="structfield"><code><a name="PangoAttrShape.copy-func"></a>copy_func</code></em>;</span></p></td>
668
 
<td>copy function for the user data</td>
669
 
</tr>
670
 
<tr>
671
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> <em class="structfield"><code><a name="PangoAttrShape.destroy-func"></a>destroy_func</code></em>;</span></p></td>
672
 
<td>destroy function for the user data</td>
 
3132
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrShape.attr"></a>attr</code></em>;</p></td>
 
3133
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
3134
<td class="struct_member_annotations"> </td>
 
3135
</tr>
 
3136
<tr>
 
3137
<td class="struct_member_name"><p><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> <em class="structfield"><code><a name="PangoAttrShape.ink-rect"></a>ink_rect</code></em>;</p></td>
 
3138
<td class="struct_member_description"><p>the ink rectangle to restrict to</p></td>
 
3139
<td class="struct_member_annotations"> </td>
 
3140
</tr>
 
3141
<tr>
 
3142
<td class="struct_member_name"><p><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> <em class="structfield"><code><a name="PangoAttrShape.logical-rect"></a>logical_rect</code></em>;</p></td>
 
3143
<td class="struct_member_description"><p>the logical rectangle to restrict to</p></td>
 
3144
<td class="struct_member_annotations"> </td>
 
3145
</tr>
 
3146
<tr>
 
3147
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="PangoAttrShape.data"></a>data</code></em>;</p></td>
 
3148
<td class="struct_member_description"><p>user data set (see <a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new-with-data" title="pango_attr_shape_new_with_data ()"><code class="function">pango_attr_shape_new_with_data()</code></a>)</p></td>
 
3149
<td class="struct_member_annotations"> </td>
 
3150
</tr>
 
3151
<tr>
 
3152
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttrDataCopyFunc" title="PangoAttrDataCopyFunc ()"><span class="type">PangoAttrDataCopyFunc</span></a> <em class="structfield"><code><a name="PangoAttrShape.copy-func"></a>copy_func</code></em>;</p></td>
 
3153
<td class="struct_member_description"><p>copy function for the user data</p></td>
 
3154
<td class="struct_member_annotations"> </td>
 
3155
</tr>
 
3156
<tr>
 
3157
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> <em class="structfield"><code><a name="PangoAttrShape.destroy-func"></a>destroy_func</code></em>;</p></td>
 
3158
<td class="struct_member_description"><p>destroy function for the user data</p></td>
 
3159
<td class="struct_member_annotations"> </td>
673
3160
</tr>
674
3161
</tbody>
675
3162
</table></div>
676
3163
</div>
 
3164
</div>
677
3165
<hr>
678
3166
<div class="refsect2">
679
3167
<a name="PangoAttrSize"></a><h3>struct PangoAttrSize</h3>
683
3171
  guint absolute : 1;
684
3172
};
685
3173
</pre>
686
 
<p>
687
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrSize" title="struct PangoAttrSize"><span class="type">PangoAttrSize</span></a> structure is used to represent attributes which
 
3174
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrSize" title="struct PangoAttrSize"><span class="type">PangoAttrSize</span></a> structure is used to represent attributes which
688
3175
set font size.</p>
689
 
<div class="variablelist"><table border="0" class="variablelist">
 
3176
<div class="refsect3">
 
3177
<a name="id-1.2.5.10.14.5"></a><h4>Members</h4>
 
3178
<div class="informaltable"><table width="100%" border="0">
690
3179
<colgroup>
691
 
<col align="left" valign="top">
692
 
<col>
 
3180
<col width="300px" class="struct_members_name">
 
3181
<col class="struct_members_description">
 
3182
<col width="200px" class="struct_members_annotations">
693
3183
</colgroup>
694
3184
<tbody>
695
3185
<tr>
696
 
<td><p><span class="term"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrSize.attr"></a>attr</code></em>;</span></p></td>
697
 
<td>the common portion of the attribute</td>
698
 
</tr>
699
 
<tr>
700
 
<td><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="PangoAttrSize.size"></a>size</code></em>;</span></p></td>
701
 
<td>size of font, in units of 1/<a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> of a point (for
702
 
<a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-SIZE:CAPS"><code class="literal">PANGO_ATTR_SIZE</code></a>) or of a device uni (for <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-ABSOLUTE-SIZE:CAPS"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></a>)</td>
703
 
</tr>
704
 
<tr>
705
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="PangoAttrSize.absolute"></a>absolute</code></em> : 1;</span></p></td>
706
 
<td>whether the font size is in device units or points.
 
3186
<td class="struct_member_name"><p><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> <em class="structfield"><code><a name="PangoAttrSize.attr"></a>attr</code></em>;</p></td>
 
3187
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
 
3188
<td class="struct_member_annotations"> </td>
 
3189
</tr>
 
3190
<tr>
 
3191
<td class="struct_member_name"><p><span class="type">int</span> <em class="structfield"><code><a name="PangoAttrSize.size"></a>size</code></em>;</p></td>
 
3192
<td class="struct_member_description"><p>size of font, in units of 1/<a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a> of a point (for
 
3193
<a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-SIZE:CAPS"><code class="literal">PANGO_ATTR_SIZE</code></a>) or of a device uni (for <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-ABSOLUTE-SIZE:CAPS"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></a>)</p></td>
 
3194
<td class="struct_member_annotations"> </td>
 
3195
</tr>
 
3196
<tr>
 
3197
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="PangoAttrSize.absolute"></a>absolute</code></em> : 1;</p></td>
 
3198
<td class="struct_member_description"><p>whether the font size is in device units or points.
707
3199
This field is only present for compatibility with Pango-1.8.0
708
3200
(<a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-ABSOLUTE-SIZE:CAPS"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></a> was added in 1.8.1); and always will
709
 
be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-SIZE:CAPS"><code class="literal">PANGO_ATTR_SIZE</code></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-ABSOLUTE-SIZE:CAPS"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></a>.</td>
710
 
</tr>
711
 
</tbody>
712
 
</table></div>
713
 
</div>
714
 
<hr>
715
 
<div class="refsect2">
716
 
<a name="pango-parse-markup"></a><h3>pango_parse_markup ()</h3>
717
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_parse_markup                  (<em class="parameter"><code>const <span class="type">char</span> *markup_text</code></em>,
718
 
                                                         <em class="parameter"><code><span class="type">int</span> length</code></em>,
719
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> accel_marker</code></em>,
720
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
721
 
                                                         <em class="parameter"><code><span class="type">char</span> **text</code></em>,
722
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> *accel_char</code></em>,
723
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
724
 
<p>
725
 
Parses marked-up text (see
726
 
<a href="PangoMarkupFormat.html">markup format</a>) to create
727
 
a plain-text string and an attribute list.</p>
728
 
<p>
729
 
If <em class="parameter"><code>accel_marker</code></em> is nonzero, the given character will mark the
730
 
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>
731
 
might be an ampersand or underscore. All characters marked
732
 
as an accelerator will receive a <a class="link" href="pango-Text-Attributes.html#PANGO-UNDERLINE-LOW:CAPS"><code class="literal">PANGO_UNDERLINE_LOW</code></a> attribute,
733
 
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>.
734
 
Two <em class="parameter"><code>accel_marker</code></em> characters following each other produce a single
735
 
literal <em class="parameter"><code>accel_marker</code></em> character.</p>
736
 
<p>
737
 
To parse a stream of pango markup incrementally, use <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-new" title="pango_markup_parser_new ()"><code class="function">pango_markup_parser_new()</code></a>.</p>
738
 
<p>
739
 
If any error happens, none of the output arguments are touched except
740
 
for <em class="parameter"><code>error</code></em>.</p>
741
 
<div class="variablelist"><table border="0" class="variablelist">
742
 
<colgroup>
743
 
<col align="left" valign="top">
744
 
<col>
745
 
</colgroup>
746
 
<tbody>
747
 
<tr>
748
 
<td><p><span class="term"><em class="parameter"><code>markup_text</code></em> :</span></p></td>
749
 
<td>markup to parse (see <a href="PangoMarkupFormat.html">markup format</a>)</td>
750
 
</tr>
751
 
<tr>
752
 
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
753
 
<td>length of <em class="parameter"><code>markup_text</code></em>, or -1 if nul-terminated</td>
754
 
</tr>
755
 
<tr>
756
 
<td><p><span class="term"><em class="parameter"><code>accel_marker</code></em> :</span></p></td>
757
 
<td>character that precedes an accelerator, or 0 for none</td>
758
 
</tr>
759
 
<tr>
760
 
<td><p><span class="term"><em class="parameter"><code>attr_list</code></em> :</span></p></td>
761
 
<td>address of return location for a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
762
 
</td>
763
 
</tr>
764
 
<tr>
765
 
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
766
 
<td>address of return location for text with tags stripped, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
767
 
</td>
768
 
</tr>
769
 
<tr>
770
 
<td><p><span class="term"><em class="parameter"><code>accel_char</code></em> :</span></p></td>
771
 
<td>address of return location for accelerator char, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
772
 
</td>
773
 
</tr>
774
 
<tr>
775
 
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
776
 
<td>address of return location for errors, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
777
 
</td>
778
 
</tr>
779
 
<tr>
780
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
781
 
<td>
782
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em> is set, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
783
 
</td>
784
 
</tr>
785
 
</tbody>
786
 
</table></div>
787
 
</div>
788
 
<hr>
789
 
<div class="refsect2">
790
 
<a name="pango-markup-parser-new"></a><h3>pango_markup_parser_new ()</h3>
791
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="returnvalue">GMarkupParseContext</span></a> * pango_markup_parser_new           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> accel_marker</code></em>);</pre>
792
 
<p>
793
 
Parses marked-up text (see
794
 
<a href="PangoMarkupFormat.html">markup format</a>) to create
795
 
a plain-text string and an attribute list.</p>
796
 
<p>
797
 
If <em class="parameter"><code>accel_marker</code></em> is nonzero, the given character will mark the
798
 
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>
799
 
might be an ampersand or underscore. All characters marked
800
 
as an accelerator will receive a <a class="link" href="pango-Text-Attributes.html#PANGO-UNDERLINE-LOW:CAPS"><code class="literal">PANGO_UNDERLINE_LOW</code></a> attribute,
801
 
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>,
802
 
when calling <code class="function">finish()</code>. Two <em class="parameter"><code>accel_marker</code></em> characters following each
803
 
other produce a single literal <em class="parameter"><code>accel_marker</code></em> character.</p>
804
 
<p>
805
 
To feed markup to the parser, use <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-parse"><code class="function">g_markup_parse_context_parse()</code></a>
806
 
on the returned <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a>. When done with feeding markup
807
 
to the parser, use <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-finish" title="pango_markup_parser_finish ()"><code class="function">pango_markup_parser_finish()</code></a> to get the data out
808
 
of it, and then use <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-free"><code class="function">g_markup_parse_context_free()</code></a> to free it.</p>
809
 
<p>
810
 
This function is designed for applications that read pango markup
811
 
from streams. To simply parse a string containing pango markup,
812
 
the simpler <a class="link" href="pango-Text-Attributes.html#pango-parse-markup" title="pango_parse_markup ()"><code class="function">pango_parse_markup()</code></a> API is recommended instead.</p>
813
 
<div class="variablelist"><table border="0" class="variablelist">
814
 
<colgroup>
815
 
<col align="left" valign="top">
816
 
<col>
817
 
</colgroup>
818
 
<tbody>
819
 
<tr>
820
 
<td><p><span class="term"><em class="parameter"><code>accel_marker</code></em> :</span></p></td>
821
 
<td>character that precedes an accelerator, or 0 for none</td>
822
 
</tr>
823
 
<tr>
824
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
825
 
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a> that should be
826
 
destroyed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-free"><code class="function">g_markup_parse_context_free()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
827
 
</td>
828
 
</tr>
829
 
</tbody>
830
 
</table></div>
831
 
<p class="since">Since 1.31.0</p>
832
 
</div>
833
 
<hr>
834
 
<div class="refsect2">
835
 
<a name="pango-markup-parser-finish"></a><h3>pango_markup_parser_finish ()</h3>
836
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_markup_parser_finish          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a> *context</code></em>,
837
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
838
 
                                                         <em class="parameter"><code><span class="type">char</span> **text</code></em>,
839
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> *accel_char</code></em>,
840
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
841
 
<p>
842
 
After feeding a pango markup parser some data with <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-parse"><code class="function">g_markup_parse_context_parse()</code></a>,
843
 
use this function to get the list of pango attributes and text out of the
844
 
markup. This function will not free <em class="parameter"><code>context</code></em>, use <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-free"><code class="function">g_markup_parse_context_free()</code></a>
845
 
to do so.</p>
846
 
<div class="variablelist"><table border="0" class="variablelist">
847
 
<colgroup>
848
 
<col align="left" valign="top">
849
 
<col>
850
 
</colgroup>
851
 
<tbody>
852
 
<tr>
853
 
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
854
 
<td>A valid parse context that was returned from <a class="link" href="pango-Text-Attributes.html#pango-markup-parser-new" title="pango_markup_parser_new ()"><code class="function">pango_markup_parser_new()</code></a>
855
 
</td>
856
 
</tr>
857
 
<tr>
858
 
<td><p><span class="term"><em class="parameter"><code>attr_list</code></em> :</span></p></td>
859
 
<td>address of return location for a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
860
 
</td>
861
 
</tr>
862
 
<tr>
863
 
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
864
 
<td>address of return location for text with tags stripped, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
865
 
</td>
866
 
</tr>
867
 
<tr>
868
 
<td><p><span class="term"><em class="parameter"><code>accel_char</code></em> :</span></p></td>
869
 
<td>address of return location for accelerator char, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
870
 
</td>
871
 
</tr>
872
 
<tr>
873
 
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
874
 
<td>address of return location for errors, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
875
 
</td>
876
 
</tr>
877
 
<tr>
878
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
879
 
<td>
880
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em> is set, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
881
 
</td>
882
 
</tr>
883
 
</tbody>
884
 
</table></div>
885
 
<p class="since">Since 1.31.0</p>
886
 
</div>
887
 
<hr>
888
 
<div class="refsect2">
889
 
<a name="pango-attr-type-register"></a><h3>pango_attr_type_register ()</h3>
890
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="returnvalue">PangoAttrType</span></a>       pango_attr_type_register            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
891
 
<p>
892
 
Allocate a new attribute type ID.  The attribute type name can be accessed
893
 
later by using <a class="link" href="pango-Text-Attributes.html#pango-attr-type-get-name" title="pango_attr_type_get_name ()"><code class="function">pango_attr_type_get_name()</code></a>.</p>
894
 
<div class="variablelist"><table border="0" class="variablelist">
895
 
<colgroup>
896
 
<col align="left" valign="top">
897
 
<col>
898
 
</colgroup>
899
 
<tbody>
900
 
<tr>
901
 
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
902
 
<td>an identifier for the type</td>
903
 
</tr>
904
 
<tr>
905
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
906
 
<td>the new type ID.</td>
907
 
</tr>
908
 
</tbody>
909
 
</table></div>
910
 
</div>
911
 
<hr>
912
 
<div class="refsect2">
913
 
<a name="pango-attr-type-get-name"></a><h3>pango_attr_type_get_name ()</h3>
914
 
<pre class="programlisting">const <span class="returnvalue">char</span> *        pango_attr_type_get_name            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="type">PangoAttrType</span></a> type</code></em>);</pre>
915
 
<p>
916
 
Fetches the attribute type name passed in when registering the type using
917
 
<a class="link" href="pango-Text-Attributes.html#pango-attr-type-register" title="pango_attr_type_register ()"><code class="function">pango_attr_type_register()</code></a>.</p>
918
 
<p>
919
 
The returned value is an interned string (see <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-intern-string"><code class="function">g_intern_string()</code></a> for what
920
 
that means) that should not be modified or freed.</p>
921
 
<div class="variablelist"><table border="0" class="variablelist">
922
 
<colgroup>
923
 
<col align="left" valign="top">
924
 
<col>
925
 
</colgroup>
926
 
<tbody>
927
 
<tr>
928
 
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
929
 
<td>an attribute type ID to fetch the name for</td>
930
 
</tr>
931
 
<tr>
932
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
933
 
<td>the type ID name (which may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>type</code></em> is
934
 
a built-in Pango attribute type or invalid.</td>
935
 
</tr>
936
 
</tbody>
937
 
</table></div>
938
 
<p class="since">Since 1.22</p>
939
 
</div>
940
 
<hr>
941
 
<div class="refsect2">
942
 
<a name="pango-attribute-init"></a><h3>pango_attribute_init ()</h3>
943
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attribute_init                (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>,
944
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a> *klass</code></em>);</pre>
945
 
<p>
946
 
Initializes <em class="parameter"><code>attr</code></em>'s klass to <em class="parameter"><code>klass</code></em>,
947
 
it's start_index to <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-FROM-TEXT-BEGINNING:CAPS" title="PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING"><code class="literal">PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING</code></a>
948
 
and end_index to <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-INDEX-TO-TEXT-END:CAPS" title="PANGO_ATTR_INDEX_TO_TEXT_END"><code class="literal">PANGO_ATTR_INDEX_TO_TEXT_END</code></a>
949
 
such that the attribute applies
950
 
to the entire text by default.</p>
951
 
<div class="variablelist"><table border="0" class="variablelist">
952
 
<colgroup>
953
 
<col align="left" valign="top">
954
 
<col>
955
 
</colgroup>
956
 
<tbody>
957
 
<tr>
958
 
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
959
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
960
 
</td>
961
 
</tr>
962
 
<tr>
963
 
<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
964
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass"><span class="type">PangoAttrClass</span></a>
965
 
</td>
966
 
</tr>
967
 
</tbody>
968
 
</table></div>
969
 
<p class="since">Since 1.20</p>
970
 
</div>
971
 
<hr>
972
 
<div class="refsect2">
973
 
<a name="pango-attribute-copy"></a><h3>pango_attribute_copy ()</h3>
974
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attribute_copy                (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
975
 
<p>
976
 
Make a copy of an attribute.</p>
977
 
<div class="variablelist"><table border="0" class="variablelist">
978
 
<colgroup>
979
 
<col align="left" valign="top">
980
 
<col>
981
 
</colgroup>
982
 
<tbody>
983
 
<tr>
984
 
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
985
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
986
 
</td>
987
 
</tr>
988
 
<tr>
989
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
990
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
991
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
992
 
</td>
993
 
</tr>
994
 
</tbody>
995
 
</table></div>
996
 
</div>
997
 
<hr>
998
 
<div class="refsect2">
999
 
<a name="pango-attribute-equal"></a><h3>pango_attribute_equal ()</h3>
1000
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_attribute_equal               (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr1</code></em>,
1001
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr2</code></em>);</pre>
1002
 
<p>
1003
 
Compare two attributes for equality. This compares only the
1004
 
actual value of the two attributes and not the ranges that the
1005
 
attributes apply to.</p>
1006
 
<div class="variablelist"><table border="0" class="variablelist">
1007
 
<colgroup>
1008
 
<col align="left" valign="top">
1009
 
<col>
1010
 
</colgroup>
1011
 
<tbody>
1012
 
<tr>
1013
 
<td><p><span class="term"><em class="parameter"><code>attr1</code></em> :</span></p></td>
1014
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
1015
 
</td>
1016
 
</tr>
1017
 
<tr>
1018
 
<td><p><span class="term"><em class="parameter"><code>attr2</code></em> :</span></p></td>
1019
 
<td>another <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>
1020
 
</td>
1021
 
</tr>
1022
 
<tr>
1023
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1024
 
<td>
1025
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the two attributes have the same value.</td>
1026
 
</tr>
1027
 
</tbody>
1028
 
</table></div>
1029
 
</div>
1030
 
<hr>
1031
 
<div class="refsect2">
1032
 
<a name="pango-attribute-destroy"></a><h3>pango_attribute_destroy ()</h3>
1033
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attribute_destroy             (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
1034
 
<p>
1035
 
Destroy a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> and free all associated memory.</p>
1036
 
<div class="variablelist"><table border="0" class="variablelist">
1037
 
<colgroup>
1038
 
<col align="left" valign="top">
1039
 
<col>
1040
 
</colgroup>
1041
 
<tbody><tr>
1042
 
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
1043
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>.</td>
1044
 
</tr></tbody>
1045
 
</table></div>
1046
 
</div>
1047
 
<hr>
1048
 
<div class="refsect2">
1049
 
<a name="pango-attr-language-new"></a><h3>pango_attr_language_new ()</h3>
1050
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_language_new             (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>
1051
 
<p>
1052
 
Create a new language tag attribute.</p>
1053
 
<div class="variablelist"><table border="0" class="variablelist">
1054
 
<colgroup>
1055
 
<col align="left" valign="top">
1056
 
<col>
1057
 
</colgroup>
1058
 
<tbody>
1059
 
<tr>
1060
 
<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
1061
 
<td>language tag</td>
1062
 
</tr>
1063
 
<tr>
1064
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1065
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1066
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1067
 
</td>
1068
 
</tr>
1069
 
</tbody>
1070
 
</table></div>
1071
 
</div>
1072
 
<hr>
1073
 
<div class="refsect2">
1074
 
<a name="pango-attr-family-new"></a><h3>pango_attr_family_new ()</h3>
1075
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_family_new               (<em class="parameter"><code>const <span class="type">char</span> *family</code></em>);</pre>
1076
 
<p>
1077
 
Create a new font family attribute.</p>
1078
 
<div class="variablelist"><table border="0" class="variablelist">
1079
 
<colgroup>
1080
 
<col align="left" valign="top">
1081
 
<col>
1082
 
</colgroup>
1083
 
<tbody>
1084
 
<tr>
1085
 
<td><p><span class="term"><em class="parameter"><code>family</code></em> :</span></p></td>
1086
 
<td>the family or comma separated list of families</td>
1087
 
</tr>
1088
 
<tr>
1089
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1090
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1091
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1092
 
</td>
1093
 
</tr>
1094
 
</tbody>
1095
 
</table></div>
1096
 
</div>
1097
 
<hr>
1098
 
<div class="refsect2">
1099
 
<a name="pango-attr-style-new"></a><h3>pango_attr_style_new ()</h3>
1100
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_style_new                (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a> style</code></em>);</pre>
1101
 
<p>
1102
 
Create a new font slant style attribute.</p>
1103
 
<div class="variablelist"><table border="0" class="variablelist">
1104
 
<colgroup>
1105
 
<col align="left" valign="top">
1106
 
<col>
1107
 
</colgroup>
1108
 
<tbody>
1109
 
<tr>
1110
 
<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
1111
 
<td>the slant style</td>
1112
 
</tr>
1113
 
<tr>
1114
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1115
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1116
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1117
 
</td>
1118
 
</tr>
1119
 
</tbody>
1120
 
</table></div>
1121
 
</div>
1122
 
<hr>
1123
 
<div class="refsect2">
1124
 
<a name="pango-attr-variant-new"></a><h3>pango_attr_variant_new ()</h3>
1125
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_variant_new              (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a> variant</code></em>);</pre>
1126
 
<p>
1127
 
Create a new font variant attribute (normal or small caps)</p>
1128
 
<div class="variablelist"><table border="0" class="variablelist">
1129
 
<colgroup>
1130
 
<col align="left" valign="top">
1131
 
<col>
1132
 
</colgroup>
1133
 
<tbody>
1134
 
<tr>
1135
 
<td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>
1136
 
<td>the variant</td>
1137
 
</tr>
1138
 
<tr>
1139
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1140
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1141
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1142
 
</td>
1143
 
</tr>
1144
 
</tbody>
1145
 
</table></div>
1146
 
</div>
1147
 
<hr>
1148
 
<div class="refsect2">
1149
 
<a name="pango-attr-stretch-new"></a><h3>pango_attr_stretch_new ()</h3>
1150
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_stretch_new              (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch"><span class="type">PangoStretch</span></a> stretch</code></em>);</pre>
1151
 
<p>
1152
 
Create a new font stretch attribute</p>
1153
 
<div class="variablelist"><table border="0" class="variablelist">
1154
 
<colgroup>
1155
 
<col align="left" valign="top">
1156
 
<col>
1157
 
</colgroup>
1158
 
<tbody>
1159
 
<tr>
1160
 
<td><p><span class="term"><em class="parameter"><code>stretch</code></em> :</span></p></td>
1161
 
<td>the stretch</td>
1162
 
</tr>
1163
 
<tr>
1164
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1165
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1166
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1167
 
</td>
1168
 
</tr>
1169
 
</tbody>
1170
 
</table></div>
1171
 
</div>
1172
 
<hr>
1173
 
<div class="refsect2">
1174
 
<a name="pango-attr-weight-new"></a><h3>pango_attr_weight_new ()</h3>
1175
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_weight_new               (<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight"><span class="type">PangoWeight</span></a> weight</code></em>);</pre>
1176
 
<p>
1177
 
Create a new font weight attribute.</p>
1178
 
<div class="variablelist"><table border="0" class="variablelist">
1179
 
<colgroup>
1180
 
<col align="left" valign="top">
1181
 
<col>
1182
 
</colgroup>
1183
 
<tbody>
1184
 
<tr>
1185
 
<td><p><span class="term"><em class="parameter"><code>weight</code></em> :</span></p></td>
1186
 
<td>the weight</td>
1187
 
</tr>
1188
 
<tr>
1189
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1190
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1191
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1192
 
</td>
1193
 
</tr>
1194
 
</tbody>
1195
 
</table></div>
1196
 
</div>
1197
 
<hr>
1198
 
<div class="refsect2">
1199
 
<a name="pango-attr-size-new"></a><h3>pango_attr_size_new ()</h3>
1200
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_size_new                 (<em class="parameter"><code><span class="type">int</span> size</code></em>);</pre>
1201
 
<p>
1202
 
Create a new font-size attribute in fractional points.</p>
1203
 
<div class="variablelist"><table border="0" class="variablelist">
1204
 
<colgroup>
1205
 
<col align="left" valign="top">
1206
 
<col>
1207
 
</colgroup>
1208
 
<tbody>
1209
 
<tr>
1210
 
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
1211
 
<td>the font size, in <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a>ths of a point.</td>
1212
 
</tr>
1213
 
<tr>
1214
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1215
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1216
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1217
 
</td>
1218
 
</tr>
1219
 
</tbody>
1220
 
</table></div>
1221
 
</div>
1222
 
<hr>
1223
 
<div class="refsect2">
1224
 
<a name="pango-attr-size-new-absolute"></a><h3>pango_attr_size_new_absolute ()</h3>
1225
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_size_new_absolute        (<em class="parameter"><code><span class="type">int</span> size</code></em>);</pre>
1226
 
<p>
1227
 
Create a new font-size attribute in device units.</p>
1228
 
<div class="variablelist"><table border="0" class="variablelist">
1229
 
<colgroup>
1230
 
<col align="left" valign="top">
1231
 
<col>
1232
 
</colgroup>
1233
 
<tbody>
1234
 
<tr>
1235
 
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
1236
 
<td>the font size, in <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a>ths of a device unit.</td>
1237
 
</tr>
1238
 
<tr>
1239
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1240
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>, which should be
1241
 
freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>.</td>
1242
 
</tr>
1243
 
</tbody>
1244
 
</table></div>
1245
 
<p class="since">Since 1.8</p>
1246
 
</div>
1247
 
<hr>
1248
 
<div class="refsect2">
1249
 
<a name="pango-attr-font-desc-new"></a><h3>pango_attr_font_desc_new ()</h3>
1250
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_font_desc_new            (<em class="parameter"><code>const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>);</pre>
1251
 
<p>
1252
 
Create a new font description attribute. This attribute
1253
 
allows setting family, style, weight, variant, stretch,
1254
 
and size simultaneously.</p>
1255
 
<div class="variablelist"><table border="0" class="variablelist">
1256
 
<colgroup>
1257
 
<col align="left" valign="top">
1258
 
<col>
1259
 
</colgroup>
1260
 
<tbody>
1261
 
<tr>
1262
 
<td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
1263
 
<td>the font description</td>
1264
 
</tr>
1265
 
<tr>
1266
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1267
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1268
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1269
 
</td>
1270
 
</tr>
1271
 
</tbody>
1272
 
</table></div>
1273
 
</div>
1274
 
<hr>
1275
 
<div class="refsect2">
1276
 
<a name="pango-attr-foreground-new"></a><h3>pango_attr_foreground_new ()</h3>
1277
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_foreground_new           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
1278
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
1279
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
1280
 
<p>
1281
 
Create a new foreground color attribute.</p>
1282
 
<div class="variablelist"><table border="0" class="variablelist">
1283
 
<colgroup>
1284
 
<col align="left" valign="top">
1285
 
<col>
1286
 
</colgroup>
1287
 
<tbody>
1288
 
<tr>
1289
 
<td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
1290
 
<td>the red value (ranging from 0 to 65535)</td>
1291
 
</tr>
1292
 
<tr>
1293
 
<td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
1294
 
<td>the green value</td>
1295
 
</tr>
1296
 
<tr>
1297
 
<td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
1298
 
<td>the blue value</td>
1299
 
</tr>
1300
 
<tr>
1301
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1302
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1303
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1304
 
</td>
1305
 
</tr>
1306
 
</tbody>
1307
 
</table></div>
1308
 
</div>
1309
 
<hr>
1310
 
<div class="refsect2">
1311
 
<a name="pango-attr-background-new"></a><h3>pango_attr_background_new ()</h3>
1312
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_background_new           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
1313
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
1314
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
1315
 
<p>
1316
 
Create a new background color attribute.</p>
1317
 
<div class="variablelist"><table border="0" class="variablelist">
1318
 
<colgroup>
1319
 
<col align="left" valign="top">
1320
 
<col>
1321
 
</colgroup>
1322
 
<tbody>
1323
 
<tr>
1324
 
<td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
1325
 
<td>the red value (ranging from 0 to 65535)</td>
1326
 
</tr>
1327
 
<tr>
1328
 
<td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
1329
 
<td>the green value</td>
1330
 
</tr>
1331
 
<tr>
1332
 
<td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
1333
 
<td>the blue value</td>
1334
 
</tr>
1335
 
<tr>
1336
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1337
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1338
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1339
 
</td>
1340
 
</tr>
1341
 
</tbody>
1342
 
</table></div>
1343
 
</div>
1344
 
<hr>
1345
 
<div class="refsect2">
1346
 
<a name="pango-attr-strikethrough-new"></a><h3>pango_attr_strikethrough_new ()</h3>
1347
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_strikethrough_new        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> strikethrough</code></em>);</pre>
1348
 
<p>
1349
 
Create a new strike-through attribute.</p>
1350
 
<div class="variablelist"><table border="0" class="variablelist">
1351
 
<colgroup>
1352
 
<col align="left" valign="top">
1353
 
<col>
1354
 
</colgroup>
1355
 
<tbody>
1356
 
<tr>
1357
 
<td><p><span class="term"><em class="parameter"><code>strikethrough</code></em> :</span></p></td>
1358
 
<td>
1359
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the text should be struck-through.</td>
1360
 
</tr>
1361
 
<tr>
1362
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1363
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1364
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1365
 
</td>
1366
 
</tr>
1367
 
</tbody>
1368
 
</table></div>
1369
 
</div>
1370
 
<hr>
1371
 
<div class="refsect2">
1372
 
<a name="pango-attr-strikethrough-color-new"></a><h3>pango_attr_strikethrough_color_new ()</h3>
1373
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_strikethrough_color_new  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
1374
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
1375
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
1376
 
<p>
1377
 
Create a new strikethrough color attribute. This attribute
1378
 
modifies the color of strikethrough lines. If not set, strikethrough
1379
 
lines will use the foreground color.</p>
1380
 
<div class="variablelist"><table border="0" class="variablelist">
1381
 
<colgroup>
1382
 
<col align="left" valign="top">
1383
 
<col>
1384
 
</colgroup>
1385
 
<tbody>
1386
 
<tr>
1387
 
<td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
1388
 
<td>the red value (ranging from 0 to 65535)</td>
1389
 
</tr>
1390
 
<tr>
1391
 
<td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
1392
 
<td>the green value</td>
1393
 
</tr>
1394
 
<tr>
1395
 
<td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
1396
 
<td>the blue value</td>
1397
 
</tr>
1398
 
<tr>
1399
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1400
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1401
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1402
 
</td>
1403
 
</tr>
1404
 
</tbody>
1405
 
</table></div>
1406
 
<p class="since">Since 1.8</p>
1407
 
</div>
1408
 
<hr>
1409
 
<div class="refsect2">
1410
 
<a name="pango-attr-underline-new"></a><h3>pango_attr_underline_new ()</h3>
1411
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_underline_new            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoUnderline"><span class="type">PangoUnderline</span></a> underline</code></em>);</pre>
1412
 
<p>
1413
 
Create a new underline-style attribute.</p>
1414
 
<div class="variablelist"><table border="0" class="variablelist">
1415
 
<colgroup>
1416
 
<col align="left" valign="top">
1417
 
<col>
1418
 
</colgroup>
1419
 
<tbody>
1420
 
<tr>
1421
 
<td><p><span class="term"><em class="parameter"><code>underline</code></em> :</span></p></td>
1422
 
<td>the underline style.</td>
1423
 
</tr>
1424
 
<tr>
1425
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1426
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1427
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1428
 
</td>
1429
 
</tr>
1430
 
</tbody>
1431
 
</table></div>
1432
 
</div>
1433
 
<hr>
1434
 
<div class="refsect2">
1435
 
<a name="pango-attr-underline-color-new"></a><h3>pango_attr_underline_color_new ()</h3>
1436
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_underline_color_new      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> red</code></em>,
1437
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> green</code></em>,
1438
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> blue</code></em>);</pre>
1439
 
<p>
1440
 
Create a new underline color attribute. This attribute
1441
 
modifies the color of underlines. If not set, underlines
1442
 
will use the foreground color.</p>
1443
 
<div class="variablelist"><table border="0" class="variablelist">
1444
 
<colgroup>
1445
 
<col align="left" valign="top">
1446
 
<col>
1447
 
</colgroup>
1448
 
<tbody>
1449
 
<tr>
1450
 
<td><p><span class="term"><em class="parameter"><code>red</code></em> :</span></p></td>
1451
 
<td>the red value (ranging from 0 to 65535)</td>
1452
 
</tr>
1453
 
<tr>
1454
 
<td><p><span class="term"><em class="parameter"><code>green</code></em> :</span></p></td>
1455
 
<td>the green value</td>
1456
 
</tr>
1457
 
<tr>
1458
 
<td><p><span class="term"><em class="parameter"><code>blue</code></em> :</span></p></td>
1459
 
<td>the blue value</td>
1460
 
</tr>
1461
 
<tr>
1462
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1463
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1464
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1465
 
</td>
1466
 
</tr>
1467
 
</tbody>
1468
 
</table></div>
1469
 
<p class="since">Since 1.8</p>
1470
 
</div>
1471
 
<hr>
1472
 
<div class="refsect2">
1473
 
<a name="PangoUnderline-enum"></a><h3>enum PangoUnderline</h3>
1474
 
<pre class="programlisting">typedef enum {
1475
 
  PANGO_UNDERLINE_NONE,
1476
 
  PANGO_UNDERLINE_SINGLE,
1477
 
  PANGO_UNDERLINE_DOUBLE,
1478
 
  PANGO_UNDERLINE_LOW,
1479
 
  PANGO_UNDERLINE_ERROR
1480
 
} PangoUnderline;
1481
 
</pre>
1482
 
<p>
1483
 
The <a class="link" href="pango-Text-Attributes.html#PangoUnderline"><span class="type">PangoUnderline</span></a> enumeration is used to specify
 
3201
be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-SIZE:CAPS"><code class="literal">PANGO_ATTR_SIZE</code></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-ABSOLUTE-SIZE:CAPS"><code class="literal">PANGO_ATTR_ABSOLUTE_SIZE</code></a>.</p></td>
 
3202
<td class="struct_member_annotations"> </td>
 
3203
</tr>
 
3204
</tbody>
 
3205
</table></div>
 
3206
</div>
 
3207
</div>
 
3208
<hr>
 
3209
<div class="refsect2">
 
3210
<a name="PangoUnderline"></a><h3>enum PangoUnderline</h3>
 
3211
<p>The <a class="link" href="pango-Text-Attributes.html#PangoUnderline" title="enum PangoUnderline"><span class="type">PangoUnderline</span></a> enumeration is used to specify
1484
3212
whether text should be underlined, and if so, the type
1485
3213
of underlining.</p>
1486
 
<div class="variablelist"><table border="0" class="variablelist">
 
3214
<div class="refsect3">
 
3215
<a name="id-1.2.5.10.15.4"></a><h4>Members</h4>
 
3216
<div class="informaltable"><table width="100%" border="0">
1487
3217
<colgroup>
1488
 
<col align="left" valign="top">
1489
 
<col>
 
3218
<col width="300px" class="enum_members_name">
 
3219
<col class="enum_members_description">
 
3220
<col width="200px" class="enum_members_annotations">
1490
3221
</colgroup>
1491
3222
<tbody>
1492
3223
<tr>
1493
 
<td><p><a name="PANGO-UNDERLINE-NONE:CAPS"></a><span class="term"><code class="literal">PANGO_UNDERLINE_NONE</code></span></p></td>
1494
 
<td>no underline should be drawn
1495
 
</td>
1496
 
</tr>
1497
 
<tr>
1498
 
<td><p><a name="PANGO-UNDERLINE-SINGLE:CAPS"></a><span class="term"><code class="literal">PANGO_UNDERLINE_SINGLE</code></span></p></td>
1499
 
<td>a single underline should be drawn
1500
 
</td>
1501
 
</tr>
1502
 
<tr>
1503
 
<td><p><a name="PANGO-UNDERLINE-DOUBLE:CAPS"></a><span class="term"><code class="literal">PANGO_UNDERLINE_DOUBLE</code></span></p></td>
1504
 
<td>a double underline should be drawn
1505
 
</td>
1506
 
</tr>
1507
 
<tr>
1508
 
<td><p><a name="PANGO-UNDERLINE-LOW:CAPS"></a><span class="term"><code class="literal">PANGO_UNDERLINE_LOW</code></span></p></td>
1509
 
<td>a single underline should be drawn at a position
 
3224
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-NONE:CAPS"></a>PANGO_UNDERLINE_NONE</p></td>
 
3225
<td class="enum_member_description">
 
3226
<p>no underline should be drawn</p>
 
3227
</td>
 
3228
<td class="enum_member_annotations"> </td>
 
3229
</tr>
 
3230
<tr>
 
3231
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-SINGLE:CAPS"></a>PANGO_UNDERLINE_SINGLE</p></td>
 
3232
<td class="enum_member_description">
 
3233
<p>a single underline should be drawn</p>
 
3234
</td>
 
3235
<td class="enum_member_annotations"> </td>
 
3236
</tr>
 
3237
<tr>
 
3238
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-DOUBLE:CAPS"></a>PANGO_UNDERLINE_DOUBLE</p></td>
 
3239
<td class="enum_member_description">
 
3240
<p>a double underline should be drawn</p>
 
3241
</td>
 
3242
<td class="enum_member_annotations"> </td>
 
3243
</tr>
 
3244
<tr>
 
3245
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-LOW:CAPS"></a>PANGO_UNDERLINE_LOW</p></td>
 
3246
<td class="enum_member_description">
 
3247
<p>a single underline should be drawn at a position
1510
3248
beneath the ink extents of the text being
1511
3249
underlined. This should be used only for underlining
1512
3250
single characters, such as for keyboard
1513
3251
accelerators. <a class="link" href="pango-Text-Attributes.html#PANGO-UNDERLINE-SINGLE:CAPS"><code class="literal">PANGO_UNDERLINE_SINGLE</code></a> should
1514
 
be used for extended portions of text.
 
3252
be used for extended portions of text.</p>
1515
3253
</td>
 
3254
<td class="enum_member_annotations"> </td>
1516
3255
</tr>
1517
3256
<tr>
1518
 
<td><p><a name="PANGO-UNDERLINE-ERROR:CAPS"></a><span class="term"><code class="literal">PANGO_UNDERLINE_ERROR</code></span></p></td>
1519
 
<td>a wavy underline should be drawn below.
 
3257
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-ERROR:CAPS"></a>PANGO_UNDERLINE_ERROR</p></td>
 
3258
<td class="enum_member_description">
 
3259
<p>a wavy underline should be drawn below.
1520
3260
This underline is typically used to indicate
1521
3261
an error such as a possilble mispelling; in some
1522
3262
cases a contrasting color may automatically
1523
 
be used. This type of underlining is available since Pango 1.4.
1524
 
</td>
1525
 
</tr>
1526
 
</tbody>
1527
 
</table></div>
1528
 
</div>
1529
 
<hr>
1530
 
<div class="refsect2">
1531
 
<a name="PANGO-TYPE-UNDERLINE:CAPS"></a><h3>PANGO_TYPE_UNDERLINE</h3>
1532
 
<pre class="programlisting">#define PANGO_TYPE_UNDERLINE (pango_underline_get_type ())
1533
 
</pre>
1534
 
</div>
1535
 
<hr>
1536
 
<div class="refsect2">
1537
 
<a name="pango-attr-shape-new"></a><h3>pango_attr_shape_new ()</h3>
1538
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_shape_new                (<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,
1539
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);</pre>
1540
 
<p>
1541
 
Create a new shape attribute. A shape is used to impose a
1542
 
particular ink and logical rectangle on the result of shaping a
1543
 
particular glyph. This might be used, for instance, for
1544
 
embedding a picture or a widget inside a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.</p>
1545
 
<div class="variablelist"><table border="0" class="variablelist">
1546
 
<colgroup>
1547
 
<col align="left" valign="top">
1548
 
<col>
1549
 
</colgroup>
1550
 
<tbody>
1551
 
<tr>
1552
 
<td><p><span class="term"><em class="parameter"><code>ink_rect</code></em> :</span></p></td>
1553
 
<td>ink rectangle to assign to each character</td>
1554
 
</tr>
1555
 
<tr>
1556
 
<td><p><span class="term"><em class="parameter"><code>logical_rect</code></em> :</span></p></td>
1557
 
<td>logical rectangle to assign to each character</td>
1558
 
</tr>
1559
 
<tr>
1560
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1561
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1562
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1563
 
</td>
1564
 
</tr>
1565
 
</tbody>
1566
 
</table></div>
1567
 
</div>
1568
 
<hr>
1569
 
<div class="refsect2">
1570
 
<a name="pango-attr-shape-new-with-data"></a><h3>pango_attr_shape_new_with_data ()</h3>
1571
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_shape_new_with_data      (<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *ink_rect</code></em>,
1572
 
                                                         <em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>,
1573
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
1574
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrDataCopyFunc" title="PangoAttrDataCopyFunc ()"><span class="type">PangoAttrDataCopyFunc</span></a> copy_func</code></em>,
1575
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_func</code></em>);</pre>
1576
 
<p>
1577
 
Like <a class="link" href="pango-Text-Attributes.html#pango-attr-shape-new" title="pango_attr_shape_new ()"><code class="function">pango_attr_shape_new()</code></a>, but a user data pointer is also
1578
 
provided; this pointer can be accessed when later
1579
 
rendering the glyph.</p>
1580
 
<div class="variablelist"><table border="0" class="variablelist">
1581
 
<colgroup>
1582
 
<col align="left" valign="top">
1583
 
<col>
1584
 
</colgroup>
1585
 
<tbody>
1586
 
<tr>
1587
 
<td><p><span class="term"><em class="parameter"><code>ink_rect</code></em> :</span></p></td>
1588
 
<td>ink rectangle to assign to each character</td>
1589
 
</tr>
1590
 
<tr>
1591
 
<td><p><span class="term"><em class="parameter"><code>logical_rect</code></em> :</span></p></td>
1592
 
<td>logical rectangle to assign to each character</td>
1593
 
</tr>
1594
 
<tr>
1595
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1596
 
<td>user data pointer</td>
1597
 
</tr>
1598
 
<tr>
1599
 
<td><p><span class="term"><em class="parameter"><code>copy_func</code></em> :</span></p></td>
1600
 
<td>function to copy <em class="parameter"><code>data</code></em> when the
1601
 
attribute is copied. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>data</code></em> is simply
1602
 
copied as a pointer. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1603
 
</td>
1604
 
</tr>
1605
 
<tr>
1606
 
<td><p><span class="term"><em class="parameter"><code>destroy_func</code></em> :</span></p></td>
1607
 
<td>function to free <em class="parameter"><code>data</code></em> when the
1608
 
attribute is freed, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1609
 
</td>
1610
 
</tr>
1611
 
<tr>
1612
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1613
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>, which should be
1614
 
freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>.</td>
1615
 
</tr>
1616
 
</tbody>
1617
 
</table></div>
1618
 
<p class="since">Since 1.8</p>
1619
 
</div>
1620
 
<hr>
1621
 
<div class="refsect2">
1622
 
<a name="PangoAttrDataCopyFunc"></a><h3>PangoAttrDataCopyFunc ()</h3>
1623
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            (*PangoAttrDataCopyFunc)            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> user_data</code></em>);</pre>
1624
 
<p>
1625
 
Type of a function that can duplicate user data for an attribute.</p>
1626
 
<div class="variablelist"><table border="0" class="variablelist">
1627
 
<colgroup>
1628
 
<col align="left" valign="top">
1629
 
<col>
1630
 
</colgroup>
1631
 
<tbody>
1632
 
<tr>
1633
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1634
 
<td>user data to copy</td>
1635
 
</tr>
1636
 
<tr>
1637
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1638
 
<td>new copy of <em class="parameter"><code>user_data</code></em>.</td>
1639
 
</tr>
1640
 
</tbody>
1641
 
</table></div>
1642
 
</div>
1643
 
<hr>
1644
 
<div class="refsect2">
1645
 
<a name="pango-attr-scale-new"></a><h3>pango_attr_scale_new ()</h3>
1646
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_scale_new                (<em class="parameter"><code><span class="type">double</span> scale_factor</code></em>);</pre>
1647
 
<p>
1648
 
Create a new font size scale attribute. The base font for the
1649
 
affected text will have its size multiplied by <em class="parameter"><code>scale_factor</code></em>.</p>
1650
 
<div class="variablelist"><table border="0" class="variablelist">
1651
 
<colgroup>
1652
 
<col align="left" valign="top">
1653
 
<col>
1654
 
</colgroup>
1655
 
<tbody>
1656
 
<tr>
1657
 
<td><p><span class="term"><em class="parameter"><code>scale_factor</code></em> :</span></p></td>
1658
 
<td>factor to scale the font</td>
1659
 
</tr>
1660
 
<tr>
1661
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1662
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1663
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1664
 
</td>
1665
 
</tr>
1666
 
</tbody>
1667
 
</table></div>
1668
 
</div>
1669
 
<hr>
1670
 
<div class="refsect2">
1671
 
<a name="PANGO-SCALE-XX-SMALL:CAPS"></a><h3>PANGO_SCALE_XX_SMALL</h3>
1672
 
<pre class="programlisting">#define PANGO_SCALE_XX_SMALL ((double)0.5787037037037)
1673
 
</pre>
1674
 
<p>
1675
 
The scale factor for three shrinking steps (1 / (1.2 * 1.2 * 1.2)).</p>
1676
 
</div>
1677
 
<hr>
1678
 
<div class="refsect2">
1679
 
<a name="PANGO-SCALE-X-SMALL:CAPS"></a><h3>PANGO_SCALE_X_SMALL</h3>
1680
 
<pre class="programlisting">#define PANGO_SCALE_X_SMALL  ((double)0.6444444444444)
1681
 
</pre>
1682
 
<p>
1683
 
The scale factor for two shrinking steps (1 / (1.2 * 1.2)).</p>
1684
 
</div>
1685
 
<hr>
1686
 
<div class="refsect2">
1687
 
<a name="PANGO-SCALE-SMALL:CAPS"></a><h3>PANGO_SCALE_SMALL</h3>
1688
 
<pre class="programlisting">#define PANGO_SCALE_SMALL    ((double)0.8333333333333)
1689
 
</pre>
1690
 
<p>
1691
 
The scale factor for one shrinking step (1 / 1.2).</p>
1692
 
</div>
1693
 
<hr>
1694
 
<div class="refsect2">
1695
 
<a name="PANGO-SCALE-MEDIUM:CAPS"></a><h3>PANGO_SCALE_MEDIUM</h3>
1696
 
<pre class="programlisting">#define PANGO_SCALE_MEDIUM   ((double)1.0)
1697
 
</pre>
1698
 
<p>
1699
 
The scale factor for normal size (1.0).</p>
1700
 
</div>
1701
 
<hr>
1702
 
<div class="refsect2">
1703
 
<a name="PANGO-SCALE-LARGE:CAPS"></a><h3>PANGO_SCALE_LARGE</h3>
1704
 
<pre class="programlisting">#define PANGO_SCALE_LARGE    ((double)1.2)
1705
 
</pre>
1706
 
<p>
1707
 
The scale factor for one magnification step (1.2).</p>
1708
 
</div>
1709
 
<hr>
1710
 
<div class="refsect2">
1711
 
<a name="PANGO-SCALE-X-LARGE:CAPS"></a><h3>PANGO_SCALE_X_LARGE</h3>
1712
 
<pre class="programlisting">#define PANGO_SCALE_X_LARGE  ((double)1.4399999999999)
1713
 
</pre>
1714
 
<p>
1715
 
The scale factor for two magnification steps (1.2 * 1.2).</p>
1716
 
</div>
1717
 
<hr>
1718
 
<div class="refsect2">
1719
 
<a name="PANGO-SCALE-XX-LARGE:CAPS"></a><h3>PANGO_SCALE_XX_LARGE</h3>
1720
 
<pre class="programlisting">#define PANGO_SCALE_XX_LARGE ((double)1.728)
1721
 
</pre>
1722
 
<p>
1723
 
The scale factor for three magnification steps (1.2 * 1.2 * 1.2).</p>
1724
 
</div>
1725
 
<hr>
1726
 
<div class="refsect2">
1727
 
<a name="pango-attr-rise-new"></a><h3>pango_attr_rise_new ()</h3>
1728
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_rise_new                 (<em class="parameter"><code><span class="type">int</span> rise</code></em>);</pre>
1729
 
<p>
1730
 
Create a new baseline displacement attribute.</p>
1731
 
<div class="variablelist"><table border="0" class="variablelist">
1732
 
<colgroup>
1733
 
<col align="left" valign="top">
1734
 
<col>
1735
 
</colgroup>
1736
 
<tbody>
1737
 
<tr>
1738
 
<td><p><span class="term"><em class="parameter"><code>rise</code></em> :</span></p></td>
1739
 
<td>the amount that the text should be displaced vertically,
1740
 
in Pango units. Positive values displace the text upwards.</td>
1741
 
</tr>
1742
 
<tr>
1743
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1744
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1745
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1746
 
</td>
1747
 
</tr>
1748
 
</tbody>
1749
 
</table></div>
1750
 
</div>
1751
 
<hr>
1752
 
<div class="refsect2">
1753
 
<a name="pango-attr-letter-spacing-new"></a><h3>pango_attr_letter_spacing_new ()</h3>
1754
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_letter_spacing_new       (<em class="parameter"><code><span class="type">int</span> letter_spacing</code></em>);</pre>
1755
 
<p>
1756
 
Create a new letter-spacing attribute.</p>
1757
 
<div class="variablelist"><table border="0" class="variablelist">
1758
 
<colgroup>
1759
 
<col align="left" valign="top">
1760
 
<col>
1761
 
</colgroup>
1762
 
<tbody>
1763
 
<tr>
1764
 
<td><p><span class="term"><em class="parameter"><code>letter_spacing</code></em> :</span></p></td>
1765
 
<td>amount of extra space to add between graphemes
1766
 
of the text, in Pango units.</td>
1767
 
</tr>
1768
 
<tr>
1769
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1770
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1771
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1772
 
</td>
1773
 
</tr>
1774
 
</tbody>
1775
 
</table></div>
1776
 
<p class="since">Since 1.6</p>
1777
 
</div>
1778
 
<hr>
1779
 
<div class="refsect2">
1780
 
<a name="pango-attr-fallback-new"></a><h3>pango_attr_fallback_new ()</h3>
1781
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_fallback_new             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable_fallback</code></em>);</pre>
1782
 
<p>
1783
 
Create a new font fallback attribute.</p>
1784
 
<p>
1785
 
If fallback is disabled, characters will only be used from the
1786
 
closest matching font on the system. No fallback will be done to
1787
 
other fonts on the system that might contain the characters in the
1788
 
text.</p>
1789
 
<div class="variablelist"><table border="0" class="variablelist">
1790
 
<colgroup>
1791
 
<col align="left" valign="top">
1792
 
<col>
1793
 
</colgroup>
1794
 
<tbody>
1795
 
<tr>
1796
 
<td><p><span class="term"><em class="parameter"><code>enable_fallback</code></em> :</span></p></td>
1797
 
<td>
1798
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if we should fall back on other fonts
1799
 
for characters the active font is missing.</td>
1800
 
</tr>
1801
 
<tr>
1802
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1803
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1804
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1805
 
</td>
1806
 
</tr>
1807
 
</tbody>
1808
 
</table></div>
1809
 
<p class="since">Since 1.4</p>
1810
 
</div>
1811
 
<hr>
1812
 
<div class="refsect2">
1813
 
<a name="pango-attr-gravity-new"></a><h3>pango_attr_gravity_new ()</h3>
1814
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_gravity_new              (<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a> gravity</code></em>);</pre>
1815
 
<p>
1816
 
Create a new gravity attribute.</p>
1817
 
<div class="variablelist"><table border="0" class="variablelist">
1818
 
<colgroup>
1819
 
<col align="left" valign="top">
1820
 
<col>
1821
 
</colgroup>
1822
 
<tbody>
1823
 
<tr>
1824
 
<td><p><span class="term"><em class="parameter"><code>gravity</code></em> :</span></p></td>
1825
 
<td>the gravity value; should not be <a class="link" href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a>.</td>
1826
 
</tr>
1827
 
<tr>
1828
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1829
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1830
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1831
 
</td>
1832
 
</tr>
1833
 
</tbody>
1834
 
</table></div>
1835
 
<p class="since">Since 1.16</p>
1836
 
</div>
1837
 
<hr>
1838
 
<div class="refsect2">
1839
 
<a name="pango-attr-gravity-hint-new"></a><h3>pango_attr_gravity_hint_new ()</h3>
1840
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_gravity_hint_new         (<em class="parameter"><code><a class="link" href="pango-Vertical-Text.html#PangoGravityHint"><span class="type">PangoGravityHint</span></a> hint</code></em>);</pre>
1841
 
<p>
1842
 
Create a new gravity hint attribute.</p>
1843
 
<div class="variablelist"><table border="0" class="variablelist">
1844
 
<colgroup>
1845
 
<col align="left" valign="top">
1846
 
<col>
1847
 
</colgroup>
1848
 
<tbody>
1849
 
<tr>
1850
 
<td><p><span class="term"><em class="parameter"><code>hint</code></em> :</span></p></td>
1851
 
<td>the gravity hint value.</td>
1852
 
</tr>
1853
 
<tr>
1854
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1855
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
1856
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1857
 
</td>
1858
 
</tr>
1859
 
</tbody>
1860
 
</table></div>
1861
 
<p class="since">Since 1.16</p>
 
3263
be used. This type of underlining is available since Pango 1.4.</p>
 
3264
</td>
 
3265
<td class="enum_member_annotations"> </td>
 
3266
</tr>
 
3267
</tbody>
 
3268
</table></div>
 
3269
</div>
1862
3270
</div>
1863
3271
<hr>
1864
3272
<div class="refsect2">
1869
3277
  guint16 blue;
1870
3278
};
1871
3279
</pre>
1872
 
<p>
1873
 
The <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> structure is used to
 
3280
<p>The <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> structure is used to
1874
3281
represent a color in an uncalibrated RGB color-space.</p>
1875
 
<div class="variablelist"><table border="0" class="variablelist">
 
3282
<div class="refsect3">
 
3283
<a name="id-1.2.5.10.16.5"></a><h4>Members</h4>
 
3284
<div class="informaltable"><table width="100%" border="0">
1876
3285
<colgroup>
1877
 
<col align="left" valign="top">
1878
 
<col>
 
3286
<col width="300px" class="struct_members_name">
 
3287
<col class="struct_members_description">
 
3288
<col width="200px" class="struct_members_annotations">
1879
3289
</colgroup>
1880
3290
<tbody>
1881
3291
<tr>
1882
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> <em class="structfield"><code><a name="PangoColor-struct.red"></a>red</code></em>;</span></p></td>
1883
 
<td>value of red component</td>
1884
 
</tr>
1885
 
<tr>
1886
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> <em class="structfield"><code><a name="PangoColor-struct.green"></a>green</code></em>;</span></p></td>
1887
 
<td>value of green component</td>
1888
 
</tr>
1889
 
<tr>
1890
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> <em class="structfield"><code><a name="PangoColor-struct.blue"></a>blue</code></em>;</span></p></td>
1891
 
<td>value of blue component</td>
 
3292
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> <em class="structfield"><code><a name="PangoColor-struct.red"></a>red</code></em>;</p></td>
 
3293
<td class="struct_member_description"><p>value of red component</p></td>
 
3294
<td class="struct_member_annotations"> </td>
 
3295
</tr>
 
3296
<tr>
 
3297
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> <em class="structfield"><code><a name="PangoColor-struct.green"></a>green</code></em>;</p></td>
 
3298
<td class="struct_member_description"><p>value of green component</p></td>
 
3299
<td class="struct_member_annotations"> </td>
 
3300
</tr>
 
3301
<tr>
 
3302
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> <em class="structfield"><code><a name="PangoColor-struct.blue"></a>blue</code></em>;</p></td>
 
3303
<td class="struct_member_description"><p>value of blue component</p></td>
 
3304
<td class="struct_member_annotations"> </td>
1892
3305
</tr>
1893
3306
</tbody>
1894
3307
</table></div>
1895
3308
</div>
 
3309
</div>
1896
3310
<hr>
1897
3311
<div class="refsect2">
1898
3312
<a name="PANGO-TYPE-COLOR:CAPS"></a><h3>PANGO_TYPE_COLOR</h3>
1899
3313
<pre class="programlisting">#define PANGO_TYPE_COLOR pango_color_get_type ()
1900
3314
</pre>
1901
 
<p>
1902
 
The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>.</p>
1903
 
</div>
1904
 
<hr>
1905
 
<div class="refsect2">
1906
 
<a name="pango-color-parse"></a><h3>pango_color_parse ()</h3>
1907
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_color_parse                   (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>,
1908
 
                                                         <em class="parameter"><code>const <span class="type">char</span> *spec</code></em>);</pre>
1909
 
<p>
1910
 
Fill in the fields of a color from a string specification. The
1911
 
string can either one of a large set of standard names. (Taken
1912
 
from the X11 <code class="filename">rgb.txt</code> file), or it can be a hex value in the
1913
 
form '#rgb' '#rrggbb' '#rrrgggbbb' or '#rrrrggggbbbb' where
1914
 
'r', 'g' and 'b' are hex digits of the red, green, and blue
1915
 
components of the color, respectively. (White in the four
1916
 
forms is '#fff' '#ffffff' '#fffffffff' and '#ffffffffffff')</p>
1917
 
<div class="variablelist"><table border="0" class="variablelist">
1918
 
<colgroup>
1919
 
<col align="left" valign="top">
1920
 
<col>
1921
 
</colgroup>
1922
 
<tbody>
1923
 
<tr>
1924
 
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
1925
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> structure in which to store the result, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1926
 
</td>
1927
 
</tr>
1928
 
<tr>
1929
 
<td><p><span class="term"><em class="parameter"><code>spec</code></em> :</span></p></td>
1930
 
<td>a string specifying the new color</td>
1931
 
</tr>
1932
 
<tr>
1933
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1934
 
<td>
1935
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if parsing of the specifier succeeded,
1936
 
otherwise false.</td>
1937
 
</tr>
1938
 
</tbody>
1939
 
</table></div>
1940
 
</div>
1941
 
<hr>
1942
 
<div class="refsect2">
1943
 
<a name="pango-color-copy"></a><h3>pango_color_copy ()</h3>
1944
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="returnvalue">PangoColor</span></a> *        pango_color_copy                    (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *src</code></em>);</pre>
1945
 
<p>
1946
 
Creates a copy of <em class="parameter"><code>src</code></em>, which should be freed with
1947
 
<a class="link" href="pango-Text-Attributes.html#pango-color-free" title="pango_color_free ()"><code class="function">pango_color_free()</code></a>. Primarily used by language bindings,
1948
 
not that useful otherwise (since colors can just be copied
1949
 
by assignment in C).</p>
1950
 
<div class="variablelist"><table border="0" class="variablelist">
1951
 
<colgroup>
1952
 
<col align="left" valign="top">
1953
 
<col>
1954
 
</colgroup>
1955
 
<tbody>
1956
 
<tr>
1957
 
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
1958
 
<td>color to copy, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1959
 
</td>
1960
 
</tr>
1961
 
<tr>
1962
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1963
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>, which should
1964
 
be freed with <a class="link" href="pango-Text-Attributes.html#pango-color-free" title="pango_color_free ()"><code class="function">pango_color_free()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1965
 
if <em class="parameter"><code>src</code></em> was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
1966
 
</tr>
1967
 
</tbody>
1968
 
</table></div>
1969
 
</div>
1970
 
<hr>
1971
 
<div class="refsect2">
1972
 
<a name="pango-color-free"></a><h3>pango_color_free ()</h3>
1973
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_color_free                    (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);</pre>
1974
 
<p>
1975
 
Frees a color allocated by <a class="link" href="pango-Text-Attributes.html#pango-color-copy" title="pango_color_copy ()"><code class="function">pango_color_copy()</code></a>.</p>
1976
 
<div class="variablelist"><table border="0" class="variablelist">
1977
 
<colgroup>
1978
 
<col align="left" valign="top">
1979
 
<col>
1980
 
</colgroup>
1981
 
<tbody><tr>
1982
 
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
1983
 
<td>an allocated <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1984
 
</td>
1985
 
</tr></tbody>
1986
 
</table></div>
1987
 
</div>
1988
 
<hr>
1989
 
<div class="refsect2">
1990
 
<a name="pango-color-to-string"></a><h3>pango_color_to_string ()</h3>
1991
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             pango_color_to_string               (<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);</pre>
1992
 
<p>
1993
 
Returns a textual specification of <em class="parameter"><code>color</code></em> in the hexadecimal form
1994
 
<code class="literal">#rrrrggggbbbb</code>, where <code class="literal">r</code>,
1995
 
<code class="literal">g</code> and <code class="literal">b</code> are hex digits representing
1996
 
the red, green, and blue components respectively.</p>
1997
 
<div class="variablelist"><table border="0" class="variablelist">
1998
 
<colgroup>
1999
 
<col align="left" valign="top">
2000
 
<col>
2001
 
</colgroup>
2002
 
<tbody>
2003
 
<tr>
2004
 
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
2005
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>
2006
 
</td>
2007
 
</tr>
2008
 
<tr>
2009
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2010
 
<td>a newly-allocated text string that must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
2011
 
</tr>
2012
 
</tbody>
2013
 
</table></div>
2014
 
<p class="since">Since 1.16</p>
 
3315
<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>.</p>
2015
3316
</div>
2016
3317
<hr>
2017
3318
<div class="refsect2">
2018
3319
<a name="PangoAttrList-struct"></a><h3>PangoAttrList</h3>
2019
3320
<pre class="programlisting">typedef struct _PangoAttrList PangoAttrList;</pre>
2020
 
<p>
2021
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> structure represents a list of attributes
 
3321
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> structure represents a list of attributes
2022
3322
that apply to a section of text. The attributes are, in general,
2023
3323
allowed to overlap in an arbitrary fashion, however, if the
2024
 
attributes are manipulated only through <a class="link" href="pango-Text-Attributes.html#pango-attr-list-change" title="pango_attr_list_change ()"><code class="function">pango_attr_list_change()</code></a>,
 
3324
attributes are manipulated only through <a class="link" href="pango-Text-Attributes.html#pango-attr-list-change" title="pango_attr_list_change ()"><code class="function">pango_attr_list_change()</code></a>,
2025
3325
the overlap between properties will meet stricter criteria.</p>
2026
 
<p>
2027
 
Since the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> structure is stored as a linear list,
 
3326
<p>Since the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> structure is stored as a linear list,
2028
3327
it is not suitable for storing attributes for large amounts
2029
3328
of text. In general, you should not use a single <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2030
3329
for more than one paragraph of text.</p>
2034
3333
<a name="PANGO-TYPE-ATTR-LIST:CAPS"></a><h3>PANGO_TYPE_ATTR_LIST</h3>
2035
3334
<pre class="programlisting">#define PANGO_TYPE_ATTR_LIST pango_attr_list_get_type ()
2036
3335
</pre>
2037
 
<p>
2038
 
The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>.</p>
2039
 
</div>
2040
 
<hr>
2041
 
<div class="refsect2">
2042
 
<a name="pango-attr-list-new"></a><h3>pango_attr_list_new ()</h3>
2043
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     pango_attr_list_new                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
2044
 
<p>
2045
 
Create a new empty attribute list with a reference count of one.</p>
2046
 
<div class="variablelist"><table border="0" class="variablelist">
2047
 
<colgroup>
2048
 
<col align="left" valign="top">
2049
 
<col>
2050
 
</colgroup>
2051
 
<tbody><tr>
2052
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2053
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>,
2054
 
which should be freed with <a class="link" href="pango-Text-Attributes.html#pango-attr-list-unref" title="pango_attr_list_unref ()"><code class="function">pango_attr_list_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2055
 
</td>
2056
 
</tr></tbody>
2057
 
</table></div>
2058
 
</div>
2059
 
<hr>
2060
 
<div class="refsect2">
2061
 
<a name="pango-attr-list-ref"></a><h3>pango_attr_list_ref ()</h3>
2062
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     pango_attr_list_ref                 (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
2063
 
<p>
2064
 
Increase the reference count of the given attribute list by one.</p>
2065
 
<div class="variablelist"><table border="0" class="variablelist">
2066
 
<colgroup>
2067
 
<col align="left" valign="top">
2068
 
<col>
2069
 
</colgroup>
2070
 
<tbody>
2071
 
<tr>
2072
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2073
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2074
 
</td>
2075
 
</tr>
2076
 
<tr>
2077
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2078
 
<td>The attribute list passed in</td>
2079
 
</tr>
2080
 
</tbody>
2081
 
</table></div>
2082
 
<p class="since">Since 1.10</p>
2083
 
</div>
2084
 
<hr>
2085
 
<div class="refsect2">
2086
 
<a name="pango-attr-list-unref"></a><h3>pango_attr_list_unref ()</h3>
2087
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_list_unref               (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
2088
 
<p>
2089
 
Decrease the reference count of the given attribute list by one.
2090
 
If the result is zero, free the attribute list and the attributes
2091
 
it contains.</p>
2092
 
<div class="variablelist"><table border="0" class="variablelist">
2093
 
<colgroup>
2094
 
<col align="left" valign="top">
2095
 
<col>
2096
 
</colgroup>
2097
 
<tbody><tr>
2098
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2099
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2100
 
</td>
2101
 
</tr></tbody>
2102
 
</table></div>
2103
 
</div>
2104
 
<hr>
2105
 
<div class="refsect2">
2106
 
<a name="pango-attr-list-copy"></a><h3>pango_attr_list_copy ()</h3>
2107
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     pango_attr_list_copy                (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
2108
 
<p>
2109
 
Copy <em class="parameter"><code>list</code></em> and return an identical new list.</p>
2110
 
<div class="variablelist"><table border="0" class="variablelist">
2111
 
<colgroup>
2112
 
<col align="left" valign="top">
2113
 
<col>
2114
 
</colgroup>
2115
 
<tbody>
2116
 
<tr>
2117
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2118
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2119
 
</td>
2120
 
</tr>
2121
 
<tr>
2122
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2123
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, with a
2124
 
reference count of one, which should
2125
 
be freed with <a class="link" href="pango-Text-Attributes.html#pango-attr-list-unref" title="pango_attr_list_unref ()"><code class="function">pango_attr_list_unref()</code></a>.
2126
 
Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>list</code></em> was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
2127
 
</tr>
2128
 
</tbody>
2129
 
</table></div>
2130
 
</div>
2131
 
<hr>
2132
 
<div class="refsect2">
2133
 
<a name="pango-attr-list-insert"></a><h3>pango_attr_list_insert ()</h3>
2134
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_list_insert              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
2135
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
2136
 
<p>
2137
 
Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
2138
 
be inserted after all other attributes with a matching
2139
 
<em class="parameter"><code>start_index</code></em>.</p>
2140
 
<div class="variablelist"><table border="0" class="variablelist">
2141
 
<colgroup>
2142
 
<col align="left" valign="top">
2143
 
<col>
2144
 
</colgroup>
2145
 
<tbody>
2146
 
<tr>
2147
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2148
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2149
 
</td>
2150
 
</tr>
2151
 
<tr>
2152
 
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
2153
 
<td>the attribute to insert. Ownership of this
2154
 
value is assumed by the list. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2155
 
</td>
2156
 
</tr>
2157
 
</tbody>
2158
 
</table></div>
2159
 
</div>
2160
 
<hr>
2161
 
<div class="refsect2">
2162
 
<a name="pango-attr-list-insert-before"></a><h3>pango_attr_list_insert_before ()</h3>
2163
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_list_insert_before       (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
2164
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
2165
 
<p>
2166
 
Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
2167
 
be inserted before all other attributes with a matching
2168
 
<em class="parameter"><code>start_index</code></em>.</p>
2169
 
<div class="variablelist"><table border="0" class="variablelist">
2170
 
<colgroup>
2171
 
<col align="left" valign="top">
2172
 
<col>
2173
 
</colgroup>
2174
 
<tbody>
2175
 
<tr>
2176
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2177
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2178
 
</td>
2179
 
</tr>
2180
 
<tr>
2181
 
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
2182
 
<td>the attribute to insert. Ownership of this
2183
 
value is assumed by the list. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2184
 
</td>
2185
 
</tr>
2186
 
</tbody>
2187
 
</table></div>
2188
 
</div>
2189
 
<hr>
2190
 
<div class="refsect2">
2191
 
<a name="pango-attr-list-change"></a><h3>pango_attr_list_change ()</h3>
2192
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_list_change              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
2193
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attr</code></em>);</pre>
2194
 
<p>
2195
 
Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
2196
 
replace any attributes of the same type on that segment
2197
 
and be merged with any adjoining attributes that are identical.</p>
2198
 
<p>
2199
 
This function is slower than <a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert" title="pango_attr_list_insert ()"><code class="function">pango_attr_list_insert()</code></a> for
2200
 
creating a attribute list in order (potentially much slower
2201
 
for large lists). However, <a class="link" href="pango-Text-Attributes.html#pango-attr-list-insert" title="pango_attr_list_insert ()"><code class="function">pango_attr_list_insert()</code></a> is not
2202
 
suitable for continually changing a set of attributes
2203
 
since it never removes or combines existing attributes.</p>
2204
 
<div class="variablelist"><table border="0" class="variablelist">
2205
 
<colgroup>
2206
 
<col align="left" valign="top">
2207
 
<col>
2208
 
</colgroup>
2209
 
<tbody>
2210
 
<tr>
2211
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2212
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2213
 
</td>
2214
 
</tr>
2215
 
<tr>
2216
 
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
2217
 
<td>the attribute to insert. Ownership of this
2218
 
value is assumed by the list. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2219
 
</td>
2220
 
</tr>
2221
 
</tbody>
2222
 
</table></div>
2223
 
</div>
2224
 
<hr>
2225
 
<div class="refsect2">
2226
 
<a name="pango-attr-list-splice"></a><h3>pango_attr_list_splice ()</h3>
2227
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_list_splice              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
2228
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *other</code></em>,
2229
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>,
2230
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> len</code></em>);</pre>
2231
 
<p>
2232
 
This function opens up a hole in <em class="parameter"><code>list</code></em>, fills it in with attributes from
2233
 
the left, and then merges <em class="parameter"><code>other</code></em> on top of the hole.</p>
2234
 
<p>
2235
 
This operation is equivalent to stretching every attribute
2236
 
that applies at position <em class="parameter"><code>pos</code></em> in <em class="parameter"><code>list</code></em> by an amount <em class="parameter"><code>len</code></em>,
2237
 
and then calling <a class="link" href="pango-Text-Attributes.html#pango-attr-list-change" title="pango_attr_list_change ()"><code class="function">pango_attr_list_change()</code></a> with a copy
2238
 
of each attribute in <em class="parameter"><code>other</code></em> in sequence (offset in position by <em class="parameter"><code>pos</code></em>).</p>
2239
 
<p>
2240
 
This operation proves useful for, for instance, inserting
2241
 
a pre-edit string in the middle of an edit buffer.</p>
2242
 
<div class="variablelist"><table border="0" class="variablelist">
2243
 
<colgroup>
2244
 
<col align="left" valign="top">
2245
 
<col>
2246
 
</colgroup>
2247
 
<tbody>
2248
 
<tr>
2249
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2250
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2251
 
</td>
2252
 
</tr>
2253
 
<tr>
2254
 
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
2255
 
<td>another <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2256
 
</td>
2257
 
</tr>
2258
 
<tr>
2259
 
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
2260
 
<td>the position in <em class="parameter"><code>list</code></em> at which to insert <em class="parameter"><code>other</code></em>
2261
 
</td>
2262
 
</tr>
2263
 
<tr>
2264
 
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2265
 
<td>the length of the spliced segment. (Note that this
2266
 
must be specified since the attributes in <em class="parameter"><code>other</code></em>
2267
 
may only be present at some subsection of this range)</td>
2268
 
</tr>
2269
 
</tbody>
2270
 
</table></div>
2271
 
</div>
2272
 
<hr>
2273
 
<div class="refsect2">
2274
 
<a name="pango-attr-list-filter"></a><h3>pango_attr_list_filter ()</h3>
2275
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     pango_attr_list_filter              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>,
2276
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrFilterFunc" title="PangoAttrFilterFunc ()"><span class="type">PangoAttrFilterFunc</span></a> func</code></em>,
2277
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
2278
 
<p>
2279
 
Given a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> and callback function, removes any elements
2280
 
of <em class="parameter"><code>list</code></em> for which <em class="parameter"><code>func</code></em> returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and inserts them into
2281
 
a new list.</p>
2282
 
<div class="variablelist"><table border="0" class="variablelist">
2283
 
<colgroup>
2284
 
<col align="left" valign="top">
2285
 
<col>
2286
 
</colgroup>
2287
 
<tbody>
2288
 
<tr>
2289
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2290
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2291
 
</td>
2292
 
</tr>
2293
 
<tr>
2294
 
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2295
 
<td>callback function; returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
2296
 
if an attribute should be filtered out. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> data]</span>
2297
 
</td>
2298
 
</tr>
2299
 
<tr>
2300
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2301
 
<td>Data to be passed to <em class="parameter"><code>func</code></em>. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
2302
 
</td>
2303
 
</tr>
2304
 
<tr>
2305
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2306
 
<td>the new <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
2307
 
no attributes of the given types were found. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2308
 
</td>
2309
 
</tr>
2310
 
</tbody>
2311
 
</table></div>
2312
 
<p class="since">Since 1.2</p>
2313
 
</div>
2314
 
<hr>
2315
 
<div class="refsect2">
2316
 
<a name="PangoAttrFilterFunc"></a><h3>PangoAttrFilterFunc ()</h3>
2317
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*PangoAttrFilterFunc)              (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a> *attribute</code></em>,
2318
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2319
 
<p>
2320
 
Type of a function filtering a list of attributes.</p>
2321
 
<div class="variablelist"><table border="0" class="variablelist">
2322
 
<colgroup>
2323
 
<col align="left" valign="top">
2324
 
<col>
2325
 
</colgroup>
2326
 
<tbody>
2327
 
<tr>
2328
 
<td><p><span class="term"><em class="parameter"><code>attribute</code></em> :</span></p></td>
2329
 
<td>a Pango attribute</td>
2330
 
</tr>
2331
 
<tr>
2332
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2333
 
<td>user data passed to the function</td>
2334
 
</tr>
2335
 
<tr>
2336
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2337
 
<td>
2338
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attribute should be selected for
2339
 
filtering, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2340
 
</tr>
2341
 
</tbody>
2342
 
</table></div>
2343
 
</div>
2344
 
<hr>
2345
 
<div class="refsect2">
2346
 
<a name="pango-attr-list-get-iterator"></a><h3>pango_attr_list_get_iterator ()</h3>
2347
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> * pango_attr_list_get_iterator        (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *list</code></em>);</pre>
2348
 
<p>
2349
 
Create a iterator initialized to the beginning of the list.
2350
 
<em class="parameter"><code>list</code></em> must not be modified until this iterator is freed.</p>
2351
 
<div class="variablelist"><table border="0" class="variablelist">
2352
 
<colgroup>
2353
 
<col align="left" valign="top">
2354
 
<col>
2355
 
</colgroup>
2356
 
<tbody>
2357
 
<tr>
2358
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2359
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
2360
 
</td>
2361
 
</tr>
2362
 
<tr>
2363
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2364
 
<td>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>, which should
2365
 
be freed with <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-destroy" title="pango_attr_iterator_destroy ()"><code class="function">pango_attr_iterator_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2366
 
</td>
2367
 
</tr>
2368
 
</tbody>
2369
 
</table></div>
 
3336
<p>The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>.</p>
2370
3337
</div>
2371
3338
<hr>
2372
3339
<div class="refsect2">
2373
3340
<a name="PangoAttrIterator"></a><h3>PangoAttrIterator</h3>
2374
3341
<pre class="programlisting">typedef struct _PangoAttrIterator PangoAttrIterator;</pre>
2375
 
<p>
2376
 
The <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> structure is used to represent an
 
3342
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> structure is used to represent an
2377
3343
iterator through a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. A new iterator is created
2378
 
with <a class="link" href="pango-Text-Attributes.html#pango-attr-list-get-iterator" title="pango_attr_list_get_iterator ()"><code class="function">pango_attr_list_get_iterator()</code></a>. Once the iterator
 
3344
with <a class="link" href="pango-Text-Attributes.html#pango-attr-list-get-iterator" title="pango_attr_list_get_iterator ()"><code class="function">pango_attr_list_get_iterator()</code></a>. Once the iterator
2379
3345
is created, it can be advanced through the style changes
2380
 
in the text using <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-next" title="pango_attr_iterator_next ()"><code class="function">pango_attr_iterator_next()</code></a>. At each
 
3346
in the text using <a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-next" title="pango_attr_iterator_next ()"><code class="function">pango_attr_iterator_next()</code></a>. At each
2381
3347
style change, the range of the current style segment and the
2382
3348
attributes currently in effect can be queried.</p>
2383
3349
</div>
2384
 
<hr>
2385
 
<div class="refsect2">
2386
 
<a name="pango-attr-iterator-copy"></a><h3>pango_attr_iterator_copy ()</h3>
2387
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> * pango_attr_iterator_copy            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
2388
 
<p>
2389
 
Copy a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p>
2390
 
<div class="variablelist"><table border="0" class="variablelist">
2391
 
<colgroup>
2392
 
<col align="left" valign="top">
2393
 
<col>
2394
 
</colgroup>
2395
 
<tbody>
2396
 
<tr>
2397
 
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
2398
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>.</td>
2399
 
</tr>
2400
 
<tr>
2401
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2402
 
<td>the newly allocated
2403
 
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>, which should be freed with
2404
 
<a class="link" href="pango-Text-Attributes.html#pango-attr-iterator-destroy" title="pango_attr_iterator_destroy ()"><code class="function">pango_attr_iterator_destroy()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2405
 
</td>
2406
 
</tr>
2407
 
</tbody>
2408
 
</table></div>
2409
 
</div>
2410
 
<hr>
2411
 
<div class="refsect2">
2412
 
<a name="pango-attr-iterator-next"></a><h3>pango_attr_iterator_next ()</h3>
2413
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_attr_iterator_next            (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
2414
 
<p>
2415
 
Advance the iterator until the next change of style.</p>
2416
 
<div class="variablelist"><table border="0" class="variablelist">
2417
 
<colgroup>
2418
 
<col align="left" valign="top">
2419
 
<col>
2420
 
</colgroup>
2421
 
<tbody>
2422
 
<tr>
2423
 
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
2424
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>
2425
 
</td>
2426
 
</tr>
2427
 
<tr>
2428
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2429
 
<td>
2430
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the iterator is at the end of the list, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
2431
 
</td>
2432
 
</tr>
2433
 
</tbody>
2434
 
</table></div>
2435
 
</div>
2436
 
<hr>
2437
 
<div class="refsect2">
2438
 
<a name="pango-attr-iterator-range"></a><h3>pango_attr_iterator_range ()</h3>
2439
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_iterator_range           (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
2440
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>,
2441
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);</pre>
2442
 
<p>
2443
 
Get the range of the current segment. Note that the
2444
 
stored return values are signed, not unsigned like
2445
 
the values in <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>. To deal with this API
2446
 
oversight, stored return values that wouldn't fit into
2447
 
a signed integer are clamped to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a>.</p>
2448
 
<div class="variablelist"><table border="0" class="variablelist">
2449
 
<colgroup>
2450
 
<col align="left" valign="top">
2451
 
<col>
2452
 
</colgroup>
2453
 
<tbody>
2454
 
<tr>
2455
 
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
2456
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>
2457
 
</td>
2458
 
</tr>
2459
 
<tr>
2460
 
<td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
2461
 
<td>location to store the start of the range. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
2462
 
</td>
2463
 
</tr>
2464
 
<tr>
2465
 
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
2466
 
<td>location to store the end of the range. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
2467
 
</td>
2468
 
</tr>
2469
 
</tbody>
2470
 
</table></div>
2471
 
</div>
2472
 
<hr>
2473
 
<div class="refsect2">
2474
 
<a name="pango-attr-iterator-get"></a><h3>pango_attr_iterator_get ()</h3>
2475
 
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *    pango_attr_iterator_get             (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
2476
 
                                                         <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrType"><span class="type">PangoAttrType</span></a> type</code></em>);</pre>
2477
 
<p>
2478
 
Find the current attribute of a particular type at the iterator
2479
 
location. When multiple attributes of the same type overlap,
2480
 
the attribute whose range starts closest to the current location
2481
 
is used.</p>
2482
 
<div class="variablelist"><table border="0" class="variablelist">
2483
 
<colgroup>
2484
 
<col align="left" valign="top">
2485
 
<col>
2486
 
</colgroup>
2487
 
<tbody>
2488
 
<tr>
2489
 
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
2490
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>
2491
 
</td>
2492
 
</tr>
2493
 
<tr>
2494
 
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
2495
 
<td>the type of attribute to find.</td>
2496
 
</tr>
2497
 
<tr>
2498
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2499
 
<td>the current attribute of the given type, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
2500
 
no attribute of that type applies to the current
2501
 
location.</td>
2502
 
</tr>
2503
 
</tbody>
2504
 
</table></div>
2505
 
</div>
2506
 
<hr>
2507
 
<div class="refsect2">
2508
 
<a name="pango-attr-iterator-get-font"></a><h3>pango_attr_iterator_get_font ()</h3>
2509
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_iterator_get_font        (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>,
2510
 
                                                         <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,
2511
 
                                                         <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> **language</code></em>,
2512
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> **extra_attrs</code></em>);</pre>
2513
 
<p>
2514
 
Get the font and other attributes at the current iterator position.</p>
2515
 
<div class="variablelist"><table border="0" class="variablelist">
2516
 
<colgroup>
2517
 
<col align="left" valign="top">
2518
 
<col>
2519
 
</colgroup>
2520
 
<tbody>
2521
 
<tr>
2522
 
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
2523
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>
2524
 
</td>
2525
 
</tr>
2526
 
<tr>
2527
 
<td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
2528
 
<td>a <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to fill in with the current values.
2529
 
The family name in this structure will be set using
2530
 
<a class="link" href="pango-Fonts.html#pango-font-description-set-family-static" title="pango_font_description_set_family_static ()"><code class="function">pango_font_description_set_family_static()</code></a> using values from
2531
 
an attribute in the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> associated with the iterator,
2532
 
so if you plan to keep it around, you must call:
2533
 
<code class="literal">pango_font_description_set_family (desc, pango_font_description_get_family (desc))</code>.</td>
2534
 
</tr>
2535
 
<tr>
2536
 
<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
2537
 
<td>if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, location to store language tag for item, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2538
 
if none is found. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2539
 
</td>
2540
 
</tr>
2541
 
<tr>
2542
 
<td><p><span class="term"><em class="parameter"><code>extra_attrs</code></em> :</span></p></td>
2543
 
<td>if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
2544
 
location in which to store a list of non-font
2545
 
attributes at the the current position; only the highest priority
2546
 
value of each attribute will be added to this list. In order
2547
 
to free this value, you must call <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a> on
2548
 
each member. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Attribute][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2549
 
</td>
2550
 
</tr>
2551
 
</tbody>
2552
 
</table></div>
2553
 
</div>
2554
 
<hr>
2555
 
<div class="refsect2">
2556
 
<a name="pango-attr-iterator-get-attrs"></a><h3>pango_attr_iterator_get_attrs ()</h3>
2557
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            pango_attr_iterator_get_attrs       (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
2558
 
<p>
2559
 
Gets a list of all attributes at the current position of the
2560
 
iterator.</p>
2561
 
<div class="variablelist"><table border="0" class="variablelist">
2562
 
<colgroup>
2563
 
<col align="left" valign="top">
2564
 
<col>
2565
 
</colgroup>
2566
 
<tbody>
2567
 
<tr>
2568
 
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
2569
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>
2570
 
</td>
2571
 
</tr>
2572
 
<tr>
2573
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2574
 
<td>a list of
2575
 
all attributes for the current range.
2576
 
To free this value, call <a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()"><code class="function">pango_attribute_destroy()</code></a> on
2577
 
each value and <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> on the list. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Pango.Attribute][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2578
 
</td>
2579
 
</tr>
2580
 
</tbody>
2581
 
</table></div>
2582
 
<p class="since">Since 1.2</p>
2583
 
</div>
2584
 
<hr>
2585
 
<div class="refsect2">
2586
 
<a name="pango-attr-iterator-destroy"></a><h3>pango_attr_iterator_destroy ()</h3>
2587
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_attr_iterator_destroy         (<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> *iterator</code></em>);</pre>
2588
 
<p>
2589
 
Destroy a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a> and free all associated memory.</p>
2590
 
<div class="variablelist"><table border="0" class="variablelist">
2591
 
<colgroup>
2592
 
<col align="left" valign="top">
2593
 
<col>
2594
 
</colgroup>
2595
 
<tbody><tr>
2596
 
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
2597
 
<td>a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>.</td>
2598
 
</tr></tbody>
2599
 
</table></div>
2600
 
</div>
2601
3350
</div>
2602
3351
</div>
2603
3352
<div class="footer">
2604
3353
<hr>
2605
 
          Generated by GTK-Doc V1.19.1</div>
 
3354
          Generated by GTK-Doc V1.20.1</div>
2606
3355
</body>
2607
3356
</html>
 
 
b'\\ No newline at end of file'