tk2fonts: Manipulate Tk fonts

tk2font.getR Documentation

Manipulate Tk fonts

Description

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

Usage

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 synchronise text Tk fonts (text, titles, and fixed-font text) with current settings in .Fonts inside the SciViews:TempEnv environment?

system

Do we synchronise 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.

Author(s)

Philippe Grosjean

See Also

tk2chooseFont()

Examples

## Not run: 
# 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")

## End(Not run)

tcltk2 documentation built on June 8, 2025, 1:04 p.m.