Tkinter LabelFrame: Ein freundlicher, praktischer Leitfaden

1 Was ist ein LabelFrame?

LabelFrame ist ein Container-Widget in Tkinter, das einen Rahmen und einen Titel um eine Gruppe von zusammengehörigen Steuerelementen zieht. Es ist der Standardweg, um Abschnitte zu organisieren – stellen Sie es sich als eine beschriftete Karte vor, die zusammengehörige Einstellungen sammelt.

Sie werden es in Einstellungsdialogen, Präferenzfenstern und Dateneingabemasken sehen. Es gruppiert Widgets visuell und semantisch, sodass Benutzer sehen, was zusammengehört und was nicht.

Ziel: Erstellen Sie ein übersichtliches Einstellungsfenster, das LabelFrame verwendet, um persönliche Informationen, Anwendungseinstellungen und Benachrichtigungseinstellungen zu enthalten.

2 Voraussetzungen

LabelFrame ist Teil des Tkinter-ttk-Moduls, das mit Python geliefert wird. Sie benötigen nur Python 3.7+ und die Standardbibliothek – keine zusätzlichen Pakete.

Überprüfen Sie Ihre Version:

python --version

3 Erstellen Sie das Anwendungsfenster

Beginnen Sie mit der Ableitung von Tk, um ein minimales Einstellungsfenster zu erstellen. Dies bietet Ihnen einen sauberen Einstiegspunkt für spätere Komponenten.

import tkinter as tk
from tkinter import ttk

class SettingsApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("Application Settings (LabelFrame Demo)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

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

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

4 Erster LabelFrame: Persönliche Informationen

Erstellen Sie einen LabelFrame für „Persönliche Informationen“ und fügen Sie dann zwei beschriftete Felder hinzu. Konfigurieren Sie das Gitter so, dass sich die Eingabefelder horizontal erweitern.

    def create_personal_info_frame(self, parent: ttk.Frame) -> None:
        personal_frame = ttk.LabelFrame(
            parent,
            text="Personal Information",
            padding="10"
        )
        personal_frame.pack(fill=tk.X, pady=(0, 10))

        ttk.Label(personal_frame, text="Name:").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 Zweiter LabelFrame: Anwendungseinstellungen

Fügen Sie einen zweiten LabelFrame für Einstellungen hinzu. Verwenden Sie Combobox für Thema und Sprache. Das Setzen von state="readonly" verhindert freie Eingaben.

    def create_preferences_frame(self, parent: ttk.Frame) -> None:
        pref_frame = ttk.LabelFrame(parent, text="Application Preferences", padding="10")
        pref_frame.pack(fill=tk.X, pady=(0, 10))

        ttk.Label(pref_frame, text="Theme:").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="Language:").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 Dritter LabelFrame: Benachrichtigungseinstellungen

Erstellen Sie einen dritten LabelFrame für Umschalter. Verwenden Sie Checkbutton für Ein/Aus-Optionen. Dieser Frame benötigt keine sich erweiternden Spalten.

    def create_notification_frame(self, parent: ttk.Frame) -> None:
        notif_frame = ttk.LabelFrame(parent, text="Notification Settings", padding="10")
        notif_frame.pack(fill=tk.X)

        ttk.Checkbutton(notif_frame, text="Enable email notifications").grid(row=0, column=0, sticky=tk.W, pady=2)
        ttk.Checkbutton(notif_frame, text="Enable desktop notifications").grid(row=1, column=0, sticky=tk.W, pady=2)
        ttk.Checkbutton(notif_frame, text="Enable sound notifications").grid(row=2, column=0, sticky=tk.W, pady=2)

7 Rufen Sie die Methoden in init auf

Rufen Sie nun die drei Hilfsmethoden aus __init__ auf, um die Abschnitte in der richtigen Reihenfolge anzuordnen.

    def __init__(self):
        super().__init__()
        self.title("Application Settings (LabelFrame Demo)")
        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 Styling und Padding

Das Argument padding fügt Abstand innerhalb jedes LabelFrame hinzu, sodass der Inhalt nicht an den Rand stößt. Halten Sie Titel kurz und beschreibend.

Auf macOS und Windows folgt das Erscheinungsbild von LabelFrame dem nativen Thema; unter Linux mit ttk kann es variieren. Vermeiden Sie es, sich auf exakte Farben über verschiedene Plattformen hinweg zu verlassen.

9 Layout: grid vs. pack

Innerhalb eines LabelFrame eignet sich grid hervorragend für beschriftete Formulare. Konfigurieren Sie Spalte 1 mit weight=1, damit sich Eingabefelder horizontal ausdehnen, um den verfügbaren Platz auszufüllen. Für Umschalter, die keine Spalten benötigen, funktionieren pack oder grid in einer einzigen Zeile gut.

Verwenden Sie padding und sticky konsistent, damit Zeilen ausgerichtet sind und zusammenhängend wirken. Sticky=EW stellt sicher, dass sich Felder beim Ändern der Fenstergröße horizontal ausdehnen.

10 Vollständiger Quellcode

Kopieren Sie das vollständige Beispiel und führen Sie es aus, um die drei beschrifteten Abschnitte zu sehen.

Hinweis: Wir haben auch ein Video-Tutorial zu dieser Lektion.

import tkinter as tk
from tkinter import ttk

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

        # Configure the main window
        self.title("Application Settings (LabelFrame Demo)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

        # Create the main container with padding
        main_container = ttk.Frame(self, padding="20")
        main_container.pack(fill=tk.BOTH, expand=True)

        # Create and pack the personal info section
        self.create_personal_info_frame(main_container)

        # Create and pack the preferences section
        self.create_preferences_frame(main_container)

        # Create and pack the notification settings
        self.create_notification_frame(main_container)

    def create_personal_info_frame(self, parent: ttk.Frame) -> None:
        """Creates a LabelFrame for personal information settings."""
        personal_frame = ttk.LabelFrame(
            parent,
            text="Personal Information",
            padding="10"
        )
        personal_frame.pack(fill=tk.X, pady=(0, 10))

        # Create and pack the form elements
        ttk.Label(personal_frame, text="Name:").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))

        # Configure grid column weights
        personal_frame.columnconfigure(1, weight=1)

    def create_preferences_frame(self, parent: ttk.Frame) -> None:
        """Creates a LabelFrame for application preferences."""
        pref_frame = ttk.LabelFrame(
            parent,
            text="Application Preferences",
            padding="10"
        )
        pref_frame.pack(fill=tk.X, pady=(0, 10))

        # Theme selection
        ttk.Label(pref_frame, text="Theme:").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))

        # Language selection
        ttk.Label(pref_frame, text="Language:").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))

        # Configure grid column weights
        pref_frame.columnconfigure(1, weight=1)

    def create_notification_frame(self, parent: ttk.Frame) -> None:
        """Creates a LabelFrame for notification settings."""
        notif_frame = ttk.LabelFrame(
            parent,
            text="Notification Settings",
            padding="10"
        )
        notif_frame.pack(fill=tk.X)

        # Email notifications
        ttk.Checkbutton(
            notif_frame,
            text="Enable email notifications"
        ).grid(row=0, column=0, sticky=tk.W, pady=2)

        # Desktop notifications
        ttk.Checkbutton(
            notif_frame,
            text="Enable desktop notifications"
        ).grid(row=1, column=0, sticky=tk.W, pady=2)

        # Sound notifications
        ttk.Checkbutton(
            notif_frame,
            text="Enable sound notifications"
        ).grid(row=2, column=0, sticky=tk.W, pady=2)

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

Ausführen mit: python settings_app.py

11 Video & Fazit

Wenn Sie lieber zuschauen, hier ist eine kurze Anleitung zur Verwendung von LabelFrame und grundlegenden Layouts.

Fazit: LabelFrame organisiert UI-Abschnitte, gibt ihnen einen Namen und verbessert die Klarheit. Verwenden Sie padding, klare Titel und Spaltengewichte, um Formulare konsistent und reaktionsschnell zu halten.