tkinter.colorchooser --- پنجره‌ی انتخاب رنگ¶

کد منبع: Lib/tkinter/colorchooser.py

ماژول tkinter.colorchooser کلاس Chooser را به‌عنوان رابطی برای پنجره محاوره‌ی انتخاب رنگ بومی فراهم می‌کند. Chooser یک پنجره محاوره‌ای مودال برای انتخاب رنگ پیاده‌سازی می‌کند. کلاس Chooser از کلاس Dialog ارث می‌برد.

class tkinter.colorchooser.Chooser(master=None, **options)¶

کلاسی که پنجره محاوره‌ای مودال (modal) برای انتخاب رنگ را پیاده‌سازی می‌کند. بیشتر برنامه‌ها به‌جای نمونه‌سازی مستقیم این کلاس، از تابع تسهیل‌کننده askcolor() استفاده می‌کنند.

tkinter.colorchooser.askcolor(color=None, **options)¶

یک پنجره‌ی محاوره‌ای مودال برای انتخاب رنگ نمایش می‌دهد و رنگ انتخاب‌شده را برمی‌گرداند. color رنگی است که هنگام باز شدن پنجره‌ی محاوره‌ای انتخاب شده است. مقدار بازگشتی یک تاپل ((r, g, b), hexstr) است، که در آن r، g و b کامپوننت‌های قرمز، سبز و آبی به‌صورت اعداد صحیح در بازه‌ی ۰ تا ۲۵۵ هستند و hexstr رشته‌ی رنگ معادل در Tk است، مانند '#ff8000'. اگر کاربر پنجره‌ی محاوره‌ای را لغو کند، (None, None) برگردانده می‌شود.

تغییر یافته در نسخه‌ی 3.10: مقادیر RGB در رنگ برگردانده‌شده اکنون به‌جای مقادیر اعشاری، اعداد صحیح در بازه‌ی ۰ تا ۲۵۵ هستند.