win32-fonts.xml

来自「GTK+-2.0源码之pango-1.15.6.tar.gz」· XML 代码 · 共 509 行 · 第 1/3 页

<refsect2>
<title><anchor id="pango-win32-get-dc" role="function"/>pango_win32_get_dc ()</title>
<indexterm><primary>pango_win32_get_dc</primary></indexterm><programlisting><link linkend="HDC:CAPS">HDC</link>         pango_win32_get_dc              (void);</programlisting>
<para>
Obtains a handle to the Windows device context that is used by Pango.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A handle to the Windows device context that is used by Pango.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="PangoWin32FontCache" role="struct"/>PangoWin32FontCache</title>
<indexterm><primary>PangoWin32FontCache</primary></indexterm><programlisting>typedef struct _PangoWin32FontCache PangoWin32FontCache;</programlisting>
<para>
A <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> caches
HFONTs by their LOGFONT descriptions. 
</para></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-cache-new" role="function"/>pango_win32_font_cache_new ()</title>
<indexterm><primary>pango_win32_font_cache_new</primary></indexterm><programlisting><link linkend="PangoWin32FontCache">PangoWin32FontCache</link>* pango_win32_font_cache_new
                                            (void);</programlisting>
<para>
Creates a font cache.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The new font cache. This must be freed with
<link linkend="pango-win32-font-cache-free"><function>pango_win32_font_cache_free()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-cache-free" role="function"/>pango_win32_font_cache_free ()</title>
<indexterm><primary>pango_win32_font_cache_free</primary></indexterm><programlisting><link linkend="void">void</link>        pango_win32_font_cache_free     (<link linkend="PangoWin32FontCache">PangoWin32FontCache</link> *cache);</programlisting>
<para>
Frees a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> and all associated memory. All fonts loaded
through this font cache will be freed along with the cache.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>cache</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-cache-load" role="function"/>pango_win32_font_cache_load ()</title>
<indexterm><primary>pango_win32_font_cache_load</primary></indexterm><programlisting><link linkend="HFONT:CAPS">HFONT</link>       pango_win32_font_cache_load     (<link linkend="PangoWin32FontCache">PangoWin32FontCache</link> *cache,
                                             const <link linkend="LOGFONT:CAPS">LOGFONT</link> *logfont);</programlisting>
<para>
Creates a HFONT from a LOGFONT. The
result may be newly loaded, or it may have been previously
stored</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>cache</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>logfont</parameter>&nbsp;:</term>
<listitem><simpara> a pointer to a LOGFONT structure describing the font to load.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The font structure, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the font could
not be loaded. In order to free this structure, you must call
<link linkend="pango-win32-font-cache-unload"><function>pango_win32_font_cache_unload()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-cache-unload" role="function"/>pango_win32_font_cache_unload ()</title>
<indexterm><primary>pango_win32_font_cache_unload</primary></indexterm><programlisting><link linkend="void">void</link>        pango_win32_font_cache_unload   (<link linkend="PangoWin32FontCache">PangoWin32FontCache</link> *cache,
                                             <link linkend="HFONT:CAPS">HFONT</link> hfont);</programlisting>
<para>
Frees a font structure previously loaded with <link linkend="pango-win32-font-cache-load"><function>pango_win32_font_cache_load()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>cache</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>hfont</parameter>&nbsp;:</term>
<listitem><simpara> the HFONT to unload
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-map-for-display" role="function"/>pango_win32_font_map_for_display ()</title>
<indexterm><primary>pango_win32_font_map_for_display</primary></indexterm><programlisting><link linkend="PangoFontMap">PangoFontMap</link>* pango_win32_font_map_for_display
                                            (void);</programlisting>
<para>
Returns a <link linkend="PangoWin32FontMap"><type>PangoWin32FontMap</type></link>. Font maps are cached and should
not be freed. If the font map is no longer needed, it can
be released with <link linkend="pango-win32-shutdown-display"><function>pango_win32_shutdown_display()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="PangoFontMap"><type>PangoFontMap</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-win32-shutdown-display" role="function"/>pango_win32_shutdown_display ()</title>
<indexterm><primary>pango_win32_shutdown_display</primary></indexterm><programlisting><link linkend="void">void</link>        pango_win32_shutdown_display    (void);</programlisting>
<para>
Free cached resources.</para>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-map-get-font-cache" role="function"/>pango_win32_font_map_get_font_cache ()</title>
<indexterm><primary>pango_win32_font_map_get_font_cache</primary></indexterm><programlisting><link linkend="PangoWin32FontCache">PangoWin32FontCache</link>* pango_win32_font_map_get_font_cache
                                            (<link linkend="PangoFontMap">PangoFontMap</link> *font_map);</programlisting>
<para>
Obtains the font cache associated with the given font map.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font_map</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoWin32FontMap"><type>PangoWin32FontMap</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <link linkend="PangoWin32FontCache"><type>PangoWin32FontCache</type></link> of <parameter>font_map</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-logfont" role="function"/>pango_win32_font_logfont ()</title>
<indexterm><primary>pango_win32_font_logfont</primary></indexterm><programlisting><link linkend="LOGFONT:CAPS">LOGFONT</link>*    pango_win32_font_logfont        (<link linkend="PangoFont">PangoFont</link> *font);</programlisting>
<para>
Determine the LOGFONT struct for the specified font.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link> which must be from the Win32 backend
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A newly allocated LOGFONT struct. It must be
freed with <link linkend="g-free"><function>g_free()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="pango-win32-font-description-from-logfont" role="function" condition="since:1.12"/>pango_win32_font_description_from_logfont ()</title>
<indexterm role="1.12"><primary>pango_win32_font_description_from_logfont</primary></indexterm><programlisting><link linkend="PangoFontDescription">PangoFontDescription</link>* pango_win32_font_description_from_logfont
                                            (const <link linkend="LOGFONT:CAPS">LOGFONT</link> *lfp);</programlisting>
<para>
Creates a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link> that matches the specified LOGFONT.
</para>
<para>
The face name, italicness and weight fields in the LOGFONT are used
to set up the resulting <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>. If the face name in
the LOGFONT contains non-ASCII characters the font is temporarily
loaded (using <link linkend="CreateFontIndirect"><function>CreateFontIndirect()</function></link>) and an ASCII (usually English)
name for it is looked up from the font name tables in the font
data. If that doesn't work, the face name is converted from the
system codepage to UTF-8 and that is used.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>lfp</parameter>&nbsp;:</term>
<listitem><simpara> a LOGFONT
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>, which
 should be freed using <link linkend="pango-font-description-free"><function>pango_font_description_free()</function></link>

</simpara></listitem></varlistentry>
</variablelist><para>Since  1.12
</para></refsect2>

</refsect1>




</refentry>