tkinter.font — Invólucro de fontes Tkinter

Código-fonte: Lib/tkinter/font.py

---

O módulo tkinter.font apresenta a classe Font para criação e utilização de fontes nomeadas.

Os diferentes pesos e inclinações de fontes são:

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)

The Font class represents a font used by Tk widgets. It either creates a new named font or refers to an existing font. A named font is Tk’s way of identifying a font as a single object that can be referred to by name and reconfigured in place, rather than respecifying its attributes at each use.

With exists false (the default), a new named font is created. Its attributes are taken from the font description font if it is given, overridden by any keyword options. The new font is named name, or a generated unique name if name is omitted.

With exists true, an existing font is referred to instead of being created. If name is given, it is the name of the font, which is reconfigured by font and options if either is given. If name is omitted, the font description font is wrapped as is, without creating a named font, so that it is used without loss of precision by actual(), measure() and metrics(). In this case no keyword options are accepted, and the name attribute is the description itself rather than a string.

The font description font is a tuple of the family name, the size and zero or more styles, or any other form accepted by Tk, such as the name of a named font.

The keyword options are:

family - a família da fonte, por exemplo, Courier, Times

size - tamanho da fonte

Se size for positivo, ele é interpretado como tamanho em pontos.

Caso size seja um número negativo, seu valor absoluto é tratado

como tamanho em pixels.

weight - ênfase da fonte (normal,negrito)

slant - ROMAN, ITALIC

underline - sublinhamento da fonte (0 - sem sublinhamento, 1 - sublinhado)

overstrike - fonte riscada (0 - sem risco, 1 - letras riscadas)

Alterado na versão 3.10: Two fonts now compare equal (==) only when both are Font instances with the same name belonging to the same Tcl interpreter.

Alterado na versão 3.16: A font description can now be wrapped without creating a new named font, and keyword options now override the attributes of the specified font.

actual(option=None, displayof=None)

Retorna os atributos reais do tipo de letra, que podem diferir dos solicitados devido a limitações da plataforma. Sem nenhuma option, retorna um dicionário de todos os atributos; se a option for fornecida, devolve o valor desse atributo individual. Os atributos são resolvidos na exibição do widget displayof ou na janela principal da aplicação se este não for especificado.

cget(option)

Recupera um atributo da fonte.

Nota

cget() and configure() operate on a named font and raise TclError for a wrapped font description. Use actual() to query the attributes of the latter.

configure(**options)

Modifica um ou mais atributos da fonte. Sem argumentos, retorna um dicionário dos atributos atuais.

config() é um apelido de configure().

copy()

Retorna uma cópia distinta da fonte atual: uma nova fonte nomeada com os mesmos atributos, porém com um nome diferente, que pode ser reconfigurada independentemente da original. Se a fonte atual envolver uma descrição de fonte, a cópia será, em vez disso, uma fonte nomeada com seus atributos resolvidos.

measure(text, displayof=None)

Retorna, como um número inteiro de pixels, a quantidade de espaço que o texto ocuparia no dispositivo de exibição especificado, quando formatado com a fonte atual. Se nenhum dispositivo de exibição for especificado, considera-se a janela principal da aplicação.

metrics(*options, **kw)

Retorna dados específicos da fonte. Sem opções, retorna um dicionário que mapeia cada nome de métrica ao seu valor inteiro; se um nome de opção for fornecido, retorna o valor dessa métrica como um número inteiro. As opções incluem:

ascent - distância entre a linha de base e o ponto mais alto que um caractere da fonte pode ocupar

descent - distância entre a linha de base e o ponto mais baixo que um caractere da fonte pode ocupar

linespace - separação vertical mínima necessária entre quaisquer dois caracteres da fonte, que garanta a ausência de sobreposição vertical entre as linhas.

fixed - 1 caso a fonte seja de largura fixa, 0 caso contrário

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

Retorna uma tupla com os nomes das famílias de fontes disponíveis.

tkinter.font.names(root=None)

Retorna uma tupla com os nomes de todas as fontes definidas.

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

Retorna uma representação Font da fonte nomeada name já existente. root é o widget cujo interpretador Tcl detém a fonte; se omitido, utiliza-se a janela raiz padrão.

Alterado na versão 3.10: O parâmetro root foi adicionado.