[−][src]Trait gtk::FontChooserExt

pub trait FontChooserExt: 'static {
    fn get_font(&self) -> Option<GString>;

    fn get_font_desc(&self) -> Option<FontDescription>;

    fn get_font_face(&self) -> Option<FontFace>;

    fn get_font_family(&self) -> Option<FontFamily>;

    fn get_font_features(&self) -> Option<GString>;

    fn get_font_map(&self) -> Option<FontMap>;

    fn get_font_size(&self) -> i32;

    fn get_language(&self) -> Option<GString>;

    fn get_level(&self) -> FontChooserLevel;

    fn get_preview_text(&self) -> Option<GString>;

    fn get_show_preview_entry(&self) -> bool;

    fn set_filter_func(
        &self, 
        filter: Option<Box_<dyn Fn(&FontFamily, &FontFace) -> bool + 'static>>
    );

    fn set_font(&self, fontname: &str);

    fn set_font_desc(&self, font_desc: &FontDescription);

    fn set_font_map<P: IsA<FontMap>>(&self, fontmap: Option<&P>);

    fn set_language(&self, language: &str);

    fn set_level(&self, level: FontChooserLevel);

    fn set_preview_text(&self, text: &str);

    fn set_show_preview_entry(&self, show_preview_entry: bool);

    fn connect_font_activated<F: Fn(&Self, &str) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_property_font_notify<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_property_font_desc_notify<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_property_font_features_notify<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_property_language_notify<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_property_level_notify<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_property_preview_text_notify<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_property_show_preview_entry_notify<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;
}

Trait containing all FontChooser methods.

Implementors

FontButton, FontChooserDialog, FontChooserWidget, FontChooser

Required methods

fn get_font(&self) -> Option<GString>

Gets the currently-selected font name.

Note that this can be a different string than what you set with FontChooser::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.

Returns

A string with the name of the current font, or None if no font is selected. You must free this string with g_free.

fn get_font_desc(&self) -> Option<FontDescription>

Gets the currently-selected font.

Note that this can be a different string than what you set with FontChooser::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.

Returns

A pango::FontDescription for the current font, or None if no font is selected.

fn get_font_face(&self) -> Option<FontFace>

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 None.

Returns

A pango::FontFace representing the selected font group details, or None. The returned object is owned by self and must not be modified or freed.

fn get_font_family(&self) -> Option<FontFamily>

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 None.

Returns

A pango::FontFamily representing the selected font family, or None. The returned object is owned by self and must not be modified or freed.

fn get_font_features(&self) -> Option<GString>

Gets the currently-selected font features.

Feature: v3_24

Returns

the currently selected font features

fn get_font_map(&self) -> Option<FontMap>

Gets the custom font map of this font chooser widget, or None if it does not have one.

Feature: v3_18

Returns

a pango::FontMap, or None

fn get_font_size(&self) -> i32

The selected font size.

Returns

A n integer representing the selected font size, or -1 if no font size is selected.

fn get_language(&self) -> Option<GString>

Gets the language that is used for font features.

Feature: v3_24

Returns

the currently selected language

fn get_level(&self) -> FontChooserLevel

Returns the current level of granularity for selecting fonts.

Feature: v3_24

Returns

the current granularity level

fn get_preview_text(&self) -> Option<GString>

Gets the text displayed in the preview area.

Returns

the text displayed in the preview area

fn get_show_preview_entry(&self) -> bool

Returns whether the preview entry is shown or not.

Returns

true if the preview entry is shown or false if it is hidden.

fn set_filter_func(
    &self,
    filter: Option<Box_<dyn Fn(&FontFamily, &FontFace) -> bool + 'static>>
)

Adds a filter function that decides which fonts to display in the font chooser.

filter

a GtkFontFilterFunc, or None

user_data

data to pass to filter

destroy

function to call to free data when it is no longer needed

fn set_font(&self, fontname: &str)

Sets the currently-selected font.

fontname

a font name like “Helvetica 12” or “Times Bold 18”

fn set_font_desc(&self, font_desc: &FontDescription)

Sets the currently-selected font from font_desc.

font_desc

a pango::FontDescription

fn set_font_map<P: IsA<FontMap>>(&self, fontmap: Option<&P>)

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.

FcConfig *config;
PangoFontMap *fontmap;

config = FcInitLoadConfigAndFonts ();
FcConfigAppFontAddFile (config, my_app_font_file);

fontmap = pango_cairo_font_map_new_for_font_type (CAIRO_FONT_TYPE_FT);
pango_fc_font_map_set_config (PANGO_FC_FONT_MAP (fontmap), config);

gtk_font_chooser_set_font_map (font_chooser, fontmap);

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:

context = gtk_widget_get_pango_context (label);
pango_context_set_font_map (context, fontmap);

Feature: v3_18

fontmap

a pango::FontMap

fn set_language(&self, language: &str)

Sets the language to use for font features.

Feature: v3_24

language

a language

fn set_level(&self, level: FontChooserLevel)

Sets the desired level of granularity for selecting fonts.

Feature: v3_24

level

the desired level of granularity

fn set_preview_text(&self, text: &str)

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

fn set_show_preview_entry(&self, show_preview_entry: bool)

Shows or hides the editable preview entry.

show_preview_entry

whether to show the editable preview entry or not

fn connect_font_activated<F: Fn(&Self, &str) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

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

fn connect_property_font_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_property_font_desc_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_property_font_features_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_property_language_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_property_level_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_property_preview_text_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_property_show_preview_entry_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

Loading content...

Implementors

impl<O: IsA<FontChooser>> FontChooserExt for O[src]

Loading content...