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
set font [gnocl::fontSelection \
-title "Please choose a font" \
-modal 1 \
-font "Serif Bold 14"]
|