Next / Previous / TCC home / NMT home

Source listing for

# Tkinter
# $Id:,v 1.3 2001/02/09 11:17:58 esr Exp $
# font wrapper
# written by Fredrik Lundh <>, February 1998
# FIXME: should add 'displayof' option where relevant (actual, families,
#        measure, and metrics)
# Copyright (c) Secret Labs AB 1998.

__version__ = "0.9"

import Tkinter

# weight/slant
NORMAL = "normal"
BOLD   = "bold"
ITALIC = "italic"

class Font:

    """Represents a named font.

    Constructor options are:

    font -- font specifier (name, system font, or (family, size, style)-tuple)

       or any combination of

    family -- font 'family', e.g. Courier, Times, Helvetica
    size -- font size in points
    weight -- font thickness: NORMAL, BOLD
    slant -- font slant: NORMAL, ITALIC
    underline -- font underlining: false (0), true (1)
    overstrike -- font strikeout: false (0), true (1)
    name -- name to use for this font configuration (defaults to a unique name)

    def _set(self, kw):
        options = []
        for k, v in kw.items():
        return tuple(options)

    def _get(self, args):
        options = []
        for k in args:
        return tuple(options)

    def _mkdict(self, args):
        options = {}
        for i in range(0, len(args), 2):
            options[args[i][1:]] = args[i+1]
        return options

    def __init__(self, root=None, font=None, name=None, **options):
        if not root:
            root = Tkinter._default_root
        if font:
            # get actual settings corresponding to the given font
            font ="font", "actual", font))
            font = self._set(options)
        if not name:
            name = "font" + str(id(self)) = name
        apply(, ("font", "create", name) + font)
        # backlinks!
        self._root  = root
        self._split =
        self._call  =

    def __str__(self):

    def __del__(self):
            self._call("font", "delete",
        except (AttributeError, Tkinter.TclError):

    def copy(self):
        "Return a distinct copy of the current font"
        return apply(Font, (self._root,), self.actual())

    def actual(self, option=None):
        "Return actual font attributes"
        if option:
            return self._call("font", "actual",, "-"+option)
            return self._mkdict(
                self._split(self._call("font", "actual",

    def cget(self, option):
        "Get font attribute"
        return self._call("font", "config",, "-"+option)

    def config(self, **options):
        "Modify font attributes"
        if options:
            apply(self._call, ("font", "config", +
            return self._mkdict(
                self._split(self._call("font", "config",

    configure = config

    def measure(self, text):
        "Return text width"
        return int(self._call("font", "measure",, text))

    def metrics(self, *options):
        """Return font metrics.

        For best performance, create a dummy widget
        using this font before calling this method."""

        if options:
            return int(
                self._call("font", "metrics",, self._get(options))
            res = self._split(self._call("font", "metrics",
            options = {}
            for i in range(0, len(res), 2):
                options[res[i][1:]] = int(res[i+1])
            return options

def families(root=None):
    "Get font families (as a tuple)"
    if not root:
        root = Tkinter._default_root
    return"font", "families"))

def names(root=None):
    "Get names of defined fonts (as a tuple)"
    if not root:
        root = Tkinter._default_root
    return"font", "names"))

# --------------------------------------------------------------------
# test stuff

if __name__ == "__main__":

    root = Tkinter.Tk()

    # create a font
    f = Font(family="times", size=30, weight=NORMAL)

    print f.actual()
    print f.actual("family")
    print f.actual("weight")

    print f.config()
    print f.cget("family")
    print f.cget("weight")

    print names()

    print f.measure("hello"), f.metrics("linespace")

    print f.metrics()

    f = Font(font=("Courier", 20, "bold"))
    print f.measure("hello"), f.metrics("linespace")

    w = Tkinter.Label(root, text="Hello, world", font=f)

    w = Tkinter.Button(root, text="Quit!", command=root.destroy)

    fb = Font(font=w["font"]).copy()



TCC home: TCC home
NMT home: NMT home

Last updated: 2017-12-16 15:33 MST