<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>pangomm: Pango::FontMap Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.4 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">pangomm <span id="projectnumber">2.28.4</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespacePango.html">Pango</a> </li>
<li class="navelem"><a class="el" href="classPango_1_1FontMap.html">FontMap</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<div class="title">Pango::FontMap Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="Pango::FontMap" --><!-- doxytag: inherits="Glib::Object" -->
<p>A <a class="el" href="classPango_1_1FontMap.html" title="A Pango::FontMap represents the set of fonts available for a particular rendering system...">Pango::FontMap</a> represents the set of fonts available for a particular rendering system. <a href="classPango_1_1FontMap.html#details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Pango::FontMap:</div>
<div class="dyncontent">
<div class="center"><img src="classPango_1_1FontMap__inherit__graph.png" border="0" usemap="#Pango_1_1FontMap_inherit__map" alt="Inheritance graph"/></div>
<map name="Pango_1_1FontMap_inherit__map" id="Pango_1_1FontMap_inherit__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Pango::FontMap:</div>
<div class="dyncontent">
<div class="center"><img src="classPango_1_1FontMap__coll__graph.png" border="0" usemap="#Pango_1_1FontMap_coll__map" alt="Collaboration graph"/></div>
<map name="Pango_1_1FontMap_coll__map" id="Pango_1_1FontMap_coll__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classPango_1_1FontMap-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1FontMap.html#addadcbe1a6a319cb06e566132d479ff4">~FontMap</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">PangoFontMap* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1FontMap.html#ad9944f6abec1dc54c2a8ad190cba3b41">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#ad9944f6abec1dc54c2a8ad190cba3b41"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const PangoFontMap* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1FontMap.html#aaf8ae88ea6344bfc04db543b4d8a6c7b">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#aaf8ae88ea6344bfc04db543b4d8a6c7b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">PangoFontMap* </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1FontMap.html#a3a42d88278dcbc412cf56ee71a985d12">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="#a3a42d88278dcbc412cf56ee71a985d12"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/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_1FontMap.html#afdd6e2219499d9fa20e1ea29dc699b96">load_font</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1Context.html">Context</a> >& context, const <a class="el" href="classPango_1_1FontDescription.html">FontDescription</a>& desc) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Load the font in the fontmap that is the closest match for <em>desc</em>. <a href="#afdd6e2219499d9fa20e1ea29dc699b96"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/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_1FontMap.html#a729237a53da397615cfe94bea7bd215e">load_fontset</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1Context.html">Context</a> >& context, 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 fontmap that can be used to render a font matching <em>desc</em>. <a href="#a729237a53da397615cfe94bea7bd215e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1Context.html">Context</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1FontMap.html#aba7b44acf8bd2c34178b1cf27930cf3d">create_context</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a <a class="el" href="classPango_1_1Context.html" title="A Pango::Context stores global information used to control the itemization process.">Pango::Context</a> connected to <em>fontmap</em>. <a href="#aba7b44acf8bd2c34178b1cf27930cf3d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1FontFamily.html">FontFamily</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1FontMap.html#a62fa30686397a0c27e6818be0c6b9989">list_families</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">List all families for the fontmap. <a href="#a62fa30686397a0c27e6818be0c6b9989"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td class="ititle" colspan="2"><p>(Note that these are not member functions.) </p>
</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1FontMap.html">Pango::FontMap</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classPango_1_1FontMap.html#a9026fe42381ba2ac182ad9c660671370">wrap</a> (PangoFontMap* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a9026fe42381ba2ac182ad9c660671370"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>A <a class="el" href="classPango_1_1FontMap.html" title="A Pango::FontMap represents the set of fonts available for a particular rendering system...">Pango::FontMap</a> represents the set of fonts available for a particular rendering system. </p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="addadcbe1a6a319cb06e566132d479ff4"></a><!-- doxytag: member="Pango::FontMap::~FontMap" ref="addadcbe1a6a319cb06e566132d479ff4" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Pango::FontMap::~FontMap </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="aba7b44acf8bd2c34178b1cf27930cf3d"></a><!-- doxytag: member="Pango::FontMap::create_context" ref="aba7b44acf8bd2c34178b1cf27930cf3d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Context.html">Context</a>> Pango::FontMap::create_context </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a <a class="el" href="classPango_1_1Context.html" title="A Pango::Context stores global information used to control the itemization process.">Pango::Context</a> connected to <em>fontmap</em>. </p>
<p>This is equivalent to Pango::Context::new() followed by <a class="el" href="classPango_1_1Context.html#a1e81f9b89aee5b5cf5f85ffe49806a74" title="Sets the font map to be searched when fonts are looked-up in this context.">Pango::Context::set_font_map()</a>.</p>
<p>If you are using <a class="el" href="namespacePango.html">Pango</a> as part of a higher-level system, that system may have it's own way of create a <a class="el" href="classPango_1_1Context.html" title="A Pango::Context stores global information used to control the itemization process.">Pango::Context</a>. For instance, the GTK+ toolkit has, among others, gdk_pango_context_get_for_screen(), and gtk_widget_get_pango_context(). Use those instead.</p>
<dl class="since_1_22"><dt><b><a class="el" href="since_1_22.html#_since_1_22000002">Since pangomm 1.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The newly allocated <a class="el" href="classPango_1_1Context.html" title="A Pango::Context stores global information used to control the itemization process.">Pango::Context</a>, which should be freed with Glib::object_unref(). </dd></dl>
</div>
</div>
<a class="anchor" id="aaf8ae88ea6344bfc04db543b4d8a6c7b"></a><!-- doxytag: member="Pango::FontMap::gobj" ref="aaf8ae88ea6344bfc04db543b4d8a6c7b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const PangoFontMap* Pango::FontMap::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> 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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="ad9944f6abec1dc54c2a8ad190cba3b41"></a><!-- doxytag: member="Pango::FontMap::gobj" ref="ad9944f6abec1dc54c2a8ad190cba3b41" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">PangoFontMap* Pango::FontMap::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="a3a42d88278dcbc412cf56ee71a985d12"></a><!-- doxytag: member="Pango::FontMap::gobj_copy" ref="a3a42d88278dcbc412cf56ee71a985d12" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">PangoFontMap* Pango::FontMap::gobj_copy </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></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>
<a class="anchor" id="a62fa30686397a0c27e6818be0c6b9989"></a><!-- doxytag: member="Pango::FontMap::list_families" ref="a62fa30686397a0c27e6818be0c6b9989" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1FontFamily.html">FontFamily</a>> > Pango::FontMap::list_families </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>List all families for the fontmap. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>an array of pointers to <a class="el" href="classPango_1_1FontFamily.html" title="A Pango::FontFamily is used to represent a family of related font faces.">Pango::FontFamily</a> objects. </dd></dl>
</div>
</div>
<a class="anchor" id="afdd6e2219499d9fa20e1ea29dc699b96"></a><!-- doxytag: member="Pango::FontMap::load_font" ref="afdd6e2219499d9fa20e1ea29dc699b96" args="(const Glib::RefPtr< Context > &context, const FontDescription &desc) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Font.html">Font</a>> Pango::FontMap::load_font </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1Context.html">Context</a> >& </td>
<td class="paramname"><em>context</em>, </td>
</tr>
<tr>
<td class="paramkey"></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></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Load the font in the fontmap that is the closest match for <em>desc</em>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">context</td><td>The <a class="el" href="classPango_1_1Context.html" title="A Pango::Context stores global information used to control the itemization process.">Pango::Context</a> the font will be used with. </td></tr>
<tr><td class="paramname">desc</td><td>A <a class="el" href="classPango_1_1FontDescription.html" title="A Pango::FontDescription represents the description of an ideal font.">Pango::FontDescription</a> describing the font to load. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The font loaded, or <code>0</code> if no font matched. </dd></dl>
</div>
</div>
<a class="anchor" id="a729237a53da397615cfe94bea7bd215e"></a><!-- doxytag: member="Pango::FontMap::load_fontset" ref="a729237a53da397615cfe94bea7bd215e" args="(const Glib::RefPtr< Context > &context, const FontDescription &desc, const Language &language) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classPango_1_1Fontset.html">Fontset</a>> Pango::FontMap::load_fontset </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1Context.html">Context</a> >& </td>
<td class="paramname"><em>context</em>, </td>
</tr>
<tr>
<td class="paramkey"></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>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Load a set of fonts in the fontmap that can be used to render a font matching <em>desc</em>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">context</td><td>The <a class="el" href="classPango_1_1Context.html" title="A Pango::Context stores global information used to control the itemization process.">Pango::Context</a> the font will be used with. </td></tr>
<tr><td class="paramname">desc</td><td>A <a class="el" href="classPango_1_1FontDescription.html" title="A Pango::FontDescription represents the description of an ideal font.">Pango::FontDescription</a> describing the font to load. </td></tr>
<tr><td class="paramname">language</td><td>A <a class="el" href="classPango_1_1Language.html" title="A Pango::Language is used to represent a language.">Pango::Language</a> the fonts will be used for. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The fontset, or <code>0</code> if no font matched. </dd></dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a9026fe42381ba2ac182ad9c660671370"></a><!-- doxytag: member="Pango::FontMap::wrap" ref="a9026fe42381ba2ac182ad9c660671370" args="(PangoFontMap *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classPango_1_1FontMap.html">Pango::FontMap</a> > wrap </td>
<td>(</td>
<td class="paramtype">PangoFontMap * </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>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
<tr><td class="paramname">take_copy</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>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>pangomm/fontmap.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Wed Oct 26 2011 13:10:53 for pangomm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address>
</body>
</html>
