Содержание
Краткая памятка по созданию графического редактора на Python
- Установите библиотеку PySimpleGUI через pip.
- Импортируйте библиотеку в свой Python-скрипт.
- Определите макет интерфейса с помощью списков и кортежей.
- Создайте окно приложения с помощью функции Window.
- Добавьте виджеты: кнопки, текстовые поля, выпадающие списки.
- Настройте обработчики событий для каждого виджета.
- Реализуйте логику рисования с помощью элемента Graph.
- Добавьте возможность выбора цвета и толщины кисти.
- Реализуйте функции сохранения и загрузки изображений.
- Протестируйте приложение на различных сценариях использования.
- Упакуйте готовое приложение в EXE-файл с помощью PyInstaller.
- Документируйте код для дальнейшего развития проекта.
Что для этого нужно
Для установки PySimpleGUI в командной строке компьютера или среды разработки пишем такую команду:
После этого библиотеку сразу можно подключать и использовать в проектах командой import PySimpleGUI. Но чтобы не писать каждый раз в коде такое громоздкое название, ей можно задать другое имя при подключении, например:
Библиотека PySimpleGUI — простой интерфейс для Python
На самом деле у Python есть много библиотек, которые позволяют создать графический интерфейс — Tkinter, Qt, Remi или WxPython. Но проблема в том, что каждую из них нужно осваивать отдельно. Например, в одной удобно создавать графики, но неудобно — кнопки и надписи.
Чтобы сделать создание интерфейсов проще, придумали PySimpleGUI. Идея в том, чтобы объединить лучшие идеи из каждой библиотеки и написать для них внешнюю обёртку.
В итоге программисту на Python достаточно взять уже готовую команду создания кнопки, а отрисовку и внешний вид программа возьмёт на себя.
Ещё PySimpleGUI — это кросс-платформенное решение. Это значит, что интерфейсы, созданные с помощью этой библиотеки, будут работать одинаково на разных операционных системах.
Создаём простой интерфейс
Сегодня мы посмотрим, как всё работает, и сделаем маленькую программу. Как разберёмся — возьмём проекты помасштабнее.
В редакторе кода создаём новый Python-файл и пишем такой код — в нём мы создаём простое окно с кнопкой и текстом:
import PySimpleGUI as sg import random layout = [[(‘Новое число’,enable_events=True, key=’-FUNCTION-‘, font=’Helvetica 16’)], [(‘Результат:’, size=(25, 1), key=’-text-‘, font=’Helvetica 16’)]] window = (‘Генератор случайных чисел’, layout, size=(350,100)) while True: event, values = () if event in (sg.WIN_CLOSED, ‘Exit’): break ()
Мы только что создали простой графический интерфейс, указав только три параметра: размер окна, кнопку и текстовое поле. Так как мы не задавали дополнительных параметров, библиотека сама разместила элементы внутри окна. Ещё у нас не прописана внутренняя логика, поэтому при нажатии на кнопку ничего не произойдёт. Исправим это и привяжем нажатие кнопки к появлению нового случайного числа.
Создание своего первого графического интерфейса
Для начала, следует импортировать Tkinter и создать окно, в котором мы зададим его название:
Результат будет выглядеть следующим образом: Прекрасно! Наше приложение работает. Последняя строка вызывает функцию mainloop. Эта функция вызывает бесконечный цикл окна, поэтому окно будет ждать любого взаимодействия с пользователем, пока не будет закрыто.
В случае, если вы забудете вызвать функцию mainloop, для пользователя ничего не отобразится.
Создание виджета Label
Чтобы добавить текст в наш предыдущий пример, мы создадим lbl, с помощью класса Label, например:
Затем мы установим позицию в окне с помощью функции grid и укажем ее следующим образом:
И вот как будет выглядеть результат: Если функция grid не будет вызвана, текст не будет отображаться.
Настройка размера и шрифта текста
Вы можете задать шрифт текста и размер. Также можно изменить стиль шрифта. Для этого передайте параметр font таким образом:
Обратите внимание, что параметр font может быть передан любому виджету, для того, чтобы поменять его шрифт, он применяется не только к Label.
Отлично, но стандартное окно слишком мало. Как насчет настройки размера окна?
Настройка размеров окна приложения
Мы можем установить размер окна по умолчанию, используя функцию geometry следующим образом:
В приведенной выше строке устанавливается окно шириной до 400 пикселей и высотой до 250 пикселей.
Попробуем добавить больше виджетов GUI, например, кнопки и посмотреть, как обрабатывается нажатие кнопок.
Добавление виджета Button
Начнем с добавления кнопки в окно. Кнопка создается и добавляется в окно так же, как и метка:
Результат будет следующим: Обратите внимание, что мы помещаем кнопку во второй столбец окна, что равно 1. Если вы забудете и поместите кнопку в том же столбце, который равен 0, он покажет только кнопку.
Изменение цвета текста и фона у Button
Вы можете поменять цвет текста кнопки или любого другого виджета, используя свойство fg. Кроме того, вы можете поменять цвет фона любого виджета, используя свойство bg.
Теперь, если вы попытаетесь щелкнуть по кнопке, ничего не произойдет, потому что событие нажатия кнопки еще не написано.
Кнопка Click
Для начала, мы запишем функцию, которую нужно выполнить при нажатии кнопки:
Обратите внимание: мы пишем clicked, а не clicked()с круглыми скобками. Теперь полный код будет выглядеть так:
При нажатии на кнопку, результат, как и ожидалось, будет выглядеть следующим образом: Круто!
Получение ввода с использованием класса Entry (текстовое поле Tkinter)
В предыдущих примерах GUI Python мы ознакомились со способами добавления простых виджетов, а теперь попробуем получить пользовательский ввод, используя класс Tkinter Entry (текстовое поле Tkinter). Вы можете создать текстовое поле с помощью класса Tkinter Entry следующим образом:
Затем вы можете добавить его в окно, используя функцию grid. Наше окно будет выглядеть так:
Полученный результат будет выглядеть так: Теперь, если вы нажмете кнопку, она покажет то же самое старое сообщение, но что же будет с отображением введенного текста в виджет Entry?
Во-первых, вы можете получить текст ввода, используя функцию get. Мы можем записать код для выбранной функции таким образом:
Если вы нажмете на кнопку — появится текст «Привет» вместе с введенным текстом в виджете записи. Вот полный код:
Запустите вышеуказанный код и проверьте результат: Прекрасно!
Каждый раз, когда мы запускаем код, нам нужно нажать на виджет ввода, чтобы настроить фокус на ввод текста, но как насчет автоматической настройки фокуса?
Установка фокуса виджета ввода
Здесь все очень просто, ведь все, что нам нужно сделать, — это вызвать функцию focus:
Когда вы запустите свой код, вы заметите, что виджет ввода в фокусе, который дает возможность сразу написать текст.
Добавление виджета Combobox
Как видите с примера, мы добавляем элементы combobox, используя значения tuple. Чтобы установить выбранный элемент, вы можете передать индекс нужного элемента текущей функции. Чтобы получить элемент select, вы можете использовать функцию get вот таким образом:
Установка состояния Checkbutton
Здесь мы создаем переменную типа BooleanVar, которая не является стандартной переменной Python, это переменная Tkinter, затем передаем ее классу Checkbutton, чтобы установить состояние чекбокса как True в приведенном выше примере.
Вы можете установить для BooleanVar значение false, что бы чекбокс не был отмечен. Так же, используйте IntVar вместо BooleanVar и установите значения 0 и 1.
Добавление виджетов Radio Button
Обратите внимание, что вы должны установить value для каждой radio кнопки с уникальным значением, иначе они не будут работать.
Результатом вышеприведенного кода будет следующий: Кроме того, вы можете задать command любой из этих кнопок для определенной функции. Если пользователь нажимает на такую кнопку, она запустит код функции. Вот пример:
Получение значения Radio Button (Избранная Radio Button)
Чтобы получить текущую выбранную radio кнопку или ее значение, вы можете передать параметр переменной и получить его значение.
Показ сообщений о предупреждениях и ошибках
Вы можете показать предупреждающее сообщение или сообщение об ошибке таким же образом. Единственное, что нужно изменить—это функция сообщения.
Показ диалоговых окон с выбором варианта
Чтобы показать пользователю сообщение “да/нет”, вы можете использовать одну из следующих функций messagebox:
Вы можете выбрать соответствующий стиль сообщения согласно вашим потребностям. Просто замените строку функции showinfo на одну из предыдущих и запустите скрипт. Кроме того, можно проверить, какая кнопка нажата, используя переменную результата.
Если вы кликнете OK, yes или retry, значение станет True, а если выберете no или cancel, значение будет False. Единственной функцией, которая возвращает одно из трех значений, является функция askyesnocancel; она возвращает True/False/None.
Добавление SpinBox (Виджет спинбокс)
Таким образом, мы создаем виджет Spinbox, и передаем параметры from и to, чтобы указать диапазон номеров. Кроме того, вы можете указать ширину виджета с помощью параметра width:
Вы можете указать числа для Spinbox, вместо использования всего диапазона следующим образом:
Добавление виджета Progressbar
Вы можете установить это значение на основе любого процесса или при выполнении задачи.
Изменение цвета Progressbar
Изменение цвета Progressbar немного сложно. Сначала нужно создать стиль и задать цвет фона, а затем настроить созданный стиль на Progressbar. Посмотрите следующий пример:
Добавление поля загрузки файла
Сначала мы создаем меню, затем добавляем наш первый пункт подменю. Вы можете добавлять пункты меню в любое меню с помощью функции add_cascade() таким образом:
Теперь мы добавляем еще один пункт меню “Изменить” с разделителем меню. Вы можете заметить пунктирную линию в начале, если вы нажмете на эту строку, она отобразит пункты меню в небольшом отдельном окне.
Просто отредактируйте new_item, как в приведенном выше примере и он больше не будет отображать пунктирную линию. Вы так же можете ввести любой код, который работает, при нажатии пользователем на любой элемент меню, задавая свойство команды.
Указание типа файлов (расширение фильтра файлов)
Возможность указания типа файлов доступна при использовании параметра filetypes, однако при этом важно указать расширение в tuples.
Вы можете указать начальную директорию для диалогового окна файла, указав initialdir следующим образом:
Добавление панели меню
После создания вкладок вы можете поместить виджеты внутри этих вкладок, назначив родительское свойство нужной вкладке.
Добавление виджета Notebook (Управление вкладкой)
Таким образом, вы можете добавлять столько вкладок, сколько нужно.
Добавление виджетов на вкладку
Вы можете добавить отступы для элементов управления, чтобы они выглядели хорошо организованными с использованием свойств padx иpady.
В этом уроке мы увидели много примеров GUI Python с использованием библиотеки Tkinter. Так же рассмотрели основные аспекты разработки графического интерфейса Python. Не стоит на этом останавливаться. Нет учебника или книги, которая может охватывать все детали. Надеюсь, эти примеры были полезными для вас.
Выдаём случайные числа
Это значит, что при нажатии на кнопку окно отправит внутреннее системное сообщение с текстом -FUNCTION-. Если мы привяжем свою функцию к этому сообщению, то она будет выполняться при каждом нажатии кнопки.
Чтобы связать функцию с сообщением от окна, добавим в конец основного цикла такую проверку:
Теперь у нас есть привязанная функция update (), но в коде её ещё нет. Исправим это и добавим новую функцию сразу после команд импорта:
def update(): r = (1,100) text_elem = window[‘-text-‘] text_elem.update(«Результат: {}».format(r))
При нажатии на кнопку скрипт обработает системное сообщение и начнёт выполнять эту функцию: создаст новое случайное число и отправит его в текстовое поле.
import PySimpleGUI as sg import random def update(): r = (1,100) text_elem = window[‘-text-‘] text_elem.update(«Результат: {}».format(r)) layout = [[(‘Новое число’,enable_events=True, key=’-FUNCTION-‘, font=’Helvetica 16’)], [(‘Результат:’, size=(25, 1), key=’-text-‘, font=’Helvetica 16’)]] window = (‘Генератор случайных чисел’, layout, size=(350,100)) while True: event, values = () if event in (sg.WIN_CLOSED, ‘Exit’): break if event == ‘-FUNCTION-‘: update() ()
Что дальше
Мы сделали самый простой интерфейс и посмотрели, как можно связать внутреннюю логику и кнопки. В следующий раз используем это для более серьёзных проектов — нарисуем им свой интерфейс и научимся менять его внешний вид.
Как в PySimpleGUI обрабатывать ввод данных из текстового поля?
Создайте текстовое поле с уникальным ключом, например (key=’-INPUT-‘). Когда пользователь введёт текст и нажмёт кнопку, прочитайте значение через словарь values в основном цикле: user_text = values[‘-INPUT-‘].
После этого можете использовать введённый текст как обычную переменную — передать в функцию, сохранить в файл или вывести в другой элемент интерфейса. Главное — не забудьте присвоить каждому элементу свой уникальный ключ, чтобы потом к нему обратиться.
Можно ли упаковать программу на PySimpleGUI в исполняемый EXE-файл?
Да, для этого используйте утилиту PyInstaller. Установите её командой pip install pyinstaller, затем в терминале перейдите в папку с вашим скриптом и выполните pyinstaller –onefile –windowed имя_файла.py. Параметр –onefile упакует всё в один EXE-файл, а –windowed скроет консольное окно, оставив только графический интерфейс.
Готовый файл появится в папке dist — его можно запускать на любом windows-компьютере без установки Python. Для Linux и macOS процесс аналогичный, только на выходе получится исполняемый файл под соответствующую систему.
Как изменить тему оформления (скин) окна в PySimpleGUI?
Когда выберете, просто укажите название в коде, и все элементы интерфейса автоматически перекрасятся в новые цвета.
Как создать многооконное приложение?
Создайте несколько объектов окон, например window1 и window2, но не запускайте для них разные циклы. В PySimpleGUI используется единый цикл событий для всех окон сразу. Вместо обычного () используйте специальную функцию read_all_windows:
while True: window, event, values = sg.read_all_windows() if window is None and event == sg.WIN_CLOSED: break if window == window1 and event == ‘Ok’: print(‘Нажали кнопку в первом окне’) if window == window2 and event == ‘Exit’: ()
Функция read_all_windows() сама определяет, в каком окне произошло действие, и возвращает ссылку на него в переменной window. Это самый эффективный способ, который не нагружает процессор лишними проверками.
Где найти полный список всех элементов (виджетов) PySimpleGUI и их параметров?
Полная документация находится на официальном сайте PySimpleGUI по адресу. Там описаны все элементы: кнопки, текстовые поля, слайдеры, графики, таблицы, вкладки и многое другое. Для каждого виджета перечислены доступные параметры, примеры использования и скриншоты результата.
Ещё на GitHub в репозитории PySimpleGUI есть папка DemoPrograms с готовыми примерами программ — можно скачать их, запустить и посмотреть, как реализованы разные элементы интерфейса.
Эта библиотека бесплатная?
- Для коммерческой разработки лицензия платная (99 $).
- Для обучения и хобби лицензия условно-бесплатная на 30 дней, и нужна обязательная регистрация. Без этого окно программы не откроется.
Если вы не хотите регистрироваться и покупать лицензионные ключи, сообщество создало полный бесплатный аналог под названием FreeSimpleGUI. Он работает абсолютно так же, как старая добрая версия из нашей статьи.
Чтобы его использовать, установите pip install FreeSimpleGUI. Затем в коде скрипта замените строку import PySimpleGUI as sg на import FreeSimpleGUI as sg.
Часто задаваемые вопросы по созданию графического редактора на Python
Вопрос: Какая библиотека лучше всего подходит для создания графического редактора на Python?
Ответ: Для простых редакторов отлично подходит PySimpleGUI, для более сложных — Tkinter или PyQt.
Вопрос: Можно ли создать графический редактор на Python без использования сторонних библиотек?
Ответ: Да, можно использовать встроенную библиотеку Tkinter, но функционал будет ограничен.
Вопрос: Как добавить возможность рисования в графическом редакторе на PySimpleGUI?
Ответ: Используйте элемент Graph для создания холста и обработки событий мыши.
Вопрос: Сложно ли научиться создавать GUI на Python новичку?
Ответ: PySimpleGUI специально создан для новичков и имеет очень простой синтаксис.
Вопрос: Как сохранить изображение, созданное в графическом редакторе на Python?
Ответ: Используйте библиотеку PIL (Pillow) для сохранения холста в файл.
Вопрос: Поддерживает ли PySimpleGUI работу с изображениями?
Ответ: Да, библиотека поддерживает отображение и базовую обработку изображений.
Вопрос: Можно ли создать многооконный графический редактор на PySimpleGUI?
Ответ: Да, библиотека поддерживает создание многооконных приложений.
Вопрос: Как обрабатывать нажатия клавиш в графическом редакторе?
Ответ: Используйте параметр key для привязки событий клавиатуры к элементам интерфейса.
Вопрос: Какие форматы файлов поддерживает PySimpleGUI для загрузки изображений?
Ответ: PySimpleGUI поддерживает PNG, JPG, GIF и другие популярные форматы.
Вопрос: Есть ли готовые шаблоны графических редакторов на PySimpleGUI?
Ответ: Да, в официальной документации и на GitHub есть примеры простых редакторов.
