<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>gtkmm 2.4: Pango::Context Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head>
<body bgcolor="#ffffff">
<table border="0" width="100%">
<tr>
<td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td>
<td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td>
</tr>
</table>
<center>
<a class="qindex" href="../../index.html">Main Page</a>
<a href="group__Widgets.html">Widgets</a>
<a class="qindex" href="namespaces.html"> Namespaces</a>
<a href="../../tutorial/html/index.html"> Book</a>
</center>
<hr width="100%"/>
<!-- begin main content -->
<div id="content">
<!-- Generated by Doxygen 1.5.1 -->
<div class="nav">
<a class="el" href="namespacePango.html">Pango</a>::<a class="el" href="classPango_1_1Context.html">Context</a></div>
<h1>Pango::Context Class Reference</h1><!-- doxytag: class="Pango::Context" --><!-- doxytag: inherits="Glib::Object" -->Inheritance diagram for Pango::Context:<p><center><img src="classPango_1_1Context__inherit__graph.png" border="0" usemap="#Pango_1_1Context__inherit__map" alt="Inheritance graph"></center>
<map name="Pango_1_1Context__inherit__map">
<area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1Object.html" shape="rect" coords="21,161,115,188" alt="">
<area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ObjectBase.html" shape="rect" coords="5,84,131,111" alt="">
<area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classsigc_1_1trackable.html" shape="rect" coords="12,7,124,33" alt="">
</map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classPango_1_1Context-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
A <a class="el" href="classPango_1_1Context.html">Pango::Context</a> stores global information used to control the itemization process.
<p>
You can retrieve a <a class="el" href="classPango_1_1Context.html">Pango::Context</a> object with <a class="el" href="classGtk_1_1Widget.html#037efd7a9033e4b66a17cbf3f6948256">Gtk::Widget::create_pango_context()</a> or <a class="el" href="classGtk_1_1Widget.html#0be06b45418ec17f992eb3acf89cd0b8">Gtk::Widget::get_pango_context()</a>. If you don't use gtkmm call some c function of the pango backend you intend to use and create a wrapper for the returned context, e.g. <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap</a>(pango_x_get_context()).<p>
Creating a <a class="el" href="classPango_1_1Context.html">Pango::Context</a> object is the starting point of every rendering process. You can either use it to create a high level <a class="el" href="classPango_1_1Layout.html">Pango::Layout</a> object which does all the hard work for you by passing it into <a class="el" href="classPango_1_1Layout.html#563434509d35cab69c4e85b7549a7bf9">Pango::Layout::create()</a> or to generate glyph strings from character strings with the help of <a class="el" href="classPango_1_1Context.html#dd1982bdccb054f2dc39e17b156d59bc">itemize()</a> and <a class="el" href="classPango_1_1Item.html#5de294536fc8bdf3d3be6de107c10a1d">Pango::Item::shape()</a> subsequently.<p>
Which fonts are used for rendering can be influenced by setting the default font description, language and base direction of the context.<p>
If you want to calculate the space some text will need to be displayed you might find the functions of <a class="el" href="classPango_1_1FontMetrics.html">Pango::FontMetrics</a> useful. Use <a class="el" href="classPango_1_1Context.html#a506bd1a380659fbc922347813cb7a2c">get_metrics()</a> to obtain the <a class="el" href="classPango_1_1FontMetrics.html">Pango::FontMetrics</a> object for a specific <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a>. For more detailed calculations in a rendering-system-independant manner and to determine whether specific characters can be represented by the font that would be used for a specific <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a> load a <a class="el" href="classPango_1_1Fontset.html">Pango::Fontset</a> with <a class="el" href="classPango_1_1Context.html#bfca9cb1a42475143183534d09bb6be8">load_fontset()</a> (<a class="el" href="classPango_1_1Context.html#f439c9a43237d2fc4a99914306560793">load_font()</a> returns the <a class="el" href="classPango_1_1Font.html">Pango::Font</a> that is the closest match for a <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a>; however that's not necessarily the font that will be used for rendering).
<p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__pangommEnums.html#g8fa031ece55a28777a84d0115829f601">Direction</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#7187329b8665fbb5ac086c5d1fb1ca64">get_base_dir</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the base direction for the context. <a href="#7187329b8665fbb5ac086c5d1fb1ca64"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__pangommEnums.html#g64db2216c86f2ce624b9ef0489bf1df4">Gravity</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#42be767f32c15536566b2b0627b231d1">get_base_gravity</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the base gravity for the context. <a href="#42be767f32c15536566b2b0627b231d1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classPango_1_1FontDescription.html">FontDescription</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#a1bdad3ae1d86d997d8fcaebdeba9226">get_font_description</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the default font description for the context. <a href="#a1bdad3ae1d86d997d8fcaebdeba9226"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classPango_1_1FontMap.html">FontMap</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#ed8b689506ac9ffe1538ddc6e0ac6130">get_font_map</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the Pango::Fontmap used to look up fonts for this context. <a href="#ed8b689506ac9ffe1538ddc6e0ac6130"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1FontMap.html">FontMap</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#56eb6d8dde7e58e820aa717214e39345">get_font_map</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the Pango::Fontmap used to look up fonts for this context. <a href="#56eb6d8dde7e58e820aa717214e39345"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">Cairo::FontOptions </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#09a487a86b9458c7a027d0d2a0d3e3ed">get_font_options</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves any font rendering options previously set with pango_cairo_font_map_set_font_options(). <a href="#09a487a86b9458c7a027d0d2a0d3e3ed"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__pangommEnums.html#g64db2216c86f2ce624b9ef0489bf1df4">Gravity</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#7fb91175786b41e1edd560d1d39904f2">get_gravity</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the gravity for the context. <a href="#7fb91175786b41e1edd560d1d39904f2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__pangommEnums.html#g405d1530ab8ac4993a0921a27fe035dd">GravityHint</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#dbc0f80f74702be4a220ef4a8007dfc1">get_gravity_hint</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the gravity hint for the context. <a href="#dbc0f80f74702be4a220ef4a8007dfc1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classPango_1_1Language.html">Language</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#c53dcbad3b801397d3168850bc6e3aee">get_language</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the global language tag for the context. <a href="#c53dcbad3b801397d3168850bc6e3aee"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="namespacePango.html#5565a2f93d4fb8f943cc2d1fb2d476e1">Matrix</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#c0b2104171d02ca53bb02593fb5adaae">get_matrix</a> () const</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classPango_1_1FontMetrics.html">FontMetrics</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#fb26cf3e1bdaae0d920e4728e654fa42">get_metrics</a> (const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& desc, const <a class="el" href="classPango_1_1Language.html">Language</a>& language) const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get overall metric information for a font particular font description. <a href="#fb26cf3e1bdaae0d920e4728e654fa42"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classPango_1_1FontMetrics.html">FontMetrics</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#a506bd1a380659fbc922347813cb7a2c">get_metrics</a> (const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& desc) const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get overall metric information for a particular font description. <a href="#a506bd1a380659fbc922347813cb7a2c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#ed78a8c0b95b43dc69d52325b13ee20e">get_resolution</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the resolution for the context. <a href="#ed78a8c0b95b43dc69d52325b13ee20e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const PangoContext* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#d66d1b28683c6b1fb2a3cb2f9517ec28">gobj</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#d66d1b28683c6b1fb2a3cb2f9517ec28"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">PangoContext* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#0be484ab187e1e8fc7be2940ec4cb615">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#0be484ab187e1e8fc7be2940ec4cb615"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">PangoContext* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#a639f1fff0f0197e2f2a74ebe6cfe926">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#a639f1fff0f0197e2f2a74ebe6cfe926"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ListHandle.html">ListHandle_Item</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#caabc75858fee895b9685a63272e3178">itemize</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text, int start_index, int length, const <a class="el" href="classPango_1_1AttrList.html">AttrList</a>& attrs, <a class="el" href="classPango_1_1AttrIter.html">AttrIter</a>& cached_iter) const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Breaks a piece of text into segments with consistent directional level and shaping engine. <a href="#caabc75858fee895b9685a63272e3178"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ListHandle.html">ListHandle_Item</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#dd1982bdccb054f2dc39e17b156d59bc">itemize</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text, const <a class="el" href="classPango_1_1AttrList.html">AttrList</a>& attrs) const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Breaks a piece of text into segments with consistent directional level and shaping engine. <a href="#dd1982bdccb054f2dc39e17b156d59bc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<br>
<a class="el" href="classPango_1_1FontFamily.html">FontFamily</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#0f67507a8df1f68daf9456cdac732ac6">list_families</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">List all available font families for a context. <a href="#0f67507a8df1f68daf9456cdac732ac6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Font.html">Font</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#f439c9a43237d2fc4a99914306560793">load_font</a> (const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& desc) const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Loads the font in one of the fontmaps in the context that is the closest match for <em>desc</em> . <a href="#f439c9a43237d2fc4a99914306560793"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Fontset.html">Fontset</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#bfca9cb1a42475143183534d09bb6be8">load_fontset</a> (const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& desc, const <a class="el" href="classPango_1_1Language.html">Language</a>& language) const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Load a set of fonts in the context that can be used to render a font matching <em>desc</em> . <a href="#bfca9cb1a42475143183534d09bb6be8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#2f2e234bb53c20eff53ed8f1e51e460f">set_base_dir</a> (<a class="el" href="group__pangommEnums.html#g8fa031ece55a28777a84d0115829f601">Direction</a> direction)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the base direction for the context. <a href="#2f2e234bb53c20eff53ed8f1e51e460f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#fc55b428fe56632e44c7d528eb27c037">set_base_gravity</a> (<a class="el" href="group__pangommEnums.html#g64db2216c86f2ce624b9ef0489bf1df4">Gravity</a> gravity)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the base gravity for the context. <a href="#fc55b428fe56632e44c7d528eb27c037"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#5f80cbc5c97fb4ef0152f559096bea6c">set_cairo_font_options</a> (const Cairo::FontOptions& options)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the font options used when rendering text with this context. <a href="#5f80cbc5c97fb4ef0152f559096bea6c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#90ba5091c7a3177c4b3e49840b64192a">set_font_description</a> (const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& desc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the default font description for the context. <a href="#90ba5091c7a3177c4b3e49840b64192a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#86b50228ad45a1bb81136519aea95915">set_gravity_hint</a> (<a class="el" href="group__pangommEnums.html#g405d1530ab8ac4993a0921a27fe035dd">GravityHint</a> hint)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the gravity hint for the context. <a href="#86b50228ad45a1bb81136519aea95915"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#20a1d003027b28404ae547118a1d6d80">set_language</a> (const <a class="el" href="classPango_1_1Language.html">Language</a>& language)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the global language tag for the context. <a href="#20a1d003027b28404ae547118a1d6d80"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#e3e16a984e6c1bb2d8066201b4594da5">set_matrix</a> (const <a class="el" href="namespacePango.html#5565a2f93d4fb8f943cc2d1fb2d476e1">Matrix</a>& matrix)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the transformation matrix that will be applied when rendering with this context. <a href="#e3e16a984e6c1bb2d8066201b4594da5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#e912e733915cc5b48124a4aa913c6a7f">set_resolution</a> (double dpi)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the resolution for the context. <a href="#e912e733915cc5b48124a4aa913c6a7f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#cc6707edbfcbbe79f6e3c540ddfa6eb1">update_from_cairo_context</a> (const Cairo::RefPtr<Cairo::Context>& context)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Updates a <a class="el" href="namespacePango.html">Pango</a> <a class="el" href="classPango_1_1Context.html">Context</a> previously created for use with Cairo to match the current transformation and target surface of a Cairo <a class="el" href="classPango_1_1Context.html">Context</a>. <a href="#cc6707edbfcbbe79f6e3c540ddfa6eb1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#c2a31a067989f07530ecaf0907b62d12">~Context</a> ()</td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#4cce2632218899d3cc6e04c4c2d860af">Context</a> ()</td></tr>
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Context.html">Pango::Context</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1Context.html#c61523c7c5af185d2c5ce7ce5706c3b4">wrap</a> (PangoContext* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#c61523c7c5af185d2c5ce7ce5706c3b4"></a><br></td></tr>
</table>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="c2a31a067989f07530ecaf0907b62d12"></a><!-- doxytag: member="Pango::Context::~Context" ref="c2a31a067989f07530ecaf0907b62d12" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Pango::Context::~Context </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="4cce2632218899d3cc6e04c4c2d860af"></a><!-- doxytag: member="Pango::Context::Context" ref="4cce2632218899d3cc6e04c4c2d860af" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Pango::Context::Context </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="7187329b8665fbb5ac086c5d1fb1ca64"></a><!-- doxytag: member="Pango::Context::get_base_dir" ref="7187329b8665fbb5ac086c5d1fb1ca64" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__pangommEnums.html#g8fa031ece55a28777a84d0115829f601">Direction</a> Pango::Context::get_base_dir </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieves the base direction for the context.
<p>
See pango_context_set_base_dir(). <dl class="return" compact><dt><b>Returns:</b></dt><dd>The base direction for the context. </dd></dl>
</div>
</div><p>
<a class="anchor" name="42be767f32c15536566b2b0627b231d1"></a><!-- doxytag: member="Pango::Context::get_base_gravity" ref="42be767f32c15536566b2b0627b231d1" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__pangommEnums.html#g64db2216c86f2ce624b9ef0489bf1df4">Gravity</a> Pango::Context::get_base_gravity </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieves the base gravity for the context.
<p>
See pango_context_set_base_gravity(). <dl class="return" compact><dt><b>Returns:</b></dt><dd>The base gravity for the context.</dd></dl>
Since: 1.16.
</div>
</div><p>
<a class="anchor" name="a1bdad3ae1d86d997d8fcaebdeba9226"></a><!-- doxytag: member="Pango::Context::get_font_description" ref="a1bdad3ae1d86d997d8fcaebdeba9226" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPango_1_1FontDescription.html">FontDescription</a> Pango::Context::get_font_description </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieve the default font description for the context.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A pointer to the context's default font description. This value must not be modified or freed. </dd></dl>
</div>
</div><p>
<a class="anchor" name="ed8b689506ac9ffe1538ddc6e0ac6130"></a><!-- doxytag: member="Pango::Context::get_font_map" ref="ed8b689506ac9ffe1538ddc6e0ac6130" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classPango_1_1FontMap.html">FontMap</a>> Pango::Context::get_font_map </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the Pango::Fontmap used to look up fonts for this context.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The font map for the <a class="el" href="classPango_1_1Context.html">Pango::Context</a>. This value is owned by <a class="el" href="namespacePango.html">Pango</a> and should not be unreferenced.</dd></dl>
Since: 1.6.
</div>
</div><p>
<a class="anchor" name="56eb6d8dde7e58e820aa717214e39345"></a><!-- doxytag: member="Pango::Context::get_font_map" ref="56eb6d8dde7e58e820aa717214e39345" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1FontMap.html">FontMap</a>> Pango::Context::get_font_map </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the Pango::Fontmap used to look up fonts for this context.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The font map for the <a class="el" href="classPango_1_1Context.html">Pango::Context</a>. This value is owned by <a class="el" href="namespacePango.html">Pango</a> and should not be unreferenced.</dd></dl>
Since: 1.6.
</div>
</div><p>
<a class="anchor" name="09a487a86b9458c7a027d0d2a0d3e3ed"></a><!-- doxytag: member="Pango::Context::get_font_options" ref="09a487a86b9458c7a027d0d2a0d3e3ed" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Cairo::FontOptions Pango::Context::get_font_options </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieves any font rendering options previously set with pango_cairo_font_map_set_font_options().
<p>
This functions not report options that are derived from the target surface by pango_cairo_update_context() <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A <a class="el" href="classPango_1_1Context.html">Pango::Context</a>, from <a class="el" href="classPango_1_1CairoFontMap.html#f0dc38a29a12d73efaf30edcec4aa99d">Pango::CairoFontMap::create_context()</a>. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The font options previously set on the context, or <code>0</code> if no options have been set. This value is owned by the context and must not be modified or freed. </dd></dl>
</div>
</div><p>
<a class="anchor" name="7fb91175786b41e1edd560d1d39904f2"></a><!-- doxytag: member="Pango::Context::get_gravity" ref="7fb91175786b41e1edd560d1d39904f2" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__pangommEnums.html#g64db2216c86f2ce624b9ef0489bf1df4">Gravity</a> Pango::Context::get_gravity </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieves the gravity for the context.
<p>
This is similar to pango_context_get_base_gravity(), except for when the base gravity is <a class="el" href="group__pangommEnums.html#gg64db2216c86f2ce624b9ef0489bf1df4f179cd9862b61b8030e2d5aee4e07b40">Pango::GRAVITY_AUTO</a> for which pango_gravity_get_for_matrix() is used to return the gravity from the current context matrix. <dl class="return" compact><dt><b>Returns:</b></dt><dd>The resolved gravity for the context.</dd></dl>
Since: 1.16.
</div>
</div><p>
<a class="anchor" name="dbc0f80f74702be4a220ef4a8007dfc1"></a><!-- doxytag: member="Pango::Context::get_gravity_hint" ref="dbc0f80f74702be4a220ef4a8007dfc1" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__pangommEnums.html#g405d1530ab8ac4993a0921a27fe035dd">GravityHint</a> Pango::Context::get_gravity_hint </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieves the gravity hint for the context.
<p>
See pango_context_set_gravity_hint() for details. <dl class="return" compact><dt><b>Returns:</b></dt><dd>The gravity hint for the context.</dd></dl>
Since: 1.16.
</div>
</div><p>
<a class="anchor" name="c53dcbad3b801397d3168850bc6e3aee"></a><!-- doxytag: member="Pango::Context::get_language" ref="c53dcbad3b801397d3168850bc6e3aee" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPango_1_1Language.html">Language</a> Pango::Context::get_language </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieves the global language tag for the context.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The global language tag. </dd></dl>
</div>
</div><p>
<a class="anchor" name="c0b2104171d02ca53bb02593fb5adaae"></a><!-- doxytag: member="Pango::Context::get_matrix" ref="c0b2104171d02ca53bb02593fb5adaae" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespacePango.html#5565a2f93d4fb8f943cc2d1fb2d476e1">Matrix</a> Pango::Context::get_matrix </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="fb26cf3e1bdaae0d920e4728e654fa42"></a><!-- doxytag: member="Pango::Context::get_metrics" ref="fb26cf3e1bdaae0d920e4728e654fa42" args="(const FontDescription &desc, const Language &language) const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPango_1_1FontMetrics.html">FontMetrics</a> Pango::Context::get_metrics </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& </td>
<td class="paramname"> <em>desc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classPango_1_1Language.html">Language</a>& </td>
<td class="paramname"> <em>language</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get overall metric information for a font particular font description.
<p>
Since the metrics may be substantially different for different scripts, a language tag can be provided to indicate that the metrics should be retrieved that correspond to the script(s) used by that language.<p>
The <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a> is interpreted in the same way as by pango_itemize(), and the family name may be a comma separated list of figures. If characters from multiple of these families would be used to render the string, then the returned fonts would be a composite of the metrics for the fonts loaded for the individual families. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>desc</em> </td><td>A <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a> structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>language</em> </td><td><a class="el" href="classPango_1_1Language.html">Language</a> tag used to determine which script to get the metrics for. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A Pango::Metrics object. </dd></dl>
</div>
</div><p>
<a class="anchor" name="a506bd1a380659fbc922347813cb7a2c"></a><!-- doxytag: member="Pango::Context::get_metrics" ref="a506bd1a380659fbc922347813cb7a2c" args="(const FontDescription &desc) const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPango_1_1FontMetrics.html">FontMetrics</a> Pango::Context::get_metrics </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& </td>
<td class="paramname"> <em>desc</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get overall metric information for a particular font description.
<p>
The metrics may be substantially different for different scripts. However this function overload returns the metrics of the entire font. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>desc</em> </td><td>A <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a> object. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classPango_1_1FontMetrics.html">Pango::FontMetrics</a> object. </dd></dl>
</div>
</div><p>
<a class="anchor" name="ed78a8c0b95b43dc69d52325b13ee20e"></a><!-- doxytag: member="Pango::Context::get_resolution" ref="ed78a8c0b95b43dc69d52325b13ee20e" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double Pango::Context::get_resolution </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the resolution for the context.
<p>
See pango_cairo_context_set_resolution() <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A <a class="el" href="classPango_1_1Context.html">Pango::Context</a>, from <a class="el" href="classPango_1_1CairoFontMap.html#f0dc38a29a12d73efaf30edcec4aa99d">Pango::CairoFontMap::create_context()</a>. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The resolution in "dots per inch". A negative value will be returned if no resolution has previously been set.</dd></dl>
Since: 1.10.
</div>
</div><p>
<a class="anchor" name="d66d1b28683c6b1fb2a3cb2f9517ec28"></a><!-- doxytag: member="Pango::Context::gobj" ref="d66d1b28683c6b1fb2a3cb2f9517ec28" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const PangoContext* Pango::Context::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C GObject.
<p>
<p>
Reimplemented from <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ObjectBase.html#2b7010748d60e770e9e0b3d65c100cf2">Glib::ObjectBase</a>.
</div>
</div><p>
<a class="anchor" name="0be484ab187e1e8fc7be2940ec4cb615"></a><!-- doxytag: member="Pango::Context::gobj" ref="0be484ab187e1e8fc7be2940ec4cb615" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">PangoContext* Pango::Context::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C GObject.
<p>
<p>
Reimplemented from <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ObjectBase.html#4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.
</div>
</div><p>
<a class="anchor" name="a639f1fff0f0197e2f2a74ebe6cfe926"></a><!-- doxytag: member="Pango::Context::gobj_copy" ref="a639f1fff0f0197e2f2a74ebe6cfe926" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">PangoContext* Pango::Context::gobj_copy </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
<p>
</div>
</div><p>
<a class="anchor" name="caabc75858fee895b9685a63272e3178"></a><!-- doxytag: member="Pango::Context::itemize" ref="caabc75858fee895b9685a63272e3178" args="(const Glib::ustring &text, int start_index, int length, const AttrList &attrs, AttrIter &cached_iter) const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ListHandle.html">ListHandle_Item</a> Pango::Context::itemize </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>start_index</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classPango_1_1AttrList.html">AttrList</a>& </td>
<td class="paramname"> <em>attrs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classPango_1_1AttrIter.html">AttrIter</a>& </td>
<td class="paramname"> <em>cached_iter</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Breaks a piece of text into segments with consistent directional level and shaping engine.
<p>
Each byte of <em>text</em> will be contained in exactly one of the items in the returned list. The generated list of items will be in logical order (the start offsets of the items are ascending).<p>
<em>cached_iter</em> should be an iterator over <em>attrs</em> currently positioned at a range before or containing <em>start_index</em>. <em>cached_iter</em> will be advanced to the range covering the position just after <em>start_index</em> + <em>length</em>. (i.e. if itemizing in a loop, just keep passing in the same <em>cached_iter</em>).<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>The text to itemize. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>start_index</em> </td><td>First byte in <em>text</em> to process. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>The number of bytes (not characters) to process after <em>start_index</em>. This must be >= <code>0</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attrs</em> </td><td>The set of attributes that apply to <em>text</em>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cached_iter</em> </td><td>Cached attribute iterator. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A list of <a class="el" href="classPango_1_1Item.html">Pango::Item</a> structures. </dd></dl>
</div>
</div><p>
<a class="anchor" name="dd1982bdccb054f2dc39e17b156d59bc"></a><!-- doxytag: member="Pango::Context::itemize" ref="dd1982bdccb054f2dc39e17b156d59bc" args="(const Glib::ustring &text, const AttrList &attrs) const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ListHandle.html">ListHandle_Item</a> Pango::Context::itemize </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classPango_1_1AttrList.html">AttrList</a>& </td>
<td class="paramname"> <em>attrs</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Breaks a piece of text into segments with consistent directional level and shaping engine.
<p>
Each byte of <em>text</em> will be contained in exactly one of the items in the returned list. The generated list of items will be in logical order (the start offsets of the items are ascending). <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>The text to itemize. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attrs</em> </td><td>The set of attributes that apply. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A list of <a class="el" href="classPango_1_1Item.html">Pango::Item</a> objects. </dd></dl>
</div>
</div><p>
<a class="anchor" name="0f67507a8df1f68daf9456cdac732ac6"></a><!-- doxytag: member="Pango::Context::list_families" ref="0f67507a8df1f68daf9456cdac732ac6" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><<a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1FontFamily.html">FontFamily</a>>> Pango::Context::list_families </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
List all available font families for a context.
<p>
You can specify one of these as your desired font family in the Pango::FontDesciption objects you use, e.g. in the default font description of the context. <dl class="return" compact><dt><b>Returns:</b></dt><dd>An array of <a class="el" href="classPango_1_1FontFamily.html">Pango::FontFamily</a> objects. </dd></dl>
</div>
</div><p>
<a class="anchor" name="f439c9a43237d2fc4a99914306560793"></a><!-- doxytag: member="Pango::Context::load_font" ref="f439c9a43237d2fc4a99914306560793" args="(const FontDescription &desc) const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Font.html">Font</a>> Pango::Context::load_font </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& </td>
<td class="paramname"> <em>desc</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Loads the font in one of the fontmaps in the context that is the closest match for <em>desc</em> .
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>desc</em> </td><td>A <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a> describing the font to load. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The font loaded, or <code>0</code> if no font matched. </dd></dl>
</div>
</div><p>
<a class="anchor" name="bfca9cb1a42475143183534d09bb6be8"></a><!-- doxytag: member="Pango::Context::load_fontset" ref="bfca9cb1a42475143183534d09bb6be8" args="(const FontDescription &desc, const Language &language) const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Fontset.html">Fontset</a>> Pango::Context::load_fontset </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& </td>
<td class="paramname"> <em>desc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classPango_1_1Language.html">Language</a>& </td>
<td class="paramname"> <em>language</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Load a set of fonts in the context that can be used to render a font matching <em>desc</em> .
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>desc</em> </td><td>A <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a> describing the fonts to load. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>language</em> </td><td>A <a class="el" href="classPango_1_1Language.html">Pango::Language</a> the fonts will be used for. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The fontset, or <code>0</code> if no font matched. </dd></dl>
</div>
</div><p>
<a class="anchor" name="2f2e234bb53c20eff53ed8f1e51e460f"></a><!-- doxytag: member="Pango::Context::set_base_dir" ref="2f2e234bb53c20eff53ed8f1e51e460f" args="(Direction direction)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_base_dir </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__pangommEnums.html#g8fa031ece55a28777a84d0115829f601">Direction</a> </td>
<td class="paramname"> <em>direction</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the base direction for the context.
<p>
The base direction is used in applying the Unicode bidirectional algorithm; if the <em>direction</em> is <a class="el" href="group__pangommEnums.html#gg8fa031ece55a28777a84d0115829f60126ee800099154692da46924d2ba3c798">Pango::DIRECTION_LTR</a> or <a class="el" href="group__pangommEnums.html#gg8fa031ece55a28777a84d0115829f601cc8fc1dc8564449e04f264cb537699ab">Pango::DIRECTION_RTL</a>, then the value will be used as the paragraph direction in the Unicode bidirectional algorithm. A value of <a class="el" href="group__pangommEnums.html#gg8fa031ece55a28777a84d0115829f60188db3f8f0d85aceeb442f350f3db062a">Pango::DIRECTION_WEAK_LTR</a> or <a class="el" href="group__pangommEnums.html#gg8fa031ece55a28777a84d0115829f601f554c4d98ffa80fa05041ea48bbb77a5">Pango::DIRECTION_WEAK_RTL</a> is used only for paragraphs that do not contain any strong characters themselves. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>direction</em> </td><td>The new base direction. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="fc55b428fe56632e44c7d528eb27c037"></a><!-- doxytag: member="Pango::Context::set_base_gravity" ref="fc55b428fe56632e44c7d528eb27c037" args="(Gravity gravity)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_base_gravity </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__pangommEnums.html#g64db2216c86f2ce624b9ef0489bf1df4">Gravity</a> </td>
<td class="paramname"> <em>gravity</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the base gravity for the context.
<p>
The base gravity is used in laying vertical text out.<p>
Since: 1.16 <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>gravity</em> </td><td>The new base gravity. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="5f80cbc5c97fb4ef0152f559096bea6c"></a><!-- doxytag: member="Pango::Context::set_cairo_font_options" ref="5f80cbc5c97fb4ef0152f559096bea6c" args="(const Cairo::FontOptions &options)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_cairo_font_options </td>
<td>(</td>
<td class="paramtype">const Cairo::FontOptions & </td>
<td class="paramname"> <em>options</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the font options used when rendering text with this context.
<p>
These options override any options that pango_cairo_update_context() derives from the target surface. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A <a class="el" href="classPango_1_1Context.html">Pango::Context</a>, from <a class="el" href="classPango_1_1CairoFontMap.html#f0dc38a29a12d73efaf30edcec4aa99d">Pango::CairoFontMap::create_context()</a>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>options</em> </td><td>A cairo_font_options_t, or <code>0</code> to unset any previously set options. A copy is made. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="90ba5091c7a3177c4b3e49840b64192a"></a><!-- doxytag: member="Pango::Context::set_font_description" ref="90ba5091c7a3177c4b3e49840b64192a" args="(const FontDescription &desc)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_font_description </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& </td>
<td class="paramname"> <em>desc</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the default font description for the context.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>desc</em> </td><td>The new pango font description. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="86b50228ad45a1bb81136519aea95915"></a><!-- doxytag: member="Pango::Context::set_gravity_hint" ref="86b50228ad45a1bb81136519aea95915" args="(GravityHint hint)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_gravity_hint </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__pangommEnums.html#g405d1530ab8ac4993a0921a27fe035dd">GravityHint</a> </td>
<td class="paramname"> <em>hint</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the gravity hint for the context.
<p>
The gravity hint is used in laying vertical text out, and is only relevant if gravity of the context as returned by pango_context_get_gravity() is set <a class="el" href="group__pangommEnums.html#gg64db2216c86f2ce624b9ef0489bf1df4f6aca55cd113d30809b9292448d444e3">Pango::GRAVITY_EAST</a> or <a class="el" href="group__pangommEnums.html#gg64db2216c86f2ce624b9ef0489bf1df44c25e7d91fb461b35daf17b8c107381b">Pango::GRAVITY_WEST</a>.<p>
Since: 1.16 <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>hint</em> </td><td>The new gravity hint. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="20a1d003027b28404ae547118a1d6d80"></a><!-- doxytag: member="Pango::Context::set_language" ref="20a1d003027b28404ae547118a1d6d80" args="(const Language &language)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_language </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPango_1_1Language.html">Language</a>& </td>
<td class="paramname"> <em>language</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the global language tag for the context.
<p>
The default language for the locale of the running process can be found using pango_language_get_default(). <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>language</em> </td><td>The new language tag. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="e3e16a984e6c1bb2d8066201b4594da5"></a><!-- doxytag: member="Pango::Context::set_matrix" ref="e3e16a984e6c1bb2d8066201b4594da5" args="(const Matrix &matrix)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_matrix </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="namespacePango.html#5565a2f93d4fb8f943cc2d1fb2d476e1">Matrix</a>& </td>
<td class="paramname"> <em>matrix</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the transformation matrix that will be applied when rendering with this context.
<p>
Note that reported metrics are in the user space coordinates before the application of the matrix, not device-space coordinates after the application of the matrix. So, they don't scale with the matrix, though they may change slightly for different matrices, depending on how the text is fit to the pixel grid.<p>
Since: 1.6 <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>matrix</em> </td><td>A <a class="el" href="namespacePango.html#5565a2f93d4fb8f943cc2d1fb2d476e1">Pango::Matrix</a>, or <code>0</code> to unset any existing matrix. (No matrix set is the same as setting the identity matrix.). </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="e912e733915cc5b48124a4aa913c6a7f"></a><!-- doxytag: member="Pango::Context::set_resolution" ref="e912e733915cc5b48124a4aa913c6a7f" args="(double dpi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::set_resolution </td>
<td>(</td>
<td class="paramtype">double </td>
<td class="paramname"> <em>dpi</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the resolution for the context.
<p>
This is a scale factor between points specified in a <a class="el" href="classPango_1_1FontDescription.html">Pango::FontDescription</a> and Cairo units. The default value is 96, meaning that a 10 point font will be 13 units high. (10* 96. / 72. = 13.3).<p>
Since: 1.10 <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A <a class="el" href="classPango_1_1Context.html">Pango::Context</a>, from <a class="el" href="classPango_1_1CairoFontMap.html#f0dc38a29a12d73efaf30edcec4aa99d">Pango::CairoFontMap::create_context()</a>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dpi</em> </td><td>The resolution in "dots per inch". (Physical inches aren't actually involved; the terminology is conventional.) A 0 or negative value means to use the resolution from the font map. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="cc6707edbfcbbe79f6e3c540ddfa6eb1"></a><!-- doxytag: member="Pango::Context::update_from_cairo_context" ref="cc6707edbfcbbe79f6e3c540ddfa6eb1" args="(const Cairo::RefPtr< Cairo::Context > &context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Pango::Context::update_from_cairo_context </td>
<td>(</td>
<td class="paramtype">const Cairo::RefPtr< Cairo::Context > & </td>
<td class="paramname"> <em>context</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Updates a <a class="el" href="namespacePango.html">Pango</a> <a class="el" href="classPango_1_1Context.html">Context</a> previously created for use with Cairo to match the current transformation and target surface of a Cairo <a class="el" href="classPango_1_1Context.html">Context</a>.
<p>
If any layouts have been created for the context, it's necessary to call <a class="el" href="classPango_1_1Layout.html#b78ccca32cb57798beb743ae6778e7a8">Pango::Layout::context_changed()</a> on those layouts.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A Cairo context, from <a class="el" href="classPango_1_1CairoFontMap.html#f0dc38a29a12d73efaf30edcec4aa99d">CairoFontMap::create_context()</a>. </td></tr>
</table>
</dl>
</div>
</div><p>
<hr><h2>Friends And Related Function Documentation</h2>
<a class="anchor" name="c61523c7c5af185d2c5ce7ce5706c3b4"></a><!-- doxytag: member="Pango::Context::wrap" ref="c61523c7c5af185d2c5ce7ce5706c3b4" args="(PangoContext *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Context.html">Pango::Context</a>> wrap </td>
<td>(</td>
<td class="paramtype">PangoContext * </td>
<td class="paramname"> <em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>take_copy</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
A <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>object</em> </td><td>The C instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>take_copy</em> </td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="context_8h.html">context.h</a></ul>
</div>
<!-- end main content -->
<hr><address><small>
Generated for gtkmm 2.4 by <a href="http://www.doxygen.org/index.html">
Doxygen</a> 1.5.1 © 1997-2001</small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
9411cff4bc6d4e61b29ae81cd24665af
>
files
>
897
