gtk.FontSelectionDialog — a dialog for selecting fonts.
class gtk.FontSelectionDialog(gtk.Dialog): |
+--gobject.GObject +-- gtk.Object +-- gtk.Widget +-- gtk.Container +-- gtk.Bin +-- gtk.Window +-- gtk.Dialog +-- gtk.FontSelectionDialog
|
The gtk.FontSelectionDialog
is a dialog box containing a gtk.FontSelection
widget that the user can use to select a font according to the desired
family, style and size.
The set_font_name
()
method sets the initial font selection. The current font selection is
retrieved using the get_font_name
()
method. The font selection dialog has a preview area that contains a gtk.Entry
that
displays text using the currently selected font. The preview text can be
retrieved with the get_preview_text
()
method and set with the set_preview_text
()
method.
Filters can be used to limit the font selections. There are 2
filters in the gtk.FontSelectionDialog
- a base filter and a user filter. The base filter cannot be changed by the
user, so this can be used when the user must choose from the restricted set
of fonts (e.g. for a terminal-type application you may want to force the
user to select a fixed-width font). The user filter can be changed or reset
by the user, by using the button or
changing the options on the Filter page of the
widget.
In GTK+ 2.2 and above the gtk.FontSelectionDialog
does not have filters, a button or a
Filter page.
gtk.FontSelectionDialog(title
)
| a string to be used as the dialog title |
Returns : | a new font selection dialog |
Creates a new gtk.FontSelectionDialog
with the title specified by title
.
def get_font_selection()
Returns : | the embedded gtk.FontSelection . |
This method is available in PyGTK 2.22 and above.
The get_font_selection
() method retrieves the
gtk.FontSelection
widget embedded in the dialog.
def get_font_name()
Returns : | the currently selected font name or None if no font is selected. |
The get_font_name
() method returns a
string containing the currently selected font name or None if no font name
is selected.
def set_font_name(fontname
)
| a string containing the font name to be set |
Returns : | True if the font is found
and can be selected |
The set_font_name
() method sets the
current font using the value of fontname
. The method
returns True
if the font exists and could be
selected.
def get_preview_text()
Returns : | a string containing the text in the preview area entry |
The get_preview_text
() method returns a
string containing the text in the preview area entry.
def set_preview_text(text
)
| a string used to set the text in the preview area entry |
The set_preview_text
() method sets the
text in the preview area entry using the string specified by
text
.
def get_apply_button()
Returns : | a gtk.Widget .
|
This method is available in PyGTK 2.14 and above but it will be deprecated in 2.16 don't use this method.
The get_apply_button
() method obtains a button.
The button doesn't have any function.
def get_cancel_button()
Returns : | the gtk.Widget .
used in the dialog for the 'Cancel' button. |
This method is available in PyGTK 2.14 and above.
The get_cancel_button
() method gets the 'Cancel' button.
def get_ok_button()
Returns : | the gtk.Widget .
used in the dialog for the 'OK' button. |
This method is available in PyGTK 2.14 and above.
The get_ok_button
() method gets the 'OK' button.