Серый форум

Кнопки

Кнопки могут содержать текст или изображения. Кнопка может отобразить текст единственным шрифтом, но текст может располагаться более, чем на одной строке. Кроме того, один из символов может быть подчёркнут, например, чтобы отметить быструю клавишу. Простейшее окно с кнопкой:

#!/usr/bin/python
# -*- coding: utf-8 -*-
from Tkinter import *

def die(event):
    root.destroy()

root = Tk()
button = Button(root)
button["text"] = "Button"
button.bind("<Button>", die)
button.pack()
root.mainloop()

Кнопку можно создать и другим способом. В Tkinter предусмотрена процедура создания графического объекта с синтаксисом вызова функции с параметрами (этой строкой можно заменить три соответствующих строки только что приведённого скрипта, при этом параметр event в функции обработки события надо убрать):

button = Button(root, text = u"Кнопка", command = die)

После создания объекта все его свойства можно устанавливать, используя показанный выше синтаксис обращения к словарю: "ключ=значение". Использование выражения "соmаnd=имя_функции" ограничивает ваши возможности назначать только функции без параметров и только единственному событию, тогда как с помощью метода bind() функции обработки можно назначить всем доступным событиям объекта, причём выполнением этих функций можно управлять с помощью параметра. Кстати, bind("<ButtonRelease>", die) будет по умолчанию и обрабатываться несколько иначе, чем соmаnd = die: вы можете проверить это, нажав кнопку мыши в пределах виджета, затем перетащив указатель мыши за пределы виджета, а затем отпустив эту кнопку.

Если вы явно не укажете размер, кнопка будет автоматически отображена достаточно большой, чтобы уместить её надпись. Вы можете использовать свойства padx и pady, чтобы добавить некоторое дополнительное пространство между надписью и границей кнопки. Вы также можете использовать свойства height и width, чтобы явно установить размер. Если вы отображаете в кнопке текст, эти свойства определяют размер кнопки в символах, если же вы отображаете рисунки - в пикселях или экранных единицах.

Вы можете использовать обычные переводы строк или свойство wraplength (максимальная ширина строки в экранных единицах), чтобы заставить кнопку переносить текст по словам. Вы можете использовать свойство relief, чтобы сделать кнопку утопленной, плоской или обведённой рамкой. Вы можете использовать свойства bg и fg для задания цвета кнопки и её текста:

button["fg"] = "green"
button["bg"] = "red"

После рассмотрения виджета "Кнопка" (как примера виджета) можно описать некоторые общие приёмы работы с виджетами.
Каждый виджет имеет свой конструктор, который позволяет задать свойства виджета при его создании единообразным способом:

имя_класса_виджета(родительский_виджет, option=value, ...)

Применение этого конструктора мы уже видели выше на примере кнопок:

button = Button(objRootWindow, text = u"Текст кнопки")

В любой момент можно задать любые свойства каждого виджета следующими равносильными методами:

имя_виджета.configure(option=value, ...)
имя_виджета.config(option=value, ...)

Если имя свойства совпадает с ключевым словом Python, к нему в конец добвляется символ подчёркивания (например, "class_").
Кроме того, свойства можно устанавливать и читать по одному, используя синтаксис обращения к словарям:

имя_виджета["имя_свойства"] = value

Метод keys() вернёт список всех свойств виджета:

имя_виджета.keys()

Многие виджеты позволяют задать цвета самого виджета и его текста (свойства типа background и foreground). Вы можете использовать имя цвета или явно определить красный, зеленый и синий (RGB) компоненты.
Имена цветов задаются в виде строк как Red, Green, Blue, Yellow, White, Сyan, Magenta, LightBlue, Moccasin, PeachPuff и т.д. (включая многие экзотические). Имена цветов нечувствительны к регистру и часто позволяют вводить даже пробелы ("Peach puff"). Доступны также системные цвета Windows: SystemActiveBorder, SystemActiveCaption, SystemAppWorkspace, SystemBackground, SystemButtonFace, SystemButtonHighlight, SystemButtonShadow, SystemButtonText, SystemCaptionText, SystemDisabledText, SystemHighlight, SystemHighlightText, SystemInactiveBorder, SystemInactiveCaption, SystemInactiveCaptionText, SystemMenu, SystemMenuText, SystemScrollbar, SystemWindow, SystemWindowFrame, SystemWindowText.
Цвета также задаются строкой в формате #RRGGBB в шестнадцатеричном виде. Способ преобразования из десятичного вида:

tk_rgb = "#%02x%02x%02x" % (128, 192, 200)

Обратное преобразование:

rgb = имя_виджета.winfo_rgb("Peach puff")
red, green, blue = rgb[0]/256, rgb[1]/256, rgb[2]/256

Многие виджеты позволяют задавать шрифты (свойства типа font). Tkinter поддерживает несколько способов задания шрифтов:
* Описание шрифта.
* Шрифт, определённый пользователем.
* Системный шрифт.
* X-описание шрифта.
Описание шрифта: вы можете определить шрифт как кортеж, содержащий имя, размер в пунктах и произвольную строку с одним или более стилями шрифта, например:

имя_виджета['font'] = ("Helvetica", 10, "bold italic")

Если имя шрифта не содержит пробелов, вы можете задать шрифт одной строкой:

имя_виджета['font'] = "Helvetica 10 bold italic"

Шрифты, как правило всегда доступные в Windows: Arial (Helvetica), Courier New (Courier), Comic Sans MS, Fixedsys, MS Sans Serif, MS Serif, Symbol, System, Times New Roman (Times), Verdana. Доступные стили: normal, bold, roman, italic, underline, overstrike. Если указанный шрифт не обнаружен, будет автоматически подобран похожий.
Шрифт, определённый пользователем: класс Font позволяет создавать объект шрифта.

import tkFont
...
ttf = tkFont.Font(family="Helvetica", size=10, weight=tkFont.BOLD, slant=tkFont.ITALIC)
имя_виджета['font'] = ttf

Если вы изменяете объект шрифта (используя метод config или обращение к свойству шрифта как к индексу словаря), изменения автоматически применяются ко всем виджетам, использующим этот объект шрифта. Класс Font поддерживает свойства: family, size (в пунктах), weight (NORMAL или BOLD), slant (NORMAL или ITALIC), underline (1 или 0), overstrike (1 или 0).
Системный шрифт: задаётся строкой - ansi, ansifixed, device, oemfixed, system или systemfixed.
X-описание шрифта задаётся строкой и имеет следующий формат (звездочки представляют поля, которые обычно не нужны):

-*-family-weight-slant-*--*-size-*-*-*-*-charset

Имя шрифта (family) может содержать пробелы. Параметр "weight" может принимать значения "Bold" или "Normal". Параметр "slant" может принимать значения "R" (что означает "roman" или "normal"), I (что означает "italic") или "O" (что означает "oblique" - всё тот же курсив). Параметр "size" задаётся в пунктах, умноженных на 10. Параметр "charset" означает кодировку символов. Пример:

-*-Allegretto Script One-Bold-I-*--*-250-*-*-*-*-cp1251

Многие виджеты позволяют задавать курсор мыши, отображаемый над виджетом (свойство cursor, задаётся строкой). Возможные значения: arrow, man, based_arrow_down, middlebutton, based_arrow_up, mouse, boat, pencil, bogosity, pirate, bottom_left_corner, plus, bottom_right_corner, question_arrow, bottom_side, right_ptr, bottom_tee, right_side, box_spiral, right_tee, center_ptr, rightbutton, circle, rtl_logo, clock, sailboat, coffee_mug, sb_down_arrow, cross, sb_h_double_arrow, cross_reverse, sb_left_arrow, crosshair, sb_right_arrow, diamond_cross, sb_up_arrow, dot, sb_v_double_arrow, dotbox, shuttle, double_arrow, sizing, draft_large, spider, draft_small, spraycan, draped_box, star, exchange, target, fleur, tcross, gobbler, top_left_arrow, gumby, top_left_corner, hand1, top_right_corner, hand2, top_side, heart, top_tee, icon, trek, iron_cross, ul_angle, left_ptr, umbrella, left_side, ur_angle, left_tee, watch, leftbutton, xterm, ll_angle, X_cursor, lr_angle.

Переключатели

Переключатель может содержать текст или изображения, и вы можете связать с переключателем функцию Python. Переключатель может отобразить текст единственным шрифтом, но текст может содержать больше, чем одну строку. Кроме того, один из символов может быть подчеркнут. Каждая группа переключателей должна быть связана с отдельной переменной, в этом случае каждая кнопка переключателя будет представлять отдельное значение для этой переменной. Пример:

# -*- coding: utf-8 -*-
from Tkinter import *
def f():
    b['text'] = v.get()

root = Tk()

v = StringVar()
v.set(u"Вариант №2")
r1 = Radiobutton(root, text=u"Вариант №1",
    variable = v, value = u"Вариант №1", command = f)
r2 = Radiobutton(root, text=u"Вариант №2",
    variable = v, value = u"Вариант №2", command = f)
b = Button(root, text=v.get(), state = DISABLED)

r1.pack()
r2.pack()
b.pack()
root.mainloop()

Методы переключателей

deselect()
Снимает переключатель.

flash()
Мигает переключателем, привлекая к нему внимание. Для получения эффекта задайте свойство activebackground или activeforeground.

invoke()
Имитирует щелчок по переключателю.

select()
Устанавливает переключатель.

Свойства переключателей

activebackground
activeforeground
Цвет фона/текста активного переключателя.

anchor
Выравникание текста (или картинки) переключателя. По сторонам света: N, NE, E, SE, S, SW, W, NW или CENTER (последнее - по умолчанию).

background (bg)
foreground (fg)
Цвет фона/текста переключателя.

bitmap
Картинка на переключателе. Есди задано свойство image, это свойство игнорируется. Возможные значения: error, gray75, gray50, gray25, gray12, hourglass, info, questhead, question и warning.

borderwidth (bd)
Ширина рамки переключателя в пикселах.

command
Функция, вызываемая при щелчке по переключателю.

cursor
Курсор мыши, отображаемый над переключателем (задается строкой).

disabledforeground
Цвет текста, который будет использоваться, когда переключатель запрещён (disabled).

font
Шрифт текста переключателя.

image
Рисунок на переключателе. Если задано это свойство, свойства text и bitmap игнорируются.

indicatoron
По умолчанию - True. Установка этого свойства в False приведёт к тому, что переключатель превратится в кнопку-переключатель.

justify
Выравнивание текста, если текст содержит несколько строк. LEFT, RIGHT или CENTER.

padx, pady
Внутренние поля переключателя (между краем переключателя и его текстом/рисунком).

relief
Оформление границы. SUNKEN (вдавленный), RAISED (выпуклый), GROOVE, RIDGE или FLAT.

selectcolor
Цвет маленького поля, где расположен собственно сам переключатель.

state
Состояние переключателя (обычное, активен, запрещён). NORMAL (по умолчанию), ACTIVE или DISABLED.

takefocus
Возможность участия переключателя в обходе с помощью клавиши Tab. ON или OFF.

text
Текст переключателя. Может содержать переводы строк. Если заданы свойства bitmap или image, это свойство игнорируется.

textvariable
Имеет тот же смысл, что и у кнопок (см. выше).

underline
Номер символа текста переключателя, который необходимо подчеркнуть. Значение по умолчанию -1 (никакой символ не подчеркнут).

value
Значение, ассоциированное с переключателем (примеры см. выше в этом же разделе).

variable
Переменная, ассоциированная с переключателем (примеры см. выше в этом же разделе).

width, height
Размер переключателя. Если переключатель отображает текст, размер задаётся в символах. Если переключатель отображает изображение, размер задаётся в пикселях (или экранных единицах). Если эти свойства не заданы, размер переключателя рассчитывается автоматически по его содержанию.

wraplength
Максимальная ширина переключателя в экранных единицах. Если текст переключателя не умещается в этой ширине, он будет автоматически разбит на строки.

Поля ввода

Поле ввода (Entry) позволяет пользователю вводить одну строку текста, в единственном шрифте. Стандартные поля ввода по умолчанию не поддерживают контекстного меню для операций с буфером и клавиши Ctrl+c, Ctrl+v, Ctrl+x. На некоторых системах поддерживаются сочетания клавиш Ctrl+Ins, Shift+Ins, Shift+Del или копирование выделенного текста в указанное место средней клавишей мыши; такое копирование можно производить между виджетами (выделенный текст запоминается в своеобразном буфере).

Методы полей ввода приведены ниже. В методах в качестве индексов символов можно использовать константы ANCHOR (позиция начала текста или начала выделения, если оно есть), INSERT (позиция курсора) и END (конец текста). Примечание: если выделение производилось справа налево, ANCHOR будет указывать на визуальный конец выделения; если только что вставлялся текст, ANCHOR становится ненадёжным и может указывать на неожиданные позиции.

В методах вместо индексов символов можно использовать также строки вида '@n' или '"@%d" % n', где n - количество пикселей от левого края виджета. При этом не имеет значения, насколько "прокручен" текст в поле ввода - работа производится с видимой частью текста.

Методы полей ввода

delete (first, last=None)
Удаляет символы из виджета, начиная с символа с индексом first, до символа с индексом last (не включая последний символ). Если второй параметр опущен, удаляется один символ.

get()
Возвращает текст, введённый в поле ввода.

icursor (index)
Устанавливает курсор в указанную позицию, при этом изменяется индекс INSERT. Текст поля ввода при этом визуально не прокручивается.

index (index)
Возвращает число, соответствующее указанному индексу (например, ANCHOR, INSERT или END).

insert (index, s)
Вставляет строку s перед символом с указанным индексом.

select_adjust (index)
selection_adjust (index)
Этот метод используется, чтобы удостовериться, что выделение включает символ c указанным индексом. Если выделение уже включает этот символ, ничего не происходит. В противном случае выделение расширяется от его текущей позиции (или от позиции курсора, если выделения нет) так, чтобы включить указанный индекс.

select_clear()
selection_clear()
Сбрасывает выделение.

select_from (index)
selection_from (index)
Устанавливает индекс ANCHOR.

select_present()
selection_present()
Если есть выделение, возвращает True, иначе возвращает False.

select_range (start, end)
selection_range (start, end)
Явно устанавливает выделение. Параметр start должен быть меньшим, чем end. Используйте selection_range (0, END), чтобы выделить весь текст.

select_to (index)
selection_to (index)
Выделяет текст между ANCHOR и указанным индексом.

xview (index)
Прокручивает текст в случае необходимости так, чтобы указанный символ стал видимым.

xview_moveto (f)
Прокручивает текст в начало (0) или в конец (1), для частичной прокрутки возможны дробные значения в диапазоне от 0 до 1.

xview_scroll (number, what)
Прокручивает текст на указанное количество символов или "страниц". Параметр number может быть отрицательным (прокрутка назад), а параметр what может принимать значения UNITS и PAGES.

Свойства полей ввода

background (bg)
foreground (fg)
Цвет фона/текста поля ввода.

borderwidth (bd)
Ширина рамки поля ввода в пикселах.

cursor
Курсор мыши, отображаемый над полем ввода (задается строкой).

exportselection
Если True, выделенный текст автоматически помещается в специальный буфер, что позволяет копировать этот текст в указанное место средней клавишей мыши. По умолчанию - True.

font
Шрифт текста поля ввода.

insertbackground
Цвет курсора вставки.

insertborderwidth
Толщина рамки выпуклого курсора вставки. Для достижения эффекта значение свойства insertwidth должно быть достаточно большим.

insertofftime
Время в миллисекундах, которое мигающий курсор вставки отсутствует на экране.

insertontime
Время в миллисекундах, которое мигающий курсор вставки присутствует на экране.

insertwidth
Толщина курсора вставки.

justify
Выравнивание текста. LEFT, RIGHT или CENTER.

relief
Оформление границы. SUNKEN (вдавленный), RAISED (выпуклый), GROOVE, RIDGE или FLAT.

selectbackground
Цвет заливки выделения.

selectborderwidth
Толщина специальной рамки выделения.

selectforeground
Цвет выделенного текста.

show
Символ для отображения ввода пароля (например, "*"). При нажатии Ctrl+Ins в буфер будет копироваться строка из этих символов, т.е. пароль будет защищён от копирования в буфер.

state
Состояние поля ввода (обычное, активно, запрещено). NORMAL (по умолчанию), ACTIVE или DISABLED.

takefocus
Возможность участия поля ввода в обходе с помощью клавиши Tab. ON или OFF.

textvariable
Имеет тот же смысл, что и у кнопок (см. выше соответствующий раздел).

width
Размер поля ввода в символах (по умолчанию - 20).

xscrollcommand
Это свойство устанавливается к методу "set" связанного элемента управления, предназначенного для прокрутки текста (см. пример ниже), что обеспечивает автоматические появление ползунка, когда текста становится достаточно много.

Пример поля ввода с горизонтальной прокруткой текста:

#!/usr/bin/python
# -*- coding: utf-8 -*-
from Tkinter import *

# обработчик события прокрутки
def f(event, *L): # принимает два или три аргумента
    if event == 'scroll': # только в этом случае есть третий аргумент
        direction = L[0] # направление (1 или -1)
        discontinuity = L[1] # дискретность (units или pages)
        ent.xview_scroll(direction, discontinuity)
    elif event == 'moveto':
        direction = L[0] # степень частичной прокрутки (от 0 до 1)
        ent.xview_moveto(direction)

root = Tk()
scr = Scrollbar(root, orient = HORIZONTAL, command = f)
ent = Entry(root, font = 'Arial 20', xscrollcommand = scr.set)
ent.pack(fill=X)
scr.pack(fill=X)
root.mainloop()

Несколько небольших примеров работы с окнами Tk и Toplevel.

Задание монохромной иконки окна в формате .xbm, под Linux:

#!/usr/bin/python
# -*- coding: utf-8 -*-
from Tkinter import *
win = Tk()
win.iconbitmap('@/some/path/kde2.xbm')
win.mainloop()

Примечание: под Windows поддерживаются цветные иконки в формате .ico, знак "@" в начале строки пути не нужен.

Пример запрета закрытия окна:

#!/usr/bin/python
# -*- coding: utf-8 -*-
from Tkinter import *
root = Tk()
Button(root, text = u'Завершение работы', command = root.destroy).pack()
root.protocol('WM_DELETE_WINDOW', lambda: 0) # перехват закрытия окна
root.mainloop()

Использование стандартных (common) диалогов:

#!/usr/bin/python
# -*- coding: utf-8 -*-
from Tkinter import *
from tkMessageBox import *

def b():
    if askyesno(u'Вопрос', u'Нажмите "Да" или "Нет".'):
        showwarning(u'Сообщение', u'Вы нажали "Да."')
    else:
        showwarning(u'Сообщение', u'Вы нажали "Нет."')

root = Tk()
Button(root, text = u'Нажми меня', command = b).pack()
root.mainloop()

Примечание: замечено, что под Linux такие диалоги могут оказаться "не совсем модальными" (что от них ожидается). Когда такой диалог находится на экране, можно передать фокус в главное окно и закрыть его "крестиком", в результате чего приложение может завершиться с ошибками, которые будут выведены на консоль (GNOME), или даже зависнуть (KDE).

Усовершенствование предыдущего примера: все курсоры, которые доступны в Tkinter, можно просмотреть не только в интерактивном режиме, нажатиями на кнопку, но и выбором из списка.

#!/usr/bin/python
# -*- coding: utf-8 -*-

from Tkinter import *

class GUI():
    
    def __init__(self):
        self.Cursors = str(" arrow, man, based_arrow_down, middlebutton, based_arrow_up, mouse, boat, pencil, bogosity, pirate, bottom_left_corner, plus, bottom_right_corner, question_arrow, bottom_side, right_ptr, bottom_tee, right_side, box_spiral, right_tee, center_ptr, rightbutton, circle, rtl_logo, clock, sailboat, coffee_mug, sb_down_arrow, cross, sb_h_double_arrow, cross_reverse, sb_left_arrow, crosshair, sb_right_arrow, diamond_cross, sb_up_arrow, dot, sb_v_double_arrow, dotbox, shuttle, double_arrow, sizing, draft_large, spider, draft_small, spraycan, draped_box, star, exchange, target, fleur, tcross, gobbler, top_left_arrow, gumby, top_left_corner, hand1, top_right_corner, hand2, top_side, heart, top_tee, icon, trek, iron_cross, ul_angle, left_ptr, umbrella, left_side, ur_angle, left_tee, watch, leftbutton, xterm, ll_angle, X_cursor, lr_angle").split(",")
        self.MainWindow = Tk()
        self.MainWindow.resizable(width=None, height=None)
        self.MainFrame = Frame(self.MainWindow, bd=5)
        self.MainLabel = Label(self.MainWindow, text=u"Демонстрация курсоров,\nдоступных в стандартной\nпоставке библиотеки\nTkinter", bd=5)
        self.MainLabel.pack()
        self.FromList = Button(self.MainFrame, text = u"Из списка", command=self.using_list)
        self.UsingButton = Button(self.MainFrame, text = u"Нажатием", command=self.using_button)
        self.MainFrame.pack()
        self.FromList.pack()
        self.UsingButton.pack()
        self.MainWindow.mainloop()
        
    def using_button(self):
        self.MainFrame.destroy()
        self.counter = 0
        self.CursorButton = Button(self.MainWindow, text=u"Сменить курсор", command=self.change_cursor_using_button, width=30)
        self.CursorButton.pack()
    
    def change_cursor_using_button(self):
        try:
            self.CursorButton["text"] = self.Cursors[self.counter]
            self.MainWindow["cursor"] = self.Cursors[self.counter]
            self.counter = self.counter+1
        except IndexError:
            self.MainWindow["cursor"] = ""
            self.CursorButton["text"] = u"Вы просмотрели все курсоры"
    
    def using_list(self):
        self.MainFrame.destroy()
        self.ListScrollbar = Scrollbar(self.MainWindow)
        self.ListBox = Listbox(self.MainWindow, bd=5, yscrollcommand=self.ListScrollbar.set)
        self.ShowButton = Button(self.MainWindow, text=u"Показать курсор", width=self.ListBox["width"], command=self.change_cursor_using_list)
        for number in xrange(len(self.Cursors)):
            self.ListBox.insert(number, self.Cursors[number])
        self.ListScrollbar.pack(side = "right", fill="y")
        self.ListScrollbar.config(command = self.ListBox.yview)
        self.ListBox.pack()
        self.ShowButton.pack(side="bottom")
            
    def change_cursor_using_list(self):
        Selected = self.ListBox.curselection()
        try:
            self.MainWindow["cursor"] = self.Cursors[int(Selected[0])]
        except IndexError:
            pass

GUI()

Автор примера — diam123.