25.1. : mod: tkinter — Interface Python para Tcl / Tk

Código Fonte: Lib/tkinter/__init__.py

---

O pacote: mod: tkinter (” Tk interface “) é a interface padrão do Python para o kit de ferramentas Tk GUI. Ambos Tk e: mod: tkinter estão disponíveis na maioria das plataformas Unix, assim como em sistemas Windows. (O próprio Tk não faz parte do Python; ele é mantido no ActiveState.)

Rodar `` python -m tkinter`` da linha de comando deve abrir uma janela demonstrando uma interface Tk simples, informando que: mod: tkinter está apropriadamente instalado em seu sistema, e também mostrando qual versão do Tcl / Tk é instalado, para que você possa ler a documentação do Tcl / Tk específica para essa versão.

Ver também

Documentação do Tkinter:

Recursos do Python Tkinter <https://wiki.python.org/moin/TkInter> _

O Python Tkinter Topic Guide fornece uma grande quantidade de informações sobre como usar o Tk do Python e links para outras fontes de informação no Tk.

TKDocs <http://www.tkdocs.com/> _

Tutorial extenso e páginas de widgets mais amigáveis para alguns dos widgets.

Referência Tkinter 8.5: uma GUI para Python <https://web.archive.org/web/20190524140835/https://infohost.nmt.edu/tcc/help/pubs/tkinter/web/index.html> _

Material de referência on-line.

Tkinter docs from effbot <http://effbot.org/tkinterbook/> _

Referência online para o tkinter suportado pelo effbot.org.

Programação Python <http://learning-python.com/about-pp4e.html> _

Livro de Mark Lutz, tem excelente cobertura da Tkinter.

Tkinter moderno para desenvolvedores Python ocupados <https://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/> _

Livro de Mark Roseman sobre a construção de interfaces gráficas de usuário atraentes e modernas com Python e Tkinter.

Programação Python e Tkinter <https://www.manning.com/books/python-and-tkinter-programming> _

Livro de John Grayson (ISBN 1-884777-81-3).

Documentação Tcl / Tk:

Comandos Tk <https://www.tcl.tk/man/tcl8.6/TkCmd/contents.htm> _

A maioria dos comandos estão disponíveis como classes: mod: tkinter ou: mod:` tkinter.ttk`. Altere ‘8.6’ para corresponder à versão de sua instalação Tcl / Tk.

Páginas de manual recentes do Tcl / Tk <https://www.tcl.tk/doc/> _

Manuais Tcl / Tk recentes em www.tcl.tk.

ActiveState Tcl Home Page

O desenvolvimento do Tk/Tcl acontece em larga medida em ActiveState.

Tcl and the Tk Toolkit

Livro de John Ousterhout, o inventor do Tcl.

Practical Programming in Tcl and Tk

Livro enciclopédico de Brent Welch.

25.1.1. Módulos Tkinter

Na maioria das vezes, tkinter é tudo o que você precisa, mas há outros módulos adicionais disponíveis. A interface do Tk está localizada em um módulo binário chamado _tkinter. Este módulo contém a interface de baixo nível do Tk, e nunca deve ser utilizada diretamente por aplicativos de programadores. Geralmente é uma biblioteca compartilhada (ou DLL), mas pode estar em alguns casos conectada estaticamente ao interpretador do Python.

Além do módulo de interface do Tk, tkinter inclui vários módulos do Python, tkinter.constants sendo o mais importante. Importar tkinter  irá importar tkinter.constants automaticamente, então, geralmente, para utilizar o Tkinter tudo o que você ´recisa é de uma simples instrução de importação:

import tkinter

Ou, com mais frequência:

from tkinter import *

class tkinter.Tk(screenName=None, baseName=None, className='Tk', useTk=1)

A classe Tk é instanciada sem argumentos. Isto cria um widget de alto nível de Tk que normalmente é a janela principal da aplicação. Cada instância possui seu próprio interpretador Tcl associado.

tkinter.Tcl(screenName=None, baseName=None, className='Tk', useTk=0)

A função Tcl() é uma função fábrica que cria um objeto assim como o criado pela classe Tk, exceto por não inicializar o subssistema Tk. Isto é útil quando executando o interpretador Tcl em um ambiente onde não se quer criar janelas de alto nível externas, ou quando não se pode (como em sistemas Unix/Linux sem um servidor X). Um objeto criado pelo objeto Tcl() pode ter uma janela de Alto nível criada (e o subssistema Tk inicializado) chamando o método loadtk().

Outros módulos que fornecem suporte Tk incluem:

tkinter.scrolledtext

Widget de texto com uma barra de rolagem vertical integrada.

tkinter.colorchooser

Caixa de diálogo para permitir que o usuário escolha uma cor.

tkinter.commondialog

Classe base para os diálogos definidos nos outros módulos listados aqui.

tkinter.filedialog

Diálogos comuns para permitir ao usuário especificar um arquivo para abrir ou salvar.

tkinter.font

Utilitários para ajudar a trabalhar com fontes.

tkinter.messagebox

Acesso às caixas de diálogo padrão do Tk.

tkinter.simpledialog

Diálogos básicos e funções de conveniência.

tkinter.dnd

Suporte de arrastar e soltar para: mod: tkinter. Isso é experimental e deve se tornar obsoleto quando for substituído pelo Tk DND.

turtle

Gráficos de tartaruga em uma janela Tk.

25.1.2. Preservador de vida Tkinter

Esta seção não foi projetada para ser um tutorial completo sobre Tk ou Tkinter. Em vez disso, pretende ser um obstáculo, fornecendo alguma orientação introdutória sobre o sistema.

Créditos:

• Tk foi escrito por John Ousterhout enquanto estava em Berkeley.

• Tkinter foi escrito por Steen Lumholt e Guido van Rossum.

• This Life Preserver foi escrito por Matt Conway, da Universidade de Virgínia.

• A renderização do HTML, com algumas edições livres, foram produzidas de uma versão do FrameMaker por Ken Manheimer.

• Fredrik Lundh elaborou e revisou as descrições de interface de classe, para que elas fiquem atuais com Tk 4.2

• Mike Clarkson converteu a documentação para LaTeX e compilou o capítulo de Interface de Usuário para o manual de referência.

25.1.2.1. Como usar esta seção

Esta seção foi feita em duas partes: a primeira parte (mais ou menos) cobre os materiais fundamentais, enquanto a segunda parte pode ser levada para o teclado como uma referência útil.

Ao tentar responder perguntas do tipo “como eu faço x”, é melhor pensar como eu faço “x” direto no Tk, e então converter de volta para uma chamada correspondente do tkinter. Programadores Python normalmente adivinham os comandos corretos em Python apenas olhando a documentação do Tk. Isso significa que para usar Tkinter, você deverá aprender um pouco sobre Tk. Este documento não pode preencher esse papel, então o melhor que podemos fazer é indicar as melhores documentações que existem. Aqui vão algumas dicas:

• Os autores sugerem fortemente que se consiga uma cópia das páginas man do Tk. Especificamente, as páginas man no diretório manN são as mais úteis. As páginas man man3 descrevem a interface C com a biblioteca Tk e, portanto, não são tão úteis para criadores de script.

• Addison-Wesley publica um livro chamado Tcl and the Tk Toolkit de John Ousterhout (ISBN 0-201-63337-X), que é uma boa introdução a Tcl e Tk para o iniciante. O livro não é exaustivo e, para muitos detalhes, ele recorre às páginas de manual.

• tkinter/__init__.py é o último recurso para a maioria, mas pode ser um bom lugar para ir quando nada mais faz sentido.

25.1.2.2. Um simples programa Olá Mundo

import tkinter as tk

class Application(tk.Frame):
    def __init__(self, master=None):
        super().__init__(master)
        self.master = master
        self.pack()
        self.create_widgets()

    def create_widgets(self):
        self.hi_there = tk.Button(self)
        self.hi_there["text"] = "Hello World\n(click me)"
        self.hi_there["command"] = self.say_hi
        self.hi_there.pack(side="top")

        self.quit = tk.Button(self, text="QUIT", fg="red",
                              command=self.master.destroy)
        self.quit.pack(side="bottom")

    def say_hi(self):
        print("hi there, everyone!")

root = tk.Tk()
app = Application(master=root)
app.mainloop()

25.1.3. Uma olhada (muito) rápida em Tcl / Tk

A hierarquia de classe parece complicada, mas na prática, programadores de aplicação quase sempre se referem às classes nos níveis mais baixos da hierarquia.

Notas:

• Essas classes são fornecidas com o objetivo de organizar certas funções em um espaço de nomes. Elas não devem ser instanciadas de forma independente.

• A classe Tk deve ser instanciada apenas uma vez em uma aplicação. Os programadores de aplicação não precisam instanciar uma explicitamente, o sistema cria uma sempre que qualquer uma das outras classes é instanciada.

• A classe Widget não foi feita para ser instanciada, é apenas para quando subclasses forem criadas para fazer widgets “reais” (em C++, isto é chamado de classe abstrata).

Para fazer uso deste material de referência, haverá vezes em que você precisará saber como ler pequenas passagens de Tk e como identificar as várias partes dos comandos Tk. (Veja a seção Mapeamento de TK Básico para Tkinter para equivalentes de tkinter do que está mostrado abaixo.)

Scripts Tk são programas Tcl. Como todos os programas Tcl, scripts Tk são apenas listas de elementos sintáticos (tokens) separados por espaços. Um widget Tk é apenas sua classe, as opções que ajudam a configurá-los, e as ações que permitem fazer coisas úteis.

Para fazer um widget em Tk, o comando é sempre da forma:

classCommand newPathname options

classCommand

denota que tipo de widget fazer (um botão, um rótulo, um menu …)

newPathname

É o novo nome para este widget. Todos os nomes em Tk devem ser únicos. Para ajudar a import isto, os widgets em Tk são renomeados com parêntesis, assim como arquivos em um sistema de arquivos. O widget de nível mais alto, a raiz, é chamado de . (ponto) e os filhos são delimitados por demais pontos. Por exemplo, .myApp.controlPanel.okButton pode ser o nome de um widget.

options

configura a aparência do widget e, em alguns casos, seu comportamento. As opções aparecem na forma de listas de flags ou valores. Flags são precedidas por um ‘-‘, como flags em comandos de console em Unix, e os valores são colocados entre aspas se consistirem em mais de uma palavra.

Por exemplo:

button   .fred   -fg red -text "hi there"
   ^       ^     \______________________/
   |       |                |
 class    new            options
command  widget  (-opt val -opt val ...)

Uma vez criado, o nome do path do widget se torna um novo comando. Este novo comando widget é o manipulador do programador para fazer o novo widget executar alguma ação. Em C, você expressaria isso como algumaAção(fred, algumasOpções), em C++, você expressaria isso como fred.algumaAção(algumasOpções), e em Tk, você usaria:

.fred someAction someOptions

Observe que o nome do objeto, .fred, começa com um ponto.

Como você deve esperar, os valores legais de algumaAção vão depender da classe do widget: .fred disable funciona se fred é um botão (fred fica cinza), mas não funciona se fred é uma etiqueta (desativar etiquetas não é suportado por Tk).

Os valores legais para algumaOpção é dependente de ação. Algumas ações, como disable, requerem nenhum argumento, outras, como o comando delete de uma caixa de entrada de texto, precisaria de argumentos para especificar o intervalo do texto para apagar.

25.1.4. Mapeamento de TK Básico para Tkinter

Comandos de classe em Tk correspondem à construtores de classe em Tkinter.

button .fred                =====>  fred = Button()

O mestre de um objeto está implícito no novo nome dado a ele no momento da criação. No Tkinter, os masters são especificados explicitamente.

button .panel.fred          =====>  fred = Button(panel)

As opções de configurações em Tk são dadas como listas de etiquetas com hífen seguidas por valores. Em Tkinter, as opções são especificadas como argumentos de palavra reservada na instância do construtor, e args de palavras reservadas para configurar chamadas, ou como índices de instâncias, na forma de dicionários, para estabelecer instâncias. Veja a seção See section Opções de configuração sobre opções de definições.

button .fred -fg red        =====>  fred = Button(panel, fg="red")
.fred configure -fg red     =====>  fred["fg"] = red
                            OR ==>  fred.config(fg="red")

Em Tk, para executar uma ação em um widget, utilize o nome do widget como comando, seguido pelo nome de uma ação, possivelmente com argumentos (opções). Em Tkinter, você chama métodos na instância da classe para invocar ações no widget. As ações (métodos) que um determindo widget pode executar estão listadas em tkinter/__init__.py.

.fred invoke                =====>  fred.invoke()

Para dar o widget ao empacotador (gerenciador de geometria), você chama pack com argumentos opcionais. Em Tkinter, a classe Pack detém toda esta funcionalidade, e as várias formas do comando pack estão implementadas como métodos. Todos os widgets em tkinter são subclasses de Packer, e portanto herdam todos os métodos de empacotamento. Veja a documentação do módulo tkinter.tix para informações adicionais sobre o gerenciador de geometria.

pack .fred -side left       =====>  fred.pack(side="left")

25.1.5. Como Tk e Tkinter estão relacionados

De cima para baixo:

Sua aplicação aqui (Python)

Ums aplicação Python faz uma chamada tkinter.

tkinter (pacote Python)

Esta chamada (por exemplo, criando um widget de botão), é implementada no pacote tkinter, que é escrito em Python. Esta função Python irá analisar os comandos e os argumentos e convertê-los em uma forma que faça parecer que vieram de um script Tk em vez de um script Python.

_tkinter (C)

Esses comandos e seus argumentos serão passados para uma função C no módulo de extensão _tkinter - note o sublinhado.

Widgets Tk (C e Tcl)

Esta função C é capaz de fazer chamadas para outros módulos C, incluindo as funções C que compõem a biblioteca Tk. Tk é implementado em C e algum Tcl. A parte Tcl dos widgets Tk é usada para vincular certos comportamentos padrão aos widgets e é executada uma vez no ponto onde o pacote Python tkinter é importado. (O usuário nunca vê este estágio).

Tk (C)

A parte Tk dos Widgets Tk implementa o mapeamento final para …

Xlib (C)

a biblioteca Xlib para desenhar gráficos na tela.

25.1.6. Referência útil

25.1.6.1. Opções de configuração

As opções controlam coisas como a cor e a largura da borda de um widget. As opções podem ser definidas de três maneiras:

No momento da criação do objeto, usando argumentos nomeados

fred = Button(self, fg="red", bg="blue")

Após a criação do objeto, tratando o nome da opção como um índice de dicionário

fred["fg"] = "red"
fred["bg"] = "blue"

Use o método config() para atualizar vários attrs posteriores à criação do objeto

fred.config(fg="red", bg="blue")

Para uma explicação completa de uma dada opção e seu comportamento, veja as páginas man do Tk para o widget em questão.

Note que as páginas man listam “OPÇÕES PADRÃO” e “OPÇÕES DE WIDGET ESPECÍFICO” para cada widget. A primeira é uma lista de opções que são comuns a vários widgets, e a segunda são opções que são idiossincráticas ao widget em particular. As Opções Padrão estão documentadas na página man options(3).

Nenhuma distinção entre as opções padrão e específicas de widget são feitas neste documento. Algumas opções não se aplicam a alguns tipos de widgets. A resposta de um dado widget a uma opção particular depende da classe do widget; botões possuem a opção command, etiquetas não.

As opções suportadas por um dado widget estão listadas na página man daquele widget, ou podem ser consultadas no tempo de execução chamando o método config() sem argumentos, ou chamando o método keys() daquele widget. O valor retornado por essas chamadas é um dicionário cujas chaves são os nomes das opções como uma string (por exemplo, 'relief') e cujos valores são tuplas de 5 elementos.

Algumas opções, como bg são sinônimos para opções comuns com nomes mais longos (bg é a abreviação de “background”, ou plano de fundo em inglês). Passando o nome de uma opção abreviada ao método config() irá retornar uma tupla de 2 elementos, e não uma tupla de 5 elementos. A tupla de 2 elementos devolvida irá conter o nome do sinônimo e a opção “verdadeira” (como por exemplo em ('bg', 'background')).

Index	Significado	Exemplo
0	nome da opção	'relief'
1	nome da opção para buscas de banco de dados	'relief'
2	classe de opção para busca de banco de dados	'Relief'
3	valor padrão	'raised'
4	valor atual	'groove'

Exemplo:

>>> print(fred.config())
{'relief': ('relief', 'relief', 'Relief', 'raised', 'groove')}

É claro que o dicionário exibido irá incluir todas as opções disponíveis e seus valores. Isso foi apenas um exemplo.

25.1.6.2. O Empacotador

The packer is one of Tk’s geometry-management mechanisms. Geometry managers are used to specify the relative positioning of the positioning of widgets within their container - their mutual master. In contrast to the more cumbersome placer (which is used less commonly, and we do not cover here), the packer takes qualitative relationship specification - above, to the left of, filling, etc - and works everything out to determine the exact placement coordinates for you.

O tamanho de qualquer widget mestre é determinado pelo tamanho dos “widgets escravos” internos. O empacotador é usado para controlar onde os widgets escravos aparecem dentro do mestre no qual são empacotados. Você pode empacotar widgets em quadros e quadros em outros quadros, a fim de obter o tipo de layout que deseja. Além disso, o arranjo é ajustado dinamicamente para acomodar alterações incrementais na configuração, uma vez que é empacotado.

Note que os widgets não aparecem até que eles tenham sua geometria especificada pelo gerenciador de geometria. É um erro comum de iniciantes deixar a geometria de fora da especificação, então se surpreender que o widget é criado sendo que nada apareceu. O widget irá aparecer apenas quando tiver, por exemplo, o método método pack() do empacotador aplicado a ele.

O método pack() pode ser chamado com pares de palavra reservada-opção/valor que controlam onde o widget deverá aparecer dentro do seu contêiner, e como deverá se comportar quando a janela da aplicação principal for redimensionada. Aqui estão alguns exemplos:

fred.pack()                     # defaults to side = "top"
fred.pack(side="left")
fred.pack(expand=1)

25.1.6.3. Opções do Empacotador

Para uma informação mais completa do empacotador e as opções que pode receber, veja as páginas man e a página 183 do livro do John Ousterhout.

âncora

Tipo âncora. Denota onde o packer deverá posicionar cada ajudante em seu pacote.

expandir

Booleano, 0 ou 1.

preencher

Valores legais: 'x', 'y', 'both', 'none'.

ipadx e ipady

Uma distância - designando o deslocamento interno de cada lado do widget ajudante.

padx and pady

Uma distância - designando o deslocamento externo de cada lado do widget ajudante.

side

Valores legais são: 'left', 'right', 'top', 'bottom'.

25.1.6.4. Acoplando Variáveis de Widgets

A definição do valor atual de alguns widgets (como widgets de entrada de texto) podem ser conectadas diretamente às variáveis da aplicação utilizando métodos especiais. Estas opções são variable, textvariable, onvalue, offvalue, e value. A conexão funciona por ambos os lados: Se por algum motivo a variável se altera, o widget ao qual ela está conectada irá se atualizar para refletir este novo valor.

Infelizmente, na atual implementação do tkinter não é possível passar uma variável Python arbitrária para um widget por uma opção variable ou textvariable. Os únicos tipos de variáveis para as quais isso funciona são variáveis que são subclasses da classe chamada Variable, definida em tkinter.

Há muitas subclasses de Variable úteis já definidas: StringVar, IntVar, DoubleVar, e BooleanVar. Para ler o atual valor de uma variável, chame o método get() nelas, e para alterar o valor você deve chamar o método set(). Se você seguir este protocolo, o widget irá sempre acompanhar os valores da variável, sem nenhuma intervenção da sua parte.

Por exemplo:

class App(Frame):
    def __init__(self, master=None):
        super().__init__(master)
        self.pack()

        self.entrythingy = Entry()
        self.entrythingy.pack()

        # here is the application variable
        self.contents = StringVar()
        # set it to some value
        self.contents.set("this is a variable")
        # tell the entry widget to watch this variable
        self.entrythingy["textvariable"] = self.contents

        # and here we get a callback when the user hits return.
        # we will have the program print out the value of the
        # application variable when the user hits return
        self.entrythingy.bind('<Key-Return>',
                              self.print_contents)

    def print_contents(self, event):
        print("hi. contents of entry is now ---->",
              self.contents.get())

25.1.6.5. O Gerenciador de Janela

No Tk, existe um comando utilitário, wm, para interagir com o gerenciador de janelas. As opções do comando wm permitem que você controle coisas como títulos, localização, ícones bitmap, entre outros. No tkinter, estes comandos foram implementados como métodos da classe Wm class. Widgets de mais alto nívelsão subclasses da classe Wm e portanto podem chamar os métodos Wm diretamente.

Para chegar à janela de nível superior que contém um determinado widget, geralmente você pode apenas consultar o mestre do widget. Claro, se o widget foi compactado dentro de um quadro, o mestre não representará uma janela de nível superior. Para chegar à janela de nível superior que contém um widget arbitrário, você pode chamar o método _root(). Este método começa com um sublinhado para denotar o fato de que esta função é parte da implementação, e não uma interface para a funcionalidade Tk.

Aqui estão alguns exemplos de uso típico:

import tkinter as tk

class App(tk.Frame):
    def __init__(self, master=None):
        super().__init__(master)
        self.pack()

# create the application
myapp = App()

#
# here are method calls to the window manager class
#
myapp.master.title("My Do-Nothing Application")
myapp.master.maxsize(1000, 400)

# start the program
myapp.mainloop()

25.1.6.6. Opções de Tipos de Dados do Tk

âncora

Valores legais são os pontos cardeais: "n", "ne", "e", "se", "s", "sw", "w", "nw", e também "center".

bitmap

Há 8 bitmaps embutidos nomeados: 'error', 'gray25', 'gray50', 'hourglass', 'info', 'questhead', 'question', 'warning'. Para especificar um nome de arquivo do bitmap X, passe o caminho completo do arquivo, precedido pelo caractere @, como em "@/usr/contrib/bitmap/gumby.bit".

booleano

Você pode passar os inteiros 0 ou 1 ou as strings "yes" ou "no".

callback

Esta é uma função Python que não aceita argumentos. Por exemplo:

def print_it():
    print("hi there")
fred["command"] = print_it

cor

As cores podem ser fornecidas como nomes de cores X no arquivo rgb.txt ou como strings que representam valores RGB nos intervalos 4 bits: "#RGB", 8 bits: "#RRGGBB", 12 bits:"#RRRGGGBBB" ou 16 bits: "#RRRRGGGGBBBB" onde R, G, B aqui representam qualquer dígito hexadecimal legal. Consulte a página 160 do livro de Ousterhout para detalhes.

cursor

Os nomes de cursor X padrão de cursorfont.h podem ser usados, sem o prefixo XC_. Por exemplo, para obter um cursor de mão (XC_hand2), use a string "hand2". Você também pode especificar um bitmap e um arquivo de máscara de sua preferência. Veja a página 179 do livro de Ousterhout.

distance

As distâncias da tela podem ser especificadas em pixels ou distâncias absolutas. Pixels são dados como números e distâncias absolutas como strings, com os caracteres finais denotando unidades: c para centímetros, i para polegadas, m para milímetros, p para os pontos da impressora. Por exemplo, 3,5 polegadas é expresso como "3.5i".

font

Tk usa um formato de nome de fonte de lista, como {courier 10 bold}. Tamanhos de fonte com números positivos são medidos em pontos; tamanhos com números negativos são medidos em pixels.

geometria

Esta é uma string no formato widthxheight, onde largura e altura são medidas em pixels para a maioria dos widgets (em caracteres para widgets que exibem texto). Por exemplo: fred["geometry"] = "200x100".

justify

Valores aceitos são as strings: "left", "center", "right" e "fill".

region

Esta é uma string com quatro elementos delimitados por espaço, cada um dos quais a uma distância legal (veja acima). Por exemplo: "2 3 4 5" e "3i 2i 4.5i 2i" e "3c 2c 4c 10.43c" são todas regiões legais.

relief

Determina qual será o estilo da borda de um widget. Os valores legais são: "raised", "sunken", "flat", "groove" e "ridge".

scrollcommand

Este é quase sempre o método set() de algum widget da barra de rolagem, mas pode ser qualquer método de widget que receba um único argumento.

wrap:

Deve ser um de: "none", "char" ou "word".

25.1.6.7. Ligações e Eventos

O método de ligação do comando widget permite que você observe certos eventos e tenha um acionamento de função de retorno de chamada quando esse tipo de evento ocorrer. A forma do método de ligação é:

def bind(self, sequence, func, add=''):

sendo que:

sequence (sequência)

é uma string que denota o tipo de evento de destino. (Consulte a página man do bind e a página 201 do livro de John Ousterhout para obter detalhes).

func

é uma função Python, tendo um argumento, a ser invocada quando o evento ocorre. Uma instância de evento será passada como argumento. (As funções implantadas dessa forma são comumente conhecidas como funções de retorno.)

add

é opcional, tanto '' ou '+'. Passar uma string vazia indica que essa ligação substitui todas as outras ligações às quais esse evento está associado. Passar um '+' significa que esta função deve ser adicionada à lista de funções ligadas a este tipo de evento.

Por exemplo:

def turn_red(self, event):
    event.widget["activeforeground"] = "red"

self.button.bind("<Enter>", self.turn_red)

Observe como o campo widget do evento está sendo acessado na função de retorno turn_red(). Este campo contém o widget que capturou o evento X. A tabela a seguir lista os outros campos de evento que você pode acessar e como eles são denotados no Tk, o que pode ser útil ao se referir às páginas man do Tk.

Tk	Campo de Eventos do Tkinter	Tk	Campo de Eventos do Tkinter
%f	focus	%A	char
%h	height	%E	send_event
%k	keycode	%K	keysym
%s	state	%N	keysym_num
%t	time	%T	type
%w	width	%W	widget
%x	x	%X	x_root
%y	y	%Y	y_root

25.1.6.8. O Parâmetro index

Vários widgets requerem que parâmetros de “indx” sejam passados. Eles são usados para apontar para um local específico em um widget Text, ou para caracteres específicos em um widget Entry, ou para itens de menu específicos em um widget Menu.

Entry widget indexes (index, view index, etc.)

Entry widgets have options that refer to character positions in the text being displayed. You can use these tkinter functions to access these special points in text widgets:

Text widget indexes

The index notation for Text widgets is very rich and is best described in the Tk man pages.

Menu indexes (menu.invoke(), menu.entryconfig(), etc.)

Algumas opções e métodos de menus manipulam entradas de menu específicas. Sempre que um índice de menu é necessário para uma opção ou parâmetro, você pode passar:

• um número inteiro que se refere à posição numérica da entrada no widget, contada do topo, começando com 0;

• a string "active", que se refere à posição do menu que está atualmente sob o cursor;

• a string "last" que se refere ao último item do menu;

• Um inteiro precedido por @, como em @6, onde o inteiro é interpretado como uma coordenada de pixel y no sistema de coordenadas do menu;

• a string "none", que indica nenhuma entrada de menu, mais frequentemente usada com menu.activate() para desativar todas as entradas e, finalmente,

• uma string de texto cujo padrão corresponde ao rótulo da entrada do menu, conforme varrido da parte superior do menu para a parte inferior. Observe que este tipo de índice é considerado após todos os outros, o que significa que as correspondências para itens de menu rotulados como last, active ou none podem ser interpretadas como os literais acima, em vez disso.

25.1.6.9. Imagens

Imagens de diferentes formatos podem ser criadas por meio da subclasse correspondente de tkinter.Image:

• BitmapImage para imagens no formato XBM.

• PhotoImage para imagens nos formatos PGM, PPM, GIF e PNG. O suporte ao último foi adicionado a partir do Tk 8.6.

Qualquer tipo de imagem é criado através da opção file ou data (outras opções também estão disponíveis).

O objeto imagem pode então ser usado sempre que uma opção image há suporte em algum widget (por exemplo: rótulos, botões, menus). Nestes casos, o Tk não guardará uma referência à imagem. Quando a última referência Python ao objeto imagem for excluída, os dados da imagem também serão excluídos e o Tk exibirá uma caixa vazia onde quer que a imagem tenha sido usada.

Ver também

O pacote Pillow adiciona suporte para formatos como BMP, JPEG, TIFF e WebP, dentre outros.

25.1.7. Tratadores de arquivos

O Tk permite que você registre e cancele o registro de uma função de retorno que será chamada a partir do laço central do Tk quando uma E/S for possível em um descritor de arquivo. Apenas um tratador pode ser registrado por descritor de arquivo. Código de exemplo:

import tkinter
widget = tkinter.Tk()
mask = tkinter.READABLE | tkinter.WRITABLE
widget.tk.createfilehandler(file, mask, callback)
...
widget.tk.deletefilehandler(file)

Este recurso não está disponível no Windows.

Já que você não sabe quantos bytes estão disponíveis para leitura, você pode não querer usar os métodos read() ou readline() de BufferedIOBase ou TextIOBase, já que eles insistirão em ler uma quantidade predefinida de byts. Para sockets, os métodos recv() ou recvfrom() vão servir; para outros arquivos, use dados brutos ou os.read(file.fileno(), maxbytecount).

Widget.tk.createfilehandler(file, mask, func)

Registra a função de retorno do tratador de arquivo func. O argumento file pode ser um objeto com um método fileno() (como um arquivo ou objeto soquete) ou um descritor de arquivo de inteiro. O argumento mask é uma combinação OR de qualquer uma das três constantes abaixo. O retorno de chamada é chamado da seguinte maneira:

callback(file, mask)

Widget.tk.deletefilehandler(file)

Cancela o registro de um tratador de arquivo.

tkinter.READABLE

tkinter.WRITABLE

tkinter.EXCEPTION

Constantes usadas nos argumentos mask.