gtkmm
3.8.1
|
An interface implemented by widgets displaying fonts. More...
Public Types | |
typedef sigc::slot< bool, const Glib::RefPtr< const Pango::FontFamily > &, const Glib::RefPtr< const Pango::FontFace >& > | SlotFontFilter |
Font filter callback. More... | |
Public Member Functions | |
virtual | ~FontChooser () |
GtkFontChooser* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkFontChooser* | gobj () const |
Provides access to the underlying C GObject. More... | |
Glib::RefPtr< Pango::FontFamily > | get_font_family () |
Gets the Pango::FontFamily representing the selected font family. More... | |
Glib::RefPtr< const Pango::FontFamily > | get_font_family () const |
Gets the Pango::FontFamily representing the selected font family. More... | |
Glib::RefPtr< Pango::FontFace > | get_font_face () |
Gets the Pango::FontFace representing the selected font group details (i.e. family, slant, weight, width, etc). More... | |
Glib::RefPtr< const Pango::FontFace > | get_font_face () const |
Gets the Pango::FontFace representing the selected font group details (i.e. family, slant, weight, width, etc). More... | |
int | get_font_size () const |
The selected font size. More... | |
Pango::FontDescription | get_font_desc () const |
Gets the currently-selected font. More... | |
void | set_font_desc (const Pango::FontDescription& font_desc) |
Sets the currently-selected font from font_desc. More... | |
Glib::ustring | get_font () const |
Gets the currently-selected font name. More... | |
void | set_font (const Glib::ustring& fontname) |
Sets the currently-selected font. More... | |
Glib::ustring | get_preview_text () const |
Gets the text displayed in the preview area. More... | |
void | set_preview_text (const Glib::ustring& text) |
Sets the text displayed in the preview area. More... | |
bool | get_show_preview_entry () const |
Returns whether the preview entry is shown or not. More... | |
void | set_show_preview_entry (bool show_preview_entry=true) |
Shows or hides the editable preview entry. More... | |
void | set_filter_func (const SlotFontFilter& slot) |
Adds a filter function that decides which fonts to display in the font chooser. More... | |
Glib::SignalProxy1< void, const Glib::ustring& > | signal_font_activated () |
Glib::PropertyProxy < Glib::ustring > | property_font () |
Font description as a string, e.g. More... | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_font () const |
Font description as a string, e.g. More... | |
Glib::PropertyProxy < Pango::FontDescription > | property_font_desc () |
Font description as a PangoFontDescription struct. More... | |
Glib::PropertyProxy_ReadOnly < Pango::FontDescription > | property_font_desc () const |
Font description as a PangoFontDescription struct. More... | |
Glib::PropertyProxy < Glib::ustring > | property_preview_text () |
The text to display in order to demonstrate the selected font. More... | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_preview_text () const |
The text to display in order to demonstrate the selected font. More... | |
Glib::PropertyProxy< bool > | property_show_preview_entry () |
Whether the preview text entry is shown or not. More... | |
Glib::PropertyProxy_ReadOnly < bool > | property_show_preview_entry () const |
Whether the preview text entry is shown or not. More... | |
Static Public Member Functions | |
static void | add_interface (GType gtype_implementer) |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Protected Member Functions | |
FontChooser () | |
You should derive from this class to use it. More... | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr< Gtk::FontChooser > | wrap (GtkFontChooser* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
An interface implemented by widgets displaying fonts.
FontChooser widgets list the available fonts, styles and sizes, allowing the user to select a font.
To set the font which is initially selected, use set_font_name().
To get the selected font use get_font_name().
To change the text which is shown in the preview area, use set_preview_text().
typedef sigc::slot<bool, const Glib::RefPtr<const Pango::FontFamily>&, const Glib::RefPtr<const Pango::FontFace>&> Gtk::FontChooser::SlotFontFilter |
Font filter callback.
For instance,
font_family | A Pango FontFamily. |
font_face | A Font Face belonging to the font_family. |
This is used for deciding what fonts should be shown in a FontChooser. See set_filter_func().
|
protected |
You should derive from this class to use it.
|
virtual |
|
static |
Glib::ustring Gtk::FontChooser::get_font | ( | ) | const |
Gets the currently-selected font name.
Note that this can be a different string than what you set with set_font(), as the font chooser widget may normalize font names and thus return a string with a different structure. For example, "Helvetica Italic Bold 12" could be normalized to "Helvetica Bold Italic 12".
Use pango_font_description_equal() if you want to compare two font descriptions.
0
if no font is selected. You must free this string with Glib::free(). Pango::FontDescription Gtk::FontChooser::get_font_desc | ( | ) | const |
Gets the currently-selected font.
Note that this can be a different string than what you set with set_font(), as the font chooser widget may normalize font names and thus return a string with a different structure. For example, "Helvetica Italic Bold 12" could be normalized to "Helvetica Bold Italic 12".
Use pango_font_description_equal() if you want to compare two font descriptions.
0
if no font is selected. Glib::RefPtr<Pango::FontFace> Gtk::FontChooser::get_font_face | ( | ) |
Gets the Pango::FontFace representing the selected font group details (i.e. family, slant, weight, width, etc).
If the selected font is not installed, returns 0
.
0
. The returned object is owned by fontchooser and must not be modified or freed. Glib::RefPtr<const Pango::FontFace> Gtk::FontChooser::get_font_face | ( | ) | const |
Gets the Pango::FontFace representing the selected font group details (i.e. family, slant, weight, width, etc).
If the selected font is not installed, returns 0
.
0
. The returned object is owned by fontchooser and must not be modified or freed. Glib::RefPtr<Pango::FontFamily> Gtk::FontChooser::get_font_family | ( | ) |
Gets the Pango::FontFamily representing the selected font family.
Font families are a collection of font faces.
If the selected font is not installed, returns 0
.
0
. The returned object is owned by fontchooser and must not be modified or freed. Glib::RefPtr<const Pango::FontFamily> Gtk::FontChooser::get_font_family | ( | ) | const |
Gets the Pango::FontFamily representing the selected font family.
Font families are a collection of font faces.
If the selected font is not installed, returns 0
.
0
. The returned object is owned by fontchooser and must not be modified or freed. int Gtk::FontChooser::get_font_size | ( | ) | const |
The selected font size.
Glib::ustring Gtk::FontChooser::get_preview_text | ( | ) | const |
Gets the text displayed in the preview area.
bool Gtk::FontChooser::get_show_preview_entry | ( | ) | const |
Returns whether the preview entry is shown or not.
true
if the preview entry is shown or false
if it is hidden.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
|
inline |
Provides access to the underlying C GObject.
|
inline |
Provides access to the underlying C GObject.
Glib::PropertyProxy< Glib::ustring > Gtk::FontChooser::property_font | ( | ) |
Font description as a string, e.g.
'Sans Italic 12'.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::FontChooser::property_font | ( | ) | const |
Font description as a string, e.g.
'Sans Italic 12'.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy< Pango::FontDescription > Gtk::FontChooser::property_font_desc | ( | ) |
Font description as a PangoFontDescription struct.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly< Pango::FontDescription > Gtk::FontChooser::property_font_desc | ( | ) | const |
Font description as a PangoFontDescription struct.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy< Glib::ustring > Gtk::FontChooser::property_preview_text | ( | ) |
The text to display in order to demonstrate the selected font.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::FontChooser::property_preview_text | ( | ) | const |
The text to display in order to demonstrate the selected font.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy< bool > Gtk::FontChooser::property_show_preview_entry | ( | ) |
Whether the preview text entry is shown or not.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly< bool > Gtk::FontChooser::property_show_preview_entry | ( | ) | const |
Whether the preview text entry is shown or not.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
void Gtk::FontChooser::set_filter_func | ( | const SlotFontFilter& | slot | ) |
Adds a filter function that decides which fonts to display in the font chooser.
slot | A callback, to be called for each font. |
void Gtk::FontChooser::set_font | ( | const Glib::ustring & | fontname | ) |
Sets the currently-selected font.
fontname | A font name like "Helvetica 12" or "Times Bold 18". |
void Gtk::FontChooser::set_font_desc | ( | const Pango::FontDescription & | font_desc | ) |
Sets the currently-selected font from font_desc.
font_desc | A Pango::FontDescription. |
void Gtk::FontChooser::set_preview_text | ( | const Glib::ustring & | text | ) |
Sets the text displayed in the preview area.
The text is used to show how the selected font looks.
text | The text to display in the preview area. |
void Gtk::FontChooser::set_show_preview_entry | ( | bool | show_preview_entry = true | ) |
Shows or hides the editable preview entry.
show_preview_entry | Whether to show the editable preview entry or not. |
Glib::SignalProxy1< void,const Glib::ustring& > Gtk::FontChooser::signal_font_activated | ( | ) |
void on_my_font_activated(const Glib::ustring& fontname)
Emitted when a font is activated. This usually happens when the user double clicks an item, or an item is selected and the user presses one of the keys Space, Shift+Space, Return or Enter.
fontname | The font name. |
|
related |
A Glib::wrap() method for this object.
object | The C instance. |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |