gtkmm 4.18.0
|
An interface implemented by widgets displaying fonts. More...
#include <gtkmm/fontchooser.h>
Public Types | |
enum class | Level { Level::FAMILY = 0x0 , Level::STYLE = 1 << 0 , Level::SIZE = 1 << 1 , Level::VARIATIONS = 1 << 2 , Level::FEATURES = 1 << 3 } |
Specifies the granularity of font selection that is desired in a Gtk::FontChooser . More... | |
typedef sigc::slot< bool(const Glib::RefPtr< const Pango::FontFamily > &, const Glib::RefPtr< const Pango::FontFace > &)> | SlotFontFilter |
Font filter callback. | |
![]() | |
typedef internal::func_destroy_notify | func_destroy_notify |
![]() | |
typedef internal::func_destroy_notify | func_destroy_notify |
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. | |
Protected Member Functions | |
FontChooser () | |
You should derive from this class to use it. | |
virtual void | on_font_activated (const Glib::ustring &fontname) |
This is a default handler for the signal signal_font_activated(). | |
![]() | |
ObjectBase () | |
ObjectBase (const char *custom_type_name) | |
ObjectBase (const std::type_info &custom_type_info) | |
ObjectBase (ObjectBase &&src) noexcept | |
ObjectBase & | operator= (ObjectBase &&src) noexcept |
virtual | ~ObjectBase () noexcept=0 |
void | initialize (GObject *castitem) |
void | initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper) |
Related Symbols | |
(Note that these are not member symbols.) | |
Glib::RefPtr< Gtk::FontChooser > | wrap (GtkFontChooser *object, bool take_copy=false) |
A Glib::wrap() method for this object. | |
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.
|
noexcept |
|
overridenoexcept |
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::FontDescription::equal() if you want to compare two font descriptions.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
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::FontDescription::equal() if you want to compare two font descriptions.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Pango::FontDescription
for the current font. 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 nullptr
.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Pango::FontFace
representing the selected font group details. 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 nullptr
.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Pango::FontFace
representing the selected font group details. 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 nullptr
.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Pango::FontFamily
representing the selected font family. 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 nullptr
.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Pango::FontFamily
representing the selected font family. Glib::ustring Gtk::FontChooser::get_font_features | ( | ) | const |
Gets the currently-selected font features.
The format of the returned string is compatible with the CSS font-feature-settings property. It can be passed to pango_attr_font_features_new().
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Glib::RefPtr< Pango::FontMap > Gtk::FontChooser::get_font_map | ( | ) |
Gets the custom font map of this font chooser widget, or nullptr
if it does not have one.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Pango::FontMap
. Glib::RefPtr< const Pango::FontMap > Gtk::FontChooser::get_font_map | ( | ) | const |
Gets the custom font map of this font chooser widget, or nullptr
if it does not have one.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Pango::FontMap
. int Gtk::FontChooser::get_font_size | ( | ) | const |
The selected font size.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Glib::ustring Gtk::FontChooser::get_language | ( | ) | const |
Gets the language that is used for font features.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Level Gtk::FontChooser::get_level | ( | ) | const |
Returns the current level of granularity for selecting fonts.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Glib::ustring Gtk::FontChooser::get_preview_text | ( | ) | const |
Gets the text displayed in the preview area.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
bool Gtk::FontChooser::get_show_preview_entry | ( | ) | const |
Returns whether the preview entry is shown or not.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
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.
|
protectedvirtual |
This is a default handler for the signal signal_font_activated().
|
noexcept |
Glib::PropertyProxy< Glib::ustring > Gtk::FontChooser::property_font | ( | ) |
The font description as a string, e.g. "Sans Italic 12".
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: "Sans 10"
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::FontChooser::property_font | ( | ) | const |
The font description as a string, e.g. "Sans Italic 12".
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: "Sans 10"
Glib::PropertyProxy< Pango::FontDescription > Gtk::FontChooser::property_font_desc | ( | ) |
The font description as a Pango::FontDescription
.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Glib::PropertyProxy_ReadOnly< Pango::FontDescription > Gtk::FontChooser::property_font_desc | ( | ) | const |
The font description as a Pango::FontDescription
.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::FontChooser::property_font_features | ( | ) | const |
The selected font features.
The format of the string is compatible with CSS and with Pango attributes.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: ""
Glib::PropertyProxy< Glib::ustring > Gtk::FontChooser::property_language | ( | ) |
The language for which the font features were selected.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: ""
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::FontChooser::property_language | ( | ) | const |
The language for which the font features were selected.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: ""
Glib::PropertyProxy< Level > Gtk::FontChooser::property_level | ( | ) |
The level of granularity to offer for selecting fonts.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: Gtk::FontChooser::Level::STYLE | Gtk::FontChooser::Level::SIZE
Glib::PropertyProxy_ReadOnly< Level > Gtk::FontChooser::property_level | ( | ) | const |
The level of granularity to offer for selecting fonts.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: Gtk::FontChooser::Level::STYLE | Gtk::FontChooser::Level::SIZE
Glib::PropertyProxy< Glib::ustring > Gtk::FontChooser::property_preview_text | ( | ) |
The string with which to preview the font.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: "The quick brown fox jumps over the lazy dog."
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::FontChooser::property_preview_text | ( | ) | const |
The string with which to preview the font.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: "The quick brown fox jumps over the lazy dog."
Glib::PropertyProxy< bool > Gtk::FontChooser::property_show_preview_entry | ( | ) |
Whether to show an entry to change the preview text.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: true
Glib::PropertyProxy_ReadOnly< bool > Gtk::FontChooser::property_show_preview_entry | ( | ) | const |
Whether to show an entry to change the preview text.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
Default value: true
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.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
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.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
font_desc | A Pango::FontDescription . |
void Gtk::FontChooser::set_font_map | ( | const Glib::RefPtr< Pango::FontMap > & | fontmap | ) |
Sets a custom font map to use for this font chooser widget.
A custom font map can be used to present application-specific fonts instead of or in addition to the normal system fonts.
[C example ellipted]
Note that other GTK widgets will only be able to use the application-specific font if it is present in the font map they use:
[C example ellipted]
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
fontmap | A Pango::FontMap . |
void Gtk::FontChooser::set_language | ( | const Glib::ustring & | language | ) |
Sets the language to use for font features.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
language | A language. |
Sets the desired level of granularity for selecting fonts.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
level | The desired level of granularity. |
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.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
text | The text to display in the preview area. |
Shows or hides the editable preview entry.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
show_preview_entry | Whether to show the editable preview entry or not. |
Glib::SignalProxy< void(const Glib::ustring &)> Gtk::FontChooser::signal_font_activated | ( | ) |
void on_my_font_activated(const Glib::ustring& fontname)
Flags: Run First
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.
Deprecated: 4.10: Use Gtk::FontDialog and Gtk::FontDialogButton instead
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. |