استفاده از Ttk¶

برای شروع استفاده از Ttk، ماژول آن را ایمپورت کنید:

from tkinter import ttk

برای بازنویسی ابزارک‌های پایه‌ی Tk، ایمپورت باید پس از ایمپورت Tk انجام شود:

from tkinter import *
from tkinter.ttk import *

آن کد باعث می‌شود چندین ابزارک tkinter.ttk (Button، Checkbutton، Entry، Frame، Label، LabelFrame، Menubutton، OptionMenu، PanedWindow، Radiobutton، Scale، Scrollbar و Spinbox) به‌طور خودکار جایگزین ابزارک‌های Tk شوند.

این امر مزیت مستقیم استفاده از ابزارک‌های جدید را به همراه دارد و ظاهر و رفتار بهتری در سکوهای مختلف ارائه می‌دهد؛ با این حال، ابزارک‌های جایگزین کاملاً سازگار نیستند. تفاوت اصلی این است که گزینه‌های ابزارک مانند fg، bg و سایر گزینه‌های مربوط به سبک‌دهی ابزارک، دیگر در ابزارک‌های Ttk وجود ندارند. در عوض، برای جلوه‌های سبک‌دهی بهبودیافته از کلاس ttk.Style استفاده کنید.

ابزارک‌های Ttk¶

Ttk دارای ۱۸ ابزارک است که دوازده‌تا از آن‌ها از قبل در tkinter وجود داشتند: Button، Checkbutton، Entry، Frame، Label، LabelFrame، Menubutton، PanedWindow، Radiobutton، Scale، Scrollbar و Spinbox. شش‌تای دیگر جدید هستند: Combobox، Notebook، Progressbar، Separator، Sizegrip و Treeview. همه‌ی آن‌ها زیرکلاس‌هایی از Widget هستند.

استفاده از ابزارک‌های Ttk، ظاهر و رفتار برنامه را بهبود می‌بخشد. همان‌طور که در بالا بحث شد، تفاوت‌هایی در نحوه کدنویسی سبک‌دهی وجود دارد.

کد Tk:

l1 = tkinter.Label(text="Test", fg="black", bg="white")
l2 = tkinter.Label(text="Test", fg="black", bg="white")

کد Ttk:

style = ttk.Style()
style.configure("BW.TLabel", foreground="black", background="white")

l1 = ttk.Label(text="Test", style="BW.TLabel")
l2 = ttk.Label(text="Test", style="BW.TLabel")

برای اطلاعات بیشتر درباره TtkStyling، مستندات کلاس Style را ببینید.

ابزارک¶

ttk.Widget گزینه‌ها و متدهای استاندارد پشتیبانی‌شده توسط ابزارک‌های Tk پوسته‌دار را تعریف می‌کند و قرار نیست به‌طور مستقیم نمونه‌سازی شود.

جعبه انتخاب (Combobox)¶

ابزارک ttk.Combobox یک فیلد متنی را با فهرستی بازشونده از مقادیر ترکیب می‌کند. این ابزارک زیرکلاسی از Entry است.

علاوه بر متدهایی که از Widget به ارث رسیده‌اند: cget()، configure()، identify()، instate() و state()، و متدهای زیر که از Entry به ارث رسیده‌اند: bbox()، delete()، icursor()، index()، insert()، selection*، xview*، متدهای دیگری نیز دارد که در ttk.Combobox توضیح داده شده‌اند.

اسپین‌باکس (Spinbox)¶

ابزارک ttk.Spinbox یک ttk.Entry است که با پیکان‌های افزایش و کاهش تقویت‌شده است. می‌توان از آن برای اعداد یا فهرست‌هایی از مقادیر رشته‌ای استفاده کرد. این ابزارک یک کلاس فرعی از Entry است. علاوه بر متدهایی که از Widget به ارث رسیده‌اند: cget()، configure()، identify()، instate() و state()، و متدهای زیر که از Entry به ارث رسیده‌اند: bbox()، delete()، icursor()، index()، insert()، xview*، این ابزارک متدهای دیگری نیز دارد که در ttk.Spinbox توضیح داده شده‌اند.

نوت‌بوک¶

ابزارک Ttk Notebook مجموعه‌ای از پنجره‌ها را مدیریت می‌کند و در هر زمان فقط یکی را نمایش می‌دهد. هر پنجره‌ی فرزند با یک زبانه مرتبط است که کاربر می‌تواند آن را برای تغییر پنجره‌ی در حال نمایش انتخاب کند.

نوار پیشرفت¶

ابزارک ttk.Progressbar وضعیت یک عملیات طولانی‌مدت را نشان می‌دهد. این ابزارک می‌تواند در دو حالت کار کند: ۱) حالت مشخص که مقدار تکمیل‌شده را نسبت به کل مقدار کاری که باید انجام شود نشان می‌دهد و ۲) حالت نامشخص که نمایشی متحرک ارائه می‌کند تا کاربر بداند کار در حال پیشرفت است.

جداکننده¶

ابزارک ttk.Separator یک نوار جداکننده افقی یا عمودی را نمایش می‌دهد.

هیچ متد دیگری به جز متدهایی که از ttk.Widget به ارث برده است، ندارد.

دسته تغییر اندازه (Sizegrip)¶

ابزارک ttk.Sizegrip (که با نام جعبه‌ی رشد (grow box) نیز شناخته می‌شود) به کاربر امکان می‌دهد با فشار دادن و کشیدن دسته، اندازه‌ی پنجره‌ی سطح بالای حاوی آن را تغییر دهد.

این ابزارک نه گزینه‌های خاصی دارد و نه متدهای خاصی، به‌جز آن‌هایی که از ttk.Widget به ارث برده است.

نمای درختی (Treeview)¶

ابزارک ttk.Treeview مجموعه‌ای سلسله‌مراتبی از آیتم‌ها را نمایش می‌دهد. هر آیتم دارای یک برچسب متنی، یک تصویر اختیاری و یک فهرست اختیاری از مقادیر داده است. مقادیر داده در ستون‌های متوالی پس از برچسب درخت نمایش داده می‌شوند.

ترتیب نمایش مقادیر داده را می‌توان با تنظیم گزینه‌ی displaycolumns ابزارک کنترل کرد. ابزارک درختی همچنین می‌تواند عنوان ستون‌ها را نمایش دهد. می‌توان به ستون‌ها از طریق شماره یا نام‌های نمادین فهرست‌شده در گزینه‌ی columns ابزارک دسترسی داشت. به Column Identifiers مراجعه کنید.

هر آیتم با یک نام یکتا مشخص می‌شود. اگر شناسه‌های آیتم توسط فراخواننده ارائه نشده باشند، ابزارک آن‌ها را تولید خواهد کرد. یک آیتم ریشه‌ی متمایز با نام {} وجود دارد. خود آیتم ریشه نمایش داده نمی‌شود؛ فرزندان آن در بالاترین سطح سلسله‌مراتب نمایش داده می‌شوند.

هر آیتم همچنین دارای فهرستی از برچسب‌ها است که می‌توان از آن‌ها برای مرتبط کردن اتصال‌های رویداد با آیتم‌های منفرد و کنترل ظاهر آیتم استفاده کرد.

ابزارک Treeview از پیمایش افقی و عمودی پشتیبانی می‌کند، بر اساس گزینه‌های توصیف‌شده در Scrollable Widget Options و متدهای Treeview.xview() و Treeview.yview().

سبک‌دهی Ttk¶

به هر ابزارک در ttk یک سبک اختصاص داده می‌شود که مجموعه‌ی المان‌های تشکیل‌دهنده‌ی ابزارک و نحوه‌ی چیدمان آن‌ها را به‌همراه تنظیمات پویا و پیش‌فرض برای گزینه‌های المان‌ها مشخص می‌کند. به‌طور پیش‌فرض، نام سبک همان نام کلاس ابزارک است، اما ممکن است توسط گزینه‌ی style ابزارک بازنویسی شود. اگر نام کلاس یک ابزارک را نمی‌دانید، از متد Misc.winfo_class (somewidget.winfo_class()) استفاده کنید.

class tkinter.ttk.Style¶

این کلاس برای دستکاری پایگاه داده‌ی سبک استفاده می‌شود.

configure(style, query_opt=None, **kw)¶

مقدار پیش‌فرض گزینه(های) مشخص‌شده در style را بخوانید یا تنظیم کنید.

هر کلید در kw یک گزینه است و هر مقدار، رشته‌ای است که مقدار آن گزینه را مشخص می‌کند.

برای مثال، برای تبدیل هر دکمه پیش‌فرض به دکمه‌ای تخت با کمی فاصله داخلی و رنگ پس‌زمینه متفاوت:

from tkinter import ttk
import tkinter

root = tkinter.Tk()

ttk.Style().configure("TButton", padding=6, relief="flat",
   background="#ccc")

btn = ttk.Button(text="Sample")
btn.pack()

root.mainloop()

map(style, query_opt=None, **kw)¶

مقادیر پویای گزینه(های) مشخص‌شده در style را بازخوانی یا تنظیم می‌کند.

هر کلید در kw یک گزینه است و هر مقدار باید (معمولاً) یک فهرست یا تاپل حاوی مشخصه‌های وضعیت (statespecs) باشد که در تاپل‌ها، فهرست‌ها یا ترجیحی دیگر گروه‌بندی شده‌اند. یک مشخصه وضعیت (statespec) ترکیبی از یک یا چند وضعیت و سپس یک مقدار است.

یک مثال ممکن است آن را قابل‌فهم‌تر کند:

import tkinter
from tkinter import ttk

root = tkinter.Tk()

style = ttk.Style()
style.map("C.TButton",
    foreground=[('pressed', 'red'), ('active', 'blue')],
    background=[('pressed', '!disabled', 'black'), ('active', 'white')]
    )

colored_btn = ttk.Button(text="Test", style="C.TButton").pack()

root.mainloop()

توجه داشته باشید که ترتیب دنباله‌های (حالت‌ها، مقدار) برای یک گزینه اهمیت دارد؛ برای مثال، اگر ترتیب در گزینه‌ی foreground به [('active', 'blue'), ('pressed', 'red')] تغییر کند، زمانی که ابزارک در حالت‌های active یا pressed باشد، نتیجه پیش‌زمینه‌ای آبی خواهد بود.

هنگامی که برای پرس‌وجوی نگاشت فراخوانی شود (بدون مشخص کردن مقادیر برای تنظیم)، یک دیکشنری برمی‌گرداند که هر گزینه را به فهرست مشخصات وضعیت (statespecs) مربوط به آن نگاشت می‌کند.

تغییر یافته در نسخه‌ی 3.10: مقدار برگردانده‌شده هنگام پرس‌وجو از map اصلاح شد.

lookup(style, option, state=None, default=None)¶

مقدار تعیین‌شده برای option در style را برمی‌گرداند.

اگر state مشخص شده باشد، انتظار می‌رود دنباله‌ای از یک یا چند وضعیت باشد. اگر آرگومان default تنظیم شده باشد، به‌عنوان مقدار جایگزین در صورتی استفاده می‌شود که هیچ مشخصه‌ای برای گزینه یافت نشود.

برای بررسی اینکه یک Button به‌طور پیش‌فرض از چه فونتی استفاده می‌کند:

from tkinter import ttk

print(ttk.Style().lookup("TButton", "font"))

layout(style, layoutspec=None)¶

چیدمان ابزارک برای style داده‌شده را تعریف می‌کند. اگر layoutspec حذف شود، مشخصات چیدمان برای style داده‌شده را برمی‌گرداند.

layoutspec، در صورت مشخص شدن، انتظار می‌رود یک فهرست یا نوع دیگری از دنباله (به‌جز رشته‌ها) باشد، که هر آیتم باید یک تاپل باشد، آیتم اول نام چیدمان است و آیتم دوم باید دارای قالب توصیف‌شده در Layouts باشد.

برای درک قالب، مثال زیر را ببینید (هدف آن انجام کار مفیدی نیست):

from tkinter import ttk
import tkinter

root = tkinter.Tk()

style = ttk.Style()
style.layout("TMenubutton", [
   ("Menubutton.background", None),
   ("Menubutton.button", {"children":
       [("Menubutton.focus", {"children":
           [("Menubutton.padding", {"children":
               [("Menubutton.label", {"side": "left", "expand": 1})]
           })]
       })]
   }),
])

mbtn = ttk.Menubutton(text='Text')
mbtn.pack()
root.mainloop()

element_create(elementname, etype, *args, **kw)¶

یک عنصر جدید در پوسته فعلی ایجاد کنید، از etype داده‌شده که انتظار می‌رود یکی از "image"، "from" یا "vsapi" باشد. مورد آخر فقط در Tk 8.6 در ویندوز در دسترس است.

اگر از "image" استفاده شود، args باید شامل نام تصویر پیش‌فرض و پس از آن جفت‌های statespec/value باشد (این imagespec است)، و kw می‌تواند گزینه‌های زیر را داشته باشد:

border=padding

فاصله داخلی (padding) فهرستی از حداکثر چهار عدد صحیح است که به‌ترتیب حاشیه‌های چپ، بالا، راست و پایین را مشخص می‌کند.

height=height

حداقل ارتفاع برای المان را مشخص می‌کند. اگر کمتر از صفر باشد، ارتفاع تصویر پایه به‌عنوان پیش‌فرض استفاده می‌شود.

padding=padding

فاصله‌ی داخلی (padding) المان را مشخص می‌کند. اگر مشخص نشده باشد، به‌طور پیش‌فرض مقدار حاشیه (border) را می‌گیرد.

sticky=spec

مشخص می‌کند که تصویر چگونه درون قطعه نهایی (parcel) قرار می‌گیرد. spec شامل صفر یا چند نویسه "n"، "s"، "w" یا "e" است.

width=width

حداقل عرض را برای المان مشخص می‌کند. اگر کمتر از صفر باشد، عرض تصویر پایه به‌عنوان پیش‌فرض استفاده می‌شود.

مثال:

img1 = tkinter.PhotoImage(master=root, file='button.png')
img1 = tkinter.PhotoImage(master=root, file='button-pressed.png')
img1 = tkinter.PhotoImage(master=root, file='button-active.png')
style = ttk.Style(root)
style.element_create('Button.button', 'image',
                     img1, ('pressed', img2), ('active', img3),
                     border=(2, 4), sticky='we')

اگر "from" به‌عنوان مقدار etype استفاده شود، element_create() یک المان موجود را رونوشت می‌کند. انتظار می‌رود args شامل یک نام تم باشد که المان از آن رونوشت می‌شود، و به‌صورت اختیاری شامل المانی باشد که از آن رونوشت می‌شود. اگر این المانی که از آن رونوشت می‌شود مشخص نشده باشد، از یک المان خالی استفاده خواهد شد. kw نادیده گرفته می‌شود.

مثال:

style = ttk.Style(root)
style.element_create('plain.background', 'from', 'default')

اگر از "vsapi" به‌عنوان مقدار etype استفاده شود، element_create() المانی جدید در پوسته‌ی جاری ایجاد می‌کند که ظاهر بصری آن با استفاده از Microsoft Visual Styles API، که مسئول سبک‌های پوسته‌ای در Windows XP و Vista است، ترسیم می‌شود. انتظار می‌رود args شامل کلاس و بخش Visual Styles، همان‌طور که در مستندات مایکروسافت آمده است، و به‌دنبال آن‌ها دنباله‌ای اختیاری از تاپل‌های شامل وضعیت‌های ttk و مقدار وضعیت متناظر Visual Styles API باشد. kw می‌تواند گزینه‌های زیر را داشته باشد:

padding=padding

فاصله‌ی داخلی المان را مشخص کنید. padding فهرستی از حداکثر ۴ عدد صحیح است که به‌ترتیب مقادیر فاصله‌ی داخلی چپ، بالا، راست و پایین را مشخص می‌کند. اگر کمتر از ۴ عنصر مشخص شده باشد، مقدار پیش‌فرض پایین برابر با بالا، راست برابر با چپ، و بالا برابر با چپ خواهد بود. به عبارت دیگر، فهرستی از ۳ عدد، فاصله‌ی داخلی چپ، عمودی و راست را مشخص می‌کند؛ فهرستی از ۲ عدد، فاصله‌ی داخلی افقی و عمودی را مشخص می‌کند؛ و یک عدد، فاصله‌ی داخلی یکسانی را در تمام اطراف ابزارک مشخص می‌کند. این گزینه را نمی‌توان با هیچ گزینه‌ی دیگری ترکیب کرد.

margins=padding

فاصله بیرونی (padding) المان را مشخص می‌کند. padding فهرستی از حداکثر چهار عدد صحیح است که به‌ترتیب مقادیر فاصله بیرونی چپ، بالا، راست و پایین را مشخص می‌کند. این گزینه نمی‌تواند با هیچ گزینه دیگری ترکیب شود.

width=width

عرض المان را مشخص می‌کند. اگر این گزینه تنظیم شده باشد، از Visual Styles API برای اندازه توصیه‌شده یا بخش پرس‌وجو نخواهد شد. اگر این گزینه تنظیم شده باشد، height نیز باید تنظیم شود. گزینه‌های width و height را نمی‌توان با گزینه‌های padding یا margins ترکیب کرد.

height=height

ارتفاع المان را مشخص می‌کند. برای width به توضیحات مراجعه کنید.

مثال:

style = ttk.Style(root)
style.element_create('pin', 'vsapi', 'EXPLORERBAR', 3, [
                     ('pressed', '!selected', 3),
                     ('active', '!selected', 2),
                     ('pressed', 'selected', 6),
                     ('active', 'selected', 5),
                     ('selected', 4),
                     ('', 1)])
style.layout('Explorer.Pin',
             [('Explorer.Pin.pin', {'sticky': 'news'})])
pin = ttk.Checkbutton(style='Explorer.Pin')
pin.pack(expand=True, fill='both')

تغییر یافته در نسخه‌ی 3.13: پشتیبانی از کارخانه‌ی المان "vsapi" افزوده شد.

element_names()¶

یک تاپل از عناصر تعریف‌شده در پوسته‌ی جاری برمی‌گرداند.

element_options(elementname)¶

یک تاپل از گزینه‌های elementname را برمی‌گرداند.

theme_create(themename, parent=None, settings=None)¶

یک پوسته جدید ایجاد کنید.

اگر themename از قبل وجود داشته باشد، خطا محسوب می‌شود. اگر parent تعیین شده باشد، پوسته‌ی جدید سبک‌ها، عناصر و چیدمان‌ها را از پوسته‌ی والد به ارث می‌برد. اگر settings موجود باشند، انتظار می‌رود که همان نحوی را داشته باشند که برای theme_settings() استفاده می‌شود.

theme_settings(themename, settings)¶

به‌طور موقت پوسته‌ی فعلی را به themename تنظیم می‌کند، settings مشخص‌شده را اعمال می‌کند و سپس پوسته‌ی قبلی را بازمی‌گرداند.

هر کلید در settings یک سبک است و هر مقدار ممکن است شامل کلیدهای 'configure'، 'map'، 'layout' و 'element create' باشد و انتظار می‌رود آن‌ها به ترتیب همان قالب مشخص‌شده توسط متدهای Style.configure()، Style.map()، Style.layout() و Style.element_create() را داشته باشند.

به‌عنوان مثال، بیایید Combobox را برای پوسته‌ی پیش‌فرض کمی تغییر دهیم:

from tkinter import ttk
import tkinter

root = tkinter.Tk()

style = ttk.Style()
style.theme_settings("default", {
   "TCombobox": {
       "configure": {"padding": 5},
       "map": {
           "background": [("active", "green2"),
                          ("!disabled", "green4")],
           "fieldbackground": [("!disabled", "green3")],
           "foreground": [("focus", "OliveDrab1"),
                          ("!disabled", "OliveDrab2")]
       }
   }
})

combo = ttk.Combobox().pack()

root.mainloop()

theme_names()¶

تاپلی از تمام پوسته‌های شناخته‌شده را برمی‌گرداند.

theme_use(themename=None)¶

اگر themename داده نشود، پوسته‌ی در حال استفاده را برمی‌گرداند. در غیر این صورت، پوسته‌ی فعلی را روی themename تنظیم می‌کند، همه‌ی ابزارک‌ها را تازه‌سازی می‌کند و یک رویداد <<ThemeChanged>> منتشر می‌کند.

ابزارک‌های اضافی¶

ابزارک‌های پوسته‌دار زیر، مجموعه ابزارک‌های tkinter.ttk را کامل می‌کنند. هر یک همتای پوسته‌دار ابزارک کلاسیک هم‌نام در tkinter است و متدهای مشترک Widget را به ارث می‌برد.

class tkinter.ttk.Button(master=None, **kw)¶

ابزارک Button در Ttk، یک برچسب متنی و/یا تصویر را نمایش می‌دهد و هنگام فشرده شدن، یک فرمان را ارزیابی می‌کند. این ابزارک، همتای پوسته‌دار tkinter.Button است و متدهای رایج ابزارک‌ها را از Widget به ارث می‌برد.

invoke()¶

فرمان مرتبط با دکمه را فراخوانی می‌کند و نتیجه‌ی آن را برمی‌گرداند.

class tkinter.ttk.Checkbutton(master=None, **kw)¶

ابزارک Checkbutton در Ttk، برای کنترل یک متغیر بولی استفاده می‌شود که بین حالت روشن و خاموش تغییر وضعیت می‌دهد. این ابزارک، همتای پوسته‌دار tkinter.Checkbutton است و متدهای رایج ابزارک‌ها را از Widget به ارث می‌برد.

invoke()¶

وضعیت دکمه را بین حالت‌های انتخاب‌شده و انتخاب‌نشده تغییر می‌دهد، فرمان مرتبط با دکمه را فراخوانی می‌کند و نتیجه‌ی آن را بازمی‌گرداند.

class tkinter.ttk.Entry(master=None, widget=None, **kw)¶

ابزارک Entry در Ttk، یک رشته متنی یک‌خطی را نمایش می‌دهد و به کاربر امکان ویرایش آن را می‌دهد. این ابزارک، همتای پوسته‌دار tkinter.Entry است و متدهای رایج ابزارک را از Widget و همچنین متدهای ویرایشی را از tkinter.Entry به ارث می‌برد.

bbox(index)¶

یک تاپل (x, y, width, height) برمی‌گرداند که جعبه محدودکننده (bounding box) نویسه در اندیس داده‌شده را می‌دهد.

این، Misc.bbox() موروثی را می‌پوشاند؛ برای جعبه محدودکننده شبکه از grid_bbox() استفاده کنید.

identify(x, y)¶

نام عنصری که در زیر نقطه مشخص‌شده با x و y قرار دارد را برمی‌گرداند، یا رشته خالی اگر هیچ عنصری در آن موقعیت وجود نداشته باشد.

validate()¶

اعتبارسنجی ورودی را اجباری می‌کند و در صورت موفقیت‌آمیز بودن اعتبارسنجی، True و در غیر این صورت False برمی‌گرداند.

class tkinter.ttk.Frame(master=None, **kw)¶

ابزارک Frame در Ttk، یک ظرف است که برای گروه‌بندی و چیدمان سایر ابزارک‌ها استفاده می‌شود. این ابزارک، همتای پوسته‌دار tkinter.Frame است و متدهای مشترک ابزارک‌ها را از Widget به ارث می‌برد.

class tkinter.ttk.Label(master=None, **kw)¶

ابزارک Label در Ttk، یک برچسب متنی و/یا تصویر را نمایش می‌دهد. این ابزارک همتای تم‌دار tkinter.Label است و متدهای رایج ابزارک‌ها را از Widget به ارث می‌برد.

class tkinter.ttk.Labelframe(master=None, **kw)¶

ابزارک Ttk Labelframe، ظرفی است که دور محتوای خود یک کادر و یک برچسب عنوان ترسیم می‌کند. این ابزارک همتای تم‌دارِ tkinter.LabelFrame است و متدهای رایج ابزارک را از Widget به ارث می‌برد.

class tkinter.ttk.Menubutton(master=None, **kw)¶

ابزارک Menubutton در Ttk، یک برچسب متنی و/یا تصویر را نمایش می‌دهد و هنگامی که فشرده می‌شود، یک منو را به‌صورت بازشو ظاهر می‌کند. این ابزارک، همتای پوسته‌دار tkinter.Menubutton است و متدهای رایج ابزارک را از Widget به ارث می‌برد.

class tkinter.ttk.OptionMenu(master, variable, default=None, *values, **kwargs)¶

ابزارک OptionMenu در Ttk، یک Menubutton است که منویی از گزینه‌های انحصاری متقابل را به‌صورت بازشو نمایش می‌دهد. variable متغیری است که مقدار انتخاب‌شده‌ی فعلی را پیگیری می‌کند، default مقداری است که در ابتدا تنظیم می‌شود، و values آیتم‌هایی هستند که در منو نمایش داده می‌شوند. می‌توان یک آرگومان کلیدواژه‌ای command را برای مشخص کردن یک شیء فراخوانی‌پذیر ارائه کرد که هر زمان انتخاب تغییر کند، با مقدار انتخاب‌شده فراخوانی می‌شود؛ آرگومان کلیدواژه‌ای style سبک مورد استفاده در menubutton زیربنایی را تنظیم می‌کند؛ آرگومان کلیدواژه‌ای direction محل نمایش منو نسبت به menubutton را تنظیم می‌کند (یکی از 'above'، 'below' (پیش‌فرض)، 'left'، 'right' یا 'flush')؛ و آرگومان کلیدواژه‌ای name نام ابزارک Tk را تنظیم می‌کند.

set_menu(default=None, *values)¶

آیتم‌های منو را با values جایگزین کنید. اگر default داده شده باشد، آن را به‌عنوان مقدار فعلی variable نیز تنظیم کنید.

destroy()¶

این ابزارک و منوی مرتبط با آن را نابود می‌کند.

تغییر یافته در نسخه‌ی 3.14: پشتیبانی از آرگومان کلیدواژه‌ای name افزوده شد.

class tkinter.ttk.Panedwindow(master=None, **kw)¶

ابزارک Ttk Panedwindow، تعدادی زیرپنجره را نمایش می‌دهد که به‌صورت عمودی یا افقی روی هم چیده شده‌اند. کاربر می‌تواند اندازه‌های نسبی زیرپنجره‌ها را با کشیدن نوار جداکننده (sash) بین پنجره‌ها تنظیم کند. این ابزارک، همتای تم‌دار tkinter.PanedWindow است و متدهای رایج ابزارک را از Widget و همچنین متدهای add() و panes() را از tkinter.PanedWindow به ارث می‌برد.

insert(pos, child, **kw)¶

یک بخش حاوی child را در موقعیت pos درج کنید. pos می‌تواند رشته‌ی 'end'، یک اندیس عدد صحیح، یا نام یک زیرپنجره‌ی مدیریت‌شده باشد. اگر child از قبل توسط پنجره‌ی چندقاب (paned window) مدیریت شده باشد، آن را به موقعیت مشخص‌شده منتقل کنید. هر آرگومان کلیدواژه‌ای، گزینه‌های بخش را تنظیم می‌کند.

forget(child)¶

حذف child، که می‌تواند یک اندیس عدد صحیح یا نام یک زیرپنجره‌ی مدیریت‌شده باشد، از بخش‌ها.

این متد، forget() موروثیِ مدیر چیدمان را می‌پوشاند؛ برای حذف خود ابزارک از مدیر آن، از pack_forget()، grid_forget() یا place_forget() استفاده کنید.

pane(pane, option=None, **kw)¶

گزینه‌های pane مشخص‌شده را پرس‌وجو می‌کند یا تغییر می‌دهد؛ pane یا یک اندیس عدد صحیحی است یا نام یک زیرپنجره‌ی مدیریت‌شده. اگر هیچ آرگومانی داده نشود، یک دیکشنری از مقادیر گزینه‌های pane برمی‌گرداند. اگر option مشخص شده باشد، مقدار آن گزینه را برمی‌گرداند. در غیر این صورت، گزینه‌های داده‌شده به‌صورت آرگومان‌های کلیدواژه‌ای را روی مقادیر متناظرشان تنظیم می‌کند.

sashpos(index, newpos=None)¶

اگر newpos مشخص شده باشد، موقعیت نوار جداکننده با شماره‌ی index را تنظیم می‌کند و موقعیت جدید آن را برمی‌گرداند. این کار ممکن است موقعیت نوارهای جداکننده مجاور را تنظیم کند تا اطمینان حاصل شود که موقعیت‌ها به‌صورت یک‌نواخت افزایشی هستند؛ همچنین موقعیت‌ها محدود شده‌اند که بین ۰ و اندازه‌ی کل ابزارک باشند. اگر newpos حذف شده باشد، موقعیت فعلی نوار جداکننده را برمی‌گرداند.

class tkinter.ttk.Radiobutton(master=None, **kw)¶

ابزارک Radiobutton در Ttk، به‌عنوان بخشی از یک گروه برای کنترل یک متغیر مشترک واحد با انتخاب یکی از چند مقدار متقابلاً انحصاری استفاده می‌شود. این ابزارک همتای دارای تمِ tkinter.Radiobutton است و متدهای رایج ابزارک را از Widget به ارث می‌برد.

invoke()¶

متغیر گزینه را روی مقدار دکمه تنظیم کنید، دکمه را انتخاب کنید، فرمان مرتبط با دکمه را فراخوانی کنید و نتیجه‌ی آن را برگردانید.

class tkinter.ttk.Scale(master=None, **kw)¶

ابزارک Scale در Ttk، لغزنده‌ای را نمایش می‌دهد که به کاربر امکان می‌دهد با حرکت لغزنده در طول یک شیار، یک مقدار عددی از یک محدوده را انتخاب کند. این ابزارک، همتای پوسته‌دار tkinter.Scale است و متدهای رایج ابزارک را از Widget به ارث می‌برد.

configure(cnf=None, **kw)¶

تغییر یا پرس‌وجوی گزینه‌های ابزارک، مانند Widget.configure. علاوه بر این، این متد مقادیر from و to را محدود می‌کند تا مقدار فعلی در محدوده‌ی تعریف‌شده توسط آن‌ها باقی بماند.

تغییر یافته در نسخه‌ی 3.9: اکنون مقدار پیکربندی را برمی‌گرداند، مانند Widget.configure.

get(x=None, y=None)¶

مقدار فعلی مقیاس را برمی‌گرداند. اگر x و y داده شده باشند، در عوض مقدار متناظر با مختصات پیکسلی x، y را برمی‌گرداند.

class tkinter.ttk.Scrollbar(master=None, **kw)¶

ابزارک Scrollbar در Ttk، دریچه دید (viewport) یک ابزارک پیمایش‌پذیر مرتبط مانند Treeview، Entry یا tkinter.Text را کنترل می‌کند. این ابزارک، همتای پوسته‌دار tkinter.Scrollbar است و متدهای مشترک ابزارک‌ها را از Widget و همچنین متدهای set() و get() را از tkinter.Scrollbar به ارث می‌برد.

class tkinter.ttk.Separator(master=None, **kw)¶

ابزارک Separator در Ttk، یک خط جداکننده افقی یا عمودی را نمایش می‌دهد. این ابزارک معادل مستقیمی در tkinter ندارد و متدهای رایج ابزارک‌ها را از Widget به ارث می‌برد.

class tkinter.ttk.Sizegrip(master=None, **kw)¶

ابزارک Sizegrip در Ttk، دسته‌ای را نمایش می‌دهد که به کاربر اجازه می‌دهد با فشار دادن و کشیدن آن دسته، اندازه‌ی پنجره‌ی سطح بالای حاوی آن را تغییر دهد؛ این دسته معمولاً در گوشه‌ی پایین سمت راست قرار می‌گیرد. این ابزارک معادل مستقیمی در tkinter ندارد و متدهای رایج ابزارک‌ها را از Widget به ارث می‌برد.

class tkinter.ttk.LabeledScale(master=None, variable=None, from_=0, to=10, **kw)¶

یک Frame شامل یک Scale و یک Label است که مقدار فعلی مقیاس را نشان می‌دهد. variable همان IntVar است که مقیاس آن را پیگیری می‌کند (اگر داده نشود، یکی ایجاد می‌شود)، و from_ و to بازه‌ی مقیاس را مشخص می‌کنند.

destroy()¶

این ابزارک را نابود می‌کند و کال‌بک ردگیری (trace callback) ثبت‌شده روی متغیر مرتبط را حذف می‌کند.

class tkinter.ttk.LabelFrame(master=None, **kw)¶

نام مستعار Labelframe، که برای سازگاری نام‌گذاری با tkinter.LabelFrame نگه داشته شده است.

class tkinter.ttk.PanedWindow(master=None, **kw)¶

نام مستعاری از Panedwindow، که برای سازگاری نام‌گذاری با tkinter.PanedWindow حفظ شده است.