← Back to branch summary

~ubuntu-branches/ubuntu/quantal/gtkmm3.0/quantal

« back to all changes in this revision

Viewing changes to gtk/gtkmm/fontselection.h

  • Committer: Package Import Robot
  • Author(s): Sebastien Bacher
  • Date: 2012-03-01 23:42:36 UTC
  • mfrom: (1.1.8)
  • Revision ID: package-import@ubuntu.com-20120301234236-12w6m0hkomhi7h53
Tags: 3.3.16-0ubuntu1
* New upstream version
* debian/control.in: updated the glib requirement

Show diffs side-by-side

added added

removed removed

Lines of Context:
gtk/gtkmm/fontselection.h
134
134
   * example, 'Sans', 'Serif', etc.
135
135
   * 
136
136
   * @newin{2,14}
 
137
   * 
 
138
   * Deprecated: 3.2: Use Gtk::FontChooser
137
139
   * @return A Gtk::Widget that is part of @a fontsel.
138
140
   */
139
141
  TreeView* get_family_list();
142
144
   * example, 'Sans', 'Serif', etc.
143
145
   * 
144
146
   * @newin{2,14}
 
147
   * 
 
148
   * Deprecated: 3.2: Use Gtk::FontChooser
145
149
   * @return A Gtk::Widget that is part of @a fontsel.
146
150
   */
147
151
  const TreeView* get_family_list() const;
151
155
   * the selected font. For example, 'Regular', 'Bold', etc.
152
156
   * 
153
157
   * @newin{2,14}
 
158
   * 
 
159
   * Deprecated: 3.2: Use Gtk::FontChooser
154
160
   * @return A Gtk::Widget that is part of @a fontsel.
155
161
   */
156
162
  TreeView* get_face_list();
159
165
   * the selected font. For example, 'Regular', 'Bold', etc.
160
166
   * 
161
167
   * @newin{2,14}
 
168
   * 
 
169
   * Deprecated: 3.2: Use Gtk::FontChooser
162
170
   * @return A Gtk::Widget that is part of @a fontsel.
163
171
   */
164
172
  const TreeView* get_face_list() const;
168
176
   * number manually instead of selecting it from the list of font sizes.
169
177
   * 
170
178
   * @newin{2,14}
 
179
   * 
 
180
   * Deprecated: 3.2: Use Gtk::FontChooser
171
181
   * @return A Gtk::Widget that is part of @a fontsel.
172
182
   */
173
183
  Entry* get_size_entry();
176
186
   * number manually instead of selecting it from the list of font sizes.
177
187
   * 
178
188
   * @newin{2,14}
 
189
   * 
 
190
   * Deprecated: 3.2: Use Gtk::FontChooser
179
191
   * @return A Gtk::Widget that is part of @a fontsel.
180
192
   */
181
193
  const Entry* get_size_entry() const;
184
196
  /** This returns the Gtk::TreeeView used to list font sizes.
185
197
   * 
186
198
   * @newin{2,14}
 
199
   * 
 
200
   * Deprecated: 3.2: Use Gtk::FontChooser
187
201
   * @return A Gtk::Widget that is part of @a fontsel.
188
202
   */
189
203
  TreeView* get_size_list();
191
205
  /** This returns the Gtk::TreeeView used to list font sizes.
192
206
   * 
193
207
   * @newin{2,14}
 
208
   * 
 
209
   * Deprecated: 3.2: Use Gtk::FontChooser
194
210
   * @return A Gtk::Widget that is part of @a fontsel.
195
211
   */
196
212
  const TreeView* get_size_list() const;
199
215
  /** This returns the Gtk::Entry used to display the font as a preview.
200
216
   * 
201
217
   * @newin{2,14}
 
218
   * 
 
219
   * Deprecated: 3.2: Use Gtk::FontChooser
202
220
   * @return A Gtk::Widget that is part of @a fontsel.
203
221
   */
204
222
  Entry* get_preview_entry();
206
224
  /** This returns the Gtk::Entry used to display the font as a preview.
207
225
   * 
208
226
   * @newin{2,14}
 
227
   * 
 
228
   * Deprecated: 3.2: Use Gtk::FontChooser
209
229
   * @return A Gtk::Widget that is part of @a fontsel.
210
230
   */
211
231
  const Entry* get_preview_entry() const;
214
234
  /** Gets the Pango::FontFamily representing the selected font family.
215
235
   * 
216
236
   * @newin{2,14}
 
237
   * 
 
238
   * Deprecated: 3.2: Use Gtk::FontChooser
217
239
   * @return A Pango::FontFamily representing the
218
240
   * selected font family. Font families are a collection of font
219
241
   * faces. The returned object is owned by @a fontsel and must not
224
246
  /** Gets the Pango::FontFamily representing the selected font family.
225
247
   * 
226
248
   * @newin{2,14}
 
249
   * 
 
250
   * Deprecated: 3.2: Use Gtk::FontChooser
227
251
   * @return A Pango::FontFamily representing the
228
252
   * selected font family. Font families are a collection of font
229
253
   * faces. The returned object is owned by @a fontsel and must not
236
260
   * details (i.e.\ family, slant, weight, width, etc).
237
261
   * 
238
262
   * @newin{2,14}
 
263
   * 
 
264
   * Deprecated: 3.2: Use Gtk::FontChooser
239
265
   * @return A Pango::FontFace representing the
240
266
   * selected font group details. The returned object is owned by
241
267
   *  @a fontsel and must not be modified or freed.
246
272
   * details (i.e.\ family, slant, weight, width, etc).
247
273
   * 
248
274
   * @newin{2,14}
 
275
   * 
 
276
   * Deprecated: 3.2: Use Gtk::FontChooser
249
277
   * @return A Pango::FontFace representing the
250
278
   * selected font group details. The returned object is owned by
251
279
   *  @a fontsel and must not be modified or freed.
256
284
  /** The selected font size.
257
285
   * 
258
286
   * @newin{2,14}
 
287
   * 
 
288
   * Deprecated: 3.2: Use Gtk::FontChooser
259
289
   * @return A n integer representing the selected font size,
260
290
   * or -1 if no font size is selected.
261
291
   */
270
300
   * For example, "Helvetica Italic Bold 12" could be normalized to 
271
301
   * "Helvetica Bold Italic 12". Use pango_font_description_equal()
272
302
   * if you want to compare two font descriptions.
 
303
   * 
 
304
   * Deprecated: 3.2: Use Gtk::FontChooser
273
305
   * @return A string with the name of the current font, or <tt>0</tt> if 
274
306
   * no font is selected. You must free this string with Glib::free().
275
307
   */
280
312
   * Note that the @a fontsel needs to know the screen in which it will appear 
281
313
   * for this to work; this can be guaranteed by simply making sure that the 
282
314
   *  @a fontsel is inserted in a toplevel window before you call this function.
 
315
   * 
 
316
   * Deprecated: 3.2: Use Gtk::FontChooser
283
317
   * @param fontname A font name like "Helvetica 12" or "Times Bold 18".
284
318
   * @return <tt>true</tt> if the font could be set successfully; <tt>false</tt> if no 
285
319
   * such font exists or if the @a fontsel doesn't belong to a particular 
288
322
  bool set_font_name(const Glib::ustring& fontname);
289
323
  
290
324
  /** Gets the text displayed in the preview area.
 
325
   * 
 
326
   * Deprecated: 3.2: Use Gtk::FontChooser
291
327
   * @return The text displayed in the preview area. 
292
328
   * This string is owned by the widget and should not be 
293
329
   * modified or freed.
296
332
  
297
333
  /** Sets the text displayed in the preview area.
298
334
   * The @a text is used to show how the selected font looks.
 
335
   * 
 
336
   * Deprecated: 3.2: Use Gtk::FontChooser
299
337
   * @param text The text to display in the preview area.
300
338
   */
301
339
  void set_preview_text(const Glib::ustring& fontname);
305
343
 
306
344
  //Note: The GdkFont "font" property is deprecated, or should be.
307
345
  #ifdef GLIBMM_PROPERTIES_ENABLED
308
 
/** The string that represents this font.
 
346
/** 
309
347
   *
310
348
   * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
311
349
   * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
325
363
#endif //#GLIBMM_PROPERTIES_ENABLED
326
364
 
327
365
  #ifdef GLIBMM_PROPERTIES_ENABLED
328
 
/** The text to display in order to demonstrate the selected font.
 
366
/** 
329
367
   *
330
368
   * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
331
369
   * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
419
457
    explicit FontSelectionDialog(const Glib::ustring& title);
420
458
 
421
459
 
422
 
  /** Sets the currently selected font.
 
460
  /** Sets the currently selected font. 
 
461
   * 
 
462
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
423
463
   * @param fontname A font name like "Helvetica 12" or "Times Bold 18".
424
464
   * @return <tt>true</tt> if the font selected in @a fsd is now the
425
465
   *  @a fontname specified, <tt>false</tt> otherwise.
434
474
   * structure. For example, "Helvetica Italic Bold 12" could be normalized 
435
475
   * to "Helvetica Bold Italic 12".  Use pango_font_description_equal()
436
476
   * if you want to compare two font descriptions.
 
477
   * 
 
478
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
437
479
   * @return A string with the name of the current font, or <tt>0</tt> if no 
438
480
   * font is selected. You must free this string with Glib::free().
439
481
   */
440
482
  Glib::ustring get_font_name() const;
441
483
  
442
484
  /** Gets the text displayed in the preview area.
 
485
   * 
 
486
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
443
487
   * @return The text displayed in the preview area. 
444
488
   * This string is owned by the widget and should not be 
445
489
   * modified or freed.
446
490
   */
447
491
  Glib::ustring get_preview_text() const;
448
492
  
449
 
  /** Sets the text displayed in the preview area.
 
493
  /** Sets the text displayed in the preview area. 
 
494
   * 
 
495
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
450
496
   * @param text The text to display in the preview area.
451
497
   */
452
498
  void set_preview_text(const Glib::ustring& fontname);
455
501
  /** Gets the 'OK' button.
456
502
   * 
457
503
   * @newin{2,14}
 
504
   * 
 
505
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
458
506
   * @return The Gtk::Widget used in the dialog
459
507
   * for the 'OK' button.
460
508
   */
463
511
  /** Gets the 'OK' button.
464
512
   * 
465
513
   * @newin{2,14}
 
514
   * 
 
515
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
466
516
   * @return The Gtk::Widget used in the dialog
467
517
   * for the 'OK' button.
468
518
   */
472
522
  /** Gets the 'Cancel' button.
473
523
   * 
474
524
   * @newin{2,14}
 
525
   * 
 
526
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
475
527
   * @return The Gtk::Widget used in the dialog
476
528
   * for the 'Cancel' button.
477
529
   */
480
532
  /** Gets the 'Cancel' button.
481
533
   * 
482
534
   * @newin{2,14}
 
535
   * 
 
536
   * Deprecated: 3.2: Use Gtk::FontChooserDialog
483
537
   * @return The Gtk::Widget used in the dialog
484
538
   * for the 'Cancel' button.
485
539
   */