A standard dialogue to choose a font.

Synopsis

gnocl::fontSelection [-option value...]

Screenshot

Options

-title string (default: "")

Title of the fontSelection.

-modal boolean (default: 0)

Whether the window is modal, i.e. it grabs all GTK+ events. If the dialogue is created modal, the command returns the chosen colour as list of rgba values or the empty string instead of the usual widget ID.

-font font

Default font for the dialogue.

-previewText string (default: "abcdefghijk ABCDEFGHIJK")

Text which is used in the preview.

-onClicked string (default: "")

Command to be executed in the global scope if the Ok or Cancel button is chosen. Before evaluation the following percent strings are substituted:

%x    button chosen: OK or CANCEL
%f    font chosen

-visible boolean (default: 1)

Whether or not the item is visible.

-name string

Name of the widget, can be used to set options in an rc file.

-onDestroy string (default: "")

Tcl command which is executed if the widget is destroyed. Before evaluation the following percent strings are substituted:

%w    widget name

Description

A gnocl::fontSelection widget is used to let the user choose a font in a standardized way. If the dialogue is created modal, the commands returns the font or the empty string if Cancel is chosen. Otherwise it returns a widget ID in the usual way. The font and buttons chosen can be retrieved via the onClicked command.

Commands

id delete

Deletes the widget and the associated tcl command.

id configure [-option value...]

Configures the widget. Option may have any of the values accepted on creation of the widget.

Example