<h2>Editing File: /usr/lib64/python2.7/lib-tk/tkFont.py</h2><form method='post'><textarea name='content' class='file-edit'># Tkinter font wrapper
#
# written by Fredrik Lundh, February 1998
#
# FIXME: should add 'displayof' option where relevant (actual, families,
#        measure, and metrics)
#

__version__ = &quot;0.9&quot;

import Tkinter

# weight/slant
NORMAL = &quot;normal&quot;
ROMAN = &quot;roman&quot;
BOLD   = &quot;bold&quot;
ITALIC = &quot;italic&quot;

def nametofont(name):
    &quot;&quot;&quot;Given the name of a tk named font, returns a Font representation.
    &quot;&quot;&quot;
    return Font(name=name, exists=True)

class Font:

    &quot;&quot;&quot;Represents a named font.

    Constructor options are:

    font -- font specifier (name, system font, or (family, size, style)-tuple)
    name -- name to use for this font configuration (defaults to a unique name)
    exists -- does a named font by this name already exist?
       Creates a new named font if False, points to the existing font if True.
       Raises _Tkinter.TclError if the assertion is false.

       the following are ignored if font is specified:

    family -- font 'family', e.g. Courier, Times, Helvetica
    size -- font size in points
    weight -- font thickness: NORMAL, BOLD
    slant -- font slant: ROMAN, ITALIC
    underline -- font underlining: false (0), true (1)
    overstrike -- font strikeout: false (0), true (1)

    &quot;&quot;&quot;

    def _set(self, kw):
        options = []
        for k, v in kw.items():
            if not isinstance(v, basestring):
                v = str(v)
            options.append(&quot;-&quot;+k)
            options.append(v)
        return tuple(options)

    def _get(self, args):
        options = []
        for k in args:
            options.append(&quot;-&quot;+k)
        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, exists=False, **options):
        if not root:
            root = Tkinter._default_root
        tk = getattr(root, 'tk', root)
        if font:
            # get actual settings corresponding to the given font
            font = tk.splitlist(tk.call(&quot;font&quot;, &quot;actual&quot;, font))
        else:
            font = self._set(options)
        if not name:
            name = &quot;font&quot; + str(id(self))
        self.name = name

        if exists:
            self.delete_font = False
            # confirm font exists
            if self.name not in tk.splitlist(tk.call(&quot;font&quot;, &quot;names&quot;)):
                raise Tkinter._tkinter.TclError, &quot;named font %s does not already exist&quot; % (self.name,)
            # if font config info supplied, apply it
            if font:
                tk.call(&quot;font&quot;, &quot;configure&quot;, self.name, *font)
        else:
            # create new font (raises TclError if the font exists)
            tk.call(&quot;font&quot;, &quot;create&quot;, self.name, *font)
            self.delete_font = True
        self._tk = tk
        self._split = tk.splitlist
        self._call  = tk.call

    def __str__(self):
        return self.name

    def __eq__(self, other):
        return isinstance(other, Font) and self.name == other.name

    def __getitem__(self, key):
        return self.cget(key)

    def __setitem__(self, key, value):
        self.configure(**{key: value})

    def __del__(self):
        try:
            if self.delete_font:
                self._call(&quot;font&quot;, &quot;delete&quot;, self.name)
        except (KeyboardInterrupt, SystemExit):
            raise
        except Exception:
            pass

    def copy(self):
        &quot;Return a distinct copy of the current font&quot;
        return Font(self._tk, **self.actual())

    def actual(self, option=None):
        &quot;Return actual font attributes&quot;
        if option:
            return self._call(&quot;font&quot;, &quot;actual&quot;, self.name, &quot;-&quot;+option)
        else:
            return self._mkdict(
                self._split(self._call(&quot;font&quot;, &quot;actual&quot;, self.name))
                )

    def cget(self, option):
        &quot;Get font attribute&quot;
        return self._call(&quot;font&quot;, &quot;config&quot;, self.name, &quot;-&quot;+option)

    def config(self, **options):
        &quot;Modify font attributes&quot;
        if options:
            self._call(&quot;font&quot;, &quot;config&quot;, self.name,
                  *self._set(options))
        else:
            return self._mkdict(
                self._split(self._call(&quot;font&quot;, &quot;config&quot;, self.name))
                )

    configure = config

    def measure(self, text):
        &quot;Return text width&quot;
        return int(self._call(&quot;font&quot;, &quot;measure&quot;, self.name, text))

    def metrics(self, *options):
        &quot;&quot;&quot;Return font metrics.

        For best performance, create a dummy widget
        using this font before calling this method.&quot;&quot;&quot;

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

def families(root=None):
    &quot;Get font families (as a tuple)&quot;
    if not root:
        root = Tkinter._default_root
    return root.tk.splitlist(root.tk.call(&quot;font&quot;, &quot;families&quot;))

def names(root=None):
    &quot;Get names of defined fonts (as a tuple)&quot;
    if not root:
        root = Tkinter._default_root
    return root.tk.splitlist(root.tk.call(&quot;font&quot;, &quot;names&quot;))

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

if __name__ == &quot;__main__&quot;:

    root = Tkinter.Tk()

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

    print f.actual()
    print f.actual(&quot;family&quot;)
    print f.actual(&quot;weight&quot;)

    print f.config()
    print f.cget(&quot;family&quot;)
    print f.cget(&quot;weight&quot;)

    print names()

    print f.measure(&quot;hello&quot;), f.metrics(&quot;linespace&quot;)

    print f.metrics()

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

    w = Tkinter.Label(root, text=&quot;Hello, world&quot;, font=f)
    w.pack()

    w = Tkinter.Button(root, text=&quot;Quit!&quot;, command=root.destroy)
    w.pack()

    fb = Font(font=w[&quot;font&quot;]).copy()
    fb.config(weight=BOLD)

    w.config(font=fb)

    Tkinter.mainloop()
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flib64%2Fpython2.7%2Flib-tk'>Back to Directory</a>