class: GtkFontDialogMeta

[447:14] static extends: object

Generated metadata helpers for FontDialog class surfaces.

Methods

properties ()

Returns property metadata for FontDialog.
- @r A list.

class: GtkFontDialog

[17:7] extends: object

Asynchronous API to present a font chooser dialog. GtkFontDialog collects the arguments that are needed to present the dialog to the user, such as a title for the dialog and whether it should be modal. The dialog is shown with the [method@Gtk.FontDialog.choose_font] function or its variants. See [class@Gtk.FontDialogButton] for a convenient control that uses GtkFontDialog and presents the results.

Members

handleObj
lib
retainedCallbacks
signalHandlerNames
signalSetterHandlers

Methods

GtkFontDialog (Handle = null)

Creates a new GtkFontDialog object.
- @p Handle is an optional native handle or wrapper whose handle to adopt; when the native constructor is called.
toNativeHandle (Source)

Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.
- @p Source is the raw handle, raw buffer, wrapper, or null.
- @r A raw pointer carrier or null when no pointer is present.
getLib ()

Returns the opened native library for this generated wrapper.
- @r The opened native library.
handle ()

Returns the wrapped NativeHandle.
- @r The wrapped NativeHandle.
isNull ()

Returns true when the wrapped handle is null.
- @r A bool.
describe ()

Returns a small string for debugging generated wrappers.
- @r A string.
asObject ()

Wraps this handle as GObject.
- @r A GObject object.
getProperty (string Name)

Reads one generated property by name.
setProperty (string Name, Value)

Writes one generated property by name.
setFilter (object Value)

A filter to restrict what fonts are shown in the font chooser dialog.
- @p Value is the new property value.
- @r None.
setFontmap (object Value)

A custom font map to select fonts from. A custom font map can be used to present application-specific fonts instead of or in addition to the normal system fonts.
- @p Value is the new property value.
- @r None.
setLanguage (object Value)

The language for which the font features are selected.
- @p Value is the new property value.
- @r None.
setModal (bool Value)

Whether the font chooser dialog is modal.
- @p Value is the new property value.
- @r None.
setTitle (string Value)

A title that may be shown on the font chooser dialog that is presented by [method@Gtk.FontDialog.choose_font].
- @p Value is the new property value.
- @r None.
choose_face (object parent, object initial_value, object cancellable, user_data)

Presents a font chooser dialog to the user. The font chooser dialog will be set up for selecting a font face. A font face represents a font family and style, but no specific font size.
- @p parent is the parent window.
- @p initial_value is the initial value.
- @p cancellable is a cancellable to cancel the operation.
- @p callback is a callback to call when the operation is complete.
- @p user_data is data to pass to @callback.
- @r None.
choose_face_finish (object result)

Finishes the [method@Gtk.FontDialog.choose_face] call. Note that this function returns a [error@Gtk.DialogError.DISMISSED] error if the user cancels the dialog.
- @p result is the result.
- @r the selected [class@Pango.FontFace].
choose_family (object parent, object initial_value, object cancellable, user_data)

Presents a font chooser dialog to the user. The font chooser dialog will be set up for selecting a font family.
- @p parent is the parent window.
- @p initial_value is the initial value.
- @p cancellable is a cancellable to cancel the operation.
- @p callback is a callback to call when the operation is complete.
- @p user_data is data to pass to @callback.
- @r None.
choose_family_finish (object result)

Finishes the [method@Gtk.FontDialog.choose_family] call. Note that this function returns a [error@Gtk.DialogError.DISMISSED] error if the user cancels the dialog.
- @p result is the result.
- @r the selected [class@Pango.FontFamily].
choose_font (object parent, object initial_value, object cancellable, user_data)

Presents a font chooser dialog to the user. The font chooser dialog will be set up for selecting a font. If you want to let the user select font features as well, use [method@Gtk.FontDialog.choose_font_and_features] instead.
- @p parent is the parent window.
- @p initial_value is the font to select initially.
- @p cancellable is a cancellable to cancel the operation.
- @p callback is a callback to call when the operation is complete.
- @p user_data is data to pass to @callback.
- @r None.
choose_font_and_features (object parent, object initial_value, object cancellable, user_data)

Presents a font chooser dialog to the user. The font chooser dialog will be set up for selecting a font and specify features for the selected font. Font features affect how the font is rendered, for example enabling glyph variants or ligatures.
- @p parent is the parent window.
- @p initial_value is the font to select initially.
- @p cancellable is a cancellable to cancel the operation.
- @p callback is a callback to call when the operation is complete.
- @p user_data is data to pass to @callback.
- @r None.
choose_font_and_features_finish (object result)

Finishes the [method@Gtk.FontDialog.choose_font_and_features] call. The selected font and features are returned in @font_desc and @font_features. Note that this function returns a [error@Gtk.DialogError.DISMISSED] error if the user cancels the dialog.
- @p result is the result.
- @p font_desc is return location for font description.
- @p font_features is return location for font features.
- @p language is return location for the language.
- @r true if a font was selected.
choose_font_finish (object result)

Finishes the [method@Gtk.FontDialog.choose_font] call. Note that this function returns a [error@Gtk.DialogError.DISMISSED] error if the user cancels the dialog.
- @p result is the result.
- @r a [struct@Pango.FontDescription] describing the selected font.
get_filter ()

Returns the filter that decides which fonts to display in the font chooser dialog.
- @r the filter.
get_font_map ()

Returns the fontmap from which fonts are selected, or NULL for the default fontmap.
- @r the fontmap.
get_language ()

Returns the language for which font features are applied.
- @r the language for font features.
get_modal ()

Returns whether the font chooser dialog blocks interaction with the parent window while it is presented.
- @r true if the font chooser dialog is modal.
get_title ()

Returns the title that will be shown on the font chooser dialog.
- @r the title.
set_filter (object filter)

Adds a filter that decides which fonts to display in the font chooser dialog. The filter must be able to handle both PangoFontFamily and PangoFontFace objects.
- @p filter is the filter.
- @r None.
set_font_map (object fontmap)

Sets the fontmap from which fonts are selected. If @fontmap is NULL, the default fontmap is used.
- @p fontmap is the fontmap.
- @r None.
set_language (object language)

Sets the language for which font features are applied.
- @p language is the language for font features.
- @r None.
set_modal (bool modal)

Sets whether the font chooser dialog blocks interaction with the parent window while it is presented.
- @p modal is the new value.
- @r None.
set_title (string title)

Sets the title that will be shown on the font chooser dialog.
- @p title is the new title.
- @r None.