Tkinter LabelFrame 실용 튜토리얼

1 LabelFrame이란 무엇인가요?

LabelFrame은 Tkinter의 컨테이너 위젯으로, 관련 컨트롤 그룹 주위에 테두리와 제목을 그립니다. 섹션을 구성하는 표준 방법입니다. 관련 설정을 모아두는 레이블이 붙은 카드라고 생각하면 됩니다.

설정 대화 상자, 환경 설정 패널, 데이터 입력 화면 등에서 볼 수 있습니다. 위젯을 시각적으로, 의미적으로 그룹화하여 사용자가 어떤 것이 함께 속하고 어떤 것이 그렇지 않은지 볼 수 있도록 합니다.

목표: 개인 정보, 애플리케이션 환경 설정, 알림 설정을 담을 LabelFrame을 사용하여 깔끔한 설정 창을 구축합니다.

2 사전 요구 사항

LabelFrame은 Python과 함께 제공되는 Tkinter의 ttk 모듈에 포함되어 있습니다. Python 3.7 이상과 표준 라이브러리만 있으면 됩니다. 추가 패키지는 필요하지 않습니다.

버전을 확인하세요:

python --version

3 애플리케이션 창 만들기

나중에 사용할 컴포넌트들을 위한 깔끔한 진입점을 제공하는 Tk를 서브클래싱하여 최소한의 설정 창을 만듭니다.

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 첫 번째 LabelFrame: 개인 정보

“개인 정보”를 위한 LabelFrame을 만든 다음 두 개의 레이블이 붙은 필드를 추가합니다. 그리드를 구성하여 입력 필드가 가로로 확장되도록 합니다.

    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 두 번째 LabelFrame: 애플리케이션 환경 설정

환경 설정을 위한 두 번째 LabelFrame을 추가합니다. 테마 및 언어에는 Combobox를 사용합니다. state="readonly"를 설정하면 자유 형식 편집을 방지할 수 있습니다.

    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 세 번째 LabelFrame: 알림 설정

토글을 위한 세 번째 LabelFrame을 만듭니다. On/Off 스타일 옵션에는 Checkbutton을 사용합니다. 이 프레임에는 확장 열이 필요하지 않습니다.

    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 init에서 메서드 호출

이제 세 개의 헬퍼 메서드를 __init__에서 호출하여 섹션을 순서대로 배치합니다.

    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 스타일링 및 패딩

padding 인수는 각 LabelFrame 내부에 공간을 추가하여 콘텐츠가 테두리에 너무 가깝게 붙지 않도록 합니다. 제목은 짧고 설명적으로 유지하세요.

macOS 및 Windows에서는 LabelFrame 모양이 네이티브 테마를 따릅니다. Linux에서는 ttk와 함께 사용 시 다를 수 있습니다. 플랫폼 간 정확한 색상에 의존하지 마세요.

9 레이아웃: grid vs. pack

LabelFrame 내부에서는 grid가 레이블이 붙은 양식에 좋습니다. 입력 필드가 사용 가능한 너비를 채우도록 열 1에 weight=1을 설정합니다. 열이 필요하지 않은 토글의 경우 pack이나 단일 행 grid를 사용해도 됩니다.

pady와 sticky를 일관되게 사용하여 행이 정렬되고 통일감 있게 보이도록 합니다. sticky=EW는 창이 크기를 조정할 때 필드가 가로로 확장되도록 합니다.

10 전체 소스 코드

완전한 예제를 복사하여 실행하면 세 개의 레이블이 붙은 섹션을 볼 수 있습니다.

참고: 이 강의에 대한 비디오 워크스루도 있습니다.

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()

실행 방법: python settings_app.py

11 비디오 및 요약

시청을 선호하는 경우, LabelFrame 사용법과 기본 레이아웃에 대한 짧은 워크스루입니다.

요약: LabelFrame은 UI 섹션을 구성하고, 이름을 부여하며, 명확성을 향상시킵니다. 패딩, 명확한 제목, 열 가중치를 사용하여 양식을 일관되고 반응성 있게 유지하세요.