Python `tkinter` 모듈 상세 매뉴얼

Python tkinter 모듈 상세 매뉴얼

Python의 tkinter 모듈은 GUI 애플리케이션을 만드는 데 사용되는 표준 라이브러리입니다. 이 모듈을 사용하면 윈도우, 버튼, 레이블, 텍스트 입력 필드 등 다양한 GUI 요소를 쉽게 생성하고 관리할 수 있습니다. tkinter는 Python에 내장된 모듈로, 추가 설치 없이 사용할 수 있습니다.

설치

tkinter 모듈은 Python에 기본적으로 포함되어 있으므로 별도의 설치가 필요하지 않습니다. Python을 설치하면 tkinter도 자동으로 함께 설치됩니다.

기본 구문

import tkinter as tk

주요 클래스 및 함수

1. Tk 클래스

GUI 애플리케이션의 기본 창을 생성합니다.

root = tk.Tk()

2. Label 클래스

텍스트 레이블을 생성합니다.

label = tk.Label(root, text="Hello, tkinter!")
label.pack()

3. Entry 클래스

단일 줄 텍스트 입력 필드를 생성합니다.

entry = tk.Entry(root)
entry.pack()

4. Button 클래스

버튼을 생성하고 클릭 이벤트를 처리합니다.

def on_button_click():
    print("Button clicked!")

button = tk.Button(root, text="Click Me", command=on_button_click)
button.pack()

5. Text 클래스

여러 줄 텍스트 입력 필드를 생성합니다.

text = tk.Text(root)
text.pack()

6. Canvas 클래스

도형을 그리거나 이미지를 표시할 수 있는 캔버스를 생성합니다.

canvas = tk.Canvas(root, width=200, height=200)
canvas.pack()

# 사각형 그리기
canvas.create_rectangle(50, 50, 150, 150, fill="blue")

7. filedialog 모듈

파일 및 디렉토리 선택 대화 상자를 제공합니다.

from tkinter import filedialog

# 파일 선택 대화 상자 열기
file_path = filedialog.askopenfilename()
print("Selected file:", file_path)

예제

기본 윈도우 생성

간단한 GUI 윈도우를 생성하는 예제입니다.

import tkinter as tk

# 기본 윈도우 생성
root = tk.Tk()
root.title("My Application")
root.geometry("400x300")

# 레이블 추가
label = tk.Label(root, text="Hello, tkinter!")
label.pack()

# 버튼 추가
button = tk.Button(root, text="Click Me")
button.pack()

# 메인 이벤트 루프 시작
root.mainloop()

파일 선택 및 텍스트 표시

파일 선택 대화 상자를 열고 선택한 파일 경로를 텍스트 상자에 표시하는 예제입니다.

import tkinter as tk
from tkinter import filedialog

def select_file():
    file_path = filedialog.askopenfilename()
    text_box.delete(1.0, tk.END)
    text_box.insert(tk.END, file_path)

# 기본 윈도우 생성
root = tk.Tk()
root.title("File Selector")
root.geometry("400x300")

# 파일 선택 버튼 추가
button = tk.Button(root, text="Select File", command=select_file)
button.pack()

# 텍스트 상자 추가
text_box = tk.Text(root, height=10)
text_box.pack()

# 메인 이벤트 루프 시작
root.mainloop()

고급 사용법

레이아웃 관리

pack, grid, place 메서드를 사용하여 위젯을 배치할 수 있습니다.

pack 메서드

위젯을 상하 또는 좌우로 정렬하여 배치합니다.

label = tk.Label(root, text="Packed Label")
label.pack(side="top", fill="x")

grid 메서드

위젯을 격자 형태로 배치합니다.

label = tk.Label(root, text="Grid Label")
label.grid(row=0, column=0)

place 메서드

위젯의 정확한 위치를 지정하여 배치합니다.

label = tk.Label(root, text="Placed Label")
label.place(x=100, y=50)

이벤트 처리

위젯에 다양한 이벤트를 바인딩하여 이벤트 처리를 할 수 있습니다.

마우스 클릭 이벤트

def on_click(event):
    print(f"Mouse clicked at ({event.x}, {event.y})")

canvas = tk.Canvas(root, width=200, height=200)
canvas.bind("<Button-1>", on_click)
canvas.pack()

키보드 입력 이벤트

def on_key(event):
    print(f"Key pressed: {event.keysym}")

root.bind("<Key>", on_key)

주의 사항

tkinter는 싱글 스레드 환경에서 동작하도록 설계되었습니다. GUI 업데이트는 메인 스레드에서만 수행해야 합니다.
위젯의 레이아웃 관리는 각 메서드의 특성을 이해하고 적절히 사용해야 합니다.
이벤트 바인딩 시 메모리 누수를 방지하기 위해 불필요한 바인딩은 제거해야 합니다.

참조

Python 공식 문서 – tkinter
TkDocs: tkinter 튜토리얼과 예제 제공

이 매뉴얼은 Python의 `tkinter` 모듈에 대한 포괄적인 설명을 제공하며, 다양한 예제와 사용법을 통해 사용자에게 깊이 있는 이해를 제공합니다.