tkinter.font — Tkinter-Hülle für Schriftarten

Quellcode: Lib/tkinter/font.py

Das Modul tkinter.font stellt die Klasse Font zum Erzeugen und Verwenden benannter Schriftarten bereit.

Die verschiedenen Schriftstärken und Neigungen sind:

tkinter.font.NORMAL
tkinter.font.BOLD
tkinter.font.ITALIC
tkinter.font.ROMAN
class tkinter.font.Font(root=None, font=None, name=None, exists=False, **options)

Die Klasse Font stellt eine benannte Schriftart dar. Font-Instanzen erhalten eindeutige Namen und können über ihre Familie, Größe und Stilkonfiguration angegeben werden. Benannte Schriftarten sind Tks Weg, Schriftarten als einzelnes Objekt zu erzeugen und zu identifizieren, statt eine Schriftart bei jedem Vorkommen über ihre Attribute anzugeben.

Geändert in Version 3.10: Zwei Schriftarten gelten jetzt nur dann als gleich (==), wenn beide Font-Instanzen mit demselben Namen sind und zum selben Tcl-Interpreter gehören.

Argumente:

font - Tupel zur Angabe der Schriftart (family, size, options)
name - eindeutiger Name der Schriftart
exists - wenn wahr, verweist self auf eine bestehende benannte Schriftart

zusätzliche Schlüsselwortoptionen (werden ignoriert, wenn font angegeben ist):

family - Schriftfamilie, zum Beispiel Courier, Times
size - Schriftgröße
Ist size positiv, wird es als Größe in Punkt gedeutet.
Ist size eine negative Zahl, wird ihr Absolutwert
als Größe in Pixel behandelt.
weight - Schriftauszeichnung (NORMAL, BOLD)
slant - ROMAN, ITALIC
underline - Unterstreichung der Schrift (0 - keine, 1 - unterstrichen)
overstrike - Durchstreichung der Schrift (0 - keine, 1 - durchgestrichen)
actual(option=None, displayof=None)

Gibt die tatsächlichen Attribute der Schriftart zurück, die wegen Plattformbeschränkungen von den angeforderten abweichen können. Ohne option wird ein Dictionary aller Attribute zurückgegeben. Ist option angegeben, wird der Wert dieses einzelnen Attributs zurückgegeben. Die Attribute werden auf der Anzeige des displayof-Widgets aufgelöst oder im Hauptfenster der Anwendung, wenn es nicht angegeben ist.

cget(option)

Ruft ein Attribut der Schriftart ab.

configure(**options)

Ändert ein oder mehrere Attribute der Schriftart. Ohne Argumente wird ein Dictionary der aktuellen Attribute zurückgegeben.

config() ist ein Alias für configure().

copy()

Gibt eine eigenständige Kopie der aktuellen Schriftart zurück: eine neue benannte Schriftart mit denselben Attributen, aber einem anderen Namen, die unabhängig vom Original neu konfiguriert werden kann. Umhüllt die aktuelle Schriftart eine Schriftartbeschreibung, ist die Kopie stattdessen eine benannte Schriftart mit deren aufgelösten Attributen.

measure(text, displayof=None)

Gibt zurück, wie viel Platz der Text auf der angegebenen Anzeige einnehmen würde, wenn er in der aktuellen Schriftart formatiert wird, als ganzzahlige Anzahl von Pixeln. Ist keine Anzeige angegeben, wird das Hauptfenster der Anwendung angenommen.

metrics(*options, **kw)

Gibt schriftartspezifische Daten zurück. Ohne Optionen wird ein Dictionary zurückgegeben, das jeden Metriknamen auf seinen ganzzahligen Wert abbildet. Ist ein Optionsname angegeben, wird der Wert dieser Metrik als ganze Zahl zurückgegeben. Zu den Optionen gehören:

ascent - Abstand zwischen der Grundlinie und dem höchsten Punkt, den ein

Zeichen der Schriftart einnehmen kann

descent - Abstand zwischen der Grundlinie und dem tiefsten Punkt, den ein

Zeichen der Schriftart einnehmen kann

linespace - mindestens nötiger senkrechter Abstand zwischen zwei beliebigen

Zeichen der Schriftart, der senkrechte Überlappung zwischen Zeilen ausschließt.

fixed - 1, wenn die Schriftart feste Zeichenbreite hat, sonst 0

tkinter.font.families(root=None, displayof=None)

Gibt ein Tupel mit den Namen der verfügbaren Schriftfamilien zurück.

tkinter.font.names(root=None)

Gibt ein Tupel mit den Namen aller definierten Schriftarten zurück.

tkinter.font.nametofont(name, root=None)

Gibt eine Font-Darstellung der bestehenden benannten Schriftart name zurück. root ist das Widget, dessen Tcl-Interpreter die Schriftart besitzt. Wird es weggelassen, wird das voreingestellte Root-Fenster verwendet.

Geändert in Version 3.10: Der Parameter root wurde hinzugefügt.