Manipulate Tk fonts

Get or set fonts used by Tk widgets from within R.

tk2font.get(font, what = c("family", "size", "bold", "italic"))

tk2font.set(font, settings)

tk2font.setstyle(text = TRUE, system = FALSE, default.styles = FALSE)

Arguments

font

The name of one or several cached Tk font.

what

A list of font characteristics to get: 'family', 'size', 'bold', italic', 'underline' and/or 'overstrike'. By default, everything except underline' and 'overstrike'.

settings

Settings of fonts. There are two possible forms: (1) a vector of character strings of same length as font with Tk fonts description like -family Times -size 12 -weight bold', for instance, or (2) a list of font characteristics (list with components 'family', 'size', 'bold', 'italic', 'underline' and 'overstrike').

text

Do we synchronize text Tk fonts (text, titles, and fixed-font text) with current settings in .Fonts inside the SciViews:TempEnv environment?

system

Do we synchronize system Tk fonts (widgets, window caption, menus, tooltips, ...) with current system configuration? This is highly platform dependent. Currently, system settings are gathered only under Windows, thanks to the winSystemFonts() function.

default.styles

Do we add .fontsStyleXXX in the SciViews:TempEnv environment, where XXX is one of the four default styles: 'Classic', 'Alternate', 'Presentation' or 'Fancy'.

Value

tk2font.get() retrieves a list with font characteristics (same format as the settings = argument) for the first Tk font found in its font = argument, or "" if the font is not found. tk2font.set() changes current font settings or, possibly, create the Tk font. tk2font.setstyle() changes the current Tk fonts settings according to actual system and/or text configuration fonts.

See also

tk2chooseFont()

Author

Philippe Grosjean

Examples

if (FALSE) { # \dontrun{
# These cannot be run by examples() but should be OK when pasted
# into an interactive R session with the tcltk package loaded
# Refresh both text and system Tk fonts
tk2font.setstyle(system = TRUE, default.styles = TRUE)
# Get characteristics of the default font
tk2font.get("TkDefaultFont")
} # }