آموزش جامع کتابخانه Tkinter در پایتون (رابط کاربری گرافیکی)

# Static Code: Requires a display environment to render the window
import tkinter as tk

# ایجاد پنجره اصلی
root = tk.Tk()

# اجرای حلقه اصلی (برنامه اینجا متوقف می‌شود تا پنجره بسته شود)
root.mainloop()

# Static Code: GUI Script
import tkinter as tk

root = tk.Tk()

# تنظیم عنوان پنجره
root.title("خانه پایتون - اولین برنامه")

# تنظیم ابعاد: عرضxارتفاع
root.geometry("400x300")

# جلوگیری از تغییر سایز (False برای عرض و ارتفاع)
root.resizable(False, False)

root.mainloop()

# Static Code: GUI Logic with Console Output
import tkinter as tk

def on_click():
    print("دکمه کلیک شد!")

root = tk.Tk()
root.geometry("300x200")

# ساخت برچسب
label = tk.Label(root, text="سلام به خانه پایتون!", font=("Arial", 14))
label.pack() # نمایش در پنجره

# ساخت دکمه
btn = tk.Button(root, text="کلیک کنید", command=on_click)
btn.pack()

root.mainloop()

# Static Code: GUI Input Handling
import tkinter as tk

def show_name():
    # دریافت متن از ویجت Entry
    name = name_entry.get()
    print(f"کاربر وارد شده: {name}")

root = tk.Tk()
root.geometry("300x150")

tk.Label(root, text="نام خود را وارد کنید:").pack()

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

submit_btn = tk.Button(root, text="تایید", command=show_name)
submit_btn.pack()

root.mainloop()

# Static Code: Pack Layout
import tkinter as tk

root = tk.Tk()

# fill=tk.X باعث می‌شود ویجت عرض پنجره را پر کند
tk.Label(root, text="Header", bg="red", fg="white").pack(fill=tk.X)
tk.Label(root, text="Content", bg="blue", fg="white").pack(fill=tk.BOTH, expand=True)
tk.Label(root, text="Footer", bg="green", fg="white").pack(fill=tk.X)

root.mainloop()

# Static Code: Grid Layout
import tkinter as tk

root = tk.Tk()

tk.Label(root, text="نام کاربری:").grid(row=0, column=0)
tk.Entry(root).grid(row=0, column=1)

tk.Label(root, text="رمز عبور:").grid(row=1, column=0)
tk.Entry(root, show="*").grid(row=1, column=1)

tk.Button(root, text="ورود").grid(row=2, column=0, columnspan=2)

root.mainloop()

# Static Code: OOP Structure in Tkinter
import tkinter as tk

class App(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("OOP Tkinter App")
        self.geometry("400x300")
        
        # مقداردهی اولیه UI
        self.create_widgets()

    def create_widgets(self):
        self.label = tk.Label(self, text="برنامه شی‌گرا")
        self.label.pack(pady=20)
        
        self.btn = tk.Button(self, text="خروج", command=self.quit)
        self.btn.pack()

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

# Static Code: Modular Frame Components
import tkinter as tk

class LoginForm(tk.Frame):
    def __init__(self, parent):
        super().__init__(parent, padx=10, pady=10, borderwidth=2, relief="groove")
        self.pack()
        
        tk.Label(self, text="Username:").pack()
        self.user_entry = tk.Entry(self)
        self.user_entry.pack()

class MainApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("Modular App")
        
        # استفاده از کامپوننت لاگین
        self.login = LoginForm(self)
        
        tk.Button(self, text="Check", command=self.check_login).pack(pady=10)

    def check_login(self):
        print(f"Checking: {self.login.user_entry.get()}")

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

# Static Code: Dynamic String Variable
import tkinter as tk

root = tk.Tk()

# تعریف متغیر مخصوص Tkinter
text_var = tk.StringVar()
text_var.set("اینجا بنویسید...")

entry = tk.Entry(root, textvariable=text_var)
entry.pack()

# برچسبی که به همان متغیر متصل است
label = tk.Label(root, textvariable=text_var, fg="blue")
label.pack()

root.mainloop()

# Static Code: Event Binding
import tkinter as tk

def on_enter_key(event):
    print("دکمه Enter فشرده شد!")

def on_left_click(event):
    print(f"کلیک چپ در موقعیت: {event.x}, {event.y}")

root = tk.Tk()

lbl = tk.Label(root, text="اینجا کلیک کنید یا Enter بزنید")
lbl.pack(padx=50, pady=50)

# اتصال کلید اینتر به پنجره
root.bind('<Return>', on_enter_key)

# اتصال کلیک چپ به برچسب خاص
lbl.bind('<Button-1>', on_left_click)

root.mainloop()

# Static Code: TTK vs Standard Widgets
import tkinter as tk
from tkinter import ttk

root = tk.Tk()
root.geometry("300x100")

# دکمه قدیمی
btn_old = tk.Button(root, text="Standard Button", bg="gray")
btn_old.pack(pady=5)

# دکمه مدرن (TTK)
btn_new = ttk.Button(root, text="Themed Button")
btn_new.pack(pady=5)

root.mainloop()

# Static Code: TTK Styling
import tkinter as tk
from tkinter import ttk

root = tk.Tk()

style = ttk.Style()
# تعریف یک استایل جدید برای دکمه
style.configure("Danger.TButton", foreground="red", font=("Helvetica", 12, "bold"))

btn = ttk.Button(root, text="دکمه خطر", style="Danger.TButton")
btn.pack(padx=20, pady=20)

root.mainloop()

# Static Code: Blocking UI (Do not use in production)
import tkinter as tk
import time

def heavy_task():
    time.sleep(5)  # شبیه‌سازی کار سنگین ۵ ثانیه‌ای
    print("کار تمام شد")

root = tk.Tk()
tk.Button(root, text="شروع کار سنگین (Freeze)", command=heavy_task).pack()
root.mainloop()

# Static Code: Implementing Threading in Tkinter
import tkinter as tk
import threading
import time

def run_heavy_task():
    # غیرفعال کردن دکمه برای جلوگیری از کلیک مجدد
    btn.config(state="disabled")
    
    def task():
        time.sleep(3) # شبیه‌سازی
        print("Task Done")
        # برگرداندن دکمه به حالت فعال (باید در ترد اصلی انجام شود؟ در Tkinter ساده معمولا مشکلی نیست اما امن‌تر است از after استفاده شود)
        btn.config(state="normal")

    # ساخت و شروع ترد جدید
    threading.Thread(target=task, daemon=True).start()

root = tk.Tk()
btn = tk.Button(root, text="Start Async Task", command=run_heavy_task)
btn.pack(pady=20)

root.mainloop()