Struct gtk4::FontButton

#[repr(transparent)]
pub struct FontButton { /* private fields */ }

The FontButton allows to open a font chooser dialog to change the font.

It is suitable widget for selecting a font in a preference dialog.

CSS nodes

fontbutton
╰── button.font
    ╰── [content]

FontButton has a single CSS node with name fontbutton which contains a button node with the .font style class.

Implements

WidgetExt, glib::ObjectExt, AccessibleExt, BuildableExt, ConstraintTargetExt, FontChooserExt, WidgetExtManual, AccessibleExtManual, FontChooserExtManual

Implementations

impl FontButton

pub fn new() -> FontButton

Creates a new font picker widget.

Returns

a new font picker widget.

pub fn with_font(fontname: &str) -> FontButton

Creates a new font picker widget showing the given font.

fontname

Name of font to display in font chooser dialog

Returns

a new font picker widget.

pub fn builder() -> FontButtonBuilder

Creates a new builder-pattern struct instance to construct FontButton objects.

This method returns an instance of FontButtonBuilder which can be used to create FontButton objects.

pub fn is_modal(&self) -> bool

Gets whether the dialog is modal.

Returns

true if the dialog is modal

pub fn title(&self) -> GString

Retrieves the title of the font chooser dialog.

Returns

an internal copy of the title string which must not be freed.

pub fn uses_font(&self) -> bool

Returns whether the selected font is used in the label.

Returns

whether the selected font is used in the label.

pub fn uses_size(&self) -> bool

Returns whether the selected size is used in the label.

Returns

whether the selected size is used in the label.

pub fn set_modal(&self, modal: bool)

Sets whether the dialog should be modal.

modal

true to make the dialog modal

pub fn set_title(&self, title: &str)

Sets the title for the font chooser dialog.

title

a string containing the font chooser dialog title

pub fn set_use_font(&self, use_font: bool)

If @use_font is true, the font name will be written using the selected font.

use_font

If true, font name will be written using font chosen.

pub fn set_use_size(&self, use_size: bool)

If @use_size is true, the font name will be written using the selected size.

use_size

If true, font name will be written using the selected size.

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

Available on crate feature v4_4 only.

Emitted to when the font button is activated.

The ::activate signal on FontButton is an action signal and emitting it causes the button to present its dialog.

pub fn emit_activate(&self)

Available on crate feature v4_4 only.

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

Emitted when the user selects a font.

When handling this signal, use FontChooserExt::font() to find out which font was just selected.

Note that this signal is only emitted when the user changes the font. If you need to react to programmatic font changes as well, use the notify::font signal.

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

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

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

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

Trait Implementations

impl Clone for FontButton

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FontButton

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FontButton

fn default() -> Self

Returns the “default value” for a type.

impl Display for FontButton

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for FontButton

fn hash<H>(&self, state: &mut H)where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for FontButton

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for FontButton

type Parent = Widget

impl<OT: ObjectType> PartialEq<OT> for FontButton

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for FontButton

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for FontButton

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for FontButton

impl IsA<Accessible> for FontButton

impl IsA<Buildable> for FontButton

impl IsA<ConstraintTarget> for FontButton

impl IsA<FontChooser> for FontButton

impl IsA<Widget> for FontButton