docs/reference/gtk/html/GtkFontSelection.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GtkFontSelection</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
   8 <link rel="up" href="SelectorWidgets.html" title="Selectors (Color/File/Font)">
   9 <link rel="prev" href="GtkFontChooserDialog.html" title="GtkFontChooserDialog">
  10 <link rel="next" href="GtkFontSelectionDialog.html" title="GtkFontSelectionDialog">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="GtkFontChooserDialog.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="SelectorWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GTK+ 3 Reference Manual</th>
  21 <td><a accesskey="n" href="GtkFontSelectionDialog.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#GtkFontSelection.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GtkFontSelection.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GtkFontSelection.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#GtkFontSelection.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31                    |
  32                   <a href="#GtkFontSelection.properties" class="shortcut">Properties</a>
  33 </td></tr>
  34 </table>
  35 <div class="refentry">
  36 <a name="GtkFontSelection"></a><div class="titlepage"></div>
  37 <div class="refnamediv"><table width="100%"><tr>
  38 <td valign="top">
  39 <h2><span class="refentrytitle"><a name="GtkFontSelection.top_of_page"></a>GtkFontSelection</span></h2>
  40 <p>GtkFontSelection — Deprecated widget for selecting fonts</p>
  41 </td>
  42 <td valign="top" align="right"></td>
  43 </tr></table></div>
  44 <div class="refsynopsisdiv">
  45 <a name="GtkFontSelection.synopsis"></a><h2>Synopsis</h2>
  46 <pre class="synopsis">
  47 #include &lt;gtk/gtk.h&gt;
  48
  49 struct              <a class="link" href="GtkFontSelection.html#GtkFontSelection-struct" title="struct GtkFontSelection">GtkFontSelection</a>;
  50 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkFontSelection.html#gtk-font-selection-new" title="gtk_font_selection_new ()">gtk_font_selection_new</a>              (<em class="parameter"><code><span class="type">void</span></code></em>);
  51 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-font-name" title="gtk_font_selection_get_font_name ()">gtk_font_selection_get_font_name</a>    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  52 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFontSelection.html#gtk-font-selection-set-font-name" title="gtk_font_selection_set_font_name ()">gtk_font_selection_set_font_name</a>    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>,
  53                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fontname</code></em>);
  54 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-preview-text" title="gtk_font_selection_get_preview_text ()">gtk_font_selection_get_preview_text</a> (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  55 <span class="returnvalue">void</span>                <a class="link" href="GtkFontSelection.html#gtk-font-selection-set-preview-text" title="gtk_font_selection_set_preview_text ()">gtk_font_selection_set_preview_text</a> (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>,
  56                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);
  57 <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFace"><span class="returnvalue">PangoFontFace</span></a> *     <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-face" title="gtk_font_selection_get_face ()">gtk_font_selection_get_face</a>         (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  58 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-face-list" title="gtk_font_selection_get_face_list ()">gtk_font_selection_get_face_list</a>    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  59 <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFamily"><span class="returnvalue">PangoFontFamily</span></a> *   <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-family" title="gtk_font_selection_get_family ()">gtk_font_selection_get_family</a>       (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  60 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-size" title="gtk_font_selection_get_size ()">gtk_font_selection_get_size</a>         (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  61 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-family-list" title="gtk_font_selection_get_family_list ()">gtk_font_selection_get_family_list</a>  (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  62 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-preview-entry" title="gtk_font_selection_get_preview_entry ()">gtk_font_selection_get_preview_entry</a>
  63                                                         (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  64 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-size-entry" title="gtk_font_selection_get_size_entry ()">gtk_font_selection_get_size_entry</a>   (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  65 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-size-list" title="gtk_font_selection_get_size_list ()">gtk_font_selection_get_size_list</a>    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);
  66 </pre>
  67 </div>
  68 <div class="refsect1">
  69 <a name="GtkFontSelection.object-hierarchy"></a><h2>Object Hierarchy</h2>
  70 <pre class="synopsis">
  71   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  72    +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
  73          +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
  74                +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
  75                      +----<a class="link" href="GtkBox.html" title="GtkBox">GtkBox</a>
  76                            +----GtkFontSelection
  77 </pre>
  78 </div>
  79 <div class="refsect1">
  80 <a name="GtkFontSelection.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
  81 <p>
  82 GtkFontSelection implements
  83  AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a> and  <a class="link" href="gtk3-Orientable.html#GtkOrientable">GtkOrientable</a>.</p>
  84 </div>
  85 <div class="refsect1">
  86 <a name="GtkFontSelection.properties"></a><h2>Properties</h2>
  87 <pre class="synopsis">
  88   "<a class="link" href="GtkFontSelection.html#GtkFontSelection--font-name" title='The "font-name" property'>font-name</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  89   "<a class="link" href="GtkFontSelection.html#GtkFontSelection--preview-text" title='The "preview-text" property'>preview-text</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  90 </pre>
  91 </div>
  92 <div class="refsect1">
  93 <a name="GtkFontSelection.description"></a><h2>Description</h2>
  94 <p>
  95 The <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> widget lists the available fonts, styles and sizes,
  96 allowing the user to select a font.
  97 It is used in the <a class="link" href="GtkFontSelectionDialog.html" title="GtkFontSelectionDialog"><span class="type">GtkFontSelectionDialog</span></a> widget to provide a dialog box for
  98 selecting fonts.
  99 </p>
 100 <p>
 101 To set the font which is initially selected, use
 102 <a class="link" href="GtkFontSelection.html#gtk-font-selection-set-font-name" title="gtk_font_selection_set_font_name ()"><code class="function">gtk_font_selection_set_font_name()</code></a>.
 103 </p>
 104 <p>
 105 To get the selected font use <a class="link" href="GtkFontSelection.html#gtk-font-selection-get-font-name" title="gtk_font_selection_get_font_name ()"><code class="function">gtk_font_selection_get_font_name()</code></a>.
 106 </p>
 107 <p>
 108 To change the text which is shown in the preview area, use
 109 <a class="link" href="GtkFontSelection.html#gtk-font-selection-set-preview-text" title="gtk_font_selection_set_preview_text ()"><code class="function">gtk_font_selection_set_preview_text()</code></a>.
 110 </p>
 111 <p>
 112 In GTK+ 3.2, <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> has been deprecated in favor of
 113 <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a>.
 114 </p>
 115 </div>
 116 <div class="refsect1">
 117 <a name="GtkFontSelection.details"></a><h2>Details</h2>
 118 <div class="refsect2">
 119 <a name="GtkFontSelection-struct"></a><h3>struct GtkFontSelection</h3>
 120 <pre class="programlisting">struct GtkFontSelection;</pre>
 121 </div>
 122 <hr>
 123 <div class="refsect2">
 124 <a name="gtk-font-selection-new"></a><h3>gtk_font_selection_new ()</h3>
 125 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_font_selection_new              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 126 <p>
 127 Creates a new <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>.
 128 </p>
 129 <div class="variablelist"><table border="0">
 130 <col align="left" valign="top">
 131 <tbody><tr>
 132 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 133 <td>a n ew <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 134 </td>
 135 </tr></tbody>
 136 </table></div>
 137 </div>
 138 <hr>
 139 <div class="refsect2">
 140 <a name="gtk-font-selection-get-font-name"></a><h3>gtk_font_selection_get_font_name ()</h3>
 141 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gtk_font_selection_get_font_name    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 142 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 143 <h3 class="title">Warning</h3>
 144 <p><code class="literal">gtk_font_selection_get_font_name</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 145 </div>
 146 <p>
 147 Gets the currently-selected font name.
 148 </p>
 149 <p>
 150 Note that this can be a different string than what you set with
 151 <a class="link" href="GtkFontSelection.html#gtk-font-selection-set-font-name" title="gtk_font_selection_set_font_name ()"><code class="function">gtk_font_selection_set_font_name()</code></a>, as the font selection widget may
 152 normalize font names and thus return a string with a different structure.
 153 For example, "Helvetica Italic Bold 12" could be normalized to
 154 "Helvetica Bold Italic 12". Use <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-equal"><code class="function">pango_font_description_equal()</code></a>
 155 if you want to compare two font descriptions.
 156 </p>
 157 <div class="variablelist"><table border="0">
 158 <col align="left" valign="top">
 159 <tbody>
 160 <tr>
 161 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 162 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 163 </td>
 164 </tr>
 165 <tr>
 166 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 167 <td>A string with the name of the current font, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 168 no font is selected. You must free this string with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
 169 </tr>
 170 </tbody>
 171 </table></div>
 172 </div>
 173 <hr>
 174 <div class="refsect2">
 175 <a name="gtk-font-selection-set-font-name"></a><h3>gtk_font_selection_set_font_name ()</h3>
 176 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_font_selection_set_font_name    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>,
 177                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fontname</code></em>);</pre>
 178 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 179 <h3 class="title">Warning</h3>
 180 <p><code class="literal">gtk_font_selection_set_font_name</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 181 </div>
 182 <p>
 183 Sets the currently-selected font.
 184 </p>
 185 <p>
 186 Note that the <em class="parameter"><code>fontsel</code></em> needs to know the screen in which it will appear
 187 for this to work; this can be guaranteed by simply making sure that the
 188 <em class="parameter"><code>fontsel</code></em> is inserted in a toplevel window before you call this function.
 189 </p>
 190 <div class="variablelist"><table border="0">
 191 <col align="left" valign="top">
 192 <tbody>
 193 <tr>
 194 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 195 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 196 </td>
 197 </tr>
 198 <tr>
 199 <td><p><span class="term"><em class="parameter"><code>fontname</code></em> :</span></p></td>
 200 <td>a font name like "Helvetica 12" or "Times Bold 18"</td>
 201 </tr>
 202 <tr>
 203 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 204 <td>
 205 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the font could be set successfully; <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if no
 206 such font exists or if the <em class="parameter"><code>fontsel</code></em> doesn't belong to a particular
 207 screen yet.</td>
 208 </tr>
 209 </tbody>
 210 </table></div>
 211 </div>
 212 <hr>
 213 <div class="refsect2">
 214 <a name="gtk-font-selection-get-preview-text"></a><h3>gtk_font_selection_get_preview_text ()</h3>
 215 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_font_selection_get_preview_text (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 216 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 217 <h3 class="title">Warning</h3>
 218 <p><code class="literal">gtk_font_selection_get_preview_text</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 219 </div>
 220 <p>
 221 Gets the text displayed in the preview area.
 222 </p>
 223 <div class="variablelist"><table border="0">
 224 <col align="left" valign="top">
 225 <tbody>
 226 <tr>
 227 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 228 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 229 </td>
 230 </tr>
 231 <tr>
 232 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 233 <td>the text displayed in the preview area.
 234 This string is owned by the widget and should not be
 235 modified or freed</td>
 236 </tr>
 237 </tbody>
 238 </table></div>
 239 </div>
 240 <hr>
 241 <div class="refsect2">
 242 <a name="gtk-font-selection-set-preview-text"></a><h3>gtk_font_selection_set_preview_text ()</h3>
 243 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_font_selection_set_preview_text (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>,
 244                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
 245 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 246 <h3 class="title">Warning</h3>
 247 <p><code class="literal">gtk_font_selection_set_preview_text</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 248 </div>
 249 <p>
 250 Sets the text displayed in the preview area.
 251 The <em class="parameter"><code>text</code></em> is used to show how the selected font looks.
 252 </p>
 253 <div class="variablelist"><table border="0">
 254 <col align="left" valign="top">
 255 <tbody>
 256 <tr>
 257 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 258 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 259 </td>
 260 </tr>
 261 <tr>
 262 <td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
 263 <td>the text to display in the preview area</td>
 264 </tr>
 265 </tbody>
 266 </table></div>
 267 </div>
 268 <hr>
 269 <div class="refsect2">
 270 <a name="gtk-font-selection-get-face"></a><h3>gtk_font_selection_get_face ()</h3>
 271 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFace"><span class="returnvalue">PangoFontFace</span></a> *     gtk_font_selection_get_face         (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 272 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 273 <h3 class="title">Warning</h3>
 274 <p><code class="literal">gtk_font_selection_get_face</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 275 </div>
 276 <p>
 277 Gets the <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> representing the selected font group
 278 details (i.e. family, slant, weight, width, etc).
 279 </p>
 280 <div class="variablelist"><table border="0">
 281 <col align="left" valign="top">
 282 <tbody>
 283 <tr>
 284 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 285 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 286 </td>
 287 </tr>
 288 <tr>
 289 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 290 <td>A <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> representing the
 291 selected font group details. The returned object is owned by
 292 <em class="parameter"><code>fontsel</code></em> and must not be modified or freed. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 293 </td>
 294 </tr>
 295 </tbody>
 296 </table></div>
 297 <p class="since">Since 2.14</p>
 298 </div>
 299 <hr>
 300 <div class="refsect2">
 301 <a name="gtk-font-selection-get-face-list"></a><h3>gtk_font_selection_get_face_list ()</h3>
 302 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_font_selection_get_face_list    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 303 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 304 <h3 class="title">Warning</h3>
 305 <p><code class="literal">gtk_font_selection_get_face_list</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 306 </div>
 307 <p>
 308 This returns the <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> which lists all styles available for
 309 the selected font. For example, 'Regular', 'Bold', etc.
 310 </p>
 311 <div class="variablelist"><table border="0">
 312 <col align="left" valign="top">
 313 <tbody>
 314 <tr>
 315 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 316 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 317 </td>
 318 </tr>
 319 <tr>
 320 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 321 <td>A <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that is part of <em class="parameter"><code>fontsel</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 322 </td>
 323 </tr>
 324 </tbody>
 325 </table></div>
 326 <p class="since">Since 2.14</p>
 327 </div>
 328 <hr>
 329 <div class="refsect2">
 330 <a name="gtk-font-selection-get-family"></a><h3>gtk_font_selection_get_family ()</h3>
 331 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFamily"><span class="returnvalue">PangoFontFamily</span></a> *   gtk_font_selection_get_family       (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 332 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 333 <h3 class="title">Warning</h3>
 334 <p><code class="literal">gtk_font_selection_get_family</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 335 </div>
 336 <p>
 337 Gets the <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> representing the selected font family.
 338 </p>
 339 <div class="variablelist"><table border="0">
 340 <col align="left" valign="top">
 341 <tbody>
 342 <tr>
 343 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 344 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 345 </td>
 346 </tr>
 347 <tr>
 348 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 349 <td>A <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> representing the
 350 selected font family. Font families are a collection of font
 351 faces. The returned object is owned by <em class="parameter"><code>fontsel</code></em> and must not
 352 be modified or freed. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 353 </td>
 354 </tr>
 355 </tbody>
 356 </table></div>
 357 <p class="since">Since 2.14</p>
 358 </div>
 359 <hr>
 360 <div class="refsect2">
 361 <a name="gtk-font-selection-get-size"></a><h3>gtk_font_selection_get_size ()</h3>
 362 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_font_selection_get_size         (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 363 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 364 <h3 class="title">Warning</h3>
 365 <p><code class="literal">gtk_font_selection_get_size</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 366 </div>
 367 <p>
 368 The selected font size.
 369 </p>
 370 <div class="variablelist"><table border="0">
 371 <col align="left" valign="top">
 372 <tbody>
 373 <tr>
 374 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 375 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 376 </td>
 377 </tr>
 378 <tr>
 379 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 380 <td>A n integer representing the selected font size,
 381 or -1 if no font size is selected.</td>
 382 </tr>
 383 </tbody>
 384 </table></div>
 385 <p class="since">Since 2.14</p>
 386 </div>
 387 <hr>
 388 <div class="refsect2">
 389 <a name="gtk-font-selection-get-family-list"></a><h3>gtk_font_selection_get_family_list ()</h3>
 390 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_font_selection_get_family_list  (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 391 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 392 <h3 class="title">Warning</h3>
 393 <p><code class="literal">gtk_font_selection_get_family_list</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 394 </div>
 395 <p>
 396 This returns the <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> that lists font families, for
 397 example, 'Sans', 'Serif', etc.
 398 </p>
 399 <div class="variablelist"><table border="0">
 400 <col align="left" valign="top">
 401 <tbody>
 402 <tr>
 403 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 404 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 405 </td>
 406 </tr>
 407 <tr>
 408 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 409 <td>A <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that is part of <em class="parameter"><code>fontsel</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 410 </td>
 411 </tr>
 412 </tbody>
 413 </table></div>
 414 <p class="since">Since 2.14</p>
 415 </div>
 416 <hr>
 417 <div class="refsect2">
 418 <a name="gtk-font-selection-get-preview-entry"></a><h3>gtk_font_selection_get_preview_entry ()</h3>
 419 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_font_selection_get_preview_entry
 420                                                         (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 421 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 422 <h3 class="title">Warning</h3>
 423 <p><code class="literal">gtk_font_selection_get_preview_entry</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 424 </div>
 425 <p>
 426 This returns the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> used to display the font as a preview.
 427 </p>
 428 <div class="variablelist"><table border="0">
 429 <col align="left" valign="top">
 430 <tbody>
 431 <tr>
 432 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 433 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 434 </td>
 435 </tr>
 436 <tr>
 437 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 438 <td>A <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that is part of <em class="parameter"><code>fontsel</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 439 </td>
 440 </tr>
 441 </tbody>
 442 </table></div>
 443 <p class="since">Since 2.14</p>
 444 </div>
 445 <hr>
 446 <div class="refsect2">
 447 <a name="gtk-font-selection-get-size-entry"></a><h3>gtk_font_selection_get_size_entry ()</h3>
 448 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_font_selection_get_size_entry   (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 449 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 450 <h3 class="title">Warning</h3>
 451 <p><code class="literal">gtk_font_selection_get_size_entry</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 452 </div>
 453 <p>
 454 This returns the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> used to allow the user to edit the font
 455 number manually instead of selecting it from the list of font sizes.
 456 </p>
 457 <div class="variablelist"><table border="0">
 458 <col align="left" valign="top">
 459 <tbody>
 460 <tr>
 461 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 462 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 463 </td>
 464 </tr>
 465 <tr>
 466 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 467 <td>A <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that is part of <em class="parameter"><code>fontsel</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 468 </td>
 469 </tr>
 470 </tbody>
 471 </table></div>
 472 <p class="since">Since 2.14</p>
 473 </div>
 474 <hr>
 475 <div class="refsect2">
 476 <a name="gtk-font-selection-get-size-list"></a><h3>gtk_font_selection_get_size_list ()</h3>
 477 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_font_selection_get_size_list    (<em class="parameter"><code><a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a> *fontsel</code></em>);</pre>
 478 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 479 <h3 class="title">Warning</h3>
 480 <p><code class="literal">gtk_font_selection_get_size_list</code> has been deprecated since version 3.2 and should not be used in newly-written code. Use <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a></p>
 481 </div>
 482 <p>
 483 This returns the <span class="type">GtkTreeeView</span> used to list font sizes.
 484 </p>
 485 <div class="variablelist"><table border="0">
 486 <col align="left" valign="top">
 487 <tbody>
 488 <tr>
 489 <td><p><span class="term"><em class="parameter"><code>fontsel</code></em> :</span></p></td>
 490 <td>a <a class="link" href="GtkFontSelection.html" title="GtkFontSelection"><span class="type">GtkFontSelection</span></a>
 491 </td>
 492 </tr>
 493 <tr>
 494 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 495 <td>A <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that is part of <em class="parameter"><code>fontsel</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 496 </td>
 497 </tr>
 498 </tbody>
 499 </table></div>
 500 <p class="since">Since 2.14</p>
 501 </div>
 502 </div>
 503 <div class="refsect1">
 504 <a name="GtkFontSelection.property-details"></a><h2>Property Details</h2>
 505 <div class="refsect2">
 506 <a name="GtkFontSelection--font-name"></a><h3>The <code class="literal">"font-name"</code> property</h3>
 507 <pre class="programlisting">  "font-name"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 508 <p>The string that represents this font.</p>
 509 <p>Default value: "Sans 10"</p>
 510 </div>
 511 <hr>
 512 <div class="refsect2">
 513 <a name="GtkFontSelection--preview-text"></a><h3>The <code class="literal">"preview-text"</code> property</h3>
 514 <pre class="programlisting">  "preview-text"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 515 <p>The text to display in order to demonstrate the selected font.</p>
 516 <p>Default value: "abcdefghijk ABCDEFGHIJK"</p>
 517 </div>
 518 </div>
 519 <div class="refsect1">
 520 <a name="GtkFontSelection.see-also"></a><h2>See Also</h2>
 521 <a class="link" href="GtkFontSelectionDialog.html" title="GtkFontSelectionDialog"><span class="type">GtkFontSelectionDialog</span></a>, <a class="link" href="GtkFontChooser.html" title="GtkFontChooser"><span class="type">GtkFontChooser</span></a>
 522 </div>
 523 </div>
 524 <div class="footer">
 525 <hr>
 526           Generated by GTK-Doc V1.18</div>
 527 </body>
 528 </html>