source-git / pango

Clone
Source Code
GIT

Files

  1.   0ec9dd32b6045a9b5be0ed717e8ad6dc523475af
  2.   docs
  3.   html
  4.   pango-Text-Attributes.html
Blob Blame History Raw 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Text Attributes: Pango Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Pango Reference Manual">
<link rel="up" href="pango.html" title="Basic Pango Interfaces">
<link rel="prev" href="pango-Fonts.html" title="Fonts">
<link rel="next" href="pango-Tab-Stops.html" title="Tab Stops">
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#pango-Text-Attributes.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#pango-Text-Attributes.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="pango.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="pango-Fonts.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="pango-Tab-Stops.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="pango-Text-Attributes"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="pango-Text-Attributes.top_of_page"></a>Text Attributes</span></h2>
<p>Text Attributes — Font and other attributes for annotating text</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="pango-Text-Attributes.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-parse-markup" title="pango_parse_markup ()">pango_parse_markup</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GMarkupParseContext</span> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="returnvalue">PangoAttrType</span></a>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-attribute-init" title="pango_attribute_init ()">pango_attribute_init</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-attribute-copy" title="pango_attribute_copy ()">pango_attribute_copy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-attribute-equal" title="pango_attribute_equal ()">pango_attribute_equal</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-attribute-destroy" title="pango_attribute_destroy ()">pango_attribute_destroy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gpointer</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-attr-font-features-new" title="pango_attr_font_features_new ()">pango_attr_font_features_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-attr-foreground-alpha-new" title="pango_attr_foreground_alpha_new ()">pango_attr_foreground_alpha_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-attr-background-alpha-new" title="pango_attr_background_alpha_new ()">pango_attr_background_alpha_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-color-parse" title="pango_color_parse ()">pango_color_parse</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="returnvalue">PangoColor</span></a> *
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-color-copy" title="pango_color_copy ()">pango_color_copy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="pango-Text-Attributes.html#pango-color-free" title="pango_color_free ()">pango_color_free</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="returnvalue">PangoAttrIterator</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GSList</span> *
</td>
<td class="function_name">
<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>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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>
</td>
</tr>
</tbody>
</table></div>
</div>
<a name="PangoColor"></a><a name="PangoAttrList"></a><div class="refsect1">
<a name="pango-Text-Attributes.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType">PangoAttrType</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrClass" title="struct PangoAttrClass">PangoAttrClass</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute">PangoAttribute</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString">PangoAttrString</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage">PangoAttrLanguage</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor">PangoAttrColor</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt">PangoAttrInt</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat">PangoAttrFloat</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc">PangoAttrFontDesc</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape">PangoAttrShape</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrSize" title="struct PangoAttrSize">PangoAttrSize</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrFontFeatures" title="struct PangoAttrFontFeatures">PangoAttrFontFeatures</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoUnderline" title="enum PangoUnderline">PangoUnderline</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoColor-struct" title="struct PangoColor">PangoColor</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrList-struct" title="PangoAttrList">PangoAttrList</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<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>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator">PangoAttrIterator</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="pango-Text-Attributes.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
    <span class="lineart">├──</span> PangoAttrList
    <span class="lineart">╰──</span> PangoColor
    <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a>
    <span class="lineart">├──</span> PangoAttrType
    <span class="lineart">╰──</span> PangoUnderline
</pre>
</div>
<div class="refsect1">
<a name="pango-Text-Attributes.description"></a><h2>Description</h2>
<p>Attributed text is used in a number of places in Pango. It
is used as the input to the itemization process and also when
creating a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>. The data types and functions in
this section are used to represent and manipulate sets
of attributes applied to a portion of text.</p>
</div>
<div class="refsect1">
<a name="pango-Text-Attributes.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="pango-parse-markup"></a><h3>pango_parse_markup ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
pango_parse_markup (<em class="parameter"><code>const <span class="type">char</span> *markup_text</code></em>,
                    <em class="parameter"><code><span class="type">int</span> length</code></em>,
                    <em class="parameter"><code><span class="type">gunichar</span> accel_marker</code></em>,
                    <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
                    <em class="parameter"><code><span class="type">char</span> **text</code></em>,
                    <em class="parameter"><code><span class="type">gunichar</span> *accel_char</code></em>,
                    <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Parses marked-up text (see</p>
markup format) to create
<p>a plain-text string and an attribute list.</p>
<p>If <em class="parameter"><code>accel_marker</code></em>
 is nonzero, the given character will mark the
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>

might be an ampersand or underscore. All characters marked
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,
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>
.
Two <em class="parameter"><code>accel_marker</code></em>
 characters following each other produce a single
literal <em class="parameter"><code>accel_marker</code></em>
 character.</p>
<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>
<p>If any error happens, none of the output arguments are touched except
for <em class="parameter"><code>error</code></em>
.</p>
<div class="refsect3">
<a name="pango-parse-markup.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>markup_text</p></td>
<td class="parameter_description"><p>markup to parse (see markup format)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>length</p></td>
<td class="parameter_description"><p>length of <em class="parameter"><code>markup_text</code></em>
, or -1 if nul-terminated</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>accel_marker</p></td>
<td class="parameter_description"><p>character that precedes an accelerator, or 0 for none</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_list</p></td>
<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 <code class="literal">NULL</code>. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>text</p></td>
<td class="parameter_description"><p>address of return location for text with tags stripped, or <code class="literal">NULL</code>. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>accel_char</p></td>
<td class="parameter_description"><p>address of return location for accelerator char, or <code class="literal">NULL</code>. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>address of return location for errors, or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-parse-markup.returns"></a><h4>Returns</h4>
<p> <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set, otherwise <code class="literal">TRUE</code></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-markup-parser-new"></a><h3>pango_markup_parser_new ()</h3>
<pre class="programlisting"><span class="returnvalue">GMarkupParseContext</span> *
pango_markup_parser_new (<em class="parameter"><code><span class="type">gunichar</span> accel_marker</code></em>);</pre>
<p>Parses marked-up text (see</p>
markup format) to create
<p>a plain-text string and an attribute list.</p>
<p>If <em class="parameter"><code>accel_marker</code></em>
 is nonzero, the given character will mark the
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>

might be an ampersand or underscore. All characters marked
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,
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>
,
when calling <code class="function">finish()</code>. Two <em class="parameter"><code>accel_marker</code></em>
 characters following each
other produce a single literal <em class="parameter"><code>accel_marker</code></em>
 character.</p>
<p>To feed markup to the parser, use <code class="function">g_markup_parse_context_parse()</code>
on the returned <span class="type">GMarkupParseContext</span>. When done with feeding markup
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
of it, and then use <code class="function">g_markup_parse_context_free()</code> to free it.</p>
<p>This function is designed for applications that read pango markup
from streams. To simply parse a string containing pango markup,
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>
<div class="refsect3">
<a name="pango-markup-parser-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>accel_marker</p></td>
<td class="parameter_description"><p>character that precedes an accelerator, or 0 for none</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-markup-parser-new.returns"></a><h4>Returns</h4>
<p>a <span class="type">GMarkupParseContext</span> that should be
destroyed with <code class="function">g_markup_parse_context_free()</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-31-0.html#api-index-1.31.0">1.31.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-markup-parser-finish"></a><h3>pango_markup_parser_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
pango_markup_parser_finish (<em class="parameter"><code><span class="type">GMarkupParseContext</span> *context</code></em>,
                            <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> **attr_list</code></em>,
                            <em class="parameter"><code><span class="type">char</span> **text</code></em>,
                            <em class="parameter"><code><span class="type">gunichar</span> *accel_char</code></em>,
                            <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>After feeding a pango markup parser some data with <code class="function">g_markup_parse_context_parse()</code>,
use this function to get the list of pango attributes and text out of the
markup. This function will not free <em class="parameter"><code>context</code></em>
, use <code class="function">g_markup_parse_context_free()</code>
to do so.</p>
<div class="refsect3">
<a name="pango-markup-parser-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>context</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_list</p></td>
<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 <code class="literal">NULL</code>. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>text</p></td>
<td class="parameter_description"><p>address of return location for text with tags stripped, or <code class="literal">NULL</code>. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>accel_char</p></td>
<td class="parameter_description"><p>address of return location for accelerator char, or <code class="literal">NULL</code>. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>address of return location for errors, or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-markup-parser-finish.returns"></a><h4>Returns</h4>
<p> <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
is set, otherwise <code class="literal">TRUE</code></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-31-0.html#api-index-1.31.0">1.31.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-type-register"></a><h3>pango_attr_type_register ()</h3>
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="returnvalue">PangoAttrType</span></a>
pango_attr_type_register (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
<p>Allocate a new attribute type ID.  The attribute type name can be accessed
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>
<div class="refsect3">
<a name="pango-attr-type-register.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>an identifier for the type</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-type-register.returns"></a><h4>Returns</h4>
<p> the new type ID.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-type-get-name"></a><h3>pango_attr_type_get_name ()</h3>
<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" title="enum PangoAttrType"><span class="type">PangoAttrType</span></a> type</code></em>);</pre>
<p>Fetches the attribute type name passed in when registering the type 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>.</p>
<p>The returned value is an interned string (see <code class="function">g_intern_string()</code> for what
that means) that should not be modified or freed.</p>
<div class="refsect3">
<a name="pango-attr-type-get-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>an attribute type ID to fetch the name for</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-type-get-name.returns"></a><h4>Returns</h4>
<p>the type ID name (which may be <code class="literal">NULL</code>), or
<code class="literal">NULL</code> if <em class="parameter"><code>type</code></em>
is a built-in Pango attribute type or invalid. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-22.html#api-index-1.22">1.22</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attribute-init"></a><h3>pango_attribute_init ()</h3>
<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>,
                      <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>
<p>Initializes <em class="parameter"><code>attr</code></em>
's klass to <em class="parameter"><code>klass</code></em>
,
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>
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>
such that the attribute applies
to the entire text by default.</p>
<div class="refsect3">
<a name="pango-attribute-init.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>attr</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>klass</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-1-20.html#api-index-1.20">1.20</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attribute-copy"></a><h3>pango_attribute_copy ()</h3>
<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>
<p>Make a copy of an attribute.</p>
<div class="refsect3">
<a name="pango-attribute-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>attr</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attribute-copy.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attribute-equal"></a><h3>pango_attribute_equal ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
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>,
                       <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>
<p>Compare two attributes for equality. This compares only the
actual value of the two attributes and not the ranges that the
attributes apply to.</p>
<div class="refsect3">
<a name="pango-attribute-equal.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>attr1</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr2</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attribute-equal.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the two attributes have the same value.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attribute-destroy"></a><h3>pango_attribute_destroy ()</h3>
<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>
<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>
<div class="refsect3">
<a name="pango-attribute-destroy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>attr</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-language-new"></a><h3>pango_attr_language_new ()</h3>
<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>
<p>Create a new language tag attribute.</p>
<div class="refsect3">
<a name="pango-attr-language-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>language</p></td>
<td class="parameter_description"><p>language tag</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-language-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-family-new"></a><h3>pango_attr_family_new ()</h3>
<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>
<p>Create a new font family attribute.</p>
<div class="refsect3">
<a name="pango-attr-family-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>family</p></td>
<td class="parameter_description"><p>the family or comma separated list of families</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-family-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-style-new"></a><h3>pango_attr_style_new ()</h3>
<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" title="enum PangoStyle"><span class="type">PangoStyle</span></a> style</code></em>);</pre>
<p>Create a new font slant style attribute.</p>
<div class="refsect3">
<a name="pango-attr-style-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>style</p></td>
<td class="parameter_description"><p>the slant style</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-style-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-variant-new"></a><h3>pango_attr_variant_new ()</h3>
<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" title="enum PangoVariant"><span class="type">PangoVariant</span></a> variant</code></em>);</pre>
<p>Create a new font variant attribute (normal or small caps)</p>
<div class="refsect3">
<a name="pango-attr-variant-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>variant</p></td>
<td class="parameter_description"><p>the variant</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-variant-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-stretch-new"></a><h3>pango_attr_stretch_new ()</h3>
<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" title="enum PangoStretch"><span class="type">PangoStretch</span></a> stretch</code></em>);</pre>
<p>Create a new font stretch attribute</p>
<div class="refsect3">
<a name="pango-attr-stretch-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>stretch</p></td>
<td class="parameter_description"><p>the stretch</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-stretch-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-weight-new"></a><h3>pango_attr_weight_new ()</h3>
<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" title="enum PangoWeight"><span class="type">PangoWeight</span></a> weight</code></em>);</pre>
<p>Create a new font weight attribute.</p>
<div class="refsect3">
<a name="pango-attr-weight-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>weight</p></td>
<td class="parameter_description"><p>the weight</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-weight-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-size-new"></a><h3>pango_attr_size_new ()</h3>
<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>
<p>Create a new font-size attribute in fractional points.</p>
<div class="refsect3">
<a name="pango-attr-size-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>size</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-size-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-size-new-absolute"></a><h3>pango_attr_size_new_absolute ()</h3>
<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>
<p>Create a new font-size attribute in device units.</p>
<div class="refsect3">
<a name="pango-attr-size-new-absolute.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>size</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-size-new-absolute.returns"></a><h4>Returns</h4>
<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
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>
</div>
<p class="since">Since: <a class="link" href="api-index-1-8.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-font-desc-new"></a><h3>pango_attr_font_desc_new ()</h3>
<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>
<p>Create a new font description attribute. This attribute
allows setting family, style, weight, variant, stretch,
and size simultaneously.</p>
<div class="refsect3">
<a name="pango-attr-font-desc-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>desc</p></td>
<td class="parameter_description"><p>the font description</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-font-desc-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-foreground-new"></a><h3>pango_attr_foreground_new ()</h3>
<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><span class="type">guint16</span> red</code></em>,
                           <em class="parameter"><code><span class="type">guint16</span> green</code></em>,
                           <em class="parameter"><code><span class="type">guint16</span> blue</code></em>);</pre>
<p>Create a new foreground color attribute.</p>
<div class="refsect3">
<a name="pango-attr-foreground-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>red</p></td>
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>green</p></td>
<td class="parameter_description"><p>the green value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>blue</p></td>
<td class="parameter_description"><p>the blue value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-foreground-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-background-new"></a><h3>pango_attr_background_new ()</h3>
<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><span class="type">guint16</span> red</code></em>,
                           <em class="parameter"><code><span class="type">guint16</span> green</code></em>,
                           <em class="parameter"><code><span class="type">guint16</span> blue</code></em>);</pre>
<p>Create a new background color attribute.</p>
<div class="refsect3">
<a name="pango-attr-background-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>red</p></td>
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>green</p></td>
<td class="parameter_description"><p>the green value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>blue</p></td>
<td class="parameter_description"><p>the blue value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-background-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-strikethrough-new"></a><h3>pango_attr_strikethrough_new ()</h3>
<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><span class="type">gboolean</span> strikethrough</code></em>);</pre>
<p>Create a new strike-through attribute.</p>
<div class="refsect3">
<a name="pango-attr-strikethrough-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>strikethrough</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the text should be struck-through.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-strikethrough-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-strikethrough-color-new"></a><h3>pango_attr_strikethrough_color_new ()</h3>
<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><span class="type">guint16</span> red</code></em>,
                                    <em class="parameter"><code><span class="type">guint16</span> green</code></em>,
                                    <em class="parameter"><code><span class="type">guint16</span> blue</code></em>);</pre>
<p>Create a new strikethrough color attribute. This attribute
modifies the color of strikethrough lines. If not set, strikethrough
lines will use the foreground color.</p>
<div class="refsect3">
<a name="pango-attr-strikethrough-color-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>red</p></td>
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>green</p></td>
<td class="parameter_description"><p>the green value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>blue</p></td>
<td class="parameter_description"><p>the blue value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-strikethrough-color-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-8.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-underline-new"></a><h3>pango_attr_underline_new ()</h3>
<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" title="enum PangoUnderline"><span class="type">PangoUnderline</span></a> underline</code></em>);</pre>
<p>Create a new underline-style attribute.</p>
<div class="refsect3">
<a name="pango-attr-underline-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>underline</p></td>
<td class="parameter_description"><p>the underline style.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-underline-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-underline-color-new"></a><h3>pango_attr_underline_color_new ()</h3>
<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><span class="type">guint16</span> red</code></em>,
                                <em class="parameter"><code><span class="type">guint16</span> green</code></em>,
                                <em class="parameter"><code><span class="type">guint16</span> blue</code></em>);</pre>
<p>Create a new underline color attribute. This attribute
modifies the color of underlines. If not set, underlines
will use the foreground color.</p>
<div class="refsect3">
<a name="pango-attr-underline-color-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>red</p></td>
<td class="parameter_description"><p>the red value (ranging from 0 to 65535)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>green</p></td>
<td class="parameter_description"><p>the green value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>blue</p></td>
<td class="parameter_description"><p>the blue value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-underline-color-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-8.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-shape-new"></a><h3>pango_attr_shape_new ()</h3>
<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>,
                      <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>
<p>Create a new shape attribute. A shape is used to impose a
particular ink and logical rectangle on the result of shaping a
particular glyph. This might be used, for instance, for
embedding a picture or a widget inside a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.</p>
<div class="refsect3">
<a name="pango-attr-shape-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>ink_rect</p></td>
<td class="parameter_description"><p>ink rectangle to assign to each character</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>logical_rect</p></td>
<td class="parameter_description"><p>logical rectangle to assign to each character</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-shape-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-shape-new-with-data"></a><h3>pango_attr_shape_new_with_data ()</h3>
<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>,
                                <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>,
                                <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
                                <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>,
                                <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy_func</code></em>);</pre>
<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
provided; this pointer can be accessed when later
rendering the glyph.</p>
<div class="refsect3">
<a name="pango-attr-shape-new-with-data.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>ink_rect</p></td>
<td class="parameter_description"><p>ink rectangle to assign to each character</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>logical_rect</p></td>
<td class="parameter_description"><p>logical rectangle to assign to each character</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>user data pointer</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>copy_func</p></td>
<td class="parameter_description"><p>function to copy <em class="parameter"><code>data</code></em>
when the
attribute is copied. If <code class="literal">NULL</code>, <em class="parameter"><code>data</code></em>
is simply
copied as a pointer. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>destroy_func</p></td>
<td class="parameter_description"><p>function to free <em class="parameter"><code>data</code></em>
when the
attribute is freed, or <code class="literal">NULL</code>. </p></td>
<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>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-shape-new-with-data.returns"></a><h4>Returns</h4>
<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
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>
</div>
<p class="since">Since: <a class="link" href="api-index-1-8.html#api-index-1.8">1.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrDataCopyFunc"></a><h3>PangoAttrDataCopyFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">gpointer</span>
<span class="c_punctuation">(</span>*PangoAttrDataCopyFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><span class="type">gconstpointer</span> user_data</code></em>);</pre>
<p>Type of a function that can duplicate user data for an attribute.</p>
<div class="refsect3">
<a name="PangoAttrDataCopyFunc.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data to copy</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="PangoAttrDataCopyFunc.returns"></a><h4>Returns</h4>
<p> new copy of <em class="parameter"><code>user_data</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-scale-new"></a><h3>pango_attr_scale_new ()</h3>
<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>
<p>Create a new font size scale attribute. The base font for the
affected text will have its size multiplied by <em class="parameter"><code>scale_factor</code></em>
.</p>
<div class="refsect3">
<a name="pango-attr-scale-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>scale_factor</p></td>
<td class="parameter_description"><p>factor to scale the font</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-scale-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-rise-new"></a><h3>pango_attr_rise_new ()</h3>
<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>
<p>Create a new baseline displacement attribute.</p>
<div class="refsect3">
<a name="pango-attr-rise-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>rise</p></td>
<td class="parameter_description"><p>the amount that the text should be displaced vertically,
in Pango units. Positive values displace the text upwards.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-rise-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-letter-spacing-new"></a><h3>pango_attr_letter_spacing_new ()</h3>
<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>
<p>Create a new letter-spacing attribute.</p>
<div class="refsect3">
<a name="pango-attr-letter-spacing-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>letter_spacing</p></td>
<td class="parameter_description"><p>amount of extra space to add between graphemes
of the text, in Pango units.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-letter-spacing-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-6.html#api-index-1.6">1.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-fallback-new"></a><h3>pango_attr_fallback_new ()</h3>
<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><span class="type">gboolean</span> enable_fallback</code></em>);</pre>
<p>Create a new font fallback attribute.</p>
<p>If fallback is disabled, characters will only be used from the
closest matching font on the system. No fallback will be done to
other fonts on the system that might contain the characters in the
text.</p>
<div class="refsect3">
<a name="pango-attr-fallback-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>enable_fallback</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if we should fall back on other fonts
for characters the active font is missing.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-fallback-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-4.html#api-index-1.4">1.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-gravity-new"></a><h3>pango_attr_gravity_new ()</h3>
<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" title="enum PangoGravity"><span class="type">PangoGravity</span></a> gravity</code></em>);</pre>
<p>Create a new gravity attribute.</p>
<div class="refsect3">
<a name="pango-attr-gravity-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>gravity</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-gravity-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-16.html#api-index-1.16">1.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-gravity-hint-new"></a><h3>pango_attr_gravity_hint_new ()</h3>
<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" title="enum PangoGravityHint"><span class="type">PangoGravityHint</span></a> hint</code></em>);</pre>
<p>Create a new gravity hint attribute.</p>
<div class="refsect3">
<a name="pango-attr-gravity-hint-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>hint</p></td>
<td class="parameter_description"><p>the gravity hint value.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-gravity-hint-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-16.html#api-index-1.16">1.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-font-features-new"></a><h3>pango_attr_font_features_new ()</h3>
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
pango_attr_font_features_new (<em class="parameter"><code>const <span class="type">gchar</span> *features</code></em>);</pre>
<p>Create a new font features tag attribute.</p>
<div class="refsect3">
<a name="pango-attr-font-features-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>features</p></td>
<td class="parameter_description"><p>a string with OpenType font features, in CSS syntax</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-font-features-new.returns"></a><h4>Returns</h4>
<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 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-38.html#api-index-1.38">1.38</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-foreground-alpha-new"></a><h3>pango_attr_foreground_alpha_new ()</h3>
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
pango_attr_foreground_alpha_new (<em class="parameter"><code><span class="type">guint16</span> alpha</code></em>);</pre>
<p>Create a new foreground alpha attribute.</p>
<div class="refsect3">
<a name="pango-attr-foreground-alpha-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>alpha</p></td>
<td class="parameter_description"><p>the alpha value, between 1 and 65536</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-foreground-alpha-new.returns"></a><h4>Returns</h4>
<p>the new allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-38.html#api-index-1.38">1.38</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-background-alpha-new"></a><h3>pango_attr_background_alpha_new ()</h3>
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="returnvalue">PangoAttribute</span></a> *
pango_attr_background_alpha_new (<em class="parameter"><code><span class="type">guint16</span> alpha</code></em>);</pre>
<p>Create a new background alpha attribute.</p>
<div class="refsect3">
<a name="pango-attr-background-alpha-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>alpha</p></td>
<td class="parameter_description"><p>the alpha value, between 1 and 65536</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-background-alpha-new.returns"></a><h4>Returns</h4>
<p>the new allocated <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>,
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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-38.html#api-index-1.38">1.38</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-color-parse"></a><h3>pango_color_parse ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
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>,
                   <em class="parameter"><code>const <span class="type">char</span> *spec</code></em>);</pre>
<p>Fill in the fields of a color from a string specification. The
string can either one of a large set of standard names. (Taken
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
value in the
form '#rgb' '#rrggbb' '#rrrgggbbb' or '#rrrrggggbbbb' where
'r', 'g' and 'b' are hex digits of the red, green, and blue
components of the color, respectively. (White in the four
forms is '#fff' '#ffffff' '#fffffffff' and '#ffffffffffff')</p>
<div class="refsect3">
<a name="pango-color-parse.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>color</p></td>
<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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>spec</p></td>
<td class="parameter_description"><p>a string specifying the new color</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-color-parse.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if parsing of the specifier succeeded,
otherwise false.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-color-copy"></a><h3>pango_color_copy ()</h3>
<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>
<p>Creates a copy of <em class="parameter"><code>src</code></em>
, which should 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>. Primarily used by language bindings,
not that useful otherwise (since colors can just be copied
by assignment in C).</p>
<div class="refsect3">
<a name="pango-color-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>src</p></td>
<td class="parameter_description"><p>color to copy, may be <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-color-copy.returns"></a><h4>Returns</h4>
<p>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>, which
should 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 <code class="literal">NULL</code> if
<em class="parameter"><code>src</code></em>
was <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-color-free"></a><h3>pango_color_free ()</h3>
<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>
<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>
<div class="refsect3">
<a name="pango-color-free.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>an allocated <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>, may be <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-color-to-string"></a><h3>pango_color_to_string ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
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>
<p>Returns a textual specification of <em class="parameter"><code>color</code></em>
 in the hexadecimal form
<code class="literal">#rrrrggggbbbb</code>, where <code class="literal">r</code>,
<code class="literal">g</code> and <code class="literal">b</code> are hex digits representing
the red, green, and blue components respectively.</p>
<div class="refsect3">
<a name="pango-color-to-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-color-to-string.returns"></a><h4>Returns</h4>
<p> a newly-allocated text string that must be freed with <code class="function">g_free()</code>.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-16.html#api-index-1.16">1.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-new"></a><h3>pango_attr_list_new ()</h3>
<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>
<p>Create a new empty attribute list with a reference count of one.</p>
<div class="refsect3">
<a name="pango-attr-list-new.returns"></a><h4>Returns</h4>
<p>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>,
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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-ref"></a><h3>pango_attr_list_ref ()</h3>
<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>
<p>Increase the reference count of the given attribute list by one.</p>
<div class="refsect3">
<a name="pango-attr-list-ref.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-list-ref.returns"></a><h4>Returns</h4>
<p> The attribute list passed in</p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-10.html#api-index-1.10">1.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-unref"></a><h3>pango_attr_list_unref ()</h3>
<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>
<p>Decrease the reference count of the given attribute list by one.
If the result is zero, free the attribute list and the attributes
it contains.</p>
<div class="refsect3">
<a name="pango-attr-list-unref.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-copy"></a><h3>pango_attr_list_copy ()</h3>
<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>
<p>Copy <em class="parameter"><code>list</code></em>
 and return an identical new list.</p>
<div class="refsect3">
<a name="pango-attr-list-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, may be <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-list-copy.returns"></a><h4>Returns</h4>
<p>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>, with a
reference count of one, 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>.
Returns <code class="literal">NULL</code> if <em class="parameter"><code>list</code></em>
was <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-insert"></a><h3>pango_attr_list_insert ()</h3>
<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>,
                        <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>
<p>Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
be inserted after all other attributes with a matching
<em class="parameter"><code>start_index</code></em>
.</p>
<div class="refsect3">
<a name="pango-attr-list-insert.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr</p></td>
<td class="parameter_description"><p>the attribute to insert. Ownership of this
value is assumed by the list. </p></td>
<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>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-insert-before"></a><h3>pango_attr_list_insert_before ()</h3>
<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>,
                               <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>
<p>Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
be inserted before all other attributes with a matching
<em class="parameter"><code>start_index</code></em>
.</p>
<div class="refsect3">
<a name="pango-attr-list-insert-before.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr</p></td>
<td class="parameter_description"><p>the attribute to insert. Ownership of this
value is assumed by the list. </p></td>
<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>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-change"></a><h3>pango_attr_list_change ()</h3>
<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>,
                        <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>
<p>Insert the given attribute into the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. It will
replace any attributes of the same type on that segment
and be merged with any adjoining attributes that are identical.</p>
<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
creating a attribute list in order (potentially much slower
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
suitable for continually changing a set of attributes
since it never removes or combines existing attributes.</p>
<div class="refsect3">
<a name="pango-attr-list-change.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr</p></td>
<td class="parameter_description"><p>the attribute to insert. Ownership of this
value is assumed by the list. </p></td>
<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>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-splice"></a><h3>pango_attr_list_splice ()</h3>
<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>,
                        <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *other</code></em>,
                        <em class="parameter"><code><span class="type">gint</span> pos</code></em>,
                        <em class="parameter"><code><span class="type">gint</span> len</code></em>);</pre>
<p>This function opens up a hole in <em class="parameter"><code>list</code></em>
, fills it in with attributes from
the left, and then merges <em class="parameter"><code>other</code></em>
 on top of the hole.</p>
<p>This operation is equivalent to stretching every attribute
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>
,
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
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>
<p>This operation proves useful for, for instance, inserting
a pre-edit string in the middle of an edit buffer.</p>
<div class="refsect3">
<a name="pango-attr-list-splice.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>other</p></td>
<td class="parameter_description"><p>another <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pos</p></td>
<td class="parameter_description"><p>the position in <em class="parameter"><code>list</code></em>
at which to insert <em class="parameter"><code>other</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>len</p></td>
<td class="parameter_description"><p>the length of the spliced segment. (Note that this
must be specified since the attributes in <em class="parameter"><code>other</code></em>
may only be present at some subsection of this range)</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-filter"></a><h3>pango_attr_list_filter ()</h3>
<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>,
                        <em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrFilterFunc" title="PangoAttrFilterFunc ()"><span class="type">PangoAttrFilterFunc</span></a> func</code></em>,
                        <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
<p>Given a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> and callback function, removes any elements
of <em class="parameter"><code>list</code></em>
 for which <em class="parameter"><code>func</code></em>
 returns <code class="literal">TRUE</code> and inserts them into
a new list.</p>
<div class="refsect3">
<a name="pango-attr-list-filter.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p>callback function; returns <code class="literal">TRUE</code>
if an attribute should be filtered out. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>Data to be passed to <em class="parameter"><code>func</code></em>
. </p></td>
<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>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-list-filter.returns"></a><h4>Returns</h4>
<p>the new <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> or
<code class="literal">NULL</code> if no attributes of the given types were found. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-1-2.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrFilterFunc"></a><h3>PangoAttrFilterFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<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>,
                        <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Type of a function filtering a list of attributes.</p>
<div class="refsect3">
<a name="PangoAttrFilterFunc.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>attribute</p></td>
<td class="parameter_description"><p>a Pango attribute</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data passed to the function</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="PangoAttrFilterFunc.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the attribute should be selected for
filtering, <code class="literal">FALSE</code> otherwise.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-list-get-iterator"></a><h3>pango_attr_list_get_iterator ()</h3>
<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>
<p>Create a iterator initialized to the beginning of the list.
<em class="parameter"><code>list</code></em>
 must not be modified until this iterator is freed.</p>
<div class="refsect3">
<a name="pango-attr-list-get-iterator.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-list-get-iterator.returns"></a><h4>Returns</h4>
<p>the newly allocated <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>, which should
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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-iterator-copy"></a><h3>pango_attr_iterator_copy ()</h3>
<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>
<p>Copy a <a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a></p>
<div class="refsect3">
<a name="pango-attr-iterator-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>iterator</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-iterator-copy.returns"></a><h4>Returns</h4>
<p>the newly allocated
<a class="link" href="pango-Text-Attributes.html#PangoAttrIterator" title="PangoAttrIterator"><span class="type">PangoAttrIterator</span></a>, which should 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>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-iterator-next"></a><h3>pango_attr_iterator_next ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
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>
<p>Advance the iterator until the next change of style.</p>
<div class="refsect3">
<a name="pango-attr-iterator-next.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>iterator</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-iterator-next.returns"></a><h4>Returns</h4>
<p> <code class="literal">FALSE</code> if the iterator is at the end of the list, otherwise <code class="literal">TRUE</code></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-iterator-range"></a><h3>pango_attr_iterator_range ()</h3>
<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>,
                           <em class="parameter"><code><span class="type">gint</span> *start</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> *end</code></em>);</pre>
<p>Get the range of the current segment. Note that the
stored return values are signed, not unsigned like
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
oversight, stored return values that wouldn't fit into
a signed integer are clamped to <code class="literal">G_MAXINT</code>.</p>
<div class="refsect3">
<a name="pango-attr-iterator-range.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iterator</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>start</p></td>
<td class="parameter_description"><p>location to store the start of the range. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>end</p></td>
<td class="parameter_description"><p>location to store the end of the range. </p></td>
<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>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-iterator-get"></a><h3>pango_attr_iterator_get ()</h3>
<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>,
                         <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>
<p>Find the current attribute of a particular type at the iterator
location. When multiple attributes of the same type overlap,
the attribute whose range starts closest to the current location
is used.</p>
<div class="refsect3">
<a name="pango-attr-iterator-get.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iterator</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>the type of attribute to find.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-iterator-get.returns"></a><h4>Returns</h4>
<p>the current attribute of the given type,
or <code class="literal">NULL</code> if no attribute of that type applies to the
current location. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-iterator-get-font"></a><h3>pango_attr_iterator_get_font ()</h3>
<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>,
                              <em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> *desc</code></em>,
                              <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> **language</code></em>,
                              <em class="parameter"><code><span class="type">GSList</span> **extra_attrs</code></em>);</pre>
<p>Get the font and other attributes at the current iterator position.</p>
<div class="refsect3">
<a name="pango-attr-iterator-get-font.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iterator</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>desc</p></td>
<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.
The family name in this structure will be set using
<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
an attribute in the <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> associated with the iterator,
so if you plan to keep it around, you must call:
<code class="literal">pango_font_description_set_family (desc, pango_font_description_get_family (desc))</code>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>language</p></td>
<td class="parameter_description"><p>if non-<code class="literal">NULL</code>, location to store language tag for item, or <code class="literal">NULL</code>
if none is found. </p></td>
<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>
</tr>
<tr>
<td class="parameter_name"><p>extra_attrs</p></td>
<td class="parameter_description"><p>if non-<code class="literal">NULL</code>,
location in which to store a list of non-font
attributes at the the current position; only the highest priority
value of each attribute will be added to this list. In order
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
each member. </p></td>
<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>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-iterator-get-attrs"></a><h3>pango_attr_iterator_get_attrs ()</h3>
<pre class="programlisting"><span class="returnvalue">GSList</span> *
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>
<p>Gets a list of all attributes at the current position of the
iterator.</p>
<div class="refsect3">
<a name="pango-attr-iterator-get-attrs.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>iterator</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="pango-attr-iterator-get-attrs.returns"></a><h4>Returns</h4>
<p>a list of
all attributes for the current range.
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
each value and <code class="function">g_slist_free()</code> on the list. </p>
<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>
</div>
<p class="since">Since: <a class="link" href="api-index-1-2.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="pango-attr-iterator-destroy"></a><h3>pango_attr_iterator_destroy ()</h3>
<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>
<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>
<div class="refsect3">
<a name="pango-attr-iterator-destroy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>iterator</p></td>
<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>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="pango-Text-Attributes.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="PangoAttrType"></a><h3>enum PangoAttrType</h3>
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrType" title="enum PangoAttrType"><span class="type">PangoAttrType</span></a>
distinguishes between different types of attributes. Along with the
predefined values, it is possible to allocate additional values
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
values are given below. The type of structure used to store the
attribute is listed in parentheses after the description.</p>
<div class="refsect3">
<a name="PangoAttrType.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-INVALID:CAPS"></a>PANGO_ATTR_INVALID</p></td>
<td class="enum_member_description">
<p>does not happen</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-LANGUAGE:CAPS"></a>PANGO_ATTR_LANGUAGE</p></td>
<td class="enum_member_description">
<p>language (<a class="link" href="pango-Text-Attributes.html#PangoAttrLanguage" title="struct PangoAttrLanguage"><span class="type">PangoAttrLanguage</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-FAMILY:CAPS"></a>PANGO_ATTR_FAMILY</p></td>
<td class="enum_member_description">
<p>font family name list (<a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString"><span class="type">PangoAttrString</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-STYLE:CAPS"></a>PANGO_ATTR_STYLE</p></td>
<td class="enum_member_description">
<p>font slant style (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-WEIGHT:CAPS"></a>PANGO_ATTR_WEIGHT</p></td>
<td class="enum_member_description">
<p>font weight (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-VARIANT:CAPS"></a>PANGO_ATTR_VARIANT</p></td>
<td class="enum_member_description">
<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>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-STRETCH:CAPS"></a>PANGO_ATTR_STRETCH</p></td>
<td class="enum_member_description">
<p>font stretch (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-SIZE:CAPS"></a>PANGO_ATTR_SIZE</p></td>
<td class="enum_member_description">
<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>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-FONT-DESC:CAPS"></a>PANGO_ATTR_FONT_DESC</p></td>
<td class="enum_member_description">
<p>font description (<a class="link" href="pango-Text-Attributes.html#PangoAttrFontDesc" title="struct PangoAttrFontDesc"><span class="type">PangoAttrFontDesc</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-FOREGROUND:CAPS"></a>PANGO_ATTR_FOREGROUND</p></td>
<td class="enum_member_description">
<p>foreground color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-BACKGROUND:CAPS"></a>PANGO_ATTR_BACKGROUND</p></td>
<td class="enum_member_description">
<p>background color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-UNDERLINE:CAPS"></a>PANGO_ATTR_UNDERLINE</p></td>
<td class="enum_member_description">
<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>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-STRIKETHROUGH:CAPS"></a>PANGO_ATTR_STRIKETHROUGH</p></td>
<td class="enum_member_description">
<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>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-RISE:CAPS"></a>PANGO_ATTR_RISE</p></td>
<td class="enum_member_description">
<p>baseline displacement (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-SHAPE:CAPS"></a>PANGO_ATTR_SHAPE</p></td>
<td class="enum_member_description">
<p>shape (<a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape"><span class="type">PangoAttrShape</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-SCALE:CAPS"></a>PANGO_ATTR_SCALE</p></td>
<td class="enum_member_description">
<p>font size scale factor (<a class="link" href="pango-Text-Attributes.html#PangoAttrFloat" title="struct PangoAttrFloat"><span class="type">PangoAttrFloat</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-FALLBACK:CAPS"></a>PANGO_ATTR_FALLBACK</p></td>
<td class="enum_member_description">
<p>whether fallback is enabled (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-LETTER-SPACING:CAPS"></a>PANGO_ATTR_LETTER_SPACING</p></td>
<td class="enum_member_description">
<p>letter spacing (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-UNDERLINE-COLOR:CAPS"></a>PANGO_ATTR_UNDERLINE_COLOR</p></td>
<td class="enum_member_description">
<p>underline color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-STRIKETHROUGH-COLOR:CAPS"></a>PANGO_ATTR_STRIKETHROUGH_COLOR</p></td>
<td class="enum_member_description">
<p>strikethrough color (<a class="link" href="pango-Text-Attributes.html#PangoAttrColor" title="struct PangoAttrColor"><span class="type">PangoAttrColor</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-ABSOLUTE-SIZE:CAPS"></a>PANGO_ATTR_ABSOLUTE_SIZE</p></td>
<td class="enum_member_description">
<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>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-GRAVITY:CAPS"></a>PANGO_ATTR_GRAVITY</p></td>
<td class="enum_member_description">
<p>base text gravity (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-GRAVITY-HINT:CAPS"></a>PANGO_ATTR_GRAVITY_HINT</p></td>
<td class="enum_member_description">
<p>gravity hint (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-FONT-FEATURES:CAPS"></a>PANGO_ATTR_FONT_FEATURES</p></td>
<td class="enum_member_description">
<p>OpenType font features (<a class="link" href="pango-Text-Attributes.html#PangoAttrString" title="struct PangoAttrString"><span class="type">PangoAttrString</span></a>). Since 1.38</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-FOREGROUND-ALPHA:CAPS"></a>PANGO_ATTR_FOREGROUND_ALPHA</p></td>
<td class="enum_member_description">
<p>foreground alpha (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>). Since 1.38</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-ATTR-BACKGROUND-ALPHA:CAPS"></a>PANGO_ATTR_BACKGROUND_ALPHA</p></td>
<td class="enum_member_description">
<p>background alpha (<a class="link" href="pango-Text-Attributes.html#PangoAttrInt" title="struct PangoAttrInt"><span class="type">PangoAttrInt</span></a>). Since 1.38</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-TYPE-ATTR-TYPE:CAPS"></a><h3>PANGO_TYPE_ATTR_TYPE</h3>
<pre class="programlisting">#define PANGO_TYPE_ATTR_TYPE (pango_attr_type_get_type ())
</pre>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrClass"></a><h3>struct PangoAttrClass</h3>
<pre class="programlisting">struct PangoAttrClass {
  PangoAttrType type;
  PangoAttribute * (*copy) (const PangoAttribute *attr);
  void             (*destroy) (PangoAttribute *attr);
  gboolean         (*equal) (const PangoAttribute *attr1, const PangoAttribute *attr2);
};
</pre>
<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
a particular type of attribute. The functions in this structure should
not be called directly. Instead, one should use the wrapper functions
provided for <a class="link" href="pango-Text-Attributes.html#PangoAttribute" title="struct PangoAttribute"><span class="type">PangoAttribute</span></a>.</p>
<div class="refsect3">
<a name="PangoAttrClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the type ID for this attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoAttrClass.copy"></a>copy</code></em> ()</p></td>
<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>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoAttrClass.destroy"></a>destroy</code></em> ()</p></td>
<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>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="PangoAttrClass.equal"></a>equal</code></em> ()</p></td>
<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>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttribute"></a><h3>struct PangoAttribute</h3>
<pre class="programlisting">struct PangoAttribute {
  const PangoAttrClass *klass;
  guint start_index; /* in bytes */
  guint end_index; /* in bytes. The character at this index is not included */
};
</pre>
<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
attributes. Particular types of attributes include this structure
as their initial portion. The common portion of the attribute holds
the range to which the value in the type-specific part of the attribute
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>.
By default an attribute will have an all-inclusive range of [0,<code class="literal">G_MAXUINT</code>].</p>
<div class="refsect3">
<a name="PangoAttribute.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the class structure holding information about the type of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint</span> <em class="structfield"><code><a name="PangoAttribute.start-index"></a>start_index</code></em>;</p></td>
<td class="struct_member_description"><p>the start index of the range (in bytes).</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint</span> <em class="structfield"><code><a name="PangoAttribute.end-index"></a>end_index</code></em>;</p></td>
<td class="struct_member_description"><p>end index of the range (in bytes). The character at this index
is not included in the range.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-ATTR-INDEX-FROM-TEXT-BEGINNING:CAPS"></a><h3>PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING</h3>
<pre class="programlisting">#define PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING 0
</pre>
<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>
such that the attribute covers from the beginning of the text.</p>
<p class="since">Since: <a class="link" href="api-index-1-24.html#api-index-1.24">1.24</a></p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-ATTR-INDEX-TO-TEXT-END:CAPS"></a><h3>PANGO_ATTR_INDEX_TO_TEXT_END</h3>
<pre class="programlisting">#define PANGO_ATTR_INDEX_TO_TEXT_END		G_MAXUINT
</pre>
<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>
such that the attribute covers to the end of the text.</p>
<p class="since">Since: <a class="link" href="api-index-1-24.html#api-index-1.24">1.24</a></p>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrString"></a><h3>struct PangoAttrString</h3>
<pre class="programlisting">struct PangoAttrString {
  PangoAttribute attr;
  char *value;
};
</pre>
<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
a string value.</p>
<div class="refsect3">
<a name="PangoAttrString.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<td class="struct_member_description"><p>the string which is the value of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrLanguage"></a><h3>struct PangoAttrLanguage</h3>
<pre class="programlisting">struct PangoAttrLanguage {
  PangoAttribute attr;
  PangoLanguage *value;
};
</pre>
<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
are languages.</p>
<div class="refsect3">
<a name="PangoAttrLanguage.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<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>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrColor"></a><h3>struct PangoAttrColor</h3>
<pre class="programlisting">struct PangoAttrColor {
  PangoAttribute attr;
  PangoColor color;
};
</pre>
<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
are colors.</p>
<div class="refsect3">
<a name="PangoAttrColor.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<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>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrInt"></a><h3>struct PangoAttrInt</h3>
<pre class="programlisting">struct PangoAttrInt {
  PangoAttribute attr;
  int value;
};
</pre>
<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
an integer or enumeration value.</p>
<div class="refsect3">
<a name="PangoAttrInt.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<td class="struct_member_description"><p>the value of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrFloat"></a><h3>struct PangoAttrFloat</h3>
<pre class="programlisting">struct PangoAttrFloat {
  PangoAttribute attr;
  double value;
};
</pre>
<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
a float or double value.</p>
<div class="refsect3">
<a name="PangoAttrFloat.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<td class="struct_member_description"><p>the value of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrFontDesc"></a><h3>struct PangoAttrFontDesc</h3>
<pre class="programlisting">struct PangoAttrFontDesc {
  PangoAttribute attr;
  PangoFontDescription *desc;
};
</pre>
<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
sets all aspects of the font description at once.</p>
<div class="refsect3">
<a name="PangoAttrFontDesc.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<td class="struct_member_description"><p>the font description which is the value of this attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrShape"></a><h3>struct PangoAttrShape</h3>
<pre class="programlisting">struct PangoAttrShape {
  PangoAttribute attr;
  PangoRectangle ink_rect;
  PangoRectangle logical_rect;

  gpointer              data;
  PangoAttrDataCopyFunc copy_func;
  GDestroyNotify        destroy_func;
};
</pre>
<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
impose shape restrictions.</p>
<div class="refsect3">
<a name="PangoAttrShape.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<td class="struct_member_description"><p>the ink rectangle to restrict to</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<td class="struct_member_description"><p>the logical rectangle to restrict to</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">gpointer</span> <em class="structfield"><code><a name="PangoAttrShape.data"></a>data</code></em>;</p></td>
<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>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<td class="struct_member_description"><p>copy function for the user data</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GDestroyNotify</span> <em class="structfield"><code><a name="PangoAttrShape.destroy-func"></a>destroy_func</code></em>;</p></td>
<td class="struct_member_description"><p>destroy function for the user data</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrSize"></a><h3>struct PangoAttrSize</h3>
<pre class="programlisting">struct PangoAttrSize {
  PangoAttribute attr;
  int size;
  guint absolute : 1;
};
</pre>
<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
set font size.</p>
<div class="refsect3">
<a name="PangoAttrSize.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<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>
<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
<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>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint</span> <em class="structfield"><code><a name="PangoAttrSize.absolute"></a>absolute</code></em> : 1;</p></td>
<td class="struct_member_description"><p>whether the font size is in device units or points.
This field is only present for compatibility with Pango-1.8.0
(<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
be <code class="literal">FALSE</code> for <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-SIZE:CAPS"><code class="literal">PANGO_ATTR_SIZE</code></a> and <code class="literal">TRUE</code> 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>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrFontFeatures"></a><h3>struct PangoAttrFontFeatures</h3>
<pre class="programlisting">struct PangoAttrFontFeatures {
  PangoAttribute attr;
  gchar *features;
};
</pre>
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrFontFeatures" title="struct PangoAttrFontFeatures"><span class="type">PangoAttrFontFeatures</span></a> structure is used to represent OpenType
font features as an attribute.</p>
<div class="refsect3">
<a name="PangoAttrFontFeatures.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<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="PangoAttrFontFeatures.attr"></a>attr</code></em>;</p></td>
<td class="struct_member_description"><p>the common portion of the attribute</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">gchar</span> *<em class="structfield"><code><a name="PangoAttrFontFeatures.features"></a>features</code></em>;</p></td>
<td class="struct_member_description"><p>the featues, as a string in CSS syntax</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-1-38.html#api-index-1.38">1.38</a></p>
</div>
<hr>
<div class="refsect2">
<a name="PangoUnderline"></a><h3>enum PangoUnderline</h3>
<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
whether text should be underlined, and if so, the type
of underlining.</p>
<div class="refsect3">
<a name="PangoUnderline.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-NONE:CAPS"></a>PANGO_UNDERLINE_NONE</p></td>
<td class="enum_member_description">
<p>no underline should be drawn</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-SINGLE:CAPS"></a>PANGO_UNDERLINE_SINGLE</p></td>
<td class="enum_member_description">
<p>a single underline should be drawn</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-DOUBLE:CAPS"></a>PANGO_UNDERLINE_DOUBLE</p></td>
<td class="enum_member_description">
<p>a double underline should be drawn</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-LOW:CAPS"></a>PANGO_UNDERLINE_LOW</p></td>
<td class="enum_member_description">
<p>a single underline should be drawn at a position
beneath the ink extents of the text being
underlined. This should be used only for underlining
single characters, such as for keyboard
accelerators. <a class="link" href="pango-Text-Attributes.html#PANGO-UNDERLINE-SINGLE:CAPS"><code class="literal">PANGO_UNDERLINE_SINGLE</code></a> should
be used for extended portions of text.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="PANGO-UNDERLINE-ERROR:CAPS"></a>PANGO_UNDERLINE_ERROR</p></td>
<td class="enum_member_description">
<p>a wavy underline should be drawn below.
This underline is typically used to indicate
an error such as a possilble mispelling; in some
cases a contrasting color may automatically
be used. This type of underlining is available since Pango 1.4.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-TYPE-UNDERLINE:CAPS"></a><h3>PANGO_TYPE_UNDERLINE</h3>
<pre class="programlisting">#define PANGO_TYPE_UNDERLINE (pango_underline_get_type ())
</pre>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-SCALE-XX-SMALL:CAPS"></a><h3>PANGO_SCALE_XX_SMALL</h3>
<pre class="programlisting">#define PANGO_SCALE_XX_SMALL ((double)0.5787037037037)
</pre>
<p>The scale factor for three shrinking steps (1 / (1.2 * 1.2 * 1.2)).</p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-SCALE-X-SMALL:CAPS"></a><h3>PANGO_SCALE_X_SMALL</h3>
<pre class="programlisting">#define PANGO_SCALE_X_SMALL  ((double)0.6444444444444)
</pre>
<p>The scale factor for two shrinking steps (1 / (1.2 * 1.2)).</p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-SCALE-SMALL:CAPS"></a><h3>PANGO_SCALE_SMALL</h3>
<pre class="programlisting">#define PANGO_SCALE_SMALL    ((double)0.8333333333333)
</pre>
<p>The scale factor for one shrinking step (1 / 1.2).</p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-SCALE-MEDIUM:CAPS"></a><h3>PANGO_SCALE_MEDIUM</h3>
<pre class="programlisting">#define PANGO_SCALE_MEDIUM   ((double)1.0)
</pre>
<p>The scale factor for normal size (1.0).</p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-SCALE-LARGE:CAPS"></a><h3>PANGO_SCALE_LARGE</h3>
<pre class="programlisting">#define PANGO_SCALE_LARGE    ((double)1.2)
</pre>
<p>The scale factor for one magnification step (1.2).</p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-SCALE-X-LARGE:CAPS"></a><h3>PANGO_SCALE_X_LARGE</h3>
<pre class="programlisting">#define PANGO_SCALE_X_LARGE  ((double)1.4399999999999)
</pre>
<p>The scale factor for two magnification steps (1.2 * 1.2).</p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-SCALE-XX-LARGE:CAPS"></a><h3>PANGO_SCALE_XX_LARGE</h3>
<pre class="programlisting">#define PANGO_SCALE_XX_LARGE ((double)1.728)
</pre>
<p>The scale factor for three magnification steps (1.2 * 1.2 * 1.2).</p>
</div>
<hr>
<div class="refsect2">
<a name="PangoColor-struct"></a><h3>struct PangoColor</h3>
<pre class="programlisting">struct PangoColor {
  guint16 red;
  guint16 green;
  guint16 blue;
};
</pre>
<p>The <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> structure is used to
represent a color in an uncalibrated RGB color-space.</p>
<div class="refsect3">
<a name="PangoColor.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><span class="type">guint16</span> <em class="structfield"><code><a name="PangoColor-struct.red"></a>red</code></em>;</p></td>
<td class="struct_member_description"><p>value of red component</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint16</span> <em class="structfield"><code><a name="PangoColor-struct.green"></a>green</code></em>;</p></td>
<td class="struct_member_description"><p>value of green component</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint16</span> <em class="structfield"><code><a name="PangoColor-struct.blue"></a>blue</code></em>;</p></td>
<td class="struct_member_description"><p>value of blue component</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-TYPE-COLOR:CAPS"></a><h3>PANGO_TYPE_COLOR</h3>
<pre class="programlisting">#define PANGO_TYPE_COLOR pango_color_get_type ()
</pre>
<p>The <span class="type">GObject</span> type for <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a>.</p>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrList-struct"></a><h3>PangoAttrList</h3>
<pre class="programlisting">typedef struct _PangoAttrList PangoAttrList;</pre>
<p>The <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> structure represents a list of attributes
that apply to a section of text. The attributes are, in general,
allowed to overlap in an arbitrary fashion, however, if the
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>,
the overlap between properties will meet stricter criteria.</p>
<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,
it is not suitable for storing attributes for large amounts
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>
for more than one paragraph of text.</p>
</div>
<hr>
<div class="refsect2">
<a name="PANGO-TYPE-ATTR-LIST:CAPS"></a><h3>PANGO_TYPE_ATTR_LIST</h3>
<pre class="programlisting">#define PANGO_TYPE_ATTR_LIST pango_attr_list_get_type ()
</pre>
<p>The <span class="type">GObject</span> type for <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>.</p>
</div>
<hr>
<div class="refsect2">
<a name="PangoAttrIterator"></a><h3>PangoAttrIterator</h3>
<pre class="programlisting">typedef struct _PangoAttrIterator PangoAttrIterator;</pre>
<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
iterator through a <a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>. A new iterator is created
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
is created, it can be advanced through the style changes
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
style change, the range of the current style segment and the
attributes currently in effect can be queried.</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.28</div>
</body>
</html>

Powered by Pagure 5.14.1

SSH Hostkey/Fingerprint | Documentation