Tkinter LabelFrame: Um guia prático e amigável

1 O que é um LabelFrame?

LabelFrame é um widget de contêiner no Tkinter que desenha uma borda e um título em torno de um grupo de controles relacionados. É a maneira padrão de organizar seções — pense nele como um cartão rotulado que reúne configurações relacionadas.

Você o verá em diálogos de configurações, painéis de preferências e telas de entrada de dados. Ele agrupa widgets visualmente e semanticamente, para que os usuários vejam o que combina e o que não combina.

Objetivo: construir uma janela de configurações limpa usando LabelFrame para conter Informações Pessoais, Preferências do Aplicativo e Configurações de Notificação.

2 Pré-requisitos

LabelFrame faz parte do módulo ttk do Tkinter, incluído com o Python. Você só precisa do Python 3.7+ e da biblioteca padrão — nenhum pacote extra.

Confirme sua versão:

python --version

3 Criar a Janela do Aplicativo

Comece criando uma subclasse de Tk para construir uma janela de configurações mínima. Isso lhe dá um ponto de entrada organizado para componentes posteriores.

import tkinter as tk
from tkinter import ttk

class SettingsApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("Configurações do Aplicativo (Demo LabelFrame)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

        # Contêiner principal com preenchimento
        main_container = ttk.Frame(self, padding="20")
        main_container.pack(fill=tk.BOTH, expand=True)

if __name__ == "__main__":
    app = SettingsApp()
    app.mainloop()

4 Primeiro LabelFrame: Informações Pessoais

Crie um LabelFrame para “Informações Pessoais” e, em seguida, adicione dois campos rotulados. Configure a grade para que os campos de entrada se expandam horizontalmente.

    def create_personal_info_frame(self, parent: ttk.Frame) -> None:
        personal_frame = ttk.LabelFrame(
            parent,
            text="Informações Pessoais",
            padding="10"
        )
        personal_frame.pack(fill=tk.X, pady=(0, 10))

        ttk.Label(personal_frame, text="Nome:").grid(row=0, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        ttk.Label(personal_frame, text="Email:").grid(row=1, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        personal_frame.columnconfigure(1, weight=1)

5 Segundo LabelFrame: Preferências do Aplicativo

Adicione um segundo LabelFrame para preferências. Use Combobox para Tema e Idioma. Definir state="readonly" impede edições livres.

    def create_preferences_frame(self, parent: ttk.Frame) -> None:
        pref_frame = ttk.LabelFrame(parent, text="Preferências do Aplicativo", padding="10")
        pref_frame.pack(fill=tk.X, pady=(0, 10))

        ttk.Label(pref_frame, text="Tema:").grid(row=0, column=0, sticky=tk.W, pady=5)
        theme_combo = ttk.Combobox(pref_frame, values=["Light", "Dark", "System"], state="readonly")
        theme_combo.set("Light")
        theme_combo.grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        ttk.Label(pref_frame, text="Idioma:").grid(row=1, column=0, sticky=tk.W, pady=5)
        lang_combo = ttk.Combobox(pref_frame, values=["English", "Spanish", "French", "German"], state="readonly")
        lang_combo.set("English")
        lang_combo.grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        pref_frame.columnconfigure(1, weight=1)

6 Terceiro LabelFrame: Configurações de Notificação

Crie um terceiro LabelFrame para alternâncias. Use Checkbutton para opções do tipo Ligar/Desligar. Este frame não requer colunas de expansão.

    def create_notification_frame(self, parent: ttk.Frame) -> None:
        notif_frame = ttk.LabelFrame(parent, text="Configurações de Notificação", padding="10")
        notif_frame.pack(fill=tk.X)

        ttk.Checkbutton(notif_frame, text="Habilitar notificações por email").grid(row=0, column=0, sticky=tk.W, pady=2)
        ttk.Checkbutton(notif_frame, text="Habilitar notificações de desktop").grid(row=1, column=0, sticky=tk.W, pady=2)
        ttk.Checkbutton(notif_frame, text="Habilitar notificações de som").grid(row=2, column=0, sticky=tk.W, pady=2)

7 Montar os Frames em init

Agora chame os três métodos auxiliares de __init__ para organizar as seções em ordem.

    def __init__(self):
        super().__init__()
        self.title("Configurações do Aplicativo (Demo LabelFrame)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

        main_container = ttk.Frame(self, padding="20")
        main_container.pack(fill=tk.BOTH, expand=True)

        self.create_personal_info_frame(main_container)
        self.create_preferences_frame(main_container)
        self.create_notification_frame(main_container)

8 Estilo e Preenchimento

O argumento padding adiciona espaço dentro de cada LabelFrame, o que impede que o conteúdo fique colado na borda. Mantenha os títulos curtos e descritivos.

No macOS e Windows, a aparência do LabelFrame segue o tema nativo; no Linux com ttk, pode variar. Evite depender de cores exatas entre plataformas.

9 Layout: grid vs. pack

Dentro de um LabelFrame, grid é ótimo para formulários rotulados. Configure a coluna 1 com weight=1 para que as entradas se estendam para preencher a largura disponível. Para alternâncias que não precisam de colunas, pack ou grid de linha única funcionam bem.

Use pady e sticky consistentemente para que as linhas se alinhem e pareçam coesas. Sticky=EW garante que os campos se expandam horizontalmente quando a janela é redimensionada.

10 Código Fonte Completo

Copie o exemplo completo e execute-o para ver as três seções rotuladas.

Nota: Também temos um guia em vídeo para esta lição.

import tkinter as tk
from tkinter import ttk

class SettingsApp(tk.Tk):
    def __init__(self):
        super().__init__()

        # Configurar a janela principal
        self.title("Configurações do Aplicativo (Demo LabelFrame)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

        # Criar o contêiner principal com preenchimento
        main_container = ttk.Frame(self, padding="20")
        main_container.pack(fill=tk.BOTH, expand=True)

        # Criar e empacotar a seção de informações pessoais
        self.create_personal_info_frame(main_container)

        # Criar e empacotar a seção de preferências
        self.create_preferences_frame(main_container)

        # Criar e empacotar as configurações de notificação
        self.create_notification_frame(main_container)

    def create_personal_info_frame(self, parent: ttk.Frame) -> None:
        """Cria um LabelFrame para configurações de informações pessoais."""
        personal_frame = ttk.LabelFrame(
            parent,
            text="Informações Pessoais",
            padding="10"
        )
        personal_frame.pack(fill=tk.X, pady=(0, 10))

        # Criar e empacotar os elementos do formulário
        ttk.Label(personal_frame, text="Nome:").grid(row=0, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        ttk.Label(personal_frame, text="Email:").grid(row=1, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        # Configurar pesos das colunas da grade
        personal_frame.columnconfigure(1, weight=1)

    def create_preferences_frame(self, parent: ttk.Frame) -> None:
        """Cria um LabelFrame para preferências do aplicativo."""
        pref_frame = ttk.LabelFrame(
            parent,
            text="Preferências do Aplicativo",
            padding="10"
        )
        pref_frame.pack(fill=tk.X, pady=(0, 10))

        # Seleção de tema
        ttk.Label(pref_frame, text="Tema:").grid(row=0, column=0, sticky=tk.W, pady=5)
        theme_combo = ttk.Combobox(
            pref_frame, 
            values=["Light", "Dark", "System"],
            state="readonly"
        )
        theme_combo.set("Light")
        theme_combo.grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        # Seleção de idioma
        ttk.Label(pref_frame, text="Idioma:").grid(row=1, column=0, sticky=tk.W, pady=5)
        lang_combo = ttk.Combobox(
            pref_frame,
            values=["English", "Spanish", "French", "German"],
            state="readonly"
        )
        lang_combo.set("English")
        lang_combo.grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        # Configurar pesos das colunas da grade
        pref_frame.columnconfigure(1, weight=1)

    def create_notification_frame(self, parent: ttk.Frame) -> None:
        """Cria um LabelFrame para configurações de notificação."""
        notif_frame = ttk.LabelFrame(
            parent,
            text="Configurações de Notificação",
            padding="10"
        )
        notif_frame.pack(fill=tk.X)

        # Notificações por email
        ttk.Checkbutton(
            notif_frame,
            text="Habilitar notificações por email"
        ).grid(row=0, column=0, sticky=tk.W, pady=2)

        # Notificações de desktop
        ttk.Checkbutton(
            notif_frame,
            text="Habilitar notificações de desktop"
        ).grid(row=1, column=0, sticky=tk.W, pady=2)

        # Notificações de som
        ttk.Checkbutton(
            notif_frame,
            text="Habilitar notificações de som"
        ).grid(row=2, column=0, sticky=tk.W, pady=2)

if __name__ == "__main__":
    app = SettingsApp()
    app.mainloop()

Execute com: python settings_app.py

11 Vídeo e Pontos Chave

Se preferir assistir, aqui está um breve guia sobre o uso do LabelFrame e layout básico.

Conclusão: LabelFrame organiza seções da UI, dá a elas um nome e melhora a clareza. Use preenchimento, títulos claros e pesos de coluna para manter os formulários consistentes e responsivos.