Python 3 и PyQt 6 PDF
Загружено:
Буянжаргал ЭрдэнэбатPython 3 и PyQt 6 PDF
Загружено:
Буянжаргал ЭрдэнэбатНиколай Прохоренок
Владимир Дронов
Python 3
и PyQt &
Разработка
nриnожений
Санкт-Петербург
« БХВ-Петербург»
2023
УДК 004.43
ББК 32.973.26-018.1
П84
Прохоренок, Н. А.
П84 Python 3 и PyQt 6. Разработка приложений/ Н. А. Прохоренок,
В. А. Дронов. - СПб.: Б:ХВ-Петербурr, 2023. - 832 с.: ил. -
(Профессиональное программирование)
ISBN 978-5-9775-1706-5
Описан язык Python 3: типы данных, операторы, условия ветвления и выбора,
циклы, регулярные выражения, функции, классы, работа с файлами и каталогами,
взаимодействие с механизмами Windows, часто используемые модули стандартной
библиотеки. Особое внимание уделено библиотеке PyQt, позволяющей создавать
приложения с графическим интерфейсом. Описаны средства для создания и выво
да окон, основных компонентов (кнопок, полей, списков, таблиц, меню, панелей
инструментов и др.). Р!iССмотрена обработка событий и сигналов, разработка мно
гопоточных программ, работа с базами данных, вывод графики, воспроизведение
мультимедиа, запись аудио, видео и фото, печать документов, экспорт их в формат
Adobe PDF и сохранения настроек программ. Дан пример полнофункционального
приложения для создания и решения головоломок судоку. На сайте издательства
размещен электронный архив со всеми примерами из книги.
Для программистов
УДК 004.43
ББК 32.973.26-018.1
Группа подготовки изд!Ц{Ия:
Руководитель проекта Евгений Рыбаков
Зав.редакцией Людмwю Гауль
Редактор Григорий Добин
Компьютерная верстка Ольги Сергиенко
Дизайн серии Марины Дамбиевой
Оформление обложки Зои Канторович
Подписано в печать 01.07.22.
Формат 70х100 1 /,6. Печать офсетная. Усл. печ. л. 67,08.
Тираж 1300 экз. Заказ № 4691.
"БХВ-Петербурr", 191036, Санкт-Петербург, Гончарная ул., 20.
Отпечатано с готового оригинал-макета
ООО "Принт-М", 142300, М.О., г. Чехов, ул. Полиграфистов, д. 1
ISBN 978-5-9775-1706-5 1!:> ООО "БХВ", 2023
11:) Оформление. ООО "БХВ-Петербург", 2023
Оглавление
Предисловие ................................................................................................................... 15
Python ..............................................................................................................................................15
PyQt .................................................................................................................................................. 16
Использованное ПО.......................................................................................................................16
Типографские соглашения ............................................................................................................16
ЧАСТЬ 1. ОСНОВЫ ЯЗЫКА PYTHON.................................................................... 19
Глава 1. Первые шаги .................................................................................................. 21
1.1. Установка Python ....................................................................................................................21
1.2. Интерактивный режим Python. Утилита IDLE ..................................................................... 24
1.3. Введение в Руthоn-программирование ................................................................................. 25
1.4..Принципы написания Руthоn-программ ............................................................................... 27
1.4.1. Комментарии и строки документирования ................................................................ 30
1.4.2. Кодировки, поддерживаемые Python .......................................................................... 31
1.4.3. Подготовка Руthоn-программ для выполнения в UNIX ............................................ 31
1.5. Дополнительные возможности IDLE ...........................................................................,.........32
1.6. Вывод даmп,�х .........................................................................................................................33
1.7. Ввод даmп,rх ............................................................................................................................35
1.8. Утилита pip: установка дополнительнь�х библиотек ...........................................................37
1.9. Доступ к документации ..........................................................................................................42
1.1О. Компиляция Руthоn-файлов .................................................................................................44
Глава 2. Переменные и типы данных ....................................................................... 46
2.1. Перемеmп,rе .............................................................................................................................46
2.2. Типы даmп,�х. Понятие объекта и ссьmки ............................................................................ 47
2.3. Присваивание значений перемеmп,rм ................................................................................... 50
2.4: Проверка типа даmп,�х............................................................................................................52
2.5. Преобразование типов даннь�х ..............................................................................................53
2.6. Удаление переменных ............................................................................................................56
Глава 3. Операторы .................................................................................................·..... 57
3.1. Математические операторы ................................................................................................... 57
3.2. Двоичные операторы .............................................................................................................. 59
4 Оглавление
3.3. Операторы для работы с последовательностями ................................................................. 60
3.4. Операторы присваивания....................................................................................................... 61
3.5. Пустой оператор ...................................................................................................................... 63
3.6. Приоритет операторов ........................................................................................................... 63
Глава 4. Инструкции ветвления, выбора и циклы ................................................ 65
4.1. Операторы сравнения ............................................................................................................. 66
4.2. Инструкция ветвления ............................................................................................................ 68
4.3. Инструкция выбора ............................................................. :.................................................. 71
4.4. Цикл перебора последовательности.................................................., ................................... 77
4.5. Цикл с условием ..................................................................................................................... 78
4.6. Оператор continue: переход на следующую итерацюо цикла ............................................. 79
4.7. Оператор break: прерывание цикла......................'................................................................. 79
4.8. Оператор присваивания в составе инструкции .................................................................... 80
Глава 5. Числа ................................................................................................................ 82
5.1. Запись чисел ............................................................................................................................ 82
5.2. Обработка чисел ..................................................................................................................... 84
5.3. Математические функции ...................................................................................................... 87
5.4. Генерирование случайных чисел........................................................................................... 89
Глава 6. Строки и двоичные данные ........................................................................ 92
6.1. Создание строк........................................................................................................................ 92
6.1.1. Специальные символы .................................................................................................94
6.1.2. Необрабатываемые строки .......................................................................................... 95
6.2. Операции над строками.......................................................................................................... 96
6.3. Форматирование строк ............................................................................... : ............:..............98
6.4. MeтoдformatO ....................................................................................................................... 104
6.4.1. Форматируемые строки ..............................................................................................108
6.5. Функции и методы для работы со строками ...................................................................... 109
6.6. Настройка локали .................................................................................................................112
6.7. Изменение регистра символов..................................... .........................................................113
6.8. Функции для работы с символами ...................................................................................... 114
6.9. Поиск и замена в строке .......................................................................................................114
6.1О. Проверка содержимого строки .......................................................................................... 118
6.11. Двоичные данные типа bytes.............................................................................................. 121
6.12. Двоичные данные типа bytearray ...................................................................................... 125
6.13. Сериализация и десериализация значений .............................................................. :........ 128
6.14. Хеширование значений ...................................................................................................... 129
Глава 7. Регулярные выражения ............................................................................. 131
7.1. Синтаксис регулярных выражений ..................................................................................... 131
7.2. Поиск первого совпадения с шаблоном...............................................................................140
7.3. Поиск всех совпадений с шаблоном ...................................................................................145
7.4. Замена в строке .............................................................................................................•....... 146
7.5. Прочие функции и методы ................................................................................................... 148
Глава 8. Списки., кортежи, множества и диапазоны ............................................ 150
8.1. Создание списков .................................................................................................................. 150
8.2. Операции над списками ............................................................,.......................................... 152
Оглавление 5
8.3. Многомерные списки ...........................................................................................................155
8.4. Перебор списков ...................................................................................................................155
8.5. Генераторы списков и выражения-генераторы ..................................................................156
8.6. Функции тарО, zipO,filterO и reduceO ............................................................................... 158
8.7. Добавление и удаление элементов списка..........................................................................161
8.8. Поиск элемента в списке и получение сведений об элементах списка ............................163
8.9. Переворачивание и перемешивание списка .......................................................................164
8.10. Выбор элементов списка случайным образом ................................... ,.............................165
8.11. Сортировка списка..............................................................................................................166
8.12. Заполнение списка числами...............................................................................................168
8.13. Преобразование списка в строку ............................................, .......................................... 168
8.14. Кортежи ............................................................................................................................... 169
8.15. Множества, изменяемые и неизменяемые ........................................................................ 170
8.16. Диапазоны ..................................: ........................................................................................175
8.17. Модуль itertoo/s...................................................................................................................177
8.17.1. Генерирование неопределенного количества значений ...................................... 177
8.17.2. Генерирование комбинаций значений ..................................................................178
8.17.3. Фильтрация элементов последовательности ........................................................180
8.17.4. Прочие функции ......................................................................................................181
Глава 9. Словари ......................................................................................................... 185
9.1. Создание словаря ..................................................................................................................185
9.2. Операции над словарями......................................................................................................187
9.3. Перебор элементов словаря ................................................................................................. 189
9.4. Методы и функции для работы со словарями ....................................................................190
9.5. Генераторы словарей............................................................................................................193
Глава 10. Работа с датой и временем....................................................................... 194
10.1. Получение текущих даты и времени ................................................................................. 194
10.2. Форматирование даты и времени ......................................................................................196
10.3. Приостановка выполнения программы ............................................................................198
10.4. Значения даты и времени ...................................................................................................198
10.4.1. Временнь1е промежутки .........................................................................................198
10.4.2. Значения даты .........................................................................................................201
10.4.3. Значения времени ...................................................................................................204
10.4.4. Временнь1е отметки................................................................................................207
10.5. Вывод календаря .................................................................................................................213
10.5.1. Вывод календаря в текстовом виде .................:..................................................... 213
10.5.2. Вывод календаря в формате НТМL ......................................................................215
10.5.3. Другие полезные функции ......................................................................................217
10.6. Измерение времени выполнения фрагментов кода ......................................................... 220
Глава 11. Функцнн ...................................................................................................... 222
11.1. Определение и вызов функции ..........................................................................................222
11.1.1. Расположение определений функций ...................................................................224
11.1.2. Локальные и глобальные переменные ..................................................................225
11.1.3. Позиционные и именованные параметры ............................................................228
11.1.4. Необязательные параметры ...................................................................................230
б Оглавление
11.1.5. Произвольное количество параметров .................................................................. 231
11.1.6. Распаковка последовательностей и отображений ...............................................233
11.6.7. Функция как значение. Функции обратного вызова............................................ 233
11.2. Анонимные функции .......................................................................................................... 234
11.3. Функции-генераторы .......................................................................................................... 236
11.4. Декораторы функций.......................................................................................................... 237
11.5. Рекурсия .............................................................................................................................. 239
11.6. Вложенные функции ..........................................................:............................................... 240
11.7. Аннотации функций ........................................................................................................... 242
Глава 12. Модули, пакеты и импорт ....................................................................... 243
12.1. Импорт модуля целиком .................................................................................................... 243
12.2. Импорт отдельных идентификаторов ............................................................................... 246
12.2.1. Указание идентификаторов, доступных для импорта ......................................... 248
12.2.2. Управление доступом к идентификаторам........................................................... 248
12.3. Пути поиска модулей .........................................................................................................249
12.4. Перезагрузка модулей ........................................................................................................ 251
12.5. Пакеты ................................................................................................................................. 252
Глава 13. Объекты и классы ..................................................................................... 256
13.1. Определение классов, создание объектов и работа с ними.............................................256
13.2. 'Атрибуты класса ................................................................................................................. 259
13.3. Конструкторы и деструкторы ............................................................................................260
13.4. Наследование ...................................................................................................................... 261
13.4.1. Множественное наследование ............................................................................... 263
13.4.1.1. Примеси и их использование .................................................................. 265
13.5. Сп!;:циальные методы.......................................................................................................... 266
13.6. Перегрузка операторов....................................................................................................... 269
13.7. Статические методы и методы класса .............................................................................. 271
13.8. Абстрактные методы .......................................................................................................... 272
13.9. Закрытые атрибуты и методы ............................................................................................273
13.10. Свойства ............................................................................................................................ 274
13.11. Декораторы классов ......................................................................................................... 276
Глава 14. Исключения и их обработка.................................................................... 278
14.1. Обработчики исюпочений ......................................................................................... ; ........ 279
14.2. Обработчики контекстов .................................................................................................... 283
14.3. Классы встроенных исюпочений·....................................................................................... 285
14.4. Генерирование исюпочений............................................................................................... 287
14.5. Пользовательские исюпочения .......................................................................................... 289
14.6. Проверочная инструкция ...................................................................................................290
Глава 15. Итераторы, контейнеры и перечисления ...;......................................... 292
15.1. Итераторы ........................................................................................................................... 292
15.2. Контейнеры ......................................................................................................................... 293
15.2.1, Контейнеры-последовательности..........................................................................293
15.2.2. Контейнеры-отображения ...................................................................................... 295
15.3. Перечисления ...................................................................................................................... 296
Оглавление 7
Глава 16. Работа с файлами и каталогами .................................................. ............ 302
16.1. Открытие файлов ................................................................................................................302
16.1.1. Указание путей к файлам и каталогам..................................................................305
16.1.2. Текущий рабочий каталог......................................................................................306
16.2. Чтение и запись данных: объектные инструменты ..........................................................307
16.3. Чтение и запись данных: низкоуровневые инструменты ................................................313
16.4. Файлы в памяти ............................................................•.....................................................315
16.5. Задание прав доступа к файлам и каталогам ....................................................................319
16.6.Работа с файлами ................................................................................................................321
16.7.Работа с путями...................................................................................................................325
16.8. Перенаправление ввода/вывода.........................................................................................326
16.9. Сохранение объектов в файлах..........................................................................................328
16.10.Работа с каталогами ..........................................................................................................331
16.10.1. Функция scandirO .................................................................................................335
16.11. Искточения, генерируемые файловыми операциями ...................................................337
Глава 17. Работа с механизмами Windows ............................................................. 338
17.1.Работа с реестром ...............................................................................................................338
17.1.1. Открытие и закрытие ветвей реестра....................................................................339
17.1.2. Чтение и запись данных реестра ...........................................................................340
17.1.3. Перебор элементов и вложенных ветвей реестра ................................................343
17.2. Получение путе� к системным каталогам ........................................................................344
17.3. Создание ярлыков ........................................................................................................... : ...345
ЧАСТЬ 11. БИБЛИОТЕКА PYQT 6 ......................................................................... 347
Глава 18. Введение в PyQt 6 ...................................................................................... 349
18.1. УстановкаРуQt6 ................................................................................................................349
18.2. Первая оконная программа ................................................................................................349
18.3. СтруктураРуQt-программы ...............................................................................................350
18.4. ООП-стиль создания окна ..................................................................................................352
18.5. Создание окон с помощью программы QtDesigner ........................................................356
18.5.1. Создание окон .........................................................................................................356
18.5.2. Использование UI-файла в программе .................................................................359
18.5.3. Преобразование Ш-файла в модуль Python ............,............................................361
18.6. Модули PyQt6 ....................................................................................................................362
18.7. Управление циклом обработки событий ..........................................................................363
18.8. Многопоточные программы ..............................................................................................365
18.8.1. Потоки .....................................................................................................................365
18.8.2. Управление потоками ............................................................................................368
18.8.3. Очереди ...................................................................................................................372
18.8.4. Блокировщики и автоблокировщики ....................................................................376
18.9. Вывод заставки .......................................... :........................................................................379
Глава 19. Окна ............................................................................................................. 382
19.1. Создание и вывод окон.......................................................................................................382
19.1.1. Типы окон ...............................................................................................................383
19.2.Размеры окон и управление ими .......................................................................................384
в Оглавление
19.3. Местоположение окна и управление им ................................................ :.......................... 387
19.4. Классы, задающие координаты и размеры ....................................................................... 390
19.4.1. Класс QPoint: координаты точки .......................................................................... 390
19.4.2. Класс QSize: размеры прямоугольной области ....................................................391
19.4.3. Класс QRect: координаты и размеры прямоугольной области ........................... 393
19.5. Разворачивание и сворачивание окон ............................................................................... 399
19.6. Управление прозрачностью о.кна ......................................................................................401
19.7. Модальные окна......................................................................................................... ;........401
19.8. Смена значка окна ........................................................................................................ ,.....403
19.9. Изменение цвета фона окна ...............................................................................................404
19.10. Вывод изображения в качестве фона ..............................................................................405
19.11. Окна произвольной формы ..............................................................................................406
19.12. Всплывающие и расширенные подсказки ......................................................................408
19.13. Программное закрытие окна............................................................................................409
19.14. Использование табшщ стилей CSS для оформления окон.............................................409
Глава 20. Обработка сигналов и событий .............................................................. 414
20.1. Назначение обработчиков сигналов ..................................................................................414
20.1.1. Слоты:..................................................................................................................... .417
20.1.2. Передача данных в обработчик сигнала ...............................................................418
20.2. Блокировка и удаление обработчиков сигналов ..................., ..........................................419
20.3. Генерирование сигналов ............................................................................... ,................... .421
20.4. Пользовательские сигналы ................ : ...............................................................................421
20.5. Использование таймеров .................................................................................................... 423
20.6. Обработка всех событий ................................ :.................................................................. .426
20.7. События окна ............................................................................ :.........................................429
20.7.1. Изменение состояния окна ................................................................................... .429
20.7.2. Изменение местоположения и размеров окна..................................................... .430
20.7.3. Перерисовка окна или его части ...........................................................................431
20.7.4. Предотвращение закрытия окна ............................................................................431
20.8. События клавиатуры ..........................................................................................................432
20.8.1. Управление фокусом ввода ................................................................................... 432
20.8.2. Назначение клавиш быстрого доступа ................................................................ .435
20.8.3. Нажатие и отпускание клавиш ..............................................................................437
20.9. События мыши.................................................................................................................... 439
20.9.1. Нажатие и отпускание кнопок мыши....................................................................439
20.9.2. Перемещение курсора мыши.............................................................................. ,..440
20.9.3. Наведение и увод курсора мыши ..........................................................................441
20.9.4. Прокрутка колесика мыши ....................................................................................441
20.9.5. Изменение курсора мыши......................................................................................442
20.10. Операция перетаскивания (drag & drop) .........................................................................443
20.10.1. Запуск перетаскивания .........................................................................................443
20.10.1.1. Задание перетаскиваемых данных .......................................................445
20.10.2. Обработка перетаскивания и сброса ...................................................................446
20.11. Работа с буфером обмена .................................................................................................448
20.12. Фильтрация событий ........................................................................................................449
20.13. Генерирование событий ...................................................................................................450
20.14. Пользовательские события ..............................................................................................450
Оглавление 9
Глава 21. Размещение компонентов в окнах. Контейнеры ................................ 451
21.1. Абсоmотное позиционирование ........................................................................................451
21.2. Контейнеры-стопки ............................................................................................................452
21.3. Контейнер-сетка..................................................................................................................455
21.4. Контейнер-форма................................................................................................................457
21.5. Стеки ..................................................................................................................... :...............460
21.6. Управление размерами компонентов ................................................................................461
21.7. Группа ..................................................................................................................................462
21.8. Панель с рамкой..................................................................................................................464
21.9. Панель с вкладками ............................................................................................................465
i1.10. Аккордеон .........................................................................................................................469
21.11. Панель с изменяемыми областями..................................................................................471
21.12. Прокручиваемая панель ...................................................................................................473
Глава 22. Основные компоненты ............................................................................ 475
22.1. Надпись................................................................................._............................................... 475
22.2. Кнопка .........................:.......................................................................................................477
22.3. Перекmочатель ....................................................................................................................479
22.4. Флажок ................................................................................................................................480
22.5. Поле ввода ...........................................................................................................................480
22.5.1. Основные методы и сигналы ..................................................................................481
22.5.2. Ввод данных по маске ............................................................................................484
22.5.3. Контроль ввода с помощью валидаторов .............................................................485
22.6. Область редактирования ....................................................................................................486
22.6.1. Основные методы и сигналы .................................................................................486
22.6.2. Задание параметров области редактирования.......... :...........................................488
22.6.3. Указание параметров текста и фона .....................................................................490
22.6.4. Класс QTextDocument ............................................................................................. 491
22.6.5. Класс QTextCursor ... :..............................................................................................494
22. 7. Текстовый ·браузер..............................................................................................................497
22.8. Поля для ввода целых и вещественных чисел..................................................................499
22.9. Поля для ввода даты и времени .......................................................................................... 501
22.10. Календарь .......................................................................................................................... 504
22.11. Семисегментный индикатор ............................................................................................ 506
22.12. Индикатор процесса ......................................................................................................... 507
22.13. Шкала с ползунком ........................................................................................................... 508
22.14. Круговая шкала с ползунк-ом ........................................................................................... 510
22.15. Полоса прокрутки .................................................................... : ........................................ 511
22.16. Веб-браузер .................................................._. ...................................................... .'............. 511
Глава 23. Списки и таблицы ..................................................................................... 516
23.1. Раскрывающийся список.................................................................................................... 516
23.1.1. Добавление, изменение и удаление элементов .................................................... 516
23.1.2. Изменение параметров списка .............................................................................. 517
23.1.3. Поиск элементов..................................................................................................... 518
23.1.4. Сигналы ................................................................................................................... 519
23.2. Список для выбора шрифта ............................................................................................... 519
23.3. Роли элементов ................................................................................................................... 520
10 Оглавление
23.4. Модели................................................................................................................................. 521
23.4.1. Доступ к данным внутри модели ..........................................................................521
23.4.2. Класс QStringListModel .......................................................................................... 523
22.4.3. Класс QStandardltemModel .................................................................................... 524
23.4.4. Класс QStandardltem ..............................................................................................528
23.5. Представления ....................................................................................................................531
23.5.1. Класс QAbstractltemView........................................................................................ 532
23.5.2. Простой список ....................................................................................................... 535
23.5.3. Таблица.................................................................".........................................., ........ 537
23.5.4. Иерархический список ........................................................................................... 539
23.5.5. Управление заголовками строк и столбцов.......................................................... 541
23.6. Управление выделением элементов ..................................................................................544
22.7. Промежуточные модели..................................................................................................... 546
23.8. Использование делегатов ................................................................................................... 547
Глава 24. Работа с базами данных ........................................................................... 551
24.1. Соединение с базой данных .................................................... :··········································551
24.2. Получение сведений о структуре таблиц .......................................................................... 554
24.2.1. Получение сведений о таблицах ............................................................................ 554
24.2.2. Получение сведений о полях таблиц .................................................................... 555
24.2.3. Получение сведений о ключевом индексе................................... �························556
24.2.4. Получение сведений об ошибке ............................................................................ 556
24.3. Выполнение SQL-запросов и получение их результатов ................................................557
24.3.1. Выполнение запросов ............................................................................................ 557
24.3.2. Обработка результатов выполнения запросов ..................................................... 560
24.3.3. Очистка запроса .............................................................................................:........562
24.3.4. Получение служебных сведений о запросе .......................................................... 563
24.4. Модели, связанные с данными .......................................................................................... 563
24.4.1. Модель, связанная с SQL-запросом ...................................................................... 563
24.4.2. Модель, связанная с таблицей .......................................................................•....... 565
24.4.3. Модель, поддерживающая межтабличные связи ................................................. 570
24.4.4. Использование связанных делегатов .................................................................... 573
Глава 25. Работа с графикой ..................................................................................... 575
25.1. Вспомогательные классы ................................................................................................... 575
25.1.1. Класс QColor: цвет ................................................................................................. 575
25.1.2. Класс QPen: перо .................................................................................................... 579
25.1.3. Класс QBrush: кисть ...............................................................................................580
25.1.4.. Класс QLine: линия .............................................. :.................................................. 581
24.1.5. Класс QPolygQn: многоугольник ........................................................................... 582
25.1.6. Класс QFont: шрифт ............................................................................................... 584
25.2. Класс QPainter .................................................................................................................... 586
25.2.1. Рисование линий и фигур ...................................................................................... 587
25.2.2. Вывод текста ........................................................................................................... 589
25.2.3. Вывод изображений ............................................................................................... 590
25.2.4. Преобразование систем координат .......................................................................592
25.2.5. Сохранение команд рисования в файл.................................................................. 593
25.3. Работа с растровыми изображениями ............................................................................... 594
25.3.1. Класс QPixmap ........................................................................................................ 594
25.3.2. Класс QBitmap ........................................................................................ .................
· 597
Оглавление 11
25.3.3. Класс Qlmage ..........................................................................................................598
25.3.4. Класс Qlcon ............................................................................................................. 601
Глава 26. Графическая сцена.................................................................................... 603
26.1. Графическая сцена ..............................................................................................................603
26.1.1. Настройка графической сцены .............................................................................. 603
26.1.2. Добавление и удаление графических объектов ................................................... 604
26.1.3. Добавление компонентов на сцену .......................................................................605
26.1.4. Поиск графических объектов ................................................................................605
26.1.5. Управление фокусом ввода ...................................................................................607
26.1.6. Управление выделением объектов........................................................................607
26.1.7. Прочие методы и сигналы .....................................................................................608
26.2. Графическое представление .................................................................:............................609
26.2.1. Настройка графического представления ..............................................................609
26.2.2. Преобразования между координатами представления и сцены ............:............ 611
26.2.3. Поиск объектов .......................................................................................................612
26.2.4. Преобразование системы координат ....................................................................612
26.2.5. Прочие методы .......................................................................................................613
26.3. Графические объекты .........................................................................................................614
26.3.1. Класс QGraphicsltem: базовый класс для графических объектов ...................... 614
26.3.1.1. Настройка графического объекта........................................................... 614
26.3.1.2. Выполнение преобразований..... ;····························································616
26.3.1.3. Прочие методы ........................................................................................ 617
26.3.2. Готовые графические объекты .............................................................................. 618
26.3.2.1. Линия ........................................................................................................618
26.3.2.2. Класс QAbstractGraphicsShapeltem ........................................................618
26.3.2.3. Прямоугольник ........................................................................................619
26.3.2.4. Многоугольник ........................................................................................619
26.3.2.5. Эллипс ......................................................................................................619
26.3.2.6. Изображение ............................................................................ : ............... 620
26.3.2.7. Простой текст........................................................................................... 621
26.3.2.8. Форматированный текст ......................................................................... 621
26.4. Группировка объектов........................................................................................................622
26.5. Эффекты ..............................................................................................................................623
26.5.1. Класс QGraphicsEjfect ............................................................................................623
26.5.2. Тень..........................................................................................................................624
26.5.3. Размытие .................................................................................................................625
26.5.4. Изменение цвета ......................................................................................................625
26.5.5. Изменение прозрачности .......................................................................................625
26.6. Обработка событий.............................................................................................................626
26.6.1. События клавиатуры ..............................................................................................626
26.6.2. События мыши ....................................................................................................... 627
26.6.3. Обработка перетаскивания и сброса ..................................................................... 630
26.6.4. Фильтрация событий .......................................:...................................................... 631
26.6.5. Обработка изменения состояния объекта............................................................. 631
Глава 27. Диалоговые окна ...............................................·........................................ 634
27.1. Пользовательские диалоговые окна ..................................................................................634
27.2. Класс QDialogButtonBox ........... :........................................................................................636
12 Оглавление
27.3. Класс QMessageBox ............................................................................................................ 639
27.3.1. Основные методы и сигналы .................................................................................640
27.3.2. Окно информационного сообщения .....................................................................642
27.3.3. Окно подтверждения .............................................................................................. 643
27.3.4. Окно предупреждающего сообщения ................................................................... 644
27.3.5. Окно критического сообщения ............................................................................. 644
27.3.6. Окно сведений о программе ........... , ...................................................................... 645
27.3.7. Окно сведений о фреймворке Qt ..........................,................................................645
27.4. Класс QlnputDialog............................................................................................................. 646
27.4.1. Основные методы и сигналы ................................................................................. 647
27.4.2. Окно ДJIЯ ввода строки ........................................................................................... 649
27.4.3. Окно ДJIЯ ввода целого числа................................................................................. 649
27.4.4. Окно ДJIЯ ввода вещественного числа ................................................................... 650
27.4.5. Окно для выбора пункта из списка .............................................. , ........................ 651
27.4.6. Окно ДJIЯ ввода большого текста...........................................................................651
27.5. Класс QFileDialog............................................................................................................... 652
27.5.1. Основные методы и сигналы ................................................................................. 653
27.5.2. Окно ДJIЯ выбора каталога .....................................................................................655
27.5.3. Окно ДJIЯ открытия файлов .........,...........................................................................656
27.5.4. Окно ДJIЯ сохранения файла...................................................................................658
27.6. Окно ДJIЯ выбора цвета ....................................................................................................... 659
27.7. Окно ДJIЯ выбора шрифта .................................................................................................... 660
27.8. Окно ДJIЯ вывода сообщения об ошибке ...... :.................................................................... 661
27.9. Окно с индикатором хода процесса ...................... ............................................................
· 662
27.10. Создание многостраничного мастера ............................................................................. 663
27.10.1. Класс QWizard....................................................................................................... 663
27.10.2. Класс QWizardPage .............................................................................................. 667
Глава 28. Создание SDI- и МDI-программ ............................................................. 670
28.1. Главное окно программы ...................................................................................................670
28.2. Меюо и действия ................................................................................................................675
28.2.1. Класс QMenuBar ..................................................................................................... 675
28.2.2. Класс QMenu ........................................................................................................... 676
28.2.3. Контекстное меюо компонента ............................................................................. 679
28.2.4. Класс QAction.......................................................................................................... 680
28.2.5. Объединение действий-переключателей в группу............................................... 683
28.3. Панели инструментов ......................................................................................................... 684
28.3.1. Класс QToo/Bar............... :....................................................................................... 685
28.3.2. Класс QToo/Button .................................................................................................. 686
28.4. Прикрепляемые панели ...................................................................................................... 688
28.5. Строка состояния ................................................................................................................ 689
28.6. МDI-программы .................................................................................................................. 690
28.6.1. Класс QMdiArea ...................................................................................................... 690
28.6.2. Класс QMdiSubWindow.: ................. : .......................................................................693
28.7. Добавление значка программы в область уведомлений..................................................694
Глава 29. Мультимедиа .............................................................................................. 696
29.1. Воспроизведение мультимедиа ...............................................................................'..........696
29.1.1. Мультимедийный проигрыватель ......................................................................... 696
29.1.2. Звуковой выход. Воспроизведение звука ............................................................. 699
Оглавление 13
29.1.3. Метаданные мультимедийного источника ........................................................... 704
29.1.4. Видеопанель. Воспроизведение видео ................................................................. 707
29.2. Запись мультимедиа ........................................................................................................... 709
29.2.1. Транспорт ................................................................................................................ 709
29.2.2. Звуковой вход ......................................................................................................... 710
29.2.3. Кодировщик звука и видео ....................................................................................710
29.2.4. Указание форматов кодирования. Запись звука ..................................................712
29.2.5. Камера. Запись видео ............................................................................................. 716
29.2.6. Кодировщик статичных изображений. Захват фото ............................................ 720
29.3. Воспроизведение звуковых эффектов ............................................................................... 722
Глава 30. Печать документов ......................�............................................................ 726
30.1. Основные средства печати ................................................................................................. 726
30.1.1. Класс QPrinter......................................................................................................... 726
30.1.2. Вывод на печать...................................................................................................... 729
30.1.3. Служебные классы ................................................................................................. 735
30.1.3.1. Класс_ QPageSize............... , ....................................................................... 735
30.1.3.2. Класс QPageLayout .................................................................................. 737
30.2. Задание параметров принтера и страницы ....................................................................... 739
30.2.1. Класс QPrintDialog ................................................................................................. 739
30.2.2. Класс QPageSetupDialog ........................................................................................ 740
30.3. Предварительный просмотр .............................................................................................. 742
30.3.1. Класс QPrintPreviewDialog .................................................................................... 742
30.3.2. Класс QPrintPreviewWidget ....................................................................................745
30.4. Класс QPrinterlnfo: получение сведений об устройстве печати ..................................... 747
30.5. Класс QPdfWriter: экспорт в формат PDF ........................................................................ 749
Глава 31. Сохранение настроек программ ............................................................. 752
31.1. Создание объекта класса QSettings ................................................................................... 752
31.2. Запись и чтение данных ..................................................................................................... 753
31.2.1. Базовые средства записи и чтения данных ........................................................... 753
31.2.2. Группировка сохраняемых значений. Кточи ...................................................... 755
31.2.3. Запись списков ........................................................................................................757
31.3. Вспомогателрные методы класса QSettings ...................................................................... 759
31.4. Где хранятся настройки? .................................................................................................... 759
Глава 32. Программа «Судоку»............................._................................................... 761
32.1. Правила судоку ................................................................................................................... 761
32.2. Описание программы «Судоку» ........................................................................................ 762
32.3. Разработка программы ....................................................................................................... 764
32.3.1. Подготовительные действия.................................................................................. 764
32.3.2. КлассMyLabel: ячейка поля судоку ...................................................................... 764
32.3.3. Класс Widget: поле судоку ..................................................................................... 768
32.3.3.1. Конструктор класса Widget .....................................................................769
32.3.3.2. Прочие методы класса Widget ................................................................ 771
32.3.4. Класс MainWindow: основное окно программы................................................... 775
32.3.4.1. Конструктор клaccaMainWindow ...........................................................776
32.3.4.2. Остальные методы классаMainWindow................................................. 779
32.3.5. Главный модуль ............................................................._ .........................................779
14 Оглавление
32.3.6. Копирование и вставка головоломок .................................................................... 780
32.3.6.1. Форматы данных ..................................................................................... 780
32.3.6.2. Реализация копирования и вставки в классе Widget.............................780
32.3.6.3. Реализация копирования и вставки в классе MainWindow ...................783
32.3.7. Сохранение и загрузка данных .............................................................................. 787
32.3.8. Печать и предварительный просмотр ................................................................... 789
32.3.8.1. Реализация печати в классе Widget ........................................................ 790
32.3.8.2. Класс PreviewDialog: диалоговое окно Щ)едварительного
просмотра ................................................................................................................ 791
32.3.8.3. Реализация печати в клacce,MainWindow ..........................'.................... 794
Заключение ................................................................................................................... 796
Приложение. Описание электронного архива ....................................................... 797
Предметный указатель .............................................................................................. 798
Предисловие
Python
Python - зто высокоуровневый, объектно-ориентирова1ПП,IЙ, тьюринг-полный, интерпре
тируемый язык программирования, предназначенный для решения самого широкого круга
задач. С его помощью можно обрабатывать числовую и текстовую информацию, создавать
изображения, работать с базами данных, разрабатывать веб-сайты и оконные программы.
Python - язык кросс-платформенный, он позволяет создавать программы, которые будут
работать во всех операционных системах.
Согласно официальной версии, название языка произошло вовсе не от змеи. Создатель язы
ка, Гвидо ван Россум (Guido van Rossum), назвал свое творение в честь британского коме
дийного телешоу Би-би-си «Летающий цирк Монти Пайтона» (Monty Python's Flying
Circus). Поэтому правильно название этого замечательного языка должно звучать как «Пай
тон».
Программа на языке Python представляет собой обычный текстовый файл с расширением ру
(консольная программа) или pyw (программа с графическим интерфейсом). Все инструкции
из этого файла выполняются интерпретатором построчно. Для ускорения работы при пер
вом импорте модуля создается промежуточный байт-код, который сохраняется в оператив
ной памяти или одноименном файле с расширением рус. Для выполнения низкоуровневых
операций и задач, требующих высокой скорости работы, можно написать модуль на языке
С или С++, скомпилировать его, а затем подключить к программе.
Поскольку Python, как было только что отмечено, является языком объектно-ориенти
рованным, практически все данные в нем представляются объектами - даже значения, от
носящиеся к элементарным типам данных, наподобие чисел и строк, а также сами типы
данных. При этом в переменной всегда сохраняется только ссылка на объект, а не сам объ
ект. Например, можfю создать функцию, сохранить ссылку на нее в переменной, а затем
вызвать функцию через эту переменную. Такое обстоятельство делает язык Python идеаль
ным инструментом для создания программ, использующих функции обратного вызова, -
например, при разработке графического интерфейса.
Python - самый стильный язык программирования в мире, он не допускает двоякого написа
ния кода. В Python отсутствуют лишние языковые конструкции, и код можно написать только
одним способом. Все программисты, работающие с языком Python, должны придерживаться
стандарта оформления программного кода, описанного в документе РЕР-8 (bttps://peps.
pytbon.org/pep-0008/). Соответственно, более читаемого кода нет ни в одном ином языке про
граммирования.
16 Предисловие
Поскольку программа на языке Python представляет собой текстовый файл, Python-кoд
можно писать в любом текстовом редакторе (например, Блокноте, поставляемом в составе
Windows). Однако лучше использовать какой-либо редактор, специально предназначенный
для программистов: Visual Studio Code (https://code.visualstudio.com/), PyCharm (https://
www.jetbrains.com/ru-ru/pycharm/), Atom (https://atom.io/), SuЬlime Text (https://www.
suЫimetext.com/), Brackets (https://Ьrackets.io/), Notepad++ (https://notepad-plus-plus.org/)
и др. Мы же в процессе изучения материала этой книги будем пользоваться утилитой IDLE,
которая позволяет исполнять инструкции языка интерактивно и входит в сосщв стандарт
ной поставки Python.
PyQt
Библиотека PyQt служит для создания кросс-платформенных оконных программ с графиче
ским интерфейсом. Библиотека очень проста в использовании и идеально подходит для раз
работки весьма серьезных программ. Пользуясь исключительно ее средствами, мы можем
выводить на экран графику практически любой сложности, работать с базами данньIХ наи
более распространенньrх форматов, воспроизводить мультимедийные файлы, записывать
звук и видео, делать фото, выводить документьr на печать и экспортировать их в популяр
ный формат Adobe PDF. Библиотека PyQt основана на популярном фреймворке Qt и служит
своего рода связкой между ним и Python.
В самом конце книги мы с вами самостоятельно напишем на языке Python с применением
библиотеки PyQt полнофункциональную программу «Судоку», предназначенную для соз
дания и решения одноименньIХ головоломок.
Использованное ПО
Авторы применяли при работе над книгой следующее ПО:
♦ Microsoft Windows 10, русская 64-разрядная редакция со всеми установленными обнов-
лениями;
♦ Python - 3.10.1, 64-разрядная редакция;
♦ winpath - 202002.24
♦ pyshortcuts - 1.8.1;
♦ PyQt- 6.2.3;
♦ Qt Designer- 5.11.1;
♦ PyQt6-WebEngine - 6.2.1.
Типографские соглашения
В книге будут часто приводиться форматы написания различных языковых конструкций,
применяемьIХ в Python. В них использованы особые типографские соглашения, приведен
ные далее.
♦ Программный код набирается моноширинным шрифтом. Например:
print ("Привет, мир! ")
input ()
Предисловие 17
♦ В угловые скобки (<>) заключаются наименования различных значений, подставляемых
в исходный код(к примеру., параметров функций и методов). Например:
tуре(<Значение>i
Здесь вместо слова <Значение> должно быть подставлено реальное значение.
♦ В наименованиях параметров часто присутствуют типы значений, указьmаемых в каче
стве параметров. Например:
sеtРiхmар(<Изображение QPixrnap>)
Здесь в качестве параметра должно быть указано изображение, представленное объек
том класса QPixrnap. Еще пример:
setAlignment(<Bыpaвнивaниe AlignmentFlag>)
Здесь в качестве параметра указывается элемент перечисления AlignmentFlag, задающий
выравнивание.
♦ В квадратные скобки ( [ J) заключаются фрагменты кода, необязательные к указанию.
Например:
input([<Сообщение>])
Здесь <Сообщение> может быть указано, а может и не указываться.
♦ Значения по умолчанию у необязательных параметров функций и методов ставятся по
сле наименований параметров через зна� равенства(=). Например:
Ыake2s(<Значение>[, digest_size=32][, salt=b""])
Здесь у необязательного параметра digect_size значение по умолчанию - 32, а у не
обязательного параметра salt - пустая последовательность байтов типа bytes.
♦ Вертикальной чертой ( 1) разделяются различные варианты языковой конструкции, из
которых следует указать лишь какой-то один. Например:
python -m compileall <Путь к файлу>l<Путь к каталогу> <Опции>
Здесь следует поставить либо <Путь к файлу>, либо <Путь к каталогу>.
♦ Слишком длинные, не помещающиеся на одной строке языковые конструкции автор
разрывал на несколько строк и в местах разрывов ставил знак�- Например:
[[<Заполнитель>]<Выравнивание>][<Знак>][#][О][<Ширина>][,][ ]�
[.<Точность>] [<Преобразование>]
Приведенный код здесь разбит на две строки, но должен быть набран в одну. Символ�
при этом нужно удалить.
Все листинги из этой книги вы найдете в электронном архиве, который можно свободно
загрузить с сервера издательства «БХВ» по ссылке: https://zip.bhv.ru/9785977517065.zip
или со страницы книги на сайте издательства https://Ьhv.ru/(см. прwюж:ение).
Авторы книги желают вам приятного чтения и надеются, что она станет верным спутником
в вашей грядущей карьере программиста!
ЧАСТЬ 1
Основы языка Python
Глава 1. Первые шаги
Глава 2. Переменные и типы данных
Глава 3. Операторы
Глава 4. Инструкции ветвления, выбора и циклы
Глава 5. Числа
Глава 6. Строки и двоичные данные
Глава 7. Регулярные выражения
Глава 8. Списки, кортежи, множества и диапазоны
Глава 9. Словари
Глава 10. Работа с датой и временем
Глава 11. Функции
Глава 12. Модули, пакеты и импорт
Глава 13. Объекты и классы
Глава 14. Исключения и их обработка
Глава 15. Итераторы, контейнеры и перечисления
Глава 16. Работа с файлами и каталогами
Глава 17. Работа с механизмами Windows
ГЛАВА 1
Первые шаги
Прежде чем мы начнем знакомство с языком Python, хочется отметить, что книги по про
граммированию нужно не только читать, - весьма желательно выполнять все имеющиеся
в них примеры, а также экспериментировать, что-нибудь в этих примерах изменяя. Поэто
му, если вы удобно устроились на диване и настроились просто читать, у вас практически
нет ш�нсов изучить язык. Чем больше вы будете делать самостоятельно, тем большему на
учитесь.
ВНИМАНИЕ!
Текущая версия Python поддерживает только Microsoft Windows версий 8.1, 1 О и 11. Более
старые версии этой операционной системы не поддерживаются.
1.1. Установка Python
Вначале необходимо установить на компьютер интерпретатор (или исполняющую среду)
Python - программный пакет, который переводит программы, написанные на этом языке,
в представление, «понятное» центральному процессору компьютера. Без интерпретатора ни
одну Руthоn-программу запустить не получится.
1. ДrnI загрузки дистрибутива исполняющей среды заходим на страницу https://www.
python.org/downloads/ и в списке доступных версий щелкаем на гиперссьшке Python 3.10.1
(эта версия является наиболее актуальной на момент подготовки книги). На открывшей
ся странице находим раздел Files и щелкаем на гиперссьmке Windows installer (32-Ьit)
(32-разрядная редакция интерпретатора) или Windows installer (64-Ьit) (его 64-разряд
ная редакция) - в зависимости от редакции 1_1ашей операционной системы. В результате
на наш компьютер будет загружен файл python-3.10.1.exe или python-3.10.1-amd64.exe
соответственно. Запускаем загруженный файл двойным щелчком на нем.
2. В открывшемся окне (рис. 1.1) проверяем, установлен ли флажок Install launcher for all
users (recommended) (Установить утилиту launcher для всех пользователей), устанавли
ваем флажок Add Python 3.10 to РАТИ (Добавить Python 3.10 в список путей из пере
менной РАТН) и нажимаем кнопку Customize installati_on (Настроить установку).
Утилита launcher, поставляемая в составе дистрибутива, предназначена для запуска про
грамм под определенной версией Python, если на компьютере установлены несколько
разных версий этого языка. К сожалению, если ее не установить, не получится ассоции
ровать файльr Руthоn-программ с исполняющей средой Python, в результате чего запус
кать программы щелчк�м мыши станет невозможно.
22 Часть /. Основы языка Python
� Python з:10'1 (64-blt)Setup х
lnstall Python 3.10.\(64-Ьit)
Select lnstall Now to install Python with'default settings. ог choose
Customize to еnаЫе or disaЫe features.
➔ !nstall Now
C:\Users\vl11d\AppD11t11\Local\Programs\Python\Python310
lncludes ЮlЕ, pip 11nd documentotion.
Creates shortcuts and file as.sociations
1➔ Cystomize insta11ation
Choose focotion and features
i
python
Б21 lnstall !auncher for all users (recommended)
windows 0 Add fython 3.1 О 10 РАТН
Рис. 1.1. Установка Python: шаг 1
3. В следующем диалоговом окне (рис. 1.2) предлагается выбрать устанавливаемые компо
ненты. Оставляем установленными все флажки, представляющие эти компоненты, и на
жимаем кнопку Next.
� Python 3.10.1 (64-Ьit) Setup х
Optional Featu res
Б21 Qocumentation
lnstalls the Python documentation tile.
Б21 Qip
ln.stal!s pip. which can download and install other Python packages.
0 td/tk and !DLE
lostalls tkioter and the !DLE development eпvironme�t.
Б21 Python 1est suite
lnstэlls the stan�ard IJbrary test suite.
Б21 ру Jauncher Б21 for ill users (requires e1evation)
:i;I: uщ ·Jnstalls the global 'ру' launcher to make it easier to s1art Python.
python
fot ,,
windows
Рис. 1.2. Установка Python: шаг 2
4. На следующем шаге (рис. 1.3) задаем дополнительные настройки и выбираем путь уста
новки. Проверяем; установлены ли флажки Associate files with Python (requires the ру
launcher) (Ассоциировать Руthоn-файлы с исполняющей средой), Create shortcuts for
Глава 1. Первые шаги 23
installed applications (Создать ярлыки для установленных приложений), Add Python to
environment variaЫes (Добавить Python в переменные окружения), устанавливаем
флажки lnstall for all users (Установить для всех пользователей) и Precompile standard
library (Предварительно откомпилировать стандартную библиотеку).
� Python 3.10.1 (64-blt) Setup х
Advanced Options
0 lnstall for ан users
0 Associate filt!s with Python (requires the ру launcher)
0 Create shortOJts for installed applications
0 Add Python to tnvironment variables
0 frecompile standard liЬrary
О Download deЬugging aymЬols
О Download deЬug Ьinaries (requires VS 2017 or later)
Customize install location
1�
e:_•\__
Pythonз_1o_________l l 8'owse J
python
{C)f
windc,ws ·!$·
Рис. 1.3. Установка Python: w11r 3
Ассоциирование Руthоn-файлов с исполняющей средой позволит запускать эти файлы
щелчками на них. Добавление пути к интерпретатору Python в список путей из перемен
ной РАТИ даст возможность запускать этот интерпретатор набором в консоли (это сокра
щенное название командной строкu Windows, применяемое далее в книге) команды
python. Предварительная компиляция стандартной библиотеки ускорит запуск Python
nporpaмм.
Обратите внимание на указание пути, по которому будет установлен Python. Изначально
предлагается установить интерпретатор no пути c:\Program Files (x86)\Python310 или
c:\Program Files\Python310. Однако в этом случае могут возникнуть проблемы ори ис
пользовании дополнительных библиотек, расширяющих функциональность интерпрета
тора.
Поэтому авторы книги рекомендуют установить Python по пути c:\Python310- т. е. не
посредственно в корень диска (см. рис. 1.3). В этом случае никаких проблем ори исполь
зовании дополнительных библиотек не возникнет.
Задав все необходимые параметры, нажимаем кнопку Install и положительно отвечаем
на появившееся на экране предупреждение UAC.
5. После завершения установки откроется окно, показанное на рис. 1.4. Нажимаем в нем
кнопку Close для выхода из программы установки.
В результате на компьютер будут установлены две редакции интерпретатора Python:
♦ python.exe - предназначена для исполнения консолънцх программ и задействуется ори
щелчке мышью на файле с расширением ру.
24 Часть /. Основы языка Python
С помощью этой редакции можно выполнять и око1rnые программы, однако в этом слу
чае на экране появится окно консоли, что может обескуражить пользователя;
♦ pythonw.exe - служит для исполнения оконных программ и задействуется при щелчке
мышью на файле с расширением pyw. Консоль при этом не вьmодится.
!;> Python 3.10.1 (64-Ьit) Setup х
Setup was successful
New to Python? Start with the on!ine tutorial and
docvment�tion. At your terminal, type "ру" to launch Python.
ог �arch for Python in your Start menu.
See what's new in this release. or find more info about ш1щ1
Python on Windows.
DisaЫe path length limit
Changes your machine «>nfiguratton to allow programs, including Pythcn, \о
bypass th� 260 character "МАХ_РАТН' limitation.
python
windows
Рис. 1.4. Установка Python: шаг 4
1.2. Интерактивный режим Python. Утилита IDLE
Изучать Python удобнее всего, вводя инструкции этого языка вручную и тотчас получая
результаты их выполнения. Для этого интерпретатор Python должен работать в интерак
тивном режиме.
Запустить интерпретатор PytЬon в интерактивном режиме можно одним из следующих спо
собов:
♦ выбрав в меню Пуск I Python 3.10 пункт Python 3.10 (32-Ьit) или Python 3.10 (64-Ьit);
♦ набрав в консоли python и нажав клавишу <Enter>;
♦ выполнив щелчок мышью (одинарный или двойной � в зависимости от настроек опера-
ционней системы) на файле python.exe в каталоге c:\Python310.
В результате на экране появится окно, напоминающее таковое у командной строки Windows
(рис. 1.5). Символами>» в этом окне помечается приглашение для ввода инструкций. Если
после этих символов ввести, например, 2 + 2 и нажать клавишу <Enter>, то на следующей
строке появится результат сложения - 4, а затем - приглашение для ввода новой инструк
ции. Таким образом, интер;;�ктивный режим можно использовать и в качестве очень мощно
го калькулятора.
Однако значительно удобнее учить язык и выполнять вычисления, работая с утилитой
IDLE, которая входит в комплект поставки Python. Эта утилита представляет собой своего
рода обертку вокруг интерпретатора, работающего в интерактивном режиме, которая
Глава 1. Первые шаги 25
Рис. 1.5. Интерпретатор Python, запущенный в интерактивном режиме
добавляет интерпретатору расширенную функциональность (в частности, синтаксическую
подсветку программного кода и вывод подсказок).
Для запуска IDLE достаточно выбрать в меmо Пуск I Python 3.10 пункт IDLE (Python 3.10
32-blt) или ШLЕ (Python 3.10 64-blt). На экране появится окно ШLЕ Sbell (рис. 1.6), в ко
тором выводится интерактивный интерпретатор Python.
ff' IDLEShellЗ.10.1 □ х
Eile .Edit Sl1e!I !2ebug Qptions 'l\lindow t:!elp
jPython 3.10.1 {tags/v3.10.1:2cd268a, Dec 6 2021, 19:10:37) [MSC v.1929 64 bit "'
i{AМD64}] on win32
;Туре "help", "copyright", "credits" or "license{)" for more iпformation.
»>!2 + 2
!4
>»il
у
Ln: 5 -Col: О
Рис. 1.6. Окно IDLE Shell утилиты IDLE
Отметим, что в окне ШLЕ Shell приглашение»> отображается на свободной полосе, рас
положенной левее области редактирования, в которой вводятся инструкции Python и выво
дятся результаты. Поэтому при копировании кода в буфер обмена комбинацией клавиш
<Ctrl>+<C> приглашение в него не попадает.
Кроме того, IDLE позволяет работать с Руthоn-программами, хранящимися в файлах. Со
держимое _таких файлов выводится в отдельных окнах. Более подробно функциональные
возможности этой утилиты будут рассмотрены позже.
ВНИМАНИЕ!
В дальнейшем для написания и выполнения Руthоп-программ мы будем использовать ути-
литу IDLE.
1.3. Введение в Руthоn-программирование
Изучение языков программирования принято начинать с программы, выводящей надпись
«Привет, мир!» Не будем нарушать традиции и продемонстрируем, как это будет выглядеть
на Python (листинг 1.1 ).
26 Часть /. Основы языка Python
# Выводим надпись с помощью функции print(}
рrint("Привет, мир!"}
Эта программа состоит из двух инструкций (или выражений) - предписаний, указываю
щих Python выполнить какое-либо законченное действие и записьmаемых на отдельных
строках. Первая инструкция ·представляет собой комментарий - пометку, написанную са
мим программистом с целью объяснить себе или коллегам, что делает тот или иной код.
Вторая инструкция выводит в консоли строку «Привет, мир!»
Вывод значения во второй инструкции выполняется посредством. функции print(). Функ
цией называется языковая конструкция, выполняющая над переданными ей значениями
(параметрами) какое-либо относительно сложное действие (в нашем случае - вывод
в консоль). Параметры записываются внутри круглых скобок и отделяются друг от друга
запятыми. В листинге 1.1 функции print () передается всего один параметр - выводимое
значение.
Запускаем интерпретатор Python в интерактивном режиме (как это сделать, бьшо описано
в разд. 1. 2). Правее приглашения>>> вводим сначала первую строку из листинга 1.1, а затем
вторую. После ввода ,каждой строки нажимаем клавишу <Enter>. В третьей строке сразу
отобразится результат, а далее - приглашение для ввода новой команды. Мы увидим сле
дующее (напоминаем, что символы>» - это приглашение, их вводить не нужно):
>>>#Выводим надпись с помощью функции print()
>>> рrint("Привет, мир!")
Привет, мир!
>>>
ВНИМАНИЕ!
В дальнейшем в подобных фрагментах кода инструкции, вводимые вручную, будут поме
чаться расположенными левее символами приглашения >>>, а результаты, выведенные
интерпретатором, показываться без этих символов.
Для создания файла с Руthоn-программой в ме_ню File окна ШLЕ Shell выбираем пункт New
File или нажимаем комбинацию клавиш <Ctrl>+<N>. В открывшемся окне набираем код из
листинга 1.1, а затем сохраняем его в каком-либо каталоге в файле с именем hello_world.py,
выбрав пункт меню File I Save (или пажа� комбинацию клавиш <Ctrl>+<S>).
Кстати, файл с Руthоn-кодом в терминологии этого языка называется модулем.
Запустить написанную программу на выполнение можно, выбрав в окне с кодом этой про
граммы пункт меню Run I Run Module или нажав клавишу <F5>. Результат выполнения
программы будет отображен в окне ШLЕ Shell.
Запустить Руthоn-программу вне среды IDLE можно двумя способами:
♦ набрав имя хранящего ее файла вместе с расширением (например: hello_world.py}
в консоли и нажав клавишу <Enter>.
Результат выполнения будет вьmеден там же, в консоли;
♦ выполнив щелчок мышью (двойной или одинарный - в зависимости от настроек систе
мы) на значке файла с этой программой.
В этом случае после вьmода результата окно консоли сразу закроется. Чтобы предотвра
тить его закрытие, необходимо добавить в конец кода программы вызов функции
Глава 1. Первые шаги 27
input(), которая станет ожидать нажатия клавиши <Enter> и не позволит окну сразу за
крыться. С учетом сказанного наша первая программа будет выглядеть так, как показано
в листинге 1.2.
! Листинr 1.2. Проrрам�а � запуска� nоА49щ11,ю щ.;,,чка мыши
рrint("Привет, мир!") # Выводим строку
input() # Ожидаем нажатия клавиши <Enter>
Отметим, что функция input() в листинге 1.2 вызывается без параметров. В таком случае
после имени функции ставятся пустые круглые -скобки.
ПРИМЕЧАНИЕ
Если до выполнения функции input() в коде возникнет ошибка, то сообщение о ней будет
выведено в консоли, но последняя после этого сразу закроется, и вы не сможете прочитать
сообщение об ошибке. Попав в подобную ситуацию, запустите программу из консоли или
утилиты IDLE, и вы сможете прочитать это сообщение.
Чтобы открыть Руthоn-файл для редактирования, запустим IDLE, выберем пункт меню File 1
Open (комбинация клавиш <Ctrl>+<O>) и выберем нужный файл в появившемся на экране
диалоговом окне открытия файла. Файл будет открыт в новом окне утилиты IDLE.
1.4. Принципы написания· Руthоn-программ
♦ Программа, написанная на Python, представляет собой обычный текстовый файл с рас
ширением ру (будет исполнен обычным интерпретатором python.exe) или pyw (будет ис
полнен «оконным» интерпретатором pythonw.exe).
Для написания Руthоn-программ, как уже ранее отмечалось, можно использовать, поми
мо IDLE, любой подходящий текстовый редактор: стандартный Блокнот, Notepad++
(https://notepad-plus-plus.org/), Visual Studio Code (https://code.visualstudio.com/) и др.
Также существует ряд специализированных текстовых редакторов, предназначенных
именно для Руthоn-программистов, в частности PyChaпn' (https://www.jetbrains.com/
ru-ru/pycharm/).
♦ Инструкции, записанные в коде программы, выполняются последовательно, в порядке
сверху вниз.
♦ Каждая инструкция Python должна располагаться на отдельной строке. Признаком конца
инструкции является перевод строки. Пример программы из двух выражений приведен
в листинге 1.3.
Лис:тинr 1.3. Программа, выnоn� арифметмческиtl вычисnения
х = 15 + 20 + 30
print(x)
Первое выражение складьmает числа 15, 20 и 30 и заносит сумму в переменную с име
нем х (переменная - ячейка памяти, имеющая уникальное имя, способная хранить ка-
1 Доступны как базовая бесплатная, так и расширенная платная редакции этого редактора.
28 Часть /. Основы языка Python
кое-либо значение - например, число, и создаваемая при присваивании ей значения).
Второе выражение выводит содержимое этой переменной - число 65 - в консоли.
В первом выражении используются два оператора. Оператором назьmается языковая
конструкция, выполняющая над переданными ему значениями какое-либо элементарное
действие (например, сложение чисел или присваивание результата указанной перемен
ной). Оператор сложения обозначается привычным символом +, а оператор присваива
ния - символом =.
В Windows перевод строки формируется комбинацией символов \r (перевод каретки)
и \n(перевод строки), в UNIX - одним символом \n.
Если загрузить файл Руthоn-программы ·по протоколу FTP в бинарном режиме, то сим
вол \r вызовет фатальную ошибку. rio этой причине файлы по протоколу FTP следует
загружать только в текстовом (ASCII) режиме - тогда символ \r будет удален автома
тически.
♦ Если строка с инструкцией получилась слишком длинной, инструкцmо можно разделить
на несколько строк одним из следующих способов:
• поставить в месте разрыва строк символ \, сразу после которого вставить перевод
строки(как обычно, нажатием клавиши <Enter>):
х = 15 + 20 + \
30
print(x)
Как правило, вторая и все последующие строки, содержащие длинное ,выражение,
набираются с отступами слева - для улучшения читаемости кода. Следует только
формировать эти отступы uсЮ1ючительно пробелами и делать одинаковой длины (со
держащими одинаковое количество пробелов).
При вводе подобного рода многострочной инструкции в интерпретаторе, работаю
щем в интерактивном режиме, строки с продолжением инструкции помечаются рас
положенным слева приглашением в виде трех точек( ... , а не>», как обычно). Кро
ме того, интерпретатор сам выводит последующие строки с отступами. Чтобы завер
шить ввод многострочной инструкции, следует, введя ее последнюю строку, нажать
клавишу <Enter> (при этом после многострочной инструкции будет создана пустая
строка с приглашением из трех точек). Пример:
>>> х = 15 + 20 + \ # Вводим первую строку многострочной инструкции
30 # Вводим вторую, последнкю, строку
# Завершаем ввод многострочной инструкции, нажав <Enter>
>>> print(x) # Вводим следуюцую инструкцию
• заключить выражение в круглые скобки, внутри которых вставить нужное количест
во переводов строки:
х = (15 +
20 +
30)
print(x)
• определение списка и словаря(описываются в главах 8 и 9), при оформлении кото
рых используются квадратные и фигурные скобки соответственно, также можно раз
бить на несколько строк:
Глава 1. Первые шаги 29
пример определения списка:
arr = (15, 20,
30]
print(arr)
пример определения словаря:
arr = { "х": 15, "у": 20,
"z": 30)
print(arr)
♦ Короткие инструкции можно записать в одной строке, разделив их символами точки
с запятой(;):
х = 15 + 20 + 30; print(x)
После точки с запятой не возбраняется ставить пробел - для улучшения читаемости кода.
♦ Блоки (наборы из произвольного количества инструкций, входящие в состав более
сложных инструкций) формируются отступами слева. Такие отступы должны форми
роваться исключительно пробелами и быть одинаковой длины (т. е. содержать одинако
вое количество пробелов). Символы табуляции в отступах не допускаются и при выпол
нении программы вызывают возникновение ошибки.
Листинг 1.4 показывает код программы, выводящей последовательно числа от 1 до 10,
которые разделяются тремя дефисами.
for i in range(l, 11):
print (i)
prin_t ("---")
Первая строка содержит сложную инструкцию - цикл(описывается в главе 4), который
выполняется 1 О раз. При каждом исполнении он заносит в переменную i очередное чис
ло в .диапазоне от· 1 до 1О и выполняет блок, входящий в его состав. Этот блок состоит из
двух инструкций, записанных во второй и третьих строках: первая инструкция выводит
в консоли число из переменной i, а вторая - строку из трех дефисов. Обе инструкции,
входящие в блок, имеют одинаковый отступ слева, содержащий 4 пробела.
Числа, перебираемые циклом (и, соответственно, количество выполнений, или итера
ций, цикла), указываются в функции range () (первая инструкция в листинге 1.4). Первый
параметр задает начальное число перебираемого диапазона, второй - конечное число
плюс 1.
ПРИМЕЧАНИЕ
4 пробела - общепринятая величина отступа в Python.
При вводе инструкции, содержащей блок, в интерпретаторе, который работает в инте
рактивном режиме, интерпретатор предваряет выражения, входящие в блок, приглаше
нием в виде трех точек (...) и сам вставляет отступы. Чтобы завершить ввод блока, сле
дует, занеся последнее входящее в него выражение, нажать клавишу <Enter> (при этом
в набранном коде появится пустая строка с приглашением в виде трех точек). Пример:
30 Часть /. Основы языка Python
>>> for i in range(l, 11):
print(i)
print("---")
>>> # Следукхцая инструкция
♦ Если блок содержит одну короткую инструкцmо, и сам блок, и сложную инструкцmо,
в состав которой он входит, можно записать в одну строку. При этом интерпретатор по
считает, что ввод блока продолжится после нажатия клавmпи <Enter>, и выведет при
глашение в виде трех точек. Чтобы завершить ввод инструкции, следует снова нажать
<Enter>. Пример программы, выводящей в консоли числа от 1 до 10:
>>> for i in range(l, 11): print(i)
Вывод пропущен ...
1.4.1. Комментарии и строки документирования
Комментарий - это произвольное пояснение, вставленное в код программы, предназна
ченное исключительно программисту и полностью игнорируемое интерпретатором. Внутри
комментария может располагаться любой текст.
Комментарий в языке Python начинается с символа # и заканчивается концом строки:
# Выводим числа от 1 до 10
for i in range(l, 11): print(i)
Комментарий может располагаться после собственно инструкции:
print(."Bce, числа закончились") # Сообщаем об окончании чисел
Если символ # разместить перед инструкцией, то она не будет выполнена (закомментиро
ванная инструкция):
# рriпt("Привет, мир!") Эта инструкция выполнена не будет
Если требуется разместить комментарий из нескольких строк, перед каждой из них придет
ся ставить символ #:
# Это наша первая программа!
# Она выводит числа от 1 до 10
# Да, не впечатляет, но для начала неплохо...
for i in range(l, 11): print(i)
Строки документирования Python обычно применяются для написания инструкций к про
граммам и модулям (подробности - в главе 6). Однако их можно использовать и для ком
ментирования кода.
Строка документирования заключается в утроенные кавычки или апострофы:
Это наша первая программа!
Она выводит числа от 1 до 10
Да, не впечатляет, но для начала неплохо...
for i in range(l, 11): piint(i)
Глава 1. Первые шаги 31
1.4.2. Кодировки, поддерживаемые Python
Код Руthоn-программы, написанный в IDLE, по умолчанию сохраняется в кодировке UTF-8
безвом 1 •
Если программу следует сохранить в какой-либо другой кодировке (что может пригодиться,
например, при переписывании старого Python-кoдa), в первой строке ее кода следует ука
зать кодировку с помощью инструкции формата:
# -*- coding: <Обозначение кодировки>-*-
Например, кодировка Windows-1251 указывается инструкцией:
# -*- coding: ср1251 -*-
Встретив такую инструкцию в коде программы, IOLE при сохранении файла самостоятель
но переведет программу в кодировку с заданным обозначением. При использовании других
редакторов следует перевести программу в указанную кодировку вручную.
Получить полный список поддерживаемых Python кодировок и их обозначения позволяет
программа, приведенная в листинге 1.5.
import encodings.aliases
arr = encodings.aliases.aliases
keys = list( arr.keys() )
keys.sort()
for key in keys: print("%s => %s" % (key, arr[key]))
1.4.3. Подготовка Python-nporpaмм для выполнения в UNIX
Если программа предназначена для исполнения в операционных системах семейства UNIX,
в первой строке кода программы необходимо указать путь к интерпретатору Python:
#!/usr/bin/python
В некоторых UNIХ-системах путь к интерпретатору выглядит по-другому:
#!/usr/local/bin/python
Иногда можно не указывать точный путь к интерпретатору, а передать название языка про
грамме env:
#!/usr/bin/env python
. ,
В этом случае программа env произведет поиск интерпретатора Python в соответствии с на-
стройками путей поиска.
Если программа, исполняемая в UNIX, сохранена в_ кодировке, отличной от UTF-8, обозна
чение кодировки указьmается во второй строке ее кода:
#!/usr/bin/python
# -*- coding: ср1251 -*-
1 ВОМ (Byte Order Mark) - метка порядка байтов. Указывает порядок, в котором записываются байты, ко
дирующие символы в UTF-8.
32 Часть /. Основы языка Python
Также следует разрешить выполнять Python-пporpaммy, указав у ее файла права 755 (-rwxr
xr-x).
1.5. Дополнительные возможности IDLE
Поскольку далее для работы мы будем использовать утилиту IDLE, рассмотрим предлагае
мые ею дополнительные возможности.
Обычно после ввода инструкции и нажатия клавиши <Enter> введенная инструкция выпол
няется, и на следующей строке выводится ее результат (при условии, что инструкция воз
вращает результат). После чего появляется приглашение для ввода новой инструкции.
При вводе сложно_й инструкции, содержащей блок, после нажатия клавиши <Enter> интер
претатор, работающий в интерактивном режиме, автоматически создаст отступ и будет
ожидать ввода блока. Чтобы сообщить интерпретатору об окончании ввода инструкции,
необходимо нажать <Enter> дважды:
>>> for n in range(l, 3);
print(n)
1
2
>>>
Если ввести какое-либо значение - например, строку или число, и нажать <Enter>, это зна
чение появится в следующей строке:
>>> "Привет, мир!"
'Привет, мир! '
>>>
Обратите внимание на то, что строки выводятся в апострофах. Этого не произойдет, если
выводить строку с ПОМОЩЬЮ функции print():
>>> рrint("Привет, мир!")
Привет, мир!
>>>
Как говорилось в разд. ·1.2, окно ШLЕ Shell можно использовать для изучения языка, а
также в качестве многофункционального калькулятора (здесь * - это оператор умноже
ния):
>>> 12 * 32 + 54
438
>>>
Результат вычисления последней инструкции сохраняется в переменной_ (одно подчерки
вание). Это позволяет производить дальнейшие расчеты без ввода предыдущего результа
та - вместо него достаточно ввести символ подчеркивания. Пример (здесь / - оператор
деления):
>>> 125 * 3 # Умножение
375
>>> + 50 # Сложение. Эквивалентно 375 + 50
425
Глава 1. Первые шаги 33
»> / 5 # Деление . Эквивалентно 425 / 5
85.0
>>>
При вводе команды можно воспользоваться комбинацией клавиш <Сtrl>+<Пробел>. В ре
зультате будет отображен список, из которого можно выбрать нужную языковую конструк
цию. Если при открытом списке начать вводить буквы, то показываться будут языковые
конструкции, начинающиеся с этих букв. Выбирать конструкцию необходимо с помощью
клавиш <i> и <t>. После выбора не следует нажимать клавишу <Enter>, иначе это приве
дет к выполнению инструкции, - просто вводите инструкцию дальше, а список закроется.
Такой же список будет автоматически появляться (с некоторой задержкой) при обращении
к атрибутам объекта или модуля после ввода точки. Для автоматического завершения язы
ковой конструкции после ввода первых букв можно воспользоваться комбинацией клавиш
<Alt>+</>. При каждом последующем нажатии этой комбинации будет вставляться сле
дующая конструкция. Эти две комбинации клавиш очень удобны, если вы забыли, как
пишется слово, или хотите, чтобы редактор закончил его за вас.
Иногда возникает необходимость выполнить ранее введенную инструкцию повторно. Для
таких случаев ШLЕ предоставляет комбинации клавиш <Alt>+<N> (вставка первой введен
ной инструкции) и <Alt>+<P> (вставка последней инструкции). J{аждое последующее нажа
тие этих клавиш будет вставлять следующую (или предыдущую) инструкцию. Для еще
более быстрого повторного ввода инструкции следует предварительно ввести ее первые
буквы - в этом случае перебираться будут только инструкции, начинающиеся с этих букв.
1.6. Вывод данных
Вывести заданнь1е значения можно с помощью функции print():
print( [ <Значения через запятую>] [, sep=' '] [, end=' \n'] [, file=sys. stdout] [,
flush=False])
Указанные значения при необходимости преобразуются в строки и посылаются в стандарт
ный поток вывода stdout. С помощью параметра file можно перенаправить вывод в другое
место - например, в файл. При этом, если параметр flush имеет значение· False, выводи
мые значения будут записаны в файл принудительно. Перенаправление вывода мы подроб
но рассмотрим при изучении файлов.
Если выполняется вывод одного значения, автоматически добавляется символ перевода
строки:
print("Cтpoкa 1")
print("Cтpoкa 2")
Результат:
Строка 1
Строка 2
Можно вывести несколько значений в одну строку, указав их в вызове функции print()
отдельными параметрами, разделенными запятыми:
print("Cтpoкa 1", "Строка 2")
Результат:
Строка 1 Строка 2
34 Часть /. Основы языка Python
Как видно из примера, между выводимыми значениями автоматически вставляется пробел.
С помощью параметра sep можно указать другой разделяющий символ. Например, выведем
строки без пробела между ними, указав в качестве разделителя пустую строку:
print("Строкаl", "Строка2", sep="")
Результат:
Строка lСтрока 2
Ряд функций, встроенных в Python, поддерживают так называемые именованные парамет
ры. В число таких параметров и входит sep. Обратим внимание, как задается его значение
в приведенном примере.
После вывода нескольких значений в одном вызове функции print() в ко�ще добавляется
символ перевода строки. Если необходимо произвести дальнейший вывод на той же строке,
то в именованном параметре end следует указать другой символ:
print("Cтpoкa 1", "Строка 2",. end=" ")
print("Cтpoкa 3")
# Выведет: Строка 1 Строка 2 Строка 3
Вызов функции print() без параметров выводит пустую строку:
for n in range(l, 5):
print(n, end=" ")
print()
print("Это текст на новой строке")
Результат выполнения:
1 2 3 4
Это текст на новой строке
Здесь мы использовали цикл, выполняющийся четыре раза. На каждой итерации он при
сваивает переменной n число от 1 до 4 и выполняет блок, содержащий вызов функции'
print(), которая выводит число из переменной n. Не забываем вставить в выражение, вхо
дящее в блок, отступ слева.
Как только цикл выполнится четыре раза, будут исполнены два следующих за ним выраже
ния. В них отступы слева указывать не следует, поскольку эти выражения не должны вхо
дить в состав блока. Первое выражение выведет пустую строку, второе - надпись «Это
текст на новой строке».
Если необходимо вывести большой блок текста, его следует разместить между утроенными
кавычками или утроенными апострофами. В этом случае текс, сохраняет свое форматиро
вание:
print("""Cтpoкa 1
Строка 2
Строка 3""")
В результате выполнения этого примера мы получим три строки:
Строка 1
Строка 2
Строка 3
Глава 1. Первые шаги 35
Вместо функции print() можно использовать· метод write() объекта stdout из модуля sys
(методы очень похожи на функции и в подробностях, вместе с объектами, будут рассмотре
ны позже):
import sys # Подключаем модуль sys, чтобы использовать
# содержащийся в нем объект stdout
sys.stdout.write("Строка")
Как мы помним из разд. 1.3, модуль - это просто файл с Руthоn-кодом. Однако модуль sys
поставляется в составе Python и входит в стандартную библиотеку (набор модулей, содер
жащих полезные функции, объекты и др.) этого языка. Подключив этот модуль, мы можем
использовать созданнь1е в нем функции и объекты.
В первой строке с помощью оператора import подключаем модуль sys, в котором объявлен
объект stdout. Далее с помощью метода write() этого объекта выводим строку. Следует
заметить, что метод не вставляет символ перевода строки, поэтому при необходимости сле
дует добавить его самим с помощью символа \n:
import sys
sys .stdout.write( "Строка 1\n")
sys.stdout.write("Cтpoкa 2")
Метод wr.:L te() возвращает результат - значение, полученное в процессе выполненных
методом вычислений. Таковым результатом является количество символов в выведенной
строке. Его можно присвоить какой-либо переменной и ис�ользовать в дальнейшем:
import sys
cnt = sys.stdout.write("Пpивeт, Python\n")
рrint("Символов в выведенной строке: ", cnt)
Результат:
Привет, Python
Символов в выведенной строке: 15
1.7. Ввод данных
Для ввода даннь1х в Python предназначена функция input() , которая получает данные со
стандартного потока ввода stdin. Функция имеет следующий формат:
input( [<Сообщение>] )
Введенное значение она возвращает в качестве результата. Этот результат следует присво
ить какой-либо переменной посредством оператора =.
Для примера переделаем нашу первую программу так, чтобы она здоровалась не со всем
миром, а только с нами (листинг 1.6).
1 nм�нr 1,6. При
name = input("Введите ваше имя: ")
рrint("Привет,", name)
inрut("Нажмите <Enter> для закрытия окна")
36 Часть /. Основы языка Python
В первой инструкции значение, введенное пользователем и полученное функцией input () ,
присваивается переменной name.
Сохраняем программу в файле test.py и запускаем на выполнение с помощью двойного
щелчка. Откроется черное окно, в котором мы увидим надпись: Введите ваше имя:. Вво
дим свое имя - например, Николай, и нажимаем клавишу <Enter>. В результате будет выве
дено приветствие: Привет, Николай.
При использовании функции input() следует учитывать, что при достижении конца файла
или при нажатии комбинации клавиш <Ctrl>+<Z>, а затем клавиши <Enter> генерируется
исключение EOFError. Если не предусмотреть обработку исключения, то программа аварий
но завершится. Обработать исключение можно следующим образом:
try:
s = inрut("Введите данные: ")
print(s)
except EOFError:
рrint("Обработали исключение EOFError")
Если внутри блока try возникнет исключение EOFError, то управление будет передано
в блок except. После исполнения инструкций в блоке except программа нормально продол
жит работу.
Передать данные можно в консоли, указав их после имени файла программы. Такие данные
доступны через список argv из модуля sys. Первый элемент списка argv будет содержать
имя файла запущенной программы, а последующие элементы - переданные данные. Для
примера создадим файл test2.py в каталоге C:\book. Содержимое файла приведено в листин
ге 1.7.
[ Л.11СТ14._r 1.7. Получен� данных из консоnи
import sys
arr = sys.argv(:]
for n in arr:
print (n)
Теперь запустим программу на выполнение из консоли, передав ей данные. Запустим кон
соль, для чего выберем в меню Пуск пункт Выполнить, в открывшемся окне наберем ко
манду cmd и нажмем кнопку ОК. Откроется черное окно с приглашением для ввода команд.
Перейдем в каталог C:\book, набрав команду:
cd C:\book
В консоли должно появиться приглашение:
C:\book>
Для запуска нашей программы вводим команду:
test2.py uhud opk987
В этой команде мы передаем имя файла (test2.py) и некоторые данные (-uNik и -р12З).
Результат выполнения программы будет выглядеть так:
test2.py
uhud
opk987
Глава 1. Первые шаги 37
1.8. Утилита pip:
установка дополнительных библиотек
Интерпретатор Python поставляется с · богатой стандартной библиотекой, реализующей,
в частности, работу с файлами, шифрование, архивирование, обмен данными по сети и пр.
Однако такие операции, как обработка графики, взаимодействие с базами данных SQLite,
MySQL и многое другое, она не поддерживает, и для их выполнения нам придется устанав
ливать дополнительные библиотеки.
Для установки дополнительных библиотек в Python достаточно воспользоваться имеющей
ся в комплекте поставки Python утилитой pip, которая самостоятельно найдет запрошенную
библиотеку в интернет-хранилище (репозитории) PyPI (Python Package Index, реестр паке
тов Python), загрузит дистрибутивный пакет с редакцией библиотеки, совместимый с уста
новленной версией Python, и установит ее. Если инсталлируемая библиотека требует для
работы другие библиотеки, они также будут установлены.
Помимо этого, утилита pip позволяет просмотреть список уже установленных библиотек,
получить сведения о выбранной библиотеке и удалить ненужную библиотеку.
Для использования утилиты pip в консоли следует набрать команду следующего формата:
pip <Команда и ее опции> <Универсальные опции>
Параметр <Команда и ее опции> указывает, что должна сделать утилита: установить биб
лиотеку, вывести список библиотек, предоставить сведения об указанной библиотеке или
удалить ее. Параметр <Универсальные опции> задают дополнительные настройки для самой
утилиты и действуют на все поддерживаемые ею команды.
Далее приведен сокращенный список поддерживаемых утилитой pip команд вместе с их
собственными опциями, а также наиболее востребованных универсальных опций. Полный
список всех команд pip можно получить, воспользовавшись командой help и опцией -h.
Итак, утилита pip поддерживает следующие наиболее полезные нам команды:
♦ install- установка указанной библиотеки. Формат этой команды таков:
pip install [<Опции>] <Название библиотеки>
Если в параметре <Опции> не указана ни одна из них (см. далее), утилита просто загрузит
и установит библиотеку с указанным названием. Если такая библиотека уже установле
на, ничего не произойдет. Вот пример установки библиотеки Pillow:
pip install pillow
Доступные опции:
• -u (или --upgrade)- обновление библиотеки с заданным названием до актуальной
версии, имеющейся в репозитории PyPI. Обновляем библиотеку Pillow:
pip install -U pillow
• --force-reinstall- выполняет полную переустановку заданной библиотеки.
Обычно используется вместе с опцией -u;
• --compile- после установки библиотеки откомпилировать ее код. Позволяет уско
рить запуск программ, использующих эту библиотеку.
Если указано лишь название библиотеки, будет установлена наиболее актуальная версия
этой библиотеки.
38 Часть /. Основы языка Python
Если нужно установить определенную версию библиотеки, в качестве параметра <Назва
ние библиотеки> также можно использовать конструкцию такого формата (кавычки обя
зательны):
"<Название библиотеки><Оператор сравнения><Номер версии библиотеки>"
Номер версии устанавливаемой библиотеки задается в формате:
<Номер старшей версии>.<Номер младшей версии>[.<Номер модификации>]
Все номера указываются в виде целых чисел.
Пример установки библиотеки Pillow версии 8.4.0:
p ip install "p illow==8.4.0"
Если номер модификации не указан, будет установлена версия с наиболее актуальной
модификацией, имеющаяся в репозитории. Пример:
p ip install "p illow== 8.4"
Вместо любого из номеров, указываемых в составе версии, можно записать символ под
становки *. В таком случае будет установлена версия библиотеки, в которой соответст
вующий номер будет максимальным из присутствующих в репозитории. Пример уста
новки библиотеки Pillow со старшей версией 7 и наиболее актуальной младшей:
p ip install "p illow=7.*"
Поддерживаются следующие операторы сравнения:
• =-равно;
• <-меньше;
• >-больше;
• <=-не больше (меньше или равно);
• >=-не меньше (больше или равно);
• ,...,= - совместимо (будет описан позже).
Пример установки библиотеки Pillow версии 5.0.0 или более новой:
p ip install "p illow>=S.0.0"
После названия библиотеки можно указать несколько конструкций формата:
<Оператор сравнения><Номер версии>
разделив их запятыми (после которых можно поставить пробелы). Каждая из этих кон
струкций задаст одно условие, которому должна удовлетворять устанавливаемая версия
библиотеки. Будет установлена версия, удовлетворяющая всем указанным условиям.
Пример установки библиотеки Pillow версии не ниже 8.4.0 и меньше 8.6.0:
p ip install "p illow>=B.4.0, <8.6.0"
Что касается оператора ~= (совместимо), то при его использовании будет установлена
либо указанная версия библиотеки, либо, при отсутствии таковой:
• если модификация указана - библиотека с заданными номерами старшей, младшей
версий и указанной или, если таковая отсутствует, наиболее актуальной модифика
цией из имеющихся в репозитории;
Глава 1. Первые шаги 39
• если модификация не указана - библиотека с заданным номером старшей· версии и
указанными или, если таковые отсутствуют, наиболее актуальными младшей версией
и модификацией.
Примеры:
p ip install "p illow-=8.4.0"
p ip install "django~=З.l"
♦ list - вывод списка установлеmn.1х библиотек и их версий. Формат команды:
p ip list [<Опции> ]
Пример:
p ip list
У авторов было выведено:
Package Version
Pillow 8.4.0
p ip 21.2.4
setup tools 58.1.0
Единственная достуШiая здесь оrщия: --format=<Фopмaт вывода>, задающая формат вы
вода. В качестве параметра <Формат вывода> можно указать columns (вьmод в виде таб
лицы, как было показано в приведенном примере, - это формат по умолчанmо), freeze
(вьmод в виде перечня) или json (вьmод в формате JSON). Вот пример вывода списка
установлеmn.1х библиотек, оформленного в виде перечня:
pip list --format=freeze
У авторов бьшо вьmедено:
Pillow==8.4.0
pip=2l.2.4
setup tools= 58.l.0
Вьmод в формате JSON:
p ip list --format=json
У авторов получилось:
[ {"name": "Pillow", "version": "8.4.0"},
{"name": "p ip ", "version": "21.2.4"},
{"name": "setup tools", "version": "58.1.0"}]
ПРИМЕЧАНИЕ
Изначально в комплекте поставки Python уже присутствуют две библиотеки такого рода:
pip, реализующая функциональность одноименной утилиты, и setuptools, предоставляющая
специфические инструменты для установки дополнительных библиотек.
♦ show - вывод сведений об указанной библиотеке. Формат команды:
pip show [<Опции>] <Название библиотеки> ·
Выводятся название библиотеки, ее версия, краткое описание, интернет-адрес «домаш
него» сайта, имя разработчика, его адрес электронной почты, название лицензии, по ко-
40 Часть /. Основы языка Python
торой распространяется библиотека, путь, по которому она установлена, список библио
тек, требующихся ей для работы, и список библиотек, которым она требуется для рабо
ты (если таковые есть). Для примера посмотрим сведения о Pillow:
pip show pillow
Вьmод:
Name: Pillow
Version: 8.4.0
Summary: Python Imaging Library (Fork)
Home-page: https://python-pillow.org
Author: Alex Clark (PIL Fork Author)
Author-einail: [email protected]
License: HPND
Location: c:\python310\lib\site-packages
Requires:
Required-by:
Единственная доступная опция: -f (или --files), которая указывает утилите pip допол
нительно вывести список всех файлов, составляющих библиотеку. Вот пример вывода
сведений о библиотеке Pillow, включая перечень составляющих ее файлов:
pip show -f pillow
♦ uninstall - удаление указанной библиотеки. Формат команды:
pip uninstall [<Опции>] <Название библиотеки>
Сначала будет выведен перечень каталогов, в которых хранятся файлы удаляемой биб
лиотеки, и вопрос, действительно ли пользователь хочет удалить ее. Чтобы подтвердить
удаление, нужно ввести букву у, чтобы отменить его - n, после чего в mобом случае
нажать клавишу <Enter>. Вот пример удаления библиотеки Pillow:
pip uninstall pillow
Из всех доступных опций для нас будет полезна только -у (или --yes), подавляющая вы
вод вопроса на удаление библиотеки. Пример:
pip uninstall -у pillow
♦ help - вывод справочных сведений об утилите pip, поддерживаемых ею командах
и оrщиях. Формат команды:
pip help [<Команда>]
• Если <Команда> не указана - будет выведен список всех поддерживаемых утилитой
pip команд и универсальных опций:
pip help
Того же результата можно достичь, просто запустив в консоли утилиту pip безо вся
. ких параметров.
• Если <Команда> указана - будет выведена справочная информация об этой команде
и всех ее оrщиях, а также перечень универсальных оrщий. В качестве примера выве
дем описание команды install:
pip help install
Глава 1. Первые шаги 41
Универсальные опции, поддерживаемые pip:
♦ --proxy - задает прокси-сервер, через который будет выполняться доступ к Интернету.
Формат использования:
--рrоху=[<Имя пользователя>:<Пароль пользователя>@]<Интернет-адрес>:�
<Номер порта>
Пример:
pip install pillow --proxy=userl23:[email protected]:3128
♦ --no-cache-dir - отключает кеширование заrруженных из репозитория библиотек на локаль
ном диске. Работает только с командой install.
♦ -v (или --verbose)- вывод более подробных сведений о выполняемых утилитой pip
действиях. Опция может быть указана один раз, дважды или трижды, тем самым задавая
вывод все более и более подробных сведений:
pip show pillow -v
pip show pillow -v -v
pip install pillow -v -v -v
Дает эффект не со всеми командами pi_p.
♦ -q (или --quiet)- вывод менее подробных сведений о выполняемых утилитой pip дей
ствиях. Также может быть указана один раз, дважды или трижды, тем самым задавая
вывод все менее и менее подробных сведений:
pip uninstall, pillow -q
pip install pillow -q -q
pip install pillow -q -q -q
Дает эффект не со всеми командами pip.
♦ -h (или --help)- вь1вод справочных сведений о заданной команде pip, всех ее опциях и
универсальных опциях pip (т. е. дает эффект, аналогичный отдаче описанной ранее
команды help с указанием команды, для которой нужно вывести справку). Для примера
выведем сведения о команде uninstall:
pip uninstall -h
Все дополнительные библиотеки устанавливаются в каталог <Каталог установки Python>\
Lib\site-packages.
В составе некоторых библиотек присутствуют программы, запускаемые из консоли. Такие
программы устанавливаются в каталог <Каталог установки Python>\Scripts. Путь к этому
каталогу при установке Python добавляется в список путей из системной переменной РАТН,
поэтому любую из записанных в этом каталоге программ можно запустить, просто набрав
в консоли ее имя.
Если Python был установлен в каталог c:\Pгogram Files (х86) или c:\Program Files, дополни
тельные библиотеки будут устанавливаться по пути с:\Usегs\<Имя учетной записи>\АррDаtа\
Roaming\Python\Python<Hoмep вepcии>\site-packages, а программы, входящие в состав биб
лиотек, - по пути с:\Usегs\<Имя учетной зanиcи>\AppData\Roaming\Python\Python<Hoмep
вepcии>\Scripts. Путь к каталогу программ не добавляется в список путей из переменной
РАТН, и нам его придется добавить туда самостоятельно (или для запуска люб_ой программы
набирать полный путь к ней).
42 Часть /. Основы языка Python
1.9. Доступ к документации
В составе Python поставляется документация по этому языку в формате СНМ. Чтобы от
крыть ее, в меmо Пуск I Python 3.10 нужно выбрать пункт Python 3.10 Manuals (32-Ыt) или
Python 3.10 Manuals (64-blt).
Если в меmо Пуск I Python 3.10 выбрать пункт Python 3.10 Module Docs (32-Ыt) или
Python 3.10 Module Docs (64-blt), запустится сервер документов pydoc (рис. 1.7). Это напи
санный на самом Python веб-сервер, выводящий в веб-браузере документацшо по модулям
стандартной библиотеки Python.
Рис. 1.7. Окно pydoc
Сразу после запуска pydoc откроется веб-браузер, в котором будет выведен список всех
модулей стандартной библиотеки. Щелкнув на имени модуля, мы откроем страницу с опи
санием всех ·классов, функций и констант, объявленных в этом модуле.
Чтобы завершить работу pydoc, следует перекточиться в его окно (см. рис. 1.7), ввести
в нем команду q (от quit, выйти) и нажать клавишу <Enter> - окно при этом автоматически
закроется. А введенная там команда ь (от browser, браузер) повторно выведет в браузере
страницу со списком модулей.
Документацшо по различным языковым конструкциям Python можно получить, запустив
интерпретатор в интерактивном режиме (см. разд. 1.2) и вызвав функцшо help(). В качест
ве примера отобразим документацшо по встроенной функции input() :
»> help(input)
Результат выполнения:
Help on built-in function input in module builtins:
input(prompt=None, /)
Read а string from standard input. The trailing newline is stripped.
The prompt string, if given, is printed to standard output without а
trailing newline before reading input.
If the user hits EOF (*nix: Ctrl-D, Windows: Ctrl-Z+Return), raise EOFError.
On *nix systems, readline is used if availaЫe.
С помощью функции help() можно получить документацmо не только по конкретной
функции, но и по всему модулю сразу. Для этого необходимо предварительно подключить
нужный модуль. Например, подключим модуль builtins, содержащий определения всех
встроенных функций и классов, а затем выведем документацшо по нему:
Глава 1. Первые шаги 43
>>> import builtins
>>> help(builtins)
В разд. 1.4. 1 говорилось, что для комментирования кода часто используются строки доку
ментирования. Такая строка сохраняется в атрибуте _doc_. Функция help() при составле
нии документации получает информацию из этого атрибута.
В качестве примера создадим файл testЗ.py, содержимое которого показано в листинге 1.8.
""" Это описание нашего модуля
def func():
""" Это описание функции"""
pass
Теперь подключим этот модуль и выведем содержимое строк документирования, записан
ных в нем. Все эти действия выполняет код из листинга 1.9.
import testЗ # Подключаем файл testЗ.py
help(testЗ)
input()
Запустим эту программу в окне IDLE Shell или щелчком мыши и получим,результат:
Help on module testЗ:
NАМЕ
testЗ - Это описание нашего модуля
FUNCTIONS
func()
Это описание функции
FILE
d:\dаtа\документы\работа\книги\руthоn 3 и pyqt 6 разработка
приложений\ftр\1\tеstЗ.ру
Теперь получим содержимое строк документирования с помощью атрибута _doc_. Как это
делается, показывает код из листинга 1.10.
import testЗ # Подключаем файл testЗ.py
print(testЗ. doc
print(testЗ.func. doc
input()
Результат выполнения:
Это описание нашего модуля
Это описание функции
44 Часть /. Основы языка Python
Атрибут _doc_ можно использовать вместо функции help(). В качестве примера получим
документацmо по функции input():
>>> print(input. doc
Результат выполнения:
Read а string from standard input. The trailing newline is stripped.
The prompt string, if given, is printed to standard output without а
trailing newline before reading input.
If the user hits EOF (*nix: Ctrl-D, Windows: Ctrl-Z+Return), raise EOFError.
On *nix systems, readline is used if availaЫe.
Получить список всех идентификаторов внутри модуля позволяет функция dir(). Пример
ее использования показывает код из листинга 1.11.
import testЗ # Подключаем файл testЗ.py
print(dir(testЗ))
input()
Результат выполнения:
[' builtins cached doc file loader name
'_y ackage_', '_spec_', 'func']
Теперь получим список всех встроенных идентификаторов:
>>> import builtins
>>> print(dir(builtins))
Будучи вызванной без параметров, функция dir() возвращает список идентификаторов из
текущего модуля:
»> print(dir())
Результат выполнения:
[' annotations ' builtins doc loader name
'_y ackage_', '_spec_']
1.1 О. Компиляция Руthоn-файлов
При запуске любой Руthоn-программы, сохраненной в файле, интерпретатор предваритель
но выполняет ее комnWiяцuю - преобразование кода программы в особое компактное
внутреннее представление. Откомпилированный код сохраняется в оперативной памяти и
запускается на исполнение. Код, прошедший компиляцию, занимает меньше места и быст
рее выполняется.
К сожалению, после завершения выполнения программы откомпилированный код удаляет
ся из памяти. И при повторном запуске этой же программы ее компиляция выполняется
заново, что замедляет запуск.
Глава 1. Первые шаги 45
Однако можно выполнить компиляцию указанного модуля (и даже всех модулей, храня
щихся в указанном каталоге) с сохранением откомпилированного кода в файле. При запуске
такого файла хранящаяся в нем программа запустится очень быстро, поскольку интерпрета
тору не придется выполнять предварительную компиляцию кода.
Для компиляции Руthоn-модулей следует набрать в консоли команду:
python -m compileall <Путь к файлу>l<Путь к каталогу> <Опции>
Можно указать либо путь к файлу модуля, который следует откомпилировать:
python -m compileall c:\work\python\programl.py
либо путь к каталогу - в этом случае будут откомпилированы все модули, хранящиеся как
в каталоге с указанным путем, так и во вложенньIХ в него каталогах:
python -m compileall c:\work\python\big_program
Откомпилированные модули сохранятся в каталоге _pycache_, который создается в ката
логе с исходными Руthоn-модулями, в файлах с именами формата:
<Имя исходного модуля>.сруthоn-<Номер версии Python>.pyc
Например, откомпилированный код модуля hello_world.py (см. листинг 1.1) будет сохранен
в файле _pycache_\hello_world.cpython-31 О.рус.
Расширение рус также ассоциируется с исполняющей средой Python, поэтому файль1 с та
ким расширением можно запускать простым щелчком мышью. А при распространении
Руthоn-программы можно передать конечным пользователям только откомпилированные
файлы, содержащие ее код.
При повторной компиляции будут откомпилированы только те модули, чье содержимое
изменилось после предыдущей компиляции. Python отслеживает изменение содержимого
модулей по дате и времени последнего изменения файлов, в которьIХ они хранятся.
Команда компиляции поддерживает следуюIЦИе полезные опции:
♦ -1 - компилировать только модули, непосредственно находящиеся в каталоге с указан
ным путем. Модули во вложенньrх каталогах компилироваться не будут;
♦ -f - принудцтельно перекомпилировать все модули в указанном каталоге, даже не из-
менившиеся после последней компиляции.
Следует отметить, что при подключении какого-либо модуля с целью использовать создан
ные в нем функции и объекты он всегда компилируется в сохранением результирующего
кода в файл. Это делается для ускорения запуска программ, использующих этот же модуль.
ГЛАВА 2
Переменные и типы данных
2.1. Переменные
Переменная - это ячейка в оперативной памяти компьютера, предназначенная для хране
ния какого-либо значения и имеющая уникальное имя. Обращение к переменной с целью
извлечь хранящееся в ней значение или занести в нее другое значение выполняется по име
ни этой переменной.
Чтобы создать переменную в языке Python, достаточно лишь занести в нее какое-либо зна
чение. Впоследствии в эту же переменную можно заносить любые другие значения. Если
занести в переменную другое значение, хранившееся в ней ранее будет потеряно.
Операция занесения значения в переменную называется присваиванием. Она выполняется
посредством оператора присваивания = (знак равенства), слева от которого ставится имя
нужной переменной, а справа - присваиваемое значение. Примеры:
>>># Присваиваем переменной language_name строковое значение 'Python'
>>> language_name = 'Python'
>>># Присваиваем переменной n число 123
>>> n = 123
Чтобы извлечь из переменной хранящееся в ней значение ·для использования его в вычисле
ниях, следует просто указать имя этой переменной:
>>>#Выводим результат сложения числа из переменной n и 321
>>> print(n + 321)
444
Имя переменной должно состоять из букв (можно использовать буквы любых алфавитов, но
традиционно применяется лишь латиница), цифр и знаков подчеркивания, причем имя пе
ременной не может начинаться с цифры. Кроме того, следует избегать указания символа
подчеркивания в начале имени, поскольку идентификаторам с таким символом определено
специальное назначение (подробности будут приведены в главе 12).
В качестве имен переменной нельзя использовать ключевые слова - слова, посредством
которых в Python составляются всевозможные языковые конструкции. Получить список
всех ключевых слов позволяет такой код:
>>> irnport keyword
>>> keyword.kwlist
['False', 'None', 'True', 'and', 'as', 'assert', 'async', 'await', 'break',
'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'finally',
Глава 2. Переменные и типы данных 47
'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lamЬda', 'nonlocal',
'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield']
Помимо кmочевых слов, следует избегать совпадений со встроенными идентификаторами
(именами функций, классов и модулей, встроенных в язык). Получить полный список
встроенных идентификаторов позволяет следующий код:
>>> import builtins
>>> print(dir(builtins))
Правильные имена переменных: х, yl, strName, str_name.
Неправильные имена переменных: ly, ! important_value ! , global.
И последнее: Python принимает во внимание регистр букв, используемых в именах пере
менных. Например, х их - разные переменные:
>>> х = 10; Х = 20
>>> print(x, Х)
10 20
2.2. Типы данных. Понятие объекта и ссылки
Тип данных - это разновидность значения, обрабатываемого Python, и набор действий, ко
торые могут быть выполнены с этим значением. Поддерживаются следующие типы данных:
♦ int - целое число. Размер числа ограничен лишь объемом оперативной памяти. Пример
(функция type() позволяет определить тип значения):
>>> type(2147483647); type(999999999999999999999999)
(<class_ 'int'>, <class 'int'>)
♦ float - дробное, или вещественное, число:
>>> type(S.l), type(8.5e-3)
(<class 'float'>, <class 'float'>)
♦ bool - логическая величина. Поддерживаются значения True («истина») и False
(«ложь»). Пример:
>>> type(True), type(False)
(<class 'bool'>, <class 'bool'>)
♦ str- строка (последовательность произвольных символов):
>>> type("Строка")
<class 'str'>
♦ list - список (набор пронумерованных значений, называемых элементами, которые
могут быть произвольными, списки можно изменять, добавляя, изменяя и удаляя нахо
дящиеся в них значения):
»> type( [1, 2, 3]
<class 'list'>
Как говорилось ранее, списки можно изменять:
>>> 1 = [1, 2, 3] # Создаем список из трех чисел
>>> print(l)
(1, 2, 3]
48 Часть /. Основы языка Python
»> l[l] = 40 # Изменяем второй элемент
>>> # Нумерация элементов в.списке начинается с О
>» print(l)
[l, 40, 3)
♦ tuple - кортеж (аналогичен списку, но не может быть изменен):
>>> type( (1, 2, 3)
<class 'tuple'>
Попытка изменить кортеж вызовет программную ошибку:
>>> t = (1, 2, 3) # Создаем кортеж из трех чисел
»> t[2] = 60 # ПЫтаемся заменить третий элемент и получаем ОIIП1бку
Traceback (most recent call last):
File "<pyshell#30>", line l, in <module>
t[2] = 60
TypeError: 'tuple' object does not support item assignment
♦ range- диапазон (последовательность целых чисел с заданными начальным, конечным
значениями и разницей между отдельными числами):
>>> type( range(l, 10)
<class 'range'>
♦ sеt-множество (аналогично списку, но хранит лишь уникальные значения):
>>> type( {"а", "Ь", "с"} )
<class 'set'>
♦ frozenset - неизменяемое множество:
>>> type(frozenset(["a", "Ь", "с"]))
<class 'frozenset'>
♦ bytes- неизменяемая последовательность байтов:
>>> type(bytes("Строка", "utf-8"))
<class 'bytes'>
♦ bytearray- изменяемая последовательность байтов:
>>> type(bytearray("Строка", "utf-8") )
<class 'bytearray'>
Типы list, tuple, range, set, frozenset, bytes и bytearray носят общее название после
довательностей, поскольку содержащиеся в них элементы можно перебрать последова
тельно, один за другим (например, в цикле), и выполнить над ними какие-либо действия.
К последовательностям относятся и строки - отдельные символы в них также можно
перебрать;
♦ dict- словари (наборы значений, каждое из которых связано с уникальным ключом, по
которому зто значение можно извлечь):
>>> type( {"х": 5, "у": 20) )
<class 'dict'>
Тип dict называется отображением, поскольку в нем каждый ключ отображается на
связанное с ним значение;
Глава 2. Переменные и типы данных 49
♦ NoneType - «пустой)) тип. Поддерживается единственное значение None, обозначающий
отсутствие mобого «значащего» значения:
>>> type(None)
<class 'NoneType'>
♦ complex - комплексные числа:
»> type(2+2j)
<class 'complex'>
♦ function - функции:
>>> def func(): pass
»> type(func)
<class 'function'>
♦ module - модули:
>>> import sys
>>> type(sys)
<class 'module'>
♦ tуре - классы и типы данных:
>>> class С: pass
>» type(C)
<class 'type'>
>>> type(type(""))
<class 'type'>
Значение каждого типа хранится в оперативной памяти в виде довольно сложной структу
ры, называемой объектом. Помимо собственно значения, в объекте содержатся всевозмож
ные данные, описывающие это значение (например, у строкового значения также хранится
количество символов, содержащихся в строке).
А теперь - важный момент! При присваивании значения, представленного объектом, ка
кой-либо переменной в последmою заносится не само это значение, а ссьmка на него (ссыл
ку можно рассматривать как особый компактный указатель на определенный объект). По
этому, если, например, список присвоить одной переменной, а потом значение этой пере
менной присвоить другой переменной, обе переменные будут содержать ссылки на один и
тот же список. Пример, илmострирующий сказанное:
>>> а [1, 2, 3] # Присваиваем список переменной а
>>> ь = а # Присваиваем значение переменной а (список)
>>> # переменной Ь
>>> print(a, Ь)
[1, 2, 3] [1, 2, 3]
>>> a[l ] = 40 # Изменяем второй элемент списка из переменной а
>>> # как видим, обе переменные сСЫJJаются
>>> print(a, Ь) # на ОДИН и ТОТ же список
[1, 40, 3] [1, 40, 3]
Типы делятся на изменяемые и неизменяемые. Значения изменяемых типов, к которым от
носятся list, set, bytearray и dict, можно изменять (так, можно изменить значение эле-
50 Часть /. Основы языка Python
мента списка или байт из последовательности). Значения неизменяемых типов изменить
нельзя (например, невозможно изменить значение элемента кортежа и символ в строке).
К неизменяемым типам относятся также числа и логические величины. То есть, если при
своить число переменной, а потом присвоить этой же переменной другое число, интерпре
татор не станет заменять значение, хранящееся в существующем числовом объекте, а соз
даст новый числовой объект, который и занесет в переменную. Старый объект при этом
будет удален из памяти.
2.3. Присваивание значений переменным
Присваивание - это занесение в переменную какого-либо значения (при этом значение,
хранившееся в переменной ранее, теряется). Оно выполняется с помощью оператора при
сваивания = (знак равенства). Имя переменной, которой присваивается значение, ставится
слева от оператора, а само присваиваемое значение - справа. Примеры:
>>> х = 7 # Присваивание целого числа (тип int)
>>> у= 7.8 # Присваивание вещественного числа (тип float)
>>> sl = "Строка" # Присваивание строки (тип string)
>>> s2 = 'Строка' # Также присваивание строки
>>> Ь = True # Присваивание логической величины True (тип bool)
В одной строке можно· присвоить значение сразу нескольким переменным (групповое при
сваивание):
>>> х = у= 10 # Переменным х и у присвоено число 10
>>> print(x, у)
10 10
Не забываем, что при этом все переменные получат ссылку на один и тот же объект. Поэто
му групповое присваивание не рекомендуется использовать для значений изменяемых
типов. Пример:
>>> х = у= (1, 2] # Якобы создали два списка
>>> print(x, у)
(1, 2] [1, 2]
>>> y[l] = 100 # Изменяем второй элемент списка
>>> print(x, у)
(1, 100] (1, 100]
Если требуется сохранить в разных переменных разные списки с одинаковым составом зна
чений, придется выполнить раздельное присваивание:
>>> х = (1, 2]
»> у = (1, 2]
»> y[l] = 100 # Изменяем второй элемент
>>> print(x, у)
(1, 2] [1, 100]
Проверить, ссылаются ли две переменные на один и тот же объект, позволяет оператор is.
Если переменные ссылаются на один и тот же объект, оператор is возвращает значение
тrue, в противном случае - False. Пример:
>>> х =у= (1, 2] # Один объект
>>> х is у
True
Глава 2. Переменные и типы данных 51
>>> х= [1, 2] # Разные объекты
»>у= [1, 2] # Разные объекты
>>> х isу
False
Следует заметить, что в целях повышения производительности интерпретатор производит
кеширование малых целых чисел и небольших строк. Это означает, что если ста перемен
ным присвоено число 2, то, скорее всего, в этих переменных будет сохранена ссьmка на
один и тот же объект. Пример:
>>> х= 2; у= 2; z= 2
>>> х isу, у is z
(True, True)
Посмотреть количество ссьmок на указанный объект позволяет функция getrefcount(<Объект>)
из модуля sys:
>>> import sys # Подключаем модуль sys
>>> sys.getrefcount(2)
304
Когда число ссылок на объект становится равно нулю, объект автоматически удаляется из
оперативной памяти. Исключением являются объекты, которые подлежат кешированию.
Помимо группового, Python поддерживает позиционное присваивание. В этом случае пере
менные записываются через запятую слева от оператора =, а присваивание им значения -
через запятую справа. Пример:
>>> х, у, z= 1, 2, 3
>>> print(x, у, z)
1 2 3
С помощью позиционного присваивания можно поменять значения двух переменных мес-
тами:
>>> х, у= 1, 2
>>> х, у
(1, 2)
>>> х, у=у, х
>>> х, у
(2, 1)
По обе стороны оператор� = могут быть указаны последовательности, к каковым относятся
строки, списки, кортежи, диапазоны, типы bytes и bytearray:
>>> х, у, z = "123" # Строка
>>> х, у, z
( 11'' '2 1 , '3')
>>> х, у, z = [1, 2, 3] # Список
>>> х, у, z
(1, 2, 3)
>>> х, у, z= (1, 2, 3) # Кортеж
>>> х, у, z
(1, 2, 3)
52 Часть /. Основы языка Python
>>> [х, у, z] (1, 2, 3) # Список слева, кортеж справа
>>> х, у, z
(1, 2, 3)
Обратите внимание на то, что количество переменных и значений справа и слева от опера
тора = должно совпадать, иначе будет вьшедено сообщение об ошибке:
>>> х, у, z = (1, 2, 3, 4)
Traceback (most receпt са11, last):
File "<pyshell#l30>", line 1, in <module>
х, у, z = (1, 2, 3, 4)
ValueError: too many values to unpack (expected 3)
Python при несоответствии количества переменных и значений справа и слева от оператора =
позволяет сохранить в одной из переменных список, состоящий из «лишних» значений. Для
этого перед именем нужной переменной указывается звездочка(*). Пример:
>>> х, у, *z = (1, 2, 3, 4)
>>> х, у, z
(1, 2, (3, 4])
>>> х, *у, z = (1, 2, 3, 4)
>>> х, у, z
(1, (2, 3]' 4)
>>> *х, у, z = (1, 2, 3, 4)
>>> х, у, z
( (1, 2], 3, 4)
>>> х, у, *z = (1, 2, 3)
>>> х, у, z
(1, 2, [3])
>>> х, у, *z = (1, 2)
>>> х, у, z
(1, 2, [])
Как видно из примера, переменная, перед которой указана звездочка, всегда получает в ка
честве значения список. Если для этой переменной не хватило значений, то ей присваивает
ся пустой список. Следует помнить, что звездочку можно указать только перед одной пере
менной, в противном случае возникнет неоднозначность и интерпретатор выведет сообще
ние об ошибке. Пример:
>>> *х, у, *z = (1, 2, 3, 4)
SyntaxError: two starred expressions in assignment
2.4. Проверка типа данных
Выяснить тип данных, к которому относится заданное значение, позволяет функция
type(<Значение>). В качестве результата она возвращает ссьmку на объект типа. Пример:
>>> type(a)
<class 'int'>
Проверить, принадлежит ли какое-либо значение указанному типу данных, можно следую
щими способами:
Глава 2. Переменные и типы данных 53
♦ сравнить значение, возвращаемое функцией type(), с нужным типом данных:
>>> х = 10
>>> if type(x) = int:
print("Этo целое число (тип int)")
♦ использовать функцию isinstance(<Значение>, <Тип>):
>>> s = "Строка"
>>> if isinstance(s, str):
print("Этo строка (тип str)")
2.5. Преобразование типов данных
Над значением, относящимся к определенному типу, можно производить лишь операции,
допустимые для этого типа. Например, можно складывать друг с другом числа, но строку
сложить с числом нельзя - это приведет к выводу сообщения об ошибке:
>>> 2 + "25"
Traceback (most recent call last):
File "<pyshell#0>", line 1, in <module>
2 + "25"
TypeError: unsupported operand type(s) for +: 'int' and 'str'
Для преобразования значения из одного типа данных в другой предназначены следующие
функции:
♦ bool([<Значение> J ) - преобразует заданное значение в логический тип данных:
>>> bool(0), bool(l), bool(""), Ьооl("Строка"), bool([l, 2]), bool([])
(False, True, False, True, True, False)
♦ int( [ <Значение> [, <Система счисления> J J ) - преобразует заданное значение в число.
Во вторqм параметре можно указать систему счисления (по умолчанию 1 О). Примеры:
>>> int(7.5), int("71")
(7, 71)
>>> int("71", 10), int("71", 8), int("0o71", 8), int("A", 16)
(71, 57, 57, 10)
Если преобразование невозможно, то генерируется исключение:
>>> int("71s")
Traceback (most recent call last):
File "<pyshell#9>", line 1, in <module>
int("71s")
ValueError: invalid literal for int() with base 10: '71s'
♦ float([<Число или строка>]) - преобразует указанное целое число или строку в веще
ственное число:
>>> float(7), float("7.l")
(7 .о, 7.1)
>>> float("Infinity"), float("-inf")
(inf, -inf)
>>> float("Infinity") + float("-inf")
nan
54 Часть /. Основы языка Python
♦ str([<Значение> J ) - преобразует указанное значение в строку:
»> str(l25), str([l, 2, 3))
('125', '[1, 2, 3]')
>>> str((l, 2, 3)), str({"x": 5, "у": 10))
('(1, 2, 3)', "{'у': 10, 'х': 5)")
>>> str(bytes("cтpoкa", "utf-8"))
"b'\\xdl\\x81\\xdl\\x82\\xdl\\x80\\xd0\\xbe\\xd0\\xЬa\\xd0\\xЬ0'"
>>> str(bytearray("cтpoкa", "utf-8"))
"bytearray(b'\\xdl\\x81\\xdl\\x82\\xdl\\x80\\xd0\\xЬe\\xd0�
\\хЬа\\хdО\\хЬО')"
♦ str(<Значение>[, <Кодировка>[, <Обработка оимбок> J J ) - преобразует заданное зна
чение типа bytes или bytearray в строку в указанной кодировке. В третьем параметре
можно указать значение "strict" (при ошибке возбуждается искточение
UnicodeDecodeError - значение по умолчанию), "replace" (неизвестный символ заменя
ется символом, имеющим код \uFFFD) или "ignore" (неизвестные символы игнорируют
ся). Примеры:
>>> objl = bytes("cтpoкal", "utf-8")
>>> obj2 = bytearray("строка2", "utf-8")
>>> str(objl, "utf-8"), str(obj2, "utf-8")
('строкаl', 'строка2')
>>> str(objl, "ascii", "strict")
Traceback (most recent call last):
File "<pyshell#l6>", line 1, in <module>
str(obj1, "ascii", "strict")
UnicodeDecodeError: 'ascii' codec can't decode byte �
0xdl in position О: ordinal not in range(l28)
>>> str(objl, "ascii", "ignore")
11'
♦ bytes(<Строка>, <Кодировка>[, <Обработка оимбок>] ) - преобразует указанную строку
в объект типа bytes в заданной кодировке. В третьем параметре могут быть заданы зна
чения "strict" (по умолчанию), "replace" или "ignore". Примеры:
>>> bytes("строка", "ср1251")
b'\xfl\xf2\xf0\xee\xea\xe0'
>>> bytes("строка123", "ascii", "ignore")
Ь'123'
♦ bytes(<Последовательность>) - преобразует указанную последовательность целых
чисел от О до 255 в объект типа bytes. Если какое-либо число из последовательности
не попадает в диапазон, возбуждается искточение ValueError. Пример:
>>> Ь = bytes([225, 226, 224, 174, 170, 160))
>>> ь
b'\xel\xe2\xe0\xae\xaa\xa0'
>>> str(b, "ср866")
'строка'
♦ bytearray(<Строка>, <Кодировка>[, <Обработка оимбок>] ) - преобразует заданную
строку в объект типа bytearray в указанной кодировке. В третьем параметре могут быть
указаны значения "strict" (по умолчанию), "replace" или "ignore". Пример:
Глава 2. Переменные и типы данных 55
>>> bytearray("cтpoкa", "ср1251")
bytearray(b'\xfl\xf2\xf0\xee\xea\xe0')
♦ bytearray(<Последовательность>) - преобразует заданную последовательность целых
чисел от О до 255 в объект типа bytearray. Если какое-либо число из последовательно
сти не попадает в диапазон, возбуждается искmочение valueError. Пример:
>>> Ь = bytearray([225, 226, 224, 174, 170, 160])
>>> ь
bytearray(b'\xel\xe2\xe0\xae\xaa\xa0')
>>> str(Ь, "ср866")
'строка'
♦ list (<Последовательность>) - преобразует элементы заданной последовательности
в список:
>>> list("l2345") # Преобразование строки
['1', '2', '3', '4', '5']
»> list((1, 2, 3, 4, 5)) # Преобразование кортежа
[1, 2, 3, 4, 5]
♦ tuple(<Последовательность>) - преобразует элементы заданной последовательности
в кортеж:
>>> tuple("l23456") # Преобразование строки
('1', '2'' '3', '4 1, '5', '6')
>>> tuple([1, 2, 3, 4, 5]) # Преобразование списка
(1, 2, 3, 4, 5)
В качестве примера рассмотрим возможность сложения двух чисел, введенных пользовате
лем (листинг 2.1 ).
х = input("x = ") # Вводим 5
у = input("у = ") # Вводим 12
print(x + у)
input()
Результатом выполнения этой программы будет не число, а строка "512". Как видим, функ
ция input() возвращает результат в виде строки. Чтобы просуммировать два числа, необхо
димо преобразовать полученные строки в числа (листинг 2.2).
х = int(input("x ")) # Вводим 5
у = int(input("у = ")) # Вводим 12
print(x + у)
input()
В этом случае мы получим число 17, как и должно быть. Однако если пользователь вместо
числа введет строку, то программа завершится с фатальной ошибкой. Как обработать ошиб
ку, мы разберемся по мере изучения языка.
56 Часть /. Основы языка Python
2.6. Удаление переменных
Удалить переменную можно с помощь19" инструкции следующего формата:
del <Переменная 1>[, . . . , <Переменная N>]
Пример удаления одной переменной:
>>> х = 10
>>> х
10
>>> del х
>>> х
Traceback (most recent call last):
File "<pyshell#l>", line 1, in <module>
del х; х
NameError: name 'х' is not defined
Пример удаления нескольких переменных:
>>> х, у= 10, 20
>>> del х, у
ГЛАВА 3
Операторы
Оператор - языковая конструкция, выполняющая над переданными ему значениями (опе
рандами) какое-либо элементарное действие (например, математическое сложение). Набор
операторов, поддерживаемых Python, определен разработчиками этого языка и не может
быть расширен (в отличие от набора поддерживаемых функций, определение которых опи
сывается в главе 11).
3.1. Математические операторы
Производить операции над числами позволяют математические операторы:
♦ + - сложение:
>>> 10 + 5 # Целые числа
15
>>> 12.4 + 5.2 # Вещественные числа
17 .6
>>> 10 + 12.4 # Целые и вещественные числа
22.4
♦ - - вычитание:
>>> 10 - 5 # Целые числа
5
>>> 12.4 - 5.2 # Вещественные числа
7.2
>>> 12 - 5.2 # Целые и вещественные числа
6.8
♦ * - умножение:
>>> 10 * 5 # Целые числа
50
>>> 12.4 * 5.2 # Вещественные числа
64.48
>>> 10 * 5.2 # Целые и вещественные числа
52.0
· ♦ / - деление. Результатом деления всегда является вещественное число, даже если про
изводится деление целых чисел. Примеры:
58 · Часть /. Основы языка Python
»> 10 / 5 # Деление целых чисел без остатка
2.0
»> 10 / 3 # Деление целых чисел с остатком
3.3333333333333335
»> 10.0 / 5.0 # Деление вещественных чисел
2.0
»> 10.0 / 3.0 # Деление вещественных чисел
3.3333333333333335
»> 10 / 5.0 # Деление целого числа на вещественное
2.0
»> 10.0 / 5 # Деление вещественного числа на целое
2.0
♦ / / - деление с округлением вниз. Остаток всегда отбрасьmается. Примеры:
>» 10 // 5 # Деление целых чисел без остатка
2
»> 10 // 3 # Деление целых чисел с остатком
3
»> 10.0 // 5.0 # Деление вещественных чисел
2.0
»> 10.0 // 3.0 # Деление вещественных чисел
3.0
»> 10 // 5.0 # Деление целого числа на вещественное
2.0
»> 10 // 3.0 # Деление целого числа на вещественное
3.0
»> 10.0 // 5 # Деление вещественного числа на целое
2.0
»> 10.0 // 3 # Деление вещественного числа на целое
3.0
♦ % - остаток от деления:
»> 10 % 5 # Деление целых чисел без остатка
о
»> 10 % 3 # Деление целых чисел с остатком
1
>>> 10.0 % 5.0 # Операция над вещественными числами
о.о
>>> 10.0 % 3.0 # Операция над вещественными числами
1.0
>>> 10 % 5.0 # Операция над целыми и вещественными числами
о.о
>>> 10 % 3.0 # Операция над целыми и вещественными числами
1.0
>>> 10.0 % 5 # Операция над целыми и вещественными числами
о.о
>>> 10.0 % 3 # Операция над целыми и вещественными числами
1.0
♦ ** - возведение в степень. Основание указывается первым операндом, показатель -
вторым. Примеры:
Глава 3. Операторы 59
>>> 10 ** 2, 10.0 ** 2
(100, 100.0)
♦ унарный минус ( - ) - изменяет знак числа на противоположный:
>>> -10, -10.0, -(-10), -(-10.0)
(-10, -10.0, 10, 10.0)
♦ унарный плюс ( +) - ничего не делает с числом 1 :
»> +10, +10.0)
(10, 10.0)
Как видно из приведенных примеров, операции над числами разных типов возвращают чис
ло, имеющее более сложный из типов, участвующих в операции. Целые числа имеют самый
простой тип, далее идут веществе�rnые числа и самый сложный тип - комплексные числа.
Таким образом, если в операции участвуют целое число и вещественное, то целое число
будет автоматически преобразовано в вещественное число, затем будет произведена опера
ция над вещественными числами, а результатом станет вещественное число.
При выполнении операций над веществеmп,1ми числами следует учитывать ограничения
точности вычислений. Например, результат следующей операции может показаться стран
ным:
>>> 0.3 - 0.1 - 0.1 - 0.1
-2.7755575615628914е-17
Ожидаемым бьш бы результат о . о, но, как видно из примера, мы получили совсем другой
результат. Если необходимо производить операции с фиксированной точностью, следует
использовать модуль decimal. Пример:
>>> from decimal import Decimal
>>> Decimal("0.3") - Decimal("0.l") - Decimal("0.l") - Decimal("0.l")
Decimal( ' О . О ' )
3.2. Двоичные операторы
Двоичные операторы предназначены для манипуляции отдельными битами:
♦ ~ - двоичная инверсия. Значение каждого бита заменяется на противоположное:
>>> х 100 # 01100100
>>> х ~х # 10011011
♦ & - двоичное И:
>>> х = 100 # 01100100
>>> у= 75 # 01001011
>>> z = х & у # 01000000
♦ 1 - двоичное ИЛИ:
>>> х = 100 # 01100100
>>> у= 75 # 01001011
>>> z = х 1 у # 01101111
1 Не совсем понятно, зачем нужен этот оператор...
60 Часть /. Основы языка Python
♦ л - двоичное искmочающее ИЛИ:
>>> х = 100 # 01100100
»>у= 250 # 11111010
>>> z = х л у # 10011110
♦ « - сдвиг влево - сдвигает двоичное представление числа, заданного первым операн
дом, влево на количество разрядов, указанное вторым операндом, и заполняет разряды
справа нулями:
>>> х = 100 # 01100100
>>>у= х << 1 # 11001000
>>> z =у<< 1 # 10010000
>>> k = z << 2 # 01000000
♦ » - сдвиг вправо - сдвигает двоичное представление числа, заданного первым опе
рандом, вправо на количество разрядов, указанное вторым операндом, и заполняет раз
ряды слева нулями, если число положительное, и единицами, если число отрицательное:
>>> х = 100 # 01100100
>>>у= х >> 1 # 00110010
>>> z =у>> 1 # 00011001
>>> k = z >> 2 # 00000110
>>> х = -127 # 10000001
>>>у= х >> 1 # 11000000
>>> z =у>> 2 # 11110000
>>> k = z << 1 # 11100000
>>> m = k >> 1 # 11110000
3.3. Операторы
для работы с последовательностями
Для работы с последовательностями предназначены следующие операторы:
♦ + - конкатенация (объединение):
>>> print("Cтpoкal" + "Строка2") # Конкатенация строк
Строка1Строка2
>>> (1, 2, 3] + (4, 5, 6] # Списки
(1, 2, 3, 4, 5, 6]
>>> (1, 2, 3) + (4, 5, 6) # Кортежи
(1, 2, 3, 4, 5, 6)
♦ * - повторение. Повторяет последовательность из первого операнда количество раз,
указанное вторым операндом. Примеры:
>>> "s" * 20 # Строки
'ssssssssssssssssssss'
>>> (1, 2] * 3 # Списки
(1, 2, 1, 2, 1, 2]
>>> (1, 2) * 3 # Кортежи
(1, 2, 1, 2, 1, 2)
Глава 3. Операторы 61
♦ in - проверка на вхождение. Если значение, заданное первым операндом, входит в по
следовательность, указанную вторым операндом, то возвращается логическое значение
True, в противном случае - False. Примеры:
>>> "Строка" in "Строка для поиска" # Строки
True
>>> "Буква" in "Строка для поиска" # Строки
False
>>> 2 in [l, 2, 3], 4 in [l, 2, 3] # Списки
(True, False)
>>> 2 in (1, 2, 3), 6 in (1, 2, 3) # Кортежи
(True, False)
♦ not in - проверка на невхождение. Если значение, заданное первым операндом, не
входит в последовательность, указанную вторым операндом, то возвращается значение
True, в противном случае - False. Примеры:
>>> "Строка" not in "Строка для поиска" # Строки
False
>>> "Буква" not in "Строка для поиска" # Строки
True
>>> 2 not in [l, 2, 3], 4 not in [l, 2, 3] #·списки
(False, True)
>>> 2 not in (1, 2, 3), 6 not in (1, 2, 3) # Кортежи
(False, True)
3.4. Операторы присваивания
Операторы присваивания предназначены для сохранения значения в переменной:
♦ = - простое присваивание:
>>> х = 5
>>> х
5
♦ += - присваивание со сложением - увеличивает значение переменной на величину из
второго операнда:
>>> х = 5; х += 10 # Эквивалентно х = х + 10
>>> х
15
Будучи примененным к последовательностям, оператор += производит конкатенацию:
>>> s = "Python"; s += " 3.10"
>>> print(s)
Python 3.10
♦ -= - присваивание с вычитанием - уменьшает значение переменной на величину из
второго операнда:
>>> х = 10; х -= 5 # Эквивалентно х = х - 5
>>> х
5
62 Часть /. Основы языка Python
♦ *=- присваивание с умножением - умножает значение переменной на величину из
второго операнда:
>>> х = 10; х *= 5 # Эквивалентно х = х * 5
>>> х
50
Будучи примененным к последовательности, оператор *= производит повторение:
>>> s = "*"; s *= 20
>>> s
'********************'
♦ /=- присваивание с делением - делит значение переменной на величину из второго.
операнда:
>>> х = 10; х /= 3 # Эквивалентно х = х / 3
>>> х
3.3333333333333335
>>>у= 10.0; у/= 3.0 # Эквивалентноу у/ 3.0
>>>у
3.3333333333333335
♦ / /= - присваивание с делением и округлением вниз - делит значение переменной на
величину из второго операнда и округляет результат вниз:.
>>> х = 10; х //= 3 # Эквивалентно х = х // 3
>>> х
3
>>>у= 10.0; у//= 3.0 # Эквивалентноу у// 3.0
>>> у
3.0
♦ %= - присваивание с делением по модулю - делит по модулю значение переменной на
величину из второго операнда:
>>> х = 10; х %= 2 # .Эквивалентно х = х % 2
>>> х
о
>>>у 10; у%= 3 # Эквивалентноу у% 3
>>>у
1
♦ ** =- присваивание с возведением в степень - возводит значение переменной в сте
пень, заданную вторым _операндом:
>>> х = 10; х **= 2 # Эквивалентно х = х ** 2
>>> х
100
♦ : = (начиная с Python 3.8) - присваивание в составе сложного выражения (рассмотрен
в главе 4).
Глава 3. Операторы 63
3.5. Пустой оператор
Пустой оператор pass ничего не делает:
>>> pass # Ничего не делаем
>>> pass # Снова ничего не делаем
>>> print ( "Что-то сделали")
Что-то сделали
Обычно пустой оператор используется, чтобы временно определить «пустую», ничего не
делающую функцию или «пустой» класс (определения функций и классов описываются
в главах 11 и 13):
def ernpty_function(): pass
class empty_class: pass
Впоследствии такие «пустые» функции и классы наполняются необходимым содержимым.
3.6. Приоритет операторов
Приоритет операторов - это очередность, в которой выполняются различные операторы
Python. Например, оператор умножения будет выполнен раньше оператора сложения, по
скольку приоритет первого выше, чем у второго.
Рассмотрим следующее выражение:
х = 5 + 10 * 3 / 2
Последовательность его вычисления будет такой:
1. Число 10 будет умножено на 3, поскольку приоритет оператора умножения выше при
оритета оператора сложения.
2. Полученное значение будет поделено на 2, поскольку приоритет оператора деления
равен приоритету оператора умножения_ (а операторы с равными приоритетами выпол
няются слева направо), но выше, чем у оператора сложения.
3. К полученному значению будет прибавлено число 5.
4. Значение будет присвоено переменной х, поскольку оператор присваивания = имеет
наименьший приоритет.
>>> х = 5 + 10 * 3 / 2
>>> х
20.0
С помощью скобок можно изменить последовательность вычисления выражения
х = (5 + 10) * 3 / 2
Теперь порядок вычислений станет инъrм:
1. К числу 5 будет прибавлено 10.
2. Полученное значение будет умножено на 3.
3. Полученное значение будет поделено на 2.
4. Значение будет присвоено переменной х.
64 Часть /. Основы языка Python
>>> х = (5 + 10) * 3 / 2
>>> х
22.5
Перечислим операторы в порядке убывания приоритета:
1. -х, +х, ~х, ** - унарный минус, унарный плюс, двоичная инверсия, возведение в сте
пень. Если унарные операторы расположены слева от оператора **, то возведение в сте
пень имеет больший приоритет, а если справа - то меньший. Например, выражение
-10 ** -2
эквивалентно следующей расстановке скобок:
- (10 ** (-2))
2. *, %, /, // - умножение (повторение), остаток от деления, деление, деление с округле-
нием вниз.
3. +,--сложение (конкатенация), вычитание.
4. «, » - двоичные сдвиги.
5. & - двоичное И.
6. л - двоичное искmочающее ИЛИ.
7. двоичное ИЛИ.
1 -
8. =, +=, -=, *=, /=, //=, %=, **= - присваивание.
ГЛАВА 4
Инструкции ветвления, выбора
и циклы
Инструкция ветвления позволяет при выполнении какого-либо условия исполнить один
блок кода, а при невыполнении условия - другой. Инструкция выбора, если указанная пе
ременная хранит одно значение, исполняет первый блок кода, если переменная хранит вто
рое значение - второй блок кода, если третье - третий блок кода и т. д. Два вида циЮ1ов
выполняют указанный блок кода либо столько раз, сколько элементов содержится в задан
ной последовательности, при этом перебирая ее элементы, либо пока выполняется заданное
условие.
В качестве условий в подобного рода инструкциях применяются выражения, в качестве
результата выдающие логическую величину True («истина», условие выполняется, или ис
тинно) или False («ложь», условие не выполняется, или ложно).
Также в качестве условия можно использовать выражение, выдающее результат любого
другого типа, который в этом случае будет автоматически приведен к логическому типу:
♦ в значение True будут преобразованы:
• любое число, не равное нулю:
>>> bool(l), Ьоо1(20), bool(-20)
(True, True, True)
>>> bool(l.O), bool(O.l), bool(-20.0)
(True, True, True)
• не пустой объект:
>>> bool("O"), bool([O, None]), bool((None,)), bool({"x": 5))
(True, True, True, True)
♦ в значение False будут преобразованы:
• число, равное нулю:
>>> bool(O), bool(O .O)
(False, False)
• пустой объект:
»> bool('"'), bool( []), bool(())
(False, False, False)
• значение None:
>>> bool(None)
False
бб Часть /. Основы языка Python
4.1. Операторы сравнения
Операторы сравнения применяются в условиях, чтобы сравнить значения указанных опе
рандов:
♦ = - равно - значения обоих операндов должны быть равны друг другу:
>>> 1 == 1, 1 = 5
(True, False)
♦ ! = - не равно - значения обоих операндов должны быть не равны друг другу:
>>> 1 != 5, 1 != 1
(True, False)
♦ < - меньше - первый операнд должен быть меньше второго:
>>> 1 < 5, 1 < О
(True, False)
♦ > - больше - первый операнд должен быть больше второго:
>>> 1 > о, 1 > 5
(True,. False)
♦ <= - меньше WIU равно - первый операнд должен быть меньше или равен второму:
>>> 1 <= 5, 1 <= о, 1 <= 1
(True, False, True)
♦ >= - больше WIU равно - первый операнд должен быть больше или равен второму:
>>> 1 >= о, 1 >= 5, 1 >= 1
(True, False, True)
♦ in - вхождение - первый операнд должен входить в последовательность из второго
операнда:
>>> "Строка" in "Строка для поиска" # Строки
True
>>> 2 in [1, 2, 3], 4 in [1, 2, 3] # Списки
(True, False)
>>> 2 in (1, 2, 3), 4 in (1, 2, 3) # Кортежи
(True, False)
Оператор in также можно использовать для проверки существования ключа в словаре:
>>> "х" in {"х": 1, "у": 2}, "z" in {"х": 1, "у": 2}
(True, False)
♦ not in - невхождение - первый операнд не должен входить в последовательность из
второго операнда:
>>> "Строка" not in "Строка для поиска" # Строки
False
>>> 2 not in [1, 2, 3], 4 not in [1, 2, 3] # Списки
(False, True)
>>> 2 not in (1, 2, 3), 4 not in (1, 2, 3) # Кортежи
(False, True)
Глава 4. Инструкции ветвления, выбора и циклы 67
♦ is - переме1rnые, заданные операндами, должны ссьшаться на один и тот же объект:
>>> х=у= (1, 2]
>>> х is у
True
>>> х= (1, 2],; у= (1, 2]
>>> х is у
False
♦ is not - переменные, заданные операндами, должны ссылаться на разные объекты:
>>> х=у= [1, 2]
>>> х is not у
False
>>> х= (1, 2]; у= (1, 2]
>>> х is not у
True
Значение логического выражения можно инвертировать (изменить на противоположное)
с помощью оператора логического НЕ - not:
>>> х= 1; у= 1
>>> х -- у
True
>>> not (х - у), not х -- у
(False, False)
Круглые скобки здесь можно не указывать, поскольку оператор not имеет более низкий
приоритет, чем операторы сравнения.
В логическом выражении можно указывать сразу несколько условий:
>>> х= 10
>>> 1 < х < 20, 11 < х < 20
(True, False)
(
Несколько логических выражений можно объединить в одно большое с помощью следую
щих операторов:
♦ and - логическое И - если оба операнда равны тrue, возвращается True, в противном
случае - False:
>>> 1 < 5 and 2 < 5 # True and True = True
True
>>> 1 < 5 and 2 > 5 # True and False False
False
>>> 1 > 5 and 2 < 5 # False and True False
False
Если значение перв�го операнда не относится к логическому типу, интерпретатор пре
образует его в логический тип. Если после преобразования получается False, то возвра
щается значение первого операнда, в противном случае - значение второго операнда.
Пример:
>>> 10 and 20, О and 20, 10 and О
(20, О, О)
68 Часть /. Основы языка Python
♦ or - логическое ИЛИ - если хотя бы один операнд равен тrue, возвращается True,
в противном случае - False:
>>> 1 < 5 or 2 < 5 # True or True == True
True
>>> 1 < 5 or 2 > 5 # True or False True
True
>>> 1 > 5 or 2 < 5 # False or True = True
True
>>> 1 > 5 or 2 > 5 # False or False == False
False
Если значение первого операнда не относится к логическому типу, интерпретатор пре
образует его в логический тип. Если после преобразования получается False, то возвра
щается значение второго операнда, в противном случае - значение первого операнда.
Пример:
>>> 10 or 20, О or 20, 10 or О
(10, 20, 10)
>>> О or "" or None or [] or "s"
's'
Перечислим операторы сравнения в порядке убывания приоритета:
1. <, >, <=, >=, =, ! =, <>, is, is not, in, not in.
2. not - логическое отрицание.
3. and- логическое И.
4. or - логическое ИЛИ.
4.2. Инструкция ветвления
Инструкция ветвления при выполнении одного заданного условия исполняет один блок
кода, при выполнении другого условия - другой, при выполнении третьего - третий, а
при невыполнении всех условий - четвертый. Оно записывается в следующем формате:
if <Условие 1>:
<Блок, исполняемый, если выполняется условие 1>
[elif <Условие 2>:
<Блок, исполняемый, если выполняется условие 2>
elif <Условие 3>:
<Блок, исполняемый, если вьmолняется условие 3>
elif <Условие n>:
<Блок, исполняемый, если выполняется условие n>
[else:
<Блок, испо/Iняемый, если ни одно условие не выполняется>
Условий и соответствующих им блоков может быть произвольное количество.
Глава 4. Инструкции ветвления, выбора и циклы 69
Выражения, входящие в блок, должны выделяться отступом слева, содержащим одинаковое
количество пробелов (обычно четыре). Концом блока является инструкция, перед которой
расположено меньшее количество пробелов.
Напишем программу, которая проверяет, является ли введенное пользователем число чет
ным, и выводит соответствующее сообщение (листинг 4.1 ).
х = int(input("Введите число: ") )
if х % 2 == О:
print(х, " четное число")
else:
print(x, " - нечетное число")
input()
Если блок состоит из одной инструкции, эту инструкцmо можно разместить на одной стро
ке с языковой конструкцией if, elif или else:
х = int(input("Введите число: ") )
if х % 2 == О: print(x, " - четное число")
else: print(x, " - нечетное число")
В таком случае концом блока является конец строки. Это означает, что инструкции, входя
щие в блок, можно разместить на одной строке, разделяя их точкой с запятой. Пример:
х = int(input("Введите число: ") )
if х % 2 == О: print(x, end=" "); print("- четное число")
else: print(x, end=" "); print("- нечетное число")
СОВЕТ
Код, подобный приведенному в этом примере, плохо читается. Поэтому всегда размещайте
все инструкции на отдельных строках.
Как говорилось ранее, выражение ветвления может содержать произвольное количество
условий и соответствующих им блоков. Рассмотрим это на примере (листинг 4.2).
1 Листинr;с.2. п· .
print("""Kaкoй операционной системой вы пользуетесь?
1 - Windows 11
2 - Windows 10
3 - Windows 8.1
4 - Windows 8
5 - Windows 7
6 - Другая""")
os = inрut("Введите число, соответствукхцее ответу: ")
if os == "1'':
print("Вы выбрали: Windows 11")
elif os -- "2":
print("Вы выбрали: Windows 10")
elif os -- "З":
print("Bы выбрали: Windows 8 .1")
70 Часть /. Основы языка Python
elif os = "4":
print("Bы вы6рали: Windows 8")
elif os == "5":
print("Вы вы6рали: Windows 7")
elif os == "6":
print("Bы вы6рали: другая")
elif not os:
print("Bы не ввели число")
else:
print("Мы не смогли определить вашу операционную систему")
input()
Обратите внимание, что условие в последней конструкции elif не содержит операторов
сравнения:
elif not os:
Такая запись эквивалентна следующей:
elif os == "":
Пустая строка всегда преобразуется в False, и, чтобы условие в этом случае считалось вы
полненным, нам следует инвертировать полученный результат оператором not.
Одну инструкцию ветвления можно вложить в другую. В этом случае отступ у блоков вло
женной инструкции должен быть в два раза больше (листинг 4.3).
print("""Кaкoй операционной системой вы пользуетесь?
1 - Windows 11
2 - Windows 10
3 - Windows 8.1
4 - Windows 8
5 - Windows 7
6 - Другая""")
os = inрut("Введите число, соответствуюцее ответу: ")
if os != 1111 .
if os - "1":
print("Bы вы6рали: Windows 11")
elif os - "2":
print("Вы вы6рали: Windows 10")
elif os -- "З":
print("Bы выбрали: Windows 8 .1")
elif os - "4":
print("Bы вы6рали: Windows 8")
elif os - "5":
print("Bы выбрали: Windows 7")
elif OS - "6":
print("Bы вы6рали: другая")
else:
print("Мы не смогли определить вашу операционную систему")
Глава 4. Инструкции ветвления, выбора и циклы 71
c:lse:
print("Bы не ввели число")
:nput ()
Инструкция ветвления может быть записана в альтернативном формате:
<Если истина> if <Условие> else <Если ложь>
Если заданное условие выполняется, инструкция возвращает значение <Если истина>,
в противном случае - значение <Если ложь>. Возвращенное значение можно вывести
в консоль, присвоить какой-либо переменной или использовать в последующих вычислени
ях. Пример:
>>> print("Дa" if 10 % 2 = О else "Нет")
да
>>> s = "Да" if 10 % 2 == О else "Нет"
>>> s
'да'
>>> s = "да" if 11 % 2 О else "Нет"
>>> s
'Нет'
4.3. Инструкция выбора
Инструкция выбора, если проверяемое значение совпадает с образцом 1, исполняет блок 1,
если совпадает с образцом 2 - блок 2 и т. д. Если же проверяемое значение не совпадает ни
с одним из указанных образцов, будет выполнен <Блок _> (если он присутствует, если же
этот блок отсутствует, ничего не произойдет). Поддержка этой инструкции появилась
в Python 3.1 О.
Формат записи инструкции выбора:
match <Проверяемое значение>:
case <Образец 1>:
<Блок 1>
case <Образец 2>:
<Блок 2>
case <Образец n>:
<Блок n>
[case
<Блок_>]
Проверяемое значение и образцы могут принадлежать к mобым типам. Языковых конст
рукций case, содержащих образцы и соответствующие им блоки, может быть произвольное
количество.
В качестве примера перепишем программу, чей код приведен в листинге 4.2, с применением
инструкции выбора (листинг 4.4).
print("""Кaкoй операционной системой вы пользуетесь?
1 - Windows 11
2 - Windows 10
72 Часть /. Основы языка Python
3 - Windows 8.1
4 - Windows 8
5 - Windows 7
6 - Другая'""')
os = inрut("Введите число, соответствук:щее ответу: ")
match os:
case "1":
print("Вы выбрали: Windows 11")
case "2":
print("ВЫ выбрали: Windows 10")
case "3":
print("ВЫ выбрали: Windows 8 .1")
case "4":
print("Bы выбрали: Windows 8")
case "5":
print("Вы выбрали: Windows 7")
case "6":
print("Вы выбрали: другая")
case ""·
print("ВЫ не ввели число")
case -:
print("Мы не смогли определить вашу операционную систему")
input()
Сразу уясним, что исполняется только один блок - соответствующий первому совпавшему
образцу. После этого обработка инструкции прекращается, и начинают исполняться инст
рукции, следующие за ней. Так что при выполнении кода:
os = "1"
match os:
case "1":
print("ВЫ выбрали: Windows 11")
case "1":
рrint("Отличный выбор!")
case "2":
print("ВЫ выбрали: Windows 10")
в консоли появится лишь строка:
ВЫ выбрали: Windows 11
Рассмотрим особенности обработки инструкцией выбора проверяемых значений разных
типов:
♦ числа, строки и логические величины - образцы указьшаются в виде соответственно
чисел, строк и логических величин (пример см. в листинге 4.4);
♦ последовательности - образец указьшается в виде кортежа (также можно указать спи
сок). При этом образец может быть задан:
• с явным перечислением всех значений - проверяемая последовательность должна
содержать только заданные в образце значения, находящиеся в заданных позициях:
match seq:
case (1, 2, 3):
рrint("Последовательность 1: 1, 2, 3")
Глава 4. Инструкции ветвления, выбора и циклы 73
case (1, 2, 3, 4):
рrint("Последовательность 2: 1, 2, 3, 4")
case (3, 2, 1):
рrint("Последовательность 3: 3, 2, 1")
case
print("Дpyгaя последовательность")
Результаты:
seq (1, 2, 3) => Последовательность 1: 1, 2, 3
seq (1, 2, 3, 4) => Последовательность 2: 1, 2, 3, 4
seq (3, 2, 1) => Последовательность 3: 3, 2, 1
seq (1, 2, 3, 4, 5) => Другая последовательность
seq ( 3, 2) => Другая последовательность
• с явным указанием части значений (вместо остальных явно заданных значений ста
вятся какие-либо переменные)- проверяемая последовательность должна содер
жать, по крайней мере, заданные значения, находящиеся в заданных позициях.
Остальные значения будут присвоены указанным в образце переменным, которые
станут доступны в блоке. Пример:
match seq:
case (1, 2, 3):
pr,int("Последовательность 1: 1, 2, 3")
case (1, 2, 3, rn):
рrint("Последовательность 2: 1, 2, 3, " + str(rn))
case (n, 2, 1):
print("Последовательность 3: " + str(n) + ", 2, 1")
case
print("Дpyгaя последовательность")
Результаты:
seq (1, 3)
2, => Последовательность 1: 1, 2, 3
seq (1, 2,
3, 4) => Последовательность 2: 1, 2, 3, 4
seq (1, 3, 56)
2, => Последовательность 2: 1, 2, 3, 56
seq (3, 2,
1) => Последовательность 3: 3, 2, 1
seq (800, 2, 1) => Последовательность 3: 800, 2, 1
seq (1, 2, 3, 4, 5) => Другая последовательность
Также можно указать в образце переменную, предварив ее символом звездочки (* ).
В эту переменную будет занесен список со всеми оставшимися элементами прове
ряемой последовательности. Пример:
match seq:
case (1, 2, 3, *а):
рrint("Последовательность 1: 1, 2, 3, " + str(a))
case (*Ь, 2, 1):
рrint("Последовательность 2: " + str(b) + 2, 1")
case
print("Дpyгaя последовательность")
Результаты:
seq (1, 2, 3, 4) => Последовательность 1: 1, 2, 3, [ 4]
seq (1, 2, 3 , 4, 5) => Последовательность 1: 1, 2, 3, [4, 5]
74 Часть /. Основы языка Python
seq (1, 2, 3) => Последовательность 1: 1, 2, 3, []
seq (5, 4, 3, 2, 1) => Последовательность 2: [5, 4, 3], 2, 1
seq (3, 2) => Другая последовательность
В последнем случае вместо переменной можно указать символ подчеркивания - то
гда оставшиеся значения проверяемой последовательности не будут сохранены ни
в какой переменной:
match seq:
case (1, 2, 3, * ) :
рrint("Последовательность 1: 1, 2, 3 и, возможно, " +
"какие-либо другие элементы")
♦ отображения - образец указывается в виде словаря. Образец можно задать:
• с явным указанием всех значений - проверяемое отображение должно содержать, по
крайней мере, заданные в образце значения под указанными кточами:
match mpn:
case {"а": 1, "Ь": 2}:
рrint("Отображение 1: а - 1, Ь - 2")
case {"а": 1, "с": 3 }:
рrint("Отображение 2: а - 1, с - 3")
case
print("Дpyгoe отображение")
Результаты:
mpn {"а": 1, "Ь": 2} => Отображение 1: а 1, ь 2
mpn {"а": 1, "Ь": 2, "с": 3}, => Отображение 1: а - 1, ь 2
mpn {"а": 1, "с": 3} => Отображение 2: а - 1, с - 3
mpn {"е": 11, "f" : -32) => Другое отображение
• с явным указанием части значений (у остальных после кточей ставятся перемен
ные) - проверяемое отображение должно содержать, по крайней мере, заданные
значения и какие-либо значения, указанные под кточами, в которых поставлены пе
ременные. Значения из кточей с переменными будут присвоены этим переменным,
которые станут доступными в блоке. Пример:
match mpn:
case {"а": 1, "Ь": 2, "d": d}:
print("Отображение 1: а - 1, Ь - 2, d - " + str(d))
case {"а": 1, "Ь": 2}�
рrint("Отображение 2: а - 1, Ь - 2")
Результаты:
mpn {"а": 1, "Ь": 2, "d": 3) => Отображение 1: а - 1, ь - 2, d - 3
mpn {"а": 1, "Ь": ·2, "d": 25} => Отображение 1: а - 1, ь - 2, d - 25
mpn {"а": 1, "Ь": ·2) => Отображение 2: а - 1, ь - 2
mpn {"а": 1, "Ь": 2, "с": 3) => Отображение 2: а - 1, ь - 2
После перечисления значений в образце можно поставить переменную, предварив ее
двойным символом звездочки(**). В эту переменную будет занесен словарь со всеми
оставшимися элементами проверяемого отображения. Пример:
Глава 4. Инструкции ветвления, выбора и циклы 75
rnatch mpn:
case {"а": 1, "Ь": 2, **d):
print("Отображение 1: а - 1, Ь - 2, " + str(d))
case {"а": 1, "d": 4):
рrint("Отображение 2: а - 1, d - 4")
Результаты:
mpn {"а": 1, "Ь": 2, "с": 3)
=> Отображение 1: а - 1, Ь - 2, {'с': 3)
mpn {"а": 1, "Ь": 2, "с": 3, "d": 4)
=> Отображение 1: а - 1, ь - 2, {'с': 3, 'd': 4)
mpn {"а'': 1, "Ь": 2) => Отображение 1: а - 1, ь - 2, {)
mpn d :
{"а": 1, " " 4) = > Отображение 2: а - 1, d - 4
♦ объекты классов (описаны в главе 1 3) - можно проверять:
• принадлежность проверяемого объекта указанному классу - образец записывается
в формате <Имя нужного класса>():
import datetime
rnatch val:
case str():
print("Строка")
case int():
print("Цeлoe число")
case datetime.datetime():
рrint("Временная отметка")
Результаты:
val "Python" => Строка
val 589 => Целое число
val datetime.datetime(2020, 12, 28) => Временная отметка
• дополнительно - наличие в атрибутах проверяемого объекта указанных значений -
образец записывается в формате:
<Имя нужного класса>(<Атрибут l>=<Значение атрибута 1>,
<Атрибут 2>=<Значение атрибута 2>,
<Атрибут n>=<Значение атрибута n>)
Пример:
import datetime
rnatch val:
case str():
print("Строка")
case datetime.datetime(year=2020, month=l2, day=28):
print("28 декабря 2020 года")
case datetime.datetime(year=2021, month=l, day=l):
print("l января 2021 года")
case datetime.datetime():
print("Другие дата и время")
76 Часть /. Основы языка Python
. Результаты:
val "Python" => Строка
val datetime.datetime(2020, 12, 28) => 28 декабря 2020 года
val datetime.datetime(2021, 1, 1) => 1 января 2021 года
val datetime.datetime(2021, 1, 2) => Другие дата и время
В конструкции <Атрибут>=<Значение атрибута> вместо значения атрибута можно за
дать переменную. Эта переменная получит значение, хранящееся в соответствующем
атрибуте проверяемого объекта класса, и будет доступна в блоке. Пример:
import datetime
match val:
case datetime.datetime(year=2021, month=l, day=l):
print("l января 2021 года")
case datetime.datetime(year=2021, month=2, day=d):
print(str(d) + " февраля 2021 года")
Результаты:
val datetime.datetime(2021, 1, 1) => 1 января 2021 года
val = datetime.datetime(2021, 2, 20) => 20 февраля 2021 года
В качестве образца можно указать набор значений, разделенных символами вертикальной
черты ( 1 ). Соответствующий блок будет выполнен, если проверяемое значение совпадает
с mобым из перечисленных образцов. Пример:
match n:
case "Python" 1 "JavaScript" 1 "РНР" 1 "RuЬy":
print("Язык программирования")
case "Django" 1 "Express" 1 ". Laravel" 1 "Rails":
print("Веб-фреймворк")
Результаты:
n = "Python" => Язык программирования
n = "Laravel" => Веб-фреймворк
n = "Express" => Веб-фреймворк
n = "RuЬy" => Язык программирования
В языковой конструкции case можно дополнительно указать конструкцию if следующего
формата:
case <Образец> if <Условие>
В этом случае проверяемое значение будет считаться совпавшим с указанным образцом
только в том случае, если заданное условие в качестве результата выдаст True. Пример
(функция len() возвращает количество значений в последовательности):
match seq:
case (1, 2, 3, *а) if (len(seq) > 4):
print("Бoлee 4 значений: 1, 2, 3, " + str(a))
case (1, 2, 3, *а):
print("He менее 4 значений: 1, 2, 3, " + str(a))
Результаты:
seq (1, 2, 3, 4, 5) => Более 4 значений: 1, 2, 3, [4, 5)
seq = (1, 2, 3, 4) => Не менее 4 значений: 1, 2, 3, [4]
Глава 4. Инструкции ветвления, выбора и циклы 77
Инструкция выбора несколько нагляднее инструкции ветвления с множественными языко
выми конструкциями elif (см. разд. 4.2) и применяется в тех же случаях, что и последняя.
4.4. Цикл перебора последовательности
Uикл перебора последовательности выполняет указанный блок, называемый телом цикла,
столько раз, сколько значений присутствует в заданной последовательности. Перед каждым
выполнением блока (итерацией) он присваивает очередное значение из последовательности
:-казанной переменной, которая становится доступной в теле цикла. Формат записи цикла
перебора последовательности:
:or <Переменная> in <Последовательность>:
<Тело цикла>
:else:
<Блок·е1sе>
<Блок else> выполняется, если указанная последовательность пуста (не содержит ни одного
элемента), и исполнение цикла не бьшо прервано оператором break (описан в разд. 4.8).
Цикл такого типа может обрабатывать любые последовательности: списки, кортежи, диапа
зоны, строки и др.
Пример перебора символов в строке приведен в листинге 4.5.
for s in "str":
print(s, end=" ")
else:
print("\nЦикл выполнен")
Результат выполнения:
s t r
Цикл выполнен
Перебор элементов списка и кортежа с построчным выводом (листинг 4.6).
for х in [10, 200, 3000):
print(х)
for у in (3000, 200, 10):
print(y)
Перебор чисел из диапазона между 5 и 15:
>>> for n in range(S, 15): print(n, end=" ")
5 6 7 8 9 10 11 12 13 14
78 Часть /. Основы языка Python
Перебор списка кортежей:
>>> arr = [ (1, 2), (3, 4)] # Список кортежей
>>> for а, Ь in arr:
print(a, Ь)
1 2
З 4
4.5. Цикл с условием
Выполнение тела цикла с условием while продолжается до тех пор, пока выполняется задан
ное условие. Цикл записывается в следующем формате:
while <Условие>:
<Тело цикла>
[else:
<Блок else>
<Блок else> будет выполнен, если указанное условие изначально не выполняется и испол
нение цикла не бьшо прервано оператором break (описан в разд. 4. 8).
В теле цикла с условием следует произвести какие-либо действия, которые в определенный
момент сделают так, чтобы указанное условие перестало выполняться и цикл завершился.
Например, условие может проверять, не превысило ли значение какой-либо переменной
указанную величину, - в таком случае в блоке следует увеличивать значение этой пере
менной на 1.
В качестве примера вьmедем все числа от 1 до 100, используя цикл while (листинг 4.7).
i = 1
while i < 101:
print(i)
i += 1
ВНИМАНИЕ/
Если в теле цикла с условием не предпринимается никаких действий, способных прервать
цикл, он будет выполняться бесконечно (бесконечный цикл).
Прервать выполнение бесконечного цикла, выводящего данные, можно нажатием комбина
ции ·клав.иш <Ctrl>+<C>. В результате генерируется исключение кeyboardinterrupt (исклю
чения рассматриваются в главе 14), и выполнение программы останавливается.
Выведем все числа от 100 до 1 (листинг 4.8).
i = 100
while i:
print (i)
i -= 1
Глава 4. Инструкции ветвления, выбора и циклы 79
Здесь условие не содержит операторов сравнения. На каждой итерации цикла мы вычитаем
единицу из значения переменной·i. Как только значение станет равным О, цикл завершится,
поскольку число О при преобразовании в логический тип даст значение False.
С помощью цикла с условием можно перебирать элементы последовательностей. Однако
такой.дикл работает медленнее цикла перебора последовательности (см. разд. 4.4). В каче
стве примера умножим каждый элемент списка на 2 (листинг 4.9).
Листинr 4.9. '1еребор эnемекrов cnиciql
ccrr = (1, 2, 3]
:, count = О, len(arr)
·.-.rhile i < count:
arr[i] *= 2
i += 1
,::Jrint(arr) # Результат вьшолнения: (2, 4, 6]
4.6. Оператор continue:
переход на следующую итерацию цикла
Оператор continue позволяет перейти к следующей итерации цикла до завершения выпол
нения текущей итерации. В качестве примера выведем все числа от 1 до 100, кроме чисел от
5 до 1О включительно (листинг 4.1О).
Листинr 4.10. Оператор oon�.
1
:or i in range(l, 101):
if 4 < i < 11:
continue # Переходим на следукхцую итерацию цикла
print(i)
4.7. Оператор break: прерывание цикла
Оператор break прерывает выполнение цикла досрочно, после чего начнут исполняться ин
струкции, следующие за прерванным циклом. Для примера выведем все числа от 1 до 100
еще одним способом (листинг 4.11).
1 Л�стинr 4:11. Опе"тор Ьrea1t
i =1
while True:
if i > 100: break # Прерываем цикл
print(i)
i += 1
Поскольку в условии указано значение тrue, цикл станет выполняться бесконечно. Однако
оператор break прерывает цикл, как только он будет выполнен 100 раз.
Цикл с условием совместно с оператором break удобно использовать для получения не
определенного заранее количества данных от пользователя. В качестве примера просумми
руем произвольное количество чисел (листинг 4.12).
80 Часть /. Основы языка Python
рrint("Введите слово 'stop' для получения результата")
sumrna = О
while True:
х = input("Введите число: ")
if х = "stop":
break # Выход из цикла
х = int(x) # Преобразуем строку в число
sumrna += х
print("Сумма чисел равна:", .sumrna)
input()
Процесс ввода трех чисел и получения суммы выглядит так (значения, введеm1ые пользова
телем, здесь выделены полужирным шрифтом):
Введите слово 'stop' для получения результата
Введите число: 10
Введите число: 20
Введите число: 30
Введите число: stop
Сумма чисел равна: 60
4.8. Оператор присваивания
в составе инструкции
Оператор присваивания в составе инструкции : = полностью аналогичен оператору при
сваивания =, за тем искточением, что он выдает результат - само присвоенное значение.
Это позволяет использовать его в условиях инструкций ветвления, выбора и циклов. Под
держка такого оператора появилась в Python 3.8.
Использование оператора присваивания в составе инструкции лучше всего показать на
примере. Рассмотрим код, получающий количество символов в строке из переменной s
(с помощью функции len()) и выводящий это количество, если оно не равно О:
1 = len(s)
if 1 > О:
рrint("Длина строки: " + str(l))
Этот код можно сократить, выполнив вычисление длины строки и присваивание ее пере
менной n непосредственно в условии инструкции ветвления - посредством оператора : =:
if (1 := len(s)) > О:
рrint("Длина строки: "+ str(l))
Выражение, вкточающее оператор присваuвания в составе инструкции, следует взять
в круглые скобки, поскольку этот оператор имеет крайне низкий приоритет - даже ниже,
чем у операторов сравнения.
Использовав в условии цикла оператор присваивания в составе инструкции, мы можем
несколько сократить код программы из листинга 4.12 (листинг 4.13).
Глава 4. Инструкции ветвления, выбора и циклы 81
рrint("Введите слово 'stop' для получения результата")
summa = О
while (х :,,; input("Введите число: ")) != "stop":
х = int(x)
summa += х
print("Cyммa чисел равна:", summa)
input()
ГЛАВА 5
Числа
Язык Python поддерживает следующие числовые типы данных:
♦ int - целые числа. Размер числа ограничен лишь объемом оперативной памяти;
♦ float - вещественные числа;
♦ complex - комплексные числа.
Операции над числами разных типов возвращают число, имеющее более сложный тип из
типов, участвующих в операции. Целые числа имеют самый простой тип, далее идут веще
ственные числа и самый сложный тип - комплексные числа. Таким образом, если в опера
ции участвуют целое число и вещественное, то целое число будет автоматически преобра
зовано в вещественное число, а затем произведена операция над вещественными числами.
Результатом этой операции будет вещественное число.
5.1. Запись чисел
Целые числа в десятичной системе счисления записываются как есть:
>>> х = О; у= 10; z = -80
>>> х, у, z
(О, 10, -80)
Можно записать целое число в двоичной, восьмеричной или шестнадцатеричной форме.
Такие числа будут автоматически преобразованы в десятичные целые числа.
♦ Двоичные числа начинаются с комбинации симво.Jtов оь (или ов) и содержат цифры О
ИЛИ 1:
>>> 0Ыlllllll, ОЫО1101
(255, 45)
♦ Восьмеричные числа начинаются с нуля и следующей за ним латинской буквы о (ре
гистр не имеет значения) и содержат цифры от О до 7:
>>> Оо7, Оо12, 00777, 007, 0012, 00777
(7, 10, 511, 7, 10, 511)
♦ Шестнадцатеричные числа начинаются с комбинации символов Ох (или ох) и могут со
держать цифры от О до 9 и буквы от А до F (регистр не имеет значения):
>>> ОХ9,ОхА, 0xl0, 0xFFF, 0xfff
(9, 10, 16, 4095, 4095)
Глава 5. Числа 83
Длинные целые числа для улучшения читаемости кода можно разбивать на группы цифр,
вставляя символы подчеркивания:
»> 1 ООО ООО
1000000
»> OЫlll 1111
255
»> Оо2 777
1535
>>> ОхаЬ cd
43981
Вещественное число может содержать точку и (или) быть представлено в экспоненциаль
ной форме с буквой Е (регистр не имеет значения). Начальный О можно не указывать. При
меры:
»> 10., .14, 3.14, 11Е20, 2.5е-12
(10.0, 0.14, 3.14, l.le+21, 2.5е-12)
При выполнении операций над вещественными числами следует учитывать ограничения
точности вычислений. Например, результат следующей операции может показаться стран
ным:
>>> 0.3 - 0.1 - 0.1 - 0.1
-2.7755575615628914е-17
Ожидаемым был бы результат о. о, но, как видно из примера, мы получили совсем другое
значение. Если необходимо производить операции с фиксированной точностью, то следует
использовать модуль decimal:
>>> from decimal import Decimal
>>> Decimal("0.3") - Decimal("O.l") - Decimal("O.l") - Decimal("O.l")
Decimal( ' О. О' )
Кроме того, можно использовать дроби, поддержка которых реализована в модуле
fractions. При создании дроби можно указать два целых числа (числитель и знаменатель),
одно вещественное число или строку с вещественным числом.
Для примера создадим несколько дробей. Вот так формируется дробь 4/5:
>>> from fractions import Fraction
>>> Fraction(4, 5)
Fraction (4, 5)
1
А вот так- дробь /2, причем можно сделать это тремя способами:
>>> Fraction(l, 2)
Fraction(l, 2)
>>> Fraction(0.5)
Fraction(l, 2)
>>> Fraction("0.5")
Fraction(l, 2)
Над дробями можно производить арифметические операции, как и над обычными числами:
>>> Fraction(9, 5) - Fraction(2, 3)
Fraction(17, 15)
84 Часть /. Основы языка Python
>>> Fraction("0.3") - Fraction("0.1") - Fraction("0.1") - Fraction("0.1")
Fraction(O, 1)
>>> float(Fraction(O, 1))
о.о
КомIШексные числа записываются в формате:
<Вещественная часть>+<Мнимая часть>J
Здесь буква J может стоять в тобом регистре. Примеры комIШексных чисел:
>>> 2+5J, Bj
( (2+5j), Bj)
Подробное рассмотрение модулей decimal и fractions, а также комIUiексных чисел выхо
дит за рамки нашей книги. За информацией обращайтесь к документации по Python.
5.2. Обработка чисел
Для работы с числами предназначены следующие функции:
♦ int( [<Значение> [, <Система счисления>] ] ) - преобразует заданное значение в целое
число. Во втором параметре можно указать систему счисления преобразуемого числа
(по умолчанmо: 10). Пр'имер:
>>> int(7.5), int("71", 10), int("Oo71", 8), int("OxA", 16)
(7, 71, 57, 10)
>>> int(), int("OЫlllllll", 2)
(0, 255)
♦ float( [<Число или строка>J ) - преобразует заданное целое число или строку в вещест
венное число:
>>> float(7), float("7.1"), float("12.")
(7.0, 7.1, 12.0)
>>> float("inf"), float("-Infinity"), float("nan")
(inf, -inf, пап)
»> float()
о.о
♦ Ьin(<Число>) - преобразует заданное десятичное число в двоичное и возвращает его
в виде строки:
>>> Ьin(255), Ьin(l), Ьin(-45)
('OЫlllllll', 'ОЫ', '-ОЫ01101')
♦ oct(<Число>) - преобразует заданное десятичное число в восьмеричное и возвращает
его в виде строки:
>>> oct(7), oct(B), oct(64)
('Оо7', 'OolO', 'OolOO')
♦ hex(<Число>) - преобразует заданное десятичное число в шестнадцатеричное и возвра
щает его в виде строки:
>>> hex(lO), hex(lб), hex(255)
('Оха', 'OxlO', 'Oxff')
Глава 5. Числа 85
♦ round(<Число>[, <Количество знаков после точки>] ) - округляет заданное число и
возвращает результат. Числа с дробной частью, меньшей о. 5, округляет до ближайшего
меньшего целого, числа с дробной частью, большей о. 5, - до ближайшего большего
целого, числа с дробной частью, равной о. 5, - до ближайшего четного числа. Примеры:
>>> round(О.49), round(0.50), round(О.51)
(О, о, 1)
>>> round(1.49), round(l.50), round(l.51)
(1, 2, 2)
>>> round (2.49), round(2.50), round(2.51)
(2, 2, 3)
>>> round(3.49), round(3.50), round(3.51)
(3; 4, 4)
Во втором параметре можно указать желаемое количество знаков после запятой (по
умолчанию О - т. е. число будет округлено до целого):
>>> round(l.524, 2), round(l.525, 2), round(l.5555, 3)
(1.52, 1.52, 1.556)
♦ abs(<Число>) - возвращает абсолютное значение заданного числа:
>>> abs(-10), abs(l0), abs(-12.5)
(10, 10, 12.5)
♦ pow(<Основание>, <Показатель> [, <Делитель>]) - возводит <Основание> в степень, за
данную <Показателем>, и возвращает результат:
>>> pow(l0, 2), 10 ** 2, pow(3, 3), 3 ** 3
(100, 100, 27, 27)
Если указан третий параметр, возвращается остаток от деления полученного результата
на значение этого параметра:
>>> pow(l0, 2, 2), (10 ** 2) % 2, pow(3, 3, 2), (3 ** 3) % 2
(О, О, 1, 1)
♦ max () - возвращает максимальное число. Поддерживает два формата вызова:
mах(<Число 1>, <Число 2>, . . ., <Число n>[, kеу=<Функция, выдакщая число>])
max(<Последовательность>[, kеу=<Функция, выда�ацая число>][,
dеfаult=<Значение по умолчанию>])
Первый формат возвращает максимальное число из указанных:
>>> max(l, 2, 3), max(3, 2, 3, 1), max(l, 1.0), max(l.0, 1)
(3, 3, 1, 1.0)
Вместо чисел можно указать значения другого типа. Однако тогда в именованном пара
метре key следует задать функцшо, которая будет получать с единственным параметром
очередное значение и возвращать его же, преобразованное в числовой тип. Результат
в этом случае будет возвращаться в изначальном виде, безо всяких преобразований.
Пример с числами, указаннъrми в виде строк (для преобразования используется функция
str()):
>>> max("l", "435", "65", "-57", key=str)
'65'
86 Часть /. Основы языка Python
Второй формат возвращает максимальное число из содержащихся в указанной последо
вательности (например, в списке):
>>> max([l, 2, 3]), max([3, 2, 3, 1]), max([l, 1.0]), max([l.0, 1])
(3, 3, 1, 1.0)
>>> seq = ["1", "435", "65", "-57"]
>>> max(seq, key=str)
'65'
Если указанная последовательность пуста, генерируется искточение valueError, кото
рое приведет к аварийному завершению программы (если его не обработать, о чем рас
сказывается в главе 14):
»> max([])
Traceback (most recent call last):
File "<pyshell#l9>", line 1, in <module>
max([])
ValueError: max() arg is an empty sequence
Однако можно указать в именованном параметре default значение, которое будет воз
вращаться функцией при передаче ей пустой последовательности (искточение в этом
случае не генерируется):
>>> max([], default=0)
о
♦ min() - возвращает минимальное число. Оба поддерживаемых формата вызова анало
гичнь1 таковым у функции max(). Примеры:
>>> min(l, 2, 3), min(3, 2, 3, 1), min(l, 1.0), min(l.0, 1)
(1, 1, 1, 1.0)
>>> min("l", "435", "65", "-57", key=str)
'-57'
»> min([1, 2, 3]), min( (3, 2, 3, 1]), min([1, 1.0]), min([1.0, 1])
(1, 1, 1, 1.0)
>>> seq = ["1", "435", "65", "-57"]
>>> min(seq, key=str)
'
'-57
♦ sum( <Последовательность>[, <Начальное значение>]) - возвращает сумму значений
элементов заданной последовательности (списка, кортежа и пр.) ruпoc <Начальное зна
чение>. Если второй параметр не указан, начальное значение принимается равным О.
Если последовательность пуста, возвращается значение второго параметра. Пример:
»> sum( (10, 20, 30, 40)), sum([10, 20, 30, 40])
(100, 100)
>>> sum([10, 20, 30, 40], 2), sum([], 2)
(102, 2)
♦ divmod(x, у) -возвращает кортеж.из двух значений (х // у, х % у):
>>> divmod(l3, 2) # 13 == 6 * 2 + 1
(6, 1)
>>> 13 // 2, 13 % 2
(6, 1)
>>> divmod(13.5, 2.0) # 13.5 6.0 * 2.0 + 1.5
(6.0, 1.5)
Глава 5. Числа 87
>>> 13.5 // 2.0, 13.5 % 2.0
(6.0, 1. 5)
В главе 2 говорилось, что в Python тобое значение представляется в виде объекта - слож
ной структуры, хранящей, помимо собственно значения, всевозможные связанные с ней
данные. Эти данные хранятся в атрибутах - переменных, принадлежащих объекту. Объ
ект также содержит методы - принадлежащие ему функции, которые позволяют манипу
лировать содержащимся в нем значением и получать какие-либо сведения о нем.
Все -объекты, хранящие значения одного типа, создаются на основе одного класса - своего
рода образца, определяющего функциональность типа, набор содержащихся в нем атрибу
тов и методов. Имя класса совпадает с именем соответствующего ему типа данных (так,
класс int служит для представления целых чисел, а класс float - вещественных чисел).
Класс float, представляющий вещественные числа, поддерживает следующие полезные
методы:
♦ is_integer() - возвращает True, если текущий объект (объект, у которого вызывается
метод) вещественного числа не содержит дробной части - т. е. фактически представля
ет собой целое число:
>>> (2.0).is_integer()
True
>>> (2.3).is_integer()
False
Обратим внимание, как вызывается метод: его в�1зов ставится после объекта и отделяет
ся от него точкой;
♦ as_integer_ratio() - возвращает кортеж из двух целых чисел, представляющих собой
числитель и знаменатель дроби, которая соответствует текущему числу:
>>> (0.5).as integer_ratio()
(1, 2)
>>> (2.3).as_integer_ratio()
(2589569785738035, 1125899906842624)
Начиная с Python 3.8, класс int, представляющий целые числа, также поддерживает метод
as_integer_ratio(), только знаменатель возвращаемой им дроби всегда равен 1:
>>> (2) .as_integer_ratio()
(2, 1)
>>> (57).as integer_ratio()
(57, 1)
5.3. Математические функции
Модуль math предоставляет дополнительные функции для работы с числами, а также стан
дартные константы. ГJрежде чем использовать этот модуль, необходимо подкточить его
с ПОМОЩЬЮ инструкции:
import math
ПРИМЕЧАНИЕ
Для работы с комплексными числами необходимо использовать модуль cmath.
88 Часть /. Основы языка Python
Модуль math предоставляет стандартные константы, хранящиеся в следующих переменных:
♦ pi - число п:
>>> import math
>>> math.pi
З.141592653589793
♦ е - константа е:
>>> math.e
2.718281828459045
♦ tau - число т, равное 2n:
>>> math.tau
6.283185307179586
Также модуль math поддерживает следующие основные функции:
♦ sin(<Угол>), cos(<Угол>), tan(<Угол>) - синус, косинус и тангенс. Угол указывается
в радианах;
♦ asin(<Значение>), acos(<Значение>), atan(<Значение>) - арксинус, арккосинус и арк
тангенс. Результат возвращается в радианах;
♦ degrees(<Угол в радианах>) - угол в градусах:
>>> math.degrees(math.pi)
180.0
♦ radians(<Угол в градусах>) - угол в радианах:
>>> math.radians(l80.0)
З.141592653589793
♦ ехр(<Число>) - экспонента от заданного числа;
♦ log(<Число> [, <База> J ) - логарифм заданного числа по указанной базе. Если база не
указана, вычисляется натуральный логарифм (по базе е);
♦ logl0(<Число>) - десятичный логарифм заданного числа;
♦ log2(<Число>) - логарифм по базе 2 от заданного числа;
♦ sqrt(<Число>) - квадратный корень от заданного числа:
>>> math.sqrt(l00), math.sqrt(25)
(10.0, 5.0)
♦ ceil(<Значение>) - заданное значение, округленное до ближайшего большего целого:
>>> math.ceil(5.49), math.ceil(5.50), math.ceil(5.51)
(6, 6, 6)
♦ floor() - заданное значение, округленное до ближайшего меньшего целого:
>>> math.floor(5.49), math.floor(5.50), math.floor(5.51)
(5, 5, 5)
♦ роw(<Основание>, <Показатель>) - указанное основание, возведенное в степень, кото
рая задана <Показателем>. В отличие от оператора** , всегда возвращает результат в виде
вещественного числа. Пример:
Глава 5. Числа 89
>>> math.pow(l0, 2), 10 ** 2, math.pow(3, 3), 3 ** 3
(100.0, 100, 27 .о, 27)
♦ fabs(<Число>) - абсототное значение заданного числа. В отличие от функции abs(),
всегда возвращает результат в виде вещественного числа. Пример:
>>> math.fabs(l0), math.fabs(-10), math.fabs(-12.5)
(10.0, 10.0, 12.5)
♦ fmоd(<Делимое>, <Делитель>) - остаток от деления. В отличие от оператора %, всегда
возвращает результат в виде вещественного числа. Пример:
>>> math.fmod(l0, 5), 10 % 5, math.fmod(l0, 3), 10 % 3
(О.О, О, 1.0, 1)
♦ factorial (<Число>) - факториал заданного числа: Начиная с Python 3.8, принимает
только целые числа. Пример:
>>> math.factoria1(5), math.factorial(б)
(120, 720)
♦ fsum(<Последовательность>) - возвращает точную сумму чисел из заданной последова
тельности:
>>> sum([.1, .1, .1, .1, .1, .1, .1, ..1, .1, .1])
О.9999999999999999
>>> math.fsum([.1, .1, .1, .1, .1, .1, .1, .1, .1, .1])
1.0
ПРИМЕЧАНИЕ
В этом разделе мы рассмотрели только основные функции, поддерживаемые модулем
math. Чтобы получить полный список функций, обращайтесь к документации по Python.
5.4. Генерирование случайных чисел
Модуль random предоставляет инструменты для генерирования случайных чисел. Сначала
необходимо подкточить его с помощью инструкции:
import random
Основные функции, содержащиеся в этом модуле:
♦ random() - возвращает псевдослучайное число от о .о до 1.о:
>>> import random
>>> random.random()
0.9753144027290991
>>> random.random()
О.5468390487484339
>>> random. random()
О.13015058054767736
♦ seed([<База>] [, version=2] ) - настраивает генератор случайных чисел на новую по
следовательность. Если первый параметр не указан, в качестве базы для случайных
чисел будет использовано системное время. При одинаковых значениях базы генериру
ется одинаковая последовательность чисел. Пример:
90 Часть /. Основы языка Python
>>> random.seed(l0)
>>> random.random()
О.5714025946899135
>>> random.seed(l0)
>>> random.random()
О.5714025946899135
♦ uniform(<Haчaлo>, <Конец>) - возвращает псевдослучайное вещественное число в диа
пазоне от параметра <Начало> до параметра <Конец>:
>>> random.uniform(0, 10)
9.965569925394552
>>> random.uniform(0, 10)
О.4455638245043303
♦ randint(<Начало>, <Конец>) - возвращает псевдослучайное целое число в диапазоне от
параметра <Начало> до параметра <Конец>:
>>> random.randint(0, 10)
4
>>> random.randint(0, 10)
10
♦ randrange( [<Начало>, J <Конец> [, <Шаг> J ) - возвращает случайный элемент из созда
ваемого «за кадром» диапазона:
>>> random.randrange(l0)
5
>>> random.randrange(0, 10)
2
>>> random.randrange(0, 10, 2)
6
♦ ·choice(<Последовательность>) - возвращает случайный элемент из заданной последо-
вательности:
>>> random.choice("string") # Строка
1 i 1
>>> random.choice( ["s", "t", "r"]) # Список
'r'
>>> random.choice(( "s", "t", "r")) # Кортеж
' t'
♦ shuffle(<Список>) - перемешивает элементы заданного списка случайным образом.
Результата не возвращает. Пример:
>>> arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
>>> random.shuffle(arr)
>>> arr
[8, 6, 9, 5, 3, 7, 2, 4, 10, 1)
Ранее эта функция принимала два параме-rра, но, начиная с Python 3.9, второй параме1р объявлен
нерекомендованным к использованию и подлежащим удалению в Python 3.11;
♦ sample() - возвращает список из указанного количества элементов, которые будут
выбраны случайным образом из заданной последовательности:
Глава 5. Числа 91
sаmрlе(<Последовательность>, <Количество элементов>[,
соunts=<Количество повторений элементов>])
>>> random.sample("string", 2)
[,i,, ,r']
>>> random.sample("string", 6)
['i', 'r', 'n', 'g', 't', 's']
>>> arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
>>> random.sample(arr, 2)
[7, 10)
>>> arr # Сам список не изменяется
[1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
>>> random.sample((l, 2, 3, 4, 5, 6, 7), 3)
[6, 3, 5)
>>> random.sample(range(300), 5)
[126, 194, 272, 46, 71)
Начиная с Python 3.9, поддерживается именованный параметр counts, в котором можно
указать последовательность, содержащую значения количества повторений элементов из
последовательности, заданной первым параметром. Первый элемент.последовательности
из параметра counts укажет количество повторений первого элемента из первой после
довательности, второй элемент - количество повторений второго элемента и т. д. На
пример, следующие два вызова функции sample() эквивалентны:
random.sample("sssttrrrrriinggg", 6)
random .sample("string", 6, counts=[3, 2, 5, 2, 1, 3))
Также, начиная с Python 3.9, указывать множества в первом параметре функции
sample() не допускается - эта возможность объявлена устаревшей и подлежащей уда
лению в будущих версиях языка.
Напишем функцию-генератор паролей произвольной длины (листинг 5.1). Для этого доба
вим в список arr все разрешенные символы, а далее в цикле будем получать случайный
элемент с помощью функции choice(). По умолчанию будет выдаваться пароль из 8 сим
волов.
import random
def passw_generator(count_char=8):
arr = [,а,,,Ь,, ,с ,,,d,,,е,,,f,,,g,,,h,,,i,, , j ,,,k ,, , 1,,1 m,,
'n','о','р','q','r','s','t','u'' 'v'' 'w','х'' 'у','z''
'А','В','С ','D','Е','F','G','Н','I','J','К','L',
'М','N','О','Р','Q','R','S','Т','U','V', 'W',
'X','Y','Z 1 ,1 l','2',1 З','4','5 ','6','7','8','9','0']
passw = []
for i in range(count_char):
passw.append(random.choice(arr))
return .join(passw)
1111
Испытаем эту функцию в действии:
print(passw_generator(l0)) # Выведет что-то вроде ngODHE8J8x
print(passw_generator()) # Выведет что-то вроде ZxcpkF5O
ГЛАВА 6
Строки и двоичные данные
Строка - это неизменяемая последовательность произвольных символов в кодировке
Unicode. Длина строки ограничена лишь объемом оперативной памяти компьютера.
Двоичные данные - это последовательность байтов (чисел от О до 255), которая может
быть как неизменяемой, так и изменяемой. Длина такой последовательности также ограни
чена лишь объемом оперативной памяти. В виде двоичных данных может быть сохранена
информация любого рода: строка, графическое изображение, архив и др.
6.1. Создание строк
Создать строку можно следующими способами:
♦ записав составляющие строку символы между одинарными или двойными кавычками:
>>> 'строка', "строка"
('строка', 'строка')
Строки, созданные с применением одинарных и двойных кавычек, ничем не отличаются
друг от друга.
В строках, созданных одинарными кавычками, можно размещать двойные кавычки, а
в строках, созданных двойными кавычками, - одинарные кавычки:
>>> 'Группа "КИно"', "О'Брайен"
('Группа "КИно"', "О'Брайен")
Попытка вставить одинарную кавычку в строку, созданную одинарными кавычками, или
двойную кавычку в строку в двойных кавычках приведет к ошибке:
>>> "Группа "КИно""
SyntaxError: invalid syntax
В строках можно указать специальные символы - символы, обрабатьшаемые особым
образом. Обозначение специального символа начинается со знака обратного слеша (\).
Например, специальный символ \n обозначает разрыв строки, специальный символ \' -
одинарную кавычку, символ \" - двойную кавычку, а \\ - обратный слеш. Более под
робно специальные символы будут описаны в разд. 6.1.1. Примеры:
>>> print ("Строкаl\\nСтрока2")
Строка1\nСтрока2
Глава б. Строки и двоичные данные 93
>>> "Группа \"КИно\"", 'О\'Брайен'
('Группа "КИно"', "О' Брайен")
Специальный символ \ \ обычно применяется для вставки символа обратного слеша
в конец строки:
>>> print("string\\")
string\
Если же использовать единичный символ обратного слеша, интерпретатор посчитает его
и следующую за ним кавычку специальным символом и вьmедет сообщение о синтакси
ческой ошибке:
>>> print("string\")
SyntaxError: unterminated string literal (detected at line 1)
Нельзя разбивать строковый .объект, созданный с помощью кавычек, на несколько
строк - это вызовет синтаксическую ошибку:
>>> "string
SyntaxError: unterminated string literal (detected at line 1)
Чтобы расположить строковое значение на нескольких строках, следует либо перед сим
волом перевода строки указать символ \, либо поместить отдельные части строки внут
ри круглых скобок, либо выполнить конкатенацию строк также внутри круглых скобок:
>>> "stringl\
string2" #После \ не должно бьrrь никаких символов
'stringlstring2'
>>> ("stringl"
"string2") # Неявная конкатенация строк
'stringlstring2'
>>> ("stringl" +
"string2") # Явная конкатенация строк
'stringlstring2'
♦ указав строку между утроенными одинарными или двойными кавычками. Такие строко
вые объекты могут размещаться на нескольких строках, содержать одинарные и двой
ные кавычки. Примеры:
>>> print('''Строкаl
Строка2''')
· Строкаl
Строка2
>>> print("""Cтpoкal
Строка2""")
Строкаl
Строка2
♦ с помощью функции str([ <Значение>[, <Кодировка>[, <Обработка ошибок>] ] ] ) . Если
указан только первый параметр, функция возвращает строковое представление указан
ного значения. Если параметры не указаны вообще, возвращается пустая строка. При
меры:
>>> str(), str([l, 2]), str((З, 4)), str({"x": 1))
(", '[1, 2]', '(3, 4)', "{'х': 1)")
94 Часть /. Основы языка Python
При попытке преобразовать двоичные данные типа byte или bytearray (описаны
в разд. 6.11 и 6.12) в строку будет выдано строковое представление двоичных данных:
»> str(b"\xfl\xf2\xf0\xee\xea\xe0")
"b'\\xfl\\xf2\\xf0\\xee\\xea\\xe0'"
Чтобы получить строку, следует указать кодировку:
>>> str(b"\xfl\xf2\xf0\xee\xea\xe0", "ср1251")
'строка'
В третьем параметре могут быть указаны значения "strict" (при ошибке возбуждается
искmочение UnicodeDecodeError - значение по умолчанmо), "replace" (неизвестный
символ заменяется символом с кодом \uFFFD) или ignore 11 (неизвестные символы игно
II
рируются):
>>> objl = bytes("cтpoкal", utf-8")
11
>>> obj2 = bytearray("cтpoкa2", .':utf-8")
>>> str(objl, "utf-8"), str(obj2, "utf-8 11)
('строкаl' , 'строка2')
>>> str(objl, "ascii", strict")
11
Traceback (most recent call last):
File "<pyshell#lб>", line 1, in <module>
str(obj1, 11 ascii", "strict
11)
UnicodeDecodeError: 'ascii' codec can't decode byte
Oxdl in position О:. ordinal not in. range(128)
>>> str(objl, "ascii", "ignore")
'1'
Если строка не присваивается переменной, то она считается строкой документирования.
Такая строка сохраняется в атрибуте _doc_ того объекта, в котором расположена. В каче
стве примера создадим функцию со строкой документирования, а затем выведем содержи
мое строки:
>>> def test():
"""Это описание функции"";'
pass
>>> print(test . doc
Это описание функции
6.1.1. Специальные символы
Специш�ьные символы, как говорилось ранее, имеют особое значение и обрабатываются
особым образом. Python поддерживает следующие специальные символы:
♦ \n - перевод строки;
♦ \r-возврат каретки;
♦ \t-знак табуляции;
♦ \v-вертикальная табуляция;
♦ \а - звонок;
♦ \Ь-забой;
Глава б. Строки и двоичные данные 95
♦ \f-перевод формата;
♦ \О-нулевой символ;
♦ \" - двойная кавычка;
♦ \' - одинарная кавычка (апостроф);
♦ \\ - обратный слеш;
♦ \<N> - символ с восьмеричным кодом <N>. Например, \ 7 4 соответствует символу <;
♦ \x<N> - символ с шестнадцатеричным кодом <N>. Например, \хба соответствует симво
лу j;
♦ \u<nnnn> - символ с 16-битным Unicode-кoдoм <nnnn>. Например, \u04За соответствует
русской букве к;
♦ \U<nnnnnnnn> - символ с 32-битным Unicode-кoдoм <nnnnnnnn>;
♦ \N{<name>J - символ с Uniсоdе-именем <name>. Например, \N{Registered Sign} соот
ветствует знаку зарегистрированной торговой марки ®·
Комбинация обратного слеша с тобым другим символом выводится как есть:
>>> print("Этот символ \не специальный")
Этот символ \не специальный
Тем не менее для вставки обратного слеша лучше использовать специальный символ \ \:
>>> print("Этoт символ \\не специальный")
Этот символ \не специальный
6.1.2. Необрабатываемые строки
В необрабатываемых строках специальные символы не обрабатываются, а выводятся как
есть. Чтобы превратить строку в необрабатываемую, достаточно предварить ее модифика
тором r или R. Примеры:
>>> print("Cтpoкal\nCтpoкa2")
Строкаl
Строка2
>>> print(r"Cтpoкal\nCтpoкa2"}
Строка1\nСтрока2
>>> print(R"Cтpoкal\nCтpoкa2")
Строка1\nСтрока2
>>> print(r"'"'Строкаl \nСтрока2""")
Строка1\nСтрока2
Необрабатываемые строки удобно использовать в шаблонах регулярных выражений и при
записи файловых путей:
»> print(r"C:\Python310\lib\site-packages")
C:\Python310\lib\site-packages
В обычных строках все обратные слеши придется заменять на специальные символы \ \:
»> print("C:\\Python310\\lib\\site-packages")
C:\Python310\lib\site-packages
96 Часть /. Основы языка Python
Если в конце необрабатываемой строки должен располагаться слеш, следует использовать
специальный символ \ \. Однако этот символ будет добавлен в строку. Пример:
»> print(r"C:\Python310\lib\site-packages\")
SyntaxError: unterminated string literal (detected at line 1)
>» print(r"C:\Python310\lib\site-packages\\")
C:\Python310\lib\site-packages\\
Избавиться от лишнего слеша можно, использовав конкатенацию строк, обычные строки
или удалив слеш явно:
>>> print(r"C:\Python310\lib\site-packages" + "\\") # Конкатенация
C:\Python310\lib\site-packages\
»> print("С:\\Python310\\lib\\site-packages\\") # Обычная строка
C:\Python310\lib\site-packages\
>» print(r"C:\PythonЗlO\lib\site-packages\\"(:-1]) # Удаление слеша
C:\Python310\lib\site-packages\
6.2. Операции над строками
Строки относятся к последовательностям и, соответственно, поддерживают все операции,
выполняем_ые над последовательностями.
Можно извлечь любой символ строки, указав индекс этого символа в квадратных скобках.
Нумерация символов начинается с нуля. Пример:
>>> s = "Python"
>» s[O], s[l], s[2], s[З], s[4], s[5]
('Р', 'у', 't', 'h', 1
0 1 , 'n')
При обращении к символу с несуществующим индексом возбуждается исключение
IndexError:
>>> s = "Python"
»> s[lOJ
Traceback (most recent call last):
File "<pyshell#90>", line 1, in <module>
s[lOJ
IndexError: string index out of range
Можно указать отрицательный индекс - он будет отсчитываться от конца строки:
>>> s = "Python"
>>> s[-1], s(-4]
('n', 't')
Так как строки относятся к неизменяемым типам данных, то изменить символ с указанным
индексом нельзя:
>>> s = "Python"
>>> s[О] = "J" # Изменить строку нельзя
Traceback (most recent call last):
File "<pyshell#94>", line 1, in <module>
s[О] = "J" # Изменить строку нельзя
TypeError: 'str' object does not support item assignment
Глава б. Строки и двоичные данные 97
Чтобы выполнить изменение, можно воспользоваться операцией извлечения среза - фраг
мента последовательности, также представляющего собой последовательность. Формат
записи среза:
[<Начало>:<Конец>:<Шаг>]
Все параметры здесь не являются обязательными. Если параметр <Начало> не указан, то ис
пользуется значение О. Если параметр <Конец> не указан, то возвращается фрагмент до кон
ца строки. Символ с индексом, указанным в этом параметре, не входит в возвращаемый
фрагмент. Если параметр <Шаг> не указан, то используется значение 1. В качестве значения
параметров можно указать отрицательные значения.
Примеры:
♦ получение копии строки:
>>> s = "Python"
»> s[:] # Возвращается фрагмент от позиции О до конца строки
'Python'
♦ вывод символов в обратном порядке:
>>> s[::-1] # Указываем отрицательное значение в параметре <Шаг>
'nohtyP'
♦ замена первого символа в строке:
>>> "J" + s[l:] # Извлекаем фрагмент от символа 1 до конца строки
'Jython'
♦ удаление последнего символа:
»> s(:-1) # Возвращается фрагмент от О до len(s)-1
'Pytho'
♦ получение первого символа в строке:
»> s[0:1] # Символ с индексом 1 не входит в диапазон
'Р'
♦ получение последнего символа:
>>> s(-1:] # Получаем фрагмент от len(s)-1 до конца строки
'n'
♦ вывод символов с индексами 2, 3 и 4:
»> s[2:5] # Возвращаются символы с индексами 2, З и 4
'tho'
Узнать длину строки (количество символов в ней) позволяет функция len():
>>> len("Python"), len("\r\n\t"), len(r"\r\n\t")
(6, 3, 6)
Можно перебрать все символы в строке с помощью цикла перебора последовательности
(см.разд. 4.4):
>>> s = "Python"
>>> for i in s: print(i, end=" ")
Р у t h о n
98 Часть /. Основы языка Python
Выполнить конкатенацию строк позволяет оператор +:
>>> print("Cтpoкal" + "Строка2")
Строка1Строка2
>>> s = "Строкаl"
>>> print(s + "Строка2")
Строка1Строка2
Кроме того, можно выполнить неявную конкатенацию строк, записав их через пробел:
>>> print("Cтpoкal" "Строка2")
Строка1Строка2
Однако выполнить неявную конкатенацию переменной и строки нельзя - это вызовет
ошибку:
>>> print(s "Строка2") # Ошибка
SyntaxError: invalid syntax
При необходимости объединить строку со значением другого типа (например, с числом)
следует произвести явное преобразование типов с помощью функции str() :
>>> "string" + str(lO)
'stringlO'
Еще строки поддерживают операцию повторения, проверки на вхождение и невхождение.
Повторить строку указанное количество раз можно с помощью оператора *, выполнить
проверку на вхождение фрагмента в строку позволяет оператор in, а проверить на невхож
дение - оператор not in:
>>> "-" * 20
--------------------
>>> "yt" in "Python" # Найдено
True
>>> "yt" in "Perl" # Не найдено
False
>>> "РНР" not in "Python" # Не найдено
True
6.3. Форматирование строк
При форматировании указанная строка объединяется со значениями любых других типов.
Форматирование выполняется быстрее конкатенации.
Операция форматирования записывается в следующем формате:
<Строка специального формата>% <Значения>
Внутри параметра <Строка специального формата> могут быть указаны спецификаторы,
имеющие следующий синтаксис:
%[(<Ключ>)] [<Флаг>] [<Ширина>] [.<Точность>]<Тип преобразования>
Количество спецификаторов внутри строки должно быть равно количеству элементов в па
раметре <Значения>. Если спецификатор один, то параметр <Значения> может содержать
одно значение, в противном случае следует задать кортеж. Примеры:
Глава 6. Строки и двоичные данные 99
>>> 11%s 11 % 10 # Один элемент
10 1
1
>>> 11%s - %s - %s 11 % (10, 20, 30) # Несколько элеr�ентов
1 10 - 20 - 301
Параметры внутри спецификатора имеют следующий смысл:
♦ <Ключ> - юпоч словаря. Если задан юпоч, то в параметре <Значения> необходимо ука
зать словарь, а не кортеж:
>>> 11%(narne)s - %( ear)s 11 % { 11 ear 11 : 1978, 11 narne11 : 11Nik 11 )
y y
1Nik - 1978 1
ш
♦ <Флаг> - флаг преобразования. Может содержать следующие значения:
• # - у восьмеричных чисел добавляет в начало комбинацию символов Оо, у естнад
цатеричных - комбинацию символов Ох (если используется тип х) или ох (если ис
пользуется тип х), у вещественных чисел предписывает всегда выводить дробную
точку, даже если в параметре <Точность> задано значение О:
>>> print(11%#0 %#о %#0 11 % (Оо77, Oxff, 10))
Оо77 00377 Оо12
>>> print(11%#x %#х %#х11 % (Оо77, Oxff, 10))
Ox3f Oxff Оха
>>> print(11%#X %#Х %#Х1 1 % (Оо77, Oxff, 10))
OX3F OXFF ОХА
>>> print(11%#.0F %.OF 11 % (300, 300))
300. 300
• о - вывод ведущих нулей у чисел:
>>> 111%d 1 - 1%05d 111 % (3, 3) # 5 - ширина поля
1 113 1 - 1 00003111
• - - выравнивание по левой границе области (по умолчанию используется выравни
вание по правой границе). Если флаг указан одновременно с флагом о, то действие
последнего будет отменено. Примеры:
>>> 11 1%5 d1 - 1%-5d"1 % (3, 3) # 5 - ширина поля
11 1 31
- 1 3
>>> 11 1%05d1 - 1 %-05d 1 11 % (3, 3)
11 100003 1 - 13
• пробел - вывод пробела перед положительным числом и минуса - перед отрица
тельным:
>>> 111% d 1 - 1 % d111 % (-3, 3)
"'-3' - ' 3'"
• + - вывод знака как у отрицательных, так и у положительных чисел. Если флаг +
указан одновременно с флагом пробел, то действие последнего будет отменено. При
мер:
ин
>>> 11 1%+d1 - 1%+d1 11 %ш(-3, 3) ш
-З' - '+3'"
111
♦ рина> - минимальная ир а поля. Если строка не помещается в указанную ири
<Ши, значение игнорируется, и строка выво
ну дится полностью. Примеры:
100 Часть /. Основы языка Python
>>>"'%10d' - '%-l0d'" % (3, 3)
"' 3' - '3
>>>"' %3s' '%10s'" % ("string", "string")
"' string'' string'"
Вместо значения ширины можно указать символ «*». В этом случае ширину следует
задать внутри кортежа. Пример:
>>>'" %*s"%10s'" % (10, "string", "str")
"' string'' str'"
♦ <Точность>- количество знаков после точки у вещественных чисел. Перед этим пара
метром обязательно должна стоять точка. Пример:
>>> irnport math
>>>"%s %f %.2f"· % (math.pi, math.pi, math.pi)
'3.141592653589793 3.141593 3.14'
Вместо значения точности можно указать символ«*». В этом случае точность следует
задать внутри кортежа. Пример:
>>>"'%*.*f"' % (8, 5, math.pi)
"' 3.14159'"
♦ <Тип преобразования>:
• s - преобразование выводимого значения в строку с помощью функции str() :
>>>print("%s" % ("Обычнаястрока"))
Обычнаястрока
>» print("%s %s %s" % (10, 10.52, [1, 2, 3]))
10 10.52 [1, 2, 3]
• r - преобразование выводимого значения в строку с помощью функции repr() :
>>>print("%r" % ("Обычнаястрока"))
'Обычнаястрока'
• а - преобразование выводимого значения в строку вызовом функции ascii() :
>>>print("%a" % ("строка"))
'\u0441\u0442\u0440\u043e\u043a\u0430'
• с - вывод символа с указанным кодом. Вьшедем числовое значение и соответст
вующий ему символ:
>>>for i in range(33, 127): print("%s =>%с" % (i, i))
• d и i - вывод целой части заданного числа:
>>>print("%d %d %d" % (10, 25.6, -80))
10 25 -80
>>>print("%i %i %i" % (10, 25.6, -80))
10 25 -80
• о - вывод заданного целого числа в восьмеричном представлении:
>>>print("%о %о" % (Оо77, 10))
77 12
Глава 6. Строки и двоичные данные 101
>>> print("%#o %#о" % (Оо77, 10))
Оо77 Оо12
При попытке вывести таким образом вещественное число возникнет ошибка;
• х - вывод заданного целого числа в щестнадцатеричном представлении в нижнем
регистре (при попытке вывести вещественное число возникнет ошибка):
>>> print("%х %х" % (0xff, 10))
ff а
>>> print("%#x %#х" % (0xff, 10))
0xff Оха
• х - вывод заданного целого числа в шестнадцатеричном представлении в верхнем
регистре (при попытке вывести вещественное число возникнет ошибка):
>>> print ("%Х %Х" % (0xff, 10))
FF А А
»> print("%#X %#Х" % (0xff, 10))
0XFF ОХА
• f и F - вывод заданного вещественного числа в десятичном представлении:
>>> print("%f %f %f" % (300, 18.65781452, -12.5))
300.000000 18.657815 -12.500000
>>> print("%F %F %F" % (300, 18.65781452, -12.5))
300.000000 18.657815 -12.500000
>>> print("%#.0F %.0F" % (300, 300))
300. 300
• е - вывод заданного вещественного числа в экспоненциальной форме (буква е
выводится в нижнем регистре):
>>> print("%e %е" % (3000, 18657.81452))
3.000000е+03 1.865781е+О4
• Е - вывод заданного вещественного числа в экспоненциальной форме (буква Е
выводится в верхнем регистре):
»> print("%E %Е" % (3000, 18657.81452))
3.ООООООЕ+03 1.865781Е+04
• g - эквивалентно f или е (выбирается более короткая запись числа):
»> print("%g %g %g" % (0.086578, 0.000086578, 1.865Е-005))
0.086578 8.6578е-05 1.865е-05
• G - эквивалентно f или � (выбирается более короткая запись числа):
>>> print("%G %G %G" % (0.086578, 0.000086578, 1.865Е-005))
0.086578 8.6578Е-05 1.865Е-05
Если внутри строки необходимо использовать символ процента, этот символ следует удво
ить, иначе будет выведено сообщение об ошибке:
>>> print("% %s" % ("- это символ процента")) # Ошибка
Traceback (most recent call last):
File "<pyshell#55>", line 1, in <module>
print("% %s" % ("- это символ процента"))
TypeError: not all arguments converted during string formatting
102 Часть /. Основы языка Python
>>> print("%% %s" % ("- это символ процента")) # Нормально
% - это символ процента
Форматирование строк очень удобно использовать при передаче даннь1х в шаблон веб-стра
ницы. Дшr этого заполняем словарь даннь1ми и указываем его справа от символа %, а сам
шаблон- слева. Продемонстрируем это на примере (листинг 6.1 ).
1• Лисrинr 6.1. Форматмрованн строк
html = """<html>
<head><title>%(title)s</title>
</head>
<body>
<h1>%(hl)s</hl>
<div>%(content)s</div>
</body>
</html>"""
arr = { "title": "Это название документа",
"hl": "Это заголовок первого уровня",
"content": "Это основное содержание страницы"}
print(html % arr) # Подставляем значения и выводим шаблон
input()
Результат выполнения:
<html>
<head><title>Этo название документа</titlе>
</head>
<body>
<hl>Это заголовок первого уровня</hl>
<div>Этo основное содержание страницы</div>
</body>
</html>
Дшr форматирования строк также можно использовать следующие методы, поддерживае
мые объектом строки:
♦ expandtabs( [ <Ширина поля> J )- заменяет каждый символ табуляции в текущей строке
пробелами так, чтобы общая ширина фрагмента вместе с текстом, расположеннь1м перед
символом табуляции, была равна указанной величине. Если параметр не указан, то
ширина поля предполагается равной 8 символам. Пример:
>>> s = "1\tl2\tl23\l ri
>>> "'%s'" % s.expandtabs(4)
"'l 12 123 '"
В этом примере ширина задана равной четырем символам. Поэтому во фрагменте 1\t
табуляция будет заменена тремя пробелами, во фрагменте 12\t- двумя пробелами, а во
фрагменте 123\t- одним пробелом. Во всех трех фрагментах ширина будет равна
четырем символам.
Если перед символом табуляции нет текста или количество символов перед табуляцией
равно указанной в вызове метода ширине, то табуляция заменяется указанным количест
вом пробелов:
Глава б. Строки и двоичные данные 103
>>> s = "\t"
>>> "'%s' - '%s'" % (s.expandtabs(), s.expandtabs(4))
1 - ' '"
>>> s = "1234\t"
>>> "'%s'" % s.expandtaЬs(4)
"'1234
Если количество символов перед табуляцией больше ширины, то табуляция заменяется
пробелами таким образом, чтобы ширина фрагмента вместе с текстом делилась без
остатка на указанную ширину:
>>> s = "12345\t123456\t1234567\t1234567890\t"
>>> "'%s'" % s.expandtabs(4)
"'12345 123456 1234567 1234567890
Таким образом, если количество символов перед табуляцией больше 4, но менее 8, то
фрагмент дополняется пробелами до 8 символов. Если количество символов больше 8,
но менее 12, то фрагмент дополняется пробелами до 12 символов и т. д. Все это справед
ливо при указании, в качестве параметра числа 4;
♦ center(<Ширина> [, <Символ>] ) - выравнивает текущую строку по центру внутри поля
указанной ширины с добавлением слева и справа символов из второго параметра (если
он не указан, будут добавлены пробелы):
>>> s = "str"
>>> s.center(l5), s.center(ll, "-")
( 1
str ', '----str----')
Теперь произведем выравнивание трех фрагментов шириной 15 символов: первого - по
правому краю, второго - по левому, а третьего - по центру:
>>> s = "str"
>>> "'%15s' '%-15s' '%s'" % (s, s, s.center(15))
str' 'str str 111
Если количество символов в текушей строке превышает ширину поля, то значение
ширины игнорируется и строка возвращается полностью:
>>> s = "string"
>>> s.center(6), s.center(5)
('string', 'string')
♦ 1just(<Ширина> [, <Символ>] ) - выравнивает текущую строку по левому краю внутри
поля указанной ширины с добавлением справа символов из второго параметра (если он
не указан, будут добавлены пробелы). Если количество символов в текущей строке пре
вышает ширину поля, то значение ширины игнорируется и строка возвращается полно
стью. Примеры:
>>> s = "string"
>>> s.ljust(15), s.ljust(15, "-")
('string ', 'string---------')
>>> s.ljust(6), s.ljust(5)
('string', 'string')
♦ rjust(<Ширина> [, <Символ>] ) - выравнивает текущую строку по правому краю внутри
поля указанной ширины с добавлением слева символов из второго параметра (если он не
104 Часть /. Основы языка Python
указан, будут добавлены пробелы). Если количество символов в текущей строке превы
шает ширину поля, то значение ширины игнорируется и строка возвращается полно
стью. Пример:
>>> s = "string"
>>> s.rjust(15), s.rjust(15, "-")
(' string', '---------string')
>>> s.rjust(б), s.rjust(5)
('string', 'string')
♦ zfill(<Ширина>) - выравнивает текущую строку по правому краю внутри поля указан
ной ширины с добавлением слева нулей. Если количество символов в текущей строке
превышает ширину поля, то значение ширины шнорируется и строка возвращается пол
ностью. Примеры:
>>> "5".zfill(20), "123456".zfill(5)
('00000000000000000005', '123456')
6.4. Метод format()
Для форматирования строк можно использовать метод fonnat( J • Он имеет следующий син
таксис вызова:
<Строка специального фopмaтa>.fonnat(*args, **kwargs)
В качестве результата возвращается отформатированная строка.
В параметре <Строка специального формата> внутри символов фшурных скобок { и } ука
зываются спецификаторы, имеющие следующий синтаксис:
{ [<Поле>] [!<Функция>] [:<Формат>] }
Все символы, расположенные вне фшурных скобок, выводятся без преобразований. Если
внутри строки необходимо использовать символы { и }, то эти символы следует удвоить,
иначе возбуждается исключение ValueError, например:
>>> рrint("Символы {{ и }} - {0}".fоnnаt("специальные")}
Символы {и} - специальные
♦ <Поле> - параметр метода fonnat(}, в котором указано выводимое значение, в виде его
порядкового номера (нумерация начинается с нуля) или имени. Допустимо комбиниро
вать позиционные и именованные параметры, при этом именованные параметры следует
указать последними. Примеры:
>>> "{О} - {1} - {2}".fonnat(l0, 12.3, "string") # Индексы
'10 - 12.3 - string'
>>> arr = [10, 12.3, "string"]
>>> "{О} - {1} - {2}".fonnat(*arr} # Индексы
'10 - 12.3 - string'
>>> "{model} - {color}".format(color="red", i;nodel':""BМW") # Имена
'ВМW - red'
>>> d = {"color": "red", "model": "ВМW"}
>>> "{model} - {color}".format(**d} # Имена
'ВМW - red'
Глава б. Строки и двоичные данные 105
>>> "{color} - {0}".format(2015, color="red") # Комбинация
'red - 2015'
В вызове метода format() можно указать список, словарь или объект. Для доступа
к элементам списка по индексу внутри строки формата применяются квадратные скобки,
а для доступа к элементам словаря или атрибутам объекта - точечная нотация. Пример:
>>> arr = (10, (12. 3, "string"]]
»> "{0(0]} - {0[1][О]} - {0[1][1]}".format(arr) # Индексы
'10 - 12.3 - string'
»> "{arr[0]} - {arr[l][l]}".format(arr=arr) # Индексы
'10 - string'
>>> class Car: color, model = "red", "ВМW"
>>> car = Car()
>>> "{0.model} - {0.color}".format(car) # Атрибуты объекта
'ВМW - red'
Существует также краткая форма записи, при которой <Поле> не указывается. В этом
случае скобки без заданного индекса нумеруются слева направо, начиная с нуля. Пример:
»> "{} - {} - {} - {n}".format(l, 2, 3, n=4} # "{О} - {1} - {2} - {n}"
'1 - 2 - 3 - 4'
»> "{} - {} - {n} - {}".format(l, 2, 3, n=4) # "{0} - {1} - {n} - {2}"
'1 - 2 - 4 - 3'
♦ <Функция> - обозначение функции, обрабатывающей значение перед вставкой в строку.
Если указано обозначение s, то значение обрабатывается функцией str() , если r, то
функцией repr() , а если а, то функцией ascii(). Если параметр не указан, для преобра
зования значения используется функция str(). Пример:
>>> print("{0!s}".format("cтpoкa"}) # str()
строка
>>> print("{0!r}".format("cтpoкa") ) # repr()
'строка'
>>> print("{0!a}".format("cтpoкa"}) # ascii(}
'\u0441\u0442\u0440\u043e\u043a\u0430'
♦ <Формат> - должен иметь следующий синтаксис:
[[<Заполнитель>]<Выравнивание>][<Знак>][ #][О][<Ширина>][, ] [ ]�
[.<Точность>][<Преобразование>]
• <Ширина> - минимальная ширина поля. Если выводимое значение не помещается
в указанную ширину, то ширина игнорируется и значение выводится полностью.
Пример:
>>> "'{0:10)' '{1:3}'".format(3, "striпg")
3' 'striпg'"
Ширину поля можно передать в качестве параметра в методе format(). В этом случае
вместо значения ширины внутри фигурных скобок указывается индекс соответст
вующего параметра. Пример:
>>> "'{0:{1}}'".format(3, 10) # 10 - это ширина поля
3'"
1 Об Часть /. Основы языка Python
• <Выравнивание>:
Q
< - по левому краю;
Q
> - по правому краю (поведение по умолчаншо);
□ л - по центру поля.
Пример:
>>> "'{0:<10}' '{1:>10}' '{2: л l0}"'.fonnat(3, 3, 3)
"' 3 3' ' 3
= - знак числа выравнивается по левому краю, а число - по правому:
>>> "'{0:=10)' '{l: =10}"'.fonnat(-3, 3)
3' ' 3'"
Как видно из приведенного примера, пространство между знаком и числом по
умолчанию заполняется пробелами, а знак у положительного числа не указывает
ся. Чтобы вместо пробелов пространство заполнялось нулями, необходимо ука
зать нуль перед шириной поля, например:
>>> "'{0:=010)' '{l:=010}'".fonnat(-3, 3)
"' -000000003' '0000000003'"
Начиная с Python 3 .1 О, такое же поведение характерно и при выводе строк:
>>> "'(0:10)'".fonnat("string")
"'string
>>> "'(0:010)'".fonnat("string")
"'string0000'"
• <Заполнитель> - символ, которым будет заполняться свободное пространство в поле
(по умолчанию пробел):
>>> "'{О:0=10)' '{l:0= 10)"'.fonnat(-3, 3)
"'-000000003' '0000000003'"
>>> "'{0:*<10}' '{1:+>10}' '{2:.лl0}"'.fonnat(3, 3, 3)
"1 3********* 1 '+++++++++3' 1 3 ..... 1"
• • • •
• <Знак> - управляет выводом знака числа:
Q +- вывод знака как у отрицательных, так и у положительных чисел;
Q
- - вывод знака только у отрицательных чисел ( значение по умолчанию);
Q
пробел - вывод пробела у положительных чисел и минуса у отрицательных.
Примеры:
>>> "'{О:+)' '{1:+}' '{0:-)' '{l:-}"'.fonnat(3, -3)
"'+3' '-3' '3' '-3 1 "
>>> "'{О: }' '{1: }'".fonnat(3, -3) # Пробел
"1
3' '-3'"
• <Преобразование> - у целых чисел:
Q
ь - в двоичную систему счисления:
>>> '"{0:Ь)' '{0:#b}"'.fonnat(3)
"' 11 ' 'ОЫl'"
Глава б. Строки и двоичные данные 107
" с- заданного числа в соответствующий символ:
>>> "'{0:c}'".format(l67)
"'§'"
" d - в десятичную систему счисления;
" n - аналогично оrщии d, но учитьmает настройки локали. Например, выведем
большое число с разделением тысячных разрядов пробелом (точнее, символом
с кодом \хао, который при выводе преобразуется в пробел):
>>> irnport locale
>>> locale.setlocale(locale.LC_NUМERIC, 'Russian_Russia.1251')
'Russian Russia.1251'
>>> print {"{О:n}".format( 100000000) . replace("\uffa0", " "))
100 ООО ООО
Также можно разделить тысячные разряды запятой, указав ее в строке формата:
>» print("{О:,d}".format(100000000))
100,000,000
или символами подчеркивания - таким же образом:
»> print("{0:_d}".format(l00000000))
100 ООО ООО
" о- в восьмеричную систему счисления:
>>> "'{0:d}' '{О:о}' '{0:#o}'".format(511)
"'511' '777' '00777'"
□ х- в шестнадцатеричную систему счисления в нижнем регистре:
>>> "'{0:х}' '{0:#x}"'.format(255)
"'ff' '0xff'"
" х - в шестнадцатеричную систему счисления в верхнем регистре:
>>> "'{0:Х}' '{0:#X}"'.format(255)
"'FF' 'OXFF'"
• <Преобразование>- у вещественных чисел:
" f и F - в десятичную систему счисления:
>>> "'{0:f}' '{l:f}' '{2:f}"'.format(30, 18.6578145, -2.5)
"
1
30.000000 1 '18.657815 1 1
-2.500000 1"
По умолчанию выводимое число имеет шесть знаков после запятой. Задать другое
количество знаков после запятой можно в параметре <Точность>, например:
»> "'{0:.7f}' '{l:.2f}"'.format(l8.6578145, -2.5)
'" 18.6578145 1 1
-2.50"'
" е - в экспоненциальную форму (буква ев нижнем регистре):
>>> "' {0:е}' '{1:е} '".format(3000, 18657.81452)
"'3. 000000е+03' '1.865781е+04'"
" Е- в экспоненциальную форму (буква Ев верхнем регистре):
»> "' {0:Е}' '{1:Е}"'.format(3000, 18657.81452)
"'3.ООООООЕ+03' '1.865781Е+04'"
108 Часть /. Основы языка Python
Здесь количество знаков после запятой по умолчанию также равно шести, но
можно указать другое количество знаков в параметре <Точность>:
»> '"{0:.2е}' '{l:.2E}"'.fo:rmat(3000, 18657.81452)
"'3. 00е+О3' '1.87Е+04'"
" g -эквивалентно f или е(выбирается более короткая запись числа):
»> "'{0:g}.' '{l:g}'".fo:rmat (0.086578, 0.000086578)
"'0.086578' '8.6578е-05'"
" n -аналогично опции g, но учитывает настройки локали;
" G - эквивалентно f или Е(выбирается более короткая запись числа):
>» "'{0:G}' '{l:G}"'.fo:rmat(0.086578, 0.000086578)
"'0.086578' '8.6578Е-05'"
" %-умножает число на 100 и добавляет символ процента в конец. Значение ото
бражается в соответствии с опцией f. Пример:
»> "'{0:%)' '{l:.4%}'".foпnat(0.086578, 0.000086578)
"'8.657800%' 'О.0087%'"
6.4.1. Форматируемые строки
Форматируемая строка - это более компактная и удобная альтернатива методу fo:rmat().
Форматируемая строка предваряется буквой f или F. В нужных местах такой строки запи
сываются команды на вставку в эти места значений, хранящихся в переменных, - точно
так же, как и в строках специального формата, описанных ранее. Такие команды имеют
следующий синтаксис:
{ [<Переменная>] [ !<Функция>] [:<Формат>]}
Параметр <Переменная> задает имя переменной, из которой будет извлечено вставляемое
в строку значение. Вместо имени переменной можно записать выражение, вычисляющее
значение, которое нужно вывести. Параметры <Функция> и <Формат> имеют то же назначе
ние и записываются так же, как и в случае метода foпnat(). Примеры:
>>> а = 10; Ь = 12.3; s = "string"
>>> f"{a} - {Ь} - {s}" # Простой вывод чисел и строк
'10 - 12.3 - string'
>>> f"{a} - {b:5.2f} - {s}" # Вывод с форматированием
'10 - 12.30 - string'
>>> d = 3
>>> f"{a} - {Ь:5.{d}f} - {s}" # В опциях можно использовать
>>> # значения из переменных
'10 - 12.300 - string'
>>> arr = [3, 4]
>>> f"{arr[0J} - {arr[l]}" # Вывод элементов массива
'3 - 4'
>>> f"{arr[0]} - {arr[l] * 2}" # Вывод результатов вычисления выражений
'3 - 8'
Начиная с Python 3.8, в форматируемой строке после переменной можно поставить символ
равенства(=)- и в строку будет подставлено имя этой переменной, знак равенства и зна
чение переменной:
Глава б. Строки и двоичные данные 109
»> Ь = 12.3
>>> f"(b=}", f"(b = }"
('Ь=12. 3', 'Ь = 12. 3')
>>> f"Значение переменной (Ь = :5.2f}"
'Значение переменной Ь = 12.30'
Этот программный инструмент может быть применен для вывода значений переменных при
отладке программ.
6.5. Функции и методы для работы со строками
Основные функции для работы со строками:
♦ str([<Значение>]) - преобразует заданное значение в строку, которую и возвращает..
Если параметр не указан, возвращается пустая строка. Используется функцией print(J
для вывода объектов. Примеры:
>>> str(}, str([l, 2]), str((3, 4)), str(("x": 1})
('', '[1, 2]', '(3, 4}', "('х': 1}")
>>> print("cтpoкal\ncтpoкa,2")
строкаl
строка2
♦ repr(<Значение>) - возвращает строковое представление заданного значения. Исполь
зуется при выводе данных интерпретатором, работающим в интерактивном режиме.
Примеры:
>>> rерr("Строка"), repr([l, 2, 3]), repr(("x": 5})
(" 'Строка' ", '[ 1, 2, 3]', "('х': 5}")
>>> repr("строкаl\nстрока2")
"'строкаl\\nстрока2'"
♦ ascii(<Значение>) - возвращает строковое представление заданного значения, содер
жащее только символы из кодировки ASCII:
»> ascii([l, 2, 3]), ascii(("x": 5})
('[1, 2, 3]', "('х': 5}")
>>> ascii("строка")
"'\\u0441\\u0442\\u0440\\u043e\\u043a\\u0430'"
♦ len(<Строка>) - возвращает длину заданной строки в символах:
>>> len("Python"), len("\r\n\t"), len(r"\r\n\t")
(6, 3, 6)
>>> lеn("строка")
6
Основные методы, поддерживаемые строками:
♦ strip( [<Символы>]) - удаляет указанные в параметре символы в начале и в конце те
кущей строки. Если параметр не задан, удаляются пробельные символы: пробел, перевод
строки (\n), возврат каретки (\r), горизонтальная (\t) и вертикальная (\v) табуляция.
Примеры:
11О Часть /. Основы языка Python
>>> sl, s2 = 11 str\n\r\v\t 11 , 11 strstrstrokstrstrstr 11
>>> 11 1 %
s' - 1 %
s 1 11 % (sl.strip
(), s2.strip( 11 tsr 11 ))
"'str' - 'ok'"
♦ lstrip( [<Символы>] J - удаляет заданные символы в начале текущей строки (если пара-
метр не указан, удаляет пробелы):
>>> sl, s2 = 11 str 11
,
11
strstrstrokstrstrstr 11
>>> 11 1 %
s' - %
' s 1 11 %
(sl.lstrip(), s2.lstrip( 11 tsr 11))
"'str ' - 'okstrstrstr' 11
♦ rstrip( [<Символы> J ) - удаляет задаш1ые символы в ко�ще текущей строки (если пара
метр не указан, удаляет пробелы):
>>> sl, s2 = 11 str 11
,
11
strstrstrokstrstrstr 11
>>> 11 1 %
s' - '%s 1 11 % (sl.rstrip(), s2.rstrip( 11 tsr 11 ))
str' - 'strstrstrok' 1 1
♦ split( [<Разделитель> [, <Лимит> J J J - разделяет текущую строку на подстроки по ука
занному разделитеmо и добавляет эти подстроки в список, который воз�ращает в каче
стве результата. Если первый параметр не указан или имеет значение None, то в качестве
разделителя используется символ пробела. Во втором параметре можно задать количе
ство подстрок в результирующем списке, если он не указан или равен -1, в список попа
дут все подстроки. Если подстрок _больше указанного количества, то список будет со
держать еще один элемент - с остатком строки. Примеры:
>>> s = 11 wordl word2 word3 11
>>> s.split(), s.split(None, 1)
( ['wordl', 'word2', 'wordЗ' ] , ['wordl', 'word2 wordЗ' ] )
>>> s = 11 wordl\nword2\nword3 11
>>> s.split( 11 \n 11 )
['wordl', 'word2', 'wordЗ' ]
Если в текущей строке содержатся несколько пробелов подряд и разделитель не указан;
то пустые элементы не будут добавлены в список:
>>> s = 11 wordl word2 wordЗ
>» s.split()
['wordl', 'word2', 'wordЗ']
При использовании другого разделителя могут возникнуть пустые элементы:
>>> s = ",,wordl,,word2,,word3,,"
>>> s.split(", 1 1)
['' ' '', 'wordl', '' ' 'word2', 'wordЗ', 1 1]
>>> 11 1,,2,,3".split(",")
[ 11', 1 1, 12 1' '1, 131]
Если разделитель в текущей строке не найден, то список будет состоять из одного эле
мента, представляющего текущую строку:
>>> "wordl word2 word3 11 .split( 11 \n 1 1)
['wordl word2 wordЗ']
♦ rsplit( [<Разделитель> [, <Лимит> J J ) - аналогичен методу split(), но поиск символа
разделителя производится не слева направо, а наоборот - справа налево:
Глава 6. Сtпроки и двоичные данные 111
>>> s = "wordl word2 wordЗ"
>>> s.rsplit(), s.rsplit(None, 1)
(['wordl', 'word2', 'wordЗ' ] , ['wordl word2 ', 'wordЗ' ] )
♦ splitlines([False]) - разделяет текущую строку на подстроки по символу перевода
строки (\n) и добавляет их в список. Символы новой строки вкточаются в результат,
только если необязательный параметр имеет значение True. Если разделитель в текущей
строке не найден, список будет содержать только один элемент - саму текущую строку.
Примеры:
>>> "wordl\nword2\nword3".splitlines()
['wordl', 'word2', 'wordЗ' ]
>>> "wordl\nword2\nword3".splitlines(True)
['wordl\n', 'word2\n', 'wordЗ']
>>> "wordl word2 wordЗ".splitlines()
['wordl word2 wordЗ']
♦ partition(<Разделитель>) - находит первое вхождение указанного символа-раздели
теля в текущей строке и возвращает кортеж из трех элементов: фрагмента, расположен
ного перед разделителем, разделителя и фрагмента, расположенного после разделителя.
Поиск производится слева направо. Если символ-разделитель не найден, то первый эле
мент кортежа будет содержать текущую строку, а остальные элементы останутся пусты
ми. Примеры:
>>> "wordl word2 wordЗ".partition(" ")
( 'wordl', ' ', 'word2 wordЗ')
>>> "wordl word2 wordЗ".partition("\n")
('wordl word2 wordЗ', '', '')
♦ rpartition(<Разделитель>) - аналогичен методу partition(), но поиск символа
разделителя производится не слева направо, а наоборот - справа налево. Если символ
разделитель не найден, то первые два элемента кортежа окажутся пустыми, а третий
элемент будет содержать текущую строку. Примеры:
>>> "wordl word2 wordЗ".rpartition(" ")
('wordl word2', ' ', 'wordЗ')
>>> "wordl word2 wordЗ".rpartition("\n")
('', '', 'wordl word2 wordЗ')
♦ join() - преобразует последовательность в строку. Элементы добавляются через ука
занный разделитель. Формат метода:
<Разделитель>.jоin(<Последовательность>)
В качестве примера преобразуем список и кортеж в строку:
>>> " => ".join(["wordl", "word2 11 ,wordЗ"])
11
'wordl => word2 => wordЗ'
>>> " ".join(( 11 wordl", 1 word2", "wordЗ"))
1
'wordl word2 wordЗ'
Элементы последовательностей должны быть строками, иначе возбуждается искточе
ние TypeError:
>>> 1111 join(( 1 wordl 11
• 1 ,
11
word2 11 5))
,
Traceback (most recent call last):
112 Часть /. Основы языка Python
File 1 < yshell#48>11 line 1, in <module>
1
p
,
1 11 join( ( 11 wordl 11 11 word21 1
1
• 5)) ,
,
TypeError: sequence item 2: ex ected str instance, int foundp
♦ remove refix(<Префикс>) (начиная с Python 3 .9)- удаляет у текущей строки указанный
p
префикс и возвращает результат. Если текущая строка не содержит такого префикса,
возвращает текущую строку. Пример:
>>> 1ActivePython11 remove refix( 11Active11
1 •
p )
'Python'
>>> 11 CPython".remove refix( Active11 p 11 )
'CPython'
♦ removesuffix(<Префикс>) (начиная с Python 3.9) ...:_ удаляет у текущей строки указа�mый
суффикс и возвращает результат . Если текущая строка не содержит такого суффикса,
возвращает текущую строку. Пример :
>>> 11 rogram. y".removesuffix(11 . y")
p p p
' rogram'
p
>>> " rogram.js11 .removesuffix(11 . y 1
p
p 1)
' rogram.js'
p
Строки относятся к неизменяемым типам данных, поэтому, если попытаться изменить ка
кой-либо символ в строке, возникнет ошибка. Однако можно преобразовать строку в список
с помощью функции list(), изменить нужные символы по их индексам, а затем вызовом
метода join() превратить список обратно в строку. Пример:
>>> s = Python11
11
>>> arr = list(s); arr # Преобразуем строку в список
[ 'Р 1 'у', 't', 'h', 0 'n']
, 1 1
,
>>> arr[O] = "J11 arr ; # Изменяем элемент по индексу
[ 'J', 'у', 't', 'h', 'о', 'n']
>>> s = " .join(arr); s
11 # Преобразуем список в строку
'Jython'
Если строка содержит лишь символы из кодировки ASCII, ее можно преобразовать в после
довательность байтов bytearray:
>>> s = "Python"
>>> Ь = bytearray(s, 11 ср1251"); Ь
bytearray(b'Python')
>>> Ь[О] = ord("J"); Ь
bytearray(b'Jython')
>>> s = b.decode("c l251 11 s p );
'Jython'
6.6. Настройка локали
Дriя установки локшrи (совокупности языковых настроек системы) служит функция
setlocale() из модуля locale. Прежде чем использовать функцию, необходимо подкmо- .
чить модуль с помощью выражения
im ort locale
p
Функция setlocale() имеет следующий формат вызова:
sеtlосаlе(<Категория>[, <Локаль>]);
Глава 6. Строки и двоичные данные 113
Параметр <Категория> может принимать следующие значения:
♦ locale.LC_ALL - устанавливает локаль для всех режимов;
♦ locale.LC_COLLATE - для сравнения строк;
♦ locale.LC_СТУРЕ - для перевода символов в IШЖНИЙ или верхний регистр;
♦ locale.LC_MONETARY - для отображения денежных единиц;
♦ locale.LC_NUМERIC - для форматирования чисел;
♦ locale.LC_ТIМЕ - для форматирования значений даты и времени.
Получить текущую локаль позволяет функция getlocale( [<Категория>]) . Если категория не
указана, будет выдана локаль для всех категорий.
В качестве примера настроим локаль вначале на кодировку Windows-1251, потом на коди•
ровку UTF-8, затем на кодировку по умолчанюо, после чего выведем текущую локаль для
всех категорий и только для locale.LC_COLLATE:
>>> import locale
>>>#Дпя кодировки windows-1251
>>> locale.setlocale(locale.LC_ALL, "Russian_Russia .1251")
'Russian Russia.1251'
>>>#Устанавливаем локаль no умолчанию
>>> locale.setlocale(locale.LC_ALL, "")
'Russian Russia.1251'
>>>#Получаем текущее значение лакали для всех категорий
>>> locale.getlocale()
('Russian_Russia', '1251')
>>>#Получаем текущее значение категории locale.LC COLLATE
>>> locale.getlocale(locale.LC_COLLATE)
('Russian_Russia', '1251')
Получить настройки локали позволяет функция localeconv() из модуля locale. Функция
возвращает словарь с настройками. Результат ее выполнения для локали Russian
Russia .1251 выглядит следующим образом:
>>> locale.localeconv()
{'int_curr_symЬol': 'RUB', 'currency_symЬol': ' ',
'mon_decimal_point': ', ', 'mon_thousands_sep': '\хаО',
'mon_grouping': [3, О], 'positive_sign': '', 'negative_sign': ,_,
'int_frac_digits': 2, 'frac_digits': 2, 'p_cs_precedes': О,
'p_sep_by_space': 1, 'n_cs_precedes': О, 'n_sep_by_space': 1,
'p_sign_posn': 1, 'n_sign_posn': 1, 'decimal_point':
'thousands sep': '\хаО', 'grouping': [З, О]}
6.7. Изменение регистра символов
Для изменения регистра символов в строке предназначены следующие методы:
♦ upper(} - приводит все символы в текущей строке к верхнему регистру:
>>> print("cтpoкa".upper(})
СТРОКА
114 Часть /. Основы языка Python
♦ lower() - приводит все символы в текущей строке к нижнему регистру:
>>> print("CTPOКA".lower())
строка
♦ swapcase() - заменяет в текущей строке все строчные символы соответствующими
прописными буквами, а все прописные символы - строчными: ·
>>> print("CTPOКA cтpoкa".swapcase())
строка СТРОКА
♦ capitalize() - делает первую букву текущей строки прописной:
>>> print("cтpoкa cтpoкa".capitalize())
Строка строка
♦ title() - делает первую букву каждого слова в текущей строке прописной:
>>> s = "первая буква каждого слова станет прописной"
>>> print(s.title())
Первая Буква каждого Слова Станет Прописной
♦ casefold() - то же самое, что и lower(), но дополнительно преобразует все символы
с диакритическими знаками и лигатуры в буквы стандартной латиницы. Обычно приме
няется для сравнения строк:
>>> "Python".casefold() "python".casefold()
True
>>> "grosse".casefold() "groBe".casefold()
True
6.8. Функции для работы с символами
Для работы с отдельными символами предназначены следующие функции:
♦ chr(<Код символа>) - возвращает символ по указанному коду:
>>> print(chr(l77))
±
♦ ord(<Символ>) - возвращает код указанного символа:
>>> print(ord("±"))
177
6.9. Поиск и замена в строке
Для поиска и замены в строке используются следующие методы:
♦ find() - ищет в текущей строке заданную подстроку. Возвращает номер позиции,
с которой начинается вхождение подстроки в строку. Если подстрока не найдена, воз
вращает значение -1. Регистр символов учитывается. Формат метода:
<Строка>.find(<Подстрока>[, <Начало>[, <Конец>]])
Если параметр <Начало> не указан, то поиск будет осуществляться с начала текущей
строки. Если параметры <Начало> и <Конец> указаны, то извлекается срез строки:
<Строка>[<Начало>:<Конец>]
Глава б. Строки и двоичные данные 115
и поиск подстроки выполняется с начала полученного фрагмента:
>>> s = "пример пример Пример"
>>> s.find("пpи"), s.find("Пpи"), s.find("тecт")
(О, 14, -1)
>>> s.find("пpи", 9), s.find("пpи", О, 6), s.find("пpи", 7, 12)
(-1, о, 7)
♦ index() - аналогичен методу find(), но если подстрока не найдена, возбуждает исклю
чение ValueError:
>>> s = "пример пример Пример"
>>> s.index("пpи"), s.index("пpи", 7, 12), s.index("Пpи", 1)
(О, 7, 14)
>>> s.index("тecт")
Traceback (most recent call last):
File "<pyshell#24>", line 1, in <module>
s ..index("тест")
ValueError: suЬstring not found
♦ rfind() - ищет в текущей строке заданную подстроку. Возвращает позицmо последне
го вхождения подстроки в строку. Если подстрока не найдена, возвращается значение -1.
Регистр символов учитывается. Формат метода:
<Строка>.rfind(<Подстрока>[, <Начало>[, <Конец>]])
Если параметр <Начало> не указан, то поиск будет производиться с конца текущей стро
ки. Если параметры <Начало> и <Конец> указаны, то извлекается срез строки, и поиск
подстроки производится с конца полученного фрагмента. Пример:
>>> s = "пример пример Пример Пример"
>>> s.rfind("пpи"), s.rfind("Пpи"), s.rfind("тecт")
(7, 21, -1)
>>> s.rfind("Пpи"), s.find("Пpи", 12, 18)
(21, 14)
♦ rindex() - аналогичен методу rfind(), но если подстрока не найдена, возбуждает ис
ключение ValueError:
>>> s = "пример пример Пример Пример"
>>> s.rindex("при"), s.rindex("При"), s.rindex("при", О, 6)
(7, 21, О)
>>> s.rindex("тест")
Traceback (most recent call last):
File "<pyshell#ЗO>", line 1, in <module>
s.rindex("тест")
·valueError: suЬstring not found
♦ count() - возвращает число вхождений заданной подстроки в текущую строку. Регистр
символов учитывается. Формат метода:
<Строка>.соunt(<Подстрока>[, <Начало>[, <Конец>]])
Если параметр <Начало> не указан, то подсчет подстрок будет производиться во всей
текущей строке. Если параметры <Начало> и <Конец> указаны, то извлекается срез строки
и подсчет .подстрок производится в полученном фрагменте. Примеры:
116 Часть 1. Основы языка Python
>>> s = "пример пример Пример Пример"
>>> s.соuпt("при"), s.count("пpи", 6), s.count("Пpи")
(2, 1, 2)
>>> s.count("тест")
о
♦ startswith() - проверяет, начинается ли текущая строка с указанной подстроки. Если
начинается, возвращается значение True, в противном случае - False. Регистр символов
учитывается. Формат метода:
<Cтpoкa>.startswith(<Пoдcтpoкa>[, <Начало>[, <Конец>]])
Если параметр <Начало> не указан, сравнение будет производиться с началом текущей
строки. Если параметры <Начало> и <Конец> указаны, то извлекается срез строки и срав
нение производится с началом полученного фрагмента. Примеры:
>>> s = "пример пример Пример Пример"
>>> s.startswith("пpи"), s.startswith("Пpи")
(True, False)
>>> s.startswith("пpи", 6), s.startswith("Пpи", 14)
(False, True)
Параметр <Подстрока> может быть кортежем:
>>> s = "пример пример Пример Пример"
>>> s.startswith(("пpи", "При"))
True
♦ endswith() - проверяет, заканчивается ли текущая строка указанной подстрокой. Если
заканчивается, то возвращается значение True, в противном случае - False. Регистр
символов учитывается. Формат метода:
<Cтpoкa>.endswith(<Пoдcтpoкa>[, <Начало>[, <Конец>]])
Если параметр <Начало> не указан, то сравнение будет производиться с концом текущей
строки. Если параметры <Начало> и <Конец> указаны, то извлекается срез строки и срав
нение производится с концом полученного фрагмента. Примеры:
>>> s = "подстрока ПОДСТРОКА"
>>> s.endswith("oкa"), s.endswith("OКA")
(False, True)
>>> s.endswith("oкa", О, 9)
True
Параметр <Подстрока> может быть кортежем:
>>> s = "подстрока ПОДСТРОКА"
>>> s.endswith(("oкa", "ОКА"))
True
♦ replace () - производит замену всех вхождений заданной подстроки в текущей строке
на другую подстроку и возвращает результат в виде новой строки. Регистр символов
учитывается. Формат метода:
<Строка>.rерlасе(<Заменяемая подстрока>, <Заменяк:щая подстрока>[,
<Максимальное количество замен>])
Если максимальное количество замен не указано, будет выполнена замена всех найден
ных подстрок. Примеры:
Глава б. Строки и двоичные данные 117
>>> s = "Привет, Петя"
>>> print(s.replace("Петя", "Вася"))
Привет, Вася
>>> print(s.replace("neтя", "вася")) # Зависит от регистра
Привет, Петя
>>> s = "strstrstrstrstr"
>>> s.replace("str", ""), s.replace("str", "", 3)
('', 'strstr')
♦ translate (<Таблица символов>) _:_ заменяет символы в текущей строке. Параметр
<Таблица символов> должен быть словарем, ключами которого являются Unicode-кoды
заменяемых символов, а значениями - Unicode-кoды заменяющих символов. Если вме
сто кода заменяющего символа указать None, то соответствующий заменяемый символ
будет удален. Для примера удалим букву п, а также изменим регистр всех букв р:
>>> s "Пример"
>>> d = {ord("П"): None, ord("p"): ord("P")}
>>> d
{1088: 1056, 1055: None}
>>> s.translate(d)
'РимеР'
Упростить создание таблицы символов позволяет статический метод maketrans(). Фор
мат метода:
str.maketrans(<X>[, <У>[, <Z>]])
Если указан только первый параметр, то он должен быть словарем:
>>> t = str.maketrans({"a": "А", "о": "О", "с": None})
>>> t
{1072: 'А', 1089: None, 1086: 'О'}
>>> "cтpoкa".translate(t)
'трОкА'
Если указаны два первых параметра, то они должны быть строками одинаковой длины.
В результате будет создан словарь с ключами из строки <Х> и значениями из строки <У>,
расположенными в той же позиции. Изменим регистр некоторых символов:
>>> t = str.maketrans("aбвгдeжзи", "АБВГДЕЖЗИ")
>>> t
{1072: 1040, 1073: 1041, 1074: 1042, 1075: 1043, 1076: 1044,
1077: 1045, 1078: 1046, 1079: 1047, 1080: 1048}
>>> "абвгдежзи".trаnslаtе(t)
'АБВГЦЕЖЗИ'
В третьем параметре можно дополнительно указать строку из символов, которым будет
сопоставлено значение None. После выполнения метода translate() эти символы будут
удалены из строки. Заменим все цифры на О, а некоторые буквы удалим из строки:
>>> t = str.maketrans("123456789", "О" * 9, "str")
>>> t
{116: None, 115: None, 114: None, 49: 48, 50: 48, 51: 48,
52: 48, 53: 48, 54: 48, 55: 48, 56: 48, 57: 48)
>>> "str123456789str".translate(t)
'000000000'
118 Часть /. Основы языка Python
6.1 О. Проверка содержимого строки
Для проверки содержимого строки предназначены следующие методы:
♦ isalnurn() - возвращает True, если текущая строка содержит только буквы и (или) циф
ры, в противном случае - False. Если строка пустая, возвращается False. Примеры:
>>> "0123".isalnurn(), "123abc".isalnurn(), "abcl23".isalnurn()
(True, True, True)
>>> "строка".isalnurn()
True
>>> "" . isalnurn (), "123 аЬс".isalnurn(), "аЬс, 123.".isalnurn()
(False, False, False)
♦ isalpha()- возвращает тrue, если текущая строка содержит только буквы, в противном
случае- False. Если строка пустая, возвращается False. Примеры:
>>> "string".isalpha(), "строка".isalpha(), "".isalpha()
(True, True, False)
>>> "123abc".isalpha(), "str str".isalpha(), "st,st".isalpha()
(False, False, False)
♦ isascii() (начиная с Python 3.7)- возвращает True, если текущая строка содержит
лишь символы из кодировки ASCII, в противном случае - False. Если строка пустая,
возвращается True. Примеры:
>>> "123abc".isascii(), "cтpoкa123".isascii(), "".isascii()
(True, False, True)
♦ isdigit ()- возвращает тrue, если текущая строка содержит только обычные цифры,
в противном случае- False. Если строка пустая, возвращается False. Примеры:
>>> "0123".isdigit(), "123аЬс".isdigit (), "аЬс123".isdigit()
(True, False, False)
♦ isdecimal() - возвращает True, если текущая строка содержит только символы цифр
(обычных, надстрочных и подстрочных), в противном случае- False. Если строка пус
тая, возвращается False. Примеры:
>>> "123".isdecimal(), "123стр".isdecimal()
(True, False)
♦ isnurneric()- возвращает тrue, если текущая строка содержит только символы чисел
(обычные и римские цифры, дробные числа), в противном случае - False. Если строка
пустая, возвращается False. Примеры:
>>> "\u2155".isnurneric(), "\u2155".isdigit()
(True, False)
>>> print ( "\u2155") # Выведет символ "1/5"
♦ isupper()- возвращает True, если текущая строка содержит буквы только, верхнего
регистра, в противном случае- False. Если строка пустая или не содержит букв, воз
вращается False. Примеры:
>>> "STRING".isupper(), "СТРОКА".isupper(), "".isupper()
(True, True, False)
Глава б. Строки и двоичные данные 119
>>> "STRINGl".isupper(), "СТРОКА, 123".isupper(), "123".isupper()
(True, True, False)
>>> "string".isupper·(), "STRing".isupper()
(False, False)
♦ islower() - возвращает True, если текущая строка содержит буквы только нижнего
регистра, в противном случае - False. Если строка пустая или не содержит букв, воз
вращается False. Примеры:
>>> "sr ting".islower(), "cтpoкa".islower(), "".islower()
(True, True, False)
>>> "stringl".islower(), "str, 123".islower(), "123".islower()
(True, True, False)
>>> "STRING".islower(), "Cтpoкa".islower()
(False, False)
♦ istitle() - возвращает True, если все слова в текущей строке начинаются с заглавной
буквы, в противном случае - False. Если строка пустая или не содержит букв, возвра
щается False. Примеры:
>>> "Str Str".istit le(), "Стр Стр".istit le()
(True, True)
>>> "Str Str 123".istit le(), "Стр Стр 123".istit le()
(True, True)
>>> "Str str".istitle(), "Стр стр".istitle()
(False, False)
>>> "".istitle(), "123".istit le()
(False, False)
♦ isprint aЫe() - возвращает True, если текущая строка содержит только печатаемые
символы, в противном случае - False. Пробел относится к печатаемым символам. Если
строка пустая, возвращается тrue. Примеры:
>>> "123".isprint aЫe()
True
>>> "РНР Python".isprint aЫe()
True
>>> "\n".isprintaЫe()
False
♦ isspace() - возвращает True, если текущая строка содержит только пробельные симво
лы, в противном случае - False. Если строка пустая, возвращается False. Пример:
>>> "".isspace(), " \n\r \t ".isspace(), "str str".isspace()
(False, True, False)
♦ iside ntifier() - возвращает тrue, если текущая строка представляет собой допустимое
с точки зрения Python имя переменной, функции или класса, в противном случае -
False:
>>> "s".iside ntifier()
True
>>> "func".iside ntifier()
True
120 Часть /. Основы языка Python
>>> "123func".isidentifier()
False
Следует иметь в виду, что метод isidentifier() лишь проверяет, удовлетворяет ли за
данное имя правилам языка. Он не проверяет, совпадает ли это имя с каким-либо ключе
вым словом Python. Для выполнения такой проверки надлежит применять функцmо
iskeyword() из модуля keyword, которая возвращает True, если переданная ей строка
совпадает с одним из ключевых слов, например:
>>> keyword.iskeyword("else")
True
>>> keyword.iskeyword("elsewhere")
False
Переделаем нашу программу суммирования произвольного количества целых чисел, вве
денных пользователем (см. листинг 4.13), таким образом, чтобы при вводе строки вместо
числа программа не завершалась с фатальной ошибкой. Кроме того, предусмотрим возмож
ность ввода отрицательных целых чисел (листинг 6.2).
рrint("Введите слово 'stop' для получения результата")
sumrha = О
while (х := inрut("Введите число: ")) ! = "stop":
if Х == Н11:
print("Bы не ввели значение!")
continue
if х[О] == "-": # Если первым символом является минус
if not x[l:] .isdigit(): # Если фрагмент не состоит из цифр
рrint("Необходимо ввести число, а не строку!")
continue
else: # Если минуса нет, то проверяем всю строку
if not x.isdigit(): # Если строка не состоит из цифр
рrint("Необходимо ввести число, а не строку!")
continue
х = int(x) # Преобразуем строку в число
sumrna += х
print("Cyммa чисел равна:", sumrna)
input()
Процесс ввода значений и получения результата выглядит так (значения, введенные поль
зователем, выделены полужирным шрифтом):
Введите слово 'stop' для получения результата
Введите число: 10
Введите число:
Вы не ввели значение!
Введите число: str
Необходимо ввести число, а не строку!
Введите число: -5
Введите число: -str
Необходимо ввести число, а не строку!
Глава б. Строки и двоичные данные 121
Введите число: stop
Сумма чисел равна: 5
6.11. Двоичные данные типа bytes
Тип данных bytes представляет неизменяемую последовательность байтов (чисел от О
ДО 255).
Создать значение типа bytes можно следующими способами:
♦ с помощью функции bytes( [<Строка>, <Кодировка> [, <Обработка 0IIП1бок>] ] ). Если па
раметры не указаны, то возвращается пустая последовательность байтов. Чтобы преоб
разовать заданную · строку в значение типа bytes, необходимо передать минимум два
первых параметра. Если указан только первый параметр, то возбуждается искточение
TypeError. Примеры:
>>> bytes()
Ь',
>>> bytes("строка", "ср1251")
b'\xfl\xf2\xf0\xee\xea\xe0'
>>> bytes("строка")
Traceback (most recent call last):
File "<pyshell#ЗЗ>", line 1, in <module>
bytes("строка")
TypeError: string argument without an encoding
В третьем параметре могут быть указаны значения "strict" (при ошибке возбуждается
искточение UnicodeEncodeError- значение по умолчанию), "replace" (неизвестный
символ заменяется знаком вопроса) или "ignore" (неизвестные символы игнорируются):
>>> bytes("string\uFFFD", "ср1251", "strict")
Traceback (most recent call last):
File "<pyshell#ЗS>", line 1, in <module>
bytes("string\uFFFD", "ср1251", "strict")
File "C:\Python310\lib\encodings\cp1251.py", line 12, in encode
return codecs.charmap_encode(input,errors,encoding_taЬle)
UnicodeEncodeError: 'charmap' codec can't encode character
'\ufffd' in position 6: character maps to <undefined>
>>> bytes("string\uFFFD", "ср1251", "replace")
b'string?'
>>> bytes("string\uFFFD", "ср1251", "ignore")
b'string'
♦ с помощью строкового метода encode( [encoding="utf-8" J · [, errors="strict" J ) • В па
раметре encoding задается кодировка (по умолчанию UTF-8). В параметре errors могут
быть указаны значения "strict" (значение по умолчанию), "replace", "ignore",
"xmlcharrefreplace" или "backslashreplace". Примеры:
>>> "строка".еnсоdе()
b'\xdl\x81\xdl\x82\xdl\x80\xdO\xЬe\xd0\xЬa\xd0\xЬO'
>>> "cтpoкa".encode(encoding="cp1251")
b'\xfl\xf2\xf0\xee\xea\xe0'
122 Часть /. Основы языка Python
>>> "cтpoкa\uFFFD".encode(encoding="cp1251",
errors="xrnlcharrefreplace")
b'\xfl\xf2\xf0\xee\xea\xe0�'
>>> "cтpoкa\uFFFD" .encode(encoding="cp1251",
errors="backslashreplace")
b'\xfl\xf2\xf0\xee\xea\xe0\\ufffd'
♦ указав букву ь (регистр не имеет значения) перед строкой в апострофах, кавычках, трой
ных апострофах или тройных кавычках. В строке могут присутствовать только символы
из кодировки ASCII, все остальные символы должны быть представлены специальными
последовательностями. Примеры:
>>> b"string", b'string', b"""string""", b'''string'''
(Ь'string', Ь'string', Ь'string', Ь'string')
>>> Ь"строка"
SyntaxError: bytes can only contain ASCII literal characters.
>>> b"\xfl\xf2\xf0\xee\xea\xe0"
b'\xfl\xf2\xf0\xee\xea\xe0'
♦ с помощью функции bytes(<Последовательность>), которая преобразует заданную по
следовательность целых чисел от О до 255 в объект типа bytes. Если какое-либо число из
последовательности не попадает в диапазон, возбуждается исключение valueError.
Примеры:
»> b = bytes([225, 226, 224, 174, 170, 160])
>>> ь
b'\xel\xe2\xe0\xae\xaa\xa0'
>>> str(b, "ср866")
'строка'
♦ с помощью функции bytes(<Количество>), которая возвращает последовательность из
заданного количества нулевых элементов:
»> bytes(10)
Ь'\х00\х00\х00\х00\х00\х00\х00\х00\х00\х00'
♦ с помощью метода bytes.fromhex(<Строка>). Заданная строка в этом случае должна со
держать только шестнадцатеричные числа. Начиная с Python 3. 7, числа в строке можно
разделять пробелами, которые будут проигнорированы. Пример:
>>> Ь = bytes.fromhex(" el е2е0ае аааО ")
>>> ь
b'\xel\xe2\xe0\xae\xaa\xa0'
>>> str(Ь, "ср866")
'строка'
Как и все последовательности, значения типа bytes поддерживают обращение к элементу
по индексу, получение среза, конкатенацию, повторение и проверку на вхождение:
>>> Ь = b�es( "string", "ср1251")
>>> ь
Ь'string'
>>> Ь[О] # Обращение по индексу
115
>>> b[l:3] # Получение среза
b'tr'
Глава б. Строки и двоичные данные 123
>>> Ь + Ь"123" # Конкатенация
b'stringl23'
>>> ь * 3 # Повторение
b'stringstringstring'
>>> 115 in ь, b"tr" in Ь, b"as" in ь
(True, True, False)
Как видно из примера, при выводе значения целиком, а также при извлечении среза произ
водится попытка.,,отображения символов. Однако доступ по индексу возвращает целое чис
ло, а не символ. Если преобразовать объект в список, то мы получим последовательность
целых чисел:
>>> list(bytes("string", "ср1251"))
[115, 116, 114, 105, 110, 103)
Тип bytes относится к неизменяемым типам. Это означает, что можно получить значение
по индексу, но изменить его нельзя:
>>> Ь = bytes("string", "ср1251")
»> Ь[О] = 168
Traceback (most recent call last):
File "<pyshell#76>", line 1, in <module>
Ь[О] = 168
TypeError: 'bytes' object does not support item assignment
Объекты типа bytes поддерживают большинство строковых методов, рассмотренных в пре
дыдущих разделах, за исключением encode(), isidentifier(), isprintaЫe(), isnumeric(),
isdecimal(), format_map(), format() и операции форматирования. При использовании этих
методов следует учитывать, что в параметрах нужно указывать объекты типа bytes, а не
строки, например:
>>> Ь = bytes("string", "ср1251")
>>> b.replace(b"s", b"S"l
b'String'
Смешивать строки и значения типа bytes в выражениях нельзя. Необходимо явно преобра
зовать объекты к одному типу, и лишь затем производить операцию, например:
>>> b"string" + "string"
Traceback (most recent call last):
File "<pyshell#79>", line 1, in <module>
b"string" + "string"
TypeError: can't concat bytes to str
>>> b"string" + "string".encode("ascii")
b'stringstring'
Значение типа bytes может содержать как однобайтовые, так и многобайтовые символы.
При использовании многобайтовых символов некоторые функции могут работать не так,
как предполагалось, - например, функция len() вернет количество байтов, а не символов:
>>> lеn("строка")
6
>>> len(bytes("cтpoкa", "ср1251"))
6
>>> len(bytes("cтpoкa", "utf-8"))
12
124 Часть /. Основы языка Python
Преобразовать значение типа bytes в строку позволяет метод decode(). Метод имеет сле
дующий формат:
decode( [encoding="utf-8"] [, errors="strict"])
Параметр encoding задает кодировку символов (по умолчанию UTF-8) в текущей последо
вательности, а параметр errors - способ обработки ошибок при преобразовании: "strict"
(значение по умолчанию), "replace" или "ignore". Пример преобразования:
>>> Ь = bytes("строка", "ср1251")
>>> b.decode(encoding="cp1251")
'строка'
Для преобразования также можно воспользоваться функцией str() :
>>> Ь = Ьуtеs("строка", "ср1251")
>>> str(Ь, "ср1251")
'строка'
Чтобы изменить кодировку данных, сначала следует преобразовать значение типа bytes
в строку, а затем произвести обратное преобразование, указав нужную кодировку. Преобра
зуем данные из кодировки Windows-1251 в кодировку KOI8-R, а затем обратно:
>>> w = Ьуtеs("Строка", "ср1251") # Данные в кодировке windows-1251
>>> k = w.decode("cp1251") .encode("koiB-r")
>>> k, str(k, "koiB-r") # Данные в кодировке KOIB-R
(b'\xf3\xd4\xd2\xcf\xcb\xcl', 'Строка')
>>> w = k.decode("koiB-r") .encode("cp1251")
>>> w, str(w, "ср1251") # Данные в кодировке windows-1251
(b'\xdl\xf2\xf0\xee\xea\xe0', 'Строка')
Последовательности типа bytes можно форматировать с применением описанного в разд. 6.3
оператора%:
>>> b"%i - %i - %f" % (10, 20, 30)
b'l0 - 20 - 30.000000'
Однако тип преобразования s (т. е. вывод в виде Unicode-cтpoки) в этом, случае не поддер
живается, и его использование приведет к возбуждению искточения TypeError:
>>> b"%s - %s - %s" % (10, 20, 30)
Traceback (most recent call last):
File "<pyshell#S0>", line 1, in <module>
b"%s - %s - %s" % (10, 20, 30)
TypeError: %Ь requires а bytes-like object, or an object that implements
_bytes_, not 'int'
Метод hex() возвращает строку с шестнадцатеричным представлением текущей последова
тельности типа bytes. Формат метода:
hex( [ <Разделитель> [, <Число байтов в группе>] ] )
Поддержка параметров у этого метода появилась в Python 3.8. Параметр <Разделитель> за
дает разделитель, который будет вставляться между отдельными группами байтов в выда
ваемой строке (если он не ·указан, никакой разделитель не вставляется). Если параметру
<Число байтов в группе> присвоено положительное число, отсчет байтов ведется справа,
если отрицательное - слева, если параметр вообще не задан, число байтов в группе прини
мается равным 1. Примеры:
Глава б. Строки и двоичные данные 125
>>> b"string".hex()
'737472696е67'
>>> b"string".hex(' '), b"string" .hex(' ', 4), b"string" .hex(' ', -4)
('73_74_72_69_6е_67', '7374_72696е67', '73747269_6е67')
6.12. Двоичные данные типа bytearray
Тип данных bytearray аналогичен типу bytes, только является изменяемым.
Создать значение типа bytearray можно следующими способами:
♦ с помощью функции bytearray([<Строка>, <Кодировка>[, <Обработка ошибок>] ] ). Если
параметры не указаны, то возвращается пустая последовательность байтов. Чтобы пре
образовать заданную строку в значение типа bytearray, необходимо передать как мини
мум два первых параметра. Если указан только первый параметр, то возбуждается ис
ключение TypeError. Примеры:
»> bytearray()
bytearray(Ь'')
>>> bytearray ("строка", "ср1251")
bytearray(b'\xfl\xf2\xf0\xee\xea\xe0')
>>> bytearray("cтpoкa")
Traceback (most recent call last):
File "<pyshell#2>", line 1, in <module>
bytearray("строка")
TypeError: string argument without an encoding
В третьем параметре могут быть указаны значения "strict" (при ошибке возбуждается
исключение UnicodeEncodeError - значение по умолчанию), "replace" (неизвестный
символ заменяется знаком вопроса) или "ignore" (неизвестные символы игнорируются):
>>> bytearray ("string\uFFFD", "ср1251", "strict")
Traceback (most recent call last):
File "<pyshell#S>", line 1, in <module>
bytearray("string\uFFFD", "ср1251", "strict")
File "C:\Python310\lib\encodings\cp1251.py", line 12, in encode
return codecs.charmap_encode(input,errors,encoding_taЫe)
UnicodeEncodeError: 'charmap' codec can't encode character
'\ufffd' in position 6: character maps to <undefined>
>>> bytearray("string\uFFFD", "ср1251", "replace")
bytearray(b'string?')
>>> bytearray("string\uFFFD", "ср1251", "ignore")
bytearray(b'string')
♦ с помощью функции bytearray(<Последовательность>), которая преобразует заданную
последовательность целых чисел от О до 255 в значение типа bytearray. Если какое-либо
число из последовательности не попадает в диапазон, возбуждается исключение
ValueError. Примеры:
>>> Ь = bytearray([225, 226, 224, 174, 170, 160))
>>> ь
bytearray(b'\xel\xe2\xe0\xae\xaa\xa0')
126 Часть /. Основы языка Python
>>> str(b, "срВбб")
'строка'
♦ с помощью функции bytearray(<Количество>), которая вернет последовательность из
указанного количества нулевых элементов:
>>> bytearray(S)
bytearray(b'\x00\x00\x00\x00\x00')
♦ с помощью метода bytearray.fromhex(<Строка>). Указанная строка должна содержать
только шестнадцатеричные числа и пробелы, которые будут проигнорированы. При
меры:
>>> Ь = bytearray.fromhex(" el е2е0ае аааО ")
>>> ь
bytearray(b'\xel\xe2\xe0\xae\xaa\xa0')
>>> str(b, "ср866")
'строка'
Любой элемент в последовательности типа bytearray можно изменить. При этом важно
помнить, что присваиваемое ему новое значение должно быть целым числом в диапазоне от
О до 255. Примеры:
>>> Ь = bytearray("Python", "ascii")
>>> Ь[О] # Можем получить значение
80
>>> Ь[О] = b"J"[О] # Можем изменить значение
>>> ь
bytearray(Ь' Jython')
Для изменения значения типа bytearray также можно использовать следующие методы:
♦ append(<Число>) - добавляет заданное число в конец текущей последовательности:
>>> Ь = bytearray("string", "ascii")
»> b.append(b"l"[0]); Ь
bytearray(Ь'stringl')
♦ ехtеnd(<Последовательность>) - добавляет элементы заданной последовательности
в конец текущей:
>>> Ь = bytearray("string", "ascii")
>>> b.extend(b"l23"); Ь
bytearray(b'stringl23')
Добавить несколько элементов также можно с помощью операторов + и +=:
>>> Ь = bytearray("string", "ascii")
>>> Ь + Ь"123" # Возвращает новый объект
bytearray(b'stringl23')
>>> Ь += Ь"456"; ь # Изменяет текущий объект
bytearray(b'string456')
Кроме того, можно воспользоваться операцией присваивания значения срезу:
>>> Ь = bytearray("string", "ascii")
>>> b[len(b):] = Ь"123" # Добавляем элементы в последовательность
Глава б. Строки и двоичные данные 127
>>> ь
bytearray(b'stringl23')
♦ insert(<Индекс>, <Число>) - добавляет заданное число в текущую последователь
ность по указанному индексу. Остальные элементы смещаются. Добавим элемент в на
чало последовательности:
>>> Ь = bytearray("string", "ascii")
>>> b.insert(O, b"l"[O]); Ь
bytearray(Ь'lstring')
Чтобы добавить несколько элементов, можно воспользоваться операцией присваивания
значения срезу. Добавим несколько элементов в начало объекта:
>>> Ь = bytearray("string", "ascii")
>>> Ь[:0] = Ь"123"; Ь
bytearray(b'l23string')
♦ рор( [ <Индекс> J ) - удаляет из текущей последовательности элемент, расположенный
по указанному индексу, и возвращает его. Если индекс не указан, удаляет и возвращает
последний элемент. Примеры:
>>> Ь = bytearray("string", "ascii")
>>> Ь.рор() # Удаляем последний элемент
103
»> ь
bytearray(b'strin')
»> Ь.рор(О) # Удаляем первый элемент
115
>>> ь
bytearray(Ь'trin')
Удалить элемент последовательности также позволяет оператор ctel:
>>> Ь = bytearray("string", "ascii")
>>> del Ь[5] # Удаляем последний элемент
>>> ь
bytearray(b'strin')
>» del Ь[ :2) # Удаляем первый и второй элементы
>>> ь
bytearray(b'rin')
♦ remove (<Число>) - удаляет из текущей последовательности первый встреченный эле
мент, хранящий указанное число. Если элемент не найден, возбуждается искточение
ValueError. Пример:
>>> Ь = bytearray("strstr", "ascii")
>>> b.remove(b"s"[O]) # Удаляет только первый элемент
>>> ь
bytearray(b'trstr')
♦ reverse() - изменяет порядок следования элементов текущей последовательности на
противоположный:
>>> Ь = bytearray("string", "ascii")
>>> b.reverse(); Ь
bytearray(b'gnirts')
128 Часть /. Основы языка Python
Преобразовать значение типа bytearray в строку позволяет метод decode(). Метод имеет
следующий формат:
decode( [ encoding="utf-8"] [, errors="strict"] )
Параметр encoding задает кодировку символов (по умолчанию UTF-8) в текущей последо
вательности, а параметр errors - способ обработки ошибок при преобразовании: "strict"
(значение по умолчанию), "replace" или "ignore". Пример:
>>> Ь = bytearray("cтpoкa", "ср1251")
>>> b.decode(encoding="cpl251"), b.decode("cpl251")
('строка', 'строка')
Для преобразования также можно воспользоваться функцией str():
>>> Ь = bytearray("cтpoкa", "ср1251")
>>> str(Ь, "ср1251")
'строка'
6.13. Сериализация и десериализация значений
Сериализацuя - это преобразование какого-либо значения в последовательность байтов,
обычно типа bytes (что может понадобиться, например, для записи значения в файл). Десе
риализация - это обратное преобразование значения из последовательности байтов в ис
ходный вид.
Инструменты для сериализации и десериализации находятся в модуле pickle, который
предварительно следует подключить с помощью инструкции:
if!1port_pickle
Для преобразования предназначены две функции:
♦ dumps(<Значение>·[, protocol=NoneJ) - производит сериализацию заданного значения и
возвращает результирующую последовательность байтов. Формат, в котором представ
ляется сериализованное значение, зависит от указанного во втором параметре протоко
ла, который задается в виде числа от О до значения константы pickle .НIGHEST_PROTOCOL.
Если второй параметр не указан, будет использован протокол 4 (константа pickle.
DEFAULT_PROTOCOL, до Python 3.8 этот параметр имел значение по умолчанию 3). Пример
преобразования списка и кортежа:
>>> irnport pickle
>>> objl = [1, 2, 3, 4, 5] # Список
>>> obj2 = ( 6, 7, 8, 9, 10) # Кортеж
>>> pickle.dшnps(objl)
b'\x80\x04\x95\x0f\x00\x00\xOO\xOO\x00\x00\x00]\x94(K\x01K\x02K\�
х03К\х04К\х05е.'
>>> pickle.dшnps(obj2)
Ь'\х80\х04\х95\х0е\х00\х00\х00\х00\х00\х00\х00(К\х06К\х07К\х08К\�
tK\nt\x94.'
♦ loads(<Последовательность байтов>) - производит десериализацию значения из задан
ной последовательность байтов. Пример восстановления cmt:cкa и кортежа:
>>> pickle.loads(b'\x80\x04\x95\x0f\x00\x00\x00\x00\x00\x00\x00]\x94(K\�
х01К\х02К\х03К\х04К\х05е.')
[1, 2, 3, 4, 5]
Глава б. Строки и двоичные данные 129
>>> pickle.loads(b'\x80\x04\x95\x0e\x00\x00\x00\x00\x00\x00\x00(K\x06K\�
x07K\x08K\tK\nt\x94. ')
(6, 7, 8, 9, 10)
6.14. Хеширование значений
Для вычисления хешей на основе последовательностей байтов предназначен модуль
hashlib. Предварительно следует подкmочить его с помощью инструкции:
import hashlib
Модуль предоставляет следующие функции: mdS (), shal(), sha224(), sha256(), sha384(),
sha512(), sha3_224(), sha3_256(), sha3_384(), sha3_512(), shake_l28() и shake_256() .
В качестве необязательного параметра функциям можно передать последовательность бай
тов, на основе которой следует вычислить хеш:
>>> import hashlib
>>> hl = hashlib.sha512(b"password")
Указать хешируемую последовательность байтов также можно с помощью метода update().
В этом случае заданная последовательность присоединяется к уже имеющейся. Пример:
»> h2 = hashlib.sha512(b"pass")
>>> h2.update(b"word")
Получить хеш в виде последовательности байтов типа ь�еs и строки позволяют методы
соответственно digest() и hexdigest():
>>> dl = hl.digest()
>>> dl
b'\xЫ\t\xf3\xЬb\xbc$N\xb8$A\x91~\xd0ma\x8b\x90\x08\xdd\t\xb3\xbe\�
xfd\xlbл \x079Lpj\x8b\xЬ9\x80\xЫ\xd7xл Yv\xec\x04\x9bF\xdf_\xl3&\xafZ.\�
xa6\xdl\x03\xfd\x07\xc9S\x85\xff\xab\x0c\xac\xЬc\x86'
>>> hl.hexdigest()
'Ы09f3bbbc244eb82441917ed06d618b9008dd09b3befdlb5e07394c706a8bb980Ыd7�
785e5976ec049b46df5fl326af5a2eaбdl03fd07c95385ffab0cacbc86'
>>> dl == h2.digest() # Имитируем сверку хеша пароля, введенного
>>> # пользователем, с хешем сохраненного пароля
True
>>> # Пользователь ввел верный пароль!
Свойство digest_size хранит длину сгенерированного хеша в байтах:
>>> hl.digest_size
64
Поддерживаются еще две функции, вычисляющие более устойчивые к взлому хеши:
♦ Ыake2s(<Значение>[, digest_size=З2J [, salt=b""J) - хеширует заданное значение по
алгоритму BLAКE2s, оптимизированному для 32-разрядных систем. Второй параметр
задает требуемый размер хеша в виде числа от 1 до 32, третий - «соль» в виде последо
вательности типа bytes, которая может иметь в длину не более 8 байтов. Возвращает
хеш в виде последовательности типа bytes. Пример:
130 Часть /. Основы языка Python
>>> h = hashlib.Ыake2s(b"string", digest_size=lб, salt=b"saltsalt")
»> h.digest()
b'\x961\xe0\xfa\xЬ4\xe7Bw\xll\xf7D\xc2\xa4\xcf\x06\xf7'
♦ Ыаkе2Ь(<Значение> [, digest_size=64] [, salt=b""] ) - хеширует задашюе значение по
алгоритму ВLАКЕ2Ь, оптимизированному для 64-разрядных систем. Второй параметр
задает требуемый размер хеша в виде числа от 1 до 64, третий - «солы> в виде последо
вательности типа bytes, которая может иметь в длину не более 16 байтов. Возвращает
хеш в виде последовательности типа bytes. Пример:
>>> h = hashlib.Ыake2b(b"string", digest_size=48, salt=b"saltsaltsalt")
>» h.digest()
b'\xOe\xcf\xЬ9\xc8G;q\xЬaV\xЬdV\xlб\xd4@/J\x97W\x0c\xc4\xc5{\xd4\xЬ6\�
xl2\x0lz\x9f\xdd\xf6\xfl\x03o\x97&v\xfd\xa6\x90\x81\xc4T\xЬ8z\xaf\�
xc3\x9a\xd9'
ПРИМЕЧАНИЕ
Функции Ыаkе2Ь() и Ыake2s() поддерживают большое количество параметров, которые
применяются только в специфических случаях. Полное описание этих функций можно най
ти в документации по Python.
Функция хеширования pbkdf'2_hrnac(), поддерживавшаяся в предыдущих версиях Python,
начиная с Python 3.1 О, объявлена устаревшей и не рекомендуется к использованию.
ГЛАВА 7
Регулярные выражения
Регулярное выражение - это шаблон, применяемый для поиска совпадающих.с ним фраг
ментов в строках. Регулярное выражение состоит как из обычных знаков, так и всевозмож
ных специальных символов: метасимволов, квантификаторов и др.
В Python использовать регулярные выражения позволяет модуль re, который необходимо
предварительно подкточить с помощью инструкции:
import re
7.1. Синтаксис регулярных выражений
Создать откомпилированное и готовое к использованию регулярное выражение позволяет
функция compile() . Формат ее вызова:
re .compile(<Шаблон регулярного выражения> [, <Флаги>] )
Шаблон создаваемого регулярного выражения указывается в виде строки или последова
тельности байтов типа bytes или bytearray. Флаги управляют особенностями обработки
регулярного выражения. Можно указать как один флаг, так и их комбинацию через опера
тор 1. Все поддерживаемые флаги также объявлены в модуле re:
♦ r или IGNORECASE - регистр символов не учитьшается:
>>> import re
>>> р = re.compile(r""[a-яe]+$", re.I I re.U)
>>> print("Haйдeнo" if р.sеаrсh("АБВГДЕЕ") else "Нет")
Найдено
>>> р = re.compile(r""[a-яe]+$", re.U)
>>> print("Haйдeнo" if р.sеаrсh("АБВГДЕЕ") else "Нет")
Нет
♦ м или МULTILINE - метасимвол " обозначает начало каждой подстроки в строке, в кото
рой выполняется поиск (сразу после символа перевода строки \n, который используется
для разбиения строки на подстроки), а символ $ - конец каждой подстроки (непосред
ственно перед символом перевода строки). Без этого флага метасимвол " обозначает
начало самой строки, в которой выполняется поиск, а символ $ - ее конец. Примеры:
>>> р = re.compile(r"".*$", re.M)
»> р.findall("Python \nDj ango \nSQLite")
['Python', 'Django', 'SQLite']
132 Часть /. Основы языка Python
>>>р = re.compile(r"л .*$")
»> р.findall("Python\nDjango\nSQLite")
[]
♦ s или DOТALL - метасимвол «точка» соответствует mобому символу, вкmочая перевод
строки {\n). Без этого флага метасимвол «точка» будет соответствовать mобому симво
лу, искmочая перевод строки. Примеры:
>>> р = re.compile(r"л .*$")
»> p.findall("Python\nDjango\nSQLite")
[]
>>>р = re.compile(r"л.*$", re.S)
»> р.findall("Python\nDjango\nSQLite")
['Python\nDjango\nSQLite']
♦ х или VERВOSE - пробелы, символы перевода строки и· комментарии, поставленные
в шаблоне регулярного выражения, игнорируются. Этот флаг позволяет форматировать
шаблоны регулярных выражений для наилучшей читабельности. Примеры:
>>> р = re.compile(r"""л # Привязка к началу строки
[0-9]+ # Строка должна содержать одну цифру (или более)
$ # Привязка к концу строки
""", re.X I re.S)
>>> print("Haйдeнo" if p.search("l234567890") else "Нет")
Найдено
>>> print("Haйдeнo" if p.search("abcdl23") else "Нет")
Нет
♦ А или ASCII - классы \w, \W, \Ь, \В, \d, \D, \s и \S соответствуют символам в кодировке
ASCII. Без этого флага указанные классы соответствуют Uniсоdе-символам.
ПРИМЕЧАНИЕ
,Флаги u и UNICODE, включающие режим соответствия классов \w, \W, \Ь, \В, \d, \О, \s и \S
Uniсоdе-символам, сохранены в Python лишь для совместимости с ранними версиями этого
языка и никакого влияния на обработку регулярных выражений не оказывают.
�
♦ L или LOCALE - учитываются настройки текущей локали. Флаг принимается во внима
ние, только если шаблон регулярного выражения задан в виде последовательности бай
тов типа bytes или bytearray.
Шаблоны регулярных выражений удобно записывать в виде необрабатываемых строк (со
держащих модификатор r):
р = re.compile(r"л\w+$")
В обычных строках все обратные слеши придется заменять специальными символами \ \:
р = re.compile("л\\w+$")
В шаблоне регулярного выражения символы ., л, $, *, +, ?, {, [, J, \, 1, ( и ) являются специ
ш,ьными и обрабатываются особым образом. Если же эти символы должны трактоваться
как есть, их следует предварить обратными слетами. Некоторые специальные символы те
ряют свое особое значение, если их разместить внутри квадратных скобок, - в этом случае
экранировать их не нужно. Например, как уже бьmо отмечено ранее, метасимвол «точка» по
умолчанию соответствует mобому символу, кроме символа перевода строки. Если необхо-
Глава 7. Регулярные выражения 133
димо найти именно точку, то перед точкой нужно указать символ \ или разместить точку
внутри квадратных скобок: [ . J • Продемонстрируем это на примере проверки правильности
введенной даты (листинг 7.1).
Листинr
import re # Подключаем модуль
d = "29 ,12.2009" # Вместо точки указана запятая
р = re.compile(r"л (0-3] (0-9]. (01] (0-9]. (12] [09] (0-9] (0-9]$")
#Символ "\" не указан перед точкой
if p.search(d):
рriпt("Дата введена правильно")
else:
print("Дaтa введена неправильно")
# Так как точка означает любой символ,
# вьrnедет: Дата введена правильно
р = re.compile(r"л[0-3] (0-9]\. (01] (0-9]\. (12] (09] (0-9] (0-9]$")
#Символ "\" указан перед точкой
if p.search(d):
print("Дaтa введена правильно")
else:
print("Дaтa введена неправильно")
# Так как перед точкой указан символ "\",
# вьrnедет: Дата введена неправильно
р = re.compile(r"л (0-3] (0-9] [.] (01] (0-9] [.] (12] (09] (0-9] [0-9] $")
# Точка внутри квадратнь� скобок
if p.search(d):
print("Дaтa введена правильно")
else:
print("Дaтa введена неправильно")
# Вьrnедет: Дата введена неправильно
input()
Метасимвол - это специальный символ, обозначающий привязку к началу или концу
строки:
♦ л - к началу строки или подстроки. Поведение зависит от флагов м (или МULTILINE)
и s (или DOTALL);
♦ $ - к концу строки или подстроки. Поведение зависит от флагов м (или МULTILINE)
и s (или DOTALL);
♦ \А- к началу строки (не зависит от флагов);
♦ \Z - к концу строки (не зависит от флагов).
Если указан флаг м (или MULTILINE), то при поиске в строке, состоящей из нескольких под
строк, разделенных символом \n, метасимвол л обозначает привязку к началу каждой такой
подстроки (сразу после символа \n), а метасимвол $ - к концу каждой подстроки (непо
средственно перед символом \n):
134 Часть /. Основы языка Python
>>> р = re.compile(r"л.+$") # Точка не соответствует \n
>>> p.findall("strl\nstr2\nstr3") # Ничего не найдено
[]
>>> р = re.compile(r"л.+$", re.S) # Теперь точка соответствует \n
>>> p.findall("strl\nstr2\nstr3") # Строка полностью соответствует
['strl\nstr2\nstr3']
>>> р = re.compile(r"л.+$", re.M) # Многострочный режим
>>> p.findall("strl\nstr2\nstr3") # Получили каждую подстроку
['strl', 'str2', 'strЗ'J
Привязку к началу и концу строки следует использовать, если строка должна полностью
соответствовать регулярному выражению. Например, для проверки, содержит ли строка
число (листинг 7.2).
J Листинr7.2,- Прове� "!'"ч� це.rюrо �в�·
import re
р = re.compile(r"л[0-9)+$", re.S)
if p.search("245"):
print("Чиcлo") # Выведет: Число
else:
print("Не число")
if p.search("Cтpoкa245"):
print("Число")
else:
print("He число") # Выведет: Не число
input()
Если убрать привязку к началу и концу строки, то любая строка, содержащая хотя бы одну
цифру, будет распознана как «Число» (листинг 7.3).
1 nмстмнr 7.3. 0тсу,:с1'1Q!е � к�•.��
• '1
import re
р = re.compile(r"[0-9)+", re.S)
if p.search("Cтpoкa245"):
print("Число") # Выведет: Число
else:
print("He число")
input()
'' (,!,
Можно указать привязку только к началу или только к концу строки (листинг 7.4).
1 Листинr 7.4; ПJЖВR31(8 IС
import re
р = re.compile(r"[0-9)+$", re.S)
if p.search("Cтpoкa245"):
print("Ecть число в конце строки")
else:
print("Нет числа в конце строки")
Глава 7. Регулярные выражения 135
# Выведет: Есть число в конце строки
р = re.compile(r"л [0-9)+", re.S)
if p.search("Cтpoкa245"):
print("Ecть число в начале строки")
else:
print("Нет числа в начале строки")
# Выведет: Нет числа в начале строки
input()
Также поддерживаются два метасимвола, указывающие привязку к началу или концу слова:
♦ \Ь - к началу слова (началом слова считается пробел или тобой символ, не являющий-
ся буквой, цифрой или знаком подчеркивания);
♦ \В -к позиции, не являющейся началом слова.
Рассмотрим несколько примеров:
>>> р = re.compile(r"\bpython\b")
>>> print("Haйдeнo" if p.search("python") else "Нет")
Найдено
>>> print("Haйдeнo" if p.search("pythonware") else "Нет")
Нет
>>> р = re.compile(r"\Bth\B")
>>> print("Haйдeнo" if p.search("python") else "Нет")
Найдено
>>> print("Haйдeнo" if p.search("this") else "Нет")
Нет
В квадратных скобках [J можно перечислить символы, которые могут встречаться на этом
месте в строке, или указать диапазон таких символов через дефис:
♦ (09) - соответствует числу О или 9;
♦ (0-9) - соответствует mобому числу от О до 9;
♦ [абвJ -соответствует буквам «а», «б» и «в»;
♦ [а-гJ -соответствует буквам «а», «б», «в» и «r»;
♦ [а-яёJ - соответствует тобой букве от «а» до «я»;
♦ [АБВJ - соответствует буквам «А», «Б» и «В»;
♦ [А-ЯЁJ - соответствует тобой букве от «А» до «Я»;
♦ [а-яА-ЯеЁJ -соответствует тобой русской букве в mобом регистре;
♦ [О-9а-яА-ЯеЁа-zА-ZJ -mобая цифра и mобая буква независимо от регистра и языка.
ВНИМАНИЕ!
Буква«�» не входит в диапазон [а-я], а буква с&» - в диапазон [А-Я].
Значение в скобках инвертируется, если после первой скобки вставить символ л, что позво
ляет указать символы, которых не должно быть на этом месте в строке:
♦ [л 09J - не цифра О или 9;
♦ [л О-9) - не цифра от О до 9;
♦ [л а-яА-ЯеЁа-zА-Z] -не буква.
136 Часть /. Основы языка Python
Как вы уже знаете, точка теряет свое специальное значение, если ее заюпочить в квадрат
ные скобки. Кроме того, внутри квадратных скобок могут встретиться символы, которые
имеют специальное значение (например, л и -). Символ л теряет свое специальное значщrие,
если он не расположен сразу после открывающей квадратной скобки. Чтобы отменить спе
циальное значение символа -, его необходимо указать после всех символов, перед закры
вающей квадратной скобкой или сразу после открывающей квадратной скобки. Все специ
альные символы можно сделать обычными, если перед ними указать символ \.
Метасимвол I позволяет сделать выбор между альтернативными значениями. Выражение
n I m соответствует одному из символов: n или m, например:
>>> р = re.compile(r"кpacн( (ая) 1 (ое))")
>>> print("Haйдeнo" if р.search("красная") else "Нет")
Найдено
>>> print("Haйдeнo" if р.search("красное") else "Нет")
Найдено
>>> print("Haйдeнo" if р.sеаrсh("красный") else "Нет")
Нет
Класс символов - это специальный символ, обозначающий какой-либо символ из опреде
ленного набора, символ с указанным Unicode-кoдoм или именем:
♦ \d-любая цифра. При указании флага А (АSсп) эквивалентен [О-9];
♦ \w - любая буква, цифра или символ подчеркивания. При указании флага А (АSсп)
эквивалентен [a-zA-Z0-9_];
♦ \s-любой пробельный символ. При указании флага А (ASCII) эквивалентен [\t\n\r\f\v];
♦ \D- любой символ, не являющийся цифрой. При указании флага А (АSсп) эквивалентен
[ Л О-9];
♦ \W - любой символ, не являющийся буквой, цифрой или подчеркиванием. При указании
флага А (ASCII) эквивалентен [л a-zA-Z0-9_:J;
♦ \s-любой символ, не являющийся пробельным. При указании флага А (АSсп) эквива-
лентен [ л\t\n\r\f\v].
ПРИМЕЧАНИЕ
Упомянутые здесь классы трактуются довольно широко. Так, класс \d соответствует не
только десятичным цифрам, но и другим цифрам из кодировки Unicode (например, дробям),
класс \w включает буквы не только латиницы, но и других алфавитов, а класс \s охватыва
ет также неразрывные пробелы. Поэтому, если необходимо явно указать набор требуемых
символов, лучше привести эти символы внутри квадратных скобок, а не использовать
классы.
♦ \u<nnnn> - символ с 16-битным Unicode-кoдoм <nnnn>. Например, \u04За соответствует
русской букве к;
♦ \U<nnnnnnnn>-символ с 32-битным Unicode-кoдoм <nnnnnnnn>;
♦ \N {<name>) (начиная с Python 3.8)- символ с Uniсоdе-именем <name>. Например,
\N {Registered Sign) соответствует знаку зарегистрированной торговой марки®.
Квантификатор - специальный символ, задающий количество экземпляров указанного
символа, которое должно присутствовать в строке:
♦ {n) - строго n экземпляров. Например, шаблон r"л [0-9] (2)$" соответствует двум вхо
ждениям любой цифры;
Глава 7. Регулярные выражения 137
♦ {n,} - n или более вхождений символа в строку. Например, шаблон r"л [0-9] (2, )$"
соответствует двум и более экземплярам любой цифры;
♦ {n,m) - не менее'n и не более m экземШIЯрам. Значения количества указьшаются через
запятую без пробела. Например, шаблон r"л[О-9] (2,4)$" соответствует 2-4 экземШIЯ
рам любой цифры;
♦ * - ноль или больше экземШIЯров. Эквивалентно комбинации {о, );
♦ + - один или больше экземШiяров. Эквивалентно комбинации {1, );
♦ ? - ноль или один экземШIЯр. Эквивалентно комбинации {о, 1).
Все квантификаторы являются «жадными». При поиске соответствия ишется самая длинная
подстрока, соответствующая шаблону, и не учитываются более короткие соответствия. Для
примера получим содержимое всех тегов <Ь> вместе с самими тегами:
>>> s = "<b>Textl</b>Text2<b>Text3</b>"
>>> р ·= re.compile(r"<b>.*</b>", re.S)
»> p.findall(s)
[ '<b>Textl</b>Text2<b>Text3</b>']
Вместо желаемого результата мы получили всю строку. Чтобы ограничить «жадность»,
необходимо после квантификатора указать символ ?, например:
>>> s = "<b>Textl</b>Text2<b>Text3</b>"
>>> р = re.compile(r"<b>.*?</b>", re.S)
»> p.findall(s)
[J<b>Textl</b>', '<Ь>ТехtЗ</Ь>']
Этот код вывел то, что мы искали. Если необходимо получить содержимое без тегов, то
нужный фрагмент внутри шаблона следует разместить внутри круглых скобок:
>>> s = "<b>Textl</b>Text2<b>Text3</b>"
>>> р = re.compile(r"<b>(.*?)</b>", re.S)
»>.p.findall(s)
['Textl', 'ТехtЗ']
Круглые скобки используются для групп внутри регулярных выражений. Фрагменты, соот
ветствующие группам, будут запоминаться и станут доступны в результатах поиска (это
называется захватом фрагмента).
Чтобы избежать захвата фрагмента, после открьшающей круглой скобки в группе следует
разместить символы ? : (вопросительный знак и двоеточие):
>>> s = "test text"
»> р = re.compile(r"([a-z]+((st) 1 (xt)))", re.S)
»> p.findall(s)
[('test'' 'st'' 'st'' '')' ('text'' 'xt'' ''' 'xt')]
»> р = re.compile(r"([a-z]+(?:(?:st)l(?:xt)))", re.S)
»> p.findall(s)
['test', 'text' ]
В первом примере мы получили список с двумя элементами. Каждый элемент списка явля
ется кортежем, содержащим четыре элемента. Все эти элементы соответствуют группам,
заключенным в шаблоне в круглые скобки: первый элемент соответствует первому фраг
менту, второй - второму и т. д. Три последних элемента кортежа являются лишними. Что
бы они не включались в результаты поиска, во втором примере мы добавили символы ? :
138 Часть /. Основы языка Python
после каждой открывающей круглой скобки. В результате список состоит только из фраг
ментов, полностью соответствующих регулярному выражению.
К найденному фрагменту можно обратиться с помощью механизма обратных ссылок. Для
этого в шаблоне регулярного выражения следует указать обратный слеш и порядковый но
мер нужной группы (начиная с 1) (например, \1). Для примера получим текст между одина
ковыми парными тегами:
>>> s = "<b>Textl</b>Text2<I>Text3</I><b>Text4</b>"
>>> р = re.compile(r"<([a-z]+)>(.*?)</\1>", re.S I re.I)
>>> p.findall(s)
[('Ь', 'Textl'), ('I', 'ТехtЗ'), ('Ь', 'Text4')]
Группам можно дать имена, создав тем самым именованные группы. Для этого после откры
вающей круглой скобки в группе следует указать комбинацию символов ?Р<Имя группы>.
Для примера разберем e-mail на составные части:
>>> email = "[email protected]"
>>> р = re.compile(r"""(?P<name>[a-z0-9_.-]+) # Название ящика
@ # Символ "@"
(?P<host>(?: [a-z0-9-]+\.)+[a-z]{2,6}) # Домен
""" , re.I 1 re.VERВOSE)
>>> r = p.search(email)
>>> r.group("name") # Название ящика
'test'
>>> r.group("host") # Домен
'mail.ru'
Чтобы внутри шаблона обратиться к фрагментам из именованных групп, используется сле
дующий синтаксис: (?P=name). Для примера получим текст между одинаковыми парными
тегами:
>>> s = "<b>Textl</b>Text2<I>Text3</I>"
>>> р = re.compile(r"<(?P<tag>[a-z]+)>(.*?)</(?P=tag)>", re.S I re.I)
»> p.findall(s)
[('Ь', 'Textl'), ('I', 'ТехtЗ')]
Кроме того, внутри круглых скобок могут быть расположены следующие конструкции:
♦ (?#<Комментарий>) - комментарий. Текст внутри круглых скобок игнорируется;
♦ (?=...) - положительный просмотр вперед. Выведем все слова, после которых распо
ложена запятая:
>>> ,s = "textl, text2, textЗ text4"
>>> р = re.compile(r"\w+(?=[,])", re.S I re.I)
»> p.findall(s)
['textl', 'text2']
♦ (? ! •••) - отрицательный просмотр вперед. Выведем все слова, после которых нет за
пятой:
>>> s = "textl, text2, textЗ text4"
»> р = re.compile(r"[a-z]+[0-9](?! [,])", re.S I re.I)
>>> p.findall(s)
['textЗ', 'text4']
Глава 7. Регулярные выражения 139
♦ (?<= ...)- положительный просмотр назад. Выведем все слова, перед которыми распо
ложена запятая с пробелом:
>>> s = 11 textl, text2, textЗ text4 11
»> р = re.compile(r 11 (?<=[ ,J [ ])[a-z]+[0-9]11 re.S I re.I)
,
»> p.findall(s)
['text2', 'textЗ']
♦ (?< ! ••• )- отрицательный просмотр назад. Вьmедем все слова, перед которыми распо
ложен пробел, но перед пробелом нет запятой:
>>> s = 11 textl, text2, textЗ text4 11
»> р = re.compile(r 11 (?<! [ ,]) ( [a-z]+[0-9]) 11 re.S I re.I)
,
»> p.findall (s)
[ 'text4']
♦ (?( <Номер> 1 <Имя> )<Шаблон 1> 1 <Шаблон 2> ) - если группа с заданным номером или име
нем найдена, то должно выполняться условие из параметра <Шаблон 1>, в противном
случае- условие из параметра <Шаблон 2>. Выведем все слова, которые распеложены
внутри апострофов. Если перед словом нет апострофа, то в конце слова должна быть
запятая:
>>> s = 1 textl 'text2' 'textЗ text4, text5 11
1
»> р = re.compile(r 11 (')?([a-z]+[0-9]) (?(1)' l , ) 11 re.S I re.I)
,
>>> p.findall(s)
11 'text2') , ('', 'text4')]
[ ( 11' ,
♦ (?a iLmsux) - задает флаги у регулярного выражения. Буквы а, i, L, rn, s, u их имеют
такое же назначение, что и одноименные флаги в функции compile( ).
Перед буквами i, rn, s и х можно указать дефис- в этом случае соответствующий флаг,
заданный ранее при создании регулярного выражения или в предыдущей подобной язы
ковой конструкции, перестанет действовать.
Предположим, что необходимо получить все слова, расположенные после дефиса, причем
перед дефисом и после слов должны следовать пробельные символы:
>>> s = 11 -wordl -word2 -wordЗ -word4 -word5 1 1
»> re.findall(r 11 \s\-([a-z0-9]+)\s11 s, re.S I re.I)
,
[ 'word2', 'word4']
Мы получили только два слова вместо пяти. Первое и последнее слова не попали в резуль
тат, поскольку расположены в начале и в конце строки. Чтобы эти слова попали в результат,
необходимо добавить альтернативный выбор ( \s) - для начала строки и (\s $) - для
л
1 1
конца строки. Чтобв1 найденные выражения внутри круглых скобок не попали в результат,
следует добавить символы ?: после открывающей скобки, например:
»> re.findall(r 1 (?:л l\s)\-([a-z0-9]+ )(?:\s1$) 1
1 1, s, re.S I re.I)
['wordl ', 'wordЗ', 'word5 ']
В этом случае в результат не попали слова word2 и word4. Чтобы понять причину, рассмот
рим поиск по шагам. Первое слово успешно попадает в результат, т. к. перед дефисом рас
положено начало строки и после слова есть пробел. После поиска указатель перемещается,
и строка для дальнейшего поиска примет следующий вид:
1 -wordl
1 <Указатель>-wоrd2 -wordЗ -word4 -word5 1 1
140 Часть /. Основы языка Python
Обратите внимание, что перед фрагментом -word2 больше нет пробела и дефис не располо
жен в начале строки. Поэтому следующим совпадением окажется слово wordЗ, и указатель
снова будет перемещен:
"-wordl -word2 -wordЗ <Указатель>-wоrd4 -wordS "
Опять перед фрагментом -word4 нет пробела, и дефис не расположен в начале строки. По
этому следующим совпадением окажется слово wordS, и поиск будет завершен. Таким обра
зом, слова word2 и word4 не попадают в результат, поскольку пробел до фрагмента уже был
использован в предыдущем поиске. Чтобы этого избежать, следует воспользоваться поло
жительным просмотром вперед (?= ...), например:
»> re.findall(r"(?:"l\s)\-([a-z0-9]+)(?=\s1$)", s, те.S I re.I)
[ 'wordl', 'word2', 'wordЗ', 'word4', 'wordS']
Теперь все слова успешно попали в список совпадений.
7.2. Поиск первого совпадения с шаблоном
Для поиска первого совпадения с шаблоном предназначены следующие методы, поддержи
ваемые объектом регулярного выражения:
♦ match() - ищет фрагмент, соответствующий текушему регулярному выраженmо, в на
чале заданной строки. Формат метода :
match(<Cтpoкa>[, <Начальная позиция>[, <Конечная позиция>]])
Если соответствие найдено, возвращается объект класса мatch, в противном случае -
значение None:
>>> irnport re
>>> р = re.compile(r"[0-9]+")
>>> print("Haйдeнo" if p.match("strl23") else "Нет")
Нет
>>> print("Haйдeнo" if p.match("strl23", 3) else "Нет")
Найдено
>>> print("Haйдeнo" if p.match("l23str") else "Нет")
Найдено
Вместо метода match() можно воспользоваться функцией match( ). Формат функции :
re.match(<Illaблoн>, <Строка>[, <Флаги>])
В параметре <IIJаблон> указывается строка с регулярным выражением или скомпилиро
ванное регулярное выражение. В параметре <Флаги> можно указать флаги, используемые
в функции compile(). Если соответствие найдено, то возвращается объект мatch, в про
тивном случае - значение None:
>>> р = r"[0-9]+"
>>> print("Haйдeнo" if re.match(p, "strl23") else "Нет")
Нет
>>> print("Haйдeнo" if re.match(p, "123str") else "Нет")
Найдено
>>> р = re.compile(r"[0-9]+")
>>> print("Найдено" if re.match(р, "123str") else "Нет")
Найдено
Глава 7. Регулярные выражения 141
♦ search() - ищет фрагмент, соответствующий текущему регулярному выраженmо, во
всей заданной строке. Формат метода:
search(<Cтpoкa>[, <Начальная позиция>[, <Конечная позиция>]])
Если соответствие найдено, возвращается объект мatch, в противном случае - значение
None:
>>> р = re.compile(r"[0-9]+")
>>> print("Haйдeнo" if p.search("str123") else "Нет")
Найдено
>>> print("Haйдeнo" if p.search("123str") else "Нет")
Найдено
>>> print("Haйдeнo" if p.search("123str", 3) else "Нет")
Нет
Вместо метода search() можно воспользоваться функцией search() . Формат функции:
rе.sеаrсh(<Шаблон>, <Строка>[, <Флаги>])
В параметре <Шаблон> указывается строка с регулярным выражением или скомпилиро
ванное регулярное выражение. В параметре <Флаги> можно указать флаги, используемые
в функции compile() . Если соответствие найдено, возвращается объект мatch, в против
ном случае - значение None. Примеры:
>>> р = r"[0-9]+"
>>> print("Haйдeнo" if re.search(p, "str123") else "Нет")
Найдено
>>> р = re.compile(r"[0-9]+")
>>> print-("Haйдeнo" if re.search(p, "str123") else "Нет")
Найдено
♦ fullmatch() - проверяет, соответствует ли заданная строка текущему регулярному вы
раженmо целиком. Формат метода:
fullmatch(<Cтpoкa>[, <Начальная позиция>[, <Конечная позиция>]])
Если соответствие найдено, то возвращается объект мatch, в противном случае_ - значе
ние None:
>>> р = re.compile("[Рр]ython")
>>> print("Haйдeнo" if р.fullmatch("Python") else "Нет")
Найдено
>>> print("Haйдeнo" if р.fullmatch("ру") else "Нет")
Нет
>>> print("Haйдeнo" if р.fullmatch("PythonWare") else "Нет")
Нет
>>> print("Haйдeнo" if р.fullmatch("PythonWare", о, 6) else "Нет")
Найдено
Вместо метода fullmatch() можно воспользоваться функцией fullmatch() . Формат
функции:
re.fullmatch(<Illaблoн>, <Строка>[, <Флаги>])
В параметре <Шаблон> указьmается строка с регулярным выражением или скомпилиро
ванное регулярное выражение. В параметре <Флаги> можно указать флаги, используемые
142 Часть /. Основы языка Python
в функции compile(). Если строка полностью совпадает с шаблоном, возвращается объ
ект Match, в противном случае - значение None. Примеры:
>>> р = "[Pp]ython"
>>> print("Haйдeнo" if re.fullmatch(p, "Python") else "Нет")
Найдено
>>> print("Haйдeнo" if re.fullmatch(p, "ру") else "Нет")
Нет
В качестве примера переделаем программу суммирования произвольного количества целых
чисел, введенных пользователем, из листинга 4.12 таким образом, чтобы при вводе строки
вместо числа программа не завершалась с фатальной ошибкой. Предусмотрим также воз
можность ввода отрицательных целых чисел (листинг 7.5).
import re
рrint("Введите слово 'stop' дпя получения результата")
summa = О
р = re.compile(r"л(-]?(0-9]+$", re.S)
while (х := input("Введите число: ")) != "stop":
if not p.search(x):
print("Необходимо ввести число, а не строку!")
continue # Переходим на следуюцую итерацию цикла
х = int(x) # Преобразуем строку в число
summa += х
print("Cyммa чисел равна:", summa)
input()
Объект класса Match, возвращаемый методами (функциями) match(), search() и fullmatch(),
имеет следующие атрибуты и методы:
♦ re - ссылка на сам шаблон регулярного выражения, поддерживающий следующие
атрибуты:
• groups - количество групп в шаблоне;
• groupindex - словарь с именами групп и их номерами;
• pattern - исходная строка с шаблоном регулярного выражения;
• flags - комбинация флагов, заданных при создании регулярного выражения в
функции compile(), и флагов, указанных в самом регулярном выражении, в конст
рукции (?aiLmsux);
♦ string - значение параметра <Строка> в методах (функциях) match(), search() и
fullmatch();
♦ pos - значение параметра <Начальная позиция> в методах match(), search() и fullmatch();
♦ endpos - значение параметра <Конечная позиция> в методах match(), search() и
fullmatch();
♦ lastindex - номер последней группы или значение None, если поиск завершился не
удачей;
Глава 7. Регулярные выражения 143
♦ lastgroup - имя последней груmп,1 или значение None, если эта группа не имеет имени
или поиск завершился неудачей:
>>> р = re.compile(r"(?P<num>[0-9]+)(?P<str>[a-z]+)")
>>> m = p.search("l23456string 67890text")
>>> m
<re.Match object; span=(0, 12), match='l23456string'>
>>> m.re.groups, m.re.groupindex
(2, mappingproxy({'num': 1, 'str': 2)))
>>> m.re.groups, m.re.groupindex["num"]
(2, 1)
>>> p.groups, p.groupindex
(2, mappingproxy({'num': 1, 'str': 2)))
>>> p.groups, p.groupindex["str"]
(2, 2)
>>> m.string
'123456string 67890text'
>>> m.lastindex, m.lastgroup
(2, 'str')
>>> m.pos, m.endpos
(0, 22)
♦ group([<Номер 1> 1 <Имя 1>[, . . ., <Номер n> 1 <Имя n> J J ) - возвращает фрагменты,
соответствующие группам. Если параметры не заданы или указано значение О, возвра
щается фрагмент, полностью соответствующий шаблону. Если указан номер или имя
груmп,1, возвращается фрагмент, совпадающий с этой группой. Можно указать несколь
ко номеров или имен групп - в этом случае возвращается кортеж, содержащий фраг
менты, что соответствует группам. Если нет группы с указанным номером или именем,
то возбуждается исключение IndexError. Примеры:
>>> р = re.compile(r"(?P<num>[0-9]+)(?P<str>[a-z]+)")
>>> m.= p.search("123456string 67890text")
>>> m.group(), m.group(0) # Полное соответствие шаблону
('123456string', '123456string')
>>> m.group(l), m.group(2) # Обращение по индексу
('123456', 'string')
>>> m.group("num"), m.group("str") # Обращение по имени
('123456', 'string')
>>> m.group(l, 2), m.group("num", "str") # Несколько параметров
(('123456', 'string'), ('123456', 'string'))
♦ groupdict([<Значение по умолчанию>]) - возвращает словарь, содержащий фрагменты
из именованных групп. Можно указать значение по умолчанию, которое будет выво
диться вместо None для групп, не имеющих совпадений. Примеры:
»> р = re.compile(r"(?P<num>[0-9]+) (?P<str>[a-z])?")
>>> m = p.search("123456")
>>> m.groupdict()
{'num': '123456', 'str': None}
>>> m.groupdict("")
{'num': '123456', 'str': "}
144 Часть /. Основы языка Python
♦ groups([<Значение по умолчанию> J ) - возвращает кортеж, содержащий фрагменты из
всех групп. Можно указать значение по умолчанию, которое будет выводиться вместо
None для групп, не имеющих совпадений. Примеры:
>>> р = re.compile(r"(?P<num>[0-9]+)(?P<str>[a-z])?")
>>> m = p.search("l23456")
>>> m.groups()
('123456', None)
>>> m.groups("")
('123456', '')
♦ start ([<Номер или имя группы> J ) - возвращает индекс начала фрагмента, соответст
вующего заданной группе. Если параметр не указан, возвращает индекс начала полного
соответствия с шаблоном. Если соответствия нет, возвращается значение -1;
♦ end([<Номер или имя группы> J ) - возвращает индекс кшща фрагмента, соответствую
щего заданной группе. Если параметр не указан, возвращает индекс конца полного соот
ветствия с шаблоном. Если соответствия нет, возвращается значение -1;
♦ span([<Номер или имя группы>]) - возвращает кортеж, содержащий начальный и ко
нечный индексы фрагмента, который соответствует заданной группе. Если параметр не
указан, возвращает индексы начала и конца полного соответствия с шаблоном. Если
соответствия нет, возвращается значение (-1, -1). Примеры:
»> р = re.compile(r"(?P<num>[0-9]+)(?P<str>[a-z]+)")
>>> s = "str123456str"
>>> m = p.search(s)
>>> m.start(), m.eпd(), m.span()
(3, 12, (3, 12))
>>> m.start(1), m.end(l), m.start("num"), m.end("num")
(3, 9, 3, 9)
>>> m.start(2), m.end(2), m.start("str"), m.end("str")
(9, 12, 9, 12)
>>> m.span(l), m.span("num"), m.span(2), m.span("str")
((3, 9), (3, 9), (9, 12), (9, 12))
>>> s[m.start(l) :m.end(l)], s[m.start(2) :m.end(2)]
('123456', 'str')
♦ expand(<IIlaблoн>) - производит замену в строке согласно заданному шаблону. Внутри
последнего можно использовать обратные ссылки: \<Номер группы>, \g<Номер группы>
и \g<Имя группы>. Содержимое не совпавших групп будет заменено на пустые строки.
Для примера поменяем два тега местами:
»> р = re.compile(r"<(?P<tagl>[a-z]+)><(?P<tag2>[a-z]+)>")
>>> m = p.search("<br><hr>")
>>> m.expand(r"<\2><\1>") # \<Номер>
'<hr><br>'
>>> m.expand(r"<\g<2>><\g<l>>") # \g<Номер>
'<hr><br>'
>>> m.expand(r"<\g<tag2>><\g<tagl>>") # \g<Имя>
'<hr><br>'
В качестве примера использования метода search() проверим на соответствие шаблону
введенный пользователем адрес электронной почты (листинг 7.6).
Глава 7. Регулярные выражения 145
import re
email = inрut("Введите e-mail: ")
ре = r"л([a-z0-9_.-]+)@(([a-z0-9-]+\.)+[a-z]{2,6))$"
р = re.compile(pe, re.I I re.S)
m = р.search(email)
if not m:
print("E-mail не соответствует шаблону")
else:
print("E-mail", m.group(0), "соответствует шаблону")
рrint("ящик:", m.group(l), "домен:", m.group(2))
input()
Результат выполнения (введенное пользователем значение выделено полужирным шриф
том):
Введите e-mail: [email protected]
E-mail [email protected] соответствует шаблону
ящик: user домен: mail.ru
7.3. Поиск всех совпадений с шаблоном
Для поиска всех совпадений с шаблоном предназначены следующие методы, поддерживае
мые объектом регулярного выражения:
♦ findall() - ищет в заданной строке все сов.падения с текущим регулярным выражени
ем. Формат метода:
findall(<Cтpoкa>[, <Начальная позиция>[, <Конечная позиция>]])
Если соответствия найдены, возвращается список с фрагментами, в противном случае -
пустой список. Если внутри шаблона есть более одной группы, то каждый элемент спи
ска будет кортежем, а не строкой. Примеры:
>>> import re
>>> р = re.compile(r"[0-9)+")
»> p.findall("2018, 2019, 2020, 2021, 2022")
[ 12018 1 , 1 2019', 12020 1 , '2021', 12022 1]
>>> р = re.compile(r"[a-z]+")
>>> p.findall("2018, 2019, 2020, 2021, 2022")
[)
»> р = re.compile(r"(([0-9]{3))-((0-9){2))-([0-9]{2)))")
»> p.findall("322-77-20, 528-22-98")
[('322-77-20', '322', '77', '20'),
( 1 528-22-98 1 , 1 528 1, 1 22 1, 198 1 )]
Вместо метода findall() можно воспользоваться функцией findall(). Формат функции:
re.findall(<Шaблoн>, <Строка>[, <Флаги>])
В параметре <Шаблон> указывается строка с регулярным выражением или скомпилиро
ванное регулярное выражение. В параметре <Флаги> можно указать флаги, используемые
в функции compile(). Примеры:
146 Часть /. Основы языка Python
>>> re.findall(r"[0-9]+", "1 2 3 4 5 6")
['1', '2', '3', '4', '5', '6']
>>> р = re .compile(r"[0-9]+")
>>> re .findall(p, "1 2 3 4 5 6")
['1', '2', '3', '4', '5', '6 ']
♦ finditer() - аналогичен методу findall(), но возвращает итератор, который на каж-
дой итерации выдает объект класса мatch. Формат метода:
finditer(<Cтpoкa>[, <Начальная позиция>[, <Конечная позиция>]])
Пример:
>>> р = re.compile(r"[0-9]+")
»> for m in p,finditer("2018, 2019, 2020, 2021, 2022"):
print (m,group(0), "start: ", m.start (), "end: ", m.end())
2018 start: О end: 4
2019 start: 6 end: 10
2020 start: 12 end: 16
2021 start: 18 end: 22
2022 start: 24 end: 28
Вместо метода finditer() можно воспользоваться функцией finditer(). Ее формат:
re.finditer(<Шaблoн>, <Строка>[, <Флаги>])
В параметре <Шаблон> указывается строка с реrулярным выражением или скомпилиро
ванное реrулярное выражение. В параметре <Флаги> можно указать флаги, используемые
в функции compile() . Получим содержимое между тегами:
>>> р = re.compile(r"<b>(.+?)</b>", re.I I re.S)
>>> s = "<b>Textl</b>Text2<b>Text3</b>"
>>> for m in re .finditer(p, s):
print(m .group(1))
Textl
Text3
7 .4. Замена в строке
Метод suЬ(), поддерживаемый реrулярным выражением, ищет в указанной строке все сов
падения с текущим реrулярным выражением и заменяет их фрагментом, соответствующим
заданному реrулярному выражению. Содержимое несовпавших групп будет заменено на
пустые строки. Если совпадения не найдены, возвращается исходная строка. Метод имеет
следующий формат:
suЬ(<Регулярное выражение, задак:щее замену>, <Строка>[,
<Максимальное количество замен>])
Внутри реrулярного выражения, задающего замену, можно использовать обратные ссьmки
\<Номер группы>, \g<Номер группы> и \g<Имя группы>. Для примера поменяем два тега мес
тами:
Глава 7. Регулярные выражения 147
>>> import re
>>> р = re.compile(r"<(?P<tagl>[a-z]+)><(?P<tag2>[a-z]+)>")
>>> p.suЬ(r"<\2><\l>", "Теги <br><hr>") # \<Номер>
'Теги <hr><br>'
>>> p.suЬ(r"<\g<2>><\g<l>>", "Теги <br><hr>") # \g<Номер>
'Теги <hr><br>'
>>> p.suЬ(r"<\g<tag2>><\g<tagl>>", "Теги <br><hr>") # \g<Имя>
'Теги <hr><br>'
В первом параметре можно указать ссылку на функцmо. В эту функцmо будет передаваться
объект класса мatch, соответствующий найденному фрагменту. Результат, возвращаемый
этой функцией, послужит заменяющим фрагментом. Для примера найдем все числа в стро
ке и прибавим к ним 10 (листинг 7.7).
1 Листинг 7,'!: Поиск чисел в строке
import re
def repl(m) :
""" Функция дпя замены. m - объект Match """
х = int(m.group(0))
х += 10
return "{0)".format(x)
р = re.compile(r"[0-9]+")
# Заменяем все вхождения
print(p.suЬ(repl, "2019, 2020, 2021, 2022"))
# Заменяем только первые два вхождения
print(р. suЬ(repl, "20.19, 2020, 2021, 2022", 2))
input()
Результат выполнения:
2029, 2030, 2031, 2032
2029, 2030, 2021, 2022
Вместо метода suЬ() можно воспользоваться функцией sub() . Формат функции:
re.suЬ(<illaблoн>, <Регулярное выражение, задающее замену>,
<Строка>[, <Максимальное количество замен>[, flags=0]])
В качестве параметров <шаблон> и <Регулярное выражение, задающее замену> можно указать
строки с регулярными выражениями или скомпилированные реГУ,лярные выражения. В па
раметре flags можно указать флаги, используемые в функции compile() . Для примера
поменяем два тега местами, а также изменим регистр букв (листинг 7.8).
Листинг 7.8. Перестановка тегов с !Щilененмемреrистр� букв
import re
def repl (m) :
"'"' Функция дпя замены. m - объект Match """
tagl = m.group("tagl").upper()
tag2 = m.group("tag2").upper()
return "<{0}><{1}>".format(tag2, tagl)
148 Часть /. Основы языка Python
р = r"<(?P<tagl>[a-z]+)><(?P<tag2>[a-z]+)>"
print(re.suЬ(p, repl, "<br><hr>"))
input()
Результат выполнения:
<HR><BR>
Метод suЬn( J аналогичен методу suЬ( J, но возвращает кортеж из двух элементов: изменен
ной строки и количества произведенных замен. Метод имеет следующий формат:
suЬn(<Регулярное выражение, задакхцее замену>, <Строка>[,
<Максимальное количество замен>])
Заменим все числа в строке на о:
>>> р = re.compile(r"[0-9]+")
>>> p.suЬn("0", "2019, 2020, 2021, 2022")
('О, О, О, О', 4)
Вместо метода suЬn( J можно воспользоваться функцией suЬn( J. Формат функции:
rе.suЬn(<Шаблон>, <Регулярное выражение, задакщее замену>,
<Строка>[, <Максимальное количество замен>[, flags=0]])
В качестве параметров <Шаблон> и <Регулярное выражение, задакщее замену> можно указать
строки с регулярными выражениями или скомпилированные регулярные выражения. В па
раметре flags можно указать флаги, используемые в функции compile(). Примеры:
>>> р = r"201[89]"
>>> re.suЬn(p, "2022", "2019, 2020, 2021, 2018")
('2022, 2020, 2021, 2022', 2)
Для выполнения замен также можно использовать метод expand(<Шаблон>), поддерживае
мый объектом Match. Внутри указанного шаблона можно использовать обратные ссылки:
\<Номер груnnы>, \g<Номер группы> И \g<Имя группы>:
>>> р = re.compile(r"<(?P<tagl>[a-z]+)><(?P<tag2>[a-z]+)>")
>>> m = p.search("<br><hr>")
>>> m.expand(r"<\2><\1>") # \<Номер>
'<hr><br>'
>>> m.expand(r"<\g<2>><\g<l>>") # \g<Номер>
'<hr><br>'
»> m.expand(r"<\g<tag2»<\g<tagl»") # \g<Имя>
'<hr><br>'
7.5. Прочие функции и методы
Метод split(<Строка>[, <Лимит> J J разбивает заданную строку по шаблону текущего регу
лярного выражения и возвращает список подстрок. Если во втором параметре задано число,
то в списке окажется указанное количество подстрок . Если подстрок больше указанного
количества, то список будет содержать еще один элемент - с остатком строки. Примеры:
>>> import re
>>> р = re.compile(r"[\s, .]+")
Глава 7. Регулярные выражения 149
>>> p.split("wordl, word2\nword3\r\nword4.word5")
['wordl', 'word2', 'wordЗ', 'word4', 'word5']
>>> p.split("wordl, word2\nword3\r\nword4.word5", 2)
['wordl', 'word2', 'word3\r\nword4.word5']
Если разделитель в строке не найден, список будет состоять только из одного элемента,
содержащего исходную строку:
>>> р = re.compile(r"[0-9]+")
>>> p.split("word, word\nword")
[ 'word, word\nword']
Вместо метода split() можно воспользоваться функцией split(). Формат функции:
re.split(<Шaблoн>, <Строка>[, <Лимит>[, flags=O]])
В качестве параметра <Шаблон> можно указать строку с регулярным выражением или ском
пилированное регулярное выражение. В параметре flags можно указать флаги, используе
мые в функции compile(). Примеры:
>>> р = re.compile(r"[\s,.]+")
>>> re.split(p, "wordl, word2\nword3")
['wordl', 'word2', 'wordЗ']
>>> re.split(r"[\s,.]+", "wordl, word2\nword3")
['wordl', 'word2', 'wordЗ']
Функция escape (<Строка>) экранирует все специальные символы в заданной строке, после
чего ее можно безопасно использовать в составе регулярного выражения:
>>> print(re.escape(r"[]().*"))
\[\]\(\)\.\*
Функция purge() очищает кеш, в котором хранятся промежуточные данные, используемые
при выполнении регулярных выражений. Ее рекомендуется вызывать после обработки
большого количества регулярных выражений. Результата эта функция не возвращает. При
мер:
>>> re.purge()
ГЛАВА 8
Списки, кортежи, множества
и диапазоны
Список, кортеж, множество и диапазон - это упорядоченные наборы значений, иначе го
воря, последовательности. Значение, входящее в последовательность, называется элемен
том и может быть любого типа: числом, строкой, логической величиной и даже другой по
следовательностью. Количество элементов в последовательности называется размером.
Большинство последовательностей (в частности, список, кортеж и диапазон) являются про
нумерованными, поскольку в них за каждь1м элементом закреплен порядковый номер -
индекс. Зная его, можно извлечь из списка или кортежа соответствующий этому индексу
элемент. Нумерация элементов в пронумерованной последовательности начинается с О.
Часть последовательностей (например, множество) относятся к группе непронумерованных,
т. к. у их элементов нет индексов. Соответственно, обратиться к элементу множества по
индексу невозможно.
8.1. Создание списков
Список - это изменяемая пронумерованная последовательность.
Создать список можно следующими способами:
♦ с помощью функции list( [<Последовательность>] ) . Функция возвращает список, соз
данный на основе указанной последовательности. Если последовательность не указана,
выдается пустой список. Примеры:
>>> list() # Создаем пустой список
[]
>>> list("String") # Преобразуем строку в список
['S 1 't', 1 r 1 'i', 'n', 'g']
, ,
>>> list((l, 2, 3, 4, 5)) # Преобразуем кортеж в список
[1, 2, 3, 4, 5]
♦ приведя элементы списка внутри квадратных скобок через запятую:
>>> arr = [1, "str", 3, "4"]
>>> arr
[1, 'str', 3, '4']
♦ заполнив список поэлементно с помощью метода append() :
>>> arr = [] # Создаем пустой список
>>> arr.append(l) # Добавляем элементl (индекс О)
Глава В. Списки, кортежи, множества и диапазоны 151
>>>arr.append("str") # Добавляем элемент2 (индекс 1)
>>>arr
(1, 'str']
Не забываем, что при присваиваIШи объекта (например, списка) какой-либо переменной
в последmою заносится не сам объект, а ссьшка на него (подробности- в разд. 2.2 и 2.3).
В результате получатся две переменные, указывающие на один и тот же объект. Пример:
>>> х=у= (1, 2] # Якобы создали два списка
>>> х, у
([1, 2], [1, 2])
»>y[l] = 100 # Изменяем второй элемент списка из второй переменной
>>> х, у # Изменилось значение сразу в двух переменных
( (1, 100], (1, 100])
Но что же делать, если необходимо создать копию списка? Первый способ заключается
в применении операции извлечения среза, второй - в использовании функции list(), а
третий - в вызове метода сору() . Примеры:
>>> х=[1, 2, 3, 4, 5] #Создали список
>>>#Создаем копию списка
>>>у= list(x) # или с помощью среза: у= х[:]
>>> # или вызовом метода сору(): у= х.сору()
>>>у
[1, 2, 3, 4, 5]
>>> х is у # Оператор is показывает, что это разные объекты
False
>>>y[l] 100 # Изменяем второй элемент
>>>х, у # Изменился только список в переменной у
( [1, 2, 3, 4, 5], [1, 100, 3, 4, 5])
Однако, если в числе элементов копируемого списка имеются другие списки (вложенные),
будут скопированы не сами эти списки, а ссьшки на них. Как говорят в таких случаях про
граммисты, будет создана поверхностная, копия. Рассмотрим пример:
>>> х= (1, (2, 3, 4, 5]] #Создали вложенный список
>>>у= list(x) # Якобы сделали копию списка
>>> х is у # Разные объекты
False
»>y[l][1]= 100 # Изменяем элемент вложенного списка
>>> х, у # Изменение затронуло переменную х ! ! !
( (1, (2, 100, 4, 5]], [1, (2, 100, 4, 5]])
Чтобы получить полную копию списка вместе с вложенными списками, следует воспользо
ваться функцией deepcopy() из модуля сору:
>>> import сору # Подключаем модуль сору
>>> х= (1, (2, 3, 4, 5]]
>>>у= copy.deepcopy(x) # Делаем полную копию списка
>>>y[l][1]= 100 # Изменяем элемент вложенного списка
>>> х, у # Изменился только список в переменной у
( (1, (2, 3, 4, 5]], (1, (2, 100, 4, 5]])
Функция deepcopy() создает копию каждого объекта, при этом сохраняя внутренmою
структуру списка. Иными словами, если в списке существуют два элемента, ссылающиеся
152 Часть /. Основы языка Python
на один объект, то будет создана копия объекта и элементы будут ссылаться на этот новый
объект, а не на разные объекты. Пример:
>>> import сору
>>> х= [1, 2]
>>> у= [х, х] # Два элемента ссылаются на один список
>>> у
[ [1, 2], [1, 2]]
>>> z= copy.deepcopy(y) # Сделали копию списка
>>> z[0] is х, z[l] is х, z[0] is z[l]
(False, False, True)
»> z[О] [О]= 300 # Изменили один элемент вложенного списка
>>> z # Значение изменилось сразу в двух вложенных списках!
[ [300, 2], [300, 2)]
>>> х # Начальный список не изменился
(1, 2)
8.2. Операции над списками
Чтобы получить элемент списка по его индексу, следует поставить после списка квадратные
скобки и указать индекс в них:
>>> arr= [1, "str", 3.2, "4"]
>>> arr[0], arr[l], arr[2], arr[3]
(1, ' str' , 3.2, ' 4' )
С помощью позиционного присваивания можно присвоить значения элементов списка
каким-либо переменным. Количество элементов справа и слева от оператора = должно сов
падать, иначе будет выведено сообщение об ошибке. Примеры:
>>> х, у, z= [1, 2, 3) # Позиционное присваивание
>>> х, у, z
(1, 2, 3)
>>> х, у= [1, 2, 3) # Количество элементов должно совпадать
Traceback (most recent call last):
File "<pyshell#Bб>", line 1, in <module>
х, у = [1, 2, 3)
ValueError: too many values to unpack (expected 2)
Перед одной из переменных слева от оператора = можно указать звездочку - и тогда в этой
перемепиой будет сохранен список из «лишних» элементов. Если таких элементов нет, спи
сок будет пустым. Примеры:
>>> х, у, *z= [1, 2, 3); х, у, z
(1, 2, [3])
>>> х, у, *z = [1, 2, 3, 4, 5]; х, у, z
(1, 2, [3, 4, 5])
>>> х, у, *z= [1, 2]; х, у, z
(1, 2, [])
>>> *х, у, z= [1, 2); х, у, z
( [], 1, 2)
Глава В. Списки, кортежи, множества и диапазоны 153
>>> х, *у, z = [1, 2, 3, 4, 5]; х, у, z
(1, [2, 3, 4], 5)
>>> *z, = [1, 2, 3, 4, 5]; z
(1, 2, 3, 4, 5]
В качестве индекса можно указать отрицательное
· · · значение. Такой индекс будет отсчиты-
ваться от конца списка. Пример:
>>> arr = [1, 2, 3, 4, 5]
>>> arr[-1], arr[-3]
(5, 3)
Так как списки относятся к изменяемым типам дairnыx, мы можем изменить элемент по его
индексу:
>>> arr = (1, 2, 3, 4, 5]
>>> arr[0] = 600 / # Изменение элемента по индексу
>>> arr
[600, 2, 3, 4, 5]
Если элемент с указанным индексом отсутствует в списке, возбуждается исключение
IndexError:
>>> arr = [1, 2, 3, 4, 5]
>>> arr[5] # Обращение к несуществующему элементу
Traceback (most recent call last):
File "<pyshell#99>", line 1, in <module>
arr[5] # Обращение к несуществук;щему элементу
IndexError: list index out of range
Получить размер списка (количество элементов в нем) позволяет функция len():
>>> arr = [1, 2, 3, 4, 5]
>>> len(arr) # Получаем количество элементов
5
>>> arr[len(arr)-1] # Получаем последний элемент
5
Срез - это фрагмент списка, который сам является списком и содержит элементы, индексы
которых располагаются между указанными начальным, конечным индексами и отстоят друг
от друга на заданm.1й шаг. Формат операции извлечения среза:
[<Начало>:<Конец>:<lliаг>]
Все параметры не являются обязательными. Если параметр <Начало> не указан, использует
ся значение О. Если параметр <Конец> не указан, возвращается фрагмент до конца списка.
Элемент с индексом, указанным в параметре <Конец>, не входит в возвращаемый срез. Если
параметр <Шаг> не указан, используется значение 1. В качестве значения параметров можно
указать отрицательные значения.
Рассмотрим несколько примеров:
♦ получение поверхностной копии списка:
>>> arr = [1, 2, 3, 4, 5]
>>> m = arr[:]; m # Создаем поверхностную копию и выводим значения
[1, 2, 3, 4, 5]
154 Часть /. Основы языка Python
>>> m is arr # Оператор is показывает, что это разные объекты
False
♦ вывод элементов списка в обратном порядке:
>>> arr = [1, 2, 3, 4, 5)
>>> arr[::-1] # шаг -1
[5, 4, 3, 2, 1)
♦ вывод списка без первого и последнего элементов:
>>> arr[l:] # Без первого элемента
[2, 3, 4, 5)
>>> arr[:-1] # Без последнего элемента
[1, 2, 3, 4)
♦ извлечение среза, содержащего первые два элемента списка:
>>> arr[0:2] # Символ с индексом 2 не входит в диапазон
[1, 2)
♦ получение среза, содержащего последний элемент списка:
>>> arr[-1:) # Последний элемент списка
[5]
♦ получение среза с элементами от второго до четвертого включительно:
>>> arr[l:4] # Возвращаюrся элементы с индексами 1, 2 и 3
[2, 3, 4)
С помощью среза можно изменить фрагмент списка. Если срезу присвоить пустой список,
то элементы, попавшие в срез, будут удалены. Примеры:
>>> arr = [1, 2, 3, 4, 5)
>>> arr[l:3] = [6, 7) # Изменяем значения элементов с индексами 1 и 2
>>> arr
[1, 6, 7, 4, 5)
>>> arr[l:3] = [] # Удаляем элементы с индексами 1 и 2
>>> arr
[1, 4, 5)
Объединить два списка _в один список позволяет оператор +. Результатом объединения
будет новый список. Пример:
>>> arrl [1, 2, 3, 4, 5)
>>> arr2 [6, 7, 8, 9)
>>> arr3 arrl + arr2
>>> arr3
[1, 2, 3, 4, 5, 6, 7, 8, 9)
Вместо оператора + можно использовать оператор +=. Следует учитывать, что в этом случае
элементы добавляются в текуший список. Пример:
>>> arr = [1, 2, 3, 4, 5)
>>> arr += [6, 7, 8, 9)
>>> arr
[1, 2, 3, 4, 5, 6, 7, 8, 9)
Еще списки поддерживают операции повторения (оператор * ), проверки на вхождение
(оператор in) и на невхождение (оператор not in):
Глава В. Списки, кортежи, множества и диапазоны 155
>>> (1, 2, 3] * 3 # Повторение
(1, 2, 3, 1, 2, 3, 1, 2, 3]
>>> 2 in (1, 2, 3, 4, 5], 6 in (1, 2, 3, 4, 5] # Проверка на вхождение
(True, False)
>>> 2 not in (1, 2, 3, 4], 6 not in (1, 2, 3, 4] # Проверка на невхождение
(False, True)
8.3. Многомернь1е списки
Многомерным называется список, содержащий в числе своих элементов вложенные списки
(или иные последовательности). Создать многомерный список можно, например, так:
>>> arr = [ [1, 2, 3], [4, 5, 6], [7, 8, 9] ]
Как вы уже знаете, выражение внутри скобок может располагаться на нескольких строках.
Следовательно, предыдущий пример можно записать иначе:
>>> arr = [
(1, 2, 3],
(4, 5, 6],
(7, 8, 9]
Чтобы получить значение элемента из вложенного списка, следует указать два индекса:
»> arr [1] [1]
5
Вложенные списки также могут содержать вложенные списки. В этом случае для доступа
к элементам указывается несколько индексов подряд, например:
>>> arr = [ [1, ["а", "Ь"], 3], [4, 5, 6], [7, 8, 9] ]
>>> arr[0] [1][О]
'а'
>>>arr = [ (1, { "а": 10, "Ь": ["s", 5] } ] ]
>» arr[0J [1]["Ь"][О]
's'
8.4. Перебор списков
Последовательно перебрать все элементь1 списка можно с помощью цикла перебора после
довательности (см.разд. 4. 4):
>>> arr (1, 2, 3, 4, 5]
>>> for i in arr: print(i, end=" ")
1 2 3 4 5
Значение очередного элемента списка заносится в переменную, указанную в цикле. Его
можно изменить в теле цикла, но если оно относится к неизменяемому типу данных (на
пример, числовому или строковому), это не отразится на исходном списке. Пример:
>>> arr [1, 2, 3, 4] # Элементы имеют неизменяемый тип (число)
>>> for i in arr: i += 10
156 Часть /. Основы языка Python
>>> arr # Список не изменился
[1, 2, 3, 4]
>>> arr [ [1, 2], [3, 4] ] # Элементы имеют изменяемый тип (список)
>>> for i iп arr: i[O] += 10
>>> arr # Список изменился
[ [11, 2], [13, 4] J
Однако изменить список в цикле все же можно, если для генерирования индексов его эле
ментов воспользоваться функцией raпge(), возвращающей диапазон. Функция имеет сле
дующий формат:
range([<Начало>, ] <Конец> [, <Шаг>])
Первый параметр задает начальное значение диапазона. Если он не указан, используется
значение О. Во втором параметре указывается конечное значение. Следует заметить, что это
значение не входит в возвращаемый диапазон. Если параметр <Шаг> не указан, используется
значение 1. Для примера умножим каждый элемент списк� на 2:
arr = [1, 2, 3, 4]
for i in range(len(arr)):
arr[i] *= 2
print(arr) # Результат вьmолнения: [2, 4, 6, 8]
Также можно воспользоваться функцией enumerate (<Список>[, start=OJ), которая на каж
дой итерации цикла for возвращает кортеж из индекса и значения очередного элемента
указанного списка. Параметр start задает индекс элемента, с которого начнется перебор
списка. Умножим каждый элемент списка на 2:
arr = [1, 2, 3, 4]
for i, elem in enumerate(arr):
arr[i] *= 2
print(arr) # Результат выполнения: [2, 4, 6, 8]
Перебрать список можно и с помощью цикла с условием, но нужно помнить, что он выпол
няется медленнее цикла перебора последовательности. Для примера умножим каждый эле
мент списка на 2:
arr = [1, 2, 3, 4]
i, с = О, len(arr)
while i < с:
arr[i] *= 2
i += 1
print(arr) # Результат выполнения: [2, 4, 6, 8]
8.5. Генераторы списков
и выражения-генераторы
Генератор списка заполняеr создаваемый список элементами, полученными в результате
каких-либо вычислений, которые выполняются над элементами другой последовательности.
Формат записи генератора списка:
[ <Выражение> for <Переменная> in <Исходная последовательность>]
Глава 8. Списки, кортежи, множества и диапазоны 157
Генератор списка перебирает заданную исходную последовательность, на каждой итерации
занося значение ее очередного элемента в указанную переменную, и выполняет заданное
выражение, проводящее необходимые вычисления над значением этого элемента (оно дос
тупно из указанной переменной). Результаты вычислений, проведенных над всеми элемен
тами исходной последовательности, сводятся во вновь созданный список, который и выда
ется в качестве результата.
Генератор цикла можно рассматривать как более компактную и производительную разно
видность цикла перебора последовательности.
Для примера вернемся в разд. 8. 4 и найдем код, изменяющий элементы списка:
arr = [1, 2, 3, 4]
for i in range(len(arr)):
arr[i] *= 2
print(arr) # Результат выполнения: [2, 4, 6, В]
Использовав генератор списка, можно заметно сократить объем этого кода (и ускорить его
выполнение):
arr = [1, 2, 3, 4]
arr = [ i * 2 for i in arr ]
print(arr) # Результат вьmолнения: [2, 4, 6, В]
Генераторы списков могут быть вложены друг в друга и (или) содержать оператор ветвле
ния. Для примера получим четные элементы списка и умножим их на 1 О:
arr = [1, 2, 3, 4]
arr = [ i * 10 for i in arr if i % 2 == О ]
print(arr) # Результат вьmолнения: [20, 40]
Этот код эквивалентен коду:
arr = []
for i in [1, 2, 3, 4]:
if i % 2 == О: # Если число четное
arr.append(i * 10) # Добавляем элемент
print(arr) # Результат вьmолнения: [20, 40]
Теперь получим четные элементы вложенного списка и умножим их на 10:
arr = [[ 1, 2 ] , [3, 4 ] , [5, 6] ]
arr = [ j * 10 for i in arr for j in i if j % 2 == О
print(arr) # Результат вьmолнения: [20, 40, 60]
Этот код эквивалентен коду:
arr = []
for i in [[1, 2], [3, 4], [5, 6]]:
for j in i:
if j % 2 == О: # Если число четное
arr.append(j * 10) # Добавляем элемент
print(arr) # Результат выполнения: [20, 40, 60]
Выражение-генератор аналогично генератору списка, только выдает не список, а итера
тор - особый объект, обладающий функциональностью последовательности. В частности,
итератор можно перебрать, воспользовавшись циклом перебора последовательности. Фор
мат записи выражения-генератора:
( <Выражение>for <Переменная>in <Исходная последовательность>)
158 Часть /. Основы языка Python
Для примера вычислим посредством выражения-генератора квадратные корни чисел от 1
до 5 и выведем их на экран в цикле перебора:
>>> import rnath
>>> expgen = ( rnath.sqrt(n) for n in range(l, 6) )
>>> for р in expgen: print(p)
1.0
1.4142135623730951
1.7320508075688772
2.0
2.23606797749979
8.6. Функции тар(), zip(), filter() и reduce()
Функция rnap() применяет заданную функцию к каждому элементу указанной последова
тельности и сводит возвращенные ей результаты в новую последовательность, которую и
возвращает в качестве результата. Она имеет такой формат:
mар(<Функция>, <Последовательность 1>[, . . ., <Последовательность N>])
Задаваемая функция должна принимать единственный параметр - очередной элемент ука
занной последовательности. Еще она должна · возвращать результат (обычно получаемый
в результате каких-либо вычислений с применением полученного элемента).
Функция map() в качестве результата возвращает итератор (объект с функциональностью
последовательности, обычно ограниченной). Чтобы получить список, возвращенный итера
тор необходимо передать в функцию list().
Для примера прибавим к каждому элементу списка число 10 (листинг 8.1).
def func(elem):
""" Увеличение значения каждого элемента списка
return elem + 10 # Возвращаем новое значение
arr = [1, 2, 3, 4, 5)
print( list( map(func, arr) ) )
# Результат вьmолнения: [11, 12, 13, 14, 15)
Функции map() можно передать несколько последовательностей. В этом случае. в заданной
функции будут передаваться сразу несколько элементов, расположенных в последователь
ностях на одинаковом смещении. Просуммируем элементы трех списков (листинг 8.2).
def func(el, е2, е3):
""" Суммирование элементов трех разных списков """
return el + е2 + е3 # Возвращаем новое значение
arrl [1, 2, 3, 4, 5)
arr2 [10, 20, 30, 40, 50)
Глава В. Списки, кортежи, множества и диапазоны 159
arr3 = [100, 200, 300, 400, 500]
print( list( map(func, arrl, arr2, arr3) ) )
# Результат вьmолнения: [111, 222, 333, 444, 555]
Если размеры заданных последовательностей различаются, за основу выбирается последо
вательность с минимальным количеством элементов (листинг 8.3).
def func(el, е2, е3):
""" Суммирование элементов т рех разных списков """
return el + е2 + е3
arrl [1, 2, 3, 4, 5]
arr2 [10, 20]
arr3 [100, 200, 300, 400, 500]
print( list( map(func, arrl, arr2, arr3) ) )
# Результат вьmолнения: [111 , 222]
Функция zip() возвращает итератор, при переборе последовательно выдающий кортежи,
содержащие элементы указанных последовательностей, расположенные на одинаковом
смещении. Формат функции:
ziр(<Последовательность 1>[, . . . , <Последовательность N>] [, strict=False])
Пример:
>>> zip([l, 2, 3], [4, 5, 6], [7, 8, 9))
<zip object at 0x00FCAC88>
»> list(zip([l, 2, 3], [4, 5, 6], [7, 8, 9]))
[ (1, 4, 7), (2, 5, 8), (3, 6, 9)]
Если размеры заданных последовательностей различаются и параметру strict (поддержи
вается, начиная с Python 3.10) дано значение False, в результат попадут только элементы,
которые существуют во всех последовательностях на одинаковом смещении:
»> list(zip([l, 2, 3], [4, 6], [7, 8, 9, 10]))
[ (1, 4, 7), (2, 6, 8)]
Если же параметру strict дано значение True, при передаче функции zip() последовательно
стей разного размера будет сгенерировано исключение valueError:
>>> list(zip([l, 2, 3], [4, 6], [7, 8, 9, 10], strict=True))
Traceback (most recent call last):
File "<pyshell#8>", line 1, in <module>
list(zip([l, 2, 3], [4, 6], [7, 8, 9, 10], st'rict=Тrue))
ValueError: zip() argument 2 is shorter than argument 1
Переделаем программу суммирования элементов трех списков из листинга 8.3, использовав
функцшо zip () (листинг 8.4).
arrl [1, 2, 3, 4, 5]
arr2 [10, 20, 30, 40, 50]
160 Часть /. Основы языка Python
arr3 = (100, 200, 300, 400, 500]
arr = [х +у+ z for (х, у, z) in zip(arrl, arr2, arr3)]
print(arr)
# Результат вьmолнения: [111, 222, 333, 444, 555]
Функция filter() выполняет проверку элементов последовательности на соответствие за
данным критериям. Формат функции:
filtеr(<Функция>, <Последовательность>)
Указанная функция должна в качестве параметра принимать очередной элемент заданной
последовательности и возвращать True или False. В результат будут добавлены только те
элементы, для которых функция вернет тrue. Если вместо функции указать значение None,
очередной элемент будет проверяться на соответствие значеншо тrue.
Функция filter() возвращает итератор. Чтобы получить.список, этот итератор необходимо
передать в функцmо list(). Примеры:
>>> filter(None, [1, О, None, [], 2])
<filter object at 0x00FD58B0>
>>> list (filter(None, [1, О, None, [], 2]))
[1, 2]
Аналогичный код с использованием генераторов списков выглядит так:
>>> [ i for i in [1, О, None, [], 2] if i ]
[1, 2]
Для примера удалим все отрицательные значения из списка (листинг 8.5).
def func(elem):
return elem >= О
arr = (-1, 2, -3, 4, О, -20, 10]
arr = list(filter(func, arr))
print(arr) # Результат: (2, 4, О, 10]
# Использование генераторов списков
arr = (-1, 2, -3, 4, О, -20, 10]
arr = [ i for i in arr if func(i) ]
print(arr) # Результат: (2, 4, О, 10]
Функция reduce () из модуля functools применяет указанную функцmо к парам элементов
заданной последовательности и накапливает результат. Функция имеет следующий формат:
rеduсе(<Функция>, <Последовательность>[, <Начальное значение>])
В заданную функцmо передаются два параметра: результат предыдущих вычислений и зна
чение очередного элемента указанной последовательности. При обработке первого элемен
та последовательности функции передаются:
♦ если начальное значение задано - начальное значение и первый элемент последова
тельности;
♦ если начальное значение не задано - первый и второй элементы последовательности;
Глава 8. Списки, кортежи, множества и диапазоны 161
Получим сумму всех элементов списка (листинг 8.6).
from functools import reduce
def func(x, у):
print("({0), {l})".format(x, у), end=" ")
return х + у
arr = [l, 2, 3, 4, 5]
summa = reduce(func, arr)
# Последовательность: (1, 2) (3, 3) (6, 4) (10, 5)
print(summa) # Результат вьшолнения: 15
summa = reduce(func, arr, 10)
# Последовательность: (l·o, 1) (11, 2) (13, 3) (16, 4) (20, 5)
print(summa) # Результат вьшолнения: 25
summa = reduce(func, [], 10)
print(summa) # Результат вьпюлнения: 10 ·
8. 7. Добавление и удаление элементов списка
Для добавления и удаления элементов списка используются следующие методы:
♦ арреnd(<Значение>) - добавляет значение в качестве элемента в конец текущего спи
ска. Результата не возвращает. Примеры:
>>> arr = [1, 2, 3]
>>> arr.append(4); arr # Добавляем число
[1, 2, 3, 4]
>>> arr.append( [5, 6]); arr # Добавляем список
[1, 2, 3, 4, [5, 6]]
>>> arr.append((7, 8)); arr # Добавляем кортеж
(1, 2, 3, 4, (5, 6]' (7, 8)]
♦ ехtеnd(<Последовательность>) - доба13ляет элементы заданной последовательности
в конец текущего списка. Результата не возвращает. Примеры:
>>> arr = [1, 2, 3]
>>> arr.extend( (4, 5, 6]) # Добавляем список
>>> arr.extend((7, 8, 9)) # Добавляем кортеж
>>> arr.extend("abc") # Добавляем буквы из строки
>>> arr
[1, 2, 3, 4, 5, 6, 7, 8, 9, 'а', 'Ь', 'с']
Добавить несколько элементов можно посредством конкатенации или оператора +=:
>>> arr = (1, 2, 3]
>>> arr + (4, 5, 6] # Возвращает новый список
[1, 2, 3, 4, 5, 6]
>>> arr += [4, 5, 6] # Изменяет текущий список
>>> arr
[1, 2, 3, 4, 5, 6]
162 Часть /. Основы языка Python
Кроме того, можно воспользоваться операцией присваивания значения срезу:
>>> arr = [1, 2, 3]
>>> arr[len(arr):] = [4, 5, 6] # Изменяет текущий список
>>> arr
[1, 2, 3, 4, 5, 6]
♦ insert(<Ин д ек с>, <Значение>) - добавляет заданное значение в текущий список по
указанному индексу. Остальные элементы смещаются. Результата не возвращает. При
меры:
>>> arr = [1, 2, 3]
>>> arr.insert(0, О); arr # Вставляем О в начало списка
[О, 1, 2, 3]
>>> arr.insert(-1, 20); arr # Можно указать отрицательные числа
[О, 1, 2, 20, 3]
>>> arr.insert(2, 100); arr # Вставляем 100 в позицию 2
[О, 1, 100, 2, 20, 3]
>>> arr. insert( 10, [4, 5]); arr # Добавляем список
[О,· 1, 100, 2, 20, 3, [4, 5]]
Метод insert() позволяет добавить только один элемент. Чтобы добавить несколько
элементов, можно воспользоваться операцией присваивания значения срезу. Добавим
несколько элементов в начало списка:
>>> arr = [1, 2, 3]
>>> arr[:0J = [-2, -1, О]
>>> arr
[-2, -1, О, 1, 2, 3]
♦ рор( [<Ин д екс>J ) - удаляет из текущего списка элемент, расположенный по указанно
му индексу, и возвращает его. Если индекс не указан, то удаляет и возвращает послед
ний элемент списка. Если элемента с указанным индексом нет или список пустой, воз
буждается исключение IndexError. Примеры:'
>>> arr = [1, 2, 3, 4, 5]
>>> arr.pop() # Удаляем последний элемент списка
5
>>> arr # Список изменился
[1, 2, 3, 4]
>>> arr.pop(0) # Удаляем первый элемент списка
1
>>> arr # Список изменился
[2, 3, 4]
Удалить элемент списка позволяет также оператор del:
>>> arr = [1, 2, 3, 4, 5]
>>> del arr[4]; arr # Удаляем последний элемент списка
[1, 2, 3, 4]
>>> del arr[:2]; arr # Удаляем первый и второй элементы
[3, 4]
♦ remove (<Значение>) - удаляет из текущего списка первый элемент, содержащий ука
занное значе,ние. Если элемент не найден, возбуждается исключение ValueError. Метод
ничего не возвращает. Примеры:
Глава В. Списки, кортежи, множества и диапазоны 163
>>> arr = [1, 2, 3, 1, 1]
>>> arr.remove(l) # Удаляет только первый элемент
>>> arr
[2, 3, 1, 1]
>>> arr.remove(5) # Такого элемента нет
Traceback (most recent call last):
File "<pyshell#3>", line 1, in <module>
arr.remove(5) # Такого элемента нет
ValueError: list.remove(x): х not in list
♦ clear() - удаляет все элементы текущего списка, очищая его. Результата не возвраща
ет. Пример:
>>> arr = [1, 2, 3, 1, 1]
>>> arr. clear()
>>> arr
[]
Если необходимо удалить все повторяющиеся элементы списка, то можно преобразовать
список во множество, а затем множество обратно преобразовать в список. Обратите внима
ние на то, что список должен содержать только неизменяемые объекты (например, числа,
строки или кортежи). В противном случае возбуждается исключение TypeError. Пример:
>>> arr = [1, 2, 3, 1, 1, 2, 2, 3, 3]
>>> s = set(arr) # Преобразуем список во множество
>>> s
{1, 2, 3)
>>> arr = list(s) # Преобразуем множество в список
>>> arr # Все повторы были удалены
[1, 2, 3]
8.8. Поиск элемента в списке
и получение сведений об элементах списка
Выполнить проверку на вхождение элемента в список позволяет оператор in: если элемент
входит в список, то возвращается значение True, в противном случае - False. Аналогич
ньrй оператор not in выполняет проверку на невхождение элемента в список: если элемент
отсутствует в списке, возвращается тrue, в противном случае - False. Примеры:
>>> 2 in [1, 2, 3, 4, 5], 6 in [1, 2, 3, 4, 5] # Проверка на вхождение
(True, False)
>>> 2 not in [1, 2, 3, 4], 6 not in [1, 2, 3, 4] # Проверка на невхождение
(False, True)
Чтобы узнать индекс элемента с заданньrм значением в текущем списке, следует воспользо
ваться методом index(). Формат метода:
indех(<Значение>[, <Начало>[, <Конец>]])
В параметре <Начало> указывается индекс элемента, с которого начнется поиск. Если он не
задан, поиск начнется с начала списка. В параметре <Конец> можно задать индекс элемента,
на котором закончится поиск. Если этот параметр не указан, поиск будет вестись до конца
списка.
164 Часть /. Основы языка Python
Метод index() возвращает индекс элемента, имеющего указанное значение. Если значение
не входит в список, то возбуждается исключение ValueError. Примеры:
>>> arr = [1, 2, 1, 2, 1]
>>> arr.index(l), arr.index(2)
(О, 1)
>>> arr.index(l, 1), arr .index(l, 3, 5)
(2, 4)
>>> arr. index(3)
Traceback (most recent call last):
File "<pyshell#lб>", line 1, in <module>
arr.index(3)
ValueError: 3 is not in list
Узнать количество элементов списка с указанным значением позволяет метод
count(<Значение>):
>>> arr = [1, 2, 1, 2, 1]
>>> arr.count(l), arr.count(2)
(3, 2)
>>> arr.count(3) # Элемент не входит в список
о
С помощью функций max () и min(), описанных в разд. 5.2, можно узнать максимальное и
минимальное значения из всех, что входят в список, соответственно:
>>> arr = [1, 2, 3, 4, 5]
>>> max(arr), min(arr)
(5, 1)
Функция аnу(<Последовательность>) возвращает значение True, если в заданной последова
тельности существует хотя бы один элемент, который в логическом контексте возвращает
значение True. Если последовательность не содержит элементов, возвращается значение
False. Пример:
>>> any([O, None]), any([O, None, 1]), any([])
(False, True, False)
Функция all(<Последовательность>) возвращает значение True, если все элементы задан
ной последовательности в логическом контексте возвращают тrue, или последовательность
не содержит элементов:
»> all([O, None]), all([O, None, 1]), all([]), all(["str", 10])
(False, False, True, True)
8.9. Переворачивание и перемешивание списка
Метод reverse() изменяет порядок следования элементов текущего списка на противопо
ложный. Результата не возвращает. Пример:
>>> arr = [1, 2, 3, 4, 5]
>>> arr.reverse() # Изменяется текущий список
>>> arr
[5, 4, 3, 2, 1]
Глава 8. Списки, кортежи, множества и диапазоны 165
Если необходимо изменить порядок следования и получить новый список, следует восполь
зоваться функцией reversed (<Последовательность>) . Она возвращает итератор, который
можно преобразовать в список с помощью функции list() или генератора списков. При
меры:
>>> arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
>>> reversed(arr)
<list reverseiterator object at 0x00FD5150>
>>> list(reversed(arr)) # Использование функции list()
[10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
>>> for i in reversed(arr): print(i, end=" ") # Вывод с помощью цикла
10 9 8 7 6 5 4 3 2 1
>>> [i for i iri reversed(arr)] # Использование генератора списков
[10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
Функция shuffle(<Список>) из модуля random перемешивает элементы списка случайным
образом. Результата не возвращает. Примеры:
>>> import random # Подключаем модуль random
>>> arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
>>> random.shuffle(arr) # Перемешиваем список случайным образом
>>> arr
(2, 7, 10, 4, 6, 8, 9, 3, 1, 5]
ПРИМЕЧАНИЕ
Второй параметр функции shuffle() в Python 3.9 объявлен устаревшим и нерекомендо
ванным к применению. Его поддержка будет удалена в Python 3.11.
8.1 О. Выбор элементов списка
случайным образом
Выбрать элементы из списка случайным образом позволяют следующие функции из модуля
random:
♦ choice(<Последовательность>) - возвращает случайный элемент из заданной последо
вательности, которая может быть любого типа (строкой, списком, кортежем и др.):
>>> import random # Подключаем модуль random
>>> random.choice(["s", "t", "r"]) # Список
's'
♦ sample() - возвращает список из указанного количества элементов заданной последо
вательности, выбранных случайным образом. Формат вызова:
sаmрlе(<Последовательность>, <Количество элементов>[,
соunts=<Количество повторений элементов>])
Примеры:
>>> arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
>>> random.sample(arr, 2)
[7, 10]
166 Часть /. Основы языка Python
>>> arr # Сам список не изменяется
(1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
Начиная с Python 3.9, поддерживается именованный параметр counts, в котором можно
указать последовательность, содержащую значения количества повторений элементов из
последовательности, заданной первым параметром. Первый элемент последовательности
из параметра counts укажет количество повторений первого элемента из первой после
довательности, второй элемент - количество повторений второго элемента и т. д. На
пример, следующие два вызова функции sarnple() эквивалентны:
random.sample( (1, 1, 1, 2, 2, 3, 3, 3, 3], 5)
random.sarnple( (1, 2, 3], 5, counts=[3, 2, 4])
Также, начиная с Python 3.9, указывать множества в первом параметре функции
sarnple() не допускается - эта возможность объявлена устаревшей и подлежащей уда
ленmо в будущих версиях·языка;
♦ choices() - возвращает список из указанного количества элементов заданной последо
вательности, выбранных случайным образом на основе заданных весовых коэффициен
тов. Формат вызова:
сhоiсеs(<Последовательность>[, <Весовые коэффициенты>][, k=l])
Количество элементов в результирующем списке указывается в параметре k.
Весовые коэффициенты задаются в виде последовательности чисел. Чем больше весовой
коэффициент, тем выше вероятность, что соответствующий элемент последовательности
из первого параметра попадет в результирующий список. Однако следует учесть, что
элементы с высокими коэффициентами могут быть вкточены в результат по нескольку
раз. Пример:
>>> arr = (1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
>>> weights = (10, 20, 10, 40, 30, 50, 100, 40, 10, 20]
>>> random.choices(arr, weights, k=4)
[8, 7, 5, 7]
Если весовые коэффициенты не указаны, вероятность попадания каждого элемента за
данной последовательности в результирующий список одинакова:
>>> random.choices(arr, k=4)
(7, 5, 6, 3]
8.11. Сортировка списка
Отсортировать текущий список позволяет метод sort() . Он имеет следующий формат:
sort([key=None][, reverse=False])
Метод ничего не возвращает. Отсортируем список по возрастанmо значений:
>>> arr = (2, 7, 10, 4, 6, ·8, 9, 3, 1, 5]
>>> arr. sort() # Изменяет текущий список
>>> arr
[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
Чтобы отсортировать список по убыванmо, следует в параметре reverse указать значение
True:
Глава 8. Списки, кортежи, множества и диапазоны 167
>>> arr = [2, 7, 10, 4, 6, 8, 9, 3, 1, 5]
>>> arr.sort(reverse=True) # Сортировка по убыванию
>>> arr
(10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
В параметре key можно указать функцию, выполняющую какое-либо действие над каждым
элементом списка. В качестве единственного параметра она должна принимать очередной
элемент списка и возвращать результат действий над ним. Этот результат будет участвовать
в процессе сортировки, но значения самих элементов списка не изменятся.
Стандартная сортировка зависит от регистра символов (листинг 8.7).
1 Листинr 8.7·. Стандарn�ая сортировка
arr = ["единицаl", "Единый", "Единица2"]
arr.sort()
for i in arr:
print(i, end=" ")
# Результат вьmолнения: Единица2 Единый единицаl
Выполнив пример из листинга 8.7, мы получили неправильный результат сортировки, ведь
Единый и Единица2 больше единицаl. Чтобы регистр символов не учитывался, в параметре
key мы укажем функцию для изменения регистра символов (листинг 8.8).
1 Листинr. 8.8. Поnьэоватеnы:каR ·сортировка
arr = ["единицаl", "Единый", "Единица2"]
arr.sort(key=str.lower) # Указываем метод lower()
for i in arr:
print(i, end=" ")
# Результат вьmолнения: единицаl Единица2 Единый
Метод sort() сортирует сам текущий список и не возвращает результата. Если необходимо
получить отсортированный список, а текущий оставить без изменений, следует воспользо
ваться функцией sorted() . Функция имеет следующий формат:
sоrtеd(<Последовательность>[, key=None] [, reverse=False])
В первом параметре указывается список, который необходимо отсортировать. Остальные
параметры эквивалентны параметрам метода sort() . Пример:
>>> arr = [2, 7, 10, 4, 6, 8, 9, 3, 1, 5]
>>> sorted(arr) # Возвращает новый список!
[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
>>> sorted(arr, reverse=Тrue) # Возвращает новый список!
[10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
>>> arr = ["единицаl", "Единый", "Единица2"]
>>> sorted(arr, key=str.lower)
['единицаl', 'Единица2', 'Единый']
168 Часть /. Основы языка Python
8.12. Заполнение списка числами
Создать список, содержащий диапазон чисел, можно, вызвав функцию range() и преобра
зовав возвращенный ею диапазон в список вызовом функции list(). Функция range() име
ет следующий формат:
range( [<Начало>, ] <Конец> [, <Шаг>] )
Первый параметр задает начальное значение, а если он не указан, используется значение О.
Во втором параметре указывается конечное значение. Следует заметить, что это значение
не входит в возвращаемый диапазон. Если параметр <Шаг> не указан, используется
значение 1. В качестве примера заполним список числами от О до 1О:
>>> list(range(ll))
[О, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
Создадим список, состоящий из диапазона чисел от 1 до 15:
>>> list(range(l, 16))
[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
Изменим порядок следования чисел на противоположный:
>>> list(range(l5, О, -1))
[15, 14, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1)
Список со случайными числами (или случайными элементами из другого списка) можно·
получить вызовом функции sample() ( см. разд. 8.1 О):
>>> import random
>>> arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
>>> random.sample(arr, 3)
[1, 9, 5]
>>> random.sample(range(300), 5)
[259, 294, 142, 292, 245)
8.13. Преобразование списка в строку
Преобразовать список в строку позволяет метод join(). Элементы добавляются в форми
руемую строку через указанный разделитель. Формат метода:
<Разделитель>.jоin(<Последовательность>)
Пример:
>>> arr = ["wordl", "word2", "word3"]
>>> " - ".join(arr)
'wordl - word2 - word3'
Все элементы списка должны быть строками, иначе генерируется искточение TypeError:
>>> arr = ["wordl", "word2", "wordЗ", 2]
>>> " - ". join(arr)
Traceback (most recent call last):
File "<pyshell#69>", line 1, in <module>
" - ".join(arr)
TypeError: sequence item 3: expected str instance, int found
Глава В. Списки, кортежи, множества и диапазоны 169
Избежать этого искmочения можно с помощью выражения-генератора, внутри которого
текущий элемент списка преобразуется в строку с помощью функции str() :
>>> arr = ["wordl", "word2", "word3", 2]
>>> " - ".join( ( str(i) for i in arr ) )
'wordl - word2 - word3 - 2'
8.14. Кортежи
Кортеж - это неизменяемая пронумерованная последовательность, фактически - неиз
меняемый список.
Создать кортеж можно следующими способами:
♦ с помощью функции tuple( [<Последовательность>] ). Функция возвращает кортеж, со
ставленный из элементов заданной последовательности. Если параметр не указан, выда
ется пустой кортеж. Примеры:
>>> tuple() # Создаем пустой кортеж
()
>>> tuple("String") # Преобразуем строку в кортеж
('S', 't', 'r', 'i', 'n', 'g ')
>>> tuple( [1, 2, 3, 4, 5]) # Преобразуем список в кортеж
(1, 2, 3, 4, 5)
♦ приведя элементы создаваемого кортежа через запятую внутри круглых скобок (или без
скобок):
>>> tl () # Создаем пустой кортеж
>>> t2 (5,) # Создаем кортеж из одного элемента
>>> t3 (1, "str", (3, 4)) # Кортеж из трех элементов
>>> t4 1, "str", (3, 4) # Кортеж из трех элементов
>>> tl, t2, t3, t4
( () , (5,), (1, 'str', (3, 4)), (1, 'str', (3, 4)))
Обратите особое внимание на вторую строку примера. Чтобы создать кортеж из одного
элемента, необходимо в ко�ще указать запятую. Именно запятые формируют кортеж,
а не круглые скобки. Если внутри круглых скобок нет запятых, будет создан объект дру
гого типа:
>>> t = (5); type(t) # Получили число, а не кортеж!
<class 'int'>
>>> t = ("str"); type(t) # Получили строку, а не кортеж!
<class 'str'>
Четвертая строка в исходном примере также доказывает, что не скобки формируют кор
теж, а запятые. Помните, что для создания кортежа необходимо указать запятые.
Как и списки, кортежи поддерживают обращение к элементу по индексу, получение среза,
объединение (оператор +), повторение (оператор *), проверку на вхождение (оператор in)
и невхождение (оператор not in):
>>> t = (1, 2, 3, 4, 5, 6,· 7, 8, 9)
>>> t[O] # Получаем значение первого элемента кортежа
1
170 Часть /. Основы языка Python
>>> t[: :-1] # Изменяем порядок следования элементов
(9, 8, 7, 6, 5, 4, 3, 2, 1)
>>> t[2:5] # Получаем срез
(3, 4, 5)
>>> 8 in t, о in t # Проверка на вхождение
(True, False)
>>> (1, 2, 3) * 3 # Повторение
(1, 2, 3, 1, 2, 3, 1, 2, 3)
>>> (1, 2, 3) + (4, 5, 6) # Конкатенация
(1, 2, 3, 4, 5, 6)
>>> 8 not in t, О not in t # Проверка на вхождение
(False, True)
Изменять элементы кортежа нельзя:
>>> t = (1, 2, 3) # Создаем кортеж
»> t[0] = 50 # Изменить элемент по индексу нельзя!
Traceback (most recent call last):
File "<pyshell#95>", line 1, in <module>
t[0] = 50 # Изменить элемент по индексу нельзя!
TypeError: 'tuple' object does not support item assignment
Кортежи поддерживают уже знакомые нам по спискам функции len(), min(), max(), методы
index() и count():
>>> t = (1, 2, 3) # Создаем кортеж
»> len(t) # Получаем размер
3
>>> t = (1, 2, 1, 2, 1)
>>> t.index(l), t.index(2) # Ищем элементы в кортеже
(О, 1)
Будучи неизменяемыми, кортежи занимают меньше оперативной памяти и обрабатываются
быстрее, чем изменяемые списки. Поэтому по возможности рекомендуется предпочитать
кортежи спискам.
8.15. Множества, изменяемые и неизменяемые
Множество - это изменяемая непронумерованная последовательность, хранящая только
уникальные значения (повторяющиеся значения при попытке добавить их в множество от
брасываются).
Создать множество из элементов указанной последовательности можно с помощью функ
ции set(<Последовательность>). Если параметр не указан, создается пустое множество.
Примеры:
>>> s = set() # Создаем пустое множество
>>> s
set([])
>>> set("string") # Преобразуем строку в множество
set(['g ', • i', 'n' ' ' s' ' ' r ' ' 't 1])
>>> set( (1, 2, 3, 4, 5]) # Преобразуем список в множество
set( [ 1, 2, 3, 4, 5])
Глава 8. Списки, кортежи, множества и диапазоны 171
>>> set((1, 2, 3, 4, 5)) # Преобр азуем кортеж в множество
set([1, 2, 3, 4, 5])
>>> set([1, 2, 3, 1, 2, 3]) # Остаются только уникальные элементы
set([1, 2, 3])
Перебрать элементы множества позволяет цикл перебора последовательности (см.разд. 4. 4):
>>> for i in set([l, 2, 3]): print i
1 2 3
Получигь размер множества позволяет функция len():
»> len(set([l, 2, 3]))
3
Поскольку множество является непронумерованной последовательностью, получигь значе
ние его элемента по индексу, изменить значение элемента по индексу и извлечь срез у мно
жества нельзя - это приведет к генерированию исключения TypeError:
»> s = set([1, 2, 3])
»> s[1]
Traceback (most recent call last):
File "<pyshell#51>", line 1, in <module>
s[l:2]
TypeError: 'set' object is not suЬscriptaЫe
Для работы с множествами предназначены следующие операторы и соответствующие им
методы, поддерживаемые объектом множества:
♦ 1 и union() - объединяют два множества:
>>> s = set([1, 2, 3])
»> s.union(set([4, 5, 6])), s I set([4, 5, 6])
(set([1, 2, 3, 4, 5, 6]), set([1, 2, 3, 4, 5, 6]))
>» set([l, 2, 3]) 1 set([2, 3, 4])
set([1, 2, 3, 4])
♦ а 1 = ь и а. update(Ь) - добавляют элементы множества ь во множество а:
>>> s = set([1, 2, 3])
>>> s. update(set([4, 5, 6)))
>>> s
set([1, 2, 3, 4, 5, 6))
>>> s 1= set([7, 8, 9])
>>> s
set([l, 2, 3, 4, 5, 6, 7, 8, 9))
♦ - и difference() - вычисляют разницу множеств:
»> set([l, 2, 3]) - set([l, 2, 4])
set([3])
>>> s = set([1, 2, 3])
>>> s.difference(set([l, 2, 4]))
set([3])
♦ а -= ь и a.difference_update (Ь) -удаляют из множества а элементы, которые сущест
вуют в обоих исходных множествах:
172 Часть /. Основы языка Python
»> s = set([l, 2, 3])
>>> s.difference_update(set([l, 2, 4]))
>>> s
set([3])
»> s -= set([3, 4, 5])
>>> s
set([])
♦ & и intersection () - возвращают множество с элементами, которые существуют в обо
их исходных множествах:
»> set([l, 2, 3]) & set([l, 2, 4])
set([1, 2])
»> s = set([l, 2, 3])
>>> s.intersection(set([l, 2, 4]))
set ( [1, 2])
♦ а &= ь и a.intersection_update(b) - оставляют во множестве а элементы, которые
существуют в обоих исходных множествах:
» > s = set([ 1, 2, 3])
>>> s.intersection_update(set([l, 2, 4]))
>>> s
set([l, 2])
>>> s &= set([1, 6, 7])
>>> s
set( [1])
♦ л и symmetric_difference() - возвращают множество с элементами, которые сущест
вуют только в одном из исходных множеств:
>» s = set([1, 2, 3])
>>> s л set([l, 2, 4]), s.symmetric_difference(set([l, 2, 4]))
(set([3, 4]), set([3, 4]))
>>> s л set([l, 2, 3)), s.symmetric_difference(set([l, 2, 3]))
(set([ J ), set([]))
>>> s л set([4, 5, 6]), s.symmetric_difference(set([4, 5, 6]))
(set([1, 2, 3, 4, 5, 6]), set([1, 2, 3, 4, 5, 6]))
♦ а л= ь и а.symmetric_difference_update (Ь) - оставляют во множестве а элементы,
присутствующие только в одном из исходных множеств:
» > s = set([1, 2, 3])
>>> s.symmetric_difference_update(set([l, 2, 4)))
>>> s
set([3, 4])
»> s л= set([3, 5, 6])
>>> s
set([4, . 5, 6])
Операторы сравнения множеств:
♦ in - проверка наличия элемента во множестве:
>>> s = set([l, 2, 3, 4, 5])
>>> 1 in s, 12 in s
(True, False)
Глава 8. Списки, кортежи, множества и диапазоны 173
♦ not in - проверка отсутствия элемента во множестве:
>>> s = set( (1, 2, 3, 4, 5))
>>> 1 in s, 12 in s
(False, True)
♦ == - проверка на равенство множеств:
>>> set([1, 2, 3)) set( [ 1, 2, 3] )
True
>>> set([l, 2, 3)) set([3, 2, 1] )
True
>>> set([1, 2, 3)) set([1, 2, 3, 4 ] )
False
♦ а <= ь и а.issuЬset(Ь) - проверяют, входят ли все элементы множества а во множест
во ь:
>>> s = set([l, 2, 3))
>>> s <= set([l, 2)), s <= set([l, 2, 3, 4))
(False, True)
>>> s.issuЬset(set([l, 2))), s.issuЬset(set([l, 2, 3, 4)))
(False, True)
♦ а < ь - проверяет, входят ли все элементы множества а во множество ь, причем мно
жество а не должно быть равно множеству ь:
>>> s = set([l, 2, 3))
>>> s < set( [1, 2, 3)), s < set([1, 2, 3, 4))
(False, True)
♦ а >= Ь и а.issuperset(Ь) - проверяют, входят ли все элементы множества Ь во множе
ство а:
>>> s = set([l, 2, 3))
>>> s >= set([l, 2)), s >= set([l, 2, 3, 4))
(True, False)
>>> s.issuperset(set([l, 2))), s.issuperset(set([l, 2, 3, 4)))
(True, False)
♦ а > ь - проверяет, входят ли все элементы множества ь во множество а, причем мно
жество а не должно быть равно множеству ь:
>>> s = set([l, 2, 3))
>>> s > set([1, 2)), s > set( (1, 2, 3))
(True, False)
♦ а. isdisjoint(Ь) - проверяет, являются ли множества а и ь полностью разными, т. е. не
содержащими ни одного совпадающего элемента:
·.:•
>>> s = set([1, 2, 3))
>>> s. isdisjoint (set([4, 5, 6)))
True
>>> s.isdisjoint(set([l, 3, 5)))
False
174 Часть /. Основы языка Python
Для работы с множествами предназначены следующие методы:
♦ сору() - возвращает коmпо текущего множества:
>>> s = set([l, 2, 3])
>>> с = s; s is с # С помощью оператора = создать копию нельзя!
True
>>> с = s.copy() # Создаем копию множества
>>> с
set([1, 2, 3])
>>> s is с # Теперь это разные объекты
False
♦ add(<Элемент>) - добавляет <Элемент> в текущее множество:
>>> s = set([l, 2, 3])
>>> s.add(4); s
set( [ 1, 2, 3, 4])
♦ remove(<Элемент>) - удаляет <Элемент> из текущего множества. Если элемент не най
ден, то возбуждается искmочение KeyError. Примеры:
>>> s = set( (1, 2, 3])
>>> s.remove(3); s # Элемент существует
set( (1, 2])
>>> s.remove(S) # Элемент НЕ существует
Traceback (most recent call last):
File "<pyshell#78>", line 1, in <module>
s.remove(S) # Элемент НЕ существует
KeyError: 5
♦ discard(<Элемент>) - удаляет <Элемент> из текущего множества, если он там присутст
вует. Если указа�rnый элемент не существует, ничего не делает. Примеры:
>>> s = set( (1, 2, 3])
>>> s.discard(3); s # Элемент существует
set( (1, 2])
>>> s.discard(S); s # Элемент НЕ существует
set( (1, 2])
♦ рор() - удаляет произвольный элемент из текущего множества и возвращает его. Если
множество пустое, возбуждается искmочение KeyError. Примеры:
»> s = set([l, 2])
>>> s.pop(), s
(1, set([2]))
>>> s.pop(), s
(2, set([]))
>>> s.pop() # Если нет элементов, то будет ошибка
Traceback (most recent call last):
File "<pyshell#89>", line 1, in <module>
s.pop() # Если нет элементов, то будет ошибка
KeyError: 'рор from an empty set'
Глава В. Списки, кортежи, множества и диапазоны 175
♦ clear() - удаляет все элементы из текущего множества:
>>> s = set( [ 1, 2, 3])
>>> s.clear(); s
set( [])
Помимо генераторов списков, Python поддерживает аналогичные им генераторы мно
жеств. Формат записи генератора множества:
( <Выражение> for <Переменная> in <Исходная последовательность>}
В результирующее множество попадут только уникальные элементы. Пример:
>>> {х for х in (1, 2, 1, 2, 1, 2, 3]}
{1, 2, 3)
Пример создания множества, содержащего лишь четные числа:
>>> {х for х in (1, 2, 1, 5, 12, 2, 3] if х % 2 = О}
{2, 12)
Неизменяемые множества аналогичны обычным, изменяемым, за тем исюпочением, что их
содержимое невозможно изменить.
Создать неизменяемое множество можно с помощью функции frozenset(). Формат ее вы
зова аналогичен таковому у функции set ( ). Примеры:
>>> f = frozenset()
>>> f
frozenset( [])
>>> frozenset("string") # Преобразуем строку
frozenset( ['g', i 'n', 's'' 'r'' 't 1])
1 1,
>>> frozenset( (1, 2, 3, 4, 4]) # Преобразуем список
frozenset( [ 1, 2, 3, 4])
>>> frozenset((1,
_ 2, 3, 4, 4)) # Преобразуем кортеж
frozenset( [ 1, 2, 3, 4])
Неизменяемые множества поддерживают все операторы, которые не изменяют содержимое
множества, а также следующие методы: сору(), difference(), iпtersection(), issuЬset(),
issuperset (), symmetric_difference ()И uпiоп().
8.16. Диапазоны
Диапазон - это неизменяемая пронумерованная последовательность целых чисел, распо
ложенных между заданными начальным и конечным значениями и отличающихся друг от
друга на значение указанного шага.
Для создания диапазона применяется функция range():
raпge( [<Начало>, ] <Конец> [, <Шаг>] )
Первый параметр задает начальное значение - если он не указан, используется значение О.
Во втором параметре указывается конечное значение. Следует заметить, что это значение
не войдет в создаваемый диапазон. Если параметр <Шаг> не указан, используется значение 1.
Примеры:
176 Часть /. Основы языка Python
>>> r = range(l, 10)
>>> for i in r: print(i, end " ")
1 2 3 4 5 6 7 8 9
>>> r = range(l0, 110, 10)
>>> for i in r_: print(i, end " ")
10 20 30 40 50 60 70 80 90 100
>>> r = range(l0, 1, -1)
>>> for i in r: print(i, end = " ")
10 9 8 7 6 5 4 3 2
Преобразовать диапазон в список, кортеж, обычное или неизменяемое множество можно
с помощью функции list(), tuple(), set() или frozenset() соответственно:
>>> list(range(l, 10)) # Преобразуем в список
[1, 2, 3, 4, 5, 6, 7, 8, 9]
>>> tuple(range(l, 10)) # Преобразуем в кортеж
(1, 2, 3, 4, 5, 6, 7, 8, 9)
>>> set(range(l, 10)) # Преобразуем в множество
{1, 2, 3, 4, 5, 6, 7, 8, 9)
Диапазоны поддерживают доступ к элементу по индексу, получение среза (в результате
возвращается также диапазон), проверку на вхождение и невхождение, функции len(),
min(), max(), методы index() и count():
>>> r = range(l, 10)
»> r[2], r[-1]
(3, 9)
»> r[2:4]
range(3, 5)
>>> 2 in r, 12 in r
(True, False)
>>> 3 not in r, 13 not in r
(False, True)
>>> len(r), min(r), max(r)
(9, 1, 9)
>>> r.index(4), r.count(4)
(3, 1)
Поддерживается ряд операторов, позволяющих сравнить два диапазона:
♦ = - возвращает тrue, если диапазоны равны, и False - в противном случае. Диапазо
ны считаются равными, если они содержат одинаковые последовательности чисел. При
меры:
>>> range(l, 10) range(l, 10, 1)
True
>>> range(l, 10, 2) range(l, 11, 2)
True
>>> range(l, 10, 2) range (1, 12, 2)
False
Глава 8. Списки, кортежи, множества и диапазоны 177
♦ ! = - возвращает True, если диапазоны не равны, и False - в противном случае:
>>> range(1, 10, 2) != range(1, 12, 2)
True
>>> range(l, 10) != range(l, 10, 1)
False
Также диапазоны поддерживают атрибуты start, stop и step, возвращающие соответствен
но начальную, конечную границы диапазона и его шаг:
>>> r = range(l, 10)
>>> r.start, r.stop, r.step
(1, 10, 1)
Важнейшим преимуществом диапазонов перед другими последовательностями является их
компактность - вне зависимости от количества входящих в диапазон элементов, он всегда
занимает один и тот же объем оперативной памяти (поскольку фактически представляет
собой функцию, при каждом вызове выдающую очередное число). Однако в диапазон могут
входить лишь целые числа, последовательно стоящие друг за .другом, - сформировать диа
пазон на основе произвольного набора чисел или значений другого типа (даже веществен
нъrх чисел) невозможно.
Диапазоны чаще всего используются для проверки вхождения значения в какой-либо ин
тервал и для организации циклов.
8.17. Модуль itertoo/s
Модуль itertools содержит функции, позволяющие генерировать различные последова
тельности на основе других последовательностей, производить фильтрацию элементов и др.
Все функции возвращают итераторы. Прежде чем использовать эти функции, необходимо
ПОДКЛЮЧИТЬ модуль с помощью инструкции:
import itertools
8.17 .1. Генерирование
неопределенного количества значений
Для генерирования неопределенного количества значений предназначены следующие
функции:
♦ count( [start=0] [, step=l]) - возвращает бесконечно нарастающую последователь
ность значений. Начальное значение задается параметром start, а шаг - параметром
step. В качестве значений параметров можно указать вещественнъ1е числа. Примеры:
>>> import itertools
>>> for i in itertools.count():
if i > 10: break
print(i, end=" ")
О 1 2 3 4 5 6 7 8 9 10
>>> list(zip(itertools.count(), "абвгд"))
[(О, 'а'), (1, 'б'), (2, 'в'), (3, 'г'), (4, 'д')]
178 Часть /. Основы языка Python
>>> list(zip(itertools.count(start=2, step=2), "абвгд"))
((2, 'а'), (4, 'б'), (6, 'в'), (В, 'г'), (10, 'д')]
>>> for i in itertools.count(start=0.5, step=l.5):
if i > 10: break
print(i, end=" ")
0.5 2.0 3.5 5.0 6.5 в.о 9.5
♦ cycle (<Последовательность>) - на каждой итерации возвращает очередной элемент
заданной последовательности. Когда будет достигнут конец последовательности, пере
бор начнется сначала, и так до бесконечности. Примеры:
>>> n = 1
>>> for i in itertools.cycle("aбв"):
if n > 10: break
print(i, end=" ")
n += 1
а б в а б в а б в а
>>> list(zip(itertools.cycle( [О, 1]), "абвгд"))
((0, 'а'), (1, 'б'), (0, 'в'), (1, 'г'), (О, 'д')]
♦ repeat(<Значение>[, <Количество>]) - возвращает заданное значение указанное коли
чество раз. Если количество не указано, значение возвращается бесконечно. Примеры:
>>> list(itertools.repeat(l, 10))
(1, 1, 1, 1, .1, 1, 1, 1, 1, 1]
>>> list(zip(itertools.repeat(5), "абвгд"))
((5, 'а'), (5, 'б'), (5, 'в'), (5, 'г'), (5, 'д')]
8.17.2. Генерирование комбинаций значений
Получить различные комбинации значений позволяют следующие функции:
♦ comЬinations() - на каждой итерации возвращает кортеж, содержащий комбинацию из
указанного количества гарантированно разных элементов заданной последовательности.
Комбинации элементов в выдаваемых кортежах не повторяются. Формат функции:
соmЬinаtiоns(<Последовательность>, <Количество элементов>)
Примеры:
>>> import itertools
>>> list(itertools.comЬinations('aбвг', 2))
[('а', 'б'), ('а', 'в'), ('а�, 'г'), ('б', 'в'), ('б', 'г'),
('в', 'г')]
>>> ["".join(i) for i in itertools.comЬinations('aбвг', 2)]
['аб' ' 'ав', 'аг' ' 'бв', 'бг' ' 'вг']
>>> list(itertools.comЬinations('вгaб', 2))
[('в', 'г'), ('в', 'а'), ('в',' 'б'), ('г', 'а'), ('г', 'б'),
('а', 'б')]
>>> list(itertools.comЬinations('aбвг', 3))
[('а', 'б', 'в'), ('а', 'б', 'г'), ('а', 'в', 'г'),
( 'б', 'в', 'г')]
Глава 8. Списки, кортежи, множества и диапазоны 179
♦ comЬinations_with_replacement() - на каждой итерации возвращает кортеж, содержа
щий комбинацmо из указанного количества элементов заданной последовательности.
Выдаваемые кортежи могут содержать одинаковые элементы. Комбинации элементов
в выдаваемых кортежах не повторяются. Формат функции:
comЬinations_with_replacement(<Пocлeдoвaтeльнocть>,
<Количество элементов>)
Примеры:
>>> list(itertools.comЬinations_with_replacement('aбвг', 2))
[('а', 'а'), ('а', 'б'), ('а', 'в'), ('а', 'г'), ('б', 'б'),
('б', 'в'), ('б', 'г'), ('в', 'в'), ('в', 'г'), ('г', 'г')]
>>> list(itertools.comЬinations_with_replacement('вгaб', 2))
[('в', 'в'), ('в', 'г'), ('в', 'а'), ('в', 'б'), ('г', 'г'),
('г', 'а'), ('г', 'б'), ('а', 'а'), ('а', 'б'), ('б', 'б')]
♦ permutations() - на каждой итерации возвращает кортеж, содержащий комбинацmо из
указанного количества элементов заданной последовательности. Комбинации элементов
в выдаваемых кортежах будут повторяться. Если количество элементов не указано, то
используется размер последовательности. Формат функции:
реrmutаtiоns(<Последовательность>[, <Количество элементов>])
Примеры:
>>> list(itertools.permutations('aбвг', 2))
[('а', 'б'), ('а', 'в')·, ('а', 'г'), ('б', 'а'), ('б', 'в'),
( , 6 , , , г , ), ( , в , , , а , ), . ( , в , , '·б , ), ( , в , , , г , ), ( , г , , , а , ),
('г', 'б'), ('г', 'в')]
>>> ["" .join(i) for i in itertools.permutations('aбвг')]
['абвг', 'абгв', 'авбг', 'авгб', 'агбв', 'агвб', 'бавг',
'багв', 'бваг', 'бвга', 'бгав', 'бгва', 'вабг', 'вагб',
'вбаг', 'вбга', 'вгаб', 'вгба', 'габв', 'гавб', 'гбав',
'гбва', 'гваб', 'гвба']
♦ pairwise(<Последовательность>) (начиная с Python 3 .1 О) - на каждой итерации возвра
щает кортеж, содержащий два соседних элемента указанной последовательности:
->>> list(itertools.pairwise("abcdef"))
[('а', 'Ь'), ('Ь', 'с'), ·('с·•, 'd'), ('d', 'е'), ('е', 'f')]
♦ product() - на каждой итерации возвращает кортеж, содержащий комбинацmо из эле
ментов одной или нескольких указанных последовательностей. Формат функции:
рrоduсt(<Последовательность 1>[, . . . , <Последовательность N>][, repeat=l])
Количество элементов в выдаваемых итератором кортежах будет равно количеству за
данных последовательностей. Можно указать другое количество элементов в параметре
repeat, однако оно не должно быть меньше количества указанньrх последовательностей.
Примеры:
>>> list(itertools.product('aбвг'))
[('а',), ('б',), ('в',), ('г',)]
>>> list(itertools.product('абвг', repeat=2))
[('а', 'а'), ('а', 'б'), ('а', 'в'), ('а', 'г'), ('б', 'а'),
('б', 'б'), ('б', 'в'), ('б', 'г'), ('в', 'а'), ('в', 'б'),
180 Часть /. Основы языка Python
('в', 'в'), ('в', 'г'), ('г', 'а'), ('г', 'б'), ('г', 'в'),
( 'г', 'г')]
>>> list(itertools .product('aб', 'вг'))
[('а', 'в'), ('а', 'г'), ('б', 'в'), ('б', 'г')]
>>> list(itertools.product('aб', 'вг', repeat=3))
[('а', 'в', 'а', 'в', 'а', 'в'), ('а', 'в', 'а', 'в', 'а', 'г'),
('а', 'в', 'а', 'в', 'б', 'в'), ('а', 'в', 'а', 'в', 'б', 'г'),
('а', 'в', 'а', 'г', 'а', 'в'), ('а', 1 в',· 'а', 'г', 'а', 'г'),
('а', 'в', 'а', 'г', 'б', 'в'), ('а', 'в', 'а', 'г', 'б', 'г'),
... Часть вывода пропущена
('б', 'г', 'б', 'г', 'б 1 , 'в'), ('б', 'г', 'б', 'г', 'б', 'г')]
8.17.3. Фильтрация элементов последовательности
Для. фильтрации элементов последовательности предназначены следующие функции:
♦ filterfalse(<Функция>, <Последова тельность>) - возвращает элементы заданной по
следовательности (по одному на каждой итерации), для которых функция, указанная
в первом параметре, вернет значение False:
>>> irnport itertools
>>> def func(x): return х > 3
>>> list(itertools.filterfalse(func,. [4, 5, 6, О, 7, 2, 3]))
[О, 2, 3]
>>> list (filter(func, [4, 5, 6, О, 7, 2, 3]))
[4, 5, 6, 7]
Если вместо функции указать значение None, то каждый элемент последовательности
будет проверен на соответствие значению False. Если элемент в логическом контексте
возвращает значение тrue, то он не войдет в возвращаемый результат. Примеры:
>>> list(itertools.filterfalse(None, [О, 5, 6, О, 7, О, 3]))
[О, О, О]
>>> list(filter(None, [О, 5, 6, О, 7, О, 3]))
[5, 6, 7, 3]
♦ dropwhile(<Функция>, <Последовательность>) - возвращает элементы заданной после
довательности (по одному на каждой итерации), начиная с элемента, для которого функ
ция, указанная в первом параметре, вернет значение False:
>>> def func(х) : return х > 3
>>> list(itertools.dropwhile(func, [4, 5, 6, о, 7, 2, 3]))
[О, 7, 2, 3]
>>> list(itertools.dropwhile(func, [4, 5, 6, 7, 8]))
[]
>>> list(itertools.dropwhile(func, [l, 2, 4, 5, 6, 7, 8]))
[l, 2, 4, 5, 6, 7, 8]
♦ takewhile(<Функция>, <Последовательность>) - возвращает элементы заданной после
довательности (по одному на каждой итерации), пока не встретится элемент, для которо
го функция, указанная в первом параметре, вернет значение False:
Глава 8. Списки, кортежи, множества и диапазоны 181
>>> def func (х) : return х > 3
>>> list(itertools.takewhile(func, (4, 5, 6, о, 7, 2, 3)))
[4
· , 5, 6)
>>> list(itertools.takewhile(func, (4, 5, 6, 7, 8)))
(4, 5, 6, 7, 8)
>>> list(itertools.takewhile(func, (1, 2, 4, 5, 6, 7, 8)))
[]
♦ compress() - возвращает элемеmы указанной фильтруемой последовательности, у ко
торых соответствующие элементы из последовательности логических значений тракту
ются как тrue, пока не закончится какая-либо из указанных последовательностей. Фор
мат функции:
соmрrеss(<Фильтруемая последовательность>,
<Последовательность логических значений>)
Примеры:
>>> list(itertools.compress('aбвгдe', (1, О, О, О, 1, 1)))
['а', 'д', 'е']
>>> list(itertools.compress('aбвгдe', [True, False, True]))
['а', 'в']
8.17 .4. Прочие функции
Модуль itertools содержит несколько дополнительных функций:
♦ islice() - на каждой итерации возвращает очередной элемент заданной последова
тельности. Поддерживаются форматы:
isliсе(<Последовательность>, <Конечная граница>)
и
isliсе(<Последовательность>, <Начальная граница>, <Конечная граница>[, <Шаг>])
Параметры <Начальная граница> и <Конечная граница> задают начальный и конечный
индексы выдаваемых элементов, параметр <Шаг> - промежуток между индексами выда
ваемых элемеmов. Элемент с указанным конечным индексом в состав выдаваемых не
войдет. Если шаг не указан, будет использовано значение 1. Примеры:
>>> list(itertools.islice("aбвгдeзж", 3))
['а', 'б', 'в']
>>> list(itertools.islice("aбвгдeзж", 3, 6))
['г', 'д', 'е']
>>> list(itertools.islice("aбвгдeзж", 3, 6, 2))
['г', 'е']
♦ starmap(<Функция>, <Последовательность>) - формирует новую последовательность на
основании значений, возвращенных указанной функцией. Исходная последовательность
должна содержать в качестве элементов кортежи - именно на основе их элемеmов ука
занная функция и станет вычислять значения, которые войдут в генерируемую последо
вательность. Примеры суммирования значений:
>>> import itertools
>>> def funcl(x, у): return х + у
182 Часть /. Основы языка Python
»> list(itertools.starrnap(funcl, ((1, 2), (4, 5), (6, 7)]))
(3, 9, 13]
>>> def func2(x, у, z): return х+ у+ z
>>> list(itertools.starrnap(func2, ((1, 2, 3), (4, 5, 6)]))
(6, 15]
♦ zip_longest() - на каждой итерации возвращает кортеж, содержащий элементы задан
ных последовательностей с одинаковыми индексами. Если последовательности имеют
разное количество элементов, вместо отсутствующего элемента вставляется значение из
параметра fillvalue. Формат функции:
ziр_lоngеst(<Последовательность 1>[, . . . , <Последовательность N>] [,
fillvalue=None])
Примеры:
>>> list(itertools.zip_longest([l, 2, 3], [ 4, 5, 6]))
[(1, 4), (2, 5), (3, 6)]
>>> list(itertools.zip_longest([l, 2, 3], [4]))
[(1, 4), (2, None), (3, None)]
>>> list(itertools.zip_longest([l, 2, 3], [4], fillvalue=0))
[ (1, 4), (2, О), (3, О)]
>>> list(zip([l, 2, 3], [4]))
[ (1, 4)]
♦ accumulate() - на каждой итерации возвращает результат, полученный выполнением
определенного действия над текущим элементом заданной последовательности и ре
зультатом, вычисленным на предЬщущей итерации. Формат функции:
ассumulаtе(<Последовательность>[, <Функция>][, initial=None])
Необходимое действие над элементами последовательности выполняется заданной
функцией, а если она не указана, выполняется сложение. Заданная функция должна при
нимать два параметра и возвращать результат. На первой итерации всегда возвращается
первый элемент переданной последовательности. Пример:
>>> # Вьmолняем сложение
>>> list(itertools.accumulate([l, 2, 3, 4, 5, 6]))
(1, 3, 6, 10, 15, 21]
>>> # [1, 1+2, 3+3, 6+4, 10+5, 15+6]
>>> # Вьmолняем умножение
>>> def func(x, у): return х * у
>>> list(itertools.accumulate([l, 2, 3, 4, 5, 6], func))
(1, 2, 6, 24, 120, 720]
>>> # (1, 1*2, 2*3, 6*4, 24*5, 120*6]
Начиная с Python 3.8, поддерживается параметр initial, задающий начальное значение
для выполнения действия. Если он указан, на первой итерации функция accumulate()
выдаст значение этого параметра, на второй - результат выполнения действия со зна
чением этого параметра и первым элементом указанной последовательности, а далее
станет работать как обычно. Пример:
>>> list(itertools.accumulate([l, 2, 3, 4, 5, 6], initial=l00))
(100, 101, 103, 106, 110, 115, 121]
Глава В. Списки, кортежи, множества и диапазоны 183
♦ chain() - на каждой итерации возвращает элементы сначала первой из указанных по
следовательностей, затем второй и т. д. Формат функции:
сhаin(<Последовательность 1>[, . . ., <Последовательность N>])
Примеры:
>>> arrl, arr2, arr3 = [1, 2, 3], [4, 5], [6, 7, 8, 9]
>>> list(itertools.chain(arrl, arr2, arr3))
[1, 2, 3, 4, 5, 6, 7, в, 9]
>>> list(itertools.chain("abc", "defg", "hij"))
['а', 'Ь', 'с', 'd', 'е', 'f', 'g', 'h', 'i', 'j ']
>>> list(itertools.chain("abc", ["defg", "hij"]))
['а', 'Ь', 'с', 'defg', 'hij' ]
♦ chain. from_i teraЫe(<Последовательность>) - аналогична функции chain(), но прини
мает одну последовательность, каждый элемент которой также должен представлять со
бой последовательность:
>>> list(itertools.chain.from_iteraЬle(["abc", "defg", J'hij"]))
['а', 'Ь 1 , 'с', 'd 1 , 'е', 'f', 1 g', 'h', 'i', 'j']
♦ tee(<Последовательность>[, <Количество>]) - возвращает кортеж, содержащий не
сколько одинаковых итераторов для заданной последовательности. Если второй пара
метр не указан, то возвращается кортеж из двух итераторов. Примеры:
>>> arr = [1, 2, 3]
>>> itertools.tee(arr)
(<itertools.tee object at Ox00FD8760>,
<itertools.tee object at Ox00FD8738>)
>>> itertools.tee(arr, 3)
(<itertools.tee object at Ox00FD8710>,
<itertools.tee object at Ox00FD87D8>,
<itertools.tee object at Ox00FD87BO>)
>>> list(itertools.tee(arr)[О])
[1, 2, 3]
>>> list(itertools.tee(arr)[1])
[1, 2, 3]
♦ groupby(<Последовательность>[, <Функция>] ) - на каждой итерации возвращает кор
теж из двух элементов: значения, возвращенного указанной функцией, и итератора,
выдающего элементы указанной последовательности, для которых указанная функция
вернула это значение. Можно сказать, что функция groupby() выполняет группировку
элементов последовательности по программно сгенерированному ключу.
Заданная функция должна в качестве параметра принимать очередной элемент последо
вательности и возвращать сгенерированный на его основе ключ. Задаваемая последова
тельность уже должна быть отсортирована с применением той же функции, что будет
использована для генерирования ключа.
Пример группировки чисел по их знаку (положительные числа попадут в первую груп
пу, отрицательные - во вторую):
>>> def func(x): return "pos" if х > О else "neg"
184 Часть /. Основы языка Python
>>> arr = [2, -4, 5, -20, 7, 1, -4]
>>> arr.sort(key=func)
>>> for i, j in itertools.groupby(arr, func):
print(str(i) + ": " + str(list(j)))
neg: [-4, -20, -4]
pos: [2, 5, 7, 1]
Если функция не указана, в качестве ключа будет использовано значение элемента по
следовательности:
>>> for i, j in itertools.groupby(arr):
print(str(i) + ": " + str(list(j)), end=" ")
-4: [-4] -20: [-20] -4: [-4] 2: [2] 5: [5] 7: [7] 1: [1]
ГЛАВА 9
Словари
Словарь - это изменяемый набор значений (элементов), каждому из которых дана уни
кальная пометка, назьmаемая ключом. В качестве ключа может выступать произвольное
значение любого типа, но практически всегда используются строки. Зная ключ, можно из
влечь из словаря соответствующий ему элемент. Кqличество элементов в словаре называет
ся размером.
Словари, а также другие подобные им типы данных назьmаются отображениями, посколь
ку в них каждый ключ отображается на соответствующий ему элемент.
9.1. Создание словаря
Создать словарь можно следующими способами:
♦ с помощью функции dict(). Форматы функции:
diсt(<Ключ l>=<Значение 1>[, . . . , <Ключ N>=<Значение N>])
diсt(<Список кортежей с двумя элементами: ключом и значением>)
diсt(<Список списков с двумя элементами: ключом и значением>)
diсt(<Словарь>)
Если параметры не указаны, создается пустой словарь. Примеры:
>>> d = dict(); d # Создаем пустой словарь
{}
>>> d = dict( {"а": 1, "Ь": 2}); d # Указан словарь
{'а': 1, 'Ь': 2}
>>> d = dict([("a", 1), ("Ь", 2)]); d # Указан список кортежей
{'а': 1, 'Ь': 2}
>>> d = dict([["a", 1], ["Ь", 2]]); d # Указан список списков
{'а': 1, 'Ь': 2}
>>> d = dict(a=l, Ь=2); d
{'а': 1, 'Ь': 2}
Объединить два списка в список кортежей позволяет функция zip() :
>>> k = ["а", "Ь "] # Список с ключами
>>> V = (1, 2] # Список со значениями
>>> list(zip(k, v)) # Создание списка кортежей
[ ('а', 1), ('Ь', 2)]
186 Часть /. Основы языка Python
>>> d = dict(zip(k, v)); d# Создание словаря
{'а': 1, 'Ь': 2}
♦ указав все элементы словаря внутри фигурных скобок - это наиболее часто используе
мый способ. Между кточом и значением ставится_ двоеточие, а пары «кточ/значение»
записываются через запятую. Примеры:
>>> d = {}; d # Создание пустого словаря
{}
>>> d = "а": 1, "Ь": 2 }; d
{'а': 1, 'Ь': 2}
♦ заполнив словарь поэлементно. В этом случае кточ указывается внутри квадратных
скобок. Примеры:
>>> d = {} # Создаем пустой словарь
>>> d["a"J 1 # Добавляем элементl (ключ "а")
>>> d["b'' J 2 # Добавляем элемент2 (КЛЮЧ "Ь")
>>> d
{'а': 1, 'Ь': 2}
♦ с помощью метода dict. fromkeys(<Последовательность> [, <Значение>]). Метод создает
словарь, кточами которого станут элементы заданной последовательности, а их значе
ниями - значение из второго параметра. Если второй параметр не указан, элементы
созданного словаря получат значение None. Примеры:
>>> d = dict.fromkeys(["a", "Ь", "с"])
>>> d
{'а': None, 'с': None, 'Ь': None}
>>> d = dict.fromkeys(["a", "Ь", "с"], 0.)# Указан список
>>> d
{'а': О, 'с': О, 'Ь': О}
>>> d = dict.fromkeys(("a", "Ь", "с"), О)# Указан кортеж
>>> d
{'а': О, 'с': О, 'Ь': О} /
Создать поверхностную копию словаря позволяет функция dict() :
>>> dl = { "а": 1, "Ь": 2 } # Создаем словарь
>>> d2 = dict(dl) # Создаем поверхностную копию
>>> dl is d2# Оператор показывает, что это разные объекты
False
>>> d2["b"J = 10
>>> dl, d2 # Изменилось только значение в переменной d2
({'а': 1, 'Ь': 2), {'а': 1, 'Ь': 10))
Также можно воспользоваться методом сору() :
>>> dl = { "а": 1, "Ь": 2 } # Создаем словарь
»> d2 = dl. сору() # Создаем поверхностную копию
>>> dl is d2# Оператор показывает, что это разные объекты
False
>>> d2["b"] = 10
>>> dl, d2 # Изменилось только значение в переменной d2
({'а': 1, 'Ь': 2}, {'а': 1, 'Ь': 10})
Глава 9. Словари 187
Создать полную копию словаря позволяет функцияdeepcopy ( ) из модуля сору:
>>>dl ={ "а": 1, "Ь": [20, 30, 40] }
>>>d2=dict (dl) # Создаем поверхно·стную копию
>>>d2["b"] [О]·= "test"
>>>dl, d2 # Изменились значения в двух переменных!!!
({'а': 1, 'Ь': ['test', 30, 40]}, {'а': 1, 'Ь': ['test', 30, 40]})
>>> import сору
>>>d3 = copy.deepcopy(dl) # Создаем полную копию
>>>d3["b"] [1] = 800
>>>dl, d3 # Изменилось значение только в переменнойd3
({'а': 1, 'Ь': ['test', 30, 40]}, {'а': 1, 'Ь': ['test', 800, 40]})
Начиная с Python 3.7, элементы в словаре хранятся строго в том порядке, в котором они
были добавлены в него (в предыдущих версиях языка элементы в словаре могли переупоря
дочиваться интерпретатором).
9.2. Операции над словарями
Обращение к элементам словаря осуществляется с помощью квадратных скобок, в которых
указывается ключ. Как говорилось ранее, ключ может быть произвольным значением любо
го типа: строкой, целым числом, кортежем и др. Однако почти всегда используются строки.
Выведем все элементы словаря:
>>>d={ 1: "int", "а": "str", (1, 2): "tuple"}
>»d[l] , d["a"], d[( 1, 2)]
( 'int', 'str', 'tuple')
Если элемент с указанным ключом отсутствует в словаре, возбуждается исключение
KeyError:
>>>d={ "а": 1, "Ь": 2}
>>>d ["с"] # Обращение к несуществукхцему элементу
Traceback (most recent call last):
File "< pyshell#49>", line 1, in <module>
d["c"] # Обращение к несуществукхцему элементу
KeyError: 'с'
Проверить существование ключа в словаре можно с помощью оператора in. Если ключ
найден, возвращается значение тrue, в противном случае - False. Примеры:
>>>d= { "а": 1, "Ь": 2
>>> "а" ind # Ключ существует
True
>>> "с" ind # Ключ не существует
False
Проверить, отсутствует ли какой-либо ключ в словаре, позволит оператор not in. Если
ключ отсутствует, возвращается True, иначе - False. Примеры:
>>>d ={ "а": 1, "Ь": 2}
>>> "с" not in d # Ключ не существует
True
188 Часть /. Основы языка Python
>>>"а" not in d # Ключ существует
False
Метод get·(<Ключ >[, <Значение по умолчанию>J ) позволяет избежать возбуждения исклю
чения кeyError при отсутствии в словаре указанного ключа. Если заданный ключ в текущем
словаре существует, метод возвращает соответствующее ему значение, если ключ не суще
ствует - None или значение из второго параметра. Пример:
>>>d= { "а": l, "Ь": 2}
>>>d.get("a"), d.get("c"), d.get("c", 800)
(1, None, 800)
Кроме того, можно воспользоваться методом setdefault(<Ключ >[, <Значение по умолча
нию>J ) • Если заданный ключ в текущем словаре существует, метод возвращает соответст
вующее ему значение, в противном случае в словаре создается новый элемент со значением
из второго параметра. Если второй параметр не указан, значением нового элемента будет
None. Примеры:
>>>d= { "а": 1, "Ь": 2}
>>.>d.setdefault ("а"), d.setdefault ("с"), d.setdefault ("d", О)
(1, None, О)
>>>d
{'а': .1, 'с': None' 'Ь' : 2' 'd': О}
Так как словари относятся к изменяемым типам данных, мы можем изменить элемент по
кточу. Если элемент с указанным ключом отсутствует в словаре, он будет создан. Пример:
>>>d = { "а": 1, "Ь": 2}
>>>d["a"] 800 # Изменение элемента по ключу
>>>d["c"] = "string" # Будет добавлен новый элемент
>>>d
{'а': 800, 'с':. 'string', 'Ь': 2)
Получить размер словаря позволяет функция len():
>>>d = { "а": 1, "Ь�: 2}
»>len(d)
2
Удалить элемент из словаря можно с помощью оператора del:
>>>d= { "а": 1, "Ь": 2}
>>>del d["b"]; d # Удаляем элемент с ключом "Ь" и выводим словарь
{'а': 1)
Оператор а I ь (поддерживается, начиная с Python 3.9) возвращает новый словарь, содер
жащий все элементы из словарей а и ь. Если оба словаря содержат элементы с одинаковыми
ключами, значения этих элементов будут взяты из словаря ь. Пример:
>>>dl { "а": 1, "Ь": 2 }
>>>d2= { "Ь": 20, "с": 3
»>dl I d2
{'а': 1., 'Ь': 20, 'с': 3)
Оператор а 1= ь (также поддерживается, начиная с Python 3.9) дополняет словарь а элемен
тами из словаря ь. Если оба словаря содержат элементы с одинаковыми ключами, значения
этих элементов будут взяты из словаря ь. Примеры:
Глава 9. Словари 189
>>> dl = { "а": 1, "Ь": 2 }
>>> d2 = { "Ь": 20, "с": 3 }
»> dl 1= d2
>>> d2
{'Ь': 20, 'с': 3}
>>> dl
{'а': 1, 'Ь': 20, 'с': 3}
9.3. Перебор элементов словаря
Перебрать все элементы словаря можно с помощью цикла перебора последовательности
(хотя словари и не являются последовательностями). Для примера выведем элементы сло
варя двумя способами. Первый способ использует метод keys(), возвращающий объект
с ключами словаря. Во втором случае мы просто указываем словарь в инструкции цикла. На
каждой итерации цикла будет возвращаться ключ, с помощью которого внутри цикла мож
но получить значение, соответствующее этому ключу (листинг 9.1 ).
d = {"z": 3, "у": 2, "х": 1 }
for key in d.keys(): # Использование метода keys()
print("({0} => {l})".format(key, d[key]), end=" ")
# Выведет: (z => 3) (у => 2) (х => 1)
print () # Вставляем символ перевода строки
for key in d: # Словари также поддерживают итерации
print("({0} => {l})".format(key, d[key]), end=" ")
# Выведет: (z => 3) (у => 2) (х => 1)
Начиная с Python 3.7, элементы словаря выводятся в порядке их создания (в предыдущих
версиях языка они могли выводиться в другом порядке).
Чтобы вывести элементы словаря с сортировкой по ключам, следует получить список клю
чей и отсортировать его методом sort() (листинг 9.2).
d = {"z": 3, "у": 2, "х": 1
k = list(d.keys()) # Получаем список ключей
k.s.ort() # Сортируем список ключей
for key in k:
print("({0} => {l})".format(key, d[key]), end=" ")
# Выведет: (х => 1) (у => 2) (z => 3)
Для сортировки ключей также можно воспользоваться функцией sorted() (листинг 9.3).
d = {"z": 3, "у": 2, "х": 1 }
for key in sorted(d.keys()):
print("({0} => {l})".format(key, d[key]), end=" ")
# Выведет: (х => 1) (у => 2) (z => 3)
190 Часть /. Основы языка Python
Так как на каждой итерации возвращается ключ словаря , функции sorted() можно передать
сам словарь, а не результат выполнения метода keys() (листинг 9.4).
d = {"z": 3, "у": 2, "х": 1 )
for key in sorted(d):
print("({O) => {l})".format(key, d[key]), end=" ")
# Выведет: (х => 1) (у => 2) (z => 3)
9.4. Методы и функции для работы со словарями
Объект словаря поддерживает следующие методы:
♦ keys() - возвращает объект dict_keys, содержащий все ключи текущего словаря. Этот
объект поддерживает итерации, а также операции над множествами. Примеры:
>>> dl, d2 = { "а": 1, "Ь": 2 ), { ".а": 3, "с": 4, "d": 5 )
>>> dl.keys(), d2.keys() # Получаем объект dict_keys
(dict_keys(['a', 'Ь']), dict keys(['a', 'с', 'd']))
>>> list(dl.keys()), list(d2.keys()) # Получаем список ключей
(['а', 'Ь'], ['а', 'с', 'd'])
>>> for k in dl.keys(): print(k, end=" ")
а Ь
>>> dl.keys() 1 d2.keys() # Объединение
{'а'' 'с'' 'Ь', 'd')
>>> dl.keys() - d2.keys() # Разница
{'Ь')
>>> d2.keys() - dl.keys() # Разница
{'с'' 'd')
>>> dl.keys() & d2.keys() # Одинаковые КЛЮЧИ
{'а')
>>> dl.keys() л d2.keys() # Уникальные ключи
{'с'' 'Ь', 'd')
♦ values() - возвращает объект dict_values, содержащий все значения текущего слова
ря. Этот объект поддерживает итерации. Примеры:
>>> d = { "а": 1, "Ь": 2
>>> d.values() # Получаем объект dict values
dict_values( (1, 2])
>>> list(d.values()) # Получаем список значений
(1, 2]
>>> [ v for v in d.values()
(1, 2]
♦ items() - возвращает объект dict_items, содержащий кортежи с двумя элементами:
ключом и значением соответствующего элемента текущего словаря. Этот объект под
держивает итерации. Примеры:
>>> d = { "а": 1, "Ь": 2 )
>>> d.items() # Получаем объект dict items
dict_items([('a', 1), ('Ь', 2)])
Глава 9. Словари 191
>>> list(d.items()) # Получаем список кортежей
[ ('а', 1), ('Ь', 2)]
♦ get(<Ключ> [, <Значение по умолчанию>] ) - если заданный кmоч присутствует в теку
щем словаре, метод возвращает значение, соответствующее этому кmочу. Если кmоч от
сутствует, возвращается None или значение из второго параметра. Пример:
>>> d= { "а": 1, "Ь": 2}
>>> d.get("a"), d.get("c"), d.get("c", 800)
(1, None, 800)
♦ setdefault(<Ключ> [, <Значение по умолчанию>] ) - если задаmп,rй кmоч присутствует
в текущем словаре, метод возвращает значение, соответствующее этому ключу. Если
кmоч отсутствует, в словаре создается новый элемент со значением из второго парамет
ра. Если второй параметр не указан, значением нового элемента будет None. Примеры:
>>> d = { "а": 1, "Ь": 2 }
>>> d .setdefault("a"),d.setdefault("c"),d.setdefault("d", О)
(1, None, О)
>>> d
{ 'а': 1, ' с': None, 'Ь ' : 2, 'd': }
О
♦ рор(<Ключ> [, <Значение по умолчанию> J } - удаляет из текущего словаря элемент с ука
заmп,rм кmочом и возвращает его значение. Если кmоч отсутствует, возвращается значе
ние из второго параметра. Если кmоч отсутствует, и второй параметр не указан, возбуж
дается искmочение KeyError. Примеры:
>>>ct ='{ "а": 1, "Ь": 2, "с": 3}
>>> d .pop("a"), d.pop("n", О)
(1, О)
>>> d.pop("n") # Ключ отсутствует, и нет второго параметра
Traceback (rnost recent call last):
File "<pyshell#40>", line 1, in <rnodule>
d .pop("n") # Ключ отсутствует, и нет второго параметра
KeyError: 'n'
>>> d
{'с' : 3, 'Ь': 2)
♦ popitern() - удаляет из текущего словаря последний элемент и возвращает кортеж из
кmоча и значения удаленного элемента. Если словарь пустой, возбуждается исключение
KeyError. Примеры:
>>> d = { "а": 1, "Ь": 2 }
>>> d.popitern(}
('Ь', 2)
>>> d.popitern()
('а', 1)
>>> d.popitern() # Словарь �устой. Возбуждается исключение
Traceback (rnost recent call last):
File "<pyshell#45>", line 1, in <rnodule>
d.popitern() # Словарь пустой. Возбуждается исключение
KeyError: 'popitern(): dictionary is ernpty'
192 Часть /. Основы языка Python
В версиях Python, предшествующих 3.7, метод popitem() удалял не последний, а произ
вольный элемент словаря (поскольку порядок хранения элементов в словаре мог менять
ся в процессе работы программы);
♦ clear() - удаляет все элементы текущего словаря и ничего не возвращает:
>>> d = { "а": 1, "Ь": 2 }
>>> d.clear() # Удаляем все элементы
>>> d # Словарь теперь пустой
{}
♦ update() - добавляет в текущий словарь заданные элементы. Результата не возвращает.
Форматы метода:
uрdаtе(<Ключ l>=<Значение 1>[, . . ., <Ключ N>=<Значение N>])
uрdаtе(<Словарь>)
uрdаtе(<Список кортежей с двумя элементами: кmочом и значением>)
uрdаtе(<Список списков с двумя элементами: ключом и значением>)
Если элемент с указанным кmочом уже присутствует в текущем словаре, то его значение
будет перезаписано. Примеры:
>>> d = { "а":, 1, "Ь": 2 }
>>> d.update(с=З, d=4)
>>> d
{'а': 1, 'с': 3, 'Ь': 2, 'd': 4)
>>> d.update({"c": 10, "d": 20)) # Словарь
>>> d # Значения элементов перезаписаны
{'а': 1, 'с': 10, 'Ь': 2, 'd': 20)
>>> d.update([("d", 80), ("е", 6)]) # Список кортежей
>>> d
{'а': 1, 'с': 10, 'Ь': 2, 'е': 6, 'd': 80)
>>> d.update([[''a", "str"], ["i", "t"]]) # Список списков
>>> d
{'а': 'str', 'с': 10, 'Ь': 2, 'е': 6, 'd': 80, 'i': 't'}
♦ сору() - создает поверхностную копию текущего словаря:
>>> dl = { "а": 1, "Ь": [10, 20] }
>>> d2 = dl.copy() # Создаем поверхностную копию
>» dl is d2 # Это разные объекты
False
>>> d2["a"] = 800 # Изменяем значение
>>> dl, d2 # Изменилось значение только в d2
({'а': 1, 'Ь': [10, 20]}, {'а': 800, 'Ь': [10, 20]})
>>> d2["b"] [О] = "new" # Изменяем значение вложенного списка
>>> dl, d2 # Изменились значения
. и в dl, и в d2 ! ! !
({'а': 1, 'Ь': ['new', 20]}, {'а': 800, 'Ь': ['new', 20]})
Чтобы создать полную копию словаря, следует воспользоваться функцией deepcopy() из
модуля сору.
Функция reversed(<Cлoвapь>) (поддерживается, начиная с Python 3.8) возвращает итератор,
который выдает кmочи заданного словаря, приведенные в обратном порядке:
Глава 9. Словари 193
>>> for k in reversed(d): print(k + " => " + str(d[k]), end=" ")
с => 3 Ь => 2 а => 1
9.5. Генераторы словарей
Помимо генераторов списков и множеств, Python поддерживает генераторы словарей.
Формат записи генератора словаря:
<Выражение ключа>: <Выражение значения> for �
(<Переменная ключа>, <Переменная значения>) in <Исходное отображение>)
В заданную переменную ключа на каждой итерации помещается ключ очередного элемента
заданного исходного отображения, а в переменную значения - значение очередного эле
мента. Заданное выражение ключа вычисляет ключ, а заданное выражение значения - зна
чение очередного элемента создаваемого словаря. Примеры:
>>> keys = [''а", "Ь "] # Список с ключами
>>> values = [1, 2 ] # Список со значениями
>>> {k: v for (k, v) in zip(keys, values))
{'а': 1, 'Ь': 2)
>>> {k: О for k in keys)
{'а': О , 'Ь': О)
Пример более сложного генератора словаря, создающего из исходного словаря новый, со
держащий только элементы с четными значениями:
>>> d = { "а": 1, "Ь": 2, "с": 3, "d": 4
>>> {k: v for (k, v) in d.items() if v % 2 = О)
{'Ь': 2 , 'd': 4)
ГЛАВА 10
Работа с датой и временем
Python предоставляет средства для работы со значениями даты и времени, а также комбина
циями даты и времени (временнь1ми отметками). Кроме того, он содержит инструменты
для вывода календаря в виде текста или в формате HTML и измерения времени выполнения
определеmп,1х фрагментов программы для целей отладки.
10.1. Получение текущих даты и времени
Получить текущие дату и время позволяют следующие функции из модуля time:
♦ time() - возвращает количество секунд, прошедшее с начала эпохи (обычно с 1 января
1970 г.), в виде вещественного числа:
>>> import time # Подключаем модуль time
>>> time.time() # Получаем количество секунд
1642072670.3688238
♦ grntime([<Количество секунд> J) - возвращает универсальное время (UTC) в виде объ
екта struct_time. Если параметр не указан, возвращается текущее время. Если параметр
указан, время будет соответствующим заданному количеству секунд, прошедших с на
чала эпохи. Примеры:
>>> time.grntime(0) # Начало эпохи
time.struct_time(tm_year=l970, tm_mon=l, tm_mday=l, tm_hour=0,
tm_min=0, tm_sec=0, tm_wday=3, tm_yday=l, tm_isdst=0)
>>> time.grntime() # Текущая дата и время
time.struct_time(tm_year=2022, tm_mon=l, tm_mday=l3, tm_hour=ll,
tm_min=l9, tm_sec=SS, tm_wday=3, tm_yday=l3, tm_isdst=0)
»> time.grntime(l642072670.0) # Дата 13.01.2022
time.struct_time(tm_year=2022, tm_mon=l, tm_mday=l3, tm_hour=ll,
tm_min=l7, tm_sec=S0, tm_wday=3, tm_yday=l3, tm_isdst=0)
Получить значение конкретного атрибута можно, указав его имя или индекс внутри
объекта:
>>> d = time.grntime()
>>> d.tm_year, d[0]
(2022, 2022)
Глава 10. Работа с датой и временем 195
»> tuple(d) # Преобразование в кортеж
(2022, 1, 13, 11, 21, 6, 3, 13, О)
♦ localtime( [ <Количество секунд> J ) - возвращает местное время в виде объекта struct_
time. Если параметр не указан, возвращается текущее время. Если параметр указан,
время будет соответствующим заданному количеству секунд, прошедших с начала эпо
хи. Примеры:
>>> time.localtime() # Текущая дата и время
time.struct_time(tm_year =2022, tm_mon= l, tm_mday=l3, tm_hour=l4,
tm_min=22, tm_sec=44, tm_wday=3, tm_yday= l3, tm_isdst=0)
>>> time.localtime(l642072670.0) # Дата 13.01.2022
time.struct_time(tm_year =2022, tm_mon=l, tm_mday=l3, tm_hour= l4;
tm_min= l7, tm_sec=50, tm_wday=3, tm_yday= l3, tm_isdst=0)
♦ mktime(<Объект struct_time>) - возвращает количество секунд, прошедших с начала
эпохи, в виде вещественного числа. В качестве параметра указывается объект struct_
time или кортеж из девяти элементов. Если указанная дата некорректна, возбуждается
искточение OVerflowError. Примеры:
>>> d = time.localtime(l642072670.0)
>>> time.mktime(d)
1642072670.0
»> tuple(time.localtime(l642072670.0))
(2022, 1, 13, 14, 17, 50, 3, 13, О)
>>> time.mktime((2022, 1, 13, 14, 17, 50, 3, 13, 0))
1642072670.0
>>> time.mktime((l940, О, 31, 5, 23, 43, 5, 31, 0))
... Фрагмент опущен ...
OVerflowError: mktime argument out of range
Объект struct_time, возвращаемый функциями gmtime() и localtime(), содержит следую
щие атрибуты (указаны тройки вида «имя атрибута - индекс - описание»):
♦ tm_year -О -год;
♦ tm_mon - 1 -месяц (число от 1 до 12);
♦ tm_mday - 2 - день месяца (число от 1 до 31);
♦ tm_hour -3 - час (число от О до 23);
♦ tm_min - 4 - минуты (число от О до 59);
♦ tm_sec - 5 - секунды (число от О до 59, изредка до 61);
♦ tm_wday - 6 - день недели (число от О для понедельника до 6 для воскресенья);
♦ tm_yday - 7 - количество дней, прошедшее с начала года (число от 1 до 366);
♦ tm_isdst - 8 -флаг коррекции летнего времени (значения О, 1 или -1).
Выведем текущие дату и время таким образом, чтобы день недели и месяц были написаны
по-русски (листинг 10.1).
1 Листмнr 10.1. Вы� ,-кущихдт, и �и ''
import time
d = [ "понедельник", "вторник", "среда", "четверг",
"пятница", "суббота", "воскресенье" ]
196 Часть /. Основы языка Python
m = , "января", "февраля", "марта", "апреля", "мая",
ff ff
"июня", "июля", "августа", "сентября", "октября",
"ноября", "декабря" ]
t = time.localtime() # Получаем текущее время
print( "Сегодня:\n%s %s %s %s %02d:%02d:%02d\n%02d.%02d.%02d" %
( d[t[б]], t[2], m[t[l]], t[0], t[3], t[4], t[S],
t[2], t[l], t[0J ) )
input()
Примерный результат выполнения:
Сегодня:
четверг 13 января 2022 14:29:55
13.01.2022
10.2. Форматирование даты и времени
Форматирование даты и времени выполняют следующие функции из модуля time:
♦ strftime(<Строка формата>[ , <Объект struct_time>]) - возвращает строковое пред
ставление даты и времени в соответствии с заданной строкой формата. Если второй
параметр не указан, будут выведены текущие дата и время. Если во втором параметре
указан объект struct_time или кортеж из девяти элементов, дата будет соответствовать
указанному значению. Функция зависит от настройки локали. Примеры:
>>> import time
>>> time.strftime("%d.%m.%У") # Форматирование даты
'13.01.2022'
>>> time.strftime("%Н:%М:%S") # Форматирование времени
'14:31:29'
»> time.strftime("%d.%m.%У", time. localtime( 1639725843.О))
'17.12.2021'
♦ strptime(<Строка с датой и временем>[ , <Строка формата>]) - разбирает указанную
строку с датой и временем в соответствии с заданной строкой формата. Возвращает объ
ект struct_time. Если строка не соответствует формату, возбуждается исключение
ValueError. Если строка формата не указана, используется строка "%а %Ь %d %Н:%М:%S
%У". Функция учитьmает текущую локаль. Примеры:
»> time.strptime("Fri Dec 17 10:24:03 2021")
time.struct_time(tm_year=2021, tm_mon=l2, tm_mday=l7, tm_hour=l0,
tm_min=24, tm_sec=3, tm_wday=4, tm_yday=351, tm_isdst=-1)
>>> time.strptime("17.12.2021", "%d.%m .%Y")
time.struct_time(tm_year=2021, tm_mon=l2, tm_mday=l7, tm_hour=0,
tm_min=0, tm_sec=0, tm_wday=4, tm_yday=351, tm_isdst=-1)
>>> time.strptime("l7-12-2021", "%d.%m.%Y")
. .. Фрагмент опущен ...
ValueError: time data '17-12-2021' does not match format '%d.%m.%Y'
♦ asctime( [<Объект struct_time>J ) - возвращает строку формата "%а %Ь %d %Н:%М:%S
%У". Если параметр не указан, будут выведены текущие дата и время. Если в параметре
указан объект struct_time или кортеж из девяти элементов, то дата и время будут соот
ветствовать указанному значению. Примеры:
Глава 10. Работа с датой и временем 197
>>> time.asctime() # Текущая дата
'Thu Jan 13 17:32:37 2022'
>>> time.asctime(time.localtime(l639725843.0)) # Дата в прошлом
'Fri Dec 17 10:24:03 2021'
♦ ctime( [ <Количество секунд> J ) � аналогична asctime(), но в качестве параметра прини
мает количество секунд, прошедших с начала эпохи:
>>> time.ctime() # Текущая дата
'Thu Jan 13 17:34:04 2022'
>>> time.ctime(l639725843.0) # Дата в прошлом
'Fri Dec 17 10:24:03 2021'
В параметре <Строка формата> в функциях strftime() и strptime() могут быть использова
ны следующие комбинации специальных символов:
♦ %у- год из двух цифр (от "00" до "99");
♦ %У - год из четырех цифр (например, "2011 11 );
♦ %m-номер месяца с предваряющим нулем (от "01" до "12");
♦ %Ь - аббревиатура месяца в зависимости от настроек локали (например, "янв" для января);
♦ %В - название месяца в зависимости от настроек локали (например, "январь");
♦ %d- номер дня в месяце с предваряющим нулем (от "01" до "31");
♦ %j -день с начала года (от "001" до "366");
♦ %U - номер недели в году (от "ОО" до "53"). Неделя начинается с воскресенья. Все дни
с начала года до первого воскресенья относятся к неделе с номером О;
♦ %W-номер недели в году (от "00" до "53"). Неделя начинается с понедельника. Все дни
с начала. года до первого понедельника относятся к неделе с номером О;
♦ %w-номер дня недели ("О"-для воскресенья, "6"-для субботы);
♦ %а - аббревиатура дня недели в зависимости от настроек локали (например, "Пн" для
понедельника);
♦ %А- название дня недели в зависимости от настроек локали (например, "понедельник");
♦ %Н - часы в 24-часовом формате (от "ОО" до "23");
♦ %I-часы в 12-часовом формате (от "01" до "12");
♦ %М-минуты (от "ОО" до "59");
♦ %s-секунды (от "00" до "59", изредка до "61");
♦ %р - эквивалент значений АМ и РМ в текущей локали;
♦ %с-представление даты и времени в текущей локали;
♦ %х-представление даты в текущей локали;
♦ %Х - представление времени в текущей локали:
>>> import locale
>>> locale.setlocale(locale.LC ALL, "Russian_Russia.1251")
'Russian Russia.1251'
>>> print(time.strftime("%x")) # Представление даты
13.01.2022
198 Часть /. Основы языка Python
>>> print(time.strftime("%X")) # Представление времени
17:36:50
>>> print(time.strftime("%c")) # Представление даты и времени
13.01.2022 17:37:17
♦ %Z - название часового пояса или пустая строка (например, "Московское время", "UTC");
♦ %%- символ "%".
В качестве примера выведем .текущие дату и время с помощью функции strftime() (лис
тинг 10.2).
import time
import locale
locale.setlocale(locale.LC_ALL, "Russian_Russia.1251")
s = "Сегодня:\n%А %d %Ь %У %H:%M:%S\n%d.%m.%Y"
print(time.strftime(s))
input()
Примерный результат выполнения:
Сегодня:
четверг 13 янв 2022 17:37:59
13.01 .2022
10.3. Приостановка выполнения программы
Функция sleep(<Время в секундах>) из модуля time приостанавливает выполнение про
граммы на указанное время. В качестве параметра можно указать целое или вещественное
число. Пример:
>>> import time
>>> time.sleep(5) # "Засьmаем" на 5 секунд
10.4. Значения даты и времени
Модуль datetime предоставляет инструменты для работы со значениями даты и времени:
выполнения арифметических операций, сравнения, вывода в различных форматах и др.
Предварительно необходимо подключить модуль с помощью инструкции:
import datetime
10.4.1. Временнь1е промежутки
Временной проме:ж:уток- это величина разницы между какими-либо временнь�ми отмет
ками (т. е. значениями времени и даты).
Класс timedelta из модуля datetime позволяет выполнять операции над временнь�ми про
межутками: складывать, вычитать, сравнивать и др. Конструктор класса имеет следующий
формат:
Глава 10. Работа с датой и временем 199
-:imedelta( [days] [, seconds] [, microseconds] [, milliseconds] [, minutes] [,
hours] [, weeks] )
Все параметры не являются обязательными и по умолчанmо имеют значение О. Их можно
записывать как позиционные или как именованные. Первые три параметра считаются
основными:
♦ days - дни (диапазон -999999999 <= days <= 999999999);
♦ seconds- секунды (диапазон О <= seconds < 3600*24);
♦ microseconds - микросекунды (диапазон О <= microseconds < 1000000).
Примеры:
>>> datetime.timedelta(3)
datetime.timedelta(days=3)
>>> datetime.timedelta(0, 2, 10000)
datetime.timedelta(seconds=2, microseconds=l0000)
>>> datetime.timedelta(days=l, seconds=7200)
datetime.timedelta(days=l, seconds=7200)
Все остальные параметры автоматически преобразуются в следующие значения:
♦ milliseconds -миллисекунды (одна миллисекунда преобразуется в 1000 микросекунд):
>>> import datetime
>>> datetime.timedelta(milliseconds=l)
datetime.timedelta(microseconds=l000)
♦ minutes- минуты (одна минута преобразуется в 60 секунд):
>>> datetime.timedelta(minutes=l)
datetime.timedelta(seconds=60)
♦ hours- часы (один час преобразуется в 3600 секунд):
>>> datetime.timedelta(hours=l)
datetime.timedelta(seconds=3600)
♦ weeks - недели (одна неделя преобразуется в 7 дней):
>>> datetime.timedelta(weeks=l)
datetime.timedelta(days=7)
Получить результат можно с помощью следующих атрибутов:
♦ dауs-дни;
♦ seconds - секунды;
♦ microseconds- микросекунды.
Пример:
>>> d = datetime.timedelta(hours=l, days=2, milliseconds=l)
>>> d
datetime.timedelta(days=2, seconds=3600, microseconds=l000)
>>> d.days, d.seconds, d.microseconds
/
(2, 3600, 1000)
200 Часть /. Основы языка Python
Получить результат в секундах позволяет метод total_seconds():
>>> d = datetime.timedelta(minutes=l)
>>> d.total_seconds()
60.0
Над временнъrми промежутками можно производить арифметические операции+,-,/,//,%
и *, использовать унарные операторы + и -, получать абсоmотное значение с помощью
функции abs(), вычислять частное и остаток от деления нацело функцией divmod():
>>> dl datetime.timedelta(days=2)
>>> d2 = datetime.timedelta(days=7)
>>> dl + d2, d2 - dl # Сложение и вычитание
(datetirne.tirnedelta(days=9), datetime.timedelta(days=5))
>>> d2 / dl # Деление
3.5
>>> dl / 2, d2 / 2.5 # Деление
(datetirne.timedelta(days =l), datetime.timedelta(days=2, secoщls= 69120))
»> d2 // dl # Деление
3
>>> dl // 2, d2 // 2 # Деление
(datetime.timedelta(days=l), datetirne.timedelta(days=3, seconds=43200))
»> d2 % dl # Остаток
datetirne.timedelta(days=l)
>>> dl * 2, d2 * 2 # Умножение
(datetime.timedelta(days =4), datetirne.timedelta(days=l4))
>>> 2 * dl, 2 * d2 # Умножение
(datetime.tirnedelta(days= 4), datetime.tirnedelta(days= l4))
»> d3 = -dl
»> d3, abs(d3)
(datetime.tirnedelta(days= -2), datetirne.tirnedelta(days=2))
>>> divmod(d2, dl)
(3, datetime.tirnedelta(days=l))
Кроме того,можно использовать операторы сравнения =, ! =, <, <=, > и >=:
>>> dl datetirne.timedelta(days=2)
>>> d2 datetime.timedelta(days=7)
>>> d3 datetime.timedelta(weeks= l)
>>> dl == d2, d2 = d3 # Проверка на равенство
(False, True)
>>> dl ! = d2, d2 ! = d3 # Проверка на неравенство
(True, False)
>>> dl < d2, d2 <= d3 # Меньше, меньше или равно
(True, True)
>>> dl > d2, d2 >= d3 # Больше, больше или равно
(False, True)
Также можно получить строковое представление временн6го промежутка с помощью
функций str() и repr():
>>> d = datetirne.tirnedelta(hours=25, rninutes=5, seconds=27)
>>> str(d), repr(d)
('1 day, 1:05:27', 'datetime.timedelta(days=l, seconds=3927) ')
Глава 10. Работа с датой и временем 201
Класс timedelta поддерживают следующие атрибуты:
♦ min - минимальное значение, которое может иметь временн6й промежуток;
♦ max - максимальное значение, которое может иметь временн6й промежуток;
♦ resolution - минимальное возможное различие между временнъ1ми промежутками.
Выведем значения этих атрибутов:
>>> datetime.timedelta.min
datetime.timedelta(days=-999999999)
>>> datetime.timedelta.max
datetime,timedelta(days=999999999, seconds=86399, microseconds=999999)
>>> datetime.timedelta.resolution
datetime.time.delta(microseconds=l)
10.4.2. Значения даты
Класс date из модуля datetime позволяет выполнять операции над датами. Конструктор
класса имеет следующий формат:
dаtе(<Год>, <Месяц>, <День>)
В параметрах указываются числа:
♦ <Год> - в диапазоне между значениями констант MINYEAR и МАХУЕАR класса datetime
(о нем речь пойдет позже). Выведем значения этих констант:
>>> import datetime
>>> datetime.MINYEAR, datetime.МAXYEAR
(1, 9999)
♦ <Месяц> - от 1 до 12 включительно;
♦ <день> - от 1 до количества дней в месяце.
Если значения выходят за диапазон, возбуждается исключение ValueError. Примеры:
>>> datetime.date(2022, 1, 13)
datetime.date(2022, 1, 13)
>>> datetime.date(2022, 13, 3) # Неправильное значение месяца
... Фрагмент опущен
ValueError: month must Ье in 1..12
Для создания даты также можно воспользоваться следующими методами класса date:
♦ today() - возвращает текущую дату:
>>> datetime.date.today()
datetime.date(2022, 1, 13)
♦ fromtimestamp(<Количество секунд>) - возвращает д<!-ту, которая соответствует задан
ному количеству секунд, прошедших с начала эпохи:
>>> import datetime, time
>>> datetime.date.fromtimestamp(time.time()) # Текущая дата
datetime.date(2022, 1, 13)
>>> datetime.date.fromtimestamp(l639725843.0) # Дата 17.12.2021
datetime.date(2021, 12, 17)
202 Часть /. Основы языка Python
♦ fromordinal(<Количество дней с 1-го года>) - возвращает дату, которая соответству
ет заданному количеству дней, прошедших с первого года. В качестве параметра указы
вается число от 1 до datetime.date.max.toordinal():
>>> datetime.date.max.toordinal()
3652059
>>> datetime.date.fromordinal(3652059)
datetime.date(9999, 12, 31)
>>> datetime.date.fromordinal(l)
datetime.date(l, 1, 1)
♦ fromisoformat(<Строка с датой>) (начиная с Python 3.7)- возвращает дату, созданную
в результате преобразования заданной строки, которая указывается в формате <ГГГГ>
<ММ>-<дц>:
>>> datetime.date.fromisoformat("2021-12-17")
datetime.date(2021, 12, 17)
♦ fromisocalendar() (начиная с Python 3.8) - возвращает дату, созданную на основе за
данных параметров. Формат метода:
fromisocalendar(<Гoд>, <Порядковый номер недели в году>,
<Порядковый номер дня в неделе>)
Пример:
>>> datetime.date.fromisocalendar(2022, 2, 4)
datetime.date(2022, 1, 13)
Получить результат можно с помощью следующих атрибутов:
♦ year - год (число в диапазоне от MINYEAR до МАХУЕАR);
♦ month - месяц (число от 1 до 12);
♦ day - день (число от 1 до количества дней в месяце).
Пример:
>>> d = datetime.date.today()
>>> d.year, d.month, d.day
(2022, 1, 13)
Над экземплярами класса date можно производить следующие операции:
♦ date2 = datel + timedelta - прибавляет к дате datel временной промежуток
timedelta. Значения атрибутов seconds и microseconds временного промежутка игнори
руются;
♦ date2 datel - timedelta - вычитает из даты datel временной промежуток
timedelta. Значения атрибутов seconds и microseconds временного промежутка игнори
руются;
♦ timedelta = . datel - date2 - возвращает разницу между датами datel и date2 в виде
временного промежутка. Атрибуты seconds и microseconds последнего будут иметь зна
чения О.
Также можно сравнивать две даты с помощью операторов сравнения:
>>> dl datetime.date(2022, 1, 13)
>>> d2 = datetime.date(2021, 12, 31)
Глава 10. Работа с датой и временем 203
>>> t = datetime.timedelta(days=l0)
>>> dl + t, dl - t # Прибавляем и вычитаем 10 дней
(datetime.date(2022, 1, 23), datetime.date(2022, 1, 3))
>>> dl - d2 # Разница между датами
datetime.timedelta(days=l3)
>>> dl < d2, dl > d2, dl <= d2, dl >= d2
(False, True, False, True)
>>> dl == d2, dl ! = d2
(False, True)
Можно получить строковое представление даты с помощью функций str() и repr() :
>>> d = datetime.date(2022, 1, 13)
>>> str(d), repr(d)
('2022-01-13', 'datetime.date(2022, 1, 13)')
Класс ctate поддерживает следующие методы:
♦ replace( [year] [, month] [, ctay]) - возвращает текущую дату с обновленными значе
ниями года (параметр year), месяца (month) и (или) числа (ctay). Параметры можно ука
зывать как позиционные или как именованные. Примеры:
>>> d = datetime.date(2021, 12, 17)
>>> d.replace(2022, 7) # Заменяем год и месяц
datetime.date(2022, 7, 17)
>>> d.replace(year=2021, month=2, day=28)
datetime.date(2021, 2, 28)
>>> d.replace(day=2) # Заменяем только день
datetime.date(2021, 12, 2)
♦ strftime(<Строка формата>) - возвращает текущую дату в виде строки, отформатиро
ванной согласно заданной строке формата. В строке формата можно задавать комбина
ции специальных символов, которые используются в функции strftime() из модуля
time. Пример:
>>> d = datetime.date(2021, 12, 17)
>>> d.strftime("%d.%m.%Y")
'17.12.2021'
♦ isoformat() - возвращает текущую дату в виде строки формата <ГГГГ>-<ММ>-<дц>:
>>> d = datetime.date(2021, 12, 17)
>>> d.isoformat()
'2021-12-17'
♦ ctime() - возвращает текущую дату в виде строки формата "%а %Ь %ct %Н:%М:%S %У":
>>> d = datetime.date(2021, 12, 17)
»> d.ctime()
'Fri Dec 17 00:00:00 2021'
♦ timetuple() - возвращает текущую дату в виде объекта struct_time:
>>> d = datetime.date(2021, 12, 17)
>>> d.timetuple()
time.struct_time(tm_year=2021, tm_mon=l2, tm_mday=17, tm_hour=0,
tm_min=0, tm_sec=0, tm_wday= 4, tm_yday=351, tm_isdst=-1)
204 Часть /. Основы языка Python
♦ toordinal () - возвращает текущую дату в виде количества дней, прошедших с 1-го года:
>>> d = datetime.date(2021, 12, 17)
>>> d.toordinal()
738141
♦ weekday() - возвращает порядковый номер дня в неделе (О - для понедельника, 6 -
для воскресенья):
>>> d = datetime.date(2021, 12, 17)
>>> d.weekday() # 4 - это пятница
4
♦ isoweekday() - возвращает порядковый номер дня в неделе (1 - для понедельника,
7 � для воскресенья):
>>> d = datetime.date(2021, 12, 17)
>>> d.isoweekday() # 5 - это пятница
5
♦ isocalendar () - возвращает последовательность из трех элементов: года, номера неде
ли в году и порядкового номера дня в неделе:
>>> d = datetime.date(2021, 12, 17)
>>> isoc = d.isocalendar()
>>> isoc[0], isoc[l], isoc[2]
(2021, 50, 5)
Наконец, имеется поддержка следующих атрибутов:
♦ min - минимально возможное значение даты;
♦ max - максимально возможное значение даты;
♦ resolution - минимальное возможное различие между значениями даты.
Выведем значения этих атрибутов:
>>> datetime.date.min
datetime.date(l, 1, 1)
>>> datetime.date.max
datetime.date(9999, 12, 31)
>>> datetime.date.resolution
datetime.timedelta(days= l)
10.4.3. Значения времени
Класс time из модуля datetime позволяет выполнять операции над значениями времени.
Конструктор класса имеет следующий формат:
time([hour][, minute] [, second] [, microsecond][, tzinfo], [fold])
Все параметры не являются обязательными. Их можно указывать как позиционнь1е или как
именованнь1е, за исключением параметра fold, который можно указать только как имено
ванный. В параметрах можно задать следующий диапазон значений:
♦ hour - часы (число от О до 23);
♦ minute - минуты (число от О до 59);
Глава 1 О. Работа с датой и временем 205
♦ second - секунды (число от О до 59);
♦ microsecond - микросекунды (число от О до 999999);
♦ tzinfo - временная зона (объект класса tzinfo или значение None);
♦ fold - порядковый номер отметки времени. Значение О (используется по умолчанию)
обозначает первую отметку, значение 1 - вторую. Предусмотрен для тех случаев, когда
в рассматриваемой временной зоне практикуется перевод часов с зимнего на летнее
время и обратно, в результате чего часы могут дважды в сутки показывать одинаковое
время.
EcJiи значения выходят за диапазон, возбуждается исключение ValueError. Примеры:
>>> import datetime
>>> datetime.time(l3, 49, 24, 186500)
datetime.time(l3, 49, 24, 186500)
>>> datetime.time(hour= l3, second =24, minute=49)
datetime.time(l3, 49, 24)
>>> datetime.time(25, 12, 38, 375000)
...- Фрагмент опущен ...
ValueError: hour must Ье in О ..23
Создать значение времени также можно с помощью метода fromisoformat(<Строка с вре
менем>) класса time (этот метод поддерживается, начиная с Python 3.7). Строка с временем
должна указываться в формате ISO 8601. Пример:
>>> datetime.time.fromisoformat( "13: 49: 24.186500'')
datetime.time(l3, 49, 24, 186500)
Получить результат можно с помощью следующих атрибутов:
♦ hour - часы (число от О до 23);
♦ minute - минуты (число от О до 59);
♦ second - секунды (число от О до 59);
♦ microsecond - микросекунды (число от О до 999999);
♦ tzinfo - временная зона (объект класса tzinfo или значение None);
♦ fold - порядковый номер отметки времени (число О или 1).
Пример:
>>> t = datetime.time(l3, 49, 24, 186500)
>>> t.hour, t.minute, t.second, t.microsecond
(13, 49, 24, 186500)
Над значениями времени нельзя выполнять арифметические операции. Можно тол�,ко про
изводить сравнения, например:
>>> tl datetime.time(l3, 49, 24, 186500)
>>> t2 = datetime.time(8, 54, 35)
>>> tl < t2, tl > t2, tl <= t2, tl >= t2
(False, True, False, True)
>>> tl == t2, tl ! = t2
(False, True)
206 Часть /. Основы языка Python
Можно получить строковое представление времени с помощью функций str() и repr() :
>>> t = datetime.time(13, 49, 24, 186500)
>>> str(t), repr(t)
('13:49:24.186500', 'datetime.time(13, 49, 24, 186500)')
Класс time поддерживает следующие методы:
♦ replace() - возвращает текущее время с обновленными значениями, указанными в па
раметрах. Формат метода:
replace( [hour] [, minute] [, second] [, microsecond] [, tzinfo] [, fold])
Параметры можно указывать как позиционные или как именованные. Примеры:
>>> t = datetime.time(13, 49, 24, 186500)
>>> t.replace(l0, 12) # Заменяем часы и минуты
datetime.time(l0, 12, 24, 186500)
>>> t.replace(second=43) # Заменяем только секунды
datetime.time(13, 49, 43, 186500)
♦ isoformat( [timespec="auto"]) - возвращает строку с текущим временем в формате
ISO 8601. В параметре timespec можно указать состав выдаваемого времени, задав одно
из следующих значений:
• "auto" - часы, минуты, секунды и микросекунды, если количество последних не
равно О - в противном случае микросекунды не включаются в состав времени;
• "hours" - часы;
• "minutes" - часы и минуты;
• "seconds" - часы, минутьr и секунды;
• "milliseconds" - часы, минуты, секунды и миллисекунды (вычисляются путем
округления микросекунд до тысячных);
• "microseconds" - часы, минуты, секунды и микросекунды (выводятся всегда, даже
если их количество равно О).
Примеры:
>>> t = datetime.time(13, 49, 24, 186500)
>>> t.isoformat()
'13:49:24.186500'
>>> t.isoformat("minutes")
'13:49'
♦ strftime(<Строка формата>) - возвращает текущее время, отформатированное согласно
заданной строке формата. В строке формата можно указывать комбинации специальных
символов, которые используются в функции strftime () из модуля time. Пример:
>>> t = datetime.time(13, 49, 24, 186500)
>>> t.strftime("%H:%M:%S")
'13:49:24'
Дополнительно класс time поддерживает такие атрибуты:
♦ min - минимально возможное значение времени;
♦ max - максимально возможное значение времени;
♦ resolution - минимальное возможное различие между значениями времени.
Глава 1 О. Работа с датой и временем 207
Вот значения этих атрибутов:
>>> datetime.time.min
datetime.time(O, О)
>>> datetime.time.max
datetime.time(23, 59, 59, 999999)
>>> datetime.time.resolution
datetime.timedelta(microseconds=l)
ПРИМЕЧАНИЕ
Класс time поддерживает также методы dst(), utcoffset() и tzname(). За подробной
информацией по этим методам, а также по абстрактному классу tzinfo обращайтесь к до
кументации по модулю datetime.
10.4.4. Временнь1е отметки
Класс datetime из модуля datetime позволяет выполнять операции над временнь1ми отмет
ками (комбинациями даты и времени). Конструктор класса имеет следующий формат:
datetime(<Гoд>, <Месяц>, <День>[, hour] [, minute] [, second] [,
microsecond] [, tzinfo] [, fold])
Первые три параметра являются обязательными. Остальные параметры можно указывать
как позиционные или как именованные, кроме fold, который задается только как имено
ванный. В параметрах можно указать следующие значения:
♦ <Год> - число, расположенное в диапазоне между значениями из констант MINYEAR (1)
И МАХУЕАR (9999 );
♦ <Месяц> - число от 1 до 12 включительно;
♦ <День> - число от 1 до количества дней в месяце;
♦ hour - часы (число от О до 23);
♦ minute - минуты (число от О до 59);
♦ second - секунды (число от О до 59);
♦ microsecond - микросекунды (число от О до 999999);
♦ tzinfo - временная зона (объект класса tzinfo или значение None);
♦ fold - порядковый номер отметки времени. Значение О (используется по умолчанmо)
обозначает первую отметку, значение 1 - вторую. Предусмотрен для тех случаев, когда
в рассматриваемой временной зоне практикуется перевод часов с зимнего на летнее
время и обратно, в результате чего часы могут дважды в сутки показывать одинаковое
время.
Если значения выходят за диапазон, возбуждается исключение ValueError. Примеры:
>>> import datetime
>>> datetime.datetime(2022, 1, 14)
datetime.datetime(2022, 1, 14, о, О)
>>> datetime.datetime(2022, 1, 14, hour=l4, minute= 22)
datetime.datetime(2022, 1, 14, 14, 22)
>>> datetime.datetime(2022, 32, 20)
... Фрагмент опущен ...
ValueError: month must Ье in 1 .. 12
208 Часть /. Основы языка Python
Для создания временной отметки также можно воспользоваться следующими методами:
♦ today() - возвращает текущие дату и время:
>>> datetime.datetime.today()
datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
♦ now( [ <Временная зона> J ) - возвращает текущие дату и время. Если параметр 'не задан,
то метод аналогичен методу today(). Пример:
>>> datetime.datetime.now()
datetime.datetime(2022, 1, 14, 14, 26, 41, 833984)
♦ utcnow() ---,- возвращает текущее универсальное время (UTC):
>>> datetime.datetime.utcnow()
datetime.datetime(2022, 1, 14, 11, 27, 28, 713491)
♦ fromtimestamp(<Количество секунд> [, <Временная зона>]) - возвращает временную
отметку, которая соответствует заданному количеству секунд, прошедших с начала эпохи:
>>> import datetime, time
>>> datetime.datetime.fromtimestamp(time.time())
datetime.datetime(2022, 1, 14, 14, 28, 47, 984896)
>>> datetime.datetime.fromtimestamp(l639725843.0)
datetime.datetime(2021, 12, 17, 10, 24, 3)
♦ utcfromtimestamp(<Количество секунд>) - возвращает временную отметку, которая
соответствует заданному количеству секунд, прошедших с начала эпохи, в универсаль
ном времени (UTC):
>>> datetime.datetime.utcfromtimestamp(time.time())
datetime.datetime(2022, 1, 14, 11, 32, 11, 356915)
>>> datetime.datetime.utcfromtimestamp(l639725843.0)
datetime.datetime(2021, 12, 17, 7, 24, 3)
♦ fromordinal(<Количество дней с 1-го года>) - возвращает дату, которая соответству
ет заданному количеству дней, прошедших с 1-го года. В качестве параметра указывает
ся число от 1 до datetime.datetime.max.toordinal (). Примеры:
>>> datetime.datetime.max.toordinal()
3652059
>>> datetime.datetime.fromordina1(3652059)
datetime.datetime(9999, 12, 31, О, О)
>>> datetime.datetime.fromordinal(l)
datetime.datetime(l, 1, 1, О, О)
♦ fromisoformat(<Строка с датой и временем>) (начиная с Python 3.7)- возвращает вре
менную отметку, созданную в результате преобразования заданной строки, которая ука
зывается в формате ISO 8601:
»> datetime.datetime.fromisoformat("2021-12-17T17:24:03.190301")
datetime.datetime(2021, 12, 17, 17, 24, 3, 190301)
♦ fromisocalendar() (начиная с Python 3.8)- возвращает временную отметку, созданную
на основе заданных параметров. Формат метода:
fromisocalendar(<Гoд>, <Порядковый номер недели в году>,
<Порядковый номер дня в неделе>)
Глава 1 О. Работа с датой и временем 209
Пример:
>>> datetime.datetime.fromisocalendar(2022, 2, 4)
datetime.datetime(2022, 1, 13, О, О)
♦ comЬine(<Дата>, <Время> [, <Временная зона>] ) - возвращает временную отметку, соз
данную на основе переданных ему даты и времени:
>>> d = datetime.date(2022, 1, 14)
>>> t = datetime.time(14, 35, 14)
>>> datetime.datetime.comЬine(d, t)
datetime.datetime(2022, 1, 14, 14, 35, 14)
♦ strptime(<Строка с датой>, <Строка формата>) - возвращает временную отметку, соз
данную на основе разбора заданной строки с датой в соответствии с указанной строкой
формата. Если строка с датой не соответствует формату, возбуждается искшочение
ValueError. Метод учитывает текущую локаль. Примеры:
>>> datetime.datetime.strptime("17.12.2021", "%d.%m.%Y")
datetime.datetime(2021, 12, 17, О, О)
>>> datetime.datetime.strptime("17.12.2021", "%d-%m-%Y")
... Фрагмент опущен ...
ValueError: time data '17.12.2021' does not match format '%d-%m-%Y'
Получить результат можно с помощью следующих атрибутов:
♦ year - год (число в диапазоне от MINYEAR до МАХУЕАR) ;
♦ month - месяц (число от 1 до 12);
♦ day- день (число от 1 до количества дней в месяце);
♦ hour- часы (число от О до 23);
♦ minute - минуты (число от О до 59);
♦ second - секунды (число от О до 59);
♦ microsecond- микросекунды (число от О до 999999);
♦ tzinfo - временная зона (объект класса tzinfo или значение None).
♦ fold- порядковый номер отметки времени (число О или 1 ).
Примеры:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.year, d.month, d.day
(2022, 1, 14)
>>> d.hour, d.minute, d.second, d.microsecond
(14, 25, 21, 998076)
Над временнь1ми отметками можно производить следующие операции:
♦ datetime2 = datetimel + timedelta - сложение временной отметки datetimel и вре
менного промежутка timedelta;
♦ datetime2 = datetimel - timedelta - вычитание из временной отметки datetimel вре
менного промежутка timedelta;
♦ timedelta = datetimel - datetime2 - возвращает разницу между временньrми отмет
ками datetimel и datetime2 в виде временного промежутка.
210 Часть /. Основы языка Python
Также можно сравнивать две даты с помощью операторов сравнения. Примеры:
>>> dl = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d2 = datetime.datetime(2021, 12, 31, 9, 5, 37, 438)
>>> t = datetime.timedelta(days=l0, minutes=l0)
>>> dl + t # Прибавляем 10 дней и 10 минут
datetime.datetime(2022, 1, 24, 14, 35, 21, 998076)
>>> dl - t # Вычитаем 10 дней и 10 минут
datetime.datetime(2022, 1, 4, 14, 15, 21, 998076)
>>> dl - d2 # Разница между датами
datetime.timedelta(days=l4, seconds=l9184, microseconds=997638)
>>> dl < d2, dl > d2, dl <= d2, dl >= d2
(False, True, False, True)
>>> dl == d2, dl ! = d2
(False, True)
Можно получить строковое представление временной отметки с помощью функций str() и
repr():
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> str(d), repr(d)
('2022-01-14 14:25:21.998076',
'datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)')
Класс datetime поддерживает следующие методы:
♦ date() - возвращает текущую дату в виде объекта date:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.date()
datetime.date(2022, 1, 14)
♦ time() - возвращает текущее время в виде объекта time без временной зоны:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
»> d.time()
datetime.time(14, 25, 21, 998076)
♦ timetz() - возвращает текущее время в виде объекта time с временной зоной;
♦ timestamp() - возвращает количество секунд, прошедшее с начала эпохи (обычно с 1 ян
варя 1970 г.), в виде вещественного числа:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.timestamp()
1642159521.998076
♦ replace() - возвращает текущую временную отметку с обновленными значениями,
взятыми из параметров. Формат метода:
replace( [year] [, month] [, day] [, hour] [, minute] [, second] [,
microsecond] [, tzinfo] [, fold] )
Параметры можно указывать как позиционные или как именованные, за исключением
fold, который указывается только как именованный. Примеры:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.replace(2023, 12)
datetime.datetime(2023, 12, 14, 14, 25, 21, 998076)
Глава 10. Работа с датой и временем 211
>>> d.replace(hour=6, minute=l0, microsecond=38)
datetime.datetime(2022, 1, 14, 6, 10, 21, 38)
♦ timetuple() - возвращает текущие дату и время в виде объекта struct_time:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.timetuple()
time.struct_time(tm_year=2022, tm_mon=l, tm_mday=l4, tm_hour=l4,
tm_min=25, tm_sec=21, tm_wday=4, tm_yday=l4, tm_isdst=-1)
♦ utctimetuple() - возвращает текущие дату и время в виде объекта struct_time в уни
версальном времени (UTC):
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.utctimetuple()
time.struct_time(tm_year=2022, tm_mon=l, tm_mday=l4, tm_hour=l4,
tm_min=25, tm_sec=21, tm_wday=4, tm_yday=l4, tm_isdst=0)
♦ toordinal() - возвращает количество дней, прошедшее с 1-го года:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.toordinal()
738169
♦ weekday() - возвращает порядковый номер дня в неделе (О - для понедельника, 6 - .
для воскресенья):
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.weekday() # 4 - это пятница
4
♦ isoweekday() - возвращает порядковый номер дня в неделе (1 - для понедельника,
7 - для воскресенья):
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.isoweekday() # 5 - это пятница
5
♦ isocalendar() - возвращает последовательность из трех элементов: года, номера неде
ли в году и порядкового номера дня в неделе:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> isoc = d.isocalendar()
>>> isoc[0], isoc[l], isoc[2]
(2022, 2, 5)
♦ isoformat([<Разделитель>][, ] [timespec="auto"J) -возвращает текущие дату и время
в формате ISO 8601. Если разделитель . не указан, используется буква т. В параметре
timespec можно указать состав выдаваемого времени, задав одно из следующих зна
чений:
• "auto" - часы, минуты, секунды и микросекунды, если количество последних не
равно О - в противном случае микросекунды не включаются в состав времени;
• "hours" - часы;
• "minutes" - часы и минуты;
212 Часть/. Основы языка Python
• "seconds" - часы,
минуты и секунды;
• "milliseconds" - часы, минуты, секунды и миллисекунды (вычисляются путем
окрутления микросекунд до тысячных);
• "microseconds" - часы, минуты, секунды и микросекунды (выводятся всегда, даже
если их количество равно О).
Примеры:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.isoformat() # Разделитель не указан
'2022-01-14Т14:25:21.998076'
>>> d.isoformat(" ") # Пробел в качестве разделителя
'2022-01-14 14:25:21.998076'
>>> d.isoformat(timespec="minutes")
'2022-01-14Т14:25'
♦ ctime() - возвращает текущие дату и время в виде строки формата "%а %Ь %d %Н:%М:%S
%У":
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.ctime()
'Fri Jan 14 14:25:21 2022'
♦ strftime(<Строка формата>) - возвращает текущие дату и время в виде строки, отфор
матированной согласно заданной строке формата. В строке формата можно указывать
комбинации специальных символов, которые использу_ются в функции strftime() из
модуля time. Пример:
>>> d = datetime.datetime(2022, 1, 14, 14, 25, 21, 998076)
>>> d.strftime("%d.%m.%Y %H:%M:%S")
'14.01.2022 14:25:21'
Класс datetime поддерживает также следующие атрибуты:
♦ min - минимально возможное значение временной отметки;
♦ max - максимально возможное значение временной отметки;
♦ resolution - минимальное возможное различие между временнь1ми отметками.
Значения этих атрибутов:
>>> datetime.datetime.min
datetime.datetime(l, 1, 1, О, О)
>>> datetime.datetime.max
datetime.datetime(9999, 12, 31, 23, 59, 59, 999999)
>>> datetime.datetime.resolution
datetime.timedelta(microseconds= l)
ПРИМЕЧАНИЕ
Класс datetime также поддерживает методы astimezone(), dst(), utcoffset() и
tzname(). За подробной информацией по этим методам, а также по абстрактному классу
tzinfo обращайтесь к документации по модулю datetime.
Глава 10. Работа с датой и временем 213
10.5. Вывод календаря
Модуль calendar формирует календарь в виде простого текста или НТМL-кода. Прежде чем
использовать модуль, необходимо подключить его с помощью инструкции:
import calendar
Класс Calendar, содержащийся в этом модуле, является базовым, от которого наследуют
остальные классы календарей, описываемые далее. Формат конструктора:
Саlеndаr([<Первый день недели>])
В параметре указывается число от О (для понедельника) до 6 (для воскресенья). Если пара
метр не указан, его значение принимается равным О. Вместо чисел можно использовать
значения переменных: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY или SUNDAY,
содержащихся в модуле calendar.
В качестве примера получим двумерный список всех дней в январе 2022 года, распределен
ных по дням недели:
>>> import calendar
>>> с = calendar.Calendar()
>>> c.monthdayscalendar(2022, 1)
((0, о, о, о, о, 1, 2], (3, 4, 5, 6, 7, 8, 9],
(10, 11, 12, 13, 14, 15, 16], (17, 18, 19, 20, 21, 22, 23],
(24, 25, 26, 27, 28, 29, 30], (31, О, О, О, О, О, О]]
В дальнейшем указать другой первый день недели у объекта календаря позволяет метод
setfirstweekday(<Пepвый день недели>). В ·качестве примера получим календарь на фев
раль 2022 года, где первым днем недели является воскресенье:
>>> c.setfirstweekday(calendar.SUNDAY)
>>> c.monthdayscalendar(2022, 2)
[[О, О, 1, 2, 3, 4, 5], (6, 7, 8, 9, 10, 11, 12],
[13, 14, 15, 16, 17, 18, 19], (20, 21, 22, 23, 24, 25, 26],
(27, 28, О, О, О, О, О]]
10.5.1. Вывод календаря в текстовом виде
Для формирования календаря в текстовом виде служат два класса из модуля calendar:
♦ тe�tCalendar - выводит названия месяцев и дней недели по-английски. Формат конст
руктора:
TextCalendar([<Пepвый день недели>])
Параметр указывается в таком же формате, что и у класса Calendar (см. разд. 10.5). Вы
ведем календарь на весь 2022 год:
>>> import calendar
>>> с = calendar.TextCalendar()
>>> print(c.formatyear(2022))
Результатом станет большая строка, содержащая календарь в виде отформатированного
текста;
♦ LocaleTextCalendar - выводит названия месяцев и дней недели в соответствии с ука
занной локалью. Формат конструктора:
LocaleTextCalendar([<Пepвый день недели>[, <Название локали>]])
214 Часть /. Основы языка Python
Вьmедем календарь на весь 2022 год на русском языке:
>>> с = calendar.LocaleTextCalendar(0, "Russian_Russia.1251")
>>> print(c.formatyear(2022))
Классы TextCalendar и LocaleTextCalendar поддерживают следующие методы:
♦ formatmonth() - возвращает текстовый календарь на указанный месяц в заданном году.
Формат метода:
formatmonth(<Гoд>, <Месяц>[, <Ширина поля с днем>[,
<Количество символов перевода строки>]])
Третий параметр задает ширину поля с днем, а четвертый параметр - количество сим
волов перевода строки между строками. Выведем календарь на декабрь 2022 года:
>>> с = calendar.LocaleTextCalendar(0, "Russian_Russia.1251")
>>> print(c.formatmonth(2022, 12))
Декабрь 2022
Пн Вт Ср Чт Пт Сб Вс
1 2 3 4
5 6 7 8 9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31
♦ prmonth() - аналогичен методу formatmonth(), только сразу выводит календарь в кон
соль. Распечатаем календарь на декабрь 2022 года, указав ширину поля с днем, равной
4 символам:
>>> с = calendar.LocaleTextCalendar(0, "Russian_Russia.1251")
>>> c.prmonth (2022, 12, 4)
Декабрь 2022
Пн Вт Ср Чт Пт Сб Вс
1 2 3 4
5 6 7 8 9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31
♦ formatyear(<Год>[, w=2 J [, l=l J [, с=6 J [, m=3 J ) - возвращает текстовый календарь на
указанный год. Параметры имеют следующее предназначение:
• w - ширина поля с днем;
• 1 - количество символов перевода строки между строками;
• с - количество пробелов между месяцами;
• m - количество месяцев на строке.
Их можно указывать как позиционные или как именованные.
Сформируем календарь на 2023 год, выведем на одной строке сразу четыре месяца и
установим количество пробелов между месяцами, равное 2:
>>> с = calendar.LocaleTextCalendar(0, "Russian_Russia.1251")
>>> print(c.formatyear(2023, m=4, с=2))
Глава 10..Работа с датой и временем 215
♦ pryear() - аналогичен методу formatyear(), только сразу выводит календарь в консоль.
Распечатаем календарь на 2023 год по два месяца на стр оке, расстояние между месяцами
установим равным четырем символам, ширину поля с датой - равной двум символам, а
строки разделим одним символом перевода строки:
>>> с = calendar.LocaleTextCalendar(O, "Russian_Russia .1251")
>>> c.pryear(2023, 2, 1, 4, 2)
10.5.2. Вывод календаря в формате HTML
Для формирования календаря в формате НТМL служат два класса из модуля calendar:
♦ HTМLCalendar - выводит названия месяцев и дней недели по-английски. Формат конст
руктора:
HTМLCalendar([<Первый день недели>])
Параметр указывается в таком же формате, что и у класса Calendar (см. разд. 10.5).
Выведем календарь на весь 2022 год:
>>> import calendar
>>> с = calendar.HTМLCalendar()
>>> print(c.formatyear(2022))
Результатом будет большая строка с НТМL-кодом календаря, отформатированного в ви
де таблицы;
♦ LocaleHTМLCalendar - выводит названия месяцев и дней недели в соответствии с ука
занной локалью. Формат конструктора:
LocaleHTМLCalendar([<Пepвый день недели>[, <Название локали>]])
Выведем календарь на весь 2022 год на русском языке в виде отдельной веб-страницы:
>>> с = calendar.LocaleHTМLCalendar(O, "Russian_Russia.1251")
>>> xhtml = c.formatyearpage(2022, encoding="windows-1251")
»> print(xhtml.decode("cp1251"))
Классы HTМLCalendar и LocaleHТМLCalendar поддерживают следующие методы:
♦ formatmonth(<Год>, <Месяц>[, <True I False>]) - возвращает календарь на указанный
месяц в заданном году в виде НТМL-кода, содержащего только таблицу (тег <tаЫе>).
Если в третьем параметре указано значение тrue (значение по умолчанию), то' в заголов
ке таблицы после названия месяца будет указан год. Выведем календарь на январь
2022 года:
>>> с = calendar.LocaleHTМLCalendar(O, "Russian_Russia.1251")
>>> print(c.formatmonth(2022, 1))
У каждой ячейки НТМL-таблицы, формирующей календарь, указывается стилевой
класс, соответствующий одному из дней недели. Благодаря этому к ячейкам можно при
вязывать разные СSS-стили. Имена этих стилевых классов доступны через атрибут
cssclasses класса календаря:
>>> с = calendar.HTМLCalendar(O)
>>> print(c.cssclasses)
['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
216 Часть /. Основы языка Python
Начиная с Python 3.7, класс календаря поддерживает следующие атрибуты, задающие
другие стилевые классы:
• cssclass_noday- имя стилевого класса, указываемого у пустых ячеек календаря
(соответствующих дням предыдущего и следующего месяцев). По умолчанию:
"noday";
• cssclasses_weekday_head- список имен стилевых классов, указываемых у заголо
вочных ячеек с названиями дней недели (по умолчанию совпадает со списком из ат
рибута cssclasses);
• cssclass_month_head - имя стилевого класса, указываемого у заголовочной ячейки
с названием месяца (по умолчанию: "month");
• cssclass_month- имя стилевого класса, указываемого. у таблицы, в которой выво
дится календарь за месяц (по умолчанию: "month");
• cssclass_year_head- имя стилевого класса, указываемого у заголовочной ячейки
с годом (по умолчанию: "year");
• cssclass_year- имя стилевого класса, указываемого у таблицы, в которой выводит-
ся календарь за весь год (по умолчанию: "year").
Выведем календарь на январь 2022 года, указав другие имена стилевых классов для яче
ек с днями недели и заголовочной ячейки с месяцем:
>>> с = calendar.LocaleHTМLCalendar(O, "Russian_Russia.1251")
>>> с.cssclasses = ["workday", "workday", "workday", "workday",
"workday", "week-end", "week-end"]
>>> c.cssclass month head = "month-head"
>>> print(c.formatmonth(2022, 1, False))
♦ formatyear(<Год> [, <Количество месяцев на строке>]) - возвращает календарь на ука
занный год в виде НТМL-кода. Календарь будет отформатирован с помощью несколь
ких НТМL-таблиц. Если количество месяцев в строке не задано, принимается зна
чение 3. Выведем календарь на 2023 год так, чтобы на одной строке выводились сразу
четыре месяца:
>>> с = calendar .LocaleHTМLCalendar(O, "Russian_Russia.1251")
>>> print(c.formatyear(2023, 4))
♦ formatyearpage(<Год>[, width] [, css] [, encoding]) - возвращает календарь на ука
занный год в виде отдельной веб-страницы. Параметры имеют следующее предназначе
ние:
• width - количество месяцев на строке (по умолчанию: 3);
• css - название файла с таблицей стилей (по умолчанию: "calendar.css");
• encoding- кодировка файла, указываемая в параметре encoding ХМL-пролога и теге
<meta> (по умолчанию не указана).
Параметры можно указывать как позиционные или как именованные.
Выведем календарь на 2023 год так, чтобы на одной строке выводились четыре месяца,
дополнительно указав кодировку:
>>> с = calendar.LocaleHTМLCalendar(O, "Russian_Russia .1251")
>>> xhtml = c.formatyearpage(2023, 4, encoding="windows-1251")
Глава 10. Работа с датой и временем 217
>>> type(xhtml) # Возвращаемая строка имеет тип данных bytes
<class 'bytes'>
>>> print(xhtml.decode("cp1251"))
10.5.3. Другие полезные функции
Модуль caiendar предоставляет еще ряд полезных функций:
♦ setfirstweekday(<Пepвый день недели>) - устанавливает первый день недели для ка
лендаря. В качестве параметра указывается число от О (для понедельника) до 6 (для вос
кресенья). Вмесrо чисел можно использовать значения переменных: MONDAY, TUESDAY,
WEDNESDAY, THURSDAY, FRIDAY, SATURDAY или SUNDAY. Получить текущее значение параметра
можно с помощью функции firstweekday(). Установим воскресенье первым днем не
дели:
>>> import calendar
>>> calendar.firstweekday() # По умолчанию О
о
>>> calendar.setfirstweekday(6) # Изменяем значение
>>> calendar.firstweekday() # Проверяем установку
6
♦ month () - возвращает текстовый календарь на указаннь1й месяц в году. Формат функ
ции:
month(<Год>, <Месяц>[, <Ширина поля с днем> [,
<Количество символов перевода строки>])
Третий параметр указывает ширину поля с днем, а четвертый - количество символов
перевода строки между строками. Выведем календарь на январь 2022 года:
>>> calendar.setfirstweekday(0)
>>> print(calendar.month(2022, 1))
January 2022
Мо Tu We Th Fr Sa Su
1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31
♦ prmonth() - аналогична функции month() , только сразу выводит календарь в консоль.
Выведем календарь на январь 2022 года:
>>> calendar.prmonth(2022, 1)
♦ monthcalendar(<Год>, <Месяц>) - возвращает двумерный список всех дней в указанном
месяце указанного года, распределеннь1х по дням недели. Дни, выходящие за пределы
месяца, будут представлены нулями. Выведем массив для января 2022 года:
>>> calendar.monthcalendar(2022, 1)
[[О, О, О, О, О, 1, 2), [3, 4, 5, 6, 7, 8, 9),
(10, 11, 12, 13, 14, 15, 16), (17, 18, 19, 20, 21, 22, 23),
(24, 25, 26, 27, 28, 29, 30), [31, О, О, О, О, О, О]]
218 Часть /. Основы языка Python
♦ monthrange(<Год>, <Месяц>) - возвращает кортеж из двух элементов: номера дня неде
ли, приходящегося на первое число указанного месяца указанного года, и количества
дней в месяце:
>>> print(calendar.monthrange(2022, 1))
(5, 31)
>>>#Январь 2022 года начинается с субботы (5) и включает 31 день
♦ calendar(<Год>[, w=2J [, 1=1] [, с = б] [, m=3J) - возвращает текстовый календарь на
указанный год. Параметры имеют следующее предназначение:
• w - ширина поля с днем;
• 1 - количество символов перевода строки между строками;
• с - количество пробелов между месяцами;
• m - количество месяцев на с троке.
Параметры можно указывать как позиционные или как именованные.
Выведем календарь на 2023 год так, чтобы на одной строке выводились сразу четыре
месяца, указав два пробела между месяцами:
>>> print(calendar.calendar(2023, m=4, с=2))
♦ prcal() - аналогична функции calendar(), только сразу выводит его календарь в кон
соль. Выведем календарь на 2023 год по два месяца на строке, расстояние между меся
цами установим равным четырем символам, ширину поля с датой - равной двум сим
волам, а строки разделим одним символом перевода строки:
>>> calendar.prcal(2023, 2, 1, 4, 2)
♦ weekheader(<Длина>) - возвращает строку, которая содержит аббревиа-rуры дней недели
с учетом текущей локали, разделенные пробелами. Единственный параметр задает длину каждой
аббревиа'I)'ры в символах. Примеры:
>>> calendar.weekheader(4)
'Mon Tue Wed Thu Fri Sat Sun '
>>> calendar.weekheader(2)
'Мо Tu We Th Fr Sa Su'
>>> import locale #Задаем другую локаль
>>> locale.setlocale(locale.LC_ALL, "Russian_Russia.1251")
'Russian Russia.1251'
>>> calendar.weekheader(2)
'Пн Вт Ср Чт Пт Сб Вс'
♦ isleap(<Год>) - возвращает значение True, если указанный год является високосным,
в противном случае - False:
>>> calendar.isleap(2022), calendar.isleap(2024)
(False, True)
♦ leapdays(<Год 1>, <Год 2>) - возвращает количество високосных лет в диапазоне от
<Год 1> до <Год 2> (<Год 2> не учитывается):
>>> calendar.leapdays(2021, 2024) #2024 не учитывается
о
>>> calendar.leapdays(2020, 2024) #2020 - високосный год
1
Глава 1 О. Работа с датой и временем 219
>>> calendar.leapdays(2020, 2025) # 2020 и 2024 - високосные года
2
♦ weekday(<Год>, <Месяц>, <День>) - возвращает номер дня недели (О- для понедель
ника, 6 - для воскресенья):
>>> calendar.weekday(2022, 1, 17)
о
♦ timegm(<Oбъeкт struct_time>)- возвращает количество секунд, прошедших с начала
эпохи. В качестве параметра указывается объект struct_time с датой и временем, воз
вращаемый функцией gmtime() из модуля time. Примеры:
>>> import calendar, time
>>> d = time.gmtime(l639725843.0) # Дата 17-12-2021
>>> d
time .struct_time(tm_year=2021, tm_mon=l2, tm_mday=l7, tm hour=7,
tm_min=24, tm_sec=3, tm_wday=4, tm_yday=351, tm_isdst=O)
»> tuple(d)
(2021, 12, 17, 7, 24, 3, ·4, 351, О)
>>> calendar.timegm(d)
1639725843
>>> calendar.timegm((2021, 12, 17, 7, 24, 3, 4, 351, 0))
1639725843
Модуль calendar также поддерживает ряд полезных атрибутов:
♦ day_name - список полных названий дней недели в текущей локали:
>>> [i for i in calendar.day_name]
['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday',
'Saturday', 'Sunday']
>>> import locale # Настройка лакали
>>> locale.setlocale(locale.LC_ALL, "Russian_Russia.1251")
'Russian Russia.1251'
>>> [i for i in calendar.day_name]
['понедельник', 'вторник', 'среда', 'четверг', 'пятница', 'суббота',
'воскресенье' ]
♦ dау_аььr- список аббревиатур названий дней недели в текушей локали:
>>> [i for i in calendar.day_aЬЬr]
['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun' ]
>>> import locale # Настройка лакали
>>> locale.setlocale(locale.LC_ALL, "Russian_Russia.1251")
'Russian Russia.1251'
>>> [i for i in calendar.day_aЬЬr]
[ , Пн, , , Вт, , , Ср, , , Чт, , , Пт, , , Сб, , , Вс, ]
♦ month_name - список полнь1х названий месяцев в текущей локали:
>>> [i for i in calendar.month_name]
[", 'January', 'February', 'March', 'April', 'Мау', 'June',
'July', 'August', 'SeptemЬer', 'October', 'NovemЬer', 'DecemЬer']
>>> import locale # Настройка лакали
>>> locale.setlocale(locale.LC_ALL, "Russian_Russia.1251")
'Russian Russia.1251'
220 Часть /. Основы языка Python
>>> [i for i in calendar.month_name]
[' ' , 'Январь', 'Февраль', 'Март', 'Апрель', 'Май', 'Июнь', 'Июль',
'Август', 'Сентябрь', 'Октябрь', 'Ноябрь', 'Декабрь']
♦ month_abbr - список аббревиатур названий месяцев в текущей локали:
>>> [i for i in calendar.month_abbr]
['', 'Jan', 'Feb', 'Mar', 'Apr', 'Мау', 'Jun', 'Jul', 'Aug',
'Sep', 'Oct', 'Nov', ' Dec']
>>> import locale # Настройка локали
>>> locale.setlocale(locale.LC_ALL , "Russian_Russia.1251")
'Russian Russia.1251'
>>> [i for i in calendar.month_aЬbr]
[ i ' ' 'янв' ' 'фев ' ' 'мар' ' 'апр' ' 'май', 'июн • ' 'июл' ' 'авг', 'сен',
'окт', 'ноя', 'дек']
10.6. Измерение времени выполнения
фрагм�нтов кода
Модуль timeit предоставляет инструменты для измерения времени выполнения фрагмен
тов кода программы с целью ее оптимизации.
Измерения производятся с помощью класса Timer, который сначала следует импортировать
из модуля timeit посредством инструкции:
from timeit import Timer
Конструктор класса имеет следующий формат:
Timer([stmt='pass'J [, setup='pass'])
В параметре stmt указывается код (в виде строки), время выполнения которого нужно изме
рить. Параметр setup задает код, выполняемый перед измерением времени выполнения ко
да, из параметра stmt (например, код из параметра setup может подключать необходимые
модули).
Получить время выполнения можно с помощью метода timeit ( [numЬer=l000000J). В пара
метре numЬer указывается количество повторений.
Для примера просуммируем числа от 1 до 10 ООО тремя способами и выведем время выпол
нения каждого способа (листинг 10.3).
from timeit import Timer
codel = """\
i, j = 1 , О
while i < 10001:
j += i
i += 1
tl = Timer(stmt=codel)
print("while:", tl.timeit(numЬer=l0000) )
code2 = """\
j = о
Глава 10. Работа с датой и временем 221
for i in range(l, 10001):
j += i
t2 = Tirner(stmt=code2)
print("for:", t2.timeit(nшnЬer=10000))
code3 = """\
j = sum(range(l, 10001))
t3 = Timer(stmt=code3)
print("sum:", t3.timeit(nшnЬer=10000))
input()
Примерный результат выполнения (зависит от мощности компьютера):
while: 10.956968600000437
for: 6.4Ql410300000862
sum: 2.3285845999998855
Сразу видно, что цикл перебора последовательности работает почти в два раза быстрее
цикла с условием, а функция sum() в нашем случае вовсе вне конкуренции.
Метод repeat( [ repeat=5] [, щдnЬеr=lОООООО] ) вызывает метод tirneit() указанное в пара
метре repeat количество раз и возвращает список значений (до Python 3.7 этот параметр
имел значение по умолчанию 3). Аргумент nшnЬer передается в качестве параметра методу
timeit().
Для примера создадим список со строковыми представлениями чисел от 1 до 1 О ООО: в пер
вом случае для создания списка используем цикл перебора последовательности и метод
append(), а во втором - генератор списков (листинг 10.4).
from timeit import Timer
codel = """\
arrl = []
for i in range(l, 10001):
arrl.append(str(i))
tl = Timer(stmt=codel)
print("append:", tl.repeat(repeat=3, nшnЬer=2000))
code2 = """\
arr2 = [str(i) for i in range(l, 10001)]
t2 = Timer(stmt=code2)
print("гeнepaтop:", t2.repeat(repeat=3, nшnЬer=2000))
input()
Примерный результаt выполнения:
append: [ 4.658220999999685, 4. 67 4832300000162, 4. 590558100000635]
генератор: (3. 93614129999969, 3.8754656000000978, 3.8798187000002144]
Как видно из результата, генераторы списков работают быстрее.
ГЛАВА 11
Функции
Функция - это языковая конструкция, выполняющая над переданными ей значениями
(параметрами) какое-либо сложное действие. Так, функция sqrt () вычисляет квадратный
корень, функция print () вьmодит заданные значения в консоль, а функция strftime () фор
матирует указанные дату и время сообразно заданному формату.
Функция может принимать произвольное количество параметров, в том числе и ни одного.
Также функция может возвращать результат выполненного ею действия..
Язык Python содержит огромное количество функций, которые реализованы в нем самом
и называются встроенными. Однако мы можем добавить к ним свои собственные, пользо
вательские, функции. Которым и посвящена эта глава.
11.1. Определение и вызов фу11кции
Инструкция создания, или определения, пользовательской функции записывается в сле
дующем формате:
def <Имя функции> ( [ <Имена параметров через запятую>] ) :
<Тело функции>
Имя функции должно быть уникальным, состоять из латинских букв, цифр и знаков под
черкивания и не начинаться с цифры. В качестве имени нельзя использовать ключевые сло
ва Python, кроме того, следует избегать совпадений с названиями встроенных идентифика
торов. Регистр символов в имени функции также имеет значение.
Имена параметров должны удовлетворять тем же требованиям, что и имена переменньrх
(см. разд. 2.1). Если функция не принимает параметров, следует указать пустые круглые
скобки.
Тело функции - это блок, реализующий функциональность определяемой функции. Не за
бьmаем, что инструкции, входящие в блок, должны иметь одинаковые отступы слева, вы-
полненные пробелами.
При вызове функции создаются переменные, имеющие те же имена, что и записанньrе
в определении функции параметры. Эти переменньrе будут хранить реальные значения па
раметров, заданные в выражении вызова функции, станут доступны лишь в теле функции
(локальные переменные), а после завершения выполнения функции - удалены из памяти.
Пример определения функции, принимающей два параметра, делящей их друг на друга и
выводящей результат в консоль:
Глава 11. Функции 223
>>> def division(a, Ь):
res = а/ Ь
print(str(a), "/ str(b), " str(res))
Если тело функции состоит из одного выражения, его можно набрать в одной строке с язы
ковой конструкцией def. Пример определения функции, не принимающей параметров и
выводящей в консоль случайное число:
>>> def rnd(): print(randorn.randorn())
Для возврата результата из функции в ее теле записывается инструкция такого формата:
return <Возвращаемое значение>
Пример функции, принимающей два параметра, делящей их друг на друга и возвращающей
в качестве результата строку с получившимся частным:
>>> def division2(a, Ь):
res = а/ Ь
s = str(a) + " / " + str(b) + " " + str(res)
return s
После выполнения инструкции, возвращающей результат, исполнение тела функции завер
шается:
>>> def func():
print("Текст до инструкции return")
return "Возвращаемый результат"
print(."Этa инструкция никогда не будет вьmолнена")
Если в теле функции отсутствует инструкция, возвращающая результат, функция при вызо
ве все равно будет неявно возвращать в качестве результата значение None.
Обращение к ранее определенной функции называется вызовом. И встроенные, и пользова
тельские функции вызываются одинаково - записью выражения в формате:
<Имя функции>([<Значения параметров через запятую>])
Количество параметров в выражении вызова функции должно совпадать с количеством па
раметров в ее определении, иначе будет выведено сообщение об ошибке. Если вызываемая
функция не принимает параметров, все равно следует указать пустые круглые скобки. При
меры:
>>>#Вызываем функцию, принимакщую параметры
>>> division(l, 2)
1 / 2 0.5
>>> division(2, 1)
2 / 1 2.0
>>>#Вызываем функцию, не принимакхцую параметров
>>> rnd()
О.5221364008680583
Результат, возвращенный функцией, можно сохранить в какой0 либо переменной или ис
пользовать в дальнейших вычислениях:
224 Часть /. Основы языка Python
>>> n = division2(4, 6)
>>> n
'4 / 6 = О.6666666666666666'
>>> print("Получен результат: division2(7, 5))
Получен результат: 7 / 5 = 1.4
Также его можно IШгде не сохранять и никак не использовать - в таком случае результат
будет потерян. Так поступают, если результат выполнения функции не нужен для работы.
Пример:
division2(4, 6) # Результат вьmолнения функции потерян ·
Поскольку в теле функции для хранения полученных параметров используются специально
создаваемые локальнь1е переменные, значения параметров могут быть изменены в теле
функции - и зто не вызовет никаких сторонних эффектов в коде, вызвавшем функцию. Вот
пример:
>>> def func(a):
print("Внутри функции: а)
а = 20 # Изменяем значение параметра внутри функции
print("Bнyтpи функции: ", а)
>>> Ь = 30 # Создаем переменную Ь
>>> print("Вне функции: Ь)
Вне функции: 30
>>> func(b) # Передаем функции значение из переменной Ь
Внутри функции: 30
Внутри функции: 20
>>> print( "Вне функции: Ь) # Значение переменной Ь не изменилось
Вне функции: 30
Однако в теле функции можно изменять значения изменяемых типов (например, списков),
созданных вне функции (поскольку в функцию передаются не сами эти значения, а ссьшки
на них):
>>> def func(lst): lst.append("Python"); lst.append("Dj_ango")
>>> platfoпns = [ "РНР", "Laravel"]
>>> func(platfoпns)
>>> platfoпns
['РНР', 'Laravel', 'Python', 'Django']
11.1.1. Расположение определений функций
Определение функции должно быть расположено перед ее вызовом. Правильно:
def sumna(х, у):
return х + у
V = Sшшila.(10, 20)
Неправильно (возникнет ошибка: NarneError: narne 'sumna' is not defined):
v = sumna(l0, 20)
def sшпmа(х, у):
return х + у
Глава 11. Функции 225
Чтобы избежать ошибки, определения функций размещают в самом начале программы по
сле подключения модулей или в отдельном модуле (о модулях речь пойдет в главе 12).
Если определения функций располагаются в том же модуле, что и их вызовы, определения
функций часто отделяют от остального кода - для наглядности.
С помощью инструкции ветвления можно при выполнении заданного условия определить
одну функцию, а при его невыполнении - другую (листинг 11.1).
Листинr 1'1.1:Оn�ие Фfнкции_в за
n = inрut("Введите 1 для вызова первой функции: ")
if n == "1":
def echo():
print("Bы ввели число 1")
else:
def echo():
рrint("Альтернативная функция")
echo ( ) # Вызываем функцию
input()
При вводе числа 1 мы получим сообщение "Вы ввели число 1", в противном случае -
"Альтернативная функция".
Если определение одной и той же функции встречается в программе несколько раз, будет
использоваться функция, которая была определена последней:
def echo():
print("Bы ввели число 1")
def echo():
рrint("Альтернативная функция")
echo() # Всегда выводит "Альтернативная функция"
11.1.2. Локальные и глрбальные переменные
В теле функции можно создавать любые переменные. Они будут существовать только
в теле функции и по завершении ее выполнения уничтожатся. Такие переменные называются
локальными. Пример функции, в теле которой создаются локальные переменные res и s:
>>> def division2(a, Ь):
res = а/ Ь
s = str(a) + " / " + str(b) + " " + str(res)
return s
>>> division(4, 6) # Вызываем функцию
'4/ 6 = О.6666666666666666'
>>> res # Безуспешно пытаемся обратиться к локальной переменной
. . . Фрагмент пропущен
NarneError: narne 'res' is not defined
Как отмечалось ранее, сам интерпретатор для размещения значений параметров, передан
ных функции при вызове, создает в ней локальные переменные с именами, совпадающими
226 Часть /. Основы языка Python
с именами параметров, которые указаны в определении функции. Так, при вызове функции,
определенной в предыдущем примере, будут созданы локальные переменные а и ь.
Переменные, созданные вне тобых функций, называются глобш�ьными. Они доступны
в теле тобой функции - но только на чтение. Глобальную переменную можно создать как
перед определением функции, так и после него. Пример:
»> def func():
print(glob)
>>> glob = 10
>>> func ()
10
При попытке в теле функции присвоить глобальной переменной новое значение создается
одноименная локальная переменная, к которой в дальнейшем и будет выполняться обраще
ние:
>>> def func2():
glob = 20 # Будет создана локальная переменная glob
print(glob)
»> func2()
20
>>> glob # Значение глобальной переменной не изменилось
10
Однако попытка в теле функции присвоить значение локальной переменной после об
ращения к одноименной глобальной переменной приведет к возбуждению искточения
UnЬoundLocalError:
>>> def func():
print(glob)
glob = 20
>>> func ()
... Фрагмент пропущен ...
UnЬoundLocalError: local variaЫe 'glob' referenced before assignment
Чтобы значения глобальных переменных можно было изменять внутри функции, необхо
димо в теле функции объявить эти переменные глобальными с помощью языковой конст
рукции формата:
global <Имена переменных через запятую>
Продемонстрируем это на примере (листинг 11.2).
def func ():
# Объявляем переменную glob глобальной
global glob
glob = 25 # Изменяем значение глобальной переменной
рrint("Значение glob внутри функции=", glob)
Глава 11. Функции 227
glob = 10 # Глобальная переменная
рrint("Значение glob вне функции =", glob)
func() # Вызываем функцию
рrint("Значение glob после функции =", glob)
Результат выполнения:
Значение glob вне функции= 10
Значение glob внутри функции = 25
Значение glob после функции= 25
Получить все идентификаторы и их значения позволяют следующие функции:
♦ globals() - возвращает словарь с глобальными идентификаторами;
♦ locals() - возвращает словарь с локальными идентификаторами.
Пример использования обеих этих функций показан в листинге 11.3.
def func():
locall = 54
glob2= 25
print("Глобальные идентификаторы внутри функции")
print(sorted(globals().keys()))
рrint("Локальные идентификаторы внутри функции")
print(sorted(locals().keys()))
gloЫ, glob2= 10, 88
func()
рrint("Глобальные идентификаторы вне функции")
print(sorted(globals() .keys()))
Результат выполнения:
Глобальные идентификаторы внутри функции
[' annotations builtins doc file loader
'_name_', '__package_', '_spec_', 'func', 'gloЫ', 'glob2']
Локальные идентификаторы внутри функции
['glob2', 'locall']
Глобальные идентификаторы вне функции
[' annotations builtins doc file loader
'_name_', '_package_', '_spec_', 'func', 'gloЫ',, /glob2']
♦ vars( [<Объект> J ) - если вызывается без параметра внутри функции, возвращает сло
варь с локальными идентификаторами. Если вызывается без параметра вне функции,
возвращает словарь с глобальными идентификаторами. При указании объекта в качестве
параметра возвращает идентификаторы этого объекта {эквивалентно вызову <Объект>.
_dict_). Пример использования этой функции можно увидеть в листинге 11.4.
1 Листмнr 11.4.:ИcliOl"I
def func():
locall = 54
228 Часть /. Основы языка Python
glob2 = 25 .
рrint("Локальные идентификаторы внутри функции")
print(sorted(vars() .keys()))
gloЫ, glob2 = 10, 88
func()
рrint("Глобальные идентификаторы вне функции")
print(sorted(vars() .keys()))
рrint("Указание объекта в качестве параметра")
print(sorted(vars(dict) .keys()))
рrint("Альтернативный вызов")
print(sorted(dict. dict .keys()))
11.1.3. Позиционные и именованные параметры
Ранее отмечалось, что при вызове функции ее параметры указываются через запятую внут
ри круглых скобок:
>>> division(l, 2)
Такие параметры носят название позиционных. Их значения передаются в вызываемую
функцmо согласно их позициям - в том порядке, в котором параметры указаны в выраже
нии ее вызова. Так, в случае функции division() значение 1 будет присвоено параметру а
(точнее, соответствующей ему локальной переменной, созданной интерпретатором, под
робности - в разд. 11.1), а значение 2 - параметру ь.
Однако для вызова функции можно использовать выражение и другого формата:
<Имя функции>([<Параметр !>=<Значение параметра 1>,
<Параметр 2>=<Значение параметра 2>,
<Параметр N>=<Значение параметра N>])
Здесь применяются именованные параметры, значения которых передаются вызываемой
функции по их именам, например:
>>> division(a=l, Ь=2)
1 / 2 0.5
Именованные параметры в выражении вызова функции можно располагать в произвольном
порядке:
>>> division(b=2, a=l)
1 / 2 = 0.5
При вызове функции можно использовать и позиционные, и именованные параметры. Од
нако именованные параметры должны располагаться после позиционных, иначе возникнет
ошибка. Примеры:
>>> def func(a, Ь, с):
print("a·=>", str(a), " Ь =>", str(b), " с =>", str(c))
>>> func(l, 2, с=З)
а => 1 Ь => 2 с => З
Глава 11. Функции 229
>>> func(l, Ь=2, с= З)
а => 1 ь => 2 с => 3
>>> func(l, с=2, Ь=З)
а => 1 ь => 3 с => 2
>>> func(a=l, 2, с= З)
SyntaxError: positional argument follows keyword argшnent
При попытке передать функции не поддерживаемый ею именованный параметр возникнет
ошибка:
>>> func(l, 2; З, d=4)
... Фрагмент пропущен
TypeError: func() got an unexpected keyword argшnent 'd'
По умолчанию тобой параметр функции может быть указан и как позиционный, и как име
нованный (двоякий параметр). Однако существует возможность пометить .одни параметры
как задаваемые только в качестве именованных (строго именованные), а другие - только
как позиционные (строго позиционные- поддерживаются, начиная с Python 3.8). Для это
го языковая конструкция def, входящая в 'состав определения функции, записывается в сле
дующем формате:
def <Имя функции>(<Строго позиционные параметры>, /,
<Двоякие параметры>, *, <Строго именованные параметры>)
Пример функции с двумя строго позиционными, тремя двоякими и двумя строго именован
ньrми параметрами:
>>> def func(a, Ь, /, с, d, е, f, g):
print("a =>", str(a), " ь =>", str(b), end=" ")
print("с =>", str(c), " d =>", str(d), " е =>", str(e), end=" ")
print("f =>", str (f), " g =>'', str(g))
>>> func(l, 2, 3, 4, 5, f= б, g=7)
а => 1 ь => 2 с => 3 d => 4 е => 5 f => 6 g => 7
>>> func(l, 2, з, d= 4, е=5, f= б, g=7)
а => 1 ь => 2 с => 3 d => 4 е => 5 f => 6 g => 7
Попытка передать строго позиционньтй параметр как именованньтй или строго именован
ный как позиционный приведет к ошибке:
>>> func(l, Ь=2, с= З, d=4, е=5, f= б, g=7)
. . . Фрагмент пропущен
TypeError: func() got·some positional-only argшnents passed as keyword
argшnents: 'Ь'
>>> func(l, 2, З, 4, 5, 6, g=7)
. . . Фрагмент пропущен ...
TypeError: func() takes 5 positional argшnents but 6 positional argшnents
(and 1 keyword-only argшnent) were given
Выражение вызова функции с позиционньтми параметрами имеет более компактную запись.
Однако использование именованньтх параметров позволяет сделать ее нагляднее. Особенно
удобно применять именованньте параметры для вызова функций с большим числом необя
зательных параметров (о них рассказано в разд. 11.1. 4).
230 Часть /. Основы языка Python
11.1.4. Необязательные параметры
Есть возможность сделать некоторые (или даже все) параметры пользовательской функции
необязательными к указанию (необязательные параметры). Если при вызове функции такой
параметр не задан, он получит заданное у него значение по умолчанию.
Необязательный параметр указывается в определении функции в следующем формате:
<Имя параметра>=<Значение параметра по умолчанию>
Необязательные параметры должны следовать после обязательных к указанию, иначе воз
никнет ошибка. Пример функции, у которой второй параметр помечен как необязательный
и имеет значение по умолчанию 2:
>>> def division(a, Ь=2):
print(str(а), " / ", str(Ь), " str(a / Ь))
>>> division(5)
5 / 2 2.5
>>> division(5, 3)
5 / 3 1.6666666666666667
>>> division(5, Ь=12)
5 / 12 О.4166666666666667
Пример функции, имеющей два необязательных параметра:
>>> def func(a, Ь=2, с=3):
print( "а =>", str(а), " Ь =>", str(Ь), " с =>", str(с))
>>> func(l)
а => 1 Ь = > 2 с => 3
>>> func(l, 200)
а => 1 Ь => 200 с => 3
Если при вызове функции требуется указать значение не первого из необязательных пара
метров, следует задать значения у всех предшествующих ему необязательных параметров
(хотя бы равные указанным у них значениям по умолчанию)- в противном случае возник
нет ошибка. Например, предположим, что нужно вызвать функцию func(), указав значение
у третьего (второго необязательного) параметра:
>>> func(l, 2, 3456789) # Задаем второй параметр - все работает
а => 1 Ь => 2 с => 3456789
>>> func(l, , 3456789) # Пропускаем второй параметр - получаем ошибку
SyntaxError: invalid syntax
Хотя проще задать нужный-параметр как именованный (если определение функции позво
ляет это):
>>> func(l, с=512)
а => 1 Ь => 2 с => 512
Значение по умолчанию, указанное у необязательного п_араметра, вычисляется только один
раз- при определении функции:
>>> n=2 # Создаем переменную для хранения значения параметра по умолчанию
>>> def division(a, b=n):
print(str(a), " / ", str(b), " = ", str(a / Ь))
Глава 11. Функции 231
»> division(5)
5 / 2 2.5
>>> n=3 # Изменяем значение переменной
»> division(5) # Значение параметра по умолчанию не изменилось
5 / 2 2.5
Если в качестве значения по умолчанию указать значение изменяемого типа, это значение
будет сохраняться между вызовами функции:
>>> def func(a=[]):
a.append(2)
return а
>>> print(func()) # Выведет: [2]
>>> print(func()) # Выведет: [2, 2)
>>> print(func()) # Выведет: [2, 2, 2)
Как видно из примера, значения накапливаются внутри списка. Обойти эту проблему мож
но, например, следующим образом:
>>> def func(a=None):
# Создаем новый список, если значение равно None
if а is None:
а = []
a.append(2)
return а
>>> print(func()) # Выведет: [2]
»> print(func·( [1])) # Выве.!!ет: [1, 2)
>>> print(func()) # Выведет: [2]
11.1.5. Произвольное количество параметров
Наконец, можно определять функции, принимающие произвольное количество параметров.
Для этого в определении функции в составе набора принимаемых параметров следует ука
зать одну из следующих языковых конструкций или сразу обе:
♦ *<Имя параметра> - параметр с заданным именем получит в качестве значения кортеж,
содержащий значения всех переданных функции позиционных параметров;
♦ **<Имя параметра> - параметр с заданным именем получит в качестве значения сло
варь, содержащий значения всех переданных функции именованных параметров. В каче
стве кшочей элементов словаря будут выступать имена параметров.
Примеры:
>>> def funcl(*pars): print(pars)
>>> funcl(l, 2, 3, 4)
(1, 2, 3, 4)
>>> funcl(1, 2, 3, 4, 5, 6, "аЬс")
(1, 2, 3, 4, 5, 6, 'аЬс')
>>> def func2(**pars): print(pars)
232 Часть /. Основы языка Python
>>> func2(a=l, Ь=2, с=3)
{'а': 1, 'Ь': 2, 'с': 3)
>>> func2(a=l, Ь=2, с=3,- i=9, j="def")
{'а': 1, 'Ь': 2, 'с': 3, 'i': 9, 'j': 'def'}
>>> def func3(*parsl, **pars2): print(parsl); print(pars2)
>>> func3(1·, 2, а=3, bcd=4)
(1, 2)
{'а': 3, 'bcd': 4)
>>> func3(5, 6, 7)
(5, 6, 7)
{}
>>> func3(s="a", t="b", v="c")
()
{'s': 'а', 't': 'Ь', 'v': 'с'}
Можно комбинировать упомянутые -языковые конструкции с обычными параметрами, ис
пользовав следующий формат:
def <Имя функции>( [<Строго позиционные параметры>, /, ]
<Двоякие параметры>[,
*<Список позиционных па�аметров>] [,
<Строго именованные параметры>] [,
**<Словарь именованных параметров>])
Пример функции, принимающей один обязательный строго позиционный параметр, один
обязательный двоякий, произвольное количество позиционных параметров, один обяза
тельный строго именованный и произвольное количество именованных:
>>> def func4(a, /, Ь, *с, d, **е):
print(a, Ь, с, d, е)
>>> func4(1, 2, 3, 4, 5, d= 6, е=7, f=8, g=9)
1 2 (3, 4, 5) 6 {'е': 7, 'f': 8, 'g': 9)
>>> func4(1, Ь=2, d=6, е=7)
1 2 () 6 {'е': 7)
>>> func4(1, 2, 3, 4, 5, е=7, f=8, g=9)
. . . Фрагмент пропущен ...
TypeError: func4() missing 1 required keyword-only argument: 'd'
Пример функции, принимающей один необязательный двоякий параметр, произвольное
количество позиционных и один необязательный именованный:
>>> def func5(a=l, *Ь, c=l00): print(a, Ь, с)
>>> func5(1, 2, 3, 4, 5)
1 (2, 3, 4, 5) 100
>>> func5(a= l0, с=20)
10 () 20
>>> func5 ()
1 () 100
Глава 11. Функции 233
11.1.6. Распаковка последовательностей и отображений
Если значения параметров, которые требуется передать в функцию, содержатся в последо
вательности (списке или кортеже) или отображении (словаре), то в вызове функции вместо
параметров можно указать одну из следующих языковых конструкций или сразу обе:
♦ *<Последовательность> - значения элементов заданной последовательности будут
переданы вызываемой функции в качестве позиционных параметров;
♦ **<Отображение> - значения элементов заданного отображения будут переданы вызы
ваемой функции в каче«::тве именованных параметров.
Подобного рода передача в функцию параметров из последовательностей и отображений
называется распаковкой. Ее пример приведен в листинге 11.5.
1 Листи
def summa(a, Ь, с):
return а + Ь + с
seql = [1, 2, 3]
print(summa(.*seql)) # Распаковка списка
seq2 = (2, 3)
print(summa(1, *seq2)) # Можно совмещать указание
·# обычных параметров и распаковку
mpnl = {"а": 1, "Ь": 2, "с": 3)
print(summa(**mpnl)) # Распаковка словаря
seq3, mpn2 = (1, 2), {"с": 3)
print(summa(*seq3, **mpn2)) # Можно совмещать распаковку
# списков и словарей
11.1.7. Функция как значение.
Функции обр�тного вызова
Определение функции (неважно, пользовательской или встроенной) представляет собой
объект, имеющий тип function, т. е. значение. Следовательно, функцию (точнее, ссьmку на
нее) можно присвоить какой-либо переменной, а позже вызвать через эту переменную.
Пример показан в листинге 11.6
Ли
def summa(x, у):
return х + у
f = summa # Сохраняем ссыпку в переменной f
print(f(lO, 20)) # Вызываем функцию через переменную f
Также можно поместить функцию в последовательность или отображение и даже передать
функцию другой функции в качестве параметра (листинг 11.5). Функции,- передаваемые
другим функциям, носят название функций обратного вызова.
234 Часть /. Основы языка Python
def summa(х, у):
return х + у
def func(f, а, Ь):
""" Через переменную f будет доступна ссыпка на
функцию summa() """
return f(а, Ь) # Вызываем функцию summa()
# Передаем ссыпку на функцию в качестве параметра
print(func(summa, 10, 20))
Объекты функций поддерживают множество атрибутов. Например, атрибут _ name_ хра
нит имя функции в виде строки, атрибут _doc_ - строку документирования и т. д. Для
примера выведем имена всех атрибутов функции с помощью встроенной функции dir() :
>>> def summa(x, у):
""" Суммирование двух чисел """
return х + у
»> dir(summa)
[' annotations builtins call class closure
code defaults delattr dict dir
'_doc_', '_eq__', '_foпnat_', '_ge_ _get_
_getattribute_ _globals_ _gt_ hash init
init suЬclass kwdefaults le lt module
name ne new _qualname_ reduce
reduce ех _repr_ setattr sizeof str
suЬclasshook ' ]
>>> summa. name
1
summa'
>>> summa. code .со varnames
('х', 'у')
>>> summa. doc
' Суммирование двух чисел '
11.2. Анонимные функции
Анонимная функция (или лямбда-функция), в отличие от обычной, не имеет имени и поэто
му сразу''fiосле определения должна быть присвоена какой-либо переменной или передана
какой-либо другой функции - в противном случае она будет потеряна. Формат определе
ния анонимной функции:
lamЬda [<Параметр 1>[, . . . , <Параметр N>]]: <Возвращаемый результат>
Пример использования анонимных функций приведен в листинге 11.8.
fl lamЬda: 10 + 20 # Функция без параметров
f2 = lamЬda х, у: х + у # Функция с двумя параметрами
Глава 11. Функции 235
fЗ = lamЬda х, у, z: х +у+ z # Функция с тремя параметрами
print (fl ()) # Выведет: 30
print(f2(5, 10)) # Выведет: 15
print(f3(5, 10, 30)) # Выведет: 45
Анонимные функции могут иметь необязательные параметры (листинг 11.17).
1 Листи
f = lamЬda х, у=2: х+ у
print(f(5)) # Выведет: 7
print(f(5, 6)) # Выведет: · 11
Чаще всего анонимные функции используют в качестве функций обратного вызова
(см. разд. 11. 6. 7). Например, метод списков sort() позволяет указать пользовательскую
функцию в параметре key. Отсортируем список без учета регистра символов, указав в каче
стве параметра анонимную функцию (листинг 11.10).
arr = ["единицаl", "Единый", "Единица2"]
arr.sort(key=lamЬda s: s .lower())
for i in arr:
print(i, end=" ")
# Результат вьпюлнения: единицаl Единица2 Единый
При указании глобальной переменной внутри анонимной функции будет сохранена ссьmка
на эту переменную, а не ее значение в момент определения функции:
>>> х = 5
>>> func = lamЬda: х # Сохраняется ссылка, а не значение переменной х! ! !
>>> х = 80 # Изменили значение
>>> print(func()) # Выведет: 80, а не 5
Если необходимо сохранить именно текущее значение глобальной переменной, можно вос
пользоваться следующим способом:
>>> х = 5
>>> func = (lamЬda у: lamЬda: у)(х) # Сохраняется значение переменной х
>>> х = 80 # Изменили значение
>>> print(func()) # Выведет: 5
Во второй строке кода мы определили анонимную функцию с одним параметром, возвра
щающую ссылку на вложенную анонимную функцию. Далее мы вызываем первую функ
цию с помощью круглых скобок и передаем ей значение переменной х. В результате сохра
няется текущее значение переменной, а не ссьmка на нее.
Сохранить текущее значение глобальной переменной также можно, указав эту переменную
в качестве значения параметра по умолчанию:
>>> х "' 5
>>> func = lamЬda х=х: х # Сохраняется значение переменной х
>>> х = 80 # Изменили значение
>>> print(func()) # Выведет: 5
236 Часть /. Основы языка Python
11.3. Функции-генераторы
Функция-генератор при последовательных вызовах возвращает один за другим элементы
какой-либо последовательности. Для возврата элемента в таких функциях применяется язы
ковая конструкция формата:
yield <Возвращаемый элемент>
Напишем функцию, которая генерирует диапазон из заданного количества чисел и последо
вательно возвращает его элементы, возведенные в заданную степень (листинг 11.11).
def func(х, у):
for i in range(l, x+l):
yield i ** у
for n in func(l0, 2):
print(n, end=" ") # Выведет: 1 4 9 16 25 36 49 64 81 100
print() # Вставляем пустую строку
for n in func(l0, 3):
print(-n, end=" ") # Выведет: 1 8 27 64 125 216 343 512 729 1000
Функции-генераторы поддерживают метод _next_(), выдающий следующее значение из
последовательности. Когда значения заканчиваются, метод генерирует исключение
Stopiteration. Метод _next_() автоматически вызывается в цикле перебора последова
тельности. Для примера перепишем предыдущую программу, использовав метод _next_()
вместо цикла (листинг 11.12).
def func(x, у):
for i in range(l, x+l):
yield i ** у
i func(3, 3)
print(i. next ()) # Выведет: 1 (1 ** 3)
print(i. next ()) # Выведет: 8 (2 ** 3)
print(i. next () ) # Выведет: 27 (3 ** 3)
print(i. next () ) # Исключение Stopiteration
Существует возможность вызвать одну функцию-генератор из другой. Для этого применя
ется языковая конструкция формата:
yield from <ВЫзываемая функция-генератор>
Предположим, у нас есть список чисел, и нам требуется получить другой список, вклю
чающий числа в диапазоне от 1 до каждого из чисел в первом списке. Чтобы создать такой
список, напишем код, показанный в листинге 11.13.
Глава 11. Функции 237
def gen(l):
for е in 1:
yield from range(l, е + 1)
1 = (5, 10]
for i in gen([5, 10]): print(i, end =" ")
Здесь мы в функции-генераторе gen() перебираем переданный ей в качестве параметра спи
сок и для каждого его элемента вызываем другую функцmо-генератор. В качестве послед
ней выступает выражение, создающее диапазон от 1 до значения очередного элемента, уве
личенного на единицу (чтобы это значение вошло в диапазон). В результате на выходе мы
получим вполне ожидаемый результат:
1 2 3 4 5 1 2 3 4 5 6 7 В 9 10
Усложним задачу, включив в результирующий список числа, умноженные на 2. Код, вы
полняюший эту задачу, показан в листинге 11.14.
1 Листинr·11.1
def gen2(n):
for е in range(l, n + 1):
yield е * 2
def gen(l):
for е in 1:
yield from gen2(e)
1 = (5, 10]
for i in gen([5, 10]): print(i, end =" ")
Здесь мы вызываем из функции-генератора gen() функцmо-генератор gen2(). Последняя
создает диапазон, перебирает все входящие в него числа и возвращает их умноженными
на 2. Результат работы приведенного в листинге кода таков:
2 4 6 В 10 2 4 6 В 10 12 14 16 18 20
Функции-генераторы пригодятся при обработке большого количества значений, поскольку
не понадобится загружать весь список с исходными значениями в память.
11.4. Декораторы функций
Декоратор - это функция, изменяющая поведение другой функции (например, произво
дящая какие-либо действия перед ее выполнением). Функция-декоратор должна принимать
в качестве параметра ссылку на функцmо, поведение которой необходимо изменить, и воз
вращать ссылку на ту же функцmо или какую-либо другую.
Вызов декоратора записывается непосредственно перед определением изменяемой функции
в формате:
@<Имя декоратора>
Круглые скобки у декоратора указывать не нужно.
238 Часть /. Основы языка Python
Пример использования декоратора показан в листинге 11.15.
def deco(f): # Функция-декоратор
рrint("Вызвана функция func()")
return f # Возвращаем ссылку на функцию
@deco
def func (х) :
return "х {0}".format(x)
print(func(10))
Результат выполнения этого примера:
Вызвана функция func()
х = 10
Приведенный пример эквивалентен коду, показанному в листинге 11.16.
def deco(f):
рrint("Вызвана функция func()")
return f
def func(х):
return "х = {0}".format(x)
# Вызываем функцию func(} через функцию deco()
print(deco(func)(10))
У определения изменяемой функции можно указать сразу несколько декораторов. Для при
мера укажем у функции func() два декоратора: decol () и deco2( J (листинг 11.17).
1 Листииr 11.11. У� .,.скоnысихдекоJ)8ТОJЮ8
def decol (f) :
рrint("Вызвана функция decol()")
return f
def deco2 (f) :
рrint("Вызвана функция deco2()")
return f
@decol
@deco2
def func(х):
return "х {0}".format(x)
print ( func(10))
Глава 11. Функции 239
Вот что мы увидим после выполнения примера:
Вызвана функция deco2()
Вызвана функция decol()
х = 10
Использование двух декораторов эквивалентно следующему коду:
func = decol(deco2(func))
Здесь сначала будет вызвана функция deco2(), а затем функция decol (). Результат выпол
нения будет присвоен идентификатору func.
В качестве еще одного примера использования декораторов рассмотрим выполнение функ
ции только при правильно введенном пароле (листинг 11.18).
1 Листинr 11.18. Оrраничение доступа с помощ1�1�одек��
passw = inрut("Введите пароль: ")
def teqt_passw(p):
def deco(f):
if р == "10": # Сравниваем пароли
return f
else:
return lamЬda: "Доступ закрыт"
return deco # Возвращаем функцию-декоратор
@test_passw(passw)
def func():
return "Доступ открыт"
print(func()) # Вызываем функцию
Здесь после символа @ указана не ссылка на функцmо, а выражение, возвращающее декора
тор. Иными словами, декоратором здесь служит не функция test_passw(), а результат ее
выполнения (функция deco()). Если введенный пароль является правильным, то выполнит
ся функция func(), в противном случае будет выведена надпись "Доступ закрыт", которую
вернет анонимная функция.
11.5. Рекурсия
Рекурсия - это вызов функцией самой себя. Рекурсmо удобно использовать для перебора
объекта с неизвестной структурой или для выполнения неопределенного количества опера
ций. Для примера рассмотрим вычисление факториала (листинг 11.19).
1 листи,�r 11.19. ВычисnеНме фalC1'0pAana
def factorial(n):
if n == О or n == 1: return 1
else:
return n * factorial(n - 1)
240 Часть /. Основы языка Python
while True:
х = input( "Введите число: ")
if x.isdigit(): # Если строка содержит только цифры
х = iлt(х) # Преобразуем строку в число
break # Выходим из цикла
else:
print("Bы ввели не число!")
рrint("Факториал числа {О)= {1}" .format(x, factorial(x)))
Впрочем, для вычисления факториала лучше воспользоваться функцией factorial() из
модуля math (см. разд. 5.3).
Количество вызовов функции самой себя (проходов рекурсии) оrраничено. Узнать его мож
но, вызвав функцmо getrecursionlimit() из модуля sys:
>>> import sys
>>> sys.getrecursionlimit()
1000
При превышении допустимого количества проходов рекурсии будет возбуждено исключе
ние RecursionError.
11.6. Вложенные функции
Вложенная функция - это функция, определенная в теле другой функции (родительской)
Вложенная функция может создавать свои собственные локальные переменные и имеет
доступ к локальным переменным, созданным в родительской функции. Рассмотрим пример
из листинга 11.20.
def funcl (х):
def func2():
print(x)
return func2
f1 funcl (10)
f2 funcl(99)
f1 () # Выведет: 10
f2() # Выведет: 99
Здесь мы определили функцmо funcl (), принимающую один параметр, а внутри нее -
вложенную функцmо func2(). Результатом выполнения функции funcl () станет ссьmка на
эту вложенную функцmо. Внутри функции func2() мы производим вывод значения пере
менной х, созданной в функции funcl().
Следует учитывать, что в момент определения функции сохраняются ссылки на перемен
ные, а не их значения. Например, если после определения функции func2() произвести из
менение переменной х, то будет использоваться это новое значение (листинг 11.21).
Глава 11. Функции 241
def funcl (х):
def func2():
print (х)
х = 30
return func2
f1 = funcl (10)
f2 = funcl (99)
f1 () # Выведет: 30
f2() # Выведет: 30
Обратите внимание на результат выполнения - в обоих случаях мы получили значение 30.
Если при определ_ении вложенной функции необходимо сохранить именно значение пере
менной, следует указать его как значение по умолчанию (листинг 11.22).
def funcl (х) :
def func2(x=x): # Сохраняем текущее значение, а не ссыпку
print (х)
х = 30
return func2
f1 funcl (10)
f2 funcl (99')
f1 () ,# Выведет: 10
f2() # Выведет: 99
Теперь попробуем из вложенной функции func2() изменить значение переменной х, соз
данной внутри функции func1 (). Если внутри функции func2() присвоить значение пере
менной х, будет создана новая локальная переменная с таким же именем. Если внутри
функции func2() объявить переменную как глобальную и присвоить ей значение, то изме
нится значение глобальной переменной, а не значение переменной х из функции funcl ().
Таким образом, ни один из изученных ранее способов не позволяет из вложенной функции
изменить значение локальной переменной из родительской функции.
Решить эту проблему можно, объявив необходимые переменные с помощью языковой кон
струкции формата:
nonlocal <Имена переменных через запятую>
Пример показан в листинге 11.23.
def funcl (а):
х = а
def func2(Ь):
nonlocal х # Объявляем переменную как nonlocal
242 Часть /. Основы языка Python
print(x)
х = ь # Можем изменить значение х в funcl()
return func2
f = funcl (10)
f(S) # Выведет: 10
f(12) # Выведет: 5
f(З) # Выведет: 12
При использовании языковой конструкции nonlocal следует помнить, что переменная обя
зательно должна существовать внутри функции-родителя. В противном случае будет выве
дено сообщение об ошибке.
11.7. Аннотации функций
Аннотация- это описание назначения параметров функции, их типов и типа возвращаемо
го результата, которое записывается в определении функции. Аннотации имеют следующий
формат:
def <Имя функции>(
[<Параметр 1> [: <Описание параметра>] [= <Значение по умолчанию>]
[, . . . ,
<Параметр N> [: <Описание параметра>] [= <Значение по умолчанию>] ] ]
) -> <Описание возвращаемого результата>:
<Тело функции>
В качестве описаний параметров и возвращаемого результата обычно указываются строки
(хотя можно задать любое выражение языка Python, которое будет выполнено при создании
функции). Пример:
>>> def func(a: "Выводимое значение 1", Ь: "Выводимое значение 2" = 3) -> None:
print(a, Ь)
У параметра а задано описание "Выводимое значение 1", у параметра Ь- "Выводимое зна
чение 2" (число з - это значение параметра ь по умолчанию). После закрывающей круглой
скобки указан тип возвращаемого функцией результата: None (т. е. результата функция не
возвращает).
Аннотация функции сохраняется в виде словаря в атрибуте _annotations_ ее объекта.
Выведем значение этого атрибута:
>>> func. annotations
{ 'а': 'Выводимое значение 1', 'Ь': 'Выводимое значение 2', 'return' : None}
ГЛАВА 12
Модули, пакеты и импорт
Модуль-это любой файл с программным кодом. Любой модуль может использовать иден
тификаторы (переменные, функции и классы, о которых речь пойдет в главе 13), созданные
в другом модуле, выполнив процедуру подключения, или импорта, последнего.
В составе интерпретатора Python поставляется большой набор модулей, содержащих полез
ные переменные, функции и классы. Эти модули называются встроенными, а их совокуп
ность - стандартной библиотекой языка.
ПРИМЕЧАНИЕ
Модули можно создавать не только на самом Python, но и на языке С++, компилируя их
в машинный код. В стандартной библиотеке содержится ряд таких модулей.
Модуль Python представляется особым объектом, содержащим ряд атрибутов. Так, атрибут
_name_ содержит имя модуля в виде строки. У модуля, непосредственно запущенного на
исполнение, этот атрибут хранит строку "_main_". Пример:
print( name # Выведет: main
Проверить, является модуль непосредственно запущенным (главным модулем, или главной
программой) или импортированным, позволяет следующий код:
if name main
print(".Это главная программа")
else:
рrint("Импортированный модуль")
12.1. Импорт модуля целиком
Можно импортировать модуль целиком и использовать любые созданные в' нем перемен
ные, функции и классы. Для этого предназначена языковая конструкция следующего фор
мата:
import <Модуль 1> [as <Псевдоним 1>],
<Модуль N> [as <Псевдоним N>]
Имя модуля не должно содержать расширения и пути к файлу, а также удовлетворять всем
требованиям, предъявляемым к именам переменных (см.разд. 2.1). Дело в том, что при им-
244 Часть /. Основы языка Python
порте модуля интерпретатор создает переменную, которой присваивает объект импортиро
ванного модуля.
Все идентификаторы, созданные в импортированном модуле, доступны через атрибуты
объекта этого модуля (атрибут- это переменная, входящая в состав объекта). Для доступа
к атрибутам следует использовать такой синтаксис:
<Переменная с объектом модуля>.<Атрибут с нужным идентификатором>
Поскольку переменная с объектом модуля и атрибут отделяются друг от друга точкой, такая
запись получила название точечной нотации.
Для примера импортируем модуль time и получим текущую дату вызовом функции
strftime (), определенной в этом модуле:
import time
print(time.strftime("%d.%m.%Y"))
Подюпочим сразу два модуля: time и math:
import time, math
print(time.strftime("%d.%m.%Y"))
print(math .pi) # Число п
Функция getattr() позволяет получить значение. атрибута с заданным в виде строки име
нем, принадлежащего указанному модуmо. С помощью этой функции можно сформировать
имя нужного атрибута программно. Формат функции:
getattr(<Oбъeкт модуля>, <Имя атрибута>[, <Значение по умолчанию>])
Если указанный атрибут не нацден, возвращается заданное значение по умолчанию, а если
оно не указано- возбуждается искmочение AttributeError. Пример:
import math
print(getattr(math, "pi")) # Будет выведено число п
print(getattr(math, "х", 50)) # Будет выведено 50, т. к. х не существует
Проверить существование атрибута с заданным именем в указанном модуле позволяет
функция hasattr(<Модуль>, <Имя атрибута>). Если атрибут существует, функция возвра
щает значение тrue, в противном случае - False. Напишем функцию проверки существо
вания атрибута в модуле,mаth (листинг 12.1).
import math
def hasattr_math(attr):
if hasattr(math, attr):
return "Атрибут существует"
else:
return "Атрибут не существует"
print(hasattr_math("pi")) # Атрибут существует
print(hasattr_math("x")) # Атрибут не существует
Если имя модуля слишком длинное и его неудобно указывать каждый раз для доступа
к атрибутам, то можно дать модуmо псевдоним. После чего для доступа к модуmо следует
Глава 12. Модули, пакеты и импорт 245
использовать искmочительно указанный псевдоним (при попытке доступа по имени модуля
возникнет ошибка). Дадим модуто math псевдоним m:
import math as m
print(m.pi)
Идентификаторы, содержащиеся в импортированном модуле, не смешиваются с идентифи
каторами, созданными в импортирующем модуле. Это значит, что, например, в импорти
руемом и импортирующем модулях могут содержаться совершенно разные переменные
с одинаковым именем х.
Проиллюстрируем это примером. Создадим модуль test.py, в котором определим перемен
ную х (листинг 12.2).
х = 50
В главной программе также определим переменную х, но с другим значением. Затем под
кточим модуль test.py и выведем значения переменных (листинг 12.3).
import test # Подключаем файл test.py
х = 22
print(test.x) # Значение переменной х внутри модуля
print(x) # Значение переменной х в главной программе
input()
Оба модуля размещаем в одном каталоге и запускаем модуль с главной программой. Про
грамма выведет числа 50 и 22 - значения переменных с именем х, хранящихся в разных
модулях. Как видно из результата, одноименные переменные из разных модулей никак не
конфликтуют друг с другом.
Объект каждого импортированного модуля заносится в словарь modules из модуля sys. При
попытке импорта модуля сначала проверяется, есть ли этот модуль в упомянутом словаре,
и если он там есть, повторный импорт выполнен не будет.
Выведем кmочи словаря modules, предварительно отсортировав их (листинг 12.4).
import test, sys # Подключаем модули test и sys
print(sorted(sys.modules.keys()))
input()
Инструкция импорта требует явного указания объекта модуля. Задать имя модуля в виде
строки нельзя.
Чтобы подкmочить модуль, имя которого формируется программно, следует воспользовать
ся функцией _import_( <Имя модуля>) . Функция возвращает объект импортированного
модуля. Для примера импортируем модуль test.py с помощью функции _import_() (лис
тинг 12.5).
246 Часть /. Основы языка Python
лмстмнr 12.5. Использование функции
s = "tes" + "t" # динамическое создание имени модуля
m = import (s) # Подключение модуля test
print(m.x) # Вывод значения атрибута х
input()
Получить список всех идентификаторов, созданных в указанном модуле, позволяет функ
ция dir(<Объект модуля>). Еще можно воспользоваться словарем из .атрибута _ dict_
объекта модуля, который содержит все идентификаторы и их значения (листинг 12.6).
1 riистинr 12.6. Вывод списка всех идентифиtа;!rоров
import test
print(dir(test))
print(sorted(test. dict .keys()))
input()
ПРИМЕЧАНИЕ
При импорте модуля он всегда компилируется (о компиляции рассказывалось в разд. 1. 10).
12.2. Импорт отдельных идентификаторов
Также можно импортировать из модуля только отдельные идентификаторы, нужные для
работы. Для этого применяется языковая конструкция, записываемая в одном из следующих
форматов:
from <Модуль> import <Идентификатор 1> [as <Псевдоним 1>],
<Идентификатор N> [as <Псевдоним N>]
from <Модуль> import (<Идентификатор 1> [as <Псевдоним 1>],
<Идентификатор N> [as <Псевдоним N>])
from <Модуль> import *
Первые два формата импортируют из указанного модуля только заданные идентификаторы.
Длинным идентификаторам можно назначить псевдонимы. В качестве примера импортиру
ем из модуля math константу pi и функцmо floor(), дав последней псевдоним f (лис
тинг 12.7).
Листинr 12.7. Имnор-,: отдельных мдентифике;торов,
from math import pi, floor as f
print(pi) # Вывод числа п
# Вызываем функцию floor() через идентификатор f
print(f(S.49)) # Выведет: 5
input()
Второй формат инструкции импорта позволяет разбить слишком длинный перечень импор
тируемых идентификаторов на несколько строк:
Глава 12. Модули, пакеты и импорт 247
from math import (pi, floor,
sin, cos)
Третий формат импортирует из модуля все идентификаторы. Для примера импортируем все
идентификаторы из модуля math (листинг 12.8).
1 ЛистиНr 12:8; Имnoi,r всех иден:тифl.кат�ров И3 модуl1Я
from math import * # Импортируем все идентификаторы из модуля math
print(pi) # Выводим число п
print(floor(S.49)) # Вызываем функцию floor()
input()
Однако в этом случае идентификаторы, импортированные из модуля, смешаются с иденти
фикаторами из импортирующего модуля. Например, если импортировать из модуля пере
менную s, а потом попытаться создать в импортирующем модуле переменную с таким же
именем, произойдет перезапись значения импортированной переменной s. То же самое
произойдет, если импортировать одноименную переменную из двух разных модулей, -
при импорте переменной из второго модуля будет перезаписано значение переменной из
первого модуля.
Для примера создадим два модуля, содержащих переменные с одинаковым именем s и раз
ными значениями, и подключим их с помощью разных инструкций. Содержимое первого
модуля, с именем module1 .ру, приведено в листинге 12.9.
/ Листинr 12.t. Содержимое фа� nцюui.1.py
s = "Значение из модуля modulel"
Содержимое второго модуля, module2.py, приведено в листинге 12.10.
/ Листин( 12.10. Содержимое фaina riiodule2.py
s = "Значение из модуля module2"
Код главной программы показан в листинге 12.11.
/ Листмнr 12.11. 1{()д rnавной nроrрам"ы
from modulel import *
from module2 import *
import modulel, module2
print(s) # ·выведет: "Значение из модуля module2"
print(modulel. s) # Выведет: "Значение из модуля modulel"
print(module2.s) # Выведет: "Значение из модуля module2"
input()
Размещаем все три модуля в одном каталоге, запускаем модуль с главной программой и
смотрим на результат...
...согласно которому, переменная s получила значение из модуля module2.py, который был
импортирован последним. Это довольно опасная ситуация, чреватая возникновением труд-
248 Часть /. Основы языка Python
но выявляемых ошибок. Однако получить доступ к переменным s из разных модулей все
таки можно - импортировав эти модули целиком (см.разд. 12. 1).
12.2.1. Указание идентификаторов, доступных для импорта
По умолчанию все идентификаторы, определенные в модуле, доступны для импорта в дру
гих модулях. Исключение составляют лишь идентификаторы, начинающиеся со знака под
черкивания, - их импортировать нельзя.
Однако можно явно задать перечень идентификаторов, доступнь1х для импорта (идентифи
каторы, не указанные в перечне, не будут импортироваться). Для этого следует в коде мо
дуля занести в переменную _all_ список таких идентификаторов, представленных в виде
строк. Интересно, что таким образом можно сделать доступными для импорта даже иден
тификаторы, начинающиеся с подчеркивания.
Для примера создадим модуль moduleЗ.py с множеством переменных и разрешим другим
модулям импортировать только две из них (листинг 12.12).
х, у, z, _s = 10, 80, 22, "Строка"
all = ["х", "_s"]
Затем напишем главную программу, которая будет его импортировать (листинг 12.13).
from moduleЗ import *
print(sorted(vars() .keys())) # Получаем список всех идентификаторов
input()
Главная программа выдаст следующий результат:
[' annotations builtins doc file loader
name _package_ _spec_', '_s', 'х']
Бьши импортированы только переменнь1е _s и х. Если бы мы не указали идентификаторы
внутри списка _all_, результат бьш бы другим:
[' annotations builtins doc file loader
'_name_', ' __package_', '_spec_', 'х', 'у', 'z']
Обратите внимание на то, что переменная _s в этом случае не импортируется, поскольку ее
имя начинается с символа подчеркивания.
12.2.2. Управление доступом к идентификаторам
В Python 3.7 появилась возможность управлять доступом к идентификаторам, определен
нь1м в импортируемом модуле. В частности; можно при попытке получить из импортирую
щего модуля доступ к какому-либо несуществующему идентификатору выдать значение
другого, существующего, идентификатора или даже результат вычисления какого-либо
выражения.
Глава 12. Модули, пакеты и импорт 249
Чтобы реализовать управление доступом к идентификаторам, в модуле следует определить
специальную функцию (функцию, вызываемую самим интерпретатором в определенные мо
менты времени) с именем _getattr_(). Она должна принимать в качестве единственного
параметра имя идентификатора, к которому импортирующий модуль пытается получить
доступ, и либо возвращать какое-либо значение, либо, если такой идентификатор не должен
поддерживаться, генерировать исюпочение AttributeError.
Также в модуле можно определить специальную функцmо _dir_(). Она не должна при
нимать параметров и должна возвращать последовательность с именами идентификаторов,
доступных извне текущего модуля.
В качестве примера создадим модуль module4.py с кодом из листинга 12.14.
def _getattr_(name):
# При попытке обратиться к переменной с вьщаем значение переменной d.
# При обращении к другим переменным генерируем исключение.
if name == "с":
return d
else:
raise AttributeError
def dir ():
return ("а", "Ь", "d")
а = 10
Ь 20
d 10000
Код главной программы приведен в листинге 12.15.
j
import module4
print(module4. dir ()) # Выведет: ('а', 'Ь', 'd')
print(module4.a) # Выведет: 10
print(module4.b) # Выведет: 20
print(module4.c) # Выведет: 10000
12.3. Пути поиска модулей
Получить список файловых путей, по которым интерпретатор Python будет искать импор
тируемые модули, можно из переменной path, которая создана в модуле sys:
>>> import sys
>>> sys.path
Список из переменной path содержит следующие пути:
♦ путь к папке с файлом главной программы или, если интерпретатор работает в интерак
тивном режиме, пустая строка;
250 Часть /. Основы языка Python
♦ значение переменной окружения РУТНОNРАТН. Для создания этой переменной в меmо
Пуск выбираем пункт Панель управления (или Настройка I Панель управления).
В открывшемся окне выбираем пункт Система и щелкаем на ссьmке Дополнительные
параметры системы. Переходим на вкладку Дополнительно и нажимаем кнопку Пе
ременные среды. В разделе Переменные среды пользователя нажимаем кнопку Соз
дать. В поле Имя переменной вводим PYTHONPATH, а в ,поле Значение переменной зада
ем пути к папкам с модулями через точку с запятой - например, с: \folderl;
с:\folder2. Закончив, не забудем нажать кнопки ОК обоих открытых окон. После этого
изменения перезагружать компьютер не нужно, достаточно перезапустить программу;
♦ пути поиска стандартных модулей;
♦ содержимое файлов с расширением pth, расположенных в каталогах поиска стандартных
модулей, - например, в каталоге C:\Python310\Lib\site-packages. Названия таких файлов
могут быть произвольными, главное, чтобы они имели расширение pth. Каждый путь
(абсолютный или относительный) должен быть расположен на отдельной строке.
Для примера создайте файл mypath.pth в каталоге C:\Python310\Lib\site-packages со сле
дующим содержимым:
# Это комментарий
С:\folderl
С: \folder2
ПРИМЕЧАНИЕ
Обратите внимание на то, что каталоги должны существовать, в противном случае они не
будут добавлены в список sys.path.
При поиске модуля список sys.path просматривается от начала к концу. Поцск прекраща
ется после первого найденного модуля. Таким образом, если в каталогах C:\folder1 и
C:\folder2 существуют одноименные модули, то будет использоваться модуль из папки
C:\folder1, поскольку он расположен первым в списке путей поиска.
Список sys.path можно изменять программно с помощью соответствующих методов.
Например, добавить каталог в конец списка можно с помощью метода append() , а в его на
чало - с помощью метода insert() (листинг 12.16).
Листинr 12.16. Изменение спЙска путей поиска�"'!"
import sys
sys.path.append(r"C:\folderl") # Добавляем в конец списка
sys.path.insert(O, r"C:\folder2") # Добавляем в начало списка
print(sys.path)
input ()
В этом примере мы добавили папку C:\folder2 в начало списка. Теперь, если в каталогах
C:\folder1 и C:\folder2 существуют одноименные модули, будет использоваться модуль из
папки C:\folder2, а не из папки C:\folder1, как в предыдущем примере.
Также можно указать полностью свои пути для поиска модулей, при этом список, храня
щийся в переменной sys.path, будет проигнорирован. Для этого достаточно поместить
в папку, где установлен Python, файл с именем python<nepвыe два числа из номера версии
Python>._pth (так, для Python 3.10 этот файл должен иметь имя python310._pth) или
python._pth, в котором записать все нужные пути в том же формате, который используется
Глава 12. Модули, пакеты и импорт 251
при создании файлов pth. Первый файл будет использоваться программами, вызывающими
библиотеку времени выполнения Python, в частности IDLE Shell. А второй файл будет счи
тан при запуске Руthоn-программы щелчком мыши на ее файле.
ВНИМАНИЕ!
В файл руthоп<первые два числа из номера версии Python>._pth обязательно следует вклю
чить пути для поиска модулей, составляющих стандартную библиотеку Python (их можно
получить из списка, хранящегося в переменной sys.path). Если этого не сделать, утилита
IDLE Shell вообще не запустится.
12.4. Перезагрузка модулей
При первой операции импорта модуль загружается в оперативную память. При последую
щих попытках импортировать тот же модуль ничего не произойдет. Если же требуется
выполнить повторный импорт (перезагрузку) импортированного ранее модуля, следует вос
пользоваться функцией reload(<Модуль>) из модуля importlib.
В качестве примера создадим модуль test2.py, поместив его в папку C:\book (листинг 12.17).
1 . ... .
1 Листинг 12.:17. Содержимое "49дYIU1 test2.py
х = 150
Подключим этот модуль и выведем текушее значение переменной х:
>>> import sys
>>> sys.path.append(r"C:\book") # Добавляем путь к папке с модулем
>>> import test2 # Подключаем модуль test2.ру
>>> print(test2.x) # Выводим текущее значение
150
Не закрывая окна интерпретатора, изменим значение переменной х на 800, а затем попробу
ем заново импортировать модуль и вывести текущее значение переменной:
>>>#Изменяем значение в модуле на 800
>>> import test2
>>> print(test2.x) # Значение не изменилось
150
Как видно из примера, значение переменной х не изменилось. Теперь перезагрузим модуль
с помощью функции reload() :
>>> from importlib import reload
>>> reload(test2) # Перезагружаем модуль
<module 'test2' from 'C:\book\test2.py'>
>>> print(test2.х) # Значение изменилось
800
Следует учитывать, что идентификаторы, импортированные с помощью языковой конст
рукции from (см. разд. 12.2}, перезагружены не будут. Кроме того, не перезагружаются
скомпилированные модули, написанные на других языках программирования (например,
на С).
252 Часть /. Основы языка Python
12.5. Пакеты
Пакет- это обычный каталог, содержащий модули и обязательный файл инициализации
_init_.py. Последний может быть пустым или содержать код, который будет выполнен при
первой операции импорта любого модуля из этого пакета.
Чтобы импортировать модуль, находящийся в па.кете, надо записать путь к этому модулю,
разделяя имена пакетов и самого модуля точками. Например, чтобы импортировать модуль
module2.py из пакета folder1\folder2, следует записать инструкцию:
import folderl.folder2.module2
Правда, переменная, создаваемая интерпретатором для хранения объекта импортированно
го модуля, получит имя, совпадающее с указанным путем к модулю:
folderl.folder2.module.func()
Поэтому для упрощения доступа к созданным в таком модуле идентификаторам рекоменду
ется задавать у модуля псевдоним:
import folderl.folder2.module2 as mod
mod.func()
или импортировать только нужные идентификаторы:
from folderl.folder2.module import func
func()
Также можно импортировать модуль из пакета, записав языковую конструкцию формата:
from <Путь к пакету> import <Модуль>[ as <Псевдоним>]
Например:
from folderl.folder2 import module
module.func ()
В качестве примера создадим следующую структуру каталогов и файлов:
main.py # Файл с главной программой
folderl\ # Каталог на одном уровне вложенности с main.py
init .ру # Файл инициализации
modulel.py # Модуль folderl\modulel.py
folder2\ # Вложенный каталог
init .ру # Файл инициализации
module2.py # Модуль folderl\folder2\module2.py
moduleЗ.py # Модуль folderl\folder2\module3.py
Содержимое файлов _init_.py приведено в листинге 12.18.
print(" init из", name
Содержимое модулей module1 .ру, module2.py и moduleЗ.py приведено в листинге 12.19.
msg = "Модуль {О} " .format ( name
Глава 12. Модули, пакеты и импорт 253
Теперь импортируем эти модули в главном модуле main.py и получим значение переменной
rnsg разными способами. Содержимое модуля main.py приведено в листинге 12.20.
# Доступ к модулю folderl\rnodulel.py
irnport folderl.rnodulel as rnl # Выведет: init из folderl
?rint (rnl.rnsg) # Выведет: Модуль folderl.rnodulel
frorn folderl irnport rnodulel as rn2
print(rn2.rnsg) # Выведет: Модуль folderl.rnodulel
frorn folderl.rnodulel irnport rnsg
?rint(rnsg) # Выведет: Модуль folderl.rnodulel
# Доступ к модулю folderl\folder2\rnodule2.py
irnport folderl.folder2.rnodule2 as mЗ # Выведет: init из folderl.folder2
print(rnЗ.rnsg) # Быведет: Модуль folderl.folder2.rnodule2
frorn folderl.folder2 irnport rnodule2 as rn4
print(rn4 .rnзg) # Выведет: Модуль folderl.folder2.rnodule2
frorn folderl.folder2.rnodule2 irnport rnsg
print(rnsg) # Выведет: Модуль folderl.folder2 .rnodule2
input()
Инструкция импорта из пакета также позволяет импортировать сразу несколько модулей.
Для этого внутри файла инициализации _init_.py в переменной _all_ следует указать
список с именами импортируемых модулей. В качестве примера изменим содержимое файла
_init_.py из каталога folder1\folder2\ на следующее:
all = ["rnodule2", "rnoduleЗ"J
Теперь создадим модуль main2.py (листинг 12.21) и запустим его.
frorn folderl.folder2 irnport *
print(rnodule2.rnsg) # Выведет: Модуль folderl.folder2.rnodule2
?rint(rnoduleЗ.rnsg) # Выведет: Модуль folderl.folder2.rnodule3
input()
Здесь после ключевого слова frorn указывается лишь путь к пакету без имени модуля. В ре
зультате будут импортированы все модули, указанные в списке _:_ан_.
Чтобы импортировать модуль, расположенный в том же каталоге, что и импортирующий
модуль, перед именем модуля указывается точка, например:
frorn .rnodule irnport *
или
frorn . irnport rnodule
Чтобы импортировать модуль, расположенный в родительском каталоге, перед именем мо
дуля указываются две точки:
frorn ..rnodule irnport *
254 Часть /. Основы языка Python
или
from .. import module
Если необходимо обратиться уровнем еще выше, то указываются три точки:
from ...module import *
или
from ... import module
Для примера создадим в каталоге C:\folder1\folder2\ модуль module4.py, чей код показан
в листинге 12.22.
1 Листинr 12.22. Содержимое модуля m9Clule4.py
# Импорт модуля module2.py из текущего каталога
from . import module2 as ml
varl = "Значение из: {0}".format(ml.msg)
from .module2 import msg as m2
var2 = "Значение из: {0}".format(m2)
# Импорт модуля modulel.py из родительского каталога
from ... import modulel as mЗ
varЗ = "Значение из: {О}".format(mЗ.msg)
from ..modulel import msg as m4
var4 = "Значение из: {О}".format (m4)
Теперь создадим модуль mainЗ.py (листинг 12.23) и запустим его на выполнение.
1 Лисrинr 12.23. Содержимое модуля m,�lnЗ.py
from folderl.folder2 import module4 as m
print(m. varl) # Значение из: Модуль folderl.folder2.module2
print(m.var2) # Значение из: Модуль folderl.folder2.module2
print(m.varЗ) # Значение из: Модуль folderl.modulel
piint(m.var4) # Значение из: Модуль folderl.modulel
input()
Следует помнить очень важную вещь. Если при запуске Руthоn-программы в список
sys.path автоматически добавляется путь к каталогу с запущенным файлом, то при относи
тельном импорте внутри пакета этого не происходит. Для примера изменим содержимое
модуля module4.py на следующее:
import module2 # Ошибка! Поиск модуля по абсолютному пути
varl = "Значение из: {0}".format(module2.msg)
var2 = varЗ = var4 = О
Здесь мы пытаемся импортировать из модуля module4.py модуль module2.py, находящийся
в том же пакете. Однако раз путь к импортирующему модулю (и, соответственно, к содер
жащему его пакету) не был добавлен в его список sys .path, интерпретатор не найдет тре-
Глава 12. Модули, пакеты и импорт 255
буемый модуль и выдаст ошибку. А если по одному из путей поиска модулей находится
модуль с таким же именем, то он и будет импортирован и программа станет работать не так,
как нужно (и, скорее всего, «вылетит» с ошибкой).
Чтобы импортировать модуль из того же пакета, следует использовать такую инструкцию:
from . import module2
или указать полный путь относительно каталога, в котором находится главный модуль:
import folderl.folder2.module2 as module2
ГЛАВА 13
Объекты и классы
Объект - это сложная структура, хранящая множество каких-либо значений и содержащая
инструменты для их обработки. Отдельные значения хранятся в атрибутах - переменных,
входящих в состав объекта, а инструменты реализованы в виде методов - функций, кото
рые также принадлежат объекту.
Все значения, обрабатываемые Python, представляют собой объекты. Например, строка
является объектом, содержащим методы format (), strip (), spli t() и многие другие (под
робности - в главе 6). Значение даты также является объектом с атрибутами year, month,
day, методами weelday(), isoformat() и др. (полное описание приведено в разд. 10.4.2).
Класс - это образец, на основе которого создаются объекты, относящиеся к одной разно
видности. Класс определяет набор атрибутов и методов, поддерживаемых объектами соот
ветствующей разновидности. Например, объекты строк принадлежат классу, носящему имя
str (как и строковый тип данных), а объекты дат - классу date.
Стандартная библиотека Python содержит множество классов, называемых встроею-1ыми.
Кроме того, разработчики могут создавать свои, пользовательские классы.
13.1. Определение классов, создание объектов
и работа с ними
Инструкция создания, или определения, пользовательского класса записывается в следую
щем формате:
class <Имя класса>:
[<Строка документирования>]
<Определения методов>
Имя класса должно удовлетворять тем же требованиям, что и имена переменных (см.разд. 2.1).
Дело в том, что, обработав определение класса, интерпретатор создает переменную, чье имя
совпадает с именем созданного класса, и присваивает ей определение этого класса (которое
также представляет собой объект).
Определения методов записываются в том же формате, что и определения функций
(см. разд. 11.1). Первым (или единственным) параметром каждый метод должен принимать
ссылку на текущий объект этого класса (чтобы в теле метода можно было обратиться к ат
рибутам и методам текущего объекта). Традиционно этому параметру дают имя self.
Глава 13. Объекты и классы 257
Атрибуты создаются в теле методов простым присваиванием им значений, для чего приме
няются инструкции формата:
<Объект>.<Атрибут> = <Значение атрибута>
В качестве <Объекта> следует использовать значение первого параметра, полученного мето
.1ом (как отмечалось ранее, обычно его называют self).
Кроме того, внутри методов можно обращаться к созданным ранее атрибутам текущего
объекта с целью получить их значения, применяя следующий синтаксис (известный под
названием точечной нотации):
<Объект>.<Атрибут>
и вызывать методы, использовав выражение формата:
<Объект>.<Метод>([Параметры через запятую])
При вызове метода следует указать только значения второго и последующих параметров,
передаваемых ему. Значение первого параметра (self) - ссьшка на текущий объект -
будет передано методу самим интерпретатором.
Определения классов должны предшествовать инструкциям, создающим на их основе объ
екты. Как правило, определения класса располагают в начале модуля или в отдельном мо
дуле, отделяют от остального кода и друг от друга пустыми строками - для наглядности.
При вводе определения класса в интерпретаторе, работающем в интерактивном режиме,
после ввода языковой конструкции class и нажатия клавиши <Enter> последующие строки
станут выводиться с отступом слева, и можно будет занести строку документирования, оп
ределения атрибутов и методов. При вводе определения метода после набора языковой кон
струкции def следующие строки станут выводиться с двойным отступом слева, и можно
будет занести тело метода. Завершив ввод тела очередного метода, следует уменьшить
отступ нажатием клавиши <Backspace>, чтобы ввести языковую конструкцию. def опреде
.1ения следующего метода. Завершив ввод всех методов, нужно нажать <Enter> дважды,
чтобы закончить ввод определения класса.
Пример определения класса Platfor.m, содержащего атрибуты narne (название программной
платформы) и type (тип платформы: клиентская или серверная, изначальное значение:
"Серверная"), методы setNarne(<Название>) (задает новое название у текущей платформы)
и getFullNarne() (возвращает строку с названием и типом текущей платформы):
>>> class Platfonn:
def setNarne(self, narne):
self.narne = narne # Создаем атрибут narne
self.type = "Серверная" # Создаем атрибут type
def getFullNarne(self):
return self.narne + " (" + self.type + ") "
Определив класс, на его основе можно создать произвольное количество объектов. Для соз
.1ания объекта класса примеряется следующий синтаксис:
<Класс>()
Возвращеннь1й объект класса необходимо присвоить какой-либо переменной, атрибуту дру
гого объекта, передать в качестве параметра функции или методу. Если этого не сделать,
созданный объект будет потерян.
Для примера создадим пару объектов только что определенного класса Platfonn:
258 Часть /. Основы языка Python
>>> pll Platform()
>>> pl2 Platform()
Для обращения к атрибутам и методам объекта применяется точечная нотация, описанная
ранее. Укажем у первого из созданных объектов название платформы (вызовом метода
setName ()),а у второго-название и тип (который занесем в атрибут type):
>>> pll.setName("Python") # Указываем значение второго параметра метода
>>> pl2.setName("JavaScript") # Значение первого параметра (ссылка на текущий
>>> # объект) будет передано методу интерпретатором
>>> pl2.type = "Клиентская"
>>> pl2.getFullName()
'JavaScript (Клиентская)'
>>> pll.getFullName()
'Python (Серверная)'
В обычном коде можно создавать у объекта принадлежащие искщочительно ему атрибуты
(атрибуты экземпляра объекта), просто присваивая им значения. Создадим у второго
объекта класса Platform атрибут экземпляра объекта founded, хранящий год создания плат
формы:
>>> pl2.founded = 1995
»> pl2.founded
1995
>>> pll.founded # У первого объекта атрибута founded нет
. .. Фрагмент пропущен ...
AttributeError: 'Platform' object has no attribute 'founded'
Удалить ненужный атрибут можно, использовав языковую конструкцию del (см. разд. 2.6)
и записав в ней удаляемый атрибут в формате: <Объект>. <Атрибут>:
»> del pll.founded
Для работы с атрибутами можно использовать следующие функции:
♦ getattr() - возвращает значение атрибута с заданным в виде строки именем, принад
лежащего указанному объекту. Формат функции:
getattr(<Oбъeкт>, <Имя атрибута>[, <Значение по умолчанию>])
Если атрибут с указанным именем не найден, генерируется искmочение AttributeError.
Чтобы избежать этого, в третьем параметре можно указать значение по умолчанию, воз
вращаемое,если атрибут не существует;
♦ setattr() - заносит указанное значение в атрибут с указанным именем, принадлежа
щий заданному объекту. Формат функции:
setattr(<Oбъeкт>, <Имя атрибута>, <Значение>)
Вторым параметром можно передать имя несуществующего атрибута - в этом случае
будет создан атрибут экземпляра объекта с таким именем;
♦ delattr(<Oбъeкт>, <Имя атрибута>) - удаляет из заданного объекта атрибут, чье имя
указано в виде строки;
♦ hasattr(<Объект>, <Имя атрибута>) - возвращает True, если атрибут с именем,указан
ным в виде строки,существует в заданном объекте,и False - в противном случае.
Примеры использования этих функций:
Глава 13. Объекты и классы 259
>>> getattr(pll, "type")
'Серверная'
>>> getattr(pll, "version")
... Фрагмент пропущен ...
AttributeError: 'Platform' object has no attribute 'version'
>>> getattr(pll, "version", "0.0")
'О.О'
>>> setattr(pll, "version", "1.0")
>>> pll.version
'1.0'
>>> hasattr(pl2, "founded")
True
>>> delattr(pl2, "founded")
>>> hasattr(pl2, "founded")
False
Любые атрибуты и методы, определенные в классе, доступны как изнутри этого класса, так
и извне его. Такие атрибуты и методы называются общедоступными. Искmочение состав
ляют лишь атрибуты и методы, чьи имена начинаются с двойного подчеркивания U -
они доступны только внутри класса (закрытые атрибуты и методы). Закрытые атрибуты
и методы будут описаны далее.
Определение класса представляет собой объект типа type (см. разд. 2.4):
>>> type(Platform)
<class 'type'>
>>> type(Platform) == type
True
13.2. Атрибуты класса
У класса можно создать атрибуты, принадлежащие самому классу, а не создаваемым на его
основе 'объектам (атрибуты класса). Для этого применяется расширенный синтаксис опре
деления класса:
class <Имя класса>:
[<Строка документирования>]
[<Определения атрибутов класса>]
<Определения методов>
Определение отдельного атрибута класса записывается в фор��те:
<Имя атрибута> = <Значение атрибута>
Пример класса, содержащего два атрибута класса:
>>> class Python:
type = "Язык программирования"
version = "3.10.1"
260 Часть /. Основы языка Python
Получить доступ к атрибутам класса можно как через сам класс (наиболее часто используе
мый вариант):
>>> Python.type
'Язык программирования'
>>> Python.version = "3.10.2"
>>> Python.version
'3.10.2'
так и через объекты этого класса:
>» р = Python()
>>> p.type
'Язык программирования'
Однако если попытаться изменить значение атрибута класса через объект, в этом объекте
будет создан одноименный атрибут экземпляра объекта:
>>> p.type "Среда разработки" # Якобы меняем значение атрибута класса type
>>> # В результате будет создан одноименный атрибут экземпляра объекта
>>> p.type
'Среда разработки'
>» р2 = Python() # Создаем еще один объект класса Python
>>> p2.type # Проверяем значение атрибута класса type
'Язык программирования'
Атрибут класса будет хранить одно и то же значение у всех объектов этого класса. Так, если
в атрибуте класса сохранить список, все объекты этого класса станут ссылаться на один и
тот же объект списка, например:
>>> class Platforms:
platform_list = [] # Атрибут класса, хранящий список
>>> plsl = Platforms()
>>> pls2 = Platforms()
>>>#Добавляем элемент в список через первый объект
»> plsl .platform_list.append("Python")
>>>#Добавляем элемент в список через второй объект
>>> pls2.platform_list.append("JavaScript")
>>>#И убеждаемся, что оба объекта ссылаются на один и тот же список
>>> plsl.platform_list
['Python', 'JavaScript']
>>> pls2.platform_list
['Py7hon', 'JavaScript' ]
13.3. Конструкторы и деструкторы
В определении класса можно указать два метода, имеющих специальное назначение:
♦ _init_() - конструктор - автоматически вызьшается при создании объекта текуще
го класса.
Первым параметром конструктору, как и другим методам, передается ссьшка на теку
щий объект. Остальными параметрами можно передать любые значения, которые могут
быть занесены в атрибуты создаваемого объекта или использованы в вычислениях.
Глава 13. Объекты и классы 261
Для создания объекта класса, имеющего конструктор, применяется инструкция следую
щего формата:
<Класс>([<Значения параметров через запятую>]])
Указанные значения параметров будут переданы конструктору;
♦ _del_() -:-- деструктор - автоматически вызывается перед уничтожеIШем объекта
текущего класса, когда перестает существоватъ последняя ссылка на этот объект. Дол
жен принимать один параметр - ссылку на текущий объект.
Пример класса с конструктором и деструктором показан в листинге 13.1.
class MyClass:
def init (self, parl, par2): # Конструктор класса
self.attrl = parl
self.attr2 = par2
print("Вызван конструктор")
def del (self): # Деструктор класса
print("Вызван деструктор")
cl = MyClass(l, 2) # Выведет: Вызван конструктор
del cl # Выведет: Вызван деструктор
с2 = MyClass("a", "Ь") # Выведет: Вызван конструктор
сЗ = с2 # Создаем еще одну ссылку на объект
del с2 # Ничего не выведет, т. к. существует еще одна ссылка
del сЗ # Выведет: Вызван деструктор
13.4. Наследование
Наследование - это создание одного класса (производного, или подкласса) на основе дру
гого (базового, или суперкласса). Производный класс получает все атрибутъr и методы, при
сутствующие в базовом классе.
Для определения производного класса применяется инструкция следующего формата:
class <Имя класса>(<Базовый класс>):
<Остальная часть определения класса>
Если и в базовом, и в производном классе присутствуют методы с одинаковыми именами,
при вызове такого метода из объекта производного класса будет вызван метод производно
го класса. То есть метод производного класса произведет перекрытие одноименного метода
из базового класса. Рассмотрим пример из листинга 13.2.
Листинr·1з.. 2. На�вание
class Classl: # Базовый класс
def funcl(self):
print("Meтoд funcl() класса Classl")
def func2(self):
print("Meтoд func2() класса Classl")
262 Часть /. Основы языка Python
class Class2(Classl): # Производный класс Class2 наследует класс. Classl
def func2(self):
print("Meтoд func2() класса Class2 перекрыл метод класса Classl")
def funcЗ(self):
print("Метод funcЗ() класса Class2")
cl = Classl() # Создаем объект класса Classl
с2 = Class2() # Создаем объект класса Class2
с2.funcl() # Выведет: Метод funcl() класса Classl
cl.func2() # Выведет: Метод func2() класса Classl
c2.func2() # Выведет: Метод func2() класса Class2 перекрыл метод класса Classl
с2.funcЗ() # Выведет: Метод funcЗ() класса Class2
Однако на практике чаще приходится не полностью заменять какой-либо метод базового
класса в производном классе, а дополнять его функциональность - производить переопре
деление метода. В теле переопределяемого метода производного класса записывается код,
реализующий дополнительную функциональность, и в нужном месте этого кода ставится
инструкция вызова метода базового класса. Для вызова метода базового класса из метода
производного класса можно использовать одну из следующих инструкций:
♦ вызов функции super () - с применением выражения формата:
suреr([<Производный класс>, <Ссыпка на текущий объект>])-�
<Вызов метода базового класса>
В вызове метода базового . класса первый параметр, содержащий ссылку на текущий
объект, не указывается.
У самой функции super() параметры указываются редко, в крайне специфических слу
чаях;
♦ <Базовый класс>.<Вызов метода базового класса>
Здесь в вызове метода базового класса, напротив, следует передать первый параметр,
содержащий ссылку на текущий объект.
Рассмотрим пример переопределения двух методов базового класса в производном классе
двумя только что описанными способами (листинг 13.3).
class Classl:
def init (self):
рrint("Конструктор базового класса")
def funcl(self):
print("Meтoд funcl() класса Classl")
def func2(self):
print("Meтoд func2() класса Classl")
class Class2(Classl):
def init (self):
print("Конструктор производного класса")
Classl. init (self) # Вызываем конструктор базового класса
Глава 13. Объекты и классы 263
def funcl(self):
print("Метод funcl() класса Class2")
super() . funcl() # Вызываем метод базового класса
def func2(self):
print("Meтoд func2() класса Class2")
super(Class2, self) . func2() # Вызываем метод базового класса
~ - Class2() # Создаем объект класса Class2
:::.funcl() # Вызываем метод funcl()
:::. func2() # Вызываем метод func2()
Выведет:
�онструктор производного класса
�онструктор базового класса
,1етод funcl() класса Class2
:-Iетод funcl () класса Classl
:-Iетод func2() класса Class2
'1етод func2() класса Classl
13.4.1. Множественное наследование
При множественном наследовании производный класс наследует сразу от нескольких базо
вых классов.
Для множественного наследования применяется инструкция следующего формата:
class <Имя класса>(<Базовые классы через запятую>):
<Остальная часть определения класса>
При обращении в производном классе к атрибуту или методу, определенному в одном из
базовых классов, просмотр базовых классов будет выполняться в том порядке, в котором
они указаны.
Рассмотрим множественное наследование на примере (листинг 13.4).
class Classl: # Базовый класс для класса Class2
def funcl(self):
print("Meтoд funcl() класса Classl")
class Class2(Classl): # класс Class2 наследует класс Classl
def func2(self):
print("Метод func2() класса Class2")
class ClassЗ(Classl): # класс ClassЗ наследует класс Classl
def funcl(self):
print("Метод funcl() класса ClassЗ")
def func2(self):
print("Meтoд func2() класса ClassЗ")
def funcЗ(self):
print("Метод funcЗ () класса ClassЗ")
264 Часть /. Основы языка Python
def func4(self):
print("Метод func4() класса ClassЗ")
class Class4(Class2, ClassЗ): # Множественное наследование
def func4(self):
print("Meтoд func4() класса Class4")
с = Class4() # Создаем объект класса Class4
c.funcl () # Выведет: Метод funcl() класса ClassЗ
с.func2() # Выведет: Метод func2() класса Class2
c.funcЗ() # Выведет: Метод funcЗ() класса ClassЗ
с.func4() # Выведет: Метод func4() класса Class4
Метод funcl() определен в двух классах: Classl и ClassЗ. Так как вначале просматривают
ся все базовые классы, непосредственно указанные в определении текущего класса, метод
�uncl() будет найден в классе ClassЗ (поскольку он указан в числе базовых классов в опре
делении Class4), а·не в классе Classl.
Метод func2() также определен в двух классах: Class2 и ClassЗ. Так как класс Class2 стоит
первым в списке базовых классов, то метод будет найден именно в нем. Чтобы наследовать
метод из класса ClassЗ, следует указать это явным образом. Переделаем определение класса
Class4 из предыдущего примера и наследуем метод func2 () из класса ClassЗ (листинг 13.5).
асса
,..,.· ·-· .. .· ,
class Class4(Class2, ClassЗ): # Множественное наследование
# Наследуем func2() из класса ClassЗ, а не из класса Class2
func2 = Class3.func2
def func4(self):
print("Метод func4() класса Class4")
Вернемся к листингу 13.4. Метод funcЗ() определен только в классе ClassЗ, поэтому метод
наследуется от этого класса. Метод func4(), определенный в. классе ClassЗ, переопределя
ется в производном классе.
Если искомый метод найден в производном классе, то вся иерархия наследования просмат
риваться не будет.
Для получения кортежа с перечнем базовых классов можно воспользоваться атрибутом
_bases_ объекта определения класса. В качестве примера выведем базовые классы для
всех классов из предыдущего примера:
>>> print(Classl. bases
>>> print(Class2. bases
>>> print(ClassЗ . bases
>>> print(Class4. bases
Выведет:
(<class 'object'>,)
(<class ' main .Classl'>,)
(<class ' main .Classl'>,)
(<class ' main .Class2'>, <class ' main .Class3'>)
Глава 13. Объекты и классы 265
Рассмотрим порядок поиска идентификаторов при сложной иерархии множественного на
следования (листинг 13.6).
class Classl: х = 10
class Class2(Classl): pass
class Class3(Class2): pass
class Class4(Class3): pass
clas.s Class�(Class2): pass
class Classб(Class5): pass
class Class7(Class4, Classб): pass
с = Class7()
print(c.x)
Последовательность поиска атрибута х будет такой:
Class7 -> Class4 -> ClassЗ -> Classб -> Class5 -> Class2 -> Classl
Получить кортеж со всей цепочкой наследования позволяет атрибут _mro_ объекта опре
деления класса:
>>> print(Class7. mro
Результат выполнения:
(<class 1
main .Class7'>, <class ' main .Class4'>,
<class 1
main .ClassЗ'>, <class ' main .Classб'>,
<class 1
_main .Class5'>, <class ' main .Class2'>,
<class 1
main .Classl'>, <class 'object'>)
13.4.1.1. Примеси и их использование
Примесь - это класс, предназначенный исключительно для расширения функциональности
других классов путем добавления в них атрибутов и методов с помощью множественного
наследования. Примеси определяются так же, как и обычные классы (поскольку ничем от
них не отличаются).
В качестве примера создадим класс-примесь Mixin, после чего создадим еще два класса,
добавим к их функцщ)Нальности ту, что определена в примеси Mixin, и проверим ее в дей
ствии (листинг 13.7).
class Mixin: # Определяем сам класс-примесь
attr = О # Определяем атрибут примеси
def mixin_method(self): # Определяем метод примеси
print("Метод примеси")
class Classl (Mixin):
def methodl(self):
print("Meтoд класса Classl")
266 Часть /. Основы языка Python
class Class2 (Classl, Mixin):
def method2(self):
print("Meтoд класса Class2")
cl = Classl()
cl.methodl()
cl.mixin
1 -
method() # Classl поддерживает метод примеси
с2 = Class2()
с2 . methodl()
с2.method2()
с2 . mixin_method() # Class2 также поддерживает метод примеси
Результат:
Метод класса Classl
Метод примеси
Метод класса Classl
Метод класса Class2
Метод примеси
Примеси активно применяются в различ�1х дополнительных библиотеках - в частности,
в популярном веб-фреймворке Django.
13.5. Специальные методы
Специальные методы вызываются самим интерпретатором в определенные моменты вре
мени. Два специальных метода - кон<;труктор и деструктор - были рассмотрены
в разд. 13.3. Помимо них, поддерживаются еще следующие:
♦ _call_() - вызывается при вызове текущего объекта с применением того же синтак
сиса, что используется при вызове функции. Формат метода:
call (self[, <Параметр 1>[, . . ., <Параметр N>]])
Пример:
class MyClass:
def init (self, m):
self.msg = m
def call (self, new_value=None):
if new value:
print(new_value)
else:
print(self.msg)
cl = МуСlаss("Значениеl") # Создание объекта
с2 = МуСlаss("Значение2") # Создание объекта
cl() # ВЫведет: Значение!
с2() # Выведет: Значение!
с2("Новое значение") # ВЫведет: Новое значение
♦ _getattr_(self, <Имя атрибута>) - вызывается при обращении к несуществующему
атрибуту текущего объекта:
Глава 13. Объекты и классы 267
class MyClass:
def init (self):
self.i = 20
def _getattr_(self, attr):
рrint("Вызван метод _getattr_()")
return О
с = MyClass()
# Атрибу� i существует
print(c.i) # Выведет: 20. Метод _getattr_() не вызывается
# Атрибут s не существует
print(c.s) # Выведет: Вызван метод _getattr_() О
♦ _getattribute_(self, <Имя атрибута>) - вызывается при обращении к mобому, даже
существующему атрибуту текущего объекта. Необходимо учитывать, что использование
точечной нотации (для обращения к атрибутам) внутри этого метода приведет к зацик
ливаншо. Чтобы избежать зацикливания, следует вызвать метод _getattribute_()
объекта object и внутри этого метода вернуть значение атрибута или сгенерировать
искmочение Attr1buteError. Пример:
class MyClass:
def init (self):
self.i = 20
def _getattribute_(self, attr):
рrint("Вызван метод _getattribute ()")
return object._getattribute_(self, attr) # Только так!!!
с = MyClass()
print(c.i) # Выведет: Вызван метод _getatt,ribute_() 20
♦ _setattr_(self, <Имя атрибута>, <Значение>) - вызывается при попытке присваи
вания значения атрибуту текущего объекта. Если внутри метода необходимо присвоить
значение атрибуту, следует использовать словарь из атрибута _ctict_, поскольку при
применении точечной нотации метод _setattr_() будет вызван повторно, что приве
дет к зацикливаншо. Пример:
class MyClass:
def setattr (self, attr, value):
рrint("Вызван метод setattr ()")
self. dict [attr] = value # Только так! !!
с = MyClass()
c.i = 10 # Выведет: Вызван метод setattr ()
print(с.i) # Выведет: 10
♦ _delattr_(self, <Имя атрибута>) - вызывается при удалении атрибута текущего
объекта с помощью инструкции del <Объект>. <Атрибут>;
♦ _len_(self) - вызывается при использовании функции len() применительно к теку
щему объекту, а также для проверки объекта на логическое значение при отсутствии
в классе метода bool () . Метод должен возвращать положительное целое число.
Пример:
class MyClass:
def len (self):
return 50
268 Часть /. Основы языка Python
с = MyClass()
print(len(c)) # Выведет: 50
♦ _bool_(self) - вызывается при использовании функции bool() применительно к те
кущему объекту. Должен возвращать логическое значение;
♦ _int_(self) - вызывается при преобразовании текущего объекта в целое число с по
мощью функции int(). Должен возвращать целое число;
♦ _float_(self) - вызывается при преобразовании текущего объекта в вещественное
число с помощью функции float(). Должен возвращать вещественное число;
♦ _complex_(self) - вызывается при преобраз�вании текущего объекта в комплексное
число с помощью функции complex(). Должен возвращать комплексное число;
♦ _round_(self, n) - вызывается при округлении текущего объекта функцией round().
Должен возвращать вещественное число;
♦ _index_(self) - вызывается при преобразовании текущего объекта в целое число при
извлечении среза, вызове функций Ьin(), oct() или hex(). Должен возвращать целое
число;
♦ _str_(self) - вызывается при использовании функций str() и print() примени
тельно к текущему объекту. Должен возвращать строку. Если отсутствует, будет исполь
зован метод _repr_() (описан далее). Пример:
class MyClass:
def init (self, m):
self.msg = m
def str (self):
return "Вызван метод str () {0}".format(self.msg)
с = МуСlаss("Значение")
print(str(c)) # Выведет: Вызван метод str () Значение
print(с) # Выведет: Вызван метод str () Значение
♦ _repr_(self) - вызывается при выводе текущего объекта интерпретатором, рабо
тающим в интерактивном режиме, и использовании функции repr() применительно
к текущему объекту. Должен возвращать строку. Пример:
cJ.ass MyClass:
def init (self, m):
self.msg = m
def _repr_(self):
return "Вызван метод _repr_() {0}".format(self.msg)
с = МуСlаss("Значение")
print(repr(c)) # Выведет: Вызван метод _repr_() Значение
♦ _hash_(self) - должен возвращать строковое представление текущего объекта, со
держащее только цифры. Такое представление можно получить, использовав функцию
hash(<Значение>). Этот метод следует переопределить, если объекты текущего класса
планируется использовать в качестве ключей словаря или внутри множества. Пример:
class MyClass:
def init (self, у):
self.x = у
def hash (self):
return hash(self.x)
Глава 13. Объекты и классы 269
с= MyClass(lO)
d = {}
d[c] = "Значение"
print(d[c]) # Выведет: Значение
Классы поддерживают еще несколько специальных методов, которые применяются лишь
в особых случаях и будут рассмотрены в главе 15.
13.6. Перегрузка операторов
Перегрузкой оператора называется изменение функциональности какого-либо из операто
ров, поддерживаемых Python, применительно к объектам определенного класса. Чтобы
перегрузить оператор, необходимо в классе определить соответствующий специальный метод.
Для перегрузки математических операторов используются следующие методы:
♦ х+ у-сложение:х. add (у);
♦ у+ х-сложение(объект класса справа):х._rаdd_(у);
♦ х+= у-сложение и присваивание: х. _ iadd_(у);
♦ х- у-вычитание: х. suЬ (у);
♦ у- х-вычитание(объект кла.сса справа):х._rsuЬ_(у);
♦ х -= у-вычитание и присваивание:х._i suЬ_(у) ;
♦ х * у-умножение: x._mul_(y);
♦ у * х-умножение(объект класса справа): x._rmul_(y);
♦ х *= у-умножение и присваивание: x._imul_(y);
♦ х / у-деление: х. truediv (у);
♦ у / х-деление( объект класса справа): х._ rtruedi v_(у);
♦ х /= у-деление и присваивание: x._itruediv_(y);
♦ х / / у-деление с округлением вниз: х._floordiv _(у);
♦ у // х-деление с округлением вниз(объект класса справа): x._rfloordiv_ (у);
♦ х //= у-делени.е с округлением вниз и присваивание: x._ifloordiv_(y);
♦ х % у-остаток от деления: х. mod (у);
♦ у % х-остаток от деления (объект класса справа): х._rmod_(у);
♦ х %= у-остаток от деления и присваивание: х. _ imod_(у);-
♦ х ** у-возведение в степень:х.--,---Роw_(у);
♦ у * * х-возведение в степень (объект класса справа):х._rpow_(у);
♦ х **= у-возведение в степень и присваивание: х._ ipow_(у);
♦ -х-унарный минус: х. _ neg_();
♦ +х-унарный плюс: х._pos_();
♦ abs(х) -абсоmотное значение: х. abs ().
Пример перегрузки математических операторов приведен в листинге 13.8.
270 Часть /. Основы языка Python
class MyClass:
def init (self, у):
self.x = у
def add (self, у) : # Перегрузка оператора +
print("Объект слева")
return self.x + у
def radd (self, у) : # Перегрузка оператора +
print( "Объект справа")
return self.x + у
def iadd (self, у) : # Перегрузка оператора +=
print("Сложение с присваиванием")
self.x += у
return self
с = MyClass(S0)
print(c + 10) # Выведет: Объект слева 60
print(20 + с) # Выведет: Объект справа 70
с += 30 # Выведет: Сложение с присваиванием
print(c.x) # Выведет: 80
Специальные методы для перегрузки двоичных операторов:
♦ ~х-двоичная инверсия: х. _invert_();
♦ х & у-двоичное И: х. and (у);
♦ у & х-двоичное И (объект класса справа): x._rand_(y);
♦ х &= у-двоичное И и присваивание:х._iand_(у);
♦ х I у-двоичное ИЛИ:х. or (у);
♦ у х -двоичное ИЛИ(объект класса справа): x._ror_ (у);
♦ х 1= у-двоичное ИЛИ и присваивание: x._ior_(y);
♦ х л у-двоичное искmочающее ИЛИ:х. xor (у);
♦ у л х-двоичное искmочающее ИЛИ(объект класса справа): x._rxor_(y);
♦ х л= у-двоичное искmочающее ИЛИ и присваивание:х._ixor_(у);
♦ х« у-сдвиг влево:х. lshift (у);
♦ у« х-сдвиг влево(объект класса справа): x._rlshift_(y);
♦ х«= у-сдвиг влево и присваивание: x._ilshift_(y);
♦ х » у-сдвигвправо:х._rshift_(у);
♦ у » х - сдвигвправо(объект класса справа): x._rrshift_(у);
♦ х »= у-сдвиг вправо и присваивание: x._irshift_(y).
Перегрузка операторов сравнения производится с помощью следующих специальных ме
тодов:
♦ х = у-равно: x._eq_(y);
♦ х != у-не равно: x._ne_(y);
Глава 13. Объекты и классы 271
♦ х < у-меньше:х. lt (у);
♦ х > у-больше:x._gt_(y);
♦ х <= у-меньше или равно:х._lе_(у);
♦ х >= у-больше или равно:x._ge_(y);
♦ у in х-проверка на вхождение:х. _contains_(у).
Пример перегрузки операторов сравнения приведен в листинге 13.9.
class MyClass:
def init (self):
self.x = 50
self.arr = [1, 2, З, 4, 5)
def _eq__(self, у): # Перегрузка оператора
return self.x = у
def contains (self, у): # Перегрузка оператора in
return у in self.arr
с = MyClass()
print("Paвнo" if с = 50 else "Не равно") # Выведет: Равно
print("Paвнo" if с = 51 else "Не равно") # Выведет: Не равно
print("Ecть" if 5 in с else "Нет") # Выведет: Есть
13. 7. Статические методы и методы класса
Статический метод -это метод, принадлежащий классу, а не объекту. Создается он так
же, как и обычный метод, только перед его определением указьmается декоратор
@staticmethod. Ссылка на текущий объект с первым параметром такому методу не переда
ется, поэтому в теле статического метода невозможно получить доступ к обычным атрибу
там и методам.
Статический метод можно вызвать как непосредственно у класса, записав инструкцию
формата:
<Класс>.<Метод>([<Параметры через запятую>])
так и у любого объекта этого класса- посредством выражений формата, приведенного
в разд. 13.1.
Пример использования статических методов показан в листинге 13.10.
class MyClass:
@staticmethod
def funcl (х, у): . # Статический метод
return х + у
def func2(self, х, у): # Обычный метод
return х + у
272 Часть /. Основы языка Python
def funcЗ(self, х, у):
return MyClass.funcl(x, у) # Вызов статического метода из обычного
print(MyClass.funcl(lO, 20)) # Вызываем статический метод
с = MyClass()
print(c.func2(15, 6)) # Вызываем обычный метод
print(c.funcl(SO, 12)) # Вызываем статический метод через объект
print(c.func3(23, 5)) # Вызываем обычный метод,
# вызывакщий статический метод
Метод класса похож на статический, только ему первым параметром передается ссылка на
текущий класс (не объект). Перед определением метода класса следует поставить декоратор
@classmethod. Пример использования методов класса пр иведен в листинге 1З .11.
class MyClass:
@classmethod
def func(cls, х): # Метод класса
print(cls, х)
MyClass.func(lO) # Вызываем метод класса у класса
с = MyClass()
c.func(SO) # Вызываем метод класса_у объекта
Статические методы и методы класса часто пр именяются для выполнения каких-либо вы
числений общего характера или для создания специфических объектов класса, содержащих
определенные значения в своих атрибутах.
13.8. Абстрактные методы
Абстрактный метод предназначен не для непосредственного вызова, а для перекрытия
в производных классах. В качестве тела такого метода указывается инструкция с пустым
оператором pass (описан в разд. 3. 5), а перед его определением ставится декоратор
@abstractmethod из модуля аЬс. Кроме того, класс, содержащий абстрактные методы, дол
жен быть производным от класса АВС из того же модуля.
При попытке создать объект пр оизводного класса, в котором не перекрыт абстрактный
метод, генерируется исключение TypeError. Следуеt помнить, что это исключение генери
руется только в том случае, если класс с абстрактными методами является производным от
класса АВС (в противном случае ничего не происходит). Рассмотрим определение абстракт
ных методов на пр имере (листинг 13.12).
from аЬс import АВС, abstractmethod
class Classl(AВC):
@abstractmethod
def func(self, х): # Абстрактный метод
pass
Глава 13. Объекты и классы 273
class Class2(Classl):
def func(self, х): # Перекрываем абстрактный метод
print(x)
class ClassЗ(Classl): # Класс не перекрывает абстрактный метод
pass
с2 = Class2()
c2.func(50) # Выведет: 50
try:
сЗ = ClassЗ() # Ошибка. Метод func() не перекрыт
c3.func(50)
except TypeError as msg:
print(msg) # Can't instantiate aЬstract class ClassЗ
# with abstract methods func
Можно создавать абстрактные статические методы и абстрактные методы класса, для чего
необходимые декораторы указываются одновременно, друг за другом (листинг 13.13).
from аЬс import АВС, abstractmethod
class MyClass(АВС):
@staticmethod
@abstractmethod
def static_func(self, х): # Абстрактный статический метод
pass
@classmethod
@aЬstractmethod
def class_func(self, х): # Абстрактный метод класса
pass
13.9. Закрытые атрибуты и методы
Закрытые атрибуты и методы, в отличие от общедоступных, доступны лишь внутри
класса, из его собственных методов. При попытке обратиться к закрытому атрибуту или
методу извне класса генерируется искmочение AttributeError.
Превратить атрибут или метод в закрытый можно, предварив его имя двойным символом
подчеркивания U- Пример:
>>> class MyClass:
def init (self, а):
self. а = а # Закрытый атрибут
def _func(self): # Закрьггый метод
print(self._а)
def func(self): # Общедоступный метод
self._func() # Вызываем закрытый метод из общедоступного
274 Часть /. Основы языка Python
>>> obj= MyClass(l23)
>>> obJ. а # ПЫтаемся получить значение закрытого атрибута - ошибка
... Фрагмент пропущен ...
AttributeError: 'MyClass' object has no attribute ' а'
>>> obj._func() # Пытаемся вызвать закрытый метод - ошибка
... Фрагмент пропущен ...
AttributeError: 'MyClass' object has no attribute ' func'. Did you mean:
'func'?
>>> obj. func()
123
Тем не менее доступ к закрытым атрибутам и методам все же можно получить извне класса,
обратившись по идентификатору формата:
<Имя класса> <Имя атрибута или метода без двойного подчеркивания>
Например:
>>> obj._MyClass_a # Получаем значение закрытого атрибута а
123
>>> obj._MyClass_func() # Вызываем закрытый метод _func()
123
Также можно указать набор атрибутов (но, к сожалению, не методов), которые будут дос
тупны извне класса (остальные атрибуты автоматически станут закрытыми). Список со
строковыми именами этих атрибутов следует присвоить атрибуту класса _slots_, а если
общедоступным планируется сделать лишь один атрибут, можно присвоить строку с его
именем. Пример показан в листинге 13.14.
1 Листинr 13.14. Использование aтJ?Ибyтa_slots_
class MyClass:
slots [ "х", "у"]
def init (self, а, Ь):
self.x, self.y= а, Ь
с= MyClass(l, 2)
print(c.x, с.у) # Выведет: 1 2
с.х, с.у= 10, 20 # Изменяем значения атрибутов
print(c.x, с.у) # Выведет: 10 20
try: # Перехватываем исключения
c.z = 50 # Атрибут z не указан в slots
# поэтому генерируется исключение
except AttributeError as msg:
print(msg) # 'MyClass' object has no attribute 1 z1
13.10. Свойства
Свойство - это своего рода атрибут, при обращении к которому вызьmается один из трех
следующих методов, определенных в классе:
♦ геттер - вызывается при попытке получить значение свойства. Должен возвращать
результат, который и станет значением свойства;
Глава 13. Объекты и классы 275
Обычно геттер возвращает значение, хранящееся в каком-либо закрытом атрибуте. Од
нако иногда он вычисляет возвращаемое значение, основываясь на содержимом других
атрибутов.
Если геттер отсутствует, свойство не будет доступно на чтение;
♦ сеттер - вызывается при попытке присвоить свойству новое значение. Должен прини
мать в качестве параметра новое значение и не должен возвращать результат.
Обычно сеттер заносит новое значение свойства в специально предназначенный для его
хранения закрытый атрибут. Помимо этого, он может выполнять какие-либо дополни
тельные действия.
Если сеттер отсутствует, свойство не будет доступно для записи;
♦ делетер - вызьmается при попытке удалить свойство.
Обычно делетер либо удаляет закрытый атрибут, в котором хранится значение свойства,
либо заносит в него значение None. Также он может выполнять какие-либо дополнитель
ные действия.
Если делетер отсутствует, свойство будет невозможно удалить.
Свойство создается вызовом функции property(). Формат функции:
property(fget=None] [, ] [fset=None[, ] [fdel=None] [, ] [doc=None])
Параметр fget задает геттер, параметр fset - сеттер, fdel - делетер, doc - строку доку
�ентирования.
В качестве результата возвращается объект, представляющий созданное свойство, который
сразу следует сохранить в каком-либо атрибуте класса. Через этот атрибут и будет в даль
нейшем выполняться доступ к свойству. Рассмотрим создание свойства на примере (лис
тинг 13.15).
Листинr 13.15. Соэдание свойства вызовом функции prqierty()
class MyClass:
def get_var(self): # Геттер
return self . var
def set_var(self, value): # Сеттер
self. var = value
def del_var(self): # Делетер
del self. var
v = property(fget=get_var, fset=set_var, fdel=del_var, dос="Свойство")
с = MyClass()
c.v = 35 # Вызывается сеттер
print(c.v) # Вызывается геттер
del c.v # Вызывается делетер
Также поддерживается альтернативньJй способ создания свойств. Сначала у будущего гет
тера указьmается декоратор property, после чего объект геттера получает поддержку мето
дов setter() и deleter(). Далее у будущего сеттера следует вызвать упомянутый ранее ме
тод setter() геттера в качестве декоратора, а у будущего делетера - точно таким же обра
зом вызвать метод deleter() геттера. Соответствующий пример приведен в листинге 13.16.
276 Часть /. Основы языка Python
class MyClass:
@property
def v(self): # Геттер
return self. var
@v.setter
def v(self, value): # Сеттер
self. var = value
@v.de1eter
def v(self): # Делетер
del self. var
с = MyClass()
c.v = 35 # Вызывается сеттер
print(c.v) # вызывается геттер
del c.v # вызывается делетер
Можно создать абстрактное свойство - в этом случае все реализующие его методы долж
нъ1 быть переопределены в производном классе. Абстрактное свойство создается с по
мощью декоратора @aЬstractrnethod и класса АБС из модуля аЬс (см. разд. 13. 8). Пример
показан в листинге 13 .17.
frorn аЬс import АБС, aЬstractrilethod
class MyClass(AВC):
@property
@aЬstractrnethod
def v(self): # Чтение
return self. var
@v.setter
@aЬstractrnethod
def v(self, value): # Запись
self. var = value
@v.de1eter
@aЬstractrnethod
def v(self): # Удаление
del self. var
13.11. Декораторы классов
Помимо декораторов функций, Python поддерживает декораторы классов - функции,
изменяющие поведение самих классов. В качестве параметра декоратор класса должен при
нимать ссылку на класс, поведение которого необходимо изменить, и должен возвращать
ссылку на тот же класс или какой-либо другой. Пример декорирования класса показан
в листинге 13.18.
Глава 13. Объекты и классы 277
jef deco(C): # Принимает объект определения класса
print.( "Внутри декоратора") # Производит какие-то действия
return С # Возвращает объект определения класса
Иесо
:lass MyClass:
def init (self, value):
self.v = value
MyClass(S)
;;rint(c.v)
ГЛАВА 14
Исключения и их обработка
Исключение - это объект, генерируемый интерпретатором Python в случае возникновения
ошибки и хранящий сведения о ней. Обработка, или перехват, исключения - это реагиро
вание на его возникновение с целью ликвидировать последствия ошибки.
В программе могут возникать ошибки трех типов:
♦ синтаксические - ошибки в синтаксисе кода: неправильное написание языковых кон
струкций, идентификаторов, отсутствие закрывающей или открывающей кавычек и т. д.
Как правило, интерпретатор предупреждает о наличии такой ошибки, и выполнение
программы прерывается. Пример синтаксической ошибки:
>>> print( "Нет завершак:щей кавычки!)
SyntaxError: EOL while scanning string literal
♦ логические - ошибки в логике программы. Как правило, интерпретатор не предупреж
дает о наличии такой ошибки, и программа успешно выполняется, но выда�щый ею
результат оказывается не тем, на который мы рассчитывали. Выявить и исправить такие
ошибки весьма трудно;
♦ ошибки времени выполнения - ошибки, возникающие во время работы программы
вследствие событий, которые не были предусмотрены программистом. Классическим
примером служит деление на ноль:
>>> def test(x, у): return х / у
»> test(4, 2) # Нормально
2.0
>>> test(4, О) # Ошибка
Traceback (most recent call last):
File "<pyshell#4>", line 1, in <module>
test(4, О)
File "<pyshell#2>", line 1, in test
def test(х, у): return х / у
ZeroDivisionError: division Ьу zero
В Python исключения также генерируются в качестве уведомлений о наступлении каких
либо событий. Например, метод index() генерирует исключение ValueError, если искомый
фрагмент не входит в обрабатываемую строку:
Глава 14. Исключения и их обработка 279
>>> "Строка".indех("текст")
Traceback (most recent call last):
File "<pyshell#S>", line 1, in <module>
"Строка".indех("текст")
ValueError: suЬstring not found
14.1. Обработчики исключений
Обработчик uсЮ1ючений - инструкция, предназначенная для обработки исюпочений. Фор
\tаТ ЭТОЙ инструкции:
:ry:
<Блок, в котором могут возникать искточения>
except[ <Класс искточения 1>[ as <Переменная>]]:
<Блок, выполняемый при возникновении искточений класса 1>
except[ <Класс исключения N>[ as <Переменная>]]:
<Блок, выполняемый при возникновении исключения класса N>
:else:
<Блок, вьmолняемый, если исключение не возникло>]
::inally:
<Блок, выполняемый в любом случае>]
Языковых конструкций except может быть произвольное количество. В переменную, ука
занную в конструкции except, будет занесен объект исюпочения, и в соответствующем бло
ке можно будет извлечь из него какие-либо сведения о возникшем исюпочении.
Пример обработки исюпочения класса zeroDivisionError, генерируемого при делении на
ноль, приведен в листинге 14.1.
:ry: # Перехватываем исключения
х = 1 / О # Ошибка: деление на О
except ZeroDivisionError: # Указываем класс исключения
рrint("Обработали деление на О")
х = о
::::rint(х) # Выведет: О
Один обработчик исюпочений можно вложить в другой. Если вложенный обработчик не
обработал возникшее исюпочение, оно всплывет во «внешний» обработчик. Если исюпоче
ние в программе вообще нигде не обрабатывается, оно будет передано обработчику по
:-молчанmо, встроенному в интерпретатор, который остановит выполнение программы
и выведет стандартное сообщение об ошибке. Пример вложенных обработчиков приведен
в листинге 14.2.
:ry: # Обрабатываем исключения
try: # Вложенный обработчик
х = 1 / О # Ошибка: деление на О
280 Часть /. Основы языка Python
except NameError:
рrint("Неопределенный идентификатор")
except IndexError:
print("Несуществу�аций индекс")
рrint("Выражение после вложенного обработчика")
except ZeroDivisionError:
рrint("Обработка деления на 0")
х = о
print(x) # Выведет: О
В этом примере во вложенном обработчике не указано исключение ZeroDivisionError, по
этому исключение «всплывет» в обработчик более высокого уровня.
После обработки исключения выполняются инструкции, расположенные сразу после обра
ботчика. В нашем примере выполнится инструкция, выводящая значение переменной х, -
print(х). Инструкция print("Выражение после вложенного обработчика") выполнена не
будет.
В языковой конструкции except можно указать сразу несколько исключений, записав их
через запятую внутри круглых скобок (листинг 14.3).
try:
х = 1 / О
except (NameError, IndexError, ZeroDivisionError):
# Обработка сразу нескольких исключений
х = о
print(x) # Выведет: О
Пример получения сведений об обрабатываемом исключении приведен в листинге 14.4.
try:
х = 1 / О # Ошибка деления на О
except (NameError, IndexError, ZeroDivisionError) as err:
print(err. class__name # Имя класса исключения
print(err) # Текст сообщения об ошибке
Результат выполнения:
ZeroDivisionError
division Ьу zero
ДJiя получения сведений об исключении можно воспользоваться функцией exc_info() из
модуля sys, которая возвращает кортеж из трех элементов: класса исключения, объекта ис
ключения и объекта с трассировочной информацией. Преобразовать эти значения в удобо
читаемый вид позволяет модуль traceback. Пример использования функции ехс_info() и
модуля traceback приведен в листинге 14.5.
Глава 14. Исключения и их обработка 281
import sys, traceback
c:ry:
х = 1 / О
except ZeroDivisionError:
Туре, Value, Trace = sys.exc_info()
print("Type: ", Туре)
print("Value:·", Value)
print("Trace:", Trace)
print("\n", "print_exception()".center(40, "-"))
traceback.print_exception(Type, Value, Trace, limit=S,
file=sys.stdout)
print("\n", "print_tb()".center(40, "-"))
traceback.print_tb(Trace, limit=l, file=sys.stdout)
print("\n", "format_exception()".center(40, "-"))
print(traceback.format_exception(Type, Value, Trace, limit=5))
print("\n", "format_exception_only() ".center(40, "-"))
print(traceback.format_exception_only(Type, Value))
Результат выполнения примера:
Туре: <class 'ZeroDivisionError'>
Value: division Ьу zero
Trace: <traceback object at Ох00000274303А7040>
-----------pri nt_exception()-----------
Traceback (rnost recent call last):
File "D:/Dаtа/Документы/Работа/Книги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.5.ру", line 3, in <rnodule>
х = 1 / О
ZeroDivisionError: division Ьу zero
---------------print_tb() ---------------
File "D:/Dаtа/Документы/Работа/Книги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.5.ру", line 3, in <rnodule>
х = 1 / О
-----------forrnat_exception() ----------
['Traceback (rnost recent call last) :\n',
' File "D:/Dаtа/Документы/Работа/Книги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.5.ру", line 3, in <rnodule>\n х = 1 / 0\n',
'ZeroDivisionError: division Ьу zero\n']
-----�--forrnat_exception_only() --------
['ZeroDivisionError: division Ьу zero\n']
Если в языковой конструкции except не указан класс исключения, то записанный в ней блок
будет перехватывать все исключения. На практике следует избегать пустых инструкций
282 Часть /. Основы языка Python
except, иначе можно перехватить искточение, которое является лишь сигналом системе, а
не ошибкой. Пример перехвата всех искточений приведен в листинге 14.6.
Листинг 14.6. Перехват всех искnючений.
try:
х = 1 / о # Ошибка деления на О
except: # Обработка всех исключений
х = о
print(x) # Выведет: о
Если в обработчике присутствует языковая конструкция else, то указанный в ней блок
будет выполнен только при отсутствии ошибок. А блок в языковой конструкции finally
выполнится вне зависимости от того, возникло искточение или нет. Для примера выведем
последовательность выполнения этих блоков (листинг 14.7).
Листинг 14.7. Яэь�ковые конструкци��t el� и ��ly.
try:
х = 10 / 2 # Нет ошибки
#х = 10 / О # Ошибка деления на О
except ZeroDivisionError:
print ("Деление на О")
else:
print ("Блок else")
finally:
print ("Блок finally")
Результат выполнения при отсутствии искточения:
Блок else
Блок finally
Последовательность выполнения блоков при наличии искточения будет другой:
Деление на О
Блок finally
Необходимо заметить, что при наличии искточения и отсутствии языковой конструкции
except блок в конструкции finally будет выполнен, но искточение останется необработан
ным и «всплывет» в обработчик более высокого уровня. Если таковой отсутствует, искто
чение передается обработчику по умолчанию, который прервет выполнение программы и
выведет сообщение об ошибке, например:
>>> try:
х = 10 / О
finally: print ("Блок finally")
Блок finally
Traceback (most recent call last):
File "<pyshell#17>", line 2, in <module>
х = 10 / О
ZeroDivisionError: division Ьу zero
Глава 14. Исключения и их обработка 283
Переделаем нашу программу суммирования произвольного количества целых чисел, вве
денных пользователем (см. листинг 4.13), таким образом, чтобы при вводе строки вместо
числа программа не завершалась с фатальной ошибкой (листинг 14.8).
1 Листинr 14.8. €уммирование нeonpe.tie.neннoro количества чисеп
рrint("Введите слово 'stop' для получения результата")
surnma = О
;,,hile (х := inрut("Введите число: ")) != "stop":
try:
х = int(x) # Преобразуем строку в число
except ValueError:
рrint("Необходимо ввести целое число!")
else:
surnma += х
print("Cyммa чисел равна:", surnma)
input()
Процесс ввода значений и получения результата выглядит так (значения, введенные поль
зователем, выделены полужирным шрифтом):
Зведите слово 'stop' для получения результата
Введите число: 10
Зведите число: str
�еобходимо ввести целое число!
Введите число: -5
Введите число:
Необходимо ввести целое число!
Введите число: stop
Сумма чисел равна: 5
14.2. Обработчики контекстов
Контекст - это объект, который следует создать, выполнить с ним заданные действия и
корректно уничтожить, вне зависимости от того, возникли исключения при выполнении
действий с ним или нет. Пример контекста - объект, представляющий файл, который
в любом случае должен быть закрыт после работы с ним. Класс, на основе которого созда
ется объект-контекст, называется менеджером контекста.
Обработчик контекста - это выражение, создающее контекст (или сразу несколько тако
вых), выполняющее с ним заданные действия и самостоятельно уничтожающее его. Такое
выражение записывается в любом из двух следующих форматов:
with <Выражение, создающее контекст 1>[ as <Переменная 1>]'
.,
<Выражение, создающее контекст N>[ as <Переменная N>]]:
<Блок, работак:щий с созданными контекстами>
with (<Выражение, создающее контекст 1>[ as <Переменная 1>]'
<Выражение, создающее контекст N>[ as <Переменная N>]]):
<Блок, работак:щий с созданными контекстами>
284 Часть /. Основы языка Python
Контексты, созданные заданными выражениями, заносятся в указанные переменные, и эти
переменные будут доступны в блоке, который работает с созданными контекстами.
Класс, являющийся менеджером контекста, должен поддерживать два специальных ме�ода:
♦ _enter_(self) - вызывается сразу после создания объекта текущего класса. Должен
возвращать ссылку на созданный объект;
♦ _exit_() - выполняется либо по завершении исполнения блока в выражении обра
ботчика контекста (если искmочение не возникло), либо сразу после возникновения ис
кmочения. Формат метода:
exit (self, <Класс исключения>, <Объект исключения>,
<Объект с трассировочной информацией>)
Если искmочение не возникло, последние три параметра получат значение None, и метод
не должен возвращать результат. В противном случае метод должен вернуть значение
тrue, если возникшее искmочение было им обработано, или False, если он не обработал
искmочение (которое в этом случае будет передано вышестоящему обработчику).
Пример обработчика контекста приведен в листинге 14.9.
class MyClass:
def enter (self):
print("Бызван метод _enter_()")
return self
def exit (self, Туре, Value, Trace):
print("Вызван метод _exit_()")
if Туре is None: # Если исключение не возникло
рrint("Исключение не возникло")
else: # Если возникло исключение
print("Value =", Value)
return False # False - исключение не обработано
# True - исключение обработано
рrint("Последовательность при отсутствии исключения:")
with MyClass():
print("Блок внутри with")
рrint("\nПоследовательность при наличии исключения:")
with MyClass() as obj:
print("Блoк внутри with")
raise TypeError ("Исключение TypeError")
Результат выполнения:
Последовательность при отсутствии исключения:
Вызван метод enter ()
Блок внутри with
Вызван метод exit ()
Исключение не возникло
Глава 14. Исключения и их обработка 285
Последовательность при наличии исключения:
Вызван метод enter ()
Блок внутри with
Вызван метод exit ()
Value = Исключение TypeError
Traceback (most recent call last):
File "D:/Dаtа/Документы/Работа/Книги/Руthоn 3 и PyQt 6 Разработка
приложений/FГР/14/14.9.ру", line 21, in <module>
raise ТуреЕrrоr("Исключение TypeError")
TypeError: Исключение TypeError
Второй формат обработчиков контекстов (с круглыми скобками) поддерживается, начиная
с Python 3.10, и позволяет разбивать языковую конструкцию with на несколько строк:
with (Classl() as objl, Class2() as obj2, ClassЗ() as оЬjЗ,
Class4() as obj4, Class5() as obj5):
Некоторые встроенные классы (например, класс файла) также являются менеджерами кон
текста. Они будут рассмотрены в последующих главах.
14.3. Классы встроенных исключений
Иерархия встроенных в Python классов исключений схематично выглядит так:
ЗaseExcept. ion
SystemExit
Keyboardinterrupt
GeneratorExit
Exception
Stopiteration
ArithmeticError
FloatingPointError, OverflowError, ZeroDivisionError
AssertionError
AttributeError
BufferError
EOFError
ImportError
ModuleNotFoundError
LookupError
IndexError, KeyError
MemoryError
NameError
UnЬoundLocalError
OSError
BlockingIOError
ChildProcessError
ConnectionError
BrokenPipeError, ConnectionAЬortedError,
ConnectionRefusedError, ConnectionResetError
FileExistsError
286 Часть /. Основы языка Python
FileNotFoundError
InterruptedError
IsADirectoryError
NotADirectoryError
PermissionError
ProcessLookupError
TimeoutError
RuntimeError
NotimplementedError, RecursionError
SyntaxError
IndentationError
TabError
SystemError
TypeError
ValueError
UnicodeError
UnicodeDecodeError, UnicodeEncodeError
UnicodeTranslateError
Warning
BytesWarning, DeprecationWarning, FutureWarning, ImportWarning,
PendingDeprecationWarning, ResourceWarning, RuntimeWarning,
SyntaxWarning, UnicodeWarning, UserWarning
Можно указать базовый класс для перехвата всех исключений соответствующих производ
ных классов. Например, указав базовый класс ArithmeticError, можно перехватывать ис
кmочения классов FloatingPointError, OverflowError и ZeroDivisionError:
try:
х = l / О # Ошибка: деление на О
except ArithmeticError: # Указываем базовый класс
рrint("Обработали деление на 0")
Основные классы встроенных исключений:
♦ вaseException - базовый класс для всех прочих классов искmочений;
♦ Exception - базовый класс для большинства исключений, встроенных в Python, а также
пользовательских искmочений;
♦ AssertionError - генерируется языковой конструкцией assert;
♦ AttributeError - попытка обращения к несуществующему атрибуту или методу объекта;
♦ EOFError - достигнут конец файла, из которого выполняется чтение;
♦ ImportError - невозможно выполнить импорт модуля или пакета вследствие ошибки
в инструкции импорта;
♦ IndentationError - неправильно расставлены отступы в программе;
♦ IndexError - указанный индекс не существует в последовательности;
♦ KeyError - указанный кmоч не существует в отображении;
♦ Keyboardinterrupt - нажата комбинация клавиш <Ctrl>+<C>;
♦ MemoryError - интерпретатору существенно не хватает оперативной памяти, и он вы
нужден срочно удалить неиспользуемые объекты, чтобы освободить ее;
Глава 14. Исключения и их обработка 287
♦ ModuleNotFoundError - импортируемый модуль или пакет не найден;
♦ NameError - попытка обращения к несуществующему идентификатору;
♦ NotimplementedError - попытка обращения к абстрактному методу;
♦ OSError - базовый класс для всех искmочений, генерируемых в ответ на возникновение
системных ошибок (отсутствие запрошенного файла, недостаток места на диске и пр.);
♦ overflowError - число, получившееся в результате выполнения арифметической опера-
ции, слишком велико, чтобы Python смог его обработать;
♦ RecursionError - превышено максимальное количество проходов рекурсии;
♦ RuntimeError - неклассифицированная ошибка времени выполнения;
♦ stopiteration - генерируется методом_next_ () как сигнал об окончании итераций;
♦ SyntaxError - синтаксическая ошибка;
♦ SystemError - ошибка в самом интерпретаторе Python;
♦ TabError - в программном коде встретился символ табуляции, использование которого
для создания отступов недопустимо;
♦ TypeError - тип объекта не соответствует ожидаемому;
♦ unЬoundLocalError - в теле функции создается локальная переменная после обращения
к одноименной глобальной переменной;
♦ UnicodeDecodeError - ошибка преобразования последовательности байтов в Unicode
cтpoкy;
♦ UnicodeEncodeError - ошибка преобразования Unicode-cтpoки в последовательность
байтов;
♦ UnicodeError - базовый класс для искmочений, генерируемых при ошибке преобразо-
вания Unicode-cтpoк в последовательности байтов и наоборот;
♦ UnicodeTranslationError - ошибка преобразования Unicode-cтpoки в другую кодировку;
♦ ValueError - неприемлемое значение параметра, переданного функции или методу;
♦ ZeroDivisionError - деление на ноль.
14.4. Генерирование исключений
Для программного генерирования искmочений предназначена инструкция, записываемая
в одном из следующих форматов:
raise <Объект исключения>
raise <Класс исключения>
raise <Объект или класс вторичного исключения> from �
<Объект первичного исключения>
raise
Первый формат генерирует искmочение, чей объект указан в инструкции. При создании
объекта искmочения можно передать конструктору класса данные, которые могут быть
извлечены в обработчике (см.разд. 14. 1). Пример генерирования искmочения Val ueError:
288 Часть /. Основы языка Python
>>> raise ValueError("Oпиcaниe исключения")
Traceback (most recent call last):
File "<pyshell#0>", line 1, in <module>
raise ValueError("Oпиcaниe исключения")
ValueError: Описание исключения
Пример обработки этого искmочения показан в листинге 14.10.
try:
raise ValueError("Oпиcaниe исключения")
except ValueError as msg:
print(msg) # Выведет: Описание исключения
Второй формат инструкции генерирует искmочение на основе указанного класса, при этом
объект искmочения создается автоматически:
try:
raise ValueError # Эквивалентно: raise ValueError()
except ValueError:
print ("Сообщение об ошибке")
Третий формат инструкции при возникновении одного искmочения (первичного) генери
рует другое (вторичное). Первичное искmочение сохраняется в атрибуте _cause_ объекта
вторичного искmочения. Пример использования этого формата можно увидеть в листин
ге 14.11.
try:
х = 1 / О
except Exception as err:
raise ValueError() from err
Результат
_ выполнения:
Traceback (most recent call last):
File "D:/Dаtа/Документы/Работа/КНИги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.11.ру", line 2, in <module>
х = 1 / О
ZeroDivisionError: division Ьу zero
The above exception was the direct cause of the following exception:
Traceback (most recent call last):
File "D:/Dаtа/Документы/Работа/Книги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.11.ру", line 4, in <module>
raise ValueError() from err
ValueError
Глава 14. Исключения и их обработка 289
Как видно из результата, мы получили информацию не только пь искточенmо valueError,
но и по искточенmо zeroDivisionError. Следует заметить, что при отсутствии языковой
конструкции from информация о первичном искточении сохраняется в объекте вторичного
искmочения неявным образом. Если убрать конструкцию from в предыдущем примере, мы
получим следующий результат:
Traceback (most recent call last):
File "D:/Dаtа/Документы/Работа/КНИги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.11.ру", line 2, in <module>
х = 1 / О
ZeroDivisionError: division Ьу zero
During handling of the аЬоvе exception, another exception occurred:
Traceback (most recent call last):
File "D:/Dаtа/Документы/Работа/КНИги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.11.ру", line 4, in <module>
raise ValueError()
ValueError
Четвертый формат инструкции повторно генерирует последнее возникшее искточение и
обычно применяется в коде, следующем за конструкцией except. Пример использования
этого формата показан в листинге 14.12.
class MyError(Exception): pass
try:
raise MyError( "Сообщение об ошибке")
except MyError as err:
print(err)
raise # Повторно генерируем исКJПОчение
Результат выполнения:
Сообщение об ошибке
Traceback (most recent call last):
File "D:/Dаtа/Документы/Работа/КНИги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.12.ру", line З, in <module>
raise МуЕrrоr("Сообщение об ошибке")
MyError: ·сообщение об ошибке
14.5. Пользовательские исключения
Пользовательское uсЮ1ючение - это искточение, созданное программистом. В качестве
пользовательского искmочения всегда выступает класс, производный от класса Exception.
Пример определения и использования пользовательского искmочения показан в листин
ге 14.13.
290 Часть /. Основы языка Python
class MyError(Exception):
def init (self, value):
self.msg = value
def str (self):
return self.msg
# Обработка пользовательского исключения
try:
raise МуЕrrоr("Описание исключения")
except MyError as err:
print(err) # Вызывается метод str ()
print(err.msg) # Обращение к атрибуту класса
# Повторно генерируем исключение
raise МуЕrrоr("Описание исключения")
Результат выполнения:
Описание исключения
Описание исключения
Traceback (most recent call last):
File "D:/Dаtа/Документы/Работа/КНИги/Руthоn 3 и PyQt 6 Разработка
приложений/FТР/14/14.13.ру", line 14, in <module>
raise MyError("Описание исключения")
MyError: Описание исключения
Класс Exception подцерживает все необходимые методы для вывода сообщения об ошибке.
Поэтому в большинстве случаев для создания пользовательского исключения достаточно
определить пустой класс, производный от него (листинг 14.14).
class MyError(Exception): pass
try: ;
raise МуЕrrоr("Описание исключения")
except MyError as err:
print(err) # Выведет: Описание исключения
14.6. Проверочная инструкция
Проверочная инструкция позволяет удостовериться, что заданное условие выполняется.
Если же это не так, инструкция сгенерирует исключение AssertionError.
Формат записи проверочной инструкции:
assert <Условие>[, <Значение]
Указанное значение будет передано конструктору класса AssertionError в качестве пара
метра.
Глава 14. Исключения и их обработка 291
Проверочная инструкция эквивалентна следующему коду:
if _debug_
if not <Условие>:
raise AssertionError(<Знaчeниe>)
Если при запуске программы используется командный ключ -о, то переменная _debug_
будет хранить значение False. Таким образом, если запустить программу без ключа -о, про
верочные инструкции выполняться не будут.
Пример использования инструкции assert представлен в листинге 14.15.
1 Лмстинr 14.15. ПРQ88рОЧН8А �
try:
х = -3
assert х >= О, "Сообщение об ошибке"
except AssertionError as err:
print(err) # Выведет: Сообщение об ошибке
ГЛАВА 15
Итераторы, контейнеры
и перечисления
Python позволяет создавать классы особого назначения: итераторы, контейнеры и перечис
ления.
15.1. Итераторы
Итератор - это класс, который при каждом обращении выдает очередной элемент задан
ной последовательности. Объект такого класса можно перебрать в цикле перебора последо
вательности. Можно сказать, что итератор аналогичен функции-генератору (см. разд. 11.3),
только является классом.
Чтобы превратить класс в итератор, следует переопределить в нем два специальных метода:
♦ _iter_ (self) - служит признаком того, что класс является итератором. Должен воз
вращать текущий объект. Как правило, этот метод выполняет всевозможные предуста
новки.
Если в классе определены методы _iter_ () и _getitem_() (о последнем будет рас
сказано позже), предпочтение отдается первому методу;
♦ _next_(self) - вызывается при выполнении каждой итерации и должен возвращать
очередной элемент последовательности. Если последовательность закончилась, в этом
методе следует сгенерировать исключение stopiteration, которое сообщит вызываю
щему коду о завершении перебора.
Рассмотрим класс, хранящий строку и на каждой итерации возвращающий очередной ее
символ, начиная с конца (листинг 15.1).
class ReverseString:
def init (self, s):
self. s = s
def iter (self):
self. i = О
return self
def next (self):
if self._i > len(self._s) - 1:
raise Stopiteration
Глава 15. Итераторы, контейнеры и перечисления 293
else:
а = self. s[-self. i - 1)
self. i = self. i + 1
return а
Проверим его в действии:
>>> s = ReverseString ("Python")
>>> for а in s: print(a, end="")
nohtyP
Также мы можем переопределить специальный метод _len() _) возвращающий размер
последовательности, и специальные методы _str() _ и _repr() _, выдающие строковое
представление объекта (были рассмотрены в разд. 13.5). Перепишем код нашего класса
итератора, добавив в него определение методов _len()_ и _str()_ (в листинге 15.2
часть кода опущена).
Листинr
class ReverseString:
def len (self):
return len(self._s)
def str (self):
return self._s[: :-1)
Теперь мы можем получить длину последовательности, хранящейся в объекте класса
ReverseString, и его строковое представление:
>>> s = ReverseString("Python")
»> len(s)
6
>>> str(s)
'nohtyP'
15.2. Контейнеры
Контейнер - это класс с функциональностью либо пронумерованной последовательности
(контейнер-последовательность) с произвольным доступом к любому ее элементу
·' по его
индексу, либо отображения (контейнер-отображение).
15.2.1. Контейнеры-последовательности
Чтобы превратить класс в контейнер-последовательность, следует переопределить в нем
следующие специальные методы:
♦ _getitem_(self, <Индекс>) - вызывается при извлечении элемента последовательно
сти с заданным индексом и должен возвращать этот элемент. Если индекс не является
целым числом или срезом, метод должен генерировать исключение TypeError, а если
такого индекса не существует, - исключение IndexError;
294 Часть /. Основы языка Python
♦ setitem_(self, <Индекс>, <Значение>) - вызывается в случае присваивания нового
значения элементу последовательности с заданным индексом. Не должен возвращать ре
зультата. В случае задания индекса недопустимого типа или отсутствия такого индекса
в последовательности метод должен генерировать те же исключения, что и метод
_getitem_();
♦ _delitem_(self, <Индекс>) - вызывается в случае удаления элемента последователь
ности с заданным индексом. Не должен возвращать результата. В случае задания индек
са недопустимого типа или отсутствия такого индекса в последовательности метод дол
жен генерировать те же исключения, что и метод _getitem_() ;
♦ _contains_(self, <Значение>) - вызьmается при проверке существования в последо
вательности элемента с заданным значением. Должен возвращать True, если такой эле
мент есть, и False - в противном случае.
В контейнере-последовательности можно дополнительно реализовать функциональность
итератора (см. разд. 15.1), переопределив специальные методы _ iter_(), _next_() и
_len_(). Чаще всего так и поступают.
Мы давно знаем, что строки в Python являются неизменяемыми. Напишем класс
MutaЫestring, представляющий строку, которую можно изменять теми же способами, что и
список (листинг 15.3).
class MutaЫeString:
def init (self, s):
self._s = list(s)
# Реализуем функциональность итератора
def iter (self):
self. i = о
return self
def next (self):
if self. i > len(self._s) - 1:
raise Stopiteration
else:
а = self._s[self._i]
self. i = self. i + 1
return а
def len (self):
return len(self._s)
def -'str (self):
return "".join(self._s)
# Определяем вспомогательный метод, который будет проверять
# корректность индекса
def _iscorrectindex(self, i):
if type(i) == int or type(i) == slice:
if type(i) = int and i > self. len {) - 1:
raise IndexError
else:
raise TypeError
Глава 15. Итераторы, контейнеры и перечисления 295
# Реализуем функциональность контейнера-последовательности
def _getitem_(self, i):
self. _iscorrectindex.(i)
return self._s[i]
def setitem (self, i, v):
self . iscorrectindex(i)
self. s[i] = v
def delitem (self, i):
self._iscorrectindex(i)
del self._s[i]
def contains (self, v):
return v in self. s
Проверим свеженаrшсанный класс в действии:
>>> s = MutaЫeString("Python")
»> print(s[-1])
n
>>>s[О] = "J"
»> print(s)
Jython
»> del s[2:4]
»> print(s)
Juon
Проверим, как наш класс обрабатывает нештатные ситуации, обратившись по несущест
вующему индексу:
>>> s[9] = "u"
. . . Фрагмент пропущен .. .
IndexError
15.2.2. Контейнеры-отображения
Превратить класс в контейнер-отображение можно, переопределив оrшсанные в разд. 15.2.1
методы: _getitem_(), _setitem_(), _delitem_() и _contains_(). При этом следует
учесть, что вместо индексов здесь будут использоваться кmочи произвольного типа (как
правило, строкового). А при обращении по несуществующему кmочу следует генерировать
искmочение KeyError.
Наrшшем класс Version, который будет хранить версию интерпретатора Python, разбитую
на части: старшая версия, младшая версия и модификация. Доступ к частям версии будет
осуществляться по строковым кmочам (листищ 15.4). Ради простоты функщюнальность
итератора реализовывать не станем, а также заблокируем операцию удаления элемента сло
варя, генерируя в методе_delitem_() искmочение NotimplementedError.
class Version:
def init (self, major, minor, suЬ):
self._major = major # Старшая версия
self. minor = minor # Младшая версия
self. suЬ = suЬ # Модификация
296 Часть /. Основы языка Python
def str (self):
return str(self._major) + + str(self._minor) + + \
str(self._suЬ)
# Реализуем функциональность отображения
def _getitem_(self, k):
if k == "major":
return self._major
elif k = "minor":
return self. minor
elif k = "suЬ":
return self. suЬ
else:
raise KeyError
def setitem (self, k, v):
if k == "major":
self._major = v
elif k == "minor":
self. minor = v
elif k == "suЬ":
self. suЬ = v
else:
raise KeyError
def delitem (self, k):
raise NotimplementedError
def contains (self, v):
return v == "major" or v == "minor" or v "suЬ"
Проверим новый класс в работе:
>>> v = Version(З, 10, 1)
>>> v["major"]
3
>>> v["minor"]
10
>>> v["suЬ"] 2
>>> str(v)
'3.10.2'
>>> v["some"]
. . . Фрагмент пропущен ...
KeyError
15.3. Перечисления
Перечисление - это набор каких-либо именованных значений, назьmаемых элементами.
Перечисление можно рассматривать как своего рода словарь, тол�ко неизменяемый.
Перечисление представляет собой класс, содержащий непосредственные определения атри
бутов класса, каждый из которых представляет один из элементов. Имя атрибута класса
Глава 15. Итераторы, контейнеры и перечисления 297
станет именем соответствующего элемента. Соглашения Руthоn-програм:мирования требу
ют, чтобы имена элементов перечисления были набраны в верхнем регистре.
Соответственно, для доступа к нужному элементу перечисления следует обратиться к пред
ставляющему его атрибуту класса посредством привычной точечной нотации.
Класс перечисления должен быть производным от. одного из следующих четырех классов,
определенных в модуле enum:
♦ Enum - базовый класс для создания перечислений, чьи элементы способны хранить зна
чения произвольного типа. Элементы такого перечисления могут содержать одинаковые
значения.
Пример перечисления, содержащего элементы с названиями различных веб-фрейм
ворков, в том числе два элемента с одинаковыми значениями:
>>> from enum import Enum
>>> class Frameworks(Enum):
LARAVEL = "Laravel"
DJANGO = "Dj ango"
EXPRESS = "Express"
RAILS = "RuЬy on Rails"
RUBY_ON_RAILS = "RuЬy on Rails"
Выведем значение одного из элементов перечисления:
>>> Frameworks.DJANGO
<Frameworks.DJANGO: 'Django'>
Присвоим значение другого элемента переменной и сравним с третьим элементом:
>>> fr = Frameworks.LARAVEL
>>> fr == Frameworks.RAILS
False
Элементы с одинаковыми значениями равны друг другу:
>>> Frameworks.RAILS Frameworks.RUBY ON RAILS
True
Создать перечисление, элементы которого гарантированно .содержат только уникальные
значения, можно, указав у его класса декоратор unique из модуля enum:
>>> from enum import Enum, unique
>>> @unique
class Frameworks2(Enum):
LARAVEL = "Laravel"
DJANGO = "Django"
EXPRESS = "Express"
RAILS = "Ruby on Rails"
Пример перечисления с целыми числами:
>>> class Colors(Enum):
RED = 1
GREEN = 2
BLUE = 3
WHITE = RED + GREEN + BLUE
298 Часть /. Основы языка Python
>>> Colors.RED
<Colors.RED: l>
>>> Colors.WHITE
<Colors.WHITE: 6>
Однако выполнять арифметические операции с элементами такого перечисления нельзя,
поскольку их значения не являются целыми числами:
>>> Colors.GREEN + 3
... Фрагмент пропущен ...
TypeError: unsupported operand type(s) for +: 'Colors' and 'int'
Если конкретные значения элементов целочисленного перечисления не важны, для их
занесения можно использовать функцmо auto() из модуля enшn. Эта функция возвраща
ет последовательно увеличивающиеся целые числа, начиная с 1. Пример:
>>> from enшn import Enшn, auto
>>> class Colors2(Enшn):
RED = auto()
GREEN = auto()
BLUE = auto()
WНITE = auto()
>>> Colors2.RED
<Colors2.RED: l>
>>> Colors2.WHITE
<Colors2.WНITE: 4>
♦ IntEnшn - базовый класс для создания перечислений, элементы которых хранят лишь
целочисленные значения. Значения элементов преобразуются в целые числа и, следова
тельно, могут быть использованы в арифметических операциях и выражениях сравнения
с целыми числами. Пример:
>>> from enшn import IntEnшn
>>> class ColorsЗ(IntEnшn):
1RED = l
GREEN = 2
BLUE = 3
WНITE = RED + GREEN + BLUE
>>> ColorsЗ.GREEN
<ColorsЗ.GREEN: 2>
>>> ColorsЗ.GREEN + 3
5
>>> ColorsЗ.GREEN * ColorsЗ.BLUE
6
>>> ColorsЗ.WHITE == 6
True
♦ Flag - базовый класс для перечислений, элементы которых хранят цел·очисленные зна
чения. Значения элементов могут выступать в качестве операндов для двоичных опера
торов (описаны в разд. 3.2). Функция auto() при использовании в таком перечислении
последовательно выдает значения 1 и числа, являющиеся степенями числа 2 (2, 4, 8, 16
и т. д.). Пример:
Глава 15. Итераторы, контейнеры и перечисления 299
>>> from entш1 import Flag, auto
>>> class Colors4(Flag):
BLACK = О
RED = auto()
GREEN = auto()
BLUE = auto()
WHITE = RED I GREEN I BLUE
>>> Colors4.BLACK
<Colors4.BLACK: О>
>>> Colors4.RED
<Colors4.RED: l>
>>> Colors4.GREEN
<Colors4.GREEN: 2>
>>> Colors4.BLUE
<Colors4.BLUE: 4>
>>> Colors4.WHIТE
<Colors4.WHITE: 7>
>>> Colors4.RED & Colors4.GREEN
<Colors4.BLACK: О>
>>> Colors4.RED I Colors4.GREEN
<Colors4.GREENIRED: З>
>>> bool(Colors4.WHITE & Colors4.BLUE)
True
Однако при манипуляциях с элементами такого перечисления использовать в качестве
операндов двоичных операторов целые числа нельзя:
>>> Colors4.RED 1 2
... Фрагмент пропущен
TypeError: unsupported operand type(s) for 1: 'Colors4' and 'int'
♦ IntFlag - аналогичен Flag, только значения элементов преобразуются в целые числа.
Следовательно, при манипуляциях с элементами такого перечисления можно использо
вать в качестве операндов двоичных операторов целочисленные значения. Пример:
>>> from entш1 import IntFlag, auto
>>> class ColorsS(IntFlag):
BLACK = О
RED = auto()
GREEN = auto()
BLUE = auto()
WHITE = RED I GREEN I BLUE
>>> ColorsS.RED 1 2
<ColorsS.GREENIRED: 3>
>>> ColorsS.WHITE == 7
True
Все классы перечислений принадлежат типу EnumМeta из модуля entш1:
>>> type(Colors)
<class 'entш1.EnumМeta'>
300 Часть /. Основы языка Python
>>> from enum import EnumМeta
>>> type(Colors) == EnumМeta
True
Значения элементов перечислений являются объектами их классов:
>>> type(Colors.RED)
<enum 'Colors'>
>>> type(Colors.RED) Colors
True
Действия, которые можно выполнять над элементами перечислений, были описаны ранее.
Помимо того, над элементами перечислений можно производить следующие операции:
♦ обращение к элементу в стиле словарей, используя имя элемента в качестве кточа:
>>> Frameworks["EXPRESS"]
<Frameworks.EXPRESS: 'Express'>
♦ обращение к элементу по его значению, записывая его в круглых скобках после имени
класса перечисления:
>>> Frameworks("Laravel")
<Frameworks.IARAVEL: 'Laravel'>
♦ получение имени атрибута класса перечисления, соответствующ�го заданному элементу,
и его значения из свойств элементов name и value соответственно:
>>> Frameworks.RAILS.name, Frameworks.RAILS.value
('RAILS'' 'RuЬy оп Rails')
♦ проверка на вхождение или невхождение элемента в· перечисление с помощью операто
ров in и not in соответственно:
>>> f = Frameworks.DJANGO
>>> f in Frameworks
True
>>> f not in Frameworks
False
>>> f in Colors
False
Перечисление можно использовать в качестве итератора (необходимая для этого функцио
нальность определена в базовом классе):
»> list(Colors)
[<Colors.RED: 1>, <Colors.GREEN: 2>, <Colors.BLUE: 3>, <Colors.WHITE: 6>]
>>> for f in Frameworks: print(f.value, end=" 1 ")
Laravel I Django I Express I RuЬy оп Rails 1
Помимо элементов, классы перечислений могут содержать методы, вкточая статические.
При этом обычные методы всегда вызываются у элемента перечисления (и соответственно
первым параметром любому методу передается ссьmка на объект, представляющий элемент
перечисления, у которого вызывается этот метод), а статические методы - у самого класса
перечисления. Для примера рассмотрим_код перечисления FrameworksЗ (листинг 15.5).
Глава 15. Итераторы, контейнеры и перечисления 301
from enum import Enum
class FrameworksЗ(Enum):
IARAVEL = "Laravel"
DJANGO = "Django"
EXPRESS = "Express"
RAILS = "RuЬy on Rails"
# Обычные методы. Вызываются у элемента перечисления.
def describe(self):
return self.name, self.value
def str (self):
return str( class--name ) + + self.name + "· " + \
self.value
# Статический метод. Вызывается у самого класса перечисления.
@classmethod
def getmostpopular(cls):
return cls.IARAVEL
В методе _str_() использована встроенная переменная _class_, хранящая ссылку на
объект определения текущего класса. Атрибут_name_ этого объекта содержит имя класса
в виде строки.
Проверим класс в работе:
>>> FrameworksЗ.DJANGO.describe()
('DJANGO'' 'Django')
>>> str(FrameworksЗ.EXPRESS)
'FrameworksЗ.EXPRESS: Express'
>>> FrameworksЗ.getmostpopular()
<FrameworksЗ.IARAVEL: 'Laravel'>
Можно определить класс перечисления, содержащий только методы и не включающий эле
менты, а потом наследовать от него производный класс, уже содержащий элементы. Про
изводный класс получит от базового поддержку всех его методов. Однако попытка создать
производный класс на основе базового, содержащего элементы, приведет к ошибке.
Перечисления можно использовать как альтернативу словарей везде, где требуется хранитъ
неизменяемый набор именованных значений. Перечисления занимают меньше оперативной
памяти, чем' словари, и быстрее обрабатываются.
ПРИМЕЧАНИЕ
В составе стандартной библиотеки Python присутствует модуль struct, позволяющий соз
давать нечто похожее на перечисления. Однако он не столь удобен в работе, как инстру
менты, предлагаемые модулем enum.
ГЛАВА 16
Работа с файлами и каталогами
16.1. Открытие файлов
Для открытия файла применяется функция open () , имеющая следующий формат вызова:
ореn(<Путь к файлу>[, mode= 'r'] [, buffering=-1) [, encoding=None] [,
errors=None] [, newline=None] [, closefd=Тrue])
Задаваемый путь к открываемому файлу может быть абсолютным или относительным. Для
разделения сегментов путей можно применять как обратные, так и прямые слеши (подроб
нее указание путей рассмотрено в разд. 16. 1. 1).
Парамеtр mode указывает реж:uм открытия файла в виде строки (чтение, запись или чтение
и запись), содержащей одно из следующих обозначений:
♦ r - чтение. Если файл не существует, генерируется исключение FileNotFoundError;
Python помечает место, с которого начнется чтение из файла или запись в него, особым
указателем. После открытия файла только на чтение этот указатель устанавливается на
начало файла;
♦ r+ - чтение и запись. Указатель устанавливается на начало файла. Если файл не суще
ствует, генерируется исключение FileNotFoundError;
♦ w - запись. Указатель устанавливается на начало файла. Если файл не существует, он
будет создан, если существует - перезаписан;
♦ w+ - чтение и запись. Указатель устанавливается на начало файла. Если файл не сущест
вует, он будет создан, если существует - перезаписан;
♦ а - дозапись. Указатель устанавливается на конец файла. Если файл не существует, он
будет сЬздан, если существует, данные будут добавлены в него;
♦ а+ - чтение и дозапись. Указатель устанавливается на конец файла. Если файл не суще
ствует, он будет создан, если существует, данные будут добавлены в него;
♦ х - создание файла для записи. Если файл уже существует, генерируется исключение
FileExistsError;
♦ х+ - создание файла для чтения и записи. Если файл уже существует, генерируется
исключение FileExistsError.
После собственно обозначения режима может следовать обозначение подреж:uма откры
тия файла, задающее формат читаемых или записываемых данных:
Глава 16. Работа с файлами и каталогами 303
♦ ь- двоичный (бинарный) подрежим. Читаемые и записываемые данные представляются
объектами типа bytes;
♦ t- текстовый подрежим (используется по умолчанию в Windows). Читаемые и запи
сываемые данные представляются строками.
В текстовом подрежиме автоматически выполняется обработка символов конца стро
ки - так, в Windows при чтении вместо символов \r\n будет подставлен символ \n. Для
примера создадим файл file.txt и запишем в него две строки:
>>> f = open(r"c:/book/file.txt", "w") # Открываем файл на запись
>>>.f.write("Stringl\nString2")# Записываем две строки в файл
15
>>> f.close() # Закрываем файл
Поскольку мы указали режим w, то, если файл не существует, он будет создан, а если
существует - перезаписан.
Теперь выведем содержимое файла в двоичном и текстовом подрежимах:
>>>#Двоичный подрежим (символ \r остается)
>>> with open(r"c:/book/file.txt", "rb") as f:
for line in f:
print(repr(line))
b'Stringl\r\n'
b'String2'
>>>#Текстовый подрежим (символ \r удаляется)
>>> with open(r"c:/book/file.txt", "r") as f:
for line in f:
print(repr(line))
'Stringl\n'
'String2'
Для ускорения работы производится буферизация записываемых данных. Информация из
буфера записывается в файл полностью только в момент закрытия файла или после вызова
функции или метода flush (). В необязательном параметре buffering можно указать размер
буфера. Если указано значение О, то данные будут сразу записьmаться в файл (допустимо
только в двоичном подрежиме). Значение 1 используется при построчной записи в файл
(допустимо только в текстовом подрежиме). Другое положительное число задает пример
нъ1й размер буфера, а отрицательное значение (или отсутствие значения) означает установ
ку размера, применяемого в системе по умолчанию. По умолчанию текстовые файлъ1 буфе
ризуются построчно, а двоичные - частями, размер которых интерпретатор выбирает са
мостоятельно в диапазоне от 4096 до 8192 байтов.
При чтении файла в текстовом подрежиме производится попытка преобразовать данные
в кодировку Unicode, а при записи выполняется обратная операция - строка преобразуется
в последовательность байтов в определенной кодировке. По умолчанию назначается коди
ровка, применяемая в системе. Если преобразование невозможно, генерируется исключе
ние. Указать кодировку, которая будет использоваться при записи и чтении файла, позволя
ет параметр encoding. Для примера запишем даннъ1е в кодировке UTF-8:
304 Часть /. Основы языка Python
>>> f = open(r"c:/book/file.txt", "w", encoding="utf-8")
>>> f.write("Cтpoкa") # Записываем строку в файл
6
>>> f.close() # Закрываем файл
При открытии этого файла для чтения следует явно указать кодировку:
>>> with open(r"c:/book/file.txt", "r", encoding="utf-8") as f:
for line in f:
print(line)
Строка
При работе с текстовыми файлами в кодировках UTF-8, UTF-16 и UTF-32 следует учиты
вать, что в начале файла может присутствовать метка порядка байтов (ВОМ). Для коди
ровки UTF-8 эта метка является необязательной, и в предыдущем примере она не была
добавлена в файл при записи. Чтобы ВОМ были добавлена, в параметре encoding следует
указать значение utf__:8-sig. Запишем строку в файл в кодировке UTF-8 с ВОМ:
>>> f = open(r"c:/book/file.txt", "w", encoding="utf-8-sig ")
>>> f.write("Cтpoкa") # Записываем строку в файл
6
>>> f.close() # Закрываем файл
Теперь прочитаем файл с разными значениями параметра encoding:
>>> with open(r"c:/book/file.txt", "r", encoding="utf-8") as f:
for line in f:
print(repr(line))
'\ufeffCтpoкa'
>>> with open(r"c:/book/file.txt", "r", encoding="utf-8-sig ") as f:
for line in f:
print(repr(line))
'Строка'
Если неизвестно, есть ли ВОМ в файле, и необходимо получить данные без нее, то при чте
нии файла в кодировке UTF-8 всегда следует указывать кодировку utf-8-sig.
При указании кодировок utf-16 и utf-32 в параметре encoding обработка ВОМ производит
ся автоматически: при записи ВОМ автоматически вставляется в начало файла, а при чте
нии она игнорируется. Запишем строку в файл, а затем прочитаем ее из файла:
>>> with open(r"c:/book/file.txt", "w", encoding="utf-16") as f:
f.write("Строка")
6
>>> with open(r"c:/book/file.txt", "r", encoding="utf-16") as f:
for line in f:
print(repr(line))
'Строка'
При указании кодировок utf-16-le, utf-16-be, utf-32-le и utf-32-be ВОМ необходимо
добавить в начало файла самостоятельно, а при чтении удалить ее.
Глава 16. Работа с файлами и каталогами 305
В параметре errors можно указать уровень обработки ошибок. Возможные значения:
"strict" (при ошибке генерируется исКJЩ)чение ValueError - значение по умолчанию),
"replace" (неизвестный символ заменяется знаком вопроса или символом с кодом \ufffd),
"ignore" (неизвестные символы итнорируются), "xrnlcharrefreplace" (неизвестный символ
заменяется последовательностью &#хххх;) и "backslashreplace" (неизвестный символ заме
няется последовательностью \uxxxx).
Параметр newline задает режим обработки символов конца строки. Поддерживаемые им
значения таковы:
♦ None (значение по умолчанию)- выполняется стандартная обработка символов конца
строки. Например, в Windows при чтении символы \r\n преобразуются в символ \n, а
при записи производится обратное преобразование;
♦ "" (пустая строка)- обработка не выполняется;
♦ "<Специальный символ>"- для обозначения конца строки используется заданнъrй специ
альнъrй символ, в качестве которого можно указать \r\n, \r и \n.
16.1.1. Указание путей к файлам и каталогам
В путях к файлам и каталогам для разделения отдельных сегментов (обозначений дисков,
имен каталогов и файлов) можно применять как обратные, так и прямые слеши.
Символ-разделитель сегментов путей, применяемый в текушей операционной системе, хра
нится в переменной sep из модуля os.path. Выведем разделитель, применяемый в Windows:
>>> from os.path import sep
>>> sep # Выведет обратный слеш
'\\'
При использовании обратных слешей следует помнить, что в. Python они являются специ
альнъrми символами (подробности- в разд. 6.1.1). По этой причине обратные слеши сле
дует заменять спецсимволами \\ или вместо обычных строк использовать необрабатьrвае
мые (описаны в разд. 6.1.1). Примеры:
>>> "C:\\temp\\new\\file.txt" # Правильно
'C:\\temp\\new\\file.txt'
>>> r"C:\temp\new\file.txt" # Правильно
'C:\\temp\\new\\file.txt'
>>> "C:\temp\new\file.txt" # Неправильно!!!
'C:\temp\new\x0cile.txt'
В последнем примере интерпретатор принял последовательность символов \f за специалъ
нъrй символ, что привело к искажению заданного нами пути. Если такой искаженный путь
передать функции open (), возникнет исключение OSError.
Кроме того, слеш, расположеннъrй в конце строки, необходимо удваивать даже при исполь-
зовании неформатированнъrх строк:
>>> r"C:\temp\new\" # Неправильно!!!
SyntaxError: EOL while scanning string literal
>>> r"C:\temp\new\\"
'C:\\temp\\new\\\\'
306 Часть 1. Основы языка Python
В первом примере последний слеш экранирует закрывающую кавычку, что приводит к син
таксической ошибке. Решить эту проблему можно, удвоив последний слеш. Однако тогда
два слеша превратятся в четыре (см. второй пример). Так что в этой ситуации лучше ис
пользовать обычные строки, например:
>>> "C:\\temp\\new\\" # Правильно
'C:\\temp\\new\\'
>>> r"C:\temp\new\\" [ :-1] # Можно и удалить слеш
'C:\\temp\\new\\'
Вместо абсолютного пути (отсчитываемого от обозначения диска) можно указать относи
тельный, который отсчитывается от текущего рабочего каталога (о нем - позже). Возмож
ны следующие варианты:
♦ если открываемый файл находится в текущем рабочем каталоге, можно указать только
имя файла:
>>> open(r"filel.txt")
♦ если открываемый файл расположен в каталоге, вложенном в текущий рабочий каталог,
перед именем файла через слеш указываются имена каталогов, в которые последовательно
вложен файл:
>>> open(r"folderl/file2 .txt")
>>> open(r"folder2/folder3/file3 .txt")
♦ если каталог с файлом расположен ниже уровнем, перед именем файла указываются две
точки и слеш (" ../"):
>>> open(r" ../file4.txt")
♦ если в начале пути расположен слеш, путь отсчитывается от корня текущего диска.
В этом случае местоположение текущего рабочего каталога не имеет значения:
»> open(r"/book/folder4/file4.txt")
»> open(r"/book/folder5/folder6/file5 .txt")
16.1.2. Текущий рабочий каталог
Текущий рабочий катшюг - это каталог, от которого интерпретатор отсчитывает относи
тельные пути файлов. По умолчанию текущим рабочим является следующий каталог:
♦ при запуске интерпретатора в интерактивном режиме - каталог, в котором установлен
Python (например, C:\Python310);
♦ при запуске Руthоn-файла щелчком мыши - каталог, в котором хранится запущенный
файл;
♦ при запуске Руthоn-файла из консоли - каталог, из которого был запущен файл. Напри
мер, если запустить консоль, выполнить в ней переход в каталог d:\work и запустить
Руthоn-файл c:\book\program.py, текущим рабочим станет каталог d:\work.
Получить путь к текущему рабочему каталогу можно вызовом функции getcwd() из мо
дуля os:
>>> import os
>>> os.getcwd()
'С:\\Python310'
Глава 16. Работа с файлами и каталогами 307
Задать в качестве текущего рабочего каталог с указанным путем можно вызовом функции
chdir(<Путь>) из модуля os:
>>> os.chdir(r"c:\book")'
Указать в качестве текущего рабочего каталог, в котором хранится запущенный Руthоn
файл, можно, вставив в код этого файла следующие инструкции:
:.mport os
os.chdir(os.path.dirname(os.path.abspath( file )))
Переменная _file_ хранит в разных случаях путь к запущенному файлу или только имя
файла без пути. Чтобы гарантированно получить полный путь к файлу, следует-передать
значение переменной в функцию abspath() из модуля os .path. Функция dirname() извлека
ет из переданного ей полного пути к файлу путь к хранящему его каталогу, который пере
.:rается функции chdir().
16.2. Чтение и запись данных:
объектные инструменты
Функция open() возвращает объект, представляющий открытый файл. Рассмотрим основ
ные методы, поддерживаемые этим объектом:
♦ close() - закрывает текущий файл.
При удалении из памяти объекта, представляющего файл, закрытие файла выполняется
автоматически, поэтому в небольших программах файлы можно не закрывать явно. Тем
не менее явное закрытие файла является признаком хорошего стиля программирования.
Кроме того, при наличии незакрытого файла генерируется предупреждающее сообще
ние: "ResourceWarning: unclosed file".
Классы объектов-файлов являются менеджерами контекста, поэтому для работы с фай
лами можно использовать обработчики контекста (см.разд. 14.2):
with open(r"c:\book\file.txt", "w", encoding="cpl251") as f:
f .write("Cтpoкa")#Записываем строку в файл
#Здесь файл уже закрыт автоматически
♦ write(<Значение>) - записывает в текущий фаЙJI указанное значение. Если файл открыт
в текстовом подрежиме, значение должно быть задано в виде строки, если в двоичном
подрежиме - в виде последовательности байтов. Метод возвращает количество запи
санных символов или байтов. Пример:
>>>#Текстовый подрежим
>>> f = open(r"c:\book\file.txt", "w", encoding="cp1251")
>>> f.write("Cтpoкal\nCтpoкa2")
15
>>> f.close()
>>>#Двоичный подрежим
>>> f = open(r"c:\book\file.txt", "wb")
>>> f.write(bytes("Cтpoкal\nCтpoкa2", "ср1251"))
15
>>> f.write(bytearray("\nCтpoкaЗ", "ср1251"))
8
»> f.close()
3()8 Часть /. Основы языка Python
♦ writelines(<Последовательность>) - записывает в текущий файл заданную последова
тельность. Если файл открыт в текстовом подрежиме, элементы последовательности
должны представлять собой строки, еСШ;f, в двоичном подрежиме - последовательности
байтов. Пример:
>>>#Текстовый подрежим
>>> f = open(r"c:\book\file.txt", "w", encoding="cpl25l")
>>> f.writelines(["Cтpoкal\n", "Строка2"])
>>> f.close()
>>>#Двоичный подрежим
>>> f.= open(r"c:\book\file.txt", "wb")
>>> arr = [bytes("Cтpoкal\n", "cpl25l"), Ьуtеs("Строка2", "cpl25l")]
>>> f.writelines(arr)
>>> f.close()
♦ writаЫе() - возвращает True, если в текущий файл можно писать, и False - в про
тивном случае:
>>> f = open(r"c:\book\file.txt", "r") # Открываем файл дпя чтения
»> f. writaЫe()
False
>>> f = open(r"c:\book\file.txt", "w") # Открываем файл дпя записи
»> f.writaЫe()
True
♦ read( [<Количество>] ) - считьmает данные из текущего файла и возвращает их. Если
файл открыт в текстовом подрежиме, выдается строка, а если в двоичном - последова
тельность байтов. Если параметр не указан, возвращается содержимое файла от текущей
позиции указателя до конца файла. Пример:
>>>#Текстовый подрежим
>>> with open(r"c:\book\file.txt", "r", encoding="cpl25l") as f:
f .read()
'Строкаl\nСтрока2'
>>>#Двоичный подрежим
>>> with open(r"c:\book\file.txt", "rb") as f:
f.read()
b'\xdl\xf2\xf0\xee\xea\xe0l\n\xdl\xf2\xf0\xee\xea\xe02'
В параметре можно указать количество символов или байтов, которое требуется прочи
тать из файла. Когда достигается конец файла, метод возвращает пустую строку или
пустую последовательность байтов. Пример:
>>> f = open(r"c:\book\file.txt", "r", encoding="cpl251")
>>> f .read(8) #Считываем 8 символов
'Строкаl\n'
>» f.read(8) #Считываем 8 символов
'Строка2'
>>> f.read(8) #Достигнут конец файла
11
>>> f.close()
Глава 1 б. Работа с файлами и каталогами 309
♦ readline( [<Количество>] ) - считывает из текущего файла очередную строку и возвра
щает ее. Если файл открыт в текстовом подрежиме, выдается строка, а если в двоич
ном - последовательность байтов. Возвращаемая строка включает символ перевода
строки. Исключением является последняя строка - если она не завершается символом
перевода строки, то таковой добавлен не будет. При достижении ко�ща файла возвраща
ется пустая строка или последовательность байтов. Пример:
>>>#Текстовый подрежим
>>> f = open(r"c:\book\file.txt", "r", encoding="cpl251")
>>> f.readline(), f.readline()
('Строкаl\n', 'Строка2')
>>> f.readline() #Достигнут конец файла
>>> f.close()
>>>#Двоичный подрежим
>>> f = open(r"c:\book\file.txt", "rb")
>>> f.readline(), f.readline()
(Ь'\xdl\xf2\xf0\xee\xea\xe01\n', Ь'\xdl\xf2\xf0\xee\xea\xe02') ,
>>> f.readline() #Достигнут конец файла
Ь',
>>> f.close()
В параметре можно указать количество символов или байтов, которое следует прочитать
из файла. В этом случае считывание будет выполняться до тех пор, пока не встретится
символ новой строки (\n), символ конца файла или из файла не будет прочитано указан
ное количество символов или байтов. Пример:
>>> f = open(r"c:\book\file.txt", "r", encoding="cpl251")
>>> f.readline(2), f.readline(2)
. ('Ст', 'ро')
>>> f.readline(lOO)# Возвращаются остатки данных
'кal\n'
»> f.close()
♦ readlines( [<Количество>] ) - считывает из текущего файла все строки и сводит их
в список, который и возвращает. Если файл открыт в текстовом подрежиме, возвращает
ся список строк, а если в двоичном - список объектов типа bytes. Каждая строка в спи
ске будет содержать символ перевода строки. Исключением является последняя стро
ка - если она не завершается символом перевода строки, таковой добавлен не будет.
Примеры:
>>>#Текстовый подрежим
>>> with open(r"c:\book\file.txt", "r", encoding="cpl251") as f:
f.readlines()
['Строкаl\n', 'Строка2']
>>>#Двоичный подрежим
>>> with open(r"c:\book\file.txt", "rb") as f:
f.readlines()
[b'\xdl\xf2\xf0\xee\xea\xe01\n', b'\xdl\xf2\xf0\xee\xea\xe02']
310 Часть /. Основы языка Python
В параметре можно указать количество символов или байтов, которое должно быть счи
тано из файла. Если указанное количество приходится на середину какой-либо строки,
эта строка считывается полностью. Если в файле хранится меньше символов (байтов),
чем указано, будет считано все содержимое файла. Примеры:
>>> f = open(r"c:\book\file.txt", "r", encoding="cpl251")
>>> f.readlines(4)
[ 'Строкаl \n']
>>> f.close()
>>> f = open(r"c:\book\file.txt", "r", encoding="cp1251")
>>> f.readlines(lO)
['Строкаl\n', 'Строка2']
>>> f.close()
♦ _next_() - при каждом вызове считывает из текущего файла одну строку и возвраща
ет ее. Если файл открыт в текстовом подрежиме, возвращается строка, а если в двоич
ном - последовательность байтов. При достижении конца файла генерируется исклю
чение Stopiteration. Пример:
>>> f = open(r"c:\book\file.txt", "r", encoding="cpl251")
>>> f. next (), f. next ()
( 'Строкаl \n', 'Строка2 ' )
>>> f. next () # Достигнут конец файла
Traceback (most recent call last):
File "<pyshell#26>", line 1, in <module>
f. next () # Достигнут конец файла
Stopiteration
>>> f.close()
Содержимое файла можно перебрать построчно в цикле перебора последовательности,
поскольку этот цикл на каждой итерации автоматически вызывает метод _next_().
Для примера выведем все строки, предварительно удалив символ перевода строки:
>>> f = open(r"c:\book\file.txt", "r", encoding="cpl251")
>>> for line in f: print(line.rstrip("\n"), end=" ")
Строкаl Строка2
>>> f.close()
♦ readaЫe() - возвращает True, если из текущего файла можно читать, и False - в про
тивном случае:
>>> f = open(r"c:\book\file.txt", "w") # Открываем файл дпя записи
>>> f.writaЫe()
False
>>> f = open(r"c:\book\file.txt", "r") # Открываем файл дпя чтения
>>> f.writaЫe()
True
♦ flush() - принудительно записывает данные из буфера на диск;
♦ fileno() - возвращает целочисленный дескриптор текущего файла. Возвращаемое зна
чение всегда будет больше числа 2, т. к. числа 0-2 закреплены за стандартными потока
ми ввода/вывода. Пример:
Глава 16. Работа с файлами и каталогами 311
>>> f = open(r"c:\book\file.txt", "r", encoding="cp1251")
»> f.fileno() # Дескриптор файла
3
>>> f.close()
♦ truncate( [<Количество>] ) - обрезает или увеличивает (с заполнением свободного мес
та нулями) текущий файл до указанного количества символов (если задан текстовый
подрежим) или байтов (в случае двоичного подрежима). Метод возвращает новый раз
мер файла. Пример:
>>> f = open(r"c:\book\file.txt", "r+", encoding="cp1251")
»> f.read()
'Строка1\nСтрока2'
>>> f.truncate(S)
5
>>> f.close()
>>> with open(r"c:\book\file.txt", "r", encoding="cp1251") as f:
f.read()
'Строк'
♦ tel1() - возвращает позицию указателя относительно начала текущего файла в виде
целого числа. В Windows при открытии файла в текстовом подрежиме метод считает
символ \r как дополнительный байт, хотя этот символ удаляется из считанных строк.
Пример:
>>> with open(r"c:\book\file.txt", "w", encoding="cp1251") as f:
f.write("Stringl\nString2")
15
>>> f = open(r"c:\book\file.txt", "r", encoding="cp1251")
>>> f. tel1() # Указатель расположен в начале файла
о
>>> f.readline() # Перемещаем указатель
'Stringl\n'
>>> f.tel1 () # Возвращает 9 (8 + '\r'), а не В!!!
9
>>> f.close()
♦ seek(<Смещение> [, <Позиtiия>] ) - устанавливает указатель текущего файла в позицию,
имеющую заданное <Смещение> относительно параметра <Позиция>. В качестве парамет
ра <Позиция> могут быть указаны следующие атрибуты из модуля io или соответствую
щие им значения:
• io.SEEK_SET или О - начало файла (значение по умолчанию);
• io. SEEK_CUR или 1 - те1<;ущая позиция указателя. Положительное значение смещения
вызывает перемещение к концу файла, отрицательное - к его началу;
• io.SEEK_END или 2 - конец файла.
Примеры:
>>> import io
>>> f = open(r"c:\book\file.txt", "rb")
312 Часть /. Основы языка Python
>>> f.seek(9, io.SEEK_CUR) # 9 байтов от указателя
9
»> f.tell()
9
>>> f.seek(O, io.SEEK_SET) # Перемещаем указатель в начало
о
>>> f.tel1()
о
>>> f.seek(-9, io.SEEK_END) # -9 байтов-от конца файла
7
>>> f.tel1()
7
>>> f.close()
♦ seekaЫe() - возвращает тrue, если указатель текущего файла можно переместить
в другую позицmо, и False - в противном случае:
>>> f = open(r"c:\book\file.txt", "r")
»> f.seekaЫe()
True
Объекты файлов поддерживают следующие атрибуты:
♦ name - имя текущего файла;
♦ mode - режим, в котором бьm открыт текущий файл;
♦ closed - хранит True, если текущий файл уже закрыт, и False - в противном случае:
>>> f = open(r"c:\book\file.txt", "r+b")
>>> f.name, f.mode, f.closed
('file.txt', 'rb+', False)
>>> f.close()
>>> f.closed
True
♦ encoding - название кодировки, в которой сохранен текущий файл. Доступен только
в текстовом подрежиме. Пример:
>>> f = open(r"c:\book\file.txt", "а", encoding="cp1251")
>>> f.encoding
'ср1251'
>>> f.close()
Стандартный поток вывода stdout также является файловым объектом. Атрибут
encoding этого объекта всегда содержит кодировку устройства вывода, поэтому строка
преобразуется в последовательность байтов в правильной кодировке. Например, при
запуске программы двойным ще-лчком мыши атрибут encoding будет иметь значение
"ср866", а при запуске в окне IDLE Shell- значение "utf-8" (в версиях Python, предше
ствовавших 3.7, атрибут хранил значение "ср1251 "). Пример:
>>> import sys
>>> sys.stdout.encoding
'utf-8'
♦ buffer - хранит ссьmку на объект буфера, в котором временно хранятся данные, запи
сываемые в текуший файл. Доступен только в текстовом подрежиме. Посредством этого
объекта можно записывать в файл последовательности байтов, например:
Глава 16. Работа с файлами и каталогами 313
>>> f = open(r"c:\book\file.txt", "w", encoding="cp1251")
>>> f.buffer.write(bytes("Cтpoкa", "ср1251"))
6
»> f.close()
16.3. Чтение и запись данных:
низкоуровневые инструменты
Python предоставляет ряд низкоуровневых функций, дающих больший контроль над читае
чыми и записываемыми данными и реализованных в модуле os:
♦ ореn(<Путь к файлу>, <Режим>[, rnode=0o777J)- открывает файл с заданным путем и
возвращает целочисленный дескриптор, с помощью которого производится дальнейшая
работа с этим файлом. Если файл открыть не удалось, генерируется исключение OSError
или одно из исключений, являющихся его подклассами (описаны в разд. 16.11). В пара
метре <Режим> в операционной системе Windows могут быть указаны следующие флаги
(или их комбинация через символ 1 ):
• os.о_RDONLY - чтение;
• os.о-WRONLY -запись;
• os.о_RDWR-чтение и запись;
• os.о_APPEND-дозапись;
• os.о_CREAT -создать файл, если он не существует и если не указан флаг os.о_EXCL;
• os.о_EXCL- при использовании совместно с os.о_CREAT указывает, что создаваемый
файл изначально не должен существовать, в противном случае будет сгенерировано
исключение FileExistsError;
• os.о_TEMPORARY - при использовании совместно с os.о_CREAT указывает создать
временный файл, который будет автоматически удален сразу после закрытия;
• os.O_SHORT_LIVED-TO же самое, что os.O_TEMPORARY, но созданный файл по возмож-
ности будет храниться в оперативной памяти;
• os.о_TRUNC -очистить содержимое открытого файла;
• os.о_ВINARY - файл будет открыт в двоичном подрежиме;
• os.о_ТЕХТ - файл будет открыт в текстовом подрежиме (в Windows файлы открыва-
ются в текстовом подрежиме по умолчанию).
Параметр rnode задает права доступа к созданному файлу.
Несколько примеров:
• открытие файла на запись и запись в него одной строки. Если файл не существует, он
будет создан, если существует -очищен:
>>> irnport os # Подключаем модуль
>>> rnode = os.O_WRONLY I os.O_CREAT I os.O_TRUNC
>>> f = os.open(r"c:\book\file.txt", rnode)
>>> os.write(f, b"Stringl\n") # Записываем данные
8
>>> os.close(f) # Закрываем файл
314 Часть /. Основы языка Python
• дозапись еще одной строки в конец файла:
>>> mode = os.O_WRONLY I os.O_CREAT 1. os.O_APPEND
>>> f = os.open(r"c:\book\file.txt", mode)
>>> os.write(f, b"String2\n")
в
>>> os.close(f)
• чтение файла в текстовом подрежиме:
>>> f = os.open(r"c:\book\file.txt", os.O_RDONLY)
>>> os.read(f, 50) # Читаем 50 байтов
b'Stringl\nString2\n'
>>> os.close(f)
• чтение файла в двоичном подрежиме:
>>> f = os.open(r"c:\book\file.txt", os.O RDONLY os.O_ВINARY)
>>> os.read(f, 50) # Читаем 50 байтов
b'Stringl\r\nString2\r\n'
>>> os.close(f)
♦ read(<Дескриптор>, <Количество байтов>) - читает из файла с заданным дескриптором
указанное количество байтов. При достижении конца файла возвращается пустая строка.
Пример:
>>> f = os.open(r"c:\book\file.txt", os.O_RDONLY)
>>> os.read(f, 5), os.read(f, 5), os.read(f, 5), os.read(f, 5)
(b'Strin', b'gl\nS', b'tring', b'2\n')
>>> os.read(f, 5) # Достигнут конец файла
Ь''
>>> os.close(f)
♦ write (<Дескриптор>, <Последовательность байтов>) - записывает заданную последо
вательность байтов в файл с указанным дескриптором. Возвращает количество записан
ных байтов;
♦ close(<Дескриптор>) - закрывает файл с заданным дескриптором;
♦ lsееk(<Дескриптор>, <Смещение>, <Позиция>) - устанавливает указатель файла с за
данным дескриптором в позицию, имеющую заданное <Смещение> относительно пара
метра <Позиция>. Возвращает новую позицию указателя. В качестве параметра <Позиция>
моrут быть указаны следующие атрибуты или соответствующие им значения:
• os.SEEK_SET или О - начало файла;
• os. SEEK_CUR или 1 - текущая позиция указателя;
• os.SEEK_END или 2 - конец файла.
Примеры:
>>> f = os.open(r"c:\book\file.txt", os.O_RDONLY I os.O_BINARY)
>>> os.lseek(f, О, os.SEEK_END) # Перемещение в конец файла
18
>>> os.lseek(f, О, os.SEEK_SET) # Перемещение в начало файла
о
Глава 1 б. Работа с файлами и каталогами 315
>>> os.lseek(f, 9, os.SEEK_CUR) # Относительно указателя
9
>>> os.lseek(f, о, os.SEEK_CUR) # Текущее положение указателя
9
>>> os.close(f)
♦ dup(<Дескриптор>) - возвращает дубликат заданного файлового дескриптора;
♦ fdopen(<Дескриптор> [, <Режим> [, <Размер буфера>]]) - возвращает файловый объект
по указанному дескриптору. Параметры <Режим> и <Размер буфера> имеют тот же смысл,
что и в функции open() (описана в разд. 16.1). Пример:
>>> fd = os.open(r"c:\book\file.txt", os.O_RDONLY)
»> fd
3
>>> f = os.fdopen(fd, "r")
>>> f.fileno() # Объект имеет тот же дескриптор
3
»> f.read()
'Stringl\nString2\n'
»> f.close()
16.4. Файлы в памяти
Python позволяет создавать файлы, хранящиеся в оперативной памяти. Такие файлы можно
открывать в текстовом или двоичном подрежиме, записывать и читать их данные, переме
щать их указатели.
Для создания файла в памяти и открытия его в текстовом подрежиме служит класс stringIO
из модуля io. Формат конструктора класса:
StringIO([<Haчaльнoe значение>][, ][newline='\n'])
Если первый параметр не указан, то начальным значением будет пустая строка . Параметр
::ewline задает символ, используемый для обозначения концов строк. После создания
объекта указатель текущей позиции устанавливается на начало файла.
Объект текстового файла в памяти поддерживает следующие методы:
♦ close() - закрывает текущий файл. Проверить, открыт файл или закрыт, позволяет
атрибут closed, который хранит True, если файл закрыт, и False - в противном случае;
♦ getvalue() - возвращает содержимое текущего файла в виде строки:
>>> import io # Подключаем модуль
>>> f = io.StringIO("Stringl\n")
>>> f.getvalue() # Получаем содержимое файла
'Stringl\n'
»> f.close() # Закрываем файл
♦ tel1 () - возвращает текущую позицию указателя относительно начала текущего файла;
♦ seek(<Смещение>[, <Позиция>J ) - устанавливает указатель текущего файла в позицию,
имеющую заданное <Смещение> относительно параметра <Позиция>. В качестве парамет
ра <Позиция> могут быть указаны следующие значения:
316 Часть /. Основы языка Python
• О - начало файла (значение по умолчанию);
• 1 - текущая позиция указателя;
• 2 - конец файла.
Примеры использования методов seek() и tel1 () :
>>> f = io.StringIO("Stringl\n")
>>> f.tel1 () # Позиция указателя
о
>>> f.seek(O, 2) # Перемещаем указатель в конец файла
8
>>> f.tel1 () # Позиция указателя
8
>>> f.seek(O) # Перемещаем указатель в начало файла
о
>>> f.tel1 () # Позиция указателя
о
>>> f.close()
♦ write(<Строка>) - записывает заданную строку в текущий файл:
>>> f = io.StringIO("Stringl\n")
>>> f.seek(O, 2) # Перемещаем указатель в конец файла
8
>>> f.write("String2\n") # Записываем строку в файл
8
>>> f.getvalue()
'Stringl\nString2\n'
>>> f.close()
♦ writelines(<Последовательность>) - записывает заданную последовательность строк
в текущий файл:
>>> f = io.StringIO()
>>> f.writelines(["Stringl\n", "String2\n"])
>>> f.getvalue()
'Stringl\nString2\n'
>>> f.close()
♦ read( [ <Количество символов>] ) - считьmает и возвращает данные из текущего файла.
За каждый вызов будет возвращаться указанное в параметре количество символов. Если
параметр не задан, возвращается содержимое файла от текущей позиции указателя до
конца файла. Когда достигается,конец файла, метод возвращает пустую строку. Пример:
»> f = io.StringIO("Stringl\nString2\n")
»> f.read()
'Stringl\nString2\n'
>>> f.seek(O) # Перемещаем указатель в начало «файла»
о
>>> f.read(S), f.read(S), f.read(S), f.read(S), f.read(S)
('Strin', 'gl\nSt', 'ring2', '\n', '')
>>> f.close()
Глава 16. Работа с файлами и каталогами 317
♦ readline( [<Количество символов>] ) - считывает из текущего файла очередную строку
и возвращает ее. Возвращаемая строка включает символ перевода строки. Исключением
является последняя строка - если она не завершается символом перевода, таковой до
бавлен не будет. При достижении конца файла возвращается пустая строка. Пример:
»> f = io .StringIO("Stringl\nString2")
>>> f.readline(), f.readline(), f.readline()
('Stringl\n', 'String2', '')
>>> f.close()
В параметре можно указать количество символов, которое требуется считать. В этом
случае считьrвание будет выполняться до тех пор, пока не встретится символ новой
строки (\n), конец файла или из файла не будет прочитано указанное количество симво
лов. Пример:
»> f = io.StringIO("Stringl\nString2\nString3\n")
>>> f.readline(5), f.readline(5)
('Strin', 'gl\n')
>>> f.readline(l00) # Возвращается одна строка, а не 100 символов
'String2\n'
>>> f.close()
♦ readlines( [ <Количество символов>] ) - считьrвает из текущего файла все строки и сво
дит их в список, который и возвращает. Каждая строка в списке будет содержать символ
перевода строки. Исключением станет последняя строка - если она не завершается
символом перевода, таковой добавлен не будет. Пример:
>>> f = io.StringIO("Stringl\nString2\nString3")
>>> f.readlines()
['Stringl\n', 'String2\n', 'String3']
>>> f.close() # Закрываем «файп»
В параметре можно указать количество символов, которое следует прочитать. В этом
случае будет считано указанное количество символов плюс фрагмент до символа конца
строки \n. Затем эта строка разбивается и добавляется построчно в список. Пример:
»> f = io.StringIO("Stringl\nString2\nString3")
>>> f.readlines(14)
[ 'Stringl\n', 'String2\n' ]
>>> f.seek(0) # Перемещаем указатель в начало «файла»
о
>>> f.readlines(17)
['Stringl\n', 'String2\n', 'String3']
>>> f.close() # Закрываем «Файп»
♦ _next_() - при каждом вызове считьrвает из текущего файла одну строку и возвраща
ет ее. При достижении конца файла генерируется исключение Stopiteration. Пример:
»> f = io.StringIO("Stringl\nString2")
>>> f._next (), f._next ()
('Stringl\n', 'String2')
>>> f. next ()
... Фрагмент опущен
Stopiteration
>>> f.close()
318 Часть /. Основы языка Python
Содержимое файла можно перебрать построчно в цикле перебора последовательности,
поскольку этот цикл на каждой итерации автоматически вызывает метод _next_() :
>>> f = io.StringIO("Stringl\nString2")
>>> for line in f: print(line .rstrip())
Stringl
String2
>>> f.close()
♦ flush() - принудительно записывает данные из буфера в текущий файл;
♦ truncate( [ <Количество символов>] ) - обрезает или увеличивает (с заполнением сво
бодного места нулями) текущий файл до указанного количества символов:
»> f = io.StringIO("Stringl\nString2\nString3")
>>> f.truncate(l5) # Обрезаем «файл»
15
>>> f .getvalue () # Получаем содержимое «файла»
'Stringl\nString2'
>>> f.close()
Если параметр не указан, то файл обрезается до текущей позиции указателя:
»> f = io.StringIO("Stringl\nString2\nString3")
>>> f.seek(l5) # Перемещаем указатель
15
>>> f.truncate() # Обрезаем файл до указателя
15
»> f.getvalue()
'Stringl\nString2'
>>> f.close()
Описанные в разд. 16.2 методы writaЫe(), readaЫe() и seekaЫe(), вызванные у объекта
класса StringIO, всегда возвращают тrue.
Для работы с файлами в памяти в двоичном подрежиме применяется класс Bytesro из мо
дуля io, аналогичный классу StringIO. Формат конструктора класса Bytesro:
BytesIO( [ <Начальное значение>] )
Класс Bytesro поддерживает те же методы, что и stringI.O, но в качестве параметров они
принимают и возвращают последовательности байтов. Рассмотрим основные операции на
примерах:
>>> import io
>>> f = io.BytesIO(b"Stringl\n")
>>> f.seek(O, 2) # Перемещаем указатель в конец файла
8
>>> f.write(b"String2\n") # пишем в файл
8
>>> f.getvalue() # Получаем содержимое файла
b'Stringl\nString2\n'
>>> f.seek(O) # Перемещаем указатель в начало файла
о
Глава 16. Работа с файлами и каталогами 319
>>> f.read() # Считываем данные
b'Stringl\nString2\n'
»> f.close() # Закрываем файл
Класс Bytesro также подцерживает метод getbuffer(), который возвращает ссылку на объ
ект memoryview. С помощью этого объекта можно получать и изменять данные по индексу
(только целые числа) или срезу (только последовательности байтов), преобразовывать дан
ные в список целых чисел (с помощью метода tolist()) или в последовательность байтов
(с помощью метода tobytes() ). Примеры:
>>> f = io.BytesIO(b"Python")
>>> buf = f.getbuffer()
>>> buf[О] # Получаем значение по индексу
80
>>> buf[0] = 81 # Изменяем значение по индексу
>>> Результат извлечения среза также будет объектом memoryview
»> buf[l:3]
<memory at Ох000001С48349ВАСО>
>>> bytes(buf[l:3])
b'yt'
>>> buf[l:3] = b"us" # Изменяем значение по срезу
»> f.getvalue()
b'Qushon'
»> f.getvalue() # Получаем содержимое
b'Qushon'
>>> buf.tolist() # Преобразуем в список
[81, 117, 115, 104, 111, 110]
>>> buf.tobytes() # Преобразуем в последовательность байтов
b'Qushon'
16.5. Задание прав доступа к файлам и каталогам
В операционных системах семейства UNIX каждому объекту (файлу или каталогу) назна
чаются права доступа, предоставляемые той или иной разновидности пользователей: вла
дельцу, группе, которой принадлежит владелец, и прочим. Могут быть назначены отдельные
права на чтение, запись и выполнение.
Права доступа обозначаются буквами:
♦ r - файл можно читать, а содержимое каталога - просматривать;
♦ w - файл можно модифицировать, удалять и переименовывать, в каталоге разрешается
создавать и удалять файлы, сам каталог можно переименовать или удалит)>;
♦ х - файл можно выполнять, в каталоге разрешается выполнять операции над файлами,
в том числе производить в нем поиск файлов.
Права доступа к файлу определяются записью типа:
-rw-r--r--
Первый символ ( -) означает, что это файл, и не задает никаких прав доступа. Далее три
символа (rw-) задают права доступа для владельца: чтение и запись, символ (-) здесь означа-
320 Часть /. Основы языка Python
ет, что права на выполнение нет. Следующие три символа задают права доступа для группы,
в которую входит владелец, - здесь только чтение (r--). Последние три символа (r--)
задают права для всех остальных пользователей - также только чтение.
Права доступа к каталогу определяются такой строкой:
drwxr-xr-x
Первая буква (d) означает, что это каталог. Владелец может выполнять в каталоге любые
действия (rwx), а его группа и все остальные пользователи - только читать и выполнять
поиск (r-x). Для того чтобы каталог можно было просматривать, должны быть установлены
права на выполнение (х).
Права доступа могут обозначаться и числом (маской прав доступа). Число состоит из трех
цифр: от О до 7. Первая цифра задает права для владельца, вторая - для его группы, а тре
тья - для всех остальных пользователей. Например, права доступа -rw-r--r-- соответст
вуют числу 644. Сопоставим числам, входящим в маску прав доступа, двоичную и буквен
ную записи (табл. 16.1).
Таблица 16.1. Права доступа в разных записях
Восьмеричная Двоичная Буквенная Восьмеричная Двоичная Буквенная
цифра запись запись цифра запись запись
о ООО --- 4 100 r--
1 001 --х 5 101 r-x
2 010 -w- 6 11О rw-
3 011 -wx 7 ' 111 rwx
Согласно этой таблице права доступа rw-r--r-- можно записать так: 110 100 100. То есть,
если право предоставлено, в соответствующей позиции стоит 1, а если нет - то О. Именно
поэтому число 11О 100 100 в двоичной записи соответствует числу 644 в восьмеричной.
Для проверки прав доступа к файлу или каталогу с указанным путем предназначена функ
ция access(<Путь>, <Режим>) из модуля os. Она возвращает True, 1 если проверка прошла
успешно, или False - в противном случае. В параметре <Режим> могут быть указаны сле
дующие константы, определяющие тип проверки:
♦ os .F_ок - проверка наличия файла или каталога:
♦ os . R_ок - проверка на возможность чтения файла или каталога;
♦ os.w_ок - проверка на возможность записи в файл или каталог;
♦ os.х_ок - определение, является ли файл или каталог выполняемым.
Примеры:
>>> import os
>>> os.access(r"c:\book\file.txt", os .F_OK) # Файл существует
True
>>> os.access(r"C:\book", os.F_OK) # Каталог существует
True
>>> os.access(r"C:\book2", os.F_OK) # каталог не существует
False
Глава 16. Работа с файлами и каталогами 321
Задать другие права доступа к файлу или каталогу с указанным путем можно вызовом
функции сhmоd(<Путь>, <Права доступа>) из модуля os. Права доступа задаются в виде
восьмеричного числа. Пример:
>>> os.chmod(r"c:\book\file.txt", 00777) #Полный доступ к файлу
Вместо числа можно указать комбинащпо констант из модуля stat. За дополнительной ин
формацией обращайтесь к документации по модуmо.
16.6. Работа с файлами
J,.rIЯ копирования и перемещения файлов предназначены следующие функции из модуля
5:;util:
♦ copyfile() - создает кomno исходного файла. Метаданные (например, дата последнего
доступа) и права доступа не копируются. Возвращает путь к созданной копии файла.
Формат вызова:
соруfilе(<Путь к исходному файлу>, <Путь к копии>[, follow_symlinks=Тrue])
Если оба заданных пути совпадают, генерируется искmочение SarneFileError из модуля
shtil. Если файл-копия существует, он будет перезаписан. Если файл не удалось скопи
ровать, генерируется искmочение OSError или одно из искmочений, являющихся произ
водным от этого класса. Примеры:
>>> import shutil #ПодКJIЮчаем модуль
>>> shutil.copyfile(r"c:\book\file.txt", r"c:\book\file2.txt")
'c:\\book\\file2.txt'
>>>#Путь не существует:
>>> shutil.copyfile(r"c:\book\file.txt", r"C:\book2\file2.txt")
... Фрагмент опущен ...
FileNotFoundError: [Errno 2] No such file or directory:
'C:\\book2\\file2.txt'
Исключение FileNotFoundError является производным от OSError и генерируется, если
указанный файл не найден (классы искmочений, генерируемых при файловых операци
ях, рассмотрены в разд. 16.11).
Если в первом параметре указать символическую ссылку на файл, будет создана копия
файла. Однако если при этом дать параметру follow_symlinks значение False, будет
создана копия символической ссылки;
♦ сору() - создает кomno исходного файл. Права доступа копируются, метаданные -
нет. Возвращает путь к созданной копии файла. Формат вызова:
сору(<Путь к исходному файлу>, <Путь к копии>[, follow_symlinks=True])
В качестве второго параметра также можно указать путь к каталогу, в котором следует
создать копию исходного файла, - тогда копия получит то же имя, что и исходный
файл. Если файл-копия существует, он будет перезаписан. Метод генерирует те же ис
ключения, что и метод copyfile(). Назначение параметра follow_symlinks такое же, как
и у метода copyfile(). Примеры:
>>> shutil.copy(r"c:\book\file.txt", r"c:\book\fileЗ.txt")
'c:\\book\\fileЗ.txt'
322 Часть /. Основы языка Python
>>> shutil.copy(r"c:\book\file.txt", r"d:\work")
'd:\\work\\file.txt'
♦ сору2() - аналогичен сору(), только копирует еще и метаданные:
>>> shutil.copy2(r"c:\book\file.txt", r"c:\book\file4.txt")
'c:\\book\\file4.txt'
♦ move() - перемещает исходный файл по местоположению целевого файла. Возвращает
путь к целевому файлу. Формат вызова:
mоvе(<Путь к исходному файлу>, <Путь к целевому файлу>[,
copy_function=shutil.copy2])
Во втором параметре также можно указать путь к каталогу, в который следует перемес
тить исходный файл, - тогда целевой файл получит то же имя, что и исходный. Если
целевой файл существует, он будет перезаписан. Метод генерирует те же искточения,
что и метод copyfile(). Пример:
>>> shutil.move(r"c:\book\file4.txt", r"d:\work")
'd:\\work\\file4.txt'
Перемещение файла выполняется в два этапа: создание его копии по целевому пути и
удаление исходного файла. Для создания копии файла на первом этапе применяется
функция, указанная в параметре copy_function. По умолчанию применяется функция
сору2(), однако можно указать другую (например, сору(), которая не копирует метадан
ные). Пример:
>>> shutil.move(r"c:\book\fileЗ.txt", r"d:\work", copy_function=shutil.copy)
'd:\\work\\fileЗ.txt'
Для переименования и удаления файлов предназначены следующие функции из модуля os:
♦ rename(<Путь к файлу>, <Путь с новым именем>) - меняет имя файла с указанным пу
тем на заданное новое (указывается вместе с путем к файлу). Если файл не удалось
переименовать, генерируется искточение OSError или одно из искточений, производных
от этого класса. Пример:
import os # Подключаем модуль
try:
os.rename(r"d:\work\fileЗ.txt", r"d:\work\file5.txt")
except OSError:
print("Фaйл не удалось переименовать")
else:
print("Файл успешно переименован")
♦ rеmоvе(<Путь к файлу>) и unlink(<Пyть к файлу>) -удаляют файл с указанным путем.
Если файл не удалось удалить, генерируется искточение OSError или одно из искточе
ний, производных от этого класса. Примеры:
>>> os.remove(r"c:\book\file2.txt")
>>> os.unlink(r"d:\work\file5.txt")
Функции, позволяющие проверить наличие файла, получить размер файла и др., содержатся
в модуле os.path:
♦ exists(<Путь или дескриптор>) - возвращает True, если файл с указанным путем суще
ствует, и False - в противном случае. В качестве параметра можно также указать цело-
Глава 16. Работа с файлами и каталогами 323
числе1rnый дескриптор открытого файла, возвращенный функцией open() из того же мо
дуля os. Примеры:
>>> import os.path
>>> os.path.exists(r"c:\book\file.txt")
True
>>> os.path.exists(r"c:\book\file2.txt")
False
♦ getsize(<Путь к файлу>) - возвращает размер файла с указанным путем в байтах. Если
файл не существует, генерируется исключение OSError. Пример:
>>> os.path.getsize(r"c:\book\file.txt") # Файл существует
18
♦ getatime(<Путь к файлу>) - возвращает время последнего обращения к файлу с ука
занным путем в виде количества секунд, прошедших с начЩiа эпохи. Если файл не
существует, генерируется исключение osEr:ror. Пример:
>>> import time # Подключаем модуль time
>>> t = os.path.getatime(r"c:\book\file.txt")
>>> t
1643369508.5388174
>>> time .strftime("%d.%m.%Y %H:%M:%S", time.localtime(t))
'28.01 .2022 14:31:48'
♦ getctime (<Путь к файлу>) - возвращает дату создания файла с указанным путем в виде
количества секунд, прошедших с начала эпохи. Если файл не существует, генерируется
исключение OSError. Пример:
>>> t = os.path.getct:i.me(r"c:\book\file.txt")
>>> t ,
1643210664.3589096
>>> time.strftime("%d.%m.%Y %H:%M:%S", time.localtime(t))
'26.01.2022 18:24:24'
♦ getmtime(<Путь к файлу>) - возвращает время последнего изменения файла с указан
ным путем в виде количества секунд, прошедших с начала эпохи. Если файл не сущест
вует, генерируется исключение OSError. Пример:
>>> t = os.path.getmtime(r"c:\book\file.txt")
>>> t
1643297017.4162638
>>> time.strftime("%d.%m.%Y %H:%M:%S", time.localtime(t))
'27.01.2022 18:23:37'
Получить размер файла с указанным путем, временами создания и последних изменения
11обращения к файлу, а также значения дРуrих метаданных позволяет функция stat() из
чодуля os. Формат вызова функции:
5саt(<Путь к файлу>[, follow_symlinks=Тrue])
Если первым параметром задана символическая ссылка на файл, будут выданы сведения
о файле. Однако если при этом дать параметру follow_symlinks значение False, функция
выдаст сведения о самой символической ссылке.
324 Часть /. Основы языка Python
Функция возвращает объект stat_result, содержащий атрибуты: st_mode, st_ino, st_dev,
st_nlink, st_uid, st_gid, st_size, st_atime, st_mtime и st_ctime.
Пример использования функции stat():
>>> import os, time
>>> s = os.stat(r"c:\book\file.txt")
>>> s
os.stat result(st mode=33206, st_ino=37436171902544313, st_dev=2163356289,
st_nlink=l, st_uid=0, st_gid=0, st_size=l8,
st_atime=l643369508, st_mtime=l643297017,
st_ctime=l643210664)
>>> s.st size # Размер файла
18
>>> t = s.st atime # Время nоследнего обращения к файлу
>>> time.strftime("%d.%m.%Y %H:%M:%S", time.localtime(t))
'28.01.2022 14:31:48'
>>> t = s.st_ctime # Время создания файла
>>> time.strftime("%d.%m.%У %Н:%М:%S", time.localtime(t))
'26.01.2022 18:24:24'
>>> t = s.st_mtime # Время последнего изменения файла
>>> time.strftime("%d.%m.%У %Н:%М:%S", time.l.ocaltime(t))
'27.01.2022 18:23:37'
Изменить время последнего обращения и время изменения файла позволяет функция
utime() из модуля os. Ее формат:
utime(<Путь к файлу или его дескриптор> [,
(<Последний доступ>, <Изменение файла>)][, follow_symlinks=True])
Первым параметром также можно указать целочисленный дескриптор открытого файла,
возвращенный функцией open () из модуля os. Вторым параметром указывается кортеж из
новых значений в виде количества секунд, прошедших с начала эпохи. Если второй пара
метр не задан, то время обращения и изменения файла будет заменено на текущее. Если
первым параметром задана символическая ссылка на файл, будут выданы сведения о файле.
Однако если при этом дать параметру follow_symlinks значение False, функция выдаст
время последнего обращения и изменения у самой символической ссьшки. Eciiи файл не
существует, генерируется исключение OSError. Пример использования функции utime():
>>> import os, time
»> t = time.time() - 600
>>> os.utime(r"c:\book\file.txt", (t, t)) # Текущее время минус 600 с
>>> s = os.stat(r"c:\book\file.txt")
>>> s.st_atime, s.st_mtime
(1643381757.3795638, 1643381757.3795638)
>>> os.utime(r"c:\book\file.txt") # Текущее время
>>> s = os.stat(r"c:\book\file.txt")
>>> s.st_atime, s.st_mtime
(1643382541.5189254, 1643382541.5189254)
Глава 16. Работа·с файлами и каталогами 325
16.7. Работа с путями
Выполнить различные действия с файловыми путями позволяют следующие функции из
�одуля os.path:
♦ аЬsраth(<Относительный путь>) - преобразует заданный относительный путь в абсо
лютный, учитывая местоположение текущего рабочего каталога, и возвращает результат
преобразования:
>>> irnport os, os.path
>>> os.chdir(r"c:\book")
>>> os.path.abspath(r"file.txt")
'c:\\book\\file.txt'
>>> os.path.abspath(r"folderl/file.txt")
'c:\\book\\folderl\\file.txt'
>>> os.path.abspath(r"../file.txt")
'c:\\file.txt'
♦ isabs(<Путь>) _:_ возвращает True, если заданный путь является абсолютным, и False -
в противном случае:
>>> os.path.isabs(r"C:\book\file.txt")
True
>>> os.path.isabs("file.txt")
False
♦ basenarne(<Путь>) - возвращает последний сегмент указанного пути (имя файла или
последнего каталога в пути):
>>> os.path.basenarne(r"C:\book\folderl\file.txt")
'file.txt'
>>> os.path.basenarne(r"C:\book\folder")
'folder'
>>> os.path.basenarne("C:\\book\\folder\\")
♦ dirnarne(<Путь>) - возвращает заданный путь без последнего сегмента:
>>> os.path.dirnarne(r"C:\book\folder\file.txt")
'C:\\book\\folder'
>>> os.path.dirnarne(r"C:\book\folder")
'С:\\book'
»> os.path.dirnarne("C:\\book\\folder\\")
'C:\\book\\folder'
♦ split(<Путь>) - возвращает кортеж из двух элементов: заданного пути без последнего
сегмента и последнего сегмента этого пути:
>>> os.path.split(r"C:\book\folder\file.txt")
('С:\\book\\folder', 'file.txt')
>>> os.path.split(r"C:\book\folder")
('С:\\book', 'folder')
>» os.path.split("С:\\book\\folder\\")
('С:\\book\\folder', ")
326 Часть /. Основы языка Python
♦ splitdrive(<Путь>) - возвращает кортеж из двух эл�ментов: обозначения диска, взято
го из заданного пути, и остального пути без обозначения диска:
>>> os.path.splitdrive(r"C:\book\folder\file.txt")
('С:', '\\book\\folder\\file.txt')
♦ splitext(<Путь>) - возвращает кортеж из двух элементов: пути с именем файла, путь
к которому был указан в параме-rре, без расширения, и расширения файла (фрагмента
после последней точки):
>>> os.path.splitext(r"C:\book\folder\file.tar.gz")
('С:\\book\\folder\\file.tar', '.gz')
♦ j oin(<Сегмент 1> [, . . ., <Сегмент N>] ) - возвращает путь, составленный из указан
ных сегментов:
>>> os.path.join("C:\\", "book\\folder", "file.txt")
'C:\\book\\folder\\file.txt'
>>> os.path.join(r"C:\\", "book/folder/", "file.txt")
'C:\\\\book/folder/file.txt'
В последнем примере в пути использованы разные слеши, что дало в результате некор
ректный путь. Чтобы этот путь сделать корректным, необходимо воспользоваться функ
цией nопnраth(<Путь>) из того же модуля os.path:
>>> р = os.path.join(r"C:\\", "book/folder/", "file.txt")
>>> os.path.noпnpath(p)
'C:\\book\\folder\\file.txt'
♦ соmmоnраth(<Последовательность nутей>) - возвращает самый длинный общий фраг
мент, расположенный в начале путей из заданной последовательности. Обрабатывает
пути посегментно. Пример:
>>> os.path.commonpath((r"c:\book\folderl", r"c:\book\folder2",
r"c:\book\found"))
'c:\\book'
♦ commonprefix() - аналогична commonpath(), только обрабатывает пути посимвольно
(вследствие чего возвращенный путь может оказаться несуществующим):
>>> os.path.commonprefix((r"c:\book\folderl", r"c:\book\folder2",
r"c:\book\found"))
'c:\\book\\fo'
16.8. Перенаправление ввода/вывода
Стандартные потоки ввода/вывода схожи с файловыми объектами. Они имеют целочислен
ные дескрипторы: стандартный поток ввода stdin - О, поток вывода stdout - 1, поток
вьmода ошибок stderr - 2. Потоки stdout и stderr поддерживают метод write(), а поток
stdin - метод readline().
Если потоку stdout или stderr присвоить ссылку на файловый объект, то можно перена
править стандартный вывод в соответствующий файл:
>>> import sys # Подключаем модуль sys
>>> tmp_out = sys.stdout # Сохраняем ссыnку на поток stdout
Глава 16. Работа с файлами и каталогами 327
>>> f = open(r"c:\book\file.txt", "а") # Открываем файл на дозапись
>>> sys .stdout = f # Перенаправляем вывод в файл
>>> рrint("ПИШем строку в файл")
>>> sys.stdout = tmp_out # Восстанавливаем стандартный вывод
»> f.close() # Закрываем файл
>>> рrint("ПИШем строку в стандартный вывод")
пишем строку в стандартный вывод
Функция print() напрямую поддерживает перенаправление вьшода. Для этого использует-
я параметр file, который по умолчанию ссылается на стандартный поток вывода. Напри
\tер, записать строку в файл можно так:
>>> f = open(r"c:\book\file.txt", "а")
>>> рrint("ПИШем строку в файл", file=f)
>>> f. close ()
Параметр flush позволяет указать, когда следует выполнять непосредственное сохранение
.:шнных из промежуточного буфера в файл. Если его значение равно False (значение по
�"\fолчанию), сохранение будет выполнено лишь после закрытия файла или после вызова
\lетода flush(). Чтобы указать интерпретатору Python выполнять сохранение после каждого
вызова функции print(), следует присвоить этому параметру значение True, например:
>>> f = open(r"c:\book\file.txt", "а")
>>> рrint("ПИШем строку в файл", file=f, flush=True)
»> рrint("ПИШем другую строку в файл", file=f, flush=True)
>>> f.close()
Стандартный ввод stdin также можно перенаправить. В этом случае функция input() будет
читать одну строку из файла при каждом вызове. При достижении конца файла возникнет
исключение EOFError. Для примера выведем содержимое файла с помощью перенаправле
ния потока ввода (листинг 16.1).
Листинг·1в.1. Перенаnравnение потока ввода
:_,'!lport sys
:'!lp_in = sys.stdin #·Сохраняем ссылку на поток stdin
:: = operi(r"c:\book\file.txt", "r") # Открываем файл на чтение
sys.stdin = f # Перенаправляем ввод
·,.-:,ile True:
try:
line = input() # Считываем строку из файла
print(line) # Выводим строку
except EOFError: # Если достигнут конец файла,
break # выходим из цикла
sys.stdin tmp_in # Восстанавливаем стандартный ввод
:: . close() # Закрываем файл
�nput()
\1етод isatty() объекта стандартного потока ввода возвращает True, если объект потока
ссылается на консоль, и False - в противном случае:
>>> tmp_in = sys.stdin # Сохраняем ссылку на поток stdin
>>> f = open(r"c:\book\file.txt", "r")
328 Часть /. Основы языка Python
>>> sys.stdin = f # Перенаправляем ввод
>>> sys.stdin.isatty() # Не ссыпаемся на терминал
False
>>> sys.stdin = tmp_in # Восстанавливаем стандартный ввод
>>> sys.stdin.isatty() # Ссьmаемся на терминал
True
>>> f.close() # Закрываем файл
С помощью стандартного вывода stdout можно создать индикатор процесса непосредст
венно в консоли. Сделать это можно, используя символ перевода каретки \r, чтобы перемес
титься в начало строки и перезаписать ранее выведенную информацию. Рассмотрим вывод
индикатора процесса на примере (листинг 16.2).
import sys, time
for i in· range (5, 101, 5) :
sys.stdout.write("\r %s%%" % i) # Обновляем индикатор
sys.stdout.flush() # Сбрасываем содержимое буфера
time.sleep(l) # Засьmаем на l секунду
sys.stdout.write("\rПpoцecc завершен\n")
input()
Сохраним код из листинга в файле и запустим его щелчком мыши. Индикатор процесса
в консоли будет обновляться каждую секунду.
16.9. Сохранение объектов в файлах
Сохранить объект в файле и в дальнейшем восстановить этот объект из файла позволяют
модули pickle и shelve.
Модуль pickle предоставляет следующие функции:
♦ dumр(<Объект>, <Файл>[, <Протокол>][, fix_imports=True]) - производит сериализа
цию заданного объекта и записывает его в указанный файл. В параметре <Файл> указыва
ется файловый объект, открытый на запись в двоичном подрежиме. Пример:
>>> import pickle
>>> f = open(r"c:\book\file .txt", "wb")
>>> obj = ["Строка", (2, 3)]
>>> pickle.dump(obj, f)
>>> f.close()
Формат, в котором: представляется сериализованное значение, зависит от указанного
протокола, который задается в виде числа от О до значения константы pickle.НIGHEST_
PROТOCOL. Если протокол не указан, будет использован протокол 4 (переменная
pickle.DEFAULT_PROТOCOL, до Python 3.8 этот параметр имел значение по умолчанию 3);
♦ load(<Файл>) - читает данные из указанного файла и преобразует их в исходный объ
ект, который и возвращает. В параметре <Файл> указывается файловый объект, открытый
на чтение в двоичном подрежиме. Пример:
Глава 16. Работа с файлами и каталогами 329
>>> f = open(r"c:\book\file.txt", "rb")
>>> obj = pickle.load(f)
»> obj
['Строка', (2, 3)]
»> f.close()
В одном файле можно сохранить сразу несколько объектов, последовательно вызывая
функцmо dump ():
>>> objl = ["Строка", (2, 3)]
>>> obj2 = (1, 2)
>>> f = open(r"c:\book\file.txt", "wb")
>>> pickle.dump(objl, f) # Сохраняем первьм объект
>>> pickle.dump(obj2, f) # Сохраняем второй объект
»> f.close()
Для восстановления объектов из файла необходимо несколько раз вызвать функцию load():
>>>f = open(r"c:\book\file.txt", "rb")
>>>objl = pickle.load(f) # Восстанавливаем первьм объект
>>>obj2 = pickle.load(f) # Восстанавливаем второй объект
»> objl, obj2
( ['Строка', (2, 3)], (1, 2))
»> f.close()
Сохранить объект в файл можно также с помощью метода dumр(<ООъект>) класса Pickler.
f.-:онструктор класса имеет следующий формат:
?�сklеr(<Файл>[, <Протокол>])
Параметры, передаваемые конструктору, аналогичны таковым у функции dump(). Пример:
>>> f = орел (r"c:\book\file.txt", "wb")
>>> obj = ["Строка", (2, 3)]
>>> pkl = pickle.Pickler(f)
>>> pkl.dump(obj)
»> f.close()
Восстановить объект из файла позволяет метод load() класса unpickler. Формат конструк
тора класса:
·;:1pickler (<Файл>)
Задаваемый параметр аналогичен таковому у функции load(). Пример:
>>> f = open(r"c:\book\file.txt", "rb")
,» obj = pickle.Unpickler(f).load ()
>» obj
[' Строка', (2, 3)]
»> f.close()
'v1одуль shelve позволяет сохранять объекты под заданными строковыми ключами, форми
руя в файле нечто похожее на словарь. Для сериализации объекта используются возмож
ности модуля pickle, а для его записи в файл - модуль dЬm.
Открыть файл с указанным путем , хранящий набор . объектов, позволяет функция орел ().
Функция имеет следующий формат:
Jреn(<Путь к файлу>[, flag="c"] [, protocol=None] [, writeback=False])
330 Часть /. Основы языка Python
В параметре flag можно указать режим открытия файла в виде строкового обозначения:
♦ r - то�ько чтение;
♦ w - чтение и запись;
♦ с - чтение и запись (значение по умолчанию). Если файл не существует, он будет соз
дан;
♦ n - чтение и запись. Если файл не существует, он будет создан. Если файл существует,
он будет перезаписан.
Параметр protocol задает протокол, применяемый при сериализации записываемых объек
тов, в виде числа от О до 4. По умолчанию используется значение переменной
pickle.DEFAULT_PROТOCOL (4). Если параметру writeback дать значение True, считываемые
из файла объекты будут кешироваться в памяти, что в ряде случаев может повысить произ
водительность.
Функция open() возвращает объект, представляющий открытый файл. В этот объект можно
добавлять новые элементы · и считывать существующие, применяя тот же синтаксис, что
используется для работы с отображениями (см. главу 9).
Объект-файл поддерживает следующие методы:
♦ close() - закрывает текущий файл. Для примера создадим файл и сохраним в нем спи
сок и кортеж:
>>> import shelve # Подключаем модуль
>>> dЬ = shelve.open(r"c:\book\dЬl.dat") # Открываем файл
>>> dЬ["objl"] = [1, 2, 3, 4, 5] # Сохраняем список
>>> dЬ["obj2"] = (6, 7, 8, 9, 10) # Сохраняем кортеж
>>> dЬ["objl"], dЬ [ "obj2"] # Выводим значения
( (1, 2, 3, 4, 5], (6, 7, 8, 9, 10))
>>> dЬ. close() # Закрываем файл
♦ keys() - возвращает объект с ключами, хранящимися в текущем файле;
♦ values() - возвращает объект со значениями, хранящимися в текущем файле;
♦ items() - возвращает итератор, который на каждой итерации выдает кортеж, содержа
щий очередные ключ и значение:
>>> dЬ = shelve.open(r" dЬl.dat")
>>> dЬ.keys(), dЬ.values()
(KeysView(<shelve.DbfilenameShelf object at 0x0000023FB67FA110>),
ValuesView(<shelve.DbfilenameShelf object at 0x0000023FB67FA110>))
>>> list(dЬ.keys()), list(dЬ.values())
(['objl', 'obj2'], [[1, 2, 3, 4, 5], (6, 7, 8, 9, 10)])
»> dЬ.items()
ItemsView(<shelve.DbfilenameShelf object at 0x0000023FB67F9FF0>)
>>> list(dЬ.items())
[('objl', (1, 2, 3, 4, 5]), ('obj2', (6, 7, 8, 9, 10))]
>>> dЬ.close()
♦ get(<Кrnоч> [, <Значение по умолчанию> J ) - возвращает значение, записанное в теку
щем файле под указанным ключом. Если ключ отсутствует, возвращается �начение None
или значение, указанное во втором параметре;
♦ setdefault(<Кrnоч> [, <Значение по умолчанию> J ) - возвращает значение, сохраненное
в текущем файле под указанным ключом. Если ключ отсутствует, создается новый эле-
Глава 16. Работа с файлами и каталогами 331
мент со значением, указанным во втором параметре, и в качестве результата возвраща
ется это значение. Если второй параметр не указан, значением нового элемента будет
None;
♦ рор(<Ключ> [, <Значение no умолчанию>]) - удаляет из текущего файла элемент с ука
занным кточом и возвращает его значение. Если кточ отсутствует, возвращается значе
ние из второго параметра. Если кточ отсутствует и второй параметр не указан, генери
руется искточение KeyError;
♦ popitem() - удаляет из текущего файла последний элемент и возвращает кортеж из его
кточа и значения (в версиях Python, предшествовавших 3.7, метод удалял произвольный
элемент). Если файл пустой, генерируется искточение KeyError;
♦ clear() -удаляет из текущего файла все элементы. Ничего не возвращает;
♦ update() - добавляет элементы в текущий файл. Ничего не возвращает. Если элемент
с указанным кточом уже присутствует, то его значение будет перезаписано. Форматы
метода:
uрdаtе(<Ключ !>=<Значение 1>[, . . ., <Ключ N>=<Значение N>])
uрdаtе(<Словарь>)
uрdаtе(<Список кортежей с двумя элементами: ключом и значением>)
uрdаtе(<Список списков с двумя элементами: ключом и значением >)
Помимо этих методов, можно пользоваться функцией len () для получения количества эле
ментов, оператором del для удаления заданного элемента, операторами in и not in для
проверки существования или несуществования кточа:
>>> с:1Ь = shelve .open(r"c:\book\c:!Ьl .dat")
>>> len(c:IЬ) # Количество элементов
2
>>> "objl" in с:1Ь
True
>>> del c:IЬ["objl"] # Удаление элемента
>>> "objl" in с:1Ь
False
>>> "objl" not in с:1Ь
True
>>> dь.close()
16.1 О. Работа с каталогами
Для работы с каталогами служат следующие функции из модуля os:
♦ mkdir(<Имя каталога> [, <Права доступа>]) - создает в текущем рабочем каталоге
новый каталог с указанными именем и правами доступа. Права доступа задаются вось
меричным числом (по умолчаншо: Оо777). Пример:
>>> os .mkdir("newfolder")
♦ makedlrs(<Путь>[, mode=Oo777] [, exist_ok=False]) - создает каталог с указанным
путем, также создавая все каталоги, записанные в заданном пути, если они не сущест
вуют:
>>> os .makedirs(r"c:\book\folder3\folder4\folder5")
332 Часть /. Основы языка Python
Параметр mode задает права доступа у созданных каталогов. Если каталог с указанным
путем существует и параметру exist_ok дано значение False, будет сгенерировано ис
кmочение FileExistsError, если же параметру дать значение True, ничего не произой
дет;
♦ rmdir(<Имя каталога>) - удаляет каталог с заданным именем из текущего рабочего
каталога. Можно удалить лишь пустой каталог. Если каталог не пуст или не существует,
генерируется искmочение, производное от класса OSError. Пример:
>>> os.rmdir("newfolder")
♦ listdir (<Путь>) - возвращает список имен файлов и каталогов, хранящихся в каталоге
с указанным путем:
»> os.listdir("C:\\book\\folderl\\")
['filel.txt', 'file2.txt', 'fileЗ.txt', 'folderl', 'folder2']
♦ walk() - последовательно просматривает сначала начальный каталог, потом вложенные
в него каталоги, потом каталоги следующего уровня 13ложенности и выдает хранящиеся
в них файлы и каталоги. Формат функции:
wаlk(<Путь к начальному каталогу>[, topdown=True] [, onerror=None] [,
followlinks=False])
Функция walk() возвращает итератор, при каждом вызове выдающий кортеж из трех
элементов: пути к очередному каталогу, списка путей к каталогам и списка путей к фай
лам, находящимся в этом каталоге.
Параметр onerror задает поведение функции при возникновении ошибки. Значение None
(используется по умолчанию) предписывает ничего не делать при их возникновении.
Также можно указать функцию, которая должна принимать в качест�е параметра объект
искmочения. Эта функция может как просто сообщить об ошибке (тогда ж:полнение
функции walk() продолжится), так и сгенерировать другое исключение (что вызовет
прерьшание работы функции walk()).
Параметр followlinks указывает функции, как поступить, если встретится символиче
ская ссылка: проследовать по ней (значение тrue) или не следовать по ней (значение
False, используемое по умолчанию).
Параметр topdown задает последовательность обхода каталогов. Если в качестве значе
ния указано тrue (значение по умолчанию), последовательность обхода будет такой:
»> for (р, d, f) in os.walk("C:\\book\\folderl\\"): print(p)
C:\book\folderl\
C:\book\folderl\folderl 1
C:\book\folderl\folderl_l\folderl 1 1
C:\book\folderl\folderl_l\folderl_l_2
C:\book\folderl\folderl_2
Если в параметре topdown указано значение False, последовательность обхода будет
другой:
>>> for (р, d, f) in os.walk("C:\\book\\folderl\\", False): print(p)
C:\book\folderl\folderl l\folderl 1 1
C:\book\folderl\folderl l\folderl_l_2
Глава 16. Работа с файлами и каталогами 333
C:\book\folderl\folderl_l
C:\book\folderl\folderl_2
C:\book\folderl\
Благодаря такой последовательности обхода перед удалением заданного каталога можно
удалить все находящиеся в нем файлы и каталоги (поскольку функция rmdir() позволяет
удалять только пустые каталоги):
import os
for (р, d, f) in os.walk("C:\\book\\folderl\\", topdown=False):
for file_name in f: # Удаляем все файлы
os.remove(os.path.join(p, file_name))
for dir_name in d: # Удаляем все каталоги
os.rmdir(os.path.join(p, dir_name))
ВНИМАНИЕ!
Очень осторожно используйте этот код. Если в качестве первого параметра в функции
walk() указать корневой каталог диска, то все имеющиеся в нем файлы и каталоги будут
удалены.
Удалить дерево каталогов позволяет также функция rmtree() из модуля shutil. Функ
ция имеет следующий формат:
rmtree(<Пyть>[, <Обработка ошибок>[, <Обработчик ошибок>]])
Если в параметре <Обработка ошибок> указано значение True, ошибки будут проигнори
рованы. Если указано значение False (используется по умолчанmо), в третьем параметре
можно задать ссылку на функцию, которая будет вызываться при возникновении искmо
чения. Указываемая функция должна принимать три параметра: ссылку на функцию,
выполнение которой вызвало возникновение ошибки, путь к файлу или каталогу, по
пытка удаления которого вызвала ошибку, и объект со сведениями о возникшей ошибке.
Пример:
import shutil
shutil.rmtree("C:\\book\\folderl\\")
♦ path.normcase(<Путь>) - преобразует заданный путь к каталогу к виду, подходящему
для использования в текущей операционной системе. В Windows преобразует все пря
мые слеши в обратные. Также во всех системах приводит все буквы пути к нижнему
р�гистру. Пример:
>>> os.path.normcase(r"c:/BoOk/filE.TxT")
'c:\\book\\file.txt'
Проверить, на что указывает заданный путь, можно с помощью следующих функций из
модуля os.path:
♦ isdir(<Путь>) - возвращает True, если заданный путь указывает на каталог, и False -
в противном случае:
>>> import os.path
>>> os.path.isdirlr"C:\book\file.txt")
False
>>> os.path.isdir("C:\\book\\")
True
334 Часть /. Основы языка Python
♦ isfile(<Путь>) - возвращает True, если заданный путь указывает на файл, и False -
в противном случае:
>>> os.path.isfile(r"C:\book\file.txt")
True
»> os.path.isfile("C:\\book\\")
False
♦ islink(<Пyть>) - возвращает True, если заданный путь указывает на символическую
ссылку, и False - в противном случае. Если символические ссылки не поддержив!lются,
функция возвращает False.
Описанная ранее функция listdir () возвращает список всех файлов и каталогов, что хра
нятся в указанном каталоге. Если необходимо ограничить список определенными крите
риями, следует воспользоваться функцией glob() из модуля glob. Она во;звращает список
путей к файлам и каталогам, имена которых совпадают с заданным путем-шаблоном. Фор
мат вызова этой функции:
glоЬ(<Пут�-шаблон>[, recursive=False][, root_dir=None])
Задаваемый путь-шаблон - это обычный путь, в котором можно использовать следующие
специальные символы:
♦ ? - любой одиночный символ;
♦ * - любое количество символов;
♦ [<Символы>] - символы, которые должны быть на этом месте в пути. Можно задать
символы или определить .и х диапазон через дефис;
♦ ** - любой файл или каталог.
Допускается указать как абсолютный, так и относительный путь-шаблон. Последний в этом
случае будет отсчитываться от текущего рабочего каталога. Примеры:
»> import glob
»> glob.glob("С:\\book\\folderl\\*.txt")
['C:\\book\\folderl\\file.txt', 'C:\\book\\folderl\\filel.txt',
'C:\\book\\folderl\\file2.txt']
»> glob.glob("C:\\book\\folderl\\*.html") # Абсолютный путь-шаблон
['C:\\book\\folderl\\index.html']
>>> glob.glob("folderl/*.html") # Относительный путь-шаблон
['folderl\\index.html']
»> glob.glob("C:\\book\\folderl\\*[0-9].txt")
['C:\\book\\folderl\\filel.txt', 'C:\\book\\folderl\\file2.txt']
»> glob.glob("C:\\book\\folderl\\*\\*.html")
['C:\\book\\folderl\\folderl_l\\index.html',
'C:\\book\\folderl\\folderl_2\\test.html']
»> glob.glob("C:\\book\\folderl\\**")
['C:\\book\\folderl\\file.txt', 'C:\\book\\folderl\\filel.txt',
'C:\\book\\folderl\\file2.txt', 'C:\\book\\folderl\\folderl_l',
'C:\\book\\folderl\\folderl_2']
Если параметр recursive имеет значение тrue, специальный символ **, будучи указанным
в качестве сегмента пути-шаблона, обозначает любое количество каталогов, вложенных
друг в друга:
Глава 1 б. Работа с файлами и каталогами 335
>>> glob.glob("C:\\book\\**\\*.html", recur5ive=Тrue)
['C:\\book\\folderl\\index.html',
'C:\\book\\folderl\\folderl_l\\index.html',
'C:\\book\\folderl\\folder1_2\\te5t.html']
В параметре root_dir (поддерживается, начиная с Python 3.10) можно указать путь к ката
логу, от которого будет отсчитываться относительный путь-шаблон:
>>> glob.glob("folderl/*.html", root_dir ="c:\\book")
['folderl\\index.html']
1·&.10.1. Функция scandir()
Функция 5candir( [ <Путь> J ) из модуля 05 выполняет просмотр содержимого каталога с ука
занным путем. Если путь не задан, будет использоваться значение "." (путь к текушему
рабочему каталогу).
Функция 5candir() возвращает итератор, на каждом проходе выдающий очередной файл
или каталог, который находится по указанному пути. Этот файл или каталог представляется
объектом класса DirEntry, определенного в том же модуле 05, который хранит всевозмож
ные сведения о файле (каталоге).
Класс DirEntry поддерживает следующие атрибуты:
♦ name - имя файла (каталога);
♦ path - путь к файлу (каталогу), составленный из пути, что был указан в вызове функ-
ции 5candir(), и имени файла (каталога), хранящегося в атрибуте name.
Выведем список всех файлов и каталогов, находящихся в текушем рабочем каталоге (при
вводе команд в IDLE Shell текушим рабочим станет каталог, где установлен Python):
>>> import 05
>>> for entry in 05.5Candir():
print(entry.path)
./DLL5
./Doc
./include
... Фрагмент пропущен
./Tool5
./vcruntime140.dll
./vcruntime140_1.dll
Видно, что путь, хранимый атрибутом path, составляется из пути, заданного в вызове функ
ции 5candir() (в нашем случае это используемый по умолчанию путь . ), и имени файла
(каталога). Теперь попробуем указать путь явно:
>>> for entry in o5.5candir("c:\python310"):
print(entry.path)
c:\python310\DLL5
c:\python310\Doc
c:\python310\include
... Фрагмент пропущен
336 Часть /. Основы языка Python
c:\python310\Tools
c:\python310\vcruntimel40.dll
c:\python310\vcruntimel40_1.dll
Еще класс DirEntry поддерживает следующие методы:
♦ is_file( [follow_symlinks=True]) - возвращает тrue, если текущий объект является
файлом, и False - в противном случае. Если текущий объект представляет собой сим
волическую ссьmку, и параметру follow_symlinks дано значение True, проверяется эле
мент, на который указывает эта символическая ссылка. Если же параметр follow_symlinks
имеет значение False, всегда возвращается False;
♦ is_dir( [follow_symlinks=Тrue]) - возвращает True, если текущий объект является ка
талогом, и· False - в противном случае. Если текущий объект представляет собой сим
волическую ссылку и параметру follow_symlinks дано значение True, проверяется эле
мент, на который указьmает эта символическая ссылка. Если же параметр follow_symlinks
имеет значение False, всегда возвращается False;
♦ is_symlink() - возвращает True, если текущий объект является символической ссыл
кой, и False - в противном случае;
♦ stat( [follow_symlinks=Тrue]) - возвращает объект stat_result (см. разд. 16.6), хра
нящий сведения о файле. Если текущий объект представляет собой символическую
ссылку и параметр follow_:_symlinks имеет значение True, возвращаются сведения об
элементе, на который указывает эта символическая ссылка. Если же параметр
follow_symlinks имеет значение False, возвращаются сведения о самой символической
ссьmке. В Windows атрибуты st_ino, st_dev и st_nlink объекта stat_result, возвра
щенного методом stat(), всегда хранят О, и для получения их значений следует вос
пользоваться функцией stat() из модуля os, описанной в разд. 16.6.
Пара примеров:
♦ вьmод списка всех каталогов, что находятся в каталоге, где установлен Python:
>>> for entry in os.scandir("c:\python310"):
if entry.is_dir():
print(entry.narne, end=", ")
DLLs, Doc, include, Lib, libs, Scripts, tcl, Tools,
♦ вывод списка всех DLL-файлов, хранящихся в каталоге Windows, без обработки симво
лических ссьmок:
>>> for entry in os.scandir("c:\windows"):
if entry.is_file(follow_symlinks=False) and \
entry.narne.endswith(".dll"):
print(entry.narne, end=", ")
pyshellext.arnd64.dll, twain_32.dll, womtrust.dll, wontrust.dll,
Итератор, возвращаемый функцией scandir(), является менеджером контекста и. может
быть использован в обработчиках контекстов (см.разд. 14.2):
>>> with os.scandir() as it:
for entry in it:
print(entry.narne)
Глава 16. Работа с файлами и каталогами 337
Путь в вызове функции scandir () также можно указать в виде объекта bytes. В таком слу
чае значения атрибутов name и path класса DirEntry тоже будут представлять собой объекты
bytes. Пример:
>>> with os.scandir(b"c:\python310") as it:
for entry in it:
print(entry.name)
b'DLLs'
b'Doc'
b'include'
. . . Фрагмент пропущен ...
16.11. Исключения,
генерируемые файловыми операциями
При возникновении нештатной ситуации во время работы с файлами и каталогами генери
руется искточение класса OSError или одно из следующих искточений, являющихся его
подклассами:
♦ ВlockingIOError - не удалось заблокировать файл или поток ввода/вьmода;
♦ ConnectionError - ошибка сетевого соединения. Может возникнуть при открытии фай
ла по сети. Является базовым классом для р'яда более специфических искточений, опи
санных в документации по Python;
♦ FileExistsError - файл или каталог с заданным путем уже существует;
♦ FileNotFoundError - файл или каталог с заданным путем не. найден;
♦ InterruptedError - файловая операция прервана операционной системой;
♦ IsADirectoryError - вместо пути к файлу указан путь к каталогу;
♦ NotADirectoryError - вместо пути к каталогу указан путь к файлу;
♦ PermissionError - отсутствуют права на доступ к указанному файлу или каталогу;
♦ TimeoutError - истекло время, отведенное системой на выполнение операции.
Пример кода, обрабатьmающего некоторые из указанных искточений:
try
open("C:\temp\new\file.txt")
except FileNotFoundError:
print("Файл отсутствует")
except IsADirectoryError:
print("Это не файл, а каталог")
except PermissionError:
print("Отсутствуют права на доступ к файлу")
except OSError:
рrint("Неустановленная 01Ш1бка открытия файла")
ГЛАВА 17
Работа с механизмами Windows
Python предоставляет инструменты для работы с реестром Windows. А с помощью допол
нительных библиотек можно получать пути к системным каталогам этой операционной
системы и создавать ярлыки.
Следует помнить, что все эти инструменты работают лишь в Microsoft Windows. Выяснить,
запущена ли программа в Windows, можно, проверив значение переменной platform из мо
дуля sys, - оно должно быть равно "win32" (одинаково в 32- и 64-разрядных редакциях
Windows). Пример:
import sys
if sys .platform == "win32":
# Текущая платформа - Windows.
# Можно использовать специфические механизмы этой системы.
else:
# Какая-то другая система.
# Специфические инструменты Windows использовать нельзя.
17.1. Работа с реестром
Реестр Windows организован в виде нескольких крупных разделов, называемых кустами
(hive). Каждый куст имеет уникальное имя: HКEY_CURRENT_USER (хранит настройки текущего
пользователя), НКЕУ_LOCAL_МАСНINЕ (настройки уровня системы) и др.
В кусте может быть создано произвольное количество подразделов - ветвей (в англоязыч
ной документации используется не очень удачный термин key - ключ). Каждая ветвь
идентифицируется путем (так, ветвь, хранящая пользовательские настройки Windows, рас
положена по пути Software\Microsoft\Windows).
Любая ветвь может хранить произвольное количество именованньrх значений (элементов)
и вложенньrх в нее ветвей, которые, в свою очередь, могут содержать произвольное количе,
ство элементов и вложенных в них ветвей. Кроме того, mобая ветвь может хранить в себе
одно произвольное значение. Значения, хранящиеся в элементах и ветвях, могут принадле
жать к одному из ограниченного набора типов: строковому, целочисленному, списочному
и пр.
Все программные инструменты Python, предназначеннь1е для работы с реестром и описы
ваемые далее, реализованы в модуле winreg. Этот модуль следует предварительно подклю
чить с помощью инструкции:
import winreg
Глава 17. Работа с механизмами Windows 339
17.1.1. Открытие и закрытие ветвей реестра
Чтобы получить доступ к требуемой ветви реестра, хранящимся в ней элементам и кmочам,
предварительно следует открыть эту ветвь. Открытие ветви выполняют функции OpenKey()
и OpenKeyEx(). Обе функции совершенно аналогичны и вызываются в формате:
OpenKey I OpenKeyEx(<Обозначение куста>, <Путь к открыв_аемому ключу> [,
reserved=0] [, access=winreg.КEY_READ])
Обозначение куста реестра, в котором хранится открываемая ветвь, указывается в виде зна
чения одной из следующих переменных: HКEY_CLASSES_ROOT, HКEY_CURRENT_USER, НКЕУ_
LOCAL_МACHINE, HКEY_USERS, HКEY_PERFORМANCE_DATA, HКEY_CURRENT_CONFIG, HКEY_DYN_DATA.
Путь к открываемой веrви задается в виде строки. Параметр reserved зарезервирован для
использования в будущих версиях Windows, в качестве значения ему всегда дается число О.
Параметр access задает права доступа к открываемой ветви и ее содержимому в виде зна-
чения одной из следующих переменных или их комбинации через двоичный оператор 1 :
♦ КЕУ_QUERY_VАШЕ - чтение данных;
♦ КЕУ_ENUМERATE_suв_KEYS - перебор вложенных ветвей;
♦ КEY_NOTIFY- получение оповещений об изменениях содержимого ветви;
♦ КЕУ_SET_VALUE - создание, запись, удаление элементов и удаление вложенных ветвей;
♦ КЕУ_CREATE_ suв_КЕУ - создание вложенных ветвей;
♦ КЕУ_READ и КЕУ_EXECUTE - полные права на чтение (комбинации КЕУ_QUERY_ VALUE,
КEY_ENUМERATE_SUB_КEYS И КEY_NOТIFY);
♦ КEY_WRITE- полные права на запись (комбинации КEY_SET_VALUE и КEY_CREATE_SUB_КEY);
♦ КЕУ_ALL _ACCESS- полные права на чтение и запись (комбинации КЕУ_READ и КЕУ_WRITE).
Следующие две переменные поддерживаются только в 64-разрядной редакции языка
Python:
♦ КЕУ_wow64 _64КЕУ - работа с 64-разрядной редакцией реестра;
♦ КЕУ_WOW64_ З2КЕУ- работа с 32-разрядной редакцией реестра.
Функции OpenKey() и OpenKeyEx() возвращают объект класса РуНКЕУ, представляющий от
крытую ветвь реестра. Если ветвь не удалось открыть, генерируется искmочение OSError
или одно из искmочений, производных от этого класса.
Закончив работу с открытой ветвью, ее следует закрыть, выполнив одно из следующих дей
ствий:
♦ вызвав функцию СlоsеКеу(<Закрываемая ветвь>);
♦ вызвав у объекта закрываемой ветви метод Close().
Пример:
>>> import winreg # Подключаем модуль
>>>#Открываем ветвь Software куста HКEY_CURRENT_USER с правами на
>>>#запись
>>> k = winreg.OpenKey(winreg.HКEY_CURRENT_USER, "Software",
access=winreg.КEY_WRITE)
>>>#Создаем в ветви Software вложенную ветвь Python
>>> sk = winreg.CreateKey(k, "Python")
340 Часть /. Основы языка Python
>>>#Записываем в ветвь Python элемент Version со значением "3.10.1"
>>> winreg.SetValueEx(sk, "Version", О, winreg.REG_SZ, "3.10.1")
>>>#Создаем в ветви Python вложенную ветвь 3.10.1 со значением
>>>#"Installed"
>>> winreg .SetValue(sk, "3.10.1", winreg.REG_SZ, "Installed")
>>>#Закрываем вложенную ветвь Python с помощью метода Close()
>>> sk.Close()
>>>#Закрываем ветвь Software с помощью функции CloseKey()
>>> winreg.CloseKey(k)
Класс РуНКЕУ, представляющий ветвь реестра, является менеджером контекста. Следова
тельно, для работы с открытыми ветвями реестра можно использовать обработчики контек
ста. Пример:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python") as k:
print(winreg.QueryValueEx(k, "Version") [О])
3.10.1
Чтобы открыть ветвь реестра удаленного компьютера, сначала следует подключиться к его
реестру. Это выполняется вызовом функции ConnectRegistry(), которая вызывается в сле
дующем формате:
ConnectRegistry(<Ceтeвoe имя компьютера>, <Обозначение куста>)
Сетевое имя компьютера указывается в виде строки. Если задать значение None, будет вы
полнено подключение к реестру локального компьютера. Обозначение куста задается в ви
де значения одной из приведенных ранее переменных.
В качестве результата возвращается объект класса РуНКЕУ, представляющий указанный куст
реестра заданного удаленного компьютера. Если подключиться к удаленному реестру не
удалось, генерируется исключение OSError или одно из исключений, производных от этого
класса.
Ьбъект куста, полученный от функции ConnectRegistry(), следует передать первым пара
метром функции OpenKey() или OpenKeyEx(), чтобы открыть нужную ветвь удаленного рее
стра. Пример:
rh = winreg.ConnectRegistry(r"\\SorneCornputer", winreg.HКEY_CURRENT_USER)
with winreg.OpenKey(rh, r"Software\Python") as k:
17.1.2. Чтение и запись данных реестра
Функции, используемые для чтения данных из реестра, записи в него значений, создания и
удаления элементов и ветвей, в качестве первого параметра принимают объект открытой
ветви, относящийся к классу РуНКЕУ и возвращенный функцией OpenKey() или OpenKeyEx()
(см. разд. 17.1.1). При возникновении ошибки они генерируют исключение ostrror или
одно из исключений, производных от этого класса. Вот эти функции:
♦ QueryValueEx(<Ветвь>, <Имя элемента>) - считывает из указанной ветви реестра значе
ние элемента с заданным именем. Возвращает кортеж из двух элементов: собственно
считанного значения и обозначения его типа, представленного целым числом. Пример:
Глава 17. Работа с механизмами Windows 341
>>> irnport winreg
>>> with winreg.OpenKey(winreg.HКEY_CURRENT USER,
r"Software\Python") as k:
print(winreg.QueryValueEx(k, "Version"))
('3.10.1', 1)
>>># 1 - это обозначение строкового типа
♦ QueryValue(<Ветвь>, <Имя вложенной ветви>) - возвращает значение вложенной ветви
с заданным именем, находящейся в указанной ветви. Возвращаемое значение всегда
представляется в виде строки. Если ветвь не имеет значения, возвращается пустая стро
ка. Если вторым параметром задано значение None, возвращает значение ветви, заданной
первым параметром. Пример:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python") as k:
print(winreg.QueryValue(k, "3.10.1"))
print(winreg.QueryValue(k, None))
Installed
>>>#Ветвь Software\Python не имеет значения
♦ СrеаtеКеу(<Ветвь>, <Имя вложенной ветви>) - создает в указанной ветви вложенную
ветвь. с заданным именем. Возвращает объект класса РуНКЕУ, представляющий создан
ную вложенную ветвь. Если вложенная ветвь с указанным именем уже существует, про
сто открывает и возвращает ее;
♦ CreateKeyEx() - аналогична CreateKey(), только позволяет дополнительно указать пра
ва доступа к созданной вложенной ветви. Формат вызова:
СrеаtеКеуЕх(<Ветвь>, <Имя вложенной ветви>[, reserved=0] [,
access=КEY_WRITE])
Параметр reserved зарезервирован для использования в будущих версиях Windows,
в качестве значения ему всегда дается число О. Параметр access задает права доступа
к создаваемой ветви в формате, описанном в разд. 17.1.1. Пример:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python") as k:
winreg.CreateKeyEx(k, "3.10.0", access=winreg.КEY_READ)
winreg.CreateKeyEx(k, "3.9.0", access=winreg.КEY_READ)
♦ SetValueEx() - добавляет в указанную ветвь элемент с заданными именем, типом и
значением. Если такой элемент уже существует, записывает в него новое значение.
Формат функции:
SetValueEx(<Beтвь>, <Имя элемента>, <Зарезервирова�>,
<Обозначение типа>, <Значение элемента>)
Имя элемента указывается в виде строки. Параметру <Зарезервирован> всегда следует
давать в качестве значения число О. Обозначение типа указывается в виде значения
одной из следующих переменных:
• REG_sz - строка;
• REG_EXPAND_sz - строка со ссылками на переменные окружения;
342 Часть /. Основы языка Python
• REG-МULТI-sz - список строк;
• REG_DWORD или REG_DWORD_LITTLE_ENDIAN - 32-разрядное целое число (байты записы
ваются в порядке «от младшего к старшему»);
• REG_DWORD_ВIG_ENDIAN - 32-разрядное целое число (байты записываются в порядке
«от старшего к младшему»);
• REG_QWORD или REG_QWORD_ LITTLE_ENDIAN - 64-разрядное целое число (байты записы-
ваются в порядке «от младшего к старшему»);
• REG_BINARY - последовательность байтов типа bytes или bytearray;
• REG_LINK - символическая ссылка Unicode;
• REG_RESOURCE_ыsт - список ресурсов драйвера устройства;
• REG-FULL-RESOURCE_DESCRIPTOR - настройки устройства;
• REG-RESOURCE-REQUIREМENTS-LIST - список ресурсов устройства;
• REG_NONE - отсутствие явно указанного типа.
Пример:
>>> versions = ["3.10.1", "3.10.0", "3.9.0"]
>>> bn = bytes("Python", "ср1251")
>>> with winreg.OpenKey(winreg.HКEY_CURRENT USER,
r"Software\Python", access=winreg.KEY_SET VALUE) as k:
winreg.SetValueEx(k, "Count", О, winreg.REG_DWORD, 3)
winreg.SetValueEx(k, "Versions", О, 'winreg.REG_МULTI_SZ,
versions)
winreg.SetValueEx(k, "BNarne", О, winreg.REG_BINARY, bn)
♦ Setvalue() - записывает во вложенную ветвь с заданным именем, находящуюся в ука
занной ветви, заданное значение с указанным типом. Если указанная вложенная ветвь не
существует, создает ее. Формат функции:
SetValue(<Beтвь>, <Имя вложенной ветви>, <Обозначение типа>,
<Значение вложенной ветви>)
Имя вложенной ветви указывается в виде строки, обозначение типа - в виде одной из
переменных, описанных ранее. Пример:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python", access=winreg.KEY_SET VALUE) as k:
winreg.SetValue(k, "3.10.0", winreg.REG_SZ, "Not installed")
♦ DeleteValue(<Ветвь>, <Имя элемента>) - удаляет из заданной ветви элемент с указан
ным именем:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python", access=winreg.KEY_SET VALUE) as k:
winreg.DeleteValue(k, "Count")
♦ DеlеtеКеу(<Ветвь>, <Имя вложенной ветви>) - удаляет из указанной ветви вложенную
ветвь с заданным именем. Удаляемая ветвь не должна содержать вложенных ветвей -
в противном случае при попытке ее удалить возникнет ошибка. Пример:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python", access=winreg.KEY_SET_VALUE) as k:
winreg.DeleteKey(k, "3.9.0")
Глава 17. Работа с механизмами Windows 343
♦ DeleteKeyEx() - то же самое, что и DeleteKey(), только дополнительно позволяет за
дать редакцию реестра (64- или 32-разрядную), из которой следует удалить вложенную
ветвь. Формат функции:
DеlеtеКеуЕх(<Ветвь>, <Имя вложенной ветви>[, access=КEY_WOW64 64КЕУ] [,
res-erved=O])
Редакция реестра задается параметром access: значение переменной KEY_WOW64_64КEY
указывает 64-разрядную редакцию реестра, а значение переменной КЕУ_wow64_32КЕУ -
32-разрядную. Параметр reserved всегда должен иметь значение О. Пример:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python", access=winreg.KEY_SET_VALUE) as k:
winreg.DeleteKeyEx(k, "3 .9.0", access=winreg.KEY_WOW64_32KEY)
ВНИМАНИЕ!
Функция DeleteKeyEx() работает только в 64-разрядных редакциях Windows. При nоnытке
вызвать ее в 32-разрядной редакции будет сгенерировано исключение NotimplementedError.
Все операции записи данных в какую-либо ветвь реестра, создания, удаления элементов
и вложенных ветвей буферизуются в оперативной памяти для повышения производи
тельности. Перенос измененной ветви реестра из памяти на диск выполняется только
после закрытия этой ветви или вызова функции FlushKey() ;
♦ FlushKey(<Beтвь>) - принудительно переносит хранящуюся в буфере исправленную
копию заданной ветви на диск;
♦ QueryinfoKey(<Beтвь>) - возвращает сведения о заданной ветви в виде кортежа из трех
элементов: количества вложенных ветвей, количества элементов и времени последнего
изменения содержимого заданной ветви, которое представлено количеством сотен нано
секунд, прошедших с 1 января 1601 года:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python") as k:
print(winreg.QueryinfoKey(k))
(2, 3, 132882022669686509)
17.1.3. Перебор элементов и вложенных ветвей реестра
Функции, перебирающие элементы и вложенные ветви, в качестве первого параметра при�
нимают объект открытой ветви, относящийся к классу РуНКЕУ и возвращенный функцией
OpenKey() или OpenKeyEx() (см. разд. 17.1.1). При возникновении ошибки они генерируют
исключение OSError или одно из производных исключений. Python предоставляет две
функции такого рода:
♦ EnumValue(<Ветвь>, <Индекс>) - возвращает сведения об элементе указанной ветви
с заданным индексом (нумерация элементов начинается с О). Возвращаемые сведения
представляют собой кортеж из трех элементов: имени элемента, его значения и целочис
ленного обозначения типа значения. При попытке получить элемент с несуществующим
индексом генерируется исключение OSError. Пример:
>>> import winreg, itertools
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python") as k:
344 Часть /. Основы языка Python
for i in itertools.count():
try:
print(winreg.EnщnValue(k, i))
except OSError:
break
('Version', '3.10.1', 1)
('Versions', ['3 .10.1', '3.10.0', '3.9.0'], 7)
( 'BName', Ь' Python', 3)
♦ ЕnumКеу(<Ветвь>, <Индекс>) - возвращает имя вложенной ветви с заданным индексом
(нумерация элементов начинается с О), находящейся в указанной ветви. При попытке
получить вложенную ветвь с несуществующим индексом генерируется . исключение
OSError. Пример:
>>> with winreg.OpenKey(winreg.HКEY_CURRENT_USER,
r"Software\Python") as k:
for i in itertools.count():
try:
print(winreg.EnumКey(k, i))
except OSError:
break
3.10.0
3.10.1
17 .2. Получение путей к системным каталогам
Для получения путей к системным каталогам Windows (таким как Документы, Изображения,
Рабочий стол, Program Files) удобно использовать дополнительную библиотеку winpath.
Перед использованием ее следует установить с помощью утилиты pip (описана в разд. 1.8),
набрав в консоли команду:
pip install winpath
ПРИМЕЧАНИЕ
Полное руководство по библиотеке wiпpath можно найти на странице:
https://pypi.org/project/winpath/.
Чтобы получить пути к системным каталогам, следует использовать следующие функции,
определенные в модуле winpath:
♦ get_my_docщnents() - каталог Документы текущего пользователя;
♦ get_my_pictures() - каталог Изображения текущего пользователя;
♦ get_desktop() - каталог Рабочий стол текущего пользователя;
♦ get_recent() - каталог недавних документов текущего пользователя;
♦ get_programs() - каталог с содержимым меню Пуск I Программы текущего пользова
теля;
♦ get_startup() - каталог меню Пуск I Программы I Автозагрузка текущего пользова
теля;
Глава 17. Работа с механизмами Windows 345
♦ get_admin_tools() - каталог меmо Пуск I Программы I Средства администрирова
ния Windows текущего пользователя;
♦ get_local_appdata() - каталог локальных настроек текущего пользователя ( <каталог
пользовательского профиля>\АррDаtа\Lосаl);
♦ get_appdata() - каталог переносимых настроек текущего пользователя (<каталог поль
зовательского npoфиля>\AppData\Roaming);
♦ get_common_documents() � каталог Документы, общий для всех пользователей;
♦ get_common_admin_tools() - каталог меmо Пуск I Программы I Средства админист-
рирования Windows всех пользователей;
♦ get_ common_ appdata() - каталог ProgramData;
♦ get_program_files() - каталог Program Files;
♦ get_program_files_common.( ) - каталог Program Files\Common Files;
♦ get_windows() - каталог Windows;
♦ get_system() - каталог Windows\System32.
Примеры:
>>> import winpath
>>> winpath.get_my_documents()
'D:\\Dаtа\\Документы'
>>> winpath.get_recent()
'C:\\Users\\vlad\\AppData\\Roaming\\Microsoft\\Windows\\Recent'
>>> winpath.get_programs()
'C:\\Users\\vlad\\AppData\\Roaming\\Microsoft\\Windows\\Start Menu\\Programs'
>>> winpath.get_local_appdata()
'C:\\Users\\vlad\\AppData\\Local'
>>> winpath.get_appdata()
'C:\\Users\\vlad\\AppData\\Roaming'
>>> winpath.get_common_documents()
'C:\\Users\\PuЫic\\Documents'
>>> winpath.get_common_appdata()
'C:\\ProgramData'
>>> winpath.get_program_files()
'C:\\Program Files'
>>> winpath.get_program_files_common()
'C:\\Program Files\\Common Files'
17.3. Создание ярлыков
Для создания ярлыков в меmо Пуск и (или) на рабочем столе отлично подходит дополни
тельная библиотека pyshortcuts. Устанавливается она набором в консоли следующей команды:
pip install pyshortcuts
Для работы она требует наличия дополнительной библиотеки pywin32, которая будет уста
новлена автоматически.
346 Часть /. Основы языка Python
После установки библиотеки следует перезапустить интерпретатор, работающий в интерак
тивном режиме, если на момент установки он был запущен.
ПРИМЕЧАНИЕ
Полная документация по библиотеке pyshortcuts находится по интернет-адресу:
https://github.com/newville/pyshortcuts.
Создание ярлыка, указывающего на заданный файл программы, выполняет функция
make_shortcut() из модуля pyshortcuts. Формат вызова функции:
make_shortcuts(<Путь к файлу программы> [, name=None] [,
description=None] [, icon=None] [, folder=None] [,
terminal=True] [, desktop=True] [, startmenu=True])
Путь к файлу программы задается в виде строки. Остальные параметры указывают:
♦ name- имя ярлыка (если None, будет использовано имя файла программы из первого
параметра);
♦ description- описание ярлыка (если None, будет использовано имя ярлыка);
♦ icon- путь к файлу со значком (если None, будет использован значок с логотипом
Python, поставляемый в составе библиотеки);
♦ folder- относительный путь, указанный относительно каталога Рабочий стол, к ката
логу, в котором будет создан ярлык (если None, ярлык будет создан непосредственно
в каталоге Рабочий стол);
♦ terminal- если True, программа, на которую указывает ярлык, будет запущена в кон
соли, если False- нет. У программ с графическим интерфейсом этому параметру сле
дует дать значение False;
♦ desktop- если тrue, ярлык будет создан на рабочем столе, если False- нет;
♦ startmenu- если тrue, ярлык будет создан в меню П�ск, если False - нет.
Функция возвращает объект класса Shortcut, определенного в модуле pyshortcuts, который
представляет созданный ярлык. Обычно возвращаемый функцией результат игнорируют.
Пример:
from pyshortcuts import make_shortcut
make_shortcut(r"c:\book\program.py", nаmе="Программа",
• description="Heбoльшaя учебная программа", startmenu=False)
ЧАСТЬ 11
Библиотека PyQt 6
Глава 18. Введение в PyQt 6
Глава 19. Окна
Глава 20. Обработка сигналов и событий
Глава 21. Размещение компонентов в окнах. Контейнеры
Глава 22. Основные компоненты
Глава 23. Списки и таблицы
Глава 24. Работа с базами данных
Глава 25. Работа с графикой
Глава 26. Графическая сцена
Глава 27. Диалоговые окна
Глава 28. Создание SDI- и МDl-программ
Глава 29. Мультимедиа
Глава 30. Печать документов
Глава 31. Сохранение настроек программ
Глава 32. Программа «Судаку»
ГЛАВА 18
Введение-в PyQt 6
PyQt 6 - это дополнительная библиотека, позволяющая разрабатывать на Python програм
мы с графическим интерфейсом (оконные программы).
Для непосредственного вывода элементов графического интерфейса (окон, кнопок, полей
ввода, списков и др.) эта библиотека использует популярный программный фреймворк Qt.
Последний автоматически устанавливается одновременно с PyQt.
ПРИМЕЧАНИЕ
Описание библиотеки PyQt приведено по интернет-адресу: https://www.riverbankcomputing.
com/. Полная документация по фреймворку Qt 6 находится на сайте: https://doc.qt.io/qt-6/
index.html.
18.1. Установка PyQt 6
Для установки дополнительной библиотеки (и всех необходимых ей для работы библиотек)
достаточно набрать в консоли команду:
pip install PyQt6
ВНИМАНИЕ!
Эта команда устанавливает библиотеку в базовой комплектации. Дополнительные ком
поненты (в частности, веб-браузер) и средства разработчика (такие как программа Qt
Designer) следует установить отдельно.
Чтобы проверить правильность установки, вьmедем версии PyQt и Qt:
>>> from PyQt6 import QtCore
>>> QtCore.PYQT_VERSION_STR
'6.2.3'
>>> QtCore.QТ_VERSION_STR
'6.2.3'
18.2. Первая оконная программа
Напишем программу, выводяшую окно с надписью «Привет, мир!» и кнопкой закрытия
окна (рис. 18.1).
350 Часть 11. Библиотека PyQt б
liJ Первая программа на ... □ х
Привет, мир!
г Jакрыть окно
Рис. 18.1. Результат выполнения листинга 18.1
1 ЛtЮТМ�r 10.1. Первая nроrрамма на.�. ,,
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("Пepвaя программа на PyQt")
window.resize(ЗOO, 70)
label = QtWidgets.QLabel("<center>Пpивeт, миp!</center>")
ЬtnQuit = QtWidgets.QPushButton("&Закрыть окно")
vbox = QtWidgets.QVBoxLayout()
vbox.addWidget(label)
vbox.addWidget(ЬtnQuit)
window.setLayout(vbox)
ЬtnQuit.clicked.connect(app.quit)
window.show()
sys.exit(app.exec())
Файлу с оконной программой следует дать расширение pyw, чтобы при ее запуске не выво
дилось окно консоли.
18.3. Структура РуQt-программы
Рассмотрим код из листинга 18.1 построчно.
♦ В первой строке импортируется модуль QtWidgets, который содержит классы, реали
зующие компоненты графического интерфейса: окна, надписи, кнопки, текстовые поля
идр.
♦ Во второй строке импортируется модуль sys, из которого нам потребуется список пара
метров, переданных в командной строке (argv), и функция exit(), завершающая выпол
нение программы.
♦ Инструкция:
арр = QtWidgets .QApplication(sys.argv)
создает объект программы на основе класса QApplication. Конструктор этого класса
принимает список параметров, переданных в командной строке.
Получить объект программы в mобом месте ее кода можно вызовом статического метода
instance() класса QApplication. Например, вывести список параметров, переданных
в командной строке, можно так:
print(QtWidgets.QApplication.instance().argv())
Глава 18. Введение в PyQt 6 351
♦ Следующая инструкция:
window = QtWidgets.QWidget()
создает объект окна в виде объекта класса QWidget. Этот класс наследуют практически
все классы, реализующие компоненты графического интерфейса. Поэтому тобой ком
понент, не имеющий родителя, выводится в своем собственном окне.
♦ Инструкция:
window.setWindowТitle("Пepвaя программа на PyQt")
задает текст, который будет выводиться в заголовке окна, для чего используется метод
setWindowТitle().
♦ Очередная инструкция:
window.resize(ЗOO, 70)
задает минимальные размеры клиентской области окна (размеры заголовка и толщина
границ окна не учитываются). В первом параметре метода resize()указывается ширина
окна, а во втором параметре - его высота. Следует помнить, что эти размеры являются
рекомендацией, - т. е. если компонеmы не помещаются в окне, оно будет увеличено.
♦ Инструкция:
label = QtWidgets.QLabel("<center>Пpивeт, миp!</center>")
создает объект надписи. Текст надписи задается в качестве параметра в конструкторе
класса QLabel. С помощью НТМL-тега <center> производится выравнивание текста по
центру компонента. Возможность использования НТМL-тегов и СSS-атрибутов является
отличительной чертой библиотеки PyQt (например, внутри надписи можно вывести таб
лицу или графическое изображение).
♦ Следующая инструкция:
btnQuit = QtWidgets.QPushButton("&Закрыть окно")
создает объект-кнопки. Текст, который будет отображен на кнопке, задается в качестве
параметра в конструкторе класса QPushButton. Символ & перед буквой з задает клавишу
быстрого доступа. Если нажать одновременно клавишу <Alt> и клавишу с буквой, перед
которой в строке указан символ &, то кнопка сработает.
♦ Инструкция:
vbox = QtWidgets.QVBoxLayout()
создает вертикальный коmейнер. Все компоненты, добавляемые в этот контейнер, будут
располагаться по вертикали сверху вниз в порядке добавления, при этом размеры добав
ленных компонентов будут подогнаны под размеры контейнера. При изменении разме
ров контейнера будет произведено изменение размеров всех компонентов.
♦ В следующих двух инструкциях:
vbox.addWidget(label)
vbox.addWidget(btnQuit)
с помощью метода addWidget() контейнера производится добавление в него созданных
ранее надписи и кнопки. Добавленные в контейнер компоненты станут его потомками, а
сам контейнер - родителем добавленных в него компонентов.
352 Часть 11. Библиотека PyQt б
♦ Инструкция:
window.setLayout(vbox)
помещает контейнер в окно с помощью метода setLayout(). В результате контейнер
станет потомком окна (а окно - родигелем контейнера).
♦ Инструкция:
btnQuit.clicked.connect(app.quit)
назначает обработчик сигнала clicked() кнопки, активизирующегося при возникнове
нии события нажатия кнопки.
Событие - это уведомление о том, что в программе что-либо произошло: пользователь
щелкнул мышью, нажал клавишу на клавиатуре, переместил окно и др.
Сигнал - это особый объект, соответствующий событию определенного типа и генери
руемый каждый раз, когда возникает событие, относящееся к этому типу.
Обработчик сигнала - это метод (или функция), связанный с сигналом и вызьmаемый
при его генерировании. Обработчик назначается сигналу вызовом у последнего метода
connect(). Метод, используемый в качестве обработчика, называется слотом.
Сигнал clicked(), генерируемый при возникновении события нажатии кнопки, доступен
через одноименный атрибут класса кнопки. Обработчик представляет собой метод
quit() объекта программы, немедленно завершающий ее работу.
Отметим, что не все события связаны со слотами. Часть событий обрабатьmается осо
быми специальными методами, называемых обработчиками событий. Подробнее об
обработке событий и сигналов будет рассказано в главе 20.
♦ Очередная инструкция:
window.show()
выводит на экран окно и все компоненты, которые мы ранее в него добавили.
♦ И, наконец, .последняя инструкция:
sys.exit(app.exec() )
запускает цикл обработки сигналов в программе.
Код, расположенный после вызова метода ехес () , будет выполнен только после завер
шения работы программы, - поскольку результат выполнения метода ехес () мы пере
даем функции exit(), дальнейшее выполнение программы будет прекращено, а код воз
врата - передан операционной системе.
18.4. ООП-стиль создания окна
Библиотека PyQt содержит несколько сотен классов. Иерархия их наследования имеет
слишком большой размер, и привести ее в книге возможности нет. Тем не менее, чтобы
увидеть зависимости, при описании каждого класса мы будем приводить иерархию его
наследования. В качестве примера выведем базовые классы класса QWidget:
>>> from PyQtб import QtWidgets
>>> QtWidgets.QWidget. bases
(<class 'PyQtб.QtCore.QObject'>, <class 'PyQtб.QtGui.QPaintDevice'>)
Глава 18. Введение в PyQt 6 353
Как видно из этого примера, класс QWidget наследует два класса: QObject и QPaintDevice.
Класс QObject является классом верхнего уровня, и его в PyQt наследует большинство клас
сов. В свою очередь, класс QWidget является базовым для всех визуальных компонентов.
ВНИМАНИЕ!
В описании каждого класса PyQt будут приведены лишь атрибуты, методы, сигналы и сло
ты, определенные непосредственно в описываемом классе. Атрибуты, методы, сигналы и
слоты базовых классов здесь не описываются - присутствуют лишь ссылки на соответст
вующие страницы документации.
Можно создавать новые классы компонентов на основе стандартных. В качестве примера
переделаем код из листинга 18.1 и создадим окно в стиле объектно-ориентированного про
граммирования (ООП), как показано в листинге 18.2.
from PyQtб import QtWidgets, QtCore
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.label = QtWidgets.QLabel("Пpивeт, мир!")
self.label.setAlignment(QtCore.Qt.AlignmentFlag.AlignHCenter)
self.ЬtnQuit = QtWidgets.QPushButton("&Зaкpыть окно")
self.vbox = QtWidgets.QVBoxLayout()
self.vbox.addWidget(self.label)
self.vbox.addWidget(self.ЬtnQuit)
self.setLayout(self.vbox)
self.ЬtnQuit.clicked.connect(QtWidgets.QApplication.instance().quit)
:.f name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow() # Создаем объект окна
window.setWindowТitle("OOП-cтиль создания окна")
window.resize(З00, 70)
window.show() # Отображаем окно
sys.exit(app.exec()) # Запускаем цикл обработки событий
Помимо уже знакомого модуля QtWidgets из пакета PyQtб, мы импортируем модуль QtCore,
содержащий модуль Qt, в котором определено перечисление AlignmentFlag, задающее вы
равнивание текста.
Далее мы определяем класс MyWindow, который наследует класс QWidget:
:lass MyWindow(QtWidgets.QWidget):
Можно наследовать и другие классы, производные от QWidget, - например, QFrame (окно
с рамкой) или QDialog (диалоговое окно). При наследовании класса QDialog окно будет вы
равниваться по центру экрана (или по центру родительского окна) и иметь в заголовке
только кнопки закрытия и вызова справки. Кроме того, можно наследовать класс
354 Часть 11. Библиотека PyQt б
QМainWindow, который представляет главное окно программы с меmо, панелями инструмен
тов и строкой состояния. Наследование класса QMainWindow имеет свои отличия, которые мы
рассмотрим в главе 28.
Конструктор класса MyWindow в качестве параметров принимает ссылки на текущий объект
(self) и на родительский компонент (parent). Родительский компонент может отсутство
вать, поэтому в определении конструктора параметру присваивается значение по умолча
нию (None). Внутри конструктора вызывается конструктор базового класса, и ему передает
ся ссылка на родительский компонент:
QtWidgets.QWidget. init (self, parent)
Далее в конструкторе создаются объекты надписи, кнопки и контейнера, компоненты до
бавляются в контейнер, а сам контейнер - в окно. Объекты надписи и кнопки сохраняются
в атрибутах объекта, чтобы в дальнейшем этими объектами можно было управлять (напри
мер, изменять текст надписи) из методов класса. Если объекты не сохранить, то получить
к ним доступ будет не так просто.
В предыдущем примере (см. листинг 18.1) мы выравнивали текст надписи с помощью
НТМL-тега. Здесь же использован метод setAlignment(), которому мы передали элемент
Alignнcenter перечисления AlignmentFlag из модуля QtCore.Qt:
self.laЬel.setAlignment(QtCore.Qt.AlignmentFlag.AlignHCenter)
В инструкции, назначающей обработчик сигнала clicked() :
self.btnQuit.clicked.connect(QtWidgets.QApplication.instance() .quit)
мы получаем доступ к объекту программы посредством рассмотренного в разд. 18.3 стати
ческого метода instance() класса QApplication.
Создание объекта программы и объекта класса MyWindow производится внутри условия
if name = '' main " ·
Атрибут модуля _name_ будет содержать значение _rnain_ только в случае запуска мо
дуля как главной программы. Если модуль импортировать, этот атрибут будет содержать
другое значение. Поэтому весь последующий код создания объектов программы и окна вы
полняется только при запуске программы двойным щелчком на значке файла. Может воз
никнуть вопрос: зачем это нужно? Дело в том, что одним из преимуществ ООП-стиля про
граммирования является повторное использование кода. Следовательно, можно импортиро
вать модуль и использовать класс MyWindow в другой программе.
Рассмотрим эту возможность на примере, для чего сохраним код из листинга 18.2 в файле
MyWindow.pyw, а затем создадим в той же папке еще один файл (например, с именем
test.pyw) и вставим в него код из листинга 18.3.
from PyQtб import QtWidgets
import MyWindow
class MyDialog(QtWidgets.QDialog):
def init (self, parent=None):
QtWidgets.QDialog. init (self, parent)
self.myWidget = MyWindow.MyWindow()
Глава 18. Введение в PyQt б 355
self.myWidget.vbox.setContentsMargins(0, О, О, О)
self.button = QtWidgets.QPushВutton("&Измeнить надпись")
mainBox = QtWidgets.QVВoxLayout()
mainBox.addWidget(self.myWidget)
mainBox.addWidget(self.button)
self.setLayout(mainBox)
self.button.clicked.connect(self.on_clicked)
def on_clicked(self):
self.myWidget.label.setText("Hoвaя надпись")
self.button.setDisaЫed(True)
if name == " rnain
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyDialog ()·
window.setWindowТitle("Пpeимyщecтвo ООП-стиля")
window.resize(З00, 100)
window.show()
sys.exit(app.exec())
Запустим файл test.pyw. На экране появится окно с надписью и двумя кнопками (рис. 18.2).
По нажатии на кнопку Изменить надпись производится изменение текста надписи, и кнопка
.Jелается неактивной. Нажатие кнопки Закрыть окно будет по-прежнему завершать работу
программы.
liJ Преимущество ООП-стиля х
Привет, мир!
jакрыть окно
.Изменить надпись
Рис. 18.2. Результат выполнения листинга 18.3
В этом примере мы создали класс MyDialog, производный от QDialog. Внутри конструктора
�-1ы создаем объект класса MyWindow и сохраняем его в атрибуте myWidget:
oelf.myWidget = MyWindow.MyWindow()
С его помощью позже мы получим доступ ко всем атрибутам класса MyWindow. Например,
в следующей строке произведем изменение отступа между границами контейнера и грани
uами соседних элементов :
oelf.myWidget.vbox.setContentsMargins(0, О, О, О)
Далее в конструкторе создаются кнопки и контейнер, объект класса MyWindow и кнопка до
бавляются в контейнер, а сам контейнер помещается в окно.
Инструкция :
=elf.button.clicked.connect(self.on_clicked)
356 Часть 11. Библиотека PyQt 6
назначает обработчик нажатия кнопки. В качестве параметра указывается ссылка на метод
on_clicked (), внутри которого производится изменение текста надписи (с помощью метода
setтext () ), и кнопка делается неактивной (с помощью метода setDisaЫed () ). Внутри ме
тода on_clicked () доступна ссылка на текущий объект self, через который можно получить
доступ к атрибутам окна.
Если модуль MyWindow.pyw запускается непосредственно как главная программа, выполнит
ся код внутри инструкции ветвления (см. листинг 18.2):
if name == " rnain "·
и создаст объекты программы и окна. Если же этот моду.11ь импортируется, объекты про
граммы и окна не создаются.
В некоторых случаях использование ООП-стиля является обязательным. Например, чтобы
обработать нажатия клавиш, необходимо наследовать какой-либо класс и переопределить в
подклассе метод с предопределенным названием. Какие методы необходимо переопреде
лять, мы рассмотрим при изучении обработки событий.
18.5. Создание окон
с помощью программы Qt Designer
Программа Qt Designer позволяет создавать окна для РуQt-программ визуально, размещая
компоненты на них мышью.
К сожалению, при попытке установить Qt Designer с помощью утилиты pip в Python 3.1О
возникает ошибка. Однако дистрибутив этой программы в виде обычного ЕХЕ-файла дос
тупен на странице https://build-system.fman.io/qt-designer-download, а процесс установки
тривиален и не вызовет проблем.
Запустить установленную программу Qt Designer можно выбором в меню Пуск пункта
Qt Designer.
18.5.1. Создание окон
После запуска Qt Designer откроется его главное окно, а поверх него - диалоговое окно
New Form (Новая форма) (рис. 18.3). В списке templates\forms (шаблоны\формы) этого
окна выберем пункт Widget (Обычное окно) и нажмем кнопку Create (Создать). В главном
окне появится пустая заготовка для создания окна (в терминологии Qt Designer - форма),
на которую с помощью мыши можно перетаскивать компоненты из панели Widget Вох
(рис. 18.4).
В качестве примера добавим на форму надпись и кнопку. Для этого на панели Widget Вох
в группе Display Widgets щелкнем левой кнопкой мыши на пункте Label и, не отпуская
кнопку мыши, перетащим компонент на форму. Затем проделаем аналогичную операцию
с компонентом Push Button, находящимся в группе Buttons, и разместим его ниже надписи.
Теперь выделим одновременно надпись и кнопку, щелкнем правой кнопкой мыши на лю
бом компоненте и в контекстном меню выберем пункт Lay out I Lay Out Vertically. Чтобы
компоненты занимали всю область формы, щелкнем правой кнопкой мыши на свободном
месте формы и в контекстном меню выберем пункт Lay out I Lay Out Horizontally.
Далее изменим некоторые свойства окна. Для этого в панели Object Inspector (рис. 18.5)
выделим первый пункт (Form), перейдем в панель Property Editor (рис. 18.6), найдем свойство
Глава 18. Введение в PyQt б 357
Ф New Form - Qt Designer х
templates\forms
Dialog with Buttons Bottom
Dialog with Buttons Right
Dialog without Buttons
MainWindow
Widaets
EmЬedded Deslgn
0 5/юw thls Dialog 00 Startup
Qeate 1: Qpen ... __ i' __ Recent __ ._:r__ {lose _!
Рис. 18.3. Диалоговое окно New Form
' Г QtDesigr>e>r о х
·а- - --� _]•»·•�1
, file fdi[ Fo,тn Yiew �tti� Yfindow !:!lc'lp
, D .,; ,а! 10 � fil! tm ss Gm � m ; � !1
1�- . -·····- ------------
: ~
Ve11k.iil Щ'OUt i{
11] Hori.zon�l layout
.
;;
;;� •·
• Hoпzoot-,1 Sp.acer
1 :
.......
Verti"'I�
а Push&Jtton
� ToolВ... tton
11): Radio8utton
• Ch@d:Boi
fi) Commarм:11..ink 8uttoo
� !Nlog Button Воl(
_____ _
_ __
_
]I Lmv-
"'-����
-::8 TreeView
gт�1ev1-
шJ Column View ,t,,;:t1oc1Edil:or Кesoi1rce1Эro,,vser
Рис. 18.4. Главное окно программы Qt Designer с пустой формой
358 Часть 11. Библиотека PyQt б
Object Class л
v III Form 10Widget....... .... .... ....: .................................................:... :. i
v � � QVBoxlayout
... Qlabel
... QPushButton
Рис. 18.5. Панель Object lnspector
(!f )(
Fllter
myform : QWldget
л
> minimumSize ..,,
Рис. 18.6. Панель Property Edltor
objectName и в поле справа от свойства введем новое имя класса формы: MyFoпn. Затем
найдем свойство geometry, щелкнем мышью на значке V слева от него, чтобы отобразить
скрытые свойства, и зададим ширину равной 300, а высоту равной 70, - размеры формы
автоматически изменятся. Указать текст, который будет отображаться в заголовке окна,
позволяет свойство windowTitle.
Чтобы изменить свойства надписи, следует выделить компонент с помощью мыши или вы
брать соответствующий ему пункт в панели Object Inspector. Для примера изменим значе
ние свойства text (оно задает текст надписи). После чего найдем свойство alignment, щелк
нем мышью на значке V слева от него, чтобы отобразить скрытые свойства, и укажем для
свойства Horizontal значение AlignHCenter. Теперь выделим кнопку и изменим значение
свойства objectName на btnQuit, а в свойстве text укажем текст надписи, которая будет вы
водиться на кнопке. (Кстати, изменить текст надписи или кнопки также можно, выполнив
двойной щелчок мышью на компоненте.)
Закончив, выберем в меню File пункт Save и сохраним готовую форму в файле MyForm.ui.
При необходимости внести в этот файл какие-либо изменения его можно открыть в про
грамме Qt Designer, выбрав в меню File пункт Open.
Глава 18. Введение в PyQt б 359
18.5.2. Использование Ul-файла в программе
Описание формы, созданной в Qt Designer, сохраняется в формате ХМL в файле с расшире
нием ui. Чтобы использовать такой файл в РуQt-программе, следует воспользоваться моду
лем uic, который входит в состав библиотеки PyQt. Предварительно следует подключить
этот модуль с помощью инструкции:
from PyQtб import uic
Для загрузки UI-файла и формирования на его основе окна предназначена функция
loadUi(), определенная в указанном модуле. Формат функции:
loadUi(<Пyть к UI-файлу>[, <Объект окна>])
Вторым параметром можно указать готовый объект окна, в котором будет сформирован
интерфейс, описанный в UI-файле с указанным путем. Если второй параметр не указан,
функция сама создаст новое окно и вернет ссылку на его объект в качестве результата.
В объекте окна будут созданы атрибуты, хранящие объекты компонентов, у которых в про
грамме Qt Designer бьmи указаны имена в свойстве objectName. Имена этих атрибутов
будут совпадать с именами соответствующих компонентов.
Два варианта использования функции loadUi() для формирования окна на основе готового
описания формы: без предварительного создания «пустого» объекта окна и с его предвари
тельным созданием - показаны в листингах 18.4 и 18.5.
from PyQtб import QtWidgets, uic
import sys
арр = QtWidgets.QApplication(sys.argv)
window = uic.loadUi("MyForm.ui")
window.btnQuit.clicked.connect(app.quit)
window.show()
sys.exit(app.exec())
from PyQtб import QtWidgets, uic
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
uic.loadUi("MyForm.ui", self)
self.btnQuit.clicked.connect(QtWidgets.QApplication.instance().quit)
if name = " main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
360 Часть 11. Библиотека PyQt 6
Загрузить UI-файл позволяет также функция loadUiType(<Путь к UI-файлу>) из того же
модуля uic. Она возвращает кортеж из двух элементов: ссылки на класс формы и ссылки на
базовый класс. Получив класс окна, мы можем создать на его основе множество объектов
окон. После создания объекта окна на основе полученного класса необходимо вызвать
у этого объекта метод setupUi(<Объект окна>) и передать ему ссылку на этот же объект
(листинг 18.6).
from PyQtб import QtWidgets, uic
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
Form, Base = uic.loadUiType("MyForm.ui")
self.ui = Form()
self.ui.setupUi(self)
self.ui.btnQuit.clicked.connect(QtWidgets.QApplication.instance().quit)
if name = " main "·
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
Загрузить UI-файл можно и вне класса, после чего при определении класса окна указать
полученный от функции loadUiType() .класс вторым в списке наследования, - чтобы опре
деляемый· класс унаследовал все его методы (листинг 18. 7).
from PyQtб import QtWidgets, uic
Form, Base = uic.loadUiТуре( "MyForm. ui")
class MyWindow(QtWidgets.QWidget, Form):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.setupUi(self)
self.btnQuit.clicked.connect(QtWidgets.QApplication.instance().quit)
if name main
import sys
арр·= QtWidgets.QApplication(sys.argv)
window = MyWindow()
window. show()
sys.exit(app.exec())
Глава 18. Введение в PyQt б 361
18.5.3. Преобразование Ul-файла в модуль Python
На основе описания формы, хранящегося в UI-файле, можно сгенерировать программный
код на языке Python, сохранив его в отдельном модуле. Для этого служит консольная ути
лита pyuicб, устанавливаемая в составе PyQt. Команда для ее запуска имеет такой формат:
pyuicб <Путь к UI-файлу> --outputl-o <Путь к генерируемому модулю> [--executelx]
При указании командного кточа --output или -х в генерируемый модуль вставляется код,
который создает и выводит окно, созданное на основе формы, в случае запуска этого моду
ля на выполнение.
Запустим консоль, перейдем в каталог; в котором находится UI-файл MyForm.ui, и отдадим
команду:
pyuicб MyForm.ui -о ui_MyForm.pyw
В результате будет создан модуль ui_MyForm.py, содержащий определение класса Ui_MyForm
с методами setupUi() и retranslateUi(). При использовании процедурного стиля програм
мирования следует создать объект «пустого» окна, объект класса формы и вызвать у по
следнего метод setupUi(), передав ему ссылку на созданный ранее объект окна (лис
тинг 18.8).
from PyQtб import QtWidgets
import sys, ui_MyForm
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
ui = ui_MyForm.Ui_MyForm()
ui.setupUi(window)
ui.btnQuit.clicked.connect(QtWidgets.QApplication.instance().quit)
•,1indow.show()
sys.exit(app.exec())
При использовании ООП-стиля программирования следует создать объект класса формы и
вызвать у него метод setupUi(), передав ему ссылку на этот же объект (листинг 18.9).
:rom PyQtб import QtWidgets
import ui_MyForm
=lass MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.ui = ui_MyForm.Ui_MyForm()
self.ui.setupUi(self)
self.ui.btnQuit.clicked.connect(QtWidgets.QApplication.instance().quit)
:f name = " main "·
import sys
арр = QtWidgets.QApplication(sys.argv)
362 Часть 11. Библиотека PyQt б
window = MyWindow()
window.show()
sys.exit(app.exec())
Класс формы можно указать во втором параметре в списке наследования - в этом случае
он унаследует все методы класса формы (листинг 18.1 О).
from PyQtб import QtWidgets
import ui_MyForm
class MyWindow(QtWidgets.QWidget, ui_MyForm.Ui_MyForm):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.setupUi(self)
self.btnQuit.clicked.connect(QtWidgets.QApplication.instance().quit)
if name = " main " ·
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
Создавать формы в программе Qt Designer очень удобно. Тем не менее, чтобы полностью
овладеть программированием на PyQt, необходимо уметь писать код вручную. Поэтому
в оставшейся части книги мы больше не станем задействовать программу Qt Designer.
18.6. Модули PyQt 6
В состав библиотеки PyQt 6 входит множество модулей, объединеннь1х в пакет PyQtб. Упо
мянем самые важные из них:
♦ QtCore - содержит классы, не связаННЬiе с реализацией графического интерфейса. От
этого модуля зависят все остальные модули;
♦ QtGui - содержит классы, реализующие низкоуровневую работу с оконнь1ми элемента
ми, обработку сигналов, вывод двухмерной графики, текста и др.;
♦ QtWidgets - содержит классы, реализующие компоненты графического интерфейса:
окна, надписи, кнопки, поля ввода, списки и др.;
♦ QtWebEngineCore - включает низкоуровневые классы для отображения веб-страниц;
♦ QtWebEngineWidgets - реализует высокоуровневые компоненты графического интер
фейса, предназначенные для вьmода веб-страниц и использующие модуль QtWebEnginecore;
♦ QtMultimedia - включает низкоуровневые классы для работы с мультимедиа;
♦ QtMultimediaWidgets - реализует высокоуровневые компоненты для работы с мульти
медиа, использующие модуль QtMultimedia;
♦ QtPrintSupport - содержит классы, реализующие печать и предварительный просмотр
документов;
Глава 18. Введение в PyQt б 363
♦ QtSql - вкточает средства для работы с базами данных, а также реализацию SQLite;
♦ QtSvg - служит для работы с векторной графикой (SVG);
♦ QtNetwork- содержит классы, предназначенные для работы с сетью;
♦ QtXml и QtXmlPatterns - предназначены для обработки ХМL;
♦ QtHelp - содержат инструменты для создания интерактивных справочных систем.
В этой книге не описываются все упомянутые модули - чтобы получить информацmо по
нерассматриваемым здесь модулям, обращайтесь к соответствующей документации.
18. 7. Управление циклом обработки событий
После вывода на экран главного окна программы и выполнения всевозможных подготови
тельных действий программа ожидает возникновения первого события. В разд. 18. 3 говори
лось, что события различных типов возникают при нажатии кнопки, занесении значения
в поле ввода, щелчке мышью, нажатии клавиши, перемещении окна и др. Дождавшись со
бытия, программа вызывает назначенный ему обработчик (либо обработчик сигнала, соот
ветствующего событию, либо обработчик события) и после его выполнения начинает ждать
возникновения следующего события ит. д.
Можно сказать, что программа после запуска вводится в бесконечный цикл, в теле которого
выполняется обработка возникающих событий. Он носит название цикла обработки собы
тий. В том же разд. 18. 3 сообщалось, что этот цикл запускается вызовом метода ехес ()
объекта программы.
Цикл обработки событий автоматически прерывается после закрытия последнего открытого
окна программы. С помощью статического метода setQuitOnLastWindowClosed() класса
QApplication это поведение можно изменить.
Чтобы завершить работу программы, необходимо вызвать слот quit() или - в теле обра
ботчика какого-либо события - метод exit( [returnCode=0J) класса QApplication. В пара
метре returncode метода exit() указывается код возврата.
Если внутри обработчика события выполняется длительная операция, программа перестает
реагировать на события. В качестве примера изобразим длительный процесс с помощью
функции sleep() из модуля time (листинг 18.11).
:rom PyQtб import QtWidgets
�mport sys, time
jef on_clicked():
time.sleep(l0) # "Засьmаем" на 10 секунд
зрр = QtWidgets.QApplication(sys.argv)
jutton = QtWidgets. QPushВutton("Запустить процесс")
jutton.resize(200, 40)
jutton.clicked.connect(on_clicked)
jutton.show()
sys.exit(app.exec())
364 Часть 11. Библиотека PyQt б
В этом примере по нажатии кнопки Запустить процесс. вызывается функция on_clicked() ,
внутри которой выполнение программы, в том числе работа цикла обработки событий, при
останавливается на десять секунд. Попробуйте нажать кнопку, перекрыть окно другим
окном, а затем заново его отобразить - вам не удастся это сделать, поскольку окно пере
стает реагировать на любые события, пока не истечет заданное время «засыпания». Про
грамма просто зависнет.
Длительную операцию можно разбить на несколько этапов и по завершении каждого этапа
принудительно запускать обработку накопившихся собьпий вызовом статического метода
processEvents() класса QApplication. Формат вызова этого метода:
processEvents( [<Типы обрабатываемых событий> [, <Время>] ] )
Первый параметр указывает типы событий, которые будут обработаны после вызова мето
да. Значение указывается в виде одного из следующих элементов перечисления
ProcessEventsFlag из класса QEventLoop, определенного в модуле QtCore, или их комбина
ции через двоичный оператор 1 :
♦ AllEvents - все события;
♦ ExcludeUserinputEvents - все события, за исключением вызываемых действиями поль
зователя;
♦ ExcludeSocketNotifiers - все события, за исключением вызванных сетевой активно
стью;
♦ · WaitForMoreEvents - ожидать возникновения событий, если накопившихся событий
нет.
Второй параметр задает время, в течение которого будут обрабатываться накопившиеся
события, в миллисекундах. Если заданное время еще не истекло, накопившихся событий
нет и в первом параметре не указан элемент WaitForMoreEvents, метод завершит работу.
Если второй параметр не указан, метод завершит работу сразу после обработки последнего
из накопившихся событий.
Переделаем предыдущую программу, инсценировав с помощью цикла длительную опера
цию, которая выполняется 20 секунд (листинг 18.12).
from PyQtб import QtWidgets, QtCore
import sys, time
def on_clicked():
button.setDisaЫed(True) # Делаем кнопку неактивной
for i in range(l, 21):
# Обрабатываем накопившиеся события всех типов в течение 1 с
QtWidgets.QApplication.instance() .processEvents(
QtCore.QEventLoop.ProcessEventsFlag .AllEvents, 1000)
time.sleep( 1) # "Засыпаем" на 1 секунду
print("step -", i)
button.setDisaЬled(False) # Делаем кнопку активной
арр = QtWidgets.QApplication(sys.argv)
button = QtWidgets.QPushButton("Зaпycтить процесс")
Глава 18. Введение в PyQt б 365
button.resize(200, 40)
button.clicked.connect(on_clicked)
button.show()
sys.exit(app.exec())
В этом примере длительная операция разбита на одинаковые этапы, после выполнения каж
дого из которых выполняется принудительная обработка накопившихся событий. Теперь
программа останется отзывчивой, хотя и с некоторой задержкой.
18.8. Многопоточные программы
Другой способ повысить отзывчивость программы - вынести выполнение длительной опе
рации в другой поток. Поток можно рассматривать как отдельный процессор, сформиро
ванный программно операционной системой, выполняющий часть кода программы и не
мешающий работе потока, в котором выполняется основной код программы (основного по
тока). Вся совокупность потоков, организуемая программой для работы, называется про
цессом, а программы, использующие более одного потока, - многопоточными.
В процессе можно запустить сразу произвольное количество независимых потоков. По воз
можности операционная система будет выполнять отдельные потоки на отдельных ядрах
центрального процессора, что дополнительно повысит производительность. Завершение
основного потока программы приведет к завершенmо работы всех потоков.
18.8.1. Потоки
Для создания потока в PyQt предназначен класс QThread, который определен в модуле
QtCore и наследует класс QObject. Конструктор класса QThread имеет следующий формат:
QТhread( [parent=None])
Параметр parent задает родительский объект создаваемого потока. При уничтожении объ
екта-родителя поток также будет "уничтожен.
Чтобы создать поток, следует определить класс, производный QThread, и вставить в него
метод run(). Код, расположенный в методе run(), будет выполняться в отдельном потоке,
а после завершения выполнения метода run() этот поток прекратит свое существование.
Чтобы запустить поток, нужно создать объект потока и вызвать у него метод start() в сле
дующем формате:
start( [priority=Priority. InheritPriority])
Параметр priority задает приоритет выполнения потока по отношенmо к другим потокам
в виде значения одного из следующих элементов перечисления Priority из класса QТhreact:
IdlePriority (самый низкий приоритет), LowestPriority, LowPriority, NoпnalPriority,
:!ighPr.:i.ority, Highestpriority, TirneCriticalPriority (самый высокий приоритет) и
InheritPriority (автоматический выбор приоритета - значение по умолчанmо).
Следует учитывать, что при наличии потока с самым высоким приоритетом поток с самым
низким приоритетом в некоторых операционных системах может быть проигнорирован.
Задать приоритет потока также позволяет метод setPriority(<Пpиopитeт Priority>). Узнать,
какой приоритет использует запущенный поток, можно с помощью метода priority() .
После запуска потока генерируется сигнал started(), а после завершения - сигнал
finished(). Назначив этим сигналам обработчики, можно контролировать состояние потока
Збб Часть 11. Библиотека PyQt б
из основного потока программы. Метод isRunning() потока возвращает значение тrue, если
текущий поток выполняется, а метод isFinished() - значение True, если поток закончил
выполнение.
Потоки выполняются внутри одного процесса и имеют доступ ко всем глобальным пере
менным. Однако из потока нельзя изменять что-либо в основном потоке программы (на
пример, менять текст надписи). Для изменения данных в основном потоке нужно использо
вать сигналы. Внутри потока у нужного сигнала вызывается метод emit(), который, собст
венно, и генерирует его. В параметрах метода emit() можно указать данные, которые будут
переданы обработчику сигнала. А внутри основного потока назначается обработчик этого
сигнала, который и будет обновлять интерфейс программы.
Рассмотрим использование потоков на примере (листинг 18.13).
from PyQtб import QtCore, QtWidgets
class MyТhread(QtCore.QThread):
mysignal = QtCore.pyqtSignal(str)
def init (self, parent=None):
QtCore.QТhread. init (self, parent)
def run(self):
for i in range(l, 21):
self.sleep(З) # "Засыnаем" на 3 секунды
# Передача данных из потока через сигнал
self.mysignal.emit("i = %s" % i)
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.label = QtWidgets.QLabel("Haжмитe кнопку для запуска потока")
self.label.setAlignrnent(QtCore.Qt.AlignrnentFlag.AlignHCenter)
self.button = QtWidgets.QPushButton("Зaпycтит1;, процесс")
self.vbox = QtWidgets.QVВoxLayout()
self.vbox.addWidget(self.label)
self.vbox.addWidget(self.button)
self.setLayout(self.vbox)
self.mythread = MyТhread() # Создаем поток
self.button.clicked.connect(self.on_clicked)
self.mythread.started.connect(self.on_started)
self.mythread.finished.coпnect(self.on_finished)
self.mythread.mysignal.connect(self.on_change,
QtCore.Qt.ConnectionType.QueuedConnection)
def on_clicked(self):
self.button.setDisaЫed(True) # Делаем кнопку неактивной
self.mythread.start() # Запускаем поток
def on_started(self): # Вызывается при запуске потока
self.label.setText("Bызвaн метод on_started()")
def on_finished(self): # Вызывается при завершении потока
self.label.setText("Вызван метод on_finished()")
self.button.setDisaЫed(False) # Делаем кнопку активной
Глава 18. Введение в PyQt б 367
def on_change(self, s):
self.laЬel.setText(s)
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow ()
window.setWindowТitle("Иcпoльзoвaниe потоков")
window.resize(ЗOO, 70)
window.show()
sys.exit(арр.ехес(). )
Здесь мы создали класс MyТhread, производный от QThread. В нем мы определили свой сиг
нал mysignal, для чего создали атрибут с таким же именем и занесли в него значение, воз
вращенное функцией pyqtSignal() из модуля QtCore. Функции pyqtSignal() мы передали
в качестве параметра тип str (строка Python), тем самым указав PyQt, что вновь определен
ный сигнал будет принимать единственный параметр строкового типа:
mysignal = QtCore.pyqtSignal(str)
В том же классе мы определили обязательный для потоков метод run() - в нем произво
дится имитация процесса с помощью цикла перебора последовательности и метода sleep() :
каждые три секунды выполняется генерация сигнала mysignal и передача текущего значе
ния переменной i в составе строки:
self.mysignal.emit("i = %s" % i)
Внутри конструктора класса MyWindow мы назначили обработчик этого сигнала с помощью
выражения
self.mythread.mysignal.connect(self.on_change,
QtCore.Qt.ConnectionType.QueuedConnection)
Здесь все нам уже знакомо: у свойства mysignal потока, которое представляет одноименный
сигнал, вызывается метод connect( J , и ему первым параметром передается обработчик. Во
втором параметре метода connect() с помощью элемента QueuedConnection перечисления
connectionType указывается, что сигнал помещается в очередь обработки событий и обра
ботчик должен выполняться в основном потоке программы. Из основного потока мы можем
смело изменять свойства компонентов.
Теперь рассмотрим код метода класса MyWindow, который станет обработчиком сигнала
mysignal:
def on_change(self, s):
self.laЬel.setText(s)
Второй параметр этого метода служит для приема параметра, переданного сигналу. Значе
ние этого параметра будет выведено в надписи с помощью метода setтext().
Еще в конструкторе класса MyWindow производится создание надписи и кнопки, а затем их
размещение внутри вертикального контейнера. Далее создается объект класса MyТhread и
сохраняется в атрибуте mythread, чтобы в дальнейшем потоком можно бьmо управлять. За
пуск потока производится с помощью метода start( J внутри обработчика нажатия кнопки.
Чтобы исключить повторный запуск потока, мы с помощью метода setDisaЫed() делаем
368 Часть 11. Библиотека PyQt б
кнопку неактивной, а после окончаIШЯ работы потока внутри обработчика сигнала
finished() опять делаем кнопку активной.
Для имитации длительного процесса мы использовали статический метод sleep() из класса
QТhread. Вообще, приостановить выполнение потока позволяют следующие статические
методы класса QThread:
♦ sleep(<Продолжительность>) - продолжительность задается в секундах:
QtCore.QThread.sleep(З) # "Засьmаем" на З секунды
♦ msleep (<Продолжительность>) - продолжительность задается в миллисекундах:
QtCore.QThread.msleep(ЗOOO) # "Засьmаем" на З секунды
♦ usleep(<Продолжительность>) - продолжительность задается в микросекундах:
QtCore.QThread.usleep(ЗOOOOOO) # "Засьmаем" на З секунды
Еще один полезный статичный метод класса QThread - yieldCurrentThread () - немедлен
но приостанавливает выполнение текущего потока и передает управление следующему
ожидающему выполнения потоку, если таковой есть:
QtCore,QThread.yieldCurrentThread()
18.8.2. Управление потоками
Если поток предназначен для выполнения в течение неопределенно долгого времени (на
пример, в нем планируется производить какие-либо сложные вычисления в цикле), следует
предусмотреть средства для управления этим потоком (скажем, для досрочного прерывания
вычислений). Сделать это можно, создав в классе потока атрибут, который будет содержать
значение (обычно логическое), обозначающее текущее состояние потока: «остановлен»
или «работает». На каждой итерации цикла вычислений выполняется обращение к этому
атрибуту, и как только его значение сменится на «остановлен», цикл прерывается и поток
завершает работу. Изменить значение указанного атрибута можно через объект потока,
в обработчике какого-либо события. Пример применения такого подхода для запуска и ос
тановки потока приведен в листинге 18.14.
from PyQtб import QtCore, QtWidgets
class MyТhread(QtCore.QТhread):
mysignal = QtCore.pyqtSignal(str)
def init (self, parent=None):
QtCore.QТhread. init (self, parent)
self.running False # Флаг вьmолнения
self.count = О
def run(self):
self.running True
while self.running: # Проверяем значение флага
self.count += l
self.mysignal.emit("count = %s" % self.count)
self.sleep(l) # Имитируем процесс
Глава 18. Введение в PyQt б 369
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.label = QtWidgets.QLabel("Haжмитe кнопку для запуска потока")
self.label.setAlignment(QtCore.Qt.AlignmentFlag.AlignHCenter)
self.ЬtnStart = QtWidgets. QPushButton("Запустить поток")
self. ЬtnStop = QtWidgets.QPushButton( "Остановить поток")
self.vbox = QtWidgets.QVВoxLayout()
self.vbox.addWidget(self.label)
self.vbox.addWidget(self.ЬtпStart)
self.vbox.addWidget(self.ЬtnStop)
self.setLayout(self.vbox)
self.mythread = MyТhread()
self.ЬtnStart.clicked.connect(self.on_start)
self.ЬtnStop.clicked.connect(self.on_stop)
self.mythread.mysignal.connect(self.on_change,
QtCore.Qt.ConnectionType.QueuedConnection)
def on_start(self):
if not self.mythread.isRunning():
self. mythread.start() # Запускаем поток
def on_stop(self):
self.mythread.running = False # Изменяем флаг вьшолнения
def on_change(self, s):
self.label.setтext(s)
def closeEvent(self, event): # Вызывается при закрытии окна
self.hide() # Скрываем окно
self.mythread.running = False # Изменяем флаг вьшолнения
self.mythread.wait(S000) # Даем время, чтобы закончить
event.accept() # Закрываем окно
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.setWindowТitle("Зaпycк и остановка потока")
window.resize(З00, 100)
window.show()
sys.exit(app.exec())
В этом примере в конструкторе класса MyThread создается атрибут running, и ему присваи
вается значение False. При запуске потока внутри метода run () значение атрибута изменя
ется на тrue. Затем запускается цикл, в котором значение этого атрибута указывается в ка
честве условия. Как только значение атрибута станет равным значению False, цикл будет
остановлен.
Внутри конструктора класса MyWindow производится создание надписи, двух кнопок и объ
екта класса MyТhread. Далее назначаются обработчики сигналов. По нажатии кнопки Запус
тить поток выполнится метод on_start(), внутри которого с помощью метода isRunning()
производится проверка текущего статуса потока. Если поток не запущен, он запускается
370 Часть 11. Библиотека PyQt 6
вызовом метода start(). По нажатии кнопки Остановить поток выполнится метод
on_ stop(), в котором атрибуту running присваивается значение False. Это значение являет
ся условием выхода из цикла внутри метода run().
Путем изменения значения атрибута можно прервать выполнение цикла только в том слу
чае, если закончилось выполнение очередной итерации. Если поток длительное время ожи
дает какого-либо события (например, ответа сервера), можно так и не дождаться заверше
ния потока. Чтобы принудительно прервать выполнение потока, следует воспользоваться
методом terminate(). Однако к этому методу рекомендуется прибегать только в крайнем
случае, поскольку прерьmание производится в произвольном месте кода. При этом блоки
ровки автоматически не снимаются и существует вероятность повредить обрабатываемые
данные. После вызова метода terminate() следует вызвать метод wait().
При закрытии окна программа завершается, что также приводит к завершению всех пото
ков. Чтобы предотвратить повреждение данных, следует перехватить событие закрытия
окна и дождаться окончания выполнения потоков. Чтобы перехватить событие, необходимо
внутри класса создать метод с именем closeEvent(). Этот метод будет автоматически вы
зван при попытке закрыть окно. В качестве параметра метод должен принимать объект со
бытия event, через который можно получить дополнительную информацию о событии.
Чтобы закрыть окно внутри метода closeEvent(), следует вызвать метод accept() объекта
события. Если необходимо предотвратить закрытие окна, то надо вызвать метод ignore().
Внутри метода closeEvent() мы присваиваем атрибуту running значение False. Далее с по
мощью метода wait() даем возможность потоку нормально завершить работу. В качестве
параметра метод wait() принимает количество миллисекунд, по истечении которых управ
ление будет передано следующей инструкции. Необходимо учить1вать, что это максималь
ное время: если поток закончит работу раньше, то и метод закончит выполнение раньше.
Метод wait() возвращает значение True, если поток успешно завершил работу, и False
в противном случае. Ожидание завершения потока занимает некоторое время, в течение
которого окно будет по-прежнему видимым. Чтобы не обескуражить пользователя, в самом
начале метода closeEvent() мы скрьmаем окно вызовом метода hide().
Каждый поток может иметь собственный цикл обработки событий, запускаемый вызовом
метода ехес (). В этом случае потоки могут обмениваться сигналами между собой. Чтобы
прервать цикл, следует вызвать слот quit() или метод exit( [returnCode=OJ). Рассмотрим
обмен сигналами между потоками на примере (листинг 18.15).
from PyQtб import QtCore, QtWidgets
class Threadl(QtCore.QТhread):
sl = QtCore.pyqtSignal(int)
def init (self, parent=None):
QtCore.QТhread. init (self, parent)
self.count = О
def run(self):
self.ехес () # Запускаем цикл обработки сигналов
def on_start(self):
self.count += 1
self.sl.emit(self.count)
Глава 18. Введение в PyQt 6 371
class Thread2(QtCore.QТhread):.
s2 = QtCore.pyqtSignal(str)
def init (self, parent=None):
QtCore.QThread. init (self, parent)
def run(self):
self.ехес() # Запускаем цикл обработки сигналов
def on_change(self, i):
i += 10
self.s2.emit("%d" % i)
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.laЬel = QtWidgets.QLabel("Haжмитe кнопку")
self.label.setAlignment(QtCore.Qt.AlignmentFlag.AlignHCenter)
self.button = QtWidgets.QPushВutton("Cгeнepиpoвaть сигнал")
self.vbox = QtWidgets.QVВoxLayout()
self.vbox.addWidget(self.laЬel)
self.vЬox.addWidget(self.button)
self.setLayout(self.vbox)
self.threadl = Threadl()
self.thread2 = Thread2()
self.threadl.start()
self.thread2.start()
self.button.clicked.connect(self.threadl.on_start)
self.threadl.s1.connect(self.thread2.on_change)
self.thread2.s2.connect(self.on_thread2_s2)
def on_thread2_s2(self, s):
self.label.setText(s)
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.setWindowТitle("Oбмeн сигналами между потоками")
window.resize(З00, 70)
window.show()
sys.exit(app.exec())
В этом примере мы создали классы Threadl, Thread2 и MyWindow. Первые два класса пред
ставляют собой потоки. Внутри них в методе run() вызывается метод ехес(), который
запускает цикл обработки событий. В конструкторе класса окна MyWindow производится соз
дание надписи, кнопки и объектов классов Threadl и Thread2. Далее выполняется запуск
сразу двух потоков.
В следующей инструкции сигнал нажатия кнопки соединяется с методом on..:._start() перво
го потока. Внутри этого метода производится какая-либо операция (в нашем случае - уве
личение значения атрибута count), а затем с помощью метода emit() генерируется сигнал
s1, и в параметре передается результат выполнения метода. Сигнал s1 соединен с методом:
372 Часть 11. Библиотека PyQt 6
on_change() второго потока. Внутри этого метода также производится какая-либо операция,
а затем генерируется сигнал s2, и передается результат выполнения метода. В свою очередь,
сигнал s2 соединен со слотом on_thread2_s2 объекта окна, который выводит в надпись зна
чение, переданное с этим сигналом. Таким образом, по нажатии кнопки Сгенерировать
сигнал вначале будет вызван метод on_ start() класса Threadl, затем - метод on_change()
класса Thread2, а потом� метод on_thread2 _s2 () класса MyWindow, который выведет ре
зультат выполнения на экран.
18.8.3. Очереди
Очередь - это подобие списка с возможностью добавлять элементы лишь в его конец
и извлекать элементы, в зависимости от типа очереди,· либо из начала, либо из конца, при
этом извлеченный элемент удаляется из очереди. Очереди часто применяются, если требу
ется распределять постоянно. поступающие задачи между ограниченным набором работаю
щих потоков.
Модуль queue из стандартной библиотеки Python содержит следующие классы потокобезо
пасных очередей:
♦ Queue - обычная очередь типа «первым пришел, первым вышел». Формат конструктора:
Queue( [maxsize=O])
Параметр maxsize в этом и последующих случаях задает максимальный размер очереди
(количество элементов, которое может содержать очередь). Если параметр равен нулю
или отрицательному значению, то размер очереди не ограничен. Пример:
>>> import queue
>>> q = queue.Queue()
>>> q.put_nowait("eleml")
>>> q.put_nowait("elem2 ")
>>> q.get_nowait()
'eleml'
>>> q.get_nowait()
'elem2'
♦ LifoQueue - стек (очередь типа «первым пришел, последним вышел»). Формат конст
руктора:
LifoQueue ( [maxsize=O])
Пример:
>>> q = queue.LifoQueue()
>>> q.put_nowait("eleml")
>>> q.put_nowait("elem2")
>>> q.get_nowait()
'elem2'
>>> q.get_nowait()
'eleml'
♦ PriorityQueue - обычная очередь с приоритетами. Элементы очереди должны быть
кортежами, в которых первым элементом является число, означающее приоритет, а вто
рым - значение заносимого в очередь элемента. При получении значения возвращается
Глава 18. Введение в PyQt б 373
элемент с наивысшим приоритетом (наименьшим значением в �ервом параметре корте
жа). Формат конструктора класса:
PriorityQueue( [maxsize=0])
Пример:
>>> q = queue.PriorityQueue()
>>> q.put_nowait((10, "eleml"))
>>> q.put_nowait((3, "elem2"))
>>> q.put_nowait((12, "elem3"))
>>> q.get_nowait()
(3, 'elem2')
>>> q.get_nowait()
(10, 'eleml')
>>> q.get_nowait()
( 12, 'elem3')
♦ SimpleQueue (начиная с Python 3.7)- ан!!.!lогичен Queue, но не поддерживает некоторые
программные инструменты и отнимает меньше системных ресурсов. Формат конструк
тора:
SimpleQueue()
Пример:
»> q = qyeue. SimpleQueue()
>>> q.put_nowait("eleml")
>>> q.put_nowait("elem2")
>>> q.get_nowait()
'eleml'
>>> q.get_nowait()
'elem2'
Все классы очередей поддерживают следующие методы:
♦ put(<Элемент> [, Ыock=Тrue] [, timeout=None]) - добавляет заданнъ1й элемент в теку
щую очередь.
Если очередь имеет ограниченнъ1й размер и полностью заполнена, а в параметре Ыосk
указано значение False, будет сгенерировано исключение Full из модуля queue. Если же
параметром Ыосk передано значение тrue, метод приостановит выполнение потока и
будет ждать, пока в очереди не появится свободное место, в течение времени, заданного
в параметре timeout в секундах. Если в очереди за это время не освободилось место для
добавления элемента, также генерируется исключение Full.
Поскольку очередь, реализуемая классом SimpleQueue, всегда имеет неограниченный
размер, значения параметров Ыосk и timeout в ее случае игнорируются. Эти параметры
· предусмотрены лишь для совместимости;
♦ put_nowait(<Элемент>) - добавляет заданный элемент в текущую очередь без ожида
ния. Эквивалентен выражению
рut(<Элемент>, False)
♦ get( [Ыock=TrueJ [, timeout=None]) - извлекает из текущей очереди очередной эле
мент и возвращает его (при этом удаляя из очереди).
3.74 Часть 11. Библиотека PyQt б
Если очередь пуста и параметр Ыосk имеет значение False, генерируется исключение
Empty из модуля que�e. Если в параметре Ыосk указано значение True, метод приостано
вит выполнение потока и будет ожидать, когда в очереди появится хотя бы один эле
мент, в течение времени, заданного параметром timeout в секундах. Если в очереди за
заданное время так и не появилось ни одного элемента, также генерируется исключение
Empty;
♦ get_nowait() - извлекает элемент из текущей очереди без ожидания. Эквивалентен вы
ражеюпо
get(False);
♦ qsize() - возвращает приблизительное количество элементов в текущей очереди. Если
доступ к очереди имеют несколько потоков, доверять этому значению не следует -
в любой момент времени размер очереди может измениться;
♦ empty() - возвращает тrue, если текущая очередь пуста, и False - в противном случае.
Если доступ к очереди имеют несколько потоков, доверять этому значеюпо также не
следует - в любой момент времени размер очереди может измениться.
Следующие методы не поддерживаются классом SimpleQueue:
♦ j oin() - блокирует поток, пока из текущей очереди не будут выбраны все элементы.
Другие потоки после выборки очередного элемента из очереди должны вызьmать метод
task_done();
♦ task_done() - уведомляет текущую очередь о выборке очередного элемента;
♦ full() - возвращает True, если текущая очередь заполнена до предела, и False -
в противном случае. Если доступ к очереди имеют несколько потоков, доверять этому
значению также не следует - в любой момент времени размер очереди может изме
ниться.
Рассмотрим использование очереди в многопоточной программе на примере (листинг 18.16).
from PyQtб import QtCore, QtWidgets
import queue
class MyТhread(QtCore.QТhread):
task_done = QtCore.pyqtSignal(int, int, name='taskDone')
def init (self, id, queue, parent=None):
QtCore.QТhread. init (self, parent)
self.id = id
self.queue = queue
def run(self):
while True:
task = self;queue.get() # Получаем задание
self.sleep(5) # Имитируем обработку
self .task_done.emit(task, self.id) # Передаем данные обратно
self.queue.task_done()
class MyWindow(QtWidgets.QPushButton):
def init (self):
QtWidgets.QPushButton. init (self)
Глава 18. Введение в PyQt б 375
self.setText("Раздать задания")
self.queue = queue.Queue() # Создаем очередь
self.threads = []
for i in range(l, 3): # Создаем потоки и запускаем
thread = MyТhread(i, self.queue)
self.threads.append(thread)
thread.task done.connect(self.on_task_done,
·otcore.Qt.ConnectionType.QueuedConnection)
thread.start( )
self.clicked.connect(self.on_add_task)
def on_add_task(self):
for i in range(O, 11):
self.queue.put(i) # Добавляем элементы в очередь
def on_task_done(self, data, id):
print(data, "- id =", id) # Выводим обработанные данные
if name main
irnport sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.setWindowТitle("Иcпoльзoвaниe очереди")
window.resize(300, 30)
window.show()
sys.exit(app.exec())
В этом примере конструктор класса MyТhread принимает уникальный идентификатор (id) и
ссылку на очередь (queue), которые сохраняются в одноименных атрибутах класса. В мето
де run() внутри бесконечного цикла из очереди с помощью метода get() извлекается оче
редной элемент. Если очередь пуста, поток будет ожидать, пока не появится хотя бы один
элемент. Далее производится обработка извлеченного элемента (в нашем случае - просто
задержка), а затем результаты обработки передаются главному потоку через сигнал
taskDone, принимающий два целочисленных параметра. После чего вызовом метода
task_done() у очереди указывается, что извлеченный элемент успешно обработан.
Отметим, что в вызове функции pyqtSignal() присутствует именованный параметр name:
task_done = QtCore.pyqtSignal(int, int, name= 'taskDone')
Он задает имя сигнала и может быть полезен в том случае, если это имя отличается от име
ни атрибута класса, соответствующего сигналу (как в нашем случае, где имя сигнала
taskDone отличается от имени атрибута task_done). После чего мы можем обращаться
к сигналу как по имени соответствующего ему атрибута:
self.task_done.emit(task, self.id)
так и по имени, заданному в параметре name функции pyqtSignal():
self.taskDone.emit(task, self.id)
Поскольку в окне программы будет присутствовать лишь кнопка, класс окна MyWindow сде
лан производным от класса кнопки QPushВutton, а не от класса окна QWidget. Все визуаль
ные компоненты (включая кнопку) являются наследниками класса QWidget, поэтому любой
компонент, не имеющий родителя, будет выведен в своем собственном окне.
376 Часть 11. Библиотека PyQt б
Внугри конструктора класса MyWindow с помощью метода setText() задается текст надписи
на кнопке, затем создается объект класса Queue и сохраняется в атрибуте queue. В следую
щем выражении создается список, в котором будут храниться ссылки на объекты потоков.
Сами объекты потоков (в нашем случае их два) создаются внутри цикла и добавляются
в список. Внутри цикла также производится назначение обработчика сигнала taskDone и
запуск потока с помощью метода start(). Далее назначается обработчик нажатия кнопки.
По нажатии кнопки Раздать задания вызываетс11 метод on_add_task(), внутри которого
обрабатываемые элементы добавляются в очередь. После этого потоки начинают работать,
и каждый из них выбирает из очереди один элемент. Завершив обработку элемента, поток
генерирует сигнал taskDone и вызьmает метод task_done(), информирующий об окончании
обработки задания. Главный поток получает сигнал и вызывает метод on_task_done(),
внутри котqрого через параметры будут доступны результаты обработки. В нашем примере
эти результаты просто выводятся в консоль (чтобы увидеть их, следует сохранить файл
с расширением ру или просто запустить программу из среды IDLE Shell). Обработав эле
мент и сигнализировав об этом, поток выбирает из очереди следующий элемент и т. д. Если
очередь окажется пуста, потоки приостановят работу, пока в очереди не Щ)Явятся элементы.
18.8.4. Блокировщики и автоблокировщики
Попытка одновременного доступа со стороны нескольких потоков к какому-либо ресурсу,
не поддерживающему одновременный доступ (например, консоли), может привести к не
предсказуемому поведению программы или даже ее аварийному завершению. В таких слу
чаях в программе следует временно блокировать ресурс при использовании его одним из
потоков, чтобы другие потоки не смогли получить к нему доступ.
Блокировщик (мьютекс) позволяет явно заблокировать ресурс на произвольное время. Впо
следствии заблокированный ресурс должен быть явно разблокирован.
Блокировщик реализуется классом QMutex из модуля QtCore. Конструктор класса имеет сле
дующий формат:
QМutex()
Класс QMutex поддерживает следующие методы:
♦ lock() - устанавливает блокировку. Если ресурс бьш заблокирован другим потоком,
работа текущего потока приостанавливается до снятия блокировки;
♦ tryLock( [timeout=O]) - устанавливает блокировку. Если блокировка бьша успешно
установлена, метод возвращает значение тrue, если ресурс заблокирован другим пото
ком - значение False без ожидания возможности установить блокировку. В параметре
timeout можно указать максимальное время ожидания в миллисекундах. Если в пара
метре указано отрицательное значение, то метод tryLock() ведет себя аналогично мето
ду lock();
♦ unlock() - снимает блокировку.
Рассмотрим использование блокировщика на примере (листинг 18.17).
Лr,1сtинr 18.17. Исnол'-30вание бtiоки�в'ц{
from PyQtб import QtCore, QtWidgets
class MyТhread(QtCore.QThread):
х = 10 # Атрибут класса
Глава 18. Введение в PyQt 6 377
mutex = QtCore.QМutex() # Блокировщик
def init (self, id, parent=None):
QtCore.QТhread. init (self, parent)
self.id = id
def run(self):
self.change_x()
def change_x(self):
MyТhread.mutex.lock() # Блокируем
print("x =", MyТhread.x, "id =", self.id) -
MyТhread.x += 5
self.sleep(2)
print("x =", MyТhread.x, "id =", self.id)
MyТhread.x += 34
print("x =", MyТhread.x, "id =", self.id)
MyТhread.mutex.unlock() # Снимаем блокировку
class MyWindow(QtWidgets.QPushButton):
def init (self):
QtWidgets.QPushButton. init (self)
self.setText("Зaпycтt-iть")
self.threadl = MyТhread(l)
self.thread2 = MyТhread(2)
self.clicked.connect(self.on_start)
def on_start(self):
if not self.threadl.isRunning(): self.threadl.start()
if not self.thread2.isRunning(): self.thread2.start()
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.setWindowТitle("Иcпoльзoвaниe блокировщика")
window.resize(300, 30)
window.show()
sys.exit(app.exec())
В классе MyТhread мы создали атрибут класса х, который и будем блокировать блокировщи
ком. Последний мы сохранили в другом атрибуте класса - mutex. Код метода change_х () ,
в котором изменяется значение атрибута класса х, поместили между вызовами методов
lock() и unlock() блокировщика, - для гарантии, что к атрибуту класса в каждый кон
кретный момент времени имеет доступ лишь один поток.
Внутри конструктора класса MyWindow создаются два объекта класса MyТhread и назнача
ется обработчик нажатия кнопки. По нажатии кнопки Запустить будет вызван метод
on_start(), внутри которого одновременно запускаются оба потока (конечно, если они не
были запущены ранее). В результате мы получим в консоли следующий результат:
х = 10 id 1
х = 15 id 1
378 Часть 11. Библиотека PyQt б
х = 49 id = 1
х = 49 id = 2
х = 54 id = 2
х = 88 id = 2
Как можно видеть, сначала значение атрибута класса изменил поток с идешификатором 1, а
лишь затем - поток с идеirrИфикатором 2. Если блокировку не указать, то результат будет
иным:
х = 10 id = 1
х = 15 id = 2
х = 20 id = 1
х = 54 id = 1
х = 54 id = 2
х = 88 id = 2
В этом случае поток с идентификатором 2 изменил значение атрибута класса х до оконча
ния выполнения метода change_х() в потоке с идентификатором 1.
При возникновении исключения внутри метода change_х() атрибут класса останется забло
кированным, т. к. вызов метода unlock() не будет выполнен. Кроме того, можно no случай
ности забыть вызвать метод unlock() , что также приведет к вечной блокировке.
Автоблокировщик автоматически блокирует указанный блокировщик при создании и так же
автоматически разблокирует его при уничтожении. Применение автоблокировщика позво
ляет исключить описанную только что ситуацmо.
Автоблокировщик реализуется классом QМutexLocker из модуля QtCore. Формат вызова
конструктора:
QМutехLосkеr(<Блокировщик>)
Переделаем метод change_x() из класса MyТhread (см. листинг 18.17) с использованием
автоблокировщика (листинг 18.18).
def change_x(self):
# Создаем автоблокировщик и тем самым накладываем блокировку
ml = QtCore.QМutexLocker(MyТhread.mutex)
print("x =", MyТhread.x, "id =", self.id)
MyТhread.x += 5
self.sleep(2)
print("x =", MyТhread.x, "id =", self.id)
MyТhread.x += 34
print("x =", MyТhread.x, "id =", self.id)
# Здесь локальная переменная с автоблокировщиком будет уничтожена,
# автоблокировщик перестанет существовать, и блокировка снимется
Класс QМutexLocker является менеджером кошекста, что позволяет использовать автобло
кировщики в обработчиках контекстов. Переделаем снова метод change_х() из класса
MyТhread (см. листинг 18.17), применив в этот раз инструкцmо обработчика кошекста (лис-
тинг 18.19).
Глава _18. Введение в PyQt б 379
nмarмt"tr 18.19. Иcnon�tiмe
def change_x(self):
with QtCore.QМutexLocker(MyТhread.mutex):
print("x =,", MyТhread.x, "id =", self.id)
MyТhread.x += 5
self.sleep(2)
print("x =", MyТhread.x, "id -"
- , self.id)
MyThread.x += 34
print("x =", MyТhread.x, "id -"
- , self.id)
# Блокировка автоматически снимется
Осталось сделать несколько замечаний:
♦ установка и снятие блокировки занимают некоторое время, что снижает быстродействие
программы. Поэтому встроенные типы данных не обеспечивают безопасную работу
в многопоточных программах. Прежде чем использовать блокировки, подумайте -
может быть, в вашей программе они и не нужны;
♦ ожидание снятия блокировки может заблокировать основной поток, и программа пере
станет реагировать на события. Если такое происходит достаточно часто, следует ис
пользовать сигналы, а не прямой доступ;
♦ если первый поток, владея ресурсом А, захочет получить доступ к ресурсу в, а второй
поток, владея ресурсом в, захочет получить доступ к ресурсу А, возникнет взаимная бло
кировка, снятия которой потоки будут ждать вечно. В этой ситуации следует временно
разблокировать занятый ресурс в одном из потоков после превышения определенного
времени.
Класс QMutexLocker также поддерживает методы unlock() и relock(). Первый метод вы
полняет разблокировку без уничтожения текушего автоблокировщика, а второй накладыва
ет блокировку повторно.
ПРИМЕЧАНИЕ
Для синхронизации и координации потоков также можно использовать классы QSemaphore
и QWaitCondition. За подробной информацией по этим классам обращайтесь к документа
ции по PyQt.· A в стандартную библиотеку языка Python входят модули multiprocessing
и threading, которые позволяют работать с потоками в любой программе. Однако при
использовании PyQt нужно отдать предпочтение классу QThread, поскольку он позволяет
работать с сигналами.
18.9. Вывод заставки
При запуске программы начальная инициализация может отнять много времени. Поэтому
сразу после запуска следует вывести заставку - окно, показьmающее логотип программы
и процесс запуска. По окончании запуска программы заставку нужно скрыть.
Дпя вывода заставки в PyQt предназначен класс QSplashScreen из модуля QtWidgets. Конст
руктор класса имеет следующие форматы:
QSplashScreen([<Изображение>] [, ] [flags=O] )
QSplashScreen(<Poдитeль>[, <Изображение>][, flags=OJ)
380 Часть 11. Библиотека PyQt б
Параметр <Родитель> позволяет указать ссылку на родительский компонент. В параме�ре
<Изображение> указывается ссылка на изображение (объект класса QPixmap из модуля QtG-�).
которое будет отображаться на заставке. Конструктору класса QPixmap можно передать путь
к файлу с изображением. Параметр flags предназначен для указания типа окна - напри
мер, чтобы заставка отображалась поверх всех остальных окон, следует передать элемент
WindowStaysOnTopHint перечисления WindoWТype из модуля QtCore.Qt.
Класс QSplashScreen поддерживает следующие методы:
♦ show() - отображает текущую заставку;
♦ finish(<Окно>) - закрывает текущую заставку. В качестве параметра указывается
ссылка на главное окно программы;
♦ showMessage( <Надпись> [, <Местоположение> [, <Цвет>] ] ) - выводит указанную надпись
в текущей заставке. Во втором параметре задается местоположение надписи в окне в ви
де одного из следующих элементов перечисления AlignmentFlag из модуля QtCore.Qt
или их комбинации через оператор 1: AlignTop (по верху), Aligncenter (по центру верти
кали и горизонтали), AlignBottom (по низу), AlignHCenter (по центру горизонтали),
AlignVCenter (по центру вертикали), AlignLeft (по левой стороне), AlignRight (по пра
вой стороне). В третьем параметре указьшается цвет текста в виде элемента перечисле
ния GlobalColor из модуля QtCore.Qt (скажем, Ыасk) объекта класса QColor (например,
QColor("red"),QColor("#ff0000"),QColor(255, О, О) и др.);
♦ clearMessage() - удаляет ранее выведенную надпись;
♦ setPixmap(<Изображение>) - выводит указанное изображение в текущей заставке.
В качестве параметра указывается объект класса QPixmap;
♦ pixmap() - возвращает изображение, выведенное в текущей заставке, в виде объекта
класса QPixmap.
Пример кода, вьшодящего заставку, показан в листинге 18.20, а сама заставка - на
рис. 18.7.
from PyQtб import QtGui, QtWidgets, QtCore
import time
class MyWindow(QtWidgets.QPushButton):
def init (self):
QtWidgets.QPushButton. init (self)
self .setText("Зaкpьrrь окно")
self .clicked.connect(QtWidgets.QApplication.instance().quit)
def load_data(self, sp):
for i in range(l, 11): # Имитируем процесс
time.sleep(2) # Что-то загружаем
sp .showMessage("Зaгpyзкa данных... {0)%".format(i * 10),
QtCore.Qt.AlignmentFlag.AlignHCenter 1
QtCore.Qt.AlignmentFlag.AlignВottom,
QtCore.Qt.GlobalColor.Ыack)
# Принудительно обрабатываем собьrrия
QtWidgets.QApplication.instance().processEvents()
Глава 18. Введение в PyQt б 381
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
splash = QtWidgets.QSplashScreen(QtGui.QPixmap("splashscreen.svg"))
splash.showМessage("Загрузка данных... 0%",
QtCore.Qt.AlignmentFlag.AlignHCenter
QtCore.Qt.AlignmentFlag.AlignBottom,
QtGui.QColor("Ыасk"))
splash.show() # Отображаем заставку
# Принудительно обрабатываем события
QtWidgets.QApplication.instance().processEvents()
window = MyWindow()
window.setWindowТitle("Bывoд заставки")
window.resize(З00, 30)
window.load_data(splash) # Загружаем данные
window.show()
splash.finish(window) # Скрываем заставку
sys.exit(app.exec())
Рис. 18.7. Заставка
ГЛАВА 19
Окна
Обычное окно представляется классом QWidget из модуля QtWidgets.
Класс QWidget является базовым для всех классов, представляющих компоненты. Благодаря
этому любой компонент (например, кнопка), у которого не бьш явно указан родитель, будет
автqматически выведен в собственном окне (чем мы и пользовались в главе 18). Кроме того,
классы компонентов поддерживают все методы, имеющиеся в кдассе QWidget (в том числе
методы для вьшода компонентов, их скрытия, изменения размеров, перемещения, получе
ния состояния видимости, размеров, местоположения компонентов и др.).
Для создания окна также можно использовать более специализированные классы: QFrarne
(окно С рамкой), QDialog (диалоговое ОКНО) ИЛИ QMainWindow (главное ОКНО программы
с меню, панелями инструментов и строкой состояния). Последним двум классам будут по
священы главы 27 и 28 соответственно.
19.1. Создание и вывод окон
Самый простой способ создать пустое окно показан в листинге 19.1.
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget() # Создаем окно
window.setWindowТitle("Зaгoлoвoк окна") # Указываем заголовок
window.resize(ЗOO, 50) # Минимальные размеры
window.show() # Отображаем окно
sys.exit(app.exec())
Конструктор класса QWidget имеет следующий формат:
QWidget( [parent=Null] [, flags=O])
В параметре parent указьшается ссьшка на родительский компонент. Если этот параметр
имеет значение None и у параметра flags указано значение О, компонент не будет иметь
родителя и получит свое собственное окно.
Глава 19. Окна 383
Параметр flags определяет тип создаваемого oIOia. Доступные для задания ТШIЪI будут рас
смотрены в разд. 19.1.1.
Указать ссьmку на родительский компонент и, возможно, тип окна уже после его создания
позволяет метод setParent() окна. Формат метода:
sеtРаrеnt(<Родитель>[, <Тип окна>])
Получить ссылку на родительский компонент можно с помощью метода parentWidget().
Если компонент не имеет родителя, возвращается значение None.
Для изменения текста в заголовке окна предназначен метод setWindowТitle(<Новый текст>).
А метод windowТitle() возвращает текст, в1�1веденный в заголовке OIOia.
После создания окна необходимо вызвать у него метод show(), чтобы вывести окно на эк
ран. Для скрытия OIOia предназначен метод hide(). Для отображения и скрытия окна также
можно пользоваться методом setVisiЫe(<Состояние>). Если параметром этого метода пе
редано значение тrue, oIOiq будет отображено, а если значение False - скрыто. Пример
отображения окна:
window.setVisiЬle(True)
Проверить, видимо ли окно в настоящее время или нет, позволяет метод isVisiЫe(), кото
рый возвращает True, если OIOIO видимо, и False.-11 противном случае. Кроме того, можно
воспользоваться методом isHidden()- он возвращает тrue, если окно скрыто, и False -
в противном случае.
19.1.1. Типы окон
Тип oIOia можно задать как при его создании, во втором параметре конструктора класса
QWidget, так и вызовом метода setWindowFlags(<ТИп окна>) перед выводом окна.
В качестве типа окна можно указать один из следующих элементов перечисления
WindowТype из модуля QtCore. Qt:
♦ Widget-в зависимости от наличия родителя:
• родитель указан-компонент выводится в составе родительского окна;
• родитель не указан- компонент вьmодится в окне изменяемых размеров с рамкой,
заголовком, системным меню, Юiопками сворачивания, разворачивания и закрытия.
Этот тип используется по умолчанию у класса QWidget;
♦ Window - то же самое, что и Widget, только компонент всегда выводится в собственном
окне, независимо от наличия или отсутствия у него родителя;
♦ Dialog- диалоговое окно: изменяемых размеров, с рамкой, ,заголовком и кнопкой за
крытия. Используется умолчанию у класса QDialog. Пример:
window.setWindowFlags(QtCore.Qt.WindowТype.Dialog)
♦ Sheet и Drawer-oIOia в стиле Apple Macintosh;
♦ Popup- всПЛЪiвающее oIOio: неизменяемых размеров, без рамки, заголовка и кнопок,
может отбрасывать тень;
♦ Tool- панель инструментов: изменяемых размеров, с рамкой, уменьшенным заголов
ком и Юiопкой закрытия;
♦ тoolTip- всПЛЪiвающая подсказка: неизменяемых размеров, без рамки, заголовка и
кнопок;
384 Часть 11. Библиотека PyQt б
♦ SplashScreen - заставка: неизменяемых размеров, без рамки, заголовка и кнопок. Ис
пользуется по умолчаншо у класса QSplashScreen;
♦ SuЬWindow - подчиненное окно: неизменяемых размеров, с рамкой, уменьшенным заго-
ловком, без кнопок;
♦ ForeignWindow - окно, созданное другим процессом;
♦ CoverWindow - окно, представляющее свернутую программу· на некоторых платформах.
Получить тип окна в программе позволяет метод windowТype() .
У окон можно через оператор I дополнительно указать следующие элементы перечисления
WindowТype (упомянуты только наиболее часто используемые элементы, полный их список
ищите в документации):
♦ MSWindowsFixedSizeDialogHint - запрещает изменение размеров окна. Кнопка развора
чивания в заголовке окна станет неактивной;
♦ Framelesswindowнint - убирает рамку и заголовок окна. Изменять размеры окна и пе-
ремещать его будет нельзя;
♦ NoDropShadowWindowHint - убирает отбрасываемую окном тень;
♦ customizeWindowHint - убирает рамку и заголовок окна, но добавляет эффект объемно
сти. Размеры окна можно изменять;
♦ WindowТitleHint - добавляет заголовок окна. Пример вывода окна фиксированного
размера с заголовком, в котором находится только текст:
window.setWindowFlags(QtCore.Qt.Window'Гype.Window 1
QtCore.Qt.WindowТype.FramelessWindowHint
QtCore.Qt.Window'Гype.Window'ГitleHint)
♦ WindowsystemМenuHint - добавляет в заголовок системное меню и кнопку закрытия;
♦ WindowМinimizeButtonHint - добавляет в заголовок кнопку сворачивания;
♦ WindowМaximizeButtonHint - добавляет в заголовок кнопку разворачивания;·
♦ WindowМinМaxButtonsHint - добавляет в заголовок кнопки сворачивания и разворачива
ния;
♦ WindowCloseButtonHin� - добавляет в заголовок кнопку закрытия;
♦ WindowContextHelpButtonHint - добавляет в заголовок кнопку вывода справки;
♦ WindowStaysOnTopHint - сообщает системе, что окно всегда должно отображаться по
верх всех других окон;
♦ WindowStaysOnBottomНint - сообщает системе, что окно всегда должно быть располо
жено позади всех других окон.
Получить все установленные элементы-типы окна из программы позволяет метод
windowFlags() .
19.2. Размеры окон и управление ими
Для изменения размеров окна предназначены следующие методы объекта окна:
♦ resize() - изменяет размеры текущего окна. Форматы вызова:
rеsizе(<Ширина>, <Высота>)
rеsizе(<Объект размеров>)
Глава 19. Окна 385
В первом · формате ширина и высота указываются в виде чисел, а во втором - в виде
объекта класса QSize из модуля QtCore. Пример:
window. resize(l00, 70)
window. resize(QtCore.QSize(l00, 70))
Если содержимое окна не помещается в установленный размер, то размер будет выбран
так, чтобы компоненты поместились без искажения при условии, что используются
менеджеры геометрии. Если используется абсоmотное позиционирование, компоненты
могут оказаться наполовину или полностью за пределами видимой части окна:
♦ setGeornetry() - изменяет одновременно местоположение и размеры текущего окна.
Форматы вызова:
setGeornetry(<X>, <У>, <Ширина>, <Высота>)
setGeornetry(<Oбъeкт местоположения и размеров>)
В первом формате первые два параметра задают координаты левого верхнего угла отно
сительно родительского компонента, а третий и четвертый параметры - ширину и вы
соту. Во втором формате указывается объект класса QRect из модуля QtCore.
ВНИМАНИЕ!
Начало координат расположено в левом верхнем углу. Ось х направлена вправо, а ось У -
вниз.
Примеры:
window.setGeornetry(l00, 100, 100, 70)
window.setGeornetry(QtCore.QRect(l00, 100, 100, 70))
♦ setFixedSize() - задает у текущего окна фиксированные ширину и высоту и делает его
размеры неизменяемыми. Форматы вызова такие же, как и у метода resize(). Пример:
window.setFixedSize(l00, 70)
window. setFixedSize(QtCore.QSize(l00, 70))
♦ setFixedWidth(<Ширина>) - задает у текущего окна фиксированную ширину и делает ее
неизменяемой;
♦ setFixedHeight (<Высота>) - задает у текущего окна фиксированную высоту и делает ее
неизменяемой;
♦ setMinirnurnSize() - задает минимальные размеры окна. Форматы вызова такие же, как
и у метода resize(). Пример:
window. setMinirnurnSize(l00, 70)
window.setMinirnurnSize(QtCore.QSize(l00, 70))
♦ setMinirnurnWidth(<Ширина>) - задает минимальную ширину;
♦ setMinirnurnНeight (<Высота>) - задает минимальную высоту;
♦ setMaxirnurnSize() - задает максимальные размеры окна. Форматы вызова такие же, как
и у метода resize(). Пример:
window.setMaxirnurnSize(l00, 70)
window.setMaxirnurnSize(QtCore.QSize(l00, 70))
♦ setMaxirnurnWidth (<Ширина>) - задает максимальную ширину;
386 Часть 11. Библиотека PyQt б
♦ setMaximumНeight(<Высота>) - задает максимальную высоту;
♦ setвasesize() - . задает базовые размеры.. Форматы вызова такие же, как и у метода
resize(). Пример:
window.setBaseSize(500, 500)
window.setBaseSize(QtCore.QSize(500, 500))
♦ adjustSize() - подгоняет размеры окна под содержимое, учитывая рекомендуемые
размеры, которые выдаются методом sizeHint().
Получить размеры позволяют следующие методы окна:
♦ width() - возвращает ширину;
♦ height() - возвращают высоту:
window.resize(50, 70)
print(window.width(), window.height()) # 50 70
♦ size() - возвращает объект' класса QSize, содержащий текущие размеры:
window.resize(50, 70)
print(window.size().width(), window.size() .height()) # 50 70
♦ minimumSize() - возвращает объект класса QSize, содержащий минимальные размеры;
♦ minimumWidth() - возвращает минимальную ширину;
♦ minimumНeight() - возвращает минимальную высоту;
♦ maximumSize() - возвращает объект класса QSize, содержащий максимальные размеры;
♦ maximumWidth() - возвращает максимальную ширину;
♦ maximumНeight() - возвращает максимальную высоту;
♦ basesize() - возвращает объект класса QSize, содержащий базовые размеры;
♦ sizeHint() - возвращает объект класса QSize, содержащий рекомендуемые размеры
компонента. Если таковые являются отрицательными, считается, что нет рекомендуемо
го размера;
♦ minimumSizeHint() - возвращает объект класса QSize, содержащий рекомендуемые ми
нимальные размеры окна. Если таковые являются отрицательными, то считается, что нет
рекомендуемого минимального размера;
♦ rect() - возвращает объект класса QRect, содержащий координаты и размеры прямо
угольника, в который вписано окно:
window.setGeometry(QtCore.QRect(lOO, 100, 100, 70))
rect ='window.rect()
print(rect.left(), rect.top()) # о о
print(rect.width(), rect.height()) # 100 70
♦ geometry() - возвращает объект класса QRect, содержащий координаты относительно
родительского компонента:
window.setGeometry(QtCore.QRect(lOO, 100, 100, 70))
rect = window.geometry()
print(rect.left(), rect.top()) # 100 100
print(rect.width(), rect.height()) # 100 70
Глава 19. Окна 387
При изменении и получении размеров окна следует учитывать, что:
♦ размеры не вкточают высоту заголовка окна и толщину границ;
♦ размеры могут изменяться в зависимости от настроек стиля. Например, на разных ком
пьютерах может быть задан шрифт разного наименования и кегля, поэтому от указания
фиксированных размеров лучше отказаться;
♦ размер может изменяться в промежутке между получением значения и действиями, об
рабатывающими эти значения. Например, сразу после получения размеров пользователь
может изменить размеры окна с помощью мыши.
Чтобы получить размеры окна, вкточающие высоту заголовка и ширину границ, следует
воспользоваться методом frameSize(), который возвращает объект класса QSize. Обратите
внимание, что полные размеры окна доступны только после его отображения, - до этого
чомента они совпадают с размерами клиентской области окна, без учета высоты заголовка
н толщины границ. Пример получения полных размеров окна:
�indow.resize(200, 70) # Задаем размеры
·,1indow.show() # Отображаем окно
;,rint(window.width(), window.height()) # 200 70
;,rint(window.frameSize() .width(),
window.frameSize().height()) # 208 104
Чтобы получить координаты окна с учетом высоты заголовка и толщины границ, следует
воспользоваться методом frameGeometry(), который возвращает объект класса QRect.
И в этом случае полные размеры окна доступны только после его отображения. Пример:
,,1indow.setGeometry(l00, 100, 200, 70)
window.show() # Отображаем окно
rect = window.geometry()
print(rect.left(), rect.top()) # 100 100
print(rect.width(), rect.height()) # 200 70
rect = window.frameGeometry()
print(rect.left(), rect.top()) # 96 70
print(rect.width(), rect.height()) # 208 1{)4
19.3. Местоположение окна и управление им
Задать местоположение окна на экране позволяют следующие методы объекта окна:
♦ move() - задает положение текущего окна относительно родителя с учетом высоты за
головка и толщины границ. Форматы вызова:
move(<Х>, <У>)
mоvе(<Объект мес�оположения>)
В первом формате координаты левого верхнего угла окна указываются в виде чисел, а во
• втором - в виде объекта класса QPoint из модуля QtCore. Пример вывода окна в левом
верхнем углу экрана:
window.move(0, О)
window.move(QtCore.QPoint(0, О))
388 Часть 11. Библиотека PyQt б
♦ setGeometry(<Х>, <У>, <Ширина>, <Высота>) - задает одновременно положение и раз
меры текущего окна. Подробно этот метод был описан в разд. 19.2.
Получить местоположение окна позволяют следующие методы:
♦ х() - возвращает горизонтальную координату левого верхнего угла окна относительно
родителя с учетом толщины гранип.
♦ у() - возвращает вертикальную координату левого верхнего угла окна относительно
родителя с учетом высоты заголовка и толщины границ:
window.move(l0, 10)
rint(window.x(), window.y()) # 10 10
♦ pos() - возвращает объект класса QPoint, содержащий координаты левого верхнего
угла окна относительно родителя с учетом высоты заголовка и толщины границ:
window.move(l0, 10)
print(window.pos() .х(), window.pos().у()) # 10 10
♦ ·geometry() - возвращает объект класса QRect, содержащий координаты относительно
родительского компонента, без учета высоты заголовка и толщины границ:
window.resize(300, 100)
window.move(l0, 10)
rect = window.geometry()
print(rect.left(), rect.top()) # 14 40
print(rect.width(), rect.height()) # 300 100
♦ frameGeometry() - возвращает объект класса QRect, содержащий координаты относи
тельно родителя с учетом высоты заголовка и ширины границ. Полные размеры окна
доступны только после отображения окна. Пример:
window.resize(300, 100)
window.move(l0, 10)
rect = window.frameGeometry()
print(rect. left(), rect.top()) # 10 10
print(rect.width(), rect.height()) # 308 134
Для отображения окна по центру экрана, у правой или нижней его границы необходимо
знать размеры экрана. Для получения их следует вызвать метод screen() окна, возвращаю
щий ссылку на экран, на котором выведено это окно и который представлен объектом клас
са QScreen из модуля QtGui. Получить размеры экрана позволяют следующие методы этого
класса:
♦ size() - возвращает объект класса QSize, содержащий полные размеры экрана:
screen = window.screen()
siz = screen.size()
print(siz.width(), siz.height()) # 2560 1440
♦ availaЫeSize() - возвращает объект класса QSize, содержащий размеры доступной
части экрана (не занятой панелью задач и иными панелями):
siz = screen.availaЬleSize()
print(siz.width(), siz.height()) # 2560 1400
♦ geometry () - возвращает объект класса QRect, содержащий координаты и полные раз
меры экрана:
Глава 19. Окна 389
screen = window.screen()
rect = screen.geometry()
print(rect.left(), rect.top()) # о о
print(rect.width(), rect.height()) # 2560 1440
♦ availaЬleGeometry() - возвращает объект класса QRect, содержащий координаты и
размеры доступной части экрана (не занятой панелью задач и иными панелями):
rect = screen.availaЬleGeometry()
print(rect.left(), rect.top()) # о о
print(rect.width(), rect.height()) # 2560 100
Пример отображения окна приблизительно по центру экрана показан в листинге 19.2.
:rom PyQt6 import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
·.чindow.setWindowТitle( "Вывод окна примерно по центру экрана")
window.resize(З00, 100)
screen_size = window.screen().availaЬleSize()
х = (screen_size.width() - window.width()) // 2
у= (screen_size.height() - window.height()) // 2
window.move(x, у)
window. show()
sys.exit(app.exec())
В этом примере использовались методы width() и height() окна, которые не учитьmают
высоту заголовка и толщину границ. Если требуется поместить окно точно в центре экрана,
следует воспользоваться методом frameSize(). Однако этот метод возвращает корректные
значения лишь после вывода окна. Если код выравнивания по центру расположить после
вызова метода show(), окно вначале отобразится в одном месте экрана, а затем переместит
ся в центр, что вызовет неприятное мелькание. Чтобы исключить такое мелькание, следует
вначале вьmести окно за пределами экрана, а затем переместить его в центр (листинг 19.3).
from PyQt6 import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("Bывoд окна точно по центру экрана")
window.resize(З00, 100)
window.move(window.width() * -2, О)
window.show()
screen_size = window.screen().availaЬleSize()
х = (screen_size.width() - window.frameSize().width()) // 2
у= (screen_size.height() - window.frameSize().height()) // 2
window.move(x, у)
sys.exit(app.exec())
390 Часть 11. Библиотека PyQt б
Если нужно расположить окно в правом верхнем углу экрана, надо,заменить код из преды
дущего примера, выравнивающий окно по центру, следующим кодом:
screen_size = window.screen() .availaЫeSize()
х = screen_size.width() - window.frarneSize().width()
window.move(x, О)
Следует заметить, что экран может быть разделен на несколько рабочих столов. Это необ
ходимо учитывать при размещении окна (за более подробной информацией обращайтесь
к документации по классу QScreen).
19.4. Классы, задающие координаты и размеры
В двух предыдущих разделах бьmи упомянуты классы QPoint, QSize и QRect, определенные
в модуле QtCore. Рассмотрим их.
ПРИМЕЧАНИЕ
Классы QPoint, QSize и QRect предназначены для работы с целыми числами. Чтобы рабо
тать с вещественными числами, необходимо использовать классы QPointF, QSizeF и QRectF
из модуля QtCore.
19.4.1. Класс QPoint координаты точки
Класс QPoint описывает координаты точки. Его конструктор поддерживает следующие
форматы вызова:
QPoint()
QPoint(<X>, <У>)
QPoint(<OOъeкт класса QPoint>)
Первый формат создает объект класса с нулевыми координатами:
>>> from PyQtб import QtCore
>>> р = QtCore.QPoint()
»> р.х(), р.у()
(О, О)
Второй формат позволяет явно указать координаты точки:
>>> р = QtCore.QPoint(l0, 88)
»> р.х(), р.у()
(10, 88) /
Третий формат создает копию заданного объекта:
>>> р = QtCore.QPoint(QtCore.QPoint(l0, 88))
»> р.х(), р.у()
(10, 88)
Класс поддерживает следующие методы:
♦ х ( ) - возвращает горизонтальную координату;
♦ у ( ) - возвращает вертикальную координату;
♦ setx(<Х>) - задает новую горизонтальную координату;
Глава 19. Окна 391
♦ setY(<У>) - задает новую вертикальную координату;
♦ isNull() - возвращает True, если координаты равны нулю, и False - в противном слу
чае:
>>> р = QtCore.QPoint()
»> p.isNull ()
True
>>> p.setX(l0); p.setY(88)
»> р.х()' р.у()
(10, 88)
♦ manhattanLength() - возвращает сумму абсолютных значений координат:
>>> QtCore.QPoint(l0, 88) .manhattanLength()
98
Над двумя объектами класса QPoint можно выполнять операции+,+=, -(минус),-=, = и !=.
Объект класса QPoint можно умножить или разделить на вещественное число (операторами
*,*=,/и/=). Примеры:
>>> pl = QtCore.QPoint(l0, 20); р2 = QtCore.QPoint(5, 9)
>>> pl + р2, pl - р2
(PyQt6.QtCore.QPoint(15, 29), PyQt6.QtCore.QPoint(5, 11))
>>> pl * 2.5, pl / 2.0
(PyQt6.QtCore.QPoint(25, 50), PyQtб.QtCore.QPoint(5, 10))
>>> -pl, pl = р2, pl != р2
(PyQtб.QtCore.QPoint(-10, -20), False, True)
19.4.2. Класс QSize: размеры прямоугольной области
Класс QSize описывает размеры прямоугольной области. Для создания объектов класса
предназначены следующие форматы конструкторов:
QSize()
QSizе(<Ширина>, <Высота>)
QSizе(<Объект класса QSize>)
Первый формат создает невалидный объект с отрицательными шириной и высотой. Второй
формат позволяет явно указать ширину и высоту. Третий формат создает кошпо указанного
объекта. Примеры:
>>> from PyQtб import QtCore
>>> s1 = QtCore.QSize(); s2 = QtCore.QSize(l0, 55); s3 = QtCore.QSize(s2)
>>> s1
PyQtб.QtCore.QSize(-1, -1)
>>> s2, s3·
(PyQtб.QtCore.QSize(l0, 55), PyQtб.QtCore.QSize(l0, 55))
Класс поддерживает следующие методы:
♦ width() - возвращает ширину;
♦ height() - возвращает высоту;
♦ setWidth(<Ширина>) - задает ширину;
392 Часть 11. Библиотека PyQt 6
♦ setHeight(<Высота>) - задает высоту.
Примеры:
>>> s = QtCore.QSize()
>>> s.setWidth(lO); s.setHeight(55)
>>> s.width(), s.height()
(10, 55)
♦ isNull() - возвращает True, если ширина и высота равны нуmо, и False - в противном
случае;
♦ isValid() - возвращает тrue, если ширина и высота больше или равны нулю, и
False - в противном случае;
♦ isEmpty() - возвращает тrue, если ширина или высота меньше или равна нулю, и
False - в противном случае;
♦ scale() - задает у текущей области новые размеры. Форматы метода:
sсаlе(<Новые размеры QSize>, <ТИп преобразования>)
sсаlе(<Новая ширина>, <Новая высота>, <Тип преобразования>)
В параметре <Тип преобразования> могут быть указаны следующие элементы перечис
ления AspectRatioMode из модуля QtCore.Qt:
• IgnoreAspectRatio - не сохраняет пропорции сторон;
• KeepAspectRatio - производится попытка масштабирования старой области внутри
новой области без нарушения пропорций;
• KeepAspectRatioByExpanding - производится попытка полностью заполнить новую
область без нарушения пропорций старой области.
Если новая ширина или высота имеет значение О, размеры изменяются без сохранения
пропорций, вне зависимости от значения параметра <Тип преобразования>. Примеры:
>>> s = QtCore.QSize(50, 20)
>>> s.scale(70, 60, QtCore.Qt.AspectRatioMode.IgnoreAspectRatio); s
PyQt6.QtCore.QSize(70, 60)
>>> s = QtCore.QSize(50-, 20)
>>> s.scale(70, 60, QtCore.Qt.AspectRatioMode.KeepAspectRatio); s
PyQt6.QtCore.QSize(70, 28)
>>> s = QtCore.QSize(50, 20)
>>> s.scale(70, 60, QtCore.Qt.AspectRatioMode.KeepAspectRatioByExpanding); s
PyQt6.QtCore.QSize(150, 60)
♦ scaled() - то же самое, что scale(), только не изменяет текущий объект, а возвращает
новый объект класса QSize с новыми размерами:
>>> s1 = QtCore.QSize(50, 20)
>>> s2 = s1.scaled(70, 60, QtCore.Qt.AspectRatioMode.IgnoreAspectRatio)
>>> s1, s2
(PyQt6.QtCore.QSize(50, 20), PyQt6.QtCore.QSize(70, 60))
♦ boundedTo(<Размеры QSize>) - возвращает объект класса QSize, который содержит ми
- нимальную ширину и высоту из текущих размеров и размеров, указаннь1х в параметре:
Глава 19. Окна 393
>>> s = QtCore.QSize(50, 20)
>>> s.boundedTo(QtCore.QSize(400, 5))
PyQt6.QtCore.QSize(50, 5)
»> s.boundedTo(QtCore.QSize(40, 50))
PyQtб .QtCore .QSize(40, 20) ·
♦ expandedтo(<Размеры QSize>) - возвращает объект класса QSize, который содержит
максимальную ширину и высоту из текущих размеров и размеров, указанных в пара
метре:
>>> s = QtCore.QSize(50, 20)
>>> s.expandedTo(QtCore.QSize(400, 5))
PyQt6.QtCore.QSize(400, 20)
>>> s.expandedTo(QtCore.QSize(40, 50))
PyQt6.QtCore.QSize(50, 50)
♦ transpose() - меняет ширину и высоту местами. Метод изменяет текущий объект и
ничего не возвращает. Пример:
>>> s = QtCore.QSize(50, 20)
>>> s.transpose(); s
PyQt6.QtCore.QSize(20, 50)
♦ transposed() - то же самое, что transpose(), только не изменяет текущий объект, а
возвращает новый объект класса QSize с измененными размерами:
>>> s1 = QtCore.QSize(50, 20)
>>> s2 = s1. transposed()
>>> s1, s2
(PyQt6.QtCore.QSize(50, 20), PyQt6.QtCore.QSize(20, 50))
Над двумя·объектами класса QSize можно выполнять операции+,+=, - (минус),-=, == и !=.
Кроме того, объект класса QSize можно умножить или разделить на вещественное число
(операторами*,*=,/ и/=). Примеры:
>>> s1 = QtCore.QSize(50, 20); s2 = QtCore.QSize(l0, 5)
>>> s1 + s2, s1 - s2
(PyQtб.QtCore.QSize(б0, 25), PyQt6.QtCore.QSize(40, 15))
>>> s1 * 2.5, s1 / 2
(PyQt6.QtCore.QSize(125, 50), PyQt6.QtCore.QSize(25, 10))
>>> s1 == s2, s1 != s2
(False, True)
19.4.З. Класс QRect
координаты и размеры прямоугольной области
Класс QRect описывает координаты и размеры прямоугольной области. Для создания объек
тов класса предназначены следующие форматы конструктора:
QRect()
QRect(<X>, <У>, <Ширина>, <Высота>)
QRесt(<Координаты левого верхнего угла QPoint>, <Размеры QSize>)
QRесt(<Координаты левого верхнего угла QPoint>,
<Координаты правого нижнего угла QPoint>)
QRесt(<Объект класса QRect>)
394 Часть 11. Библиотека PyQt б
Первый формат создает объект с нулевыми координатами и размерами. Второй и третий
форматы позволяют указать координаты левого верхнего угла и размеры области. Четвер
тый формат позволяет указать координаты левого верхнего угла и правого нижнего угла.
Пятый конструктор создает копию заданного объекта.
Примеры:
>>> from PyQtб import QtCore
>>> r = QtCore.QRect()
>>> r.left(), r.top(), r.right(), r.bottom(), r.width(), r.height()
(0, О, -1, -1, О, О)
>>> r = QtCore.QRect(l0, 15, 400, 300)
>>> r.left(), r.top(), r.right(), r.bottom (), r.width(), r .height()
(10, 15, 409, 314, 400, 300)
>>> r = QtCore.QRect(QtCore.QPoint(l0, 15), QtCore.QSize(400, 300))
>>> r.left(), r·.top(), r.right(), r.bottom(), r.width(), r.height()
(10, 15, 409, 314, 400, 300)
>>> r = QtCore.QRect(QtCore.QPoint(l0, 15), QtCore.QPoint(409, 314))
>>> r.left(), r.top(), r.right(), r.bottom(), r.width(), r.height()
(10, 15, 409, 314, 400, 300)
»> QtCore.QRect(r)
PyQtб.QtCore.QRect(l0, 15, 400, 300)
Изменить значения уже после создания объекта позволяют следующие методы:
♦ setLeft(<Xl>) и setx(<Xl>) - задает горизонтальную координату левого верхнего угла;
♦ setTop(<Yl>) и setY(<Yl>) - задает вертикальную координату левого верхнего угла:
>>> r = QtCore.QRect()
>>> r.setLeft(10); r.setTop(55); r
PyQtб.QtCore.QRect(l0, 55, -10, -55)
>>> r.setX(12); r.setY(81); r
PyQt6.QtCore.QRect(12, 81, -12, -81)
♦ setRight(<Х2>) - задает горизонтальную координату правого нижнего угла;
♦ setвottom(<Y2>) - задает вертикальную координату правого нижнего угла:
>>> r = QtCore.QRect()
>>> r.setRight(12); r.setBottom(81); r
PyQtб.QtCore.QRect(0, О, 13, 82)
♦ setTopLeft(<Координаты QPoint>) - задает координаты левого верхнего угла;
♦ setTopRight(<Координаты QPoint>) - задает координаты правого верхнего угла;
♦ setBottomLeft(<Координаты QPoint>) - задает координаты левого нижнего угла;
♦ setBottomRight(<Координаты QPoint>) - задает координаты правого нижнего угла.
Примеры:
>>> r = QtCore.QRect()
>>> r.setTopLeft(QtCore.QPoint(l0, 5))
>>> r.setBottomRight(QtCore.QPoint(39, 19)); r
PyQtб.QtCore.QRect(l0, 5, 30, 15)
Глава 19. Окна 395
>>> r.setTopRight(QtCore.QPoint(39, 5))
>>> r.setBottomLeft(QtCore.QPoint(l0, 19)); r
PyQtб.QtCore.QRect(l0, 5, 30, 15)
♦ setWidth(<Ширина>) - задает ширину;
♦ setHeight (<Высота>) - задает высоту;
♦ setSize(<Размеры QSize>) - задает ширину и высоту;
♦ setRect( <Xl>, <Yl>, <Ширина>, <Высота>) - задает координаты левого верхнего угла и
размеры области;
♦ setcoords(<Xl>, <Yl>, <Х2>, <У2>) - задает координаты левого верхнего и правого
нижнего углов.
Примеры:
>>> r = QtCore.QRect()
>>> r.setRect(l0, 10, 100, 500); r
PyQtб.QtCore.QRect(l0, 10, 100, 500)
>>> r.setCoords(l0, 10, 109, 509); r
PyQtб.QtCore.QRect(l0, 10, 100, 500)
♦ marginsAdded(<Границы QМargins>) - возвращает новый объект класса QRect, который
представляет текущую область, увеличенную на заданные величины границ. Границы
указываются в виде объекта класса QMargins из модуля QtCore, конструктор которого
имеет следующий формат:
QМargins(<Гpaницa слева>, <Граница сверху>, <Граница справа>,
<Граница снизу>)
Текущий объект при этом не изменяется. Примеры:
>>> rl = QtCore.QRect(l0, 15, 400, 300)
>>> m = QtCore.QМargins(5, 2, 5, 2)
>>> r2 = rl.marginsAdded(m)
>>> r2
PyQt6.QtCore.QRect(5, 13, 410, 304)
>>> rl
PyQtб.QtCore.QRect(l0, 15, 400, 300)
♦ marginsRemoved() - то же самое, что marginsAdded(), только уменьшает новую область
на заданные величинъ1 границ:
>>> rl = QtCore.QRect(l0, 15, 400, 300)
>>> m = QtCore.QМargins(2, 10, 2, 10) .1.-1
>>> r2 = rl.marginsRemoved(m)
>>> r2
PyQt6.QtCore.QRect(12, 25, 396, 280)
>>> rl
PyQtб.QtCore.QRect(l0, 15, 400, 300)
♦ moveтo() - задает новые координаты левого верхнего угла. Форматы вызова:
moveTo(<X>, <У>)
mоvеТо(<Координаты QPoint>)
♦ moveLeft(<Х>) - задает новую горизонтальную координату левого верхнего угла;
396 Часть 11. Библиотека PyQt б
♦ moveтop(<У>) - задает новую вертикальную координату левого верхнего угла.
Примеры:
>>> r = QtCore.QRect(l0, 15, 400, 300)
>>> r.moveTo(0, О); r
PyQtб.QtCore.QRect(0, О, 400, 300)
>>> r.moveTo(QtCore.QPoint(l0, 10)); r
PyQtб.QtCore.QRect(l0, 10, 400, 300)
>>> r.moveLeft(5); r.moveTop(0); r
PyQt6.QtCore.QRect(5, О, 400, 300)
♦ moveRight(<Х>) - задает новую горизонтальную координату правого нижнего угла;
♦ moveBottom(<У>) - задает новую вертикальную координату правого нижнего угла;
♦ moveTopLeft (<Координаты QPoint>) - задает новые координаты левого верхнего угла;
♦ moveTopRight (<Координаты QPoint>) - задает новые координаты правого верхнего угла;
♦ moveBottomLeft (<Координаты QPoint>) - задает новые координаты левого нижнего угла;
♦ moveBottomRight(<Координаты QPoint>) - задает новые координаты правого нижнего
угла.
Примеры:
>>> r = QtCore.QRect(l0, 15, 400, 300)
>>> r.moveTopLeft(QtCore.QPoint(0, О)); r
PyQtб.QtCore.QRect(0, О, 400, 300)
>>> r.moveBottomRight(QtCore.QPoint(599, 499)); r
PyQt6.QtCore.QRect(200, 200, 400, 300)
♦ moveCenter(<Координаты QPoint>) - задает новые координаты центра;
♦ translat�() - смещает левь�й верхний угол на заданные значения. Форматы вызова:
translate(<Cдвиг по оси Х>, <Сдвиг по оси У>)
trаnslаtе(<Величины сдвигов QPoint)
Примеры:
>>> r = QtCore.QRect(0, О, 400, 300)
>>> r.translate(20, 15); r
PyQt6.QtCore.QRect(20, 15, 400, 300)
>>> r.translate(QtCore.QPoint(l0, 5)); r
PyQt6.QtCore.QRect(30, 20, 400, 300)
♦ translated() - аналогичен методу translate(), только возвращает новый объект клас
са QRect с новыми координатами, а не изменяет текущий;
♦ adjust(<Xl>, <Yl>, <Х2>, <У2>) - смещает левый верхний и правый нижний углы на
заданные значения:
>>> r = QtCore.QRect(0, О, 400, 300)
>>> r.adjust(l0, 5, 10, 5); r
PyQtб.QtCore.QRect(l0, 5, 400, 300)
♦ adjusted() - аналогичен методу adjust(), только возвращает новый объект класса
QRect, а не изменяет текущий.
Глава 19. Окна 397
Для получения параметров области предназначены следующие методы:
♦ left() и х () - возвращают горизонтальную координату левого верхнего угла;
♦ top() и у() - возвращают вертикальную координату левого верхнего угла;
♦ right() - возвращает горизонтальную координату правого нижнего угла;
♦ bottom() - возвращает вертикальную координату правого нижнего угла;
♦ width() - возвращает ширину;
♦ height() - возвращает высоту;
♦ size() - возвращает размеры в виде объекта класса QSize.
Примеры:
>>>r = QtCore.QRect(l0, 15, 400, 300)
»> r.left(), r.top(), r.x(), r.y(), r.right(), r.bottom()
(10, 15, 10, 15, 409, 314)
»> r.width(), r.height(), r.size()
(400, 300, PyQt6 .QtCore.QSize(400, 300))
♦ topLeft() - возвращает координаты левого верхнего угла в виде объекта класса QPoint;
♦ topRight ( ) - возвращает координаты правого верхнего угла в виде объекта класса
QPoint;
♦ bottomLeft() - возвращает координаты левого нижнего угла в виде объекта класса
QPoint;
♦ bottomRight() - возвращает координаты правого нижнего угла в виде объекта класса
QPoint.
Примеры:
>>> r = QtCore.QRect(l0, 15, 400, 300)
>» r.topLeft(), r. topRight()
(PyQtб.QtCore.QPoint(l0, 15), PyQt6.QtCore .QPoint(409, 15))
>>> r .bottomLeft(), r.bottomRight()
(PyQtб.QtCore.QPoint(l0, 314), PyQt6.QtCore.QPoint(409, 314))
♦ center () - возвращает координаты центра области в виде объекта класса QPoint. При
мер вывода окна в центре доступной области экрана:
screen = window.screen()
window.move(screen.availaЬleGeometry().center() - window.rect().center())
♦ getRect() - возвращает кортеж с координатами левого верхнего угла и размерами об
ласти;
♦ getcoords() - возвращает кортеж с координатами левого верхнего и правого нижнего
углов:
>>> r = QtCore.QRect(l0, 15, 400, 300)
>>> r.getRect(),· r.getCoords()
((10, 15, 400, 300), (10, 15, 409, 314))
Прочие методы:
♦ isNull() - возвращает True, если ширина и высота равны нулю, и False - в противном
случае;
398 Часть 11. Библиотека PyQt б
♦ isValid() - возвращает True, если left() < right() и top() < bottom(), и False -
в противном случае;
♦ isEmpty() - возвращает True, если left() > right() или top() > bottom(), и False -
в противном случае;
♦ noпnalized() - исправляет ситуацию, при которой left() > right() или top() >
bottom(), и возвращает новый объект класса QRect с исправлешп,1ми координатами:
>>> r = QtCore.QRect(QtCore.QPoint(409, 314), QtCore.QPoint(l0, 15))
>>> r
PyQt6.QtCore.QRect(409, 314, -398, -298)
>>> r.noпnalized()
PyQtб.QtCore.QRect(l0, 15, 400, 300)
♦ contains() - возвращает True, если точка с указашп,1ми координатами расположена
внутри текущей области или на ее границе, и False - в противном случае. Форматы вы
зова:
contains(<Х>, <У> [, <Флаг>] )
contains(<OOЪeкт класса QPoint>[, <Флаг>])
Если во втором параметре указано значение True, то точка должна быть расположена
строго внутри области, а не на ее границе (значение параметра по умолчанию - False).
Пример:
>>> r = QtCore.QRect(0, О, 400, 300)
>>> r.contains(0, 10), r.contains(0, 10, True)
(True, False)
♦ contains(<Область QRect>[, <Флаг> J ) - возвращает True, если указанная область рас
положена внутри текущей области или на ее краю, и False - в противном случае. Если
во втором параметре указано значение True, то указанная область должна быть располо
жена строго внутри текущей области, а не на ее краю (значение параметра по умолча
нию - False). Примеры:
>>> r = QtCore.QRect(0, о, 400, 300)
>>> r.contains(QtCore:QRect(0, о, 20, 5))
True
>>> r.contains(QtCore.QRect(0, о, 20, 5), True)
False
♦ intersects(<Область QRect>) - возвращает True, если указанная область пересекается
с текущей, и False - в противном случае;
♦ intersected(<Область QRect>) - возвращает область, которая расположена на пересе
чении текущей и указанной областей, в виде объекта класса QRect:
>>> r = QtCore.QRect(0, О, 20, 20)
>>> r.intersects(QtCore.QRect(l0, 10, 20, 20))
True
>>> r.intersected(QtCore.QRect(l0, 10, 20, 20))
PyQtб.QtCore.QRect(l0, 10, 10, 10)
♦ united(<Область QRect>J - возвращает область, которая охватывает текущую и указан
ную области, в виде объекта класса QRect:
Глава 19. Окна 399
>>> r = QtCore.QRect(O, О, 20, 20)
>>> r.united(QtCore.QRect(30, 30, 20, 20))
PyQtб.QtCore.QRect(O, О, 50, 50)
Над двумя объектами класса QRect можно выполнять операции & и &= (пересечение), 1 и 1 =
(объединение), in (проверка на вхождение), == и ! =:
>>> rl, r2 = QtCore.QRect(O, О, 20, 20), QtCore.QRect(lO, 10, 20, 20)
>>> rl & r2, rl I r2
(PyQtб.QtCore.QRect(lO, 10, 10, 10), PyQtб.Q�Core.QRect(O, О, 30, 30))
>>> rl in r2, rl in QtCore.QRect(O, О, 30, 30)
(False, True)
>>> rl == r2, rl != r2
(False, True)
Также поддерживаются операторы + и -, выполняющие увеличение и уменьшение области
на заданнь1е величинь1 границ, заданнь1е в виде объекта класса QMargins:
>>> r = QtCore.QRect(lO, 15, 400, 300)
>>> m = QtCore.QМargins(5, 15, 5, 15)
>>> r + m
PyQt6.QtCore.QRect(5, О, 410, 330)
>>> r - m
PyQt6.QtCore.QRect(l5, 30, 390, 270)
19.5. Разворачивание и сворачивание окон
Развернуть или свернуть окно позволяют следующие методы класса QWidget:
♦ showМinimized() - сворачивает окно;
♦ showМaximized() - разворачивает окно до максимального размера;
♦ showFullScreen() - включает полноэкраННЬiй режим отображения окна. Окно отобра
жается без заголовка и границ;
♦ showNormal() - возвращает окно к изначальным размерам;
♦ activateWiJ1dow() - делает окно активным (т. е. имеющим фокус ввода). В Windows,
если окно ранее бьшо свернуто, оно не восстанавливается;
♦ setWindowState(<Флаги>) - изменяет состояние окна на основе указаннь1х флагов. В их
качестве указывается комбинация следующих элементов перечисления Windowstate из
модуля QtCore.Qt через оператор 1 :
• WindowNoState - изначальное состояние окна;
• WindowМinimized - окно свернуто;
•, WindowМaximized - окно максимально развернуто;
• WindowFullScreen - полноэкранный режим;
• WindowActive - окно активно.
Например, включить полноэкраннь1й режим можно так:
window.setWindowState((window.windowState() &
~(QtCore.Qt.WindowState.WindowMinimized 1
400 Часть 11. Библиотека PyQt 6
QtCore.Qt.WindowState.WindowMaximized))
QtCore.Qt.WindowState.WindowFullScreen)
Проверить текущее состояние окна позволяют следующие методы:
♦ isMinimized() - возвращает тrue, если окно свернуто, и False - в противном случае;
♦ isMaximized() - возвращает True, если окно развернуто, и False - в противном случае;
♦ isFullScreen() - возвращает True, если у окна вкточен полноэкранный режим, и
False - в противном случае;
♦ isActiveWindow() - возвращает True, если окно активно, и False - в противном случае;
♦ windowstate() - возвращает комбинацию флагов, обозначающих текущее состояние
окна.
Пример проверки использования полноэкранного режима:
if window.windowState() & QtCore.Qt.WindowState.WindowFullScreen:
рrint("Полноэкранный режим")
Пример разворачивания и сворачивания окна приведен в листинге 19.4.
from PyQtб import QtCore, QtWidgets
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.btnМin = QtWidgets.QPushВutton("Свернуть")
self.btnМax = QtWidgets.QPushButton("Paзвepнyть")
self.btnFull = QtWidgets.QPushВutton("Полный экран")
self.btnNormal = QtWidgets.QPushButton("Hopмaльный размер")
vbox = QtWidgets.QVВoxLayout()
vbox.addWidget(self.btnМin)
vbox.addWidget(self.btnМax)
vbox.addWidget(self.btnFull)
vbox.addWidget(self.btnNormal)
self.setLayout(vbox)
self.btnМin.clicked.connect(self.on_min)
self.btnМax.clicked.connect(self.on_max)
self.btnFull.clicked.connect(self.on_full)
self.btnNormal.clicked.connect(self.on_normal)
def on_min(self\:
self.showМinimized()
def on_max(self):
self.showМaximized()
def on_full(self):
self.showFullScreen()
def on_normal(self):
self.showNormal()
if name main
import sys
Глава 19. Окна 401
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.setWindowТitle("Paзвopaчивaниe и сворачивание окна")
window.resize(ЗOO, 100)
window.show()
sys.exit(app.exec())
19.6. Управление прозрачностью окна
Сделать окно полупрозрачным позволяет метод setWindowOpacitу() окна. Формат метода:
setWindowOpacity(<Beщecтвeннoe число от О.О до 1.0>)
Число о.о соответствует полностью прозрачному окну, а число 1.о- отсутствию прозрач
ности. Для получения степени прозрачности окна предназначен метод windowOpacity().
Выведем окно со степенью прозрачности o.s (листинг 19.5).
' Листинt;19:5.f1рлу,проэра-iное окно
:rom PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
·,1indow = QtWidgets.QWidget()
window.setWindowТitle("Пoлynpoзpaчнoe окно")
window.resize(ЗOO, 100)
window.setWindowOpacity(0.5)
,,1indow.show()
print(window.windowOpacity()) # Выведет: О.4980392156862745
sys.exit(app.exec())
19.7. Модальные окна
А1одапьным называется окно, которое перекрывает другие окна программы и не дает поль
зователю взаимодействовать с ними. Модальными обычно делают всевозможные диалого
вые окна.
Сделать окно модальным позволяет метод setWindowМodality(<Флaг>) окна. В качестве па
раметра могут быть указаны следующие элементы перечисления WindowМodality из модуля
QtCore.Qt:
♦ NonМodal- окно не является модальным (поведение по умолчанию);
♦ WindowМodal- окно блокирует только родительские окна в пределах иерархии;
♦ ApplicationМodal- окно блокирует все окна программы.
Окна, открытые из модального окна, не блокируются. Следует также учитывать, что метод
setWindowModality() должен быть вызван до отображения окна.
Получить текущее значение модальности позволяет метод windowМodality(). Проверить,
является ли окно модальным, можно с помощью метода isModal()- он возвращает True,
если окно модально, и False - в противном случае.
402 Часть 11. Библиотека PyQt 6
Создадим два независимых окна. В первом окне разместим кнопку, по нажатии которой
откроется модальное окно - оно будет блокировать только первое окно, но не второе. Мо
дальное окно выведем примерно по центру родительского окна (листинг 19.6).
from PyQtб import QtCore, QtWidgets
import sys
def show modal_window():
global modalWindow
modalWindow = QtWidgets.QWidget(windowl, QtCore.Qt.WindowТype.Window)
modalWindow.setWindowТitle("Moдaльнoe окно")
modalWindow.resize(200, 50)
modalWindow.setWindowModality(QtCore.Qt.WindowМodality.WindowМodal)
modalWindow.setAttribute(QtCore.Qt.WidgetAttribute.WA_DeleteOnClose, True)
modalWindow.move(windowl.geometry().center() -
modalWindow.rect().center() - QtCore.QPoint(4, 30))
modalWindow.show()
арр = QtWidgets.QApplication(sys.argv)
windowl = QtWidgets.QWidget()
windowl.setWindowТitle("Oбычнoe окно")
windowl.resize(З00, 100)
button = QtWidgets.QPushButton("Oткpыть модальное окно")
button.clicked.connect(show_modal_window)
vbox = QtWidgets.QVВoxLayout()
vbox.addWidget(button)
windowl.setLayout(vbox)
windowl .show()
window2 = QtWidgets.QWidget()
window2.setWindowТitle("Этo окно не будет блокировано")
window2.resize(S00, 100)
window2. show()
sys.exit(app.exec())
Ес�и запустить программу и нажать кнопку Открыть модальное окно, откроется окно,
выровненное примерно по центру родительского окна. При этом получить доступ к роди
тельскому окну можно только после закрытия модального окна. Второе окно блокировано
не будет. Однако, если заменить элемент WindowМodal перечисления WindowМodality элемен-
том ApplicationМodal, оба окна будут блокированы.
О_братите внимание, что в конструктор модального окна мы передали ссьшку на первое
окно и элемент Window перечисления WindowТype. Если не указать ссьшку, то первое окно
блокироваться не будет, а если не указать элемент Window, окно вообще не откроется. Кроме
того, мы объявили переменную modalWindow глобальной, иначе при достижении конца
функции переменная выйдет из области видимости и окно будет автоматически удалено.
Чтобы объект окна автоматически удалялся при закрытии окна, атрибуту WA_ DeleteOnClose
в методе setAttribute() бьшо присвоено значение True.
Глава 19. Окна 403
PyQt предоставляет класс QDialog, который предназначен для создания диалоговых окон,
самостоятельно делает окно модальным и выводит его в центре экрана или родительского
окна. Кроме того, этот класс предоставляет множество специальных методов, позволяющих
дождаться закрытия окна, определить статус завершения и выполнить друтие действия.
Подробно класс QDialog мы рассмотрим в главе 27.
19.8. Смена значка окна
Сменить значок, вьmодящийся в заголовке окна, позволяет метод setWindowicon() окна.
В качестве параметра метод принимает объект класса Qicon из модуля QtGui (описан
в разд. 25.3.4).
Конструктору класса Qicon передается путь к графическому файлу со значком. Получить
список поддерживаемых графических форматов можно вызовом статического метода
supportedimageForrnats() класса QimageReader из модуля QtGui. Метод возвращает список
с объектами класса QByteArray. Получим список поддерживаемых форматов:
>>> from PyQtб import QtGui
>>> for i in QtGui.QimageReader.supportedimageForrnats():
print(str(i, "ascii").upper(), end=" ")
ВМР CUR GIF ICNS ICO JPEG JPG РВМ PGM PNG РРМ SVG SVGZ TGA TIF TIFF WВМР
WEBP ХВМ ХРМ
Если у окна не указать значок, будет использоваться значок уровня программы, установ
ленный с помощью метода setWindowicon(<Знaчoк Qicon>) объекта программы. Получить
текущий значок программы можно вызовом у того же объекта метода windowrcon(), кото
рый возвращает объект класса Qicon.
Вместо загрузки значка из файла можно воспользоваться одним из встроенных значков.
Список всех встроенных значков приведен на странице https://doc.qt.io/qt-6/qstyle.html
#StandardPixmap-enum. Пример:
ico = window.style().standardicon(
QtWidgets.QStyle.StandardPixmap.SP_MessageBoxCritical)
window.setWindowicon(ico)
Создадим значок размером 16 на 16 пикселов в формате PNG, сохраним его в одном катало
ге с программой и установим у окна и всей программы (листинг 19. 7).
from PyQtб import QtGui, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("CМeнa значка в заголовке окна")
window.resize(З00, 100)
ico = QtGui.Qicon("icon.png")
window.setWindowicon(ico) # Значок для окна
app.setWindowicon(ico) # Значок программы
window.show()
sys.exit(app.exec())
404 Часть //. Библиотека PyQt б
19.9. Изменение цвета фона окна
Изменить цвет фона окна (или компонента) можно через его палитру. Пш�итра - это набор
цветов для различных составных частей и состояний окна.
Получить текущую палитру окна позволяет его метод palette() . Палитра возвращается
в виде объекта класса QPalette из модуля QtGui.
Чтобы изменить цвет для какой-либо роли и состояния, следует воспользоваться методом
setColor () палитры. Формат метода:
sеtСоlоr([<Состояние>, ]<Составная часть окна>, <Цвет>)
Состояние окна указывается в виде одного из следующих элементов перечисления
ColorGroup из класса QPalette:
♦ Active и Norrnal-окно активно;
♦ DisaЫed-окно недоступно;
♦ Inactive-окно неактивно.
Составная часть окна задается в виде одного из элементов перечисления ColorRole из клас
са QPalette. Так, элемент Window (или Background) обозначает фон окна, а элемент
WindowТext (или Foreground)- текста. Полный список элементов перечисления ColorRole
имеется по интернет-адресу https://doc.qt.io/qt-6/qpalette.html#ColorRole-enum.
Цвет указывается в виде элемента перечисления GlobalColor из модуля QtCore .Qt (скажем,
Ыасk) или объекта класса QColor (например, QColor("red"), QColor("#ff0000"), QColor(255,
О, О) и др.).
После настройки палитры необходимо вызвать метод setPalette(<Палитра>) окна и пере
дать этому методу измененный- объект палитры. Следует помнить, что компоненты
потомки по умолчанию имеют прозрачный фон и не перерисовываются автомати
чески. Чтобы включить перерисовку, необходимо передать значение тrue методу
setAutoFillBackground(<Флаг>) окна.
Изменить цвет фона также можно с помощью СSS-атрибута background-color. Для этого
следует передать таблицу стилей в метод setStyleSheet(<Таблица стилей>) компонента.
Таблицы стилей могут быть внешними (подключение через командную строку), установ
ленными на уровне программы (с помощью метода setStyleSheet() класса QApplication)
или установленными на уровне компонента (с помощью метода setstyleSheet() класса
QWidget). Атрибуты, установленные последними, обычно перекрывают значения аналогич
ных атрибутов, указанных ранее.
Создадим окно с надписью. У активного окна установим зеленый цвет, а у неактивного-
красный. Цвет фона надписи сделаем белым. Для изменения фона окна используем палитру,
а для изменения цвета фона надписи-СSS-атрибут background-color (листинг 19.8).
Листинг 19.8. Изменение цве:rа
from PyQtб import QtCore, QtGui, QtWidgets
import sys
арр = QtWidgets . QApplication(sys.argv)
window = QtWidgets .QWidget()
window.setWindowТitle("Измeнeниe цвета фона окна")
window .resize(З00, 100)
Глава 19. Окна 405
pal = window.palette()·
pal.setColor(QtGui.QPalette.ColorGroup.Normal, QtGui.QPalette.ColorRole.Window,
QtGui.QColor("#008800"))
pal.setColor(QtGui.QPalette.ColorGroup.Inactive,
QtGui.QPalette.ColorRole.Window, QtGui.QColor("#ff0000"))
window.setPalette(pal)
label = QtWidgets.QLabel("Teкcт надписи")
label.setAlignrnent(QtCore.Qt.AlignrnentFlag.AlignHCenter)
label.setStyleSheet("background-color: #ffffff;")
label.setAutoFillBackground(True)
vbox = QtWidgets.QVBoxLayout()
vbox.addWidget(label)
window.setLayout(vbox)
'нindow.show()
sys.exit(app.exec())
19.1 О. Вывод изображения в качестве фона
В качестве фона окна (или компонента) можно использовать изображение. Для эrого необ
ходимо получить текущую палитру компонента с помощью метода palette(), а затем вы
звать метод setBrush() объекта палитры. Формат метода:
setBrush([<Cocтoяниe>, ]<Составная часть окна>, <КИсть QBrush>)
Первые два параметра аналогичны таковым у метода setcolor() (см. разд. 19.9). В третьем
параметре указывается кисть - объект класса QBrush из модуля QtGui. Форматы конструк
тора класса:
QBrush(<Cтиль кисти>)
QBrush(<Цвeт>[, <Стиль киcти>=BrushStyle.SolidPattern])
QBrush(<Цвeт>, <Изображение QPixmap>)
QВrush(<Изображение QPixmap>)
QВrush(<Изображение Qimage>)
QВrush(<Градиент QGradient>)
QBrush(<Oбъeкт класса QBrush>)
В качестве _стиля кисти указывается один из элементов перечисления BrushStyle из модуля
QtCore.Qt: NoBrush, SolidPattern, DenselPattern, Dense2Pattern, / DenseЗPattern,
Dense4Pattern, Dense5Pattern, DenseбPattern, Dense7Pattern, CrossPattern И др. С помо
щью этого параметра можно сделать цвет сплошным (solidPattern) или имеющим текстуру
(например, элемент CrossPattern задает текстуру в виде сетки).
Цвет можно задать в виде элемента перечисления GlobalColor из модуля QtCore.Qt (напри
мер, Ыасk, white и т. д.) или объекта класса QColor (�апример, QColor("red"),
QColor("#ff0000"), QColor(255, о, о-, и др.). При этом установка сплошного цвета фона
окна может выглядеть так:
pal = window.palette()
pal.setBrush(QtGui.QPalette.ColorGroup.Normal, QtGui.QPalette.ColorRole.Window,
QtGui.QBrush(QtGui.QColor("#008800"), QtCore.Qt.BrushStyle.SolidPattern))
window.setPalette(pal)
406 Часть 11. Библиотека PyQt б
Третий, четвертый и пятый форматы позволяют указать изображение в ·виде объекта класса
QPiюnap или Qirnage. Конструкторы этих классов принимают путь к файлу с нужным изо
бражением.
Шестой формат создает новую кисть на основе rрадиента, представленного объектом класса
QGradient (см. главу 25), а седьмой- на основе указанной кисти.
После настройки палитры у окна также следует вызвать метод setpalette() (см.разд. 19.9),
передав ему измененный объект палитры. Следует помнить, что компоненты-потомки по
умолчанию имеют прозрачный фон и не перерисовываются автоматически. Чтобы вклю
чить перерисовку, необходимо передать значение True в метод setAutoFillBackground().
Указать фоновое изображение также можно с помощью СSS-атрибутов background и
background-irnage. Воспользовавшись СSS-атрибутом background-repeat, можно задать ре
жим повтора фонового рисунка: repeat (повтор по горизонтали и вертикали), repeat-x
(только по горизонтали), repeat-y (только по вертикали) и no-repeat (не повторяется).
Создадим окно с надписью. Для активного окна установим одно изображение (с помощью
изменения палитры), а для надписи- другое (с помощью СSS-атрибута background-irnage)
(листинг 19.9).
frorn PyQtб irnport QtCore, QtGui, QtWidgets
irnport sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("Изoбpaжeниe в качестве фона")
window.resize(З00, 100)
pal = window.palette()
pal.setBrush(QtGui.QPalette.ColorGroup.Norrnal, QtGui.QPalette.ColorRole.Window,
QtGui.QBrush(QtGui.QPixrnap("backgroundl.jpg")))
window.setPalette(pal)
label = QtWidgets.QLabel("Teкcт надписи")
label.setAlignrnent(QtCore.Qt.AlignrnentFlag.AlignCenter)
label.setStyleSheet("background-irnage: url(background2.jpg);")
label.setAutoFillBackground(True)
vbox = QtWidgets.QVBoxLayout()
vbox.addWidget(label)
window.setLayout(vbox)
window.show()
sys.exit(app.exec())
19.11. Окна произвольной формы
Чтобы создать окно произвольной формы, нужно выполнить следующие шаги:
1. Создать изображение нужной формы с прозрачным фоном и сохранить его, например,
в формате PNG.
2. Создать объект класса QPixrnap, передав конструктору класса путь к файлу с ранее соз
данным изображением.
Глава 19. Окна 407
3. Установить изображение в качестве фона окна с помощью палитры (см.разд. 19.1О).
Если для создания окна используется класс надписи QLabel, то установить изображение
в качестве фона можно вызовом метода setPixmap(<Изображение QPixmap>) надписи.
4. Создать на основе изображения битовую маску с помощью метода mask() класса
QPixmap.
5. Применить полученную маску к окну, вызвав у него метод setMask(<Маска>).
6. Убрать рамку у окна, например, передав комбинацию следующих элементов перечисле
ния WindowТype:
QtCore.Qt.WindowТype.Window I QtCore.Qt.WindowТype.FramelessWindowHint
Для примера создадим круглое окно с кнопкой, закрывающей его. Для использования в ка
честве маски создадим РNG-изображение в виде белого круга с прозрачным фоном. Окно
выведем без заголовка и границ (листинг 19.10).
from PyQtб import QtCore, QtGui, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()·
window.setWindowFlags(QtCore.Qt.WindowТype.Window
QtCore.Qt.WindowТype.FramelessWindowHint)
window.setWindowТitle("Coздaниe окна произвольной формы")
window.resize(300, 300)
pixmap = QtGui.QPixmap("mask.png")
pal = window.palette()
pal.setBrush(QtGui.QPalette.ColorGroup .Normal, QtGui.QPalette.ColorRole.Window,
QtGui.QBrush(pixmap))
pal.setBrush(QtGui.QPalette.ColorGroup.Inactive,
QtGui.QPalette.ColorRole.Window, QtGui.QBrush(pixmap))
window.setPalette(pal)
window.setMask(pixmap.mask())
button = QtWidgets.QPushВutton("Зaкpыть окно", window)
button.setFixedSize(lS0, 30)
button.move(75, 135)
button.clicked.connect(QtWidgets.QApplication.instance().quit)
window.show()
sys.exit(app.exec())
Получившееся окно можно увидеть на рис. 19.1.
Рис. 19.1. Окно круглой формы
408 Часть 11. Библиотека PyQt 6
19.12. Всплывающие и расширенные подсказки
Всплывающая подсказка содержит справочную информацюо о каком-либо компоненте
и выводится на экран при наведении курсора мыши на этот компонент.
Расширенная подсказка по компоненту выводится после нажатия кнопки вывода справки
в заголовке диалогового окна и щеЮiка мышью на этом компоненте, также можно сделать
компонент активным нажатием комбинации клавиш <Shift>+<Fl>.
Для создания всплывающих подсказок и управления ими служат следующие методы класса
QWidget:
♦ setToolTip(<Teкcт>) - задает текст всплывающей подсказки. В качестве параметра
можно указать простой текст или НТМL-код. Чтобы отключить вывод подсказки, доста
точно передать в этот метод пустую строку;
♦ toolTip() - возвращает текст всплывающей подсказки;
♦ setтoolTipDuration(<Bpeмя>) - задает время, в течение которого всплывающая под
сказка будет присутствовать на экране, в миллисекундах. Если задать значение -1, PyQt
будет сама вычислять необходимое время, основываясь на длине текста подсказки (по
ведение по умолчанюо );
♦ toolTipDuration() - возвращает время, в течение которого всплывающая подсказка
будет присутствовать на экране;
♦ setWhatsThis(<Текст>) - задает текст расширенной подсказки. В качестве параметра
можно указать простой текст или НТМL-код. Чтобы отключить вывод подсказки, доста
точно передать в этот метод пустую строку;
♦ whatsThis() - возвращает текст расширенной подсказки.
Создадим окно с кнопкой и зададим для них текст всплывающих и расширенных подсказок
(листинг 19.11 ).
from PyQtб import QtCore, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget(flags=QtCore.Qt.WindoWТype.Dialog
QtCore.Qt.WindoWТype.WindowContextHelpButtonHint)
window.setWindoWТitle("Bcплывaк:щиe и расширенные подсказки")
window.resize(З00, 70)
button = QtWidgets. QPushButton("Закрьгrь окно", window)
button.setFixedSize(l50, 30)
button.move(75, 20)
button.setToolTip("Этo всnлывакхцая подсказка для кнопки")
button.setToolTipDuration(З000)
window.setToolTip("Это всплывакхцая подсказка для окна")
button.setToolTipDuration(5000)
button.setWhatsThis("Этo расширенная подсказка для кнопки")
window.setWhatsThis("Этo расширенная подсказка для окна")
button.clicked.connect(QtWidgets.QApplication.instance().quit)
window.show()
sys.exit(app.exec())
Глава 19. Окна 409
19.13. Программное закрытие окна
Чтобы закрыть окно, у него следует вызвать метод close(), Он возвращает значение True,
если окно успешно закрыто, и False - в противном случае. Закрыть сразу все окна про
граммы позволяет сJют closeAllWindows() объекта программы.
Если у окна элемент WA_DeleteOnClose перечисления WidgetAttribute �з модуля QtCore.Qt
установлен в значение True, после закрытия окна его объект будет автоматически удален,
в противном случае окно просто скроется. Установить или сбросить элемент можно с по
мощью метода setAttribute() окна, например:
window.setAttribute(QtCore.Qt.WidgetAttribute.WA_DeleteOnClose, True)
После вызова метода close() или нажатия кнопки закрытия в заголовке окна возникает со
бытие QEvent.Close. Если внутри класса определить метод closeEvent(), это событие мож
но перехватить и обработать. В качестве параметра метод принимает объект класса
QCloseEvent, который поддерживает методы accept() (позволяет закрыть окно) и ignore()
(запрещает закрытие окна). Вызывая эти методы, можно контролировать процесс закрытия
окна.
В качестве примера закроем окно по нажатии кнопки (листинг 19.12).
from PyQtб import QtCore, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget(flags=QtCore.Qt.WindowТype.Dialog)
window.setWindowТitle("Пpoгpaммнoe закрытие окна ")
window.resize(З00, 70)
button = QtWidgets.QPushButton("Закрьгrь окно", window)
button.setFixedSize(lS0, 30)
button.move(75, 20)
button.clicked.connect(window.close)
window.show()
sys.exit(app.exec() )
ВНИМАНИЕ!
После закрытия последнего окна программы выполнение программы завершится.
19.14. Использование таблиц стилей CSS
для оформления окон
Задавать оформление у компонентов можно также с помощью таблиц стилей CSS. Это по
зволяет сделать метод setStyleSheet (<Таблица стилей>), упоминавшийся в разд. 19.9, ко
торый можно вызвать:
♦ у самой программы - тогда заданные в таблице стилей параметры оформления будут
применены ко всем компонентам всех окон программы;
♦ у отдельного окна - тогда эти паР, метры будут действовать в пределах этого окна;
♦ у отдельного компонента - тогда они будут действовать только на этот компонент.
410 Часть 11. Библиотека PyQt б
При указании таблицы стилей у программы и окна можно использовать привычный формат
объявления СSS-стилей:
<Селектор> {<Определение стилей>}
<Селектор> записывается в следующем формате:
<Основной селектор>[<Дополнительный селектор>] [<Псевдокласс>] [<Псевдоселектор>]
Параметр <Основной селектор> указывает на класс компонента. Его можно задать в одном
из следующих форматов:
♦ * (звездочка) - указывает на все компонентъ1. Например, так можно задать у всех ком
понентов зеленый цвет текста:
* {color: green;}
♦ <Класс> - указывает на компоненты, относящиеся к заданному <Классу> и его подклас
сам. Задание красного цвета текста у всех компонентов, относящихся к классу
QAЬstractButton и его подклассам (т. е. у командных кнопок, флажков и перекточате
лей), осуществляется так:
QAЬstractButton {color: red;}
♦ .<Класс> - указывает только на компоненты, относящиеся лишь к заданному <Классу>,
но не к его подклассам. Указание полужирного шрифта у всех компонентов класса
QPushвutton (командных кнопок), но не у его подклассов, осуществляется так:
.QPushВutton {font-weight: bold;}
Параметр <Дополнительный селектор> задает дополнительные параметры компонента. Его
форматы:
♦ [ <Свойство>="<Значение>"] - указанное <Свойство> компонента должно иметь заданное
<Значение>. Полужирный шрифт у кнопки, чье свойство default имеет значение true
(кнопки по умолчанию), задается так:
Qi?ushВutton[default="true"] {font-weight: bold;}
♦ #<Имя> - указывает на компонент с заданным <Именем>. <Имя> можно задать вызовом
у компонента метода setObjectName (<Имя>) , а' получить вызовом метода
objectName (). Красный цвет текста у кнопки с именем ЬtnRed задается так:
QPushВutton#ЬtnRed {color: red;}
Параметр <Псевдокласс> указывает на отдельную составную часть сложного компонента.
Он записывается в формате : : <Обозначение составной части>. Вот пример указания графи
ческого изображения у кнопки разворачивания раскрывающегося списка (обозначение этой
составной части - down-a�row):
QComЬoBox::down-arrow {image: url(arrow.png);}
Параметр <Псевдоселектор> указывает на состояние компонента (должна ли быть кнопка
нажата, должен ли флажок быть установленным и т. п.). Он может быть записан в двух
форматах:
♦ :<Обозначение состояния> - компонент должен находиться в указанном состоянии.
Пример указания белого цвета фона у кнопки, когда она нажата (это состояние имеет
обозначение pressed):
QPushВutton:pressed {background-color: white;}
Глава 19. Окна 411
♦ : ! <Обозначение состояния> - компонент должен находиться в тобом состоянии, кроме
указанного. Пример указания желтого цвета фона у кнопки, когда она не нажата:
QPushВutton: !pressed {background-color: yellow;}
Можно указать сразу несколько псевдоселекторов, расположив их непосредственно друг
за другом - тогда селектор будет указывать на компонент, находящийся одновременно
во всех состояниях, которые обозначены этими селекторами. Вот пример указания чер
ного цвета фона и белого цвета текста у кнопки, которая нажата и над которой находит
ся курсор мыши (обозначение - hover):
QPushButton:pressed:hover {color: white; background-color: Ыасk;}
Если нужно указать стиль компонента, вложенного в другой компонент, применяется сле
дующий формат указания селектора:
<Селектор «внешнего» компонента><Разделитель><Селектор вложенного компонента>
Поддерживаются два варианта параметра <Разделитель>:
♦ пробел - <Вложенный компонент> не обязательно должен быть вложен непосредственно
во <«Внешний»> . Так мы указываем зеленый цвет фона у всех надписей (QLabel), вложен
ных в грУr:rпу (QGroupBox), и вложенные в нее компоненты:
QGroupBox QLabel {background-color: green;}
♦ > - <Вложенный компонент> обязательно должен быть вложен непосредственно во
<«Внешний»>. Так мы укажем синий цвет текста у всех надписей, непосредственно вло
женных в группу:
QGroupBox>QLaЬel {color: Ыuе;}
В стиле можно указать сразу несколько селекторов, записав их через запятую, - тогда
стиль будет применен к компонентам, на которые указывают эти селекторы. Вот пример
задания зеленого цвета фона у кнопок и надписей:
QLabel, QPushButton {background-color: green;}
В PyQt компоненты не наследуют параметры оформления от их родителе:ц. Скажем, если
мы укажем у группы красный цвет текста:
app.setStyleSheet("QGroupBox {color: red;}")
вложенные в эту группу компоненты не унаследуют его и будут иметь цвет текста, задан
ный по умолчанmо. Придется задать для них нужный цвет явно:
app.setStyleSheet("QGroupBox, QGroupBox * {color: red;}")
Есть возможность указать компонентам-потомкам наследовать параметры офррмления
у родителя. Для этого достаточно вызвать у объекта программы статический метод
setAttribute(), передав ему в качестве первого параметра элемент
М_UseStyleSheetPropagationinWidge_tStyles перечисления ApplicationAttribute из модуля
QtCore.Qt, а в качестве второго параметра - значение True:
QtWidgets.QApplication.setAttribute(
QtCore.Qt.ApplicationAttribute.M_UseStyleSheetPropagationinWidgetStyles,
True)
Чтобы откточить такую возможность, достаточно вызвать этот метод еще раз, указав в нем
вторым параметром False.
412 Часть 11. Библиотека PyQt б
При вызове метода setStyleSheet() у компонента в назначаемой ему таблице стилей не
указываются ни селектор, ни фигурные скобки - они просто не нужны.
В случае PyQt, как и в CSS, также действуют правила каскадности. Так, таблица стилей,
заданная у окна, имеет больший приоритет, нежели таковая, указанная у программы, а
стиль, что был задан у компонента, имеет наивысший приоритет. Более специфические сти
ли имеют больший приоритет, чем менее специфические, - так, стиль с селектором, в со
став которого входит имя компонента, перекроет стиль с селектором любого другого типа.
За более подробным описанием поддерживаемых PyQt псевдоклассов, - псевдоселекторов и
особенностей указания стилей для отдельных классов компонентов обращайтесь по-интер-
нет-адресу https://doc.qt.io/qt-6/stylesheet-reference.html.
В листинге 19.13 показан пример задания таблиц стилей у компонентов разными способа
ми. Результат выполнения приведенного кода можно увидеть на рис. 19.2.
Jlистинr 19.13. Ис
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
# На уровне программы задаем синий цвет текста у надписей, вложенных в группы,
# и курсивное начертание текста кнопок
app.setStyleSheet(
"QGroupBox QLabel {color: Ыuе;} QPushВutton {font-style: italic}")
window = QtWidgets.QWidget()
window.setWindowТitle("Taблицы стилей")
# На уровне окна задаем зеленый цвет текста у надписи с именем first и
# красный цвет текста у надписи, на которую наведен курсор МЬШIИ
window.setStyleSheet("QLabel#first {color: green;} QLabel:hover {color: red;}")
window.resize(200, 150)
# Создаем три надписи
lЫl = QtWidgets.QLaЬel("Зeлeный текст")
# Даем первой надписи имя first
lЫl.setObjectName("first")
1Ы2 = QtWidgets.QLabel("Пoлyжиpный текст")
# У второй надписи указываем полужирный шрифт
lЫ2.setStyleSheet("font-weight: bold")
lЫЗ = QtWidgets.QLabel("Cиний текст")
# Создаем кнопку
btn = QtWidgets.QPushВutton("Курсивный текст")
# Создаем группу
Ьох = QtWidgets.QGroupBox ("Группа")
# Создаем контейнер, помещаем в него третью надпись и вставляем в группу
ЬЬох = QtWidgets.QVBoxLayout()
bbox.addWidget(lЫЗ)
box.setLayout(bbox)
# Создаем еще один контейнер, помещаем в него две первые надписи, группу,
# кнопку и вставляем в окно
mainЬox = QtWidgets.QVВoxLayout()
mainЬox.addWidget(lЬll)
Глава 19. Окна 413
rnainЬox.addWidget(lЫ2)
rnainЬox.addWidget(box)
rnainЬox.addWidget(btn)
window.setLayout(rnainЬox)
window.show()
sys.exit(app.exec())
� Табл... □ х
Зеленый текст
Полужирный текст
Группа
Синий текст
Рис. 19.2. Пример использования таблиц стилей
ГЛАВА 20
Обработка сигналов и событий
Событие� это 'уведомление о том, что в программе что-либо произошло: пользователь
щелкнул мышью, нажал клавишу на клавиатуре, нажал кнопку и др. Обработка собы
тия - это реагирование на него заданным образом (например, запуск действия, закреплен-
ного за нажатой кнопкой).
Обработка событий разных типов в PyQt выполняется двумя способами:
♦ низкоуровневые события (нажатие кнопки мыши, клавиши, перемещение мыши и т. п.)
посредством обработчиков событий, которые представляют собой особые специальные
методы, определенные в классе, в котором могут возникать события (окне или каком
либо компоненте);
♦ высокоуровневые события (например, нажатие экранной кнопки) - приводят к генери
рованию в классе, в котором возникло событие, соответствующего сигншю (представле
ния события внутри PyQt) и вызову назначенных ему обработчиков сигнала. Обработ
чики сигншюв реализуются в виде слотов - особым образом помеченных методов клас
са, в которых возникают события, или функций.
Класс, в котором возникло событие, называется источником события, а класс, в котором
бьш сгенерирован соответствующий событию сигнал, - источником сигнШiа. Класс, в ко
тором выполняется обработка события или сигнала, носит название приемника соответст
венно события и сигнШlа.
20.1. Назначение обработчиков сигналов
Каждый сигнал, реализованный в классе, представляется в виде особого объекта и хранится
в одноименном атрибуте этого класса (не обычном атрибуте!). Так, сигнал clicked(), гене
рируемый при щелчке мышью, соответствует атрибуту clicked.
Чтобы назначить сигналу обработчик, следует использовать метод connect() компонента.
Форматы вызова этого метода таковы:
<Сигнал>.соnnесt(<Обработчик>[,
<Тип coeдинeния>=ConnectionType.AutoConnection][, no receiver_check=False])
<Сигнал>[<Тип>] .соnnесt(<Обработчик>[,
<Тип coeдинeния>=ConnectionType.AutoConnection][, no_receiver_check=False])
Глава 20. Обработка сигналов и событий 415
В качестве обработчика можно указать:
♦ ссылку на пользовательскую функцию;
♦ ссьmку на метод класса;
♦ ссьmку на объект класса, в котором определен метод_call_() ;
♦ анонимную функцmо;
♦ ссьmку на слот класса.
Остальные два параметра будут описаны позже.
Вот пример назначения функции on_clicked_button() в качестве обработчика сигнала
clicked кнопки button:
button.clicked.connect(on_clicked_button)
Сигналы могут принимать произвольное число параметров, каждый из которых может от
носиться к любому типу данных. При этом бывает и так, что в классе существуют два сиг
нала с одинаковыми наименованиями, но разными наборами параметров. Тогда следует
дополнительно в квадратных скобках указать <Тип> данных, принимаемых сигналом, в виде -
либо ссьmки на его класс, либо в виде строкового имени. Например, оба следующих выра
жения назначают обработчик сигнала, принимающего один параметр логического типа:
button.clicked[bool] .connect(on_clicked_button)
button.clicked["bool"] .connect(on_clicked_button)
Одному и тому же сигналу можно назначить произвольное количество обработчиков. Это
иллюстрирует код из листинга 20.1, -где сигналу clicked кнопки назначены сразу четыре
обработчика.
from PyQtб import QtWidgets
import sys
def on_clicfed():
рrint("КНопка нажата. Функция on_clicked()")
class MyClass():
def init (self, х=О):
self.x = х
def call (self) :
рrint("КНопка нажата. Метод MyClass. call ()")
print("x =", self.x)
def on_clicked(self):
print("кнопка нажата. Метод MyClass.on_clicked()")
obj = MyClass ()
арр = QtWidgets.QApplication(sys.argv)
button = QtWidgets.QPushВutton("Н= меня")
# Назначаем обработчиком функцию
button.clicked.connect(on_clickep)
# Назначаем обработчиком метод класса
button.clicked.connect-(obj .on_clicked)
416 Часть 11. Библиотека PyQt б
# Назначаем обработчиком сСЫ11ку на объект класса
button.clicked.connect(MyClass(lO))
# Назначаем обработчиком анонимную функцию
button.clicked.connect(lamЬda: MyClass(5)())
button.show()
sys.exit(app.exec())
В четвертом обработчике мы использовали анонимную функцию. В ней мы сначала создаем
объект класса MyClass, передав ему в качестве параметра число 5, после чего сразу же вы
зываем его как функцию, указав после конструктора пустые скобки:
.button.clicked.connect(lamЬda: MyClass(5)())
Результат выполнения в окне консоли при щелчке на кнопке:
кнопка нажата. Функция on_clicked()
кнопка нажата. Метод MyClass.on_clicked()
'
кнопка нажата. Метод MyClass._call_()
х = 10
кнопка нажата. Метод MyClass. call ()
х = 5
Тип соединения в вызове метода connect() следует указывать при' использовании несколь
ких потоков. Можно указать один из следующих элементов перечисления connectionType
из модуля QtCore.Qt:
♦ AutoConnection - если источник сигнала и обработчик находятся в одном потоке, то он
эквивалентен элементу DirectConnection, а если в разных потоках, то - QueuedConnection;
♦ Directcoiшection - обработчик вызывается сразу после генерирования сигнала и вы
полняется в потоке его источника;
♦ QueuedConnection - сигнал помещается в очередь обработки событий, а его обработчик
выполняется в потоке приемника сигнала;
♦ BlockingQueuedConnection - аналогичен элементу QueuedConnection за тем искточени
ем, что поток блокируется на время обработки сигнала. Обратите внимание, что источ
ник и обработчик сигнала обязательно должны выполняться в разных потоках;
♦ UniqueConnection - обработчик можно назначить только один раз. Этот элемент с по
мощью оператора I может быть объединен с любым из представленных. Примеры:
# Эти два обработчика будут успешно назначены и вьmолнены
button.clicked.connect(on_clicked)
button.clicked.connect(on_clicked)
# А эти два обработчика назначены не будут
button.clicked.connect(on_clicked, QtCore.Qt.AutoConnection 1 \
QtCore.Qt.UniqueConnection)
button.clicked.connect(on_clicked, QtCore.Qt.AutoConnection 1 \
QtCore.Qt.UniqueConnection)
# Тем не менее эти два обработчика будут назначены, поскольку они разные
button.clicked.connect(on_clicked, QtCore.Qt.AutoConnection 1 \
QtCore.Qt.UniqueConnection)
button.clicked.connect(obj.on_clicked, QtCore.Qt.AutoConnection 1 \
QtCore.Qt.UniqueConnection)
Глава 20. Обработка сигналов и событий 417
♦ SingleShotConnection - обработчик выполнится всего один раз, после чего его назна
чение сигналу будет автоматически отменено. Этот элемент с помощью оператора I мо
жет быть объединен с любым из представленных. Пример:
# Назначенный обработчик будет выполнен лишь единожды
button .clicked.connect(on_once_clicked, QtCore.Qt.AutoConnection 1 \
QtCore.Qt.SingleShotConnection)
Если параметру no_receiver_check дано значение False, то в случае, если приемник сигнала
уже не существует, возникнет ошибка. Если же параметру дано значение тrue, то в таком
случае ошибка.не возникнет.
20.1.1. Слоты
Классы PyQt уже содержат ряд слотов, которые могут быть использованы в качестве обра
ботчиков сигналов. Например, класс QApplication поддерживает слот quit(), завершающий
программу. В листинге 19.2 показан пример его использования.
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
button = QtWidgets.QPushButton("Зaвepuмть работу")
button.clicked .connect(app.quit)
button.show()
sys.exit(app.exec())
Любой пользовательский метод можно сделать слотом, для чего необходимо перед его оп
ределением вставить декоратор @pyqtSlot(). Формат декоратора:
@QtCore.pyqtSlot([<Tип 1>, <Тип 2>, . . ., <Тип N>] [, name=None] [, result=None])
Можно указать типы параметров, принимаемых слотом (bool, int и др.). При задании типа
данных С++ его имя необходимо указать в виде строки. Если слот не принимает парамет
ров, типы не указьшаются. В параметре name можно передать имя слота в виде строки. Если
этот параметр не задан, в качестве имени слота будет использовано имя метода. Параметр
result задает тип результата, возвращаемого слотом. Если слот не возвращает результата,
этот параметр не задается.
Можно создать несколько одноименных слотов, принимающих разные параметры (пере
груженный слот). Пример приведен в листинге 20.3.
from PyQtб import QtCore, QtWidgets
import sys
class MyClass(QtCore.QObject):
def init (self):
QtCore.QObject. init (self)
418 Часть 11. Библиотека PyQt б
@QtCore.pyqtSlot()
def on_clicked(self):
print("КНопка нажата. Слот on_clicked()")
@QtCore.pyqtSlot(bool, name="myslot")
def on_clicked2(self, status):
рrint("КНопка нажата. Слот myslot(bool)", status)
obj = MyClass()
арр = QtWidgets.QApplication(sys.argv)
button = QtWidgets.QPushБutton("Haжми меня")
button.clicked.connect(obj.on_clicked)
button.clicked.connect(obj.myslot)
button.show()
sys.exit(app.exec())
Превращать метод, используемый в качестве обработчика сигнала, в слот необязательно.
Однако вызов слота выполняется быстрее вызова обычного метода.
20.1.2. Передача данных в обработчик сигнала
Передать какие-либо произвольные данные в обработчик можно следующими способами:
♦ создать анонимную функцию и внутри ее выполнить вызов обработчика с параметрами.
Вот пример передачи обработчику числа 10:
self.buttonl.clicked.connect(lamЬda : self.on_clicked_buttonl(l0))
Если передаваемое обработчику значение вычисляется в процессе выполнения кода,
переменную, хранящую это значение, следует указывать в анонимной функции как зна
чение по умолчанию, иначе функции будет передана ссьшка на это значение, а не оно
само:
у = 10
self.buttonl.clicked.connect(lamЬda х=у: self.on_clicked_buttonl(x))
♦ передать ссьшку на объект класса, внутри которого определен метод _call_() . Пере
даваемое значение указывается в качестве параметра конструктора этого класса. При
мер:
class MyClass():
def init (self, х=О):
self.x = х
def call (self):
print("x =", self.x)
self.buttonl.clicked.connect(MyClass(l0))
♦ передать ссылку на обработчик и данные в функцmо paitial() из модуля functools.
Формат функции:
partial(<Функция> [, *<Позиционные параметры>] [, **<Именованные параметры>])
Пример передачи параметра в обработчик:
from functools import partial
self.buttonl.clicked.connect(partial(self.on_clicked buttonl, 10))
Глава 20. Обработка сигналов и событий 419
Значения, передаваемые в составе сигнала, будут переданы в обработчик после осталь
НЪIХ параметров . Назначим обработчик сигнала clicked, принимающего логический
параметр, и дополнительно передадим число:
self.buttonl.clicked.connect(partial(self.on_clicked buttonl, 10))
Обработчик будет иметь следующий вид:
def on_clicked_buttonl(self, х, status):
print("Haжaтa кнопка buttonl", х, status)
Результат выполнения:
Нажата кнопка buttonl 10 False
20.2. Блокировка и удаление
обработчиков сигналов
Для блокировки и удаления обработчиков предназначены следующие методы компонентов:
♦ ЫockSignals(<Состояние>) - временно блокирует прием сигналов, если параметр име
ет значение тrue, и сним�ет блокировку, если параметр имеет значение False. Метод
возвращает предыдущее состояние;
♦ signalsВlocked () - возвращает значение True, если блокировка сигналов установлена,
и False - в противном случае;
♦ disconnect() - удаляет заданный обработчик. Форматы метода:
<Сигнал>.disсоnnесt([<Обработчик>])
<Сигнал>[<Тип>] .disсоnnесt([<Обработчик>])
Если обработчик не указан, удаляются все обработчики. Параметр <Тип> указывается
лишь в том случае, если существуют сигналы с одинаковыми именами, но принимаю
щие разные параметры . Примеры:
button.clicked.disconnect()
button.clicked[bool] .disconnect(on_clicked_button)
button.clicked ["bool"]..disconnect(on_clicked_button)
Создадим окно с четырьмя кнопками (листинг 19.4). У кнопки Нажми меня назначим об
работчик сигнала clicked. Чтобы информировать о нажатии кнопки, выведем сообщение
в консоль. У кнопок Блокировать, Разблокировать и Удалить обработчик создадим
обработчики, которые будут изменять состояние обработчика у кнопки Нажми меня.
from PyQtб import QtCore, QtWidgets
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.setWindoWТitle("Блoкиpoвкa и удаление обработчика")
self.reize(З00, 150)
self.buttonl = QtWidgets.QPushButton("Нажми меня")
420 Часть 1/. Библиотека PyQt 6
self.button2 = QtWidgets.QPushВutton("Блoкиpoвaть")
self.buttonЗ = QtWidgets.QPushButton("Paзблoкиpoвaть")
self.button4 = QtWidgets.QPushButton("Yдaлить обработчик")
self.buttonЗ.setEnaЬled(False)
vbox = QtWidgets.QVВoxLayout()
vbox.addWidget(self.buttonl)
vbox.addWidget(self.button2)
vbox.addWidget(self.buttonЗ)
vbox.addWidget(self.button4)
self.setLayout(vbox)
self.buttonl.clicked.connect(self.on_clicked buttonl)
self.button2.clicked.connect(self.on_clicked_button2)
self.button3.clicked.connect(self.on_clicked_button3)
self.button4.clicked.connect(self.on_clicked_button4)
@QtCore.pyqtSlot()
def on_clicked_buttonl(self):
print("Нажата кнопка buttonl")
@QtCore.pyqtSlot()
def on_clicked_button2(self):
self.buttonl.ЫockSignals(True)
self.button2.setEnaЬled(False)
self.buttonЗ.setEnaЫed(True)
@QtCore.pyqtSlot()
def on_clicked_buttonЗ(self):
self.buttonl.ЫockSignals(False)
self.button2.setEnaЫed(True)
self.buttonЗ.setEnaЫed(False)
@QtCore.pyqtSlot()
def on_clicked_button4(self):
self.buttonl.clicked.disconnect(self.on_clicked buttonl)
self.button2.setEnaЫed(False)
self.buttonЗ.setEnaЫed(False)
self.button4.setEnaЫed(False)
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
Если нажать кнопку Нажми меня, в консоли будет выведена строка Нажата кнопка buttonl.
Нажатие кнопки Блокировать производит блокировку обработчика - теперь при нажатии
кнопки Нажми меня никаких сообщений в консоли не выводится., Отменить блокировку
можно с помощью кнопки Разблокировать. Нажатие кнопки Удалить обработчик произ
водит полное удаление обработчика - в этом случае, чтобы обрабатывать нажатие кнопки
Нажми меня, необходимо заново назначить обработчик.
Также можно временно сделать компонент недоступным, воспользовавшись следующими
методами:
Глава 20. Обработка сигналов и событий 421
♦ sе tЕnаЫеd (<Состояние>) - если в параметре указано значение False, компонент станет
недоступным. Чтобы сделать компонент опять доступным, следует передать значение
True;
♦ se tDisaЫed (<Cocтoяниe>) - если в параметре указано значение тrue, компонент станет
недоступным. Чтобы сделать компонент опять доступным, следует передать значение
False.
Проверить, доступен компонент или нет, позволяет метод isEnaЫed (). Он возвращает зна
чение тrue, если компонент доступен, и False - в противном случае.
20.3. Генерирование сигналов
Сгенерировать сигнал программно позволяет метод emit(). Форматы этого метода:
<Сигнал>.emit( [<Данные>] )
<Сигнал> [<Тип>] . emit([<Данные>] )
Метод emit() всегда вызывается у объекта, которому посьmается сигнал, например:
button.clicked.emit()
Сигналу и соответственно его обработчику можно передать данные, указав их в вызове
метода emit()
button.clicked[bool].emit(False )
button.clicked["bool"] .emit(False )
Некоторые компоненты предоставляют методы, которые генерируют сигналы. Например,
у кнопок существует метод click(). Используя его, инструкцmо:
button.clicked.emit()
можно записать следующим образом:
button.click()
20.4. Пользовательские сигналы
Также можно создавать свои собственные, пользовательские сигналы. Для этого следует
определить в классе какой-либо атрибут класса (не обычный!) и присвоить ему результат,
возвращенный функцией pyqtSignal() из модуля QtCore. Формат функции:
pyqtSignal( [<Тип 1>, <Тип 2>, . . . , <Тип N>] [, пame=N one ])
Можно указать типы значений, передаваемых сигналу (например: bool или iпt):
mysignall = QtCore.pyqtSignal-(int)
mysignal2 = QtCore.pyqtSignal(int, str)
При использовании типа данных С++ его имя необходимо указать в виде строки:
mysignalЗ = QtCore.pyqtSignal("QDate")
Если сигнал не принимает параметров, типы не указьmаются.
Параметр name задает имя создаваемого сигнала. Если он не указан, имя сигнала совпадет с
именем атрибута класса, в котором он хранится. Пример:
mysignal4 = QtCore.pyqtSignal(int, name="mySignal")
422 Часть 11. Библиотека PyQt б
Можно создать несколько одноименных сигналов, принимающих разные параметры (пере
груженный сигнш�). В этом случае типы передаваемых значений указьmаются внутри квад
ратных скобок. Вот пример сигнала, передающего данные типа int или str:
mysignal5 = QtCore.pyqtSignal( [int], [str])
Создадим окно с двумя кнопками (листинг 19.5), которым назначим обработчики сигнала
clicked (нажатие кнопки). Внутри обработчика щелчка на первой кнопке сгенерируем два
сигнала: первый будет имитировать нажатие второй кнопки, а второй станет пользователь
ским, привязанным к окну. Внутри обработчиков выведем сообщения в консоли.
from PyQtб import QtCore, QtWidgets
class MyWindow(QtWidgets.QWidget):
mysignal = QtCore.pyqtSignal(int, int)
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.setWindowТitle("Пoльзoвaтeльcкий сигнал")
self.resize(З00, 100)
self.buttonl = QtWidgets.QPushButton("Haжми меня")
self.button2 = QtWidgets.QPushВutton("КНoпкa 2")
vbox = QtWidgets.QVВoxLayout()
vbox.addWidget(self.buttonl)
vbox.addWidget(self.button2)
self.setLayout(vbox)
self.buttonl.clicked.connect(self.on_clicked_buttonl)
self.buttoп2.clicked.connect(self.on_clicked_button2)
self.mysignal.connect(self.on_mysignal)
def on_clicked_buttonl(self):
print("Нажата кнопка buttonl")
# Генерируем сигналы
self.button2.clicked[bool] .emit(False)
self.mysignal.emit(l0, 20)
def on_clicked_button2(self):
print("Нажата кнопка button2")
def on_mysignal(self, х, у):
рrint("Обработан пользовательский сигнал mysignal()")
print("х =", х, "у =", у)
if _name...'.!:.: :;,- "�main_
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
Результат выполнения после нажатия первой кнопки:
Нажата кнопка buttonl
Нажата кнопка button2
Глава 20. Обработка сигналов и событий 423
Обработан пользовательский сигнал mysignal()
х = 10 у = 20
Вместо конкретного типа принимаемого сигналом параметра можно указать тип QVariant
из модуля QtCore. В этом случае сигналу допускается передавать значение любого типа.
Пример:
mysignal = QtCore.pyqtSignal(QtCore.QVariant)
self.mysignal.emit(20)
self.mysignal.emit("Пpивeт!")
self.mysignal.emit([l, "2"])
20.5. Использование таймеров
Таймеры позволяют через задашп,1й интервал времени выполнять специальный метод
timerEvent (). Для назначения таймера используется метод startTimer() компонента. Фор
мат метода:
startTimer(<Интepвaл>[, timerType=TimerType.CoarseTimer])
Интервал времени задается в митшсекундах. Минимальное значение интервала зависит от
операционной системы. Если указать значение О, таймер будет срабатывать регулярно при
отсутствии других необработашп,�х событий.
Необязательный параметр timerтype задает тип таймера в виде одного из элементов пере
числения TimerType из модуля QtCore.Qt:
♦ PreciseTimer - точный таймер, обеспечивающий точность до МИJDIИСекунд;
♦ CoarseTimer - «приблизительный» таймер, обеспечивающий точность в пределах 5% от
заданного интервала;
♦ VeryCoarseTimer - «приблизительный» таймер, обеспечивающий точность до секунд.
Метод startTimer() возвращает идентификатор таймера, с помощью которого впоследст
вии можно остановить таймер.
Формат специального метода timerEvent():
timerEvent(self, <Объект класса QТimerEvent>)
Внутри этого метода можно получить идентификатор таймера, вызвав метод timerid()
у объекта класса QTimerEvent, который передается методу timerEvent() со вторым парамет
ром.
Чтобы остановить таймер с указанным идентификатором, необходимо воспользоваться
методом killTimer(<Идентификатор>) компонента.
Создадим в окне часы, которые будут отображать текущее системное время с точностью до
секунды, и добавим возможность запуска и остановки этих часов с помощью соответст
вующих кнопок (листинг 20.6).
1 Листинг 20.6. Часы, вариант ;1
from PyQtб import QtCore, QtWidgets
import time
424 Часть 11. Библиотека PyQt б
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.setWindowТitle("Чacы ")
self.resize(200, 100)
self.timer id = О
self.label = QtWidgets.QLabel("")
self.laЬel.setAlignment(QtCore.Qt.AlignmentFlag.AlignНCenter)
self.buttonl = QtWidgets.QPushButton("Зaпycтить")
self.button2 = QtWidgets.QPushButton("Ocтaнoвить")
self.button2.setEnaЫed(False)
vbox = QtWidgets.QVВoxLayout()
vbox.addWidget(self.label)
vbox.addWidget(self.buttonl)
vbox.addWidget(self.button2)
self.setLayout(vbox)
self.buttonl.clicked.connect(self.on_clicked_buttonl)
self.button2.clicked.connect(self.on_clicked_button2)
def on_clicked_buttonl(self):
# Задаем интервал в 1 секунду и «приблизительный» таймер
self.timer_id = self.startTimer(l000,
timerType=QtCore.Qt.TimerType.VeryCoarseTimer)
self.buttonl.setEnaЫed(False)
self.button2.setEnaЬled(True)
def on_clicked_button2(self):
if self.timer id:
self. killTimer (
. self.timer_id)
self.timer id = О
self.buttonl.setEnaЬled(True)
self.button2.setEnaЬled(False)
def timerEvent(self, event):
self.label.setText(time.strftime ("%И: %М: %S"))
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow( )
window.show()
sys.exit(app.exec())
Вместо методов startTimer() и killTimer() класса QObject можно воспользоваться классом
QТimer из модуля QtCore. Конструктор класса имеет следующий формат:
QТimer( [parent=None])
Методы этого класса:
♦ setinterval(<Ин�ервал>) - задает интервал времени· в миллисекундах, по истечении
которого генерируется сигнал timeout. Минимальное значение интервала зависит от
операционной системы. Если указать значение О, таймер будет срабатывать регулярно
при отсутствии других необработанных сигналов;
Глава 20. Обработка сигналов и событий 425
♦ start( [ <Интервал> J ) - запускает таймер. В параметре можно указать интервал времени
в миллисекундах. Если параметр не указан, используется значение, заданное в вызове
метода setinterval();
♦ stop() - останавливает таймер;
♦ isActive() - возвращает значение тrue, если таймер запущен, и False - в противном
случае;
♦ timerid() - возвращает идентификатор таймера, если он запущен, и значение -1 -
в противном случае;
♦ remainingTime() - возвращает ·время, оставшееся до очередного срабатывания таймера,
в миллисекундах;
♦ int�rval() - возвращает установленный интервал;
♦ setSingleShot(<Состояние>) - если в параметре указано значение True, таймер сработа
ет только один раз, в противном случае - будет срабатывать многократно;
♦ isSingleShot() - возвращает значение True, если таймер сработает только один раз, и
False - в противном случае;
♦ setTimerType(<Тип таймера>) - задает тип таймера, который указывается в том же виде,
что и в вызове метода startTimer();
♦ timerType() - возвращает тип таймера.
Переделаем предыдущий пример, использовав класс QTimer (листинг 20.7).
from PyQtб import QtCore, QtWidgets
import time
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.setWindoWТitle("Чacы")
self.resize(200, 100)
self.label = QtWidgets.QLabel("")
self.label.setAlignment(QtCore.Qt.AlignmentFlag.AlignHCenter)
self.buttonl = QtWidgets.QPushВutton("Зaпycтить")
self.button2 = QtWidgets.QPushВutton("Ocтaнoвить")
self.button2.setEnaЫed(False)
vbox = QtWidgets.QVВoxLayout()
vbox.addWidget(self.label)
vbox.addWidget(self.buttonl)
vbox.addWidget(self.button2)
self.setLayout(vbox)
self.buttonl.clicked.connect(self.on_clicked buttonl)
self.button2.clicked.connect(self.on_clicked_button2)
self.timer = QtCore.QTimer()
self.timer.timeout.connect(self.on_timeout);
def on_clicked_buttonl(self):
self.timer.start(l000) # 1 секунда
426 Часть 11. Библиотека PyQt б
self.buttonl.setEnaЫed(False)
self.button2.setEnaЫed(True)
def on_clicked_button2(self):
self.timer.stop()
self.buttonl.setEnaЫed(True)
self.button2.setEnaЫed(False)
def on_timeout(self):
self.laЬel.setText(time.strftime("%H:%M:%S"))
if -name- main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
Статический метод singleShot() класса QТimer запускает таймер, настраивает его для одно
кратного срабатывания и указьIВает функцию или метод, который будет вызван по истече
нии заданного интервала. Формат метода:
singleShot(<Интepвaл>[, <ТИп таймера>], <Функция или метод>)
/
Примеры:
QtCore.QTimer.singleShot(lOOO, self.on_timeout)
QtCore.QTimer.singleShot(lOOO, QtWidgets.QApplication.instance() .quit)
20.6. Обработка всех событий
Обработка событий отличается от обработки сигналов. Чтобы обработать событие, необхо
димо создать подкласс какого-либо компонента и переопределить в нем соответствующий
специальный метод (например, чтобы обработать нажатие клавиши, следует переопреде
лить метод keyPressEvent()). Специальные методы принимают объект, содержащий
детальную информацию о событии (обозначение нажатой кнопки мыши, код нажатой кла
виши и т. п.).
Классы событий являются производными от класса QEvent и наследуют от него следующие
методы:
♦ accept() - устанавливает флаг, разрешающий дальнейшую обработку события. Ска
жем, если в методе closeEvent() у объекта события вызвать метод accept(), окно будет
закрыто. Этот флаг обычно установлен по умолчанию;
♦ ignore() - сбрасЬIВает флаг, разрешающий дальнейшую обработку события. Так, если
в методе closeEvent()у объекта события вызвать метод ignore(), окно закрыто не будет;
♦ setAccepted(<Флаг>) - если в качестве параметра указано значение True, флаг, разре
шающий дальнейшую обработку события, будет установлен (аналогично вызову метода
accept()); а если False - сброшен (аналогично вызову мет_ода ignore());
♦ isAcceptect() - возвращает текущее состояние флага, разрешающего дальнейшую об
работку события;
♦ spontaneous() - возвращает тrue, если событие сгенерировано операционной системой,
и False - если самой программой;
Глава 20. Обработка сигналов и событий 427
♦ type () - возвращает тип события в виде одного из следующих элементов перечисления
Туре из класса QEvent (приведены основные типы событий, полный их список содержит
ся на странице https://doc.qt.io/qt-6/qevent.html#Type-enum):
• None_ - нет.события;
• MouseButtonPress - нажата кнопка мыши;
• MouseButtonRelease - отпущена кнопка мыши;
• MouseButtonDЫClick- двойной щелчок мышью;
• MouseMove - перемещение мыши;
• Wheel - прокручено колесико мыши;
• Enter - курсор мыши помещен на компонент;
• Leave- курсор мыши уведен с компонента;
• DragEnter - курсор мыши помещен на компонент при операции перетаскивания;
• DragMove- производится операция перетаскивания;
• DragLeave- курсор мыши уведен с компонента при операции перетаскивания;
• Drop - операция перетаскивания завершена;
• KeyPress - нажата клавиша;
• KeyRelease - отпушена клавиша;
• Show - компонент отображен;
• Hide - компонент скрыт;
• Focusin- компонент получил фокус ввода;
• FocusOut- компонент потерял фокус ввода;
• Paint- компонент требует перерисовки;
• моvе - местоположение компонента изменилось;
• Resize- размеры компонента изменились;
• PolishRequest - компонент должен быть настроен;
• Polish - компонент настроен;
• ShoWТoParent- дочерний компонент отображен;
• HideToParent - дочерний компонент скрыт;
• ChildAdded- дочерний компонент добавлен;
.,
• ChildPolished- производится настройка дочернего компонента;
• ChildRernoved - дочерний компонент удален;
• Close - окно закрыто;
• _WindowActivate - окно стало активным;
• WindowDeactivate - окно стало неактивным;
• ActivationChange - изменилось состояние активности окна верхнего уровня;
• WindowBlocked - окно блокировано модальным окном;
• Windowunыocked - окно разблокировано после закрытия модального окна;
428 Часть //. Библиотека PyQt 6
• WindowStateChange - состояние окна изменилось;
• ApplicationStateChange- текущее состояние программы изменилось;
• ContextMenu - событие контекстного меюо;
• Clipboard - содержимое буфера обмена изменилось;
• Timer - событие таймера;
• 1000- user- пользовательское событие;
• 65535 - мaxuser- максимальный идентификатор пользовательского события.
Статический метод registerEventType( [ <Идентификатор> J ) класса QEvent позволяет зареги
стрировать пользовательский тип события с указанным идентификатором. В качестве по
следнего можно указать значение в пределах от QEvent.User (1000) до QEvent.мaxUser
(65535). Если заданный идентификатор занят, выбирается ближайший свободный. В качест
ве результата возвращается идентификатор зарегистрированного события.
Перехват всех событий осуществляется с помощью специального метода event(self,
<event>). Через параметр <event> доступен объект события. Этот объект различен у разных
типов событий (например, у события MouseButtonPress он относится к классу QMouseEvent, а
у события KeyPress- к классу QKeyEvent). Эти классы будут рассмотрены позже.
Из метода event() следует вернуть в качестве результата значение тrue, если событие было
обработано, и False- в противном случае. Если
_ возвращается значение True, то. родитель
ский компонент не получит событие. Чтобы продолжить распространение события на роди
теля, необходимо вызвать метод event() . базового класса и передать ему текущий объект
события. Обычно это делается так:
return QtWidgets.QWidget.event(self, е)
В этом случае пользовательский класс является наследником класса QWidget и переопреде
ляет метод event(). Если вы наследуете другой класс, следует вызывать метод именно этого
класса. Например, при наследовании класса QLabel инструкция будет выглядеть так:
return QtWidgets.QLabel.event(self, е)
Пример обработки нажатий клавиш, щелчков мышью и закрытия окна показан в листин
ге 20.8.
from PyQt6 import QtCore, QtWidgets
·c1ass MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.resize(300, 100)
def event(self, е):
if e.type() �= QtCore.QEvent.Type.KeyPress:
print("Нажата клавиша на клавиатуре")
print("Koд:", e.key(), ", текст:", e.text())
elif e.type() == QtCore.QEvent.Type.Close:
print("Oкнo закрЫ'l'о")
Глава 20. ·Обработка сигналов и событий 429
elif e.type() == QtCore.QEvent.Type.MouseButtonPress:
р = e.pos()
print("Щелчок мьnпью. Координаты:", р.х(), р.у())
return QtWidgets.QWidget.event(self, е) # Отправляем дальше
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow ()
window.show()
sys.exit(app.exec())
Перехватывать все события следует только в самом крайнем случае. В обычных ситуациях
надо обрабатывать только нужные события.
20. 7. События окна
20.7.1. Изменение состояния окна
Отследить изменение состояния окна ( сворачивание, разворачивание, скрытие и отображе
ние) позволяют следующие методь1:
♦ changeEvent(self, <event>) - вызывается при изменении состояния окна, компонента
или программы, заголовка окна, его палитры, состояния активности окна верхнего уров
ня, языка, локали и др. (полный список смотрите в документации). При обработке собы
тия типа Type.WindowStateChange через параметр <event> доступен объект класса
QWindowStateChangeEvent. Этот класс поддерживает только метод oldState(), с помо
щью которого можно получить предыдущее состояние окна;
♦ showEvent(self, <event>) - вызьmается при отображении компонента. Через параметр
<event> доступен объект класса QShowEvent;
♦ hideEvent(self, <event>) - вызывается при скрытии компонента. Через параметр
<event> доступен объект класса QHideEvent.
Для примера выведем в консоль текущее состояние окна при его сворачивании, разворачи
вании, скрытии и отображении (листинг 20.9).
from PyQtб import QtCore, QtWidgets
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.resize(З00, 100)
def changeEvent(self, е):
if e.type() = QtCore.QEvent.Type.WindowStateChange:
if self.isMinimized():
print("Oкнo свернуто")
elif self.isMaximized():
print("Окно раскрыто до максимаJJЬНЫХ размеров")
430 Часть 11. Библиотека PyQt б
elif self.isFullScreen():
print("Полноэкранный режим")
elif self.isActiveWindow():
print("Oкнo находится в фокусе ввода")
QtWidgets.QWidget.changeEvent(self, е) # Отправляем дальше
def showEvent(self, е):
print("Oкнo отображено")
QtWidgets.QWidget.showEvent(self, е) # Отправляем дальше
def hideEvent(self, е):
print("Oкнo скрыто")
QtWidgets.QWidget.hideEvent(self, е) # Отправляем дальше
if narne = " main "·
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
20. 7 .2. Изменение местоположения и размеров окна
При перемещении и изменении размеров окна вызываются следующие специальные методы:
♦ moveEvent(self, <event>) - непрерывно вызывается при перемещении окна. Через па
рамеtр <event> доступен объект класса QMoveEvent. Получить координаты левого верх
него угла окна позволяют следующие методы этого класса:
• pos() - возвращает объект класса QPoint с текущими координатами;
• oldPos() - возвращает объект класса QPoint с предыдущими координатами;
♦ re.sizeEvent(self, <event>) - непрерывно вызывается при изменении размеров окна.
Через параметр <event> доступен объект класса QResizeEvent. Получить размеры окна
позволяют следующие методы этого класса:
• size() - возвращает объект класса QSize с текущими размерами;
• oldSize() - возвращает объект класса QSize с предыдущими размерами.
Пример обработки изменения местоположения и размеров окна показан в листинге 20.10.
from PyQtб import QtWidgets
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget._init_(self, parent)
self.resize(З00, 100)
def moveEvent(self, е):
print("x = {О}; у= {l}".format(e.pos().x(), e.pos().y()))
QtWidgets.QWidget.moveEvent(self, е) # Отправляем дальше
def resizeEvent(self, е):
print("w = {О}; h = {l}".format(e.size().width(), e.size().height()))
QtWidgets.QWidget.resizeEvent(self, е) # Отправляем дальше
Глава 20. Обработка сигналов и событий 431
if name rnain "·
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec() )
20.7.3. Перерисовка окна или его части
Когда компонент (или часть компонента) становится видимым, требуется выпошппь его
перерисовку. В этом случае вызывается специальный метод paintEvent(self, <event>).
Через параметр <event>· доступен объект класса QPaintEvent, который поддерживает сле
дующие методы:
♦ rect() - возвращает объект класса QRect с координатами и размерами прямоугольной
области, которую требуется перерисовать;
♦ region() - возвращает объект класса QRegion с регионом, требующим перерисовки.
С помощью этих методов можно получить координаты области, которая, например, бьmа
ранее перекрыта другим окном и теперь вновь оказалась в зоне видимости. Перерисовывая
только область, а не весь компонент, можно заметно повысить быстродействие программы.
Следует также заметить, что в целях эффективности несколько событий перерисовки могут
быть объединены в одно событие с общей областью перерисовки.
В некоторых случаях перерисовку окна необходимо выполнить вне зависимости от внеш
них действий системы или пользователя (например, при изменении каких-либо значений
требуется обновить нарисованный на их основе график). Вызвать событие перерисовки
компонента позволяют следующие методы класса QWidget:
♦ repaint() - немедленно вызывает метод paintEvent() для перерисовки компонента при
условии, что таковой не скрыт и обновление не бьmо запрещено вызовом метода
setUpdatesEnaЫed(). Форматы метода:
repaint()
repaint(<X>, <У>, <Ширина>, <Высота>)
rераint(<Прямоугольная область QRect>)
rераint(<Область QRegion>)
Первый формат вызова выполняет перерисовку всего компонента, а остальные - только
области с указанными координатами;
♦ update() - генерирует событие перерисовки при условии, что компоне:нт не скрыт и
обновление не запрещено. Событие будет обработано на следующей итерации цикла
обработки событий. Если• генерируется сразу несколько событий, они объединяются
в одно, чтобы избежать неприятного мерцания. Рекоме:ндуется использовать этот метод
вместо метода repaint(). Форматы вызова такие же, как и у метода repaint().
20.7.4. Предотвращение закрытия окна
При закрытии окна нажатием кнопки закрытия в его заголовке или вызовом метода close ()
вызывается специальный метод closeEvent(self, <event>). Через параметр <event> досту
пен объект класса QCloseEvent. Чтобы предотвратить закрытие окна, у объекта события
следует вызвать метод ignore(), в противном случае - метод accept().
432 Часть 11. Библиотека PyQt 6
В качестве примера по нажатии кнопки закрытия выведем стандартное диалоговое окно
с запросом подтверждения закрытия окна (листинг 20.11). Если пользователь нажмет кноп
ку Да, закроем окно, а если щелкнет кнопку Нет или просто закроет диалоговое окно, не
будем его закрывать.
from PyQtб import QtWidgets
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.resize(З00, 100)
def closeEvent(self, е):
result = QtWidgets.QMessageBox.question(self,
"Подтверждение закрытия окна",
"Вы действительно хотите закрыть окно?")
if result == QtWidgets.QМessageBox.StandardButton.Yes:
e.accept ()
QtWidgets.QWidget.closeEvent(self, е)
else:
e.ignore()
if name main " ·
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
20.8. События клавиатуры
20.8.1. Управление фокусом ввода
Для управления фокусом ввода прецназначены следующие методы класса QWidget:
♦ setFocus( [<Причина>] ) - устанавливает фокус ввода, если компонент находится в ак
тивном окне. В качестве причины изменения фокуса ввода можно указать один из сле
дующих элементов перечисления FocusReason из модуля QtCore.Qt:
• MouseFocusReason - фокус изменен с помощью мыши; •
• TabFocusReason - нажата клавиша <ТаЬ>;
• BacktabFocusReason - нажата комбинация клавиш <Shift>+<Тab>;
• ActiveWindowFocusReason - окно стало активным или неактивным;
• PopupFocusReason - открыто или закрыто всплывающее окно;
• ShortcutFocusReason - нажата комбинация клавиш быстрого доступа;
• MenuВarFocusReason - фокус ввода переместился на меню;
• OtherFocusReason - другая причина;
Глава 20. Обработка сигналов и событий 433
♦ clearFocus() - убирает фокус ввода с текущего компонента;
♦ hasFocus() - возвращает значение True, если компонент имеет фокус ввода, и False -
в противном случае;
♦ focusWidget() - возвращает ссылку на последний дочерний компонент, у которого вы
зывался метод setFocus(). Для компонентов верхнего уровня возвращается ссылка на
компонент; который получит фокус после того, как окно станет активным;
♦ setFocusProxy(<Компонент>) - указывает компонент, который будет получать фокус
ввода вместо текущего компонента;
♦ focusProxy() - возвращает ссьmку на компонент, который получает фокус ввода вме
сто текущего компонента. Если такого компонента нет, возвращает значение None;
♦ focusNextChild() - передает фокус ввода следующему компоненту (аналогично нажа
тию кл�виши <ТаЬ>). Возвращает значение тrue, если фокус ввода удалось передать,
и False - в противном случае;
♦ focusPreviousChild() - передает фокус ввода предыдущему компоненту (аналогично
нажатию комбинации клавиш <Shift>+<Tab>). Возвращает значение True, если фокус
ввода удалось передать, и False - в противном случае;
♦ focusNextPrevChild(<Направление>) - -если в параметре указано значение True, работа
ет аналогично методу focusNextChild (), если указано False - аналогично методу
focusPreviousChild();
♦ setTabOrder(<Компонент 1>, <Компонент 2>) - статический метод, задает последова
тельность смены фокуса при нажатии клавиши <ТаЬ>. В параметре <Компонент 2> ука
зьmается ссылка на компонент, на который переместится фокус с компонента <Компонент 1>.
Вот пример указания цепочки перехода widgetl -> widget2 -> widgetЗ -> widget4:
QtWidgets.QWidget.setTabOrder(widgetl, widget2)
QtWidgets.QWidget.setTabOrder(widget2, widgetЗ)
QtWidgets.QWidget.setTabOrder(widgetЗ, widget4)
♦ setFocusPolicy(<Cпocoб>) - задает способ получения фокуса текущим компонентом
в виде одного из следующих элементов перечисления FocusPolicy из модуля QtCore . Qt:
• NoFocus - компонент не может получать фокус;
• TabFocus - с помощью клавиши <ТаЬ>;
• ClickFocus - посредством щелчка мышью;
• StrongFocus - с помощью клавиши <ТаЬ> и щелчка мышью;
• WheelFocus - с· помощью клавиши <ТаЬ>, щелчка мышью и колесика мыши;
♦ focusPolicy() - возвращает текущий способ получения фокуса;
♦ graЬKeyboard() - захватывает ввод с клавиатуры. Другие компоненты не будут полу-
чать события клавиатуры, пока не будет вызван метод releaseKeyboard();
♦ releaseKeyboard() - освобождает захваченный ранее ввод с клавиатуры.
Получить ссылку на компонент, находящийся в фокусе ввода, позволяет статический метод
focusWidget() класса QApplication. Если ни один компонент не имеет фокуса ввода, метод
возвращает значение None. Не путайте этот метод с одноименным методом из класса
QWidget.
434 Часть 11. Библиотека PyQt 6
Обработать получение и потерю фокуса ввода позволяют следующие специальные методы
класса QWidget:
♦ focusinEvent(self, <event>) - вызывается при получении фокуса ввода;
♦ focusOutEvent(self, <event>) - вызывается при потере фокуса ввода.
Через параметр <event> доступен объект класса QFocusEvent, который поддерживает сле
дующие методы:
♦ gotFocus() - возвращает значение True, если фокус ввода был получен, и False - если
был потерян;
♦ lostFocus() - возвращает значение True, если фокус ввода был потерян, и False -
если был получен;
♦ reason() � возвращает причину установки фокуса. Значение аналогично значению па-
раметра <Причина> в методе setFocus().
Создадим окно с кнопкой и двумя полями ввода (листинг 20.12). У полей ввода обработаем
получение и потерю фокуса ввода, а по нажатии кнопки установим фокус ввода на второе
поле. Кроме того, зададим последовательность перехода при нажатии клавиши <ТаЬ>.
frorn PyQtб import QtWidgets
class MyLineEdit(QtWidgets.QLineEdit):
def init (self, id, parent=None):
QtWidgets.QLineEdit. init (self, parent)
self.id = id
def focusinEvent(self, е):
рrint("Получен фокус полем", self.id)
QtWidgets.QLineEdit.focusinEvent(self, е)
def focusOutEvent(self, е):
рrint("Потерян фокус полем", self.id)
QtWidgets.QLineEdit.focusOutEvent(self, е)
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.resize(З00, 100)
self.button = QtWidgets.QPushButton("Ycтaнoвить фокус на поле 2")
self.linel = MyLineEdit(l)
self.line2 = MyLineEdit(2)
self.vbox = QtWidgets.QVВoxLayout()
. self.vbox.addWidget(self.button)
self.vbox.addWidget(self.linel)
self.vbox.addWidget(self.line2)
self.setLayout(self.vbox)
self.button.clicked.connect(self.on_clicked)
# Задаем порядок обхода с помощью клавиши <ТаЬ>
QtWidgets.QWidget.setTabOrder(self.linel, self.line2)
QtWidgets.QWidget.setTaЬOrder(self.line2, self.button)
Глава 20. Обработка сигналов и событий 435
def on_clicked(self):
self.line2.setFocus()
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
20.8.2. Назначение клавиш быстрого доступа
Клавиша быстрого доступа (или горячая клавиша) - это какая-либо из алфавитно
цифровых клавиш, нажатие которой совместно с клавишей-модификатором (обычно <Alt>)
устанавливает фокус ввода на связанный с ней компонент. Если связанным компонентом
является кнопка (или пункт меmо), она будет нажата.
У компонента, имеющего текстовую надпись (например, кнопки), указать клавишу быстро
го доступа можно, поставив в тексте надписи перед буквой, соответствующей указываемой
клавише, символ &. Чтобы вставить в надпись сам символ &, его следует продублировать.
Если компонент не имеет собственной текстовой надписи, придется создать надпись к нему
и связать ее с компонентом с помощью метода setBuddy(<Компонент>) объекта надписи.
Если же создать отдельную надпись у компонента не представляется возможным, можно
воспользоваться следующими методами класса QWidget:
♦ grabShortcut (<Клавиша> [, <Контекст>] ) - регистрирует заданную клавишу быстрого
доступа и возвращает ид�нтификатор, с помощью которого можно управлять ею в даль
нейшем. 'Клавиша указывается в виде объекта класса QKeySequence из модуля QtGui.
Конструктор этого класса поддерживает следующие форматы вызова:
QKeySequence(<Cтpoкa с обозначениями клавиш>)
QKeySequence(<Чиcлoвoe обозначение клавиши>)
В первом формате в передаваемой строке обозначения клавиш указываются последова
тельно и отделяются друг от друга символами +. Во втором формате обозначение кла
виши указывается в виде значения одного из элементов перечисления Кеу из модуля
QtCore.Qt или комбинации значений через оператор +.
Также можно воспользоваться статическим методом mnemonic(<Обозначение клавиши>)
класса QKeySequence, где обозначение клавиши указывается в виде строки и предваряет
ся символом &.
Примеры создания объекта класса QKeySequence для комбинации клавиш <Alt>+<E>:
QtGui.QKeySequence.mnemonic("&e")
QtGui.QKeySequence("Alt+e")
QtGui.QKeySequence(QtCore.Qt.Key.Key_FS)
В качестве контекста можно указать следующие элементы перечисления
ShortcutContext ИЗ модуля QtCore.Qt:
• WidgetShortcut - клавиша быстрого доступа работает, когда родитель компонента
имеет фокус ввода;
• WidgetWithChildrenShortcut - клавиша быстрого доступа работает, когда его роди
тель компонента или любой из его потомков имеет фокус ввода;
436 Часть 11. Библиотека PyQt б
• WiridowShortcut - клавиша быстрого доступа работает, когда окно, содержащее ком
понент, активно (значение по умолчаюпо); ,,
• ApplicationShortcut - клавиша быстрого доступа работает, когда программа активна;
♦ releaseShortcut (<Идентификатор>) - удаляет комбинацию с указанным идентификато
ром;
♦ setShortcutEnaЫed(<Идентификатор> [, <Состояние>] ) - если в качестве состояния ука
зано True (значение по умолчаюпо), клавиша быстрого доступа с заданным идентифика
тором разрешена. Состояние False запрещает использование клавиши быстрого доступа.
При нажатии клавиши быстрого доступа генерируется событие типа Туре.Shortcut, которое
можно обработать в методе event(self, <event>). Через параметр <event> дqступен объект
класса QShortcutEvent, поддерживающий следующие методы:
♦ shortcut Id() - возвращает идентификатор комбинации клавиш;
♦ isAmЬiguous() - возвращает значение True, если нажатая клавиша быстрого доступа
была указана сразу у нескольких компонентов, и False - в противном случае;
♦ key() - возвращает объект класса QKeySequence, представляющий нажатую клавишу
быстрого доступа.
Создадим окно с надписью, двумя полями ввода и кнопкой (листинг 20.13). У первого поля
ввода назначим клавишу быстрого доступа <Alt>+<B> через надпись, а у второго поля -
клавишу <Alt>+<E> с помощью метода grabShortcut(). У кнопки назначим клавишу быст
рого доступа <Alt>+<Y> через надпись на кнопке.
. J1истинr 20.13, н'
from PyQtб import QtCore, QtGui, QtWidgets
class MyLineEdit(QtWidgets.QLineEdit):
def init (self, parent=None):
QtWidgets.QLineEdit. init (self, parent)
self.id = None
def event(self, е):
if e.type() == QtCore.QEvent.Type.Shortcut:
if self.id == e.shortcutid():
self.setFocus(QtCore.Qt.FocusReason.ShortcutFocusReason)
return True
return QtWidgets.QLineEdit.event(self, е)
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.resize(З00, 100)
self.label = QtWidgets.QLabel( "Устано&вить фокус на поле l")
self.lineEditl = QtWidgets.QLineEdit()
self.label.setBuddy(self.lineEditl)
self.lineEdit2 = MyLineEdit()
self.lineEdit2.id = self.lineEdit2.grabShortcut(
QtGui. QKeySequence .mnemonic("&е") )
Глава 20. Обработка сигналов и событий 437
self.button = QtWidgets.QPushButton("&Yбpaть фокус с поля 1")
self.vbox = QtWidgets.QVВoxLayout()
self.vbox.addWidget(self.label)
self.vbox.addWidget(self.lineEditl)
self.vbox.addWidget(self.lineEdit2)
self.vbox.addWidget(self.button)
self.setLayout(self.vbox)
self.button.clicked.connect(self.on_clicked)
def on_clicked(self):
self.lineEditl.clearFocus()
if name main
import sys
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
Для назначения клавиш быстрого доступа также можно воспользоваться классом QShortcut
из модуля QtGui. В этом случае назначение клавиши у второго текстового поля будет вы
глядеть так:
self.lineEdit2 = QtWidgets.QLineEdit()
self.shc = QtGui.QShortcut(QtGui.QKeySequence.mnemonic("&e"), self)
self.shc.setContext(QtCore.Qt.ShortcutContext.WindowShortcut)
self.shc.�ctivated.connect(self.lineEdit2.setFocus)
Еще можно использовать класс QAction из модуля QtGui. Назначение клавиши у второго
текстового. поля выглядит следующим образом:
self.lineEdit2 = QtWidgets.QLineEdit()
self.act = QtGui.QAction(self)
self.act.setShortcut(QtGui.QKeySequence.mnemonic("&e"))
self.act.triggered.connect(self.lineEdit2.setFocus)
self.addAction(self.act)
20.8.3. Нажатие и отпускание клавиш
При нажатии и отпускании клавиши вызьmаются следующие специальные методы:
♦ keyPressEvent;(self, <event>) - вызывается при нажатии клавиши. Если клавишу
удерживать нажатой, метод будет вызываться многократно, пока клавишу не отпустят;
♦ keyReleaseEvent(self, <event>) - вызывается при отпускании нажатой ранее клавиши.
Через параметр <event> доступен объект класса QKeyEvent, хранящий дополнительную ин
формацию о событии. Он поддерживает следующие полезные для нас методы (полный их
список приведен на странице https://doc.qt.io/qt-6/qkeyevent.html):
♦ key() - возвращает код нажатой клавиши:
if e.key() == QtCore.Qt.Key.Key_B:
print("Нажата клавиша <В>")
438 Часть //. Библиотека PyQt б
♦ text() - возвращает текстовое представление введенного символа в кодировке Unicode
или пустую строку, если была нажата специальная клавиша;
♦ modifiers() - позволяет определить, какие клавиши-модификаторы (<Shift>, <Ctrl>,
<Alt> и др.) были нажаты. Возвращает значение одного из следующих элементов пере
числения KeyboardМodifier из модуля QtCore.Qt или их комбинацmо:
• NoModifier - модификаторы не бьmи нажаты;
• ShiftModifier - бьmа нажата клавиша <Shift>;
• ControlModifier - была нажата клавиша <Ctrl>;
• AltModifier - бьша нажата клавиша <Alt>;
• MetaModifier - была нажата клавиша <Meta>;
• KeypadМodifier - бьша нажата любая клавиша на дополнительной клавиатуре;
• GroupSwitchМodifier - бьmа нажата клавиша <Mode_switch> (только в Xl 1).
Пример определения, была ли нажата клавиша-модификатор <Shift>:
if e.modifiers() & QtCore.Qt.KeyboardМodifier.ShiftModifier:
print("Haжaтa клавиша-модификатор <Shift>")
♦ isAutoRepeat() - возвращает True, если событие было вызвано удержанием клавиши
нажатой, и False - в противном случае;
♦ matches(<Обозначение>) - возвращает значение тrue, если бьmа нажата специальная
комбинация клавиш, соответствующая указанному обозначению, и False - в противном
случае. В качестве параметра указывается один из элементов перечисления standardКey
из класса QKeySequence - например, Сору соответствует комбинации клавиш <Ctrl>+
+<С> (полный список элементов перечисления приведен на странице https://doc.qt.io/
qt-6/qkeysequence.html#StandardKey-enum). Пример:
if e.matches(QtGui.QKeySequence.StandardKey.Copy):
print("Haжaтa комбинация клавиш <Ctrl>+<C>")
При обработке нажатия клавиш следует учитывать, что:
♦ компонент должен иметь возможность принимать фокус ввода. Некоторые компоненты
(в частности, надписи ) по умолчанию не могут принимать фокус ввода. Чтобы изменить
способ получения фокуса, следует воспользоваться методом setFocusPolicy(<Способ>)
(рассмотрен в разд. 20.8. 1);
♦ чтобы захватить эксклюзивный ввод с клавиатуры, следует воспользоваться методом
grabKeyboard(), а чтобы .освободить ввод - методом releaseKeyboard();
♦ можно перехватить нажатие любых клавиш, кроме клавиши <ТаЬ> и комбинации
<Shift>+<Tab>. Эти клавиши используются для передачи фокуса следующему и преды
дущему компоненту соответственно. Перехватить нажатие этих клавиш можно только
в методе event(self, <event>);
♦ если событие обработано, следует вызвать метод accept() объекта события. Чтобы
родительский компонент смог получить событие, вместо метода accept() необходимо
вызвать метод ignore().
Глава 20. Обработка сигналов и событий 439
20.9. События мыши
20.9.1. Нажатие и отпускание кнопок мыши
При нажатии и отпускании кнопок мыши вызываются следующие специальные методы:
♦ mousePressEvent (self, <event>) - вызывается при нажатии кнопки мыши в области
компонента;.
♦ mouseReleaseEvent (self, <event>) - вызывается при отпускании ранее нажатой кнопки
мыши;
♦ mouseDouЫeClickEvent (self, <event>) - вызывается при двойном щелчке мышью.
Следует учитывать, что двойному щелчку предшествуют другие события. Последова
тельность собьпий при двойном щелчке выглядит так:
Mous�ButtonPress
MouseButtonRelease
MouseButtonDЫClick
MouseButtonPress
MouseButtonRelease
Задать интервал двойного щелчка в миллисекундах позволяет статический метод
setDouЬleClickinterval (<Интервал>) класса QApplication, а получить
его текущее зна
чение - статический метод douЬleClickinterval () того же класса.
Через параметр <event> доступен объект класса QMouseEvent, хранящий дополнительную
информацию о событии. Он поддерживает такие методы:
♦ pos () - возвращает объект класса QPoint с целочисленными координатами в пределах
компонента;
♦ position () - возвращает объект класса QPointF с вещественными координатами в пре
делах компонента;
♦ scenePosition () - возвращает объект класса QPointF с вещественными координатами
. в пределах окна или графической сцены (рассмотрена в главе 26);
♦ globalPosition () - возвращает объект класса QPointF с вещественными координатами
в пределах экрана;
♦ button () - возвращает обозначение нажатой кнопки мыши в виде одного из следую
щих элементов перечисления мouseвutton из модуля QtCore. Qt (описаны не все элемен
ты, полный их список приведен на странице https://doc.qt.io/qt-6/qt.html#MouseButton
enum):
• NoButton - ни одна кнопка не нажата. Это значение возвращается методом button ()
при перемещении курсора мыши;
• LeftButton - левая кнопка;
• RightButton - правая кнопка;
• MiddleButton - средняя кнопка или колесико;
• xвuttonl, Extraвuttonl и вackButton - первая из дополнительных кнопок;
• xвutton2, ExtraButton2 и ForwardВutton - вторая из дополнительных кнопок;
♦ buttons () - возвращает обозначение всех нажатых кнопок мыши в виде комбинации
элементов перечисления Mouseвutton:
440 Часть 11. Библиотека PyQt б
if e.buttons() & QtCore .Qt .MouseButton.LeftButton:
print( "Нажата левая кнопка мьШIИ")
♦ modifiers() - позволяет определить, какие клавиши-модификаторы (<Shift>, <Ctrl>,
<Alt> и др.) были нажаты вместе с кнопкой мыши. Описан в разд. 20.8.3;
♦ flags() - возвращает дополнительные сведения о событии в виде значения одног() из
элементов перечисления MouseEveпtFlag из модуля QtCore или их комбинацию. По
состоянию на сегодня перечисление содержит единственный элемент
MouseEventCreatedDouЫeClick, который устанавливается при возникновении события
MouseButtonPress, если оно было вызвано-двойным щелчком;
♦ timestamp() - возвращает в виде числа отметку системного времени, в которое возник-
ло событие.
Если событие было успешно обработано, следует вызвать метод accept() объекта события.
Чтобы родительский компонент мог получить событие, вместо метода accept() нужно вы
звать метод ignore().
Если у компонента элемент WA_NoMousePropagation перечисления WidgetAttribute из моду
ля QtCore.Qt установлен в тrue, событие мыши не будет передаваться родительскому ком
поненту. Значение атрибута можно изменить с помощью метода setAttribute(), вызванно
го у этого компонента:
button.setAttribute(QtCore.Qt.WidgetAttribute.WA_NoMousePropagation, True)
По умолчанию событие мыши перехватывает компонент, над которым был произведен
щелчок м�1шью. Чтобы перехватывать нажатие и отпускание мыши вне компонента, следу�
ет захватить мышь вь,зовом метода grabMouse(). Освободить захваченную ранее мышь по
зволяет метод releaseMouse().
20.9.2. Перемещение курсора мыши
Чтобы обработать перемещение курсора мыши над компонент�м, необходимо определить
специальный метод mouseMoveEvent(self, <event>). Через параметр <event> доступен объ
ект класса QMouseEvent, содержащий дополнительную информацию о событии (описан
в разд. 20.9.1). Следует учитывать, что метод button() при перемещении мыши возвращает
элемент NoButton перечисления QtCore.Qt.MouseButton.
По умолчанию метод mouseMoveEvent() вызывается только в том случае, если при переме
щении удерживается нажатой какая-либо кнопка.мыши. Это сделано специально, чтобы не
создавать лишних событий при обычном перемещении мыши. 'Если необходимо обрабаты
вать любые перемещения мыши в пределах компонента, следует вызвать у этого компонен
та метод setMouseTracking(<Состояние>), которому передать значение True. Чтобы обрабо
тать все перемещения внутри окна, нужно дополнительно захватить мышь вызовом метода
grabMouse().
Метод pos() объекта события возвращает позицию точки в системе координат текущеrо
компонента. Чтобы преобразовать координаты точки в систему координат родительского
компонента или в глобальную систему координат, надо воспользоваться следующими
методами класса QWidget:
♦ mapToGlobal(<Координаты QPoint>) - преобразует заданные координаты точки из сис
темы координат компонента в глобальную систему координат. Возвращает объект клас
са QPoint;
Глава 20. Обработка сигналов и событий 441
♦ mapFromGlobal(<Координаты QPoint>) - преобразует заданные координаты точки из
глобальной в систему координат компонента. Возвращает объект класса QPoint;
♦ mapToParent(<Координаты QPoint>) - преобразует заданные координаты точки из сис
темы координат компонента в систему координат его родителя. Если компонент не име
ет родителя, действует как метод mapToGlobal(). Возвращает объект класса QPoint;
♦ mapFromParent(<Координаты QPoint>) - преобразует заданные координаты точки из
системы координат родительского компонента в систему координат текущего компо
нента. Если компонент не имеет родителя, работает подобно методу mapFromGlobal().
Возвращает объект класса QPoint;
♦ mapTo(<Компонент>, <Координаты QPoint>) - преобразует заданные координаты точки
из системы координат текущего компонента в систему координат родителя указанного
компонента. Возвращает объект класса QPoint;
♦ mapFrom(<Компонент>, <Координаты QPoint>) - преобразует заданные координаты точ
ки из системы координат родителя указанного компонента в систему координат текуще
го компонента. Возвращает объект класса QPoint.
20.9.3. Наведение и увод курсора мыши
Обработать наведение курсора мыши на компонент и увод его с компонента позволяют
следующие специальные методы:
♦ enterEvent(self, <event>) - вызывается при наведении курсора мыши на компонент.
Через параметр <event> доступен объект класса QEnterEvent, не несущий никакой до
полнительной информации;
♦ leaveEvent(self, <event>) - вызывается при уводе курсора мыши с компонента. Через
параметр <event> доступен объект класса QLeaveEvent, не несущий никакой дополни
тельной информации.
20.9.4. Прокрутка колесика мыши
Обработать прокрутку колесика мыши позволяет специальный метод wheelEvent(self,
<event>). Через параметр <event> доступен объект класса QWheelEvent с дополнительной
информацией о событии.
Класс QWheelEvent поддерживает методы:
♦ angleDelta() - возвращает углы поворота колесика по горизонтали и вертикали в гра
дусах, умноженные на 8, в виде объекта класса QPoint. Значения углов могут быть по
ложительными или отрицательными - в зависимости от направления поворота. При
мер:
angle = e.angleDelta() / 8
angleX = angle.x()
angleY = angle.y()
♦ pixelDelta() - возвращает величины поворота колесика по горизонтали и вертикали
в пикселах в виде объекта класса QPoint. Величины поворота могут быть положитещ,
ными или отрицательными - в зависимости от направления поворота.
Также поддерживаются методы position(), scenePosition(), globalPosition(), button(),
buttons(), modifiers() и timestamp (), описанные в разд. 20.9.1.
442 Часть 11. Библиотека PyQt б
Если событие было успешно обработано, необходимо вызвать метод accept() объекта
события. Чтобы родительский компонент мог получить событие, вместо метода accept()
необходимо вызвать метод ignore().
20.9.5. Изменение курсора мыши
Для изменения внешнего вида курсора мыши при вхождении его в область компонента
предназначены следующие методы класса QWidget:
♦ setCursor(<Кypcop>) - задает внешний вид курсора мыши для компонента. В качестве
параметра указывается объект класса QCursor или следующие элементы перечисления
CursorShape из модуля QtCore.Qt: ArrowCursor (стандартная стрелка), UpArrowCursor
(стрелка, направленная вверх), Crosscursor (крестообразный курсор), WaitCursor (пе
сочные часы), IВearncursor (!-образный курсор), SizeVercursor (стрелки, направленные
вверх и вниз), Sizeнorcursor (стрелки, направленные влево и вправо), SizeBDiagCursor
(стрелки, направленные в правый верхний угол и левый нижний угол), SizeFDiagCursor
(стрелки, направленные в левый верхний угол и правый нижний угол), SizeAllCursor
(стрелки, направленные вверх, вниз, влево и вправо), ВlankCursor (невидимый курсор),
SplitVCursor (указатель изменения высоты), SplitHCursor (указатель изменения шири
ны), PointingHandCursor (курсор в виде руки), ForЬiddenCursor (перечеркнутый круг),
OpenHandCursor (разжатая рука), ClosedНandCursor (сжатая рука), WhatsThisCursor
(стрелка с вопросительным знаком), BusyCursor (стрелка с песочными часами),
DragMovecursor (обозначение перемещения путем перетаскивания), DragCopyCursor (обо
значение копирования путем перетаскивания) и DragLinkCursor (обозначение создания
ссьmки путем перетаскивания). Пример:
self.setCursor(QtCore.Qt.CursorShape.WaitCursor)
♦ unsetCursor() - отменяет изменение курсора мыши для компонента. В результате
внешний вид курсора будет наследоваться от родителя;
♦ cursor() - возвращает объект класса QCursor, представляющий текущий курсор.
Управлять видом курсора сразу на уровне программы можно с помощью следующих стати
ческих методов класса QApplication:
♦ setOVerrideCursor(<Курсор>) - задает курсор мыши. В качестве параметра указывается
объект класса QCursor или один из ранее описанных элементов перечисления
CursorShape ИЗ модуля QtCore.Qt;
♦ restoreOverrideCursor() - отменяет изменение курсора мыши:
QtWidgets.QApplication.setOVerrideCursor(QtCore.Qt.CursorShape.WaitCursor)
# Вьmолняем мительную операцию
QtWidgets.QApplication.restoreOVerrideCursor()
♦ changeOVerrideCursor(<Курсор>) - изменяет курсор мыши. Если до вызова этого мето
да не вызывался метод setOVerrideCursor(), ничего не произойдет. В качестве парамет
ра указывается объект класса QCursor или один из ранее описанных элементов перечис
ления CursorShape из модуля QtCore.Qt;
♦ overrideCursor() - возвращает объект класса QCursor, представляющий текущий кур
сор, или значение None, если таковой не бьш изменен.
Изменять курсор мыши на уровне программы следует на небольшой промежуток време
ни - обычно при выполнения какой-либо операции, в процессе которой программа не мо-
Глава 20. Обработка сигналов и событий 443
жет нормально реагировать на действия пользователя. Обычно курсор изменяют на песоч
ные часы (элемент WaitCursor) или стрелку с песочными часами (элемент BusyCursor).
Метод setOverrideCursor() может быть вызван несколько раз. В этом случае курсоры по
мещаются в стек. Каждый вызов метода restoreOverrideCursor() удаляет последний кур
сор, добавленный в стек. Для нормальной работы программы необходимо вызывать методы
setOverrideCursor() и restoreOverrideCursor() одинаковое количество раз.
Класс QCursor позволяет использовать в качестве курсора изображение тобой формы. Что
бы загрузить изображение, следует передать конструктору класса QPixmap путь к файлу изо
бражения. Для создания объекта курсора необходимо передать конструктору класса QCursor
в первом параметре объект класса QPixmap, а во втором и третьем параметрах - координа
ты «горячей» точки будущего курсора. Вот пример создания и установки пользовательского
курсора:
self.setCursor(QtGui.QCursor(QtGui.QPixmap("cursor.png"), О, О))
Класс QCursor поддерживает два статических метода:
♦ pos() - возвращает объект класса QPoint с координатами курсора мыши относительно
экрана:
р = QtGui.QCursor.pos()
print(p.x(), р.у())
♦ setPos() - задает координаты курсора мыши. Форматы вызова:
setPos(<X>, <У>)
sеtРоs(<Координаты QPoint>)
20.10. Операция перетаскивания (drag & drop)
Операция перетаскивания состоит из двух частей: запуск процесса и обработка перетаски
вания и сброса данных. Обе части могут обрабатьшаться как одной, так и разными про
граммами.
20.10.1. Запуск перетаскивания
Запуск перетаскивания осуществляется следующим образом:
1. Внутри специального метода mousePressEvent () запоминаются координаты курсора
мыши в момент нажатия ее левой кнопки.
2. Внутри специального метода mouseMoveEvent() вычисляется пройденное расстояние или
измеряется продолжительность операции. Это необходимо для того, чтобы предотвра
тить случайное перетаскивание. Управлять задержкой позволяют следующие статиче
ские методы класса QApplication:
• setStartDragDistance (<Расстояние>) - задает минимальное расстояние, после про
хождения которого будет запушена операция перетаскивания, в пикселах (по умол
чанmо 10);
• startDragDistance() - возвращает зто расстояние;
• setStartDragTime(<Время>) - задает время задержки в миллисекундах перед запус
ком операции перетаскивания;
• startDragTirne() - возвращает зто время.
444 Часть 11. Библиотека PyQt б
3. Если пройдено минимальное расстояние или истек минимальный промежуток времени,
создается объект класса QDrag из модуля QtGui и у него вызывается метод ехес(), кото
рый после завершения операции возвращает действие, выполненное с данными (напри
мер, их копирование или перемещение).
Конструктор класса QDrag вызывается так:
QDrаg(<Компонент-источник, из которого перетаскиваются данные>)
Класс QDrag поддерживает следующие методы:
♦ ехес() - запускает процесс перетаскивания и возвращает действие, которое бьшо вы
полнено по завершении операции. Метод имеет два формата:
ехес( [ <Допустимые действия>=DrорАсtiоn.MoveAction] )
ехес(<Допустимые действия>, <Действие по умолчанию>)
Допустимые действия над перетаскиваемыми данными задаются следующими элемен
тами перечисления DropAction из модуля QtCore.Qt или их комбинацией через оператор
1: CopyAction (копирование перетаскиваемых данных), MoveAction (перемещение),
LinkAction (создание ссылки), IgnoreAction (действие игнорировано), TargetMoveAction
(сохранить перетаскиваемые данные в компоненте-источнике). Действие по умолчанию,
выполняемое, если ни одна из клавиш-модификаторов не была нажата, задается в виде
одного из приведенных ранее элементов перечисления DropAction. Пример:
drag = QtGui.QDrag(self)
act = drag.exec(QtCore.Qt.DropAction.MoveAction
QtCore.Qt.DropAction.CopyAction,
QtCore.Qt.DropAction.MoveAction)
♦ setMimeData(<Данные>) - задает сами перемещаемые данные в виде объекта класса
QMimeData (описан в разд. 20.1 О. 2). Пример ·задания текста:
data = QtCore.QMimeData()
dаtа.sеtТехt("Перетаскиваемый текст")
drag = QtGui.QDrag(self)
drag.setMimeData(data)
♦ mimeData() - возвращает объект класса QMimeData с перемещаемыми данными;
♦ setpixmap(<Изображение QPixmap>) - задает изображение, которое будет перемещаться
вместе с курсором мыши:
drag.setPixmap (QtGui .QPixmap("dd_representer.png"))
♦ pixmap() - возвращает объект класса QPixmap с изображением, которое перемещается
вместе с курсором;
♦ setHotSpot(<Координаты QPoint>) - задает координаты «горячей» точки на перемещае
мом изображении:
drag.setHotSpot(QtCore.QPoint(20, 20))
♦ hotSpot () - возвращает объект класса QPoint с координатами «горячей» точки на пере
мещаемом изображении;
♦ setDragCursor(<Изoбpaжeниe QPixmap>, <Действие>) - задает курсор мыши для указан
ного действия. Первым параметром передается изображение, которое, собственно, ста
нет курсором мыши. Если в первом параметре указан пустой объект класса QPixmap,
Глава 20. Обработка сигналов и событий 445
ранее установленный для действия курсор будет отменен. Действие задается в виде
одного из приведенных ранее элементов перечисления DropAction. Пример изменения
курсора мыши для перемещения:
drag.setDragCursor(QtGui.QPixmap("move_cursor.png"),
QtCore.Qt.DropAction.MoveAction)
♦ dragcursor (<Действие>) -возвращает объект класса QPixmap, представляющий курсор
мыши для заданного действия;
♦ source() - возвращает ссылку на компонент-источник;
♦ target() - возвращает ссьmку на компонент-приемник или значение None, ·если компо
нент находится в другой программе;
♦ supportedActions() - возвращает значение, представляющее набор допустимых в те
кущей операции действий, в виде комбинации перечисленных ранее элементов перечис
ления DropAction;
♦ defaultAction() - возвращает действие по умолчанию в виде одного из приведенных
ранее элементов перечисления DropAction.
Класс QDrag поддерживает два сигнала:
♦ actionChanged(<Действие>) - генерируется при изменении действия. Новое действие
представляется одним из приведенных ранее элементов перечисления DropAction;
♦ targetChanged (<Компонент-приемник>) - генерируется при изменении компонента-прием-
ника.
Примеры назначения обработчиков этих сигналов:
drag.actionChanged.connect(self.on_action_changed)
drag.targetChanged.connect(self.on_target_changed)
20.10.1.1. Задание перетаскиваемых данных
Перетаскиваемые данные, передаваемые методу setMimeData() класса QDrag, задаются
объектом класса QMimeData из модуля QtCore. Его конструктор вызывается так:
QMimeData()
Класс QMimeData поддерживает следующие полезные для нас методы (полный их список
приведен на странице https://doc.qt.io/qt-6/qmimedata.html):
♦ setText(<Текст>) -заносит текстовые данные (МIМЕ-тип text/plain):
dаtа.sеtТехt("Перетаскиваемый текст")
♦ text() - возвращает текстовые данные;
♦ hasтext() - возвращает значение тrue, если объект содержит текстовые данные, и
False - в противном случае;
♦ setHtml(<НТМL-код>) - заносит данные в формате HTML (МIМЕ-тип text/html):
dаtа.sеtНtml("<Ь>Перетаскиваемый НТМL-текст</Ь>")
♦ html() - возвращает данные в формате НТМL;
♦ hasHtml() - возвращает значение True, если объект содержит данные в формате НТМL,
и False - в противном случае;
446 Часть 11. Библиотека PyQt б
♦ setUrls(<Список интернет-адресов>) - заносит список интернет-адресов (МIМЕ-тип
text/uri-list), представленных объектами класса QUrl из модуля QtCore. С помощью
этого МIМЕ-типа можно обработать перетаскивание файлов. Пример:
data.setUrls([QtCore.QUrl("https://www.google.ru/")])
♦ urls() -возвращает список интернет-адресов:
uri = е.mimeData().urls() [О] .toString()
♦ hasUrls() - возвращает значение тrue, если объект содержит список интернет-адресов,
и False - в противном случае;
♦ setimageData(<Изображение>) - заносит изображение (МIМЕ-тип application/x-qt
image). В параметре можно указать, например, объект класса Qimage или QPixmap. При
мер:
data.setimageData(QtGui.Qimage("pixmap.png"))
data .setimageData(QtGui.QPixmap("pixmap.png"))
♦ imageData() � возвращает объект изображения;
♦ hasimage() -возвращает значение тrue, если объект содержит изображение, и False -
в противном случае;
♦ setColorData(<Цвет>) - заносит цвет (МIМЕ-тип application/x-color). Цвет может
быть представлен значением произвольного типа. Пример:
data.setColorData("red")
♦ colorData() -возвращает цвет;
♦ hasColor() - возвращает значение True, если объект содержит цвет, и False - в про
тивном случае;
♦ setData(<МIМЕ-тип>, <Данные>) - заносит данные указанного МIМЕ-типа. МIМЕ-тип
указывается в виде строки, данные - в виде объекта класса QByteArray из модуля
QtCore. Метод можно вызвать несколько раз с различными МIМЕ-типами. Пример зане
сения текстовых данных:
data.setData("text/plain", QtCore.QByteArray(bytes("Дaнныe", "utf-8")))
♦ data(<МIМЕ-тип>) -возвращает объект класса QByteArray с данными, соответствующи
ми указанному МIМЕ-типу;
♦ hasFormat(<МIМЕ-тип>) - возвращает значение True, если объект содержит данные ука-
занного МIМЕ-типа, и False -в противном случае;
♦ formats() -возвращает список с МIМЕ-типами данных, содержащихся в объекте;
♦ removeFormat(<МIМЕ-тип>) - удаляет данные, соответствующие указанному МIМЕ-типу;
♦ clear() -удаляет все данные.
Если необходимо перетаскивать данные какого-либо специфического типа, нужно наследо
вать класс QMimeData и переопределить в нем методы retrieveData() и formats(). За под
робной информацией по этому вопросу обращайтесь к документации.
20.10.2. Обработка перетаскивания и сброса
Прежде чем обрабатывать перетаскивание и сбрасывание данных в какой-либо компонент,
необходимо сообщить системе, что этот компонент может принимать перетаскивае-
Глава 20. Обработка сигналов и событий 447
мые дairnыe. Для этого внутри конструктора компонента следует вызвать метод
setAcceptDrops(<Состояние>), передав ему True, например:
self.setAcceptDrops(True)
Обработка перетаскивания и сброса объекта выполняется следующим образом:
1. Внутри специального метода dragEnterEvent () компонента проверяется МIМЕ-тип пе
ретаскиваемых данных и предлагаемое действие. Если компонент способен обработать
сброс этих данных и соглашается с предложенным действием, необходимо вызвать ме
тод acceptproposedAction() объекта события. Если нужно изменить действие, методу
setDropAction() объекта события передается новое действие, а затем у того же объекта
вызывается метод accept() вместо acceptProposedAction().
2. Если необходимо ограничить область сброса некоторым участком компонента, следует
дополнительно определить в нем метод dragMoveEvent(). Этот метод будет постоянно
вызываться при перетаскивании внутри компонента. При достижении курсором мыши
нужного участка компонента следует вызвать метод accept() объекта события, передав
ему объект класса QRect с координатами и размерами этого участка. В этом случае при
перетаскивании внутри участка метод dragMoveEvent() повторно вызываться не будет.
3. Внутри метода dropEvent() компонента производится обработка сброса.
Обработать события, возникающие в процессе перетаскивания и сбрасывания, позволяют
следующие специальные методы класса QWidget:
♦ dragEnterEvent(self, <event>) - вызывается, когда перетаскиваемые данные входят
в область компонента. Через параметр <event> доступен объект класса QDragEnterEvent;
♦ dragLeaveEvent(self, <event>) - вызывается, когда перетаскиваемые данные покида
ют область компонента. Через параметр <event> доступен объект класса QDragLeaveEvent;
♦ dragMoveEvent(self, <event>) - вызывается при перетаскивании данных внутри ком
понента. Через параметр <event> доступен объект класса QDragMoveEvent;
♦ dropEvent(self, <event>) - вызывается при сбрасывании данных в компонент. Через
параметр <event> доступен объект класса QDropEvent.
Класс QDragLeaveEvent наследует класс QEvent и не несет никакой дополнительной инфор
мации.
Цепочка наследования остальных классов выглядит так:
QEvent - QDropEvent - QDragMoveEvent - QDragEnterEvent
Класс QDragEnterEvent не содержит собственных методов.
Класс QDropEvent поддерживает следующие методы:
♦ mimeData() - возвращает объект класса QMimeData с перемещаемыми данными;
♦ possiЫeActions() - возвращает комбинацию допустимых действий при сбрасьmании:
if e.possiЫeActions() & QtCore.Qt.DropAction.MoveAction:
print("MoveAction")
if e.possiЫeActions() & QtCore.Qt.DropAction.CopyAction:
print("CopyAction")
♦ proposedAction () - возвращает предлагаемое действие по умолчанию;
♦ acceptproposedAction() - сообщает о готовности принять переносимые данные и со
гласии с предлагаемым действием по умолчанию. Этот метод (или метод accept(), под-
448 Часть 11. Библиотека PyQt б
держиваемый классом QDragMoveEvent) необходимо вызвать внутри метода
dragEnterEvent(), иначе метод dropEvent() вызван не будет;
♦ setDropAction(<Действие>) - задает другое действие при сбрасывании. После изме-
нения действия следует вызвать метод accept() объекта события, а не
acceptProposedAction();
♦ dropAction() - возвращает действие, которое должно быть выполнено при сбрасыва
нии. Оно может не совпадать со значением, возвращаемым методом proposedAction(),
если действие было изменено с помощью метода setDropAction();
♦ source() - возвращает ссылку на компонент-источник, или None, если данные перено
сятся из другой программы.
Теперь рассмотрим методы класса QDragMoveEvent:
♦ accept( [ <Область QRect> J ) - сообщает о согласии с дальнейшей обработкой события.
В качестве параметра можно указать объект класса QRect с координатами и размерами
прямоутольной области, в которой будет доступно сбрасывание;
♦ ignore( [ <Область QRect> J ) - отменяет операцию переноса данных. В качестве пара
метра можно указать объект класса QRect с координатами и размерами прямоугольной
области, в которой сбрасывание запрещено;
♦ answerRect() - возвращает объект класса QRect с координатами и размерами прямо
угольной области, в которой произойдет сбрасывание, если событие будет принято.
Некоторые компоненты в PyQt уже поддерживают технологию drag & drop (так, в поле вво
да можно перетащить текст из друтой программы).
20.11. Работа с буфером обмена
Получить ссылку на глобальный объект буфера обмена позволяет статический метод
clipboard() класса QApplication:
clipboard = QtWidgets.QApplication.clipboard()
Класс QClipboard, на основе которого создан этот объект, поддерживает следующие методы:
♦ setтext(<Текст>) - заносит текст в буфер обмена:
clipboard.setText("Teкcт")
♦ text() - возвращает из буфера обмена текст или пустую строку;
♦ text(<Тип>) - возвращает кортеж из двух строк: первая хранит текст из буфера обмена,
вторая - название типа. В параметре <Тип> могут быть указаны значения· "plain" (про
стой текст), "html" (НТМL-код) или пустая строка (любой тип);
♦ setimage(<Изображение Qimage>) - заносит в буфер обмена изображение:
clipboard.setlmage(QtGui.Qimage("image. jpg"))
♦ image() - возвращает из буфера обмена изображение, представленное объектом класса
Qimage, или пустой объект этого класса;
♦ s�tPixmap(<Изображение QPixmap>) - заносит в буфер обмена изображение:
clipboard.setpixmap(QtGui .QPixmap("image.jpg"))
Глава 20. Обработка сигналов и событий 449
♦ pixrnap() - возвращает из буфера обмена изображение, представленное объектом класса
QPixrnap, или пустой объект этого класса;
♦ setMimeData (<Данные QMimeData>) - заносит в буфер обмена заданные данные;
♦ mimeData() - возвращает данные, представленные объектом класса QМimeData;
♦ clear() - очищает буфер обмена.
Отследить изменение состояния буфера обмена позволяет сигнал dataChanged() объекта
буфера обмена. Назначить обработчик этого сигнала можно так:
QtWidgets.QApplication.instance().clipboard().dataChanged.connect(
on change_clipboard)
20.12. Фи11ьтрация событий
События можно перехватывать еще до того, как они будут переданы компоненту. Для этого
необходимо создать класс, который является наследником класса QObject, и определить
в нем специальный метод eventFilter(self, <Компонент>, <event>). Через второй пара
метр доступна ссылка на компонент, а через параметр <event> - на объект с дополнитель
ной информацией о событии. Этот объект различен для разных типов событий - так, у со
бытия MouseвuttonPress он будет создан на основе класса QMouseEvent, а у события
KeyPress - на основе класса QKeyEvent. Из метода eventFilter() следует вернуть з�ачение
True, если событие не должно быть передано дальше, и. False - в противном случае. При
мер такого класса-фильтра, перехватывающего нажатие клавиши <В>:
class MyFilter(QtCore.QObject):
def init (self, parent=None):
QtCore.QObJect. init (self, parent)
def eventFilter(self, oqj, е);
if e.type() == QtCore.QEvent.Type.KeyPress:
if e.key() == QtCore.Qt.Key.Key_B:
рrint("Событие от клавиши <В> не дойдет до компонента")
return True
return QtCore.QObject.eventFilter(self, obj, е)
Далее следует создать объект этого класса, передав. в конструктор ссьшку на компонент, а
затем вызвать у того же компонента метод installEventFilter(), передав в качестве един
ственного параметра ссылку на объект фильтра. Пример установки фильтра для надписи:
self.label.installEventFilter(MyFilter(self.label))
Метод installEventFilter() можно вызвать несколько раз, передавая ссылку на разные
объекты фильтров. В этом случае первым будет вызван фильтр, который был добавлен по
следним. Кроме того, один фильтр можно установить сразу в нескольких компонентах.
Ссылка на компонент, который является источником события, доступна через второй пара
метр метода eventFilter().
Удалить заданный фильтр позволяет метод removeEventFilter(<Фильтр>), вызываемый
у компонента, у которого был назначен этот фильтр. Если таковой не был установлен, при
вызове метода ничего не произойдет.
450 Часть 11. Библиотека PyQt б
20.13. Генерирование событий
Для генерирования событий применяются следующие статические методы класса
QApplication:
♦ sendEvent(<Компонент>, <Собьггие>) - немедленно посылает заданное событие указан
ному компоненту и возвращает результат выполнения обработчика;
♦ postEvent() - добавляет заданное событие в очередь. Формат вызова:
роstЕvеnt(<Компонент>, <Собьгг.ие>[,
priority=EventPriority.NormalEventPriority])
Параметром priority можно передать приоритет события, использовав один из сле
дующих элементов перечисления EventPriority из модуля QtCore.Qt: HighEventPriority
(высокий приоритет), NormalEventPriority (обычный приоритет) и LowEventpriority
(низкий приоритет). Этот метод является потокобезопасным, следовательно, его можно
использовать в многопоточных программах для обмена событиями между потоками.
Пример отправки события QEvent.MouseButtonPress компоненту label:
е = QtGui.QМouseEvent(QtCore.QEvent.Type.MouseButtonPress,
QtCore.QPointF(S, 5), QtCore.Qt.MouseButton.LeftButton,
QtCore.Qt.MouseButton.LeftButton,
QtCore.Qt.KeyboardМodifier.NoModifier)
QtWidgets.QApplication.sendEvent(self.label, е)
20.14. Пользовательские события
Пользовательским называется событие, созданное самим программистом. Класс пользова
тельского события должен быть производным от класса QEvent. В нем следует зарегистри
ровать пользовательское событие с помощью статического метода registerEventтype()
класса QEvent и сохранить идентификатор зарегистрированного события, возвращенный
этим методом, в каком-либо атрибуте класса. Пример:
class MyEvent(QtCore.QEvent):
idType = QtCore.QEvent.registerEventType()
def init (self, data):
QtCore.QEvent. init (self, MyEvent.idType)
self.data = data
def get_data(self):
return self.data
Пример отправки события класса MyEvent компоненту label:
QtWidgets.QApplication.sendEvent(self.label, MyEvent("512"))
Обработать пользовательское событие · можно с помощью специальных методов
event(self, <event>) или customEvent (self, <event>). С параметром <event> в эти методы
передается объект события. Пример:
def customEvent(self; е):
if е.t уре() = MyEvent. idType:
self. setText ("Получены данные: {О}".format( е.get_data()))
ГЛАВА 21
Размещение компонентов в окнах.
Контейнеры
Размещать компоненты в окнах можно двумя <.;пособами:
♦ посредством абсолютного позиционирования - явно указывая местоположение и раз
меры каждого компонента;
♦ используя контейнеры - особые компоненты, предназначенные для размещения других
компонентов в определенном порядке (например, в стопку или в ячейках воображаемой
сетки).
Все описанные далее классы определены в модуле QtWidgets.
21.1. Абсолютное позиционирование
При создании компонента с указанием ссьшки на родителя созданный компонент будет
выведен в позицmо с координатами (о, о) - в левый верхний угол родителя. Если создать
таким образом несколько компонентов, то все они отобразятся в одной и той же позиции,
наложившись друг на друга. Размеры добавляемых компонентов будут соответствовать их
содержимому.
Для перемещения компонента можно воспользоваться методом move( ) , а для изменения
размеров - методом resize (). Выполнить одновременное изменение позиции и размеров
позволяет метод setGeometry( ) .
Для примера выведем внутри окна надпись и кнопку, применив абсототное позициониро
вание (листинг 21.1 ).
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("Aбcoлютнoe позиционирование")
window.resize(З00, 120)
label = QtWidgets.QLabel("Teкcт надписи", window)
button = QtWidgets.QPushButton("Teкcт на кнопке", window)
label.setGeometry(l0, 10, 280, 60)
button.resize(280, 30)
452 Часть 11. Библиотека PyQt б
button.move(l0, 80)
window.show()
sys.exit(app.exec())
Абсоmотное позиционирование имеет следующие недостатки:
♦ . при изменении размеров окна координаты и размеры располагающихся в нем компонен
тов придется изменять самостоятельно;
♦ при запуске программьi на другом кdмпьютере, имеющем другие настройки экрана, сис
темных шрифтов или другую операционную систему, надписи на компонентах могут
выходить за их пределы.
Аналогичная проблема возникнет, если программа поддерживает несколько языков ин
терфейса (поскольку длина слов в разных языках различается).
21.2. Контейнеры-стопки
Контейнер-стопка выстраивает находящиеся в нем компоненты в линию. Существуют два
следующих класса, представляющих подобного рода контейнеры:
♦ QHBoxLayout - горизонтальная стопка;
♦ QVBoxLayout - вертикальная стопка.
Иерархия наследования для этих классов выглядит так:
(QObject, QLayoutitem) - QLayout - QBoxLayout - QHBoxLayout
(QObject, QLayoutitem) - QLayout - QBoxLayout - QVВoxLayout
Контейнеры-стопки не являются наследниками класса QWidget, вследствие чего не облада
ют собственнъ1м окном и не могут использоваться отдельно. Поэтому они обязательно
должны быть привязаны к родительскому компоненту (обычно окну или другому контейне
ру). При привязке контейнера к родитеmо контейнер автоматически вьmодится на экран.
Формат вызова конструктора обоих классов:
QHBoxLayoutlQVВoxLayout([<Poдитeль>])
Если родитель не был указан при создании объекта контейнера, привязать контейнер к ро
дитеmо можно вызовом у последнего метода setLayout (<Привязываемый контейнер>).
Пример использования класса QHBoxLayout показан в листинге 21.2, а увидеть результат
выполнения этого кода можно на рис. 21.1.
коl(Тейнер,
'(
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget() # Родительский компонент - окно
window .setWindowТitle("QHBoxLayout")
window.resize(З00, 60)
buttonl = QtWidgets.QPushButton("l")
button2 = QtWidgets.QPushButton("2")
buttonЗ = QtWidgets.QPushButton("З")
Глава 21. Размещение компонентов в окнах. Контейнеры 453
button4 = QtWidgets.QPushButton("4")
hЬох = QtWidgets.QHBoxLayout() # Создаем контейнер
hЬox.addWidget(buttonl) # Добавляем компоненты
hЬox.addWidget(button2)
hЬox.addWidget(buttonЗ)
hЬox.addWidget(button4)
window.setLayout(hЬox) # Привязываем контейнер к родителю
window.show()
sys.exit(app.exec())
[u QHBoxlayout □ х
Рис. 21.1. Контейнер QHBoxLayout с четырьмя кнопками
Добавить компоненты в контейнер, удалить их и заменить другими позволяют следующие
методы:
♦ addWidget() - добавляет компонент в конец контейнера. Формат метода:
addWidget(<Koмnoнeнт>[, stretch=O] [, alignment=O])
В первом параметре указывается ссьmка на компонент. Необязательный параметр
stretch задает фактор растяжения для ячейки в виде целого числа, а параметр
alignment - выравнивание компонента внутри ячейки. Два последних параметра можно
задавать как позиционные или именованные, например:
hЬox.addWidget(buttonl, 10, QtCore.Qt.AlignmentFlag.AlignRight)
hЬox.addWidget(button2, stretch=lO)
hЬox.addWidget(buttonЗ, alignment=QtCore.Qt.AlignmentFlag.AlignRight)
♦ insertWidget() - добавляет компонент в позицию контейнера, обозначенную указан
ным индексом. Формат метода:
insertWidget(<Индeкc>, <Компонент>[, stretch=O][, alignment=O])
Если в первом параметре указано значение О, компонент будет добавлен в начало кон
тейнера, а если отрицательное значение - в конец контейнера. Иное значение указывает
определенную позицmо. Остальные параметры аналогичны параметрам метода
addWidget(). Пример:
hЬox.addWidget(buttonl)
hЬox.insertWidget(-1, button2) # Добавление в конец
hЬox.insertWidget(O, buttonЗ) # Добавление в начало
♦ �emoveWidget(<Компонент>) - удаляет указанный компонент из контейнера;
♦ replaceWidget() - заменяет присутствующий в контейнере компонент другим. Формат
метода:
rерlасеWidgеt(<Заменяемый компонент>, <Заменяющий компонент>[,
options=FindChildOption.FindChildrenRecursively])
454 Часть 11. Библиотека PyQt 6
В необязательном параметре options можно задать режим поиска заменяемого компо
нента в виде одного из элементов перечисления FindChildOptions из модуля QtCore. Qt:
FindDirectChildrenOnly (искать только среди содержимого текущего, контейнера) и
FindChildrenRecursively (искать среди содержимого текущего и всех вложенных в него
контейнеров);
♦ addLayout(<Контейнер> [, stretch=OJ ) - добавляет другой контейнер в конец текущего
контейнера. С помощью этого метода можно вкладывать один контейнер в другой, соз
давая таким образом структуру любой сложности;
♦ insertLayout(Позиция>, <Контейнер> [, stretch=O]) - добавляет другой контейнер в
позицию текущего контейнера, обозначенную указанным индексом. Если в первом па
раметре задано отрицательное значение, контейнер добавляется в конец;
♦ addSpacing(<Размер>) - добавляет пустое пространство указанного размера (в пиксе
лах) в конец контейнера:
hЬox.addSpacing(lOO)
♦ insertSpacing(<Индекс>, <Размер>) - добавляет пустое пространство указанного раз
мера (в пикселах) в позицию с заданным индексом. Если первым параметром передается
отрицательное значение, то пространство добавляется в конец;
♦ addStretch( [stretch=OJ) - добавляет пустое растягиваемое пространство с нулевым
минимальным размером и фактором растяжения stretch в конец контейнера. Это про
странство можно сравнить с пружиной, вставленной между компонентами, а параметр
stretch - с жесткостью пружины;
♦ insertStretch(<Индекс> [, stretch=OJ ) - добавляет растягиваемое пространство в по
зицию с указанным индексом. Если в первом параметре задано отрицательное значение,
пространство добавляется в конец контейнера.
Параметр alignment в методах addWidget() и insertWidget() задает выравнивание компо
нента внутри ячейки в виде одного из следующих элементов перечисления AlignmentFlag из
модуля QtCore. Qt:
♦ AlignLeft или AlignLeading - горизонтальное выравнивание по левому краю;
♦ AlignRight или AlignTrailing - горизонтальное выравнивание по правому краю;
♦ AlignHCenter - горизонтальное выравнивание по центру;
♦ AlignJustify - заполнение всей ячейки;
♦ AlignTop - вертикальное выравнивание по верхнему краю;
♦ AlignBottom - вертикальное выравнивание по нижнему краю;
♦ AlignVCenter - вертикальное выравнивание по центру;
♦ Alignвaseline - вертикальное выравнивание по базовой линии;
♦ AlignCenter - горизонтальное и вертикальное выравнивание по центру;
♦ AlignAЬsolute - если в методе setLayoutDirection(<Выравнивание>) класса QWidget
указан элемент RightToLeft перечисления LayoutDirection из модуля QtCore. Qt, атрибут
AlignLeft �адает выравнивание по правому краю, а атрибут AlignRight - по левому
краю. Чтобы атрибут AlignLeft всегда соответствовал именно левому краю, необходимо
указать комбинацию AlignAЬsolute I AlignLeft. Аналогично следует поступить с атри
бутом AlignRight.
Глава 21. Размещение компонентов в окнах. Контейнеры 455
Можно задавать комбинации элементов, один из которых укажет выравнивание по горизон
тали, другой - по вертикали. Например, комбинация AlignLeft I AlignTop задает вырав
нивание по левому и верхнему краям. Противоречивые значения приводят к непредсказуе
мым результатам.
Контейнеры поддерживают также следующие методы (здесь приведены только основные
полный их список ищите в документации):
♦ setDirection (<Направление>) - задает направление вывода компонентов. В параметре
можно указать следующие элементы перечисления Direction из класса QHBoxLayout или
QVBoxLayout:
• LeftToRight - слева направо (значение по умолчанию у горизонтального контейнера);
• RightToLeft - справа налево;
• TopToBottom - сверху вниз (значение по умолчанию у вертикального контейнера);
• BottomToTop - снизу вверх;
♦ setContentsMargins() - задает величины отступов от границ контейнера до его содер
жимого. Форматы метода:
setContentsMargins(<Cлeвa>, <Сверху>, <Справа>, <Снизу>)
setContentsMargins(<Oтcтyпы QМargins>)
Примеры:
hЬox.setContentsMargins(2, 4, 2, 4)
m = QtCore.QМargins(4, 2, 4, 2)
hЬox.setContentsMargins(m)
♦ setSpacing(<Расстояние>) - задает расстояние между компонентами.
21.3. Контейнер-сетка
Контейнер-сетка располагает добавленные в него компоненты в ячейках воображаемой
сетки. Он реализуется классом QGridLayout. Иерархия его наследования:
(QObject, QLayoutitem) - QLayout - QGridLayout_
Формаt конструктора класса QGridLayout:
QGridLayout( [<Родитель>] )
Если родитель не был указан при создании объекта контейнера, привязатъ контейнер к ро
дителю можно вызовом у последнего метода setLayout().
Пример использования класса QGridLayout представлен в листинге 21.3, а результат его
выполнения -на рис. 21.2.
Листинг 21.3.-!1сnоnьэованме �нтейнера
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget() # Родительский компонент - окно
window.setWindowТitle("QGridLayout")
456 Часть 11. Библиотека PyQt 6
window.resize(250, 100)
buttonl QtWidgets.QPushButton("l")
button2 QtWidgets.QPushButton("2")
buttonЗ QtWidgets.QPushButton("3")
button4 QtWidgets.QPushButton("4")
grid = QtWidgets.QGridLayout() # Создаем сетку
grid.addWidget(buttonl, О, О) # Добавляем компоненты
grid.addWidget(button2, О, 1)
grid.addWidget(buttonЗ, 1, О)
grid.addWidget(button4, 1, 1)
window.setLayout(grid) # Привязываем контейнер к родителю
window.show()
sys.exit(app.exec())
liJ QGridlayout о х
Рис. 21.2. Контейнер QGridLayout с четырьмя кнопками
Добавить компоненты в сетку позволяют следующие методы:
♦ addWidget() - добавляет компонент в указанную ячейку сетки. Метод имеет следую
· щие форматы:
· addWidget_(<Компонент>, <Строка>, <Столбец>[, alignment=0] )
addWidget(<Koмпoнeнт>, <Строка>, <Столбец>, <Количество строк>,
<Количество столбцов>[, alignment=0])
В первом параметре указывается ссылка на компонент, во втором параметре - индекс
строки, а в третьем - индекс столбца. Нумерация строк и столбцов начинается с нуля.
Параметр <Количество строк> задает количество занимаемых компонентом ячеек по
вертикали, а параметр <Количество столбцов> - по горизонтали. Параметр alignment
задает выравнивание компонента внутри ячейки в виде одного из элементов перечисле
ния AlignmentFlag из модуля QtCore.Qt (см.разд. 21.2). Пример:
grid = QtGui.QGridLayout()
grid.addWidget(buttonl, О, О, alignment=QtCore.Qt.AlignmentFlag.AlignLeft)
grid.addWidget(button2, О, 1, QtCore.Qt.AlignmentFlag.AlignRight)
grid.addWidget(buttonЗ, 1, О, 1, 2)
♦ addLayout() - добавляет заданный контейнер в указанную ячейку сетки. Метод имеет
следующие форматы:
addLayout(<Koнтeйнep>, <Строка>, <Столбец>[, alignment=0])
addLayout(<Koнтeйнep>, <Строка>, <Столбец>, <Количество строк>,
<Количество столбцов>[, alignment=0])
Глава 21. Размещение компонентов в окнах. Контейнеры 457
В первом параметре указывается ссылка на контейнер. Остал1ьные параметры аналогич
ны параметрам метода addWidget().
Для удаления и замены компонентов следует пользоваться методами removeWidget() и
:::eplaceWidget(), описанными в разд. 21.2.
Класс QGric!Layout поддерживает следующие методы (здесь приведены только основные
-.1етоды - полный их список смотрите на странице https://doc.qt.io/qt-6/qgridlayout.html):
♦ setRowМinimшnНeight (<Индекс>, <Высота>) - задает минимальную высоту строки с ин
дексом <Индекс>;
♦ setColumnМinimumWidth(<Индекс>, <Ширина>) - задает минимальную ширину столбца
с индексом <Индекс>;
♦ setRowStretch (<Индекс>, <Фактор растяжения>) - задает фактор растяжения по верти
кали для строки с индексом <Индекс>;
♦ setColumnStretch(<Индeкc>, <Фактор растяжения>) - задает фактор растяжения по го
ризонтали для столбца с индексом <Индекс>;
♦ setcontentsмargins() - задает величины отступов от границ сетки до ее содержимого.
Форматы метода:
setContentsMargins(<Cлeвa>, <Сверху>, <Справа>, <Снизу>)
setContentsMargins(<Oтcтyпы QMargins>)
♦ setSpacing (<Расстояние>) - задает расстояние между компонентами по горизонтали и
вертикали;
♦ setHorizontalSpacing(<Paccтoяниe>) - задает расстояние между компонентами по го-
ризонтали;
♦ setVerticalSpacing(<Расстояние>) - задает расстояние между компонентами по вертикали;
♦ rowCount() - возвращает количество строк сетки;
♦ columnCount() - возвращает количество столбцов сетки;
♦ cellRect(<Индекс строки>, <Индекс колонки>) - возвращает объект класса QRect, ко
торый хранит координаты и размеры ячейки, расположенной на пересечении строки и
колонки с указанными индексами.
21.4. Контейнер-форма
Контейнер-форма выстраивает компоненты в виде таблицы из двух столбцов: в левом
столбце располагаются надписи для компонентов, в правом - сами компоненты. Он реали
зуется классом QFonnLayout. Иерархия наследования выглядит так:
(QObject, QLayoutitem) - QLayout - QFonnLayout
Формат конструктора класса QFonnLayout:
QFonnLayout( [<Родитель>])
Если родитель не был указан при создании объекта контейнера, привязать контейнер к ро
дителю можно вызовом у последнего метода setLayout().
В листинге 21.4 показан код, создающий форму с применением контейнера QFonnLayout.
Результат выполнения этого кода можно увидеть на рис. 21.3.
458 Часть 11. Библиотека PyQt 6
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QFormLayout")
window.resize(З00, 150)
lineEdit = QtWidgets.QLineEdit()
textEdit = QtWidgets.QТextEdit()
buttonl = QtWidgets.QPushButton("O&тnpaвить")
button2 = QtWidgets.QPushButton("O&чиcтить")
hЬох = QtWidgets.QHBoxLayout()
hЬox.addWidget(buttonl)
hЬox.addWidget(button2)
form = QtWidgets.QFormLayout()
form.addRow("&Haзвaниe:", lineEdit)
form.addRow("&Oпиcaниe:", textEdit)
form.addRow(hЬox)
window.setLayout(form)
window.show()
sys.exit(app.exec())
1!J QFormlayout □ х
Рис. 21.3. Контейнер QFormLayout
Класс QFormLayout поддерживает следующие методы (здесь приведены только основные -
полный их список смотрите на странице https://doc.qt.io/qt-6/qformlayout.html):
♦ addRow() - добавляет в конец контейнера строку с указанными надписью и компонен
том или друтим контейнером. Форматы метода:
addRow(<Teкcт надписи>, <Компонент> 1 <Контейнер>)
аddRоw(<Надпись QLabel>, <Компонент> 1 <Контейнер>)
аddRоw(<Компонент> 1 <Контейнер>)
В первом формате в тексте надписи можно указать символ &, который пометит клавишу
быстрого доступа для компонента (контейнера). Второй формат принимает в качестве
надписи компонент класса QLaЬel - в этом случае связь с компонентом (контейнером)
необходимо устанавливать вручную, передав ссьшку на него в метод setвuddy(). Третий
формат помещает компонент (контейнер) сразу в оба столбца формы;
Глава 21. Размещение компонентов в окнах. Контейнеры 459
♦ insertRow() - добавляет строку в позицию контейнера, обозначенную указанным ин
дексом. Если в первом параметре задано отрицательное значение, компонент добавляет
ся в конец контейнера. Форматы метода:
insertRow(<Индeкc>, <Текст надписи>, <Компонент> 1 <Контейнер>)
insertRow(<Индeкc>, <Надпись QLabel>, <Компонент> 1 <Контейнер>)
insertRow(<Индeкc>, <Компонент> 1 <Контейнер>)
♦ setFormAlignrnent(<Режим>) - задает режим выравнивания формы (допустимые значе
ния рассмотрены в разд. 21.2):
foпn.setFormAlignrnentjQtCore.Qt.AlignrnentFlag.AlignRight
QtCore.Qt.AlignrnentFlag.AlignBottom)
♦ setLabelAlignrnent(<Режим>) - задает режим выравнивания надписей (допустимые зна
чения рассмотрены в разд. 21.2):
foпn.setLabelAlignrnent(QtCore.Qt.AlignrnentFlag.AlignRight)
♦ setRowWrapPolicy(<Режим>) - задает местоположение надписей относительно связан
ных с ними компонентов. В параметре указываются следующие элементы перечисления
RowWrapPolicy из класса QFormLayout:
• DontWrapRows - надписи расположены слева от компонентов;
• wrapLongRows - длинные надписи могут находиться выше компонентов, а короткие
надписи - слева от компонентов;
• WrapAllRows - надписи всегда расположены выше компонентов;
♦ setFieldGrowthPolicy(<Режим>) - задает режим управления размерами компонентов.
В параметре указываются следующие элементы перечисления FieldGrowthPolicy из
класса QFormLayout:
• FieldsStayAtSizeHint - компоненты всегда будут принимать рекомендуемые (воз
вращаемые методом sizeHint()) размеры;
• ExpandingFieldsGrow - компоненты, у которых установлена политика изменения
размеров Expanding или MinimumExpanding (см. разд. 21.6), займут всю доступную
ширину. Размеры остальных компонентов всегда будут соответствовать рекомендуе
мым;
• AllNonFixedFieldsGrow - все компоненты по возможности займут всю доступную
ширину;
♦ setContentsMargins() - задает величины отступов от границ формы до ее содержимого.
Форматы метода:
setContentsMargins(<Cлeвa>, <Сверху>, <Справа>, <Снизу>)
1
setContentsMargins(<Oтcтyпы QМargins>)
♦ • setSpacing(<Расстояние>) - задает расстояние между компонентами по горизонтали и
вертикали;
♦ setHorizontalSpacing(<Расстояние>) - задает расстояние между компонентами по го
ризонтали;
♦ setVerticalSpacing(<Расстояние>) - задает расстояние между компонентами по верти
кали.
Для удаления и замены компонентов следует пользоваться методами removeWidget() и
replaceWidget(), описанными в разд. 21.2.
460 Часть 11. Библиотека PyQt б
21.5. Стеки
Контейнер-стек в каждый момент времени выводит лишь один компонент-потомок. Он
реализуется классом QStackedLayout. Иерархия наследов_ания выглядит так:
(QObject, QLayoutitem) - QLayout - QStackedLayout
Формат конструктора класса QStackedLayout:
QStackedLayout([<Poдитeль>])
Если родитель не был указан при создании объекта контейнера,_привязать контейнер к ро
дитето можно вызовом у последнего метода setLayout() .
Класс QStackedLayout поддерживает следующие методы:
♦ addWidget(<Компонент>) - добавляет компонент в конец контейнера. Метод возвращает
индекс добавленного компонента;
♦ insertWidget(<Индекс>, <Компонент>) - добавляет компонент в позицюо контейнера,
обозначенную указанным индексом. Метод возвращает индекс добавленного компо
нента;
♦ setcurrentindex(<Индекс>) - делает видимым компонент с указанным индексом. Ме
тод является слотом;
♦ currentindex() - возвращает индекс видимого компонента;
♦ setCurrentWidget(<Компонент>) - делает видимым указа�rnый компонент. Метод явля
ется слотом;
♦ currentWidget() - возвращает ссылку на видимый компонент;
♦ setStackingMode(<Режим>) - задает режим отображения компонентов. В параметре
могут быть указаны следующие элементы перечисления StackingMode · из класса
QStackedLayout:
• StackOne - видим только один компонент (значение по умолчанию);
• StackAll - видны все компоненты;
♦ stackingMode() - возвращает режим отображения компонентов;
♦ count() - возвра�цает количество компонентов внутри контейнера;
♦ widget(<Индекс>) - возвращает ссылку на компонент, который расположен по указан-
ному индексу, или значение None при обращении по несуществующему индексу.
Для удаления и. замены компонентов следует пользоваться методами removeWidget() и
replaceWidget(), описанными в разд. 21.2.
Класс QStackedLayout поддерживает следующие сигналы:
♦ currentChanged(<Индекс>) - генерируется при выводе другого компонента. Через пара
метр внутри обработчика доступен целочисленный индекс выведенного компонента;
♦ widgetRemoved(<Индекс>) - генерируется при удалении компонента из контейнера.
Через параметр внутри обработчика доступен целочисленный индекс удаленного ком
понента.
Класс QStackedWidget также реализует стек компонентов, но представляет собой полноцен
ный компонент. Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame - QStackedWidget
Глава 21. Размещение компонентов в окнах. Контейнеры 461
Формат конструктора этого класса:
QStackedWidget([<Родитель>])
Класс QStackedWidget поддерживает описанные ранее методы addWidget(), insertWidget(),
removeWidget(), replaceWidget(), count(), currentindex(), currentWidget(), widget(),
setCurrentindex() и setCurrentWidget(). Кроме того, класс QStackedWidget наследует все
методы из базовых классов и определяет два дополнительных:
♦ indexOf(<Компонент>)- возвращает индекс компонента, ссылка на который указана
в параметре;
♦ _len_() - возвращает количество компонентов. Метод вызывается при использова
нии функции len(), а также для проверки объекта на логическое значение.
Поддерживаются и описанные ранее сигналь� currentChanged() и widgetRemoved().
21.6. Управление размерами компонентов
Если в вертикальный контейнер большой высоты добавить надпись и кнопку, то кнопка
займет пространство, совпадающее с рекомендуемыми размерами (которые возвращает ме
тод sizeHint()), а под надпись будет выделецо все остальное место. Управление размерами
компонентов внутри контейнера определяется правилами, установленными с помощью
объектов класса QSizePolicy. Установить эти правила для компонента можно с помощью
метода setSizePolicy(<Правило QSizePolicy>) класса QWidget, а получить их- вызовом
метода sizePolicy().
Формат конструктора класса QSizePolicy:
QSizePolicy([<Пpaвилo для горизонтали>, <Правило для вертикали>[,
<Тип компонента>]])
Если параметры не заданы, размер компонента будет точно соответствовать размерам, воз
вращаемым методом sizeHint(). В первом и втором параметрах указывается один из сле
дующих элементов перечисления Policy из класса QSizePolicy:
♦ Fixed - размеры компонента будут точно соответствовать размерам, возвращаемым
методом sizeHint();
♦ Minimum- размеры, возвращаемые методом sizeHint(), станут минимальными для ком
понента и могут быть увеличены при необходимости;
♦ Maximum- размеры, возвращаемые методом sizeHint(), станут максимальными для
компонента и могут быть уменьшены при необходимости;
♦ Preferred- размеры, возвращаемые методом sizeHint(), являются предпочтительны
ми и могут быть как увеличены, так и уменьшены;
♦ Expanding- размеры, возвращаемые методом sizeHint(), могут быть как увеличены,
так и уменьшены. Компонент займет все свободное пространство в контейнере;
♦ MinimumExpanding- размеры, возвращаемые методом sizeHint(), являются минималь
·ным для компонента. Компонент займет все свободное пространство в контейнере;
♦ Ignored- размеры, возвращаемые методом sizeHint(), игнорируются. Компонент зай
мет все свободное пространство в контейнере.
В качестве типа компонента указывается один из следующих элементов перечисления
ControlType из класса QSizePolicy: DefaultType (нет какого-либо специфического типа-
462 Часть 11. Библиотека PyQt б
значение по умолчщшю), вuttonBox (набор кнопок диалогового окна, представленный объ
ектом класса QDialogButtonвox), CheckBox (флажок), СоmЬоВох (раскрывающийся список),
Frame (панель с рамкой), GroupBox (группа), Label (надпись), Line (панель с рамкой, выво
дящаяся: в виде горизонтальной или вертикальной линии), LineEdit (поле ввода), PushButton
(кнопка), RadioButton (переключатель), Slider (шкала с ползунком), SpinBox (поле для вво
да целых чисел), TabWidget (панель с вкладками) или ToolВutton (кнопка панели инстру
ментов).
Пример:
sp = QtWidgets.QSizePolicy(QtWidgets.QSizePolicy.Policy.MinimlШI,
QtWidgets.QSizePolicy.Policy.Fixed,
QtWidgets.QSizePolicy.ControlType.Frame)
Изменить правила управления размерами уже после создания объекта класса QSizePolicy
позволяют методь1 setHorizontaiPolicy(<Пpaвилo для горизонтали>) и
setVerticalPolicy(<Пpaвилo для вертикали>) .
Изменить тип компонента после создания объекта класса QSizePolicy позволяет метод
setControlType(<Tип компонента>).
С помощью методов setHorizontalStretch(<Фактор для горизонтали>) и
setVerticalStretch(<Фактор для вертикали>) можно указать фактор растяжения. Чем
больше указанное значение относительно значения, заданного в других компонентах, тем
больше места будет выделяться под текущий компонент.
Можно указать, что предпочтительная высота компонента зависит от его ширины. Для это
го необходимо передать значение True в метод setHeightForWidth(<Флаг>). Кроме того,
следует в классе компонента переопределить метод heightForWidth(<Шиpинa>) - переопре
деленный метод должен возвращать высоту компонента для указанной в параметре
ширины.
Метод setRetainSizeWhenHidden(<Флаг>) позволяет указать поведение контейнера при
скрытии компонента. Значение False параметра предписывает контейнеру полностью уби
рать как сам скрытый компонент, так и пространство, занятое скрытым компонентом, а зна
чение тrue - убирать лишь компонент, оставляя занятое им пространство свободным.
21.7. Группа
Группа - это область, содержащая какой-либо набор компонентов и окруженная рамкой,
на верхней границе которой выводится текст заголовка. Она реализуется классом QGroupBox.
Иерархия наследования выглядит так:
(QObj.ect, QPaintDevice) - QWidget - QGroupBox
Формат конструктора класса QGroupBox:
QGroupBox([<Родитель>] )
QGroupBox(<Teкcт заголовка>[, <Родитель>])
В тексте заголовка символ &, указанный перед буквой, задает комбинацию клавиш быстрого
доступа.
После создания объекта класса QGroupвox следует добавить компоненты в какой-либо кон
тейнер, а затем передать ссылку на этот контейнер в метод setLayout() группы.
Глава 21. Размещение компонентов в окнах. Контейнеры 463
Пример использоваIШЯ класса QGroupвox представлен кодом из листинга 21.5. Созданная им
группа показана на рис. 21.4.
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QGroupBox")
window.resize(250, 80)
mainЬox = QtWidgets .QVВoxLayout () # Создаем главный контейнер -
radiol = QtWidgets.QRadioButton("&Дa")
radio2 = QtWidgets.QRadioButton("&Heт")
Ьох = QtWidgets.QGroupBox("&Bы знаете язык Python?") # Объект группы
hЬох = QtWidgets.QHBoxLayout() # Создаем второй контейнер - для группы
hЬox.addWidget(radiol) # Добавляем компоненты во второй контейнер
hЬox.addWidget(radio2)
box.setLayout(hЬox) # Добавляем второй контейнер в группу
mainЬox.addWidget(box) # Добавляем груnпу'в главный контейнер
window.setLayout(mainЬox) # Помещаем главный контейнер в окно
radiol.setChecked(True) # Выбираем первый переключатель
,·
window.show()
sys.exit(app.exec())
fjJ QGroupBox □ х
�ы знает,е язык·Руthоn?
О .!::!ет
Рис. 20.4. Компонент QGroupBox
Класс QGroupBox поддерживает следующие методы (здесь приведены только основные -
полный их список смотрите на странице https://doc.qt.io/qt-6/qgroupbox.html):
♦ setTitle(<Текст>) - задает текст заголовка;
♦ title() - возвращает текст заголовка;
♦ setAlignment(<Выравнивание>) - задает горизонтальное выравнивание текста заголовка.
В параметре указывается один из следующих элементов перечисления AlignmentFlag. из
модуля QtCore.Qt: AlignLeft, AlignHCenter или AlignRight:
box.setAlignment(QtCore.Qt.AlignmentFlag.AlignRight)
♦ alignment() - возвращает горизонтальное выравнивание текста заголовка;
♦ setCheckaЫe(<Флаг>) - если в параметре указать значение True, то перед заголовком
группы будет отображен флажок. Если флажок установлен, группа станет доступной для
ввода, а если флажок снят - недоступной. По умолчанию флажок не отображается;
464 Часть //. Библиотека PyQt 6
♦ isCheckaЫe() - возвращает значение True, если перед заголовком группы выводится
флажок, и False-в противном случае;
♦ setChecked(<Флaг>) - если в параметре указать значение True, флажок, отображаемый
перед заголовком группы, будет установлен. Значение False сбрасьmает флажок. Метод
является слотом;
♦ isChecked() - возвращает значение True, если флажок, отображаемый перед заголов
ком группы, установлен, и False-в противном случае;
♦ setFlat(<Флаг>) - если в параметре указано значение True, будет ото?ражаться только
верхняя граница рамки, а если False-то все границы рамки;
♦ isFlat() - возвращает зн�чение True, если отображается только верх.няя граница рам
ки, и False - если все границы рамки.
Класс QGroupBox поддерживает сигналы:
♦ сliсkеd(<Состояние флажка>) - генерируется при щелчке мышью на флажке, выводи
мом перед заголовком группы. Если состояние флажка изменяется с помощью метода
setChecked() , сигнал не генерируется. Через параметр внутри обработчика доступно
значение True, если флажок установлен, и False - если сброшен;
♦ toggled(<Cocтoяниe флажка>) - rенерируется при изменении состояния флажка, выво
димого п�ред заголовком группы. Через параметр внутри обработчика доступно значе
ние True, если флажок установлен, и False - если сброшен.
21.8. Панель с рамкой
Класс QFrame расширяет возможности класса QWidget, добавляя рамку вокруг компонента.
Этот класс, в свою очередь, наследуют некоторые компоненты - например, надписи, мно
гострочные текстовые поля и др. Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame
Конструктор класса QFrame имеет следующий формат:
QFrame( [parent=None] [, flags=O] )
В параметре parent указывается ссьшка на родительский компонент. Если этот параметр
имеет значение None и у параметра flags указано значение О, компонент не будет иметь
родителя и получит свое собственное окно. Параметр flags указывает тип создаваемого
окна. Доступные для задания типы рассмотрены в разд. 19.1.1.
Класс QFrame поддерживает следующие методы (здесь приведены только основные - пол
ный их список смотрите на странице https://doc.qt.io/qt-6/qframe.html):
♦ setFrameShape(<Форма>) - задает форму рамки. Могут быть указаны следующие эле
менты перечисления Shape из класса QFrame:
• NoFrame-нeт рамки;
. • Вох - прямоугольная рамка;
• Panel - панель, которая может быть выпуклой или вогнутой;
• WinPanel - панель в стиле Windows 2000, которая может быть выпуклой или вогну
той. Толщина границы ___: 2 пиксела. Этот элемент присутствует для совместимости
со старыми версиями Qt;
Глава 21. Размещение компонентов в окнах. Контейнеры 465
• HLine - горизонтальная линия. Используется как разделитель;
• VLine - вертикальная линия;
• styledPanel - панель, внешний вид которой зависит от текущего стиля. Она может
быть выпуклой или вогнутой. Это рекомендуемая форма рамки для панелей;
♦ setFrameShadow(<Тень>) - задает стиль тени. Могут быть указаны следующие элементы
перечисления Shadow из класса QFrame:
• Plain - нет тени;
• Raised - панель отображается выпуклой;
• sunken - панель отображается вогнутой;
♦ setFrameStyle(<Стиль>) - задает форму рамки и стиль тени одновременно. В качестве
значения через оператор I указывается комбинация приведенных ранее элементов пере
числений Shape и Shadow класса QFrame:
frame.setFrameStyle(QtWidgets.QFrame .Shape.Panel 1
QtWidgets.QFrame.Shadow .Raised)
♦ setLineWidth(<Ширина>) - задает толщину линий у рамки;
♦ setMidLineWidth(<Ширина>) - задает толщину средней линии у рамки. Средняя линия
используется для создания эффекта выпуклости и вогнутости и доступна только для
форм рамки Вох, HLine и VLine
♦ setFrameRect(<Область QRect>) - задает местоположение и размеры области внутри
панели, вокруг которой будет проведена рамка, в виде объекта класса QRect. По умолча
нию рамка рисуется вокруг всей панели.
21.9. Панель с вкладками
Панели с вкладками (блокнот) реализуется классом QTabWidget. Иерархия наследования
у него выглядит так:
(QCbject, QPaintDevice) - QWidget - QTabWidget
Конструктор класса QT�bWidget имеет следующий формат:
QTabWidget( [<Родитель>])
В параметре <Родит.ель> указывается ссылка на родительский компонент. Если он не указан,
компонент будет обладать своим собственным окном.
Пример кода, создающего компонент QTabWidget, приведен в листинге 21.6. Сама панель
с вкладками показана на рис. 21.5.
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys .argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QTabWidget")
window.resize(ЗOO, 100)
466 Часть 11. Библиотека PyQt 6
tab = QtWidgets.QТabWidget()
tab.addTaЬ(QtWidgets.QLabel("Coдepжимoe вкладки l"), "Вкладка &l")
tab.addTaЬ(QtWidgets.QLabel("Coдepжимoe вкладки 2"), "Вкладка &2")
tab.addTaЬ(QtWidgets.QLaЬel("Coдepжимoe вкладки 3"), "Вкладка &3")
tab.setCurrentindex(O)
vbox = QtWidgets.QVBoxLayout()
vbox.addWidget(tab)
window.setLayout(vbox)
window.show()
window.show()
sys.exit(app.exec())
li] QТabWidget □ х
Вкладка 1 , Вкладка l Вкладка J
:содержимое вкладки 1
Рис. 21.5. Компонент QГaЬWidget
Класс QTabWidget поддерживает следующие методы (здесь приведены только основные -
полное описание класса содержится на странице https://doc.qt.io/qt-6/qtabwidget.html):
♦ addTab() - добавляет вкладку в конец контейнера и возвращает ее индекс. Форматы
метода:
аddТаЬ(<Компонент>, <Текст ярлыка>)
аddТаЬ(<Компонент>, <Значок Qicon>, <Текст ярлыка>)
В параметре <Компонент> указьmается ссылка на компонент, который будет отображать
ся на вкладке. Чаще всего этот компонент является лишь родителем для других компо
нентов. Параметр <Текст ярлыка> задает текст, который будет отображаться на ярлыке
вкладки. Внутри текста ярлыка символ &, указанный перед буквой, задает комбинацmо
клавиш быстрого доступа. Параметр <Значок> указьrвает значок, который отобразится
перед текстом на ярлыке вкладки.
Пример указания стандартного значка:
style = window.style()
icon = style.standardicon(QtWidgets.QStyle.StandardPixmap.SP_DriveNeticon)
tab.addTaЬ(QtWidgets.QLabel("Coдepжимoe вкладки l"), icon, "Вкладка &l")
Пример загрузки значка из файла:
icon = QtGui.Qicon("icon.png")
tab.addTaЬ(QtWidgets.QLabel("Coдepжимoe вкладки l"), icon, "Вкладка &l")
♦ insertтaь() - добавляет вкладку по указанному индексу и возвращает индекс добав
ленной вкладки. Форматы метода:
insertTab(<Индeкc>, <Компонент>, <Текст ярлыка>)
insertTab(<Индeкc>, <Компонент>, <Значок Qicon>, <Текст ярлыка>)
Глава 21. Размещение компонентов в окнах. Контейнеры 467
♦ rernoveTab (<Индекс>) - удаляет вкладку с указа1rnым mщексом, при этом компонент,
который отображался на вкладке, не удаляется;
♦ clear () - удаляет все вкладки, при этом компоненты, которые отображались на вклад
ках, не удаляются;
♦ setTabText (<Индекс>, <Текст заголовка>) - задает текст на ярлыке вкладки с указан
ным индексом;
♦ setElideMode(<Режим>) - задает режим обрезки текста на ярлыке вкладки, если он не
помещается в отведенную область (в месте обрезки выводится троеточие). Могут быть
указаны следующие элементы перечисления TextElideMode из модуля QtCore.Qt:
• ElideLeft - текст обрезается слева;
• ElideRight - текст обрезается справа;
• ElideMiddle - текст вырезается посередине;
• ElideNone - текст не обрезается;
♦ tabText (<Индекс>) - возвращает текст на ярлыке вкладки с указанным индексом;
♦ sеtТаЫсоn(<Индекс>, <Значок Qicon>) - устанавливает значок перед текстом на ярлы
ке вкладки с указанным индексом;
♦ seticonSize(<Размеры QSize>) - задает размеры значков, выводящихся на ярлыках
вкладок;
♦ setTabPosition(<Позиция>) - задает местоположение заголовка панели, на котором
выводятся ярлыки вкладок. Моrут быть указаны следующие элементь1 перечисления
TabPosition из класса QТabWidget: North (сверху), South (снизу), West (слева) или East
(справа). Пример:
tab.setTabPosition(QtWidgets.QTabWidget.TabPosition;South)
♦ setTaЬShape (<Форма>) - задает форму углов у ярлыков вкладок. Могут быть указаны
следующие элементы перечисления TabShape из класса QТabWidget: Rounded (скругленная
форма-значение по умолчанmо) или Triangular (треугольная форма);
♦ setTabsClosaЫe(<Флаг>) - если в качестве параметра указано значение True, то после
текста на ярлыке вкладки будет отображена кнопка ее закрытия. При нажатии этой
кнопки генерируется сигнал tabCloseRequested;
♦ setMovaЫe(<Флаг>) - если в качестве параметра указано значение тrue, вкладки можно
перетаскивать мышью за их ярлыки;
♦ setDocurnentMode(<Флаг>) - если в качестве параметра указано значение True, панель не
будет окружена рамкой;
♦ setUsesScrollButtons (<Флаг>) - если в качестве параметра указано значение True, то,
если все ярлыки вкладок не помещаются в заголовке панели, появятся две кнопки, с по
мощью которых можно прокручивать содержимое заголовка. Значение False предписы
вает панели выводить все ярлыки в несколько строк;
♦ setTabBarAutoHide(<Флаг>) - если в качестве параметра указано значение True, и в па
нели присутствует всего одна вкладка (или ни одной), заголовок панели будет скрыт.
Значение False указывает панели всегда отображать заголовок;
♦ sеtТаЬТооlТiр(<Индекс>, <Текст>) - задает текст вспльIВающей подсказки у ярлыка
вкладки с указанным индексом;
468 Часть //. Библиотека PyQt б
♦ setTabWhatsThis(<Индекс>, <Текст>) - задает текст расширенной подсказки у ярлыка
вкладки с указанным индексом;
♦ setCurrentindex(<Индекс>) - делает видимой вкладку с указанным индексом. Метод
является слотом;
♦ currentindex() - возвращает индекс видимой вкладки;
♦ setCurrentWidget(<Компонент>) - делает видимой вкладку с указанным компонентом.
Метод является слотом;
♦ sеtТаЬЕnаЫеd(<Индекс>, <Флаг>) - если вторым параметром передано значение F�lse,
вкладка с указанным индексом станет недоступной. Значение тrue делает вкладку дос
туmюй;
♦ isTabEnaЫed(<Индекс>) - возвращает значение True, если вкладка с указа�rnым индек
сом доступна, и False -в противном случае;
♦ setTabVisiЫe(<Индекс>, <Флаг>) - если вторым параметром передано значение False,'
вкладка с указанным индексом станет невидимой. Значение True делает вкладку види
мой;
♦ isTabVisiЫe(<Индекс>) - возвращает значение True, если вкладка с указанным индек
сом видима, и False - в противном случае;
♦ currentWidget() - возвращает ссьmку на компонент, расположенный на видимой
вкладке;
♦ widget(<Индекс>) - возвращает ссылку на компонент, расположенный на вкладке с ука
занным индексом, или значение None в случае обращения по несуществующему индексу;
♦ indexOf(<Компонент>) - возвращает индекс вкладки, на которой расположен заданный
компонент. Если компонент не найден, возвращается значение -1;
♦ count( ) - возвращает количество вкл�доk. Получить количество вкладок можно также
с помощью функции len() :
print(tab.count(), len(tab))
Класс QTabWidget поддерживает такие сигналы:
♦ currentChanged(<Индекс>) - генерируется при переключении на другую вкладку. Через
параметр внутри обработчика доступен индекс вьmеденной вкладки;
♦ tabBarCl icked(<Индекс>) - генерируется при щелчке на ярлыке вкладки. Через пара
метр внутри обработчика доступен индекс вкладки, на которой был выполнен щелчок,
или значение -1, если щелчок был выполнен на области заголовка панели, не_ занятой
ярлыками;
♦ tabBarDouЫeClicked(<Индeкc>) - генерируется при двойном щелчке на ярлыке вклад
ки. Через параметр внутри обработчика доступен индекс вкладки, на которой бьm
выполнен двойной щелчок, или значение -1, если щелчок бьm выполнен на области за
головка панели, не занятой ярлыками;
♦ tabCloseRequested(<Индекс>) - генерируется при нажатии кнопки закрытия вкладки.
Через параметр внутри обработчика доступен индекс закрываемой вкладки.
Глава 21. Размещение ко1уtпонентов в окнах. Контейнеры 469
21.1 О. Аккордеон
Аккордеон похож на панель с вкладками, только отдельные панели в нем расположены по
вертикали: при перекmочении на какую-либо панель она разворачивается, а развернутая
ранее - сворачивается. Аккордеон представляется классом QТoolBox. Иерархия наследова
ния выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame - QТoolBox
Конструктор класса QToolBox имеет следующий формат:
QToolBox( [parent=None] [, flags=0])
В параметре parent указьшается ссьmка на родительский компонент. Если этот параметр
имеет значение None, и у параметра flags указано значение О, компонент не будет иметь
родителя и получит свое собственное окно. Параметр flags указывает тип создаваемого
окна. Доступные для задания типы рассмотрены в разд. 19.1.1.
Пример кода, создающего аккордеон, представлен в листинге 21.7, а созданный им аккор
деон - на рис. 21.6.
from PyQtб import QtWidgets
import sys
арр = QtWidgets.QApplication(sys .argv)
window. = QtWidgets.QWidget()
window.setWiri.dowТitle("QТoolBox")
window.resize(250, 100)
toolBox = QtWidgets.QТoolBox()
toolBox.additem(QtWidgets.QLabel("Coдepжимoe вкладки 1"), "Вкладка &1")
toolBox.additem(QtWidgets.QLaЬel("Coдepжимoe вкладки 2"), "Вкладка &2")
toolBox .additem(QtWidgets.QLaЬel("Содержимое вкладки З."), "Вкладка &3")
toolBox.setCurrentindex(0)
vbox = QtWidgets.QVBoxLayout()
vbox.addWidget(toolBox)
window.setLayout(vbox)
window.show()
sys.exit(app.exec())
liJ QТoolBox □ х
Вкладка!· . 1
Содер)Кj,\мое вкладки 1
Вкладка�
Вкладка]
Рис. 21.6. Компонент QТoolBox
470 Чарть 11. Библиотека PyQt 6
Класс QToolBox поддерживает следующие методы (здесь приведены толь.ко основные -
полный их список смотрите на странице https://doc.qt.io/qt-6/qtoolbox.html):
♦ additem() - добавляет вкладку в конец контейнера. Метод возвращает индекс добав
ленной вкладки. Форматы метода:
аdditеm(<Компонент>, <Текст ярлыка>)
аdditеm(<Компонент>, <Значок Qicon>, <Текст ярлыка>)
В параметре <Компонент> указывается ссылка на компонент, который будет отображать
ся на вкладке. Чаще всего этот компонент является лишь родителем для других компо
нентов. Параметр <Текст ярлыка> задает текст, который будет отображаться на ярлыке
вкладки. Внутри текста вкладки символ &, указаt1ный перед буквой, задает комбинацmо
клавиш быстрого доступа. Параметр <Значок> указывает значок, который отобразится
перед текстом на ярлыке вкладки;
♦ insertrtem() -добавляет вкладку по указанному индексу и возвращает индекс добав
ленной вкладки. Форматы метода:
insertitem(<Индeкc>, <Компонент>, <Текст ярлыка>)
insertitem(<Индeкc>, <Компонент>, <Значок Qicon>, <Текст заголовка>)
♦ removeitem(<Индeкc>) -удаляет вкладку с указанным индексом, при этом компонент,
который отображался на вкладке, не удаляется;
♦ setitemText(<Индекс>, <Текст заголовка>) - задает текст ярлыка у вкладки с указан
ным индексом;
♦ itemText (<Индекс>) -возвращает текст ярлыка у вкладки с указанным индексом;
♦ setitemicon(<Индeкc>, <Значок Qicon>) - устанавливает значок на ярлыке вкладки
с указанным индексом;
♦ setitemToolTip(<Индeкc>, <Текст>) - задает текст всплывающей подсказки у ярлыка
вкладки с указанным индексом;
♦ set ItemEnaЫed(<Индекс>, <Флаг>) - если вторым параметром передается значение
False, вкладка с указанным в первом параметре индексом станет недоступной. Значение
тrue делает вкладку доступной;
♦ isitemEnaЫed(<Индeкc>) -возвращает значение тrue, если вкладка с указанным индек
сом доступна, и False - в противном случае;
♦ setCurrentindex(<Индекс>) - делает видимой вкладку с указанным индексом. Метод
является слотом;
♦ currentindex() -возвращает индекс видимой вкладки;
♦ setCurrentWidget(<Компонент>) - разворачивает вкладку с указанным компонентом.
Метод является слотом;
♦ currentWidget() - возвращает ссьшку на компонент, расположенный на развернутой
вкладке;
♦ widget(<Индекс>) -возвращает ссьшку на компонент, расположенный на вкладке с ука
занным индексом, или значение None в случае обращения по несуществующему индексу;
♦ indexOf(<Компонент>) -возвращает индекс вкладки, на которой расположен заданный
компонент. Если компонент не найден, возвращается значение -1;
Глава 21. Размещение компонентов в окнах. Контейнеры 471
♦ count() - возвращает количество вкладок. Получить количество вкладок можно также
с помощью функции len() :
print(toolBox.count(), len(toolBox))
При переключении на другую вкладку генерируется сигнал currentChanged(<Индекс>) .
Через параметр внутри обработчика доступен индекс вкладки, на которую бьшо выполнено
переключение.
21.11. Панель с изменяемыми областями
Панель с изменяемыми областями включает ряд областей, каждая из которых содержит
один компонент. На границах между областями располагаются захваты, перемещая которые
с помощью мыши можно менять относительные размеры этих областей. Такая панель реа
лизуется классом QSplitter. Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QFrarne - QSplitter
Конструктор класса QSplitter имеет два формата:
QSplitter([parent=None])
QSplitter(<Opиeнтaция>[, parent=None])
В параметре parent указывается ссьшка на родительский компонент. Если таковой не ука
зан или имеет значение None, компонент будет обладать своим собственным окном. Пара
метр <Ориентация> задает ориентацию расположения областей в виде одного из следующих
элементов перечисления Orientation из модуля QtCore.Qt: Horizontal (горизонтальная -
значение по умолчанию) или Vertical (вертикальная).
Пример использования класса QSplitter показан в листинге 21.8, а результат можно уви
деть на рис. 21.7.
from PyQtб import QtCore, QtWidgets
import sys
арр =_QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QSplitter")
window.resize(250, 200)
splitter = QtWidgets.QSplitter(QtCore.Qt.Orientation.Vertical)
labell = QtWidgets.QLabel("Содержимое компонента 1")
label2 = QtWidgets.QLabel("Coдepжимoe компонента 2")
labell.setFrarneStyle(QtWidgets.QFrarne.Shape.Box 1
QtWidgets.QFrarne.Shadow.Plain)
label2.setFrarneStyle(QtWidgets.QFrarne.Shape.Box 1
QtWidgets.QFrarne.Shadow.Plain)
splitter.addWidget(labell)
splitter.addWidget(label2)
vbox = QtWidgets.QVBoxLayout()
vbox.addWidget(splitter)
window.setLayout(vbox)
window.show()
sys.exit(app.exec())
472 Часть 11. Библиотека PyQt б
liJ QSplitter о х
Содержимое компонента 1
Содержимое компонента 2
Рис. 21.7. Компонент QSplitter
Класс QSplitter поддерживает следующие методы (здесь приведены только основные -
полный их список смотрите на странице https://doc.qt.io/qt-6/qsplitter.html):
♦ addWidget (<Компонент>) - добавляет компонент в конец панели, создавая в ней новую
область;
♦ insertWidget (<Индекс>, <Компонент>) - добавляет компонент по указанному индексу.
Если компонент был добавлен ранее, он будет перемещен по указанному индексу;
♦ setOrientation (<Ориентация>) - задает ориентацию расположения областей. Могут
быть заданы элементы Horizontal (горизонтальная) или vertical (вертикальная) пере
числения Orientation из модуля QtCore.Qt;
♦ setHandleWidth (<Ширина>) - задает толщину захвата;
♦ saveState () - возвращает объект класса QByteArray с размерами всех областей. Эти
данные можно сохранить (например, в файл), а затем восстановить с помощью метода
restoreState ();
♦ restoreState (<Объект QByteArray>) - восстанавливает размеры областей из объекта
класса QByteArray, возвращенного методом savestate ();
♦ setChildrenCollapsiЫe (<Флаг>) - если в параметре указано значение False, пользова
тель не сможет уменьшить размеры всех областей до нуля. По умолчанию размер может
быть нулевым, даже если для какого-либо компонента установлены минимальные раз
меры;
♦ setCollapsiЫe (<Индекс>, <Флаг>) - значение False в параметре <Флаг> запрещает
уменьшение размеров до нуля у компонента с указанным индексом;
♦ setOpaqueResize (<Флаг>) - если в качестве параметра указано значение False, размеры
областей изменятся только после окончания перемещения захвата и отпускания кнопки
мыши. В процессе. перемещения мыши вместе с ней будет перемещаться специальный
компонент в виде линии;
♦ setStretchFactor (<Индекс>, <Фактор>) - задает целочисленный фактор растяжения
для компонента с указанным индексом;
♦ setSizes (<Список>) - задает размеры всех областей. У панели с горизонтальной ориен
тацией указывается список со значениями ширины каждой области, у панели с верти
кальной ориентацией - список со значениями высоты каждой области;
Глава 21. Размещение компонентов в окнах. Контейнеры 473
♦ sizes() - возвращает список с размерами (шириной или высотой):
print(splitter .sizes()) # Результат: (308, 15]
♦ count() - возвращает количество областей. Получить количество областей можно так
же с помощью функции len() :
print(splitter.count(), len(splitter))
♦ widget(<Индекс>) - возвращает ссылку на компонент, расположенный по указанному
индексу, или значение N�ne в случае обращения по несуществующему индексу;
♦ indexOf(<Компонент>) - возвращает индекс области, в которой расположен заданный
компонент. Если таковой не найден, возвращается значение -1.
При перемещении какого-либо из захватов генерируется сигнал splitterMoved(<Пoзиция>,
<Индекс>). Через первый параметр внутри обработчика доступна новая позиция переме
щенного захвата, а через второй параметр - индекс этого захвата.
21.12. Прокручиваемая панель
Панель с полосами прокрутки (которые выводятся автоматически, если содержимое панели
не помещается в ней) представляется классом QScrollArea. Иерархия наследования выгля
.'IИТ так:
,QObject, QPaintDevice) - QWidget - QFrame -
QAЬstractScrollArea - QScrollArea
Конструктор класса QScrollArea имеет следующий формат:
:;)Scroll.Area([<Родитель>])
Класс QScrollArea поддерживает следующие методы (здесь приведены только основные -
полный их список смотрите на странице https://doc.qt.io/qt-6/qscrollarea.html):
♦ setWidget(<Компонент>) - помещает заданный компонент в панель-;
♦ setWidgetResizaЫe(<Флаг>) - если в качестве параметра указано значение True, при
изменении размеров панели будут изменяться и размеры компонента. Значение False
запрещает изменение размеров компонента;
♦ setAlignrnent(<Выравнивание>) - задает местоположение компонента внутри панели,
когда размеры панели больше размеров компонента, в виде одного из элементов пере
числения AlignrnentFlag из модуля QtCore .Qt (см.разд. 21.2):
scrollArea.setAlignrnent(QtCore .Qt.AlignrnentFlag.AlignCenter)
♦ ensureVisiЫeC<X>, <У>[, xМargin=SOJ[, yMargin=SOJ) - прокручивает панель таким
образом, чтобы точка с координатами (<Х>, <У>) оказалась в видимой области. Пара
метры xМargin и yМargi_n задают отступы соответственно по горизонтали и вертикали
между границами панели и видимой области;
♦ ensureWidgetVisiЫe(<Компонент>[, xМargin=SO][, yМargin=SO]) - прокручивает па
нель таким образом, чтобы <Компонент> оказался в видимой области. Параметры xМargin
и yMargin задают отступы соответственно по горизонтали и вертикали между границами
панели и видимой области;
♦ widget() - возвращает ссьmку на компонент, который расположен внутри панели, или
значение None, если панель пуста;
474 Часть 11. Библиотека PyQt 6
♦ takeWidget () - удаляет компонент из панели и возвращает ссьшку на него. Сам компо-
нент не удаляется.
Класс QScrollArea наследует следующие методы из класса QAЬstractScrollArea (здесь
перечислены толъко основные - полный их список смотрите на странице https://doc.qt.io/
qt-6/qabstractscrollarea.html):
♦ horizontalScrollBar () - возвращает ссьmку на горизонтальную полосу прокрутки
(объект класса QScrollBar);
♦ verticalScrollBar () - возвращает ссылку на вертикальную полосу прокрутки (объект
класса QScrollBar);
♦ setHorizontalScrollBarPolicy (<Режим>) - устанавливает режим отображения горизон
тальной полосы прокрутки;
♦ setVerticalScrollBarPolicy (<Режим>) - устанавливает режим отображения вертикаль
ной полосы прокрутки.
В параметре <Режим> могут быть указаны следующие элементы перечисления
ScrollBarPolicy ИЗ модуля QtCore. Qt:
• ScrollBarAsNeeded - полоса прокрутки отображается только в том случае, если раз
меры компонента больше размеров панели;
• ScrollBarAlwaysOff - полоса прокрутки никогда не отображается;
• ScrollBarAlwaysOn - полоса прокрутки отображается всегда.
ГЛАВА 22
Основные компоненты
Практически все основные компоненты (за искmочением QWebEngineView) определены
в модуле QtWidgets, наследуют класс QWidget и, соответственно, поддерживают все методы
этого класса (бьmи описаны в главах 19 и 20). Если компонент не имеет родителя, он будет
выводиться в собственном окне.
22.1. Надпись
Надпись применяется для вывода подсказки пользоватешо, информирования пользователя
о ходе выполнения операции, назначении клавиш быстрого доступа и т. п. Надпись может
выводить обычный текст, текст, отформатированный НТМL-тегами или тегами Markdown.
Надпись реализуется классом QLabel. Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame - QLabel
Конструктор класса QLabel имеет два формата:
:)Label( [parent=None] [, flags=O])
:)Label(<Текст>[, parent=None] [, flags=OJ)
В параметре parent указывается ссьmка на родительскиf{ компонент. Если он не указан или
имеет значение None, компонент будет обладать своим собственным окном, тип которого
можно задать с помощью параметра flags. Параметр <Текст> позволяет задать текст, кото
рый будет отображен на надписи. Пример:
label = QtWidgets .QLabel("Teкcт надписи", flags=QtCore.Qt.WindowТype.Window)
label.resize(ЗOO, 50)
label.show()
Класс QLabel поддерживает следующие основные методы (полный их список смотрите на
странице https://doc.qt.io/qt-6/qlabel.html):
♦ setтext (<Текст>) - задает текст, который будет отображен на надnиси. Можно указать
как обычный текст, так и содержащий СSS-форматирование текст в формате НТМL.
Пример:
label.setText("Teкcт <Ь>полужирный</Ь>")
Перевод строки в простом тексте осуществляется с помощью символа \n, а в тексте
в формате НТМL - с помощью тега <br>:
label.setText("Teкcт\nнa двух строках")
476 Часть 11. Библиотека PyQt б
Внутри текста символ &, указа1rnый перед буквой или цифрой, задает комбинацию кла
виш быстрого доступа. В этом случае буква, перед которой указан символ &, будет -
в качестве подсказки пользователю - подчеркнута. При одновременном нажатии кла
виши <Alt> и подчеркнутой буквы компонент, ссылка. на который передана в метод
setBuddy(), окажется в фокусе ввода. Чтобы вывести сам символ &, необходимо его
удвоить. Если надпись не связана с другим компонентом, символ & выводится в составе
текста. Пример:
label = QtWidgets.QLabel("&Пapoль")
lineEdit = QtWidgets.QLineEdit()
label.setBuddy(lineEdit)
Метод является слотом;
♦ setNwn(<Чиcлo>) - выводит в надписи заданное целое или вещественное число. Метод
является слотом;
♦ setwordWrap(<Флаг>) - если в параметре указано значение True, текст может перено
ситься на другую строку. По умолчанию перенос строк не осуществляется;
♦ text() - возвращает текст надписи;
♦ setTextFormat(<Режим>) - задает режим отображения текста. Могут быть указаны сле
дующие элементы перечисления TextFormat из модуля QtCore.Qt:
• PlainText - простой текст;
• RichText - текст, отформатированный тегами НТМL;
• Autoтext - автоматическое определение (режим по умолчанию). Если текст содер
жит НТМL-теги, то используется режим Richтext, в. противном случае - режим
PlainText;
• MarkdownText - текст, отформатированный тегами Markdown;
♦ setAlignment(<Режим>) - задает режим выравнивания текста внутри надписи (допусти
мые значения рассмотрены в разд. 21.2):
label.setAlignment(QtCore.Qt.AlignrnentFlag.AlignRight 1
QtCore.Qt .Alignrnent.Flag.AlignBottom)
♦ setOpenExternalLinks(<Флаг>) - если в качестве параметра указано значение True, теги
<а>, присутствующие в тексте, будут преобразованы в гиперссылки:
label.setText('<a href="https://www.google.ru/">Этo гиперссылка</а>')
label.setOpenExternalLinks(True)
♦ setBuddy(<Компонент>) - связывает надпись с другим компонентом. В этом случае
в тексте надписи можно задавать клавиши быстрого доступа, указав символ & перед бук
вой или цифрой;
♦ setPixmap(<Изображение QPixmap>) - позволяет вьmести изображение на надпись:
label.setPixmap(QtGui.QPixmap("picture. jpg"))
Метод является слотом;
♦ setPicture (<Рисунок QPicture>) - выводит заданный рисунок. Метод является слотом;
♦ setScaledContents(<Флаг>) - если в параметре указано значение тrue, то при измене
нии размеров надписи размер содержимого также будет изменяться. По умолчанию
изменение размеров содержимого не осуществляется;
Глава 22. Основные компоненты 477
♦ setMargin(<Отступ>) - задает отступы от границ компонента до его содержимого;
♦ setindent(<Отступ>) - задает отступ от рамки до текста надписи в зависимости от зна
чения выравнивания. Если вырав_нивание производится по левой стороне, то задает от
ступ слева, если по правой стороне, то справа;
♦ clear() - удаляет содержимое надписи. Метод является слотом;
♦ setтextinteractionFlags(<Режим>) - задает режим взаимодействия пользователя с тек
стом надписи. Можно указать следующие элементы (или их комбинацию через опера
тор 1) перечисления TextinteractionFlag из модуля QtCore. Qt:
• NoTextinteraction - пользователь не может взаимодействовать с текстом надписи;
• TextSelectaЫeByMouse - текст можно выделить мышью;
• TextSelectaЫeByKeyboard - текст можно выделить с помощью клавиш на клавиату
ре. В.нутри надписи будет отображен текстовый курсор;
• LinksAccessiЫeByМouse - на гиперссылках, присутствующих в тексте надписи,
можно щелкать мышью;
• LinksAccessiЬleByKeyboard - с гиперссылками, присутствующими в тексте надписи,
допускается взаимодействовать с помощью клавиатуры: перемещаться между гипер
ссылками - цажатиями клавиши <ТаЬ>, а переходить по гиперссылке - по нажатии
клавиши <Enter>;
• TextEditaЫe - текст надписи можно редактировать;
• TextEditorinteraction - комбинация TextSelectaЬleByMouse
TextSelectaЬleByKeyboard I TextEditaЫe;
• TextBrowserinteraction - комбинация TextSelectaЬleByMouse
LinksAccessiЬleByМouse I LinksAccessiЬleByKeyboard;
♦ setSelection(<Индeкc>, <Дпина>) - выделяет фрагмент длиной <Дпина>, начиная с по
зиции <Индекс>;
♦ selectionStart() - возвращает начальный индекс выделенного фрагмента или значе
ние -1, если ничего не выделено;
♦ selectedтext() :.._ возвращает выделенный текст или пустую строку, если ничего не вы
делено;
♦ hasSelectedText() - возвращает значение True, если фрагмент текста надписи выделен,
и False - в противном случае.
Класс QLabel поддерживает следующие сигналы:
♦ linkActi vated(<Интернет-адрес>) - генерируется при переходе по гиперссылке. Через
параметр внутри обработчика доступен целевой интернет-адрес, заданный в виде строки;
♦ linkHovered (<Интернет-адрес>) - генерируется при наведении курсора мыши на гипер
ссылку. Через параметр внутри обработчика доступен интернет-адрес гиперссьшки в виде
строки или пустая·строка.
22.2. Кнопка
Кнопка реализуется классом QPushВutton. Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QAЬstractButton - QPushButton
478 Часть 11. Библиотека PyQt 6
Конструктор класса QPushButton имеет три формата:
QPushВutton([parent=None])
QPushButton(<Teкcт>[, parent=None])
QPushButton(<Знaчoк Qicon>, <Текст>[, parent=None])
В параметре parent указывается ссылка на родительский компонент. Если таковой не задан
или имеет значение None, компонент будет обладать своим собственным окном. Параметр
<Текст> задает текст, который отобразится на кнопке, а параметр <Значок> - значок, выво
димый перед текстом.
Класс QPushButton наследует следующие методы из класса QAЬstractвutton (здесь приведе
ны только основные - полный их список смотрите на странице https://doc.qt.io/qt-6/
qabstractbutton.html):
♦ setтext(<Текст>) - задает текст, который будет отображен на кнопке. Внутри текста
символ &, указанный перед буквой или цифрой, задает комбинацию клавиш быстрого
доступа. В этом случае буква, перед которой указан символ &, будет - в качестве под
сказки пользоватето - подчеркнута. Одновременное нажатие клавиши <Alt> и под
черкнутой буквы приведет к нажатmо этой кнопки. Чтобы вывести сам символ &, необ
ходимо его удвоить;
♦ text() - возвращает текст, отображаемый на кнопке;
♦ setShortcut(<Клавиша QKeySequence>) - задает клавишу быстрого доступа:
button.setShortcut("Alt+B")
button.setShortcut(QtGui.QKeySeque,nce.mnemonic("&B"))
button.setShortcut(QtGui.QKeySequence("Alt+B"))
button.setShortcut(QtGui.QKeySequence(QtCore.Qt.Key.Key_FS))
♦ seticon(<Значок Qicon>) - вставляет значок перед текстом кнопки;
♦ seticonSize(<Размеры QSize>) - задает размеры значка. Метод является слотом;
♦ setAutoRepeat(<Флаг>) - если в качестве параметра указано значение True, сигнал
clicked будет периодически генерироваться, пока кно�а находится в нажатом состоя
нии;
♦ animateClick() - имитирует нажатие пользователем кнопки с анимацией. После нажа
тия кнопка находится в этом состоянии в течении 100 миллисекунд. Метод является сло
том;
♦ click() � имитирует нажатие кнопки без анимации. Метод является слотом;
♦ setCheckaЫe(<Флаг>) - если в качестве параме_тра указано значение тrue,. то кнопка
является перекточателем, который может находиться в двух состояниях: установленном
и неустановленном;
♦ setChecked(<Флaг>) - если в качестве параметра указано значение True, кнопка
перекточатель будет находиться в установленном состоянии. Метод является слотом;
♦ isChecked() - возвращает значение тrue, если кнопка-перекточатель находится в уста
новленном состоянии, и False - в противном случае;
♦ toggle() - перекточает кнопку-перекточатель. _Метод является слотом;
♦ setAutoExclusive(<Флаг>) - если в качестве параметра указано значение True, внутри
контейнера может быть установлена только одна кнопка-перекточатель;
Глава 22. Основные компоненты 479
♦ setDown(<Флаг>) - если в качестве параметра указано значение True, кнопка будет на
ходиться в нажатом состоянии;
♦ isDown() - возвращает значение True, если кнопка находится в нажатом состоянии,
и False - в противном случае.
Класс QAЬstractвutton поддерживает следующие сигналы:
♦ pressed() - генерируется при нажатии кнопки;
♦ released() - генерируется при отпускании ранее нажатой кнопки;
♦ clicked (<Состояние>) - генерируется при нажатии и отпускании кнопки. Передавае
мый обработчику параметр имеет значение тrue, если кнопка-переключатель установле
на, и False, если она сброшена или это обычная кнопка, а не переключатель;
♦ toggled(<Состояние>) - генерируется при изменении состояния кнопки-переключателя.
Через параметр доступно новое состояние кнопки.
Класс QPushButton· определяет свои собственные методы (здесь приведены только основ
ные - полный их список смотрите на странице https://doc.qt.io/qt-6/qpushbutton.html):
♦ setFlat(<Флаг>) - если в качестве параметра указано значение True, кнопка будет ото
бражаться без рамки;
♦ setAutoDefault(<Флаг>) - если в качестве параметра указано значение True, кнопка
может быть нажата с помощью клавиши <Enter> при ,условии, что она находится в фо
кусе. По умолчанию нажать кнопку позволяет только клавиша <Пробел>. В диалоговых
окнах у всех кнопок по умолчанию указано значение тrue, а в остальных окнах - зна
чение False;
♦ setDefault(<Флаг>) - задает кнопку по умолчанию. Эта кнопка �ожет быть нажата
с помощью клавиши <Enter>, когда фокус ввода установлен на другой компонент, -
например, на текстовое поле. Метод работает только в диалоговых окнах;
♦ setMenu(<Меню QMenu>) - устанавливает всплывающее меню, которое будет отображать
ся при нажатии кнопки;
♦ menu() - возвращает ссылку на вспльIВающее меню или значение None;
♦ showМenu() - отображает вспльIВающее меню. Метод является слотом.
22.3. Переключатель
ПереJ(JПОчатели всегда компонуются группами. Для объединения переключателей в группу
можно воспользоваться компонентом QGroupBox (см разд. 21. 7) или классом QButtonGroup.
Переключатель реализуется классом QRadioButton. Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QAЬstractButton - QRadioButton
Конструктор класса QRadioButton имеет два формата:
QRadioButton([parent=<None>])
QRadioButton(<Teкcт>[, parent=None])
Класс QRadioButton наследует все методы класса QAЬstractButton (см. разд. 22.2). Устано
вить или сбросить переключатель позволяет метод setChecked(<Флаг>), а проверить его те
кущее состояние можно с помощью метода isChecked(). Отследить изменение состояния
480 Часть 11. Библиотека PyQt 6
можно в обработчике сигнала toggled(<Состояние>), в параметре которого передается
логическая величина, указывающая новое состояние переключателя.
22.4. Флажок
Флажок может находиться в нескольких состояниях: установленном, сброшенном и проме
жуточном (неопределенном) - последнее состояние может быть запрещено программно.
Флажок реализуется с помощью класса QCheckВox. Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QAЬstractButton - QCheckBox
Конструктор класса QCheckBox имеет два формата:
QCheckBox( [parent=None] )
QCheckВox(<Текст> [, parent=None])
Класс QCheckBox наследует все методы класса QAЬstractвutton (см. разд. 22.2), а также до
бавляет несколько новых:
♦ setCheckState(<Состояние>) - задает состояние флажка. Могут быть указаны следую
щие элементы перечисления Checkstate из модуля QtCore.Qt:
• unchecked - флажок сброшен;
• PartiallyChecked -,- флажок находится в промежуточном состоянии;
• Checked - флажок установлен;
♦ checkState() - возвращает текущее состояние флажка;
♦ setтristate( [<Флаг>=Тruе] ) - если в качестве параметра указано· значение True (значе
ние по умолчанию), флажок может находиться во всех трех состояниях. По умолчанию
поддерживаются только установленное·и сброшенное состояния;
♦ isTristate() - возвращает значение True, если флажок поддерживает три состояния.
и False - если только два.
Чтобы перехватить изменение состояния флажка, следует назначить обработчик сигна..1а
stateChanged(<Состояние>). Через параметр внутри обработчика доступно новое состояние
флажка, заданное в виде целого числа: О (сброшенное), 1 (промежуточное) или 2 (установ
ленное).
Если используется флажок, поддерживающий только два состояния, установить или сбро
сить его позволяет метод setChecked(), а проверить текущее состояние - метод isChecked
Обработать изменение состояния можно в обработчике сигнала toggled(<Состояние>
параметр которого имеет логический тип.
22.5. Поле ввода
Поле ввода самостоятельно поддерживает технологию drag & drop, стандартные комбина
ции клавиш быстрого доступа, работу с буфером обмена и многое другое. Оно реализуется
классом QLineEdit. Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QLineEdit
Конструктор класса QLineEdit имеет два формата:
QLineEdit( [parent=None])
QLineEdit(<Teкcт>[, parent=None])
Глава 22. Основные компоненты 481
В параметре parent указывается ссылка на родительский компонент. Если родитель не ука
зан или имеет значение None, компонент будет обладать своим собственным окном. Пара
метр <Текст> позволяет задать текст, который будет отображен в поле ввода.
22.5.1. Основные методы и сигналы
Класс QLineEdit поддерживает следующие методы (полный их список смотрите на страни
це https://doc.qt.io/qt-6/qlineedit.html):
♦ setтext(<Текст>) - помещает указанный текст в поле ввода. Метод является слотом;
♦ insert(<Текст>) - вставляет текст в текущую позицmо текстового курсора. Если в поле
ввода был выделен фрагмент, он будет удален;
♦ text() - возвращает текст, содержащийся в поле ввода;
♦ displayТext() - возвращает текст, который видит пользователь. Результат зависит от
режима отображения, заданного с помощью метода setEchoMode () (например, в режиме
Password строка будет состоять из звездочек);
♦ clear () - удаляет весь текст из поля. Метод является слотом;
♦ backspace() - удаляет выделенный фрагмент. Если выделенного фрагмента нет, удаля
ет символ, стоящий слева от текстового курсора;
♦ del () - удаляет выделенный фрагмент. Если выделенного фрагмента нет, удаляет сим
вол, стоящий справа от текстового курсора;
♦ setSelection(<Индeкc>, <Длина>) - выделяет фрагмент длиной <Длина>, начиная с по
зиции <Индекс>. Во втором параметре можно указать отрицательное значение;
♦ selectedText() - возвращает выделенный фрагмент или пустую строку, если ничего не
выделено;
♦ selectAll() - выделяет весь текст в поле. Метод является слотом;
♦ selectionStart(·) - возвращает начальный индекс выделенного фрагмента или значе
ние -1, если ничего не выделено;
♦ selectionEnd() - возвращает индекс символа, следующего сразу за последним симво
лом выделенного фрагмента, или значение -1, если ничего не выделено;
♦ hasSelectedText() --: возвращает значение тrue, если поле ввода содержит выделенный
фрагмент, и False - в противном случае;
♦ deselect() - снимает выделение;
♦ isModified () - возвращает True, если текст в поле был изменен пользователем,
и False - в противном случае. Отметьте, что вызов метода setтext() помечает поле как
неизмененное;
♦ setModified(<Флaг>) - если передано значение True, поле ввода помечается как изме
ненное, если False - как неизмененное;
♦ setEchoMode(<Режим>) - задает режим отображения текста. Могут быть указаны сле
дующие элементы перечисления EchoMode из класса QLineEdit:
• Normal - показывать вводимые символы;
• NoEcho - не показывать вводимые символы;
482 Часть 11. Библиотека PyQt б
• Password - вместо символов выводить звездочки ( * );
• PasswordEchoOnEdit - показывать символы при вводе, а после потери фокуса вместо
них отображать звездочки;
♦ setCompleter(<Список>) - задает список вариантов значений для автозавершения.
В качестве параметра указывается объект класса QCompleter. Пример:
lineEdit = QtWidgets.QLineEdit()
arr = ["кадр", "каменный", "камень", "камера"]
completer = QtWidgets.QCompleter(arr, parent=window)
lineEdit.setCompleter(completer)
♦ setReadOnly(<Флaг>) - если в качестве параметра указано значение True, поле будет
доступно только для чтения;
♦ isReadOnly() - возвращает значение True, если поле доступно только для чтения,
и False - в противном случае;
♦ setAlignment(<Выравнивание AlignmentFlag>) - задает выравнивание текста внутри
поля;
♦ setMaxLength(<Количество>) - задает максимальную длину вводимого значения в сим
волах;
♦ setFrame(<Флаг>) - если в качестве параметра указано значение False, поле будет ото
бражаться без рамки;
♦ setDragEnaЫed(<Флаг>) - если в качестве параметра указано значение тrue, режим
перетаскивания текста из текстового поля с помощью мыши будет включен. По умолча
нию поле ввода только принимает перетаскиваемый текст;
♦ setPlaceholderText(<Текст>) - задает текст подсказки, который будет выводиться не
посредственно в поле ввода, когда оно не содержит значения и не имеет фокуса ввода;
♦ setTextMargins() - задает величины отступов от границ компонента до находящегося
в нем текста. Форматы метода:
setTextMargins(<Cлeвa>, <Сверху>, <Справа>, <Снизу>)
setTextMargins(<Oтcтyпы QMargins>)
♦ setCursorPosition(<Индекс>) - задает положение текстового курсора;
♦ cursorPosition() - возвращает текущее положение текстового курсора;
♦ cursorForward(<Флaг>[, steps=l]) - перемещает текстовый курсор вперед на указан
ное во втором параметре количество символов. Если в первом параметре указано значе
ние тrue, выполняется выделение фрагмента;
♦ cursorBackward (<Флаг> [, steps=l J ) - перемещает текстовый курсор назад на указан
ное во втором параметре количество символов. Если в первом пар_аметре указано значе
ние тrue, выполняется выделение фрагмента;
♦ cursorWordForward(<Флaг>) - перемещает текстовый курсор вперед на одно слово. Если
в параметре указано значение тrue, выполняется выделение фрагмента;
♦ cursorwordВackward(<Флаг>) _:__ перемещает текстовый курсор назад на одно слово. Если
в параметре указано значение True, выполняется выделение фрагмента;
♦ home(<Флаг>) - перемещает текстовый курсор в начало поля. Если в параметре указано
значение тrue, выполняется выделение фрагмента;
Глава 22. Основные компоненты 483
♦ end (<Флаг>) - перемещает текстовый курсор в конец поля. Если в параметре указано
значение тrue, выполняется выделение фрагмента;
♦ cut () - вырезает выделенный текст в буфер обмена при условии, что есть выделенный
фрагмент и используется режим Normal. Метод является слотом;
♦ сору () - копирует выделенный текст в буфер обмена при условии, что есть выделен
ный фрагмент и используется режим Normal. Метод является слотом;
♦ paste () - вставляет текст из буфера обмена в текущую позицию текстового курсора
при условии, что поле доступно для редактирования. Метод является слотом;
♦ undo () - отменяет последнюю операцию ввода пользователем при условии, что отмена
возможна. Метод является слотом;
♦ redo () - повторяет последнюю отмененную операцию ввода пользователем, если это
возможно. Метод является слотом;
♦ isUndoAvailaЫe () - возвращает значение True, если можно отменить последнюю опе
рацию ввода, и False - в противном случае;
♦ isRedoAvailaЫe () - возвращает значение True, если можно повторить последнюю от
мененную операцию ввода, и False - в противном случае;
♦ createStandardContextMenu () - создает стандартное контекстное меню, которое ото
бражается при щелчке правой кнопкой мыши в текстовом поле. Чтобы изменить стан
дартное меню, следует создать класс, производный от QLineEdit, и переопределить в нем
метод contextMenuEvent (self., <event>). Внутри этого метода можно создать свое соб
ственное меню или добавить новый пункт в стандартное меню;
♦ setClearвuttonEnaЫed (<Флаг>) - �ели передано тrue, в правой части непустого поля
будет выводиться кнопка, нажатием которой можно очистить это поле, если False,
кнопка очистки выводиться не будет.
Класс QLineEdit поддерживает следующие сигналь�:
♦ cursorPositionChanged (<Старая позиция>, <Новая позиция>) - генерируется при пере
мещении текстового курсора. Внутри обработчика через первый параметр доступна ста
рая позиция курсора, а через второй параметр - новая позиция. Оба параметра являют
ся целочисленными;
♦ editingFinished () - генерируется при нажатии клавиши <Enter> или потере полем
фокуса ввода;
♦ inputRej ected () - генерируется, если операция ввода, выполненная пользователем,
отвергнута полем ввода. Это может случиться, например, при попытке ввести значение
с длиной большей, чем задана вызовом метода setMaxLength ();
♦ returnPressed () - генерируется при нажатии клавиши <Enter>;
♦ selectionChanged () - генерируется при изменении выделения;
♦ textChanged (<Новый текст>) - генерируется при изменении текста внутри поля пользо
вателем или программно. Внутри обработчика через параметр доступен новый текст
в виде строки;
♦ textEdited (<Новый текст>) - генерируется при изменении текста внутри поля пользо
вателем. При задании текста вызовом метода setтext () не генерируется. Внутри обра
ботчика через параметр доступен новый текст в виде строки.
484 Часть 1/. Библиотека PyQt б
22.5.2. Ввод данных по маске
С помощью метода setinputMask(<Мacкa>) можно указать маску, которой должно соответ
ствовать заносимое пользователем значение. Маска указывается в виде строки следующего
формата:
"<Последовательность символов>[;<Символ-заполнитель>]"
В первом параметре указывается комбинация из следующих специальных символов:
♦ 9- обязательна цифра от о до 9;
♦ о- разрешена, но не обязательна цифра от о до 9;
♦ о- обязательна цифра от 1 до 9;
♦ d - разрешена, но не обязательна цифра от 1 до 9;
♦ в- обязательна цифра о или 1;
♦ ь- разрешена, но не обязательна цифра о или 1;
♦ н- обязателен шестнадцатеричный символ (0-9, A-F, a-f);
♦ h- разрешен, но не обязателен шестнадцатеричный символ (0-9, A-F, a-f);
♦ # - разрешена, но не обязательна цифра, знак «плюс» или «минус»;
♦ А- обязательна буква в любом регистре;
♦ а- разрешена, но не обязательна буква;
♦ N- обязательна буква в любом регистре или цифра _от о до 9;
♦ n - разрешена, но не обязательна буква или цифра от о до 9;
♦ х - обязателен любой непробельный символ;
♦ х - разрешен, но не обязателен любой непробельный символ;
♦ >- все последующие буквы переводятся в верхний регистр;
♦ <- все последующие буквы переводятся в нижний регистр;
♦ ! - отключает изменение регистра;
♦ \ - используется для отмены действия перечисленных ранее спецсимволов.
В необязательном параметре <Символ-заполнитель> можно указать символ, который будет
отображаться в поле, обозначая место ввода. Если параметр не указан, заполнителем будет
служить пробел.
Все остальные символы трактуются как есть.
Примеры:
lineEdit.setinputMask("Дaтa: 99.В9 .9999;_") # Дата: ____
lineEdit.setinputMask("Дaтa: 99.В9 .9999;#") # Дата: ##.##.####
lineEdit.setinputMask("Дaтa: 99.В9.9999 г.") # Дата: г.
Проверить соответствие введенных данных маске позволяет метод hasAcceptaЫeinput ().
Если данные соответствуют маске, метод возвращает значение True, а в противном слу
чае - False.
Глава 22. Основные компоненты 485
22.5.3. Контроль ввода с помощью валидаторов
Валидатор - механизм, проверяющий соответствие введенного в поле значения заданным
правилам.
Валидатор у поля ввода задается методом setValidator(<Валидатор>). В качестве параметра
указывается объект класса, производного от класса QValidator из модуля QtGui. Существу
ют следующие стандартные классы валидаторов:
♦ QintValidator - допускает ввод только целых чисел. Функциональность класса зависит
от настройки локали. Форматы конструктора:
QintValidator([parent=None])
QintValidator(<Минимaльнoe значение>, <Максимальное значение>[,
parent=None])
Пример ограничения ввода диапазоном целых чисел от О до 100:
lineEdit.setValidator(QtGui.QintValidator(0, 100, parent=window))
♦ QDouЫeValidator - допускает ввод только вещественных чисел. Функциональность
класса зависит от настройки локали. Форматы конструктора:
QDouЬleValidator([parent=None])
QDоuЫеVаlidаtоr(<Минимальное значение>, <Максимальное значение>,
<Количество цифр после точки>[, parent=None])
Пример ограничения ввода диапазоном вещественных чисел от о. о до 100. о и двумя
цифрами после десятичной точки:
lineEdit.setValidator(QtGui.QDouЫeValidator(0.0, 100.0, 2, parent=window))
Чтобы позволить вводить числа в экспоненциальной форме, необходимо передать в ме
тод setNotation(<Tип записи>) элемент ScientificNotation перечисления Notation из
класса QDouЬleValidator. Если передать методу элемент StandardNotation того же пере
числения, будет разрешено вводить числа только в десятичной форме. Пример:
validator = QtGui.QDouЬleValidator(0.0, 100.0, 2, parent=window)
validator.setNotation(QtGui.QDouЬleValidator.Notation.StandardNotation)
lineEdit.setValidator(validator)
♦ QRegularExpressionValidator - позволяет проверить данные на соответствие заданному
регулярному выражению. Форматы конструктора:
QRegularExpressionValidator([parent=None])
QRegularExpressionValidator(<Peгyляpнoe выражение>[, parent=None])
Регулярное выражение указывается в виде объекта класса QRegularExpression из модуля
QtCor�. Пример ввода только цифр от О до 9:
validator = QtGui.QRegularExpressionValidator(
QtCore.QRegularExpression("[0-9]+"), parent=window)
lineEdit.setValidator(validator)
Обратите внимание, что здесь производится проверка полного соответствия шаблону,
поэтому символы ли$ явным образом указывать не нужно.
Проверить корректность введенных данных позволяет метод hasAcceptaЬleinput(). Если
данные корректны, метод. возвращает значение True, а в противном случае - False.
486 Часть 11. Библиотека PyQt 6
22.6. Область редактирования
Область редактирования предназначена для ввода и редактирования обычного текста, тек
ста в формате НТМL или Maгkdown. Она изначально поддерживает технологию drag &
drop, стандартные комбинации клавиш, работу с буфером обмена и многое другое.
Область редактирования реализуется с помощью класса QTextEdit. Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QFrarne -
QAЬstractScrollArea - QТextEdit
Конструктор класса QTextEdit имеет два формата вызова:
QТextEdit( [parent=None])
QТextEdit(<Teкcт>[, parent=None])
В параметре parent указывается ссылка на родительский компонент. Если параметр не ука
зан или имеет значение None, компонент будет обладать своим собственным окном. Пара
метр <Текст> позволяет задать текст в формате НТМL, который будет отображен в области
редактирования.
ПРИМЕЧАНИЕ
Если помержка HTML не нужна, то следует воспользоваться классом QPlainтextEdit,
который оптимизирован для работы с простым текстом большого объема.
22.6.1. Основные методы и сигналы
Класс QTextEdit поддерживает следующие основные методы (полный их список смотрите
на странице https://doc.qt.io/qt-6/qtextedit.html):
♦ setтext(<Текст>) � помещает указанный текст в область редактирования. Текст может
быть простым или в формате НТМL. Метод является слотом;
♦ setPlainText(<Текст>) - помещает в область редактирования простой текст. Метод
является слотом;
♦ setHtml (<Текст>) - помещает в область редактирования текст в формате HTML. Метод
является слотом;
♦ setMarkdown (<Текст>) - помещает в область редактирования текст в формате Maгkdown.
Метод является слотом;
♦ insertPlainText (<Текст>) - вставляет простой текст в текущую позицию текстового
курсора. iЕспи в области редактирования был выделен фрагмент, он будет удален. Метод
является слотом;
♦ insertHtml(<Текст>) -вставляет текст в формате НТМL в текущую позицию текстово
го курсора. Если в области был выделен фрагмент, он будет удален. Метод является сло
том;
♦ append (<Текст>) - добавляет новый абзац с указанным текстом в формате НТМL в ко
нец области редактирования. Метод является слотом;
♦ setDocurnentTitle(<Текст>) -задает текст заголовка документа (в теге <title>);
♦ docurnentTitle () -возвращает текст заголовка (из тега <title>);
Глава 22. Основные компоненты 487
♦ toPlainText() - возвращает содержимое области редактирования в виде простого текста;
♦ toHtml() - возвращает текст в формате НТМL;
♦ toMarkdown() - возвращает текст в формате Markdown;
♦ clear() - удаляет весь текст из области. Метод является слотом;
♦ selectAll() - выделяет весь текст в области. Метод является слотом;
♦ zoomin( [range=l]) - увеличивает размер шрифта на заданное в параметре range коли
чество пунктов. Метод является слотом;
♦ zoomOut( [range=l]) - уменьшает размер шрифта на заданное в параметре range коли
чество пунктов. Метод является слотом;
♦ cut() - вырезает выделенный текст в буфер обмена при условии, что есть выделенный
фрагмент. Метод является слотом;
♦ сору() - копирует выделенный текст в буфер обмена при условии, что есть выделен
ный фрагмент. Метод является слотом;
♦ paste() - вставляет текст из буфера обмена в текущую позицию текстового курсора
при условии, что область доступна для редактирования. Метод является слотом;
♦ canPaste() - возвращает True, если из буфера обмена можно вставить текст, и False -
в противном случае;
♦ setAcceptRichText(<Флаг>) - если в качестве параметра указано значение True, в об
ласть редактирования можно будет ввести, вставить из буфера обмена или перетащить
текст в формате НТМL. Значение False дает возможность заносить в область лишь обыч
ный текст;
♦ acceptRichText() - возвращает значение True, если в область можно занести текст
в формате НТМL, и False - если доступно занесение лишь обычного текста;
♦ undo() - отменяет последнюю операцию ввода пользователем при условии, что отмена
возможна. Метод является слотом;
♦ redo() - повторяет последнюю отмененную операцию ввода пользователем, если это
возможно. Метод является слотом;
♦ setUndoRedoEnaЫed(<Флаг>) - если в качестве значения указано значение True, опера
ции отмены и повтора действий будут разрешены, а если False - то будут запрещены;
♦ isUndoRedoEnaЫed() - возвращает значение True, если операции отмены и повтора
действий разрешены, и False - если запрещены;
♦ createStandardContextMenu( [<Координаты QPoint>]) - создает стандартное контекстное
меню, которое отображается при щелчке правой кнопкой мыши в области .редактирова
ния. В параметре можно указать координаты точки внутри содержимого области редак
тирования. Чтобы изменить стандартное меню, следует создать класс, производный от
QТextEdit, и переопределить в нем метод contextMenuEvent (self, <event>). Внутри это
го метода можно создать свое собственное меню или добавить новый пункт в стандарт
ное меню;
♦ ensureCursorVisiЫe() - прокручивает область таким образом, чтобы текстовый курсор
оказался в зоне видимости;
♦ find() - производит поиск фрагмента (по умолчанию в прямом направлении без учета
регистра символов) в области редактирования. Если фрагмент найден, то он выделяется
488 Часть //. Библиотека PyQt б
и метод возвращает значение Tr\Je, в противном случае - значение False. Форматы
метода:
find(<Искомый текст> 1 <Регулярное выражение> [, <Режим>] )
Искомый текст можно указать либо строкой, либо реrулярным выражением, представ
ленным объектом класса QRegularExpression из модуля QtCore. В необязательном пара
метре <Режим> можно указать комбинацmо (через оператор 1) следующих элементов
перечисления FindFlag класса QТextDocument из модуля QtGui:
• FindВackw,э.rd - поиск в обратном направлении;
• FindCaseSensitively- поиск с учетом регистра символов;
• FindWholeWords - поиск целых слов, а не фрагментов;
♦ print (<Принтер>) - отправляет содержимое текстового поля на заданный принтер.
В качестве параметра указывается объект одного из классов, . производных от
QPagedPaintDevice (модуль QtGui): QPrinter (модуль QtPrintSupport) или QPdfWriter
(модуль QtGui). Пример вывода документа в РDF-файл:
pdf = QtGui.QPdfWriter("document.pdf")
. textEdit.print(pdf)
Класс QTextEdit поддерживает следующие сигналь�:
♦ copyAvailaЫe (<Флаг>) - генерируется при выделении текста или, наоборот, снятии
выделения. Значение параметра True указывает, что фрагмент выделен и его можно ско
пировать, значение False- обратное;
♦ currentCharFoпnatChanged (<Формат>) - генерируется при' изменении формата текста.
Внутри обработчика через параметр доступен новый формат в виде объекта класса
QТextCharFoпnat;
♦ cursorPositionChanged() - генерируется при изменении положения текстового курсора;
♦ redoAvailaЫe (<Флаг>) - генерируется при изменении возможности повторить отме
ненную операцmо ввода. Значение параметра True обозначает возможность повтора от
мененной операции, а значение False - невозможность сделать это;
♦ selectionChanged() - генерируется при изменении выделения текста;
♦ textChanged() - генерируется при изменении текста в области редактирования;
♦ undoAvailaЫe (<Флаг>) - генерируется при изменении возможности отменить опера
цmо _ввода. Значение параметра тrue указьmает, что операция ввода может быть отмене
на, значение False говорит об обратном.
22.6.2. Задание параметров области редактирования
Задать щ:>угие параметры области редактирования можно вызовами следующих методов
класса QTextEdit (полный их список смотрите на странице https://doc.qtio/qt-6/qtextedit.html):
♦ setTextinteractionFlags (<Режим>) - задает режим взаимодействия пользователя с тек
стом. Можно указать следующие элементы (или их комбинацmо через оператор 1) пере
числения TextinteractionFlag из модуля QtCore .Qt:
• NoTextinteraction- пользователь не может взаимодействовать с текстом;
• TextSelectaЫeByМouse - текст можно выделить мышью;
Глава 22. Основные компоненты 489
• TextSelectaЫeByKeyboard - текст можно выделить с помощью клавиатуры. Внутри
поля будет отображен текстовый курсор;
• LinksAccessiЫeByMouse - на гиперссьmках, присутствующих в тексте, можно щел
кать мышью;
• LinksAccessiЫeByKeyboard - с гиперссьmками, пр_исутствующими в тексте, можно
взаимодействовать с клавиатуры: перемещаться между гиперссылками - с помощью
клавиши <ТаЬ>, а переходить по гиперссылке - нажав клавишу <Enter>;
• TextEditаЫе - текст можно редактировать;
• TextEditorinteractfon - комбинация TextSelectaЫeByMouse
TextSelectaЫeByKeyboard I TextEditaЫe;
• TextBrowserinteraction - комбинация TextSelectaЫeByMouse
LinksAccessiЫeByМouse I LinksAcces_siЫeByKeyboarct;
♦ setReadOnly(<Флaг>) - если в качестве параметра указано значение True, область редак
тирования будет доступна только для чтения;
♦ isReadOnly() - возвращает значение True, если область доступна только для чтения,
и False - в противном случае;
♦ setLineWrapMode(<Режим>) - задает режим переноса строк. В качестве значения могут
быть указаны следующие элементы перечисления LinewrapMode из класса QTextEdit:
• NoWrap - перенос строк не производится;
• WidgetWidth - перенос строк при достижении ими правого края области редактиро
вания;
• FixedPixelWidth - перенос строк при достижении ими фиксированной ширины
в пикселах, которую можно задать с помощью метода setLineWrapColurnnOrWidth() ;
• FixedColurnnWidth - перенос строк при достижении ими фиксированной ширины
в символах, которую можно задать с помощью метода setLineWrapColurnnOrWidth() ;
♦ setLineWrapColurnnOrWidth(<Шиpинa>) - задает фиксированную ширину строк, при дос
тижении которой будет выполняться перенос, в пикселах или символах (в зависимости
от заданного режима переноса);
♦ setWordWrapMode(<Режим>) - задает режим переноса по словам. В качестве значения
могут быть указаны следующие элементы перечисления WrapMode класса QTextOption
ИЗ модуля QtGui:
• _NoWrap или ManualWrap ,- перенос по словам не производится;
• Worctwrap - перенос строк только по словам;
• wrapAnywhere - перенос строки может быть внутри слова;
• WrapAtWordВoundaryOrAnywhere - перенос по возможности по словам, но может быть
выполнен и внутри слова;
♦ setOVerwriteMode(<Флаг>) - если в качестве параметра указано значение True, вводи
мый текст будет замещать ранее введенный. Значение False отключает замещение;
♦ overwriteMode() - возвращает значе·ние True, если вводимый текст замещает ранее вве
денный, и False - в противном случае;
♦ setAutoFormatting(<Режим>) - задает режим автоматического форматирования. В каче
стве значения могут быть указаны следующие элементь1 перечисления AutoFormattingFlag
из класса QTextEdit:
490 Часть 11. Библиотека PyQt 6
• AutoNone - автоматическое форматирование не используется;
• AutoBulletList - автоматическое создание маркированного списка при вводе поль
зователем в начале строки символа*;
• AutoAll - вкточить все режимы. По состоянию на сегодня эквивалентно режиму
AutoBulletList;
♦ setCursorWidth (<Толщина>) - задает толщину текстового курсора;
♦ setTabChangesFocus(<Флаг>) - если параметром передать значение False, то с помощью
нажатия клавиши <ТаЬ> можно вставить в область редактирования символ табуляции.
Если указано значение True, клавиша <ТаЬ> используется для передачи фокуса следую
щему компоненту;
♦ setTabStopDistance(<1I1ирина>) - задает ширину табуляции в пикселах;
♦ tabStopDistance() - возвращает ширину табуляции в пикселах.
22.6.3. Указание параметров текста и фона
Для изменения параметров текста и фона предназначены следующие методы класса
QТextEdit (полный их список смотрите на странице https://doc.qt.io/qt-6/qtextedit.html):
♦ setcurrentFont(<Шрифт>) - задает текущий шрифт. Метод является слотом. В качестве
параметра указывается объект класса QFont из модуля QtGui. Конструктор этого класса
имеет следующий формат:
<Шрифт> = QFоnt(<Название шрифта>[, pointSize=-1][, weight=-1] [, italic=False])
В первом параметре задается название шрифта в виде строки. Необязательный параметр
pointSize устанавливает размер шрифта. В параметре weight можно указать степень
жирности шрифта в виде числа от О до 99 или следующего элемента перечисления
Weight ИЗ класса QFont: Thin, ExtraLight, Light, Noпnal, Mediшn, DemiBold, Bold, ExtraBold
или Black. Если в параметре italic указано значение True, шрифт будет курсивным;
♦ currentFont() - возвращает объект класса QFont с текущими характеристиками шрифта;
♦ setFontfamily(<Haзвaниe шрифта>) - задает название текущего шрифта. Метод являет
ся слотом;
♦ fontFamily() - возвращает название текущего шрифта;
♦ setFontPointSize(<Paзмep>) - задает размер текущего шрифта В пунктах. Метод явля
ется слотом;
♦ fontpointSize() - возвращает размер текущего шрифта;
♦ setFontWeight(<Жирность>) - задает жирность текущего шрифта в виде числа от О до 99
или одного из элементов перечисления weight из класса QFont. Метод является слотом;
♦ fontWeight() - возвращает жирность текущего шрифта;
♦ setFontitalic(<Флаг>) - если в качестве параметра указано значение True, шрифт бу
дет курсивным. Метод является слотом;
♦ fontitalic () - возвращает True, если шрифт курсивный, и False - в противном слу
чае;
♦ setFontUnderline(<Флаг>) - если в качестве параметра указано значение тrue, текст
будет подчеркнутым. Метод является слотом;
Глава 22. Основные компоненты 491
♦ fontUnderline() - возвращает True, если текст подчеркнутый, и False - в противном
случае;
♦ setTextColor(<Цвет>J - задает цвет текущего текста. В качестве значения можно ука
зать один из элементов перечисления GlobalColor из модуля QtCore.Qt (например, Ыасk,
white и т. д.) или объект класса QColor из модуля QtGui (например, QColor("red"),
QColor("#ff0000"), QColor(255, о, О) и др.). Метод является слотом;
♦ textColor() - возвращает объект класса QColor с цветом текущего текста;
♦ setтextвackgroundColor(<Цвет>) - задает цвет фона. В качестве значения можно ука
зать один из элементов перечисления GlobalColor из модуля QtCore.Qt (например, Ыасk,
white и т. д.) или объект класса QColor (например, QColor("red"), QColor("#ff0000"),
QColor(255, о, О) и др.). Метод является слотом;
♦ textвackgroundColor() - возвращает объект класса QColor с цветом фона;
♦ setAligrunent(<Выравнивание>) - задает горизонтальное выравнивание текста внутри
абзаца (допустимые значения рассмотрены в разд. 21.2). Метод является слотом;
♦ aligrunent() - возвращает значение выравнивания текста внутри абзаца.
Задать формат символов также можно с помощью класса QTextCharFoпnat, который опреде
лен в модуле QtGui и поддерживает дополнительные настройки. После создания объекта
класса, его следует передать в метод setCurrentCharFoпnat(<Формат>). Получить объект
класса с текущими настройками позволяет метод currentCharFoпnat (). За подробной
информацией по классу QTextCharFoпnat обращайтесь к странице https://doc.qt.io/qt-6/
qtextcharformat.html.
22.6.4. Класс QTextDocument
Класс QTextDocument из модуля QtGui представляет документ, который отображается в об
ласти редактирования. .Получить ссылку на текущий документ позволяет метод document()
класса QTextEdit. Занести в область редактирования новый документ можно с помощью
метода setDocument(<Документ>). Иерархия наследования:
QObject - QТextDocument
Конструктор класса QTextDocument имеет два формата:
QTextDocument([parent=None])
QTextDocument(<Teкcт>[, parent=None])
В параметре parent указывается ссылка на родитель. Параметр <Текст> задает простой
текст (не в НТМL-формате), который будет отображен в области редактирования.
Класс·, QTextDocument поддерживает следующий набор методов (полный их список смотрите
на странице https://doc.qt.io/qt-6/qtextdocument.html):
♦ setPlainText(<Текст>) - помещает в документ простой текст;
♦ setHtml(<Текст>) - помещает в.документ текст в формате HTML;
♦ setMarkdown (<Текст>) - помещает в документ текст в формате Markdown;
♦ toPlainText() - возвращает простой текст, содержащийся в документе;
♦ toHtml() - возвращает текст в формате НТМL;
♦ toмarkdown() - возвращает текст в формате Markdown;
492 Часть 11. Библиотека PyQt б
♦ clear() - удаляет весь текст из документа;
♦ isEmpty() - возвращает значение True, если документ пустой, и False - в противном
случае;
♦ setModified(<Флаг>) - если передано значение т rue, документ помечается как изме
·ненный, если False - как неизмененный. Метод является слотом;
♦ isModified () - воз.вращает значение True, если документ был изменен, и False -
в противном случае;
♦ undo() - отменяет последнюю операцию ввода пользователем при условии, что отмена
возможна. Метод является слотом;
♦ redo() - повторяет последнюю отмененную операцию ввода пользователем, если это
возможно. Метод является слотом;
♦ isUndoAvailaЫe() - возвращает значение True, если можно отменить последнюю опе
рацию ввода, и False - в противном случае;
♦ isRedoAvailaЫe() - возвращает значение True, если можно повторить последнюю от
мененную операцию ввода, и False - в противном случае;
♦ setUndoRedoEnaЫed(<Флаг>) - если в качестве параметра указано значение True, то
операции отмены и повтора действий разрешены, а если False - то запрещены;
♦ isUndoRedoEnaЫed() - возвращает значение True, если операции отмены и повтора
действий разрешены, и False - если запр�щены;
♦ availaЬleUndoSteps() - возвращает количество возможных операций отмены;
♦ availaЫeRedoSteps() - возвращает количество возможных повторов отмененных опе
раций;
♦ clearUndoRedoStacks([stacks=Stacks. UndoAndRedoStacks] ) - очищает список возмож
ных отмен и/или повторов. В качестве параметра можно указать следующие элементы
перечисления Stacks из класса QТextDocurnent:
• UndoStack - только список возможных отмен;
• RedoStack - только список ВОЗМОЖНЫХ повторов;
• UndoAndRedoStacks - оба списка;
♦ print(<Принтер>) - отправляет содержимое документа на указанный принтер. В каче
стве ·параметра указывается объект одного из классов, производных от QPagedPaintDevice
(модуль QtGui): QPrinter (модуль QtPrintSupport) или QPdfWriter (модуль QtGui);
♦ find() - производит поиск фрагмента в документе. Метод возвращает объект класса
QТextCursor из модуля QtGui. Если фрагмент не найден, то возвращенный объект будет
нулевым. Проверить успешность операции можно с помощью метода isNull() класса
QТextCursor. Форматы метода:
find(<Teкcт> <Регулярное выражение> [, position=O] [, options=O])
find(<Teкcт> 1 <Регулярное выражение>, <Курсор>[, options=O])
Параметр <Текст> задает искомый фрагмент, а параметр <Регулярное выражение> - ре
гулярное выражение в виде объекта класса QRegularExpression из модуля Qtcore. По
умолчанию обычный поиск производится без учета регистра символов в прямом направ
лении, начиная с позиции position или от текстового курсора, указанного в параметре
<Курсор> в . виде объекта класса QTextcursor. Поиск по регулярному выражению по
Глава 22. Основные компоненты 493
умолчанию производится с учетом регистра символов. Чтобы поиск производился без
учета регистра, необходимо передать элемент CaseinsensitiveOption перечисления
PatternOption из класса QRegularExpression в метод setPatternOptions() регулярного
выражения. В необязательном параметре options можно указать комбинацию (через опе
ратор 1) следующих элементов перечисления FindFlag из класса QTextDocument:
• FindВackward- поиск в обратном направлении;
• FindCasesensitively- поиск с учетом регистра символов. При использовании регу
лярного выражения значение игнорируется;
• FindWholeWords - поиск целых слов, а не фрагментов;
♦ setDefaultFont (<Шрифт>) - задает шрифт по умолчанию для документа. В качестве
параметра указывается объект класса QFont из модуля QtGui (описан в разд. 22.6.3);
♦ setDefaultStyleSheet(<Таблица стилей>) - устанавливает для документа таблицу сти-
лей CSS по умолчанию. Таблица стилей задается в виде строки;
♦ setDocumentMargin(<Отступ>) - задает отступ от краев поля до текста;
♦ documentMargin() - возвращает величину отступа от краев поля до текста;
♦ setMaximumВlockCount(<Количество>) - задает максимальное количество текстовых
блоков в документе. Если количество блоков становится больше указанного значения,
первые блоки будут удалены;
♦ maximumВlockCount() - возвращает максимальное количество текстовы� блоков;
♦ charactercount() - возвращает количество символов в документе;
♦ linecount() - возвращает количество строк в документе;
♦ ЫockCount() - возвращает количество текстовых блоков в документе;
♦ firstBlock() - возвращает объект класса QTextВlock, объявленного в модуле QtGui,
который содержит первый текстовый блок документа;
♦ ·1astВlock() - возвращает объект класса QTextВlock, который содержит последний тек
стовый блок документа;
♦ findВlock(<Индекс символа>) _:_ возвращает объект класса QТextBlock, который содер
жит текстовый блок документа, вкmочающий символ с указанным индексом;
♦ findВlockВyLineNшnЬer(<Индекс абзаца>) - возвращает объект класса QTextBlock, ко�
торый содержит текстовый блок документа, вкmочающий абзац с указанным индексом;
♦ findВlockByNшnЬer(<Индекс блока>) - возвращает объект класса QTextBlock, который
содержит текстовый блок документа с указанным индексом.
Класс QTextDocument поддерживает сигналь�:
♦ ЫockCountChanged(<Hoвoe количество блоков>) - генерируется при изменении количе
ства текстовых блоков. Внутри обработчика через параметр доступно новое количество
текстовых блоков, заданное целым числом;
♦ contentsChange(<Позиция курсора>, <Количество удаленных символов>, <Количество
добавленных символов>) - генерируется при изменении текста. Все три параметра цело
численные;
♦ contentschanged() - генерируется при любом изменении документа;
♦ cursorPositionChanged(<Курсор QTextCursor>) - генерируется при изменении позиции
текстового курсора из-за операции редактирования. При простом перемещении тексто-
494 Часть 11. Библиотека PyQt 6
вого курсора сигнал не генерируется. Внутри обработчика через параметр доступен объ
ект обновленного курсора;
♦ modificationChanged(<Флaг>) - генерируется при изменении состояния документа: из
неизмененного в измененное или наоборот. Значение параметра тrue обозначает, что
документ помечен как измененный, значение False - что он теперь неизмененный;
♦ redoAvailaЫe.(<Флаг>) - генерируется при изменении возможности повторить отме
ненную операцmо ввода. Значение параметра True обозначает наличие возможности по
вторить отмененную операцmо ввода, а False - отсутствие такой возможности;
♦ undoAvailaЫe(<Флаг>) - генерируется при изменении возможности отменить опера
цmо ввода. Значение параметра True обозначает наличие возможности отменить опера
цmо ввода, а False - отсутствие такой возможности;
♦ undoCommandAdded () - генерируется при добавлении операции ввода в список возмож
ных отмен.
22.6.5. Класс QTextCursor
Класс QTextCursor из модуля QtGui предоставляет текстовьiй курсор - инструмент для ра
боты с документом, представленным объектом класса QTextDocument. Конструктор класса
QГextCursor поддерживает следующие форматы:
QГextCursor()
QГextCursor(<Oбъeкт класса QTextDocument>)
QГextCursor(<Oбъeкт класса QTextFrame>)
QТextCursor(<Oбъeкт класса QTextBlock>)
QTextCursor(<Oбъeкт класса QTextCursor>)
С,оздать текстовый курсор, установить его в документе и управлять им позволяют следую
щие методы класса QTextEdit:
♦ textcursor() - возвращает видимый в текущий момент текстовый курсор в виде объек
та класса QTextcursor;
♦ setTextCursor(<Курсор QГextCursor>) - устанавливает новый текстовый курсор;
♦ cursorForPosition (<Позиция>) - возвращает текстовый курсор, который соответствует
позиции, указанной в качестве параметра. Позиция задается в виде объекта класса
QPoint в координатах области редактирования;
♦ moveCursor(<Позиция> [, mode =MoveMode. MoveAnchor] ) - перемещает текстовый курсор
внутри документа. В первом параметре можно указать следующие элементы перечисления
MoveOperation из класса QTextCursor:
• NoMove - не перемещать курсор;
• Start - в начало документа;
• up - на одну строку вверх;
• StartOfLine - в начало текущей строки;
• StartOfВlock - в начало текущего текстового блока;
• StartOfWord - в начало текущего слова;
• PreviousВlock - в начало предыдущего текстового блока;
• PreviousCharacter - на предыдущий символ;
Глава 22. Основные компоненты 495
• Previousword - в начало предыдущего слова;
• Left - на один символ влево;
• WordLeft - на одно слово влево;
• End - в конец документа;
• Down - на одну строку вниз;
• EndOfLine - в конец текущей строки;
• EndOfWord •- в конец текущего слова;
• EndOfВlock - в конец текущего текстового блока;
• NextBlock - в начало следующего текстового блока;
• NextCharacter - на следующий символ;
• NextWord - в начало следующего слова;
• Right - сдвинуть на ОДИН СИМВОЛ вправо;
• WordRight - в начало следующего слова.
Помимо указанных, в перечислении существуют также элементы NextCell,
PreviousCell, NextRow и PreviousRow, позволяющие перемещать текстовый курсор внут
ри таблицы.
В параметре mode можно указать следующие элементы перечисления MoveMode из класса
QТextCursor:
• MoveAnchor - если существует выделенный фрагмент, то выделение будет снято и
текстовый курсор переместится в новое место (значение no умолчанию);
• KeepAnchor - фрагмент текста от старой позиции курсора до новой будет выделен.
Класс QTextCursor поддерживает следующие методы (здесь приведены только основные -
полный их список смотрите на странице https://doc.qt.io/qt-6/qtextcursor.html):
♦ isNull() - возвращает значение тrue, если объект курсора является нулевым (создан
вызовом конструктора без параметра), и False - в противном случае;
♦ setPosition(<Позиция>[, mode=MoveMode .MoveAnchor]) - перемещает текстовый курсор
внутри документа. В первом параметре указывается позиция внутри документа. Необя
зательный параметр mode аналогичен одноименному параметру метода movecursor()
класса QTextEdit;
♦ movePosition(<Пoзиция>[, mode=MoveMode.MoveAnchor] [, n= l]) - перемещает тексто
вый курсор внутри документа. Параметры <Позиция> и mode аналогичны одноименным
параметрам метода movecursor() класса QTextEdit. Необязательный параметр n позволя
ет указать количество перемещений - например, переместить курсор на I О символов
вперед можно так:
cur = textEdit.textCursor()
cur.movePosition(QtGui.QTextCursor.MoveOperation.NextCharacter,
mode=QtGui.QTextCursor.MoveMode.MoveAnchor, n= l0)
textEdit.setTextCursor(cur)
Метод возвращает значение тrue, если операция успешно выполнена указанное количе
ство раз. Если было выполнено меньшее количество перемещений (например, из-за дос
тижения конца документа), метод возвращает значение False;
496 Часть 11. Библиотека PyQt б
♦ position () - возвращает позицшо текстового курсора внутри документа;
♦ positioninВlock () - возвращает позицию текстового курсора внутри блока;
♦ Ыосk () - возвращает объект класса QTextBlock, который описывает текстовый блок,
содержащий курсор;
♦ ЫockNшnЬer() - возвращает номер текстового блока, содержащего курсор;
♦ atStart () - возвращает значение True, если текстовый курсор ,находится в начале до
кумента, и False - в противном случае;
♦ atEnd () - возвращает значение True, если текстовый курсор находится в конце доку
мента, и False - в противном случае;
♦ atBlockStart() - возвращает значение True, если текстовый курсор находится в начале
блока, и False - в противном случае;
♦ atвlockEnd () - возвращает значение True, если текстовый курсор находится в конце
блока, и False - в противном случае;
♦ select(<Режим>) - выделяет фрагмент в документе в соответствии с указанным режи
мом. В качестве параметра можно указать следующие элементы перечисления
SelectionType из класса QTextCursor:
• WordUnderCursor - выделяет слово, в котором расположен курсор;
• LineUnderCursor - выделяет строку, в которой расположен курсор;
• BlockUnderCursor - выделяет текстовый блок, в котором находится курсор;
• Document - выделяет весь документ;
♦ hasSelection () - возвращает значение True, если существует выделенный фрагмент,
и False - в противном случае;
♦ hascomplexSelection () - возвращает значение True, если выделенный фрагмент содер-
жит сложное форматирование, а не просто текст, и False - в противном случае;
♦ clearSelection () - снимает выделение;
♦ selectionstart () - возвращает начальную позицию выделенного фрагмента;
♦ selectionEnd () - возвращает конечную позицию выделенного фрагмента;
♦ selectedText () - возвращает текст выделенного фрагмента;
ВНИМАНИЕ!
Если выделенный фрагмент занимает несколько строк, то вместо символа перевода строки
вставляется символ с кодом \u2029. Попытка вывести этот символ в консоли приведет к ис
ключению, поэтому следует произвести замену символа с помощью метода replace():
print(cur.selectedText().replace("\u2029", "\n"))
♦ selection () - возвращает объект класса QTextDocumentFragment, который описывает
выделенный фрагмент. Получить текст позволяют_ методы toPlainText () (возвращает
простой текст) и toHtml() (возвращает текст в формате НТМL) этого класса;
♦ removeSelectedText() - удаляет выделенный фрагмент;
♦ deleteChar () - если нет выделенного фрагмента, удаляет символ справа от курсора,
в противном случае удаляет выделенный фрагмент;
Глава 22. Основные компоненты 497
♦ deletePreviousChar() -· если нет выделенного фрагмента, удаляет символ слева от кур
сора, в противном случае удаляет выделенный фрагмент;
♦ beginEditВlock () - задает начало блока операций ввода. Операции, входящие в такой
блок, могут быть отменены или повторены как единое целое с помощью методов undo()
И redo();
♦ end.EditВlock () - задает конец блока операций ввода;
♦ joinPreviousEditВlock() - делает последующие операции ввода частью предыдущего
блока операций;
♦ setKeepPositionOninsert(<Флаг>) - если в качестве параметра указано значение True,
то после операции вставки курсор сохранит свою предыдущую позицию. По умолчанию
позиция курсора при вставке изменяется;
♦ insertтext(<Текст>[, <Формат> J ) - вставляет простой текст с форматом, указанным
в виде объекта класса QTextFormat;
♦ insertHtml(<Текст>) - вставляет текст в формате НТМL.
С помощью методов insertВlock(), insertFragment(), insertFrame(), insertimage(),
insertList() и insertTaЫe () можно вставить различные элементы: изображения, списки
и др. Изменить формат выделенного фрагмента позволяют методы mergeBlockCharFormat (),
mergeBlockFormat() и mergeCharFormat(). За подробной информацией по этим методам
обращайтесь к странице документации https://doc.qt.io/qt-6/qtextcursor.html.
22.7. Текстовый браузер
Класс QTextBrowser расширяет возможности класса QTextEdit и реализует текстовый брау
зер с возможностью перехода по гиперссылкам. Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame -
QAЬstractScrollArea - QTextEdit - QТextBrowser
Формат конструктора класса QTextBrowser:
QTextBrowser( [par.ent =None])
Класс QTextBrowser поддерживает следующие основные методы (полный их список смотри
те на странице https://doc.qt.io/qt-6/qtextbrowser.html):
♦ setsource() - загружает ресурс. Формат метода:
sеtSоurсе(<Интернет-адрес>[, type =ResourceType.UnknownResource])
Интернет-адрес указывается в виде объекта класса QUrl из класса QtCore. Параметр type
задает тип открываемого ресурса в виде одного из следующих элементов перечисления_
ResourceType из класса QTextDocument:
• UnknownResource --, неизвестный ресурс или ресурс вообще не загружен;
• HtmlResource - НТМL-документ;
• ImageResource - графическое изображение;
• StyleSheetResource - таблица стилей CSS;
• MarkdownResource - документ в формате Markdown.
498 Часть 11. Библиотека PyQt 6
Пример:
# Загружаем и выводим содержимое текстового файла
url = QtCore,QUrl("text.txt")
browser.setSource(url)
Метод является слотом;
♦ source() - возвращает объект класса QUr 1 с адресом текущего ресурса;
♦ reload() - перезагружает текущий ресурс; Метод является слотом;
♦ home() - загружает первый ресурс из списка истории. Метод является слотом;
♦ backward() � загружает предыдущий ресурс из списка истории. Метод является слотом;
♦ forward() - загружает следующий ресурс из списка истории. Метод является слотом;
♦ backwardHistoryCount() - возвращает количество предыдущих ресурсов из списка ис
тории;
♦ forwardНistoryCount() - возвращает количество следующих ресурсов из списка исто
рии;
♦ isBackwardAvailaЫe () - возвращает значение True, если существует предыдущий
ресурс в списке истории, и False - в противном случае;
♦ isForwardAvailaЫe() - возвращает значение True, если существует следующий ресурс
в списке истории, и False ...:.... в противном случае;
♦ clearHistory() - очищает список истории;
♦ historyТitle(<Количество позиций>) - если в качестве параметра указано отрицатель
ное число, возвращает заголовок предыдущего ресурса, отстоящего от текущего на за
данное число позиций, если О - заголовок текущего ресурса, а если положительное
число - заголовок следующего ресурса, также отстоящего от текущего на заданное
число позиций;
♦ historyUrl (<Количество позиций>) - то же самое, что historyТitle(), но возвращает
адрес ресурса в виде объекта класса QUrl;
♦ setOpenLinks(<Флаг>) - если в качестве параметра указано значение тrue, то переход
по гиперссылкам будет разрешен (поведение по умолчанmо). Значение False запрещает
переход;
♦ setOpenExternalLinks(<Флаг>) - если в . качестве параметра указано значение тrue, то
переход по гиперссылкам, ведущим на внешние ресурсы, будет разрешен (при этом сиг
нал anchorClicked() не генерируется). Значение False запрещает переход (поведение по
умолчанию).
Класс QTextBrowser поддерживает сигналы:
♦ anchorClicked(<Интepнeт-aдpec>) - генерируется при переходе по гиперссылке. Внут
ри обработчика через параметр доступен интернет-адрес гиперссылки в виде объекта
класса QUrl;
♦ backwardAvailaЫe(<Признак>) - генерируется при изменении списка предыдущих
ресурсов. Внутри обработчика через параметр доступно значение тrue, если в списке
истории имеются предыдущие ресурсы, и False - в противном случае;
♦ forwardAvailaЫe(<Признак>) - генерируется при изменении списка следующих ресур
сов. В обработчике через параметр доступно значение True, если в списке истории име
ют.ся следующие ресурсы, и False - в противном случае;
Глава 22. Основные компоненты 499
♦ highlighted(<Инт epнeт-aдpec>) - генерируется при наведении указателя мыши на ги
перссылку. Внутри обработчика через параметр доступен интернет-адрес гиперссьmки
в виде объекта класса QUrl или пустой объект;
♦ historyChanged() - генерируется при изменении списка истории;
♦ sourceChanged(<Инт ернет-адрес>). - генерируется при переходе на новый ресурс. Внут
ри обработчика через параметр доступен интернет-адрес загруженного ресурса в виде
объекта класса QUrl.
22.8. Поля для ввода
целых и вещественных чисел
Для ввода целых чисел предназначен класс QSpinBox, для ввода вещественных чисел -
класс QDouЫeSpinBox. Эти поля могут содержать две кнопки, которые позволяют щелчками
мыши увеличивать и уменьшать значение внутри поля. Пример такого поля ввода можно
увидеть на рис. 22.1. Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QAЬstractSpinBox - QSpinBox
(QObject, QPaintDevice) - QWidget - QAЬstractSpinBox - �DouЬleSpinBox
UQSpinBox □ х
Рис. 22.1. Компонент QSpinBox
Форматы конструкторов классов QSpinBox и QDouЬleSpinBox:
QSpinВox( [parent=None])
QDouЬleSpinBox( [parent=None])
Классы QSpinBox . и QDouЬleSpinBox наследуют следующие методы из класса
QAЬstractSpinBox (здесь приведены только основные - полный их список смотрите на
странице https://doc.qt.io/qt-6/qabstractspinbox.html):
♦ setButtonSymЬols (<Режим>) - задает режим отображения кнопок, предназначенньrх для
изменения значения поля. Можно указать следующие элементы перечисления
ButtonSymЬols из класса QAЬstractSpinВox:
• UpDownArrows - отображаются кнопки со стрелками;
• PlusMinus - отображаются кнопки с символами+ и-. Обратите внимание, что при ис
пользовании некоторых стилей это значение может быть проигнорировано;
• NoButtons -кнопки не отображаются;
♦ setCorrectionМode(<Режим>) - задает режим преобразования введенных вручную недопус
тимых значений в допустимые в виде одного из следующих элементов перечисления
CorrectionМode из класса QAЬstractSpinBox:
• CorrectToPreviousValue -преобразовывать в предыдущее допустимое значение;
• CorrectToNearestValue - преобразовывать в ближайшее допустимое значение;
500 Часть 11. Библиотека PyQt б
♦ setAccelerated (<Флаг>) - если в качестве парамеrра указано значение True, то при удержа
нии какой-либо из кнопок нажатой скорость смены значений в поле увеличиrся;
♦ setAlignrnent (<Режим>) - задает режим выравнивания значения внутри поля (допусти
мые значения рассмотрены в разд. 21. 2);
♦ setwrapping (<Флаг>) - если в качестве параметра указано значение True, то значение
внутри поля будет при нажатии кнопок изменяться по кругу: максимальное значение
сменится минимальным и наоборот;
♦ setSpecialValueтext (<Строка>) - задает строку, которая будет отображаться внутри
поля вместо минимального значения;
♦ setReadOnly(<Флaг>) - если в качестве параметра указано значение True, поле будет
доступно ТОЛЬКО для чтения;
♦ setFrame (<Флаг>) - если в качестве параметра указано значение False, поле будет ото-
бражаться без рамки;
♦ stepDown () - уменьшает значение на одно прирашение. Метод является слотом;
♦ stepUp () - увеличивает значение на одно приращение. Метод является слотом;
♦ stepBy(<Количество>) - увеличивает (при положительном значении) или уменьшает
(при отрицательном значении) значение поля на указанное количество приращений;
♦ text () - возвращает текст, содержащийся внутри поля;
♦ clear () - очищает поле. Метод является слотом;
♦ selectAll () - выделяет все содержимое поля. Метод является слотом.
Класс QAЬstractSpinВox поддерживает сигнал editingFinished (), который генерируется
при потере полем фокуса ввода или при нажатии клавиши <Enter>.
Классы QSpinBox и QDouЬleSpinBox поддерживают следующие методы (здесь приведены
только основные - полные их списки доступны на страницах https://doc.qt.io/qt-6/
qspinbox.html и https://doc.qt.io/qt�6/qdouЫespinbox.html соответственно):
♦ setValue (<Число>) - задает значение поля. Метод является слотом, принимающим,
в зависимости от компонента, целое или вещественное значение;
♦ value () - возвращает целое или вещественное число, содержащееся в поле;
♦ cleanText () - возвращает целое или вещественное число в виде строки, без дополни
тельного текста, заданного методами setPrefix () и setSuffix (), начальных и конечных
пробелов;
♦ setRange (<Минимум>, <Максимум>) - задает минимальное и максимальное допустимые
значения;
♦ setMinimurn (<Минимум>) - задает минимальное значение;
♦ setMaximurn (<Максимум>) � задает максимальное значение;
♦ setPrefix (<Текст>) - задает текст, который будет отображаться внутри поля перед зна
чением;
♦ setSuffix (<Текст>) - задает текст, который будет отображаться внутри поля после зна
чения;
♦ setSingleStep (<Число>) - задает число, которое будет прибавляться или вычитаться из
текущего значения поля на каждом шаге.
Глава 22. Основные компоненты 501
Класс QDouЫeSpinBox также подцерживает метод setDecirnals(<Количество>), который за
дает количество цифр после десятичной точки.
Классы QSpinВox и QDouЬleSpinBox подцерживают сигналы valueChanged(<Целое число>)
(в классе. QSpinBox), valueChanged(<Вещественное число>) (в классе QDouЫeSpinBox) и
textChanged(<Строка>), которые генерируются при изменении значения внутри поля. Внут
ри обработчика через параметр доступно новое значение в виде числа или строки.
22.9. Поля для ввода даты и времени
Для ввода даты и времени предназначены классы QDateTimeEdit (ввод временной отметки,
т. е.
значения даты и времени), QDateEdit (ввод даты) и QTimeEdit (ввод времени). Поля
могут содержать кнопки, которые позволяют щелчками мыши увеличивать и уменьшать
значение внутри поля. Пример такого поля показан на рис. 22.2.
iu QDateEdit о х
!■ 02.2022
Рис. 22.2. Компонент QDateEdi,t с кнопками-стрелками
Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QAЬstractSpinBox - QDateTimeEdit
(QObject, QPaintDevice) - QWidget - QAЬstractSpinВox - QDateTimeEdit - QDateEdit
(QObject, QPaintDevice) - QWidget - QAЬstractSpinВox - QDateTimeEdit - QТimeEdit
Форматы конструкторов классов:
QDateTimeEdit([parent=None])
QDateTimeEdit(<Bpeмeннaя отметка>[, parent=None])
QDateTimeEdit(<Дaтa>[, parent=None])
QDateTimeEdit(<Bpeмя>[, parent=None])
QDateEdit([parent=None])
QDateEdit(<Дaтa>[, parent=None])
QТi�eEdit([parent=None])
QTimeEdit(<Bpeмя>[, parent=None])
В параметре <Временная отметка> можно указать объект класса QDateTime или datetime (из
Python). Преобразовать объект класса QDateTime в объект класса datetime позволяет метод
toPyDateTime () класса QDateTime:
>>> from PyQtб import QtCore
>>> d = QtCore.QDateTime(2022, 2, 18, 14, 23)
>>> d
PyQt6.QtCore.QDateTime(2022, 2, 18, 14, 23)
>>> d.toPyDateTime()
datetime.datetime(2022, 2, 18, 14, 23)
В качестве параметра <Дата> можно указать объект класса QDate или date (из Python). Пре
образовать объект класса QDate в объект класса date позволяет метод toPyDate() класса
QDate.
502 Часть 1/. Библиотека PyQt 6
В параметре <Время> можно указать объект класса QTime или time (из Python). Преобразо
вать объект класса QTime в объект класса time позволяет метод toPyТime() класса QТime.
Классы QDateTime, QDate и QТime определены в модуле QtCore.
Класс QDateTimeEdit наследует все методы из класса QAЬstractSpinBox (см. разд. 22.8) и
дополнительно реализует следующие методы (здесь приведены только самые п_олезные -
полный их список смотрите на странице https://doc.qt.io/qt-6/qdatetimeedit.html):
♦ setDateTime (<Временная отметка QDateTime или <;latetime>)_ - устанавливает времен-
ную отметку. Метод является слотом;
♦ setDate (<Дата QDate или date>) -устанавливает дату. Метод является слотом;
♦ setTime (<Время QTime или time>) -устанавливает время. Метод является слотом;
♦ dateтime () -возвращает объект класса QDateTime с временной отметкой;
♦ date () -возвращает объект класса QDate с датой;
♦ time () -возвращает объект класса QTime со временем;
♦ setDateTimeRange (<Минимум>, <Максимум>) - задает минимальное и максимальное
допустимые значения для временной отметки;
♦ setMinimumDateTime (<Минимум>) - задает минимальное допустимое значение времен
ной отметки;
♦ setMaximumDateTime (<Максимум>) - задает максимальное допустимое значение времен
ной отметки.
В параметрах трех последних методов указываются объекты класса QDateTime или
datetime;
♦ setDateRange (<Минимум>, <Максимум>) - задают минимальное и максимальное допус
тимые значения для даты;
♦ setMinimumDate (<Минимум>) -задает минимальное допустимое значение даты;
♦ setМaximumDate (<Макс:имуы>) - задает максимальное допустимое значение даты.
В параметрах трех последних методов указываются объекты класса·ооаtе или date;
♦ setTimeRange (<Минимум>, <Максимум>) - задает минимальное и максимальное допус
тимые значения для времени;
♦ setMinimumTime (<Минимум>) -задает минимальное допустимое значение времени;
♦ setMaximumTime (<Максимум>) -задает максимальное допустимое значение времени.
В параметрах трех последних методов указываются объекты класса QTime или time;
♦ setDisplayFormat(<Формат>) -задает формат отображения даты и времени. В качестве
параметра указывается строка, содержащая специальные символы. Пример задания
строки формата:
dateTimeEdit .setDisplayFormat("dd.ММ.yyyy HH:mm:ss")
♦ setTimeSpec(<Зона>) - задает временную зону. В качестве параметра можно указать
следующие элементы перечисления TimeSpec из модуля QtCore.Qt: LocalTime (местное
время), uтс (всемирное координированное время) или OffsetFromuтc (смещение относи
тельно всемирного координированного времени, исчисляемое в секундах);
Глава 22. Основные компоненты 503
♦ setCalendarPopup (<Флаг>) - если в качестве параметра указано значение True, то дату
можно будет выбрать с помощью календаря, который появится на экране при щелчке на
кнопке с направленной вниз стрелкой, выведенной вместо стандартных кнопок-стрелок
(рис. 22.3);
[jJ QDateEdit □ х
-
Пн Вт Ср Чт Пт Сб Вс
31 2 3 4 5 6
7 8 9 10 11 12 13
14 15 16 17 19 20
21 22 23 24 25 26 27
28 2 3 4 5 6
7 8 9 10 11 12 13
Рис. 22.3. Компонент QDateEdit с открытым календарем
♦ setSelectedSection (<Секция>) - выделяет указанную секцию. В качестве параметра
можно задать один из следующих элементов перечисления section из класса
QDateTimeEdit:
• NoSection - ни одна секция не будет выделена;
• DaySection - будет выделена секция числа;
• мonthSection - секция месяца;
• YearSection - секция года;
• HourSection - секция часов;
• MinuteSection - секция минут;
• SecondSection - секция секунд;
• мsecsection - секция миллисекунд;
• AmPmSection - секция времени суток (АМ или РМ);
♦ setCurrentSection (<Секция Section>) - делает указанную секцию текущей;
♦ setCurrentSectionindex (<Индекс>) - делает секцию с указанным индексом текущей;
♦ currentsection () - возвращает тип текущей секции в виде одного из элементов пере-
числения Section из класса QDateTimeEdit;
♦ currentSectionindex () - возвращает индекс текущей секции;
♦ sectioncount () - возвращает количество секций внутри поля;
♦ sectionAt (<Индекс>) - возвращает обозначение типа секции по указанному индексу
в виде одного из элементов перечислени,я Section из класса QDateTimeEdit;
♦ sectionText (<Секция Section>) - возвращает текст указанной секции.
504 Часть 11. Библиотека PyQt 6
При изменении значений даты или времени генерируются сигналы timeChanged(<Время>),
dateChanged(<Дата>) и date;ГimeChanged(<Временная отметка>). Внутри обработчиков через
параметр доступно новое значение в виде объекта класса QTime, QDate или QDateTime. соот
ветственно.
Классы QDateEdit и QTimeEdit отличаются от класса QDateTimeEdit только форматом ото
бражаемых данных. Эти классы наследуют методы базовых классов и не добавляют ника
ких своих методов.
22.10. Календарь
Класс QCalendarWidget реализует календарь с возможностью выбора даты и перемещения
по месяцам с помощью мыши и клавиатуры (рис. 22.4). Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QCalendarWidget
U QCalendarWidget □ х
Пн Вт Ср Чт Пт Сб Вс
•
5 31 2 3 4 5 6
6 7 8 9 10 11 12 13
7 14 15 16 17 19 20
8 21 22 23 24 25 26 27
9 28 2 3 4 5 6
10 7 8 9 10 11 1" 13
Рис. 22.4. Компонент QCalendarWidget
Формат конструктора класса QCalendarWidget:
QCalendarWidget([parent=None])
Класс QCalendarWidget поддерживает следующие методы (зде_сь представлены только ос
новные :-- полный их список смотрите на странице https://doc.qtio/qt-6/qcalendarwidgethtml):
♦ setSelectedDate(<Дата QDate или date>) -устанавливает дату. Метод является слотом;
♦ selectedDate() - возвращает объект класса QDate с выбранной датой;
♦ setDateRange(<Минимум>, <Максимум>) - задает минимальное и максимальное допус
тимые значения для даты. Метод является слотом;
♦ setMinimumDate (<Минимум>) - задает минимальное допустимое значение даты;
♦ setMaximumDate(<Максимум>) -задает максимальное допустимое значение даты.
В параметрах трех последних методов указывается объект класса QDate или date;
Глава 22. Основные компоненты 505
♦ setcurrentPage (<Год>, <Месяц>) - делает текущей страницу календаря с указанными
годом и месяцем, которые задаются целыми числами. Выбранная дата при этом не изме
няется. Метод является слотом;
♦ monthShown () - возвращает месяц (число от 1 до J 2), отображаемый на текущей странице;
♦ yearShown () - возвращает год, отображаемый на текущей странице;
♦ showSelectedDate () - отображает страницу с выбранной датой. Выбранная дата при
этом не изменяется. Метод является слотом;
♦ showТoday () - отображает страницу с сегодняшней датой. Выбранная дата при этом не
изменяется. Метод является слотом;
♦ showPreviousMonth () - отображает страницу с предыдущим месяцем. Выбранная дата
при этом не изменяется. Метод является слотом;
♦ showNextMonth () - отображает страницу со следующим месяцем. Выбранная дата при
этом не изменяется. Метод является слотом;
♦ showPreviousYear () - отображает страницу с текущим месяцем в предыдущем году.
Выбранная дата нt; изменяется. Метод является слотом;
♦ showNextyear () - отображает страницу с текущим месяцем в следующем году. Выбран
ная дата при этом не изменяется. Метод является слотом;
♦ setFirstDayOfWeek (<День>) - задает первый день недели. По умолчанию используется
воскресенье. Чтобы первым днем недели сделать понедельник, с:11едует в качестве пара
метра указать элемент Monday перечисления DayOfWeek из класса QtCore. Qt;
♦ setNavigationБarVisiЫe (<Флаг>) - если в качестве параметра указано значение False,
то панель навигации выводиться не будет. Метод является слотом;
♦ setHorizontalHeaderFormat (<Формат>) - задает формат горизонтального заголовка.
В качестве параметра можно указать следующие элементы перечисления
HorizontalHeaderFormat класса QCalendarWidget:
• NoHorizontalHeader - заголовок не отображается;
• SingleLetterDayNames - отображается только первая буква из названия дня недели;
• ShortDayNames - отображается сокращенное название дня недели;
• LongDayNames - отображается полное назваFШе дня недели;
♦ setVerticalНeaderFormat (<Формат>) - задает формат вертикального заголовка. В каче
стве параметра можно указать следующие элементы перечисления VerticalHeaderFormat
из класса QCalendarWidget:
• NoVerticalHeader - заголовок не отображается;
• rsoweekNumЬers - отображается номер недели в году;
♦ setGridVisiЫe (<Флаг>) - если в качестве параметра указано значение True, линии сет
ки будут отображены. Метод является слотом;
♦ setSelectionМode (<Режим>) - задает режим выделения даты. В качестве параметра
можно указать следующие элементьr перечисления SelectionМode из класса
QCalendarWidget:
• NoSelection - дата не может быть выбрана пользователем;
• SingleSelection - может бьпь выбрана одна дата;
506 Часть 11. Библиотека PyQt б
♦ setHeaderTextFoпnat(<Формат>) - задает формат ячеек заголовка. В параметре указыва
ется объект класса QTextCharFoпnat из модуля QtGui;
♦ setWeekdayТextFoпnat(<День недели>, <Формат>) - определяет формат ячеек для· ука
заmюго дня недели. В первом параметре задаются следующие элементы перечисления
DayOfWeek из .модуля QCore.Qt: Monday (понедельник), Tuesday (вторник), Wednesday (сре
да), Thursday (четверг), Friday (пятница), Saturday (суббота) или sunday (воскресенье), а
во втором параметре - объект класса QTextCharFoпnat;
♦ setDateтextFoпnat(<Дата QDate или date>, <Формат QTextCharFoпnat>) - задает формат
ячейки с указанной датой.
Класс QCalendarWidget поддерживает такие сигналы:
♦ activated(<Дaтa QDate>) - генерируется при двойном щелчке мышью или нажатии кла
виши <Enter>. Внутри обработчика через параметр доступна текущая дата;
♦ clicked(<Дaтa QDate>) - генерируется при щелчке мышью на какой-либо дате. Внутри
обработчика через параметр доступна выбранная дата;
♦ currentPageChanged(<Год>, <Месяц>) - генерируется при изменении страницы. Внутри
обрабо� через первый параметр доступен год,· а через второй- месяц. Обе величи
ны зад�елыми числами;
♦ selectionChanged() - генерируется при изменении выбранной даты пользователем или
из программного кода.
22.11. Семисегментный индикатор
Класс QLCDNumЬer реализует семисегментный индикатор, аналогичный используемым
в электронных часах и калькуляторах (рис. 22.5). Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame - QLCDNumЬer
[U QLDCNumber □ х
Рис. 22.5. Компонент QLCDNurnЬer
Форматы конструктора класса QLCDNumЬer:
QLCDNumЬer([parent=None])
QLCDNumЬer(<Koличecтвo цифр>[, parent=None])
Если количество отображаемых цифр не указано, используется значение 5.
Класс QLCDNumЬer поддерживает следующие методы (здесь приведены только основные -
полнь1й их список смотрите на странице https://doc.qt.io/qt-6/qlcdnumber.html):
♦ display(<Значение>) - задает новое выводимое значение: целое число, вещественное
ЧИСЛО или строку:
lcd.display(l054871)
Метод является слотом;
Глава 22. Осно.вные компоненты 507
♦ checkOverflow(<Чиcлo>) - возвращает значение True, если целое или вещественное
число, указанное в параметре, не может быть отображено индикатором. В противном
случае возвращает значение False;
♦ intValue () - возвращает выводимое значение в виде целого числа;
♦ value () - возвращает выводимое значение в виде вещественного числа;
♦ setSegmentStyle (<Стиль>) - задает стиль индикатора. В качестве параметра можно ука
зать следующие элементы перечисления SegmentStyle из класса QLCDNшnЬer: Outline
(контурные сегментъ1), Filled (выпуклые сплошные сегментъ1) или Flat (плоские
сплошные сегментъ1);
♦ setMode (<Режим>) - задает режим отображения чисел. В качестве параметра можно ука
зать следующие элементы перечисления Mode из класса QLCDNшnЬer: Нех (шестнадцате
ричный режим), Dec (десятичный), oct (восьмеричный) или Bin (двоичный).
Вместо метода setMode () удобнее воспользоваться методам:и-слотами setHexМode (),
setDecMode (), setOctMode () и setBinМode () ;
♦ setSmallDecimalPoint (<Флаг>) - если в качестве параметра указано значение True, де
сятичная точка будет отображаться как отдельный элемент (при этом значение выводит
ся более компактно - без пробелов до и после точки), а если значение False - то деся
тичная точка будет занимать позицию цифры (поведение по умолчанию). Метод являет
ся слотом;
♦ setDigitCount (<Число>) :_ задает количество отображаемых цифр. Если в методе
setSmallDecimalPoint () указано значение False, десятичная точка считается отдельной
цифрой.
Класс QLCDNшnЬer поддерживает сигнал overflow(), генерируемый при попытке задать зна
чение, которое не может быть отображено индикатором.
22.12. Индикатор процесса
Класс QProgressBar реализует индикатор процесса. Иерархия наследования выглядит так:
QObject, QPaintDevice) - QWidget - QProgressBar
Формат конструктора класса QProgressBar:
:2ProgressBar ( [parent=None])
Класс QProgressвar поддерживает следующий набор методов, которые могут быть нам по
_1езны (полный их список смотрите на странице https://doc.qt.io/qt-6/qprogressbar.html):
♦ setValue (<Значение>) - задает новое целочисленное значение процесса. Метод являет-
ся слотом;
♦ value () - возвращает текущее значение процесса в виде числа;
♦ text () - возвращает текст, отображаемый на индикаторе или рядом с ним;
♦ setRange (<Минимум>, <Максимум>) - задает минимальное и максимальное значения;
♦ setMinimum (<Минимум>) - задает минимальное значение;
♦ setMaximum (<Максимум>) - задает максимальное значение.
Параметры всех трех последних методов задаются в виде целых чисел. Если и мини
мальное, и максимальное значения равны нуmо, то внутри индикатора будут постоянно
508 · Часть 11. Библиотека PyQt б
по кругу перемещаться сегменты, показьшая ход выполнения процесса с неопределен
ньтм количеством шагов. Все три метода являются слотами_;
♦ reset() - сбрасывает значение индикатора. Метод является слотом;
♦ setOrientation(<Ориентация>) - задает ориентацию индикатора. В качестве значения
указываются элементы Horizontal (горизонтальная) ИЛИ Vertical (вертикальная) пере
числения Orientation из модуля QtCore. Qt. Метод является слотом;
♦ setтextVisiЫe(<Флаг>) - если в качестве параметра указано значение False, текст
с текущим значением индикатора отображаться не будет;
♦ setTextDirection(<Направление>) - задает направление вывода текста при вертикаль
ной ориентации индикатора. В качестве значения указываются следующие элементы пе
речисления Direction из класса QProgressBar:
• TopToBottom - текст поворачивается на 90° по часовой <;.трелке;
• BottomToTop - текст поворачивается на 90° против часовой стрелки.
При использовании стилей "windows", "windowsxp" и "macintosh" при вертикальной ори
ентации текст вообще не отображается.
♦ setinvertedAppearance(<Флаг>) - если в качестве параметра указано, значение True,
направление увеличения значения будет изменено на противоположное (например, не
слева направо, а справа налево - при горизонтальной ориентации);
♦ setFormat(<Формат>) - задает формат вьшода текстового представления значения. Па
раметром передается строка формата, в которой могут использоваться следующие спе
·циальные символы: %v - само текущее значение, %m - заданный методами setмaximun()
или setRange() максимум, %р - текущее значение в процентах:
lcd.setFormat( 'Вьmолнено %v шагов из %m')
При изменении значения процесса генерируется сигнал valueChanged(<Hoвoe значение>).
Внутри обработчика через параметр доступно новое значение, заданное целым числом.
22.13. Шкала с ползунком
Класс QSlider реализует шкалу с ползунком. Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QAЬstractSlider - QSlider
Форматы конструктора класса QSlider:
QSlider([parent=None])
QSlidеr(<Ориентация>[, parent=None])
В качестве значения параметра <Ориентация> указываются элементы Horizontal (горизон
тальная) или Vertical (вертикальная - значение по умолчанию) перечисления drientation
из модуля QtCore.Qt.
Класс QSlider наследует следующие методы из класса QAЬstractSlider (здесь· приведены
только основные - полный их список смотрите на странице Ьttps://doc.qt.io/qt-2/
qabstractslider.Ьtml):
♦ setValue(<Значение>) - задает новое целочисленное значение для шкалъr. Метод явля
ется слотом;
♦ value() - возвращает текущее значение в виде числа;
Глава 22. Основные компоненты 509
♦ setSliderPosition(<Положение>) - задает текущее положение ползунка;
♦ sliderPosition () - возвращает текущее положение ползунка в виде числа. Если отсле
живание перемещения ползунка включено (принято по умолчанию), то возвращаемое
значение будет совпадать со значением, возвращаемым методом value (). Если отслежи
вание выключено, то при перемещении метод sliderPosition () вернет текущее положе
ние, а метод value() - положение, которое имел ползунок до перемещения;
♦ setRange (<Минимум>, <Максимум>) - задает минимальное и максимальное значения,
представленные целыми числами. Метод является слотом;
♦ setMinimum (<Минимум>) - задает минимальное значение в виде целого числа;
♦ setMaximum(<Максимум>) - задает максимальное значение в виде целого числа;
♦ setorientation (<Ориентация>) - задает ориентацию шкалы. В качестве значения ука
зываются элементы Horizontal (горизонтальная) или vertical (вертикальная) перечис
ления Orientation из модуля QtCore. Qt. Метод является слотом;
♦ setSingleStep(<Знaчeниe>) - задает значение, на которое сдвинется ползунок при на
жатии клавиш со стрелками;
♦ setPageStep(<Значение>) - задает значение, на которое сдвинется ползунок при нажа
тии клавиш <Page Up> и <Page Down>, повороте колесика мыши или щелчке мышью на
шкале;
♦ set InvertedAppearance(<Флаг>) - если в качестве параметра указано значение True,
направление увеличения значения будет изменено на противоположное (например, не
слева направо, а справа налево- при горизонтальной ориентации);
♦ setinvertedControls (<Флаг>) - если в качестве параметра указано значение False, то
при изменении направления увеличения значения будет изменено и направление пере
мещения ползунка при нажатии клавиш <Page Up> и <Page Down>, повороте колесика
мыши и нажатии клавиш со стрелками вверх и вниз;
♦ setтracking(<Флаг>) - если в качестве параметра указано значение тrue, отслеживание
перемещения ползунка будет включено (принято по умолчанию). При этом сигнал
· valueChanged() при перемещении ползунка станет генерироваться постоянно. Если в ка
честве параметра указано значение False, то сигнал valueChanged() будет сгенерирован
только при отпускании ползунка;
♦ hasTracking() - возвращает значение True, если отслеживание перемещения ползунка
включено, и False - в противном случае.
Класс QAЬstractSlider поддерживает сигналы:
♦ actionTriggered(<Дeйcтвиe>) - генерируется, когда происходит взаимодействие с пол
зунком (например, при нажатии клавиши <PgUp>). Внутри обработчика через параметр
доступно произв.еденное действие, которое описывается целым числом. Также мож
но использовать следующие элементы перечисления SliderAction из класса
QAЬstractSlider:
• SliderNoAction (о)- нет взаимодействия с ползунком;
• Sl:i.derSingleStepAdd (1)- увеличение значения путем щелчка на клавише-стрелке
(какой именно, зависит от указанного направления увеличения значения);
• SliderSingleStepSuЬ (2)-уменьшение значения путем щелчка на клавише-стрелке;
510 Часть 11. Библиотека PyQt б
• SliderPageStepAdd (з)-увеличение значения путем щелчка на клавише<PgUp> или
<PgDn> (какой именно, зависит от указанного направления увеличения значения);
• SliderPageStepSuЬ ( 4)- уменьшение значения путем щелчка на клавише <PgUp>
или<РgDn>;
• SliderToMinimum (s) -сдвиг ползунка в начало шкалы нажатием клавиши<Ноше>;
• Sliderтoмaximum ( 6) -сдвиг ползунка в конец шкалы нажатием клавиши<End>;
• SliderMove (7) - перемещение ползунка мышью;
♦ rangeChanged (<Минимум>, <Максимум>) -генерируется при изменении диапазона значе
ний. Внутри обработчика через параметры доступны новые минимальное и максималь
ное значения, заданньrе целыми числами;
♦ sliderPressed() -генерируется при нажатии ползунка;
♦ sliderмoved(<Пoлoжeниe>) - генерируется постоянно при перемещении ползунка.
Внутри обработчика через параметр доступно новое положение ползунка, выраженное
целым числом;
♦ sliderReleased() -генерируется при отпускании ранее нажатого ползунка;
♦ valueChanged(<Знaчeниe>) -генерируется при изменении значения. Внутри обработчи-
ка через параметр доступно новое значение в виде целого числа.
Класс QSlider дополнит_ельно определяет следующие методы (здесь приведены только
основные - полный их список смотрите на странице https://doc.qt.io/qt-6/qslider.html):
♦ setTickPosition(<Позиция>) - задает позицию рисок. В качестве параметра указывают
ся следующие элементы перечисления TickPosition из класса QSlider:
• NoTicks -без рисок;
• TicksBothSides -рискило обе стороны;
• TicksAЬove -риски выводятся сверху;
• TicksBelow -риски выводятся снизу;
• TicksLeft -риски выводятся слева;
• TicksRight -риски выводятся справа;
♦ setTickinterval(<Расстояние>) -задает расстояние между отдельными рисками.
22.14. Круговая шкала с ползунком
Класс QDial реализует круглую шкалу с ползунком, который можно перемещать по кругу
с помощью мыши или клавиатуры. Компонент, показанный ца рис. 22.6, напоминает регу
лятор, используемый в различных устройствах для изменения каких-либо настроек. Иерар
хия наследования:
(QObject, QPaintDevice) - QWidget - QAЬstractSlider - QDial
Формат конструктора класса QDial:
QDial( [parent=None])
Класс QDial наследует все методы и сигналы класса QAЬstractSlider (см. разд. 22.131 ?
определяет несколько дополнительных методов (здесь приведена только часть методов -
полный их список смотрите на странице https://doc.qt.io/qt-6/qdial.html):
Глава 22. Основные компоненты 511
UQDial □ х
/
,,..
Рис. 22.6. Компонент QDial
♦ setNotchesVisiЫe (<Флаг>) - если в качестве параметра указано значение True, будут
отображены риски. По умолчанию риски не выводятся. Метод является слотом;
♦ setNotchTarget(<Значение>) - задает рекомендуемое расстояние между рисками в пик
селах. В качестве параметра указывается вещественное число;
♦ setWJ:"apping(<Флаг>) - если в качестве параметра указано значение True, то начало
шкалы будет совпадать с ее концом. По умолчанию между началом шкалы и концом
расположено пустое пространство. Метод является слотом.
22.15. Полос
, а прокрутки
Класс QScrollBar реализует горизонтальную или вертикальную полосу прокрутки. Иерар
хия наследования:
(QObject, QPaintDevice) - QWidget - QAЬstractSlider - QScrollBar
Форматы конструктора класса QScrollBar:
QScrollBar([parent=None])
QSсrоllВаr(<Ориентация>[, parent=None])
В качестве значения параметра <Ориентация> указываются элементы Horizontal (горизон
тальная) или vertical (вертикальная - значение по умолчанию) перечисления Orientation
из модуля QtCore .Qt.
Класс QScrollBar наследует все методы и сигналы класса QAЬstractSlider (см. разд. 22.13)
и не определяет дополнительных методов.
22.16. Веб-браузер
Чтобы использовать компонент полнофункционального веб-браузера, потребуется устано
вить дополнительную библиотеку PyQt6-WebEngine, для чего следует в консоли подать
следующую команду:
pip install PyQtб-WebEngine
Веб-браузер реализуется классом QWebEngineView из модуля QtWebEngineWidgets (рис. 22.7).
Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QWebEngineView
512 Часть 11. Библиотека PyQt 6
lit] QWebEngineViev, о х
n�та Карп1н�, •••
8•1 Нiii
Поиск в GoogJe Мне nовезёт!
Россия
Нуnевой баланс выбросов yrneкv.cлora га.за с 2007 rода
Всё о Goog!e Реклама Дл� бизнеса Как работает Google По�ск Конфидемциальность Условия Настройки .
Рис. 22.7. Компонент QWebEngineView
Формат консч,уктора класса QWebEngineView:
QWebEngineView( [parent=None])
Класс QWebEngineView поддерживает следующие полезные для нас методы (полный их спи
сок смотрите на странице https://doc.qt.io/qt-6/qwebengineview.html):
♦ lоаd(<Интернет-адрес>) и sеtUrl(<Интернет-адрес>) - загружают и-выводят страницу
с указа1rnым в параметре адресом, который задается в виде объекта класса QUrl из моду
ля QtCore:
web.load(QtCore.QUrl('https://www.google.ru/'))
♦ url() - возвращает адрес текущей страницы в виде объекта класса QUrl;
♦ · title() - возвращает заголовок (содержимое тега <title>) текущей страницы;
♦ setHtml(<НТМL-код> [, baseUrl=QUrl() J ) - задает НТМL-код страницы, которая будет
отображена в компоненте.
Необяза-тельный параметр baseurl указывает базовый адрес, относительно которого
будут отсчитываться относительные адреса в гиперссылках, ссылках на файлы изобра
жений, таблицы стилей, файлы сценариев и пр. Если этот параметр не указан, в качестве
значения по умолчанию используется «пустой» объект класса QUrl, и относительные
адреса будут отсчитываться от каталога, где находится сам файл страницы. Пример:
wv.setHtml("<hl>Зaгoлoвoк</hl>")
# Файл page2.html будет загружен с сайта http://www.somesite.ru/
webview.setHtml("<a href='page2.html'>Bтopaя страница</а>",
QtCore.QUrl('http://www.somesite.ru/'))
Глава 22. Основные компоненты 513
♦ selectedText() - возвращает выделенный текст или пустую строку, если ничего не бы
ло выделено;
♦ hasSelection() - возвращает Tr1:1e, если какой-либо фрагмент страницы был выделен,
и False- в противном случае;
♦ setzoomFactor(<Множитель>) - задает масштаб самой страницы. Значение 1 указывает,
что страница будет выведена в оригинальном масштабе, значение меньше· единицы -
в уменьшенном, значение больше единицы - увеличенном масштабе;
♦ zoomFactor() ;__ возвращает масштаб страницы;
♦ back() - загружает предыдущий ресурс из списка истории. Метод является слотом;
♦ forward() - загружает следующий ресурс из списка истории . Метод является слотом;
♦ reload() - перезагружает с траницу. Метод является слотом;
♦ stop() - останавливает загрузку страницы. Метод является слотом;
♦ icon() - возвращает в виде объекта класса Qicon значок, заданный для с траницы;
♦ findText (<Искомый текст>[, options= {}] [, resultCallback=0]) - ищет на странице
заданный фрагмент текста. Все найденные фрагменты будут выделены желтым фоном
непосредственно в компоненте.
Необязательный: параметр option задает дополнительные параметры в виде одного из
следующих элементов перечисления FindFlag класса QWebEnginePage из модуля
QtWebEngineCore (или их комбинации через оператор 1 ):
• FindВackward - вьtполнять поиск в обратном, а не в прямом направлении;
• FindCaseSensitively- поиск с учетом регистра символов (по умолчанию выполня-
ется поиск без учета регистра).
В необязательном параметре resultCallback можно указать функцию, которая будет вы
звана по окончании поиска. Эта функция должна принимать в качестве единственного
параметра объект класса QW�bEngineFindTextResult из модуля QtWebEngineCore. Этот
класс поддерживает следующие методы:
• numЬerOfМatches() - возвращает количество совпавших фрагментов;
• activeMatch() - индекс выделенного в текущий момент совпавшего фрагмента.
Пример поиска с учетом регистра и выделением всех найденнь1х совпадений:
web. findText( 'Python' ,
options= QtWebEngineCore.QWebEnginePage.FindFlag.FindBackward 1
QtWebEngineCore.QWebEnginePage.FindFlag.FindCaseSensitively)
♦ triggerPageAction(<Действие>[, checked=False]) - выполняет над страницей указан
ное действие. В качестве действия задается один из элементов перечисления WebAction
класса QWebEnginePage из модуля QtWebEngineCore - этих атрибутов очень много, и все
они приведены на странице Ьttps://doc.qt.io/qt-6/qwebenginepage.Ьtml#WebAction
enum. Необязательный параметр checked имеет смысл указывать лишь для действий,
принимающих логический флаг:
# Выделение всей страницы
web.triggerPageAction(QtWebEngineCore.QWebEnginePage.WebAction.SelectAll)
# Копирование выделенного фрагмента страницы
web.triggerPageAction(QtWebEngineCore.QWebEnginePage.WebAction.Copy)
514 Часть 11. Библиотека PyQt б
# Перезагрузка страницы, минуя кеш
web.triggerPageAction(
QtWebEngineCore.QWebEnginePage.WebAction.ReloadAndВypassCache)
♦ page() - возвращает объект класса QWebEnginePage из модуля QtWebEngineCore, пред
ставляющий открытую веб-страницу (описан далее);
♦ print(<Принтер>) - печатает содержимое открытой страницы на заданном принтере
(указывается в виде объекта класса QPrinter);
♦ printToPdf() - преобразует страницу в формат PDF. Форматы метода:
printToPdf(<Пyть к файлу>,
pageLayout=QPageLayout(QPageSize(QPageSize.PageSizeid.A4),
QPageLayout.Orientation.Portrait,
QMarginsF()),
ranges={})
рrintТоРdf(<Функция>,
pageLayout=QPageLayout(QPageSize(QPageSize.PageSizeid.A4),
QPageLayout .Orientation .Portrait,
QMarginsF() ),
ranges= {})
Первый формат сразу сохраняет преобразованную страницу в файле, чей путь указан
первым параметром. Второй формат после преобразования вызывает указанную в пер
вом параметре функцmо, передавая ей в качестве единственного параметра. преобразо
ванную страницу в виде объекта класса QByteArray.
Параметр pageLayout задает настройки страницы в виде объекта класса QPageLayout
(описан в главе 30). Если параметр не указан, будет выполнена печать на бумаге типо
размера А4, в портретной ориентации, без отступов.
Параметр ranges задает номера страниц, которые попадут в формируемый РDF-доку
мент, в виде множества. Если он не указан, в документ попадут все страницы.
Класс QWebEngineView поддерживает следующий набор полезных сигналов (полный их спи
сок смотрите на странице https://doc.qt.io/qt-6/qwebengineview.html):
♦ iconChanged(<Знaчoк Qicon>) - генерируется после загрузки или изменения значка, за
данного для страницы. В параметре, передаваемом обработчику, доступен полученный
значок;
♦ loadFinished(<Флaг>) - генерируется по окончании загрузки страницы. Значение True
параметра указывает, что загрузка выполнена без проблем, False - что при загрузке
произошли ошибки;
♦ loadProgress(<Процент выполнения>) - периодически генерируется в процессе загрузки
страницы. Е качестве параметра передается целое число от О до 100, показывающее про
цент загрузки;
♦ loadStarted() - генерируется после начала загрузки страницы;
♦ selectionChanged() - генерируется при выделении нового · фрагмента содержимого
страницы;
♦ titleChanged(<Teкcт>) - генерируется при изменении текста заголовка страницы (со
держимого тега <title>). В параметре, передаваемом обработчику, доступен этот текст
в виде строки;
Глава 22. Основные компоненты 515
♦ ur lChanged(<Интернет-адрес QUr 1>) - генерируется при изменении интернет-адреса
текущей страницы, что может быть вызвано, например, загрузкой новой страницы. Па
раметр - новый интернет-адрес.
Класс QWebEnginePage, представляющий открытую в веб-браузере страницу, поддерживает
следующие полезные методы (полный их список смотрите на странице https://doc.qt.io/qt-6/
qwebenginepage.html):
♦ save(<Путь к файлу>, foпnat=SaveFoпnatPage .MimeHtmlSaveFormat) - сохраняет стра
ницу в файле, чей путь указан в первом параметре. Параметр format задает формат фай
ла в виде одного из следующих элементов перечисления SavePageFoпnat класса
QWebEngineDownloadRequest из модуля QtWebEngineCore:
• SingleHtmlSaveFoпnat - обычный НТМL-файл. Связанные со страницей файлы
(изображения, аудио- и видеоролики, таблицы стилей и пр.) не сохраняются;
• CompleteHtmlSaveFoпnat - то же самое, только связанные файлы будут сохранены
в каталоге, находящемся там же, где и файл со страницей, и имеющем то же имя;
• MimeHtmlSaveFoпnat - страница и все связанные файлы сохраняются в одном файле;
♦ contentsSize () - возвращает объект класса QSizeF, хранящий размеры содержимого
страницы;
♦ scrollPosition () - возвращает объект класса QPointF, хранящий позицию прокрутки
содержимого страницы;
♦ setAudioMuted(<Флaг>) - если с параметром передать значение True, все звуки, воспро
изводящиеся на странице, будут приглушены. Чтобы снова сделать их слышимыми,
нужно передать значение False;
♦ isAudioMuted() - возвращает True, если все звуки, воспроизводящиеся на странице,
приглушены, и False :._ в противном случае;
♦ setBackgroundColor (<Цвет QColor>) - задает для страницы фоновый цвет;
♦ backgroundColor () - возвращает фоновый цвет страницы в виде объекта класса QColor.
ГЛАВА 23
Списки и таблицы
Классы, реализующие всевозможные списки (раскрьmающийся, обычный и иерархический)
и таблицу, определены в модуле QtWidgets.
23.1. Раскрывающийся список
Класс QСоmЬовох реализует раскрывающийся список с возможностью выбора единственного
пункта. Иерархия наследования выглядит так:
(QObject, 'QPaintDevice) - QWidget - QComЬoBox
Формат конструктора класса QСоmЬовох:
QComЬoBox([parent=None])
23.1.1. Добавление, изменение и удаление элементов·
Для добавления, изменения, удаления и получения значений элементов предназначены сле
дующие методы класса QСоmЬовох:
♦ additem() - добавляет один элемент в конец списка. Форматы метода:
additem(<Teкcт элемента>[, <Даню:�е>])
additem(<Знaчoк Qicon>, <Текст элемента>[, <Данные>])
В параметре <Значок> задается значок, который будет отображен перед текстом. Необя
зательный параметр <Данные> указьmает произвольные данные, сохраняемые в элементе
(например, индекс в таблице базы данных);
♦ additems(<Список строк>) - добавляет несколько элементов в конец списка;
♦ insertitem() - вставляет один элемент в указанную позицию списка. Форматы метода:
insertitem(<Индeкc позиции>, <Текст элемента>[, <Данные>])
insertitem(<Индeкc позиции>, <Значок Qicon>, <Текст элемента>[; <Данные>])
♦ insertitems(<Индекс позиции>, <Список строк>) - вставляет несколько элементов в
указанную позицию списка;
♦ insertSeparator(<Индекс позиции>) - вставляет разделительную линию в указанную
позицию;
♦ setitemText(<Индекс>, <Строка>) - изменяет текст элемента с указанным индексом;
Глава 23. Списки и таблицы 517
♦ setitemicon (<Индекс>, <Значок Qicon>) - изменяет значок элемента с указанным ин
дексом;
♦ setitemData (<Индекс>, <Данные> [, role=ItemDataRole.UserRole]) - изменяет данные
у элемента с указанным индексом. Необязательный параметр role указывает роль, для
которой задаются данные. Например, если указать элемент ToolTipRole перечисления
ItemDataRole из модуля QtCore.Qt, данные зададут текст вспльrвающей подсказки, кото
рая будет отображена при наведении курсора мыши на элемент. По умолчанию изменя
ются пользовательские данные;
♦ removeitem (<Индекс>) - удаляет элемент с указанным индексом;
♦ setCurrentindex (<Индекс>) - делает элемент с указанным индексом текущим. Метод
является слотом;
♦ currentindex () - возвращает индекс текущего элемента;
♦ setCurrentText ·,<Текст>) - делает элемент с указанным текстом текущим. Метод явля
ется слотом;
♦ currentText () - возвращает текст текущего элемента;
♦ currentData ( [role=ItemDataRole. userRole]) - возвращает данные текущего элемента,
относящиеся к заданной роли;
♦ itemтext (<Индекс>) - возвращает текст элемента с указанным индексом;
♦ itemData (<Индекс> [, role=ItemDataRole.UserRole]) - возвращает данные, сохранен
ные в роли role элемента с индексом <Индекс>;
♦ count () - возвращает общее количество элементов списка. Получить количество эле
ментов можно также с помощью функции len () ;
♦ clear () - удаляет все элементы списка. Метод является слотом.
23.1.2. Изменение параметров списка
Управлять параметрами раскрывающегося списка позволяют следующие методы класса
QComЬoBox:
♦ setEditaЫe (<Флаг>) - если в качестве параметра указано значение True, пользователь
сможет вводить текст в раскрывающийся список и, возможно, добавлять таким образом
в него новые элементы;
♦ setinsertPolicy(<Peжим>) - задает режим добавления в список элементов, введенных.
пользователем. В качестве параметра указьrваются следующие элементы перечисления
InsertPolicy из класса QComЬoBox:
• Noinsert - элемент не будет добавлен;
• InsertAtTop - элемент вставляется в начало списка;
• InsertAtCurrent - будет изменен текст текущего элемента;
• In�ertAtBottom - элемент добавляется в конец списка;
• InsertAfterCurrent - элемент вставляется после текущего элемента;
• InsertBeforeCurrent - элемент вставляется перед текущим элементом;
• InsertAlphaЬetically- при вставке учитывается алфавитный порядок следования
элементов;
518 Часть 11. Библиотека PyQt 6
♦ setEditтext (<Текст>) -вставляет текст в поле редактир ования. Метод является слотом;
♦ clearEditтext() -удаляет текст из поля редактирования. Метод является слотом;
♦ setCompleter(<Список QCompleter>) - задает список вариантов значений для автоза
вершения;
♦ setValidator(<Валидатор>) - устанавливает валидатор в виде объекта класса, произ
водного от QValidator (см. разд. 22.5.3);
♦ setDuplicatesEnaЫed(<Флaг>) - если в качестве параметра _указано значение True,
пользователь может добавить элемент с повторяющимся текстом. По умолчанию повто
ры запрещены;
♦ setMaxcount(<Количество>) -задает максимальное количество элементов в списке. Если
до вызова метода количество элементов превышало это количество, лишние элементы
будут удалены;
♦ setMaxVisiЫeiterns(<Количество>) - задает максимальное количество видимых эле
ментов в раскрывающемся списке;
♦ setMinirnurnContentsLength(<Количество>) - задает минимальное количество символов,
которое должно помещаться в раскрывающемся списке;
♦ setSizeAdjustPolicy(<Режим>) - задает режим установки ширины списка при измене
нии содержимого, В качестве параметра указываются следующие элементы перечисле
ния SizeAdjustPolicy из класса QCornЬoBox:
• AdjustToContents -ширина списка подстраивается под ширину текущего содержи
мого;
• AdjustToContentsOnFirstShow - ширина списка подстраивается под ширину содер
жимого, имевшегося в списке при первом его отображении;
• AdjustToMinirnurnContentsLengthWithicon - используется значение минимальной
ширины, которое установлено с помощью метода setMinirnurnContentsLength() , плюс
ширина значка;
♦ setFrarne(<Флаг>) - если в качестве параметра указано значение _False, список будет
отображаться без рамки;
♦ seticonSize(<Размеры QSize>) -задает максимальные размеры значков;
♦ showPopup() - разворачивает список;
♦ hidePopup() - сворачивает список.
23.1.3. Поиск элементов
Произвести поиск элемента в списке позволяют методы finctтex;t() (по тексту элемента)
и findData() (по данным с указанной ролью). Методы возвращают индекс найденного эле
мента или значение -1, если таковой не бьm найден. Форматы методов:
findText(<Teкcт>[, flags=MatchFlag.MatchExactly 1
MatchFlag.MatchCaseSensitive])
findData(<Данные> [, role=IternDataRole.UserRole] [,
flags=MatchFlag.MatchExactly I MatchFlag.MatchCaseSensitive])
Параметр flags задает режим поиска. В качестве значения через оператор I можно указать
комбинацию следующих элементов перечисления MatchFlag из модуля QtCore . Qt:
Глава 23. Списки и таблицы 519
♦ MatchExactly - полное совпадение с текстом элемента;
♦ MatchContains- совпадение с любой частью текста элемента;
♦ MatchStartsWith- совпадение с началом;
♦ MatchEndsWith- совпадение с концом;
♦ MatchRegularExpression - поиск с помощью регулярного выражения;
♦ MatchWildcard - используются подстановочные знаки;
♦ MatchFixedString- поиск полного совпадения внутри строки, выполняемый по умол
чанию без учета регистра символов;
♦ MatchCaseSensitive - поиск с учетом регистра символов;
♦ мatchWrap- если. просмотрены все элементъ1 и подходящий элемент не найден, поиск
начнется с начала списка;
♦ MatchRecursive- просмотр всей иерархии.
23.1.4. Сигналы
Класс QComЬoBox поддерживает следующие сигналы:
♦ activated(<Индекс>)- генерируется при выборе пользователем пункта в списке (даже
если индекс не изменился). Внутри обработчика доступен целочисленный индекс эле
мента;_
♦ currentindexChanged(<Индeкc>) - генерируется при изменении текущего индекса.
Внутри обработчика доступен целочисленный индекс элемента (или значение -1, если
ни один элемент не выбран);
♦ currentTextChanged(<Текст>) - то же самое, что И currectindexChanged(), только в об
работчик передается текст элемента (или пустая строка, если ни один элемент не вы
бран);
♦ editTextChanged(<Текст>) - генерируется при изменении текста в поле. Внутри обра
ботчика через параметр доступен новый текст;
♦ highlighted(<Индeкc>) - генерируется при наведении курсора мыши на пункт в списке.
Внутри обработчика доступен целочисленный индекс элемента;
♦ textActivated (<Индекс>) - то же самое, что и activated(), только в обработчик пере
дается текст элемента;
♦ textHighlighted(<Текст>) - то же самое, что и highlighted(), только в обработчик пе
редается текст элемента.
23.2. Список для выбора шрифта
Класс QFontComЬoBox реализует раскрывающийся список с названиями шрифтов. Шрифт
можно выбрать из списка или ввести его название в поле - при этом станут отображаться
названия, начинающиеся с введенных букв. Иерархия наследования:
(QObject, QPaintD�vice) - QWidget - QComЬoBox - QFontComЬoBox
Формат конструктора класса QFontComЬoBox:
QFontComЬoBox( [parent=None])
520 Часть 11. Библиотека PyQt б
Класс QFontcomЬoBox наследует. все методы и сигналы класса QComЬoBox (см. разд. 23.1)
и определяет несколько дополнительных методов:
♦ setCurrentFont (<Шрифт QFont>) - делает текущим элемент, соответствующий указан
ному шрифту:
comЬoBox.setCurrentFont(QtGui.QFont("Verdana"))
Метод является слотом;
♦ currentFont() - возвращает объект класса QFont с выбранным шрифтом. Вот пример
вывода названия шрифта:
print(comЬoBox.currentFont().farnily())
♦ setFontFilters(<Фильтр>) - выводит в списке только шрифты типов, соответствующих
указанному фильтру. В качестве параметра указывается комбинация следующих элемен
тов перечисления FontFilter из класса QFontComЬoBox:
• AllFonts -все типы шрифтов;
•· scalaЬleFonts -масштабируемые шрифты;
• NonScalaЬleFonts -немасштабируемые шрифты;
• MonospacedFonts - моноширинные шрифты;
• ProportionalFonts -пропорциональные шрифты.
Класс QFontComЬoBox поддерживает сигнал currentFontChanged (<Шрифт QFont>), который
генерируется при изменении выбранного шрифта. Внутри 'обработчика доступен выбран
ный шрифт.
23.3. Роли элементов
Каждый элемент списка хранит набор величин, каждая из которых относится к определен
ной роли: текст элемента, шрифт и цвет, которыми отображается элемент, текст всплываю
щей подсказки и многое другое. Приведем роли элементов (элементы перечисления
ItemDataRole ИЗ модуля QtCore. Qt):
♦ DisplayRole -отображаемые данные (обычно текст);
♦ DecorationRole - изображение (обычно значок);
♦ EditRole -данные в виде, удобном для редактирования;
♦ ToolTipRole -текст всплывающей подсказки;
♦ StatusTipRole -текст для строки состояния;
♦ WhatsThisRole - текст для расширенной подсказки;
♦ FontRole -шрифт элемента (объект класса QFont);
♦ тextAlignmentRole -выравнивание текста внутри элемента;
♦ вackgroundRole -фон элемента (объект класса QBrush);
♦ ForegroundRole -цвет текста (объект класса QBrush);
♦ CheckStateRole -статус флажка. Могут быть указаны следующие элементы перечисле
ния CheckState из модуля QtCore.Qt:
Глава 23. Списки и таблицы 521
• Unchecked -флажок сброшен;
• PartiallyChecked-флaжoк частично.установлен;
• Checked-флажок установлен;
♦ AccessiЫeTextRole - текст, выводящийся специализированными устройствами вывода
(например, системами чтения с экрана);
♦ AccessiЫeDescriptionRole- описание элемента, выводящееся специализированными
устройствами вывода (например, системами чтения с экрана);
♦ SizeHintRole -рекомендуемый размер элемента (объект класса QSize);
♦ userRole (32) - mобые пользовательские данные (например, индекс элемента в базе
данных). Можно сохранить несколько данных, указав их в роли с индексом более 32,
например:
comЬoBox.setitemData(O, 50, role=QtCore.Qt.ItemDataRole.UserRole)
comЬoBox .setitemData(O, "Другие данные",
role=QtCore.Qt.ItemDataRole.UserRole + 1)
23.4. Модели
Для отображения данных в виде списков и таблиц применяется концепция «модель
представление»," позволяющая отделить данные от их внешнего вида и избежать дублиро
вания данных. В основе концепции лежат следующие составляющие:
♦ модель-являет<;я «оберткой» над данными. Позволяет считывать, добавлять, изменять,
удалять данные и управлять ими;
♦ представление-отображает данные модели на экране. Сразу несколько представлений
могут выводить одну и ту же модель;
♦ модель выделения- управляет выделением. 'Если одна модель выделения установлена
сразу в нескольких представлениях, то выделение элемента в одном представлении при
ведет к выделению соответствующего элемента в другом;
♦ промежуточная модель-является прослойкой между базовой моделью и представле
нием. Позволяет производить сортировку и фильтрацию данных без изменения порядка
следования элементов в базовой модели;
♦ делегат-представляет компонент для редактирования данных. Существуют стандарт
ные классы делегатов, кроме того, разработчик может создать свои классы.
23.4.1. Доступ к данным внутри модели
Доступ к данным внутри модели реализуется с помощью класса QModelindex из модуля
QtCore.
Чаще всего объект класса QМodelindex создается с помощью метода index() какого-либо
класса модели или метода currentindex(), унаследованного моделями из класса
QAЬstractitemView. Такой объект указывает на конкретные данные.
Если запрошенных данных в модели нет, возвращается пустой, невалидный объект класса
QModelindex. Его.также можно создать обычным вызовом конструктора:
QModelindex()
522 Часть 11. Библиотека PyQt б
Класс QМodelindex поддерживает следующие методы:
♦ isValid () - возвращает значение True, если объект является валидным, и False -
в противном случае;
♦ data ( [role=ItemDataRole. DisplayRoleJ) - возвращает данные, относящиеся к указан
ной в параметре role роли (по умолчанию - выводимый на экран текст элемента
списка); ·
♦ flags () - возвращает свойства элемента в виде комбинации следующих элементов
перечисления ItemFlag из модуля QtCore. Qt:
• NoitemFlags - элемент не имеет свойств;
• ItemisSelectaЫe - элемент можно выделить;
• ItemisEditaЫe - элемент можно редактировать;
• ItemisDragEnaЫed· - элемент можно перетаскивать;
• ItemisDropEnaЫed - в элемент можно сбрасывать перетаскиваемые данные;
• ItemrsuserCheckaЫe - элемент может быть установлен и сброшен;
• ItemisEnaЫed - пользовател_ь может взаимодействовать с элементом;
• ItemisAutoTristate - состояние элемента зависит от состояния вложенных в него
элементов (например, родительский элемент устанавливается, если все вложенные
в него элементы установлены, и частично устанавливается, если установлена лишь
часть вложенных элементов);
• ItemNeverHasChildren - элемент не может иметь вложенные элементы;
• ItemisUserTristate - элемент может находиться в трех состояниях (сброшенном,
частично установленном и установленном);
♦ row () - возвращает индекс строки;
♦ column () - возвращает индекс столбца;
♦ parent () - возвращает индекс элемента (объект класса QМodelindex), расположенного
на один уровень выше по иерархии. Если такого элемента нет, возвращается невалидный
объект класса QModelindex;
♦ siЫing (<Строка>, <Столбец>) - возвращает индекс элемента (объект класса
QМodelindex), расположенного на том же уровне вложенности на указанных строке и
столбце. Если такого элемента нет, возвращается невалидный объект класса QModelindex;
♦ siЫingAtRow (<Строка>) - возвращает индекс элемента (объект класса QModelindex),
расположенного на том же уровне вложенности на указанной стр·оке. Если такого эле
мента нет, возвращается невалиднь1й объект класса QModelindex;
♦ siЫingAtColumn (<Столбец>) - возвращает индекс элемента (объект класса QModelindex),
расположенного на том же уровне вложенности на указанном столбце. Если такого эле
мента нет, возвращается невалиднь1й объект класса QModelindex;
♦ model () - возвращает ссьmку на модель.
Также класс QModelindex поддерживает операторы сравнения =:�, < и ! =.
Надо учитывать, что модель может измен;иться - тогда объект класса QModelindex будет
ссьmаться на уже несуществующий элеме�т. Если необходимо сохранить ссылку на эле
мент, следует воспользоваться классом QPersistentModelindex, который содержит те же
самые методы, но обеспечивает валидность ссьmки.
Глава 23. Списки и таблицы 523
23.4.2. Класс QStringListModel
Класс QStringListModel из модуля QtCore реализует одномерную модель, содержащую спи
сок строк. Ее содержимое можно отобразить с помощью классов QListView, QComЬoBox и др.,
передав в метод setModel() представления. Иерархия наследования:
QObject - QAЬstractitemМodel - QAЬstractListModel - QStringListModel
Форматы конструктора класса QStringListModel:
QStringListModel([parent=None])
QStringListModel(<Cпиcoк строк>[, parent=None])
Пример:
1st = ['Perl', 'РНР', 'Python', 'RuЬy']
slm = QtCore .QStringListModel(lst, parent=window)
сЬо = QtWidgets .QComЬoBox()
cbo .setModel(slm)
Класс QStringListModel наследует метод index() из класса QAЬstractListModel, который
возвращает индекс (объект класса QModelindex) элемента модели. Формат метода:
index(<Cтpoкa>[, column=0] [, parent=QМodelindex()])
Первый параметр задает номер строки в модели, в которой хранится нужный элемент.
Необязательный параметр column указывает номер столбца модели - для класса
QStringListModel, позволяющего хранить простые списки строк, его следует задать равным О.
Необязательный параметр parent позволяет задать элемент верхнего уровня для искомого
элемента - если таковой не задан, будет выполнен поиск элемента на самом верхнем уров
не иерархии.
Класс QStringListModel поддерживает также следующие методы (здесь приведены только
основные - полный их список можно найти на странице https://doc.qt.io/qt-6/
qstringlistmodel.html):
♦ setStringList(<Список строк>) - устанавливает список строк в качестве содержимого
модели;
♦ stringList() - возвращает список строк, хранящихся в модели;
♦ insertRows(<Индекс>, <Количество> [, parent=QModelIndex()]) - вставляет указанное
количество пустых элементов в позицию, заданную первым параметром, остальные эле
менты сдвигаются в, конец списка. Необязательный параметр parent позволяет указать
элемент верхнего уровня, в который будут вложены добавляемые элементы, - если та
ковой не задан, элементы будут добавлены на самый верхний уровень иерархии. Метод
возвращает значение True, если операция успешно выполнена';
♦ removeRows(<Индекс>, <Количество>[, parent=QModelindex()]) - удаляет указанное
количество элементов, начиная с позиции, заданной первым параметром. Необязатель
ный параметр parent дозволяет указать элемент верхнего уровня, в который вложены
удаляемые элементы, - если таковой не задан, элементы будут удалены из самого верх
него уровня иерархии. Метод возвращает значение тrue, если операция успешно выпол
нена;
♦ setData() - задает значение для роли role элемента, на который указывает индекс,
заданный первым параметром. Формат метода:
sеtDаtа(<Индекс QModelindex>, <Значение>[, role=ItemDataRole.EditRole])
524 Часть 11. Библиотека PyQt б
Метод возвращает значение True, если операция выполнена успешно. Пример:
1st = QtWidgets.QComЬoBox()
slm = QtCore.QStringListModel(parent=window)
slm.insertRows(0, 4)
slm.setData(slm.index(0), 'Perl')
slm.setData(slm.index(l), 'РНР')
slm.setData(slm.index(2), 'Python')
slm.setData(slm.index(З), 'RuЬy')
lst.setModel(slm)
♦ data(<Индекс QМodelindex>[, role=ItemDataRole.DisplayRole]) - возвращает данные,
хранимые в роли, указанной в параметре role, элемента, на который ссылается индекс
из первого параметра;
♦ flags (.) - возвращает свойства элемента в виде комбинации элементов перечисления
ItemFlag из модуля QtCore.Qt (см.разд. 23.4.1);
♦ rowCount([parent=QМodelindex()]) - возвращает количество элементов в модели. Не-
обязательный параметр parent указывает .элемент верхнего уровня, при этом будет воз
вращено количество вложенных в него элементов. Если параметр не задан, возвращается
количество элементов верхнего уровня иерархии;
♦ sort(<Индекс столбца>[, order=SortOrder.AscendingOrder]) - производит сортировку.
Если во втором параметре указан элемент AscendingOrder перечисления SordOrder из
класса QtCore. Qt, сортировка производится в прямом порядке, а если элемент
Descending(:rder того же перечисления - в обратном.
22.4.3. Кдасс QStandardltemModel
Класс QStandarditemмodel из модуля QtGui реализует двумерную (таблица) и иерархиче
скую модели. Каждый элемент такой модели представлен классом QStandarditem из того же
модуля. Вывести на экран ее содержимое можно с помощью классов QTaЬleView, QТreeView
и др., передав модель в метод setModel() представления. Иерархия наследования:
QObject - QAЬstractitemМodel - QStandarditemМodel
Форматы конструктора класса QStandarditemМodel:
QStandarditemМodel([parent=None])
QStandarditemМodel(<Koличecтвo строк>, <Количество столбцов>[, parent=None])
Пример создания и вывода на экран таблицы из трех столбцов: значка, названия языка про
граммирования и адреса веб-сайта приведен в листинге 23 .1.
from PyQtб import QtGui, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QStandarditemМodel")
tv = QtWidgets.QТaЬleView(parent=window)
sti = QtGui.QStandarditemМodel(parent=window)
Глава 23. Списки и таблицы 525
lstl ['Perl', 'РНР', 'Python', 'RuЬy']
lst2 ['http://www.perl ..org/', 'http: //php.net/', 'https: //www.python.org/',
'https://www.ruЬy-lang.org/']
for row in range(0, 4):
if row = 2:
iconfile 'python.png'
else:
iconfile = 'icon.png'
iteml = QtGui.QStandarditem(QtGui.Qicon(iconfile), '')
item2 = QtGui.QStandarditem(lstl[row])
itemЗ = QtGui.QStandarditem(lst2[row])
sti.appendRow( [ iteml, item2, i,temЗ])
sti.setHorizontalHeaderLabels(['Знaчoк', 'Название', 'Сайт'])
tv.setModel(sti)
tv.setColurnnWidth(0, 50)
tv ..setColurnnWidth (2, 180)
tv.resize(350, 150)
window.show()
sys.exit(app.exec())
Класс QStandarditemМodel поддерживает следующие основные методы (полный их список
можно найти на странице https://doc.qt.io/qt-6/qstandarditemmodel.html):
♦ setRoWCount(<Количество строк>) - задает количество строк;
♦ setColurnnCount (<Количество столбцов>) - задает количество столбцов;
♦ rowcount([parent=QМodelindex()]) - возвращает количество строк. Необязательный
параметр parent указывает элемент верхнего уровня, при этом будет возвращено коли
чество вложенных в этот элемент строк, - если параметр не задан, возвращается коли
чество строк верхнего уровня иерархии;
♦ colurnnCount( [parent=QМodelindex()]) - возвращает количество столбцов. Необяза
тельный параметр parent в этом случае не используется;
♦ setitem(<Cтpoкa>, <Столбец>, <Элемент QStandarditem>) - устанавливает элемент в
ячейку, располагающуюся на пересечении указанных строки и столбца;
♦ appendRow(<Список элементов QStandarditem>.) - добавляет одну строку в конец моде
ли. В качестве параметра указьmается список отдельных столбцов добавляемой строки;
♦ appendRow(<Элемент QStandarditem>) - добавляет строку из одного столбца в конец
модели;
♦ appendColurnn(<Cпиcoк элементов QStandarditem>) - добавляет один столбец в конец
модели. В качестве параметра указывается список отдельных строк добавляемого столбца;
♦ insertRow (<Индекс строки>, <Список элементов QStandarditem>) - добавляет одну
строку в указанную позицию модели. В качестве параметра <Список> указывается список
отдельньrх столбцов добавляемой строки;
♦ insertRow(<Индекс строки>, <Элемент QStandarditem>) - добавляет одну строку из
одного столбца в указанную позицию модели;
♦ insertRow(<Индекс> [, parent=QМodelindex()]) - добавляет одну пустую строку в ука
занную позицию модели. Необязательный параметр parent указывает элемент верхнего
526 Часть 11. Библиотека PyQt б
уровня, в который будет вложена добавляемая строка, - если параметр не задан, строка
добавляется на самый верхний уровень иерархии. Метод возвращает значение тrue, если
операция успешно выполнена;
♦ insertRows(<Индекс>, <Количество>[, parent=QModelindex()]) - добавляет несколько
пустых строк в указанную позицmо модели. Необязательный параметр parent указывает
элемент верхнего уровня, в который будут вложены добавляемые строки, - если пара
метр не задан, строки добавляются на самый верхний уровень иерархии. Метод возвра
щает значение True, если операция успешно выполнена;
♦ insertColшnn(<Индeкc столбца>, <Список элементов QStandarditem>) - добавляет один
столбец в указанную позицmо модели. В качестве параметра <Список> указывается спи
сок отдельных строк добавляемого столбца;
♦ insertColшnn (<Индекс>[, parent=QМodelindex()]) - добавляет один пустой столбец
в указанную позицmо. Необязательный параметр parent указывает элемент верхнего
уровня - владелец элементов, в который будет добавлен столбец. Если этот параметр
не задан, столбец добавляется в элементы самого верхнего уровня иерархии. Метод воз
вращает значение True, если операция выполнена успешно;
♦ inser'tColшnns(<Индекс>, <Количество>[, parent=QModelindex()]) - добавляет не
сколько пустых столбцов в указанную позицmо. Необязательный параметр parent ука
зывает элемент верхнего уровня - владелец элементов, в который будут добавлены
столбцы. Если этот параметр не задан, столбцы добавляются в элементы самого верхне
го уровня иерархии. Метод возвращает значение тrue, если операция успешно вьшол
нена;
♦ removeRows(<Индекс>, <Количество> [, parent=QМodelindex()]) - удаляет указанное
количество строк, начиная со строки, имеющей заданнь1й индекс. Необязательный пара
метр parent указывает элемент верхнего уровня - владелец удаляемых строк. Если этот
параметр не задан, будут удалены строки из самого верхнего уровня иерархии. Метод
возвращает значение True, если операция успешно выполнена;
♦ removeColшnns(<Индекс>, <Количество> [, parent=QModelindex()]) - удаляет указанное
количество столбцов, начиная со столбца, имеющего заданный индекс. Необязательный
параметр parent указывает элемент верхнего уровня - владелец элементов, из которых
будут удалены столбцы. Если этот параметр не задан, удаляются столбцы из элементов
самого верхнего уровня иерархии. Метод возвращает значение тrue, е�ли операция
успешно выполнена;
♦ takeitem(<Строка> [, <Столбец>=О J ) - удаляет указанный элемент из модели и возвра
щает его в виде объекта класса QStandarditem;
♦ takeRow(<Ин.rieкc>) - удаляет строку с указаннь1м индексом и возвращает ее в виде спи
ска объектов класса QStandarditem;
♦ takeColшnn(<Индекс>) - удаляет столбец с указанным индексом и возвращает его в виде
списка объектов класса QStandarditem;
♦ clear() - удаляет все элементы из модели;
♦ item(<Строка> [, <Столбец>=О J ) - возвращает ссьmку на элемент (объект класса
QStandarditem), расположенный в указанной ячейке;
♦ invisiЫeRootitem() - возвращает ссылку на невидимый· корневой элемент модели
в виде объекта класса QStandarditem;
Глава 23. Списки и таблицы 527
♦ itemFromindex(<Индекс QModelIndex>) - возвращает ссылку на элемент (объект класса
QStandarditem), на который ссьшается заданный индекс;
♦ index(<Строка>, <Столбец>[, parent=QМodelindex() ]) - возвращает индекс элемента
(объект класса QModelindex), расположенного в указанной ячейке. Необязательный па
раметр parent задает элемент верхнего уровня для искомого элемента. Если таковой не
задан, будет выполнен поиск элемента на са�ом верхнем уровне иерархии;
♦ indexFromitem(<Элeмeнт QStandarditem>) возвращает индекс указанного элемента
в виде объекта класса QModelindex;
♦ setData() - задает значение для роли role элемента, на который указывает заданный
индекс. Метод возвращает значение тrue, если операция успешно выполнена. Формат
метода:
sеtDаtа(<Индекс QМodelindex>, <Значение>[, role=ItemDataRole.EditRole])
♦ dаtа(<Индекс QModelindex>[, role=ItemDataRole.DisplayRole]) - возвращает данные,
относящиеся к указанной роли элемента, на который ссьшается заданный индекс;
♦ setHorizontalHeaderLabels(<Список строк>) - задает заголовки столбцов. В качестве
параметра указывается список строк;
♦ setVerticalHeaderLabels (<Список строк>) - задает заголовки строк. В качестве пара
метра указьmается список строк;
♦ setHorizontalHeaderitem(<Индeкc>, <заголовок QStandarditem>) - задает заголовок
столбца с указанным индексом;
♦ setVerticalHeaderitem(<Индекс>, <Заголовок QStandarditem>) - задает заголовок
строки с указанным индексом;
♦ horizontalHeaderitem(<Индекс>) - возвращает заголовок (объект класса QStandarditem)
столбца с указанным индексом;
♦ verticalHeaderitem(<Индекс>) - возвращает заголовок (объект класса QStandarditem)
строки с указанным индексом;
♦ setHeaderData() - задает новое значение для указанной роли заголовка. Формат метода:
setHeaderData(<Индeкc>, <Ориентация>, <Значение>[, role=ItemDataRole.EditRole])
В первом параметре указывается индекс строки или столбца, а во втором - ориентация
в виде элемента Horizontal (горизонтальная) или Vertical (вертикальная) перечисления
Orientation из модуля QtCore.Qt. Метод возвращает значение True, если операция
успешно выполнена;
♦ headerData(<Индeкc>, <Ориентация>[, role=ItemDataRole.DisplayRole]) - возвращает
значение, соответствующее указанной роли заголовка. В первом параметре указьmается
индекс строки или столбца, а во втором - ориентация;
♦ finditems(<Текст>[, flags=MatchFlag.MatchExactly][, column=0]) - производит по
иск элемента внутри модели в указанном в параметре column столбце по заданному тек
сту. Допустимые значения параметра flags мы рассматривали в разд. 23.1.3. В качестве
значения метод возвращает список объектов класса QStandarditem или пустой список;
♦ sort (<Индекс столбца> [, order=SortOrder.AscendingOrder]) - производит сортировку.
Если во втором параметре указан элемент AscendingOrder перечисления SortOrder из
модуля QtCore.Qt, сортировка производится в прямом порядке, а если элемент
DescendingOrder того же перечисления - в обратном;
528 Часть 11. Библиотека PyQt 6
♦ setSortRole(<Роль>) - задает роль (см. разд. 23.3), по которой производится сортировка;
♦ parent (<Индекс QModelindex>) - возвращает индекс (объект класса QModelindex) роди
тельского элемента. В качестве параметра указывается индекс элемента-потомка;
♦ hasChildren([parent=QModelindex() J) - возвращает True, если заданный элемент имеет
хотя бы одного потомка, и False. - в противном случае.
При изменении значения элемента генерируется сигнал iteпChanged(<;элемент QStandarditem>) .
Внутри обработчика через параметр доступна ссылка на изменившийся элемент.
23.4.4. Класс QStandardltem
Каждый элемент модели QStandarditemМodel представлен классом QStandarditem из модуля
QtGui. Этот класс не только описывает элемент, но и позволяет создавать вложенные струк
туры, в которых любой элемент может иметь произвольное количество вложенных в него
дочерних элементов или элементов-потомков (что пригодится при выводе иерархического
списка). Форматы конструктора класса:
QStandarditem()
QStandarditem(<Teкcт>)
QStandarditem(<Знaчoк Qicon>, <Текст>)
QStandarditem(<Koличecтвo строк>[, <Количество столбцов>=l])
Последний формат задает количество дочерних элементов и столбцов в них.
Наиболее часто используемые методы класса QStandarditem приведены далее (полный их
список можно найти на странице https://doc.qt.io/qt-6/qstandardit�m.html):
♦ setRoWCount(<Количество строк>) - задает количество дочерних стр_ок;
♦ setColumnCount(<Количество столбцов>) - задает количество столбцов в дочерних
строках;
♦ rowcount() - возвращает количество дочерних строк;
♦ columnCount() - возвращает количество столбцов в дочерних строках;
♦ row() - возвращает индекс строки в дочерней таблице родительского элемента или зна
чение -1, если элемент яе содержит родителя (находится на самом верхнем уровне
иерархии);
♦ column() - возвращает индекс столбца в дочерней таблице родительского элемента или
значение -1, если элемент не содержит родителя;
♦ setChild(<Строка>, <Столбец>, <Элемент QStandard:I:tem>) - устанавливает заданный
третьим параметром элемент в указанную ячейку дочерней таблицы текущего элемента.
Пример создания иерархии и вывода ее на экран с применением иерархического списка
показан в листинге 23.2.
n�стинt,23.2. Вывод ие�рхичес1<оr� сnис�.
from PyQtб import QtGui, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QStandarditemМodel")
Глава 23. Списки t.i таблицы 529
tv = QtWidgets.QTreeView(parent=window)
sti = QtGui.QStandarditemМodel(parent=window)
rootiternl = QtGui.QStandarditern('QAЬstractitemView')
rootitem2 = QtGui.QStandarditem('Базовый класс' )
iteml = QtGui.QStandarditem('QListView')
item2 = QtGui.QStandarditem( 'Список' )
rootiteml.appendRow([iteml, item2])
iternl = QtGui.QStandarditem( 'QTaЬleView' )
item2 = QtGui.QStandarditem('Таблица')
rootiternl.appendRow([iteml, item2])
iteml = QtGui.QStandarditem('QTreeView')
item2 = QtGui.QStandarditem( 'Иерархический список')
rootiternl.appendRow([iteml, item2])
sti.appendRow([rootiteml, rootitern2])
sti.setHorizontalHeaderLabels(['Клacc', 'Описание'])
tv .setModel(sti)
tv.setColumпWidth(0, 170)
tv.resize(400, 100)
window. show()
sys.exit(app.exec())
♦ appendRow(<Список элементов QStandarditem>) - добавляет одну строку в конец дочер
ней таблицы текущего элемента. В качестве параметра указывается список отдельных
столбцов;
♦ appendRow(<Элемент QStandarditem>) - добавляет заданный элемент в конец дочерней
таблицы текущего элемента, формируя строку с одним столбцом;
♦ appendRows(<Список элементов QStandarditem>) - добавляет несколько строк, содержа
щих по одному столбцу, в конец дочерней таблицы текущего элемента, В качестве па
раметра указывается список добавляемых строк;
♦ appendColuпin(<Cпиcoк элементов QStandarditem>) - добавляет один столбец в конец
дочерней таблицы текущего элемента. В качестве параметра указывается список отдель
ных строки;
♦ insertRbw(<Индeкc строки>, <Список элементов QStaпdarditem>) - вставляет одну
строку в указанную позицию дочерней таблицы у текущего элемента. В качестве пара
метра <Список> указывается список объектов отдельных столбцов;
♦ insertRow(<Индекс строки>, <Элемент QStandarditem>) - вставляет заданный элемент
в указанную позицию дочерней таблицы у текущего элемента, формируя строку с одним
столбцом;
♦ iпsertRows(<Индекс строки>, <Список элементов QStandarditem>) - вставляет несколь
ко строк, содержащих по одному столбцу, в указанную позицию дочерней таблицы у те
кущего элемента. В качестве параметра <Список> указывается список отдельных строк;
♦ insertRows(<Индекс строки>, <Количество>) - вставляет заданное количество пустых
строк в указанную позицию дочерней таблицы для текущего элемента;
♦ insertColumп(<Индекс столбца>, <Список элементов QStandarditem>) - вставляет один
столбец в указанную· позицию дочерней таблицы у текущего элемента. В качестве пара
метра <Список> указывается список отдельных строк;
530 Часть 11. Библиотека PyQt б
♦ insertColumns (<Индекс>, <Количество>) - вставляет заданное количество пустых
столбцов в указанную позицmо дочерней таблицы у текущего элемента;
♦ removeRow (<Индекс>) - удаляет строку с указанным индексом;
♦ removeRows (<Индекс>, <Количество>) -удаляет указанное количество строк, начиная со
строки, имеющей заданный индекс;
♦ removeColumn (<Индекс>) -удаляет столбец с указанным индексом;
♦ removeColumns (<Индекс>, <Количество>) - удаляет указанное количество столбцов, на
чиная со столбца, имеющего заданный индекс;
♦ takeChild(<Cтpoкa>[, <Столбец>=ОJ) -удаляет указанный дочерний элемент и возвра
щает его в виде объекта класса QStandarditem;
♦ tаkеRоw(<Индекс>) - удаляет указанную строку из дочерней таблицы и возвращает ее
в виде списка объектов класса QStandardrtem;
♦ takeColumn(<Индeкc>) -удаляет указанный столбец из дочерней таблицы и возвращает
его в виде списка объектов класса QStandardrtem;
♦ parent () - возвращает ссылку на родительский элемент (объект класса QStandarditem)
или значение None, если текущий элемент не имеет родителя;
♦ child(<Строка> [, <Столбец>=ОJ) - возвращает ссьшку на дочерний элемент (объект
класса QStandarditem) или значение None, если такового нет;
♦ hasChildren() - возвращает значение True, если существует хотя бы один дочерний
элемент, и False - в противном случае;
♦ setData(<Значение>[, role=ItemDataRole.UserRole+ 1] ) - устанавливает значение для
указанной роли;
♦ data ( [<Poль>=ItemDataRole. UserRole+ 1 J ) - возвращает значение, которое соответству-
ет указанной роли;
♦ setтext(<Текст>) - задает текст элемента;
♦ text() - возвращает текст элемента;
♦ setTextAlignment(<Выравнивание>) - задает выравнивание текста внутри элемента в
виде элемента перечисления AlignmentFlag из модуля QtCore.Qt;
♦ seticon(<Значок Qicon>) - задает значок, который будет отображен перед текстом;
♦ setToolт ip(<Текст>) - задает текст всплывающей подсказки;
♦ setWhatsThis(<Текст>) - задает текст расширенной подсказки;
♦ setFont(<Щрифт QFont>) - задает шрифт элемента;
♦ setвackground (<Цвет QBrush>) - задает цвет фона;
♦ setForeground(<Цвет QBrush>) - задает цвет текста;
♦ setCheckaЫe (<Флаг>) - если в качестве параметра указано значение True, после текста
элемента будет выведен флажок, который можно устанавливать и сбрасьmать;
♦ isCheckaЫe() - возвращает значение True, если после текста элемента выводится фла
жок, и False - в противном случае;
♦ setCheckState(<Статус>) - задает состояние флажка. Могут быть указаны следующие
элементь1 перечисления CheckState из модуля QtCore.Qt: Unchecked (флажок сброшен),
PartiallyChecked (находится в неопределенном состоянии) и Checked (установлен);
Глава 23. Списки и таблицы 531
♦ checkState () - возвращает текущее состояние флажка в виде элемента перечисления
CheckState из модуля QtCore . Qt;
♦ setUserTristate (<Флаг>) - если в качестве параметра указано значение True, флажок
может иметь три состояния: установленное, сброшенное и неопределенное (промежу
точное);
♦ isUserTristate () - возвращает значение тrue, если флажок может иметь три состоя-
ния, и False - в противном случае;
♦ setFlags (<Флаги>) - задает свойства элемента (см.разд. 23.4. 1);
♦ flags () - возвращает значение установленных свойств элемента;
♦ setSelectaЫe (<Флаг>) - если в качестве параметра указано значение True, пользова
тель может выделить элемент;
♦ setEditaЫe (<Флаг>) - если в качестве параметра указано значение True, пользователь
может редактировать текст элемента;
♦ setDragEnaЫed (<Флаг>) - если в качестве параметра указано значение True, перетаски
вание элемента разрешено;
♦ setDropEnaЫed (<Флаг>) - если в качестве параметра указано значение True, сброс пе
ретаскиваемых данных в элемент разрешен;
♦ setEnaЫed (<Флаг>) - если в качестве параметра указано значение True, пользователь
может взаимодействовать с элементом. Значение False делает элемент недоступным;
♦ clone () - возвращает копию элемента в виде объекта класса QStandarditem;
♦ index () - возвращает индекс элемента (объект класса QModelindex);
♦ model () - возвращает ссылку на модель (объект класса QStandarditemМodel);
♦ sortChildren (<Индекс столбца> [, order=SortOrder .AscendingOrder]) - производит
сортировку дочерней таблицы. Если во втором параметре указан элемент AscendingOrder
перечисления sordOrder из модуля QtCore. Qt, сортировка производится в прямом поряд
ке, а если элемент DescendingOrder того же перечисления - в обратном.
23.5. Представления
Для отображения элементов модели предназначены следующие классы представлений:
♦ QListView - простой список с возможностью выбора как одного, так и нескольких
пунктов. Пункты списка, помимо текстовой надписи, могут содержать значки;
♦ QTaЫeView - таблица;
♦ QТreeView - иерархический список.
Также можно воспользоваться классами QComЬoBox (раскрьmающийся список - см. разд. 23. 1),
QListWidget (простой список), QTaЫeWidget (таблица) и QTreeWidget (иерархический спи
сок). Последние три класса нарушают концепцию «модель-представление», хотя и отчасти
базируются на ней. За подробной информацией по этим классам обращайтесь к докумен
тации.
532 Часть 11. Библиотека PyQt б
23.5.1: Класс QAbstractltemView
Абстрактный класс QAЬstractitemView является базовым для всех рассмотренных ранее
представлений" Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame - QAЬstractScrollArea -
QAЬstractitemView
Класс QAЬstractitemView поддерживает следующий набор полезных для нас методов (пол
ный их список можно найти на странице https://doc.qt.io/qt-6/qabstractitemview.html):
♦ setModel (<Модель>) -задает для представления модель. В качестве параметра передает
ся объект одного из классов, производных от QAЬstractitemМodel;
♦ · model () - возвращает заданную для представления модель;
♦ selectedindexes () - возвращает выделенные элементы, представленные списком объ
ектов класса QModelindex;
♦ setCurrentindex (<Индекс QМodelindex>) - делает элемент с указанным индексом теку
щим. Метод является слотом;
♦ currentindex () - возвращает индекс (объект класса QModelindex) текущего элемента;
♦ setRootindex (<Индекс QМodelindex>) - делает элемент с заданным индексом корневым.
Метод является слотом;
♦ rootindex () -возвращает индекс (объект класса QModelindex) корневого элемента;
♦ setAlternatingRowColors (<Флаг>) - если в качестве параметра указано значение True,
то четные и нечетные строки будут иметь разный цвет фона;
♦ setindexWidget (<Индекс QModelindex>, <Компонент>) - устанавливает компонент в по
зицию, указанную индексом, и делает его потомком представления. Если в той позиции
уже находится какой-либо компонент, он удаляется;
♦ indexWidget (<Индекс QМodelindex>) - возвращает ссьmку на компонент, который был
ранее установлен в позицию, указанную индексом;
♦ setSelectionМodel (<Модель вьщеления>) - устанавливает модель выделения (объект
класса QitemSelectionМodel);
♦ selectionМodel () -возвращает модель выделения (объект класса QitemSelectionМodel);
♦ setSelectionМode (<Режим>) -задает режим выделения элементов. В качестве параметра
указываются следующие элементы перечисления SelectionМode из класса
QAЬstractitemView:
• NoSelection -элементы не могут быть выделены;
• SingleSelection -можно выделить только один элемент;
• мultiSelection -можно выделить несколько элементов. Повторный щелчок на эле
менте снимает выделение;
• ExtendedSelection -можно выделить несколько элементов, щелкая на них мышью и
удерживая при этом нажатой клавишу ,<Ctrl>. Можно также нажать на элементе
левую кнопку мыши и перемещать мышь, не отпуская кнопку. Если удерживать
нажатой клавишу <Shift>, все элементы от текущей позиции до позиции щелчка
мышью выделяются;
• ContiguousSelection - можно выделить несколько элементов, нажав на элементе
левую кнопку мыши и перемещая мышь, не отпуская кнопку. Если удерживать пажа-
Глава 23. Списки и таблицы 533
той клавишу <Shift>, все элементы от текущей позиции до позиции щелчка мышью
выделяются;
♦ setSelectionBehavior(<Режим>) - задает режим представления выделенных элементов.
В качестве параметра указьmаются следующие элементы перечисления Selectionвehavior
из класса QAЬstractitemView:
• Selectitems - выделяется отдельный элемент;
• SelectRows- выделяется строка целиком;
• SelectColuпms- выделяется столбец целиком;
♦ selectAll() - выделяет все элементы. Метод является слотом;
♦ clearSelection() - снимает выделение. Метод является слотом;
♦ edit(<Индекс QМodelindex>) - переключает элемент с заданным индексом в режим
редактирования, не делая его выделенным. Метод является слотом;
♦ setEditTriggers (<Действие>) - задает действие, при котором элемент переключается
в режим редактирования. В качестве параметра указывается комбинация следующих
элементов перечисления EditTrigger из класса QAЬstractitemView:
• NoEditTriggers - элемент не будет поддерживать редактирование;
• currentChanged - при выделении-элемента;
• DouЬleClicked - при двойном щелчке мышью;
• SelectedClicked- при щелчке мышью на уже выделенном элементе;
• EditKeyPressed - при нажатии клавиши <F2>;
• AnyKeyPressed - при нажатии любой символьной клавиши;
• AllEditTriggers - при любом упомяm-том ранее действии;
♦ seticonSize(<Размеры QSize>) - задает размеры значков;
♦ setTextElideMode(<Режим>) - задает режим обрезки текста, если он не помещается
в отведенную область (в месте пропуска выводится троеточие). Могут быть указаны
следующие элементы перечисления тextElideмode из модуля QtCore .Qt:
• ElideLeft- текст обрезается слева;
•. ElideRight - текст обрезается справа;
• • ElideMiddle- текст вырезается посередине;
• ElideNone- текст не обрезается;
♦ setTabKeyNavigation(<Флаг>) - если в качестве параметра указано значение True, меж
ду элементами можно перемещаться с помощью клавиш <ТаЬ> и <Shift>+<Tab>;
♦ sсrоllТо(<Индекс QМodelindex>[, hint=ScrollHint.EnsureVisiЫe]) - прокручивает
представление таким образом, чтобы элемент, на который ссылается заданный индекс,
бьm видим. В параметре hint указьmаются следующие элементы перечисления ScrollHint
из класса QAЬstractitemView:
• EnsureVisiЫe- элемент должен находиться в области видимости;
• PositionAtTop - элемент должен находиться в верхней части;
• PositionAtBottom - элемент должен находиться в нижней части;
• PositionAtCenter-элeмeнт доЛЖен находиться в центре;
534 Часть 11. Библиотека PyQt б
♦ scrollToTop() - прокручивает представление в самое начало. Метод является слотом;·
♦ scrollToBottom () - прокручивает представление в самый конец. Метод является с.до
том;
♦ setDragEnaЫed(<Флаг>) - если в качестве параметра указано значение True, перетаски
вание элементов разрешено;
♦ setDragDropMode(<Режим>) - задает режим работы drag & drop. В качестве парамет
ра указываются следующие элементы перечисления DragDropMode из класса
QAЬstractitemView:
• NoDragDrop - drag & drop не поддерживается;
• DragOnly - поддерживается только перетаскивание;
• DropOnly - поддерживается только сбрасывание;
• DragDrop - поддерживается перетаскивание и сбрасывание;
• InternalMove - допускается лишь перетаскивание внутри компонента;
♦ setDrapDropOverwriteMode(<Флаг>) - если в качестве параметра задано значение True,
сбрасываемые данные заменят имевшиеся в элементе ранее, если False - будут встав
лены в позицию сброса (поведение по умолчанию);
♦ setDropindicatorShown(<Флaг>) - если в качестве параметра указано значение True,
позиция возможного сброса элемента будет подсвечена;
♦ setAutoScroll (<Флаг>) - если в качестве параметра указано значение True, при пере
таскивании пункта будет производиться автоматическая прокрутка;
♦ setAutoScrollMargin (<Отступ>) - задает расстояние от края области, при достижении
которого будет производиться автоматическая прокрутка области;
♦ update(<Индекс QМodelindex>) - обновляет элемент с заданным индексом. Метод явля
ется слотом.
Класс QAЬstractitemView поддерживает следующие сигналы:
♦ activated(<Индeкc QModelindex>) - генерируется при активизации элемента путем
одинарного, двойного щелчка мышью или нажатия клавиши <Enter>. В обработчике
через параметр доступен индекс активного элемента;
♦ clicked(<Индекс QModelindex>) - генерируется при щелчке мышью над элементом.
Параметр хранит индекс элемента;
♦ douЫeClicked(<Индекс QModelindex>) - генерируется при двойном щелчке мышью над
элементом. Параметр хранит индекс элемента;
♦ entered(<Индекс QМodelindex>) - генерируется при вхождении курсора мыши в об
ласть элемента. Чтобы сигнал сработал, необходимо включить обработку перемещения
курсора вызовом метода setMouseTracking (), унаследованного от класса QWidget. Внут
ри обработчика через параметр доступен индекс элемента;
♦ pressed(<Индекс QМodelindex>) - генерируется при нажатии кнопки мыши над элемен
том. Внутри обработчика через параметр доступен индекс элемента;
♦ viewportEntered() - генерируется при вхождении курсора мыши в область компонента.
Чтобы сигнал сработал, необходимо включить обработку перемещения курсора с по
мощью метода setMouseTracking(), унаследованного от класса QWidget.
Глава 23. Списки и таблицы 535
23.5.2. Простой список
Класс QListView реализует простой список с возможностью выбора как одного, так и не
скольких пунктов. Кром� текста, в любом пункте такого списка может присутствовать зна
чок (рис. 23.1). Иерархия наследования выглядиттак:
(QObject, QPaintDevice) - QWidget - QFrame - QAЬstractScrollArea -
QAЬstractltemView - QListView
[iJ QListView □ х
:jJ: Perl
·'/J:- РНР
� Python
·'/J:- Ruby
Рис. 23.1. KoмnoнeнтQListView
Формат конструктора класса QListView:
QListView([parent=None])
Типичный пример использования списка приведен в листинге 23.3.
from PyQtб import QtGui, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.'QWidget()
window.setWindowТitle("QListView")
lv = QtWidgets.QListView(parent=window)
sti = QtGui.QStandardltemМodel(parent=window)
1st = ['Perl', 'РНР', 'Python', 'RuЬy']
for row in range(0, 4):
if row == 2:
iconfile 'python.png'
else:
iconfile = 'icon.png'
item = QtGui.QStandardltem(QtGui.Qicon(iconfile), lst[row])
sti. appendRow(item)
lv.setModel(sti)
lv.resize(250, 100)
window. show()
sys.exit(app.exec())
Класс QListView наследует все методы и сигналы из класса QAЬstractitemView (см.разд. 23.5.1),
включая методы setModel(), model() и selectedlndexes () . Помимо этого, он дополнительно
определяет следующие методы (здесь приведены только основные - полный их список
можно найти на странице https://doc.qt.io/qt-6/qlistview.html):
536 Часть 11. Библиотека PyQt б
♦ setModelColшnn (<Индекс>) - задает индекс отображаемого столбца в табличной модели
(по умолчанию отображается первый столбец с индексом О);
♦ setViewМode (<Режим>) - задает режим отображения элементов. В качестве параметра
указываются следующие элементы перечисления ViewMode из класса QListView:
• Listмode - элементы выстраиваются по вертикали, а значки имеют маленькие раз
меры;
• IconМode - элементы выстраиваются по горизонтали, а значки имеют большие раз
меры. Элементы можно свободно перемещать мышью;
♦ setмovement (<Режим>) - задает режим перемещения элементов. В качестве параметра
указываются следующие элементы перечисления Movement из класса QListView:
• Static - пользователь не может перемещать элементы;
• Free - свободное перемещение;
• snap - перемещаемые элементы автоматически выравниваются по сетке, размеры
которой задаются методом setGridSize ();
♦ setGridSize (<Размеры QSize>) - задает размеры отдельной ячейки сетки, по которой
выравниваются перемещаемые элементы;
♦ setResizeMode (<Режим>) - задает режим расположения элементов при изменении раз
мера списка. В качестве параметр:� указываются следующие элементы перечисления
ResizeMode из класса QListView:
• Fixed - элементы остаются в том же положении;
• Adjust - положение элементов изменяется при изменении размеров;
♦ setFlow (<Режим>) - задает порядок вьmода элементов. В качестве параметра указыва
ются следующие элементы перечисления Flow из класса QListView: LeftToRight (слева
направо) и TopToBottom (сверху вниз);
♦ setwrapping (<Флаг>) - если в качестве параметра указано значение False, перенос эле
ментов на новую строку (если они не помещаются в ширину области) запрещен;
♦ setWordWrap (<Флаг>) - если в качестве параметра указано значение True, текст элемен
тов при необходимости будет переноситься по строкам;
♦ setLayoutMode (<Режим>) - задает режим размещения элементоl). В качестве параметра
указываются следующие элементы перечисления LayoutMode из класса QListView:
• SinglePass - элементы размещаются все сразу. Если список слишком большой, то
, окно останется заблокированнь1м, пока все элементы не будут отображены;
• вatched - элементы размещаются блоками. Размер такого блока задается методом
setBatchSize ();
♦ setBatchSize (<Количество>) - задает количество элементов в отдельном блоке, если
в качестве режима размещения элементов указан Batched;
♦ setUniformrtemSizes (<Флаг>) - если в качестве параметра указано значение True, все
элементы будут иметь одинаковый размер (по умолчанию они имеют разные размеры,
зависящие от содержимого);
♦ setSpacing (<Отступ>) - задает отступ вокруг элемента;
♦ setSelectionRectVisiЫe (<Флаг>) - если в качестве параметра указано значение True,
будет отображаться вспомогательная рамка, показывающая область выделения. Метод
доступен только при использовании режима множественного выделения;
Глава 23. Списки и таблицы 537
♦ setRowHidden(<Индекс>, <Флаг>) - если во втором параметре указано значение True,
строка с индексом, указанным в первом параметре, будет скрыта. Значение False ото
бражает строку;
♦ isRowHidden(<Индекс>) - возвращает значение True, если строка с указанным индексом
скрыта, и False - в противном случае.
Класс QListView поддерживает сигнал indexesMoved(<Список индексов QМodelindex>), гене
рируемый при перемещении элементов. Внутри обработчика через параметр доступен спи
сок индексов перемещаемых элементов.
23.5.3. Таблица
Класс QTaЬleView реализует таблицу (рис. 23.2). Иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget � QFrame - QAЬstractScrollArea -
QAЬstractiternView - QTaЬleView
! i] QTaЫeView о х
Значок Название Сайт
1 [=]Perl http://www.per!.org/
РНР http://php.net/
Python https://www.python.org/
Ruby https://www.ruby
-lan����
------ 1
Рис. 23.2. Компонент QTaЬleView
Формат конструктора класса QTaЫeView:
QTaЫeView( [parent=None])
Класс QTaЬleView наследует все методы и сигналы из класса QAЬstractiternView
(см. разд. 23.5.1) и дополнительно поддерживает следующие методы (здесь приведены только
основные - полный их список можно найти на странице https://doc.qt.io/qt-6/qtaЫeview.html):
♦ selectRow(<Индекс>) - выделяет строку с указанным индексом. Метод является слотом;
♦ selectColurnn(<Индeкc>) - выделяет столбец с указанным индексом. Метод является
слотом;
♦ horizontalНeader() - возвращает ссылку на горизонтальный заголовок, представлен
ный объектом класса QHeaderView;
♦ verticalHeader() - возвращает ссьшку на вертикальный заголовок, представленный
объектом класса QHeaderView. Например, вывести таблицу без заголовков можно сле
дующим образом:
view.horizontalHeader() .hide()
view.verticalHeader() .hide()
♦ setRowHeight(<Индекс>, <Высота>) - задает высоту строки с указанным в первом пара
метре индексом;
♦ rowHeight(<Индекс>) - возвращает высоту строки с указанным индексом;
538 Часть 11. Библиотека PyQt б
♦ setColurnnWidth(<Индекс>, <Ширина>) - задает ширину столбца с указанным в первом
параметре индексом;
♦ colurnnWidth(<Индекс>) - возвращает ширину столбца с указанным индексом;
♦ resizeRowТoContents(<Индекс строки>) - изменяет размер указанной строки таким
образом, чтобы в нее поместилось все содержимое. Метод является слотом;
♦ resizeRowsToContents() - изменяет размер всех строк таким образом, чтобы в них по
местилось все содержимое. Метод является слотом;
♦ resizeColurnnToContents(<Индекс столбца>) - изменяет размер указанного столбца
таким образом, чтобы в него поместилось все содержимое. Метод является слотом;
♦ resizeColurnnsToContents() - изменяет размер всех столбцов таким образом, чтобы
в них поместилось содержимое. Метод является слотом;
♦ setSpan() - растягивает элемент с указанными в первых двух параметрах индексами на
заданное количество строк и столбцов, производя как бы объединение ячеек таблицы.
Формат метода:
sеtSраn(<Индекс строки>, <Индекс столбца>, <Количество строк>,
<Количество столбцов>)
♦ rowSpan (<Индекс строки>, <Индекс столбца>) - возвращает количество ячеек в строке,
которое занимает элемент с указанными индексами;
♦ colurnnSpan(<Индекс строки>, <Индекс столбца>) - возвращает количество ячеек в
столбце, которое занимает элемент с указанными индексами;
♦ clearSpans() - отменяет все объединения ячеек;
♦ setRowHidden (<Индекс>, <Флаг>) - если во втором параметре указано значение True, то
строка с индексом, указанным в первом параметре, будет скрыта. Значение False ото
бражает строку;
♦ hideRow(<Индекс>) - скрьmает строку с указанным индексом. Метод является слотом;
♦ showRow(<Индекс>) - отображает строку с указанным индексом. Метод является слотом;
♦ isRowHidden (<Индекс>) - возвращает значение True, если строка с указанным индексом
скрыта, и False - в противном случае;
♦ setColurnnНidden(<Индeкc>, <Флаг>) - если во втором параметре указано значение True,
то столбец с индексом, указанным в первом параметре, будет. скрыт. Значение False
отображает столбец;
♦ hideColurnn (<Индекс>) - скрывает столбец с указанным индексом. Метод является сло
том;
♦ shoWColurnn (<Индекс>) - отображает столбец с указанным индексом. Метод является
слотом;
♦ isColurnnHidden (<Индекс>) - возвращает значение True, если столбец с указанным ин
дексом скрыт, и False - в противном случае;
♦ isindexHidden (<Индекс QModelindex>) - возвращает значение True, если элемент с ука
занным индексом скрыт, и False - в противном случае;
♦ setGridStyle(<Стиль>) - задает стиль линий сетки. В качестве параметра указываются
следующие элементы перечисления PenStyle из модуля Qtcore.Qt:
Глава 23. Списки и таблицы 539
• NoPen - линии не выводятся;
• SolidLine - СШiошная линия;
• DashLine - штриховая линия;
• DotLine - точечная линия;
• DashDotLine - штрих и точка, штрих и точка и т. д.;
• DashDotDotLine - штрих и две точки, штрих и две точки и т. д.;
♦ setshowGrid(<Флaг>) - если в качестве параметра указано значение тrue, то сетка будет
отображена, а если False - то скрыта. Метод является слотом;
♦ setSortingEnaЫed(<Флaг>) - если в качестве параметра указано значение True, столб
цы можно сортировать, щелкая мышью на их заголовках. При этом в заголовке показы
вается текущее направление сортировки;
♦ setCornerButtonEnaЫed (<Флаг>) - если в качестве параметра указано значение True,
с помощью кнопки в левом верхнем углу заголовка можно выделить всю таблицу. Зна
чение False отключает кнопку;
♦ setWordWrap (<Флаг>) - если в качестве параметра указано значение True, текст элемен
тов при необходимости будет переноситься по строкам;
♦ sortByColumn(<Индекс столбца>, <Направление>) - производит сортировку. Если во
втором параметре указан элемент AscendingOrder перечисления SortOrder из модуля
QtCore. Qt, сортировка производится в прямом порядке, а если элемент DescendingOrder
того же перечисления - в обратном. Метод является слотом.
23.5.4. Иерархический список
Класс QTreeView реализует иерархический список (рис. 23.3). Иерархия наследования:
:QObject, QPaintDevice) - QWidget - QFrarne - QAЬstractScrollArea -
QAЬstractitemView - QТreeView
Формат конструктора класса QTreeView:
JTreeView( [parent=None])
liJ QТreeView □ х
Класс Описание
V OAbstractltemView Базовый класс
QlistView Список
QTaЫeView Таблица
QTreeView Иерархический список
> OAbstractltemModel Базовый класс
Рис. 23.3. Компонент QTreeView
Класс QTreeView наследует все методы и сигналы класса QAЬstractrtemView (см. разд. 22.5.1)
и дополнительно поддерживает следующие методы (здесь приведены только основные -
полный их список можно найти на странице https://doc.qt.io/qt-6/qtreeview.html):
540 Часть 11. Библиотека PyQt 6
♦ header() - возвращает ссьmку на горизонтальный заголовок (объект класса QHeaderView);
♦ ,setColumnWidth(<Индекс>, <Ширина>) - задает ширину столбца с указанным в первом
параметре индексом;
♦ columnWidth(<Индекс>) - возвращает ширину столбца;
♦ rowHeight(<Индекс QМodelindex>) - возвращает высоту строки, в которой находится
элемент с указанным индексом;
♦ resizeColumnToContents(<Индекс столбца>) - изменяет ширину указанного столбца
таким образом, чтобы в нем поместилось все содержимое. Метод является слотом;
♦ setUniformRowHeights(<Флаг>) - если в качестве параметра указано значение True, все
элементы будут иметь одинаковую высоту;
♦ setHeaderHidden (<Флаг>) - если в качестве параметра указано значение True, заголовок
будет скрыт. Значение False отображает заголовок;
♦ isHeaderHidden () - возвращает значение True, если заголовок скрыт, и False - в про
тивном случае;
♦ setColumnHidden(<Индекс>, <Флаг>) - если во втором параметре указано значение True,
то столбец с индексом, указанным в первом параметре, будет скрыт. Значение False
отображает столбец;
♦ hideColumn(<Индeкc>) - скрывает столбец с указанным индексом. Метод является сло
том;
♦ showColumn(<Индeкc>) - отображает столбец с указанным индексом. ·Метод является
слотом;
♦ isColumnHidden (<Индекс>) - возвращает значение тrue, если столбец с указанным
индексом скрыт, и False - в противном случ�е;
♦ setRowHidden(<Индeкc>, <Индекс родителя QМodelindex>, <Флаг>) - если в третьем па
раметре указано значение True, то строка с указанными индексом и индексом родителя
будет скрыта. Значение False отображает строку;
♦ isRowHidden(<Индекс>, <Индекс родителя QМodelindex>) - возвращает значение True,
если строка с указанными индексом и индексом родителя скрыта, и False - в против
ном случае;
♦ isindexHidden(<Индeкc QModelindex>) - возвращает значение True, если элемент с ука
занным индексом скрыт, и False - в противном случае;
♦ setExpanded(<Индeкc QModelindex>, <Флаг>) - если во втором параметре указано зна
чение True, то элементы, которые являются дочерними для элемента с указанным в пер
вом параметре индексом, будут отображены, а если False - то скрыты;
♦ ехраnd(<Индекс QModelindex>) - отображает элементы, которые являются дочерними
для элемента с указанным индексом. Метод является слотом;
♦ expandToDepth(<Уровень>) ---:- отображает все дочерние элементы до указанного уровня.
Метод является слотом;
♦ expandAll() - отображает все дочерние элементьr. Метод являе�;ся слотом;
♦ collapse(<Индекс QМodelindex>) - скрывает элементы, которые являются дочерними
для элемента с указанным индексом. Метод является слотом;
♦ collapseAll() - скрывает все дочерние элементы. Метод является слотом;
Глава 23. Списки и таблицы 541
♦ isExpanded(<Индeкc QМodelindex>) - возвращает значение True, если элементы, кото
рые являются дочерними для элемента с указанным индексом, отображены, и False -
в противном случае;
♦ setitemsExpandaЫe(<Флаг>) - если в качестве параметра указано значение False, поль
зователь не сможет отображать или скрьшать дочерние элементы;
♦ setAnimated(<Флaг>) - если в качестве параметра указано значение True, отображение
и сокрытие дочерних элементов будет производиться с анимацией;
♦ setindentation(<Отступ>) - задает отступ для дочерних элемен7:ов;
♦ setRootisDecorated(<Флaг>) - если в качестве параметра указано значение False,
у элементов верхнего уровня не будут показываться элементы управления, с помощью
которых производится отображение и сокрытие дочерних элементов;
♦ setFirstColumnSpanned() - если третьим параметром передано значение True, содер
жимое первого столбца строки с указанными индексом и индексом родителя, займет всю
ширину списка. Формат метода:
setirstColumnSpanned(<Индeкc строки>, <Индекс родителя QModelindex>, <Флаг>)
♦ setExpandsOnDouЫeClick(<Флаг>) - если передать в параметре значение False, свора
чивание и разворачивание пунктов списка будут выполняться по двойному щелчку мыши;
♦ setSortingEnaЫed(<Флaг>) - если в качестве параметра указано значение тrue, столб
цы можно сортировать щелчками мыши на их заголовках. При этом в заголовке показы
вается текущее направление сортировки;
♦ setWordWrap(<Флаг>) - если в качестве параметра указано значение True, текст элемен
тов при необходимости будет переноситься по строкам;
♦ sortByColumn(<Индекс столбца>, <Направление>) - производит сортировку. Если во
втором параметре указан элемент AscendingOrder перечисления SortOrder из модуля
QtCore . Qt, сортировка производится в прямом порядке, а если элемент DescendingOrder
того же перечисления - в обратном. Метод является слотом.
Класс QTreeView поддерживает сигналы:
♦ ехраndеd(<Индекс QМodelindex>) - генерируется при отображении дочерних элементов.
Внутри обработчика через параметр доступен индекс элемента-родителя;
♦ collapsed(<Индекс QМodelindex>) - генерируется при сокрытии дочерних элементов.
Внутри обработчика через параметр доступен индекс элемента-родителя.
23.5.5. Управление заголовками строк и столбцов
Класс QHeaderView представляет заголовки строк и столбцов в компонентах QTaЬleView и
QТreeView. Получить ссьшки на заголовки в IOiacce QТaЫeView позволяют методы
riorizontalHeader() и verticalHeader(), а для установки заголовков предназначены методы
setHorizontalHeader() и setVerticalHeader(). Получить ссылку на заголовок в классе
JTreeView позволяет метод header(), а для установки заголовка предназначен метод
setHeader(). Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QFrame - QAЬstractScrollArea -
QAЬstractitemView - QHeaderView
Формат конструктора класса QHeaderView:
QНеаdеrViеw(<Ориентация>[, parent=None])
542 Часть 11. Библиотека PyQt б
В качестве ориентации указываются элементы Horizontal (горизонтальная) или vertical
(вертикальная) перечисления Orientation из модуля QtCore. Qt.
Класс QHeaderView наследует все методы и сигналы класса QAЬstractitemView (см.разд. 23.5.1)
и дополнительно определяет следующие основные методы (полный их список можно найти
на странице https://doc.qt.io/qt-6/qheaderview.html):
♦ count() - возвращает количество секций в заголовке. Получить количество секций
можно также с помощью функции len() ;
♦ setDefaultSectionSize(<Размер>) - задает размер секций по умолчанию;
♦ defaultSectionSize() - возвращает размер секций по умолчанию;
♦ setMinimumSectionSize(<Размер>) -задает минимальный размер секций;
♦. minimumSectionSize () - возвращает минимальный размер секций;
♦ setMaximumSectionSize(<Размер>) -задает максимальный размер секций;
♦ maximumSectionSize() -возвращает максимальный размер секций;
♦ resizeSection(<Индeкc>, <Размер>) - задает новый размер у секции с указанным ин
дексом;
♦ sectionSize(<Индекс>) -возвращает размер секции с указанным индексом;
♦ setSectionResizeMode(<Режим>) - задает режим изменения размеров у всех секций.
В качестве параметра могут быть указаны следующие элементы перечисления
ResizeMode из класса QHeaderView:
• Interactive - размер может быть изменен пользователем или программно;
• stretch - секции равномерно распределяют свободное пространство между собой.
Размер не может быть изменен ни пользователем, ни программно;
• Fixed - размер может быть изменен только программно;
• Resizeтocontents - размер определяется автоматически по содержимому секции.
Размер не может быть изменен ни пользователем, ни программно;
♦ setSectionResizeMode(<Индекс>, <Режим>) - задает режим изменения размеров у сек
ции с указанным индексом;
♦ setStretchLastSection(<Флaг>) - если в качестве параметра указано значение True,
последняя секция будет занимать все оставшееся свободное пространство;
♦ setCascadingSectionResizes(<Флаг>) - если в качестве параметра указано значение
тrue, изменение размеров одной секции может привести к изменению размеров других
секций;
♦ setSectionHidden (<Индекс>, <Флаг>) - если во втором параметре указано значение
тrue, секция с индексом, указанным в первом параметре, будет скрыта. Значение False
отображает секцию;
♦ hideSection (<Индекс>) -скрывает секцию с указанным индексом;
♦ showsection(<Индекс>) - отображает секцию с указанным индексом;
♦ isSectionHidden(<Индекс>) - возвращает значение True, если секция с указанным ин
дексом скрыта, и False - в противном случае;
♦ sectionsHidden() - возвращает значение тrue, если существует хотя бы одна скрытая
секция, и False - в противном случае;
Глава 23. Списки и таблицы 543
♦ hiddenSectionCount () � возвращает количество скрытых секций;
♦ setDefaultAlignment(<Выравнивание>) - задает выравнивание текста внутри заголовков
в виде элемента перечисления AlignmentFlag из модуля QtCore.Qt (см.разд. 21.2);
♦ setHighlightSections(<Флаг>) - если в качестве параметра указано значение True, то
текст заголовка текущей секции будет выделен;
♦ setSectionsClickaЫe(<Флаг>) - если в качестве параметра указано значение True, за
головок будет реагировать на щелчок мышью, при этом выделяя все элементы секции;
♦ setSectionsMovaЫe (<Флаг>) - если в качестве параметра указано значение True, поль
зователь может перемещать секции с помощью мыши;
♦ sectionsMovaЫe () - возвращает значение True, если пользователь может перемещать
секции с помощью мыши, и False - в противном случае;
♦ moveSection (<Откуда>, <Куда>) - позволяет переместить секцию. В параметрах указы
ваются визуальные индексы;
♦ swapSections(<Секuия 1>, <Секuия 2>) - меняет две секции местами. В параметрах
указываются визуальные индексы;
♦ visualindex (<Логический индекс>) - преобразует логический индекс (первоначальный
порядок следования) в визуальный (отображаемый в настоящее время порядок следова
ния). Если преобразование прошло неудачно, возвращается значение -1;
♦ logicalindex (<Визуальный индекс>) - преобразует визуальный индекс (отображаемый
в настоящее время порядок следования) в логический (первоначальный порядок следо
вания). Если преобразование прошло неудачно, возвращается значение -1;
♦ savestate() - возвращает объект класса QByteArray с текущими размерами и положе
нием секций;
♦ restoreStat.e(<Объект QByteArray>) - восстанавливает размеры и положение секций на
основе з�анного объекта класса QByteArray, возвращаемого методом saveState().
Класс QHeaderView поддерживает следующие сигналы (здесь приведеньi только основные -
полный их список можно найти на странице https://doc.qt.io/qt-6/qheaderview.html):
♦ sectionPressed(<Логический индекс>) - генерируется при нажатии левой кнопки мыши
над заголовком секции. Внутри обработчика через параметр доступен целочисленньrй
логический индекс секции;
♦ sectionClicked (<Логический индекс>) - генерируется при нажатии и отпускании левой
кнопки мыши над заголовком секции. Внутри обработчика через параметр доступен
целочисленньrй логический индекс секции;
♦ sectionDouЫeClicked(<Лoгичecкий индекс>) - генерируется при двойном щелчке
мышью на заголовке секции. Внутри обработчика через параметр доступен целочислен
нь1й логический индекс секции;
♦ sectionМoved(<Логический индекс>, <СтаRый визуальный индекс>, <Новый визуальный
индекс>) - генерируется при изменении положения секции. Все параметры целочис
ленные;
♦ sectionResized(<Логический индекс>, <Старый размер>, <Новый размер>) - генериру
ется непрерывно при изменении размера секции. Все параметры целочисленньrе.
544 Часть 11. Библиотека PyQt б
23.6. Управление выделением элементов
Класс QitemSelectionМodel, определенный в модуле QtCore, реализует модель, позволяю
щую централизованно управлять выделением сразу в нескольких представлениях. Устано
вить модель выделения позволяет метод setSelectionМodel() класса QAЬstractitemView, а
получить ссылку на модель можно с помощью метода selectionМodel(). Если одна модель
выделения установлена сразу в нескольких представлениях, то выделение элемента в одном
представлении приведет к выделению соответствующего элемента в другом представлении.
Иерархия наследования выглядит так:
QObject - QitemSelectionМodel
Форматы конструктора класса QitemSelectionМodel:
QitemSelectionМodel([<Мoдeль>J)
QitemSelectionМodel(<Мoдeль>, <Родитель>)
Класс QitemSelectionМodel поддерживает следующие полезные методы (полный их список
можно найти на странице https://doc.qt.io/qt-6/qitemselectionmodel.html):
♦ hasSelection() - возвращает значение тrue, если существует выделенный элемент,
и False - в противном случае;
♦ isSelected(<Индeкc QМodelindex>) - возвращает значение True, если элемент с указан
ным индексом выделен, и False - в противном случае;
♦ isRowSelected(<Индекс> [, <Индекс родителя QМodel Index>J) - возвращает значение
True, если строка с указанными индексом и индексом родителя выделена, и False - в про
тивном случае. Если индекс родителя не указан, проверяется строка верхнего уровня иерар
хии;
♦ isColumnSelected (<Индекс> [, <Индекс родителя QModelindex>J) - возвращает значение
True, если столбец с указанными индексом и индексом родителя выделен, и False -
в противном случае. Если индекс родителя не указан, проверяется столбец верхнего уровня
иерархии;
♦ rowintersectsSelection(<Индекс> [, <Индекс родителя QModelindex>]) - возвращает
значение True, если строка с указанными индексом и индексом родителя содержит выде
ленный элемент, и False - в противном случае. Если индекс родителя не указан, проверя
ется строка верхнего уровня иерархии;
♦ columnintersectsSelection( <Индекс> [, <Индекс родителя QModelindex>] ) - возвраща
ет значение тrue, если столбец с указанными индексом и индексом родителя содержит
выделенный элемент, и False - в противном случае. Если индекс родителя не указан,
проверяется столбец верхнего уровня иерархии;
♦ . selectedindexes() - возвращает список индексов (объектов класса QModelindex) выде
ленных элементов или пустой список, если выделенных элементов нет;
♦ selectedRows([ <Индекс столбца>=О] ) - возвращает СПИСОК индексов (объектов класса
QМodelindex) выделенных элементов из указанного столбца. Элемент попадет в список
только в том случае, если строка выделена полностью;
♦ selectedColumns([<Индекс �троки>=ОJ) - возвращает список индексов (объектов класса
QModelindex) выделенных элементов из указанной строки. Элемент попадет в список
только в том случае, если столбец выделен полностью;
Глава 23. Списки и таблицы 545
♦ selection() - возвращает ссылку на объект класса QitemSelection;
♦ select(<Индекс QModelindex>, <Режим>) - изменяет выделение элемента с указашп.1м
индексом. Во втором параметре указьmаются следующие элементы (или их комбинация
через оператор 1) перечисления SelectionFlag из класса QitemSelectionМodel:
• NoUpdate - без изменений;
• Clear - снимает выделение всех элементов;
• Select-выделяет элемент;
• Deselect - снимает выделение с элемента;
• · тoggle -выделяет элемент, если он не выделен, или снимает выделение, если эле-
мент был выделен;
• Current-обновляет выде,11ение текущего элемента;
• Rows - индекс будет расширен так, чтобы охватить всю строку;
• Colwnns-индекс будет расширен так, чтобы охватить весь столбец;
• SelectCurrent-комбинация Select Current;
• ToggleCurrent-комбинация Toggle Current;
• ClearAndSelect -комбинация Clear Select.
Метод является слотом;
♦ select(<Выделение QI-temSelection>, <Режим>) - задает новое выделение элементов.
Метод является слотом;
♦ setCurrentindex(<Индeкc QModelindex>, <Режим>) -делает элемент с задашп.1м индек-
сом текущим и изменяет режим выделения. Метод является слотом;
♦ currentindex() -возвращает индекс (объект класса QModelindex) текущего элемента;
♦ clearSelection() -снимает все выделения. Метод является слотом.
Класс QitemSelectionМodel поддерживает следующие сигналы:
♦ currentChanged(<Предыдущий индекс>, <Новый индекс>) -генерируется при выделении
другого элемента. Внутри обработчика через первый параметр доступен индекс ранее
выделенного элемента, а через второй - индекс вновь выделенного элемента (объекты
класса QModelindex);
♦ currentRowChanged(<Предыдущий индекс>, <Новый индекс>) -генерируется при выделе
нии элемента из другой строки. Внутри обработчика через первый параметр доступен
индекс предыдущего элемента, а через второй - индекс нового �лемента (объекть1 клас-
са QModelindex);
♦ currentColwnnChanged (<Предыдущий индекс>, <Новый индекс>) - генерируется при вы
делении элемента из другого столбца. Внутри обработчика через первьiй параметр дос
тупен индекс предыдущего элемента, а через второй-индекс нового элемента (объек
ты класса QModelindex);
♦ selectionChanged(<Предьщущее выделение>, <Новое вьщеление>) - генерируется при
изменении выделения. Внутри обработчика через первый параметр доступно предыду
щее выделение, а через второй-новое выделение (объекты класса QitemSelection).
546 Часть 11. Библиотека PyQt б
22. 7. Промежуточные модели
Одну модель можно установить в нескольких представлениях. При этом изменение порядка
следования элементов в одном представлении повлечет за собой изменение порядка следо
вания элементов в другом. Чтобы предотвратить изменение порядка следования элемен
тов в базовой модели, следует создать промежуточную модель с помощью класса
QSortFilterProxyМodel из модуля QtCore и установить ее в представлении. Иерархия насле
дования класса QSortFilterProxyМodel выглядит так:
QObject - QAЬstractitemМodel - QAЬstractProxyModel - QSortFilterProxyМodel
Формат конструктора класса QSortFilterProxyМodel:
QSortFilterProxyМodel([parent=None])
Класс QSortFilterProxyМodel наследует следующие методы из класса QAЬstractProxyМodel
(здесь приведены только основные - полный их список можно найти на странице
https://doc.qt.io/qt-6/qabstractproxymodel.html):
♦ setSourceModel(<Модель>) - устанавливает базовую модель;
♦ sourceModel() - возвращает ссьmку на базовую модель.
Класс QSortFilterProxyМodel поддерживает основные методы обычных моделей и допол
нительно определяет следующие основные методы (полный их список можно найти на
странице https://doc.qt.io/qt-6/qsortfilterproxymodel.html):
♦ sort(<Индекс столбца>[, order= SortOrder. AscendingOrder]) - производит сортировку.
Если во втором параметре указан элемент AscendingOrder перечисления SortOrder из
модуля QtCore.Qt, сортировка производится в прямом порядке, а если элемент
DescendingOrder того же перечисления '-- в обратном. Если в параметре <Индек� столб
ца> указать значение -1, будет использован порядок следования элементов из базовой
модели.
ПРИМЕЧАНИЕ
Чтобы включить сортировку столбцов пользователем, следует передать значение True
в метод setSortingEnaЫed () объекта представления.
♦ setSortRole(<Роль>) - задает роль (см. разд. 23.3), по которой производится сортиров
ка. По умолчанию сортировка производится по роли rt.emDataRole.DisplayRole;
♦ setSortCaseSensitivity(<Peжим>) - если в качестве параметра указать элемент
Caseinsensitive перечисления CaseSensitivity из модуля QtCore.Qt, при сортировке
регистр символов учитываться не будет, а если элемент casesensitive того же перечис
ления - то будет;
♦ setSortLocaleAware(<Флаг>) - если в качестве параметра указать значение тrue, при
сортировке будут учитываться настройки локали;
♦ setFilterFixedString(<Фрагмент>) - выбор из модели элементов, которые содержат
заданный фрагмент. Если указать пустую строку, в результат попадут все строки из
базовой модели. Метод является слотом;
♦ setFilterRegularExpression() - выбор из модели элементов, соответствующих указан
ному регулярному выражению. Если указать пустую строку, в результат попадут все
строки из базовой модели. Форматы метода:
Глава 23. Списки и таблицы 547
setFilterRegularExpression(<Peгyляpнoe выражение QRegularExpression>)
setFilterRegularExpression(<Cтpoкa с регулярным выражением>)
Второй формат метода является слотом;
♦ setFilterWildcard(<Шаблон>) - выбор из модели элементов, соответствующих указан
ной строке, которая может содержать подстановочные знаки:
• ? - один любой символ;
• * - нуль или более любых символов;
• [ ••• J - диапазон значений.
Остальные символы трактуются как есть. Если в качестве параметра указать пустую
строку, в результат попадут все элементы из базовой модели. Метод является слотом;
♦ setFilterKeyColumn(<Индекс>) - задает индекс столбца, по которому будет произво
дит.ься фильтрация. Если в качестве параметра указать значение -1, будут просматри
ваться элементы во всех столбцах. По умолчанию фильтрация производится по первому
столбцу;
♦ setFilterRole(<Роль>) - задает роль (см. разд. 23.3), по которой производится фильт
рация. По умолчанию фильтрация производится по роли ItemDataRole. DisplayRole;
♦ setFilterCaseSensitivity(<Peжим>) - если в качестве параметра указать элемент
Caseinsensitive перечисления CaseSensitivity из модуля QtCore.Qt, при фильтрации
регистр символов учитываться не будет, а если элемент casesensitive того же перечис
ления - то будет;
♦ setRecursiveFilteringEnaЫed(<Флaг>) - если в качестве параметра указано True, так
же будет выполняться фильтрация вложенных элементов, и у всех вложенных элемен
тов, соответствующих фильтру, будут видны родители.Если False, дочерние элементы
фильтроваться не будут (поведение по умолчанию);
♦ setAutoAcceptChildRows(<Флаг>) - если в качестве параметра указано True, у родитель
ских элементов будут показываться все дочерние элементь1, даже не удовлетворяющие
заданному фильтру. Если False, будут показываться лишь дочерние элементы, удовле
творяющие фильтру (поведение по умолчанию);
♦ setDynamicSortFilter(<Флаг>) - если в качестве параметра указано значение False, при
изменении базовой модели не будет производиться повторная: сортировка или фильт
рация..
23.8. Использование делегатов
Все три представления, рассмотренные в разд. 23.5, дают возможность редактирования тек
ста их элементов. Например, в таблице (класс QTaЫeView) мы можем дважды щелкнуть
мышью на любом элементе, после чего в нем появится поле ввода.Введем в это поле новый
текст и нажмем клавишу <Enter> для подтверждения ввода или <Esc> - для отмены.
За редактирование данных в представлении отвечает особый класс, называемый делегатом.
Он создает компонент, в котором будет выполняться редактирование значения (редактор),
задает его параметры, заносит в него само редактируемое значение, а по окончании редак
тирования переносит его назад, в модель.
548 Часть 11. Библиотека PyQt б
По умолчанию в качестве делегата используется класс QitemDelegate из модуля QtWidgets.
А в качестве компонента-редактора применяется однострочное поле ввода (класс QLineEdit,
рассмотренный в главе 22).
Если мы хотим использовать для редактирования значения в каком-либо столбце или стро
ке другой редактор (например, многострочное поле ввода, поле ввода даты или целого чис
ла), мы создадим другой делегат и назначим его представлению. Класс, представляющий
делегат, должен быть унаследован от класса QStyleditemDelegate.
Иерархия наследования классов QitemDelegate и QStyleditemDelegate:
QObject - QAЬstractitemDelegate - QitemDelegate
QObject - QAЬstractitemDelegate - QStyleditemDelegate
В новом классе-делегате следует переопределить следующие методы:
♦ createEditor() - создает КО\\fПОнент, который будет использоваться для редактирова
ния данных, и задает его параметры. Формат метода:
createEditor(self, <Родитель>, <Настройки>, <Индекс>)
Вторым параметром передается ссылка на компонент-представление, который станет
родителем создаваемого редактора (список, таблица или иерархический список). Треть
им параметром передается объект класса QStyleOptiqnViewitem, хранящий дополнитель
ные настройки делегата, четвертым - индекс текущего элемента модели в виде объекта
класса QModelindex.
Метод createEdi tor() должен создать компонент-редактор, задать у него в качестве
родителя компонент-представление (он передается вторым параметром) и вернуть соз
данный компонент в качестве результата.
Чтобы отказаться от использования собственного делегата и указать представлению ис
пользовать делегат по умолчанию, в методе createEditor() следует вернуть значение
None�
♦ setEditorData() - заносит в компонент-редактор, созданный в методе createEditor (),
данные из текущего элемента модели, тем самым подготавливая редактор для редакти
рования этих данных. Формат метода:
setEditorData(self, <Редактор>, <Индекс>)
Вторым параметром передается компонент-редактор, а третьим - индекс текущего эле
мента модели в виде объекта класса QModelindex;
♦ updateEditorGeometry() - задает размеры редактора соответственно размерам области,
отведенной под него в компоненте-представлении. Формат:
updateEctitorGeometry(self, <Редактор>, <Настройки>, <Индекс>)
Вторым параметром передается ссылка на компонент-редактор, третьим - ссылка на
объект класса QStyleOptionViewitem, хранящий настройки делегата, четвертым - ин
декс текущего элемента модели, представленный объектом класса QModelindex.
Размеры отведенной под редактор области можно получить из атрибута rect объекта
класса QStyleOptionViewitem, переданного третьим параметром (полное описание класса
QStyleOptionViewitem приведено на странице https://doc.qt.io/qt-6/qstyleoptionviewitem.
html, а описание класса QStyleOption, от которого он порожден, - на странице
https://doc.qt.io/qt-'6/qstyleoption.html);
Глава 23. Списки и таблицы 549
♦ setModelData() - по окончании редактирования переносит значение из редактора в те
кущий элемент модели. Формат:
setModelData(self, <Редактор>, <Модель>, <Индекс>)
Вторым параметром передается ссылка на компонент-редактор, третьим - ссылка на
модель, четвертым - индекс текущего элемента модели в виде объекта класса
QModelindex.
Полное описание базового класса-делегата QAЬstractitemDelegate можно найти на странице
https://doc.qt.io/qt-6/qabstractitemdelegate.html, класса QitemDelegate - на странице https://
doc.qt.io/qt-6/qitemdelegate.html, а класса QStyleditemDelegate - на странице https://doc.
qt.io/qt-6/qstyleditemdelegate.html.
Для назначения делегатов представленmо следует применять следующие методы, унаследо
ванные от класса QAЬstractitemView:
♦ setitemDelegate(<Деле·гат>) - назначает заданный делегат для всего представления;
♦ setitemDelegateForColumn(<Индeкc столбца>, <Делегат>) - назначает заданный деле
гат для столбца представления с указанным индексом;
♦ setitemDelegateForRow (<Индекс строки>, <Делегат>) - назначает заданный делегат
для строки представления с указанным индексом.
Если в какой-либо ячейке представления действуют одновременно два делегата, задан
ные для столбца и для строки, будет использоваться делегат, заданный для строки.
В качестве примера рассмотрим небольшую складскую программу (листинг 23.4), позво
ляющую править количество каких-либо имеющихся на складе позиций с применением
поля для ввода целочисленных значений (класс QSpinBox).
from PyQtб import QtCore, QtWidgets, QtGui
import sys
# Создаем класс делегата
class SpinBoxDelegate(QtWidgets.QStyleditemDelegate):
def createEditor(self, parent, options, index):
# Создаем компонент-редактор, используемый для правки значений
# количества позиций
editor = QtWidgets.QSpinВox(parent)
editor.setFrame(False)
editor.setMinimum(O)
editor.setSingleStep(l)
return editor
def setEditorData(self, editor, index):
# Заносим в компонент-редактор значение количества
value = int(index.model() .data(index, QtCore.Qt.ItemDataRole·.EditRole))
editor.setValue(value)
def updateEditorGeometry(self, editor, options, index):
# Указываем размеры компонента-редактора
editor.setGeometry(options.rect)
550 Часть 11. Библиотека PyQt б
def setModelData(self, editor, model, index):
# Заносим исправленное значение количества в модель
value = str(editor.value())
model.setData(index, value, QtCore.Qt.ItemDataRole.EditRole);
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QТaЬleView()
window.setWindowТitle("Иcпoльзoвaниe делегата")
sti = QtGui.QStandarditemМodel(parent=window)
lstl = ['Флеш-диск', 'Бумага для принтера', 'картридж для принтера']
lst2 = ["10", "3", "8"]
for row in range(0, 3):
iteml = QtGui.QStandarditem(lstl[row])
item2 = QtGui.QStandarditem(lst2[row])
sti.appendRow([iteml, item2]) ·
sti.setHorizontalHeaderLabels(['Toвap', 'Кол-во'])
window.setModel(sti)
# Назначаем делегат второму столбцу таблицы
window.setitemDelegateForColumn(l, SpinBoxDelegate())
window.setColumnWidth(0, 150)
window.resize(350, 150)
window.show()
sys.exit(app.exec())
Результат выполнения кода из листинга 23.4 показан на рис. 23.4.
11] Использование делегата □ х
Товар Кол-во
2 Бумага для принтера 3
' '
3 Картридж для принтера 8
- �-·-�--· -·-- ·-
Рис. 23.4. Использование делегата
ГЛАВА 24 1
Работа с базами данных
PyQt вкточает в свой состав средства для работы с базами данных формата SQLite, MySQL,
MariaDB, Oracle, PostgreSQL, IВМ DB2 и др., не требующие установки никаких дополни
тельных Руthоn-библиотек. Кроме того, поддерживается работа с mобыми базами данных
посредством платформы ODBC.
ВНИМАНИЕ!
Для успешного доступа к базам данных всех форматов, кроме SQLite и ODBC, требуется
установить соответствующие клиенты.
Все классы, обеспечивающие работу с базами данных и рассмотренные в этой главе, опре
делены в модуле QtSql.
24.1. Соединение с базой данных
За соединение с базой данных и обработку транзакций отвечает класс QSqlDatabase.
Чтобы установить соединение с базой, следует вызвать статический метод addDatabase ()
этого класса. Формат вызова:
addDatabase (<Формат базы данных> [, connectionName=""] )
Формат базы данных указывается в виде одного из следующих строковых обозначений:
QSQLITE" (SQLite) "QМYSQL" или "МARIADB" (MySQL или MariaDB), "QOCI" (Oracle), "QPSQL"
11
(PostgreSQL), "QDB2" (DB2) или "QODBC" (ODBC).
Вторым параметром можно задать имя соединения, что может оказаться полезным, если
программа одновременно работает с несколькими базами. Если имя соединения не указано,
устанавливаемое соединение будет помечено как используемое по умолчанию.
Метод addDatabase () возвращает объект класса QSqlDatabase, представляющий «пустое»
соединение с базой данных. В этот объект следует занести параметры базы, с которой тре
буется соединиться, с помощью следующих методов класса QSqlDatabase:
♦ setHostName (<Хает>) - задает хост, на котором расположена база данных. Использует
ся только для серверных баз данных наподобие MySQL;
♦ setPort (<Номер порта>) - задает номер ТСР-порта, через который будет выполнено
подкточение к хосту. Используется только для сервернь�х баз даннь1х и лишь в том слу
чае, если для соединения с базой задействуется порт, отличный от порта по умолчанию;
552 Часть 11. Библиотека PyQt 6
♦ setDatabaseName (<Имя � путь к базе данных>) - задает имя базы данных (для сер
верных баз), путь к ней (для локальных баз данных, таких как SQLite) или полный набор
параметров подключения (если используется ODBC);
♦ setUserName (<Имя>) - задает имя пользователя для подключения к базе. Используется
только для серверных баз данных;
♦ setPassword(<Пapoль>) - задает пароль для подключения к базе. Используется только
для серверных баз данных;
♦ setConnectOptions (<Параметры>) - задает набор дополнительных параметров для под
ключения к базе в виде строки. Набор поддерживаемых дополнительных параметров
различен в зависимости от выбранного формата и приведен в документации по классу
QSqlDatabase.
Для работы с базой предназначены следующие методы класса QSqlDataЬase:
♦ open () - открывает базу данных. Возвращает тrue, если база бьша успешно открыта,
и False - в противном случае;
ВНИМАНИЕ!
Перед созданием соединения с базой данных обязательно следует создать объект про
граммы (объект класса QApplication). Если этого не сделать, PyQt не сможет загрузить
драйвер указанного формата баз данных, и соединение не будет создано.
Открываемая база данных уже должна существовать на локальном диске или сервере.
Единственное исключение - база формата SQLite, которая в случае ее отсутствия будет
создана автоматически.
♦ open (<Имя>, <Пароль>) - открывает базу данных под указанными именем пользователя
и паролем. Возвращает тrue, если база была успешно открыта, и False - в противном
случае;
♦ isOpen () - возвращает True, если база данных в настоящее время открыта, и False -
в противном случае;
♦ isOpenError () - возвращает True, если при попытке открытия базы данных возникли
ошибки, и False - в противном случае;
♦ transaction () - запускает транзакцию, если формат базы поддерживает таковые. Если
же формат базы не поддерживает транзакции, то не делает ничего. Возвращает True,
если транзакция была успешно запущена, и False - в противном случае;
♦ commit () - подтверждает транзакцию, если формат базы поддерживает таковые: Если
же формат базы не поддерживает транзакции, то не делает ничего. Возвращает True,
если транзакция бьша успешно подтверждена, и False - в противном случае;
♦ rollback () - отклоняет транзакцию, если формат базы поддерживает таковые. Если же
формат базы не поддерживает транзакции, то не делает ничего. Возвращает True, если
транзакция бьша успешно отклонена, и False - в противном случае;
♦ lastError () - возвращает сведения о последней возникшей при работе с базой ошибке
в виде объекта класса QSqlError;
♦ connectionName () - возвращает строку с именем соединения с базой или пустую строку
для соединения по умолчанию;
♦ taЫes ( [tуре=ТаЫеТуре. ТаЫеs]) - возвращает список таблиц, хранящихся в базе.
В параметре type можно указать тип таблиц в виде одного из элементов перечисления
таЫеТуре из класса QSql или их комбинации через оператор 1:
Глава 24. Работа с базами данных 553
• ТаЫеs - обычные таблицы;
• Systemтaыes - служебнь1е таблицы;
• Views - представления;
• AllTaЫes - все упомянутое ранее;
♦ record(<Имя таблицы>) - возвращает сведения о структуре таблицы с переданным име
нем, представленные объектом класса QSqlRecord, или пустой объект этого класса, если
таблицы с таким именем нет;
♦ primaryindex (<Имя таблицы>) - возвращает сведения о ключевом индексе таблицы
с переданным именем, представленные объектом класса QSqlindex, или пустой объект
этого класса, если таблицы с таким именем нет;
♦ close() - закрывает базу данных;
♦ isValid() - возвращает True, если текущий объект корректен, и False - в противном
случае.
Также могут пригодиться следующие статические методы класса QSqlDatabase:
♦ contains( [connectionName=""]) - возвращает True, если имеется соединение с базой
данных с именем, указанным в параметре connectionName, и False - в противном слу
чае;
♦ connectionNames() - возвращает список имен всех созданных соединений с базами
данных. Соединение по умолчанmо обозначается пустой строкой;
♦ database( [connectionName=""] [, ] [open=True]) - возвращает сведения о соединении
с базой данных, имя которого указано в параметре connectionName, в виде объекта класса
QSqlDatabase. Если в параметре open указано значение True, база данных будет открыта.
Если такового соединения нет, возвращается некорректно сформированный объект клас
са QSqlDatabase;
♦ cloneDatabase(<Соединение QSqlDatabase>, <Имя соединения>) - создает копmо ука
занного в первом параметре соединения с базой и дает ему имя, заданное во втором
параметре. Возвращаемый результат - объект класса QSqlDatabase, представляющий
созданную копmо соединения;
♦ removeDatabase(<Имя соединения>) - удаляет соединение с указанным именем. Соеди
нение по умолчанmо обозначается пустой строкой;
♦ isDriverAvailaЫe(<Формат>) - возвращает True, если указанное в виде строки обозна
чение формата баз данных поддерживается PyQt, и False - в противном случае:
>>> from PyQtб import QtSql
>» QtSql.QSqlDatabase.isDriverAvailaЫe("QSQLITE")
True
>>> QtSql.QSqlDatabase.isDriverAvailaЫe("QМSSQL")
False
♦ drivers() - возвращает список обозначений всех форматов баз данных, с которыми
в текущий момен-r может работать PyQt. Список может быть неполным, если на компью
тере не установлены клиенты каких-либо из баз данных, подцерживаемых библиотекой.
Пример_:
>>> QtSql.QSqlDatabase.drivers()
[ 'QSQLITE', 'QODBC', 'QPSQL' ]
554 Часть 11. Библиотека PyQt б
В листинге 24.1 показан код, выполняющий соединение с базами даюn,1х различных форма
тов и их открытие.
frorn PyQtб irnport QtWidgets, QtSql
irnport sys
# Создаем объект программы, иначе поддержка баз данных не будет работать
арр = QtWidgets.QApplication(sys.argv)
# Открываем базу данных SQLite, находящуюся в том же каталоге, что и файn
# с этой программой
conl = QtSql.QSqlDatabase.addDatabase('QSQLITE')
conl.setDatabaseNarne('data.sqlite' )
conl .open()
conl.close()
# Открываем базу данных MySQL
con2 = QtSql.QSqlDatabase.addDataьase('QМYSQL')
con2.setHostNarne("sornehost");
con2.setDataьaseNarne("sornedЬ");
con2.setUserNarne("sorneuser");
con2.setPassword("password");
con2,open();
con2.close()
# Открываем базу данных Microsoft Access через ODBC
соnЗ = QtSql.QSqlDatabase.addDatabase("QODBC");
conЗ.setDatabaseNarne("DRIVER={Mit:rosoft Access Driver (*.rndЬ) };" +
"FIL={MS Access};DBQ=c:/book/data.rndЬ");
соnЗ.open()
соnЗ.close()
Полное описание класса QSqlDatabase приведено на странице https://doc.qt.io/qt-6/
qsqldatabase.html.
24.2. Получение сведений о структуре таблиц
PyQt позволяет получить сведения о структуре таблиц, хранящихся в базе: списки полей
таблицы, параметры отдельного поля, индекса и ошибки, возникшей при работе с базой.
24.2.1. Получение сведений о таблицах
Сведения о структуре таблицы можно получить вызовом метода record() класса
QSqlDatabase (см.разд. 24. 1). Эти сведения представляются объектом класса QSqlRecord.
Для получения сведений о полях таблицы используются следующие методы этого класса:
♦ count() - возвращает количество полей в таблице;
♦ fieldNarne (<Индекс поля>) - возвращает имя поля, имеющее заданный индекс, или пус
тую строку, если индекс некорректен;
Глава 24. Работа с базами данных 555
♦ fiеld(<Индекс поля>) - возвращает сведения о поле (объект класса QSqlField), чей ин
декс задан в качестве параметра;
♦ field(<Имя поля>) - возвращает сведения о поле (объект класса QSqlField), чье имя
задано в качестве параметра;
♦ indexOf(<Имя поля>) - возвращает- индекс поля с указанным именем или -1, если тако�
го поля нет. При поиске поля не учитывается регистр символов;
♦ contains(<Имя поля>) - возвращает True, если поле с указанным именем существует,
и False -в противном случае;
♦ isEmpty() -возвращает тrue, если в таблице нет полей, и False - в противном случае.
Полное описание класса QSqlRecord приведено на странице https://doc.qt.io/qt-6/
qsqlrecord.html.
24.2.2. Получение сведений о полях таблиц
Сведения об отдельном поле таблицы возвращаются методами field() класса QSqlRecord
(см. разд. 24.2.1). Они представляются объектом класса QSqlField, поддерживающим сле
:rующие методы:
♦ name () -возвращает имя поля;
♦ typeID() - возвращает объект класса QMetaType (модуль QtCore), описывающий тип
поля.
Класс QMetaтype поддерживает метод id() , возвращающий целочисленный идентифика
тор типа поля. Идентификаторы наиболее часто применяемых типов применительно
к Python приведены далее (полный их список можно найти по адресу https://doc.qt.io/
qt-6/qmetatype.html#Type-enum):
• О -тип определить не удалось;
• 1 -логический;
• 2, 4 или 32 -целочисленный;
• 6 или 3& -вещественный;
• 1О -строковый;
• 14-дата;
• 15 -время;
• 16 -временная отметка;
• 3, 5 или 35 -положительное целое число;
• 7 -строка из одного символа;
• 12 -двоичные данные QByteArray;
♦ length() -возвращает максимальную длину поля в символах;
♦ precision() -·возвращает количество знаков после запятой у полей, хранящих вещест
венные числа;
♦ defaultValue () -возвращает значение поля по умолчанию;
♦ requiredStatus () - возвращает признак, является ли поле обязательным к заполнению,
в виде одного из элементов перечисления RequiredStatus из класса QSqlField:
556 Часть 11. Библиотека PyQt 6
• Required - поле является обязательным к заполнению;
• Optional - поле не является обязательным к заполнению;
• Unknown - определить признак обязательности заполнения поля не представляется
возможным;
♦ isAutoValue () - возвращает тrue, если значение в поле заносится автоматически (что
может быть, например) у поля автоинкремента), и False - в противном случае;
♦ isReadOnly () - возвращает True, если поле доступно только для чтения, и False -
в противном случае.
Полное описание класса QSqlField приведено на странице https://doc.qt.io/qt-6/qsqlfield.html.
24.2.3. Получение сведений о ключевом·индексе
Сведения о юпочевом индексе, возвращаемые методом primaryindex () класса QSqlDatabase
(см. разд. 24.2.1); представляются объектом класса QSqlindex. Он наследует все методы
класса QSqlRecord, тем самым позволяя узнать, в частности, список полей, на основе кото
рых создан индекс.
Также он определяет следующие методы:
♦ narne () - возвращает имя индекса или пустую строку для юпочевого индекса;
♦ isDescending ( <Номер поля>) - возвращает True, если поле с указ;шным номером в ин
дексе отсортировано по убыванию, и False - в противном случае.
Полное описание класса QSqlindex приведено на странице https://doc.qt.io/qt-6/qsqlindex.html.
24.2.4. Получение сведений об ошибке
Сведения об ошибке, возникщей при работе с базой данных, представляются объектом
класса QSqlError. Выяснить, что за ошибка произошла и каковы ее причины, позволят сле
дующие методы этого класса:
♦ type () - возвращает код ошибки в виде одного из следующих элементов перечисления
ErrorТype из класса QSqlError:
• NoError - никакой ошибки не возникло;
• ConnectionError - ошибка соединения с базой данных;
• StaternentError - ошибка в коде SQL-зaпpoca;
• TransactionError - ошибка в обработке транзакции;
• UnknownError - ошибка неустановленной природы.
Если код ошибки не удается определить, возвращается_-�;
♦ text () - возвращает полное текстовое описание ошибки (фактически - значения, воз
вращаемые методами databaseтext () и driverтext (), объединенные в одну строку);
♦ databaseтext () - возвращает текстовое описание ошибки, сгенерированное базой дан
ных;
♦ driverText ·() - возвращает текстовое описание ошибки, сгенерированное драйвером
базы данных, который входит в состав PyQt;
Глава 24. Работа с базами данных 557
♦ nati veErrorCode () - возвращает строковый код ошибки, специфический для выбраmю
го формата баз дairnыx;
♦ isValid() - возвращает тrue, если текущий объект корректен (описывает реально воз-
никшую ошибку), и False - в противном случае.
Пример:
=on = QtSql.QSqlDatabase.addDatabase('QSQLITE')
=on. setDatabaseNarne('data .sqlite')
:_f con.open():
# Работаем с базой данных
else:
# Выводим текст описания ошибки
print(con .lastError() .text())
Полное описание класса QSqlError можно найти на странице https://doc.qt.io/qt-6/
qsqlerror.html.
24.3. Выполнение SQL-зanpocoв
и nQ,лучение их результатов
Класс QSqlQuery позволяет выполнять SQL-запросы любого назначения: создания таблиц,
выборки, добавления, изменения, удаления и др.
ПРИМЕЧАНИЕ
Далее будут рассмотрены лишь наиболее часто используемые возможности класса
QSqlQuery. Полное его описание приведено на странице https://doc.qt.io/qt-6/
qsqlquery.html.
24.3.1. Выполнение запросов
Чтобы выполнить запрос к базе, сначала следует создать объект класса QSqlQuery. Для этого
используется один из следующих форматов вызова его конструктора:
QSqlQuery([<SQL-кoд>][, dЬ=QSqlDatabase()])
QSqlQuery(<Coeдинeниe с базой данных QSqlDatabase>)
QSqlQuery(<Oбъeкт класса QSqlQuery>)
Первый формат позволяет сразу задать SQL-кoд, который следует выполнить, и немедленно
запустить его на исполнение. Необязательный параметр dЬ задает соединение с базой дан
ных, запрос к которой следует выполнить, - если он не указан, будет использоваться со
единение по умолчанию.
Второй формат создает пустой запрос, не содержащий ни SQL-кoдa, ни каких-либо прочих
параметров, и сразу задает соединение с указанной базой данных. Третий запрос создает
копию запроса, п�реданного в параметре.
Для выполнения запросов используются следующие методы класса QSqlQuery:
♦ ехес(<SQL-кoд>) - немедленно выполняет переданный в параметре SQL-кoд. Если по
следний бьш успешно выполнен, возвращает True и переводит запрос в а�ивное состоя
ние, в противном случае возвращает False. Пример использования этого метода показан
в листинге 24.2.
558 Часть //. Библиотека PyQt 6
from PyQtб import QtWidgets, QtSql
import sys
арр = QtWidgets.QApplication(sys.argv)
con = QtSql.QSqlDatabase.addDatabase('QSQLITE')
con.setDatabaseName('data.sqli te')
con .open()
# Проверяем, есть ли в базе данных таблица good, и, если таковой нет,
# создаем ее SQL-командой CREATE ТАВLЕ
if 'good' not in con.taЫes():
query = QtSql.QSqlQuery()
query.exec("create tаЫе good(id integer primary key autoincrement, " +
"goodname text, goodcount integer) ")
con.close()
СОВЕТ
Метод ехес() следует использовать в тех случаях, если SQL-эanpoc не принимает пара
метров. В противном случае рекомендуется применять методы, рассмотренные далее.
♦ prepare(<SQL-кoд>) - подготавливает запрос с зада�rnым SQL-кодом к выполнению.
Применяется, если SQL-зaпpoc содержит параметры. Параметры в коде запроса могут
быть либо позиционными (в стиле ODBC - заданные вопросительными знаками), либо
именованными (в стиле Oracle - задаются произвольными именами, предваренными
знаком двоеточия). Метод возвращает True, если SQL-зaпpoc был успешно подготовлен,
и False - в про,тивном случае;
♦ ехес() - выполняет подготовленный ранее запрос. Возвращает True, если запрос был
успешно выполнен, и False - в противном случае;
♦ addВindValue(<Значение параметра> [, paramType=ParamType.In] ) - задает значение
очередного по счету позиционного параметра: первый вызов этого метода задает значе
ние первого параметра, второй вызов - второго и т. д. Необязательный параметр
paramType указывает тип параметра - здесь практически всегда используется элемент In
перечисления ParamType из класса QSql, означающий, что этот параметр служит для за
несения значения в запрос.
В листинге 24.3 приведен пример использования методов prepare (), addВindValue() и
ехес().
1 яисти�r 2-4.3. Иcnon�вattиe методов� о, addВindV'alue о � 'eXSC-O
from PyQtб import QtWidgets, QtSql
import sys
арр = QtWidgets.QApplication(sys.argv)
con = QtSql.QSqlDatabase.addDatabase('QSQLITE')
con.setDatabaseName('data.sqlite' )
con.open()
query = QtSql.QSqlQuery()
# Добавляем в только что созданную таблицу good запись,
# используя SQL-команду INSERT
Глава 24. Работа с базами данных 559
query.prepare("insert into good values(null, ?, ?)")
query.addВindValue('ДИcкeтa')
query.addВindValue(lO)
query. ехес ()
con.close()
♦ ЬindValue() - задает значение позиционного параметра с указанным порядковым но
мером (нумерация параметров начинается с нуля). Формат метода:
ЬindValue(<Hoмep параметра>, <Значение параметра>[, paramType=ParamType.In])
Пример применения метода показан в листинге 23.4.
·",t
· "·. с
Лмс:тииt UA. Исnоnwоаание
�· зрния значений lto3,и
from PyQtб import QtWidgets, QtSql
import sys
арр = QtWidgets.QApplication(sys.argvl
con = QtSql.QSqlDatabase.addDatabase('QSQLITE')
con. setDatabaseName('data.sqlite')
con.open()
query = QtSql.QSqlQuery()
query.prepare("insert into good values(null, ?, ?)")
query.ЬindValue(O, 'Компакт-диск')
query.ЬindValue(l, 5)
query. ехес()
con.close()
♦ ЬindValue() - задает значение именованного параметра с указанным именем. Формат
метода:
ЬindValue(<Имя параметра>, <Значение параметра> [, paramType=ParamType. In] )
Пример применения метода показан в листинге 24.5.
ЛиtrИНr 2-t.5. �
' дnJI эадаl;t� 3Нa't8tltli и ., '
from PyQtб import QtWidgets, QtSql
import sys
арр = QtWidgets.QApplication(sys.argv)
con = QtSql.QSqlDatabase.addDataЬase('QSQLITE')
con.setDatabaseName('data.sqlite')
con.open()
query = QtSql.QSqlQuery()
query.prepare("insert into good values(null, :name, :count)")
query.ЬindValue(':name', 'Флеш-накопитель')
1
query.ЬindValue(':count', 20)
query.ехес()
con.close()
560 Часть 11. Библиотека PyQt 6
♦ execBatch( [mode=BatchExecutionМode.ValuesAsRows]) если в вызове метода
addВindValue() или Ьinctvalue() вторым параметром бьш указан список, выполнит под
готовленный запрос.
Необязательный параметр mode указывает, как будут интерпретироваться отдельные
элементы заданного списка. В настоящее время в качестве его значения для всех фор
матов баз данных поддерживается лишь элемент ValuesAsRows перечисления
BatchExecutionМode из класса QSqlQuery, указьmающий, что подготовленный запрос
должен быть выполнен столько раз, сколько элементов присутствует в списке, при этом
на каждом выполнении запроса в его код подставляется очередной элемент списка.
Метод возвращает True, если запрос бьш успешно выполнен, и False :-- в противном
случае.
Листинг 24.6 представляет пример добавления в таблицу сразу нескольких записей
с применением метода execвatch().
from PyQtб import QtWidgets, QtSql
irpport sys
арр = QtWidgets.QApplication(sys.argv)
con = QtSql .QSqlDatabase.addDatabase('QSQLITE')
con.setDatabaseName('data.sqlite')
con.open()
query = QtSql.QSqlQuery()
query.prepare("insert into good values(null, :name, :count)")
lstl = ['Бумага офисная', 'Фотобумага', 'картридж']
lst2 = [15, 8, З]
query.ЬindValue(' :name' , lstl)
query.ЬindValue(':count', lst2)
query.execBatch()
con.close()
♦ setForwardOnly(<Флаг>) - если передано значение True, по результату запроса можно
будет перемещаться только «вперед», т. е. от начала к концу. Такой режим выполнения
запроса существенно сокращает потребление системных ресурсов. Этот метод должен
быть вызван перед выполнением запроса, который возвращает результат, н�пример:
query.prepare( "select * from good order Ьу goodname")
query.setForwardOnly(True)
query.ехес()
24.3.2. Обработка результатов выполнения запросов
Если был выполнен запрос на выборку данных (SQL-команда SELECT), следует получить
результат его выполнения. Для этого мы используем методы класса QSqlQuery, описанные
в этом разделе.
Запрос на выборку данных поддерживает особый внутренний указатель, указьmающий на
запись результата, содержимое которой в насrоящее время доступно для получения. Однако
сразу после выполнения запроса этот указатель хранит неопределенное значение, не идеи-
Глава 24. Работа с базами данных 561
тифицирующее никакую реальную запись. Поэтому перед собственно выборкой данных
необходимо позиционировать этот указатель на нужную запись:
♦ first () - позиционирует указатель запроса на первую запись результата. Возвращает
True, если позиционирование прошло успешно, и False - если результат пуст (не со
держит записей);
♦ next () - позиционирует указатель запроса на следующую запись результата или на
первую запись, если этот метод был вызван сразу после выполнения запроса. Возвраща
ет тrue, если позиционирование прошло успешно, и False - если записей в результате
больше нет, резулы;ат пуст или указатель ранее не был установлен ни на какую запись;
♦ previous () - позиционирует указатель запроса на предыдущую запись результата или
на последнюю запись, если указатель в текуший момент находится за последней запи
сью. Возвращает True, если позиционирование прошло успешно, и False - если записей
в результате больше нет, результат пуст или указатель ранее не был установлен ни на
какую запись;
♦ last () - позиционирует указатель запроса на последнюю запись результата. Возвраща
ет тrue, если позиционирование прошло успешно, и False - если результат пуст;
♦ seek(<Hoмep записи>[, relative=False]) - позиционирует указатель на запись с ука
занным номером (нумерация записей начинается с нуля). Если необязательным парамет
ром relative передано значение True, то позиционирование выполняется относительно
текущей записи: положительные значения вызывают смещение указателя «вперед»
(к концу), а отрицательные - «назад» (к началу). Возвращает тrue, если позициониро
вание прошло успешно, и False - в противном случае;
♦ isvalid () - возвращает тrue, если указатель указывает на какую-либо запись, и False,
если он имеет неопределенное значение;
♦ at () - возвращает номер записи, на которую указывает указатель результата, или отри
цательное число, если указатель имеет неопределенное значение;
♦ size () - возвращает количество записей, возвращенных в результате выполш:щия за
проса, или -1, если этот запрос не выполнял выборку данных.
Для собственно выборки данных следует применять описанные далее методы:
♦ value (<Индекс поля>) - возвращает значение поля текущей записи с заданным индек
сом. Поля нумеруются в том порядке, в котором они присутствуют в таблице базы или
в SQL-кoдe запроса;
♦ value (<Имя поля>) - возвращает значение поля текушей записи с заданным именем;
♦ isNull (<Индекс поля>) - возвращает True, если в поле с указанным индексом нет зна
чения, и False - в противном случае;
♦ isNull (<Имя поля>) - возвращает True, если в поле с указанным именем нет значения,
и False - в противном случае;
♦ record () - если внутренний указатель установлен на какую-либо запись, возвращает
сведения об этой записи, в противном случае возвращаются сведения о самой таблице.
Возвращаемым результатом является объект класса QSqlRecorct;
♦ recort (<Индекс записи>) - возвращает сведения о записи с указанным индексом. Воз
вращаемым результатом является объект класса QSqlRecorct;
♦ isSelect () - возвращает True, если бьш выполнен запрос на выборку данных, и False,
если исполнялся запрос иного рода.
562 Часть 11. Библиотека PyQt б
В листинге 24.7 приведен код, извлекающий данные из таблицы good созданной ранее базы
данных и выводящий их на экран.
1 Л�нr: 24.7. В1,,1борка даНt!ЬIХ из базы
from PyQtб import QtWidgets, QtSql
import sys
арр = QtWidgets.QApplication(sys.argv)
con = QtSql.QSqlDatabase.addDatabase('QSQLITE')
con.setDatabaseName('data.sqlite')
con.open()
query = QtSql.QSqlQuery()
query.exec("select * from good order Ьу goodname")
1st = []
if query.isActive():
query.first()
while query.isValid():
lst.append(query.value('goodname') + ': ' +
str( query.value('goodcount')) + ' шт.')
query.next()
for р in 1st: print(p)
con,- close()
Результат выполнения этого кода:
Бумага офисная: 15 шт.
дискета: 10 шт.
Картридж: 3 шт.
Компакт-диск: 5 шт.
Флеш-накопитель: 20 шт.
Фотобумага: 8 шт.
24.3.3. Очистка запроса
После первого выполнения метода ехес() или execвatch() запрос переходит в активное
состояние, и выполнить любую другую SQL-команду с его помощью станет невозможно.
Метод isActive() класса QSqlQuery возвращает True, если запрос находится в активном
состоянии. Если же запрос неактивен, метод возвращает False.
Если один и ·тот же объект класса QSqlQuery планируется использовать для выполнения не
скольких SQL-команд, перед выполнением новой команды следует сбросить его, переведя
тем самым в неактивное состояние и освободив занимаемые им системные ресурсы. Это
выполняется вызовом метода clear():
query = QtSql.QSqlQuery()
query.exec("select * from good order Ьу goodname")
# Обрабатываем результат запроса
query.clear()
query.exec("select count(*) as cnt from good")
# Работаем с новым запросом
Глава 24. Работа с базами данных 563
24.3.4. Получение служебных сведений о запросе
Класс QSqlQuery также позволяет получить всевозможные служебные сведения о запросе.
Для этого применяются следующие методы:
♦ n�owsAffected () - возвращает количество записей, обработанных в процессе выпол
нения запроса, или -1, если это количество не удается определить. Для запросов выбор
ки данных возвращает t:Jone - в этом случае следует вызывать метод size ();
♦ lastinsertid () - возвращает идентификатор последней добавленной записи. Если за
прос не_ добавлял записи или если формат базы данных не позволяет определить иден
тификатор последней добавленной записи, возвращает None;
♦ 1a·stError () - возвращает объект класса QSqlError, описывающий последнюю возник
шую в базе данных ошибку;
♦ executedQuery () - возвращает SQL-кoд последнего выполненного запроса или пустую
строку, если никакой запрос еще не бьш выполнен. В возвращенном коде запроса вместо
параметров будут подставлены указанные у них значения;
♦ lastQuery () � возвращает код последнего выполненного запроса или пустую строку,
если никакой запрос еще не был выполнен. В возвращенном коде запроса вместо пара
метров не будут подставлены указанные у них значения;
♦ boundValue (<Номер параметра>) - возвращает значение параметра запроса с указанным
номером;
♦ boundValue (<Имя параметра>) - возвращает значение параметра запроса с указанным
именем;
♦ boundValues () - возвращает словарь, ключами элементов которого служат имена пара
метров, а значениями элементов - значения этих параметров. В случае позиционных
параметров в качестве ключей будут использованы произвольные строки вида : а для
первого параметра, :ьь для второго и т. д.
24.4. Модели, связанные с данными
PyQt предоставляет два класса-модели, извлекающие данные из базы и позволяющие вы
вести их в списках или таблицах.
24.4.1. Модель, связанная с SQL-зanpocoм
Если данные, извлеченные в результате выполнения SQL-зaпpoca, не требуется редактиро
вать, имеет смысл использовать класс QSqlQueryModel. Он представляет модель, связанную
с SQL-запросом. Иерархия наследования этого класса:
QObject - QAЬstractitemМodel - QAЬstractTaЬleModel - QSqlQueryМodel
Формат конструктора класса:
QSqlQueryМodel ( [parent=None])
Класс QSqlQueryModel поддерживает следующие методы (здесь приведен их сокращенный
список, а полный список методов этого класса доступен на страницах https://doc.qt.io/
qt-6/qsqlquerymodel.html и https://doc.qt.io/qt-6/qabstracttaЫemodel.html):
564 Часть 11. Библиотека PyQt б
♦ setQuery(<Код запроса>[, dЬ=QSqlDataЬase() J ) - задает SQL-кoд запроса у модели.
Необязательный параметр dЬ задает соединение с базой данных, запрос к которой следу
ет выполнить, - если он не указан, будет использоваться соединение по умолчаmпо;
♦ setQuery(<Запрос QSqlQuery>) - задает запрос у модели;
♦ query() - возвращает запрос (объект класса QSqlQuery), заданный у модели;
♦ record() - возвращает объект класса QSqlRecord,_ хранящий сведения о структуре ре
зультата запроса;
♦ recorci(<Индекс записи>) - возвращает объект класса QSqlRecord, хранящий сведения
о записи с указанным индексом;
♦ lastError() - возвращает объект объекта QSqlError, описывающий последнюю воз
никшую в базе данных ошибку;
♦ index(<Строка>, <Столбец> [, parent=QМodelI.ndex() J ) - возвращает индекс (объект
класса QModellndex) элемента модели, находящегося на пересечении строки и столбца
с указанными индексами. Необязательцый параметр paren:t задает элемент верхнего
уровня (объект класса QModellndex) для искомого элемента - если таковой не задан, бу
дет выполнен поиск элемента на самом верхнем уровне иерархии;
♦ data(<Индекс QModellndex>[, role=ItemDataRole.DisplayRole J ) --,- возвращает данные,
хранимые в указанной в параметре role роли элемента, на который ссылается заданный
индекс;
♦ rowcount( [parent=QМodellndex() J ) - возвращает количество элементов в модели. Не
обязательный параметр parent указьшает элемент верхнего уровня (объект класса
QModellndex), при этом будет возвращено количество вложенных в него элементов. Если
параметр не задан, возвращается количество элементов верхнего уровня иерархии;
♦ setHeaderData() - задает значение для указанной роли заголовка. Формат метода:
SetHeaderData(<Индeкc>, <Ориентация>, <Значение>[, role=ItemDataRole.EditRole])
В первом параметре указьmается индекс строки или столбца, а во втором - ориентация
(элемент Horizontal или Vertical перечисления Orientation из модуля QtCore.Qt). Ме
тод возвращает значение True, если операция успешно выполнена;
♦ headerData(<Индекс>, <Ориентация> [, role=ItemDataRole.DisplayRole] ) - возвращает
значение, соответствующее указанной роли заголовка. В первом параметре указьшается
индекс строки или столбца, а во втором - ориентация.
Рассмотрим пример, выводящий данные из созданной нами ранее базы с помощью компо
нента таблицы (листинг 24.8).
from PyQtб import QtCore, QtWidgets, QtSql
import sys
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QTaЬleView()
window.setWindoWТitle("QSqlQueryМodel")
# Устанавливаем соединение с базой данных
con.= QtSql.QSqlDatabase.addDatabase('QSQLITE')
coh.setDatabaseName('data.sqlite')
con.open()
Глава 24. Работа с базами данных 565
# Создаем модель
sqm = QtSql.QSqlQueryModel(parent=window)
sqm.setQuery('select * from good order Ьу goodname')
# Задаем заголовки для столбцов модели
sqm.setHeaderData(l, QtCore.Qt .Orientation.Horizontal, 'Название')
sqm.setHeaderData(2, QtCore.Qt.Orientation.Horizontal, 'Кол-во')
# Задаем для таблицы только что созданную модель
window.setModel(sqm)
# Скрываем первый столбец, в котором выводится идентификатор
window.hideColumn(0)
window.setColumnWidth(l, 150)
window.setColumnWidth(2, 60)
window.resize(260, 160)
window .show()
sys.exit(app.exec())
24.4.2. Модель, связанная с таблицей
Если необходимо дать пользоватеmо возможность редактировать данные, хранящиеся
в базе, следует использовать класс QSqlTaЬleModel. Он представляет модель, связанную не
посредственно с указанной таблицей базы данных. Иерархия наследования:
QObject - QAЬstractitemМodel - QAЬstractTaЬleModel - QSqlQueryМodel - QSqlTaЫeModel
Формат конструктора класса:
QSqlTaЫeModel([parent=None] [, dЬ=QSqlDatabase()])
Необязательный параметр dЬ задает соединение с базой данных, запрос к которой следует
выполнить, - если он не указан, будет использоваться соединение по умолчанию.
Класс QSqlTaЫeModel наследует все методы из класса QSqlQueryModel (см. разд. 24.4. 1) и в
дополне_ние к ним определяет следующие наиболее полезные для нас методы (полный их
список приведен на странице https://doc.qt.io/qt-6/qsqltaЫemodel.html):
♦ sеtтаые(<Имя таблицы>) - задает таблицу, данные из которой будут представлены
в модели. Отметим, что этот метод лишь выполняет получение из базы данных структу
ры указанной таблицы, но не загружает сами эти данные;
♦ taЫeName() - возвращает имя таблицы, заданной для модели;
♦ setSort( <Индекс столбца>, <Порядок сортировки>) - задает сортировку данных по
столбцу с указанным индексом. Если вторым параметром передан элемент AscendingOrder
перечисления sortOrder из модуля QtCore.Qt, сортировка будет производиться в прямом
порядке, а если элемент DescendingOrder того же перечисления - в обратном;
♦ setFilter(<Ycлoвиe фильтрации>) - задает условие для фильтрации данных в виде
строки в формате, который применяется в SQL-команде WHERE;
♦ filter() - возвращает строку с фильтром, заданным для модели;
♦ select() - считывает в модель данные из заданной ранее таблицы с учетом указанных
параметров сортировки и фильтрации. Возвращает Tru�, если считывание данных про
шло успешно, и False - в противном случае:
stm = QtSql.QSqlTaЫeModel(parent=window)
stm.setTaЬle( ' good')
566 Часть 11. Библиотека PyQt 6
stm.setSort(l, QtCore.Qt.SortOrder.DescendingOrder)
stm.setFilter( 'goodcount > 2' )
stm.select()
М�тод является слотом;
♦ setEditStrategy(<Peжим>) -указывает режим редактирования даюn,rх в модели. В ка
честве параметра задается один из элементов перечисления Ed itStrategy из класса
QSqlTaЬleModel:
• OnF ieldChange - все изменения переносятся в базу даюn,rх немедленно;
• OnRowChange - изменения переносятся в базу лишь после того, как пользователь пе
рейдет на другую строку;
• OnМanualSuЬmit - изменения переносятся в базу только после вызова метода
suЬmit() или suЬmitAll() ;
♦ insertRow(<Индeкc>) -добавляет пустую запись по индексу, заданному первым пара
метром. Возвращает значение тrue, если запись была успешно добавлена, и False -
в противном случае;
♦ insertRows(<Индекс>, <Количество>) - добавляет указанное количество пустых запи
сей по индексу, заданному первым параметром. Если указан индекс -1, записи добавля
ются в конец модели. Возвращает значение True, если записи были успешно добавлены,
и False - в противном случае;
♦ removeRow(<Индeкc>) - удаляет запись с указанным индексом. Возвращает значение
True, если запись бьша успешно удалена, и False - в противном случае;
♦ removeRows(<Индекс>, <Количество>) -удаляет указанное количество записей, начиная
с записи с указаюn,rм индексом. Возвращает значение тrue, если записи были успешно
удалены, и False -в противном случае;
ПРИМЕЧАНИЕ
Нужно отметить, что после удаления записи вызовом метода removeRow() или removeRows ()
в модели останется пустая запись, реально не представляющая никакой записи из табли
цы. Чтобы убрать ее, достаточно выполнить повторное считывание данных в модель вызо
вом метода select() .
♦ insertRecord(<Индекс>, <Запись>) - добавляет в модель новую запись по индексу, ука
занному первым параметром. Если задан отрицательный индекс, запись добавляется
. в конец модели. Добавляемая запись представляется объектом класса QSqlRecord, уже
заполненным необходимыми даюn,rми. Возвращает True, если запись была успешно
добавлена, и False - в противном случае;
♦ setRecord(<Индeкc>, <Запись>) -заменяет запись по индексу, указанному первым па
раметром, другой записью, которая передается вторым параметром в виде объекта клас
са QSqlRecord, уже заполненного необходимыми даюn,rми. Возвращает тrue, если запись
бьша успешно изменена, и False - в противном случае;
♦ suЬmit() -переносит в базу данных изменения, сделанные в текущей записи, если был
задан режим редактирования OnМanualSuЬmit. Возвращает True, если изменения были
успешно перенесены, и False -в противном случае. Метод является слотом;
♦ suЬmitAll() - переносит в базу данных изменения, сделаюn,rе во всех записях, если
был задан режим редактирования OnМanualSuЬmit. Возвращает True, если изменения
были успешно перенесены, и False - в противном случае. Метод является слотом;
Глава 24. Работа с базами данных 567
♦ revert() - отменяет изменения, сделанные в текущей записи, если был задан режим
редактирования OnМanualSuЬmit. Возвращает тrue, если изменения были успешно отме
нены, и False - в противном случае. Метод является слотом;
♦ revertRow(<Индекс заГ)иси>) - отменяет изменения, сделанные в записи с заданным
индексом, если бьш задан режим редактирования OnМanualSuЬmit;
♦ revertAll() - отменяет изменения, сделанные во всех записях, если был задан режим
редактирования OnМanualSuЬmit. Возвращает True, если изменения были успешно отме
нены, и False - в противном случае. Метод является слотом;
♦ selectRow(<Индeкc записи>) - обновляет содержимое записи с указанным индексом.
Возвращает True, если запись была успешно обновлена, и False - в противном случае.
Метод является слотом;
♦ isDirtу(<Индекс QModelindex>) - возвращает True, если запись с указанным индексом
была изменена, но эти изменения еще не бьши перенесены в базу данных, и False -
в противном случае;
♦ isDirty() - возвращает тrue, если хотя бы одна запись в модели была изменена, но эти
изменения еще не были перенесены в базу данных, и False - в противном случае;
♦ fieldindex(<Имя поля>) - возвращает индекс поля с указанным именем или -1, если
такого поля нет;
♦ primaryKey() - возвращает сведения о ключевом индексе таблицы, представленные
объектом класса QSqlindex, или пустой объект этого класса, если таблица не содержит
ключевого индекса.
Методы insertRecord() и setRecord(), предназначенные соответственно для добавления и
изменения записи, принимают в качестве второго параметра объект класса QSqlRecord.
Формат вызова конструктора этого класса:
QSqlRecord([<Oбъeкт класса QSqlRecord>])
Если в параметре указать объект класса QSqlRecord, будет создана его копия. Обычно при
создании новой записи здесь указывают значение, возвращенное методом record() класса
QSqlDatabase (оно хранит сведения о структуре таблицы и, следовательно, представляет
пустую запись), а при правке существующей записи - значение, возвращенное методом
record(), который унаследован классом QSqlтаыемоdеl от класса QSqlQueryМodel (оно
представляет запись, которую нужно отредактировать).
Класс QSqlRecord, в дополнение к методам, рассмотренным нами в разд. 24.2.1, поддержи
вает следующие методы:
♦ value(<Индекс поля>) - возвращает значение поля текущей записи с заданным индек
сом;
♦ value(<Имя поля>) - возвращает значение поля текущей записи с заданным именем;
♦ setValue (<Индекс поля>, <Значение>) - заносит в поле с указанным индексом новое
значение;
♦ setValue (<Имя поля>, <Значение>) - заносит в поле с указанным именем новое значе
ние;
♦ isNull(<Индекс поля>) - возвращает True, если в поле с указанным индексом нет зна
чения, и False - в противном случае;
568 Часть 11. Библиотека PyQt б
♦ isNull(<Имя поля>) - возвращает True, если в поле с указанным именем нет значения,
и False - в противном случае;
♦ setNull(<Индекс поля>) - удаляет значение из поля с указанным индексом;
♦ setNull(<Имя поля>) -удаляет значение из поля с указанным именем;
♦ clearvalues() -удаляет значения из всех полей записи;
♦ setGenerated(<Индeкc поля>, <Флаг>) - если вторым параметром передано False, поле
с указанным индексом помечается как неактуальное, и хранящееся в нем значение не
будет перенесено в таблицу;
♦ setGenerated(<Имя поля>, <Флаг>) -. если вторым параметром передано False, поле
с указанным именем помечается как неактуальное, и хранящееся в нем значение не
будет перенесено в таблицу;
♦ isGenerated(<Индeкc поля>) - возвращает False, если поле с указанным индексом по
мечено как неактуальное, и тrue - в противном случае;
♦ isGenerated(<Имя поля>) - возвращает False, если поле с указанным именем помечено
как неактуальное, и тrue - в противном случае.
Пример кода, добавляющего новую запись в модель:
con = QtSql.QSqlDatabase.addDatabase('QSQLITE')
con.setDatabaseName('data. sqlite')
con.open()
stm = QtSql.QSqlTaЬleModel()
stm. setTaЫe('good')
stm.select()
rec = con.record('good' )
rec. setValue( 'goodname', 'Коврик дr1я мьШIИ')
rec.setValue('goodcount', 2)
stm.insertRecord(-1, rec)
Пример кода, редактирующего существующую запись с индексом 3:
rec = stm.record(З)
rec.setValue('goodcount', 5)
stm.setRecord(З, rec)
Класс QSqlTaЬleModel поддерживает такие сигналь�:
♦ primeinsert(<Индекс>, <Запись QSqlRecord>) - генерируется при вызове метода
insertRows() перед добавлением каждой из записей в модель. В первом параметре дос
тупен целочисленный индекс добавляемой записи, а ·во втором - сама добавляемая
запись, пустая, в которую можно занести какие-либо значения по умолчанию;
♦ beforeinsert(<Запись QSqlRecord>) - генерируется перед добавлением новой записи
в таблицу. В параметре доступна добавляемая запись;
♦ beforeUpdate(<Индекс>, <Запись QSqlRecord>) - генерируется перед изменением запи
си в таблице. В параметрах доступны целочисленный индекс изменяемой записи и сама
изменяемая запись;
♦ beforeDelete(<Индекс>) - генерируется· перед удалением записи из таблицы. В пара
метре доступен целочисленный индекс удаляемой записи;
Глава 24. Работа с базами данных 569
♦ dataChanged(<Индекс QSqlRecord l>, <Индекс QSqlRecord 2>, roles= [] ) - генериру
ется при изменении данных в модели пользователем. Первым параметром передается
индекс верхней левой из набора измененных записей, вторым - индекс правой нижней.
Необязательный параметр roles хранит список ролей, данные которых изменились.
Если указан пустой список, значит, изменились данные во всех ролях.
Сигнал dataChanged - идеальное место для вызова методов suЬmit() или suЬmitAll()
в случае, если у модели был задан режим редактирования OnМanualSuЬmit. Как мы знаем,
эти методы выполняют сохранение отредактированных данных в базе.
В листинге 24.9 представлен код складской программы, позволяющей править, добавлять и
удалять записи нажатием соответствующих кнопок. А на рис. 24.1 можно увидеть саму про
грамму в работе.
from PyQtб import QtCore, QtWidgets, QtSql
import sys
def addRecord():
# Вставляем пустую запись, в которую пользователь сможет
# ввести нужные данные
stm.insertRow(stm.rowCount())
def delRecord():
# Удаляем запись из модели
stm.removeRow(tv.currentlndex().row())
# Вьmолняем повторное считывание данных в модель,
# чтобы убрать пустую "мусорную" запись
stm.select ()
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QSqlTaЫeModel")
# Устанавливаем соединение с базой данных
con = QtSql.QSqlDatabase.addDataЬase('QSQLITE')
con.setDataЬaseName('data.sqlite')
con.open()
# Создаем модель
stm = QtSql.QSqlTaЬleМodel(parent=window)
stm.setTaЫe('good')
stm.setSort(l, QtCore.Qt.SortOrder.AscendingOrder)
stm.select()
# Задаем заголовки для столбцов модели
stm.setHeaderData(l, QtCore.Qt.Orientation.Horizontal, 'Название')
stm.setHeaderData(2, QtCore.Qt.Orientation.Horizontal, 'Кол-во')
# Задаем для таблицы только что созданную модель
vbox = QtWidgets.QVВoxLayout()
tv = QtWidgets.QТaЬleView()
tv.setModel(stm)
570 Часть //. Библиотека PyQt б
# Скрываем первый столбец, в котором выводится идентификатор
tv.hideColшnn(0)
tv.setColшnnWidth(l, 150)
tv.setColшnnWidth(2, 60)
vbox.addWidget(tv)
btnAdd = QtWidgets. QPushButton("&Добавить запись")
btnAdd.clicked.connect(addRecord)
vbox.addWidget(btnAdd)
ЬtnDel = QtWidgets. QPushButton("&Удалить запись")
ЬtnDel.clicked.connect(delRecord)
vbox.addWidget(ЬtnDel)
window.setLayout(vbox)
window.resize(370, 250)
window.show()
sys.exit(app .exec())
i] QSqlTaЫeModel · □ х
Название Коп-во
!
Бумага офисная 115
2 Кабель 11
·тi
3 Картридж ;з
-t----ll
4 Компакт-диск
�;1
5 Флеш-накопитель ;20
6 Фотобумага 8
Добавить запи_сь·
}'далить запись
Рис. 24.1. Пример складской программы, использующей модель QSqlTaЬleModel
24.4.3. Модель, подцерживающая межтабличные связи
Предположим, что мы решили расширить нашу простенькую складскую программу, введя
разбиение товаров на категории. В базе данных data. sqlite мы создали таблицу category
с полями id и catnarne, а в таблицу good добавили поле category, где будут храниться иден
тификаторы категорий.
Теперь попытаемся вывести содержимое таблицы good на экран с ·помощью модели
QSqlTaЫeModel и таблицы QTaЫeView. И сразу увидим, что в колонке, где показьmается со
держимое поля category, вьmодятся числовые идентификаторы категорий (рис. 24.2). А нам
хотелось бы видеть там наименования категорий вместо непонятной цифири.
Глава 24. Работа с базами данных 571
[i] QSqlTaЬleModel о х
Название Кол-во Категор
ия
1 !Бума га офисная
2 б ль
l
11
1s
Ка е
а тридж 1з
З К р г-
4 К омпакт-д иск 1·· ... ·13·
;5
20
5 Флеш- нак опитель
!З
6 Ф т бумага
о о
Удалить запись
Рис. 24.2. Пример складской программы после доработки: вместо названий категорий
выводятся их числовые идентификаторы
Сделать это· поможет класс QSqlRelationalTaЬleModel, реализующий модель вторичной
таблицы, которая связывается с первичной таблицей. Иерархия наследования этого класса:
JQbject - QAЬstractitemМodel - QAЬstractTaЬleModel - QSqlQueryМodel -
QSqlTaЬleModel - QSqlRelationalTaЬleModel
Формат конструктора класса:
QSqlRelationalQueryModel([parent=None] [, dЬ=QSqlDatabase()])
Необязательный параметр dЬ задает соединение с базой данных, запрос к которой следует
выполнить, - если он не указан, будет использоваться соединение по умолчанию.
Класс QSqlRelationalTaЫeModel наследует все методы класса QSqlTaЫeModel (см. разд. 24.4.2)
и в дополнение к ним определяет следующие полезные для нас методы (полный их список
приведен на странице https://doc.qt.io/qt-6/qsqlrelationaltaЫemodel.html):
♦ setRelation(<Индeкc поля>, <Связь>) - задает связь для поля внешнего кmоча с ука
занным индексом. Сама связь представляется объектом класса QSqlRelation, рассматри
ваемым чуть позже;
♦ setJoinМode(<Режим связывания>) - задает режим связывания для всей модели. В каче
стве параметра указывается один из элементов перечисления JoinМode1, ,и з класса
QSqlRelationalTaЬleModel:
• InnerJoin - каждой записи вторичной таблицы должна соответствовать связанная
с ней запись первичной таблицы. Используется по умолчанию;
• LeftJoin - записи вторичной таблицьt не обязательно должна соответствовать свя-
занная запись первичной таблиць1.
Класс QSqlRelation представляет саму межтабличную связь. Его конструктор имеет такой
формат:
QSqlRelation(<Имя первичной таблицы>, <Имя поля первичного ключа>,
<Имя поля, выводящегося на экран>)
572 Часть 11. Библиотека PyQt б
Поля, чьи имена указываются во втором и третьем параметрах, относятся к первичной таб
лице.
В листинге 24.1 О приведен код исправленной складской программы, а на рис. 24.3 показан
ее интерфейс.
from PyQtб import QtCore, QtWidgets, QtSql
import sys
def addRecord():
stm.insertRow(stm.rowCount())
def delRecord():
stm.removeRow(tv.currentindex().row())
stm.select()
арр = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowТitle("QRelationalSqlTaЬleМodel")
con = QtSql.QSqlDatabase.addDatabase('QSQLITE')
con.setDatabaseName('data.sqlite')
con.open()
stm = QtSql.QSqlRelationalTaЫeModel(parent=window)
stm.setTaЫe('good')
stm.setSort(l, QtCore.Qt.SortOrder.AscendingOrder)
# Задаем для поля категории связь с таблицей списка категорий
stm.setRelation(З, QtSql.QSqlRelation('category', 'id', 'catname'))
stm. select()
stm.setНeaderData(l, QtCore.Qt.Orientation.Hoiizontal, 'Название')
stm.setHeaderData(2, QtCore.Qt.Orientation.Horizontal, 'Кол-во')
stm.setHeaderData(З, QtCore.Qt.Orientation.Horizontal, 'категория')
vbox = QtWidgets.QVВoxLayout()
tv = QtWidgets.QТaЬleView()
tv.setModel(stm)
tv.hideColumn(O)
tv.setColumnWidth(l, 150)
tv.setColumnWidth(2, 60)
tv.setColumnWidth(З, 150)
vbox.addWidget(tv)
ЬtnAdd = QtWidgets.QPushButton("&Дoбaвить запись")
ЬtnAdd.clicked.connect(addRecord)
vbox.addWidget(ЬtnAdd)
ЬtnDel = QtWidgets.QPushВutton("&Удалить запись")
ЬtnDel.clicked.connect(delRecord)
vbox.addWidget(ЬtnDel)
window.setLayout(vbox)
window.resize(420, 250)
window.show()
sys.exit(app.exec())
Глава 24. Работа с базами данных 573
iiJ QRelationalSqlTaЬleModel □ х
Н азвание Кол-во К атего и я
р
11 s
Бумага офисная j Расходные материалы
2 К абел
ь ... ]_1 �· J�р�ч�� ��- .•..
3 и
Картр дж
j\.3 j Расходные материал ы
. 11
4 К ом пак т-диск j5 Н опите ли
5 Флеш-накоnитель
+· ...
! 20
+Нак .... .............. .
j акопите ли
. ·10;
!
б Фотобумага Расход ные_ м�тер иалы
Рис. 24.3. Пример складской программы, использующей модель QSqlRelationalTaЬleModel:
на экран выводятся названия категорий
24.4.4. Использование связанных делегатов
Исправленная складская программа имеет существеннейший недостаток - как только мы
решим добавить новую запись или исправить уже существующую, то столкнемся с тем, что
все сделанные нами изменения не сохраняются. Почему?
1
Дело в том, что модель QSqlRelationalTaЬleМodel «не знает», как перевести введенное на-
звание категории в ее идентификатор, который и хранится в поле category таблицы good.
Она лишь вьшолняет попытку занести строковое название категории в поле целочисленного
типа, что вполне ожидаемо вызывает ошибку, и запись в таблице не сохраняется.
Исправить такое положение дел нам позволит особый делегат, называемый связанным
(о делегатах рассказывалось в разд. 23.8). Он способен выполнить поиск в первичной таб
лице нужной записи, извлечь ее идентификатор и сохранить его в поле вторичной таблицы.
А, кроме того, он представляет все доступные для занесения в поле значения, взятые из
первичной таблицы, в виде раскрывающегося списка - очень удобно!
Функциональность связанного делегата реализует класс QSqlRelationalDelegate. Иерархия
наследования:
QObject - QAЬstractitemDelegate - QStyleditemDelegate - QSqlRelationalDelegate
Использовать связаннъrй делегат очень просто - нужно лишь создать его объект, передав
конструктору класса ссьшку на компонент-представление (в нашем случае - таблицу),
и вызвать у представления метод setitemDelegate (), setitemDelegateForColumn () или
setitemDelegateForRow (), указав в нем только что созданнъrй делегат.
Доработаем складскую программу, дав полъзоватето возможность выбирать категории то
варов из списка. Для чего вставим в код листинга 24.10 одно новое выражение (в приведен
ном далее листинге 24.11 оно выделено полужирным шрифтом):
574 Часть 11. Библиотека PyQt 6
nмстинr 24.11. Испопьэованме связанноrQ деnеrата
(фра,._нт мсnравленного «ода 8"3 nмстмнrа 24s10)
tv = QtWidgets.QTaЬleView()
tv. setModel (stm)
tv.setitemDelegateForColumn(З, Qtsql.QSqlRelationalDelegate(tv))
tv.hideColumn(O)
Интерфейс законченной программы показан на рис. 24.4.
[i] QRelationalSqlTaЬleModel □ х
Название Кол-во Катеrория
Бумага офисная ! 15 Расходные материалы
2 Кабель Прочее
з Картридж 3 : Расходные материалы V
5 Прочее
4 Компакт-диск
-··· ···--·-----··--·---- Ра�одные материалы
5 Флеш-накопитель 20 Накопители
6 Фотобумага 8 ! Расходные материалы
....1.
Рис. 24.4. Окончательный вариант складской программы, использующей связанный делегат
ГЛАВА 25
Работа с графикой
PyQt предоставляет класс QPainter, содержащий инструменты для рисования произвольной
графики. Рисование выполняется на поверхности, реализуемой классом QPaintoevice или
одним из его подклассов, в число которых входит и QWidget - базовый класс всех компо
нентов. Это дает возможность выводить произвольную графику на произвольном компо
ненте (вкточая обычное окно).
Когда у компонента возникает необходимость выполнить перерисовку (что может произой
ти, например, при первом выводе содержащего его окна, активизации этого окна, его разво
рачивании и т. п.), в его объекте вызывается специальный метод paintEvent(). Внутри этого
метода и выполняется рисование на компоненте необходимой графики. Инициировать при
нудительную перерисовку компонента можно вызовом метода repaint() или update (.)
(подробности - в разд. 20. 7.3).
Все описанные в этой главе классы определены в модуле QtGui, если не указано обратное.
PyQt также позволяет работать с SVG-графикой и вкточает в свой состав поддержку техно
логии OpenGL, предназначенной для вьIВода двумерной и трехмерной графики. Рассмотре
ние этих инструментов выходит за рамки нашей книги, поэтому за подробной информацией
о них обращайтесь к соответствующей документации.
25.1. Вспомогательные классы
25.1.1. Класс QСо/ог. цвет
Класс QColor описывает цвет в цветовых моделях RGB, СМУК, HSV или HSL. Форматы
конструктора класса QColor:
QColor()
QСоlоr(<Красный>, <Зеленый>, <Синий>[, alpha=255])
QColor(<Cтpoкa>)
QСоlоr(<Элемент перечисления GlobalColor>)
QСоlоr(<Число>)
QСоlоr(<Исходный цвет QColor>)
Первый формат создает невалидный объект. Проверить объект на валидность можно с по
мощью метода isValid(). Метод возвращает значение тrue, если объект является валид
ным, и False - в противном случае.
576 · Часть 11. Библиотека PyQt б
Второй формат принимает целочисленные значения красной, зеленой и синей составляю
щих цвета модели RGB. В качестве параметров указываются числа от О до 255. Необяза
тельный параметр alpha задает степень прозрачности· цвета: значение О соответствует про
зрачному цвету, а значение 255 - полностью непрозрачному.
Вот пример указания красного цвета:
red = QtGui.QColor(255, О, О)
В третьем формате цвет, указывается в виде строки в форматах "#RGB", "#RRGGBB",
"#AARRGGBB" (здесь м обозначает степень прозрачности цвета), "#RRRGGGBBB", "#RRRRGGGGBBBB",
"<Название цвета>" или "transparent" (прозрачный цвет):
red = QtGui.QColor("#f00")
darkВlue = QtGui.QColor("#000080")
semiTransparentDarkBlue =.QtGui.QColor("#7F000080")
white = QtGui.QColor("white")
Получить список всех поддерживаемых · названий цветов позволяет статический метод
colorNames(). Проверить правильность строки с названием цвета можно с помощью стати
ческого метода isValidColor(<Строка>), который возвращает значение True, если строка
является правильным наименованием цвета, и False- в противном случае:
print(QtGui.QColor.colorNames()) # ['aliceЫue', 'antiquewhite', ... ]
print(QtGui.QColor.isValidColor("lightcyan")) # True
В четвертом формате указываются следующие элементы перечисления GlobalColor из мо
дуля QtCore.Qt: white, Ыасk, red, darkRed, green, darkGreen, Ыuе, darkBlue, cyan, darkCyan,
magenta, darkМagenta, yellow, darkYellow, gray, darkGray, lightGray, color0, colorl или
transparent (прозрачный цвет). Элементы color0 (прозрачный цвет) и colorl (непрозрач
ный цвет) используются в двухцветных изображениях:
Ыасk = QtCore.Qt.GlobalColor.Ыack
В пятом формате указывается целочисленное значение цвета:
darkBlue = QtGui.QColor(0x000080)
Шестой формат создает новый объект на основе указанного в параметре.
Задать или получить значения в цветовой модели RGB (Red, Green, Blue - красный, зеле
ный, синий) позволяют следующие методы:
♦ setNamedColor(<Cтpoкa>) - задает название цвета в виде строки в форматах "#RGB",
"#RRGGBB", "#МRRGGBB", "#RRRGGGBBB", "#RRRRGGGGBBBB", "<Название цвета>" или
"transparent" (прозрачный цвет);
♦ name( [format=NameFormat.HexRgb J ) - возвращает строковое представление цвета в виде
строки в· формате, заданном параметром format. Формат указывается в виде эле�ентов
перечисления NameFormat из класса QColor:
• HexRgb- в формате "#RRGGBB";
• HexArgb-B формате "#AARRGGBB";
♦ sеtRgЬ(<Красный>, <Зеленый>, <Синий>[, alpha=255J) - задает целочисленнь1е значе
ния красной, зеленой и синей составляющих цвета модели RGB. В качестве параметров
указываются числа от О до 255. Необязательный параметр alpha задает степень прозрач
ности цвета: значение О соответствует прозрачному цвету, а значение 255 - полностью
непрозрачному;
Глава 25. Работа с. графикой 577
♦ setRgb(<Число>) - задает целочисленное значение цвета;
♦ setRgba(<Число>) - задает целочисленное значение цвета со степенью прозрачности;
♦ setRed(<Красный>), setGreen(<Зеленый>), setВlue(<Синий>) и setAlpha (<Прозрачность>) -
задают значения отдельных составляющих цвета. В качестве параметров указываются
числа от О до 255;
♦ fromRgb(<Красный>, <Зеленый>, <Синий> [, alpha=255]) - статический,. возвращает
объект класса QColor с указаннь1ми значениями. В качестве параметров указьmаются
числа от о до 255:
white = QtGui.QColor.fromRgb(255, 255, 255, 255)
♦ fromRgb(<Число>) и fromRgba(<Число>) - статические, возвращают объект класса QColor
со значениями, соответствующими целым числам, которые указаны в параметрах:
white = QtGui.QColor.fromRgba(4294967295)
♦ getRgb() - возвращает кортеж из четырех целочисленных значений (<Красный>, <Зеле
ный>, <Синий>, <Прозрачность>);
♦ red(), green (), Ыuе() и alpha () - возвращают целочисленные значения отдельных со
ставляющих цвета;
♦ rgb() и rgba() - возвращают целочисленное значение цвета;
♦ setRgbF(<Кpacный>, <Зеленый>, <Синий>[, alpha=l.0]) - задает значения красной, зе
леной .и синей составляющих цвета модели RGB. В качестве параметров указываются
вещественнь1е числа от о.о до 1.о. Необязательный параметр alpha задает степень про·
зрачности цвета: значение о.о соответствует прозрачному цвету, а значение l. о - пол
ностью непрозрачному;
♦ setRedF(<Красный>), setGreenF(<Зеленый>), setBlueF(<Синий>) и setAlphaF(<Прозрачность>) -
задают значения отдельных составляющих цвета. В качестве параметров указываются
вещественньrе числа от о.о до 1.о;
♦ fromRgbF(<Кpacный>, <Зеленый>, <Синий>[, alpha=l.0]) - статический, возвращает
объект класса QColor с указанными значениями. В качестве параметров указываются
вещественнь1е числа от о. о до l.о:
white = QtGui.QColor.fromRgbF(l.0, 1.0, 1.0, 1.0)
♦ get:RgbF() - возвращает кортеж из четырех вещественнь1х значений (<Красный>, <Зеле
ный>, <Синий>, <Прозрачность>);
♦ redF(), greenF(), ЫueF() и alphaF() - возвращают вещественные значения отдельных'
составляющих цвета;
♦ lighter ([factor=l50]) - если параметр имеет значение больше 100, то возвращает
новый объект с более светлым цветом, а если меньше 100 - то с более темным;
♦ darker ([factor=200] ) - если параметр имеет значение больше 100, то возвращает
новый объект с более темным цветом, а если меньше 100 - то с более светлым.
Задать или получить значения в цветовой модели СМУК (Cyan, Magenta, Yellow, Кеу
голубой, пурпурный, желтый, «ключевой» - он же черный) позволяют следующие методы:
♦ sеtСmуk(<Голубой>, <Пурпурный>, <Желтый>, <Черный>[, alpha=255]) - задает цело
численнь1е значения составляющих цвета модели СМУК. В качестве параметров указы
ваются числа от О до 255. Необязательный параметр alpha задает степень прозрачности
578 Часть 11. Библиотека PyQt 6
цвета: значение О соответствует прозрачному цвету, а значение 255-полностью непро
зрачному;
♦ fromQnyk(<Гoлyбoй>, <Пурпурный>, <Желтый>, <Черный>[, alpha=255]) - статический,
возвращает объект класса QColor с указанными значениями. В качестве параметров ука
зываются числа от О до 255:
white = QtGui.QColor.fromQnyk(0, О, О, О, 255)
♦ getanyk () - возвращает кортеж из пяти целочисленных значений (<Голубой>, <Пурпур
ный>, <Желтый>, <Черный>, <Прозрачность>);
♦ cyan(), magenta (), yellow(), Ыасk () и alpha () - возвращают целочисленные значения
отдельных составляющих цвета;
♦ setQnykF (<Голубой>, <Пурпурный>, <Желтый>, <Черный>[, alpha = l.О]) - задает значе
ния составляющих цвета модели СМУК. В качестве параметров указываются вещест
венные числа от о. о до 1.о. Необязательный параметр alpha задает степень прозрачно
сти цвета: значение о. о соответствует прозрачному цвету, а значение 1. о - полностью
непрозрачному;
♦ fromQnykF (<Голубой>, <Пурпурный>, <Желтый>, <Черный>[, alpha= l.О] ) -статический,
возвращает объект класса QColor с указанными значениями. В качестве параметров ука
зываются вещественные числа от о.о до 1.о:
white = QtGui.QColor.fromQnykF(0.0, О.О, О.О, О.О, 1.0)
♦ getQnykF() - возвращает кортеж из пяти вещественнь1х значений (<Голубой>, <Пурпур
ный>, <Желтый>, <Черный>, <Прозрачность>);
♦ cyanF(), magentaF(), yellowF (), ЫackF () и alphaE: () - возвращают вещественные зна-
чения отдельных составляющих цвета.
Задать или получить значения в цветовой модели HSV (Hue, Saturation, Value- оттенок,
насыщенность, значение-оно же яркость) позволяют следующие методы:
♦ setHsv(<Оттенок>, <Насыценность>, <Значение> [, alpha=255]) - задает целочислен
ные значения составляющих цвета модели HSV. В первом параметре указывается число
от О до 359, а в остальных параметрах - числа от О до 255;
♦ fromНsv (.<Оттенок>, <Насьпценность>, <Значение> [, alpha =255]) статический, воз-
вращает объект класса QColor с указанными значениями:
white = QtGui.QColor.fromНsv(0, О, 255, 255)
♦ getHsv () - возвращает кортеж из четырех целочисленных значений (<Оттенок>, <Насы
щенность>, <Значение>, <Прозрачность>);
♦ hsvHue (), hsvSaturation (), value () и alpha () - возвращают целочисленнь1е значения
отдельных составляющих цвета;
♦ setHsvF(<Оттенок>, <Насыценность>, <Значение>[, alpha= l.О]) - задает значения со
ставляющих цвета модели HSV. В качестве параметров указываются вещественнь1е чис
ла от о.о до 1 .о;
♦ fromНsvF(<Oттeнoк>, <Насыценность>, <Значение>[, alpha =l.0]) - статический, воз
вращает объект класса QColor с указанными значениями. В качестве параметров указы
ваются вещественные числа от о. о до 1.о:
white = QtGui.QColor.fromНsvF(0.0, О.О, 1.0, 1.0)
Глава 25. Работа с графикой 579
♦ getHsvF () - возвращает кортеж из четырех вещественных значений (<Оттенок>, <Насы
щенность>, <Значение>, <Прозрачность>);
♦ hsvHueF (), hsvSaturationF (), valueF () и alphaF () - возвращают вещественные значе-
ния отдельных составляющих цвета.
Цветовая модель HSL (Hue, Saturation, Lightness - оттенок, насыщенность, яркость) отли
чается от модели HSV только последней составляющей. Описание этой модели и полный
перечень методов для установки и получения значений приведены в документации.
Для получения типа используемой модели и преобразования между моделями предназначе
ны следующие методы:
♦ spec() - возвращает тип используемой модели в виде одного из следующих элементов
перечисления Spec из класса QColor: Invalid (объект не валиден), Rgb, Hsv, Cmyk или Hsl;
♦ convertTo(<Целевой тип модели>) - преобразует тип модели. В качестве параметра ука
зываются элементы перечисления Spec из класса QColor (бьmо описано ранее). Метод
возвращает новый объект цвета. Пример:
whiteHSV = QtGui.QColor.fromНsv(O, О, 255)
whiteRGB = whiteHSV.convertTo(QtGui.QColor.Spec.Rgb)
Также можно пользоваться методами toRgb (), toCmyk (), toнsv() и toHsl(), которые воз
вращают новые объекты цвета:
whiteHSV = QtGui.QColor. fromНsv(O, О, 255)
whiteRGB = whiteHSV.toRgb ()
25.1.2. Класс QPen: перо
Класс QPen описывает виртуальное перо, с помощью которого производится рисование
точек, линий и контуров фигур. Форматы конструктора класса:
JPen()
JРеn(<Цвет QColor>)
JРеn(<Стиль линий>)
JРеn(<Цвет QColor или кисть QBrush>, <Ширина>[, style=PenStyle. Solic!Line] [,
cap=PenCapStyle.SquareCap] [, join=PenJoinStyle.BevelJoin])
JРеn(<Исходное перо QPen>)
Первый формат создает перо черного цвета с настройками по умолчанию. Второй формат
задает только цвет пера. Третий формат позволяет указать стиль линий - в виде элемента
перечисления PenStyle из модуля QtCore.Qt:
♦ NoPen - линия не выводится;
♦ Solic!Line - сплошная линия;
♦ DashLine - штриховая линия;
♦ DotLine - точечная линия;
♦ DashDotLine - штрих и точка, штрих и точка и т. д.;
♦ DashDotDotLine - штрих и две точки, штрих и две точки и т. д.;
♦ CustornDashLine - пользовательский стиль.
580 Часть 11. Библиотека PyQt 6
Четвертый формат позволяет задать все характеристики пера за один раз. В параметре style
указывается стиль линий. Необязательный параметр сар задает стиль концов линий в виде
элемента перечисления PenCapStyle из модуля QtCore.Qt:
♦ Flatcap - квадратные концы линии. Длина линии не превышает указанных граничных
точек;
♦ Squarecap - квадратные концы. Длина линии увеличивается с обоих концов на полови
ну ширины линии;
♦ RoundCap - скрутленные концы. Длина линии увеличивается с обоих концов на полови-
ну ширины линии.
Необязательный параметр j oin задает стиль соединения линий - в качестве значения ука
зываются следующие элементы перечисления PenJoinStyle из модуля QtCore.Qt:
♦ BevelJoin - линии соединяются под �стрым углом;
♦ MiterJoin - острые утлы срезаются на определенную величину;
♦ RoundJoin - скругленные углы;
♦ SvgMiterJoin - линии соединяются под острым утлом, как определено в спецификации
SVG 1.2 Tiny.
Последний формат создает новый объект на основе указанного в параметре.
Класс QPen поддерживает следующие методы (здесь приведены только основные - полный
их список можно найти на странице https://doc.qt.io/qt-6/qpen.html):
♦ setColor(<Цвет QColor>) - задает цвет линий;
♦ setBrush(<КИсть QBrush>) - задает кисть;
♦ setWidth(<Ширина типа int>) и setWidthF(<Ширина типа float>) - задают ширину ли-
ний целым числом или числом с плавающей точкой соответственно;
♦ setStyle(<Стиль PenStyle>) - задает стиль линий;
♦ setCapStyle(<Стиль PenCapStyle>) - задает стиль концов линий;
♦ setJoinStyle(<Стиль PenJoinStyle>) - задает стиль соединения линий;
♦ setMiterLimit(<Величина срезания>) - задает величину срезания острых углов, если
указан режим соединения MiterJoin.
25.1.3. Класс QBrush: кисть
Класс QBrush описывает виртуальную кисть, с помощью которой производится заливка
фигур. Форматы конструктора класса:
QBrush()
QBrush(<Цвeт>[, style=BrushStyle.SolidPattern])
QBrush(<Cтиль кисти>)
QВrush(<Градиент>)
QBru,sh(<Цвет>, <Изображение QPixmap>)
QВrush(<Изображение QPixmap или Qimage>)
QBrush(<Oбъeкт класса QBrush>)
Первый формат создает кисть с черной сплошной. заливкой и стилем NoBrush (т. е. заливка
фактически не рисуется).
Глава 25. Работа с графикой 581
Во втором и пятом форматах цвет может быть задан в виде объекта класса QColor или эле
мента перечисления GlobalColor из модуля QtCore . Qt (например: Ыасk).
Во втором и третьем форматах стиль кисти в параметрах <Стиль кисти> и style указывается
в виде элемента перечисления BrushStyle из модуля QtCore. Qt: NoBrush, SolidPattern,
JenselPattern, Dense2Pattern, DenseЗPattern, Dense4Pattern, Dense5Pattern, DenseбPattern,
Dense7Pattern, CrossPattern и др. Так, можно сделать цвет сплошным (SolidPattern) или
имеющим текстуру (например, элемент CrossPattern задает текстуру в виде сетки).
Четвертый формат создает кисть с градиентной заливкой. В параметре <Градиент> указыва
ется объект одного из классов, производных от QGradient: QLinearGradi,ent (линейный гра
диент) , QConicalGradient (конический градиент) или QRadialGradient (радиальный гради
ент). За подробной информацией по этим классам обращайтесь к документации.
Пятый формат создает кисть с заданным сплошным цветом и текстурой, создаваемой ука
занным изображением. Шестой формат создает кисть с черным цветом и текстурой, созда
ваемой указанным изображением.
Последний формат создает копию указанной кисти.
Класс QBrush поддерживает следующие полезные для нас методы (полный их список приве
ден на странице https://doc.qt.io/qt-6/qbrush.html):
♦ setColor(<Цвет>) - задает цвет кисти (объект класса QColor или элемент перечисления
GlobalColor из модуля QtCore. Qt);
♦ setStyle(<Стиль BrushStyle>) -задает стиль кисти;
♦ setTexture (<Изображение QPixmap>) -устанавливает растровое изображение в качестве
текстуры;
♦ setTextureimage (<Изображение Qimage>) - устанавливает изображение в качестве тек
стуры.
25.1.4. Класс QLine: линия
Класс QLine из модуля QtCore описывает координаты линии. Форматы конструктора класса:
QLine()
QLinе(<Начальная точка QPoint>, <Конечная точка QPoint>)
QLine(<Xl>, <Yl>, <Х2>, <У2>)
Первый формат создает линию, имеющую неустановленные местоположение и размеры.
В третьем формате координаты начальной и конечной точек указываются в виде целочис
ленных значений.
Класс QLine поддерживает следующие основные методы (полный их список приведен на
странице https://doc.qt.io/qt-6/qline.html):
♦ isNull() -возвращает значение тrue, если начальная или конечная точка не установле
ны, и False - в противном случае;
♦ setPoints(<Начальная точка QPoint>, <Конечная точка QPoint>) - задает координаты
начальной и конечной точек;
♦ setLine(<Xl>, <Yl>, <Х2>, <У2>) - задает координаты начальной и конечной точек
в виде целочисленных значений;
♦ setPl(<Точка QPoint>) -задает координаты начальной точки;
582 Часть 11. Библиотека PyQt б
♦ setP2(<Точка QPoint>) -задает координаты конечной точки;
♦ pl () -возвращает координаты (объект класса QPoint) начальной точки;
♦ р2() - возвращает координаты (объект класса QPoint) конечной точки;
♦ center() -возвращает координаты (объект класса QPoint) центральной точки;
♦ xl (), yl (), х2() и у2() - возвращают значения отдельных составляющих координат
начальной и конечной точек в виде целых чисел;
♦ dx() -возвращает горизошалъную составляющую вектора линии;
♦ dy() - возвращает вертикальную составляющую вектора линии.
ПРИМЕЧАНИЕ
Класс QLine предназначен для работы с целыми числами. Чтобы работать с вещественны
ми числами, необходимо использовать класс QLineF.
24.1.5. Класс QPolygon: многоугольник
Класс QPolygon описывает координаты вершин многоугольника. Форматы конструктора
класса:
QPolygon()
QPolygon(<Cпиcoк с координатами вершин QPoint>)
QРоlуgоn(<Прямоугольник QRect>[, closed=False])
QРоlуgоn(<Количество вершин>)
QРоlуgоn(<Исходный многоугольник QPolygon>)
Первый формат создает многоугольник, не имеющий вершин. Заполнить его координатами
вершин можно с помощью оператора «. Пример:
polygon = QtGui.QPolygon()
polygon « QtCore.QPoint(20, 50) « QtCore.QPoint(280, 50)
polygon << QtCore.QPoint(150, 280)
Во втором формате указывается список с координатами отдельных вершин:
polygon = QtGui.QPolygon([QtCore.QPoint(20, 50), QtCore.QPoint(280, 50),
QtCore.QPoint(150, 280)])
Третий формат создает многоугольник, имеющий вид заданного прямоугольника. Если па
раметр closed имеет значение False, то созданный многоугольник не будет замкнут, а если
значение тrue -то будет замкнут.
В четвертом формате можно· указать количество вершин, а затем задать координаты путем
присваивания значения по индексу:
polygon = QtGui.QPolygon(З)
polygon[0] QtCore.QPoint(20, 50)
polygon[l] QtCore.QPoint(280, 50)
polygon[2] QtCore.QPoint(150, 280)
Пятый конструктор создает копию заданного исходного объекта.
Класс QPolygon поддерживает следующие методы (здесь приведены только основные -
полный их список можно найти на странице https://doc.qt.io/qt-6/qpolygon.html):
Глава 25. Работа с графикой 583
♦ setpoints() - устанавливает координаты вершин. Ранее установленные значения уда
ляются. Форматы метода:
setPoints(<Cпиcoк с координатами вершин QPoint>)
setPoints(<Xl>, <Yl>[, . . ., <Xn>, <Yn>])
Пример указания значений:
polygon = QtGui.QPolygon()
polyg_on.setPoints([20,50, 280,50, 150,280])
♦ prepend( <Вершина QPoint>) -добавляет новую вершину в начало объекта;
♦ append(<Вершина ·oPoint>) - добавляет новую вершину в конец объекта. Добавить вер
шину можно также с помощью операторов « и +=;
♦ insert(<Индекс>, <Вершина QP;int>) -добавляет новую вершину в позицию с указан
ным индексом;
♦ setPoint() -задает координаты вершины с указанным индексом. Форматы метода:
setPoint(<Индeкc>, <Вершина QPoint>)
setPoint(<Индeкc>, <Х>, <У>)
Также можно задать координаты путем присваивания значения по индексу:
polygon = QtGui.QPolygon(З)
polygon.setPoint(O, QtCore.QPoint(20, 50))
polygon.setPoint(l, 280, 50)
polygon[2]'= QtCore .QPoint(150, 280)
♦ point(<Индекс>) - возвращает объект класса QPoint с координатами вершины, индекс
которой указан в параметре. Получить значение можно также с помощью операции дос
тупа по индексу, например:
polygon = QtGui.QPolygon([20,50, 280,50, 150,280])
print(polygon .point(O)) # PyQt6.QtCore .QPoint(20, 50)
pr;.:i.nt(polygon[l]) # PyQt6.QtCore.QPoint(280, 50)
♦ remove(<Индекс>[, <Количество> J ) - удаляет указанное количество вершин, начиная
с индекса <Индекс>. Если второй параметр не указан, удаляется одна вершина. Удалить
вершину можно также с помощью оператора del по индексу или срезу;
♦ clear() -удаляет все вершины;
♦ size() -возвращает количество вершин;
♦ count([<Координаты QPoint> J ) - возвращает количество вершин. Если указан параметр
<Координаты>, возвращается только количество вершин с этими координатами.
Получить количество вершин можно также с помощью функции len();
♦ isEmpty() -возвращает значение тrue, если многоугольник не содержит ни одной вер
шины, и False -в противном случае;
♦ boundingRec_t() -возвращает объект класса QRect с координатами и размерами прямо-
угольной области, в которую вписан многоугольник.
ПРИМЕЧАНИЕ
Класс QPolygon предназначен для работы с целыми числами. Чтобы работать с веществен
ными числами, необходимо использовать класс QPolygonF.
584 Часть 11. Библиотека PyQt 6
25.1.6. Класс QFont шрифт
Класс QFont описывает характеристики шрифта. Форматы конструктора класса:
QFont()
QFоnt(<Название шрифта>[, pointSize=-1] [, weight=-1] [, italic=False])
QFоnt(<Исходный объект QFont>)
Первый формат создает объект шрифта с настройками, используемыми приложением по
умолчанию. Установить шрифт приложения по умолчанию позволяет статический метод
setFont() класса QApplication.
Второй формат позволяет указать основные характеристики шрифта. В первом параметре
указывается название шрифта или семейства в виде строки. Необязательный параметр
pointSize задает размер шрифта. В параметре weight можно указать степень жирности
шрифта: число от О до 99 или значение элемента Thin, ExtraLight, Light, Nonnal, Mediшn,
DemiBold, Bold, ExtraBold или Black перечисления Weight из класса QFont. Если в параметре
italic указано значение True, шрифт будет курсивным.
Третий формат создает кomno заданного 11сходного объекта.
Класс QFont поддерживает следующие методы (здесь приведены только основные - пол
ный их список можно найти по адресу https://doc.qt.io/qt-6/qfont.html):
♦ setFamily(<Название шрифта>) - задает название шрифта или семейства шрифтов;
♦ family() - возвращает название шрифта;
♦ setPointSize(<Размер типа int>) и setPointSizeF(<Размер типа float>) - задают
размер шрифта в пунктах;
♦ setPixelSize(<Размер>) - задает размер шрифта в пикселах;
♦ pointSize() - возвращает размер шрифта в пунктах в виде целого числа или значе
ние -1, если размер шрифта был установлен в пикселах;
♦ pointSizeF() - возвращает размер шрифта в пунктах в виде вещественного числа или
значение -1, если размер шрифта был установлен в пикселах;
♦ pixelSize() - возвращает размер шрифта в пикселах или -1, если размер шрифта был
установл·ен в пунктах;
♦ setWeight(<Жирность Weight>) - задает степень жирности шрифта;
♦ weight() - возвращает степень жирности шрифта;
♦ setBold(<Флаг>) - если в качестве параметра указано значение тrue, то жирность
шрифта устанавливается равной значению элемента Bold, а если False - то равной зна
чению элемента Normal перечисления Weight из класса QFont;
♦ bold() - возвращает значение тrue, если степень жирности ·шрифта больше значения
элемента Normal перечисления Weight из класса QFont, и False - в противном случае;
♦ setitalic(<Флаг>) - если в качестве параметра указано значение True, шрифт будет
курсивным, а если False - обычного начертания;
♦ italic() - возвращает значение True, если шрифт курсивный, и False - в противном
случае;
♦ setUnderline (<Флаг>) - если в качестве параметра указано значение True, текст будет
подчеркнутым, а если False - неподчеркнутым;
Глава 25. Работа с графикой 585
♦ underline() - возвращает значение True, если текст подчеркнут, и False - в против
ном случае;
♦ sei:Overline(<Флаг>) - если в качестве параметра указано значение тrue, то текст будет
надчеркнутым;
♦ overline () - возвращает значение True, если текст надчеркнут, и False - в противном
случае;
♦ setStrikeOut(<Флаг>) - если в качестве параметра указано значение True, текст будет
зачеркнутым;
♦ strikeOut() - возвращает значение True, если текст зачеркнут, и False - в противном
случае.
Получить список всех доступных шрифтов позволяет метод families() класса
QFontDatabase. Метод возвращает список строк. Отметим, что перед его вызовом следует
создать объект класса QApplication, в противном случае мы получим ошибку исполнения:
from PyQt6 import QtGui, QtWidgets
арр = QtWidgets.QApplication(list())
print(QtGui.QFontDatabase.families())
Чтобы получить список доступных стилей для указанного шрифта, следует воспользоваться
статическим методом styles (<Название шрифта>) класса QFontDatabase:
print(QtGui.QFontDatabase.styles("Arial"))
# [ 'Обычный' , 'Полужирный' , 'Полужирный Курсив' , 'Курсив' ]
Получить допустимые размеры для указанного стиля можно с помощью статического мето
да smoothSizes(<Название шрифта>, <Стиль>) класса QFontDatabase:
print(QtGui.QFontDatabase.smoothSizes("Arial", "Обычный"))
# (6, 7, 8, 9, 10, 11, 12, 14, 16, 18, 20, 22, 24, 26, 28, 36, 48, 72]
Очень часто необходимо произвести выравнивание выводимого текста внутри некоторой
области. Чтобы это сделать, нужно знать размеры области, в которую вписан текст. Полу
чить эти значения можно с помощью класса QFontMetrics, конструктор которого имеет сле
дующий формат вызова:
QFontMetrics(<Шpифт QFont>)
Класс QFontMetrics поддерживает следующие полезные методы:
♦ horiontalAdvance (<Текст> [, length=-1 J ) - возвращает расстояние от начала текста
<Текст> до позиции, в которой должен начаться другой текст. Параметр length позволя
ет ограничить количество символов;
♦ height() - возвращает высоту шрифта;
♦ boundingRect(<Текст>) - возвр�щает объект класса QRect с координатами и размерами
прямоугольной области, в которую вписан текст.
Вот пример получения размеров области:
font = QtGui.QFont("Tahoma", 16)
fm = QtGui.QFontMetrics(font)
print(fm.horizontalAdvance("Cтpoкa")) # 67
print(fm.height()) # 25
print(fm.boundingRect("Cтpoкa")) # PyQt6.QtCore.QRect(O, -21, 66, 25)
586 Часть-11. Библиотека PyQt б
Обратите внимание, что значения, возвращаемые методами horizontalAdvance() и
QRect.width() , различаются.
ПРИМЕЧАНИЕ
Класс QFontмetrics предназначен для работы с целыми числами. Чтобы работать с веще
ственными числами, необходимо использовать класс QFontмetricsF.
25.2. Класс QPainter
Класс QPainter содержит все необходимые средства, позволяющие выполнять рисование
геометрических фигур и вывод текста на поверхности, реализуемой классом QPaintDevice.
Класс QPaintDevice наследуют классы QWidget, QPicture, QPixmap, QI�ge,
QPagedPaintDevice и некоторые дРУГИе. Это дает возможность рисовать на поверхности mо
бого компонента, на изображении или на печатаемой странице. Форматы конструктора
класса:
QPainter()
QРаintеr(<Поверхность рисования>)
Первый формат создает объект, который не подкmочен ни к одной поверхности рисования.
Чтобы подкmочиться к поверхности и захватить контекст рисования, необходимо вызвать
метод begin(<Поверхность>) и передать ему ссылку на объект класса, производного от
QPaintDevice. Метод возвращает значение тrue, если контекст успешно захвачен, и False -
в противном случае. В один момент времени только один объект может рисовать на по
верхности, поэтому после окончания рисования необходимо освободить контекст рисова
ния с помощью метода end() . С учетом сказанного код, позволяющий рисовать на компо
ненте, будет выглядеть так:
def paintEvent(self, е):
# Компонент, на котором выполняется рисование, передается в параметре self
painter = QtGui.QPainter()
pai_nter.begin.(self)
# Здесь производим рисование на компоненте
painter.end()
Второй формат принимает поверхность рисования, которая задана в виде объекта класса,
производного от QPaintDevice, подкmочается к этой поверхности и сразу захватывает кон
текст рисования. Контекст рисования автоматически освобождается внутри деструктора
класса QPainter при уничтожении объекта. Так как объект автоматически уничтожается при
выходе из метода paintEvent() , то метод end() можно и не вызывать.
Вот пример рисования на компоненте:
def paintEvent(self, е):
painter = QtGui.QPainter(self)
# Здесь производим рисование на компоненте
Проверить успешность захвата контекста рисования можно с помощью метода isActive():
он возвращает значение тrue, если контекст захвачен, и False - в противном случае.
Глава 25. Работа с графикой 587
25.2.1. Рисование линий и фигур
После захвата контекста рисования следует установить перо и кисть. С помощью пера про
изводится рисование
_ точек, линий и контуров фигур, а с помощью кисти - заполнение
фона фигур. Установить перо позволяет метод setPen() класса QPainter. Форматы метода:
setPen(<Пepo QPen>)
sеtРеn(<Цвет QColor>)
sеtРеn(<Стиль пера PenStyle>)
Для установки кисти предназначен метод setвrush () . Форматы метода:
setBrush(<КИcть QBrush>)
setBrush(<Cтиль кисти BrushStyle>)
Устанавливать перо или кисть необходимо перед каждой операцией рисования, требующей
изменения цвета или стиля. Если перо или кисть не установлены, будут использоваться
объекты с настройками по умолчанию. После установки пера и кисти можно приступать
к рисованию точек, линий, фигур, текста и др.
Для рисования точек, линий и фигур класс QPainter предоставляет следующие наиболее
часто употребляемые методы (полный их список приведен на странице https://doc.qt.io/
qt-6/qpainter.html):
♦ drawPoint() - рисует точку. Форматы метода:
drawPoint(<X>, <У>)
drawPoint(<Koopдинaты QPoint или QPointF>)
♦ drawPoints() - рисует несколько точек. Форматы метода:
drawPoints(<Koopдинaты QPoint 1>[, . . . , <Координаты QPoint N>])
drawPoints(<Koopдинaты QPointF 1>[, . . . , <Координаты QPointF N>])
drаwРоints(<Многоугольник QPolygon или QPolygonF>)
♦ drawLine() - рисует линию. Форматы метода:
drawLine(<Пиния QLine или QLineF>)
drawLine(<Haчaльнaя точка QPoint>, <Конечная точка QPoint>)
drawLine(<Haчaльнaя точка QPointF>, <Конечная точка QPointF>)
drawLine(<Xl>, <Yl>, <Х2>, <У2>)
♦ drawLines() - рисует несколько отдельных линий. Форматы метода:
drawLines(<Пиния QLine 1>[, . . . , <Пиния QLine N>])
drawLines(<Линия QLineF 1>[, . . . , <Пиния QLineF N>])
drawLines(<Cпиcoк с линиями QLineF>)
drawLines(<Toчкa QPoint 1>[, . . . , <Точка QPoint N>])
drawLines(<Toчкa QPointF 1>[, . . . , <Точка QPointF N>])
♦ drawPolyline() - рисует несколько линий, которые соединяют указанные точки. Пер
вая и последняя точки не соединяются. Форматы метода:
drawPolyline(<Toчкa QPoint 1>[, . . . , <Точка QPoint N>])
drawPolyline(<Toчкa QPointF 1>[, . . . , <Точка QPointF N>])
drаwРоlуlinе(<Многоугольник QPolygon или QPolygonF>)
588 Часть 11. Библиотека PyQt б
♦ drawRect() - рисует прямоугольник с границей и заливкой. Чтобы убрать границу, сле
дует использовать перо со стилем NoPen, а чтобы убрать заливку - кисть со стилем
NoBrush. Форматы метода:
drawRect(<X>, <У>, <Ширина>, <Высота>)
drаwRесt(<Прямоугольник QRect или QRectF>)
♦ fillRect() - рисует прямоугольник с заливкой. без границы. Форматы метода:
fillRect(<X>, <У>, <Ширина>, <Высота>, <Заливка>)
fillRесt(< Прямоугольник QRect или QRectF>, <Заливка>)
< Заливка> может быть задана объектами классов < QColor>, <QBrush>, в виде стиля кисти
или элемента перечисления GlobalColor;
♦ drawRoundedRect() - рисует прямоугольник с границей, заливкой и скругленными
краями. Форматы метода:
drawRoundedRect(<X>, <У>, <Ширина>, <Высота>,
<Скругление по горизонтали>, . <Скругление по вертикали>[,
mode=SizeMode.AЬsoluteSize])
drawRoundedRect(< Пpямoyгoльник QRect или QRectF>,
<Скругление по горизонтали>, <Скругление по вертикали>[,
mode=SizeMode.AЬsoluteSize])
Параметры <Скругление по горизонтали> и <Скругление по вертикали> задают радиусы
скругления углов по горизонтали и вертикали. Необязательный параметр mode указыва
ет, в каких единицах измеряются радиусы скругления углов, и задается одним из сле
дующих элементов перечисления SizeMode из модуля QtCore.Qt:
• AЬsoluteSize - радиусы указываются в пикселах;
• RelativeSize - радиусы указываются в процентах от соответствующего размера ри
суемого прямоугольника;
♦ drawPolygon() - рисует многоугольник с границей и заливкой. Форматы метода:
drawPolygon(<Bepшинa QPoint 1>[, ..., <Вершина QPoint N>])
drawPolygon(<Bepшинa QPointF 1>[, ..., <Вершина QPointF N>])
drаwРоlуgоn(<Многоугольник QPolygon или QPolygonF>[,
fillRule=FillRule.OddEvenFill])
Необязательный параметр fillRule задает алгоритм определения, находится ли какая
либо точка внутри нарисованного многоугольника или вне его. В качестве его значения
указывается атрибут OddEvenFill или WindingFill перечисления FillRule из модуля
QtCore.Qt;
♦ drawEllipse () - рисует эллипс с границей и заливкой. Форматы метода:
drawEllipse(<X>, <У>, <Ширина>, <Высота>)
drаwЕlliрsе(< Прямоугольник QRect или QRectF>)
drawEllipse(<Toчкa QPoint или QPointF>, <int rX>, <int rY>)
В первых двух форматах указываются координаты и размеры прямоугольника, в кото
рый необходимо вписать эллипс. В последнем формате первый параметр задает коорди
наты центра, параметр rx - радиус по оси х, а параметр rY - радиус по оси У;
Глава 25. Работа с графикой 589
♦ drawArc() - рисует дугу. Форматы метода:
drawArc(<X>, <У>, <ШИрина>, <Высота>, <Начальный угол>, <Угол>)
drаwАrс(<Прямоугольник QRect или QRectF>, <Начальный угол>, <Угол>)
Значения углов задаются в значениях 1/16 . Полный круг эквивалентен значению
°
5760 = 16 х 360. Нулевой угол находится в позиции «трех часов». Положительные зна
чения углов отсчитываются против часовой стрелки, а отрицательные - по часовой
стрелке;
♦ drawChord() - рисует замкнутую дугу. Аналогичен методу drawArc(), но соединяет
крайние точки дуги прямой линией. Форматы метода:
drawChord(<X>, <У>, <ШИрина>, <Высота>, <Начальный угол>, <Угол>)
drаwСhоrd(<Прямоугольник QRect или QRectF>, <Начальный угол>, <Угол>)
♦ drawPie() - рисует замкнутый сектор. Аналогичен методу drawArc(), но соединяет
крайние точки дуги с центром окружности. Форматы метода:
drawPie(<X>, <У>, <ШИрина>, <Высота>, <Начальный угол>, <Угол>)
drаwРiе(<Прямоугольник QRect или QRectF>, <Начальный угол>, <Угол>)
При выводе некоторых фигур (например, эллипса) контур может отображаться в виде
«лесенки». Чтобы сгладить контуры фигур, следует вызвать метод setRenderHint (<Режим
сглаживания>) и передать ему в качестве единственного параметра элемент Antialiasing
перечисления RenderHint из класса QPainter:
painter.setRenderHint(QtGui.QPainter.RenderHint.Antialiasing)
Если требуется отключить сглаживание, следует вызвать тот же метод, но передать ему
вторым параметром значение False:
painter.setRenderHint(QtGui.QPainter.RenderHint.Antialiasing, False)
25.2.2. Вывод текста
Вывести текст позволяет метод drawТext() класса QPainter. Форматы метода:
drawТext(<X>, <У>, <Текст>)
drаwТехt(<Координаты QPoint или QPointF>, <Текст>)
drawТext(<X>, <У>, <ШИрина>, <Высота>, <Флаги>, <Текст>)
drаwТехt(<Прямоугольник QRect или QRectF>, <Флаги>, <Текст>)
drаwТехt(<Прямоугольник QRectF>, <Текст>[, option=QTextOption()])
Первые два формата метода выводят текст, начиная с указанных координат.
Следующие два формата выводят текст . в указанную прямоугольную облас�ь: При этом
текст, который не помещается в эту область, будет обрезан, если не указан флаг
тextDontClip. Методы возвращают объект класса QRect (QRectF для четвертого формата)
с координатами и размерами прямоугольника, в который вписан текст. В параметре <Флаги>
через оператор I указываются элементы AlignLeft, AlignRight, AlignНCenter, AlignTop,
AlignBottom, AlignVCenter или AlignCenter перечисления AlignmentFlag из модуля
QtCore. Qt, задающие выравнивание текста внутри прямоугольной области, а также сле
дующие элементы перечисления TextFlag из того же модуля:
♦ TextSingleLine - все пробельные символы (табуляция, возвраты каретки и переводы
строки) трактуются как пробелы, и текст выводится в одну строку;
590 Часть 11. Библиотека PyQt 6
♦ тextDontClip- часть текста, вышедшая за пределы указанной прямоугольной области,
не будет обрезаться;
♦ TextExpandTabs- символы табуляции будут обрабатываться;
♦ тextShowМnemonic-:-- символ, перед которым указан знак &, будет подчеркнут. Чтобы
вывести символ &, его необходимо удвоить;
♦ тextwordW-rap - если текст не помещается на одной строке, будет произведен перенос
сло�а без его разрыва;
♦ тextWrapAnywhere - перенос строки может быть выполнен внутри слова;
♦ TextHideМnemonic- то же самое, что и тextShowМnemonic, но символ не подчеркивается;
♦ TextDontPrint -текст не будет напечатан;
♦ тextincludeTrailingSpaces - размеры текста будут возвращаться с учетом начальных
и конечных пробелов, если таковые есть в тексте;
♦ TextJustificationForced- задает выравнивание по ширине у последней строки текста.
Пятый формат метода drawТext () также вьшодит текст в указанную прямоугольную об
ласть, но выравнивание текста и другие опции задаются с помощью объекта класса
QТextOption. Например, с помощью этого класса можно отобразить непечатаемые символы
(символ пробела, табуляцию и др.).
Получить координаты и размеры прямоугольника, в который вписывается текст, позволяет
метод boundingRect() класса QPainter. Форматы метода:
boundingRect(<X>, <У>, <Ширина>, <Высота>, <Флаги>, <Текст>)
ЬоundingRесt(<Прямоугольник QRect>, <Флаги>, <Текст>)
ЬоundingRесt(<Прямоугольник QRectF>, <Флаги>, <Текст>)
ЬоundingRесt(<Прямоугольник QRectF>, <Текст>[, option=QТextOption()])
Первые два формата возвращают объект класса QRect, а последние два - объект класса
QRectF.
При выводе текста линии букв могут отображаться в виде «лесенки». Чтобы сгладить кон
туры, следует вызвать метод setRenderHint(<Режим сглаживания>) и передать ему элемент
тextAntialiasing перечисления ·RenderHint из класса QPainter:
painter.setRenderHint(QtGui.QPainter.RenderHint.TextAntialiasing)
Если требуется отключить сглаживание, следует вызвать тот же метод, но передать ему
вторым параметром значение False:
painter.setRenderHint(QtGui.QPainter.RenderHint.TextAntialiasing, False)
25.2.3. Вывод изображений
Для вывода растровых изображений предназначены методы drawPixmap() и d�awimage()
класса QPainter. Метод drawPixmap() обеспечивает вывод изображений, хранимых в объек
те класса QPixmap. Форматы метода:
drawPixmap(<X>, <У>, <Изображение QPixmap>)
drаwРiхmар(<Координаты QPoint или QPointF>, <Изображение QPixmap>)
drawPixmap(<X>, <У>, <Ширина>, <Высота>, <Изображение QPixmap>)
drаwРiхmар(<Прямоугольник QRect>, <Изображение QPixmap>)
Глава 25. Работа с графикой 591
drawPixmap(<Xl>, <Yl>, <Изображение QPixmap>, <Х2> 1 <У2>,
<Ширина 2>, <Высота 2>).
drаwРiхmар(<Координаты QPoint>, <Изображение QPixmap>,
<Прямоугольник QRect>)
drаwРiхmар(<Координаты QPointF>, <Изображение QPixmap>,
<Прямоугольник QRectF>)
drawPixmap(<Xl>, <Yl>, <Ширина 1>, <Высота 1>, <Изображение QPixmap>,
<Х2>, <У2>, <Ширина 2>, <Высота 2>)
drаwРiхmар(<Прямоугольник QRect>, <Изображение QPixmap>,
<Прямоугольник QRect>)
drаwРiхmар(<Прямоугольник QRectF>, <Изображение QPixmap>,
<Прямоугольник QRectF>)
Первые два формата задают J\ООрдинаты, в которые будет установлен левый верхний угол
ВЫВОДИМОГО изображения:
pixmap = QtGui.QPixmap( " foto. jpg" )
painter.drawPixmap(З, З, pixmap)
Третий и четвертый форматы позволяют ограничить вывод изображения указанной прямо
угольной областью. Если размеры области не совпадают с размерами изображения, то про
изводится масштабирование изображ.ения. При несоответствии пропорций изображение
может быть искажено.
Пятый, шестой и седьмой форматы задают координаты, в которые будет установлен левый
верхний угол фрагмента изображения. Координаты и размеры вставляемого фрагмента изо
бражения указываются после объекта класса QPixmap в виде отдельных составляющих или
объектов классов QRect или QRectF.
Последние три формата ограничивают вывод фрагмента изображения указанной прямо
угольной областью. Координаты и размеры вставляемого фрагмента изображения указыва
ются после изображения в виде отдельных составляющих или объектов классов QRect или
QRectF. Если размеры области не совпадают с размерами фрагмента изображения, произво
дится масштабирование изображения. При несоответствии пропорций изображение может
быть искажено.
Метод drawimage () предназначен для вывода изображений, хранимых в объектах класса
Qimage. Форматы метода:
drawlmage(<Koopдинaты QPoint или QPointF>, <Изображение Qimage>)
drаwlmаgе(<Прямоугольник QRect или QRectF>, <Изображение Qimage>)
drawlmage(<Xl>, <Yl>, <Изображение Qimage>[, sx=O] [, sy=O] [,
sw=-1) [, sh=-1][, flags=ImageConversionFlag.AutoColor])
drawlmage(<Koopдинaты
_ QPoint>, <Изображение Qimage>,
<Прямоугольник QRect>[, flags=ImageConversionFlag.AutoColor])
drawlmage(<Koopдинaты QPointF>, <Изображение Qimage>,
<Прямоугольник QRectF>[, flags=ImageConversionFlag.AutoColor])
drаwlmаgе(<Прямоугольник QRect>, <Изображение Qimage>,
<Прямоугольник QRect>[, flags= ImageConversionFlag.AutoColor])
drаwimаgе(<Прямоугольник QRectF>, <Изображение Qimage>,
<Прямоугольник QRectF>[, flags=ImageConversionFlag.AutoColor])
Первый, а также третий формат со значениями по умолчанию задают координаты, по кото
рым будет находиться левый верхний угол выводимого изображения:
592 Часть 11. Библиотека PyQt 6
img = QtGui.Qimage("foto. jpg")
painter.drawimage(З, 3, img)
Второй формат ограничивает вывод изображения указанной прямоугольной областью. Если
размеры области не совпадают с размерами изображения, то производится масштабирова
ние изображения. При несоответствии пропорций изображение может быть искажено.
Третий, четвертый и пятый форматы задают координаты, в которые будет установлен ле
вый верхний угол фрагмента изображения. Координаты и размеры вставляемого фрагмента
изображения указываются после изображения в виде отдельных составляющих или объек
тов классов QRect или QRectF.
Последние два формата ограничивают вывод фрагмента изображения указанной прямо
угольной областью. Координаты и размеры вставляемого фрагмента изображения указыва
ются после изображения в виде объектов кilассов QRect или QRectF. Если размеры области
не совпадают с размерами фрагмента изображения, производится масштабирование изо
бражения. При несоответствии пропорций изображение может быть искажено.
Необязательный параметр flags задает цветовые преобразования, которые будут выполне
ны при выводе изображения (фактически - при неявном преобразовании объекта класса
Qimage в объект класса QPixmap, которое обязательно выполняется перед выводом). Они ука
зываются в виде элементов перечисления ImageConve.i:sionFlag из модуля QtCore. Qt, приве
денных на странице https://doc.qt.io/qt-6/qt.html#lmageConversionFlag-enum . В большин
стве случаев имеет смысл использовать заданный по умолчанию элемент Aut?Color этого
перечисления.
25.2.4. Преобразование систем координат
Существуют две системы координат: физическая (viewport, система координат устройства)
и логическая (window). При рисовании координаты из логической системы координат пре
образуются в систему координат устройства. По умолчанию эти две системы координат
совпадают.
В некоторых случаях возникает необходимость изменить координаты. Выполнить измене
ние физической системы координат позволяет метод setViewport(<Х>, <У>, <Ширина>,
<Высота>) или setViewport(<Объект класса QRect>), а получить текущие значения - метод
viewport (). Выполнить изменение логической системы координат позволяет метод
setWindow(<Х>, <У>, <111ирина>, <Высота>) или setWindow(<Объект класса QRect>), а полу
чить текущие значения - метод window() класса QPainter.
Произвести дополнительную трансформацию системы координат позволяют следующие
методы того же класса QPainter:
♦ translate() - перемещает начало координат в указанную точку. По умолчанию начало
координат находится в левом верхнем углу. Положительная ось х направлена вправо, а
положительная ось У - вниз. Форматы метода:
translate(<X>, <У>)
translate(<Toчкa QPoint или QPointF>)
♦ rotate(<Угол>) - поворачивает систему координат на заданный угол (указывается
в виде вещественного числа в градусах). Положительное зна�ение вызывает поворот по
часовой сrрелке, а отрицательное значение - против часовой стрелки;
Глава 25. Работа с графикой 593
♦ scale(<По оси Х>, <По оси У>) - масштабирует систему координат. В качестве значе
ний указываются вещественные числа. Если значение меньше единицы, то выполняется
уменьшение, а если больше единицы - то увеличение;
♦ shear(<По горизонтали>, <По вертикали>) - сдвигает систему координат. В качестве
значений указываются вещественные числа.
Все указанные трансформации влияют на последующие операции рисования и не изменяют
ранее нарисованные фигуры. Чтобы после трансформации восстановить систему координат,
следует предварительно сохранить состояние в стеке с помощью метода save(), а после
окончания рисования вызвать метод restore():
painter.save() # Сохраняем состояние
# Трансформируем и рисуем
painter.restore() # Восстанавливаем состояние
Несколько трансформаций можно произвести последовательно друг за другом. При этом
надо учитывать, что порядок следования трансформаций имеет значение.
Если одна и та же последовательность трансформаций выполняется несколько раз, то ее
можно сохранить в объекте класса QTransfoпn, а затем установить с помощью метода
setTransforrn(<Tpaнcфopмaция>):
transforrn = QtGui.QTransfonn()
transfonn.translate(105, 105)
transfonn.rotate(45.0)
painter.setTransfonn(transforrn)
painter.fillRect(-25, -25, 50, 50, QtCore.Qt.green)
25.2.5. Сохранение команд рисования в файл
Класс QPicture выполняет роль устройства для рисования с возможностью сохранения
команд рисования в файле специального формата для последующего вывода его на экран.
Иерархия наследования:
QPaintDevice - QPicture
Форматы конструктора класса:
<Объект> QPicture([fonnatVersion=-1])
<Объект> = QРiсturе(<Исходный объект QPicture>)
Первый конструктор создает пустой рисунок. Необязательный параметр fonnatVersion
задает версию формата. Если параметр не указан, то используется формат, принятый в те
кущей версии PyQt. Второй конструктор создает копию заданного объекта.
Для сохранения и загрузки рисунка предназначены следующие методы:
♦ save(<Путь к файлу>) - сохраняет рисунок в файле с указанным путем. Возвращает
значение тrue, если рисунок успешно сохранен, и False - в противном случае;
♦ load(<Путь к файлу>) - загружает рисунок из файла с указанным путем. Возвр�щает
значение тrue, если рисунок успешно загружен, и False - в противном случае.
Для вывода загруженного рисунка на устройство рисования по указанным координатам
предназначен метод drawPicture() класса QPainter. Форматы метода:
drawPicture(<X>, <У>, <Изображение QPicture>)
drawPicture(<Koopдинaты QPoint или QPointF>, <Изображение QPicture>)
594 Часть 11. Библиотека PyQt б
Пример сохранения рисунка:
painter = QtGui.QPainter()
pic = QtGui.QPicture()
painter.begin(pic)
# Здесь что-то рисуем
painter.end()
pic.save(r"c:\book\pic.dat")
Пример вывода загруженного рисунка на поверхность компонента:
def paintEvent(self, е):
painter = QtGui.QPainter(self)
pic = QtGui.QPicture()
pic.load(r"c:\book\pic.dat")
painter.drawPicture(0, О, pic)
25.3. Работа с растровыми изображениями
Библиотека PyQt включает несколько классов, позволяющих работать с растровыми изо
бражениями в контекстно-зависимом (классы QPixmap и QBitmap) и контекстно-независимом
(класс Qimage) представлениях.
Получить список графических форматов, доступных для загрузки, позволяет статический
метод supportedimageFormats () класса QimageReader, возвращающий список с объектами
класса QByteArray. Получим список поддерживаемых форматов для чтения:
>>> for i in QtGui.QimageReader.supportedimageFormats():
print(str(i, "ascii").upper(), end=" ")
ВМР CUR GIF ICNS ICO JPEG JPG РВМ PGM PNG РРМ SVG SVGZ TGA TIF TIFF WBMP
WEBP ХВМ ХРМ
Получить список графических форматов, доступных для сохранения, позволяет статический
метод supportedimageFormats() класса QimageWriter, возвращающий список с объектами
класса QByteArray. Получим список поддерживаемых форматов для записи:
>>> for i in QtGui.QimageWriter .supportedimageFormats():
print(str(i, "ascii").upper(), end=" ")
ВМР CUR ICNS ICO JPEG JPG РВМ PGM PNG РРМ TIF TIFF WBMP WEBP ХВМ ХРМ
Обратите внимание, что мы можем загрузить изображение в формате GIF, но не имеем воз
можности сохранить изображение в этом формате, поскольку алгоритм сжатия, используе
мый в нем, защищен патентом.
25.3.1. Класс QPixmap
Класс QPixmap предназначен для работы с изображениями в контекстно-зависимом пред
ставлении. Данные хранятся в виде, позволяющем отображать изображение на экране наи
более эффективным способом, поэтому класс QPixmap часто используется для предвари
тельного рисования графики перед выводом ее на экран. Иерархия наследования:
QPaintDevice - QPixmap
Глава 25. Работа с графикой 595
Поскольку класс QPixrnap ·наследует класс QPaintDevice, мы можем использовать его ка!<
поверхность для рисования. Вывести изображение позволяет метод drawPixrnap () класса
QPainter (см. разд. 25.2.3).
Форматы конструктора класса:
QPixmap()
QРiхmар(<Ширина>, <Высота>)
QРiхmар(<Размеры QSize>)
QРiхmар(<Путь к файлу>[, foпnat=None][, flags =Image.ConversionFlag .AutoColor])
QРiхmар(<Исходный объект QPixrnap>)
Первый формат создает пустой объект изображения. Второй и третий форматы позволяют
указать размеры изображения - если размеры равны нулю, то будет создан пустой объект.
Четвертый формат предназначен для загрузки изображения из файла. Во втором параметре
указывается тип изображения в виде строки (например, "PNG")- если он не указан, то
формат будет определен по расширению загружаемого файла. Пятый конструктор создает
коmпо указанного изображения.
Класс QPixrnap поддерживает следующие методы (здесь приведены только основные - пол
ный их список можно найти на странице https://doc.qt.io/qt-6/qpixmap.html):
♦ isNull () - возвращает значение True, если объект является пустым, и False - в про
тивном случае;
♦ load()_ - загружа:ет изображение из файла с указанным путем. Формат метода:
lоаd(<Путь к файпу>[, format =None][, flags= ImageConversionFlag .AutoColor])
Во втором параметре можно задать формат файла в виде строки - если он не указан,
формат определяется по расширению файла. Необязательный параметр flags задает тип
преобразования цветов. Метод возвращает значение тrue, если изображение успешно
загружено, и False - в противном случае;
♦ loadFromData () - загружает изображение из заданного объекта класса QByteArray.
Формат метода:
loadE'romData(<Объект QByteArray или bytes> [, foпnat=None] [,
flags = ImageConversionFlag.AutoColor])
Метод возвращает значение True, если изображение успешно загружено, и False -
в противном случае;
♦ sаvе(<Путь к файлу>[, format=None][, quality=-1]) - сохраняет изображение в файл
с указанным пут-ем. Во втором параметре можно задать формат файла в виде строки -
если он не указан, формат будет определен по расширению файла. Необязательный
параметр quality позволяет задать качество изображения. Можно передать значение
в диапазоне от О до 100, значение -1 указывает качество по умолчанию. Метод возвраща
ет значение True, если изображение успешно сохранено, и False - в противном случае;
♦ convertFromimage() - преобразует заданный объект класса Qimage в объект класса
QPixrnap. Формат метода:
convertFromimage(<Изoбpaжeниe Qimage>[, flags= ImageConversionFlag.AutoColor])
Метод возвращает значение тrue, если изображение успешно преобразовано, и False -
в противном случае;
596 Часть 11. Библиотека PyQt 6
♦ fromimage() - статический, преобразует заданный объект класса Qimage в объект класса
QPixmap, который и возвращает. Формат метода:
frоmimаgе(<Изображение Qimage>[, flags=ImageConversionFlag.AutoColor])
♦ toimage() - преобразует текущее изображение в объект класса Qimage и возвращает его;
♦ fill([color=GlobalColor. white]) - производит заливку изображения указанным цве-
том;
♦ width() - возвращает ширину изображения;
♦ height() - возвращает высоту изображения;
♦ size() -возвращает объект класса QSize с размерами изображения;
♦ rect() - возвращает объект класса QRect с координатами и размерами прямоугольной
области, ограничивающей изображение;
♦ depth() - возвращает глубину цвета;
♦ isQBitmap() - возвращает значение тrue, если глубина цвета равна одному биту (т. е.
это монохромное изображение), и False - в противном случае;
♦ createMaskFromColor(<Цвет QColor> [, mode=МaskМode .MaskinColor]>) - создает на ос
нове текущего изображения маску в виде объекта класса QBitmap и возвращает ее. Пер
вый параметр задает цвет - области, закрашенные этим цветом, будут на маске либо
прозрачными, либо непрозрачньiми. Необязательный параметр mode задает режим созда
ния маски в виде следующих элементов перечисления MaskМode из модуля QtCore.Qt:
• MaskinColor - области, закрашенные указанным цветом, будут прозрачными;
• мaskOutColor - области, закрашенные указанным цветом, будут непрозрачными;
♦ setMask(<Маска QBitmap>) - устанавливает маску;
♦ mask() - возвращает объект класса QBitmap с маской изображения;
♦ сору() - возвращает объект класса QPixmap с фрагментом изображения. Если параметр
rect не указан, изображение копируется полностью. Форматы метода:
copy("[rect=QRect()])
сору(<Х>, <У>, <Ширина>, <Высота>)
♦ scaled() - изменяет размер изображения и возвращает результат в виде объекта класса
QPixmap. Исходное изображение не изменяется. Форматы метода:
sсаlеd(<Ширина>, <Высота>[,
aspectRatioMode=AspectRatioMode.IgnoreAspectRatio][,
transformМode=ТransformationМode.FastTransformation])
scaled(<Размеры QSize>[,·
aspectRatioMode=AspectRatioMode.IgnoreAspectRatio][,
transformМode=TransformationМode.FastTransformation])
В необязательном параметре aspectRatioMode могут быть указаны следующие элементы
перечисления AspectRatioMode из модуля QtCore.Qt:
• IgnoreAspectRatio - изменяет размеры без сохранения пропорций сторон;
• KeepAspectRatio - изменяет размеры с сохранением пропорций сторон. При этом
часть области нового изображения может оказаться незаполненной;
Глава 25.'Работа с графикой 597
• KeepAspectRatioByExpanding - изменяет размеры с сохранением пропорций сторон.
При этом часть нового изображения может выйти за пределы его области.
В необязательном параметре transformМode могут быть указаны следующие элементь1
перечисления TransfoпnationМode из модуля QtCore.Qt:
• FastTransfoпnation - сглаживание выключено;
• SmoothTransfoпnati,an - сглаживание включено;
♦ scaledтowictth() - изменяет ширину изображения и возвращает результат в виде объек
та класса QPixmap. Формат метода:
scaledToWidth(<Illиpинa>[, mode=ТransfoпnationМode.FastTransfoпnation])
Высота изображения изменяется пропорционально. Исходное изображение не изменяет
ся. IJараметр mode аналогичен параметру transformМode в методе scaled();
♦ scaledToHeight() -:- изменяет высоту изображения и возвращает результат в виде объ
екта класса QPixmap. Формат метода:
scaledToHeight(<Высота> [, mode=TransformationМode. FastTransfoпnation] )
Ширина изображения изменяется пропорционально. Исходное изображение не изменя
ется. Параметр mode аналогичен параметру transformМode в методе scaled();
♦ transformed() - производит трансформацию изображения (например, поворот) и воз
вращает результат в виде объекта класса QPixmap. Формат метода:
transformed(<Tpaнcфopмaция QTransform>[,
mode=TransfoпnationМode.FastTransfoпnation])
Исходное изображение не изменяется. Параметр mode аналогичен параметру
transformМode в методе scaled();
♦ swap(<Изображение QPixmap>) - заменяет текущее изображение указанным в параметре;
♦ hasAlpha() - возвращает тrue, если изображение имеет прозрачные области, и False -
в противном случае;
♦ hasAlphaChannel() - возвращает тrue, если формат изображения поддерживает про
зрачность, и False - в противном случае.
25.3.2. Класс QBitmap
Класс QBitmap предназначен для работы в контекстно-зависимом представлении с моно
хромными изображениями. Наиболее часто класс QBitmap используется для создания масок
изображений. Иерархия наследования:
QPaintDevice - QPixmap - QBitmap.
Поскольку класс QBitmap наследует класс QPaintDevice, мы можем использовать его как
поверхность для рисования. Цвет пера и кисти. задается элементами colorO (прозрачный
цвет) и colorl (непрозрачный цвет) перечисления GlobalColor из модуля QtCore.Qt. Вывес
ти изображение позволяет метод drawPixmap() класса QPainter (см.разд. 2 5. 2. 3).
Форматы конструктора класса:
QBitmap()
QBitmap(<IIIиpинa>, <Высота>)
QBitmap(<Paзмepы QSize>)
598 Часть 11. Библиотека PyQt б
QBitmap(<Пyть к файлу>[, format=None])
QВitmар(<Изображение QPixmap>)
QВitmар(<Исходный объект QBitmap>)
Класс QBitmap наследует все методы класса QPixmap и определяет следующие дополнитель
ные методы (здесь приведены только нас интересующие- полный их список можно найти
на странице https://doc.qt.io/qt-6/qbltmap.html):
♦ fromimage() - статический, преобразует заданный объект класса Qimage в объект класса
QBitmap, который и возвращает. Формат метода:
frоmimаgе(<Изображение Qimage>[, flags=ImageConversionFlag.AutoColor])
♦ transformed (<Трансформация QTransform>) - производит трансформацию изображения
(например, поворот) и возвращает объект класса QBitmap. Исходное изображение не из
меняется;
♦ clear() - очищает изображение, устанавливая у всех точек изображения цвет colorO.
25.3.3. Класс Qlmage
Класс Qimage предназначен для работы с изображениями в контекстно-независимом пред
ставлении. Иерархия наследования:
QPaintDevice - Qimage
Поскольку класс Qimage наследует класс QPaintDevice, мы можем использовать его как по
верхность для рисования. Однако следует учитьшать, что не на всех форматах изображения
можно рисовать, - для рисования лучше использовать изображение формата Format_
ARGB32_Premultiplied. Вывести изображение позволяет метод drawimage () класса QPainter
(см. разд. 25.2.3).
Форматы конструктора класса:
Qimage()
Qimаgе(<Ширина>, <Высота>, <Формат>)
Qimage(<Paзмepы QSize>, <Формат>)
Qimage(<Пyть к файлу>[, <Тип изображения>])
Qimаgе(<Исходный объект Qimage>)
Первый конструктор создает пустой объект изображения. Второй и трет� конструкторы
позволяют указать размеры изображения- если таковые равны нулю, будет создан пустой
объект. Четвертый конструктор предназначен для загрузки изображения из файла. Во вто
ром параметре указывается тип изображения в виде строки - если он не указан, формат
будет определен по расширению загружаемого файла. Пятый конструктор создает копию
заданного исходного объекта.
В параметр� <Формат> можно указать следующие элементы перечисления Format из класса
Qimage (приведены только 1 наиболее часто используемые - полный их список можно найти
на странице https://doc.qt.io/qt-6/qimage.html#Format-enum):
♦ Format_Invalid- неверный формат;
♦ Format_Mono - глубина цвета 1 бит;
♦ Format_MonoLSB - глубина цвета 1 бит;
♦ Format_Indexeq8- глубина цвета 8 битов;
♦ Format_RGВ32 - RGB без альфа-канала, глубина цвета 32 бита;
Глава 25. Работа с графикой 599
♦ Format_ARGВ32 - RGB с альфа-каналом, глубина цвета 32 бита;
♦ Format_ARGB32_Premultiplied -RGB с альфа-каналом, глубина цвета 32 бита. Для ри-
сования лучше использовать этот формат.
Класс Qimage поддерживает большое количество методов, из которых мы рассмотрим лишь
основные (полный их список приведен на странице https://doc.qt.io/qt-6/qimage.html):
♦ isNull() -возвращает значение True, если текущий объект является пустым, и False -
в противном случае;
♦ load(<Путь к· файлу> [, format=None]) - загружает изображение из файла с указанным
путем. Во втором параметре задается формат файла в виде строки -если он не указан,
формат определяется по расширению файла. Метод возвращает значение тrue, если изо
бражение успешно загружено, и False -в противном случае;
♦ loadFromData(<Объект QByteArray или bytes> [, format=None]) - загружает изображе
ние из заданного объекта. Во втором параметре указывается тип изображения в виде
строки (например: "PNG':). Метод возвращает значение True, если изображение успешно
загружено, и False -в противном случае;
♦ fromData(<Объект QByteArray или bytes> [, format=None]) - статический, загружает
изображение из заданного объекта. Во втором параметре указывается тип изображения
в виде строки (например: "PNG"). Метод возвращает объект класса Qimage;
♦ sаvе(<Путь к файлу>[, format=None] [, quality=-1]) -сохраняет изображение в файле
с указанным путем. Во втором параметре можно задать формат файла в виде строки -
если он не указан, формат определяется по расширению файла. Необязательный пара
метр quality позволяет задать качество изображения. Можно передать значение в диа
пазоне от О до 100; значение -1 указывает качество по умолчанию. Метод возвращает
значение True, если изображение успешно сохранено, и False -в противном случае;
♦ fill(<Цвет>) - производит заливку изображения заданным цветом. В качестве пара
метра указывается элемент перечисления GlobalColor, объект класса QColor или цело
численное значение цвета, возвращаемое методами rgb() и rgba() класса QColor. При
меры:
img.fill(QtCore.Qt.GlobalColor.red)
img.fill(QtGui.QColor("#ff0000"))
img.fill(QtGui.QColor("#ff0000").rgb())
♦ width() -возвращает ширину изображения;
♦ height() -возвращает высоту изображения;
♦ size() -возвращает объект класса QSize с размерами изображения;
♦ rect() - возвращает объект класса QRect с координатами и размерами прямоугольной
области, ограничивающей изображение;
♦ depth() - возвращает глубину цвета;
♦ format() - возвращает формат изображения в виде элемента перечисления Format из
класса Qimage;
♦ setPixel() -задает цвет пиксела с указанными координатами. Форматы метода:
setPixel(<X>, <У>, <Индекс или цвет>)
sеtРiхеl(<Координаты QPoint>, <Индекс или цвет>)
600 Часть 11. Библиотека PyQt б
В параметре <Индекс или цвет> у 8-битных изображений задается индекс цвета в палит
ре, а у 32-битных - целочисленное значение цвета, получить которое позволяют мето
ды rgb() и rgba() класса QColor;
♦ pixel() - возвращает целочисленное значение цвета пиксела с указанными координа
тами. Это значение можно передать конструктору класса QColor, а затем получить зна
чения различных составляющих цвета. Форматы метода:
pixel(<X>, <У>)
рiхеl(<Координаты QPoint>)
♦ convertToForrnat() - преобразует текущее изображение в указанный формат (задается
в виде элемента перечисления Forrnat из класса Qii;na_ge) и возвращает новый объект клас
са Qimage. Исходное изображение не изменяется. Форматы метода:
convertToForrnat(<Фopмaт>[, flags=ImageConversionFlag.AutoColor])
convertToFoпnat(<Фopмaт>, <Таблица цветов>[,
flags=ImageCpnversionFlag.AutoColor])
♦ сору() - возвращает объект класса Qimage с прямоутольным фрагментом изображения
с заданными параметрами. Форматы метода:
сору([<Параметры фрагмента QRect>])
сору(<Х>, <У>, <Ширина>, <Высота>)
Если в первом формате параметры фрагмента не указаны, изображение копируется
целиком;
♦ scaled() - изменяет размер изображения и возвращает результат в виде объекта класса
Qimage. Исходное изображение не изменяется. Форматы метода:
sсаlеd(<Ширина>, <Высота>[,
�spectRatioMode7AspectRatioMode.IgnoreAspectRatio][,
transformМode=TransfoпnationМode .FastTransforrnation])
sсаlеd(<Размеры QSize>[,
aspectRatioMode=AspectRatioMode.IgnoreAspectRatio][,
transformМode=TransforrnationМode.FastTransforrnation])
В необязательном параметре aspectRatioMode могут быть указаны следующие элементы
перечисления AspectRatioMode из модуля QtCore.Qt:
• IgnoreAspectRatio - изменяет размеры без сохранения пропорций сторон;
• KeepAspectRatio - изменяет размеры с сохранением пропорций сторон. При этом
часть области нового изображения может оказаться незаполненной;
• KeeF.1}\spectRatioByExpqflding - изменяет размеры с сохранением пропорций сторон.
При этом часть нового изображения может выйти за пределы его области.
В необязательном параметре transformМode могут быть указаны следующие элементы
перечисления TransforrnationМode из модуля QtCore.Qt:
• FastTransforrnation - сглаживание выключено;
• SmoothTransforrnation - сглаживание включено;
♦ scaledToWidth() - изменяет ширину изображения и возвращает результат в виде объек
та класса Qimage. Формат метода:
scaledToWidth(<Шиpинa>[, mode=TransforrnationМode.FastTransforrnation])
Глава 25. Работа с графикой 601
Высота изображения изменяется пропорционально. Исходное изображение не изменяет
ся. Параметр mode аналогичен параметру transformМode в методе sG:aled();
♦ scaledToHeight() - изменяет высоту изображения и возвращает результат в виде объ
екта класса Qimage. Формат метода:
scaledToHeight(<Bыcoтa>[, mode=TransformationМode.FastTransformation])
Ширина изображения изменяется пропорционально. Исходное изображение не изменя
ется. Параметр mode аналогичен параметру tra�sformМope в методе scaled();
♦ transformed() - производит трансформацию изображения (например, поворот) и воз
вращает результат в виде объекта класса Qimage. Формат метода:
transformed(<Tpaнcфopмaция QTransform>[,
mode=ТransformationМode.FastTransformation])
Исходное изображение не изменяется. Параметр mode аналогичен параметру transformМode
в методе scaled();
♦ invertPixels([mode=InvertMode . InvertRgb] ) - инвертирует значения всех пикселов
в изображении. В необязательном параметре mode может быть указан элемент InvertRgb
или InvertRgba перечисления InvertMode из класса Qimage;
♦ mirror([horizontal=False] [, vertical=True]) - зеркально отображает текущее изо
бражение. Если значение True дано параметру horizontal, выпоJ_Iняется отображение по
горизонтали, а если параметру vertical - по вертикали;
♦ mirrored() - аналогичен mirror(), только создает новый объект, хранящий зеркальную
копию текущего изображения, и возвращает его. Текущее изображение не изменяется.
25.3.4. Класс Qlcon
Класс Qicon представляет значки в различных размерах, режимах и состояниях. Он не на
следует класс QPaintDevice, - следовательно, мы не можем использовать его как поверх
ность для рисования. Форматы конструктора:
Qicon()
Qiсоn(<Путь к файлу>)
Qiсоn(<Изображение QPixmap>)
Qiсоn(<Исходный объект Qicon>)
Первый конструктор создает пустой объект значка. Второй конструктор выполняет загрузку
значка из файла, причем файл загружается при первой попытке использования, а не сразу.
Третий конструктор создает значок на основе заданного изображения, а четвертый - соз-
дает кошnо исходного объекта.
Класс Qicon поддерживает следующие методы (здесь приведены только основные - пол
ный их список можно найти на странице https://doc.qt.io/qt-6/qicon.html):
♦ isNull() - возвращает значение True, если объект является пустым, и False - в про
тивном случае;
♦ addFile() - .добавляет значок для указанных размера, режима и состояния. Формат
метода:
addFile(<Пyть к файлу>[, size=QSize()] [, mode=Mode.Normal][, state=State.Off])
602 Часть 11. Библиотека PyQt б
Можцо добавить несколько значков, вызывая метод с разными значениями параметров.
Параметр size задает размер значка в виде объекта класса QSize (поскольку загрузка
значка производится при первой попытке использования, заранее размер значка неизвес
тен, и нам придется задать его явно). В параметре mode можно указать следующие эле
менты перечисления Mode из класса Qicon: Normal (обычное состояние компонента),
DisaЫed (компонент недоступен), Active (компонент активен) или Selected (компонент
выделен - обычно используется для элементов представлений). В параметре state ука
зываются атрибуты Off (отключенное 1состояние) или оп (включенное состояние) пере
числения State из класса Qicon;
♦ addPixmap () - добавляет заданное изображение в качестве значка для указанного режи
ма и состояния. Формат метода:
аddРiхmар(<Изображение QPixmap>[, mode=Mode.Normal][, state=State.Off])
♦ availaЫeSizes([mode=Mode.Normal][, state= State.Off]) - возвращает доступные
размеры (список с объектами класса QSize) значков для указанного режима и состояния;
♦ actualSize(<Paзмep QSize>[, mode= Mode.Normal] [, state= State.Off]) - возвращает
фактический размер (объект класса QSize) для указанного размера, режима и состояния.
Фактический размер может быть меньше размера, указанного в первом параметре, но не
больше;
♦ pixmap () - возвращает значок (объект класса QPixmap), который примерно соответству
ет указанному размеру, режиму и состоянmо. Форматы метода:
pixmap (<Шир11на>, <Высота>[, mode= Mode.Normal] [, state= State.Off])
pixmap (<Ширина и высота>[, mode= Mode.Normal][, state= State.Off] )
рiхmар(<Размер QSize>[, mode=Mode.Normal][, state=State.Off])
Во втором формате первый параметр задает и ширину, и высоту значка, имеющего квад
ратную форму.
Вместо загрузки значка из файла можно воспользоваться одним из встроеннь1х в PyQt стан
дартных значков. Загрузить стацдартный значок позволяет следующий код:
ico = window.style() .standardicon(
QtWidgets.QStyle.StandardPixmap.SP_MessageBoxCritical)
Найти список всех встроенных значков можно в документации к классу QStyle на странице
https://doc.qt.io/qt-6/qstyle.html#StandardPixmap-enum.
ГЛАВА 26
Графическая сцена
Графическая сцена - это поверхность, позволяющая размещать всевозможные графиче
ские объекты (линии, прямоугольники, многоугольники и т. п.) и производить над ними
различные манипуляции (перемещать с помощью мыши, преобразовывать систему коорди
нат и др.). Для вывода графической сцены применяется особый компонент, называемый
графическим представлением. Одна и та же графическая сцена может быть выведена в не
скольких разных графических представлениях.
Все описанные в этой главе классы объявлены в модуле QtWidgets, если не указано иное.
26.1. Графическая сцена
Класс QGraphicsscene исполняет роль графический сцены. Иерархия наследования выгля
дит так:
QObject - QGraphicsScene
Форматы конструктора:
QGraphicsScene([parent=None])
QGraphicsScene(<X>, <У>, <Ширина>, <Высота>[, parent=None])
QGrарhiсsSс�nе(<Прямоугольник QRectF>[, parent=None])
Первый конструктор создает сцену, не имеющую определенного размера. Второй и третий
конструкторы позволяют указать координаты и размеры сцены. В качестве параметра
parent можно указать ссылку на родительский компонент.
26.1.1. Настройка графической сцены
Для настройки различных параметров графической сцены предназначены следующие мето
ды класса QGraphicsScene:
♦ setsceneRect() - задает координаты и размеры сцены. Форматы метода:
setSceneRect(<X>, <У>, <Ширина>, <ВЫсота>)
sеtSсеnеRесt(<Прямоугольник QRectF>)
♦ sceneRect() - возвращает объект класса QRectF с координатами и размерами сцены;
♦ width() и height() - возвращают ширину и высоту сцены соответственно в виде веще
ственных чисел;
604 Часть 11. Библиотека PyQt б
♦ itemsBoundingRect () - возвращает объект класса /QRectF. с координатами и размерами
прямоугольника, в который вписываются все объекты, расположенные на сцене;
♦ setBackgroundВrush(<КИсть QBrush>) - задает кисть для заднего плана (фона), распо
ложенного под графическими объектами. Изменить задний план также можно, переоп
ределив у сцены метод drawBackground() и выполнив перерисовку заднего плана внутри
него;
♦ setForegroundВrush (<КИсть QBrush>) - задает кисть для передне�о плана, расположен
ного над графическими объектами. Изменить передний план также можно, переопреде
лив у сцены метод drawForeground() и выполнив перерисовку переднего плана внутри
него;
♦ setFont(<Шрифт QFont>) - задает шрифт сцены по умолчанию;
♦ set ItemindexМethod(<Режим>) - задает режим индексации объектов сцены для ускоре
ния их поиска. В качестве параметра указываются следующие элементы перечисления
ItemindexМethod из класса QGraphicsScene:
• вspтreeindex - для поиска объектов используется индекс в виде бинарного дерева.
Этот режим следует применять для сцен, большинство объектов которых являются
статическими;
• Noindex - индекс не используется. Этот режим следует применять для сцен, содер
жимое которых часто меняется;
♦ setBspTreeDepth(<Глубина>) - задает целочисленную глубину дерева при использова
нии режима BspTreeindex. По умолчанию установлено значение О, которое говорит, что
глубина выбирается автоматически;
♦ bspTreeDepth() - возвращает текущее значение глубины дерева при использовании
режима BspTreeindex.
26.1.2. Добавление и удаление графических объектов
Для добавления графических объектов на сцену и удаления их оттуда предназначены сле
дующие методы класса QGraphicsScene:
♦ addrtem(<Графический объект>) - добавляет графический объект на сцену;
♦ addLine() - создает линию, добавляет ее на сцену и возвращает ссылку на представ
ляющий ее объект класса QGraphicsLineitem. Форматы метода:
addLine(<Xl>, <Yl>, <Х2>, <У2>[, pen=QPen()])
аddLinе(<Линия QLineF>[, pen=QPen()])
♦ addRect() - создает прямоугольник, добавляет его на сцену и возвращает ссылку на
представляющий его объект класса QGraphicsRectitem. Форматы метода:
addRect(<Х>, <У>, <Ширина>, <Высота> [, pen=QPen() ] [, brush=QBrush()])
addRect ( <Прямоугольник QRectF> [, pen=QPen()] [, brush=QBrush()])
♦ addPolygon() - создает многоугольник, добавляет его на сцену и возвращает ссылку на
представляющий его объект класса QGraphicsPolygonitem. Формат метода:
аddРоlуgоn(<Многоугольник QPolygonF>[, pen=QPen()][, brush=QBrush()])
♦ addEllipse() - создает эллипс, добавляет его на сцену и возвращает ссылку на пред
ставляющий его объект класса QGraphicsEllipseitem. Форматы метода:
Глава 26. Графическая сцена 605
addEllipse(<X>, <У>, <Ширина>, <Высота>[, pen=QPen()] [, brush=QBrush()])
аddЕlliрsе(<Прямоугольник QRectF>[, pen=QPen()J [, brush=QBrush()])
♦ addPixmap(<Изображение QPixmap>) - создает изображение, добавляет его на сцену и
возвращает ссылку на представляющий его объект класса QGraphicsPixmaprtern;
♦ addSirnpleText·(<Текст> [, font=QFont()]) - создает фрагмент простого текста, добавля
ет его на сцену в позицию с координатами (о, о) и возвращает ссылку на представляю
щий его объект класса QGraphicsSirnpleTextrtern;
♦ addText(<Текст> [, font=QFont() ] ) - создает фрагмент форматированного текста, до
бавляет его на сцену в позицию с координатами (О, О) и возвращает ссылку на пред
ставляющий его объект класса QGraphicsTextitern;
♦ addPath(<Путь QPainterPath> [, pen=QPen() ] [, brush=QBrush()]) - создает сложную
фигуру («путь»), добавляет ее на сцену и возвращает ссылку на представ�щий ее объ
ект класса QGraphicsPathitern;
♦ rеmоvеrtеm(<Графический объект>) -убирает заданный графический объект и всех его
потомков со сцены. Сам объект при этом не удаляется и, например, может быть добав
лен на другую сцену;
♦ clear() -удаляет все элементы со сцены. Метод является слотом;
♦ createiternGroup(<Список с графическими объектами>) - объединяет объекты из заданно
го списка в группу, добавляет ее на сцену и возвращает представляющий созданную группу
объект класса QGraphicsiterrGroup;
♦ destroyiternGroup(<Группа QGraphicsiternGroup>) - удаляет заданную группу со сцены,
при этом сохраняя все содержащиеся в группе элементы.
26.1.3. Добавление компонентов на сцену
Помимо графических объектов, на сцену можно добавить компоненты, которые будут
функционировать как обычно. Добавить компонент на сцену позволяет метод
addWidget(<Компонент> [, flags=O]) класса QGraphicsScene. В параметре flags задается тип
окна (см. разд. 19:1.1). Метод возвращает ссьmку на объект класса QGraphicsProxyWidget,
представляющий добавленный компонент.
26.1.4. Поиск графических объектов
Для поиска графических объектов; находящихся на сцене, предназначены следующие мето
ды класса QGraphicsScene:
♦ itemAt() - возвращает ссылку на верхний видимый объект, который расположен по
указанным координатам, или значение None, если никакого объекта там нет. Форматы
метода:
itemAt(<X>, <У>, <Преобразования QTransforrn>)
itеmАt(<Координаты QPointF>, <Преобразования QТransforrn>)
Третий параметр задает примененные к сцене преобразования системы координат
(см. разд. 25.2.4). Его необходимо указывать, если на сцене присутствуют объекты,
игнорирующие преобразования. В противном случае следует указать пустой объект
класса QTransforrn;
606 Часть 11. Библиотека PyQt 6
♦ collidingitems() - возвращает список со ссылками на объекты, которые находятся
в указанном в первом параметре объекте или пересекаются с ним. Если .таких объектов
нет, метод возвращает пустой список. Формат метода:
collidingitems(<Гpaфичecкий объект>[,
mode=ItemSelectionМode.IntersectsitemShape])
Необязательный параметр mode указывает режим поиска графических объектов и должен
задаваться следующими элементами перечисления ItemSelectionМode из модуля
QtCore.Qt:
• ContainsrtemShape - ищутся объекты, чьи границы полностью находятся внутри за
данного объекта;
• IntersectsrtemShape - ищутся объекты, чьи границы полностью находятся внутри
заданного объекта или пересекаются с его границей;
• ContainsrtemВoundingRect - ищутся объекты, чьи охватывающие прямоугольники
(т. е. прямоугольники минимальных размеров, в которые искомые объекты помеща
ются полностью) полностью находятся внутри охватывающего прямоугольника за
данного объекта;
• IntersectsrtemВoundingRect - ищутся объекты, чьи охватывающие прямоугольники
(т. е. прямоугольники минимальных размеров, в которые искомые объекты помеща
ются полностью) полностью находятся внутри охватывающего прямоугольника за
данного объекта или пересекаются с его границами;
♦ items() - возвращает список со ссылками на все объекты, или на объекты, располо
женные по указанным координатам, или на объекты, попадающие в указанную область.
Если объектов нет, то возвращается пустой список. Форматы метода:
items([order=SortOrder.DescendingOrder])
itеms(<Координаты QPointF>[, mode= ItemSelectionМode.IntersectsitemShape][,
order=SortOrder.DescendingOrder][, deviceTransform=QТransform()])
items(<X>, <У>, <Ширина>, <Высота>[,
mode=ItemSelectionМode.IntersectsitemShape][,
order=SortOrder.DescendingOrder] [, deviceTransform=QТransform()])
itеms(<Координаты QRectF>[, mode= ItemSelectionМode.IntersectsitemShape][,
order=SortOrder.DescendingOrder][, deviceTransform=QTransform()])
itеms(<Многоугольник QPolygonF>[,
mode=ItemSelectionМode.IntersectsitemShape] [,
order=SortOrder.DescendingOrder][, deviceTransform=QTransform()])
items(<Пyть QPainterPath>[, mode=ItemSelectionМode.IntersectsitemShape] [,
order=SortOrder.DescendingOrder] [, deviceTransform=QТransform()])
Параметр mode аналогичен таковому у метода collidingrtems(). В необязательном па
раметре order, задающем порядок сортировки объектов, указываются атрибуты
AscendingOrder (в алфавитном порядке) или DescendingOrder (в обратном порядке) пере
числения SordOrder из модуля QtCore. Qt.
Необязательный параметр deviceтransform задает примененные к сцене.преобразования
системы координат (см. разд. 25.2.4). Его необходимо указывать, если на сцене присут
ствуют объекты, игнорирующие преобразования.
Глава 26. Графическая сцена 607
26.1.5. Управление фокусом ввода
Получить фокус ввода с клавиатуры может как сцена в целом, так и отдельный объект на
ней. Если фокус установлен на отдельный объект, все события клавиатуры перенаправля
ются этому объекту. Чтобы объект мог принимать фокус ввода, необходимо установить
флаг IternisFocusaЫe - например, с помощью метода setFlag() класса QGraphicsitern. Для
управления фокусом ввода предназначены следующие методы класса QGraphicScene:
♦ setFocus([focusReason=FocusReason.OtherFocusReason]) - устанавливает фокус ввода
на сцену. В параметре focusReason можно указать причину изменения фокуса ввода
(см.разд. 20. 8. 1);
♦ setFocusitern() - устанавливает фокус ввода на указанный графический объект на сце
не. Формат метода:
setFocusitern(<Гpaфичecкий объект>[, focusReason=FocusReason .OtherFocusReason])
Если сцена была вне фокуса ввода, она автоматически получит фокус. Если в первом па
раметре указано значение None, или объект не может принимать фокус, метод просто
убирает фокус с объекта, обладающего им в текущий момент. В параметре focusReason
можно указать причину изменения фокуса ввода (см.разд. 20. 8. 1);
♦ clearFocus() - убирает фокус ввода со сцены. Объект, который обладает фокусом вво
да в текущий момент, потеряет его, но получит его снова, когда фокус будет опять уста
новлен на сцену;
♦ hasFocus() - возвращает значение True, если сцена имеет фокус ввода, и False -
в противном случае;
♦ focusitern() - возвращает ссылку на объект, который обладает фокусом ввода, или зна
чение None;
♦ setStickyFocus(<Флаг>) - если в качестве параметра указано значение тrue, то при
щелчке мышью на фоне сцены или на объекте, который не может принимать фокус,
объект, владеющий фокусом, не потеряет его. По умолчанию фокус убирается;
♦ stickyFocus() - возвращает значение True, если фокус ввода не будет убран с объекта
при щелчке мышью на фоне или на объект�, который не может принимать фокус.
26.1.6. Управление выделением объектов
Чтобы объект можно было выделить (с помощью мыши или программно), необходимо
установить флаг IternisSelectaЫe - например, с помощью метода setFlag() класса
QGraphicsitern. Для управления выделением объектов предназначены следующие методы
класса QGraphicScene:
♦ setSelectionArea() - выделяет· объекты внутри указанной области. Чтобы выделить
только один объект, следует воспользоваться методом setSelected() класса
QGraphicsitern. Форматы метода setSelectionArea():
setSelectionArea(<Пyть QPainterPath>, <Преобразования QTransforrn>)
setSelectionArea(<Пyть QPainterPath>[,
rnode=IternSelectionМode .IntersectsiternShape][,
deviceTransforrn=QTransforrn()])
setSelectionArea(<Пyть QPainterPath>, <Операция>[,
rnode= IternSelectionМode.IntersectsiternShape][,
deviceTransforrn=QTransforrn()])
608 Часть 11. Библиотека PyQt 6
Параметр mode аналогичен таковому у метода collidingrtems() (см. разд. 26.1.4). Вто-
' рой параметр первого формата и параметр deviceтransform второго формата задают
примененные к сцене преобразования системы координат (см. разд. 25.2.4).
Третий формат позволяет дополнительно указать, какую операцию следует выполнить
с ранее выделенными объектами сцены, в виде одного. из следующих элементов пере
числения ItemSelectiorIOperation из модуля QtCore.Qt:
• ReplaceSelection - ранее выделенные объекты перестанут быт�; выделенными;
• AddToSelection - ранее выделенные объекты останутся выделенными;
♦ selectionArea() - возвращает область выделения в виде объекта класса QPainterPath;
♦ selectedrtems() - возвращает список со ссьmками на выделенные объекты или пустой
список, если выделенных объектов нет;
♦ clearSelection() - снимает выделение. Метод является слотом.
26.1.7. Прочие методы и сигналы
Помимо рассмотренных ранее, класс QGraph icsScene поддерживает след:УЮЩИе методы
(здесь приведены только основные - полный их список можно найти на странице
https://doc.qt.io/qt-6/qgraphicsscene.html):
♦ isActive () - возвращает значение True, если сцена отображается на экране с помощью
какого-либо графического представления, и False - в противном случае;
♦ views() - возвращает список с графическими представлениями (объектами класса
QGraphicsView), в которых выводится сцена. Если сцена вообще не выводится на экран ,
возвращается пустой список;
♦ mouseGrabberrtem() - возвращает ссылку на объект, который владеет мышью, или None,
если такого объекта нет;
♦ render() - выводит сцену на устройство рисования или принтер. Формат метода :
rеndеr(<Устройство QPainter>[, target=QRectF()] [, source=QRectF()] [,
mode= AspectRatioMode.KeepAspectRatio])
Параметр target задает координаты и размеры устройства рисования, а параметр
source - координаты и размеры прямоугольной области на сцене. Если параметры не
указаны, используются размеры устройства рисования и сцены. В параметре mode,
.задающем режим изменения размеров графики при выводе, могут быть указаны сле
дующие элементы перечисления AspectRatioMode из модуля QtCore.Qt:
• IgnoreAspectRatio - изменяет размеры без сохранения пропорций сторон;
• кeepAspectRatio - изменяет размеры с сохранением пропорций сторон. При этом
часть области на устройстве рисования может оказаться незаполненной;
• кeepAspectRatioByExpanding - изменяет размеры с сохранением пропорций сторон.
При этом часть выводимой графики может выйти за пределы области ·на устройстве
рисования;
♦ invalidate() - вызывает перерисовку заданных слоев внутри прямоугольной области
с указанными параметрами. Форматы метода:
invalidate(<X>, <У>, <Ширина>, <Высота>[, layers= SceneLayers.AllLayers])
invalidate([rect=QRectF()] [, layers= SceneLayers.AllLayers])
Глава 26. Графическая сцена 609
В параметре layers, задающем слои, которые требуется перерисовать, могут быть указа
ны следующие элементы перечисления SceneLayers из класса QGraphicsScene:
• ItemLayer - слой объекта;
• BackgroundLayer - слой заднего плана;
• ForegroundLayer - слой переднего плана;
• AllLayers - все слои. Сначала отрисовывается слой заднего плана, затем - слой
объекта и в конце - слой переднего плана.
Второй формат метода является слотом;
♦ update() - вызывает перерисовку прямоугольной области с указанными параметрами.
Форматы метода:
update(<X>, <У>, <Ширина>, <Высота>)
update([rect=QRectF()])
Второй формат метода является слотом.
Класс QGraphicsScene поддерживает следующие сигналы:
♦ changed(<Список областей>) - генерируется при изменении сцены. Внутри обработчика
через параметр доступен список с объектами класса QRectF, представляющими изме
нившиеся области сцены;
♦ sceneRectChanged(<Paзмepы QRectF>) - генерируется при изменении размеров сцены.
Внутр.и обработчика через параметр доступен объект класса QRectF с новыми координа
тами и размерами сцены;
♦ selectionChanged() - генерируется при изменении выделения объектов;
♦ focusitemChanged(<Oбъeкт 1>, <Объект 2>, <Причина изменения фокуса>) - генериру
ется при изменении фокуса клавиатурного ввода. Через параметры доступны объект, по
лучивший фокус ввода, объект, потерявший фокус ввода, и причина изменения фокуса
(см. разд. 20.8.1).
26.2� Графическое представление
Класс QGraphicsView реализует графическое представление, выводящее графическую сцену.
Иерархия наследования:
(QObje�t, QPaintDevice) - QWidget - QFrame - QAЬstractScrollArea - QGraphicsView
Форматы конструктора класса:
QGraphicsView( [parent=None])
QGraphicsView(<Гpaфичecкaя сцена>[, parent=None])
Второй формат сразу же позволяет установить в представлении вьmодимую сцену.
26.2.1. Настройка·графического представления
Для настройки различных параметров представления применяются следующие методы
класса QGraphicsView (здесь приведены только основные - полный их список можно найти
на странице https://doc.qt.io/qt-6/qgraphicsview.html):
610 Часть 11. Библиотека PyQt б
♦ setScene(<Графическая сцена>) - устанавливает выводимую сцену;
♦ scene() - возвращает ссьшку на установленную сцену в виде объекта класса
QGraphicsScene;
♦ setSceneRect() - задает координаты и размеры сцены. Форматы метода:
setSceneRect(<X>, <У>, <Ширина>, <Высота>)
sеtSсеnеRесt(<Прямоугольник QRectF>)
♦ sceneRect() - возвращает объект класса QRectF с координатами и размерами сцены;
♦ setBackgroundВrush(<КИсть QBrush>) - задает кисть для заднего плана (фона) сцены
(расположен под графическими объектами);
♦ setForegroundВrush(<КИcть QBrush>) - задает кисть для переднего плана сцены (распо
ложен над графическими объектами);
♦ setCacheMode(<Режим>) - задает режим кеширования выводимых объектов. В качестве
параметра могут быть указаны следующие элементы перечисления cacheModeFlag из
класса QGraphicsView:
• CacheNone - без кеширования;
• CacheBackground - кешируется только задний план;
♦ resetCachedContent() - сбрасывает кеш;
♦ setAlignment(<ВЫравнивание AlignmentFlag>) - задает выравнивание сцены в случае,
если содержимое сцены полностью помещается в представлении. По умолчанию сцена
центрируется по горизонтали и вертикали. Пример установки сцены в левом верхнем уг
лу представления:
view.setAlignment(QtCore.Qt.AlignmentFlag.AlighLeft
QtCore.Qt.AlignmentFlag.AlignTop)
♦ setinteractive(<Флаг>) - если в качестве параметра указано значение True, пользова
тель может взаимодействовать с объектами на сцене (интерактивный режим, использу
ется по умолчанию). Значение False разрешает только просмотр сцены;
♦ isinteractive() - возвращает значение тrue, если задан интерактивный режим, и
False - в противном случае;
♦ setDragMode(<Режим>) - задает действие, производимое при щелчке левой кнопкой
мыши на фоне и перемещении мыши. В качестве параметра могут быть указаны сле
дующие элементы перечисления DragMode из класса QGraphicsView:
• NoDrag - никакого действия;
• scrollHandDrag - прокрутка сцены. При этом указатель мыши примет вид сжатой
или разжатой руки;
• RuЬberBandDrag - создание области выделения. Объекты, частично или полностью
(задается с помощью метода setRuЬberBandSelectionМode()) попавшие в эту область,
будут выделены (при условии, что у объектов установлен флаг ItemisSelectaЫe).
Действие выполняется только в интерактивном режиме;
♦ dragMode() - возвращает обозначение действия, производимого при щелчке левой
кнопкой мыши на фоне и перемещении мыши, в виде элемента перечисления DragMode
из класса QGraphicsView;
Глава 26. Графическая сцена 611
♦ setRuЬberвandSelectionМode(<Режим>) - задает режим выделения объектов при уста
новленном флаге RuЬberBandDrag. В параметре могут быть указаны элементы перечисле
ния ItemSelectionМode из модуля QtCore.Qt, описанные в разд. 26.1.4;
♦ setRenderHint(<Опция вывода> [, <Флаг>] ) - управляет опциями, влияющими на каче
ство отображения сцены. Если вторым параметром передано значение тrue или если
второй параметр вообще не указан, <Опция вывода> активизируется, если же передано
False, опция деактивируется. Сама <Опция вывода> указывается в виде одного из сле
дующих элементов перечисления RenderHint из класса QPainter:
• Antialiasing - выполнятъ сглаживание краев у графических объектов;
• TextAntialiasing - выполнять сглаживание текста. Активизирован по умолчанmо;
• SmoothPixrnapTransfoпn - использовать более качественное сглаживание при транс
формациях растровых изображений;
• VerticalSuЬpixelPositioning- выполнять субпиксельное позиционирование текста
не только по горизонтали, но и по вертикали. Обычно применяется при выравнива
нии текста относительно других графических объектов;
• LosslessimageRendering - выполнять вывод графики без потерь. Учитывается толь-
ко при сохранении изображения в формате PDF.
Пример активизирования для представления всех доступных опций вывода:
view.setRenderHint(QtGui.QPainter.RenderHint.Antialiasing)
view.setRenderHint(QtGui.QPainter.RenderHint.TestAntialiasing)
view.setRenderHint(QtGui.QPainter.RenderHint.SmoothPixrnapTransfoпn)
view.setRenderHint(QtGui.QPainter.RenderHint.VerticalSuЬpixelPositioning)
view.setRenderHint(QtGui.QPainter.RenderHint.LosslessimageRendering)
♦ setRenderHints(<Опции вывода>) - активизирует сразу все указанные <Опции вывода>
(те, что не были указаны, деактивируются). <Опции вывода> задаются в виде комбинации
описанных ранее элементов перечисления RenderHint, указанных через оператор 1 .
Пример активизирования для представления всех доступных опций:
view.setRenderHints(QtGui.QPainter.RenderHint.Antialiasing 1
QtGui.QPainter.RenderHint.TestAntialiasing
QtGui.QPainter.RenderHint.SmoothPixmapTransfoпn
QtGui.QPainter.RenderHint.VerticalSuЬpixelPositioning
QtGui.QPainter.RenderHint.LosslessimageRendering)
26.2.2. Преобразования
между координатами представления и сцены
Для преобразования между координатами представления и сцены предназначены следую
щие методы класса QGraphicsView:
♦ mapFromScene() - преобразует заданные координаты точки из системы координат сцены
в систему координат представления. Формать1 метода (справа указан тип возвращаемого
значения):
mapFromScene(<X>, <У>) -> QPoint
mapFromScene(<QPointF>) -> QPoint
mapFromScene(<X>, <У>, <Ширина>, <Высота>) -> QPolygon
612 Часть //. Библиотека PyQt б
mapFromScene(<QRectF>) -> QPolygon
mapFromScene(<QPolygonF>) -> QPolygon
mapFromScene(<QPainterPath>) -> QPainterPath
♦ mapтoscene() - преобразует заданные координаты точки из системы координат пред
ставления в систему координат сцены. Форматы метода (справа указан тип возвращае
мого значения):
mapToScene(<X>, <У>) -> QPointF
mapToScene(<QPoint>) -> QPointF
mapToS.cene(<Х>, <У>, <Ширина>, <Высота>) -> QPolygonF
mapToScene(<QRect>) -> QPolygonF
mapToScene(<QPolygon>) -> QPolygonF
mapToScene(<QPainterPath>) -> QPainterPath
26.2.3. Поиск объектов
Для поиска объектов на сцене предназначены следующие методы класса QGraphicsView:
♦ itemAt() .,- возвращает ссьшку на верхний видимый объект, который расположен по
указанным координатам, или значение None, если никакого объекта там нет. В качестве
значений указываются координаты в системе координат представления, а не сцены.
Форматы метода:
itemAt(<Х>, <У>)
itеmАt(<Координаты QPoint>)
♦ iterns() - возвращает список со ссьшками на все объекты, или на объекты, располо
женные по указанным координатам, или на объекты, попадающие в указанную область.
Если объектов нет, возвращается пустой список. В качестве значений указываются
координаты в системе координат представления, а не сцены. Форматы метода:
iterns()
iterns(<X>, <У>)
itеms(<Координаты QPoint>)
iterns(<X>, <У>, <Ширина>, <Высота>[,
mode=ItemSelectionМode.IntersectsitemShape])
itеms(<Прямоугольник QRect>[, mode=ItemSelectionМode.IntersectsitemShape])
itеms(<Многоугольник QPolygon>[, mode=ItemSelectionМode.IntersectsitemShape])
iterns(<Пyть QPainterPath>[, mode=ItemSelectionМode.IntersectsitemShape])
Допустимые значения параметра rnode были рассмотрены в разд. 26.1.4.
26.2.4. Преобразование системы координат
Выполнить преобразование системы координат позволяют следующие методы класса
QGraphicsView:
♦ translate(<Х>, <У>) - перемещает начало координат в точку с указанными координа
тами. По умолчанию начало координат находится в левом верхнем углу, ось х направле
на вправо, а ось У - вниз;
♦ rotate(<Угол>) - поворачивает систему координат на заданный угол (указывается
в виде вещественного числа в градусах). Положительное значение вызывает поворот по
часовой стрелке, а отрицательное значение - против часовой стрелки;
Глава 26. Графическая сцена 613
♦ scale(<По оси Х>, <По оси У>) - масштабирует систему координат. В качестве значе
ний указываются вещественные числа. Если значение меньше единицы, то выполняется·
. уменьшение, а если больше единицы - то увеличение;
♦ shear(<По горизонтали>, <По вертикали>) - сдвигает систему координат. В качестве
значений указьmаются вещественные числа;
♦ resetTransfoпn () - отменяет все преобразования.
Несколько преобразований можно произвести последовательно друг за другом. При этом
надо учитывать, что порядок следования преобразований имеет значение.
Если одна и та же последовательность преобразований выполняется несколько раз, то ее
можно сохранить в объекте класса QTransform, а затем установить с помощью метода
setTransfoпn(). Получить ссылку на установленное преобразование позволяет метод
transfoпn ().
26.2.5. Прочие методы
Помимо рассмотреннь1х ранее, класс QGraphicsView поддерживает следующие методы
(здесь приведены только основные - полный их список можно найти на странице
https://doc.qt.io/qt�6/qgraphicsview.html):
♦ centeron() - прокручивает представление таким образом, чтобы указанная точка или
объект находились в центре видимой области. Форматы метода:
centerOn(<X>, <У>)
сеntеrОn(<Координаты QPointF>)
сеntеrОn(<Графический объект>)
♦ ensureVisiЫe() - прокручивает представление таким образом, чтобы указанный пря
моугольник или объект находились в видимой области. Форматы метода:
ensureVisiЫe(<Х>, <У>, <Ширина>, <Высота>[, xМargin= 50] [, y Margin= 50])
еnsurеVisiЫе(<Прямоугольник QRectF>[, xМargin=50][, · yмargin=50])
еnsurеVisiЫе(<Графический объект>[, xМargin= 50] [, y Margin=50])
Необязательные параметры xМargin и y Margin задают минимальные значения просветов
между границами графического объекта и краями представления по горизонтали и вер
тикали соответственно;
♦ fitinView() - прокручивает и масштабирует представление таким образом, чтобы ука
заннь1й прямоугольник или объект занимали всю видимую область. Форматы метода:
fitinView(<X>, <У>, <Ширина>, <Высота>[, mode= AspectRatioMode.IgnoreAspectRatio])
fitinViеw(<Прямоугольник QRectF>[, mode= AspectRatioMode.IgnoreAspectRatio])
fi tinView ( <Графический объект>[, mode= AspectRatioMode.IgnoreAspectRatio])
Необязательный параметр mode задает режим изменения размеров. Его значения рас
сматривались в разд. 26.1. 7 (см. описание метода render() класса QGraphicsScene);
♦ render() - выводит содержимое представления на устройство рисования или принтер.
Формат метода:
rеndеr(<Устройство рисования>[, target=QRectF()][, source=QRectF()][,
mode=AspectRatioMode.KeepAspectRatio])
614 Часть 11. Библиотека PyQt б
Назначение параметров этого метода сходно с таковым у метода render() класса
QGraphicsScene (см.разд. 26.1. 7);
♦ invalidateScene( [rect=QRectF()] [, layers=SceneLayers .AllLayers]) - вызывает пе
рерисовку указанных слоев внутри заданной прямоугольной области на сцене. Назначе
ние его параметров сходно с таковым у одноименного метода класса QGraphicsScene
(см.разд. 26.1. 7). Метод является слотом;
♦ updateSceneRect(<Прямоугольник QRectF>) - вызывает перерисовку указанной прямо
угольной области сцены. Метод является слотом;
♦ updateScene(<Список с прямоугольниками QRectF>) - вызывает перерисовку указанных
прямоугольных областей. Метод является слотом.
26.З. Графические объекты
26.3.1. Класс QGraphicsltem:
базовый класс для графических объектов
Абстрактный класс QGraphicsitem является базовым классом для графических объектов.
Формат конструктора класса:
QGraphicsitem( [parent=None])
В параметре parent может быть указана ссьmка на родительский объект (объект класса,
производного от QGraphicsitem).
Поскольку класс QGraphicsitem является абстрактным, создать его объект нельзя. Чтобы
создать новый графический объект, следует наследовать этот класс и переопределить как
минимум методы boundingRect() и paint(). Метод boundingRect() должен возвращать объ
ект класса QRectF с координатами и размерами прямоугольной области, ограничивающей
объект. Внутри метода paint() необходимо выполнить рисование объекта. Формат метода
paint():
paint(self, <Устройство рисования QPainter>,
<Параметры перерисовки QStyleOptionGraphicsitem>, widget=None)
Для обработки столкновений следует также переопределить метод shape(). Метод должен
возвращать объект класса QPainterPath.
. 26.з.1·.1. Настройка графического объекта
Для настройки различных параметров объекта предназначены следующие методы класса
QGraphicsitem (здесь приведены только основные - полный их список можно найти на
странице https://doc.qt.io/qt-6/qgraphicsitem.html):
♦ setPos() - задает позицию объекта относительно родителя или сцены (при отсутствии
родителя). Форматы метода:
setPos(<X>, <У>)
sеtРоs(<Координаты QPointF>)
♦ pos() - возвращает объект класса QPointF с текущими координатами относительно
родителя или сцены (при отсутствии родителя);
Глава 26. Графическая сцена 615
♦ scenePos ()- возвращает объект класса QPointF с текущими координатами относитель
но сцены;
♦ sceneBoundingRect()- возвращает объект класса QRectF, который содержит координа-
ты (относительно сцены) и размеры прямоугольника, ограничивающего объект;
♦ setx(<Х>) и setY(<У>)- задают позицию объекта по отдельным осям;
♦ х () и у () - возвращают позицию объекта по отдельным осям;
♦ setZValue(<Z>) - задает позицию объекта по оси z. Объект с б6льшим значением этого
параметра рисуется выше объекта с меньшим значением. По умолчанию для всех объек
тов значение позиции по оси z равно о. о;
♦ zValue() - возвращает позицию объекта по оси z;
♦ moveBy(<По оси Х>, <По оси У>) - сдвигает объект на указанное смещение относи
тельно текущей позиции;
♦ prepareGeometryChange() - этот метод следует вызвать перед изменением размеров
объекта, чтобы поддержать индекс сцены в актуальном состоянии;
♦ scene()- возвращает ссьшку на сцену (объект класса QGraphicsScene) или значение
None, если объект не помещен на сцену;
♦ setFlag(<Флаг> [, enaЫed=Тrue] ) - устанавливает (если второй параметр имеет значе
ние тrue) или сбрасывает (если второй параметр имеет значение False) заданнь1й флаг.
В первом параметре могут быть указаны следующие элементы перечисления
GraphicitemFlag из класса QGraphicsitem (здесь приведены только основные- ПОЛНЬIЙ
их список можно найти на странице https://doc.qt.io/qt-6/qgraphicsitem.html
#GraphicsltemFiag-enum):
• ItemlsMovaЫe- объект МОЖНО перемещать С ПОМОЩЬЮ мыши;
• ItemisSelectaЫe - объект можно выделять;
• ItemisFocusaЫe - объект может получать фокус ввода;
• ItemignoresTransformations- объект игнорирует наследуемые преобразования;
• ItemignoresParentOpacity- объект игнорирует прозрачность родителя;
• ItemDoesntPropagateOpacityТoChildren - прозрачность объекта не распространяется
на потомков;
• ItemStacksBehindParent - объект располагается ниже родителя;
• ItemisPanel - объект является панелью;
♦ setFlags(<Флаги>) - устанавливает сразу несколько флагов. Элементы перечисления
GraphicitemFlag (см. описание метода setFlag()) указываются через оператор 1;
♦ flags() - возвращает комбинацию установленнъ1х флагов (см. описание метода
setFlag());
♦ setOpacity(<Чиcлo>) - задает степень прозрачности объекта. В качестве значения ука
зывается вещественное число от о . о (полностью прозрачный) до 1. о (полностью непро
зрачный);
♦ opacitу() - возвращает степень прозрачности объекта;
♦ setтoolтip(<Текст>) - задает текст всплъ1вающей подсказки;
616 Часть 11. Библиотека PyQt 6
♦ setcursor(<�сор>) - задает внешний вид курсора мыши при наведении его на объект
(см.разд. 20.9.5);
♦ unsetcursor() - отменяет изменение курсора мыши;
♦ setVisiЫe(<Флаг>) - если в качестве параметра указано значение True, то объект будет
видим. Значение False скрывает объект;
♦ show() - делает объект видимым;
♦ hide() - скрывает объект;
♦ isVisiЫe() - возвращает значение True, если объект видим, и False - если скрыт;
♦ sеtЕnаЫеd(<Флаг>) - если в качестве параметра указано значение True, объект будет
доступен. Значение False делает объект недоступным. Недоступный объект не получает
никаких событий, и его нельзя выделить;
♦ isEnaЫed t) - возвращает значение True, если объект доступен, и False - если недос
тупен;
♦ setSelected(<Флaг>) - если в качестве параметра указано значение тrue, объект будет
выделен. Значение False снимает выделение. Чтобы объект можно было выделить, не
обходимо установить флаг ItemisSelectaЫe - например, с помощью метода setFlag();
♦ isSelected() - возвращает значение True, если объект выделен, и False - в противном
случае;
♦ setFocus( [ focusReason=FocusReason. OtherFocusReason]) - устанавливает фокус ввода на
объект. В параметре focusReason можно указать причину изменения фокуса ввода
(см. разд. 20.8.1). Чтобы объект мог принимать фокус ввода, необходимо установить флаг
ItemisFocusaЫe - например, с помощью метода setFlag ();
♦ clearFocus() - убирает фокус ввода с объекта;
♦ hasFocus() - возвращает значение True, если объект находится в фокусе ввода, и
False - в противном случае;
♦ graЬKeyboard() - захватывает ввод с клавиатуры;
♦ ungrabKeyboard() - освобождает ввод с клавиатуры;
♦ grabMouse () - захватывает мышь;
♦ ungraЬMouse() - освобождает мышь.
26.3.1.2. Выполнение преобразований
Задать преобразования для графического объекта можно, воспользовавшись классом
QТransform. Для работы с преобразованиями, заданными объектами этого класса, класс
QGraphicsitem поддерживает следующие методы:
♦ setTransform(<Пpeoбpaзoвaниe QTransform>[, comЬine=False]) - устанавливает преоб
разования, заданные в первом параметре. Если вторым параметром передать значение
тrue, новые преобразования будут объединены с уже установленными, - в противном
случае они заменят установленные ранее преобразования;
♦ transform() - возвращает объект класса QT:ransfoпn, представляющий заданные для
объекта преобразования;
♦ sceneTransform() - возвращает объект класса QTransfoпn, который представляет преоб
разования, заданные у самой графической сцены.
Глава 2б. Графическая сцена 617
Есть и более простой способ задания преобразований - использование следующих методов
класса QGraphicsitern:
♦ setTransformOriginPoint() - перемещает начало координат в указанную точку. Форма
ты метода:
setTransformOriginPoint(<X>, <У>)
setTransformOriginPoint(<Koopдинaты QPointF>)
♦ setRotation(<Yгoл>) - поворачивает систему координат на указанное количество гра
дусов (указывается вещественное число): положительное значение вызывает поворот по
часовой стрелке, а ·отрицательное - против часовой стрелки;
♦ rotation() - возвращает текущий угол поворота;
♦ setScale(<Значение>) - масштабирует систему координат. В качестве значений указы
ваются вещественные числа: если значение меньше единицы, выполняется уменьшение,
а если больше - увеличение;
♦ scale() - возвращает текущий масштаб;
♦ resetTransform() - отменяет все преобразования.
26.3.1.3. Прочие методьI
Помимо рассмотреннъrх ранее, класс QGraphicsitem поддерживает следующие полезные
методы (полный их список можно найти на странице https://doc.qt.io/qt-6/qgraphicsitem.
html):
♦ setParentitern(<Гpaфичecкий объект>) - назначает заданнъrй графический объект роди
телем для текущего объекта. Местоположение дочернего объекта задается в координа
тах родительского объекта;
♦ parentitern() - возвращает ссьшку на родительский объект;
♦ topLevel Itern() - возвращает ссылку на родительский объект верхнего уровня;
♦ childitems() - возвращает список с дочерними объектами;
♦ contains(<Координаты QPointF>) - возвращает True, если точка с указанными коорди
натами входит в состав текущего графического объекта, и False - в противном случае;
♦ collidingitems([mode=ItemSelectionМode. IntersectsitemShape]) - возвращает список
со ссылками на объекты, которые находятся в текущем объекте или пересекаются с ним.
Если таких объектов нет, возвращается пустой список. Возможные значения параметра
mode описаны в разд. 26.1.4;
♦ collideswithitem () - возвращает значение тrue, если текущий объект находится в ука
занном объекте или пересекается с ним. Формат метода:
collidesWithitern(<Гpaфичecкий объект>[,
mode=ItemSelectionМode.IntersectsitemShape])
Возможные значения параметра mode см. в разд. 26.1.4;
♦ collidesWithPath() - возвращает значение True, если текущий объект находится внут
ри указанного пути или пересекается с ним. Формат метода:
collidesWithPath(<Пyть QGraphicsPath>[,
mode=ItemSelectionМode.IntersectsitemShape])
Возможные значения параметра mode см. в разд. 26.1.4;
618 Часть 11. Библиотека PyQt б
♦ ensureVisiЫe() - прокручивает представление таким образом, чтобы указанный пря
моугольник находился в видимой области. Форматы метода:
ensureVisiЫe(<X>, <У>, <Ширина>, <Высота>[, xМargin=SOJ [, yMargin=SO])
ensureVisiЫe( [rect=QRectF()] [, xМargin= SO][, yМargin=SO])
Необязательные параметры xМargin и yMargin задают минимальные значения просветов
между границами графического объекта и краями представления по горизонтали и вер
тикали соответственно;
♦ update() - вызывает перерисовку прямоугольной области с указанными параметрами.
Форматы метода:
update(<X>, <У>, <Ширина>, <Высота>)
update([rect=QRectF()])
26.3.2. Готовые графические объекты
Вместо создания собственного объекта путем наследования класса Qgraphicsitem можно
воспользоваться стандартными классами, описываемыми далее.
26.3.2.1. Линия
Класс QGraphicsLineitem описывает линию. Иерархия наследования:
QGraphicsitem - QGraphicsLineitem
Форматы конструктора класса:
QGraphicsLineitem([parent=None])
QGraphicsLineitem(<Xl>, <Yl>, <Х2>, <У2>[, parent=None])
QGraphicsLineitem(<Линия QLineF>[, parent=None])
В параметре parent можно указать ссылку на родительский объект.
Класс QGraphicsLineitem наследует все методы класса QGraphicsitem и поддерживает сле
дующие методы (полный их список можно найти на странице https://doc.qt.io/qt-6/
qgraphicslineitem.html):
♦ setLine() - задает параметры линии. Форматы метода:
setLine(<Xl>, <Yl>, <Х2>, <У2>)
sеtLinе(<Линия QLineF>)
♦- line() - возвращает параметры линии в виде объекта класса QLineF;
♦ setPen(<Перо QPen>) - устанавливает перо.
26.3.2.2. Класс QAbstractGraphicsShapeltem
Класс QAЬstractGraphicsShapeitem является базовым классом всех графических фигур,
более сложных, чем линия. Иерархия наследования:
QGraphicsitem - QAЬstractGraphicsShapeitem
Класс QAЬstractGraphicsShapeitem поддерживает следующие методы (здесь приведены
только основные - полный их список можно найти на странице https://doc.qt.io/qt-6/
qabstractgraphicsshapeitem.html):
Глава 26. Графическая сцена 619
♦ setpen(<Перо QPen>) - устанавливает перо;
♦ setBrush(<Кисть QBrush>) - устанавливает кисть.
26.3.2.3. Прямоугольник
Класс QGraphicsRectitem описывает прямоугольник. Иерархия наследования:
QGraphicsitem - QAЬstractGraphicsShapeitem - QGraphicsRectitem
Форматы конструктора класса:
QGraphicsRectitem([parent=None])
QGraphicsRectit·em(<X>, <У>, <Ширина>, <Высота>[, parent=None])
QGraphicsRectitem(<Пpямoyгoльник QRectF>[, parent=None])
В параметре parent можно указать ссьшку на родительский объект.
Класс QGraphicsRectitem наследует все методы базовых классов и поддерживает следую
щие методы (здесь приведены только основные-полный их список можно найти на стра
нице https://doc.qt.io/qt-6/qgraphicsrectitem.html):
♦ setRect() - задает параметры прямоугольника. Форматы метода:
setRect(<X>, <У>, <Ширина>, <Высота>)
sеtRесt(<Прямоугольник QRectF>)
♦ rect() - возвращает параметры прямоугольника в виде объекта класса QRectF.
26.3.2.4. Многоугольник
Класс QGraphicsPolygonitem описывает многоугольник. Иерархия наследования:
QGraphicsitem - QAЬstractGraphicsShapeitem - QGraphicsPolygonitem
Форматы конструктора класса:
QGraphicsPolygonitem( [parent=None])
QGraphicsPolygonitem(<Мнoгoyгoльник QPolygonF>[, parent=None])
В параметре parent можно указать ссьшку на родительский объект.
Класс QGraphicsPolygonitem наследует все методы из базовых классов и поддерживает сле
дующие методы (здесь приведены только основные- полный их список можно найти на
странице https://doc.qt.io/qt-6/qgraphicspolygonitem.html):
♦ sеtРоlуgоn(<Многоугольник QPolygonF>) -задает параметры многоугольника;
♦ polygon() - возвращает параметры многоугольника в виде 'объекта класса QPolygonF;
♦ setFillRule(<Апгоритм>) - задает алгоритм определения, находится ли какая-либо точ
ка внутри нарисованного прямоугольника или вне его. В качестве значения параметра
указывается элемент OddEvenFill или WindingFill перечисления FillRule из модуля
QtCore.Qt.
26.3.2.5. Эллипс
Класс QGraphicsEllipseitem описывает эллипс. Иерархия наследования:
QGraphicsitem - QAЬstractGraphicsShapeitem - QGraphicsEllipseitem
620 Часть /1. Библиотека PyQt б
Форматы конструктора класса:
QGraphicsEllipseitem([parent=None])
QGraphicsEllipseitem(<X>, <У>, <Ширина>, <Высота>[, parent=None])
QGraphicsEllipseitem(<Пpямoyгoльник QRectF>[, parent=None])
В параметре parent можно указать ссьшку на родительский объект.
Класс QGraphicsEllipseitem наследует все методы базовых классов и поддерживает сле
дующие методы (здесь приведены только основные - полный их список можно найти на
странице bttps://doc.qt.io/qt-6/qgrapbicsellipseitem.html):
♦ setRect() - задает параметры прямоугольника, в который необходимо вписать эллипс.
Форматы метода:
setRect(<X>, <У>, <Ширина>, <Высота>)
sеtRесt(<Прямоугольник QRectF>)
♦ rect() - возвращает параметры прямоугольника,. в который вписан эллипс, в виде объ
екта класса QRect r;
♦ setStartAngle(<Угол>) и setSpanAngle(<Угол>) - задают начальный и конечный углы
сектора соответственно. Углы задаются в значениях 1/16°. Полный круг эквивалентен
значению 16 х 360 = 5760. Нулевой угол находится в позиции «трех часов». Положи
тельные значения углов отсчитываются против часовой стрелки, а отрицательные - по
часовой стрелке;
♦ startAngle() и spanAngle() - возвращают значения начального и конечного углов· сек
тора соответственно.
26.3.2.6. Изображение
Класс QGraphicsPixrnapitem описывает изображение. Иерархия наследования:
QGraphicsitem - QGraphicsPixrnapitem
Форматы конструктора класса:
QGraphicsPixrnapitem([parent=None])
QGraphicsPixrnapitem(<Изoбpaжeниe QPixrnap>[, parent=None])
В параметре parent можно указать ссылку на родительский объект.
Класс QGraphicsPixrnapitem наследует все методы из класса QGraphicsitem и поддерживает
следующие методы (здесь приведены только основные - пощ1ый их список можно найти
на странице bttps://doc.qt.io/qt-6/qgraphicspixmapitem.html):
♦ setPixrnap(<Изображение QPixrnap>) - задает изображение;
♦ pixrnap() - возвращает представляющий изображение объект класса QPixrnap;
♦ setOffset() - задает местоположение изображения в объекте. Форматы метода:
setOffset(<X>, <У>)
setOffset(<Koopдинaты QPointF>)
♦ offset() - возвращает местоположение изображения в виде объекта класса QPointF;
♦ setShapeMode(<Режим>) - задает режим определения формы изображения. В качестве
параметра могут быть указаны следующие элементы перечисления Shapeмocte из класса
QGraphicsPixrnapitem:
Глава 26. Графическая сцена 621
• мaskShape - используется результат выполнения метода mask() класса QPixmap (зна-
чение по умолчанию);
• BoundingRectShape - форма определяется по контуру изображения;
• HeuristicMaskShape используется результат выполнения метода
createHeuristicMask() класса QPixmap;
♦ setTransformationМode(<Режим>) - задает режим сглаживания. В качестве параметра
могут быть указаны следующие элементы перечисления TransformationМode из класса
QtCore.Qt:
• Fastтransformation - сглаживание выключено (по умолчанию);
• SmoothTransformation - сглаживание включено.
26.3.2.7. Простой текст
Класс QGraphicsSimpleTextitem описывает простой текст. Иерархия наследования:
QGraphicsitem � QAЬstractGraphicsShapeitem - QGraphicsSimpleTextitem
Форматы конструктора класса:
QGraphicsSimpleTextitem([parent=None])
QGraphicsSimpleTextitem(<Текст> [, parent=None] )
В параметре parent можно указать ссылку на родительский объект.
Класс QGraphicsSimpleTextitem наследует все методы из базовых классов и поддерживает
следующие методы (здесь приведены только основные - полный их список можно найти
на странице https://doc.qt.io/qt-6/qgraphicssimpletextitem.html):
♦ setText(<Текст>) - задает текст;
♦ text() - возвращает текст;
♦ setFont(<111рi�фт QFont>) - задает шрифт;
♦ font() - возвращает описывающий заданный шрифт объект класса QFont.
26.3.2.8. Форматированный текст
Класс QGraphicsTextitem описывает форматированный текст. Иерархия наследования:
(QObject, QGraphicsitem) - QGraphicsObject - QGraphicsTextitem
Форматы конструктора класса:
QGraphicsTextitem([parent=None])
QGraphicsTextitem(<Teкcт>[, parent=None])
В параметре parent можно указать ссылку на родительский объект.
Класс QGraphicsTextrtem наследует все методы из базовых классов и поддерживает сле
дующие методы (здесь приведены только основные - полный их список можно найти на
странице https://doc.qt.io/qt-6/qgraphicstextitem.btml):
♦ ·setPlainText(<Простой текст>) - задает простой текст;
♦ toPlainText () - возвращает простой текст;
♦ setHtml( <НТМL-код>) - задает форматированный текст в виде НТМL-кода;
♦ toHtml() - возвращает форматированный текст в виде НТМL-кода;
622 Часть 11. Библиотека PyQt 6
♦ setFont(<Шрифт QFont>) -устанавливает шрифт;
♦ font() -возвращает описывающий установленный шрифт объект класса QFont;
♦ setDefaultTextColor(<Цвет QColor>) - задает цвет текста по умолчанию;
♦ defaultTextColor() - возвращает цвет текста по умолчанию в виде объекта класса
QColor;
♦ setTextWidth(<Шиpинa>) - задает цредпочитаемую ширину строки. Если текст не поме
щается в установленную ширину, он будет перенесен на новую строку;
♦ textWidth() -возвращает предпочитаемую ширину текста;
♦ setDocument(<Дoкyмeнт>) задает документ в виде объекта класса QTextDocurnent
(см.разд. 22. 6.4);
♦ docurnent() - возвращает ссылку на документ (объект класса QTextDocurnent;
см. разд. 22. 6. 4);
♦ setTextCursor(<Кypcop>) - устанавливает курсор в виде объекта класса QTextCursor
(см. разд. 22.6.5);
♦ textCursor() -возвращает курсор (объект класса Qtextcursor - см. разд. 22.6.5);
♦ setTextinteractionFlags(<Режим>) -задает режим взаимодействия пользователя с тек
стом. По умолчанию используется режим NoTextinteraction, при котором пользователь
не может взаимодействовать с текстом. Допустимые режимы приведены в разд. 22.1 (см.
описание метода setTextinteractionFlags() );
♦ setTabChangesFocus(<Флаг>) - если в качестве параметра указано значение False, то
нажатием клавиши <ТаЬ> можно будет вставить в текст символ табуляции. Если указано
значение тrue, клавиша <ТаЬ> станет использоваться для передачи фокуса;
♦ setOpenExternalLinks(<Флаг>) - если в качестве параметра указано значение тrue,
щелчок на гиперссылке приведет к -открытию браузера, используемого в системе по
умолчанию, и загрузке страницы с указанным в гиперссылке интернет-адресом (URL).
Метод работает только при использовании режима TextBrowserinteraction.
Класс QGraphicsTextitem поддерживает следующие сигналь�:
♦ linkActi vated (<Интернет-адрес>) - генерируется при переходе по гиперссылке. Через
параметр внутри обработчика доступен интернет-адрес гиперссылки в виде строки;
♦ linkHovered (<Интернет-адрес>) - генерируется при наведении указателя мыши на ги
перссылку. Через параметр внутри обработчика доступен интернет-адрес гиперссьшки
в виде строки.
26.4. Группировка объектов
Объединить несколько объектов в группу позволяет класс QGraphicsrtemGroup. Над сгруп
пированными объектами можно выполнять различные преобразования (например, пере
мещать или поворачивать их одновременно). Иерархия наследования для класса
QGraphicsitemGroup выглядит так:
QGraphicsitem - QGraphicsitemGroup
Формат конструктора класса:
QGraphicsitemGroup( [parent=None])
В параметре parent можно указать ссылку на родительский объект.
Глава 26. Графическая сцена 623
Класс QGraphicsitemGroup наследует все методы класса QGraphicsitem и поддерживает сле
дующие методы (здесь приведены только основные- полный их список можно найти на
странице https://doc.qt.io/qt-6/qgraphicsitemgroup.html):
♦ �ddToGroup(<Объект>) - добавляет указанный графический объект в текущую группу;
♦ removeFromGroup(<Объект>) ___: удаляет указанный графический объект из текущей группы.
Создать группу и добавить ее на сцену можно и с помощью метода
createitemGroup(<Список с графическими объектами>) класса QGraphicsScene. Метод воз
вращает ссылку на группу (объект класса QGraphicsitemGroup). Удалить группу со сцены
позволяет метод destroyitemGroup(<Группа>) класса QGraphicsScene.
Добавить объект в группу позволяет также метод setGroup(<Группа>) класса QGraphicsitem.
Получить ссылку на группу, в которой находится объект, можно вызовом метода group()
класса QGraphicsitem. Если объект не находится ни в какой группе, метод возвращает None.
26.5. Эффекты
К графическим объектам допускается применить различные эффекты: изменение прозрач
ности, цвета, отображение тени, размытие и пр. Наследуя класс QGraphicsEffect и переоп
ределяя в нем метод draw(), можно создать свой эффект.
Для установки эффекта и получения ссылки на него предназначены следующие методы
класса QGraphicsitem:
♦ setGraphicsEffect(<Эффект>) - задает эффект в виде объекта класса, производного от
QGraphicsEffect;
♦ graphicsEffect() - возвращает ссьmку на эффект (объект класса, производного от
QGraphicsEffect) или значение None, если эффект не был установлен.
26.5.1. Класс QGraphicsEffect
Класс QGraphicsEffect является базовым классом для всех эффектов. Иерархия наследова
ния выглядит так:
QObject - QGraphicsEffect
Формат конструктора класса:
QGraphicsEffect( [parent=None])
Класс QGraphicsEffect поддерживает следующие основные методы (полный их список
можно найти на странице https://doc.qt.io/qt-6/qgraphicseffect.html):
♦ draw(self, <Устройство рисования>) - собственно рисует эффект. Этот абстрактный
метод должен быть переопределен в производных классах;
♦ sеtЕnаЫеd(<Флаг>)- если в качестве параметра ·указано значение False, эффект от
ключается. Значение True разрешает использование эффекта. Метод является слотом;
♦ isEnaЫed()- возвращает значение True, если эффект включен, и False- в противном
случае;
♦ update()- вызывает перерисовку эффекта. Метод является слотом.
624 Часть //. Библиотека PyQt б
Класс QGraphicsEffect поддерживает сигнал enaЫedChanged(<Флаг>}, который генерирует
ся при изменении статуса эффекта. Внутри обработчика через параметр доступно значение
тrue, если эффект вкmочен, и False - в противном случае.
26.5.2. Тень
·Класс QGraphicsDropShadowEffect реализует вывод тени у. объекта. Иерархия наследования:
QObject - QGraphicsEffect - QGraphicsDropShadowEffect
Формат конструктора класса:
QGraphicsDropShadowEffect([parent=None])
Класс QGraphicsDropShadowEffect наследует все методы базовых классов и поддерживает
следующие методы (здесь приведены только осщ>вные - полный их список можно найти
на странице https://doc.qt.io/qt-6/qgraphicsdropshadoweffect.html):
♦ setColor(<Цвет QColor>) - задает цвет тени. По умолчанmо используется полупро
зрачный темно-серый цвет (QColor(63, 63, 63, 180} ). Метод является слотом;
♦ color() -возвращает цвет тени (объект класса QColor);
♦ setBlurRadius(<Радиус>} - задает радиус размытия. тени в виде вещественного числа.
По умолчанmо используется значение 1. Метод является слотом;
♦ ЫurRadius(} -возвращает радиус размытия тени;
♦ setOffset() - задает смещение тени. По умолчанmо тень смещена на 8 пикселов вниз и
вправо. Форматы метода:
setOffset(<Пo оси Х>, <По оси У>)
setOffset(<CМeщeниe по обеим осям>)
setOffset(<CМeщeниe QPointF>}
Второй конструктор задает смещение сразу по обеим осям координат. В первом и вто
ром конструкторах параметры задаются вещественнь1ми числами. Метод является сло
том;
♦ offset(} - возвращает смещение тени в виде объекта класса QPointF;
♦ setXOffset(<Смещение>) - задает смещение по оси х в виде вещественного числа. Метод
является слотом;
♦ xOffset(} - возвращает смещение по оси х;
♦ setYOffset(<Смещение>} - задает смещение по оси У в виде вещественного числа. Метод
является слотом;
♦ yOffset(} - возвращает смещение пр оси У.
Класс QGraphicsDropShadowEffect поддерживает сигналы:
♦ colorChanged(<Цвет QColor>} - генерируется при изменении цвета тени. Внутри обра
ботчика через параметр доступен новый цвет;
♦ ыurRadiusChanged(<Радиус размытия>) - генерируется при изменении радиуса размы
тия. Внутри обработчика чере:1 параметр доступно новое значение в виде вещественного
числа;
♦ offsetChanged(<Cмeщeниe QPointF>} - генерируется при изменении смещения. Внутри
обработчика через параметр доступно новое смещение.
Глава 26. Графическая сцена 625
26.5.З. Размытие
Класс QGraphicsBlurEffect реализует эффект размытия. Иерархия наследования:
QObject - QGraphicsEffect - QGraphicsBlurEffect
Формат конструктора класса:
QGraphicsBlurEffect([parent=None])
Класс QGraphicsВlurEffect наследует все методы из базовых классов и поддерживает сле
дующие методы (здесь приведены только основные - полный их список можно найти на
странице https://doc.qt.io/qt-6/qgraphicsblureffect.html):
♦ setВlurRadius(<Радиус>) - задает радиус размытия в виде вещественного числа.- По
умолчанию используется значение 5. Метод является слотом;
♦ ЫurRadius() - возвращает радиус размытия.
Класс QGraphicsBlurEffect поддерживает сигнал ЫurRadiusChanged(<Радиус>), который
генерируется при изменении радиуса размытия. Внутри обработчика через параметр дос
тупно новое значение радиуса в виде вещественного числа.
26.5.4. Изменение цвета
Класс QGraphicsColorizeEffect реализует эффект изменения цвета. Иерархия наследования:
QObject - QGraphicsEffect - QGraphicsColorizeEffect
Формат конструктора класса:
QGraphicsColorizeEffect([parent=None])
Класс QGraphicsColorizeEffect наследует все методы из базовых классов и поддерживает
следующие методы (здесь приведены только основные- полный их список можно найти
на странице https://doc.qt.io/qt-6/qgraphicscolorizeeffect.htщl):
♦ setColor(<Цвет QColor>) - задает цвет. По умолчанию используется светло-синий цвет
(QColor(О, о, 192) ). Метод является слотом;
♦ color() - возвращает текущий цвет в виде объекта класса QColor;
♦ · setstrength(<Знaчeниe>) - задает интенсивность цвета. В качестве значения указыва
ется вещественное число от ·о. о до 1 . о (значение по умолчанию). Метод является сло
том;
♦ strength() - возвращает интенсивность цвета.
Класс QGraphicsColorizeEffect поддерживает сигналы:
♦ colorChanged(<Цвeт QColor>) - генерируется при изменении цвета. Внутри обработчи
ка через параметр доступен новый цвет;
♦ strengthChanged (<Интенсивность>) - генерируется при изменении интенсивности цве
. та. Внутри обработчика через параметр доступно новое значение в виде вещественного
числа.
26.5.5. Изменение прозрачности
Класс QGraphicgOpacityEffect реализует эффект прозрачности. Иерархия наследования:
QObject - QGraphicsEffect - QGraphicsOpacityEffect
626 Часть 11. Библиотека PyQt 6
Формат конструктора класса:
QGraphicsOpacityEffect ( [parent=None] )
Класс QGraphicsOpacityEffect наследует все методы базовых классов и поддерживает сле
дующие методы (здесь приведены только самые полезные - полный их список можно най
ти на странице https://doc.qt.io/qt-6/qgraphicsopacityeffect.html):
♦ sеtОрасitу(<Значение>) - задает степень прозрачности. В качестве значения указыва
ется вещественное число от о. о до 1. о. По умолчанию используется значение о. 7. Метод
является слотом;
♦ opacity () - возвращает степень прозрачности;
♦ setOpacityMask (<КИсть QBrush>) - задает маску прозрачности. Метод является слотом;
♦ opacityМask () - возвращает маску прозрачности в виде объекта класса QBrush.
Класс QGraphicsOpaci tyEffect поддерживает следующие сигналы:
♦ opacityChanged (<Прозрачность>) - генерируется при изменении степени прозрачности.
Внутри обработчика через параметр доступно новое значение в виде вещес'твенного
числа;
♦ opacityМaskChanged (<КИсть QBrush>) - генерируется при изменении маски прозрачно
сти. Через параметр доступна новая маска.
26.6. Обработка событий
Все происходящие в графических объектах события изначально возникают в графическом
представлении. Компонент-представление преобразует их и передает объекту графической
сцены, который, в свою очередь, перенаправляет их объекту, способному обработать воз
никшее событие (так, щелчок мыши передается объекту, который расположен по координа
там щелчка).
Обработка событий в представлении ничем не отличается от обычной обработки событий,
рассмотренной в главе 20, за исключением некоторых особенностей, рассматриваемых
в этом разделе.
26.6.1. События клавиатуры
При обработке событий клавиатуры следует учитывать, что:
♦ графический объект должен и:меть возможность принимать фокус ввода. Для этого не
обходимо установить флаг ItemisFocusaЫe - например, с помощью метода setFlag()
класса QGraphicsitem;
♦ объект должен бьrть в фокусе ввода. Методы, позволяющие управлять фокусом ввода,
мы рассматривали в разд. 26.1.5 и 26.3.1.1;
♦ чтобы захватить эксклюзивный ввод с клавиатуры, следует вызвать у графического объ
екта метод grabKeyboard (), а чтобы освободить ввод - метод ungrabKeyboard ();
♦ можно перехватить нажатие любых клавиш, кроме <ТаЬ> и <Shift>+<Tab>, используе
мьIХ для передачи фокуса;
♦ если событие обработано, нужно вызвать метод accept () у объекта события, в против
ном случае - метод ignore ().
Глава 26. Графическая сцена 627
Для обработки событий клавиатуры следует наследов;пь класс, реализующий графический
объект, и переопределить в нем методы:
♦ focusinEvent (self, <event>) - вызьmается при получении фокуса ввода. Через пара
метр <event> доступен объект класса QFocusEvent (см.разд. 20.8.1);
♦ focusOUtEvent (self, <event>) - вызывается при потере фокуса ввода. Через параметр
<event> доступен объект класса QFocusEvent (см.разд. 20.8.1);
♦ keyPressEvent (self, <event>) - вызьmается при нажатии клавиши. Если клавишу
удерживать нажатой, метод будет вызываться постоянно, пока ее не отпустят. Через па
раметр <event> доступен объект класса QKeyEvent (см. разд. 20.8.3);
♦ keyReleaseEvent (self, <event>) - вызывается при отпускании нажатой ранее клавиши.
Через параметр <event> доступен объект класса QKeyEvent (см.разд. 20.8.3).
С помощью метода setFocusProxy (<Графический объект>) класса QGraphicsitem можно ука
зать графический объект, который будет обрабатывать события клавиатуры вместо текуще
го объекта. Получить ссылку на назначенный ранее объект-обработчик событий клавиатуры
позволяет метод focusProxy ().
26.6.2. События мыши
Для обработки нажат�щ кнопок мыши и перемещения мыши следует наследовать класс,
реализующий графический объект, и переопределить в нем такие методы:
♦ mousePressEvent (self, <event>) - вызьmается при нажатии кнопки мыши над объек
том. Через параметр <event> доступен объект класса QGraphicsSceneMouseEvent. Если
событие принято, необходимо вызвать метод accept () объекта события, в противном
случае - метод ignore (). Если бьш вызван метод ignore (), методы mouseReleaseEvent ()
и mouseMoveEvent () вызваны не будут.
С помощью метода setAcceptedМouseButtons (<КНоnки>) класса QGraphicsitem можно
указать кнопки, события от которых объект будет принимать. По умолчанию объект
принимает события от всех кнопок мыши. В качестве параметра указывается элемент
перечисления MouseButton из модуля QtCore. Qt или их комбинация через оператор 1.
Если указать элемент NoButton, объект вообще не станет принимать события от кнопок
мыши;
♦ mouseReleaseEvent ( self, <event>) - вызывается при отпускании ранее нажатой кнопки
мыши. Через параметр <event> доступен объект класса QGraphicsSceneMouseEvent;
♦ mouseDouЬleClickEvent (self, <event>) - вызывается при двойном щелчке мышью в
области объекта. Через параметр <event> доступен объект класса QgraphicsSceneMouse
Event;
♦ mouseMoveEvent (self, <event>) - вызывается при перемещении мыши. Через параметр
<event> доступен объект класса QGraphicsSceneMouseEvent.
Класс QGraphicsSceneMouseEvent наследует все методы классов QGraphicsSceneEvent и
:)Event и добавляет поддержку следующих методов:
♦ pos () - возвращает объект класса QPointF с координатами курсора мыши в пределах
области объекта;
♦ scenePos () - возвращает объект класса QPointF с координатами курсора мыши в преде
лах сцены;
628 Часть 11. Библиотека PyQt б
♦ screenPos () - возвращает объект класса QPoint с координатами курсора мыши в преде
лах экрана;
♦ lastPos () - возвращает объект класса QPointF с координатами последней запомненной
представлением позиции мыши в пределах области объекта;
♦ lastScenePos () - возвращает объект класса QPointF с координатами последней запом
ненной представлением позиции мыши в пределах сцены;
♦ lastScreenPos () - возвращает объект класса QPoint с координатами последней запом
ненной представлением позиции мыши в пределах экрана;
♦ buttonDownPos (<кнопка>) - возвращает объект класса QPointF с координатами щелчка
указанной кнопки мыши в пределах области объек_та;
♦ buttonDownScenePos (<КНопка>) - возвращает объект класса QPointF с коордиuатами
щелчка указанной кнопки мыши в пределах сцены;
♦ butt.onDownScreenPos (<кнопка>) - возвращает объект класса QPoint с координатами
щелчка указанной кнопки мыши в пределах экрана;
♦ button () - возвращает обозначение кнопки мыши, нажатие которой вызвало событие;
♦ buttons () - возвращает комбинацию обозначений всех кнопок мыши, одновременное
нажатие которых вызвало событие.
Обозначения кнопок представляются элементами перечисления мouseButton из модуля
· QtCore . Qt или их комбинациями через оператор 1 ;
♦ modifiers () - возвращает набор обозначений всех клавиш-модификаторов (<Shift>,
<Ctrl>, <Alt> и др.), что были нажаты вместе с кнопкой мыши, в виде комбинации эле
ментов перечисления KeyboardМodifier из модуля QtCore.Qt или их комбинации через
орератор 1.
По умолчанию событие мыши перехватывает объект, на котором бьm произведен щелчок
мышью. Чтобы перехватывать нажатие и отпускание мыши вне объекта, следует захватить
мышь с помощью метода grabMouse () класса QGraphicsitem. Освободить захваченную ранее
мышь позволяет метод ungrabMouse (). Получить ссылку на объект, захвативший мышь,
можно с помощью метода mouseGrabberitem () класса QGraphicsScene.
Для обработки прочих событий мыши нужно наследовать класс, реализующий графический
объект, и переопределить следующие методы:
♦ hoverEnterEvent (self, <event>) - вызьmается при наведении курсора мыши на область
объекта. Через параметр <event> доступен объект класса QGraphicsSceneHoverEvent;
♦ hoverLeaveEvent ( self, <event>) - вызывается, когда курсор мыши покидает область
объекта. Через параметр <event> доступен объект класса QGraphicsSceneHoverEvent;
♦ hoverMoveEvent (self, <event>) - вызывается при перемещении курсора мыши внут-
ри области объекта. Через параметр <event> доступен объект класса
QGraphicsSceneHoverEvent;
♦ wheelEvent (self, <event>) - вызывается при повороте колесика мыши при нахожде
нии курсора мыши над объектом. Чтобы обрабатывать событие, в любом случае сле
дует захватить мышь. Через параметр <event> доступен объект класса
QGraphicsSceneWheelEvent.
Следует учитывать, что методы hoverEnterEvent (), hoverLeaveEvent () и hoverMoveEvent ()
будут вызваны только в том случае, если обработка этих событий разрешена. Чтобы раз-
Глава 26. Графическая сцена 629
решить обработку событий перемещения мыши, следует вызвать метод
setAcceptHoverEvents (<Флаг>) класса QGraphicsitem и передать_ ему значение True. Значе
ние False запрещает обработку событий перемещения указателя. Получить текущее состоя
ние позволяет метод acceptHoverEvents () .
Класс QGraphicsSceneHoverEvent наследует все методы классов QGraphicsSceneEvent и
QEvent и добавляет поддержку своих методов:
♦ pos () - возвращает объект класса QPointF с координатами курсора мыши в пределах
области объекта;
♦ scenePos () - возвращает объект класса QPointF с координатами курсора мыши в преде
лах сцены;
♦ screenPos () - возвращает объект класса QPoint с координатами курсора мыши в преде
лах экрана;
♦ lastPos () - возвращает объект класса QPointF с координатами последней запомненной
представлением позиции мыши в пределах области объекта;
♦ lastScenePos () - возвращает объект класса QPointF с координатами последней запом
ненной представлением позиции мыши в пределах сцены;
♦ lastScreenPos () - возвращает объект класса QPoint с координатами последней запом
ненной представлением позиции мыши в пределах экрана;
♦ modifiers () - возвращает комбинацию обозначений всех клавиш-модификаторов
(<Shift>, <Ctrl>, <Alt> и др.), что бьши нажаты одновременно с перемещением мыши,
в виде комбинации элементов перечисления KeyboardМodifiers из модуля QtCore .Qt или
их комбинации через оператор 1 .
Класс QGraphicsSceneWheelEvent наследует все методы классов QGraphicsSceneEvent и
QEvent и добавляет поддержку следующих методов:
♦ delta () - возвращает угол поворота колесика, измеряемого в 1/ . Положительное зна
8
°
чение означает, что колесико поворачивалось в направлении от пользователя, отрица
тельное - к пользователю;
♦ orientation () - возвращает направление вращения колесика в виде значения одного из
следующих элементом перечисления .Orientation из модуля QtCore .Qt: Horizontal (по
горизонтали) или Vertical (по вертикали);
♦ pos () - возвращает объект класса QPointF с координатами курсора мыши в пределах
области объекта;
♦ scenePos () - возвращает объект класса QPointF с координатами курсора мыши в преде
лах сцены;
♦ screenPos () - возвращает объект класса QPoint с координатами курсора мыши в преде
лах экрана;
♦ buttons () - возвращает комбинацию обозначений всех кнопок мыши, нажатых одно
временно с вращением колесика;
♦ modifiers () - возвращает комбинацию обозначений всех клавиш-модификаторов
(<Shift>, <Ctrl>, <Alt> и др.), что бьши нажаты одновременно с вращением колесика.
630 Часть 11. Библиотека PyQt б
26.6.3. Обработка перетаскивания и сброса
Прежде чем обрабатывать перетаскивание и сброс, необходимо сообщить системе, что гра
фический объект может их обработать. Для этого следует вызвать метод
setAcceptDrops (<Флаг>) класса QGraphicsitem и передать ему значение True.
Обработка перетаскивания и сброса в графическом объекте выполняется следующим об
разом:
♦ внутри метода dragEnterEvent () проверяется МIМЕ-тип перетаскиваемых данных и
действие. Если графический объект способен обработать сброс этих данных и соглаша
ется с предложенным действием, необходимо вызвать метод acceptProposedActi�n ()
объекта события. Если нужно изменить действие, методу setDropAction () объекта собы
тия передается новое действие, а затем у того же объекта вызывается метод accept ()
вместо метода acceptProposedAction () ;
♦ если необходимо ограничить область сброса некоторым участком графического объекта,
можно дополнительно определить в нем метод dragMoveEvent () . Этот метод будет
постоянно вызываться при перетаскивании внутри области графического объекта. При
согласии со ·сбрасыванием следует вызвать у объекта события метод accept () ;
♦ внутри метода dropEvent () производится обработка сброса.
Обработать события, возникающие при перетаскивании и сбрасывании объектов, позволя
ют следующие методы:
♦ dragEnterEvent (self, <event>) - вызывается, когда перетаскиваемый объект входит
в область графического объекта. Через параметр <event> доступен объект класса
QGraphicsSceneDragDropEvent;
♦ dragLeaveEvent (self, <event>) - вызывается, когда перетаскиваемый объект покидает
область графического объекта. Через параметр <event> доступен объект класса
QGraphicsSceneDragDropEvent;
♦ dragMoveEvent (self, <event>) - вызьmается при перетаскивании объекта внутри об
ласти графического объекта. Через параметр <event> доступен объект класса
QGraphicsSceneDragDropEvent;
♦ dropEvent (self, <event>) - вызывается при сбрасывании объекта в области гра-
фического объекта. Через параметр <event> доступен объект класса
QGraphicsSceneDragDropEvent.
Класс QGraphicssceneDragDropEvent наследует все методы классов QGraphicsSceneEvent
и QEvent и добавляет поддержку методов:
♦ mimeData () - возвращает объект класса QMimeData с перемещаемыми данными и ин
формацией о МIМЕ-типе;
♦ pos () - возвращает объект класса QPointF с координатами курсора мыши в пределах
области объекта;
♦ scenePos () - возвращает объект класса QPointF с координатами курсора мыши в преде
лах сцены;
♦ screenPos () - возвращает объект класса QPoint с координатами курсора мыши в преде
лах экрана;
♦ possiЫeActions () - возвращает набор возможных действий при сбрасывании в виде
комбинации элементов перечисления DropAction из модуля QtCore . Qt;
Глава 26. Графическая сцена 631
♦ proposed.Action () - возвращает действие по умолчаншо при сбрасывании в виде эле
мента перечисления DropAction из модуля QtCore.Qt;
♦ acceptProposed.Action () - подтверждает готовность принять перемещаемые данные и
согласие с действием по умолчаншо, возвращаемым методом proposed.Action ();
♦ setDropAction (<Действие>) - указывает другое действие при сбрасывании. После изме
нения действия следует вызвать метод accept (), а не acceptProposed.Action ();
♦ dropAction () - возвращает действие, которое должно быть выполнено при сбрасыва
нии;
♦ buttons () � возвращает комбинацшо обозначений всех кнопок мыши, нажатых в про
цессе перетаскивания;
♦ modifiers () - возвращает комбинацшо обозначений всех клавиш-модификаторов
(<Shift>, <Ctrl>, <Alt> и др.), что были нажаты в процессе перетаскивания;
♦ source () - возвращает ссылку на источник события или значение None.
26.6.4. Фильтрация событий
События можно перехватьmать еще до того, как они будут переданы специализированному
методу. Для этого в классе графического объекта необходимо переопределить метод
sceneEvent (self, <event>). Через параметр <event> здесь будет доступен объект с допол
нительной информацией о событи1:1.. Тип этого объекта различен для разных типов событий.
Внутри метода следует вернуть значение тrue, если событие обработано, и False - в про
тивном случае. Если вернуть значение True, специализированный метод (например,
mousePressEvent ()) вызываться не будет.
Чтобы произвести фильтрацшо событий какого-либо объекта, в классе графического объек
та необходимо переопределить метод sceneEventFilter (self, <Объект>, <event>). Через
параметр <Объект> здесь будет доступна ссылка на графический объект, в котором возникло
событие, а через параметр <event> - объект с информацией о самом событии. Тип этого
объекта различен для разных типов событий. Внутри метода следует вернуть значение тrue,
если событие обработано, и False - в противном случае. Если вернуть значение тrue, объ
ект, в котором возникло событие, не получит его.
Указать, события какого объекта фильтруются, позволяют следующие методы класса
QGraphicsitem:
♦ installSceneEventFilter (<Графический объект>) - задает объект, который будет про
изводить фильтрацшо событий текущего объекта;
♦ removeSceneEventFil ter (<Графический объект>) - удаляет объект-фильтр событий;
♦ setFiltersChildEvents (<Флаг>) - если в качестве параметра указано значение True,
текущий объект будет производить фильтрацшо событий всех своих дочерних объектов.
26.6.5. Обработка изменения состояния объекта
Чтобы обработать изменение состояния объекта, следует переопределить метод
itemChange (self, <Состояние>, <Значение>) в классе графического объекта. Метод должен
возвращать новое значение. Через параметр <Состояние> доступно состояние, которое было
изменено, в виде значения одного из следующих элементов перечисления
GraphicitemChange из класса QGraphicsitem (здесь приведены только ос�овные - полный
632 Часть //. Библиотека PyQt б
их список можно найти на странице https://doc.qt.io/qt-6/qgraphicsitem.html#Graphicsltem
Change-enum):
♦ ItemEnaЫedChange- изменилось состояние доступности;
♦ ItemEnaЫedНasChanged- изменилось состояние доступности. Возвращаемое значение
игнорируется;
♦ ItemPosi tionChange- изменилось местоположение объекта. Метод будет вызван, толь
ко если установлен флаг ItemSendsGeometryChanges;
♦ ItemPositionHasChanged- изменилось местоположение объекта. Метод будет вызван,
только если установлен флаг ItemSendsGeometryChanges. Возвращаемое значение игно
рируется;
♦ ItemScenePositionНasChanged- изменилось местоположение объекта на сцене с учетом
преобразований, примененных к самому объекту и его родителям. Метод будет вызван,
только если установлен флаг ItemSendsScenePositionChanges. Возвращаемое значение
игнорируется;
♦ ItemTransformChange - изменилась матрица преобразований. Метод будет вызван,
только если установлен флаг ItemSendsGeometryChanges;
♦ ItemTransformНasCh�nged- изменилась матрица преобразований. Метод будет вызван,
только если установлен флаг ItemSendsGeometryChanges. Возвращаемое значение игно
рируется;
♦ ItemSelectedChange- изменилось выделение объекта;
♦ ItemSelectedНasChanged- изменилось выделение объекта. Возвращаемое значение иг
норируется;
♦ ItemVisiЫeChange- изменилось состояние видимости <?бъекта;
♦ ItemVisiЫeнasChanged- изменилось состьяние видимости объекта. Возвращаемое зна-
чение игнорируется;
♦ ItemCursorChange - изменился курсор;
♦ ItemCursorHasChanged- изменился курсор. Возвращаемое значение игнорируется;
♦ ItemToolTipChange - изменилась вспльшающая подсказка;
♦ ItemToolTipHasChanged- изменилась всплывающая подсказка. Возвращаемое значение
игнорируется;
♦ ItemFlagsChange- изменились флаги;
♦ ItemFlagsHaveChanged- изменились флаги. Возвращаемое значение игнорируется;
♦ ItemZVal-ueChange - изменилось положение по оси z;
♦ ItemZValueHasChanged- изменилось положение по оси z. Возвращаемое значение игно
рируется;
♦ ItemOpacityChange- изменилась прозрачность объекта;
♦ ItemOpacityHasChanged- изменилась прозрачность объекта. Возвращаемое значение
игнорируется;
♦ ItemParentChange - изменился родитель объекта;
♦ ItemParentHasChanged- изменился родитель объекта. Возвращаемое значение игнори
руется;
Глава 26. Графическая сцена 633
♦ It;emChildAddedChange - в объект бьm добавлен новый потомок;
♦ ItemChildRemovedChange - из объекта бьm удален потомок;
♦ ItemSceneChange - объект бьm перемещен на другую сцену;
♦ ItemSceneHasChanged - объект был перемещен на другую сцену. Возвращаемое значе-
ние игнорируется.
BHHMAHHEI
Вызов некоторых методов из метода itemChange () может привести к рекурсии. За подроб
ной информацией обращайтесь к документации по классу QGraphicsrtem.
ПРНМЕЧАННЕ
PyQt также поддерживает помещение на сцену видеозаписей в качестве отдельных графи
ческих объектов и создание анимации. За подробным описанием обращайтесь к докумен
тации по этой библиотеке.
ГЛАВА 27
Диалоговые окна
PyQt позволяет выводить как произвольные диалоговые окна, так и стандартные: открытия
файла, каталога, для ввода данных, для вывода сообщений и др.
Все рассмотренные в этой главе классы определены в модуле QtWidgets, если не указано
иное.
27.1. Пользовательские диалоговые окна
Класс QDialog реализует диалоговое окно. По умолчанию окно выводится с рамкой и заго
ловком, в котором расположены кнопки вывода справки и закрытия. Размеры окна можно
изменять. Иерархия наследования класса QDialog выглядит так:
(QObject, QPaintDevice) - QWidget - QDialog
Конструктор класса QDialog имеет следующий формат:
QDialog ( [раrеnt=<Родитель>] [, flags=0] )
В параметре parent указывается ссылка на родительское окно. Если родитель не указан или
имеет значение None, диалоговое окно будет центрироваться относительно экрана, если
указана - относительно родительского окна (это также позволяет создать модальное диа
логовое окно, которое будет блокировать только окно родителя, а не все окна программы).
Значения, указываемые в параметре flags, были рассмотрены в разд. 19.1.1. Тип окна по
умолчанию - Dialog.
Класс QDialog наследует все методы базовых классов и дополнительно реализует следую
щие методы (здесь приведены только основные - полный их список можно найти на стра
нице https://doc.qt.io/qt-6/qdialog.html):
♦ ехес () - отображает модальное диалоговое окно, дожидается закрытия окна и возвра
щает код возврата в виде значения следующих элементов перечисления DialogCode из
класса QDialog:
• Accepted - нажата кнопка ОК;
• Rejected- нажата кнопка Cancel, кнопка закрытия в заголовке окна или клавиша
<Esc>.
Метод является слотом.
Глава 27. Диалоговые окна 635
Пример отображения диалогового окна и обработки статуса внутри обработчика нажа
тия кнопки (класс MyDialog является наследником класса QDialog, а window - ссьmка на
главное окно):
def on�clicked():
dialog = MyDialog(window)
result = dialog.exec()
if result == QtWidgets.QDialog.DialogCode.Accepted:
print("Нажата кнопка ОК")
# Здесь получаем данные из диалогового окна
else:
print("Нажата кнопка Cancel")
♦ accept() - закрывает модальное диалоговое окно и устанавливает код возврата равным
значению элемента Accepted перечисления DialogCode. Метод является слотом. Обычно
его соединяют с сигналом нажатия кнопки ОК:
self.btnOK.clicked.connect(self.accept)
♦ reject() -закрьmает модальное диалоговое окно и устанавливает код возврата равным
значению элемента Rejected перечисления DialogCode. Метод является слотом. Обычно
его соединяют с сигналом нажатия кнопки Cancel:
self.btnCancel.clicked.connect(self.reject)
♦ done(<Код возврата>) - закрывает модальное диалоговое окно и устанавливает код
возврата равным значению параметра. Метод является слотом;
♦ setResult(<Код возврата>) - устанавливает код возврата;
♦ result() -возвращает код возвра�а;
♦ setSizeGripEnaЫed(<Флаг>) - если в качестве параметра указано значение True, то
в правом нижнем углу диалогового окна будет отображен значок изменения размера,
а если False -то скрыт (значение по умолчанию);
♦ isSizeGripEnaЫed() -возвращает значение True, если в правом нижнем углу диалого
вого окна отображается значок изменения размера, и False -в противном случае;
♦ setVisiЫe(<Флаг>) -если в параметре указано значение True, диалоговое окно будет
отображено, а если значение False -то скрыто;
♦ show() -отображает диалоговое окно;
♦ hide() -закрывает диалоговое окно;
♦ open() - отображает диалоговое окно в модальном режиме, но не дожидается его за
крытия. Блокируется только родительское окно, а не все окна приложения. Метод явля
ется слотом;
♦ setModal (<Флаг>) - если в качестве параметра указано значение True, окно будет
модальным, а если F.alse - обычным. Обратите внимание, что окно, открываемое с по
мощью метода ехес(), всегда будет модальным - независимо от значения, заданного
вызовом метода setModal(). Чтобы диалоговое окно было не модальным, нужно ото
бражать его с помощью метода show () или setVisiЫe(). После вызова этих методов
следует вызвать методы raise _() (чтобы поместить окно поверх всех окон) и
activateWindow () (чтобы сделать окно активным -т. е. имеющим фокус ввода).
636 Часть 11. Библиотека PyQt 6
Указать, что окно является модальным, также позволяет метод setWindowМodality(<Флaг>)
класса QWidget. В качестве параметра могут быть указаны следующие элементы пере
числения WindowМodality из модуля QtCore.Qt:
• NonМodal - окно не является модальным;
• WindowМodal - окно блокирует только родительские окна в пределах иерархии;
• ApplicationМodal '- окно блокирует все окна в программе.
Окна, открытые из модального окна, не блокируются. Следует также учитывать, что ме
тод setWindowМodality() должен быть вызван до отображения окна.
Получить текущее значение модальности окна позволяет метод windowМodality() класса
QWidget. Проверить, является ли окно модальным, можно с помощью метода isModal()
того же класса, который возвращает True, если окно является модальным, и False -
в противном случае.
Класс QDialog поддерживает следующие сигналь�:
♦ accepted() - генерируется при установке флага Accepted (нажата кнопка ОК). Не гене
рируется при закрытии окна с помощью метода hide() или setVisiЫe();
♦ rejected() - генерируется при установке флага Rejected· (нажата кнопка Cancel, кноп
ка закрытия в заголовке окна или клавиша <Esc>). Не генерируется при закрытии окна
с помощью метода hide() или setVisiЫe();
♦ finished(<Koд завершения>) - ге,нерируется при установке любого кода завершения
в результате действий пользователя или программно - вызовом методов accept(),
reject() или done(). Внутри обработчика через параметр доступен код завершения.
Сигнал не генерируется при закрытии окна с помощью метода hide() или setVisiЫe().
Для всех кнопок, добавляемых в диалоговое окно, автоматически вызывается . метод
setAutoDefault() со значением True в .качестве параметра. В этом случае кнопка может
быть нажата с помощью клавиши <Enter> при условии, что она находится в фокусе. По
умолчанию нажать кнопку позволяет только клавиша <Пробел>.
С помощью метода setDefault() можно указать кнопку по умолчанию. Эта кнопка может
быть нажата с помощью клавиши <Enter>, когда фокус ввода установлен на другой компо
нент - например, на текстовое поле.
27 .2. Класс QDialogButtonBox
Класс QDialogButtonBox представляет контейнер, в который можно добавить различные
кнопки: как стандартные, так и пользовательские. Внешний вид контейнера и расположение
кнопок в нем зависят от используемой операционной системы. Иерархия наследования для
класса QDialogButtonBox:
(QObject, QPaintDevice) - QWidget - QDialogButtonBox
Форматы конструктора класса QDialogButtonвox:
QDialogButtonBox( [parent=None])
QDialogButtonBox(<Opиeнтaция>[, parent=None])
QDialogButtonBox(<Стандартные кнопки> [, parent=None]).
QDialogButtonBox(<Cтaндapтныe кнопки>, <Ориентация>[, parent=None])
Глава 27. Диалоговые окна 637
В параметре parent может быть указана ссылка на родительский компонент. Параметр
<Ориентация> задает порядок расположения кнопок внутри контейнера. В качестве значения
указываются элементы нorizontal (по горизонтали - значение по умолчанию) или
Vertical (по вертикали) перечисления Orientation из модуля QtCore.Qt. В параметре
<Стандартные кнопки> указываются следующие элементы перечисления Standard.Вutton
(или их комбинация через оператор 1) класса QDialogButtonвox:
♦ NoButton - кнопки не установлены;
♦ Ok - кнопка ОК с ролью AcceptRole;
♦ cancel - кнопка Cancel с ролью RejectRole;
♦ Yes - кнопка Yes с ролью YesRole;
♦ YesToAll - кнопка Yes to AII с ролью YesRole;
♦ No - кнопка No с ролью NoRole;
♦ NoToAll - кнопка No to AII с ролью NoRole;
♦ Open - кнопка Open с ролью AcceptRole;
♦ Close - кнопка Close с ролью RejectRole;
♦ Save - кнопка Save с ролью AcceptRole;
♦ SaveAll - кнопка Save AII с ролью AcceptRole;
♦ Discard- кнопка Discard или Don't Save (надпись на кнопке зависит от операционной
системы) с ролью DestructiveRole;
♦ Apply - кнопка Apply с ролью ApplyRole;
♦ Reset - кнопка Reset с ролью ResetRole;
♦ RestoreDefaults - кнопка Restore Defaults с ролью ResetRole;
♦ Help - кнопка Help с ролью HelpRole;
♦ AЬort - кнопка Abort с ролью RejectRole;
♦ Retry - кнопка Retry с ролью AcceptRole;
♦ Ignore - кнопка Ignore с ролью AcceptRole.
Класс QDialogвuttonвox наследует все методы базовых классов и поддерживает следующие
дополнительные методы (здесь приведены только интересующие нас - полный их список
можно найти на странице https://doc.qt.io/qt-6/qdialogbuttonbox.html):
♦ setOrientation (<Ориентация>) - задает порядок расположения кнопок внутри контей
нера. В качестве значения указываются элементы Horizontal (по горизонтали) или
vertical (по вертикали) перечисления Orientation из модуля QtCore.Qt;
♦ setStandard.Вuttons(<Стандартные кнопки>) ---'- д.обавляет в контейнер стандартные
кнопки:
self. Ьох. setStandard.Вuttons ( QtWidgets. QDialogButtonBox. Standard.ВЩ:ton.Ok
QtWidgets.QDialogButtonВox.Standard.Вutton.Cancel)
♦ add.Вutton( ) - добавляет кнопку в контейнер. Форматы метода:
аdd.Вuttоn(<Стандартная кнопка Standard.Вutton>)
add.Вutton(<Teкcт>, <Роль>)
add.Вutton(<КНoпкa QAЬstractButton>, <Роль>)
638 Часть 11. Библиотека PyQt б
Первый формат добавляет стандартную кнопку или кнопки (в виде одного из рассмот
ренных ранее элементов перечисления standardБutton или их комбинации через опера
тор 1 ). Второй формат принимает в качестве первого параметра надпись для добавляе
мой кнопки, а в качестве второго - ее роль. Третий формат принимает добавляемую
кнопку в виде объекта одного из подклассов класса QAЬstractButton - как правило,
класса QPushButton, представляющего обычную кнопку.
В качестве роли указывается один из следующих элементов перечисления вuttonRole из
класса QDialogButtonВox:
• InvalidRole - ошибочная роль;
• AcceptRole - нажатие кнопки устанавливает код возврата равным значению элемен
та Acceptect;
• RejectRole - нажатие кнопки устанавливает код возврата равным значению элемен
та Rejectect;
• DestructiveRole - кнопка для отказа от изменений и закрытия диалогового окна;
• ActionRole - нажатие кнопки приводит к выполнению операции, которая не связана
с закрытием окна;
• HelpRole - кнопка для отображения справки;
• YesRole - кнопка Yes;
• NoRole ---: кнопка No;
• ResetRole - кнопка для установки значений по умолчанию;
• ApplyRole - кнопка для принятия изменений.
Если роль недействительна, кнопка добавлена не будет.
Первый и второй форматы возвращают ссылку на сгенерированную и добавленную
в контейнер кнопку, третий не возвращает ничего:
self.ЬtnYes = QtWidget.QPushButton("&Дa")
self.box.addБutton(self.ЬtnYes,
QtWidget.QDialogButtonBox.ButtonRole.AcceptRole)
self.ЬtnNo = self.box.addButton(QtWidget.QDialogButtonBox.StandardButton.No)
self.ЬtnCancel = self.box.addБutton("&Cancel",
QtWidget.QDialogButtonBox.StandardБutton.RejectRole)
♦ button(<Стандартная кнопка StandardБutton>) - возвращает ссылку на стандартную
кнопку, соответствующую указанному обозначению, или None, если такой стандартной
кнопки в контейнере нет;
♦ standardБutton(<Кнопка QAЬstractButton>) - возвращает обозначение стандартной
кнопки, переданной в качестве параметра, или значение элемента NoButton, если такой
кнопки в контейнере нет;
♦ standardButtons () - возвращает комбинацию обозначений всех стандартных кнопок,
добавленных в контейнер;
♦ buttonRole(<Кнопка QAЬstractButton>) - возвращает роль указанной в параметре
кнопки. Если такая кнопка отсутствует, возвращается значение э:ле�ента InvalidRole;
♦ buttons() - возвращает список со ссылками на все кнопки, которые бьши добавлены
в контейнер;
Глава 27. Диалоговые окна 639
♦ removeButton(<КНопка QAЬstractButton>) - удаляет заданную кнопку из контейнера,
. при этом не удаляя объект кнопки;
♦ clear() - очищает контейнер и удаляет все кнопки;
♦ setCenterButtons(<Флаг>) - если в качестве параметра указано значение True, кнопки
будут выравниваться по центру контейнера.
Класс QDialogButtonвox поддерживает следующие сигналы:
♦ accepted() - генерируется при нажатии кнопки с ролью AcceptRole или YesRole. Этот
сигнал можно соединить со слотом accept() объекта диалогового окна:
self.box.accepted.connect(self.accept)
♦ rejected() - генерируется при нажатии кнопки с ролью RejectRole или NoRole. Этот
сигнал можно соединить со· слотом reject() объекта диалогового окна:
self.box .rejected.connect(self.reject)
♦ helpRequested() - генерируется при нажатии кнопки с ролью HelpRole;
♦ сliсkеd(<КНопка QAЬstractButton>) - генерируется при нажатии любой кнопки внутри
контейнера. Внутри обработчика через параметр доступна ссьшка на объект кнопки.
27 .3. Класс QMessageBox
Класс QMessageBox реализует стандартные окна-предупреждения для вывода сообщений.
Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QDialog - QMessageBox
Форматы конструктора класса QМessageBox:
QMessageBox ( [-parent= None])
QМеssаgеВох(<Значок>, <Текст заголовка>, <Текст сообщения>[,
buttons= StandardButton.NoButton] [, parent=None] [,
flags= WindowТype.Dialog I WindowТype.MSWindowsFix edSizeDialogHint])
Если в параметре parent указана ссылка на родительское окно, диалоговое окно будет цен
трироваться относительно родительского окна, а не относительно экрана. Параметр flags
задает тип окна (см. разд. 19.1.1). В параметре <Значок> могут быть указаны следующие
элементы перечисления Icon из класса QMessageBox:
♦ Noicon - нет значка;
♦ Question - значок со знаком вопроса;
♦ Information - значок информационного сообщения;
♦ Warning - значок предупреждающего сообщения;
♦ Critical - значок критического сообщения.
В параметре buttons указываются следующие элементы (или их комбинация через опера
тор 1) перечисления StandardВutton из класса QMessageBox:
♦ NoButton - кнопки не установлены;
♦ Ok - кнопка ()К с ролью AcceptRole;
640 Часть 11. Библиотека PyQt б
♦ Cancel - кнопка Cancel с ролью RejectRole;
♦ Yes - кнопка Yes с ролью YesRole;
♦ YesToAll - кнопка Yes to АН с ролью YesRole;
♦ No - кнопка No с ролью NoRole;
♦ NoToAll - кнопка No to АН с ролью NoRole;
♦ Open - кнопка Open с ролью AcceptRole;
♦ Close - кнопка Close с ролью RejectRole;
♦ Save - кнопка Save с ролью AcceptRole;
♦ SaveAll - кнопка Save АН с ролью AcceptRole;
♦ Discard - кнопка Discard или Don't Save (нацпись на кнопке зависит от операционной
системы) с ролью DestructiveRole;
♦ Apply - кнопка Apply с ролью ApplyRole;
♦ Reset - кнопка Reset с ролью ResetRole;
♦ RestoreDefaults - кнопка Restore Defaults с ролью ResetRole;
♦ Help - кнопка Help с ролью HelpRole;
♦ AЬort - кнопка Abort с ролью RejectRole;
♦ Retry - кнопка Retry с ролью AcceptRole;
♦ Ignore - кнопка Ignore с ролью AcceptRole.
После создания объекта класса следует вызвать метод ехес() , чтобы вывести окно на экран.
Метод возвращает числовое обозначение нажатой кнопки:
dialog = QtWidgets.QМessageBox(QtWidgets.QМessageBox.Icon.Critical,
"Текст заголовка", "Текст сообщения",
buttons=QtWidgets.QМessageBox.StandardВutton.Ok
QtWidgets.QМessageBox.StandardВutton.Cancel,
parent=window)
result = dialog.exec()
27.3.1. Основные методы и сигналы
Класс QMessageBox наследует все-петоды базовых классов и поддерживает следующие
дополнительные методы (полный их список можно найти на странице https://doc.qt.io/
qt-6/qmessagebox.html):
♦ seticon (<Значок Icon>) - устанавливает стандартный значок;
♦ seticonPixmap ( <Значок QPixmap>) - устанавливает пользовательский значок;
♦ setWindowТitle(<Текст заголовка>) - задает текст заголовка окна;
♦ setтext(<Текст сообщения>) - задает текст сообщения. Можно указать обычный текст,
текст в формате Markdown или НТМL-код. Перенос строки в обычной строке осуществ
ляется с помощью символа \n, а в строке в формате НТМL - с помощью тега <br>;
♦ setinfoпnativeтext (<Текст>) - задает текст дополнения, которое выводится под сооб
щением. Можно указать обычный текст, текст в формате Markdown или НТМL-код;
Глава 27. Диалоговые окна 641
♦ setDetailedText(<Текст>) - задает текст подробного сообщения. Если он задан, в окно
будет добавлена кнопка Show Details, с помощью которой можно отобразить скрытую
панель с подробным сообщением;
♦ setTextFormat(<Режим>) - задает режим отображения текста сообщения. Могут быть
указаны следующие элементы перечисления TextFш:mat из модуля Qtcore.Qt:
• Plainтext - простой текст;
• RichText - НТМL-код;
• Autoтext - автоматическое определение (режим по умолчанию). Если текст содер
жит НТМL-теги, используется режим Richтext, в противном случае - режим
PlainText;
• MarkdownText - текст в формате Markdown;
♦ setStandardВuttons(<Стандартные кнопки>) � добавляет стандартные кнопки:
dialog.setStandardВuttons(QtWidgets.QMessageBox.StandardButton .Ok 1
QtWidgets.QМessageBox.StandardВutton.Cancel)
♦ addВutton() - добавляет кнопку в окно. Форматы метода:
аddВuttоn(<Стандартная кнопка StandardВutton>)
addВutton(<Teкcт>, <Роль>)
addВutton(<КНoпкa QAЬstractButton>, <Роль>)
Первый формат добавляет стандартную кнопку или кнопки (в виде одного из рассмот
ренных ранее элементов перечисления StandardButton или их комбинации через опера
тор 1 ). Второй формат принимает в качестве первого параметра надпись для добавляе
мой кнопки, а в качестве второго - ее роль. Третий формат принимает добавляемую
кнопку в виде объекта одного из подклассов класса QAЬstractButton - как правило,
класса QPushButton, представляющего обычную кнопку.
В качеств·е роли указывается один из следующих элементов перечисления ButtonRole из
класса QMessageBox:
• InvalidRole - ошибочная роль;
• AcceptRole - нажатие кнопки устанавливает код возврата равным значению элемен
та Accepted;
• RejectRole - нажатие кнопки устанавливает код возврата равным значению элемен
та Rejected;
• DestructiveRole - кнопка для отказа от изменений и закрытия диалогового окна;
• ActionRole - нажатие кнопки приводит к выполнению операции, которая не связана
с закрытием окна;
• HelpRole - кнопка для отображения справки;
_
• YesRole - кнопка Yes;
• NoRole - кнопка No;
• ResetRole - кнопка для установки значений по умолчанию;
• ApplyRole - кнопка для принятия изменений.
Если роль недействительна, кнопка добавлена не будет..
642 Часть //. Библиотека PyQt б
Первый и второй форматы возвращают ссылку на сгенерированную и добавленную
в окно кнопку, третий не возвращает ничего:
btnYes = QtWidgets.QPushВutton("&Дa")
dialog.addВutton(btnYes, QtWidgets.QМessageBox.ButtonRole.AcceptRole)
btnNo = dialog.addВutton("&Heт",
QtWidgets.QМessageBox.ButtonRole.RejectRole)
btnCancel = dialog.addВutton(QtWidgets.QMessageBox.StandardВutton.Cancel)
♦ setDefaultButton() - задает кнопку по умолчанию, которая сработает при нажатии
клавиши <Enter>. Форматы метода:
setDefaultButton(<Cтaндapтнaя кнопка StandardВutton>)
setDefaultButton(<КНoпкa QPushВutton>)
♦ setEscapeвutton() - задает кнопку, которця сработает при нажатии клавиши <Esc>.
Форматы метода:
setEscapeButton(<Cтaндapтнaя кнопка StandardВutton>)
setEscapeButton(<КНoпкa QAЬstractButton>)
♦ setCheckBox(<Флажок QCheckВox>) - задает флажок, который будет выводиться в окне.
Чтобы убрать заданный ранее флажок, нужно передать значение None;
♦ checkBox() - возвращает заданный в методе setCheckBox() флажок или None, если тако
вого нет;
♦ clickedВutton() - возвращает ссьmку на кнопку, которая бьmа нажата, или значение
None;
♦ Ьuttоn(<Стандартная кнопка StandardВutton>) - возвращает ссьmку на стандартную
кнопку, соответствующую указанному обозначению, или None, если такой стандартной
кнопки в контейнере нет;
♦ standardButton (<кнопка QAЬstractButton>) - возвращает обозначение стандартной
кнопки, переданной в качестве параметра, или значение элемента NoButton, если такой
кнопки в контейнере нет;
♦ standardButtons() - возвращает комбинацию обозначений всех стандартных кнопок,
добавленных в окно;
♦ buttonRole(<кнопка QAЬstractButton>) - возвращает роль указанной в параметре
кнопки. Если · такая кнопка отсутствует, метод возвращает значение элемента
InvalidRole;
♦ buttons() - возвращает список со ссьmками на все кнопки, которые бьmи добавлены
в окно;
♦ removeButton(<КНопка QAЬstractButton>) - удаляет заданную кнопку из окна, при этом
не удаляя объект кнопки.
Класс QMessageBox поддерживает сигнал buttonClicked(<КНопка QAЬsi:ractButton>), гене
рируемый при нажатии кнопки в окне. Внутри обработчика через параметр доступна ссьmка
на нажатую кнопку.
27.3.2. Окно информационного сообщения
Помимо рассмотренных ранее, класс QМessageBox предлагает несколько статических мето
дов, выводящих типовые окна-предупреждения.
Глава 27. Диалоговые окна 643
Для вывода информационного сообщения предназначен статический метод information() .
Формат метода:
information(<Poдитeль>, <Текст заголовка>, <Текст сообщения>[,
buttons=StandardВutton.Ok] [, defaultButton=StandardВutton.NoButton])
В параметре <Родитель> указывается ссьmка на родительское окно или значение None. Если
указана ссьmка, диалоговое окно будет центрироваться относительно родительского окна, а
не относительно экрана. Необязательный параметр buttons позволяет указать стандартные
кнопки (элементы перечисления, задающие стандартные кнопки, указываются через опера
тор 1). По умолчанию выводится кнопка ОК. Параметр ctefaultвutton назначает кнопку по
умолчанию. Метод information() возвращает числовое обозначение нажатой кнопки:
QtWidgets.QМessageBox.information(window, "Текст заголовка",
"Текст сообщения",
buttons=QtWidgets.QМessageBox.StandardButton.Close,
defaultButton=QtWidgets.QМessageBox.StandardButton.Close)
Результат выполнения этого кода показан на рис. 27.1.
о
iiJ Текст заг�ловка Х
Текст сообщения
Close
Рис. 27.1. Информационное окно-сообщение
27.3.3. Окно подтверждения
Для вывода окна с запросом подтверждения каких-либо действий предназначен статиче
ский метод question(). Формат метода:
question(<Poдитeль>, <Текст заголовка>, <Текст сообщения>[,
buttons=StandardВutton.Yes I Standarr;ffiutton.No] [,
defaultButton=StandardВutton.NoButton])
В параметреI <Родитель> указывается ссьmка на родительское окно или значение None. Если
указана ссьmка, диалоговое окно будет центрироваться относительно родительского окна, а
не относительно экрана. Необязательный параметр buttons позволяет указать выводимые
стандартные кнопки (элементы перечисления, задающие стандартные кнопки, указываются
через оператор 1). По умолчанию отображаются кнопки Yes и No. Параметр ctefaultButton
назначает кнопку по умолчанию. Метод question() возвращает числовое обозначение на
жатой кнопки:
result = QtWidgets.QМessageBox.question(window, "Текст заголовка",
"Вы действительно хотите выполнить действие?",
buttons=QtWidgets.QМessageBox.StandardВutton.Yes
QtWidgets.QМessageBox.StandardВutton.No 1
QtWidgets.QМessageBox.StandardВutton.Cancel,
defaultButton=QtWidgets.QМessageBox.StandardВutton.Cancel)
Результат выполнения этого кода показан на рис. 27.2.
644 Часть 11. Библиотека PyQt б
il] Текст заголовка х
Вы действительно хотите выполнить действие?
Рис. 27.2. Окно запроса подтверждения
27.3.4. Окно предупреждающего сообщения
Для вывода окна с предупреждающим сообщением предназначен статический метод
warning() . Формат метода:
warning(<Poдитeль>, <Текст заголовка>, <Текст сообщения>[,
buttons=StandardВutton.Ok] [, defaultButton=StandardВutton.NoButton])
В параметре <Родитель> указывается ссьшка на родительское окно или значение None. Если
указана ссьmка, диалоговое окно будет центрироваться относительно родительского окна, а
не относительно экрана. Необязательный параметр buttons позволяет указать выводимые
стандартные кнопки (элементы перечисления, задающие стандартные кнопки, указываются
через оператор 1 ). По умолчанию отображается кнопка ОК. Параметр defaultButton назна
чает кнопку по умолчанию. Метод warning () возвращает числовое обозначение нажатой
кнопки:
result = QtWidgets.QMessageBox.warning(window, "Текст заголовка",
"Действие может бьrrь опасным. Продолжить?",
buttons=QtWidgets.QМessageBox.StandardВutton.Yes
QtWidgets.QMessageBox.StandardВutton.No 1
QtWidgets.QMessageBox.StandardВutton.Cancel,
defaultButton=QtWidgets.QМessageBox.StandardВutton.Cancel)
Результат выполнения этого кода показан на рис. 27.3.
liJ Текст заголовка х
Действие может быть опасным. Продолжить?
iL-----�
Yes iГ .t::!o ! 1 Cancel
Рис. 27.3. Окно предупреждающего сообщения
27.3.5. Окно критического сообщения
Для вывода окна с критическим сообщением предназначен статический метод critical () .
Формат метода:
сritiсаl(<Родитель>, <Текст заголовка>, <Текст сообщения>[,
buttons =StandardButton.Ok] [, defaultButton=StandardButton.NoButton])
Глава 27. Диалоговые окна 645
В параметре <Родитель> указывается ссылка на родительское окно или значение None. Если
указана ссылка, диалоговое окно будет центрироваться относительно родительского окна,
а не относительно экрана. Необязательный параметр buttons позволяет указать вьmодящие
ся на экран стандартные кнопки (элементы перечисления, задающие стандартные кнопки,
указываются через оператор 1 ). По умолчанию отображается кнопка ОК. Параметр
defaultButton назначает кнопху по умолчанию. Метод critical() возвращает числовое
обозначение нажатой кнопки:
QtWidgets.QМessageBox.critical(window, "Текст заголовка",
"Программа вьmолнила недопустимую ошибку и будет закрыта",
defaultButton=QtWidgets.QМessageBox.StandardВutton.Ok)
Результат выполнения этого кода показан на рис. 27.4.
i] Текст заголовка х
о Программа выполнила недопустимую ошибку и будет закрыта
.___о_к__.l
Рис. 27.4. Окно критического сообщения
27.3.6. Окно сведений о программе
Для вывода окна со сведениями о программе и авторских правах ее разработчиков предна
значен статический метод about() . Формат метода:
аЬоut(<Родитель>, <Текст заголовка>, <Текст сообщения>)
В параметре <Родитель> указывается ссылка на родительское окно или значение None. Если
указана ссылка, диалоговое окно будет центрироваться относительно родительского окна,
а не относительно экрана. Слева от текста сообщения отображается значок приложения
(см.разд. 19. 8), если он был установлен:
QtWidgets.QMessageBox.about(window, "Текст заголовка", "Описание программы")
27.3.7. Окно сведений о фреймворке Qt
Для вывода окна с описанием используемой версии фреймворка Qt предназначен статиче
ский метод aboutQt() . Формат метода:
aboutQt(<Родитель> [, title=""])
В параметре <Родитель> указывается ссылка на родительское окно или значение None. Если
указана ссылка, диалоговое окно будет центрироваться относительно родительского окна, а
не относительно экрана. В параметре title можно указать текст, выводимый в заголовке
окна. Если параметр не указан, то выводится заголовок About Qt:
QtWidgets.QМessageBox.aboutQt(window, title="O фреймворке Qt")
Результат выполнения этого кода.показан на рис. 27.5.
646 Часть 11. Библиотека PyQt 6
!u о фреймворке Qt х
AboutQt
mJ This program uses Qt version 6.2.3.
Qt is а С++ toolkit for cross-platform application development.
Qt provides single-source portabllity across all major desk\op operating systems. lt is also
availaЫe for embedded Linux and other embedded and moblle operating systems.
Qt is availaЫe under multiple licensing options designed to accommodate the needs of
our various users.
Qt licensed under our commercial license agreement is appropriate for development of
proprietary/commercial software where you do not want to share a'ny source code with
third parties or otherwise cannot comply with the terms of GNU (L)GPL.
Qt licensed under GNU (L)GPL is appropriate for the development of Qt applications
provided you can comply with the terms and conditions of the respective licenses.
Please see qt.io/licensing
. for an overview of Qt .licensing.
Copyright (С) 2022 The Qt Company ltd and other contributors.
Qt and the Qt logo are trademarks of The Qt Company Ltd.
Qt is The Qt Company ltd product developed as an open source project. See _g!Jo for
more information.
ок
Рис. 27.5. Окно сведений о фреймворке Qt
27 .4. Класс QlnputDialog
Класс QinputDialog представляет модальные диалоговые окна для ввода различных данных.
Иерархия наследования для этого класса выглядит так:
(QObject, QPaintDevice) - QWidget - QDialog - QinputDialog
Формат конструктора класса QinputDialog:
QinputDialog( [parent=None] [, ] [ flags=0] )
Если в параметре parent указана ссылка на родительское окно, диалоговое· окно будет цен
трироваться относительно родительского окна, а не относительно экрана. Параметр flags
задает тип окна (см.разд. 19.1. 1).
После создания объекта класса следует вызвать метод ехес ( ) , чтобы отобразить окно.
Метод возвращает код возврата в виде одного из следующих элементов перечисления
DialogCode из класса QDialog: Accepted или Rejected.
Вот пример отображения диалогового окна и обработки статуса внутри обработчика нажа
тия кнопки:
def on_clicked():
dialog = QtWidgets.QinputDialog(window)
result = dialog.exec()
if result == QtWidgets.QDialog.DialogCode.Accepted:
Глава 27. Диалоговые окна 647
print("Нажата кнопка ОК")
# Здесь получаем данные из диалогового окна
else:
print("Haжaтa кнопка Cancel")
27.4.1. Основные методы и сигналь�
Класс QinputDialog наследует все методы базовых классов и добавляет к ним следующие
собственные методы (здесь приведены только основные - полный их список можно найти
на странице https://doc.qt.io/qt.-6/qinputdialog.html):
♦ setLaЬelтехt(<Текст>) - задает текст, отображаемый над полем ввода;
♦ setOkButtonText(<Текст>) -задает текст надписи для кнопки ОК:
dialog.setOkВuttonText("&Пpинять")
♦ setCancelButtonText(<Текст>) - задает текст надписи для кнопки Cancel:
dialog.setCancelButtonText("&Bepнyтьcя")
♦ setinputMode(<Режим>) -задает режим ввода данных. В качестве параметра указывают
ся следующие элементы перечисления InputMode из класса QinputDialog:
• тextinput - ввод текста;
• Intinput - ввод целого числа;
• DouЫeinput - ввод вещественного числа;
♦ setTextEchoMode(<Режим>) - задает режим отображения текста в поле ввода. Могут
быть указаны следующие элементы перечисления EchoMode из класса QLineEdit:
• No:rmal - показьшать вводимые символы;
• NoEcho - не показывать вводимые символы;
• Password - вместо символов выводить звездочки ( *);
• PasswordEchoOnEdit - показывать символы при вводе, а при потере фокуса вместо
них отображать звездочки;
♦ setTextValu·e(<Текст>) - задает текст по умолчанmо, отображаемый в поле ввода;
♦ textValue() - возвращает текст, занесенный в поле ввода;
♦ setintValue(<Значение>) - задает целочисленное значение при использовании режима
Intlnput;
♦ intValue() - возвращает целочисленное значение, введенное в поле, при использова
нии режима Intinput;
♦ setintRange(<Минимум>, <Максимум>), setintMinimum(<Минимyм>) И setintMaximum(
<Максимум>) - задают диапазон допустимых целочисленных значений при использова
нии режима Intinput;
♦ setintstep(<Шaг>) - задает шаг приращения значения при нажатии кнопок со стрелка
ми в правой части поля при использовании режима Intinput;
♦ setDouЫeValue(<Значение>) - задает вещественное значение при использовании режи
ма DouЬleinput;
648 Часть 11. Библиотека PyQt б
♦ douЬleValue() - возвращает вещественное значение, введенное в поле, при использова
нии режима DouЫeinput;
♦ setDouЫeRange (<Минимум>, <Максимум>), setDouЬleMinimum(<Минимyм>) и
setDouЫeMaximum (<Максимум>) - задают диапазон допустимых вещественных значений
при использовании режима DouЬleinput;
♦ setDouЬleDecimals(<Количество>) - задает количество цифр после десятичной точки
при использовании режима DouЬleinput;
♦ setDouЬleStep( <11Iаг>) - задает шаг приращения значения при нажатии кнопок со
стрелками в правой части поля при использовании режима DouЬleinput;
♦ setComЬoBoxitems(<Список строк>) - задает пункты, которые будут присутствовать
в раскрывающемся списке, выводящемся в этом случае вместо обычного поля ввода.
Набор пунктов указывается в виде списка строк;
♦ setComЬoBoxEditaЫe(<Флаг>) - если в качестве параметра указано значение True, поль
зователь сможет ввести произвольное значение в раскрывающийся список, как если бы
он бьm обычным полем ввода;
♦ setOption(<0пция>[, on=True]) - если во втором параметре указано значение True, за
данная в первом параметре опция будет установлена, а если False - сброшена. Опщш
указьшаются в виде следующих элементов перечисления InputDialogOption из класса
QinputDialog:
• NoButtons - не выводить кнопки ОК и Cancel;
• UseListViewForComЬoBoxitems - для отображения списка строк будет использоваться
класс QListView (обычный список), а не QComЬoBox (раскрывающийся список);
• UsePlainTextEditForтextinput - вместо класса QLineEdit (поле ввода) будет ис
пользован класс QPlainTextEdit (область редактирования для обычного текста);
♦ setOptions(<Опции>) - сразу устанавливает несколько опций (см.. описание метода
setOption()).
Класс QinputDialog поддерживает сигналы:
♦ textValueChanged(<Знaчeниe>) - генерируется при изменении значения в текстовом
поле. Внутри обработчика через параметр доступно новое значение в виде строки. Сиг
нал генерируется при использовании режима тextinput;
♦ textValueSelected(<Знaчeниe>) - генерируется при нажатии кнопки ОК. Внутри обра
ботчика через параметр доступно введенное значение в виде строки. Сигнал генерирует
ся при использовании режима Textinput;
♦ intValueChanged(<Знaчeниe>) - генерируется при изменении значения в поле. Внутри
обработчика через параметр 1доступно новое значение в виде целого числа. Сигнал гене
рируется при использовании режима Intinput;
♦ intValueSelected(<Значение>) - ген_ерируется при нажатии кнопки ОК. Внутри обра
ботчика через параметр доступно введенное значение в виде целого числа. Сигнал гене
рируется при использовании режима Intinput;
♦ douЬleValueChanged(<Знaчeниe>) - генерируется при изменении значения в поле. Внут
ри обработчика через параметр доступно новое значение в виде_ вещественного числа.
Сигнал генерируется при использовании режима DouЬleinput;
Глава 27. Диалоговые окна 649
♦ douЫeValueSelected(<Значение>) - генерируется при нажатии кнопки ОК. Внутри об
работчика через параметр доступно введенное значение в виде вещественного числа.
Сигнал генерируется при использовании режима DouЫeinput.
27 .4.2. Окно для ввода строки
Класс QinputDialog также· поддерживает несколько статических методов, реализующих
типовые диалоговые окна.
Окно для ввода обычной строки или пароля выводится вызовом статического метода
getтext(). Формат метода:
gеtТехt(<Родитель>, <Текст заголовка>, <Текст nодск�зки>[,
echo=EchoMode.Normal] [, text=""] [, flags=O] [,
inputMethodHints=InputMethodНint .ImhNone])
В параметре <Родитель> указьmается ссьшка на родительское окно или значение None. Если
указана ссьшка, диалоговое окно будет центрироваться относительно родительского окна,
а не экрана. Необязательный параметр echo. задает режим отображения текста в поле
(см. описание метода setTextEchoMode () в разд. 2 7. 4.1). Параметр text устанавливает зна
чение поля по умолчанию, а в параметре flags можно указать тип окна.
Параметр inputMethodНints указьmает дополнительные опции поля ввода, присутствующе
го в· вьmеденном окне. g качестве его значения можно указать один из многочисленных
элементов перечисления InputMethodHint из модуля QtCore. Qt, список которых приведен на
странице https://doc.qt.io/qt-6/qt.html#InputMethodHint-enum, или их комбинацию через
оператор 1-
Метод getтext() возвращает кортеж из двух элементов: (<Значение>, <Статус>). Через
первый элемент доступно введенное значение, а через второй - значение тrue, если была
нажата кнопка ОК, или значение False, если бьша нажата кнопка Cancel, клавиша <Esc>
или кнопка закрытия в заголовке окна. Пример:
s, ok = QtWidgets.QinputDialog.getText(window, "Это заголовок окна",
"Это текст подсказки", tехt="Значение no умолчанию")
if ok:
print("Bвeдeнo значение:", s)
Результат выполнения этого кода показан на рис. 27.6.
U Это заголовок окна Х
Это текст подсказки
1Значение по умолчанию
Рис. 27.6. Окно для ввода строки
27 .4.3. Окно для ввода целого числа
Окно для ввода целого числа реализуется с помощью статического метода getint(). Фор
мат метода:
650 Часть 11. Библиотека PyQt 6
getint(<Родитель>, <Текст заголовка>, <Текст подсказки>·[, value=O] [,
min=-2147483647] [, max=2147483647] [, step=l] [, flags=O])
В параметре <Родитель> указывается ссылка на родительское окно или значение None. Если
указана ссылка, диалоговое окно будет центрироваться относительно родительского окна, а
не относительно экрана. Необязательный параметр value устанавливает значение поля по
умолчанию. Параметр min задает минимальное значение, параметр max - максимальное
значение, а параметр step - шаг приращения. Параметр flags позволяет указать тип окна.
Методы возвращают кортеж из двух элементов: (<Значение>, <Статус>). Через первый
элемент доступно введенное значение, а через второй - значение True, если бьmа нажата
кнопка ОК, или значение False, если бьmа нажата кнопка Cancel, клавиша <Esc> или кноп
ка закрытия в заголовке окна. Пример:
n, ok = QtWidgets.QinputDialog.getint(window, "Это заголовок окна",
"Это текст подсказки",
value=SO, min=O, max=lOO, step=2)
if ok:
print("Bвeдeнo значение:", n)
Результат выполнения этого кода показан на рис. 27.7.
liJ Это заголовок окна Х
Эrо текст подсказки
ШI
__о_к_�I [ СаП(еl 1
Рис. 27.7. Окно для ввода целого числа
27 .4.4. Окно для ввода вещественного числа
Окно для ввода вещественного числа реализуется с помощью статического метода
getDouЫe(). Формат метода:
gеtDоuЫе(<Родитель>, <Текст заголовка>, <Текст подсказки>[, value=O] [,.
min=-2147483647] [, max=2147483647] [, decimals=l] [, step=l] [, flags=O])
В параметре <Родитель> указывается ссьmка на родительское окно или значение None. Если
указана ссьmка, диалоговое окно будет центрироваться относительно родительского окна, а
не относительно экрана. Необязательный параметр value устанавливает значение поля по
умолчанию. Параметр min задает минимальное значение, параметр max - максимальное
значение, параметр decimals - количество цифр после десятичной точки, а параметр
step - шаг приращения. Параметр flags позволяет указать тип окна. Метод возвращает
кортеж из двух элементов: (<Значение>, <Статус>). Через первый элемент доступно вве
денное значение, а через второй элемент - значение т·rue, если была нажата кнопка ОК,
или значение False, если бьmа нажата кнопка Cancel, клавиша <Esc> или кнопка закрытия
в заголовке окна. Пример:
n, ok = QtWidgets.QinputDialog.getDouЬle(window, "Это заголовок окна",
"Это текст подсказки", value=SO.O, min=O.O,_ max=lOO.O,
decimals=2, step=2.0)
Глава 27. Диалоговые окна 651
if ok:
print("Bвeдeнo значение:", n)
27.4.5. Окно для выбора пункта из списка
Окно для выбора пункта из списка выводится статическим методом getrtem(). Формат
метода:
gеtitеm(<Родитель>, <Текст заголовка>, <Текст подсказки>, <Список строк>[,
current=O] [, editaЫe=True] [, flags= O] [,
inputMethodHints=InputMethodНint.ImhNone])
В параметре <Родитель> указывается ссьmка на родительское окно или значение None. Если
указана ссылка, диалоговое окно будет центрироваться относительно родительского окна, а
не относительно экрана. Необязательный параметр current устанавливает индекс пункта,
выбранного по умолчанию. Если в параметре editаЫе указано значение тrue, пользователь
может ввести произвольное значение в список вручную. Параметр flags позволяет указать
тип окна.
Параметр inputMethodНints указывает дополнительные опции списка, который будет при
сутствовать в выведенном окне. Его имеет смысл указывать только в том случае, если
параметру editaЫe дано значение тrue. В качестве его значения можно указать один из
многочисленных элементов перечисления InputMethodНint из модуля· QtCore. Qt, список
которых приведен на странице https://doc.qt.io/qt-6/qt.html#InputMethodHint-enum, или
их комбинацmо через оператор 1.
Метод возвращает кортеж из двух элементов: (<Значение>, <Статус>). Через первый эле
мент доступен текст выбранного пункта, а через второй - значение тrue, если была нажата
кнопка ОК, или значение False, если бьmа нажата кнопка Cancel, клавиша <Esc> или кноп
ка закрi.пия в заголовке окна. Пример:
s, ok = QtWidgets.QinputDialog.getitem(window, "Это заголовок окна",
"Это текст подсказки", ["Пункт 1", "Пункт 2", "Пункт З"],
current=l, editaЫe=False)
if ok:
print("Teкcт выбранного пункта:",.s)
Результат выполнения этого кода показан на рис. 27.8.
[i] Это заголовок окна Х
Это текст подсказки
r :
(Пу� тк �2 � __-:::J
- _ _-:_"':._"':._-=.,- , ,_ _
,...
Рис. 27.8. Окно для выбора пункта из списка
27.4.6. Окно для ввода большого текста
Окно для ввода большого _фрагмента обычного текста выводится статическим методом
getMultiLineText(). Формат метода:
652 Часть 11. Библиотека PyQt б
getMultiLineText(<Poдитeль>, <Текст заголовка>, <Текст подсказки>[,
text=""] [, flags=O] [, inputMethodHints= InputMethodНint. ImhNone] )
В параметре <Родитель> указывается ссьmка на родительское окно или значение None. Если
указана. ссылка, диалоговое окно будет центрироваться относительно родительского окна,
а не относительно экрана. Параметр text устанавливает значение, выводимое в области
редактирования по умолчанию, а в параметре flags можно указать тип окна.
Параметр inputMethodНints указывает дополнительные опции области редактирования, ко
торое будет присутствовать в выведенном окне. В качестве его значения можно указать
один из элементов перечисления InputMethodНint или их комбинацию через оператор 1 .
Метод getMultiLineText() возвращает кортеж из двух элементов: (<Значение>, <Статус>) .
Через первый элемент доступно введенное значение, а через второй - значение True, если
бьmа нажата кнопка ОК, или значение False, если бьmа нажата кнопка Cancel, клавиша
<Esc> или кнопка закрытия в заголовке окна. Пример:
s, ok = QtWidgets.QinputDialog.getMultiLineText(window, "Это заголовок окна",
"Это текст подсказки", text = "Текст\nТекст\nТекст")
if ok:
print("Teкcт выбранного пункта:", s)
Результат выполнения этого кода показан на рис. 27.9.
i)J Это заголовок окна х
Это текст подсказки
Текст
Текст
Текст
ОК Сапсеl
Рис. 27.9. Окно для ввода большого фрагмента текста
27 .5. Класс QFileDialog
Класс QFileDialog реализует модальные диалоговые окна для выбора файла или каталога.
Иерархия наследования для него выглядит так:
(QObject, QPaintDevice) - QWidget - QDialog - QFileDialog
Форматы конструктора класса QFileDialog:
QFileDialog(<Poдитeль>, <Тип окна>)
QFileDialog( [parent=None] [, caption=""J[, directory=""J[,, filter=""J)
Глава 27. Диалоговые окна 653
Если в параметрах <Родитель> и parent указана ссылка на родительское окно, диалоговое
окно буд'ет центрироваться относительно родительского окна, а не экрана. Параметр <Тип
окна> задает тип окна (см. разд. 19.1.1). Необязательный параметр caption задает заголовок
окна, параметр directory- начальный каталог, а параметр filter- фильтр для отбора
файлов, которые будут выведены в диалоговом окне (например, фильтр "Images (* .png
*. jpg)" задаст вывод только файлов с расширениями png и jpg).
После создания объекта класса сдедует вызвать метод ехес ( ) , чтобы вьmести диалоговое
окно на экран. Метод возвращает код возврата в виде значения элементов Accepted или
Rejected перечисления DialogCode из класса QDialog.
27 .5.1. Основные методы и сигналы
Класс QFileDialog наследует все методы базовых классов и определяет следующие собст
венные методы (здесь приведены только основные - полный их список можно найти на
странице https://doc.qt.io/qt-6/qfiledialog.html):
♦ setAcceptMode (<Тип>) - задает тип окна. В качестве параметра указываются следующие
элементы перечисления AcceptMode из класса QFileDialog:
• AcceptOpen - окно для открытия файла (по умолчанию);
• AcceptSave- окно для сохранения файла;
♦ setViewMode (<Режим>) - задает режим вывода списка файлов в окне. В качестве пара
метра указываются следующие элементы перечисления ViewМode из класса QFileDialog:
• Detail - отображается подробная информация о файлах;
• List- отображаются только значки и имена файлов;
♦ setFileMode (<Тип>·) - задает тип элементов, которые пользователь может выбратъ
в окне. В качестве параметра указываются следующие элементъ1 перечисления FileMode
из класса QFileDialog:
• AnyFile - любой файл, независимо от того, существует он или нет;
• ExistingFile - только существующий файл;
• Directory- каталог;
• ExistingFiles - произвольное количество существующих файлов. Несколько фай
лов можно выбрать, удерживая нажатой клавишу <Ctrl>;
♦ setOption (<Опция> [, on=True] ) - если во втором параметре указано значение True,
указанная в первом параметре опция будет уста»овлена, а если False - сброшена.
В первом параметре можно указать следующие элементы перечисления option из класса
QFileDialog (здесь приведены только основные - полный их список можно найти на
странице https://doc.qt.io/qt-6/qfiledialog.html#Option-enum):
• ShowDirsOnly - отображать только имена каталогов. Опция работает лишь при ис
пользовании типа выбираемых элементов Directory;
• DontConfirmOVerwrite - не спрашивать разрешения на перезапись существующего
файла;
• ReadOnly- режим только для чтения;
• HideNameFilterDetails - скрывает детали фильтра;
654 Часть 11. Библиотека PyQt б
♦ setOptions(<Опции>) - устанавливает сразу несколько опций;
♦ setDirectory() - задает отображаемый каталог. Форматы метода:
setDirectory(<Пyть>)
setDirectory(<Kaтaлoг QDir>)
♦ 'ctirectory() - возвращает объект класса QDir с путем к отображаемому каталогу;
♦ setDirectoryUrl(<Путь QUrl>) - задае.т отображаемый каталог в виде объекта класса
QUrl ИЗ модуля QtCore:
dialog.setDirectoryUrl(QtCore.QUrl.fromLocalFile("C:\\book"))
♦ directoryUrl() -возвращает объект класса QUrl с путем к отображаемому каталогу;
♦ setNameFilter(<Фильтp>) -устанавливает фильтр. Чтобы установить несколько фильт
ров, необходимо указать их через две точки с запятой, например:
dialog.setNameFilter("All (*);; Images (*.png *. jpg)")
♦ setNameFilters(<Список фильтров>) -устанавливает сразу несколько фильтров:
dialog.setNameFilters(["All (*)", "Images (*.png *.jpg)"])
♦ selectFile(<Имя файла>) -выбирает указанный файл;
♦ selectUrl(<Путь QUrl>) -выбирает файл, путь к которому указан в виде объекта клас
са QUrl;
♦ selectedFiles() -возвращает список с выбранными файлами;
♦ selectedUrls() -возвращает список объектов класса QUrl, представляющих выбранные
файлы;
♦ setDefaultSuffix(<Расширение>) -задает расширение, которое добавляется к файлу без
явно указанного расширения;
♦ setHistory(<Список>) - задает список истории;
♦ setSidebarUrls(<Список каталогов QUrl>) -задает список каталогов, отображаемый на
боковой панели окна:
dialog.setSidebarUrls( (QtCore.QUrl.fromLocalFile("С:\ \book"),
QtCore.QUrl.fromLocalFile("C:\\book\\eclipse")])
♦ setLaЬelText(<Тип надписи>, <Текст>) -позволяет изменить текст указанной надписи.
В первом параметре указываются следующие элементы перечисления DialogLabel из
класса QFileDialog:
• Lookin -надпись слева от списка с каталогами;
• FileName - надпись слева от поля с именем файла;
• FileType -надпись слева от списка с типами файлов;
• Accept - надпись на кнопке, нажатие которой приведет к подтверждению действия
(по умолчанию Open или Save);
• Reject -надпись на кнопке, нажатие которой приведет к отказу от действия (по
умолчанию Cancel);
♦ savestate() - возвращает объект класса QByteArray с текущими параметрами диалого
вого окна;
Глава 27. Диалоговые окна 655
♦ restoreState(<Объект QByteArray>) - восстанавливает параметры диалогового окна из
заданного объекта и возвращает True, если восстановление прошло успешно, и False -
в противном случае.
Класс QFileDialog поддерживает следующие сигналы:
♦ currentChanged(<Путь>) - генерируется при выборе другого файла. Внутри обработчи
ка через параметр доступен путь к выбранному файлу в виде строки;
♦ currentUrlChanged(<Пyть QUrl>) - генерируется при выборе другого файла. Внутри
обработчика через параметр доступен путь к выбранному файлу;
♦ directoryEntered(<Пyть>) - генерируется при выборе другого каталога. Внутри обра
ботчика через параметр доступен путь к выбранному каталогу в виде строки;
♦ directoryUrlEntered(<Путь QUr 1>) - генерируется при выборе другого каталога. Внут
ри обработчика через параметр доступен путь к выбранному каталогу;
♦ fileSelected(<Пyть>) - генерируется при выборе файла и подтверждении выбора.
Внутри обработчика через параметр доступен путь к выбранному файлу в виде строки;
♦ filesSelected(<Список путей>) - генерируется при выборе нескольких файлов и под
тверждении выбора. Внутри обработчика через параметр доступен список с путями
к выбранным файлам, заданными в виде строк;
♦ urlSelected(<Путь QUr 1>) - генерируется при выборе файла и подтверждении выбора.
Внутри обработчика через параметр доступен путь к выбранному файлу;
♦ urlsSelected(<Cпиcoк riутей QUrl>) - генерируется при выборе нескольких файлов и
подтверждении выбора. Внутри обработчика через параметр доступен список с путями
к выбранным файлам;
♦ filterSelected(<Фильтр>) - генерируется при выборе другого фильтра. Внутри обра
ботчика через параметр доступен выбранный фильтр в виде строки.
27.5.2. Окно для выбора каталога
Помимо рассмотренных методов, класс QFileDialog поддерживает несколько статических
методов, реализующих типовые диалоговые окна.
Окно для выбора каталога реализуется с помощью статических методов
getExistingDirectory() и getExistingDirectoryUrl(). Форматы методов:
getExistingDirectory( [parent=None] [, caption=""] [, directory=""] [,
options=Options.Show[?i,rsOnly])
getExistingDirectoryUrl( [parent=None] [, caption=""] [, directory=QUrl()] [,
options=Options .ShowDirsOnly])
В параметре parent указывается ссьmка на родительское окно или значение None. Необяза-
телъный параметр directory задает текущий каталог, а параметр options устанавливает
опции (см. описание метода setOption() в разд. 27. 5.1). Метод getExistingDirectory()
возвращает выбранный каталог или пустую строку, а метод getExistingDirectoryUrl() -
объект класса QUrl с выбранным путем или пустой объект. Пример:
dirNarne = QtWidgets.QFileDialog.getExistingDirectory(parent=window,
directory=QtCore.QDir.currentPath())
656 Часть 11. Библиотека PyQt 6
dir QtWidgets.QFileDialog.getExistingDirectoryUrl(parent=window,
=
directory=QtCore.QUrl.fromLocalFile(QtCore.QDir.currentPath()))
dirName = dir.toLocalFile()
Результат выполнения этого кода показан на рис. 27.10.
!iJ Выбор папки х
t , 1. " Python 3 и PyQt 6 Разработка приложений ) Материалы V U Р Поиск: Матерiылы
Упорядочить • Новая папка
, ); 14, Искл, " Имя Размер
;1 15, Итер,
Нет элемснюв, удовлетворяющих уаювиям rюиска.
'i 16, Рабо-
! 17, Рабо-
) 18, Знак,
1 19. Окна
]: 20, Обра
J 21, Разм,
l 27, Диал,
>
Папка: 11
Выбор папки,
Рис. 27.10.-Окно для выбора каталога
27.5.3. Окно для открытия файлов
Окно для открытия одного файла реализуется с помощью статических методов
getOpenFileName() и getOpenFileUrl(). Форматы методов:
getOpenFileName( [parent=None] [, caption=""] [, directory=""] [, filter=""] [,
initialFilter=' '] [, options=O])
getOpenFileUrl( [parent=None] [, caption='"'] [, directory=QUrl()] [, filter=""] [,
initialFilter=' '] [, options=O])
В параметре parent указывается ссьшка на родительское окно или значение None. Необяза
тельный параметр caption задает текст заголовка окна, параметр directory - текущий
каталог, параметр filter - фильтр, параметр initialFilter - фильтр, который будет вы
бран изначально, а параметр options устанавливает опции (см. описание метода
setOption() в разд. 27. 5. 1). Метод getOpenFileName() возвращает кортеж из двух элементов:
первым элементом будет выбранный файл или пустая строка, вторым - выбранный
Глава 27. Диалоговые окна 657
фильтр. Метод getOpenFileUrl() также возвращает кортеж из двух элементов: первый -
объект класса QUrl с путем выбранного файла или пустой объект, второй- выбранный
фильтр. Примеры:
file QtWidgets.QFileDialog.getOpenFileName(parent=window,
=
сарtiоn="Заголовок окна", directory="c:\\python310",
filter="All (*);;Exes (*.ехе *.dll)",
initialFilter="Exes (*.ехе *.dll)")
fileName = file[O]
file = QtWidgets .QFileDialog .getOpenFileUrl(parent=window,
сарtiоn="Заголовок окна",
directory=QtCore.QUrl("file:///c:\\pythonЗlO"),
filter="All (*);;Exes (*.ехе *.dll)",
initialFilter="Exes (*.ехе *.dll)")
fileName = file[O] .toLocalFile()
Результат выполнения кода из последнего примера показан на рис. 27.11.
[jJ Заголовок окна х
t > Этот компьютер > System ((:) > PythonЗ 1 О > V t) /) Поиск: Python31 О
Упорядочить • Новая папка
:& Владимир Дрон "' Имя Размер
■
_..,. Этот компьюте�
видео
� Документы
Dlls
Doc
include
.J, Загрузки i: lib
� Изображения libs
Scripts
J, Му з ыка
tcl
::J Объемные itf:.·
t Tools
8 Рабочий аол
Р python.exe 97 К
• System (С:)
5-' pythonw.exe 95 К
$WinREAgen1
§;) python3.dll 61 К
book l� python31O.dll 4367К
OneDrfVeTem L� vcruntime140.dll 95 К
J Program Files � vcruntime140_1.dll 37 К
1, Program Files
ProgramData
>
Имя файла: 1
�-------------------�
Qncpьm.
Рис. 27.11. Окно для открытия файла
Окно для открытия произвольного количества файлов реализуется с помощью статических
методов getOpenFileNames() и getOpenFileUrls(). Форматы методов:
getOpenFileNames( [parent=None] [, caption=""] [, directory=""] [, filter=""] [,
initialFilter= ' '] [, options=OJ)
658 Часть //. Библиотека PyQt б
getOpenFileUrls([parent=None] [, caption=""][, directory=QUrl()][,filter=""] [,
initialFilter= ' '][, options=O])
Меtод getOpenFileNames() возвращает кортеж из двух элементов: первый - список с путя
ми к выбранным файлам или пустой список, второй - выбранный фильтр. Метод
getOpenFileUrls() также возвращает кортеж из двух элементов: первый - список объектов
класса QUrl с путями к выбранным файлам или пустой список, второй - выбранный
фильтр. Примеры:
arr QtWidgets.QFileDialog.getOpenFileNames(parent=window,
=
сарtiоn= "Заголовок окна", directory="c:\\python310",
filter="All (*);;Exes (*.ехе *.dll)",
initialFilter="Exes (*.ехе *.dll)")
files = arr[O]
arr = QtWidgets.QFileDialog.getOpenFileUrls(parent=window,
сарtiоn="Заголовок окна",
directory=QtCore.QUrl("file:///c:\\pythonЗlO"),
filter="All (*);;Exes (*.ехе *.dll)",
initialFilter="Exes (*.ехе *.dll)")
files list(a.toLocalFile() for а in arr[O])
27 .5.4. Окно для сохранения файла
Окно для сохранения файла реализуется статическими методами getsaveFileName() и
getSaveFileUrl(). Форматы методов:
getSaveFileName([parent=None][, caption=""][, directory=""][, filter=""] [,
initialFilter= ' '] [, options=O])
getSaveFileUrl([parent=None][, caption=""] [, directory =QUrl()][,filter=""] [,
initialFilter= ' '][, options=O])
В параметре parent указывается ссылка на родительское окно или значение None. Необяза
тельный параметр caption задает текст заголовка окна, параметр directory - текущий
каталог, параметр filter - фильтр, параметр initialFilter - фильтр, который будет вы
бран изначально, а параметр options устанавливает опции (см. описание метода
setOption() в разд. 27.5. 1). Метод getSaveFileName() возвращает кортеж из двух элементов:
первым элементом будет выбранный файл или пустая строка, вторым - выбранный
фильтр. Метод getSaveFileUrl() также возвращает кортеж из двух элементов: первый
объект класса QUrl с путем выбранного файла или пустой объект, второй- выбранный
фильтр. Примеры:
f QtWidgets.QFileDialog.getSaveFileName(parent=window,
=
сарtiоn="Заголовок окна", directory=QtCore.QDir.currentPath(),
filter="All (*);;Python Code (*.ру *.pyw)")
fileName = f[O]
f = QtWidgets.QFileDialog.getSaveFileUrl(parent=window,
сарtiоn="Заголовок окна",
directory=QtCore.QUrl("file:///" + QtCore.QDir. currentPath()),
filter="All (*);;Python-Code (*.ру *.pyw)")
fileName = f[O].toLocalFile()
Результат выполнения кода из последнего примера показан на рис. 27.12.
Глава 27. Диалоговые окна 659
[i] Заголовок окна х
1' · ' « Python 3 и PyQt 6 Разработк� приложений > Материалы Р Поиск: Материалы
Упо рядочить • Новая папка
,. 16, Работа с файл " Имя Разм "'
1 17. Работа с меха
iJI test.py
1 18. Знакомство с � 22.1.pyw
1 19. Окна �.- 22.2.pyw
" 20. Обработка си [� 22.3.pyw
� 21. Размещение Jc Ё? 22.4.руw
i 22. Основные ко1 � 22.5.pyw
�- 22.6.pyw
23. Сnиски и табл
�- 22,7,pyw
,, 24. Работа с база,
� 23.2.pyw
1 25. Работа с граф
1:? 23.З.руw
J 26. Графическая ,, � 24.2,pyw
t 27. Диалоговые с [ill 27.1.pyw
-� FTP f? 27.2.pyw
1. Договор [!'1 27.3.pyw
,.. Скрыть папки Соwанитъ
,d
Рис. 27.12. Окно для сохранения файла
27 .6. Окно для выбора цвета
Окно для выбора цвета (рис. 27 .13) реализуется с помощью статического метода getColor( )
класса QColorDialog. Формат метода:
getColor( [initial=GlobalColor.white] [, parent=None] [, title= ""] [, options=0])
Параметр initial задает начальный цвет. В параметре parent указывается ссылка на роди
тельское окно или значение None. Параметр title позволяет указать заголовок окна. В па
раметре options могут быть указаны следующие элементы (или их комбинация) перечис
ления ColorDialogOption из класса QColorDialog:
♦ ShowAlphaChannel - пользователь может выбрать значение прозрачности;
♦ NoButtons-кнoпки ОК и Cancel не отображаются;
♦ DontUseNativeDialog - использовать встроенное в библиотеку Qt диалоговое окно
выбора цвета вместо системного.
Метод возвращает объект класса QColor, представляющий выбранный цвет. Если пользова
тель нажмет кнопку Cancel, возвращенный объект будет невалидным. Пример:
color = QtWidgets.QColorDialog.getColor(initial=QtGui.QColor("#ff0000"),
parent=window, titlе="Заголовок окна",
options=QtWidgets.QColorDialog.ColorDialogOption.ShowAlphaChannel)
660 Часть 11. Библиотека PyQt 6
IJ Заголовок окна х
!!asic colors
нuо· Го�
�• c___L'!:.�
�
.Веd: 1255 L-:'Ji
�at: ��Ш lo__
§гееn: ЯJi
г-:
!:;ustom colors
г··1 г···i г1 г··J г·1 ГJ .\lal: !25_�lft Bl.ue: !�--- [ij
[] [J [J [.J ГJ A!pha channel: !шТ�
г: · • ·.
!-,.....___,:.:;;;;-.;,;:_,
Дd� t� � ol rs ·- .· �· 1
Custo C o !:!TML: !#ffOooo-----�
Рис. 27.13. Окно для выбора цвета
if color.isValid():
print(color.red(), color.green(), color.Ыue(), color .alpha()).
27.7. Окно для выбора шрифта
Окно для выбора шрифта реализуется с помощью статического метода getFont() класса
QFontDialog. Форматы метода:
getFont( [parent=None])
getFont(<Шрифт QFont> [, parent=None] [, caption=""] [, options=O])
Первый параметр во втором формате задает начальный шрифт. В параметре parent указы
вается ссылка на родительское окно или значение None. Параметр caption позволяет указать
заголовок окна. В параметре options могут быть указаны следующие элементы перечисле
ния FontDialogOption из класса QFontDialqg или их комбинация:
♦ NoButtons - кнопки ОК и Cancel не отображаются;
♦ DontUseNativeDialog - использовать встроенное в библиотеку Qt диалоговое окно
выбора шрифта вместо системного;
♦ ScalaЫeFonts - показать только масштабируемые шрифты;
♦ NonScalaЫeFonts - показать ТQЛЬКО немасштабируемые шрифты;
♦ MonospacedFonts·- показать только моноширинные шрифты;
♦ ProportionalFonts - показать только пропорциональные шрифты.
Глава 27. Диалоговые окна 661
Метод возвращает кортеж из двух элементов: (<Выбранный шрифт>, <Статус>). Если второй
элемент содержит значение True, первый элемент хранит объект класса QFont с выбра1rnым
шрифтом. Пример:
(font, ok) = QtWidgets.QFontDialog.getFont(QtGui.QFont("Tahoma", 16),
parent=window, сарtiоn= "Заголовок окна")
if ok:
print(font.family(), font.pointSize(), font.weight(),
font.italic(), font.underline())
Результат выполнения этого кода показан на рис. 27.14.
i] Заголовок окна х
F ont �---------- fon��txf_e ____ �ize
"" = = = �
1j 16
!,
.,,lli=
ft•=
j.= @j'-------------< обы_��ы ". .. . ••··
ii,= , ..
Sitka Subheading "
,., Q���':!!Й-� ·
1
8
Sitka Text Полужирный 9
Small Fonts 10
1
Sylfaen 11
12
gi!
1
��:::' �. f
Tahoma "!
------------�' �-------� �---�
�1 __ 1
Нfects Sample
О Stri!\eout
1
О !J.nderline
д_а_вь_v_у_2z.__
1 i Cancel j
Рис. 27 .14. Окно для выбора шрифта
27.8. Окно для вывода сообщения об ошибке
Класс QErrorMessage реализует немодальное диалоговое окно с сообщением об ошибке
(рис. 27.15). Окно содержит надпись с собственно сообщением и флажок. Если пользова
тель снимает флажок, окно больше отображаться не будет. Иерархия наследования для
класса QErrorMessage выглядит так:
(QObject, QPaintDevice) - QWidget - QDialog - QErrorMessage
Формат конструктора класса QErrorMessage:
QErrorMessage( [parent=None] )
Для отображения окна предназначен метод showМessage (). Форматы его вызова:
showМessage(<Teкcт сообщения>)
showМessage(<Teкcт сообщения>, <Тип>)
Если пользователь установил флажок и тип сообщения не был задан, то все последующие
сообщения об ошибках не будут выводиться на экран. Если же был указан тип сообщения
662 Часть 11. Библиотека PyQt 6
(в виде строки), то не будут выводиться лишь сообщения того же типа. Оба формата метода
являются слотами. Пример:
ems = QtWidgets.QErrorMessage(parent=window)
ems.showMessage("Cooбщeниe об ошибке")
ems.showMessage("Cooбщeниe об ошибке типа warning", "warning")
iU pythonw Х
о Сообщение об ошибке
0 Show this message again
QK
Рис. 27.15. Окно для вывода сообщения об ошибке
27.9. Окно с индикатором хода процесса
Класс QProgressDialog реализует диалоговое окно с индикатором хода процесса и кнопкой
Cancel (рис. 27.16). Иерархия наследования для класса QProgressDialog выглядит так:
(QObject, QPaintDevice) - QWidget - QDialog - QProgressDialog
iu Выполнение операции х
Выполняется операция
30%
1 Отмена
Рис. 27.16. Окно с индикатором хода процесса
Форматы конструктора класса QProgressDialog:
QProgressDialog([parent=None] [, flags=O] )
QProgressDialog(<Teкcт над индикатором>, <Текст на кнопке Cancel>,
<Минимум>, <Максимум>[, parent=None] [, flags=O])
Значения минимума и максимума должны быть заданы в виде целых чисел. Если в парамет
ре parent указана ссьшка на родительское окно, диалоговое окно будет центрироваться от
носительно родительского окна, а не экрана. Параметр flags задает 'тип окна (см.разд. 19.1.1).
Класс QProgressDialog наследует все методы базовых классов и дополнительно определяет
следующие методы (здесь приведены только основные - полный их список можно найти
на странице https://doc.qt.io/qt-6/qprogressdialog.html):
♦ setValue(<Значение>) - задает новое значение индикатора, которое должно представ
лять собой целое число. Если диалоговое окно является модальным, при установке зна-
Глава 27. Диалоговые окна 663
чения автоматически вызывается метод processEvents() объекта программы. Метод явля
ется слотом;
♦ value () - возвращает текущее значение индикатора в виде целого числа;
♦ setLabelText(<Текст>) - задает текст надписи, выводимой над индикатором. Метод
является слотом;
♦ setCancelButtonтext(<Текст>) - задает текст, выводимый на кнопке Cancel. Метод
является слотом;
♦ setRange(<Минимум>, <Максимум>) , setMinimum(<Минимум>) И setMaximum(<Максимум>) -
задают минимальное и максимальное значения в виде целых чисел. Если оба значения
равны нуmо, то внутри индикатора будут постоянно по кругу перемещаться сегменты,
показывая ход выполнения процесса с неопределенным количеством шагов. Методы
являются слотами;
♦ setMinimumDuration(<Значение>) - устанавливает промежуток времени в миллисекун
дах перед отображением окна (задается целым числом- значение по умолчанmо 4000).
Окно может быть отображено ранее этого срока при установке значения индикатора.
Метод является слотом;
♦ reset() - сбрасывает значение индикатора. Метод является слотом;
♦ cancel() - имитирует нажатие кнопки Cancel. Метод является слотом;
♦ setLabel(<Надп11сь QLabel>) - заменяет объект надписи на заданный;
♦ setвar(<Индикатор QProgressBar>) -заменяет объект индикатора на заданный;
♦ setCancelButton(<КНопка QPushButton>) - заменяет объект кнопки Cancel на заданный;
♦ setAutoClose(<Флаг>) - если в качестве параметра указано значение True, при сбросе
значения окно скрывается;
♦ setAutoReset(<Флаг>) - если в качестве параметра указано значение True, при дости-
жении максимального значения будет автоматически произведен сброс;
♦ wasCanceled() - возвращает значение True, если была нажата кнопка Cancel.
Класс QProgressDialog поддерживает сигнал canceled(), который генерируется при нажа-
тии кнопки Cancel.
27.1 О. Создание многостраничного мастера
PyQt позволяет создать мастер- диалоговое окно, в котором при нажатии кнопок Back
(Назад) и Next (Далее) последовательно или в произвольном порядке отображаются раз
личные страницы. Класс QWizard реализует контейнер для страниц, а отдельная страница
описывается классом QWizardPage.
27.10.1. Класс QWizard
Класс QWizard реализует сам мастер- набор страниц, отображаемых последовательно или
в произвольном порядке. Иерархия наследования для него выглядит так:
(QObject, QPaintDevice) - QWiQget - QDialog - QWizard
Формат конструктора класса QWizard:
QWizard( [parent=None] [, flags=0])
664 Часть 11. Библиотека PyQt 6
Помимо унаследованных методов, класс QWizard поддерживает следующие (здесь приведе
ны только основные - полный их список можно найти на странице https://doc.qt.io/qt-6/
qwizard.html):
♦ addPage(<Страница QWizardPage>) - добавляет заданную страницу в конец мастера и
возвращает ее целочисленный идентификатор;
♦ setPage(<Идентифи·катор>, <Страница QWizardPage>) - добавляет заданную страницу
в позицию, обозначенную указанным идентификатором;
♦ removePage(<Идентификатор>) - удаляет страницу с указанным идентификатором;
♦ page(<Идентификатор>) - возвращает ссылку на страницу (объект класс\! QWizardPage),
соответствующую указанному идентификатору, или значение None, если такой страницы
не существует;
♦ pageids() - возвращает список-с идентификаторами страниц;
♦ currentid() - возвращает идентификатор активной страницы;
♦ curre�tFage() - возвращает ссылку на активную страницу (объект класса QWizardPage)
или None, если страницы не существует (что может случиться, если мастер еще не вьmе
ден на экран));
♦ sеtstаrtld(<Идентификатор>) - задает идентификатор начальной страницы: По умол
чанию начальной станет страница с наименьшим идентификатором;
♦ startid () - возвращает идентификатор начальной страницы или -1, если страниц
в мастере нет;
♦ visitedids() - возвращает список с идентификаторами посещенных страниц или пус
той список;
♦ hasVisitedPage (<Идентификатор>) - возвращает значение True, если страница с указан-
ным идентификатором бьша посещена, и False - в противном случае;
♦ back() - имитирует нажатие кнопки Back. Метод является слотом;
♦ next() - имитирует нажатие кнопки Next. Метод является слотом;
♦ restart() - перезапускает мастер. Метод является слотом;
♦ nextid(self) - этот метод следует переопределить в классе, наследующем класс
QWizard, если необходимо изменить порядок- отображения страниц. Метод -вызывается
при нажатии кнопки Next и должен возвращать идентификатор следующей страницы
или значение -1, если текущая страница - последняя;
♦ initializePage(self, <Идентификатор>) - этот метод следует переопределить в классе,
наследующем QWizard, ес:ли необходимо производить настройку свойств компонентов на
очередной странице на основе данных, введенных на предыдущих страницах. Метод вы
зывается при нажатии кнопки Next на активной странице, но до отображения следую
щей страницы. Если установлена опция IndependentPages, метод вызывается только при
первом отображении страницы;
♦ cleanupPage(self, <Идентификатор>) - этот метод следует переопределить в классе,
наследующем QWizard, если необходимо выполнять какие-либо завершающие действия
перед переходом на предыдущую страницу после нажатия кнопки Back. Метод вызыва
ется при нажатии кнопки Back на актицной странице, но до отображения предыдущей
страницы. Если установлена опция IndependentPages, метод не вызывается;
Глава 27. Диалоговые окна 665
♦ validatecurrentPage(self) - этот мет0д следует переопределить в классе, наследую
щем QWizard, если необходимо проверять данные, введенные на активной странице.
Метод вызывается при нажатии кнопки Next или Finish. Метод должен вернуть значе
ние True, если данные корректны, и False - в противном случае. Если метод возвраща-·
ет значение False, переход на-следующую страницу не производится;
♦ setField (<Свойство>, <Значение>) - устанавливает значение указанного свойства.
Создание свойства производится с помощью метода registerField () класса
QWizardPage. Используя метод setField(), можно изменять значения компонентов, рас
положенных на разных страницах мастера;
♦ fiеld(<Свойство>) - возвращает значение указанного свойства. Используя этот метод,
также можно получить значения компонентов, расположенных на разных страницах
мастера;
♦ setWizardStyle(<Стиль>) - задает стилевое оформление мастера. В качестве параметра
указываются следующие элементы перечисления Wizarctstyle из класса QWizard:
• Classicstyle - классическое в стиле Windows;
•· ModernStyle - современное в стиле Windows;
• мacStyle - в стиле macOS;
• · AeroStyle - в стиле Windows Aero;
♦ setTitleFoпnat(<Формат>) - задает формат отображения названия страницы. В качестве
параметра указываются следующие элементы перечисления тextFoпnat из модуля
QtCore.Qt:
• PlainText - простой текст;
• Richтext - текст, отформатированный НТМL-тегами;
• Autoтext - автоматическое определение (режим по умолчанию). Если текст содер
жит НТМL-теги, то используется режим RichText, в противном случае - режим
PlainText;
• мarkdownтext - текст, отформатированный Markdown-тeraми;
♦ setSuЬTitleFoпnat (<Формат>) - задает формат отображения описания страницы. До
пустимые значения см. в описании метода setTitleFoпnat ();
♦ setButton (<Роль>, <КНопка QAЬstractButton>) - добавляет кнопку для указанной роли.
В первом параметре указываются следующие элементы перечисления WizardВutton из
класса QWizard:
• BackButton - кнопка Back;
• NextButton - кнопка Next;
• CoпmitButton - кнопка Commit;
• FinishButton - кнопка Finish;
• CancelButton - кнопка Cancel (если установлена опция NoCancelButton, кнопка не
отображается);
• HelpButton - кнопка Help (чтобы отобразить кнопку, необходимо установить опцию
HaveHelpButton);
• customВuttonl - первая пользовательская кнопка (чтобы отобразить кнопку, необ
ходимо установить опцию HaveCustomВuttonl);
666 Часть 11. Библиотека PyQt б
• customВutton2 - вторая пользовательская кнопка (чтобы отобразить кнопку, необхо
димо установить опцmо HaveCustomВutton2);
• customВuttonЗ - третья пользовательская кнопка (чтобы отобразить кнопку, необхо-
димо установить опцmо HaveCustomВuttonЗ);
♦ button (<Роль WizardButton>) - возвращает ссылку на кнопку с указанной_ ролью;
♦ setButtonText (<Роль WizardВutton>, <Текст надписи>) - устанавливает текст надписи
для кнопки с указанной ролью;
♦ buttonтext(<Роль WizardВutton>) - возвращает текст надписи кнопки с указанной ролью;
♦ setButtonLayout(<Список с ролями WizardButton>) - задает порядок отображения кно
пок. В качестве параметра указывается список с ролями кнопок. Список также может
содержать значение элемента Stretch перечисления WizardВutton из класса QWizard, ко
торый создает растягивающееся свободное пространство между кнопками;
♦ setPixrnap(<Роль>, <Изображение QPixmap>) - добавляет изображение для указанной
роли. В первом параметре указываются следующие элементы перечисления WizardPixmap
из класса QWizarct:
• watermarkPixmap - изображение, которое занимает всю левую сторону страницы при
использовании стилей ClassicStyle и ModernStyle;
• LogoPixmap - небольшое изображение, отображаемое в правой части заголовка при
использовании стилей ClassicStyle и ModernStyle;
• BannerPixmap - фоновое изображение, отображаемое в заголовке страницы при ис
пользовании стиля ModernStyle;
• BackgroundPixmap - фоновое изображение при использовании стиля Macstyle;
♦ setOption(<Oпция>[, on=True]) - если во втором параметре указано значение True, за
данная в первом параметре опция будет установлена, а если указано значение False -
сброшена. В первом параметре указываются следующие элементы перечисления
WizardOption из класса QWizard:
• Independentpages - страницы не зависят друг от друга. В этом случае метод
initializePage () будет вызван только при первом отображении страницы, а метод
cleanupPage () не вызьmается;
• IgnoreSuЬTitles - це отображать описания страниц в заголовке;
• ExtendedWatermarkPixmap - изображение с ролью WatermarkPixmap будет занимать
всю левую сторону страницы вплоть до нижнего края окна;
• NoDefaultвutton - не делать кнопки Next и Finish кнопками по умолчанию;
• NoBackButtononstartPage - не отображать кнопку Back на стартовой странице;
• NoBackButtonOnLastPage - не отображать кнопку Back на последней странице;
• DisaЫedBackButtonOnLastPage - сделать кнопку Back неактивной на последней
странице;
• HaveNextвuttonOnLastPage - показать неактивную кнопку Next на последней стра
нице;
• нaveFinishButtonOnEarlyPages - показать неактивную кнопку Finish на непослед
них страницах;
Глава 27. Диалоговые окна 667
• NoCancelButton - не отображать кнопку Cancel;
• cancelВuttonOnLeft - поместить кнопку Cancel слева от кнопки Back (по умолча-
нию кнопка Cancel расположена справа от кнопок Next и Finish);
• HaveHelpButton - показать кнопку Help;
• HelpButtonOnRight - поместить кнопку Help у правого края окна;
• HaveCustomВuttonl - показать пользовательскую кнопку с ролью CustomВuttonl;
• нaveCustomВutton2 -показать пользовательскую кнопку с ролью customВutton2;
• HaveCustomВuttonЗ -показать пользовательскую кнопку с ролью customВuttonЗ;
• NoCancelButtonOnLastPage - не показывать кнопку Cancel на последней странице;
♦ setOptions(<Опции>) - устанавливает сразу несколько опций;
♦ setSideWidget(<Компонент>) - устанавливает заданный компонент в левую часть мас
тера. Если используется стиль ClassicStyle или ModernStyle, компонент будет выведен
выше изображения с ролью WaterrnarkPixmap.
Класс QWizard поддерживает следующие сигналь�:
♦ currentidChanged(<Идeнтификaтop>) -генерируется, когда активной становится другая
страница. Внутри обработчика через параметр доступен целочисленный идентификатор
новой активной страницы;
♦ customВuttonClicked(<Роль>) генерируется при нажатии кнопок с ролями
customВuttonl, customВutton2 и customВuttonЗ. В параметре доступна целочисленная
роль нажатой кнопки;
♦ helpRequested() - генерируется при нажатии кнопки Help;
♦ pageAdded(<Идентификатор>) - генерируется при добавлении страницы. В параметре
передается целочисленный идентификатор добавленной страницы;
♦ раgеRеmоvеd(<Идентификатор>) - генерируется при удалении страницы. В параметре
передается целочисленный идентификатор удаленной страницы.
27.10.2. Класс QWizardPage
Класс QWizardPage описывает одну страницу в мастере. Его иерархия наследования такова:
(QObject, QPaintDevice) - QWidget' - QWizardPage
Формат конструктора класса QWizardPage:
QWizardPage( [parent=None])
Класс QWizardPage наследует �се методы базовых классов и, помимо них, поддерживает
также следующие методы (здесь приведены только основные - полный их список можно
найти.на странице https://doc.qt.io/qt-6/qwizardpage.html):
♦ wizard() - возвращает ссылку на мастер (объект класса QWizard) или значение None,
если страница не была добавлена в какой-либо мастер;
♦ setтitle(<Текст>) - задает название страницы;
♦ title() - возвращает название страницы;
♦ setSuЬTitle(<Текст>) -задает описание страницы;
668 Часть 11. Библиотека PyQt 6
♦ suЬTitle () - возвращает описание стра1ШЦЬ1;
♦ setButtonText(<Роль>, <Текст надписи>) - устанавливает текст надписи для кнопки
с указанной ролью (допустимые значения параметра <Роль> см. в описании метода
setButton() класса QWizard в разд. 27.10.1);
♦ buttonтext (<Роль>) - возвращает текст надписи кнопки с указанной ролью;
♦ setpixrnap(<Роль>, <Изобрf'Кение QPixrnap>) - добавляет изображение для указанной
роли (допустимые значения параметра <Роль> см. в описании метода setPixrnap() класса
QWizard вpaзд. 27.10.1);
♦ registerField() - регистрирует свойство, с помощью которого можно получить доступ
к значению компонента с любой страницы мастера. Формат метода:
registerField(<Cвoйcтвo>, <Компонент>[, property=None] [, changedSignal=O])
В параметре <Свойство> указывается произвольное имя свойства в виде строки. Если
в конце строки указать символ *, компонент должен обязательно иметь значение (на
пример, в поле должно быть введено какое-либо значение), иначе кнопки Next и Finish
будут недоступны. Во втором параметре указывается ссылка. на компонент, связьmае
мый со свойством. После регистрации свойства изменить значение связанного с ним
компонента позволяет метод setField(), а получить значение - метод field().
В параметре property может быть указано свойство компонента для получения и изме
нения значения, а в параметре changedSignal - сигнал, генерируемый при изменении
значения.
Назначить эти параметры для определенного класса позволяет также метод
setDefaultProperty(<Имя класса>, property, changedSignal) класса QWizard. Для стан
дартных классов по умолчанию используются следующие свойства и сигналы
(табл. 27: 1).
Таблица 27.1. Свойства и сигналы,
-используемые по умолчанию для стандартных классов
Класс Свойство Сигнал
QAЬstractButton checked toggled()
QAЬstractSlider value valueChanged()
QComЬoBox currentlndex currentlndexChanged()
QDateTimeEdit dateTime dateTimeChanged()
QLineEdit text textChanged()
QListWidget currentRow currentRowChanged()
QSpinBox value valueChanged()
♦ setField(<Свойство>, <Значение>) - устанавливает значение указанного свойства.
С помощью этого метода можно изменять значения компонентов, расположенных на
разных страницах мастера;
♦ field(<Свойство>) - возвращает значение указанного свойства. С помощью этого
метода можно получать значения компонентов, расположенных на разных страницах
мастера;
Глава 27. Диалоговые окна 669
♦ setFinalPage (<Флаг>) - если в качестве параметра указано значение True, текущая
страница станет последней, и на ней будет отображаться кнопка Finish;
♦ isFinalPage () - возвращает значение True, если текущая страница является последней,
и False - в противном случае;
♦ setCon-пnitPage (<Флаг>) - если в качестве параметра указано значение True, на странице
будет отображаться кнопка Commit;
♦ isCommitPage () - возвращает значение True, если на странице отображается кнопка
Commit, и False - в противном случае;
♦ is_Cornplete (self) -этот метод вызывается, чтобы определить, должны ли кнопки Next
и Finish быть доступными (метод возвращает значение True) или недоступными (метод
возвращает значение False). Метод можно переопределить в классе, наследующем класс
QWizardPage, и реализовать собственную проверку правильности ввода данных. При из
менении возвращаемого значения необходимо генерировать сигнал cornpleteChanged ();
♦ nextld (self) -этот метод следует переопределить в классе, наследующем QWizardPage,
если необходимо изменить порядок отображения страниц. Метод вызывается при нажа
тии кнопки Next. Метод должен возвращать идентификатор следующей страницы или
значение -1, если текущая страница - последняя;
♦ initializePage (self) - этот метод следует переопределить в классе, наследующем
QWizardPage, если необходимо производить настройку свойств компонентов на текущей
странице на основе данных, введенных на предыдущих страницах. Метод вызывается
при нажатии кнопки Next на предыдущей странице, но до отображения текущей страни
цы. Если установлена опция IndependentPages, метод вызывается только при первом
отображении страницы;
♦ cleanupPage (self) - этот метод следует переопределить в классе, наследующем
QWizardPage, если необходимо выполнять какие-либо завершающие действия на текущей
странице перед переходом на предыдущую при нажатии кнопки Back. Метод вызывает
ся при нажатии кнопки Back на текущей странице, но до отображения предыдущей
страницы. Если установлена опция IndependentPages, метод не вызывается;
♦ validatePage (self) - этот метод следует переопределить в классе, наследующем
QWizardPage, если необходимо производить проверку данных, введенных на текушей
странице. Метод вызывается при нажатии кнопки Next или Finish. Метод должен вер
нуть значение True, если данные корректны, и False -в противном случае. Если метод
возвращает значение False, переход на следующую страницу не производится.
ГЛАВА 28
Создание SDI- и МDl-программ
♦ SDI-программа (Single Document Interface, однодокументный интерфейс)- может от
крыть лишь один документ. Типичные примеры: Блокнот, WordPad и Paint, поставляе
мые в составе Windows.
♦ МDI-программа (Multiple Document Interface, многодокументный интерфейс)- позво
ляет открыть произвольное количество документов, каждый - в отдельном вложенном
окне. Примером приложения такого рода является программа Adobe Photoshop.
Все рассмотренные в этой главе классы объявлены в модуле QtWidgets, если не указано
иное.
28.1. Главное окно программы
И SDI-, и МDl-программы имеют одно главное окно, в котором отображается один откры
тый документ или вложенные окна с открытыми документами. Главное окно содержит
меню, панели инструментов, прикреrmяемые панели, центральный компонент и строку со
стояния.
Главное окно реализуется классом QMainWindow. Иерархия наследования для него выглядит
так:
(QObject, QPaintDevice) - QWidget - QМainWindow
Конструктор класса QMainWindow имеет следующий формат:
QMainWindow ( [parent=None] [, flags=0])
В параметре parent указывается ссылка на родительское окно. Доступные значения пара
метра flags мы рассматривали в разд. 19.1.1.
Чтобы создать SDl-программу, следует с помощью метода setCentralWidget () класса
QМainWindow установить в главном окне какой-либо центральный компонент, отображаю
щий содержимое открытого документа.
Класс QMainWindow наследует все методы базовых классов и поддерживает следующие до
полнительные методы (здесь приведены только интересующие нас - полный их список
можно найти на странице https://doc.qt.io/qt-6/qmainwindow.html):
♦ setCentralWidget (<Компонент>) - делает указанный компонент центральным в главном
окне;
Глава 28. Создание SDI- и МО/-программ 671
♦ centralWidget () - возвращает ссылку на центральный компонент или значение None,
если таковой не был установлен;
♦ setMenuBar(<Меню QMenuвar>) - устанавливает в главном окне заданное главное меню
вместо стандартного, формируемого самим PyQt;
♦ menuBar() - возвращает ссылку на главное меню (объект класса QMenuBar);
♦ setMenuWidget(<Меню QWidget>) - устанавливает в главном окне заданное главное меню
вместо стандартного. Используется, если в главном окне требуется создать какое-либо
специфическое меню (например, не обычное горизонтальное, а вертикальное);
♦ menuWidget() - возвращает ссылку на главш)е меню (объект класса QWidget или произ
водного от него);
♦ createPopupMenu() - создает контекстное меню с пунктами, позволяющими отобразить
или скрыть панели инструментов и прикрепляемые панели, и возвращает ссылку на это
меню (объект класса QMenu). Контекстное меню по умолчанию отображается при щелчке
правой кнопкой мыши в области меню, панели инструментов или прикрепляемых пане
лей. Переопределив этот метод, можно реализовать собственное контекстное меню;
♦ setStatusBar(<Строка состояния QStatusBar>) - устанавливает в главном окне задан
ную строку состояния вместо стандартной;
♦ statusBar() - возвращает ссылку на строку состояния (объект класса QStatusBar);
♦ addToolBar() - добавляет панель инструментов. Форматы метода:
аddТооlВаr(<Панель инструментов· QToolBar>)
аddТооlВаr(<Область>, <Панель инструментов QToolBar>)
аddТооlВаr(<Название панели>)
Первый формат добавляет панель инструментов в верхнюю часть окна. Второй формат
позволяет задать местоположение панели. В качестве параметра <Область> могут быть
указаны следующие элементы перечисления тoolBarArea из модуля QtCore.Qt:
LeftToolBarArea (слева), RightToolBarArea (справа), TopToolBarArea (сверху) или
BottomToolBarArea (снизу). Третий формат создает панель инструментов с указанным
именем, добавляет ее в верхнюю область окна и возвращает ссылку на представляющий
ее объект класса QToolBar;
♦ insertToolBar(<Панель QToolBar l>, <Панель QToolBar 2>) - добавляет панель
<QToolBar 2> перед панелью <QТoolBar l>;
♦ removeToolBar ( <Панель инструментов QToolBar>) - удаляет панель инструментов из
окна и скрывает ее. При этом объект панели инструментов не удаляется и далее может
быть добавлен в другое место;
♦ toolBarArea(<Панель инструментов QToolBar>) - возвращает местоположение указан
ной панели инструментов в виде элементов LeftToolBarArea (слева), RightToolВarArea
(справа), TopToolBarArea (сверху), BottomтoolВarArea (снизу) или NoToolBarArea (поло
жение не определено) перечисления ToolBarArea из модуля QtCore.Qt;
♦ setToolButtonStyle (<Стиль>) - задает стиль кнопок на панелях инструментов. В ка
честве параметра указываются следующие элементы перечисления ToolButtonStyle из
модуля QtCore.Qt:
• ToolButtoniconOnly � только значок;
• ToolButtonTextOnly- только текст;
672 Часть 11. Библиотека PyQt 6
• тoolButtonTextBesideicon - текст справа от значка;
• ToolButtonTextUndericon - текст под значком;
• ToolButtonFollowStyle - зависит от используемого стиля;
♦ toolButtonStyle() - возвращает стиль кнопок на панелях инструментов;
♦ seticonSize(<Размеры QSize>) - задает размеры значков на кнопках в панелях инстру
ментов;
♦ iconSize() - возвращает размеры значков (объект класса QSize) на кнопках в панелях
инструментов;
♦ setAnimated(<Флaг>) - если в качестве параметра указано значение False, вставка
панелей инструментов и прикреШIЯемых панелей в новое место по окончании переме
щения будет производиться без анимации. Метод является слотом;
♦ addToolВarBreak ( [area=ТoolBarArea . TopToolBarArea]) - вставляет разрыв в указанное
параметром area место после всех добавленных ранее панелей. По умолчанию панели
добавляются друг за другом на одной сtроке. С помощью этого метода можно поместить
панели инструментов на двух и более строках;
♦ insertтoolBarBreak(<Панель инструментов QToolBar>) - вставляет разрыв перед ука
занной панелью инструментов;
♦ removeToolBarBreak(<Пaнeль инструментов QТoolBar>) - удаляет разрыв перед указан
ной панелью инструментов;
♦ toolBarBreak( <Панель инструментов QToolBar>) - возвращает значение True, если
перед указанной панелью инструментов существует разрыв, и False - в противном
случае;
♦ addDockWidget() - добавляет прикреШIЯемую панель. Форматы метода:
addDockWidget(<Oблacть>, <Панель QDockWidget>)
addDockWidget(<Oблacть>, <Панель QDockWidget>, <Ориентация>)
Первый формат добавляет прикреШIЯемую панель в указанную область окна. В качестве
параметра <Область> могут быть указаны следующие элементы перечисления
DockWidgetArea из модуля QtCore.Qt: LeftDockWidgetArea (слева), RightDockWidgetArea
(справа), TopDockWidgetArea (сверху) или BottomDockWidgetArea (снизу). Второй формат
позволяет дополнительно указать ориентацию в виде следующих элементов перечисле
ния Orientation из модуля QtCore.Qt: Horizontal или Vertical. Если указан элемент
Horizontal, добавляемая панель будет расположена справа от ранее добавленной пане
ли, а если Vertical - снизу;
♦ removeDockWidget(<Панель QDockWidget>) - удаляет заданную прикрепляемую панель
из окна и скрывает ее. При'·этом объект панели не удаляется и впоследствии может быть
добавлен в другую область;
♦ dockWidgetArea(<Панель QDockWidget>) - возвращает местоположение указанной при
крепляемой панели в виде элементов LeftDockWidgetArea (слева), RightDockWidgetArea
(справа), TopDockWidgetArea (сверху), BottomDockWidgetArea (снизу) или NoDockWidgetArea
(положение не определено) перечисления DockWidgetArea из модуля QtCore.Qt;
♦ setDockOptions(<Опции>) - устанавливает опции для прикреШIЯемых панелей. Значение
ПО умолчанию: AnimatedDocks I AllowТaЬЬedDocks. В качестве значения указывается
комбинация (через оператор 1) следующих элементов перечисления DockOption из клас
са QМainWindow:
Глава 28. Создание SDI- и МDl-программ 673
• AnirnatedDocks - вставка панелей в новое место по окончании перемещения будет
производиться с анимацией;
1
• AllowNestedDocks - в тобую область можно будет поместить несколько панелей;
'•,
• Allow'I'abbedDocks - панели накладываются одна на другую. Для перекточения меж
ду накладывающимися панелями будет использоваться панель с вкладками;
• ForceTabbedDocks - панели всегда накладываются друг на друга. При этом опция
AllowNestedDocks игнорируется;
• verticalTabs - заголовки вкладок у накладывающихся панелей будут отображаться
с внешнего края области (если область справа, то и заtоловки вкладок справа, если
область слева, то и заголовки вкладок слева, если область сверху, то и заголовки
вкладок сверху, если область снизу, то и заголовки вкладок снизу). По умолчанию
заголовки вкладок отображаются снизу. Опция AlloWТabbedDocks должна быть уста
новлена;
• GroupedDragging - при перетаскивании тобой панели все остальные панели, нало
женные на нее, будут перетаскиваться вместе с ней. Опция AlloWТabbedDocks должна
быть установлена;
ВННМАННЕ!
Опции необходимо устанавливать до добавления прикрепляемых панелей. Исключением
ЯВЛЯЮТСЯ ОПЦИИ AnimatedDocks И VerticalTabs.
♦ dockOptions () - возвращает комбинацию установленных опций прикрепляемых па
нелей;
♦ setDockNestingEnaЫed (<Флаг>) - если указано значение True, опция AllowNestedDocks
будет установлена, а если указано значение False - сброшена. Метод является слотом;
♦ isDockNestingEnaЫed () - возвращает значение True, если опция AllowNestedDocks
установлена, и False - в противном случае;
♦ setTabPosition ( <Область DockWidgetArea>, <Позиция>) - задает позицию отображения
заголовков вкладок для указанной области. По умолчанию заголовки вкладок отобра
жаются снизу. В качестве параметра <Позиция> могут быть указаны следующие элемен
ты перечисления TaЬPosition из класса QTabWidget: North (сверху), South (снизу), West
(слева) и East (справа);
♦ tabPosition (<Область DockWidgetArea>) - возвращает позицию отображения заголов
ков вкладок прикрепляемых панелей для указанной области;
♦ setTabShape (<Форма>) - задает форму углов ярлыков вкладок в виде одного из следую
щих элементов перечисления· TabShape из класса QT�bWidget: Rounded (скругленные
углы - значение по умолчанию) или Triangular (треугольная форма);
♦ tabShape () - возвращает форму углов ярлыков вкладок;
♦ setCorner (<Угол>, <Область DockWidgetArea>) - закрепляет указанный угол за задан
ной областью. По умолчанию верхние углы закреплены за верхней областью, а ниж
ние - -за нижней областью. В параметре <Угол> указываются следующие элементы
перечисления Corner из модуля QtCore. Qt:
• TopLeftCorner - левый верхний угол;
• TopRightCorner - правый верхний угол;
674 Часть 1/. Библиотека PyQt 6
• BottomLeftCorner - левый нижний угол;
• BottomRightCorner - правый нижний угол;
♦ corner(<Угол Corner>) - возвращает область, за которой закреШiен указанный угол;
♦ splitDockWidget() - разделяет область, занимаемую панелью <QDockWidget 1>, поме
щает панель <QDockWidget 1> в первую часть области, а панель <QDockWidget 2> - во
вторую. Формат метода:
splitDockWidget(<Пaнeль QDockWidget 1>, <Панель QDockWidget 2>, <Ориентация>)
В качестве параметра <Ориентация> могут быть указаны следующие элементъ1 перечис
ления Orientation из модуля QtCore.Qt: Horizontal или Vertical. Если указан элемент
Horizontal, то панель <QDockWidget 2> будет расположена справа, а если Vertical - то
снизу. Если панель <QDockWidget 1> расположена на вкладке, панель <QDockWidget 2>
будет добавлена на новую вкладку, и разделения области при этом не произойдет;
♦ taЬifyDockWidget(<Панель QDockWidget 1>, <Панель QDockWidget 2>) - размещает па
нель <QdockWidget 2> над панелью <QDockWidget 1>, создавая таким образом область
с вкладками;
♦ taЬifiedDockWidgets(<Панель QDockWidget>) - возвращает список ссылок на панели
(объекты класса QDockWidget), которые расположень1 на других вкладках в области па
нели, указанной в качестве параметра;
♦ resizeDocks () - задает новые размеры у панелей из списка, указанного в первом пара
метре, при этом первый размер из указанных в <Списке размеров> будет применен к пер
вой панели, второй - ко второй панели и т. д. Формат метода:
resizeDocks(<Cпиcoк панелей QDockWidget>, <Список размеров>, <Ориентация>)
Если третьим параметром передан элемент нorizontal перечисления Orientation из
. модуля QtCore. Qt, <Список размеров> задаст значения ширины панелей, если указан
элемент vertical - высоты. Размеры панелей, не указанных в первом списке, будут из
менены таким образом, чтобы вместиться в оставшееся свободное пространство. Разме
ры самого окна при этом не изменяются;
♦ savestate ( [version=0J) - возвращает объект класса QByteArray с размерами и положе
нием всех панелей инструментов и прикрепляемых панелей.
Обратите внимание, что все панели инструментов и прикрепляемые панели должны
иметь уникальные объектные имена. Задать объектное имя можно с помощью метода
setObjectNarne(<Имя в виде строки>) класса QObject, например:
self.dw =.QtWidgets.QDockWidget("MyDockWidgetl")
self. dw. setObjectNarne("MyDockWidgetl")
♦ restoreState(<OOЬeкт' QByteArray>[, version=0])-'- восстанавливает размеры и место
положение всех панелей инструментов и прикрепляемых панелей, ранее сохраненные
вызовом метода saveState() .
Чтобы сохранить размеры окна, следует воспользоваться методом saveGeometry() класса
QWidget. Метод возвращает объект класса QByteArray с размерами окна. Чтобы восстано
вить размеры окна, достаточно вызвать метод restoreGeometry(<ООЬект QByteArray>) ;
♦ restoreDockWidget(<Панель QDockWidget>) - восстанавливает состояние указанной па
нели, если она была создана после вызова метода restorestate(). Метод возвращает
значение True, если состояние панели успешно восстановлено, и False - в противном
случае.
Глава 28. Создание SDI- и МDl-программ 675
Класс QMainWindow поддерживает полезный сигнал taЬifiedDockWidgetActivated (<Панель
QDockWidget>), генерируемый при активиза_ции в,кладки щелчком на ее заголовке. Активи
зированная вкладка передается обработчику с единственным параметром. Остальные, менее
полезные сигналы описаны на странице https://doc.qt.io/qt-6/qmainwindow.html.
28.2. Меню и действия
Главное меню позволяет компактно поместить в главное окно множество команд, объеди
ненных в логические группы. Оно представляет собой горизонтальную панель (реализуе
мую классом QMenuBar), на которой расположены отдельные меюо (реализуются с помощью
класса QMenu) верхнего уровня.
Каждое меюо содержит произвольное количество действий (класс QAction), каждое из ко
торых, в зависимости от его типа, представляет отдельный пункт, разделитель или вложен
ное меюо. Действие, представляющее пункт, содержит текстовое название, необязательные
значок и флажок, превращающий его в переключатель. Действие, представляющее вложен
ное меюо, содержит название, собственно меюо и необязательный значок. Действие
разделитель ничего не содержит.
Контекстное меню обычно отображается при щелчке правой кнопкой мыши в области ка
кого-либо компонента. Оно также реализуется классом QMenu.
28.2.1. Класс QMenuBar
Класс QMenuвar описывает само главное меюо. Оно реализовано в главном окне программы
изначально. Получить ссылку на него можно вызовом метода menuBar () класса QMainWindow.
Установить свое главное меюо позволяет метод setMenuBar (<Главное меню QMenuBar>) .
Иерархия наследования класса QMenuBar такова:
(QObject, QPaintDevice) - QWidget - QМenuBar
Конструктор класса QMenuBar имеет следующий формат:.
QMenuBar ( [parent=None])
В параметре parent указывается ссылка на родительское окно.
Класс QMenuBar наследует все методы баз_овых классов и поддерживает следующие допол
нительные методы (здесь приведены только интересующие нас - полный их список можно
найти на странице https://doc.qt.io/qt-6/qmenubar.html):
♦ addМenu (<Меню QМenu>) - добавляет заданное меюо в текущее главное меюо и возвра
щает связанное с добавленным меюо действи_е (объект класса QAction);
♦ addМenu ( [ <Значок Qicon>, ]<Название>) - создает меюо, добавляет его в гл�цо.е ·меюо
и возвращает ссылку на созданное меюо.(объект класса QMenu). Внутри текста названия
символ &, указанный перед буквой или цифрой, задает комбинацию клавиш быстрого
доступа. В первом параметре можно указать значок, который будет выведен левее
названия меюо;
♦ insertMenu (<Действие QAction>, <Меню QMenu>) - добавляет заданное меюо перед ука
занным действием. Метод возвращает действие (объект класса QAction), соответствую
щее добавленному меюо;
♦ addAction () - добавляет в главное меюо действие, непосредственно заданное или соз
данное на основе заданных названия и обработчика. Форматы метода:
676 Часть 11. Библиотека PyQt 6
аddАсtiоn(<Действие QAction>)
addAction(<Haзвaниe>) -> QAction
addAction(<Haзвaниe>, <Обработчик>) -> QAction
Второй и третий форматы возвращают созданное действие;
♦ addSeparator() - добавляет в главное меmо разделитель и возвращает представляющее
его действие;
♦ insertSeparator(<Действие QAction>) - добавляет перед указанным действием разде-
литель и возвращает связанное с ним действие;
♦ clear() - удаляет все действия из главного меmо;
♦ setActiveAction(<Дейсоrвие QAction>) - делает активным указанное действие;
♦ activeAction() - возвращает активное действие или значение None;
♦ setDefaultUp(<Флaг>) - если в качестве параметра указано значение True, отдельные
меmо будут открываться над главным меmо, а не под ним;
♦ setVisiЫe(<Флаг>) - если в качестве параметра указано значение False, главное меmо
будет скрыто. Значение True отображает панель меmо.
Класс QMenuBar поддерживает следующие сигналь�:
♦ hovered(<Действие QAction>) - генерируется при наведении курсора мыши на какое-
либо действие. Последнее передается обработчику с параметром;
♦ triggered(<Дeйcтвиe QAction>) - генерируется при выборе какого-либо действия. По
следнее передается обработчику с параметром.
28.2.2. Класс QMenu
Класс QMenu реализует отдельное меmо в главном меmо, а также вложенное и контекстное
меmо. Его иерархия наследования выглядит так:
(QObject, QPaintDevice) - QWidget - QМenu
Форматы конструктора класса QМenu:
QМenu( [parent=None])
QМеnu(<Название>[, parent=None])
В параметре parent указывается ссылка на родительский компонент. Внутри текста в пара
метре <Название> символ &, указанный перед буквой или цифрой, задает клавишу быстрого
доступа. Чтобы вывести сам символ &, необходимо его удвоить.
Помимо унаследованных из базовых классов, класс QМenu поддерживает ряд своих методов
(здесь приведены только основные - полный их список можно найти на странице
bttps://doc.qt.io/qt-6/qmenu.btml):
♦ addAction() - добавляет в меmо действие, непосредственно заданное или созданное на
основе заданных параметров. Форматы метода:
аddАсtiоn(<Действие QAction>)
addAction(<Haзвaниe>) -> QAction
addAction(<Знaчoк Qicon>, <Название>) -> QAction
addAction(<Haзвaниe>, <Обработчик>[, shortcut=OJ) -> QAction
addAction(<Знaчoк Qicon>, <Название>, <Обработчик>[, shortcut=O]) -> QAction
Глава 28. Создание SDI- и МDl-программ 677
Внутри текста названия символ &, указанный перед буквой или цифрой, задает клавишу
быстрого доступа. Эта клавиша сработает только в том случае, если меmо, в котором на
ходится пункт, является активным.
Параметр shortcut задает комбин;щmо «горячих» клавиш, нажатие которых аналогично
выбору пункта в меmо. Нажатие комбинации «горячих» клавиш сработает даже в том
случае, если меmо не является активным. Примеры:
QtGui.QKeySequence("Ctrl +R")
QtGui.QKeySequence(QtCore.Qt.Key.Key_FS))
QtGui.QKeySequence .fromString("Ctrl+R")
Все форматы, за исключением первого, возвращают созданное действие;
♦ addSeparator() -добавляет в меmо действие-разделитель и возвращает ссылку на него;
♦ addSection() -добавляет в меmо действие-секцию, которая выглядит как разделитель
с заголовком и, возможно, значком, и возвращает ссылку на созданное действие. Форма
ты метода:
addSection(<Зaгoлoвoк>)
addSection(<Зaгoлoвoк>, <Значок,Qiсоn>)
♦ addМenu(<Меню QMenu>) - добавляет заданное меmо в качестве вложенного и возвращает
представляющее его действие (объект класса QAction);
♦ addМenu( [ <Значок Qicon>, J <Название>) - создает вложенное меmо, добавляет его
в текущее меmо и возвращает ссьmку на созданное меmо (объект класса QMenu);
♦ insertMenu(<Действие QAction>, <Меню QMenu>) - добавляет заданное меmо в качестве
вложенного перед указанным действием. Метод возвращает действие, соответствующее
добавленному меmо;
♦ insertseparator(<Действие QAction>) -добавляет действие-разделитель перед указан
ны� действием и возвращает ссьmку на добавленное действие;
♦ insertsection() -добавляет действие-секцию перед указанным действием и возвраща
ет ссылку на добавленное действие. Форматы метода:
insertSection(<Дe�cтвиe QAction>, <Заголовок>)
insertSection(<Дeйcтвиe QAction>, <Заголовок>, <Значок Qicon>)
♦ clear() -удаляет все действия из меmо;
♦ isEmpty() - возвращает значение True, если меmо не содержит видимых пунктов,
и False - в противном случае;
♦ menuAction() -возвращает действие, связанное с текущим меmо;
♦ setTitle(<Название>) -задает название меmо;
♦ title() -возвращает название меmо;
♦ seticon(<Значок Qicon>) - задает значок меmо;
♦ icon( J -возвращает значок меmо (объект :\<Ласса Qrcon);
♦ setActiveAction(<Действие QAction>) - делает активным пункт, соответствующий ука
занному действию;
♦ activeAction() - возвращает активный пункт (объект класса QAction) или значение
None;
♦ setDefaultAction(<Действие QAction>) -задает пункт по умолчанию;
678 Часть 11. Библиотека PyQt 6
♦ defaultAction() - возвращает пункт по умолчанию (объект класса QAction) или значе
Нй:е None;
♦ setTearOffEnaЫed(<Флaг>) - если в качестве параметра указано значение True, в нача
ло меню добавляется пункт с пунктирной линией, с помощью нажатия на который мож
но оторвать меню от главного меню и сделать его плавающим (отображаемым в отдель
ном окне, которое можно разместить в любой части экрана);
♦ isTearOffEnaЫed () - возвращает значение True, если меню может быть плавающим,
и False - в противном случае;
♦ isTearOffМenuVisiЫe() - возвращает значение True, если меню является плавающим,
и False - в противном случае;
♦ showТearOffМenu([<Координаты QPoint>] ) - принудительно превращает меню, для ко
торого была указана такая возможность, в плавающее и помещает его либо по заданным
координатам, либо, если параметр не указан, в точке, где расположен курсор мыши;
♦ hideTearOffМenu() - скрывает плавающее меню;
♦ setSeparatorsCollapsiЫe(<Флаг>) - если в качестве параметра указано значение тrue,
вместо нескольких разделителей, идущих подряд, будет отображаться один. Кроме того,
разделители, расположенные по краям меню, также будут скрыты;
♦ setToolTipsVisiЫe(<Флаг>) - если передано значение True, заданная для меню всплы
вающая подсказка будет отображаться на экране, если False - не будет (поведение по
умолчанию). Текст всплывающей подсказки у меню можно задать вызовом метода
setToolTip(<Текст>), унаследованным от класса QWidget;
♦ popup(<Координаты QPoint> [, <Действие QAction>]) - отображает меню по указанным
глобальным координатам. Если указан второй параметр, меню отображается таким обра
зом, чтобы по координатам бьш расположен указанный пункт меню;
♦ ехес([<Координаты QPoint>][, ][action=None]]) - отображает меню по указанным
глобальным координатам и возвращает действие, соответствующее выбранному пункту,
или значение None, если ни один пункт не был выбран (например, была нажата клавиша
<Esc>). Если в параметре action указано действие (объект класса QAction), меню ото
бражается таким образом, чтобы по координатам бьш расположен соответствующий
пункт;
♦ ехес() - статический, выводит меню, содержащее действия из указанного списка, по
заданным глобальным координатам и возвращает действие, соответствующее выбран
ному пункту, или значение None, если пункт не выбран (например, была нажата клавиша
<Esc>). Формат метода:
ехес(<Список с действиями QAction>, <Координаты QPoint>[, at=None][,
parent=None])
Если в параметре at указано действие (объект класса QAction), меню отображается та
ким образом, чтобы по координатам был расположен соответствующий пункт меню.
В параметре parent можно указать ссьшку на родительский компонент.
Класс QMenu поддерживает следующие сигналь�:
♦ hоvеrеd(<Действие QAction>) - генерируется при наведении курсора мыши на какое
либо действие, которое передается в обработчик в параметре;
♦ triggered(<Дeйcтвиe QAction>) - генерируется при выборе в меню какого-либо дейст
вия, которое передается в обработчик в параметре;
Глава 28. Создание SDI- и МD/-программ 679
♦ aЬoutToShow() - rе}lерируется перед отображением меmо;
♦ aboutToHide() - генерируется перед скрытием меmо.
28.2.3. Контекстное меню компонента
Чтобы создать у компонента контекстное меmо, можно воспользоваться следующими мето
дами класса QWidget:
♦ addAction(<Действие QAction>) - добавляет указанное действие в конец контекстного
меmо;
♦ addActions (<Список с действиями QAction>) - добавляет действия из указанного спи
ска в конец контекстного меmо;
♦ insertAction (<Действие QAction 1>, <Действие QAction 2>) - добавляет <Действие 2>
перед <Действием 1>;
♦ insertActions (<Действие QAction>, <Список с действиями QAction>) - добавляет дей
ствия из указанного списка перед заданным действием;
♦ actions() - возвращает список с действиями (объекты класса QAction), содержащимися
в контекстном меmо;
♦ removeAction(<Действие QAction>) - удаляет указанное действие из меmо.
Перед добавлением действий в контекстное меmо компонента с помощью методов addAction()
и addActions() следует вызвать у компонента метод setContectMenuPolicy(<Режим>), за
дающий режим формирования и вывода контекстного меmо, передав ему в качестве пара
метра элемент ActionscontextMenu перечисления ContextMenuPolicy из модуля QtCore.Qt.
Таким образом компоненту будет указано формировать пункты контекстного меmо на
основе заданных действий. Пример:
class MyComponent(QWidget):
def init (self):
self.setContextMenuPolicy(
QtCore.Qt.ContextMenuPolicy.ActionsContextMenu)
# Создаем действия actionl, action2 и actionЗ
self.addAction(self.actionl)
self.addAction(self.action2)
self.addAction(self.actionЗ)
Созданное таким образом контекстное меmо будет выводиться автоматически при щелчке
на компоненте правой кнопкой мыши.
Другой способ вывести контекстное меmо - переопределение у компонента метода
contextMenuEvent (self, <event>). Этот метод будет автоматически вызываться при щелчке
правой кнопкой мыши в области компонента. Внутри метода через параметр <event> досту
пен объект класса QContextMenuEvent, содержащий дополнительную информацию о собы
тии. Класс QContextMenuEvent поддерживает следующие основные методы:
♦ х() и у () - возвращают координаты по осям х и У соответственно в пределах области
компонента;
♦ pos () - возвращает объект класса QPoint с целочисленными координатами в пределах
области компонента;
680 Часть 11. Библиотека PyQt б
♦ globalx() и globalY() - возвращают координаты по осям х и У соответственно в преде-
лах экрана;
♦ globalPos() - возвращает объект класса QPoint с координатами в пределах экрана.
В методе следует явно создать меmо, добавить. в него необходимые действия и вывести
вызовом метода ехес() с передачей ему результата выполнения метода globalPos():
class MyCornponent(QWidget):
def contextMenuEvent(self, event):
self.context_rnenu = QtWidgets.QМenu(parent=self)
self.context_rnenu.addAction(self.actionl)
self.context_rnenu.addAction(self.action2)
self.context_rnenu.addAction(self.actionЗ)
self.context_rnenu.exec(event.globalPos())
Контекстное меmо можно создавать и заранее (например, в теле конструктора).
28.2.4. Класс QAction
Класс QAction из модуля QtGui описьmает действие. Добавленное в меmо, оно преобразует
ся в пункт, добавленное на панель инструментов - в кнопку. Один и тот же объект дейст
вия допускается добавлять в несколько мест (например, и в меmо, и на панель инструмен
тов), что позволяет управлять видимостью и доступностью действия централизованно.
Иерархия наследования для класса QAction следующая:
QObject - QAction
Форматы конструктора класса QAction:
QAction([parent=None])
QАсtiоn(<Название>[, parent=None])
QАсtiоn(<Значок Qicon>, <Название>[, parent=None])
В параметре parent указывается ссылка на родительский компонент или значение None.
Внутри текста названия символ &, указанный перед буквой или цифрой, задает клавишу
быстрого доступа. Чтобы вывести сам символ &, необходимо его удвоить.
Класс QAction поддерживает следующие основные методы (полный их список можно найти
на странице https://doc.qt.io/qt-6/qaction.html):
♦ setText(<Название>) - задает название действия. Внутри текста названия символ &,
указа:нный перед буквой или цифрой, задает клавишу быстрого доступа. Нажатие кла
виши быстрого доступа сработает только. в том случае, если меmо, в котором
. находится
.
пункт,.является активным;
♦ text() - возвращает название действия;
♦ seticon(<Значок Qicon>) - устанавливает значок;
♦ icon() - возвращает значок (объект класса Qicon);
♦ seticonVisiЬleinМenu(<Флaг>) - если в качестве параметра указано значение False,
значок отображаться не будет;
♦ setSeparator(<Флаг>) - если в качестве параметра указано значение True, действие
станет разделителем;
Глава 28. Создание SDI- и МDl-программ 681
♦ isSeparator () - возвращает значение True, если действие является разделителем,
и False - в противном случае;
♦ setShortcut(<Объект QKeySequence>) - задает комбинацию «горячих» клавиш. Нажатие
комбинации «горячих» клавиш по умолчанию сработает даже в том случае, если меюо
не является активным. Вот примеры указания значения:
"Ctrl+O"
QtGui. QKeySequence("Ctrl+О")
QtGui. QKeySequence. fromString ("Ctrl+О")
QtGui.QKeySequence.Open
♦ setShortcuts() - позволяет задать сразу несколько комбинаций «горячих» клавиш.
Форматы метода:
setShortcuts(<Cпиcoк с объектами QKeySequence>)
setShortcuts(<Cтaндapтнaя комбинация клавиш>)
В параметре <Стандартная комбинация клавиш> указываются элементы перечисления
StandardKey из класса QKeySequence (например, Open, Close, Сору, Cut и т. д. - полный
их список можно найти в документации по классу QKeySequence);
♦ setShortcutContext(<Область>) - задает область действия комбинации «горячих» кла
виш. В качестве параметра указываются следующие элементы перечисления
ShortcutContext из модуля QtCore. Qt:
• WidgetShortcut - комбинация доступна, если родительский компонент имеет фокус;
• WidgetWithChildrenShortcut - комбинация доступна, если фокус имеет родитель
ский компонент или любой дочерний компонент;
• WindowShortcut - комбинация доступна, если окно, в котором расположен компо
нент, является активным;
• ApplicationShortcut - комбинация доступна, если любое окно программы является
активным;
♦ setтoolтip(<Текст>) - задает текст всплывающей подсказки;
♦ toolTip() - возвращает текст всплывающей подсказки;
♦ setWhatsThis(<Текст>) - задает текст расширенной подсказки;
♦ whatsThis() - возвращает текст расширенной подсказки;
♦ setStatusTip(<Teкcт>) - задает текст, который будет отображаться в строке состояния
при наведении курсора мыши на действие;
♦ statusTip() - возвращает текст для строки состояния;
♦ setCheckaЫe(<Флаг>) - если в качестве па:раметра указано значение тrue, действие яв
ляется переключателем, который может находиться в двух состояниях: установленном
и неустановленном;
♦ isCheckaЫe() - возвращает значение тrue, если действие является переключателем,
и False - в противном случае; .
♦ setChecked(<Флaг>) - если в качестве параметра указано значение True, действие
переключатель будет находиться в установленном состоянии. Метод является слотом;
♦ isChecked·() - возвращает значение True, если действие-переключатель находится
в установленном состоянии, и False - в противном случае;
682 Часть 11. Библиотека PyQt 6
♦ setDisaЫed(<Флаг>.) - если в качестве параметра указано значение True, действие ста
нет недоступным. Значение False делает действие вновь доступным. Метод является
слотом;
♦ sеtЕnаЫеd(<Флаг>) - если в качестве параметра указано значение False, действие ста
нет недоступным. Значение тrue делает действие вновь доступным. Метод является сло
том;
♦ isEnaЫed() - возвращает значение True, если действие доступно, и False - в против
ном случае;
♦ setVisiЫe(<Флаг>) - если в качестве параметра указано значение False, действие
будет скрыто. Значение True вновь выводит действие на экран. Метод является слотом;
♦ isVisiЫe() - возвращает значение False, если действие скрыто, и True - в противном
случае;
♦ setFont( <Шрифт QFont>) - устанавливает шрифт для текста;
♦ font() - возвращает объект класса QFont с текущими параметрами шрифта;
♦ setAutoRepeat (<Флаг>) - если в качестве параметра указано значение True (значение по
умолчанmо), действие будет повторяться, пока удерживается нажатой комбинация «го
рячих» клавиш;
♦ setPriority(<Пpиopитeт>) - задает приоритет действия. В качестве параметра указы
ваются элементы LowPriority (низкий), NormalPriority (нормальный) или HighPriority
(высокий) перечисления Priority из класса QAction;
♦ priority() - возвращает текущий приоритет действия;
♦ setData(<Данные>) - позволяет сохранить пользовательские данные любого типа в объ
екте действия;
♦ data() - возвращает пользовцелъские данные, сохраненные ранее с помощью метода
setData(), или значение None;
♦ setActionGroup(<Группа QActionGroup>) - добавляет действие в указанную группу;
♦ actionGroup() - возвращает ссылку на группу (объект класса QActionGroup) или значе
ние None;
♦ showstatusтext( [None]) - отправляет событие типа Type.StatusTip указанному в пара
метре компоненту и возвращает значение тrue, если событие успешно отправлено. Если
компонент не указан, событие посылается родителю действия.
Чтобы обработать событие, необходимо наследовать класс компонента и переопреде
лить метод event(self, <event>). При событии Type.StatusTip через параметр <event>
доступен объект класса QStatusTipEvent. Получить текст для строки состояния можно
через метод tip() объекта события. Вот пример обработки события в классе, наследую
щем класс QLabel:
def event(self, е):
if e.type() = QtCore.QEvent.Type.StatusTip:
self.setText(e.tip())
return True
return QtWidgets.QLaЬel.event(self, е)
♦ hover() - посьmает сигнал hovered(). Метод является слотом;
Глава 28. Создание SDI- и МD/-программ 683
♦ toggle() - изменяет состояние действия-переюпочателя на противоположное. Метод
является слотом;
♦ trigger() - посылает сигнал triggered(). Метод является слотом.
Класс QAction поддерживает следующие сигналы:
♦ changed() - генерируется при изменении действия;
♦ hovered() - генерируется при наведении курсора мыши на действие;
♦ toggled(<Состояние>) - генерируется при изменении состояния действия-переключа
теля. Внутри обработчика через параметр доступно текущее состояние в виде логиче
ской величины;
♦ triggered(<Cocтoяниe переключателя>) - генерируется при выборе пункта меmо, нажа
тии кнопки на панели инструментов, нажатии комбинации клавиш или вызове метода
trigger(). В параметре доступно текущее состояние действия-переключателя в виде ло
гической величины - у обычных действий значение параметра всегда равно False.
Код, который должен выполняться при выборе действия, обычно помещается в обработчик
сигнала triggered () или toggled().
28.2.5. Объединение действий-переключателей в группу
Класс QActionGroup· представляет группу, объединяющую произвольное количество дейст
вий-переключателей. По умолчанию внутри группы может быть установлен только один
переключатель - при попытке установить другой переключатель ранее установленный
будет сброшен. Иерархия наследования у этого класса выглядит так:
QObject - QActionGroup
Конструктор класса QActionGroup имеет следующий формат:
QActionGroup(<Poдитeль>)
В параметре <Родитель> указывается ссылка на родительский компонент. После создания
объекта группы он может быть указан в качестве родителя при создании объектов дейст
вия - в этом случае действия автоматически добавятся в группу.
Класс QActionGroup поддерживает следующие основные методы:
♦ addAction() -добавляет в группу действие, указанное непосредственно или вновь соз
данное на основе заданных названия и значка. Метод возвращает добавленное действие.
Форматы метода:
addAction(<Действи_е QAction>) •i \"·f•
addAction(<Haзвaниe>)
addAction(<Знaчoк Qicon>, <Название>)
♦ removeAction(<Действие QAction>) -удаляет указанное действие из группы;
♦ actions() -возвращает список с действиями (объектами класса QAction), которые были
добавлены в группу, или пустой список;
♦ checkedAction() - возвращает ссьmку (объект класса QAction) на установленное дейст
вие-переюпочатель внутри группы при использовании эксклюзивного режима или зна
чение None;
684 Часть 11. Библиотека PyQt б
♦ setExclusive(<Флаг>) - если в качестве параметра указано значение False, внутри
группы может быть установлено произвольное количество действий-переключателей.
Значение True возвращает эксклюзивный режим, при котором может быть установлено
только одно действие-переключатель (поведение по умолчанию). Метод является сло
том;
♦ setExclusionPolicy(<Режим>) - задает режим работы группы. В качестве параметра
указывае;гся один из следующих элементов перечисления ExclusionPolicy из класса
QActionGroup:
• None - может быть установлено произвольное количество действий-переключателей
(аналогично вызову метода setExclusive() с передачей ему значения False);
• Exclusive - может быть установлено лишь одно действие-переключатель (поведе
ние по умолчанию);
• ExclusiveOptional - может быть установлено лишь одно действие-переключатель
или ни одного;
♦ setDisaЫed(<Флaг>) - если в качестве параметра указано значение True, все действия
в группе станут недоступными. Значение False делает действия вновь доступными. Ме
тод является слотом;
♦ sеtЕnаЫеd(<Флаг>) - если в качестве параметра указано значение F�lse, все действия
в группе станут недоступными. Значение тrue делает действия вновь доступными. Ме
тод является слотом;
♦ isEnaЫed() - возвращает значение тrue, если действия в группе доступны, и False -
в противном случае;
♦ setVisiЫe(<Флаг>) - если в качестве параметра указано значение False, все действия
в группе будут скрыты. Значение True вновь выводит действия на экран. Метод является
слотом;
♦ isVisiЫe() - возвращает значение False, если действия группы скрыты, и тrue -
в противном случае.
Класс QActionGroup поддерживает сигналы:
♦ hovered(<Действие QAction>) - генерируется при наведении курсора мыши на действие
внутри группы. Внутри обработчика через параметр доступна ссылка на это действие;
♦ triggered(<Дeйcтвиe QAction>) - генерируется при выборе пункта мешо, нажатии
кнопки на панели инструментов или комбинации клавиш. Внутри обработчика через па
раметр доступна ссылка на действие.
28.3. Панели инструментов
Панели инструментов предназначены для отображения часто используемых команд. Доба
вить панель инструментов в главное окно позволяют методы addToolВar() и
insertToolBar () класса QМainWindow. Один из форматов метода addToolBar() позволяет ука
зать область, к которой будет изначально прикреплена панель. По умолчанию с помощью
мыши пользователь может переместить панель в другую область окна или отобразить в от
дельном окне. Ограничить перечень областей, к которым можно прикрепить панель, позво
ляет метод setAllowedAreas() класса QToolBar, а запретить отображение панели в отдель
ном окне - метод setFloataЫe() .
Глава 28. Создание SD/- и МD/-программ 685
28.3.1. Класс QToo/Bar
Класс QToolBar реализует панель инструментов, которую можно перемещать с помощью
мыши. Иерархия наследования для него такова:
(QObject, QPaintDevice) - QWidget - QТoolBar
Форматы конструктора класса QToolВar:
QТoolBar([parent=None])
QТооlВаr(<Название>[, parent=None])
В параметре parent указывается ссылка на родительский компонент, а в параметре <Назва
ние> - название панели, которое отображается в контекстном меmо при щелчке правой
кнопкой мыши в области меmо, области панелей инструментов или на заголовке прикреп
ляемых панелей. С помощью контекстного меmо можно скрыть или отобразить панель
инструментов.
Класс QToolBar наследует все методы базовых классов и поддерживает следующие собст�
венные методы (здесь приведены только основные - полный их список можно найти на
странице https://doc.qt.io/qt-6/qtoolbar.html):
♦ adc!Action() - добавляет на панель инструментов действие, указанное непосредственно
или вновь созданное на основе заданных параметров. Форматы метода:
аdс!Асtiоn(<Действие QAction>)
аdс!Асtiоn(<Название>) -> QAction
аdс!Асtiоn(<Значок Qicon>, <Название>) -> QAction
аdс!Асtiоn(<Название>, <Обработчик>) -> QAction
аdс!Асtiоn(<Значок Qicon>, <Название>, <Обработчик>) -> QAction
Все форматы, кроме первого, возвращают ссылку на добавленное действие;
♦ addSeparator() - добавляет действие-разделитель и возвращает ссылку на него;
♦ insertSeparator(<Дeйcтвиe QAction>) - добавляет действие-разделитель перед указан-
НЬIМ действием и возвращает ссылку на добавленное действие;
♦ addWidget(<Компонент) - добавляет заданнь1й компонент (например, раскрывающийся
список). Метод возвращает действие, представляющее добавленнь1й компонент;
♦ insertWidget(<Действие QAction>, <Компонент>) - добавляет заданный компонент пе
ред указанным действием и возвращает действие, представляющее· добавленнь1й компо
нент;
♦ widgetForAction(<Действие QAction>) - возвращает ссылку на компонент, который
связан с указаннь1м действием;_
♦ clear() - удаляет все действия из панели инструментов;
♦ setOrientation (<Ориентация>) - задает ориентацию панели в виде следующих элемен
тов перечисления Orientation из модуля QtCore.Qt:
• Horizontal- горизонтальная (значение по умолчанию);
• Vertical - вертикальная;
♦ setAllowedAreas(<Области>) - задает области, к которым можно прикрепить панель
инструментов. В качестве параметра указываются следующие элементы (или их ком
бинация через оператор 1) перечисления ToolBarArea из модуля QtCore. Qt: LeftToolвarArea
(слева), RightToolBarArea (справа), TopToolBarArea (сверху), BottomToolBarArea (снизу),
686 Часть 11. Библиотека PyQt 6
AllToolBarAreas (все области - значение по умолчанmо) или NoToolBarArea (ни одна
область);
♦ setMovaЫe(<Флаг>) - если в качестве параметра указано значение False, будет невоз
можно перемещать панель с помощью мыши. Значение True вновь разрешает перемеще
ние панели;
♦ isMovaЫe() - возвращает значение True, если панель можно перемещать с помощью
мыши, и False- в противном случае;
♦ setFloataЬle(<Флаг>) - если в качестве параметра указано значение False, панель
недьзя будет вынести в отдельное окно. Значение True вновь разрешает выносить панель
в окно;
♦ isFloataЫe() - возвращает значение тrue, если панель можно вынести в отдельное
окно, и False - в противном случае;
♦ isFloating() - возвращает значение True, если панель в настоящий момент вынесена
в отдельное окно, и False - в противном случае;
♦ setтoolButtonStyle(<Стиль>) - задает стиль кнопок на панели инструментов. Метод
является слотом. В качестве параметра указьшаются следующие элементы перечисления
ToolButtonStyle из модуля QtCore .Qt:
• ToolButtoniconOnly - только значок;
• ToolButtonTextOnly- только текст;
• ToolButtonтextBesideicon - текст справа от значка;
• ToolButtonTextUndericon - текст под значком;
• ToolButtonFollowStyle- зависит от используемого стиля;
♦ toolButtonStyle() - возвращает стиль кнопок на панели инструментов;
♦ seticonSize(<Размеры qsize>) - задает размеры значков. Метод является слотом;
♦ iconSize() - возвращает разм�ры значков (объект класса QSize);
♦ toggleViewAction() - возвращает действие (объект класса QAction), с помощью которо-
го можно скрыть или отобразить панель.
Класс QToolВar поддерживает следующие сигналь� (здесь приведены только основные -
полный их список можно найти на странице https://doc.qt.io/qt-6/qtoolbar.html):
♦ actionTriggered(<Дeйcтвиe QAction>) - генерируется при нажатии кнопки на панели.
Внутри обработчика через параметр доступно действие, связанное с этой кнопкой;
♦ visibi;LityChanged(<Фщ,г>.) - генерируется при изменении видимости панели. Внутри
обраб�тчика через пар·��·етр доступно значение True, если панель видима, и False -
если скрыта;
♦ topLevelChanged(<Флаг>) - генерируется при изменении состояния панели. Внутри
обработчика через параметр доступно значение True, если панель вынесена в отдельное
окно, и False- если прикреплена к области.
28.3.2. Класс QToo/Button
При добавлении на панель инструментов какого-либо действия автоматически создается
кнопка, представляемая классом QТoolButton. Получить ссылку на кнопку позволяет метод
Глава 28. Создание SDI- и МDl-программ 687
widgetForAction () класса QТoolBar. Иерархия наследования для класса QToolButton выгля
дит так:
(QObject, QPaintDevice) - QWidget - QAЬstractButton - QТoolButton
Конструктор класса QТoolButton имеет следующий формат:
QТoolButton( [parent�None])
В параметре parent указывается ссьmка на родительский компонент.
Класс QToolButton, помимо методов базовых классов, поддерживает следующие методы
(здесь приведены только основные - полный их список можно найти на странице
https://doc.qt.io/qt-6/qtoolbutton.html):
♦ setDefaultAction(<Дeйcтвиe QAction>) - связывает указанное действие с кнопкой. Ме
тод является слотом;
♦ defaultAction() - возвращает ссылку на действие (объект класса QAction), связанное
с кнопкой;
♦ setтoolButtonStyle(<Стиль>) - задает стиль _кнопки. Метод является слотом. Допус
тимые значения параметра приведены в описании метода setToolButtonStyle()
(см.разд. 28.3.1);
♦ toolВuttonStyle() - возвращает стиль кнопки;
♦ setMenu(<Меню QМenu>) - добавляет к кнопке заданное меmо;
♦ menu() - возвращает ссьmку на меmо (объект класса QMenu), добавленное к кнопке, или
значение None;
♦ showМenu() - отображает меmо, связанное с кнопкой. Метод является слотом;
♦ setPopupMode(<Режим>) - задает режим отображения меmо, связанного с кнопкой.
В качестве параметра указьmаются следующие элементы перечисления тoolButtonPopupМode
из класса QToolButton:
• DelayedPopup - меmо отображается при удержании кнопки, нажатой в течение неко
торого промежутка времени;
• MenuButtonPopup - справа от кнопки отображается кнопка со стрелкой, нажатие ко
торой приводит к немедленному открытию меmо;
• InstantPopup - нажатие кнопки приводит к немедленному открытию меmо. Сигнал
triggered() при этом не генерируется;
♦ popupMode() - возвращает режим отображения меmо, связанного с кнопкой;
♦ setArrowТype(<Тиn значка>) - устанавливает у кнопки, связанной с меmо, значок в ви
де стрелки. В качестве параметра задаются элементы NoArrow (нет стрелки - значение
по умолчанию), UpArrow (стрелка вверх), DownArrow (стрелка вниз), LeftAr,:ow (стрелка
влево) или RightArrow (стрелка вправо) перечисления ArrowТype из модуля QtCore. Qt;
♦ setAutoRaise(<Флаг>) - если в качестве параметра указано значение False, кнопка бу
дет отображаться с рамкой. По умолчанию кнопка сливается с фоном, а при наведении
указателя мыши становится выпуклой.
Класс QТoolButton поддерживает сигнал triggered(<Действие · QAction>), который генери
руется при нажатии кнопки или комбинации клавиш, а также при выборе пункта в связан
ном меmо. Внутри обработчика через параметр доступно соответствующее действие.
688 Часть 11. Библиотека PyQt б
· 28.4. Прикрепляемые панели
Если необходимо вывести на экран компоненты, занимающие много места (например,
таблицу или иерархический список), можно воспользоваться прикрепляемыми панелями.
Прикрепляемые панели реализуются с помощью класса QDockWidget. Его иерархия наследо
вания выглядит так:
(QObject, QPaintDevice) - QWidget - QDockWidget
Форматы конструктора класса QDockWidget:
QDockWidget([parent=None] [, flags= 0] )
QDockWidget(<Haзвaниe>[, parent=None] [, flags=0])
В параметре <Название> задается название панели, отображаемое в заголовке панели и в
контекстном меню при щелчке правой кнопкой мыши в области меlЩ), области панелей
инструментов или на заголовке прикрепляемых панелей. С помощью контекстногq меню
можно скрыть или отобразить прикрепляемую панель. В параметре parent указьmается
ссылка на родительское окно. Доступные значения параметра flags мы рассматривали
в разд. 19.1.1.
Класс QDockWidget наследует все методы базовых классов и поддерживает следующие до
полнительные методы (здесь приведены только интересующие нас - полный их список
можно найти на странице https://doc.qt.io/qt-6/qdockwidget.html):
♦ setWidget(<Компонент>) - устанавливает компонент, который будет отображаться на
прикрепляемой панели;
♦ widget() - возвращает ссылку на компонент, расположенный на панели;
♦ setTitleBarWidget(<Компонент>) - указывает компонент, отображаемый в заголовке
панели;
♦ titleBarWidget () - возвращает ссылку на компонент, расположенный в заголовке
панели, или значение None, если компонент не был установлен;
♦ setAllowec!Areas(<Области>) - задает области, к которым можно прикрепить панель.
В качестве параметра указываются следующие элементы (или их комбинация через опе
ратор 1) перечисления ToolВarArea из модуля QtCore. Qt: LeftDockWidgetArea (слева),
RightDockWidgetArea (справа), TopDockWidgetArea (сверху), BottomDockWidgetArea (снизу)
или AllDockWidgetAreas (все области - значение по умолчанию) или NoToolВarArea (ни
одна область);
♦ setFloating(<Флаг>) - если в качестве параметра указано значение True, панель ото
бразится в отдельном окне, а если указано значение False, она будет прикреплена к ка
кой-либо области;
♦ ·isFloating() - возвращает значение True, если панель отображается в отдельном окне,
и False - в противном случае;
♦ setFeatures(<Свойства>) - устанавливает свойства панели. В качестве параметра ука
зывается комбинация (через оператор 1) следующих элементов перечисления
DockWidgetFeature из класса QDockWidget:
• DockWidgetClosaЫe - панель можно закрыть;
• DockWidgetMovaЫe - панель можно перемещать мышью;
• DockWidgetFloataЫe - панель можно вынести в отдельное окно;
Глава 28. Создание SDI- и МО/-программ 689
• DockWidgetVerticalTitleBar - заголовок панели отображается с левой стороны, а не
сверху;
• NoDockWidgetFeatures - панель нельзя закрыть, переместить и вынести в отдельное
окно;
♦ features() - возвращает комбинацию установленных свойств панели;
♦ toggleViewAction() - возвращает действие (объект класса QAction), с помощью которо-
го можно скрыть или отобразить панель.
Класс QDockWidget поддерживает следующие полезные сигналы (полный их список можно
найти на странице https://doc.qt.io/qt-6/qdockwidget.html):
♦ dockLocationChanged(<Oблacть ToolBarArea>) - генерируется при переносе панели
в другую область. Внутри обработчика через параметр доступен идентификатор области,
на которую была перенесена панель;
♦ visiЬilityChanged(<Флaг>) - генерируется при изменении видимости панели. Внутри
обработчика через параметр доступно значение True, если панель видима, и False -
если скрыта;
♦ topLevelChanged(<Флаг>) - генерируется при изменении состояния панели. Внутри об
работчика через параметр доступно значение True, если панель вынесена в отдельное
окно, и False - если прикреплена к области.
28.5. Строка состояния
Класс QStatusBar реализует строку состояния, в которой можно выводить необходимые
сообщения. Помимо текстовой информации, туда можно добавить различные компонен
ты - например, индикатор хода выполнения процесса. Строка состояния состоит из трех
секщщ:
♦ секция для временных сообщений. Реализована по умолчанию. В эту секцию, в частно
сти, при наведении курсора мыши на пункт меню или кнопку на панели инструментов
вьmодятся сообщения, заданные у действия с помощью метода setstatusTip(). Вывести
пользовательское сообщение во временную секцию можно с помощью метода
showМessage();
♦ обычная секция. При выводе временного сообщения содержимое обычной секции скры
вается. Чтобы отображать сообщения в этой секции, необходимо предварительно доба
вить туда компоненты вызовом метода addWidget() или insertWidget (). Добавленные
компоненты выравниваются по левой стороне строки состояния;
♦ постоянная секция. При вьmоде временного сообщения содержимое постоянной секции
не скрывается. Чтобы отображать там сообщения, необходимо предварительно добавить
туда компоненты методом addPennanentWidget () или insertPennanentWidget(). Добав
ленные компоненты выравниваются по правой стороне строки состояния.
Получить ссылку на строку состояния, установленную в главном окне·, позволяет метод
statusBar() класса QMainWindow, а установить пользовательскую панель вместо стандартной
можно с помощью метода setStatusBar(<Строка состояния QStatusBar>). Иерархия насле
дования для класса QStatusвar выглядит так:
(QObject, QPaintDevice) - QWidget - QStatusBar
690 Часть 11. Библиотека PyQt б
Формат конструктора класса QStatusBar:
QStatusBar ([parent=None])
В параметре parent указывается ссьшка на родительское окно.
Класс QStatusBar наследует все методы базовых классов и поддерживает следующие
дополнительные методы (здесь приведены только основные - полный их список можно
найти на странице https://doc.qt.io/qt-6/qstatusbar.html):
♦ showMessage (<Текст> [, msecs=O] ) - вьmодит временное сообщение. Во втором пара
метре можно указать время показа сообщения в миллисекундах - если указано значе
ние О, то сообщение показывается, пока не будет выведено новое сообщение или вызван
метод clearмessage (). Метод является слотом;
♦ currentMessage () - возвращает временное сообщение, отображаемое в текущий мо
мент;
♦ clearMessage () - удаляет временное сообщение. Метод является слотом;
♦ addWidget (<Компонент>[, stretch=O J ) - добавляет указанный компонент в конец
обычной секции. В параметре stretch может быть указан фактор растяжения;
♦ insertWidget (<Индекс>, <Компонент>[, stretch=O]) - добавляет заданный компонент
в позицmо обычной секции с указанным индексом и возвращает индекс позиции. В па
раметре stretch может быть указан фактор растяжения;
♦ addPermanentWidget (<Компонент> [, stretch=O] ) - добавляет указанный компонент
в конец постоянной секции. В параметре stretch может быть указан фактор растяжения;
♦ insertPermanentWidget (<Индекс>, <Компонент>[, stretch=O]) - добавляет заданный ком
понент в позицmо постоянной секции с указанным индексом и возвращает индекс пози
ции. В параметре stretch может быть указан фактор растяжения;
♦ removeWidget (<Компонент>) - удаляет компонент из обычной или постоянной секции.
При этом сам компонент не удаляется, а только скрьmается, лишается родителя и
в дальнейшем может быть помещен в другое место;
♦ setSizeGripEnaЫed (<Флаг>) - если в качестве параметра указано значение тrue, в пра
вом нижнем углу строки состояния будет отображаться маркер изменения размера. Зна
чение False скрывает маркер.
Класс QStatusBar поддерживает сигнал messagechanged (<Сообщение>), генерируемый при
изменении текста во временной секции. Внутри обработчика через параметр доступно но
вое сообщение или пустая строка.
28.6. МDl-программы
Чтобы создать МDl-программу, следует в качестве центрального компонента главного окна
установить компонент QMdiArea вызовом метода setCentralWidget () класса QMainWindow.
Отдельное окно внутри МDI-области представляется классом QМdiSuЬWindow.
28.6.1. Класс QMdiArea
Класс QMdiArea реализует МDI-область, внутри которой располагаются вложенные окна
(объекты класса QMdiSuЬWindow). Иерархия наследования для класса QMdiArea выглядит так:
(QObject, QPaintDevice) - QWidget - QFrame - QAЬstractScrollArea - QMdiArea
Глава 28. Создание SDI- и МDl-программ 691
Конструктор класса QMdiArea имеет следующий формат:
QMdiArea( [parent=None])
В параметре parent указывается ссылка на родительское окно.
Класс QMdiArea поддерживает следующие методы (здесь приведены только основные -
полный их список можно найти на странице https://doc.qt.io/qt-6/qmdiarea.html):
♦ addSuЬWindow(<Koмпoнeнт>[, flags=O]) - создает вложенное окно с флагами flags
(см. разд. 19.1.1), добавляет в него заданный компонент и возвращает ссылку на создан
ное окно (объект класса QMdiSuЬWindo�):
w = MyWidget()
sWindow = self.mdi_area.addSuЬWindow(w)
sWindow.setAttribute(QtCore.Qt.WidgetAttribute.WA_DeleteOnClose)
# ... Задаем параметры окна
sWindow.show()
Чтобы окно автоматически удалялось при закрытии, необходимо установить у него флаг
WA_DeleteOnClose, а чтобы отобразить окно - вызвать метод show().
В первом параметре этого метода также можно указать ссьmку на существующее вло
женное окно (объект класса QMdiSuЬWindow):
w = MyWidget()
sWindow = QtWidgets.QMdiSuЬWindow()
self.mdi_area.addSuЬWindow(sWindow)
sWindow.setAttribute(QtCore.Qt.WidgetAttribute.WA_DeleteOnClose)
# ... Производим настройку свойств окна
sWindow.setWidget(w)
sWindow.show()
Кроме того, можно добавить вложенное окно в МDI-область, указав последmою в ка
честве родителя при создании объекта вложенного окна:
sWindow = QtWidgets.QМdiSuЬWindow(self.mdi_area)
♦ activeSuЬWindow() - возвращает ссылку на активное вложенное. окно (объект класса
QMdiSuЬWindow) или значение None;
♦ currentSuЬWindow() - возвращает ссьmку на текущее вложенное окно (объект класса
QMdiSuЬWindow) или значение None. Результат выполнения этого метода аналогичен тако
вому у метода activeSuЬWindow(), если МDI-область находится в активном окне;
♦ suЬWindowList( [order=WindowOrder.CreationOrder]) - возвращает список со ссылками
на все вложенные окна (объекты класса QMdiSuЬWindow), добавленные в МDI-область,
или пустой список. В параметре order указьшаются следующие элементы перечисления
WindowOrder из класса QМdiArea:
• CreationOrder - окна в списке указываются в порядке их создания;
• stackingOrder - окна в списке указываются в порядке размещения их на экране. По
следний элемент в списке будет содержать ссылку на самое верхнее окно, а пер
вый - ссылку на самое нижнее окно;
• ActivationHistoryOrder - окна в списке указываются в порядке истории получения
ими фокуса. Последний элемент в списке будет содержать ссылку на окно, получив
шее фокус последним;
692 Часть 11. Библиотека PyQt б
♦ removeSubWindow(<Koмnoнeнт>) - удаляет из МDI-области вложенное окно, содержащее
указанный компонент. В параметре также можно определить подлежащее удалению
вложенное окно (объект класса QМdiSuЬWindow);
♦ setActiveSuЬWindow(<Впоженное окно>) - делает указанное вложенное окно активным.
Если задать значение None, -все вложенные окна станут неактивными. Метод является
слотом;
♦ setActivationOrder(<Пopядoк WindowOrder>) - задает порядок передачи фокуса при
использовании методов activatePreviousSuЬWindow(), acti vateNextSuЬWindow() и др.
В параметре указываются те_ же элементы, что и в параметре метода suЬWindowList ();
♦ activationOrder() - возвращает порядок передачи фокуса;
♦ acti vateNextSubWindow() - делает активным следующее вложенное окно. Метод
является слотом. Порядок передачи фокуса устанавливается с помощью метода
setActivationOrder();
♦ activatePreviousSuЬWindow() - делает активным предыдущее вложенное окно. Метод
является слотом. Порядок передачи фокуса устанавливается с помощью метода
setActivationOrder();
♦ closeActiveSuЬWindow() - закрывает активное вложенное окно. Метод является слотом;
♦ closeAllSuЬWindows() - закрывает все вложенные окна. Метод является слотом;
♦ cascadeSuЬWindows() - выстраивает вложенные окна в виде стопки. Метод является
слотом;
♦ tileSuЬWindows() - выстраивает вложенные окна в виде мозаики. Метод является сло
том;
♦ setViewМode(-<Режим>) - задает режим отображения вложенных окон. В параметре
<Режим> указываются следующие элементы перечисления ViewMode из класса QMdiArea:
• SuЬWindowView - в виде собственно окон (по умолчанию);
• тabbedView - в виде отдельных вкладок на панели с вкладками;
♦ viewМode() - возвращает режим отображения вложенных окон;
♦ setTabPosition(<Позиция>) - задает позицию отображения заголовков вкладок при ис
пользовании режима TabbedView. В качестве параметра могут быть указаны следующие
элементы перечисления TabPosition из класса QTabWidget: North (сверху - значение по
умолчанию), South (снизу), West (слева) или East (справа);
♦ tabPosition() - возвращает позицию отображения заголовков вкладок при использо
вании режима TabbedView;
♦ setTabShape(<Форма>) - задает форму углов ярлыков вкладок при использовании ре
жима TabbedView. Могут быть указаны следующие элементы перечисления TabShape
из класса QTabWidget: Rounded (скругленные углы - значение по умолчанию) или
Triangular (треугольная форма);
♦ tabShape() - возвращает форму углов ярлыков вкладок в области заголовка при ис
пользовании режима TabbedView;
♦ setTabsMovaЫe(<Флаг>) - если передано значение True, вкладки на панели при исполь
зовании режима TabbedView можно перемещать мышью;
Глава 28. Создание SDI- и МD/-программ 693
♦ setTabsClosaЫe(<Флaг>) - если передано значение True, вкладки на панели при ис
пользовании режима тabbedView можно закрывать щелчком на расположенной в заго
ловке вкладки_ кнопке закрытия;
♦ setвackground(<кисть QBrush>) - задает кисть для заполнения фона МDl-области;
♦ setOption(<Oпция>[, on=True]) - если во втором параметре указано значение True, за
данная в первом параметре опция будет установлена, если False - сброшена. В пара
метре <Опция> может быть указан единственный поддерживаемый в настоящее время
элемент DontMaximizeSuЬWindowOnActivation перечисления AreaOption из класса
QМdiArea, в случае установки запрещающий автоматически разворачивать следующее
вложенное окно при переключении на него из уже развернутого окна;
♦ testOption(<Опция AreaOption>) - возвращает значение ,True, если указанная опция
установлена, и False - в противном случае.
Класс QMdiArea поддерживает сигнал suЬWindowActivated(<Вложенное окно>), генерируе
мый при активизации другого вложенного окна. В обработчике через параметр доступна
ссылка на активизированное вложенное окно или значение None.
28.6.2. Класс QMdiSubWindow
Класс QMdiSuЬWindow . реализует вложенное окно, отображаемое внутри МDI-области.
Иерархия наследования для него выглядит следующим образом:
(QObject, QPaintDevice) - QWidget - QМdiSuЬWindow
Формат конструктора класса QMdiSuЬWindow:
QМdiSuЬWindow([parent=N.on;=][, flags=O])
В параметре parent указывается ссылка на родительское окно. Доступные значения пара
метра flags мы рассматривали в разд. 19.1.1.
Класс QMdiSuЬWindow наследует все методы базовых классов и дополнительно поддерживает
следующие методы (полный их список можно найти на странице https:i/doc.qt.io/qt-
6/qmdisubwindow.html):
♦ setWidget(<Компонент>) --'- помещает заданный компонент в окно;
♦ widget() - возвращает ссылку на помещенный в окно компонент;
♦ mdiArea() - возвращает ссылку на МDl-область (объект класса QMdiArea) или значение
None;
♦ setsystemМenu(<Меню QMenu>) - устанавливает указанное меню у окна в качестве сис
темного;
♦ systemМenu() - возвращает ссьшку на системное меню окна (объект класса QMenu) или
значение None;
♦ showSystemМenu () - открывает системное меню окна. Метод является слотом;
♦ setKeyboardSingleStep(<Знaчeниe>) - устанавливает шаг изменения размера окна или
его положения с помощью клавиш со стрелками. Чтобы изменить размеры окна или его
положение с клавиатуры, необходимо в системном меню окна выбрать пункт Перемес
тить или Размер. Значение по умолчанию - 5;
♦ setKeyboardPageStep(<Значение>) - устанавливает шаг изменения размера окна или его
положения с помощью клавиш со стрелками при удержании нажатой клавиши <Shift>.
Значение по умолчанию - 20;
694 Часть 1/. Библиотека PyQt 6
♦ showShaded() - сворачивает содержимое окна, оставляя только заголовок. Метод явля
ется слотом;
♦ isShaded () - возвращает значение True, если отображается только заголовок окна,
и False - в противном случае;
♦ setOption(<Опция>[, on=True] ) - если во втором параметре указано значение тrue, за
данная в первом параметре опция будет установлена, а если False - сброшена. В пара
метре <Опция> могут быть указаны следующие элементы перечисления SuЬWindowOption
из класса QMdiSuЬWindow:
• RuЬberвandResize - если опция усцшовлена, при изменении размеров окна станут
изменяться размеры вспомогательного компонента, а не самого окна. По окончании
изменения размеров будут изменены размеры окна;
• RuЬberBandМove - если опция установлена, при изменении положения окна станет
перемещаться вспомогательный компонент, а не само окно. По окончании переме
щения будет изменено положение окна;
♦ testOption(<Oпция SuЬWindowOption>) - возвращает значение True, если указанная оц-
ция установлена, и False - в противном случае.
Класс QMdiSuЬWindow поддерживает следующие сигналы:
♦ aboutToActivate () - генерируется перед активацией вложенного окна;
♦ windowStateChanged(<Старое состояние>, <Новое состояние>) - генерируется при из
менении состояния окна. Внутри обработчика через параметры доступны обознач�ния
старого и нового состояний в виде элементов перечисления WindowState из модуля
QtCore.Qt.
28. 7. Добавление значка программы
в область уведомлений
Класс QSystemTrayicon поз�оляет добавить значок в область уведомлений, расположенную
в правой части панели задач Windows. Иерархия наследования для этого класса выглядит ·
так:
QObject - QSystemTrayicon
Форматы конструктора класса QSystemтrayicon:
QSystemTrayicon([parent=None])
QSystemTrayicon(<Знaчoк Qicon>[, parent=None])
В параметре parent указывается ссьmка на родительское окно.
Класс QSystemTrayicon поддерживает следующие основные методы:
♦ isSystemTrayAvailaЫe () - статический, возвращает значение True, если область уве-
домлений доступна, и Faise - в противном случае;
♦ seticon(<Значок Qicon>) -устанавливает заданный значок;
♦ icon() -возвращает значок (объект класса Qicon);
♦ setContextMenu(<Меню QMenu>) - устанавливает заданное меню у значка в качестве кон
текстного, отображаемого при щелчке правой кнопкой мыши;
Глава 28. Создание SDI- и МО/-программ 695
♦ contextMenu() - возвращает ссылку на контекстное меюо значка (объект класса QMenu);
♦ setToolTip(<Текст>) -задает текст всплывающей подсказки;
♦ toolTip() - возвращает текст всплывающей подсказки;
♦ · setVisiЫe(<Флаг>) - если в качестве параметра указа.но значение тrue, значок будет
выведен на экран, а если False - то скрыт. Метод является слотом;
♦ show() - отображает значок. Метод является слотом;
♦ hicte() - скрывает значок. Метод является слотом;
♦ isVisiЫe() - возвращает значение тrue, если значок присутствует на экране, и False -
в противном случае;
♦. geometry() - возвращает объект класса QRect с размерами и координатами значка на
экране;
♦ supportsMessages() - статический, возвращает значение True, если поддерживается
вывод сообщений, и False - в противном случае;
♦ showМessage() - вьmодит сообщение в области уведомлений. Форматы метода:
shоwМеssаgе(<Заголовок>, <Текст сообщения>[, icon=Messagelcon.Information] [,
msecs= l0000])
shоwМеssаgе(<Заголовок>, <Текст сообщения>, <Значок Qicon>[, msecs=l0000])
В первом формате необязательный параметр icon задает значок, который отображается
слева от заголовка сообщения. В качестве значения можно указать следующие элементы
перечисления Messagelcon из класса QSystemTrayicon: Nolcon (без значка), Information,
Warning или Critical.
Во втором формате третьим параметром можно указать произвольный значок.
Необязательный параметр msecs задает промежуток времени, в течение которого сооб
щение будет присутствовать на экране. Обратите внимание, что сообщение может не
показываться вообще, кроме того, значение параметра msecs в некоторых операционных
системах игнорируется.
Метод является слотом.
Класс QSystemтrayicon поддерживает следующие сигналы:
♦ activated(<Причина>) - генерируется при щелчке мышью на значке. Внутри обработ
чика через параметр доступна причина в виде значения одного из следующих элементов
перечисления ActivationReason из класса QSystemтrayicon:
• Unknown - неизвестная причина;
• Context - нажата правая кнопка мыши;
,• DouЫeClick - двойной щелчок мышью;
• Trigger - нажата левая кнопка мыши;
• MiddleClick - нажата средняя кнопка или колесико мыши;
♦ messageClicked () - генерируется при щелчке мышью на сообщении.
ГЛАВА 29
Мультимедиа
Библиотека PyQt предоставляет развитые средства воспроизведения звука и видео. Для это
го она задействует мультимедийную подсистему Windows Media Foundation, входящую
в состав Windows. Следовательно, все форматы, поддерживаемые операционной системой,
будут гарантированно поддерживаться и PyQt.
Все описанные в этой главе классы объявлены в модуле QtMultimedia, если не указано иное.
29.1. Воспроизведение мультимедиа
29.1.1. Мультимедийный проигрыватель
Класс QMediaPlayer реализует полнофункциональный мультимедийный проигрыватель,
позволяющий воспроизводить как з�ук, так и видео из файлов и сетевых источников. Един
ственный его недостаток заключается в том, что он не предоставляет никакого интерфейса
для управления воспроизведением: ни кнопок запуска, остановки и паузы, ни регулятора
громкости, ни индикатора текущей позиции воспроизведения. Все зто придется делать
самостоятельно.
Иерархия наследования для класса QMediaPlayer выглядит так:
QObject - QMediaPlayer
Формат вызова конструктора:
QМediaPlayer([parent=None])
В параметре parent может быть указана ссылка на родительский компонент.
Класс QMediaPlayer поддер'ЖИВает следующие наиболее полезные ·для нас методы (полный
их список �южно найти на странице https://doc.qt.io/qt-6/qmediaplayer.html):
♦ setAudioOutput (<Звуковой выход>) - соединяет мультимедийный проигрыватель с за
данным звуковым выходом (объект класса QAudioOutput, описываемого в разд. 29.1.2);
♦ audioOutput() - возвращает звуковой выход, с кот.орым в настоящий момент- соединен
текущий проигрьmатель, в виде объекта класса QAudioOutput;
♦ setVideoOutput (<Видеопанель>) - задает видеопанель, в которой будет выводиться
видео (объект класса QVideoWidget, описываемого в разд. 29.1.4). Используется лишь
. при воспроизведении видео;
Глава 29. Мультимедиа 697
♦ videooutput() - возвращает видеопанель, с которой в настоящий момент соединен
текущий проигрыватель, в виде объекта класса QVideoWidget;
♦ setsource(<Путь QUrl>) - задает путь к источнику (локальному мультимедийному
файлу или сетевому ресурсу), который будет воспроизводиться. Если передать «пустой»
объект класса QUrl, заданный ранее источник будет закрыт. Пример задания источника
файла:
mp = QtMultimedia.QMediaPlayer()
те = QtCore.QUrl.fromLocalFile(r"c:\media\songl.mpЗ")
mp.setSource(mc)
Пример задания сетевого источника:
mp.setSource(QtCore.QUrl(r"https://www.someradio.ru/audio.mpЗ"))
Метод является.слотом;
♦ source() -возвращает заданный путъ к источнику (объект класса QUrl);
♦ play() - начинает или возобновляет воспроизведение мультимедиа. Метод Яlщяется
слотом;
♦ pause() - приостанавливает воспроизведение мультимедиа. Метод является слотом;
♦ stop() -останавливает воспроизведение мультимедиа и перемещает позицию воспро
изведения на начало. Метод .является слотом;
♦ playbackState() -возвращает текущее состояние проигрывателя в виде значения одно
го из следую щих элементов перечисления PlaybackState из класса QMediaPlayer:
• stoppedState -воспроизведение либо остановлено, либо еще не начиналось;
• PlayingState - идет воспроизведение;
• PausedState -воспроизведение приостановлено;
♦ duration() - возвращае� продолжительность воспроизведения мультимедиа в милли
секундах;
♦ position() - возвращает текущую позицию воспроизведения мультимедиа в милли
секундах;
♦ isSeekaЫe() -возвращает True, если имеется возможность изменить позицию воспро
изведения, и False, если источник этого не поддерживает;
♦ setPosition(<Позиция>) -задает текущую позицию воспроизведения в миллисекундах.
Метод является слотом;
♦ setPlaybackRate(<Скорость>) - задает скорость воспроизведения мультимедиа. Значе
ние параметра должно представлять собой вещественное. число, умножаемое на стан
дартную скорость воспроизведения, чтобы получить ее новую величину. Значение 1. о
задает стандартную скорость, меньшее 1 . о - уменьшенную скорость, а большее 1 .о -
увеличенную. Метод является слотом;
♦ playbackRate() -возвращает текущую скорость воспроизведения мультимедиа;
♦ setLoops(<Количество>) - задает количество повторений воспроизвоДЯ1Цегося мульти
медиа в виде целого числа. По умолчанию источник воспроизводится один раз. Если
указать число -1, источник будет воспроизводиться бесконечно; .
♦ loops() - возвращает количество повторений воспроизведения мультимедиа в виде
целого числа;
698 Часть 11. Библиотека PyQt б
♦ mediaStatus () - возвращает состояние источника в виде значения одного из следую
щих элементов перечисления MediaStatus из класса QMediaPlayer:
• NoMedia - источник отсутствует;
• LoadingMedia - идет загрузка источника;
• LoadedМedia - источник загружен;
• stalledМedia - воспроизведение приостановлено из-за опустошения внутреннего
буфера проигрывателя или невозможности загрузить следующую порцию данных;
• вufferingMedia - идет заполнение данными внутреннего буфера проигрывателя,
однако данных достаточно для продолжения воспроизведения;
• BufferedМedia - внутренний буфер заполнен, идет воспроизведение;
• EndOfМedia - воспроизведение источника закончено;
• Invalictмedia - источник не может быть воспроизведен (неподдерживаемый формат
мультимедийных данных, поврежденный файл и т. п.);
♦ hasAudio () - возвращает True, если источник содержит звук, и False - в противном
случае. О.бычно используется при воспроизведении видеороликов, чтобы узнать, имеют
ли они звуковое сопровождение;
♦ hasVideo (_) - возвращает True, · если источник содержит видео, и False - в противном
случае;
♦ bufferProgress () - возвращает процент заполнения внутреннего буфера проигрывате
ля в виде вещественного числа от о . о до 1. о;
♦ error () - возвращает обозначение ошибки, возникшей при воспроизведении мульти
медиа, в виде одного из следующих элементqв перечисления Error из класса
QМediaPlayer:
• NoError - никакой ошибки не возникло;
• ResourceError - некорректный путь или интернет-адрес источника;
• FormatError - неподдерживаемый формат звука или видео;
• NetworkError - сетевая ошибка;
• AccessDeniedError - недостаточно прав для загрузки источника;
♦ errorString () - возвращает текстовое описание ошибки;
♦ metaData () - возвращает метаданные воспроизводящегося в текущий момент источни
ка в виде объекта класса QMediaмetaData (описан в разд. 29.1.3);
♦ audioTracks () - возвращает список со всеми звуковыми дорожками, имеющимися
в воспроизводящемся источнике и представленными объектами класса QMediaмetaData;
♦ videoтracks () - возвращает список со всеми видеодорожками, имеющимися в воспро
изводящемся источнике и представленными объектами класса QMectiaмetaData;
♦ suЬtitleтracks () - возвращает список со всеми дорожками субтитров, имеющимися
в воспроизводящемся источнике и представленными объектами класса QМectiaмetaData;
♦ setActiveAudioTrack (<Индекс>) - выбирает для воспроизведения звуковую дорожку
с указанным индексом;
♦ activeAudioTrack () - возвращает индекс воспроизводящейся в текущий момент звуко
вой дорожки;
Глава:29. Мультимедиа 699
♦ · setActiveVideoтrack (<Индекс>) - выбирает для воспроизведения видеодорожку с ука
занным ·индексом;
♦ activeVideoTrack() - возвращает индекс воспроизводящейся в текущий момент видео
дорожки;
♦ setActiveSuЬtitleTrack(<Индекс>) - выбирает для воспроизведения дорожку субтит
ров с указанным индексом;
♦ activeSuЬtitleTrack() - возвращает .индекс воспроизводящейся в текущий момент
дорожки субтитров.
Класс QMediaPlayer поддерживает большое количество сигналов, из которых для нас пред
ставляют интерес лишь приведенные далее (полный их список можно найти на странице
https://doc.qt.io/qt-6/qmediaplayer.html):
♦ sourceChanged(<Путь QUrl>) - генерируется при указании другого источника. Путь
к новому источнику передается в параметре;
♦ durаtiоnСhаngеd(<Продолжительность>) - генерируется при первом получении или из
менении продолжительности источника. Новое значение продолжительности, заданное
целым числом в миллисекундах, передается обработчику в параметре;
♦ playbackStateChanged(<Состояние PlaybackState>) - генерируется при изменении со
сто� проигрывателя. В параметре обработчику передается новое состояние;
♦ positi<:>nChanged(<Позиция>) - генерируется при изменении позиции воспроизведения.
· В параметре обработчику передается новая позиция в виде целого числа в миллисекун
дах;
♦ mediaStatusChanged(<Состояние MediaStatus>) - генерируется при изменении состоя
ния источника. Новое обозначение состояния передается в параметре;
♦ playbackRateChanged(<Скорость>) - генерируется при изменении скорости воспроизве
дения. В параметре передается новое значение скорости воспроизведения, представлен
ное вещественным числом;
♦ bufferProgressChanged(<Процент>) - генерируется при изменении процента заполнения
внутреннего буфера проигрывателя. Новая величина процента заполнения в виде веще
ственного числа от о. о до 1 . о передается в параметре;
♦ errorOccured(<Ошибка Error>, <Описание>) - генерируется при возникновении ошиб
ки. В параметрах передаются обозначение возникшей ошибки и ее строковое описание;
♦ metaDataChanged() - генерируется при изменении метаданных ролика.
29.1.2. Звуковой выход. Воспроизведение звука
Класс QAudioOutput представляет звуковой выход, через который выполняется вьшод звука.
Иерархия наследования для этого класса:
QObject - QAudioOutput
Формат вызова юонструктора:
QAudioOutput( [parent=None])
В параметре parent может быть указана ссьшка на родительский компонент.
Звуковой выход, представляемый этим классом, изначально выводит звук на устройство
вывода звука, помеченное в настройках операционной системы как используемое по умол-
700 Часть 11. Библиотекд PyQt б
чанию. Однако звуковому выходу можно указать выводить звук на любое другое доступное
устройство.
Выяснить, какие устройства вывода звука существуют на текущей платформе, позволяют
следующие статические методы класса QMediaDevices:
♦ audioOUtputs() - возвращает список доступных устройств вывода звука, представляе
МЬIХ объектами класса QAudioDevice (описан далее) :
>>> dlist = QtMultimedia.QМediaDevices.audioOutputs()
>>> for d in dlist: print(d.description())
динамики (2- High Definition Audio Device)
PHL 276EBV (NVIDIA High Definition Audio)
Цифровое аудио (S/PDIF) (2- High Definition Audio Device)
Цифровое аудио (S/PDIF) (2- High Definition Audio Device)
♦ defaultAudioOUtput() - возвращает устройство вывода звука, помеченное как исполь
зуемое по умолчанmо (объект класса QAudioDevice):
.>>> QtMultimedia.QМediaDevices.defaultAudioOutput().description()
'динамики (2- High Definition Audio Device)'
Класс QAudioDevice представляет доступное на текущей платформе устройство для. вывода
звука. Метод description () этого класса возвращает строковое название текущего устрой
ства вывода звука. Полное описание класса QAudioDevice приведено на странице
https://doc.qt.io/qt-6/qaudiodevice.html.
Класс QAudioOutput поддерживает следующие полезные методы:
♦ setVolume (<Громкость>) - задает громкость звука в виде вещественного числа от о. о
(звук отключен) до 1.0 (максимальная громкость) . Метод является слотом;
♦ volume() - возвращает громкость звука в виде вещественного числа от о.о до 1.о;
♦ setMuted(<Флаг>) - если передать значение True, звук будет отключен. Значение False
восстанавливает прежmою громкость. Метод является слотом;
♦ isMuted() - возвращает True, если звук в настоящее время отключен, и False - в про
тивном случае;
♦ setDevice(<Устройство QAudioDevice>) - назначает текущему звуковому ВЬIХОду за
данное устройство вывода звука:
ао = QtMultimedia.QAudioOutput(parent=self)
dlist = QtMultimedia.QМediaDevices.audioOUtputs()
·ao .setDevice(dlist[l])
♦ device() - возвращает устройство вывода звука, назначенное у текущего звукового
вьIХода (объект класса QAudioDevice).
Еще этот класс поддерживает такие сигналы:
♦ volumeChanged(<Гpoмкocть>) - генерируется при изменении громко.сти. В параметре
передается новое значение громкости в виде вещественного числа от о .о до 1. о;
♦ mutedChanged(<Флаг>) - генерируется при отключении или, напротив, включении звука.
В параметре передается значение True, если звук отключен, или False, если вновь вклю
чен;
Глава 29. Мультимедиа 701
♦ deviceChanged() - генерируется при указании у звукового выхода другого устройства
вывода звука.
Соединить проигрыватель со звуковым вь�ходом,можно вызовом метода setAudioOutput(<Зву
ковой выход QAudioOutput>) класса QMediaPlayer.
Простейший аудиопроигрыватель (листинг 29.1) содержит кнопку для открытия звукового
файла, кнопки пуска, паузы и остановки воспроизведения, регулятор текущей позиции вос
произведения, регулятор громкости и кнопку временного откmочения звука (рис. 29.1).
ii] Аудиопроиrрыватель Х
Рис. 29.1. Аудиопроигрыватель
from PyQtб import QtCore, QtWidgets, QtMultimedia
import sys
class MyWindow(QtWidgets.QWidget):
def _init_(self, parent=None):
QtWidgets.QWidget. init (self, parent,
flags=QtCore.Qt.WindowType.Window
QtCore.Qt.WindowType.MSWindowsFixedSizeDialogHint)
self.setWindowТitle("Ayдиoпpoигpывaтeль")
# Создаем устройство вывода звука
self.aOutput = QtMultimedia.QAudioOutput(parent=self)
seif.aOutput.setVolume(0.5)
# Создаем сам проигрыватель
self.mplPlayer = QtMultim�dia.QМediaPlayer(parent=self)
self.mplPlayer.setAudioOutput(self.aOutput)
self.mplPlayer.mediaStatusChanged.connect(self.initPlayer)
self.mplPlayer.playbackStateChanged.connect(self.setPlayerState)
vbox = QtWidgets:QvвoxLayout()
# Создаем кнопку открытия файла
btnOpen = QtWidgets.QPushВutton("&Oткpыть файл...")
btnOpen.clicked.connect(self.openFile)
vbox.addWidget(btnOpen)
# Создаем компоненты для управления воспроизведением.
# Делаем их изначально недоступными
self.sldPosition = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)
self.sldPosition.setMinimum(0)
self.sldPosition.valueChanged.connect(self.mplPlayer.setPosition)
self.mplPlayer.positionChanged.connect(self.sldPosition.setValue)
702 Часть 11. Библиотека PyQt 6
self.sldPosition.setEnaЫed(False)
vbox.addWidget(self.sldPosition)
hЬох = QtWidgets.QHBoxLayout()
self.btnPlay = QtWidgets.QPushButton("&Пycк")
self.btnPlay.clicked.connect(self.mplPlayer.play)
self.btnPlay.setEnaЫed(False)
hЬox.addWidget(self.btnPlay)
self.ЬtnPause = QtWidgets.QPushButton("П&ayзa")
self.ЬtnPause.clicked.connect(self.mplPlayer.pause)
self.ЬtnPause.setEnaЫed(False)
hЬox.addWidget(self.ЬtnPause)
self.ЬtnStop = QtWidgets.QPushButton("&Cтon")
self.ЬtnStop.clicked.connect(self.mplPlayer.stop)
self.ЬtnStop.setEnaЫed(False)
hЬox.addWidget(self.ЬtnStop)
vbox.addLayout(hЬox)
# Создаем компоненты для управления громкостью
hЬох = QtWidgets.QHBoxLayout()
lЫVolume = QtWidgets.QLabel("&Гpoмкocть")
hЬox.addWidget(lЫVolume)
self.sldVolume = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)
self.sldVolume.setRange(0, 100)
self.sldVolume.setTickPosition(
QtWidgets.QSlider.TickPosition.TicksAЬove)
self.sldVolume.setTickinterval(l0)
self.sldVolume.setValue(50)
lЫVolume.setBuddy(self.sldVolume)
self.sldVolume.valueChanged.connect(self.setVolume)
hЬox.addWidget(self.sldVolume)
ЬtnМute = QtWidgets.QPushButton("&Tиxo!")
ЬtnМute.setCheckaЫe(True)
ЬtnМute.toggled.connect(self.aOutput.setMuted)
hЬox.addWidget(ЬtnМute)
vbox.addLayout(hЬox)
· self.setLayout(vbox)
self.resize(З00, 100)
# Для открытия файла используем метод getOpenFileUrl() класса
# QFileDialog, т. к. для указания источника у проигрывателя
# нам нужен путь к файлу, заданный в виде объекта класса QUrl
def openFile(self):
file = QtWidgets.QFileDialog.getOpenFileUrl(parent=self,
сарtiоn="Выберите звуковой файл",
filtеr="Звуковые файлы (*.mрЗ *.асЗ)")
if file[l]:
self.mplPlayer.setSource(file[0])
def initPlayer(self, state):
match- state:
Глава 29. Мультимедиа 703
case QtMultimedia.QМediaPlayer.MediaStatus.LoadedМedia:
# После загрузки файла подготавливаем проигрыватель
# для его воспроизведения
self.mplPlayer.stop()
self.btnPlay.setEnaЫed(True)
self.bbnPause.setEnaЬled(False)
self.sldPosition.setEnaЫed(True)
self.sldPosition.setMaximum(self.mplPlayer.duration())
case QtMultimedia.QМediaPlayer.MediaStatus.EndOfМedia:
# По окончании воспроизведения файла возвращаем
# проигрыв�тель в изначальное состояние
self.mplPlayer.stop()
self.sldPosition.setValue(0)
self.sldPosition.setEnaЫed(False)
self.btnPlay.setEnaЫed(False)
self.btnPause.setEnaЫed(False)
self.btnStop.setEnaЫed(False)
case QtMultimedia.QМediaPlayer.MediaStatus.NoMedia 1 \
QtMultimedia.QМediaPlayer.MediaStatus.InvalidМedia:
# Если файл не был загружен, отключаем компоненты,
# управлякщие воспроизведением
self.sldPosition.setValue(0)
self.sldPosition.setEnaЫed(False)
self.btnPlay.setEnaЫed(False)
self.btnPause.setEnaЫed(False)
self.btnStop.setEnaЫed(False)
# В зависимости от того, воспроизводится ли файл, поставлен
# ли он на паузу или остановлен, делаем соответствук:щие кнопки
# доступными или недоступными
def setPlayerState(self, state):
match state:
case QtMultimedia.QМediaPlayer.PlaybackState.StoppedState:
self.sldPosition.setValue(0)
self.btnPlay.setEnaЬled(True)
self.btnPause.setEnaЫed(False)
self.btnStop.setEnaЫed(False)
case QtMultimedia.QМediaPlayer.PlaybackState.PlayingState:
self.btnPlay.setEnaЫed(False)
self.btnPause.setEnaЫed(True)
self.btnStop.setEnaЫed(True)
case QtMultimedia.QМediaPlayer.PlaybackState.PausedState:
self.btnPlay.setEnaЬled(True)
self.btnPause.setEnaЫed(False)
self.btnStop.setEnaЫed(True)
def setVolume(self, value):
self.aOutput.setVolume(value / 100)
704 Часть 11. Библиотека PyQt б
# При закрытии окна останавливаем воспроизведение
def closeEvent(self, е):
self.mplPlayer.stop()
e.accept()
QtWidgets.QWidget.closeEvent(self, е)
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
29.1.3. Метаданные мультимедийного источника
Класс QMectiaмetaData представляет метаданные воспроизводящегося мультимедийного ис
точника, его отдельной звуковой, видеодорожки или дорожки субтитров. Он поддерживает
следующие полезные методы:
♦ value(<Ключ>) - возвращает метаданные, относящиеся к заданному ключу, или None,
если метаданных с таким ключом в источнике нет. Кточ задается в виде одного из ука
занных далее элементов перечисления Кеу из класса QMediaмetaData (рассмотрены наи
более часто используемые элементы - полный их список можно найти на странице
https://doc.qt.io/qt-6/qmediametadata.html). Если не указано обратное, возвращаемый
методом результат представляет собой строку, а слово «список» означает обычный спи
сок Python (объект класса list).
• Title - название произведения;
• Author - список авторов произведения;
• Comment - примечание;
• Description - описание;
• Genre - список жанров, к которым относится произведение;
• Date - дата выпуска произведения в виде объекта класса QDate;
• Language - язык произведения в виде элемента перечисления Language из класса
QLocale (модуль QtCore);
• • copyright - авторс!{Ие права создателей произведения;
• FileFormat - формат файла источника в виде элемента перечисления FileFormat из
класса QMediaFormat;
• Duration - продолжительность воспро,изведения источника в миллисекундах, задан
ная целым числом;
• AudioCodec - обозначение кодека, с помощью которого кодировался звук, в виде
элемента перечисления AudioCodec из класса QМediaFormat;
• AudioBitRate - битрейт звука в виде целого числа, измеряемый в битах в секуоду;
• AlbumTitle - название альбома, в который входит произведение;
• AlbumArtist - автор альбома;
• ContributingArtist - список исполнителей, занятых в записи альбома;
• Composer - список композиторов, произведения которых входят в альбом;
Глава 29. Мультимедиа 705
• LeadPerforrner - список в�дущих испщшителей, занятых в записи альбома;
• TrackNшnЬer - порядковый номер произведения в альбоме в виде целого числа;
• VideoCodec - обозначение кодека, с помощью которого кодировалось видео,_ в виде
элемента перечисления VideoCodec из класса QМediaForrnat;
• Resolution - размер видео в виде ·объекта класса QSize;
• VideoFrameRate - частота кадров видео в ·виде вещественного числа, измеряемая
в кадрах в секунду;
• VideoBitRate - битрейт видео в виде целого числа, измеряемый в битах в секунду.
Следует отметить, что в источнике совсем не обязательно будут присутствовать все эти
данные.
Получить метаданные, относящиеся к какому-либо ключу, также можно, обратившись
к объекту класса QMediaмetaData как к словарю:
md = mediaplayer.metaData()
media_title = md[QtMultimedia.QМediaмetaData.Key.Title]
♦ stringValue (<Ключ>) - аналогичен value (), только всегда возвращает результат в виде
строки;
♦ keys() - возвращает список ключей, содержащихся в текущем объекте.
ВНИМАНИЕ/
При вызове метода keys () происходит аварийное завершение программы. Вероятно, это
следствие ошибки, которая присутствует во фреймворке Qt и будет исправлена в его бу
дущих версиях.
♦ isEmpty() - возвращает True, если текущий объект не содержит метаданных, и False -
в противном случае.
Если требуется лишь получить метаданные из загруженного мультимедийного источника,
соединять проигрыватель со звуковым выходом необязательно.
В листинге 29.2 приведен код служебной утилиты, выводящей метаданные, которые хра
нятся в загруженном мультимедийном файле. В настоящий момент она выводит сведения
об открытом в ней аудиофайле (рис. 29.2).
!J] Метаданные х
Г
l ... ����-Qткры! Файл_..._-�-------·J
1
ь
Title: Born to Ье wild
Autfюr: Steppenwolf
Genre: Hard rock
Duration: 212872
AudioBitRate: 160000
AlbumТitle: Steppenwolf
ContributingArtist: Steppenwolf
TrackNumЬer: 5
Рис. 29.2. Утилита, выводящая метаданные мультимедийного файла
706 Часть 11. Библиотека PyQt б
. '
1181c'n1W� ..........�.
from PyQtб import QtCore, QtWidgets, QtMultirnedia
import sys
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent,
flags=QtCore.Qt.WindowТype.Window 1 ·
QtCore.Qt.WindowТype.MSWindowsFixedSizeDialogHint)
self.setWindowТitle("Meтaдaнныe")
self.mplPlayer � QtMultimedia.()-lediaPlayer(parent=self)
self.mplPlayer.metaDataChanged.connect(self.showМetadata)
vbox = QtWidgets.QVВoxLayout()
btnOpen = QtWidgets.QPushButton("&Oткpыть файл...")
btnOpen.clicked.connect(self.openFile)
vbox.addWidget(btnOpen)
# Создаем доступную только для чтения область редактирования,
# в которую будет выводиться результат
self.txtOutput = QtWidgets.QТextEdit()
self.txtOutput.setReadOnly(True)
vЬox.addWidget(self.txtOutput)
self.setLayout(vbox)
self.resize(З00, 250)
def openFile(self):
file = QtWidgets.QFileDialog.getOpenFileUrl(parent=self,
сарtiоn="Быберите звуковой файл",
filtеr="Звуковые файлы (*.mрЗ *.асЗ)")
if file[1]:
self.mplPlayer.setSource(file[0])
def showМetadata(self):
# как только метаданные будут получены...
# •••очищаем область редактирования...
self.txtOutput.clear()
# ...извлекаем объект с метаданными...
md = self.mplPlayer.metaData()
s = ""
# ...перебираем их в цикле...
for k in list(QtMultimedia.()-lediaмetaData.Key):
v = md.value(k)
# ...проверяем, действительно ли существует значение
# с таким ключом...
if v:
# ... если значение представляет собой список,
# преобразуем.его в строку...
if v is list:
v = ", ".join(v)
Гnа(!а 29. Мультимедиа ·707
# ..• формируем на о.сно,ве .значщ-�ий .текст...
s += "<strong>" + k.narne + "</strong>: "+ str(v)+ "<br>"
# ...и выводим его в область редактирования
self.txtOUtput.setHtml(s)
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
29.1.4. Видеопанель. Воспроизведение видео
Класс QVideoWidget, определенный в модуле QtMultimediaWidgets, представляет видео
панель, которая выводит воспроизводимое видео.
Иерархия наследования класса QVideoWidget выглядит следующим образом:
(QObject, QPaintDevice) - QWidget - QVideoWidget
А формат вызова его конструктора таков:
QVideoWidget( [parent=None])
В параметре parent может быть указана ссьmка на родительский компонент.
Методов класс QVideoWidget поддерживает относительно немного:
♦ setFullScreen(<Флаг>) - если передать значение True, воспроизводящееся видео займет
весь экран. Если передать значение False, оно займет лишь саму панель. Метод является
слотом;
♦ isFullScreen() - возвращает True, если воспроизводящееся видео занимает весь экран,
и False, если оно выводится лишь в самой панели;
♦ setAspectRatioMode(<Режим>) - задает режим управления соотношением сторон при
масштабировании видео. В качестве результата указывается один из следующих элемен
тов перечисления AspectRatioMode из модуля QtCore.Qt:
• IgnoreAspectRatio - соотношение сторон при масштабировании видео не соблюда
ется, в результате чего видео может выводиться сжатым или вытянутым;
• KeepAspectRatio - соотношение сторон соблюдается. Видео масштабируется так,
чтобы полностью вместиться в панель или экран, но при этом какая-то часть панели
или экрана может оказаться незанятой;
• KeepAspectRatioByExpanding - соотношение сторон соблюдается. Видео масштаби
руется так, чтобы полностью занять панель (экран), но при этом какая-то часть видео
может выйти за ее границы.
Метод является слотом;
♦ aspectRatioMode() - возвращает обозначение режима управления соотношением сто
рон при масштабировании видео.
Класс QVideoWidget поддерживает следующие сигналы:
♦ fullScreenChanged(<Флaг>) - генерируется при переключении видео из обычного в
полноэкранный режим или из полноэкранноrо в обычный. Через параметр передается
значение True, если видео выводится на весь экран, или False - в противном случае;
708 Часть 11. Библиотека PyQt б
♦ aspectRatioModeChanged( <Режим AspectRatioMode>) - генерируется при изменении
режима управления соотношением сторон у видео. Через параметр досrупно новое обо
значение режима.
Задать видеопанель у мультимедийного проигрывателя можно вызовом метода
setVideoOutput(<Видеопанель QVideoWidget>) класса QMediaPlayer.
Мъ1 можем превратить написанную ранее программу аудиопроигрывателя в инструмент для
воспроизведения видео (рис. 29.3). Для этого достаточно внести в ее код некоторые измене
ния (листинг 29.3) - добавленные и исправленные строки выделены здесь полужирным
1прифтом.
U Видеопроигрыватель· х
,----------·----··--
[ ---,
_ __ _ ______ Qткрыtь файл..._ ___ , ___ _· _ J
l, . :��� ______
' 'j [____ _ J:��----J
' [
[ромкость 1 Jихо!
_J
Рис. 29.3. Видеопроигрыватель
from PyQtб iшport Qtcore, QtWidgets, QtМultimedia, QtМultimediaWidgets
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
self.setWi.ndowТi tle( "Бидеопроигрыватель")
vbox.addWidget(btnOpen)
vwg = QtМultimediaWidgets.QVideoWidget()
vwg.setAspectRatiat-юde(QtCore.Qt.AspectRatiat-юde.КeepAspectRatio)
self.mplPlayer.setVideoOutput(vwg)
vЬох.addWidget(vwg)
self.sldPosition = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)
self.setLayout(vbox)
self.resize(З00, 300)
Глава 29. Мультимедиа 709
def openFile(self):
file = QtWidgets.QFileDialog.getOpenFileUrl(parent=self,
сарtiоn=11 Выберите
видеофайп••·,
filtе="Видеофайпы (* .avi * .mp4) ")
if file[l]:
self.mplPlayer .setSource(file[0J)
29.2. Запись мультимедиа
29.2.1. Транспорт
Класс QМediaCaptureSession представляет транспорт - механизм, который передает звук
и видео, полученные с камеры и микрофона, кодировщику, непосредственно кодирующему
мультимедиа и записывающему его в указанный файл. Иерархия наследования этого класса:
QObject - QМediaCaptureSession
Формат конструктора класса:
QМediaCaptureSession([parent=None])
В параметре parent может быть указана ссьшка на родите�ьский компонент.
Класс QMediaCaptureSession поддерживает следующие методы:
♦ setAudioinput(<Звуковой вход>) - соединяет текущий транспорт с заданным звуковым
входом (объект класса QAudioinput, описываемого в разд. 29.2.2);
♦ setRecorder (<Кодировщик>) - задает кодировщик звука и видео (объект класса
QМediaRecorder, описываемого в разд. 29.2.3);
♦ setcamera(<камера>) - соединяет транспорт с заданной камерой, с которой будет запи
сываться видео (объект класса QCamera, описываемого в разд. 29.2.5);
♦ setimageCapture(<Кодировщик>) - задает кодировщик, записывающий статичные изо
бражения (объект класса QimageCapture, описываемого в разд. 29.2.6);
♦ setAudioOutput(<Ус�ройство>) - соединяет транспорт с заданным устройством вывода
звука (объект класса QAudioOutput, описанного в разд. 29.1.1). Это устройство будет
использоваться для прослушивания записываемого звука в целях контроля;
♦ setVideoOutput(<Видеопанель QVideoWidget>) - соединяет транспорт с заданной видео
панелью (см. разд. 29.1.2). Она будет использоваться для просмотра записываемого ви-
део в целях контроля;
♦ audioinput() - возвращает устройство ввода звука, с которым соединен текущий
транспорт, в виде объекта класса QAudioinput;
♦ recorder () - возвращает заданный у транспорта кодировщик звука и видео в виде
объекта класса QMediaRecorder;
♦ camera() - возвращает камеру, с которой соединен текущий транспорт, в виде объекта
класса QCamera;
♦ imageCapture() - возвращает кодировщик статичных изображений, заданный у транс
порта, в виде объекта класса QimageCapture;
♦ audioOutput() - возвращает устройство вывода звука, с которым соединен текущий
транспорт, в виде объекта класса QAudioOutput;
710 Часть -1/. БиблиотекаРуС}t 6
♦ videooutput () - возвращает видеопанель, с которой соединен текущий транспорт,
в виде объекта класса QVideoWidget.
Класс QMediaCapturesession также поддерживает несколько не очень полезных для нас сиг
налов, описанных на странице https://doc.qt.io/qt-6/qmediacapturesession.html.
29.2.2. Звуковой вход
Класс QAudioinput служит для получения записываемого звука
· и' полностью
· аналогичен
классу QAudioOutput, описанному вразд. 29.1.2.
Звуковой вход изначально захватывает звук с устройства ввода,, помеченного в настройках
операционной системы как используемое по умолчанию. Однако можно указать ему захва
тывать звук с любого другого устройства ввода, доступного на текущей платформе.
Выяснить, какие устройства ввода звука существуют на текущей платформе, позволяют
следующие статические методы класса QMediaDevices:
♦ audioinputs() - возвращает список доступных устройств ввода звука, представляемых
объектами класса QAudioDevice (см.разд. 29.1.2):
>>> dlist = QtMultirnedia.QMediaDevices.audioinputs()
>>> for d in dlist: print(d.description())
Микрофон ( SGЗЗО)
Головной телефон (RВ-НХ220В Hands-Free AG Audio)
♦ defaultAudioinput() - возвращает устройство ввода звука, помеченное как используе-
мое по умолчанию (объект класса QAudioDevice):
>>> QtMultirnedia.QMediaDevices.defaultAudioinput().description()
'Микрофон (SGЗЗО)'
Назначить у звукового входа другое устройство ввода звука можно вызовом метода
setDevice(<Звуковой вход QAudioDevice>) класса QAudioinput:_
ai = QtMultirnedia.QAudioinput(parent=self)
dlist = QtMultirnedia.QMediaDevices.audioinputs()
ai.setDevice(dlist[l])
Соединить транспорт со звуковым входом можно вызовом метода setAudioinput(<Звуковой
вход QAudioinput>) класса QМediaCaptureSession.
29.2.3. Кодировщик звука и видео
Класс QMediaRecorder представляет кодировщик, кодирующий получаемые от транспорта
звук и видео и записывающий их в заданный файл. Его иерархия наследования выглядит
чк:
QObj ect - QMediaRecorder
Формат конструктора этого класса:
QAudioRecorder([parent=None] )
В параметре parent может быть указана ссьшка на родительский компонент.
Глава 29. Мультимедиа 711
Класс поддерживает следующие полезные методы (полный их список приведен на странице
https://doc.qt.io/qt-6/qmediarecorder.html):
♦ setOUtputLocation(<Пyть QUrl>) - задает путъ,к файлу, в котором будет сохраняться
записываемое мультимедиа;
♦ setMediaFo:пnat(<Формат>) - задает формат результирующего файла, алгоритмы коди
рования звука и видео в виде объекта класса QМediaFo:пnat (будет описан далее);
♦ setEncodingМode(<Режим>) - задает режим кодирования в виде одного из следующих
элементов перечисления EncodingMode из класса QMediaRecorder:
• ConstantQualityEncoding - кодирование с постоянным качеством (реальный бит
рейт может немного отличаться от указанного);
• ConstantBitRateEncoding - с постоянным битрейтом;
• AverageBitRateEncoding - с переменным битрейтом (реальный битрейт может
варьироваться относительно указанного);
• ТWoPassEncoding - кодирование в два прохода;
♦ setQuality(<кaчecтвo>) - задает качество результирующего мультимедиа в виде одно
го из следующих элементов перечисления Quality из класса QМediaRecorder:
VeryLowQuality (очень низкое качество), LowQuality (низкое), No:пnalQuality (обычное -
значение по умолчаmпо), HighQuality (высокое) и VeryHighQuality (очень высокое).
Этот параметр принимается во внимание, если установлен режим �одирования
ConstantQualityEncoder;
♦ setAudioBitRate(<Битрейт>) - задает битрейт кодируемого звука в виде целого числа
в бит/с. Этот параметр принимается во внимание, если установлен режим кодирования,
отличный от ConstantQualityEncoder;
♦ setAudioChannelCount(<Количество>) - задает количество каналов кодируемого звука.
Если задать число -1, кодировщик сам выберет оптимальное количество каналов;
♦ setAudioSampleRate(<Частота>) - задает частоту дискретизации кодируемого звука
в виде целого числа в герцах (Гц). Если задать число -1, кодировщик сам выберет опти
мальную частоту дискретизации;
♦ setVideoBitRate(<Битрейт>) - задает битрейт кодируемого видео в виде целого числа
в бит/с;
♦ setVideoResolution() - задает размерь� изображения у кодируемого видео в пикселах.
Форматы метода:
setVideoResolution(<Paзмepы QSize>)
setVideoResolution(<Шиpинa>, <ВЫсота>)
Если при вызове в первом формате передать методу объект класса QSize с нулевыми
размерами, кодировщик сам выберет оптимальные размеры видео;
♦ setVideoFrameRate(<Частота>) - задает частоту кадров кодируемого видео в герцах
(Гц). Если задать о, кодировщик сам выберет оптимальную частоту кадров;
♦ isAvailaЫe() - возвращает True, если кодировщик готов к работе, и False - в про
тивном случае;
♦ record() - запускает или возобновляет запись мультимедиа. Метод является слотом;
♦ pause() - приостанавливает запись. Метод является слотом;
712 Часть 11. Библиотека PyQt б
♦ stop() - останавливает запись. Метод является с.лотом;
♦ recorderState() - возвращает текущее состоЯiше кодировщика в виде значения одного
из следующих элементов перечисления RecorderState из класса QMediaRecorder:
• stoppedState - запись мультимедиа не выполняется;
• RecordingState - идет запись;
• PausedState - запись приостановлена;
♦ duration () - возвращает продолжительность записанного мультимедиа в виде целого
числа в миллисекундах;
♦ error() - возвращает обозначение возникшей при записи мультимедиа ошибке в виде
одного из следующих элементов перечисления Error из класса QMediaRecorder:
• NoError - ошибки не возникло;
• ResourceError - устройство захвата звука или видео отсутствует или недоступно;
• FormatError - заданный формат файла, алгоритм кодирования звука или видео не
поддерживается на текущей платформе;
• OUtOfSpaceError - не хватает места на диске для сохранения результирующего файла;
• LocationNotWritaЫe - местоположение результирующего файла не доступно для
записи;
♦ errorString() - возвращает строковое описание возникшей ошибки.
Класс QMediaRecorder поддерживает следующие полезные сигналы (полный их список
можно найти на странице https://doc.qt.io/qt-6/qmediarecorder.html):
♦ durationChanged(<Продолжительность>) - генерируется при изменении продолжитель
ности записанного мультимедиа. В параметре передается новое значение продолжитель
ности, заданное целым числом в миллисекундах;
♦ recorderStateChanged(<Состояние RecorderState>) - генерируется при изменении со
стояния записи мультимедиа. В параметре передается обозначение нового состояния;
♦ errorOccured(<ошибка Error>, <Описание>) -'- генерируется при возникновении ошиб
ки. В параметрах передаются обозначение возникшей ошибки и ее строковое описание;
♦ actualLocation Changed(<Пyть QUrl>) - генерируется при указании другого файла для
сохранения записанного мультимедиа. В параметре передается путь к новому файлу.
Соединить транспорт с кодировщиком можно вызовом метода setRecorder(<Кодировщик
QМediaRecorder>) класса QMediaCapturesession.
29.2.4. Указание форматов кодирования. Запись звука
Класс QMediaFormat служит для указания формата файла, в котором будет сохраняться запи
сываемое мультимедиа, и алгоритмов кодирования звука и видео. Форматы конструктора
этого класса:
QМediaFormat([<Фopмaт фaйлa>=FileFormat.Un specifiedFormat])
QМediaFormat(<Иcxoдньiй объект QМediaFormat>)
В первом формате вызова формат файла задается в виде одного из следующих элементов
перечисления FileFormat из класса QMediaFormat: WМА, мс, Matroska, wмv, МРЗ, Wave, Ogg,
Глава 29. Мультимедиа 713
MPEG4, AVI, QuickTime, WеЬМ, Mpeg4Audio, FIAC или UnspecifiedFormat (формат не задан -
значение по умолчанmо).
Второй формат вызова конструктора создает копию указанного объекта.
Класс поддерживает следующие полезные методы (их полный список приведен на странице
https://doc.qt.io/qt-6/qmediaformat.html):
♦ supportedFileFormats(<Операция>) - возвращает список обозначений форматов фай
лов, с которыми можно выполнить заданную операцию. Параметр <Операция> указыва
ется в виде следующего элемента перечисления ConversionМode из класса QmediaFormat:
Encode (кодирование, т. е. запись) или Decode (декодирование, т. е. воспроизведение).
Пример получения форматов файлов, запись в которые поддерживается на компьютере
одного из авторов:
>>> mf = QtMultimedia.QМediaFormat()
.>>> flist = mf.supportedFileFormats(
QtMultimedia.QМediaFormat.ConversionМode.Encode)
>>> for f in flist: pri.nt(f.name, end=" ")
Mpeg4Audio МРЗ МС WМА WМV MPEG4· FIAC
♦ supportedAudioCodecs(<Операция ConversionМode>) - возвращает список обозначений
алгоритмов кодирования звука, с которыми можно выполнить заданную операцию. Обо
значения алгоритмов представляются следующими элементами перечисления
AudioCodec из класса QMediaFormat: WМА, АСЗ, мс, AIAC, DolbyТrueHD, ЕАСЗ, МРЗ, Wave,
Vorbls, FIAC, Opus или Unspecified (алгоритм не задан). Пример:
>>> flist = mf.supportedAudioCodecs(
QtMultimedia.QМediaFormat.ConversionМode.Encode)
>>> for f in flist: print(f.name, end=" ")
FIAC МС МРЗ АСЗ WМА AIAC
♦ supportedVideoCodecs(<Операция Conv�rsionМode>) - возвращает список обозначений
алгоритмов кодирования видео, с которыми можно выполнить заданную операцию.
Обозначения алгоритмов представляются следующими элементами перечисления
VideoCodec из класса QMediaFormat: VPB, MPEG2, MPEGl, wмv, Н265, Н264, MPEG4, AVl,
MotionJPEG, .vP9;Theora или unspecified (алгоритм не указан). Пример:
>>> flist = mf.supportedVideoCodecs(
QtMultimedia.QMediaFormat.ConversionМode.Encode)
>>> for f in flist: print(f.name, end=" ")
Н264 WМV
♦ setFileFormat(<Формат FileFormat>) - задает формат файла;
♦ setAudioCodec(<Алгоритм AudioCodec>) - задает алгорИЦ,1 кодирования звука;
♦ setVideoCodec(<Алгоритм VideoCodec>) -задает алгоритм кодирования видео.
Напишем программу-диктофон (листинг 29.4), записывающую звук с устройства ввода по
умолчанию и сохраняющую его в файле формата МРЗ в минимальном качестве {рис. 29.4).
714 Часть 11. Библиотека PyQt б
iiJ Запись звука Х
2iщж;ь [ П�уэа . J[ kтоп ]
lровень записи 1·
Записано 6 секунд
Рис. 29.4. Программа-диктофон
from PyQtб import QtCore, QtWidgets, QtMultimedia
import· sys, os
class MyWindow (.QtWidgets. QWidget) :
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent,
flags=QtCore.Qt.WindowТype.Window
Q�Core.Qt.WindowТype.MSWindowsFixedSizeDialogHint)
self.setWindowТitle("Зaпиcь звука")
# Создаем транспорт, звуковой вход и кодировщик
mcs = QtMultimedia.QMediaCaptureSession(parent=self)
self.ainput = QtMultimedia.QAudioinput(parent=self)
self.ainput.setVolume(l.O)
mcs.setAudioinput(self.ainput)
self.ardRecorder = QtMultimedia.QМediaRecorder(parent=self)
mcs.setRecorder(self.ardRecorder)
# Звук будет сохраняться в файле record.mpЗ, находящемся
# в той же папке, где хранится программа
fn = QtCore.QUrl.fromLocalFile(os.path.abspath("record.mpЗ"))
self.ardRecorder.setOUtputLocation(fn)
# Указываем формат файла МРЗ
mf = QtMultimedia.QМediaFormat(
QtMultimedia.QMediaFormat..FileFormat.МРЗ)
mf.setAudioCodec(QtMultimedia.QMediaFormat.AudioCodec.MPЗ)
self.ardRecorder.setMediaFormat(mf)
# Задаем параметры кодирования звука
self.ardRecorder.setQцality(
QtMultimedia.QМediaRecorder.Quality.LowQuality)
self.ardRecorder.setEncodingMode(
QtMultimedia.QМediaRecorder.EncodingMode.ConstantQualityEncoding)
self.ardRecorder.setAudioChannelCount(l)
self.ardRecorder.setAudioSampleRate(-1)
self.ardRecorder.recorderStateChanged.connect(self.initRecorder)
self.ardRecorder.dur�tionChanged.connect(self.showDuration)
# Создаем компоненты для запуска, приостановки и остановки
# записи звука и регулирования его уровня
vbox QtWidgets.QVВoxLayout()
hЬох = QtWidgets.QHBoxLayout()
Глава 29. Мультимедиа 715
self.ЬtnRecord = QtWidgets.QPushButton("&Зaпиcь")
self.ЬtnRecord.clicked.connect(self.ardRecorder.record)
hЬox.addWidget(self.ЬtnRecord)
self.ЬtnPause = QtWidgets.QPushButton("П&ayзa")
self.ЬtnPause.clicked.connect(self.ardRecorder.pause)
self.ЬtnPause.setEnaЫed(False)
hЬox.addWidget(self.ЬtnPause)
self.ЬtnStop = QtWidgets.QPushВutton("&Стоп")
self.ЬtnStop.clicked.connect(self.ardRecorder.stop)
self.ЬtnStop.setEnaЫed(False)
hЬox.addWidget(self.ЬtnStop)
vbox.addLayout(hЬox)
hЬох = QtWidgets.QHBoxLayout()
lЫVolume = QtWidgets.QLabe1("&Ypoвeнь записи")
hЬox.addWidget(lЫVolume)
self.sldVolume = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)
self.sldVolume.setRange(0, 100)
self.sldVolume.setTickPosition(
QtWidgets.QSlider.TickPosition.TicksAЬove)
self.sldVolume.setTickinterval(l0)
self.sldVolume.setValue(l00)
lЫVolume.setBuddy(self.sldVolume)
self.sldVolurne.valueChanged.connect(self.setVolume)
hЬox.addWidget(self.sldVolume)
vbox.addLayout(hЬox)
# Создаем надпись, в которую будет выводиться состояние программы
self.lЫStatus = QtWidgets.QLaЬel("Гoтoвo")
vbox.addWidget(self.lЫStatus)
self._setLayout(vbox)
self.resize(З00, 100)
# В зависимости от состояния записи звука делаем нужные
# кнопки доступными или, напротив, недоступными и выводим
# соответствук:щий текст в надписи
def initRecorder(self, state):
match state:
case QtMultimedia.QMediaRecorder.RecorderState.RecordingState:.
self.ЬtnRecord.setEnaЫed(False)
self.ЬtnPause.setEnaЫed(True)
self.ЬtnStop.setEnaЫed(True)
self.lЫStatus.setText("Зaпиcь")
case QtMultimedia.QMediaRecorder.RecorderState.PausedState:
self.ЬtnRecord.setEnaЫed(True)
self.ЬtnPause.setEnaЫed(False)
self.lЫStatus.setText("Пayзa")
case QtMultimedia.QMediaRecorder.RecorderState.StoppedState:
self.ЬtnRecord.setEnaЫed(True)
self.ЬtnPause.setEnaЫed(False)
self.ЬtnStop.setEnaЫed(False)
self.lЫStatus.setText("Гoтoвo")
716 Часть 11. Библиотека PyQt б
# Выводим продолжительность записанного звука
def showDuratioп(self, duration):
self.lЫStatus.setText("Зaпиcaнo " + str(duration // 1000) +
" секунд")
def setVolume(self, value):
selt'.ainput.setVolume(value / 100)
# При закрьгrии окна останавливаем запись
def closeEvent(self, е):
self.ardRecorder.stop()
e.accept()
QtWidgets.QWidget.closeEvent(self, е)
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow ()
window.show()
sys.exit(app.exec())
29.2.5. Камера. Запись видео
Класс QCamera представляет вцртуальную камеру, соединенную с указанным устройством
захвата видео (например, с веб-камерой). Иерархия наследования этого класса:
QObject - QCamera
Форматы конструктора этого класса:
QCamera( [parent=None])
QСаmеrа(<Местоположение камеры>[, parent=None])
QСаmеrа(<Устройство захвата видео>[, parent=None])
В параметре parent может быть указана ссылка на родительский компонент.
Первый формат создает камеру, которая будет захватывать видео с устройства, указанного
в настройках операционной системы как используемое по умолчанию.
Второй формат позволяет выбрать устройство захвата видео, задав его местоположение.
Последнее указывается в виде одного из следующих элементов перечисления Position из
класса QCameraDevice:
♦ UnspecifiedPosition - местоположение устройства не указано, и будет использовано
устройство по умолчанию;
♦ вackFace -устройство захвата видео, расположенное сзади (тыловая камера);
♦ FrontFace -устройство захвата видео, расположенное спереди (фронтальная камера).
Пример:
cam = QtMultimedia QCamera(QtMultimedia.QCameraDevice.Position.FrontFace)
Третий формат позволяет указать конкретное устройство, представленное объектом класса
QCameraDevice.
Выяснить, какие устройства захвата видео доступны на текущей платформе, позволяют
следующие статические методы класса QMediaDevices:
Глава 29. Мультимедиа 717
♦ videoinputs () - возвращает список доступных устройств захвата видео, представляе
мых объектами класса QCarneraDevice (будет описан далее):
>>> dlist = QtMultimedia.QМediaDevices.videoinputs()
>>> for d in dlist: print(d.description())
SGЗЗО
♦ defaultVideoinput() - возвращает устройство захвата видео, помеченное как исполь
зуемое по умолчанию (объект класса QCarneraDevice):
>>> QtМultimedia.QМediaDevices.defaultVideoinput().description()
'SGЗЗО'
Пример:
dlist = QtMultimedia.QМediaDevices.videoinputs()
carn = QtMultimedia.QCarnera(dlist[l])
Назначить у камеры другое устройство захвата видео можно вызовом метода
setCarneraDevice(<Камера QCarneraDevice>) класса QCarnera:
carn = QtMultimedia.QCarnera(parent=self)
dlist = QtMultimedia.QMediaDevices.videoinputs()
carn.setCarneraDevice(dlist[l])
Класс QCarneraDevice представляет доступное на текущей шштформе устройство для захвата
видео. Метод description() этого класса возвращает строковое название текущего устрой
ства. Полное описание класса QCarneraDevice приведено на странице https://doc.qt.io/qt-6/
qcameradevice.html.
Класс QCarnera поддерживает много методов, позволяющих, в частности, узнать характери
стики устройства захвата видео и указать некоторые его параметры, и ряд сигналов. Полное
описание этого класса приведено на странице https://doc.qt.io/qt-6/qcamera.html.
Соединить транспорт с камерой можно вызовом мето�а setCarnera (<Камера QCarnera>) клас
са QМediaCaptureSession.
После присоединения камеры к транспорту необходимо запустить захват видео этой каме
рой, вызвав метод start() класса QCarnera.
Напишем простую программу для записи видео
(листинг 29.5), которая станет сохранять записан- iil Запись видео Х
ное видео в минимальном качестве в файле фор
мата MPEG4, кодировать звук алгоритмом ААС, а
видео - алгоритмом Н264 (рис. 29.5). Ради про
стоты не будем реализовывать в ней регулировку
уровня записи звука.
Записано 7 .секунд
Рис. 29.5. Программа для записи видео
718 Часть 11. Библиотека PyQt 6
from PyQtб irnpo.rt QtCore, QtWidgets, QtMultimedia, QtMultimediaWidgets
import sys, os
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent,
flags=QtCore.Qt.WindowType.Window
QtCore.Qt.WindowType.MSWindowsFixedSizeDialogHint)
self.setWindowТitle("Зaпиcь видео")
# Создаем транспорт, звуковой вход, камеру и кодировщик
mcs = QtMultimedia.QMediaCaptureSession(parent=self)
self.ainput = QtMultimedia.QAudioinput(parent=self)
self.ainput.setVolume(l.0)
mcs.setAudioinput(self.ainput)
cam = QtMultimedia.QCamera(parent=self)
mcs.setCamera(cam)
self.ardRecorder = QtMultimedia.QMediaRecorder(parent=self)
mcs.setRecorder(self.ardRecorder)
# Запускаем захват видео созданной ранее камерой
cam.start()
# Видео будет сохраняться в файле movie.rnp4, находящемся
# в той же папке, где хранится программа
fn = QtCore.QUrl.fromLocalFile(os.path.abspath("movie.rnp4"))
self.ardRecorder.setOutputLocation(fn)
mf = QtMultimedia.QМediaFormat(
QtMultimedia.QMediaFormat.FileFormat.MPEG4)
mf.setAudioCodec(QtMultimedia.QMediaFormat.AudioCodec.AAC)
mf.setVideoCodec(QtMultimedia.QMediaFormat.VideoCodec.H264)
self.ardRecorder.setMediaFormat(mf)
# Задаем параметры кодирования звука и видео
self.ardRecorder.setQuality(
QtMultimedia.QMediaRecorder.Quality.LowQuality)
self.ardRecorder.setEncodingMode(
QtMultimedia.QMediaRecorder.EncodingMode.ConstantQualityEncoding)
self.ardRecorder.setAudioChannelCount(l)
self.ardRecorder.setAudioSarnpleRate(-1)
self.ardRecorder.setVideoResolution(QtCore.QSize())
self.ardRecorder.recorderStateChanged.connect(self.initRecorder)
self.ardRecorder.durationChanged.connect(self.showDuration)
vbox = QtWidgets.QVВoxLayout()
# Создаем контрольную видеопанель и связываем ее с транспортом
vwg = QtMultimediaWidgets.QVideoWidget()
vwg.setAspectRatioMode(QtCore.Qt.AspectRatioMode.KeepAspectRatio)
mcs.setVideoOutput(vwg)
vbox.addWidget(vwg, stretch=l)
# Создаем компоненты для запуска, приост�новки и остановки
# записи видео
hЬох = QtWidgets.QHBoxLayout()
self.ЬtnRecord = QtWidgets.QPushButton("&Зaпиcь")
Глава 29. Мультимедиа 719
self.btnRecord.clicked.connect(self.ardRecorder.record)
hЬox.addWidget(self.btnRecord)
self.btnPause = QtWidgets.QPushButton("П&ауза")
self.btnPause.clicked.connect(self.ardRecorder.pause)
self.btnPause.setEnaЫed(False)
hЬox.addWidget(self.btnPause)
se1f.ЬtnStop = QtWidgets.QPushВutton("&Cтoп")
self.ЬtnStop.clicked.connect(self.ardRecorder.stop)
self.ЬtnStop.setEnaЫed(False)
hЬox.addWidget(self.ЬtnStop)
vbox.addLayout(hЬox)
vbox.addLayout(hЬox)
# Создаем надпись, в которую будет выводиться состояние программы
self.lЫStatus = QtWidgets.QLabel("Гoтoвo")
vbox.addWidget(self.lЫStatus)
self.setLayout(vbox)
self.resize(З00, 280)
# В зависимости от состояния записи видео делаем нужные
# кнопки доступными или, напротив, недоступными и выводим
# соответствующий текст в надписи
def initRecorder(self, state):
match state:
case QtMultimedia.QMediaRecorder.RecorderState.RecordingState:
self.ЬtnRecord.setEnaЬled(False)
self.ЬtnPause.setEnaЫed(True)
self.ЬtnStop.setEnaЫed(True)
self.lЫStatus.setText("Зaпиcь")
case QtMultimedia.QМediaRecorder.R�corderState.PausedState:
self.ЬtnRecord.setEnaЫed(True)
self.ЬtnPause.setEnaЫed(False)
self.lЫStatus.setText("Пayзa")
case QtMultimedia.QMediaRecorder.RecorderState.StoppedState:
self.ЬtnRecord.setEnaЫed(True)
self.ЬtnPause.setEnaЬled(False)
self.ЬtnStop.setEnaЫed(False)
self.lЫStatus.setText("Гoтoвo")
# Выводим продолжительность записанного видео
def showDuration(self, duration):
self.lЫStatus.setText("Зaпиcaнo " + str(duration // 1000) + " секунд")
# При закрытии окна останавливаем запись
def closeEvent(self, е):
self.ardRecorder.stop()
e.accept()
QtWidgets.QWidget.closeEvent(self, е)
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
720 Часть 11. Библиотека PyQt 6
window.show()
sys.exit(app .exec())
29.2.6. Кодировщик статичных изображений. Захват фото
Класс QimageCapture представляет кодировщик статичных изображений, который получает
с камеры отдельные кадры и сохраняет их в графических файлах. Иерархия наследования:
QObject - QimageCapture
Формат конструктора класса:
QimageCapture( [parent=self] )
В параметре parent может быть указана ссылка на родительский компонент.
Класс QimageCapture поддерживает следующие методы (их полный список приведен на
странице https://doc.qt.io/qt-6/qimagecapture.html):
♦ s�tFileFormat(<Формат>) - задает формат результирующих файлов. В качестве пара
метра указывается один из следующих элементов перечисления FileFormat из класса
QimageCapture: JPEG, PNG, Tiff, WebP или UnspecifiedFormat (формат не указан - значе
ние по умолчанию);
♦ setQuality(<Kaчecтвo>) - задает качество результирующего изображения в виде одно
го из следующих элементов перечисления Quality из класса QimageCapture:
VeryLowQuality (очень низкое качество), LowQuality (низкое), NormalQuality (обычное -
значение по умолчанию), HighQuality (высокое) и VeryHighQuality (очень высокое);
♦ setResolution() - задает размеры результирующего изображения в пикселах. Форматы
метода:
setResolution(<Paзмepы QSize>)
setResolution(<Шиpинa>, <Высота>)
Если при вызове в первом формате передать методу объект класса QSize с нулевыми
размерами, кодировщик сам выберет оптимальные размеры изображения;
♦ isAvailaЫe() - возвращает True, если кодировщик готов к работе, и False - в про
тивном случае;
♦ captureToFile(<Путь к файлу>) __:, захватывает статичный кадр и сохраняет его в файле
с заданнь1м путем. Метод является слотом.
Вызов этого метода лишь запускает процесс захвата и сохранения статичного изображе
ния. После этого в течение какого-то времени кодировщик будет обрабатывать захва
ченнь1й кадр, и попытка выполнить захват нового кадра вызовом метода
captureToFile() приведет к возникновению ошибки с типом Error.NotReadyError.
Как только файл с захваченнь1м кадром будет сохранен, будет сгенерирован сигнал
imageSaved();
♦ capture() - захватывает статичный кадр и сохраняет его в памяти в виде объекта клас- ·
са Qimage. Это изображение впоследствии можно получить в обработчике сигнала
imageCaptured(). Метод является слотом
♦ isReadyForCapture() - возвращает True, если кодировщик в текущий момент готов
к захвату очередного статичного кадра, и False - если он еще обрабатывает кадр,
захваченный ранее;
Глава 29. Мультимедиа 721
♦ error {) - возвращает обозначение возникшей при захвате кадра ошибки в виде одного
из следующих элементов перечисления Error из класса QimageCapture:
• NoError - ошибки не возникло;
• NotReadyError - кодировщик не готов к работе, поскольку уже выполняет захват
и обработку статичного кадра;
• ResourceError - устройство захвата видео отсутствует или недоступно;
• FormatError - заданный формат файла не поддерживается на текущей платформе;
• Out0fSpaceError - не хватает места на диске для сохранения результирующего файла;
• NotSupportedFeatureError - выбранное устройство захвата видео не поддерживает
захват статичных изображений;
♦ errorstring {) - возвращает строковое описание возникшей ошибки.
Класс QimageCapture поддерживает следующие полезные сигналы (их полный список при
веден на странице https://doc.qt.io/qt-6/qimagecapture.html):
♦ imageCaptured {<Идентификатор>, <Изображение Qimage>) - генерируется сразу после
захвата статичного изображения и перед его сохранением в файле (если был выполнен
вызовом метода captureToFile() ). Через параметры передаются целочисленный иден
тификатор захваченного изображения и само это изображение;
♦ imаgеSаvеd{<Идентификатор>, <Путь к файлу>) - генерируется сразу после сохране�
захваченного кадра в файле. Через параметры передаются целочисленный идентифика
тор захваченного изображения и путь к созданному файлу;
♦ readyForCaptureChanged(<Флаг>) - генерируется при изменении состояния_ готовности
кодировщика к захвату кадра. В параметре передается значение тrue, если кодировщик
готов к захвату кадра, и False - если не готов;
♦ erroroccured {<Ошибка Error>, <Описание>) - генерируется при возникновении ошиб-
ки. В параметрах передаются обозначение возникшей ошибки и ее строковое описание.
Присоединить кодировщик статичных изображений к транспорту можно вызовом метода
setimageCapture(<Кодировщик QimageCapture>) класса QМediaCaptureSession.
В листинге 29.6 приведен код программы-«фотоаппараrа», которая захватывает статичные
кадры и сохраняет их в файлах формата JPEG, чьи имена представляют собой последова
тельно увеличивающиеся целые числа.
29.6. niюrpa
from PyQtб import QtCore, QtWidgets, QtMultimedia, QtMultimediaWidgets
import sys, os
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None)·:
QtWidgets.QWidget. init (self, parent,
flags=QtCore .Qt.WindowТype.Window
QtCore.Qt.WindowТype.MSWindowsFixedSizeDialogHint)
# Создаем счетчик захваченных изображений
self.counter = О
self.setWindowТitle("Зaxвaт фото")
722 Часть 11. Библиотека PyQt б
# Создаем транспорт, камеру и кодировщик
mcs = QtMultimedia.QMediaCaptureSession(parent=self)
cam = QtMultimedia.QCamera(parent=self)
mcs.setCamera(cam)
self.icCapture = QtMultimedia.QimageCapture(parent=self)
mcs.setimageCapture(self.icCapture)
cam.start()
# Задаем параметры сохранения изображений
self.icCapture.setFileFormat(
QtMultimedia.QimageCapture.FileFormat.JPEG)
self.icCapture.setQuality(
QtMultimedia.QimageCapture.Quality.HighQuality)
self.icCapture.setResolution(QtCore.QSize())
vbox = QtWidgets.QVВoxLayout()
# Создаем контрольную видеопанель и связываем ее с транспортом
vwg = QtMultimediaWidgets.QVideoWidget()
vwg.setAspectRatioMode(QtCore.Qt.AspectRatioMode.KeepAspeqtRatio)
mcs.setVideoOutput(vwg)
vbox.addWidget(vwg, stretch=l)
# Создаем кнопку для захвата изображения
self.ЬtnCapture = QtWidgets.QPushButton("&Cдeлaть фото")
self.ЬtnCapture.clicked.connect(self.captureimage)
self.icCapture.readyForCaptureChanged.connect(
self.ЬtnCapture.setEnaЫed)
vbox.addWidget(self.ЬtnCapture)
self.setLayout(vbox)
self.resize(320, 240)
def captureimage(self):
self.counter += 1
self.icCapture.captureToFile(
os.path.abspath(str (self.counter) + ".jpg"))
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
29.3. Воспроизведение звуковых эффектов
Звуковой эффект - это короткий звук, сообщающий пользоватеmо о наступлении какого
либо события (например, об окончании выполнения длительной операции).
Класс QSoundEffect представляет звуковой эффект. Его иерархия наследования:
QObject - QSoundEffect
Конструктор этого класса имеет следующие форматы вызова:
QSoundEffect( [parent=None])
QSoundEffect(<Ycтpoйcтвo вывода звука QAudioDevice>[, parent=None])
Глава 29. Мультимедиа 723
Первый формат соединяет создаваемый эффект с устройством для вывода звука, исполь
зуемым по умолчанию. Второй формат позволяет явно указать используемое устройство
вывода звука.
В параметре parent может быть указана ссьmка на родительский компонент.
Класс QSoundEffect поддерживает следующие основные методы (полный их список можно
найти на странице https://doc.qt.io/qt-6/qsoundeffect.html):
♦ setsource(<Путь QUrl>) -задает файл-источник воспроизводимого звука;
♦ setVolume (<Громкость>) -задает громкость воспроизводимого звука в виде веществен
ного числа от о.о (звук отключен) до 1.о (максимальная громкость - значение по
умолчанию);
♦ setLoopCount(<Количество>) - задает количество повторений звука при воспроизведе
нии. Значение о или 1 предписывает воспроизвести звук однократно, а значение -2 -
воспроизводить его бесконечное количество раз;
♦ setMuted(<Флаг>) - если передать значение True, звук при воспроизведении будет от
ключен. Значение False вновь включает звук;
♦ setAudioDevice (<Устройство вывода звука QAudioDevice>) - связывает текущий эф-
фект с заданным устройсuюм вывода звука;
♦ play () - запускает воспроизведение звука. Метод является слотом;
♦ stop() - останавливает воспроизведение звука. Метод является слотом;
♦ isLoaded() -возвращает True, если звук загружен из указанного в методе setsource()
файла, и False - в противном случае;
♦ isPlaying() -возвращает True, если звук в текущий момент воспроизводится, и False -
в противном случае;
♦ loopsRernaining() - возвращает количество оставшихся повторов воспроизведения зву
ка или значение -2, если было задано бесконечное воспроизведение;
♦ volume() - возвращает текущее значение громкости звука в виде вещественного числа
от о.о до 1.0;
♦ isMuted() - возвращает True, если воспроизводящийся звук в текущий момент отклю
чен, и False - в противном случае;
♦ status() -возвращает текущее состояние звука в виде значения одного из следующих
элементов перечисления Status из класса QSoundEffect:
• Null - источник звука не задан;
• Loading - идет загрузка звука из файла-источника;
• Ready -звук загружен и готов к воспроизведенmо;
• Error -в процессе загрузки звука возникла ошибка;
♦ supportedМirneTypes() - статический, возвращает список МIМЕ-типов поддерживаемых
форматов звука:
>>> for f in QtMultirnedia .QSoundEffect .supportedМirneTypes():
print(f, end=" ")
audio/x-wav audio/wav audio/wave· audio/x-pn-wav
724 Часть 11. Библиотека PyQt б
Класс QSoundEffect поддерживает следующие полезные сигналы (полный их список можно
найти на странице https://doc.qt.io/qt-6/qsoundeffect.html):
♦ 5tatu5Cha·nged() - генерируется при изменении состояния звука;
♦ loadedchanged() - генерируется при изменении состояния загрузки звука из файла
источника;
♦ playingChanged() - генерируется при изменении состояния воспроизведения звука;
1
♦ loop5Remainingchanged () - генерируется при каждом повторении воспроизводимого
звука;
♦ volurneChanged() - генерируется при изменении громкости звука;·
♦ mutedChanged() - генерируется при отключении звука или, наоборот, восстановлении
его громкости вызовом метода 5etMuted().
Примером к этому разделу станет небольшая программа, воспроизводящая звук, в зависи
мости от выбора пользователя: единожды, десять раз или бесконечно (листинг 29.7).
from PyQtб import QtCore, QtWidget5, QtMultimedia
import 5у5, 05
cla55 MyWindow(QtWidget5.QWidget):
def init (5elf, parent=None):
QtWidget5.QWidget. init (5elf, parent,
flag5=QtCore.Qt.WindowТype.Window
QtCore._Qt.WindowТype.МSWindow5FixedSizeDialogHint)
5elf.5etWindowТitle("Звyкoвыe эффекты")
# Инициализируем подсистему вывода звуковых эффектов
5elf.5ndEffect = QtMultimedia.QSoundEffect()
# Задаем файл-источник
fn = QtCore.QUrl. fromLocalFile(05 .path.aЬ5path("effect.wav"))
5elf.5ndEffect.5etSource(fn)
5elf.5ndEffect.loop5RemainingChanged.coппect(5elf.5hoWCount)
5elf.5ndEffect.playingChanged.coппect(self.clearCount)
vbox = QtWidgets.QVВoxLayout()
# Создаем кнопки для заГ!Уска воспроизведения звука
lЫPlay = QtWidgets.QLaЬel("Bocпpoизвecти...")
vbox.addWidget(lЫPlay)
btnOnce = QtWidget5.QPu5hВutton("...&oдин раз")
btn0nce.clicked.coппect(5elf.play0nce)
vbox.addWidget(btnOnce)
btnTen = QtWidget5.QPu5hВutton("...&дecять раз")
btnTen.clicked.coппect(self.playТen)
vbox.addWidget(btnTen)'
btnihfinite = QtWidget5.QPu5hButton(
"...&бесконечное количество раз")
btninfinite.clicked.coппect(5elf.playinfinite)
vbox.addWidget(btninfinite)
ЬtnStop = QtWidgets.QPu5hВutton("&Cтoп")
Глава 29. Мультимедиа 725
btnStop.clicked.connect(self.sndEffect.stop)
vbox.addWidget(btnStop)
self.lЫStatus = QtWidgets.QLaЬel("")
vbox.addWidget(self.lЫStatus)
self.setLayout(vbox)
self.resize(З00, 100)
def playOnce(self):
self.sndEffect.setLoopCount(l)
self.sndEffect.play()
def playТen(self):
self.sndEffect.setLoopCount(l0)
self.sndEffect.play()
def playinfinite(self):
self.sndEffect.setLoopCount(-2)
self.sndEffect.play()
# Выводим количество повторений воспроизведения эффекта
def showCount(self):
self.lЫStatus.setText("Bocпpoизвeдeнo " +
str(self.sndEffect.loopCount() -
self.sndEffect.loopsRemaining()) + " раз")
# Если воспроизведение закончено, очищаем выведенное ранее
# количество повторений эффекта
def clearCount(self):
if not self.sndEffect.isPlaying():
self.lЫStatus.setText("")
def closeEvent(self, е):
self.sndEffect.stop()
e.accept()
QtWidgets.QWidget.closeEvent(self, е)
арр = QtWidget's.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
ПРИМЕЧАНИЕ
Помимо описанных здесь возможностей, PyQt поддерживает доступ к устройствам воспро
изведения звука на низком уровне, а также получение непосредственно массива звуковых
и видеоданных с целью их анализа и обработки. Соответствующие программные инстру
менты описаны в документации по этой библиотеке.
ГЛАВА зо·
Печать документов
PyQt поддерживает ряд развитых средств, позволяющих выполнить печать документов, их
предварительный просмотр и экспорт в формат PDF.
Все описанные в этой главе классы определены в модуле QtPrintSupport, если не указано
иное.
30.1. Основные средства печати
30.1.1. Класс QPrinter
Класс QPrinter представляет принтер, связанный с указанным физическим устройством
печати (например, физическим принтером). Его иерархия наследования такова:
QPaintDevice - QPagedPaintDevice - QPrinter
Конструктор класса QPrinter поддерживает следующие форматы вызова:
QPrinter([mode=PrinterMode.ScreenResolution])
QPrinter(<Ycтpoйcтвo печати>[, mode=PrinterMode.ScreenResolution])
Первый формат создает принтер, связанный с физическим устройством печати, которое
помечено в настройках операционной системы как используемое по умолчаншо. В парамет
ре mode может быть указан режим работы принтера, заданный в виде одного из следующих
элементов перечисления PrinterMode из класса QPrinter:
♦ ScreenResolution - печать в разрешении экрана. Позволяет вывести документ макси
мально быстро, но в худшем качестве;
♦ HighResolution - печать в разрешении принтера. Печать выполняется качественнее, но
медленнее.
Второй формат создает принтер, связанный с указанным устройством печати. Последнее
задается объектом класса QPrinterinfo, речь о котором пойдет далее.
Поскольку класс QPrinter является производным от класса QPagedPaintDevice, который,
в свою очередь, наследует рассмотренный в главе 25 класс QPaintDevice, для вывода доку
ментов на печать используются методы последнего.
Класс QPrinter поддерживает очень много методов, из которых мы рассмотрим лишь наи
более полезные (полный их список можно найти на страницах https://doc;qt.io/qt-6/
qprinter.html и https://doc.qt.io/qt-6/qpaintdevice.html).
Глава 30. Печать документов 727
♦ setPrinterName(<Имя принтера>) - соединяет текущий принтер с устройством печати
с заданным в виде строки именем. Если передать пустую строку, будет выполнено
соединение со встроенной в PyQt подсистемой вывода документов в формате PDF;
♦ printerName() - возвращает строку с именем устройства печати, с которым соединен
текущий принтер;
♦ setOutputFileName(<Путь к файлу>) - задает путь к файлу, в который будет выведен
печатаемый документ (вместо печати на бумаге). Если файл имеет расширение pdf, бу
дет выполнен вывод в формате PDF. В противном случае файл будет сохранен в форма
те, установленном в вызове метода setOutputFormat(). Чтобы отключить вывод доку
мента в файл, следует вызвать этот метод, передав ему в качестве параметра пустую
строку;
♦ outputFileName() - возвращает путь к файлу, в который будет выведен документ вме
сто печати на бумаге;
♦ setOUtputFormat(<Формат вывода>) - задает формат вывода документа при записи его
в файл. В качестве параметра передается значение одного из следующих элементов пе
речисления OutputFormat из класса QPrinter:
• NativeFormat - внутренний формат устройства печати. Этот режим автоматически
устанавливается при вызове метода setPrinterName() с указанием имени сущест
вующего устройства печати. Если текущий принтер подключен к подсистеме вывода
в формате PDF, будет выполнено соединение с устройством печати по умолчаншо;
• PdfFormat - формат PDF. Этот режим автоматически устанавливается при вызове
метода setprinterName() с указанием пустой строки;
♦ outputFormat() - возвращает обозначение формата вывода документа в виде элемента
перечисления OutputFormat;
♦ isValid() - возвращает True, если связанное с принтером устройство печати действи
тельно установлено в системе и готово к работе, и False - в противном случае.
♦ setpageSize(<Размер>) - задает размер страницы в виде объекта класса QPageSize из
модуля QtGui (будет описан далее). Возвращает True, если операция увенчалась успехом,
и False - в противном случае. Пример задания размера бумаги А4:
ps = QtGui.QPageSize(QtGui.QPageSize.QPageSizeid.A4)
printer.setPageSize(ps)
♦ setPageOrientation(<Opиeнтaция>) - задает ориентацюо страницы в виде элемента
Portrait (портретная) или Landscape (ландшафтная) перечисления Orientation из класса
QPageLayout (модуль QtGui). Возвращает True, если операция увенчалась успехом,
и False - в противном случае;
♦ setPageMargins (<Отступы QMarginsF> [, units=Unit .Millimeter]) - задает отступы от
краев страницы. Параметр units указывает единицу измерения отступов в виде одного
из следующих элементов перечисления unit из класса QPageLayout:
• Millimeter - миллиметры;
• Point - пункты;
• Inch - дюймы;
• Pica - пики;
728 Часть 11. Библиотека PyQt б
• Didot - ДИДО (0,375 мм);
• Cicero _:_ цицеро (4,5 мм).
Возвращает True, если операция увенчалась успехом, и False - в противном случае.
Вот пример задания отступов в 1 пункт со всех сторон страницы:
m = QtCore . QMargins(l, 1, 1, 1)
printer.setPageMargins(m, units=QtGui.QPageLayout.Unit.Point)
♦ setPageLayout(<Параметры>) -:--- задает сразу все параметры страницы (размер, ориента
цию и отступы от краев) в виде объекта класса QPageLayout (будет описан далее). Воз
вращает тrue, если операция увенчалась успехом, и False - в противном случае;
♦ pageLayout() - возвращает параметры страницы в виде объекта класса QPageLayout;
♦ setCopyCount(<Количество>) - задает количество копий печатаемого документа;
♦ copyCount() - возвращает количество копий печатаемого документа;
♦ setCollateCopies(<Флаг>) - если передано значение True, каждая копия документа бу
дет отпечатана полностью, прежде чем начнется печать следующей копии. Если пере
дать значение False, сначала будут отпечатаны все копии первой страницы, потом все
копии второй и т. д.;
♦ collateCopies() - возвращает True, если каждая копия документа печатается полно
стью, и False - в противном случае;
♦ setDuplex(<Режим>) - задает режим двусторонней_ печати в виде одного из следующих
элементов перечисления DuplexМode из класса QPrinter:
• DuplexNone - односторонняя печать;
• DuplexAuto - двусторонняя печать с автоматическим определением стороны листа,
вокруг которой следует его перевернуть;
• DuplexLongSide - двусторонняя печать с переворачиванием листа вокруг длинной
стороны;
• DuplexShortSide - двусторонняя печать с переворачиванием листа вокруг короткой
стороны;
♦ duplex() - возвращает обозначение заданного для принтера режима двусторонней
печати в виде элемента перечисления DuplexМode;
♦ setPrintRange(<Диапазон>) - задает диапазон печати документа в виде одного из сле
дующих элементов перечисления PrintRange из класса QPrinter:
• AllPages - печатать в�е страницы;
• Selection - печатать только выделенный фрагмент;
• PageRange - печатать только заданный диапазон страниц;
• CurrentPage - печатать только текущую страницу;·
♦ setFromTo(<Первая страница>, <Последняя страница>) - задает номера первой и по-
следней страниц в печатаемом диапазоне;
♦ fromPage() - возвращает номер первой страницы из печатаемого диапазона;
♦ toPage() - возвращает номер последней страницы из печатаемого диапазона;
♦ setColorMode(<Режим>) - задает режим вывода цвета в виде элемента Color (цветной)
или Grayscale (черно-белый) перечисления ColorMode из класса QPrinter;
Глава 30. Печать документов 729
♦ colorMode() - возвращает обозначение режима вывода цвета в виде элемента перечис
ления ColorMode;
♦ setResolution(<Разрешение>) - задает разрешение для принтера в виде целого числа
в точках на дюйм. Если указано неподдерживаемое значение разрешения, будет выстав
лено разрешение, наиболее бл_изкое к заданному;
♦ resolution() - возвращает заданное для принтера разрешение;
♦ setPaperSource(<Источник>) - задает источник бумаги в виде значения одного из сле
дующих элементов перечисления Papersource из класса QPrinter (приведены лишь наи
более часто используемые источники - полный их список можно найти на странице
https://doc.qt.io/qt-6/qprinter.html#PaperSource-enum):
• OnlyOne - единственный лоток принтера или лоток, используемый по умолчанию;
• Lower - нижний лоток;
• Middle - средний лоток;
• Manual - лоток для ручной подачи бумаги;
• Envelope - лоток для конвертов;
• EnvelopeManual - лоток для ручной подачи конвертов;
• Auto - автоматический выбор источника;
♦ papersource() - возвращает обозначение источника бумаги в виде элемента перечисле
ния PaperSource;
♦ setFontEmЬeddingEnaЫed(<Флаг>) - если передано значение True, в создаваемый доку
мент PDF будут внедрены все использованные в его тексте шрифты, если передано зна
чение False - не будут;
♦ supportsMultipleCopies() - возвращает True, если принтер сам способен напечатать
несколько копий документа, и False - в противном случае;
♦ supportedResolutions() - возвращает список разрешений, поддерживаемых принтером
и измеряемых в точках на дюйм:
>>> printer = QtPrintSupport.QPrinter()
>>> for f in printer.supportedResolutions(): print(f, end=" ")
600
ВНИМАНИЕ!
Для некоторых принтеров метод supportResolutions() по какой-то причине выводит пустой
список.
30.1.2. Вывод на печать
Процесс вывода документа на печать средствами PyQt делится на следующие этапы:
1. Создание принтера (объекта класса QPrinter) и задание его параметров:
printer = QtPrintSupport.QPrinter()
2. Создание объекта класса QPainter:
painter = QtGui.QPainter()
730 Часть 11. Библиотека PyQt б
3. Вызов метода begin(<Устройство QPaintDevice>) у созданного ранее объекта класса
QPainter с передачей ему в качестве параметра только что созданного принтера:
painter.begin(printer)
Метод begin() инициирует процесс вывода графики на принтер. Он возвращает тrue,
если инициализация прошла успешно, и False - в противном случае.
4. Вывод содержимого печатаемого документа в созданный ранее объект класса QPainter
средствами этого класса (см. главу 25).
5. В случае необходимости начать вывод новой страницы - вызов метода newPage() клас
са QPrinter:
printer.newPage()
Метод newPage() подготавливает принтер к выводу новой страницы и возвращает True,
если подготовка увенчалась успехом, и False - в противном случае.
6. По окончании вывода документа - вызов метода end() класса QPainter:
painter .end()
Этот метод завершает рисование графики и возвращает тrue, если вывод графики бьш
закончен успешно, и False - в противном случае. После его вызова выполняется собст
венно печать документа.
Метод abort() класса QPrinter прерывает процесс печати и возвращает True, если печать
успешно прервана, и False - в противном случае.
Перед началом вывода графики понадобится определить размеры всей .страницы принтера,
размеры области на ней, доступной для рисования, и некоторые другие параметры, касаю
щиеся этих размеров. Для этого применяются следующие методы класса QPrinter:
+ pageRect(<Единица измерения>) - возвращает размеры области на странице, доступной
для печати, в заданных единицах измерения в виде объекта класса QRectF. Единицы изме
рения задаются в виде одного из следующих элементов перечисления Unit из класса
QPrinter:
• Millimeter - миллиметры;
• Point - пункты;
• Inch - дюймы;
• Pica - пики;
• Didot - дидо (0,375 мм);
• Cicero - цицеро (4,5 мм);
• DevicePixel - пикселы;
♦ paperRect (<Единица измерения Unit>) - возвращает размеры страницы целиком в за-
данных единицах измерения в виде объекта класса QRectF.
Начало координат находится в левом верхнем углу области, ·отведенной под печать. Гори
зонтальная координатная ось направлена направо, а вертикальная - вниз.
Напишем код, который будет вьmодить на установленное по умолчанию устройство печати
документ из двух страниц (листинг 30.1). Первую страницу мы обведем точечной синей
Глава 30. Печать документов 731
рамкой, а по ее центру расположим надпись «QPrinter». Вторая страница будет отпечатана
в ландшафтной ориентации, и ее полностью займет графическое изображение.
from PyQtб import QtCore, QtWidgets, QtGui, QtPrintSupport
import sys
арр = QtWidgets.QApplication(sys.argv)
# Создаем принтер
printer = QtPrintSupport.QPrinter()
# Дпя целей отладки лущпе выводить документ не на принтер,
# а в файл в формате PDF. Чтобы сделать это, достаточно
# раскомментировать следующую строку кода:-
# printer.setOutputFileName("output.pdf")
# Создаем поверхность рисования и привязываем принтер к ней
painter = QtGui.QPainter()
painter.begin(printer)
# Рисуем рамку вокруг страницы
реп = QtGui.QPen(QtGui.QColor(QtCore.Qt.GlobaiColor.Ыue), 5,
style=QtCore.Qt.PenStyle.DotLine)
painter.setPen(pen)
painter.setBrush(QtCore.Qt.BrushStyle.NoBrush)
page_size = printer.pageRect(QtPrintSupport.QPrinter.Unit.DevicePixel)
page_width = int(page_size.width())
page_height = int(page_size.height())
painter.drawRect(0, О, page_width, page_height)
# Выводим надпись
color � QtGui.QColor(QtCore.Qt.GlobalColor.Ыack)
painter.setPen(QtGui.QPen(color))
painter.setBrush(QtGui.QBrush(color))
font = QtGui.QFont("Verdana", pointSize=42)
painter.setFont(font)
painter.drawТext(l0, page_height // 2 - 100, page_width - 20,
50, QtCore.Qt.AlignmentFlag.AlignCenter
QtCore.Qt.TextFlag.TextDontClip,
"QPrinter")
# Изменяем ориентацию страницы. Сделать это нужно перед вызовом
# метода newPage()
printer.setPageOrientation(QtGui.QPageLayout.Orientation.Landscape)
# Переходим на новую страницу
printer.newPage()
# Выводим изображение
page_size = printer.pageRect(QtPrintSupport.QPrinter.Unit.DevicePixel)
page_width = int(page_size.width())
page_height = int(page_size.height())
pixmap QtGui.QPixmap("img.jpg")
pixmap = pixmap.scaled(page_width, page_height,
aspectRatioMode=QtCore.Qt.AspectRatioMode.KeepAspectRatio)
painter.drawPixmap(0, О, pixmap)
painter.end()
732 Часть 1/. Библиотека PyQt б
В листинге 30.2 приведен код класса PrintList, реализующий печать списков или содержи
мого таблиц баз данных в виде полноценного табличного отчета. Этот класс можно исполь
зовать для разработки бизнес-приложений.
from PyQtб import QtCore, QtGui, QtPrintSupport
class PrintList:
def init (self):
self.printer = QtPrintSupport.QPrinter()
self.headerFont = QtGui.QFont("Arial", pointSize=lO,
weight=QtGui.QFont.Weight.Bold)
self.bodyFont = QtGui.QFont("Arial",-pointSize=lO)
self.footerFont = QtGui.QFont("Arial"; pointSize=9, italic = True)
self.headerFlags = QtCore.Qt.AlignmentFlag.AlignнCenter 1 \
QtCore.Qt.TextFlag.TextWordWrap
self.bodyFlags = QtCore.Qt.TextFlag.TextWordWrap
self.footerFlags = QtCore.Qt.AlignmentFlag.AlignнCenter 1 \
QtCore.Qt.TextFlag.TextWordWrap
color = QtGui.QColor(QtCore.Qt.GlobalColor.Ыack)
self.headerPen = QtGui.QPen(color, 2)
self.bodyPen = QtGui.QPen(color, 1)
self.margin = 5
self._resetData()
def _resetData(self):
self.headers = None
self.columnWidths = None
self.data = None
self._brush = QtCore.Qt.BrushStyle.NoBrush
self._currentRowHeight = О
self._currentPageHeight О
self._headerRowHeight = О
self._footerRowHeight = О
self._currentPageNumЬer 1
self._painter = None
def printData(self):
self._painter =.QtGui.QPainter()
self._painter.begin(self.printer)
self._painter.setBrush(self._brush)
if self._headerRowHeight == О:
self._painter.setFont(self.headerFont)
self._headerRowHeight = self._calculateRowHeight(
self.columnWidths, self.headers)
if self._footerRowHeight == О:
self._painter.setFont(self.footerFont)
self._footerRowHeight = self._calculateRowHeight(
[ self.printer.width() ] , "Страница")
Глава 30. Печать документов 733
for i in range(len(self.data)):
height = self._calculateRowHeight(self.columnWidths, self.data[i])
if self._currentPageHeight + height > self.printer.height() - \
self._footerRowHeight - 2 * self.margin:
self._printFooterRow()
self._current.PageHeight = О
self._currentPageNumЬer += 1
self.printer.newPage()
if self._currentPageHeight == О:
self._painter.setPen(self.headerPen)
self._painter.setFont(self.headerFont)
self.printRow(self.columnWidths, self.headers,
self._headerRowHei�ht, self.headerFlags)
self._painter.setPen(self.bodyPen)
self._painter.setFont(self.bodyFont)
self.printRow(self.columnWidths, self.data[i], height,
self.bodyFlags}
self. _printFooterRow(}
self._pai!'lter.end()
self._resetData()
def _calculateRowHeight(self, widths, cellData):
height = О
for i in range(len(widths)):
·r = self._painter.boundingRect(O, О, widths[i] - 2 *
self.margin, 50, QtCore.Qt.TextFlag.TextWordWrap,
str(cellData[i]))
h = r.height() + 2 * self.margin
if height < h:
height = h
return height
def printRow(self, widths, cellData, height, flags):
х = о
for i in range(len(widths)):
self._painter.drawТext(x + self.margin,
self._currentPageHeight + self.margin,
widths[i] - self.margin, height - 2 * self.margin,
flags, str(cellData[i]})
self._painter.drawRect(x, self._currentPageHeight,
widths[i], height)
х += widths[i]
self._currentPageHeight += height
def _printFooterRow(self):
self._painter.setFont(self.footerFont)
self._painter.drawТext(self.margin, self.printer.height() -
self._footerRowHeight - self.margin, self.printer.width() -
2 * self.margin, self._footerRowHeight - 2 * self.margin,
self.footerFlags, "Страница " + str(self._currentPageNumЬer))
734 Часть 11. Библиотека PyQt 6
Пользоваться этим классом очень просто. Сначала нужно создать его объект, вызвав конст
руктор следующего формата:
PrintList ()
После чего задать параметры печатаемого табличного отчета, воспользовавшись следую
щими атрибутами класса PrintList:
♦ headers- заголовки для столбцов табличного отчета в виде списка строк;
♦ columnWidths - значения ширинъ1 для столбцов, измеряемые в пикселах, в виде списка
целочисленных величин;
♦ data - собственно выводимые даннъ1е. Они должны представлять собой �писок значе
ний, выводимых в отдельных ячейках, - каждый из элементов этого списка задает дан
ные для одной строки.
Следующие свойства являются необязательными для указания:
♦ printer - принтер (ссьшка на объект класса QPrinter), на котором будет печататься
отчет. Изначально хранит принтер, используемый по умолчанию;
♦ headerFont - шрифт, используемый для вывода текста «шапки» табличного отчета. По
умолчанию- полужирный шрифт Arial размером 10 пунктов;
♦ headerPen - параметры рамки, рисуемой вокруг ячеек «шапки». По умолчанию - чер
ная линия толщиной 2 пиксела;
♦ headerFlags - параметры вывода текста ячеек «шапки». По умолчанию - выравнива
ние по центру и перенос по словам;
♦ bodyFont - шрифт, используемый для вывода текста обычных строк. По умолчанию -
шрифт Arial размером 1О пунктов;
♦ bodyPen - параметры рамки, рисуемой вокруг ячеек обычных строк. По умолчанию -
черная линия толщиной 1 пиксел;
♦ bodyFlags - параметры вьmода текста ячеек обычных строк. По умолчанию - перенос
по словам;
♦ footerFont - шрифт, используемый для вывода текста «поддона» таблицы. По умолча
нию - курсивный шрифт Arial размером 9 пунктов;
♦ footerFlags - параметры вывода текста «поддона». По умолчанию - выравнивание по
центру и перенос по словам;
♦ margin - величина просвета между рамкой ячейки и ее содержимым. По умолчанию -
5 пикселов.
После задания всех необходимых параметров следует вызвать метод printData () класса
PrintList•, который и выполняет печать данных. Впоследствии, пользуясь тем же объектом
этого класса, мы можем распечатать другой набор данных.
В листинге 30.3 приведен код тестовой программы, вьmодящей на экран числа от 1 до 100,
их квадраты и кубы. Подразумевается, что код, приведенный в листинге 30.2, сохранен
в модуле Printlist.py.
from PyQtб import QtWidgets
import sys
import PrintList
Глава 30. Печать документов 735
арр = QtWidgets.QApplication(sys.argv)
pl = PrintList .PrintList()
# Если требуется вывести документ в файл формата PDF,
# следует раскомментировать эту строку:
# pl.printer.setOUtputFileNarne("output.pdf")
data = []
for Ь in range(l, 101):
data.append([b, Ь ** 2, Ь ** 3])
pl.data = data
pl.columnWidths = [100, 100, 200]
pl.headers = ["Аргумент", "Квадрат•:, "Куб"]
pl.pr.1ntData()
В результате мы должны получить табличный документ из трех страниц с тремя,столбцами
и нумерацией в «поддоне».
30.1.3. Служебные классы
30.1.3.1. Класс QPageSize
Класс QPageSize, определенный в модуле QtGui, описывает размер (или формат) страницы.
Для указания размера страницы, который будет использовать принтер, предназначен метод
setPageSize(<Размеры QPageSize>) класса QPrinter.
Форматы конструктора класса:
QPageSize()
QРаgеSizе(<Идентификатор формата>)
QPageSize(<Размер QSize>[, narne=""] [, matchPolicy=SizeMatchPolicy.FuzzyMatch])
QPageSize(<Paзмep QSizeF>, <Единица измерения>[, narne=""] [,
matchPolicy=SizeMatchPolicy.FuzzyMatch])
QРаgеSizе(<Исходный объект QPageSize>)
Первый формат создает «пустой» объект класса, не хранящий данные ни о каком размере
страницы.
Второй формат позволяет указать размер сразу, в виде одного из следующих элементов
перечисления PageSizeid из класса QPageSize (приведены только наиболее употребитель
ные размеры - полный их список можно найти на странице https://doc.qt.io/qt-6/
qpagesize.html#PageSizeld-enum): АО, Al, А2, АЗ, м, А5, Letter, Legal.
Третий и четвертый форматы служат для создания нестандартных форматов. В третьем
формате размеры задаются в первом параметре в пунктах. В параметре narne можно задать
имя создаваемого размера бумаги - если он не указан, будет .создано имя по умолчанию
вида Custom (<Ширина> х <Высота>) .
Если заданные размеры близки к размерам какого-либо из стандартных форматов бумаги,
будет использован этот формат. В параметре matchPolicy можно задать режим подбора
стандартного формата бумаги в виде одного из следующих элементов перечисления
SizeMatchPolicy из класса QPageSize:
♦ FuzzyМatch - размеры стандартного формата должны быть близки к заданным в конст
рукторе размерам в определенных рамках с учетом ориентации;
♦ FuzzyOrientationМatch - размеры стандартного формата должны быть близки к задан
нь1м в конструкторе размерам в определенных рамках без учета ориентации;
736 Часть 11. Библиотека PyQt б
♦ Exactмatch - размеры стандартного формата должны точно совпадать с заданными
в конструкторе.
В четвертом формате вторым параметром должны быть заданы единицы измерения разме
ров в виде значения одного из следующих элементов перечисления Unit из класса
QPageSize:
• Millimeter - миллиметры;
• Point - пункты;
• Inch - дюймы;
• Pica - пики;
• Didot - дидо (0,375 мм);
• Cicero - цицеро (4,5 мм).
Последний формат создает копию указанного исходного объекта.
Примеры:
# Задаем размер бумаги А5
ps = QtGui.QPageSize(QtGui.QPageSize.PageSizeid.A5)
printer.setPageSize(ps)
# Задаем размер бумаги 50 х 30 пунктов с названием "Особый размер"
sz = QtCore.QSize(50, 30)
ps = QtGui.QPageSize(sz, nаmе="Особый размер",
matchPolicy=QtGui.QPageSize.SizeMatchPolicy.FuzzyМatch)
printer.setPageSize(ps)
Класс QPageSize поддерживает следующие полезные методы (полный их список можно
найти на странице https://doc.qt.io/qt-6/qpagesize.html):
♦ size(<Единица измерения Unit>) и rect(<Единица измерения ·unit>) - возвращают раз
меры бумаги в заданных единицах измерения в виде объекта класса QSizeF или QRectF
соответственно;
♦ size() - статический, возвращает размеры бумаги для заданного идентификатора фор
мата в заданных единицах измерения, представленные объектом класса QSizeF. Формат
метода:
sizе(<Идентификатор формата PageSizeid>, <Единица измерения Unit>)
Пример:
>>> s = QtGui.QPageSize.size(QtGui.QPageSize.PageSizeid.A0,
QtGui.QPageSize.Unit.Millimeter)
>>> print(s.width(), "х", s.height())
841.0 х 1189.0
♦ sizePixels(<Разрешение>) и rectPixels(<Разрешение>) - возвращают размеры бумаги
для заданного разрешения, которое измеряется в точках на дюйм, в пикселах в виде
объекта класса QSize или QRect соответственно:
>>> ps = QtGui.QPageSize(QtGui.QPageSize.PageSizeid.A5)
>>> s = ps.sizePixels(б00)
>>> print(s.width(), "х", s.height())
3500 х 4958
Глава 30. Печать документов 737
♦ sizePixels() - статический, возвращает размеры бумаги для заданных идентификатора
формата и разрешения, которое измеряется в точках на дюйм, в пикселах в 'Виде объекта
класса QSize. Формат метода:
sizеРiхеls(<Идентификатор формата PageSizeid>, <Разрешение>)
♦ sizePoints() и rectPoints() - возвращают размеры бумаги в пунктах в виде объекта
класса QSize или QRect соответственно;
♦ sizеРоints(<Идентификатор формата PageSizeid>)_- статический, возвращает размеры
бумаги для заданного идентификатора формата в пунктах в виде объекта класса QSize;
♦ swар(<Размер QPageSize>) - меняет размер бумаги, хранящийся в текущем объекте
класса, на заданный в параметре;
♦ name() _:_ возвращает имя размера бумаги;
♦ name(<Идентификатор формата PageSizeid>) статический, возвращает имя размера
бумаги, заданного идентификатором;
♦ isEquivalentтo(<Размер QPageSize>) - возвращает тrue, если размеры текущего фор
мата бумаги равны ра,змерам, переданным в параметре, и False - в противном случае.
Также класс QPageSize поддерживает операторы сравнения == и ! =:
sl = QtGui.QPageSize(QtGui.QPageSize.PageSizeid.A4)
s2 = QtGui.QPageSize(QtGui.QPageSize.PageSizeid .A4)
s3 = QtGui .QPageSize(QtGui.QPageSize.PageSizeid.AЗ)
print(s1 s2) # Выведет: True
print(s1 ! = s3) # Выведет: True
30.1.3.2. Класс QPageLayout
Класс QPageLayout, также определенный в модуле QtGui, представляет сразу размеры, ори
ентацию страницы и величины отступов от ее краев. Передать все эти сведения принтеру
позволяет метод setPageLayout(<Параметры QPageLayout>) класса QPrinter.
Форматы вызова конструктора этого класса:
QPageLayout()
QPageLayout(<Paзмep QPageSize>, <Ориентация Orientation>, <Отступы QМarginsF>[,
units=Unit.Point] [, minМargins=QМarginsF(0,0,0,0)])
QРаgеLауоut(<Исходный объект QPageLayout>)
Первый формат создает «пустой» объект, не хранящий никаких сведений.
Второй формат позволяет задать сразу все необходимые сведения о бумаге. Ориентация
бумаги задается в виде элемента Portrait (портретная) или Landscape (ландшафтная) пере
числения Orientation из класса QPageLayout. Параметр units задает единицы измерения
размеров в виде значения одного из элементов перечисления Unit из класса QPageLayout
(см. разд. 30.1.1). А параметр minМargins указывает минимальные отступы от краев страни
цы, которые может обеспечить принтер. Пример:
layout � QtGui.QPageLayout(QtGui.QPageSize(QtGui.QPageSize.PageSizeid.A5),
_QtGui.QPageLayout.Orientation.Landscape,
QtCore.QМarginsF(l0, 10, 10, 10),
units=QtGui.QPageLayout.Unit.Millimeter)
printer.setPageLayout(layout)
Третий формат создает копию указанного исходного объекта.
738 Часть 11. Библиотека PyQt б
Наиболее полезные методы класса QPageLayout приведены далее (полный их список можно
найти на странице https://doc.qt.io/qt-6/qpagelayout.html).
♦ setPageSize(<Размер QPageSize> [, minМargins= QMarginsF (О, О, О, О)]) - задает раз
меры бумаги. В необязательном параметре minМargins можно указать минимальные ве
личины отступов от краев страницы (объект класса QMarginsF);
♦ setOrientation (<Ориентация Orientation>) - задает ориентацию страницы;
♦ setMargins(<Отступы QMarginsF>) - задает величины отступов от краев страницы. Воз
вращает тrue, если операция прошла успешно, и False - в противном случае;
♦ setLeftMargin(<Oтcтyп>), setTopMargin(<Oтcтyп>), setRightMargin(<Oтcтyп>) и
setBottomМargin(<Отступ>) - задают величины отступов от левого, верхнего, правого
и нижнего краев страницы соответственно. _Возвращают тrue, если операция прошла
успешно, и False - в противном случае;
♦ setUnits (<Единица измерения Unit>) - задает единицу измерения размеров;
♦ setMinimumМargins(<Отступы QMarginsF>) - задает минимальные величины отступов от
краев страницы, которые может обеспечить принтер;
♦ swap(<Параметры QPageLayout>) - меняет параметры бумаги, хранящиеся в текущем
объекте класса, на заданные;
♦ fullRect( [<Единица измерения Unit> J ) - возвращает размеры страницы с учетом ори
ентации, но без учета отступов в виде объекта класса QRectF. Если единица измерения не
указана, выведенные значения будут исчисляться в единицах измерения, заданных
в конструкторе. Пример:
>>> lt = QtGui.QPageLayout(QtGui.QPageSize(QtGui.QPageSize.PageSizeid.AS),
QtGui.QPageLayout.Orientation.Landscape,
QtCore.QMarginsF(10, 10, 10, 10),
units=QtGui.QPageLayout.Unit.Millimeter)
>>> r = lt.fullRect()
>>> print(r.width(), "х", r.height())
210.0 х 148.0
♦ fullRectPixels(<Разрешение>) - возвращает размеры страницы в пикселах с учетом
ориентации, но без учета отступов для заданного разрешения, которое измеряется в точ
ках на дюйм. Результат представляет собой объект класса QRect;
♦ fullRectPoints() - возвращает размеры страницы в пунктах с учетом ориентации, но
без учета отступов в виде объекта класса QRect;
♦ paintRect( [<Единица измерения Unit> J ) - возвращает размеры страницы с учетом ори
ентации и отступов (фактически - доступной для вывода графики области страницы)
в виде объекта класса QRectF. Если единица измерения не указана, выведенные значения
будут исчисляться в единицах измерения, заданных в конструкторе;
♦ paintRectPixels(<Разрешение>) - возвращает размеры страницы в пикселах с учетом
ориентации и отступов для заданного разрешения, которое измеряется в точках на дюйм.
Результат представляет собой объект класса QRect;
♦ paintRectPoints() - возвращает размеры страницы в пунктах с учетом ориентации и
отступов в виде объекта класса QRect.
Класс QPageLayout также поддерживает операторы сравнения = = и ! =.
Глава 30. Печать документов 739
30.2. Задание параметров принтера и страницы
30.2.1. Класс QPrintDialog
Класс QPrintDialog реализует функциональность стандартного диалогового окна выбора
и настройки принтера (рис. 30.1).
.,,;J Печать х
Общие
Выберите принтер
�-C_a_no_ n
_ _iP_2_800_ser_i
es
______ �I•
Microsoft XPS Document \
� Fax 8 OneNote for Windows 1 О
8 Microsoft Print to PDF 8 PDFCrea tor
< >
Состояние: Отключен О П�ать в файл ��-=·
i Н,IСТройк а ._.:_��,i
>. ___
Папка:
Коммент арий: f!:\аllти пр интер .1
Диаnаэон страниц
· ,Iекущая • Число 11опий:
@Все · страница
0fаэобрать по копиям
· _ , В!а!деление
тр н
О с а ицы: �10-_1___�
Введите номер.страницы или диапазон
страниц. Например: 5-12
[lечать I f отмена I пр именить
Рис. 30.1. Стандартное диалоговое окно выбора и настройки принтера
Иерархия наследования этого класса:
(QObject, QPaintDevice) - QWidget - QDialog - QAЬstractPrintDialog - QPrintDialog
Конструктор класса QPrintDialog имеет следующий формат:
QPrintDialog(<Пpинтep QPrinter>[, parent=None])
В первом параметре указывается принтер, настройки которого будут задаваться в диалого
вом окне. Необязательный параметр parent может быть использован для задания родителя.
Перед выводом диалогового окна можно указать для него значения по умолчанию, восполь
зовавшись методами класса QPrinter, описанными в разд. 30.1.1. Например, для указания
размера бумаги следует вызвать метод setPageSize (), для задания количества копий -
setCopyCount () и т. д.
ВьЦJести диалоговое окно на экран можно вызовом метода ехес () .
После закрытия диалогового окна все заданные в нем параметры при необходимости могут
быть получены через соответствующие методы класса QPrinter. При этом выяснить размер
бумаги, ее ориентацию и отступы от краев позволит метод pageLayout (), количество копий
документа - метод copyCount () и т. д. Все эти методы были описаны в разд. 30.1.1.
740 Часть 11. Библиотека PyQt б
Все настройки, заданные в диалоговом окне, будут применены к принтеру самой библиоте
кой PyQt. Так, если пользователь выберет другой принтер, печать будет выполнена на
выбранном им принтере. А если он укажет напечатать документ в нескольких копиях, все
эти копии будут напечатаны PyQt самостоятельно.
Класс QPrintDialog поддерживает следующие основные методы (полный их список можно
найти на страницах https://doc.qt.io/qt-6/qabstractprintdialog.html и https://doc.qt.io/qt-6/
qprintdialog.html):
♦ setOption(<Hacтpoйкa>[, on=True]) - активизирует указанную в первом параметре
настройку принтера, если в параметре on задано значение True, и сбрасывает, если пере
дано False. Настройка задается в виде одного из следующих элементов перечисления
PrintDialogOption из класса QPrintDialog или их комбинации через оператор 1:
• None - все настройки принтера сброшены;
• PrintToFile - доступна возможность печати в файл;
• PrintSelection - разрешен выбор принтера;
• PrintPageRange - доступно указание диапазона печатаемых страниц;
• PrintShowPageSize - вьmод размера страницы и отступов (только если это возможно);
• PrintCollateCopies - доступно указание режима печати копий документов (будет
ли каждая копия печататься полностью, или уначала будут отпечатаны все копии
первой страницы, потом - копии второй и т. д.);
• PrintCurrentPage __: доступно указание печати только текущей страницы;
♦ setOptions(<Настройки PrintDialogOptions>) - позволяет активизировать сразу не
сколько настроек принтера;
♦ testOption(<Настройка PrintDialogOptions>) - возвращает True, если заданная на
стройка принтера активизирована, и False - в противном случае;
♦ options() - возвращает через оператор I комбинацию элементов перечисления
PrintDialogOption, представляющих активизированные настройки;
♦ printer() - возвращает принтер (объект класса QPrinter), выбранный в диалоговом
окне.
30.2.2. Класс QPageSetupDialog
Класс QP1Э,geSetupDialog реализует работу стандартного диалогового окна установки пара
метров страницы: размера, ориентации, отступов и др. (рис. 30.2).
Иерархия наследования этого класса:
(QObject, QPaintDevice) - QWidget - QDialog - QPageSetupDialog
Конструктор класса QPageSetupDialog имеет следующие форматы вызова:
QPageSetupDialog([parent=None])
QPageSetupDialog(<Пpинтep QPrinter>[, parent=None])
. Первый формат создает диалоговое окно, привязанное к используемому по умолчанию
устройству печати, второй формат позволяет указать нужный принтер. Необязательный
параметр parent может быть использован для задания родителя.
Глава 30. Печать документов 741
Параметры страницы х
Бумага
Ра;}мер:
Пода�а:
П я(м
Ориентация ол м}
@Книжн я
а левое: г·-----,
��j правое �:=J
:
л мная
Qt, ьбо
j!ерхнее: ��96 ] нижнее: l�
, ОК Отмена
.
Рис. 30.2. Стандартное диалоговое окно установки параметров страницы
Принципы работы с диалоговым окном параметров страницы такие же, как и у его «колле
гю>, представляющего параметры принтера (см.разд. 30.2.1): мы задаем нужные параметры
страницы, вызывая соответствующие методы класса QPrinter, и выводим диалоговое окно
на экран вызовом метода ехес (). И, опять же, все зада�rnые в этом диалоговом окне на
стройки будут применены к принтеру автоматически.
Из поддерживаемых классом QPagesetupDialog методов нас может заинтересовать разве что
Он возвращает принтер (объект класса QPrinter), указанный в вызове конструк
printer ().
тора.
Напишем печатающую изображение из указанного графического файла утилиту, -позво
ляющую задать настройки принтера и параметры страницы в соответствующих диалоговых
окнах (листинг 30.4).
from PyQtб import QtCore, QtWidgets, QtGui, QtPrintSupport
import sys
class MyWindow(QtWidgets.QWidget):
def �init (self, parent=None):
QtWidgets.QWidget. init (self, parent,
flags=QtCore.Qt.WindowТype.Window
QtCore.Qt.WindowТype.MSWindowsFixedSizeDialogHint)
self.setWindowТitle("Пeчaть изображений")
self.printer = QtPrintSupport.QPrinter()
742 Часть 11. Библиотека PyQt б
self.printer.setPageOrientation(
QtGui.QPageLayout.0rientation.Landscape)
self.file = None
vbox = QtWidgets.QVВoxLayout()
ЬtnOpen = QtWidgets.QPushButton("&Oткpыть файл...")
ЬtnOpen.clicked.connect(self.openFile)
vbox.addWidget(ЬtnOpen)
ЬtnPageOptions = QtWidgets.QPushButton("Настройка &страницы...")
ЬtnPageOptions.clicked.connect(self.showPageOptions)
vbox.addWidget(ЬtnPageOptions)
ЬtnPrint = QtWidgets.QPushButton("&Пeчaть ...")
ЬtnPrint.clicked.connect(self.print)
vbox.addWidget(ЬtnPrint)
self.setLayout(vbox)
self.resize(З00, 100)
def openFile(self):
self.file = QtWidgets.QFileDialog.getOpenFileNarne(parent=self,
сарtiоn="Выберите графический файл",
filtеr="Графические файлы (*.bmp *.jpg *.png)") [О]
def showPageOptions(self):
pd = QtPrintSupport.QPageSetupDialog(self.printer, parent=self)
pd.exec()
def print(s�lf):
pd = QtPrintSupport.QPrintDialog(self.printer, parent=self)
pd.setOptions(
QtPrintSupport.QAЬstractPrintDialog.PrintDialogOption.PrintToFile
QtPrintSupport.QAЬstractPrintDialog.PrintDialogOption.PrintSelection)
if pd.exec() == QtWidgets.QDialog.DialogCode.Accepted:
painter = _QtGui.QPainter()
painter.begin(self.printer)
pixmap = QtGui.QPixmap(self.file)
pixmap = pixmap.scaled(self.printer.width(), self.printer.height(),
aspectRatioMode=QtCore.Qt.AspectRatioMode.KeepAspectRatio)
painter.drawPixmap(0, О, pixmap)
painter.end()
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
30.3. Предварительный просмотр
30.3.1. Класс QPrintPreviewDialog
Класс QPrintpreviewDialog выводит документ в диалоговом окне предварительного про
смотра (рис. 30.3). Это окно дает возможности перехода со страющы на страницу, масшта-
Глава 30. Печать документов 743
бирования выведенного документа, указания режима его вывода (постранично, по две стра
ницы и т. п.), задания ориентации страницы, вызова диалогового окна настроек страницы, а
также отправки документа на печать.
i.i] Print Preview х
Рис. 30.3. Диалоговое окно предварительного просмотра документа
Иерархия наследования класса QPrintPreviewDialog:
(QObject, QPaintDevice) - QWidget - QDialog - QPrintPreviewDialog
Конструктор класса имеет следующие форматы вызова:
QPrintPreviewDialog([parent=None] [, ] [flags=O])
QPrintPreviewDialog(<Пpинтep QPrinter>[, parent=None] [, flags=O])
Первый формат создает диалоговое окно, привязанное к используемому по умолчанию
устройству печати, второй формат позволяет указать нужный принтер. Параметр parent
задает родителя, а параметр flags - типа окна (см.разд. 19.11).
Вывод документа для предварительного просмотра с помощью класса QPrintPreviewDialog
выполняется в три этапа:
1. Создание объекта класса QPrintPreviewDialog.
2. Назначение сигналу paintRequested(<Принтер QPrinter>) этого объекта обработчика,
внутри которого и будет выполняться вывод документа. Обработчику в параметре пере
дается указанный в вызове конструктора принтер.
3. Вывод диалогового окна на экран вызовом метода ехес() класса QPrintPreviewDialog.
Переделаем написанную ранее утилиту печати изображений (см. листинг 30.4) таким обра
зом, чтобы дать пользователю возможность просматривать изображения перед печатью.
Код новой утилиты приведен в листинге 30.5.
744 Часть 11. Библиотека PyQt б
from PyQtб import QtCore, QtWidgets, QtGui, QtPrintSupport
import sys
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent,
flags=QtCore.Qt.WindowТype.Window
QtCore.Qt.WindowТype.MSWindowsFixedSizeDialogHint)
self.setWindowТitle("Пeчaть изображений")
self.printer = QtPrintSupport.QPrinter'()
self.printer.setPageOrientation(
QtGui.QPageLayout.Orientation.Landscape)
self.file = None
vbox = QtWidgets.QVВoxLayout()
btnOpen = QtWidgets.QPushВutton("&Oткpыть файл ...")
btnOpen.clicked.connect(seif.openFile)
vbox.addWidget(btnOpen)
btnPageOptions = QtWidgets.QPushButton("Hacтpoйкa &страницы...")
btnPageOptions.clicked.connect(self.showPageOptions)
vbox.addWidget(btnPageOptions)
btnPreview = QtWidgets.QPushВutton("П&pocмoтp...")
btnPreview.clicked.connect(self.preview)
vbox.addWidget(btnPreview)
btnPrint = QtWidgets.QPushButton("&Пeчaть ...")
btnPrint.clicked.connect(self.print)
vbox.addWidget(btnPrint)
self.setLayout(vbox)
self.resizeГЗ00, 100)
def openFile(self):
self.file = QtWidgets.QFileDialog.getOpenFileName(parent=self,
сарtiоn="Выберите графический файл",
filtеr="Графические файлы (*.bmp *.jpg *.png)") [О]
def showPageOptions(self):
pd = QtPrintSupport.QPageSetupDialog(self.printer, parent=self)
pd.exec()
def preview(self):
рр = QtPrintSupport.QPrintPreviewDialog(self.printer, parent=self)
pp.paintRequested.connect(self.__printimage)
рр.ехес()
def print(self):
pd = QtPrintSupport.QPrintDialog(self.printer, parent=self)
pd.setOptions(
QtPrintSupport.QAЬstractPrintDialog.PrintDialogOption.PrintToFile
QtPrintSupport.QAЬstractPrintDialog.PrintDialogOption.PrintSelection)
Глава 30. Печать документов 745
if pd.exec() == QtWidgets.QDialog.DialogCode.Accepted:
self._printimage(self.printer)
def _printimage(self, printer):
painter = QtGui.QPainter()
painter.begin(printer)
pixmap = QtGui.QPixmap(self.file)
pixmap = pixmap.scaled(printer.width(), printer.height(),
aspectRatioMode=QtCore.Qt.AspectRatioMode.KeepAspectRatio)
painter.drawPixmap(0, О, pixmap)
painter.end()
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show ()
sys.exit(app.exec())
30.3.2. Класс QPrintPreviewWidget
Класс QPrintPreviewWidget представляет отдельный компонент - панель для предвари
тельного просмотра документа. Он имеет ту же функциональность, что и диалоговое окно,
рассмотренное вразд. 30. 3.1.
Иерархия наследования этого класса:
(QObject, QPaintDevice) - QWidget - QPrintPreviewWidget
Конструктор класса QPrintPreviewWidget имеет следующие форматы вызова:
QPrintPreviewWidget( [parent=None] [, flags=0])
QPrintPreviewWidget(<Пpинтep QPrinter>[, parent=None][, flags=0])
Первый формат создает компонент, привязанный к используемому по умолчанию устройст
ву печати, второй формат позволяет указать нужный принтер. Параметр l?arent задает роди
теля, а параметр flags - тип окна (см.разд. 19.11).
Последовательность действий, необходимых для реализации предварительного просмотра
с помощью класса QPrintPreviewWidget, почти такая же, что и в случае класса
QPrint_PreviewDialog: мы создаем объект класса QPrintPreviewWidget, назначаем для его
сигнала paintRequested() обработчик и пишем в этом обработчике код, который и выпол
нит вывод документа.
Класс QPrintPreviewWidget поддерживает ряд методов, предназначенных для выполнения
различных действий над выведенным в панели документом. Рассмотрим их:
♦ setOrientation(<Ориентация>) - задает ориентацию страницы в виде элемента Portrai t
(портретная) или Landscape (ландшафтная) перечисления Orientation из класса
QPageLayout. Метод является слотом;
♦ setPortraitOrientati�n() - задает псJртретную ориентацию страницы. Метод является
слотом;
♦ setLandscapeOrientation() - задает ландшафтную ориентацию страницы. Метод явля
ется слотом;
Глава 30. Лечать документов 747
♦ zoomFactor() - возвращает значение масштаба;
♦ pageCount() - возвращает общее количество страниц в документе;
♦ setCurrentPage(<Номер странищ,r>) -··задает номер страницы, выводимой в панели. Ме
тод является слотом;
♦ currentPage() - возвращает номер страницы;,вы)3<щящейся в панели в данный момент;
♦ updatePreview () - обновляет содержимое панели. При этом будет снова сгенерирован
сигнал paintRequested() . Метод является слотом;
♦ print() - печатает документ, отображающийся в панели, с выводом на экран диалого-
вого окна выбора и настройки принтера. Метод является слотом.
В дополнение к paintRequested(), класс QPrintPreviewWidget поддерживает сигнал
previewChanged() . Он генерируется при изменении параметров панели просмотра: ориента
ции страницы, режима просмотра, масштаба и др.
30.4. Класс QPrinterlnfo:
получение сведений об устройстве печати
Класс QPrinterinfo позволяет получитр сведения как обо всех установленных в системе
физических устройствах печати, так и о конкретном устройстве, указанном нами. Форматы
его конструктора следующие:
QPrinterinfo(<Пpинтep QPrinter>)
QPrinterinfo(<Иcxoдный объект QPrinterinfo>)
Первый формат создает объект со сведениями об устройстве печати, связанном с заданным
принтером. Второй формат создает копию указанного исходного объекта.
Класс QPrinterinfo поддерживает следующие методы:
♦ availaЫePrinters() - статический, возвращает список всех установленных в системе
устройств rieчaпt; представлеIПIЫХ объектами класса QPrinter::i:nfo;
♦ availaЫePrinterNames() - статический, возвращает список имен всех установленных
в системе устройств печати:
>>> 1 = QtPrintSupport.QPrinterinfo.availaЫePrinterNames()
>>> for р in 1: print(p)
OneNote for Windows 10
PDFCreator
Microsoft XJS Document Writer
Microsoft Print to PDF
Fax
Canon iP2800 series
♦ · default'Printer()· - статический, возвращает сведения об устройстве печати, используе
мом по умолчанию, в виде объекта класса QPrinterinfo;
♦ defaultPrinterNarrie() - статический, возвращает ИМЯ устройства печати, исnользуемо
ГО по умолчанию:
>�>.print(QtPrintSupport.QPrinterinfo.defaultPrinterName() )
Canon iP2800 series
748 Часть 11. Библиотека PyQt б
♦ printerlnfo(<Имя устройства печати>) � статический, возвращает объект класса
QPrinterinfo, хранящий сведения об устройстве печати с указанным именем. Если тако
го устройства печати нет, возвращается некорректный, «пустой» объект класса. Пример:
>>> р = QtPrintSupport.QPrinterlnfo.printerlnfo("Canon iP2800 series")
♦ isNull() - возвращает True, если текущий объект указывает на конкретное установ
ленное в системе устройство печати, и False, если он является «пустым»;_
♦ printerName() - возвращает имя текущего устройства печати;
♦ makeAndМodel() - возвращает развернутое наименование устройства печати с указанием
его изготовителя, если таковые сведения имеются в наличии, или просто его имя -
в противном случае;
♦ description() - возвращает развернутое описание устройства печати, если таковое
имеется в наличии, или просто его имя - в противном случае;
♦ location() - возвращает указание на местоположение устройства печати, если таковое
имеется в наличии, или пустую строку - в противном случае;
♦ isDefault() - возвращает True, если устройство печати помечено как используемое по
умолчанию, и False - в противном случае;
♦ isRemote() - возвращает тrue, если это сетевое устройство печати, и False, если ло
кальное;
♦ state() - возвращает текущее состояние устройства печати в виде одного из следую
щих элементов перечисления PrinterState из класса QPrinter:
• Idle - простаивает;
• Active - идет печать;
• AЬorted - печать была прервана;
• Error - возникла ошибка;
♦ supportedPageSizes() - возвращает список поддерживаемых устройством печати раз
меров бумаги, представляемых объектами класса QPageSize:
>>> 1st = p.supportedPageSizes()
>>> for 1 in 1st: print(l.name())
Letter 22х28 см 8.S"xll"
Legal 22х36 см 8.5"х14"
А5
А4
. Остальной вывод пропущен . . .
♦ supportsCustomPageSizes() - возвращает тrue, если устройство печати поддерживает
указание произвольного размера бумаги, и False - в противном случае;
♦ supportedResolutions () - возвращает список разрешений, поддерживаемых устройст
вом печати и измеряемых в точках на дюйм;
♦ supportedDuplexМodes() - возвращает список поддерживаемых устройством печати
режимов двусторонней печати. Каждый элемент списка является одним из элементов
перечисления DuplexМode из класса QPrinter (см.разд. 30.1.1);
Глава 30. Печать документов 749
♦ supportedColorModes() - возвращает список поддерживаемых устройством печати
режимов вывода цвета. Каждый элемент списка является одним из элементов перечис
ления ColorMode из класса QPrinter (см.разд. 30.1. /);
♦ defaultPageSize() - возвращает установленный по умолчанию размер бумаги в виде
объекта класса QPageSize:
>>> ps � p.defaultPageSize()
>>> print(p.defaultPageSize().narne())
А4
>>> s = ps.size(QtGui.QPageSize.Millimeter)
>>> print(s.width(),"x", s.height())
210.0 х 297.0
♦ defaul tDuplexМode() - возвращает зада1rnый по умолчанию режим двусторонней печати
в виде элемента перечисления DuplexМode;
♦ defaultColorMode() - возвращает заданный по умолчанию режим вывода цвета в виде
элемента перечисления ColorMode;
♦ minimumPhysicalPageSize() и maximumPhysicalPageSize() - возвращают соответственно
минимальный и максимальный размеры бумаги , поддерживаемые принтером и пред
ставленные объектами класса QPageSize:
>>> ps = p.maximumPhysicalPageSize()
>>> print(ps.narne())
Custom (1190pt х 1916pt)
>>> s = ps.size(QtGui.QPageSize.Millimeter)
>>> print(s.width(),"x", s.height())
419.81 х 675.92
30.5. Класс QPdfWriter. экспорт в формат PDF
В разд. 30.1.1 упоминалось о возможности сохранения печатаемого документа в файл фор
мата PDF - для этого достаточно вызвать метод setOutputFileNarne(), передав ему в каче
стве параметра путь к файлу и указав у этого файла расширение pdf. Однако при этом
задействуется подсистема печати Windows, что приводит к напрасному расходу системных
ресурсов.
Библиотека PyQt предоставляет возможность экспорта документов в формат PDF напря
мую, без использования подсистемы печати. Это обеспечивает класс QPdfWriter, опреде
ленный в модуле QtGui. Его иерархия наследования:
QPaintDevice - (QObject, QPagedPaintDevice) - QPdfWriter
Формат конструктора этого класса:
QPdfWriter(<Пyть к результиру�ацему РDF-файлу>)
Вывод документа в формат PDF выполняется так же , как и его печать (см.разд. 30.1.2). Как
и QPrinter, класс QPdfWriter поддерживает метод newPage(), подготавливающий следую
щую страницу документа для вывода.
Класс QPdfWriter поддерживает также и следующие полезные .методы (полный их список
можно найти на страницах https://doc.qt.io/qt-6/qpdfwriter.html и https://doc.qt.io/qt-6/
qpagedpaintdevice. htm l):
750 Часть 11. Библиотека PyQt б
♦ setPageSize (<Размер QPageSize>) � задает размер страницы. Возвращает True, если
операция увенчалась успехом, и False - в противном случае;
♦ setPageOrientation(<Opиeнтaция>) - задает ориентацию страницы в виде значения
элемента Portrait (портретная) ИЛИ Landscape (ландшафтная) перечисления Orientation
из класса QPageLayout. Возвращает True, есЩI операция увенчалась успехом, и False -
в противном случае;
♦ setPageMargins(<Отступы QMarginsF> [, units=Unit.Millirneter]) - задает отступы от
краев страницы в заданных единицах измерения. Последние указьmаются в параметре units
в виде одного из элементов перечисления Unit из класса QPageLayout (см. разд. 30.1.1).
Возвращает тrue, если операция увенчалась успехом, и False - в противном случае;
♦ setPageLayout(<Параметры QPageLayout>) - задает сразу все параметры страницы (раз
меры, ориентацию, отступы от краев страницы и т. п.). Возвращает True, если операция
увенчалась успехом, и False - в противном случае;
♦ setResolution(<Paзpeшeниe>) - задает разрешение в виде целого числа в точках на
дюйм;
♦ resolution() - возвращает разрешение в виде целого числа в точках на дюйм;
♦ setTitle(<Заголовок>) -задает заголовок документа, который будет записан в файл PDF;
♦ setcreator(<Имя создателя>) - задает имя создателя документа, ·которое будет записа
но в файл PDF;
♦ setPdfVersion(<Bepcия>) - задает версию формата PDF, в которой будет создан доку
мент, в виде одного из следующих элементов перечисления PdfVersion из класса
QPdfWriter: PdfVersion_l_4, PdfVersion_Alb или PdfVersion_l_б.
Возьмем код из листинга 30.1 и немного переделаем его: пусть на первой странице он вы
водит надпись «QPdtwriter» и выполняет печать в файл формата PDF на бумаге формата А5
(листинг 30.6).
frorn PyQtб import QtCore, QtWidgets, QtGui, QtPrintSupport
import sys
арр = QtWidgets.QApplication(sys.argv)
writer = QtGui.QPdfWriter("output.pdf")
writer.setCreator( 11 Владимир Дронов 11)
writer.setTitle("Tecт 11 )
layout = QtGui.QPageLayout()
layout.setPageSize(QtGui.QPageSize(QtGui.QPageSize.PageSizeid.A5))
layout.setOrientation(QtGui.QPageLayout.Orientation.Portrait)
writer.setPageLayout(layout)
painter = QtGui.QPainter()
painter.begin(writer)
color = QtGui.QColor(QtCore.Qt.GlobalColor.Ыack)
painter.setPen(QtGui.QPen(color))
painter.setBrush(QtGui.QBrush(color))
font = QtGui.QFont( 11 Verdana 11 , pointSize=42)
painter.setFont(font)
Глава 30. Печать документов 751
# Получаем размеры страницы в пикселах для текущего экранного разрешения
page_size = layout.paintRectPixels(writer.resolution())
page_width = int(page_size.width().)
page_height = int(page_size.height())
painter.drawТext(l0, page_height // 2 - 50, page_width - 20, 50,
QtCore.Qt.AlignmentFlag.AlignCenter I QtCore.Qt.TextFlag.TextDontClip,
"QPdfWriter")
layout.setOrientation(QtGui.QPageLayout.Orientation.Landscape)
writer;setPageLayout(layout)
writer.newPage()
page_size = layout.paintRectPixels(writer.resolution())
page_width = int(page_size.width())
page_height = int(page_size.height())
pixmap = QtGui.QPixmap("img.jpg")
pixmap = pixmap.scaled(page_width, page_height,
aspectRatioMode=QtCore.Qt.AspectRatioMode.KeepAspectRatio)
painter.drawPixmap(0, О, pixmap)
painter.end()
У класса QPdfWriter есть недостаток - создаваемые с его помощью РDF-документы имеют
очень большой размер. Так, у авторов после выполнения кода из листинга 30.6 получился
файл объемом в 7,1 Мбайт. Вероятно, PyQt создает документъ1 максимально допустимого
в формате PDF качества, и понизить его, тем самым уменьшив размер результирующих
файлов, невозможно.
ГЛАВА 31
Сохранение настроек программ
PyQt позволяет сохранять настройки программ в едином хранш1Uще настроек, в качестве
которого могут использоваться как реестр Windows (по умолчанmо), так и INI-файл.
Для работы с таким хранилищем предусмотрен удобный класс QSettings, определенный
в модуле QtCore.
31.1. Создание объекта класса QSettings
Форматы конструктора класса QSettings:
QSettings([parent=None])
QSettings(<Ypoвeнь>[, parent=None])
QSettings(<Haзвaниe организации>[, application=""J [, parent=None])
QSettings(<Ypoвeнь>, <Название организации>[, application=""][, parent=None])
QSettings(<Tип хранипища>, <Уровень>, <Название организации>[,
application=""] [, parent=None])
QSettings(<Пyть к файлу или ключу реестра>, <Тип хранипища>[, parent=None])
Первый формат создает объект, хранящий настройки на уровне текущего пользователя
в реестре Windows.
Чтобы настройки успешно сохранились, понадобится задать названия организации и про
граммы, и сделать это нужно еще до создания объекта класса QSettings. В этом нам помо
гут следующие два статических метода класса QApplication из модуля QtWidgets:
♦ setOrganizationName (<Название организации>) - задает название организации; .
♦ setApplicationName(<Название программы>) - задает название программы.
Пример:
QtWidgets.QApplication.setOrganizationName("Пpoxopeнoк и Дронов")
QtWidgets.QApplication.setApplicationName("Tecтoвaя программа")
settings = QtCore.QSettings()
Второй формат позволяет указать уровень хранения настроек в виде одного из следующих
элементов перечисления Scope из класса QSettings:
♦ userscope - уровень текущего пользователя;
♦ SystemScope - уровень системы.
Эти настройки тоже будут храниться в реестре Windows.
Глава 31. Сохранение настроек программ 753
В третьем формате задается <Название организации> - разработчика программы. В необя
зательном параметре application можно указать название программы. Настройки также
будут храниться на уровне текущего пользователя в реестре Windows.
В четвертом формате, помимо названий организации и программы, можно задать уровень
хранения настроек в виде элемента перечисления scope.
Пятый формат позволяет сверх того задать тип хранилища в виде одного из следующих
элементов перечисления Fonпat из класса QSettings:
♦ NativeFonпat - реестр Windows: его 32-разрядная копия, если программа работает под
управлением 32-разрядной редакции Python, и 64-разрядная - для 64-разрядной редак
ции языка;
♦ IniFonпat - INI-файл;
♦ Registry32Foпnat - для 64-разрядных программ - 32-разрядная. копия реестра, для
32-разрядных программ аналогичен атрибуту NativeFoпnat;
♦ Registry64Fonпat - для 32-разрядных программ, запущенных под 64-разрядной
Windows, - 64-разрядная копия реестра. Для 32-разрядных программ, работающих под
32-разрядной Windows, и 64-разрядных программ - аналогичен NativeFonпat.
Шестой формат позволяет напрямую указать <Путь к файлу или ключу реестра>, где будут
храниться настройки (в частности, этот формат пригодится в случае, если нужно прочитать
какие-либо системные настройки). В качестве параметра <ТИп хранилища> следует указать
один из следующих элементов перечисления Fonпat из класса QSettings:
♦ NativeFonпat - реестр;
♦ IniFonпat - INI-файл.
Класс QSettings поддерживает следующие методы, позволяющие узнать значения парамет
ров, которые были заданы при создании объекта:
♦ organizationName () - возвращает название организации;
♦ applicationName () - возвращает название программы;
♦ scope () - возвращает обозначение уровня храпе� настроек в виде элемента перечис
ления Scope;
♦ fonпat () - возвращает обозначение формата хранения настроек в виде элемента пере
числения Fonпat;
♦ fileName () - возвращает путь к ключу реестра или INI-файлу с настройками.
31 .2. Запись и чтение данных
Создав объект класса QSettings, мы можем приступить к сохранению настроек или чтению
их.
31.2.1. Базовые средства записи и чтения данных
Для выполнения простейших операций по записи и чтению-данных класс QSettings предос
_
тавляет следующие методы:
♦ setValue (<Имя значения>, <Значение>) - записывает заданное <Значение> под указан
ным в виде.строки <Именем>. <Значение> может быть любого типа;
754 Часть 11. Библиотека PyQt б
♦ value(<Имя значения> [, defaultValue=None]) - считывает значение с указанным в виде
строки <Именем> и возвращает его в качестве результата. В необязательном параметре
defaultValue можно указать значение, которое будет возвращено, если значение с за
данным <Именем> не будет найдено;
♦ remove(<Имя значения>) - удаляет_зн,ачение с заданным в виде строки <Именем>. Если
в качестве параметра была передана пустая_ строка, будут удалены все значения, что на
ходятся в хранилище;
♦ contains(<Имя значения>) - возвращает True, если значение с заданным <Именем> су-
ществует в хранилище, и False - в противном случае;
♦ childКeys() - возвращает список имен имеющихся в хранилище значений;
♦ clear() - удаляет все значения из хранилища;
♦ sync() - выполняет принудительную запись всех выполненных в хранилище измене-
ний в реестр или файл.
В листинге 31.1 приведен код программы, которая записывает в хранилище настроек (по
скольку формат хранения не задан, в качестве хранилища выступает реестр) число, строку и
объект класса QSize. Далее она считывает все сохраненные ранее значения, выводит их на
экран и проверяет, присутствует ли в хранилище настроек значение, которое заведомо там
не сохранялось. Наконец, она очищает хранилище.
from PyQtб import QtCore, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
settings = QtCore.QSettings("Пpoxopeнoк и Дронов", "Тест 1")
vl 123
v2 = "Python"
v3 = QtCore.QSize(640, 480)
print(vl, v2, v3, sep=" 1 ")
print("Сохраняем настройки")
settings.setValue("Знaчeниe 2", v2)
settings.setValue("Знaчeниe 3", v3)
settings.sync()
print("Считываем настройки")
lvl settings.value("Знaчeниe 1")
lv2 = settings.value("Знaчeниe 2")
lv3 = settings.value("Знaчeниe 3")
pririt(lvl, lv2, lv3, sep=" 1 ")
if settings.contains("Знaчeниe 4"):
print("Значение 4 в хранилище присутствует")
else:
рrint("Значение 4 в хранилище отсутствует")
print("Очищаем хранилище")
settings.clear ()
В консоли эта программа вьmедет:
123 1 Python I PyQt6.QtCore.QSize(640, 480)
Сохраняем настройки
Глава- 31. Сохранение настроек программ 755
Сч,-�.тываем настройки
123 1 Python I PyQtб.QtCore.QSize(640, 480)
Значение 4 в хранилище отсутствует
Очищаем хранилище
Теперь прочитаем из реестра путь к системному каталогу Документы, для чего воспользу
емся пятым форматом конструктора класса QSettings (см.разд. 31. 1):
>» settings = QtCore.QSettings("HКEY_CURRENT_USER\\Software\\" +
"Microsoft\\Windows\\CurrentVersion\\" +
"Explorer\\Shell Folders",
QtCore.QSettings.Format.NativeFormat)
>>> settings.value("Personal")
'D:\\Dаtа\\Документы'
31 .2.2. Группировка сохраняемых значений. Ключи
PyQt позволяет объединять сохраняемые в хранилище настроек значения по какому-либо
признаку в особые группы, назьmаемые ключами. Каждый ключ способен содержать произ
вольное количество значений, а разные ключи могут содержать значения с одинаковыми
именами. Для создания ключей можно применить два способа: простой и сложный.
Простой способ заключается в том, что в первом параметре метода setValue() имя значе
ния предваряется именем ключа, в которое его следует поместить, и отделяется от него
прямым слешем:
settings.setValue("Кrnoч 1/Значение 1", vl)
lvl = settings.value("Кrnoч 1/Значение 1")
Кmочи можно вкладъmать внутрь других ключей:
settings.setValue("Кrnoч 2/Вложенный ключ 1/Значение 4", v4)
lv4 = settings.value("Кrnoч 2/Вложенный ключ 1/Значение 4")
Сложный способ (который на самом деле не так уж и сложен) пригодится, если нужно со
хранить в одном ключе сразу несколько значений или прочитать ряд значений из одного
и того же ключа. Для его реализации следует выполнить следующие шаги:
1. Вызвать метод beginGroup(<Имя или путь ключа>) класса QSettings, который предпишет
PyQt с этого момента работать с заданным ключом. В качестве параметра методу пере
дается имя ключа, к содержимому которого следует обратиться, или же целый «путь»,
если нужно создать вложенный ключ. Примеры:
settings .beginGroup("Кrnоч 1")
settings._beginGroup("Кrnоч 2/Вложенный ключ 1")
2. Выполнить запись или чтение нужных значений с помощью методов setValue() и
value() (см. разд. 31.2.1). В этом случае значения будут записаны в ключ, указанный
в предыдущем вызове метода beginGroup(), или же прочитаны из этого ключа.
3. Вызвать метод endGroup() класса QSettings, который завершит работу с ключом.
Использование методов beginGroup() и endGroup() имеет ряд особенностей, о которых нам
обязательно следует знать.
756 Часть 11. Библиотека PyQt 6
♦ Методы remove(), contains() и childКeys(), если их вызовы помещены между вызовами
упомянутых ранее методов, действуют только внутри указанного в вызове метода
beginGroup() кточа. Так; метод contains() будет искать значение с указанным именем
только в текущем кточе.
♦ Вызов метода remove() с передачей ему в качестве параметра пустой строки удалит все
значения, сохраненные в текущем ·юпоче, не затрагивая содержимое других кточей и
«корня» хранилища.
♦ Список, возвращаемый методом childКeys(), будет вкточать не только имена значений,
но и имена всех ключей, вложенных в текущий кточ.
♦ Для проверки существования какого-либо кточа можно использовать метод contains(),
вызвав его в кточе предыдущего уровня или же в «корне» хранилища, если кточ никуда
не вложен.
♦ Для удаления кточа можно использовать метод remove(), · который в этом случае вызы-
вается точно так же.
При использовании кточей могут пригодиться три следующих метода класса QSettings:
♦ group() - возвращает строку с именем текущего кточа;
♦ childGroups() - возвращает список с именами всех кточей, что имеются в текущем;
♦ allKeys() - возвращает список полных путей ко всем значе�, что имеются в храни-
лище, вкточая значения, которые сохранены в кточах.
В листинге 31.2 приведен код программы, окно которой сохраняет свое местоположение
при завершении и восстанавливает при запуске. Помимо этого, при нажатии специальной
кнопки выполняется сохранение текста, занесенного пользователем в поле ввода. Местопо
ложение окна и введенный текст сохраняются в разных группах.
from PyQtб import QtCore, QtWidgets
import sys
class MyWindow(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent,
flags=QtCore.Qt.WindowТype.Window)
self.setWindowТitle("Иcпoльзoвaниe ключей")
self.settings = QtCore.QSettings("Пpoxopeнoк и Дронов",
"Использование ключей")
vbox = QtWidgets.QVВoxLayout()
self.txtLine = QtWidgets.QLineEdit(parent=self)
vbox.addWidget(self.txtLine)
btnSave = QtWidgets.QPushВutton("&Coxpaнить текст")
btnSave.clicked.connect(self.saveText)
vbox.addWidget(btnSave)
self.setLayout(vbox)
if self.settings.contains("Oкнo/Mecтoпoлoжeниe"):
self.setGeometry(self.settings.value("Oкнo/Mecтoпoлoжeниe") )
Глава 31. Сохранение настроек программ 757
else:
self.resize(200, 50)
if self.settings.contains("Дaнныe/Teкcт"):
self.txtLine.setText(self.settings.value("Дaнныe/Teкcт"))
def closeEvent(self, evt):
self.settings.beginGroup("Oкнo")
self.settings.setValue("Mecтoпoлoжeниe", self.geometry())
self.settings.endGroup()
def saveтext(self):
self.settings.beginGroup.("Данные")
self.settings.setValue("Teкcт", self.txtLine.text())
self.settings.endGroup()
арр = QtWidgets.QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
31.2.3. Запись списков
Для записи в хранилище настроек списка каких-либо значений следует выполнить следую
щую последовательность действий:
1. Вызвать метод beginWriteArray(<Имя или путь ключа> [, size=-1] ) класса QSettings.
Первым параметром методу передается <Имя или путь ключа>, в котором будут сохране
ны элементы списка. В необязательном параметре size можно указать размер списка -
если задать значение -1 или вообще опустить этот параметр, PyQt определит размер со
храняемого списка самостоятельно.
2. Перебрать сохраняемый список в цикле, внутри которого выполнить следующие дейст
вия:
• вызвать метод setArrayindex(<Индекс записываемого элемента>) класса QSettings,
тем самым указав PyQt, что сейчас будет записан элемент списка с заданным индек
сом;
• собственно, записать элемент списка, индекс которого был задан ранее.
3. Закончив запись элементов списка, по завершении выполнения цикла вызвать метод
endArray() класса QSettings. Это послужит сигналом окончания записи списка.
Прочитать список из хранилища настроек можно точно таким же образом, только на шаге 1
вместо метода beginWriteArray() следует вызвать метод beginReadArray(<Имя или путь
ключа>) того же класса QSettings. Метод в качестве результата вернет размер списка, ранее
сохраненный методом beginWriteArray(). Этот размер понадобится для формирования цик
ла, который будет выполнять выборку элементов списка.
На шаге 2, после вызова метода setArrayindex(), можно пользоваться методами remove() и
contains() для удаления и проверки существования значения соответственно. Эти методы
будут действовать только для элемента списка с указанным в вызове метода setArrayrnctex()
индексом.
758 Часть 11. Библиотека PyQt б
При использовании описанного здесь подхода в хранилище настроек создается следующая
структура ключей и значений:
♦ ключ, чье имя (путь) было задано в вызове метода beginWriteArray(). В этом кmоче
будут созданы:
• значение size - хранящее размер записанного списка. Этот размер будет возвращен
методом beginReadArray();
• ключ, чье имя совпадает с индексом, заданным очередным вызовом метода
setArrayindex() и увеличенным на единицу.
В этом кmоче будут созданы значения, записываемые последующими вызовами
метода setValue().
В качестве примера рассмотрим листинг 31.3, в котором приведен код, формирующий спи
сок строк, записывающий его в хранилище настроек, считывающий впоследствии и выво
дящий на экран.
from PyQtб import QtCore, QtWidgets
import sys
арр = QtWidgets.QApplication(sys.argv)
settings = QtCore.QSettings("Пpoxopeнoк и Дронов", "Тест 2")
1 = ["Python", "RuЬy", "РНР", "JavaScript"]
print(1)
print("Coxpaняeм список")
settings.beginWriteArray("Список")
for i, el in enumerate(l):
settings.setArrayindex(i)
settings.setValue("Элeмeнт", el)
settings.endArray()
settings . sync()
рrint("Считываем список")
11 = []
lSize = settings.beginReadArray("Cпиcoк")
for i in range(lSize):
settings.setArrayindex(i)
11.append(settings.value("Элeмeнт"))
settings.endArray()
print(ll)
settings.clear()
В консоли эта программа выведет следующее:
['Python', 'RuЬy', 'РНР', 'JavaScript']
Сохраняем список
Считываем список
['Python', 'RuЬy', 'РНР', 'JavaScript']
Глава 31. Сохранение настроек программ 759
31.3. Вспомогательные методы класса QSettings
Теперь познакомимся с вспомогательными методами класса QSettings, которые могут при
годиться в некоторых случаях.
♦ · status ( ) - возвращает обозначение состояния,. в котором пребывает хранилище на
строек после выполнения очередной операции, выраженное в виде одного из следующих
элементов перечисления status класса QSettings:
• NoError - операция была успешно выполнена, и никаких ошибок не возникло;
• AccessError - возникла ошибка доступа к реестру или INI-файлу (возможно, была
произведена попытка чтения недоступного для текущего пользователя кmоча реест
ра, файла или же запись в файл, недоступный для записи);
• Fo:пnatError - бьmа выполнена попытка открыть некорректно сформированный INI
файл;
♦ isWritaЫe () - возвращает True, если хранилище настроек доступно для записи, и
False - в противном случае (например, если хранилищем является INI-файл, на запись
в который текущий пользователь не имеет прав).
31.4. Где хранятся настройки?
· Если местоположение хранилища настроек не указано явно (т. е. используются форматы
вызова конструктора класса QSettings, отличные от шестого, подробности- в разд. 31.1),
настройки будут храниться по следующим местоположениям:
♦ при сохранении в реестр Windows (указацы типы хранилища NativeFormat,
Registry32Format или Registry64Fo:пnat):
• если выполняется сохранение на уровне текущего пользователя (указан диапазон
UserScope):
" когда название программы указано (т. е. задан параметр application конструкто
ра) - в ветви HКEY_GJRRENТ_USER\Software\<Haзвaниe организации>\<Название про
грамм,�>;
" когда название программы не указано (т. е. параметр application конструктора
не задан) - в ветви НКЕУ_ CURRENT_USER\Software \ <Название организации>\
OrganizationDefaults (похоже, что в таком случае PyQt считает, что заданные
настройки применяются сразу ко всем программам, разработанным этой органи
зацией);
• если выполняется сохранение на уровне системы (указан диапазон SysternScope):
" когда название программы указано - в ветви HКEY_LOCAL_МACНINE\Software\
<Название организации>\<Название программы>;
" когда название программы не указано - в ветви HКEY_LOCAL_МACНINE\Software\
<Название opгaнизaции>\OrganizationDefaults.
Программы, работающие под управлением 32-разрядной редакции Python на 64-раз
рядной редакции Windows, если указан тип хранилища, отличный от Registry64Fo:пnat,
сохраняют настройки в ветвях HКEY_LOCAL_МACHINE\Software\WOW6432node\<Haзвaниe
760 Часть 11. Библиотека PyQt б
организации>\<Название программы> И HКEY_LOCAL_МACHINE\Software\WOW6432node\
<Название организации>\Organizat ionDefaul ts соответственно;
♦ при сохранении в INI-файл (указан тип хранилища IniFoпnat):
• если выполняется сохранение на уровне текущего пользователя:
□ когда название программы указано - в файле <каталог пользовательского про
филя>\АррDаtа\Rоаmiпg\<Название орrанизации>\<Название программы>.iпi;
□ когда название программы не указано - в файле <каталог пользовательского
профиля>\АррDаtа\Rоаming\<Название организации>.ini;
• если выполняется сохранение на уровне системы:
□ когда название программы указано - в файле <системный диск>:\РгоgгаmDаtа\
<Название орrанизации>\<Название nporpaммы>.ini;
□ когда название программы не указано - в файле <системный диск>:\РгоgгаmDаtа\
<Название организации>.ini.
ГЛАВА 32
Программа «Судоку»
В завершение в качестве примера напишем на языке Python с применением библиотеки
PyQt программу «Судоку». Она предназначена для создания и решения головоломок судоку
и позволит, помимо всего прочего, сохранять головоломки в файлах, загружать их из фай
лов и выводить на печать.
Изначально программа бьmа разработана Н. Прохоренком в 2011 году на языке С++. Для
этой книги она переписана на Python и несколько усовершенствована В. Дроновым в конце
2017 года.
32.1. Правила судоку
Судоку- традиционная японская числовая головоломка (иногда ее неправильно называют
магическим квадратом). Далее приведены правила ее решения (полное описание судоку
можно найти по интернет-адресу https://ru.wikipedia.org/wiki/Cyдoкy).
♦ Поле судоку представляет собой квадрат, разбитый на 81 ячейку (9 столбцов по 9 строк).
Каждые 9 ячеек объединены в группу 3 х 3 - итого получается 9 групп.
♦ В каждую ячейку поля можно подставить только одну цифру от I до 9.
♦ Ячейки группы не должны содержать одинаковых цифр.
♦ Одна и та же цифра должна присутствовать в каждой строке и каждом столбце поля
только один раз.
На рис. 32.1 приведен пример решенной судоку.
5 4 7 8 6 3 9 2 1
3 8 1 2 9 7 6 5 4
2 9 6 5 1 4 8 3 7
6 2 5 9 3 1 4 7 8
7 3 8 4 2 б 1 9 5
4 1 9 7 5 8 3 б 2
9 7 3 1 8 2 5 4 6
1 6 2 3 4 5 7 8 9
8 5 4 6 7 9 2 1 3
Рис. 32.1. Решенная судаку (группы выделены утолщенными рамками)
762 Часть 11. Библиотека PyQt б
Как правило, судоку решают вдвоем: один игрок произвольно расставляет цифры в некото
рых ячейках поля, а второй, собственно, решает головоломку.
32.2. Описание программы «Судоку»
Программа «Судоку» выполнена в традиционном ключе, присущем обычным Windows
пporpaммaм. Ее окно (рис. 32.2) включает в себя главное меmо, панель инструментов,
основное, содержимое - поле судоку и набор кнопок для установки цифр в ячейки, и стро
ку состояния.
В самом поле судоку группы ячеек выделены различными цветами фона: оранжевым и
светло-серым. Установленные в них цифры выводятся черным цветом.
Одна из ячеек является активной - именно с активной ячейкой осуществляется взаимо
действие. Активная ячейка закрашена желтым цветом (на рис. 32.2 это ячейка с цифрой 4
в правом нижнем углу поля). Чтобы сделать какую-либо ячейку активной, следует:
♦ либо, пользуясь клавишами-стрелками, переместить на нее желтый фокус выделения;
♦ либо просто щелкнуть на ней мышью.
Чтобы установить в активную ячейку какую-либо цифру, следует:
♦ либо нажать соответствующую кнопку в наборе, расположенном ниже поля;
♦ либо нажать соответствующую цифровую клавишу.
Чтобы убрать цифру из активной ячейки, нужно:
♦ либо нажать кнопку Х, находящуюся в расположенном под полем наборе;
♦ либо нажать клавишу пробела, <Backspace> или <Del>.
fШ Судаку 2.0.0 Х
�айл [lравка �правка
2 1
{ ,. ""
4 5
,,
7 б
8
'
4
Рис. 32.2. Окно программы «Судаку»
Глава_ 32. Программа «Судоку» 763
Чтобь1 случайно не занести в какую-либо ячейку другую цифру, есть возможность заблоки
ровать ее. Для этого следует сделать нужную ячейку активной и нажать клавишу <F2>.
В заблокированной ячейке цифра выводится красным шрифтом (на рис. 32.2 заблокирована
ячейка с цифрой 5). Отметим, что блокировать можно только ячейки, содержащие цифры.
Снять блокировку с ячейки можно, сделав ее активной и нажав клавишу <F4>.
Главное меню программы содержит следующие пункты:
♦ меmоФайл:
• Новый (с ним связана комбинация клавиш <Ctrl>+<N>)- очистка поля;
• Открыть (<Ctrl>+<O>)- загрузка сохраненной ранее головоломки из выбранного
пользователем файла;
• Сохранить (<Ctrl>+<S>)- сохранение головоломки. в файле с указанным пользова
телем именем.
При выборе этого пункта производится сохранение в полном формате - т. е. для
каждой ячейки, помимо находящейся в ней цифры, сохраняется признак того, забло
кирована ли она;
• Сохранить компактно- сохранение головоломки в файле в компактном формате.
Компактный формат не предусматривает хранения признака блокировки ячейки.
Вследствие этого файл, сохраненный в компактном формате, вдвое меньше полно
форматного.
При открытии файла, сохраненного в компактном формате, производится автомати
ческая блокировка всех ячеек, содержащих цифры;
• Печать (<Ctrl>+<P>) - вывод головоломки на печать;
• Предварительный просмотр- просмотр головоломки в том виде, в котором она
будет выведена на печать;
• Параметры страницы - настройка параметров печатаемой страницы;
• Выход (<Ctrl>+<Q>)- завершение работы программы;
♦ меmо Правка:
• Копировать (<Ctrl>+<C>)- копирование головоломки в буфер обмена в полном
формате (аналогичном тому, в котором сохраняется файл при выборе пункта Сохра
. нить меmо Файл);
• Копировать компактно - копирование головоломки в буфер обмена в компактном
формате (аналогичном тому, в котором сохраняется файл при выборе пункта Сохра
нить компактно меmо Файл);
• Копировать для Excel- копирование головоломки в буфер обмена в формате,
предназначенном для вставки в таблицу Microsoft Ехсе\;
• Вставить (<Ctrl>+<V>)- вставка головоломки, скопированной ранее в любом фор
мате.
Ес11и головоломка была скопирована в компактном формате, все ячейки, содержащие
цифры, будут автоматически заблокированы;
• Вставить из Excel- вставка из буфера обмена головоломки, скопированной из таб
лицы Microsoft Ехсе\;
• Блокировать (<F2>)- блокировка активной ячейки;
764 Часть 11. Библиотека PyQt б
• Блокировать все (<FЗ>)- блокировка всех ячеек. Блокируются только ячейки, со
держащие цифры;
• Разблокировать (<F4>)- разблокировка активной ячейки;
• Разблокировать все (<F5>)- разблокировка всех ячеек;
♦ меюо Справка:
• О программе - вывод окна со сведениями о программе «Судоку»;
• О Qt - вывод окна со сведениями о фреймворке Qt.
При наведении курсора мыши на любой пункт меюо в строке состояния появляется его раз
вернутое описание.
В панели J:fНСтрументов присутствуют кнопки (в порядке слева направо): Новый, Открыть,
Сохранить, Печать, Предварительный просмотр, Копировать, Вставить, Блокировать
все и Разблокировать все. Они выполняют те же действия, что и одноименные пункты
меюо. При наведении курсора мыши на кнопку панели инструментов в строке состояния
появляется ее развернутое описание, а рядом с кнопкой спустя небольшой промежуток
времени появляется всплывающая подсказка (на рис. 32.2 курсор мыши наведен на кнопку
Сохранить).
Сохранение головоломок выполняется в текстовых файлах с расширением svd. Форматы,
в которых хранятся головоломки, будут описаны позже..
Окно программы при закрытии сохраняет свое местоположение и впоследствии, после сле
дующего запуска, восстанавливает его.
32.3. Разработка программы
32.3.1. Подготовительные действия
Создадим где-либо на диске каталог sudoku, в котором будут находиться все файлы нашей
будущей программы. В этом каталоге создадим два вложенных каталога:
♦ images - для хранения значков, которые будут выводиться в пунктах меюо и кнопках
панели инструментов, а также значок самой программы;
♦ modules - для хранения файлов с программными модулями Python, которые напишем
впоследствии.
Найдем в Интернете значки для представления самой программы, пунктов меюо и кнопок
панели инструментов. Сохраним их в каталоге images под именами svd.png (значок про
граммы), new.png, open.png, save.png, print.png, preview.png, copy.png, paste.png, lock.png и
unlock.png (значки кнопок).
32.3.2. Класс MyLabel: ячейка поля судоку
Начнем с создания класса MyLabel, который будет представлять отдельную ячейку поля су
доку, - 81 такой компонент и составит это поле.
Наш класс должен «уметь» выводить на экран цифру, занесенную в ячейку, отображать
обычное, активное и заблокированное состояния, реагировать на щелчки мышью, чтобы
сообщить компоненту поля судоку, что та или иная ячейка стала активной. Помимо этого,
Глава 32. Программа «Судаку» 765
ячейка должна иметь возможность принимать фоновый цвет- ведь именно разными цве
тами фона мы будем выделять группы ячеек на поле.
Визуально ячейка должна иметь размеры 30 х 30 пикселов и выводить цифру, выровненную
по середине без отступов от границ компонента.
Большую часть необходимой функциональности мы можем получить, просто сделав класс
MyLabel производным от класса надписи QLabel. Тогда, чтобы вывести на экран цифру,
можно просто задать ее в качестве содержимого надписи, воспользовавшись унаследован
ным методом setтext (), - также несложно будет указать необходимые размеры и вырав
нивание. А задать для текста и фона нужные цвета мы сможем, привязав к ячейке таблицу
стилей, для чего воспользуемся методом setstyleSheet (), опять же, унаследованным.
Теперь подумаем, какие атрибуты должен поддерживать класс MyLabel:
♦ colorYellow, colorOrange, colorGrey, colorBlack и colorRed- будут хранить RGВ-коды
соответственно желтого, оранжевого, светло-серого, черного и красного цветов. По
скольку значения этих атрибутов будут одинаковыми для всех объектов класса ячейки,
мы сделаем их атрибутами класса (если же сделать их обычными атрибутами, каждый
объект будет хранить свой собственный набор этих атрибутов, что приведет к избыточ
ному расходу оперативной памяти);
♦ isCellChange - значение тrue сообщит о том, что ячейка разблокирована, а значение
False - что она заблокирована;
♦ fontColorCurrent - текущий цвет текста: черный или красный;
♦ bgColorDefault - заданный при создании ячейки цвет фона: оранжевый или светло
серый. Он понадобится, чтобы перевести ячейку из активного в неактивное состояние;
♦ bgColorcurrent- текущий цвет фона: желтый, оранжевый или светло-серый;
♦ id- порядковый номер ячейки. Он понадобится, чтобы при щелчке мышью на ячейке
сообщить компоненту поля судоку, какая ячейка стала активной.
Компонент MyLabel будет входить в состав компонента поля, который мы напишем чуть
позже. Он должен уведомлять компонент поля, когда текущая ячейка становится активной
после щелчка мышью. Наилучший способ сделать это- объявить сигнал, который будет
генерироваться при щелчке. Обрабатывая этот сигнал, поле всегда будет «в курсе», на
какой ячейке был выполнен щелчок.
Мы объявим в .ячейке сигнал cellChangeFocus. Он будет передавать обработчику единст
венный параметр целочисленного типа - номер ячейки, на которой пользователь щелкнул
МЫШЬЮ.
Теперь определим набор необходимых методов нашего класса и представим в общих чер
тах, что должен делать каждый из них:
♦ ·mousePressEvent () - этот метод следует переопределить, чтобы получить возможность
обрабатывать щелчки мышью. Внутри него мы будем генерировать сигнал cellChangeFocus;
♦ shoWColorCurrent () - задаст для ячейки цвета текста и фона, взятые из атрибутов
fontco·lorcurrent и bgColorCurrent соответственно, и тем самым обновит визуальное
состояние ячейки, или, как говорят программисты, перерисует ее. Этот метод мы будем
вызывать после перевода ячейки из неактивного состояния в активное, из разблокиро
ванного - в заблокированное и наоборот;
♦ setCellFocus () - переведет ячейку из неактивного состояния в активное. Сделать это
очень просто - мы занесем в атрибут bgColorCurrent код желтого цвета (который хра-
766 Часть 11. Библиотека PyQt 6
нится в атрибуте класса colorYellow) и вызовем метод showColorCurrent(), чтобы обно
вить визуальное представление ячейки;
♦ clearCellFocus() - переведет ячейку из активного состояния в неактивное. Мы занесем
в атрибут bgColorCurrent значение цвета фона, взятое из атрибута bgColorDefaul t
(он, как мы помним, хранит код изначального цвета фона), и вызовем метод
showColorCurrent(), который перерисует ячейку;
♦ setCellВlock() - переведет ячейку из разблокированного состояния в заблокирован
ное. Здесь мы занесем в атрибут isCellChange значение False, тем самым указывая,
что ячейка заблокирована, присвоим атрибуту fontColorCurrent код красного цвета,
хранящийся в атрибуте класса colorRed, и перерисуем ячейку вызовом метода
showColorCurrent() ;
♦ clearCellBlock() - переведет ячейку из заблокированного состояния в разблокирован
ное. Д1Iя этого достаточно присвоить атрибуту isCellChange значение тrue, занести в ат
рибут fontColorCurrent значение черного цвета из атрибута объекта colorBlack и не
забыть перерисовать ячейку вызовом метода showColorCurrent() ;
♦ setNewТext() - занесет в ячейку новое число, переданное ему в качестве единственного
параметра в виде строки. Здесь нужно предварительно проверить, не заблокирована ли
ячейка (не хранится ли в атрибуте isCellChange значение False), и уже потом вызывать
унаследованный от класса QLabel метод setText() ;
♦ конструктор должен принимать в качестве обязательных параметров номер создаваемой
ячейки (он будет занесен в атрибут id), цвет ее фона (его мы присвоим атрибутам
bgColorDefault и bgColorCurrent), а также необязательный параметр родителя parent.
Еще он должен присвоить атрибуту isCellChange значение True - вновь созданная
ячейка изначально должна быть разблокирована. Напоследок он перерисует ячейку,
вызвав метод showColorCurrent().
Код класса MyLabel относительно невелик, несложен и полностью приведен в листинге 32.1.
Его следует сохранить в модуле mylabel.pyw в каталоге modules.
ЭЛЕКТРОННЫЙ АРХИВ
Напомним, что файлы с кодами разрабатываемой в этой главе программы. находятся
в папке sudoku сопровождающего книгу электронного архива (см. приложение).
! ЛИстинr за.1. Класс МуLаЬе1
from PyQtб import QtCore, QtWidgets
class MyLabel(QtWidgets.QLabel):
colorYellow = "#FFFF90"
colorOrange = "#F5D8Cl"
colorGrey = "#Е8Е8Е8"
colorBlack = "#000000"
colorRed = "#D77A38"
changeCellFocus = QtCore.pyqtSignal(int)
def init (self, id, bgColor, parent=None):
QtWidgets.QLabel. init (self, parent)
Глава 32. Программа ((Судаку» 767
self.setAlignment(QtCore.Qt.AlignmentFlag.AlignCenter)
self.setFixedSize(З0, 30)
self.setMargin(0)
self.setText("")
if id < О or id > 80:
id = О
self.id = id
self.isCellChange = True
self.fontColorCurrent = self.colorBlack
self.bgColorDefault = bgColor
self.bgColorCurrent = bgColor
self.showColorCurrent()
def. mousePressEvent(self, evt):
self.changeCellFocus.emit(self.id)
QtWidgets.QLabel.mousePressEvent(self, evt)
def showColorCurrent(self):
self.setStyleSheet("background-color:" + self.bgColorCurrent +
";color:" + self.fontColorCurrent + ";")
def setCellFocus(self):
self.bgColorCurrent = self.colorYellow
self.showColorCurrent()
def clearCellFocus(self):
self.bgColorCurrent = self.bgColorDefault
self.showColorCurrent()
def setCellBlock(self):
self.isCellChange = False
self.fontColorCurrent = self.colorRed
.self.showColorCurrent()
def clearCellBlock(self):
self.isCellChange = True
self.fontColorCurrent = self.colorBlack
self.showColorCurrent()
def setNewТext(self, text):
if self.isCellChange:
self.setтext(text)
Отметим пару чисто технических деталей:
♦ в методе mousePressEvent (), выполнив все необходимые действия, а именно сгенериро
вав сигнал changeCellFocus, мы в обязательном порядке вызываем тот же метод супер
класса. Если этого не сделать, возможны проблемы;
♦ в методе showColorCurrent() мы вызовом метода setStyleSheet() привязываем к наше
му компоненту таблицу стилей, которая установит для ячейки цвета текста и фона (про
чие параметры для компонента мы установим в таблице стилей, привязанной к компо
ненту основного окна, которую создадим позже).
768 Часть 11. Библиотека PyQt б
32.3.3. Класс Widget: поле судоку
Класс Widget представит само поле судоку, составленное из 81 компонента MyLabel, напи
санного ранее, и набора из 10 обычных кнопок, с помощью которых пользователь будет
вставлять цифры в ячейки.
Сразу после создания компонент Widget должен вывести на экран поле судоку и набор кно
пок. Он даст пользователю возможность делать ячейки активными с помощью клавиш
стрелок (активизация посредством щелчка мышью уже реализована нами в классе MyLaЬel),
устанавливать в ячейки цифры либо клавишами, либо кнопками из набора и удалять цифры,
опять же, клавишами или специальной кнопкой. Это основная функциональность компо
нента.
Что касается его дополнительной функциональности, то ее мы будем реализовывать по час
тям. И сейчас мы сделаем лишь очистку поля, блокировку и-разблокировку его ячеек.
Поскольку функциональности, специфической для какого-либо имеющегося в библиотеке
компонента, нам не требуется, класс Widget сделаем производным от класса QWidget.
Необходимый нам набор атрибутов класса очень невелик:
♦ cells - массив ячеек поля судоку - объектов класса MyLabel. Мы сохраним этот мас
сив в атрибуте, поскольку в других методах этого класса нам понадобится получать
к нему доступ;
♦ idCellinFocus - порядковый номер ячейки, являющейся активной в настоящий момент.
Его нужно знать в любом случае - хотя бы для того, чтобы визуально выделить актив
ную ячейку, вьiзвав у нее метод setCellFocus () (см. разд. 32.3.2).
Набор методов, поддерживаемый классом Widget, будет более объемным (даже с учетом
того, что мы еще не реализовали в классе дополнительную функциональность). Поскольку
эти методы сложнее таковых у класса MyLabel, рассмотрим здесь их вкратце, не углубляясь
в технические детали, - полное их описание будет приведено далее, вместе с их кодом:
♦ onChangeCellFocus () - обработчик сигналов changeCellFocus всех ячеек, что имеются
в поле (упомянутый здесь сигнал, как мы помним, генерируется при щелчке на ячейке
мышью). Он получит с единственным параметром номер ячейки, на которой бьш выпол
нен щелчок, и активизирует ее;
♦ keyPressEvent () - этот метод следует переопределить, чтобы получить возможность
обрабатывать нажатия клавиш клавиатуры. Здесь мы будем, в зависимости от нажатой
клавиши, перемещать по полю фокус выделения, ставить цифры в ячейки и оtiишать их;
♦ onвtn<N>Clicked () (где <N> - число от о до в или буква х) - обработчики щелчков на
кнопках 1 ... 9 и Х. Они будут ставить в ячейку соответствующую цифру или же очишать
ячейку;
♦ onClearAllCells () - очистит поле судоку. Будет вызываться при выборе пункта Новый
меню Файл или нажатии кнопки Новый панели инструментов;
♦ onBlockCell () - заблокирует активную ячейку, если она содержит цифру и еще не за
блокирована. Будет вызываться при выборе пункта Заблокировать меню Правка;
♦ onВlockCells () - заблокирует все ячейки, содержащие цифры и не забло_кированные.
Будет вызываться при выборе пункта Заблокировать все меню Правка или нажатии
кнопки Заблокировать все панели инструментов;
♦ onClearBlockCell () - разблокирует активную ячейку, если она заблокирована. Будет
вызываться при выборе пункта Разблокировать меню Правка;
Глава 32. Программа «Судоку» 769
♦ onClearBlockCells() - разблокирует все заблокированные ячейки. Будет вызываться
при выборе пункта Разблокировать все меню Правка или нажатии кнопки Разблоки
ровать все панели инструментов;
♦ конструктор, который создаст все необходимые компоненты и выполнит привязку обра
ботчиков к сигналам.
Весь код класса Widget мы сохраним в модуле widget.pyw в каталоге modules. Поскольку
этот код весьма велик, мы рассмотрим его по частям.
32.3.3.1. Конструктор класса Widget
Конструктор - самый сложный метод класса Widget. Поэтому мы не станем приводить
полный листинг конструктора, а рассмотрим его по фрагментам.
from PyQt6 import QtCore, QtGui, QtWidgets
Ломимо модулей QtCore и QtWidgets, которые понадобятся нам сейчас, мы импортируем
модуль QtGui. Объявленные в нем классы пригодятся позже, при реализации печати.
from modules.mylabel import MyLabel
Не забываем импортировать из модуля mylabel.pyw, что хранится в каталоге modules, класс
MyLabel, представляющий отдельную ячейку и написанный нами ранее.
class Widget(QtWidgets.QWidget):
def init (self, parent=None):
QtWidgets.QWidget. init (self, parent)
self.setFocusPolicy(QtCore.Qt .FocusPolicy .StrongFocus)
По умолчанию объект класса QWidget или производного от него класса не может принимать
фокус ввода. Чтобы дать ему возможность принимать фокус ввода при щелчке мышью
и переходе нажатием клавиши <ТаЬ>, мы вызовем у него метод setFocusPolicy(), передав
ему в качестве параметра элемент StrongFocus перечисления FocusPolicy.
vBoxМain = QtWidgets.QVВoxLayout()
Поскольку само поле и набор кнопок будут располагаться друг над другом, мы используем
для их размещения контейнер QVВoxLayout.
framel = QtWidgets.QFrame()
framel.setStyleSheet(
"background-color:#9AA6A7;border:lpx solid #9АА6А7;")
Поле (которое будет создано контейнером-сеткой QGridLayout) поместим в панель с рамкой
QFrame. У этой панели с помощью таблицы стилей укажем тонкую рамку и фон одинакового
темно-серого цвета. Панель с рамкой займет все выделенное под него пространство контей
нера, а поле судоку поместится в центре этой панели. В результате этого будет казаться, что
поле окружено толстой темно-серой рамкой, что выглядит весьма эффектно.
grid = QtWidgets.QGridLayout()
grid.setSpacing(O)
Создаем сетку QGridLayout, которая сформирует само поле.
idColor = (3, 4, 5, 12, 13, 14, 21, 22, 23, 27, 28, 29, 36, 37, 38, 45,
46, 47, 33, 34, 35, 42, 43, 44, 51, 52, 53, 57, 58, ·59, 66,
67, 68, 75, 76, 77)
Объявляем массив, хранящий номера ячеек, которые должны быть выделены светло-серым
фоном.
770 Часть 11. Библиотека PyQt б
self.cells [MyLabel(i, MyLabel.colorGrey if i in idColor else \
MyLabel.colorOrange) for i in range(0, 81)]
Создаем список из 81 ячейки MyLabel, сохранив его в атрибуте cells класса Widget. Здесь
мы используем выражение генератора списка, которое позволит нам радикально упростить
код. Если номер создаваемой ячейки имеется в объявленном ранее массиве, задаем для нее
светло-серый цвет фона, в противном случае - оранжевый.
self.cells[0] .setCellFocus()
self.idCellinFocus = О
Делаем активной ячейку с номером О и заносим тот же номер в атрибут idCellinFocus клас
са Widget. В результате изначально активной станет самая первая ячейка поля.
i = о
for j in range(0, 9):
for k in range(0, 9):
grid.addWidget(self.cells[i], j, k)
i += 1
Помещаем все созданные ячейки в сетку.
for cell in self.cells:
cell.changeCellFocus.connect(self.onChangeCellFocus)
У всех ячеек задаем для сигнала changeCellFocus обработчик - метод onChangeCellFocus()
класса Widget, пока еще не объявленный.
frarnel.setLayout(grid)
vBoxМain.addWidget(frarnel,
alignment=QtCore.Qt.AlignmentFlag.AlignHCenter)
Помещаем сетку в панель с рамкой и добавляем последmою в контейнер vвoxLayout, указав
для нее горизонтальное выравнивание посередине.
frarne2 = QtWidgets.QFrarne()
frarne2.setFixedSize(272, 36)
Набор кнопок, с помощью которых будет выполняться занесение цифр в ячейки, мы помес
тим в другую панель с рамкой QFrarne. Это позволит нам привязать к кнопкам таблицу сти
лей, задающую для них представление. У панели обязательно зададим фиксированные раз
меры - иначе их установит сам PyQt согласно своему разумению, которое вряд ли совпа
дет с нашим.
hЬох = QtWidgets.QHBoxLayout()
hЬox.setSpacing(l)
Кнопки будут выстроены по горизонтали, следовательно, наилучший вариант - поместить
их в контейнер QHBoxLayout.
Ьtns = []
for i in range(l, 10):
Ьtn = QtWidgets.QPushВutton(str(i))
Ьtn.setFixedSize(27, 27)
Ьtn.setFocusPolicy(QtCore.Qt.FocusPolicy.NoFocus)
Ьtns .append(Ьtn)
Создаем кнопки 1 ...9, даем им размеры 27 х 27 пикселов и добавляем в специально создан
ный для этого список. Также для каждой кнопки указываем, что она не должна принимать
Глава 32. Программа ((Судоку» 771
фокус ввода (для чего вызовем у нее метод setFocusPolicy() с параметром NoFocus), - это
нужно для того, чтобы поле судоку при нажатии любой из этих кнопок не теряло фокус,
и пользователь смог продолжать манипулировать в нем с помощью клавиш.
Ьtn = QtWidgets.QPushButton( "Х")
Ьtn.setFixedSize(27, 27)
Ьtns.append(Ьtn)
Таким же образом создаем кнопку Х, которая уберет цифру из ячейки.
for Ьtn in Ьtns:
hЬox.addWidget(Ьtn)
Помещаем все кнопки в контейнер QHBoxLayout.
Ьtns[OJ .clicked.connect(self.onВtnOClicked)
Ьtns[l] .clicked.connect(self.onBtnlClicked)
Ьtns[2] .clicked.connect(self.onBtn2Clicked)
Ьtns[З] .clicked.connect(self.onBtnЗClicked)
Ьtns[4] .clicked.connect(self.onBtn4Clicked)
Ьtns[SJ .clicked.connect(self.onBtnSClicked)
Ьtns[б] .clicked.connect(self.onBtnбClicked)
Ьtns[7] .clicked.connect(self.onBtn7Clicked)
Ьtns[BJ .clicked.connect(self.onBtn8Clicked)
Ьtns[9] .clicked.connect(self.onBtnXClicked)
Привязываем к сигналам clicked всех этих кнопок соответствующие обработчики - мето
ды класса поля, которые объявим позже.
frame2.setLayout(hЬox)
vBoxМain.addWidget(frame2,
alignment=QtCore.Qt.AlignmentFlag.AlignHCenter)
Помещаем контейнер с кнопками в панель с рамкой, а ее - во «всеобъемлющий» контей
нер vвoxLayout, не забыв указать горизонтальное выравнивание посередине.
self.setLayout(vBoxМain)
И помещаем этот контейнер в компонент поля.
32.3.3.2. Прочие методы класса Widget
Теперь напишем код остальных методов класса Widget. Они существенно проще конструк
тора, и мы можем не рассматривать их по частям.
def onChangeCellFocus(self, id):
if self.idCellinFocus != id and not (id < О or id > 80):
self.cells[self.idCellinFocus] .clearCellFocus()
self.idCellinFocus = id
self.cells[id] .setCellFocus()
· Метод onChangeCellFocus() станет обработчиком сигнала changeCellFocus ячейки MyLabel
(листинг 32.2). В качес�е единственного параметра он получит номер ячейки, ставшей
активной. "\_
772 Часть 11. Библиотека PyQt б
Сначала проверим, не совпадает ли полученный номер с тем, что хрщштся в атрибуте
idCellinFocus (не щелкнул ли пользователь на активной ячейке), не меньше ли он о и не
больше ли 80 (т. е. не вышел ли о,н за диапазон номеров ячеек). Если это так, выполняем
операцию по переносу фокуса на ячейку с полученным в параметре номером.
Предварительно нам следует деактивировать ячейку, бывшую активной ранее (номер этой
ячейки в настоящий момент хранится в атрибуте idCellinFocus). Извлекаем номер, получа
ем из списка ячеек (он хранится в атрибуте cells) саму эту ячейку и переводим ее в неак
тивное состояние вызовом метода clearCellFocus(). Далее заносим полученный с парамет
ром номер в атрибут idCellinFocus, тем самым указывая, что ячейка с этим номером сейчас
активна, и делаем ее активной, вызвав у нее метод setCellFocus().
def keyPressEvent(self, evt):
key = evt.key()
if key == QtCore.Qt.Key.Key_Up:
tid = self.idCellinFocus - 9
if tid < О:
tid += 81
self.onChangeCellFocus(tid)
elif key == QtCore.Qt.Key.Key_Right:
tid = self.idCellinFocus + 1
if tid > 80:
tid -= 81
self.onChangeCellFocus(tid)
elif key == QtCore.Qt.Key.Key_Down:
tid = self.idCellinFocus + 9
if tid > 80:
tid -= 81
self.onChangeCellFocus(tid)
elif key = QtCore.Qt.Key.Key_Left:
tid = self.idCellinFocus - 1
if tid < О:
tid += 81
self.onChangeCellFocus(tid)
elif key >= QtCore.Qt.Key.Key_l and key .<= QtCore.Qt.Key.Key_9:
self.cells[self.idCellinFocus] .setNewТext(chr(key))
elif key == QtCore.Qt.Key.Key_Delete or \
key = QtCore.Qt.Key.Key_Backspace or \
key == QtCore.Qt.Key.Key_Space:
self.cells[self.idCellinFocus] .setNewТext("")
QtWidgets.QWidget.keyPressEvent(self, evt)
Переопределенный менщ keyPressEvent() · будет обрабатывать нажатия клавиш (лис
тинг 32.3). В качестве параметра он получит объект события клавиатуры. Мы вызовем
у этого объекта метод key(), чтобы получить код нажатой клавиши. После чего начнем по
следовательно сравнивать его с кодами различных клавиш, чтобы выяснить, какая из них
была нажата.
Глава 32. Программа ((Судоку» 773
Если была нажата клавиша<j>, следует сделать активной ячейку, расположенную строкой
выше. Мь1 получим номер этой ячейки, вычтя из номера активной ячейки (он, как мы знаем,
хранится в атрибуте idCellinFocus) число 9- т.е. количество ячеек, помещающихся
в строке поля. Если получившаяся разность меньше о (фокус выделения вышел за пределы
верхней границы поля), мы прибавляем к разности 81 (количество ячеек в поле), в результа
те чего фокус окажется на самой последней строке поля, в том же столбце. И, наконец, вы
зываем метод onChangeCellFocus() класса поля, передав ему результирующий номер ячей
ки, чтобы сделать ее активной.
Если была нажата клавиша<--+>, нужно сделать активной ячейку, расположенную правее.
Понятно, что для получения ее номера нам следует прибавить к номеру активной ячейки
единицу. Если же полученная сумма оказалась больше 80 (фокус выделения вышел за пре
делы верхней границы диапазона имеющихся ячеек), мы вычтем из нее то же число 81-
тогда фокус окажется на самой первой ячейке в поле. И не забываем напоследок вызвать
метод onChangeCellFocus().
Обработка нажатия клавиш <l> и <<-> производится аналогично. Вы можете сами разо
браться, как работает выполняющий ее код.
Если была нажата клавиша<1>..<9>,
. мы формируем на основе ее кода соответствующий
символ, воспользовавшись функцией chr (), вызьmаем у активной ячейки метод
setNewТext() и передаем ему этот символ. Так мы занесем в активную ячейку цифру, соот
ветствующую нажатой клавише.
Случай нажатия клавиш <Backspace>, <Del> или <пробел> - самый простой. Мь1 вызыва
ем у активной ячейки метод setNewТext(), передав ему пустую строку, - так мы уберем
цифру с ячейки.
В самом конце, какая бы ни бьша нажата клавиша, мы в обязательном порядке вызьmаем
метод keyPressEvent() базового класса. Если этого не сделать, программа может повести
себя непредсказуемо.
def onВtnOClicked(self):
self.cells[self.idCellinFocus] .setNewText("l")
def onВtnlClicked(self):
self.cells[self.idCellinFocus] .setNewТext("2")
def onBtn2Clicked(self):
self.cells[self.idCellinFocus] ..setNewТext( "З")
def onВtnЗClicked(self):
self.cells[self.idCellinFocus] .setNewТext("4")
def onBtn4Clicked(self):
self.cells[self.idCellinFocus] .setNewТext("S")
def onBtnSClicked(self):
self.cells[self.idCellinFocus] .setNewText("б")
def onBtnбClicked(self):
self.cells[self.idCellinFocus] .setNewText("7")
774 Часть //. Библиотека PyQt б
def onBtn7Clicked(self):
self.cells[self.idCellinFocus] .setNewТext("B")
def onBtn8Clicked(self):
self.cells[self.idCellinFocus] .setNewТext("9")
def onBtnXClicked(self):
self.cells[self.idCellinFocus] .setNewТext("")
Методы с onBtnOClicked() по onBtn8Clicked() и onВtnXClicked() занесут в ячейку цифру,
соответствующую нажатой кнопке 1 ...9, или удалят цифру, если была нажата кнопка Х
(листинг 32.4). Как они работают, понятно без дополнительных пояснений.
def onClearAllCells(self):
for cell in self.cells:
cell.setText("")
cell.clearCellBlock()
Метод onClearAllCells() очистит поле судоку (листинг 32.5). В нем мы перебираем все
имеющиеся в поле ячейки, каждую очищаем от занесенной в нее цифры и переводим в раз
блокированное состояние вызовом метода clearCellBlock() класса MyLabel.
def onBlockCell(self):
cell = self.cells[self.idCellinFocus]
if cell. text() ! = '"':
' if cell.isCellChange:
cell.setCellBlock()
Метод onBlockCell() будет блокировать активную-ячейку (листинг 32.6). Сначала он про
верит, есть ли в ней цифра (получить ее можно вызовом унаследованного от суперкласса
QLabel метода text()), поскольку блокировать можно только ячейки с цифрами. Если
в ячейке нет цифры, метод ничего не сделает. В противном случае он проверит, хранится ли
в атрибуте isCellChange блокируемой ячейки значение True (т. е. не заблокирована ли уже
эта ячейка), и, если это так, заблокирует ячейку вызовом метода setCellBlock() класса
MyLabel.
В этом методе мы предварительно извлекаем из списка активную ячейку, сохраняем ее
в переменной и в дальнейшем используем для доступа к активной ячейке именно эту пере
менную. Такой подход позволяет несколько повысить быстродействие, поскольку обраще
ние к переменной выполняется быстрее, чем к атрибуту класса или элементу списка.
def onBlockCells(self):
for cell in self.cells:
if cell.text() and cell.isCellChange:
cell.setCellBlo,ck()
Глава 32. Программа «Судоку» 775
Метод onBlockCells(), блокирующий все ячейки, выполняет перебор всех ячеек и блокиру
ет тобую из них, если она содержит цифру и еще не заблокирована (листинг 32. 7).
def onClearBlockCell(self):
cell = self.cells[self.idCellinFocus]'
if not cell.isCellChange:
cell.clearCellBlock()
Метод onClearBlockCell(), предназначенный для разблокирования активной ячейки, пред-
варительно проверит, хранится ли в ее атрибуте isCellChange значение False (т. е. заблоки
рована ли эта ячейка). И только после этого он вызывает метод clearCellBlock() класса
MyLabel, чтобы разблокировать ячейку (листинг 32.8).
def onClearBlockCells(self):
for cell in self.cells:
if not cell.isCellChange:
cell.clearCellBlock()
Метод onClearBlockCells(), разблокирующий все ячейки поля (листинг 32.9), очень прост,
и вы, уважаемые читатели, сами поймете, как он работает.
32.3.4. Класс MainWindow: основное окно программы
Класс MainWindow представляет основное окно программы «Судоку». Оно вкточает компо
нент Widget � т. е. поле судоку, главное меmо, панель инструментов и строку состояния.
Класс основного окна, в силу его сложности, мы также будем писать по частям. В настоя
щий момент мы реализуем в нем только часть всех функций программы: операции очистки
поля, завершения программы, блокировки и разблокировки ячеек и получения справочных
сведений. Мы также реализуем сохранение и восстановление местоположения окна и нач
нем разработку функции печати. Ос,:альная функциональность будет добавлена позже.
Класс MainWindow мы сделаем произвоцным от класса главного окна MainWindow. Это позво
лит нам без проблем разместить в окне поле судоку, создать главное меmо, панель инстру
ментов и строку состояния.
Подумаем, какие атрибутъ1 мы объявим в классе основного окна:
♦ sudoku - объект класса Widget, представляющий компонент поля судоку. Нам придется
работать с этим компонентом в других методах класса Mainwindow;
♦ settings - объект класса QSettings, предназначеннъ1й для загрузки и сохранения на
строек программы. Мы применим здесь подход, показанный в листинге 31.2, при кото
ром сохранение настроек выполняется в методе closeEvent ();
♦ printer - объект класса QPrinter, представляющий принтер. Мы сразу, же создадим его
в конструкторе класса окна, чтобы потом не вносить в код конструктора слишком много
правок.
776 Часть 11. Библиотека PyQt б
Что касается методов класса MainWindaw, то мы объявим всего три:
♦ claseEvent()- этот метод следует переопределить, если нужно выполнять какие-либо
действия непосредственно перед закрытием окна. Внутри его мы выполним сохранение
местоположения окна;
♦ abautinfa()- выведет на экран стандартное диалоговое окно со сведениями о про
грамме «Судоку»;
♦ конструктор сформирует интерфейс программы, загрузит и установит сохраненное
ранее местоположение окна, создаст принтер, а также привяжет к окну таблицу стилей,
которая укажет специфическое оформление для ячеек поля судоку и набора кнопок,
который находится ниже поля.
Весь код класса MainWindaw мы сохраним в модуле mainwindow.pyw в каталоге modules. Его
мы также рассмотрим по частям.
32.3.4.1. Конструктор класса MainWindow
И в этом случае конструктор- самый сложный метод рассматриваемого класса. Поэтому
мы не станем приводить полный листинг конструктора, а тоже рассмотрим его по фраг
ментам.
fram PyQtб impart QtCare, QtGui, QtWidgets, QtPrintSuppart
Не забываем импортировать все нужные модули, включая модуль QtPrintSuppart.
fram madules.widget impart Widget
Импортируем класс поля судоку Widget из модуля widget.pyw, который мы сохранили в ка
талоге modules.
class Ma�nWindaw(QtWidgets.QMainWindaw):
def init (self, parent=Nane):
QtWidgets.QMainWindaw. init (self, parent,
flags=QtCare.Qt .WindawТype.Windaw 1
QtCare.Qt.WindawТype.MSWindawsFixedSizeDialagHint)
self.setWindawТitle( "Судаку 2 .О. О")
У создаваемого окна указываем флаг мswindawsFixedSizeDialagHint, запрещающий измене
ние его размеров. Все равно поле судоку у нас имеет фиксированный размер.
self.setStyleSheet(
"QFrame QPushButtan {fant-size:10pt;fant-family:Verdai1a;"
"calar:Ыack;fant-weight:bald;}"
"MyLabel {fant-size:14pt;fant-family:Verdana;"
"barder:lpx salid #9АА6А7;}")
Указьmаем у окна таблицу стилей, которая задаст представление для следующих элементов
управления:
♦ у кнопок из набора, расположенного под полем судоку,- черный полужирный шрифт
Verdana размером 10 пунктов (так мы сделаем эти кнопки заметнее);
♦ у ячеек поля судоку- шрифт Verdana размером 14 пунктов и темно-серую сIШошную
рамку толщиной в 1 пиксел.
self .settings = QtCare.QSettings("Пpaxapeнaк и Дранав", "Судаку")
self.printer = QtPrintSuppart.QPrinter()
Создаем объекты хранилища настроек и принтера.
Глава 32. Программа «Судаку» 777
self.sudoku = Widget()
self.setCentralWidget(self.sudoku)
Создаем объект класса Widget, сохраняем его в атрибуте sudoku и помещаем в окно в каче
стве центрального.
menuBar self.menuВar()
toolBar = QtWidgets.QToolBar()
Получаем уже имеющееся в окне главное меню и создаем панель инструментов.
myМenuFile = menuBar.addМenu("&Фaйл")
Создаем меню Файл.
action = myMenuFile.addAction(QtGui.Qicon(r"images/new.png"),
"&Новый", self.sudoku.onClearAllCells,
QtGui.QKeySequence("Ctrl+N"))
Создаем пункт Новый меню Файл.
Для создания пунктов меню используем разновидность метода addAction() класса QMenu,
которая в качестве параметров принимает значок, название пункта, обработчик и комбина
цию клавиш. На основе всего этого метод формирует действие (объект класса QAction),
создает связанный с ним пункт меню и возвращает это действие в качестве результата
(подробности- в разд. 28.2.2). Мы сохраним полученное действие в переменной, чтобы
впоследствии создать на панели инструментов связанную с ним кнопку и задать текст под
сказки для строки состояния.
В качестве обработчика для этого действия мы указываем метод onClearAllCells () компо
нента поля судоку (класса Widget).
toolBar.addAction(action)
action.setStatusTip("Coздaниe новой, пустой головоломки")
Создаем на основе только что подготовленного действия кнопку Новый панели инструмен
тов и задаем для действия текст подсказки, выводимой в строке состояния.
myМenuFile.addSeparator()
toolBar.addSeparator()
actioп = myMenuFile.addAction("&Bыxoд",
QtWidgets.QApplication.instance().quit,
QtGui.QKeySequence("Ctrl+Q"))
action.setStatusTip("Зaвepшeниe работы программы")
Добавляем в меню и на панель инструментов разделители и точно таким же образом созда
ем пункт Выход меню Файл. В качестве обработчика указываем сигнал quit() объекта
программы.
myМenuEdit = menuBar.addМenu("&Пpaвкa")
action = myMenuEdit.addAction("&Блoкиpoвaть",
self.sudoku.onBlockCell, QtCore.Qt.Key.Key_F2)
action.setStatusTip("Блoкиpoвaниe активной ячейки")
action = myMenuEdit.addAction(QtGui.Qicon(r"images/lock.png"),
"Б&локировать все",
self.sudoku. onВlockCells, QtCore.Qt.Кеу·.Кеу_FЗ)
778 Часть 11. Библиотека PyQt 6
toolBar.addAction(action)
action.setStat:usTip("Блoкиpoвaниe всех ячеек")
action = myMenuEdit.addAction("&Paзблoкиpoвaть",
self.sudoku.onClearBlockCell, QtCore.Qt.Key.Key_F4)
action.setStatusTip("Paзблoкиpoвaниe активной ячейки")
action myMenuEdit.addAction(QtGui.Qicon(r"images/unlock.png"),
=
"Р&азблокировать все",
self.sudoku.onClearBlockCells,
QtCore.Qt.Key.Key_FS)
toolBar.addAction(action)
action.setStatusTip( "Разблокирование всех ячеек")
Создаем меню Правка, его пункты Блокировать, Блокировать все, Разблокировать
и Разблокировать все и соответствующие им кнопки панели инструментов. В качестве
обработчиков действий указываем соответственно методы onBlockCell(), onBlockCells(),
onClearBlockCell() и onClearBlockCells() компонента поля судоку.
myМenuAЬout = menuBar.addМenu("&Справка")
action = myMenuAЬout.addAction("O &программе...", self.aboutProgram)
action.setStatusTip("Пoлyчeниe сведений о программе")
action = myMenuAЬout.addAction("O &Qt...", self.aЬoutQt)
action.setStatusTip("Пoлyчeниe сведений о фреймворке Qt")
Создаем меню Справка и его пункты О программе и О Qt. У действия, связанного с пер
вым пунктом, указываем в качестве обработчика метод aboutProgram() класса MainWindow, а
у действия, связанного с вторым пунктом, - метод aboutQt() того же класса. Оба метода
мы скоро напишем.
toolBar.setMovaЫe(False)
toolBar.setFloataЬle(False)
self.addToolBar(toolBar)
Запрещаем панели инструментов перемещаться внутри области, в которой она находится,
и выноситься в отдельное окно (для нашей простой программы это излишне), и добавляем
ее в окно. Поскольку в вызове метода addToolBar() окна мы не указали область, панель
будет помещена в верхнюю часть окна.
statusBar = self.statusBar()
statusBar.setSizeGripEnaЫed(False)
statusBar.showМessage("\"Cyдoкy\" приветствует вас", 20000)
Получаем доступ к строке состояния, убираем из нее маркер изменения размера (все равно
главное окно имеет фиксированные размеры) и выводим приветственное сообщение, кото
рое будет отображаться в течение 20 секунд.
if self.settings.contains (
' "Х") and self.settings.contains("У") :
self.move(self.settings.value("X"), self.settings.value("Y"))
Проверяем, находятся ли в хранилище настроек значения с именами х (горизонтальная
координата левого верхнего угла окна) и У (его вертикальная координата), и, если это так,
Гла�а 32. Программа «Судоку» 779
извлекаем эти значения и позиционируем окно по этим координатам (размеры окна хранить
не имеет смысла, поскольку они неизменны).
32.3.4.2. Остальные методы класса MainWindow
Осталось рассмотреть три метода класса основного окна мainWindow.
j J'lистинr 32.10. llето;ц cl.o�t ()
def closeEvent(self, evt):
g = self.geometry()
self.settings.setValue("X", g.left())
self.settings.setValue("Y", g.top())
Метод closeEvent() будет автоматически вызван при закрытии окна (листинг 32.1О). В нем
мы выполняем сохранение текущих координат левого верхнего угла окна.
j Листинr 32.11. Методы aoou1:Prograla() и �tQt о,
def aboutinfo(self):
QtWidgets.QMessageBox.about(self, "О программе",
"<center>\"Cyдoкy\" v2.0.0<br><br>"
"Программа для просмотра и редактирования судсжу<Ьr><Ьr>"
"(с) Прохоренок Н.А., Дронов В.А. 2011-2022 гг.")
def aboutQt(self):
QtWidgets.QMessageBox.aboutQt(self, title="O фреймворке ·ot")
Метод aboutProgram() вьmедет стандартное окно со сведениями о программе, а метод
aboutQt() - стандартное окно со сведениями о фреймворке Qt (листинг 32.11).
32.3.5. Главный модуль
Теперь напишем главный модуль, который, собственно, и запустит программу на выпол
нение. Сохраним его в файле start.pyw непосредственно в каталоге sudoku. Код главного
модуля представлен в листинге 32.12.
1 Листинr 32.12. Гnа�ный модуль
from_ PyQtб import QtGui, QtWidgets
import sys
from modules.mainwindow import MainWindow
.арр = QtWidgets.QApplication(sys.argv)
app .setWindowicon(QtGui.Qicon(r"images/svd.png"))
window = MainWindow()
window. show()
sys.exit(app.exec())
Здесь мы создаем объект класса QApplicat;i.on, представляющий программу, указьmаем
у нее значок, подготовленный ранее, создаем объект только что написанного класса
MainWindow, представляющего основное окно, вь1водим окно на экран и запускаем программу.
780 Часть 11. Библиотека PyQt 6
Выполним запуск программы, запустив модуль start.pyw любым знакомым нам способом:
щелчком мышью на самом файле или нажатием клавиши <F5> в окне IDLE, в котором от
крыт этот модуль. Проверим, работает ли активизация ячеек по щелчку мыши и посредст
вом клавиш-стрелок поставим в какие-либо ячейки цифры и удалим их. Попробуем забло
кировать и разблокировать ячейки. Наконец, очистим поле судоку, вызовем окна сведений
о программе и Qt и закроем программу.
32.3.6. Копирование и вставка головоломок
32.3.6.1. Форматы данных
Сначала следует определиться, в каких форматах головоломки будут копироваться в буфер
обмена. В разд. 32.2 мы решили, что таковых будет три: полный, компактный и предназна
ченный для Microsoft Excel.
В любом случае данные будут копироваться в виде строки, состоящей из цифр от О до 9.
♦ Полный формат- строка длиной 162 символа. Каждая пара цифр, содержащаяся в ней,
представляет сведения об одной ячейке:
• первая цифра - обозначает состояние блокировки ячейки: О - разблокирована, 1 -
заблокирована;.
• вторая цифра - это, собственно, цифра, которая установлена в ячейке, или О, если
ячейка не имеет цифры.
Сведения о ячейках записываются последовательно, без каких-либо разделителей: пер
вая пара цифр хранит сведения о ячейке с номером О, вторая - о ячейке 1, третья -
о ячейке 2 и. т. д.
♦ Компактный формат - строка длиной 81 символ. Она содержит только цифры, уста
новленные в ячейках. О обозначает отсутс_твие цифры в соответствующей ячейке. Первая
цифра соответствует ячейке О, вторая - ячейке 1 и т; д.
♦ Фор.мат для Excel - более длинная строка. Каждую ячейку представляет одна цифра -
та, что у(;тановлена в ней (состояние блокировки не сохраняется). Если ячейка не имеет
цифры, сохраняется пустая строка. Цифры или пустые строки, соответствующие всем
ячейкам одной строки поля судоку, отделяются друг от друга символами табуляции. На
боры цифр или пустых строк, соответствующие отдельным строкам, отделяются друг
. от друга последовательностями символов возврата каретки и перевода строки. Этой же
последовательностью символов завершается сама строка с данными.
Чтобы реализовать копирование и вставку головоломок, нам потребуется добавить новые
методы в классы Widget и MainWindow.
32.3.6.2. Реализация копирования и вставки в классе Widget
В классе Widget мы объявим четыре новых метода:
♦ getpataAllCells () - возвращает данные о головоломке в полном формате;
♦ getDataAllCellsMini () - возвращает данные о головоломке в компактном формате;
♦ getDataAllCellsExcel () - возвращает данные о головоломке в формате для Excel.
Эти методы не будут непосредственно помещать данные о головоломке в буфер обмена,
а станут лишь формировать их. Занесением готовых данных в буфер обмена займутся
методы класса Mai,nWindow, которые мы напишем позже.
Глава 32. Программа «Судоку» 781
Методы getDataAllCells () и getDataAllCellsMini() мы впоследствии используем для
подготовки данных, которые будут записываться в файлы;
♦ setDataAllCells() - принимает с единственным параметром данные о головоломке,
представленные в полном или компактном формате (формат распознается автоматиче
ски), и выполняет их вставку.
Опять же, этот метод не будет непосредственно извлекать данные из буфера обмена, а
станет лишь выполнять вставку данных, извлеченных оттуда специальными методами
класса MainWindow. Один из этих методов, помимо всего прочего, выполнит преобразо
вание полученных из буфера обмена данных, представленных в формате Excel, в полный
формат перед тем, как передать их методу setDataAllCells().
· Позднее мы используем этот метод для вставки данных о головоломке, прочитанных из
файла.
1
def getDataAllCells(self):
listAllData = []
for cell in self.cells:
listAllData.append("0" if cell.isCellChange else " l")
s = cell.text ()
listAllData.append(s if len(s) == 1 else "0")
return "" .join(listAllData)
Метод getDataAllCells () возвращает строку с данными о головоломке в полном формате
(листинг 32.13).
Формировать строку с копируемыми данными можно двумя способами, Первый способ
заключается в том, что сначала объявляется переменная, хранящая пустую строку, а потом
к этой строке постепенно добавляются символы, хранящие сведения о ячейках. Но в таком
случае при очередном добавлении символов предыдущая строка останется в оперативной
памяти - в результате эти «мусорные» строки станут постепенно накапливаться, засоряя
память. Разумеется, рано или поздно они будут удалены особой подсистемой Python, нося
щей название сборщика мусора, но произойдет это только тогда; когда программа будет
простаивать.
Поэтому, чтобы избежать «замусоривания» памяти, мы используем второй способ: объявим
пустой список, в который будем добавлять строки с символами, представляющие сведения
об очередной ячейке, а под конец сформируем строку, составленную из элементов этого
списка (для этого мы вызовем у пустой строки метод j oin(), передав ему наш список). Это
и будут данные о головоломке, записанные в полном формате.
В самом методе getDataAllCells () нет ничего особо сложного. Мы перебираем ячейки поля
судоку в цикле. У каждой ячейки выясняем состояние блокировки (оно, как мы помним,
хранится в атрибуте isCellChange класса MyLabel). Если ячейка разблокирована, добавляем
в список строку "О", в противном случае - "1". Далее вызовом унаследованного метода
text() извлекаем текстовое содержимое ячейки, проверяем, равна ли ее длина единице (т. е.
установлена ли в ячейку цифра), и, если так, добавляем в список строку с этим содержимым
(т. е. с установленной в ячейку цифрой). В противном случае добавляем строку "0". Под
конец формируем строку, составленную из элементов списк<.1 и представляющую собой
данные, которые должны быть помещены в буфер обмена. Эту строку возвращаем в качест
ве результата.
782 Часть 11. Библиотека PyQt 6
def getDataAllCellsMini(self):
listAllData = []
for cell in self.cells:
s = cell.text()
listAllData.append(s if len(s) l.else "0")
return "".join(listAllData)
Код метода getDataAllCellsMini (), возвращающий данные о головоломке в компактном
формате (листинг 32.14), работает аналогично. Вы, уважаемые читатели, и сами разбере
тесь, как.
. Лметинr·З2.15•. 111'.етод ge��lceй
def getDataAllCellsExcel(self):
nurnЬers = (9, 18, 27, 36, 45, 54, 63, 72)
listAllData = [self.cells[O] .text() ]
for i in range(l, 81):
listAllData.append("\r\n" if i in nurnЬers else "\t")
listAllData.append(self.cells[i] .text() )
listAllData.append("\r\n")
return "".join(listAllData)
Метод getDataAllCellsExcel(), что станет формировать данные для вставки в Excel, немно
гим сложнее (листинг 32.15). Мы создаем кортеж, содержащий номера ячеек, перед кото
рыми в результирующую строку вместо символа табуляции нужно вставить возврат каретки
и перевод строки, - как видим, это номера первых ячеек в каждой строке, кроме первой.
Затем создаем список из единственного элемента - содержимого самой первой ячейки:
цифры или пустой строки. Далее в цикле перебираем все ячейки от второй· до последней.
Если номер очередной ячейки входит в объявленный ранее кортеж (т. е. начинается новая
строка поля судоку), добавляем в список возврат каретки и перевод строки, в противном
случае - символ табуляции. Далее добавляем в список содержимое ячейки. Наконец, за
вершаем. формируемые данные возвратом каретки и переводом строки и формируем строку,
составленную из элементов списка.
def setDataAllCells(self, data):
l = len(data)
if l == 81:
for i in range(O, 81):
if data[i] == "О":
self.cells[i] .setText("")
self.cells[i] .clearCellBlock()
else:
self.cells[i] .setText(data[i])
self.cells[i] .setCellBlock()
self.onChangeCellFocus(О).
Глава 32. Программа «Судаку» 783
elif 1 == 162:
for i in range(0, 162, 2):
if data[i] == "О":
self.cells[i // 2].clearCellBlock()
else:
self.cells[i // 2] .setCellBlock()
self.cells[i // 2] .setText('"' if data[i + 1] "О" \
else data[i + 1])
self.onChangeCellFocus(0)
Метод setDataAllCells(), вставляющий да1rnые о головоломке в поле судоку (листинг
32.16), будет самым сложным. Ведь сначала он должен выяснять, в каком формате пред
ставлены данные - в полном или компактном.
Данные, предназначенные для вставки, метод получает с единственным параметром, и дан
ные эти представлены в виде строки. Следовательно, узнать их формат мы можем, выяснив
длину строки с данными:
♦ если длина строки с данными равна 81 символу, данные представлены в компактном
формате. В этом случае мы перебираем все символы в полученной строке. Если очеред
ной символ представляет собой цифру "0", очищаем и разблокируем соответствующую
ячейку, в противном случае заносим очередной символ (которь�м станет цифра) в ячейку
и блокируем ее;
♦ если же длина строки равна 162 символам, данные представлены в полном формате. Мы
точно так же перебираем в цикле символы этой строки, но уже через один, извлекая тем
самым на каждом проходе каждый четный символ (для чего применим цикл for i in
range(о, 162, 2)), - этим символом станет обозначение состояния блокировки соот
ветствующей ячейки. Номер соответствующей символу ячейки можем получить, разде
лив номер очередного символа на 2 нацело (применив оператор //). Если извлеченный
символ является цифрой "О", разблокируем ячейку, в противном случае - блокируем.
Далее извлекаем и проверяем следующий символ строки: если это цифра "0", очищаем
ячейку, а если цифра, отличная от "О", заносим ее в ячейку.
В любом случае после вставки данных мы делаем активной самую первую (левую верх
нюю) ячейку поля судоку.
32.3.6.3. Реализация копирования и вставки в классе MainWindow
В классе MainWindow мы внесем дополнения в код конструктора и объявим шесть новых ме
тодов:
♦ onCopyData() - копирует в буфер обмен данные в полном формате;
♦ onCopyDataмini() - копирует в буфер обмена данные в компактном формате;
♦ onCopyDataExcel() ---'---- копирует в буфер обмена данные в формате для Excel;
♦ onPasteData() - вставляет из буфера обмена данные, представленные в полном или
компактном формате, предВарительно проверив эти данные на корректность;
♦ onPasteDataExcel() - вставляет из буфера обмена данные, представленные в формате
для Excel, предВарительно проверив эти даннщ: на корректность;
♦ dataErrorMsg() - вьmодит сообщение о том, что предназначенные для вставки данные
имеют неправильный формат.
784 Часть 11. Библиотека PyQt б
Начнем с того, что в самое начало модуля, где находятся выражения импорта, добавим вы
ражение, импортирующее модуль для поддержки регулярных выражений:
import re
Регулярные выражения очень помогут нам реализовать проверку вставляемых данных на
корректность.
Доработаем конструктор. Все необходимые добавления показаны в листинге 32.17 (добав
ленный код выделен полужирным шрифтом).
л11сти1tr 32. 17. �онструктор �ополнен�ия),
def init (self, parent=None):
myMenuEdit = menuBar.addМenu("&Пpaвкa")
action = myМenuEdit.addAction(QtGui.Qicon(r"images/copy.png"),
"К&опировать", self.onCopyData,
QtGui.QКeySequence("Ctrl+c"))
toolВar.a.c:ldAction(action)
action.setstatusTip("Кoпиpoв;iНИE! гоnоволомки в буфер обмена")
action = myМenuEdit.addAction("&Кoпиpoвaть компактно",
self.onCopyDataМini)
action.setstatusTip ("Копирование в компактном форете")
action = myМenuEdit.addAction("Koпиpoвaть &дnя Excel",
self.onCopyDataExoel)
action.setstatusTip("Кoпиpoвaниe в форете МS Exoel")
action = myМenuEdit.addAction(QtGui.Qicon(r"images/paste.png"),
"&Вставить", self.onPasteData,
QtGui.QКeySequence("Ctrl +V"))
toolВar.addAction(action)
action.setstatusTip("Вставка гоnоволомки из буфера обмена")
acti_on = myМenuEdit.addAction("Вcтaвить &из Exoel",
self.onPasteDataExcel)
action.setstatusTip("Вставка гоnоволомки из МS Excel")
myМenuEdit. addSeparator ()
toolВar. addSeparator ()
action = myMenuEdit.addAction("&Блoкиpoвaть",
self.sudoku.onBlockCell, QtCore.Qt.Key_F2)
Здесь мы добавляем в начало меmо Правка пять пунктов: Копировать, Копировать ком
пактно, Копировать для Excel, Вета.вить и Вставить из Excel. Указываем для них в каче
стве обрабоtчиков приведенные ранее методы, а также добавляем нужные кнопки в панель
инструментов.
Глава 32. Программа «Судаку» 785
def onCopyData(self):
QtWidgets.QApplication.clipboard().setText(
self.sudoku.getDataAllCells())
def onCopyDataMini(self):
QtWidgets.QApplication.clipboard().setText(
self.sudoku.getDataAllCellsMini())
def onCopyDataExcel(self):
QtWidgets.QApplication.clipboard().setText(
self.sudoku.getDataAllCellsExcel())
Методы onCopyData(), onCopyDataMini() и onCopyDataExcel(), копирующие данные,
очень просты (листинг 32.18). Они всего лишь помещают в буфер обмена результат, воз
вращенный соответственно методами getDataAllCells(), getDataAllCellsMini() и
getDataAllCellsExcel() класса поля судоку.
[>�нr 32.19; Метод �steDataO
def onPasteData(self):
data = QtWidgets.QApplication.clipboard().text()
if data:
if len(data) == 81 or len(data) == 162:
r = re.compile(r"[ л 0-9]")
if not r.rnatch(data):
self.sudoku.setDataAllCells(data)
return
self.dataErrorMsg()
Метод onPasteData() вставляет данные в полном или компактном формате (листинг 32.19).
Перед тем как вызвать метод setDataAllCells() класса поля судоку, передав ему данные
для вставки, он выполняет их проверку. Сначала он удостоверяется, что данные для вставки
вообще есть (не равны пустой строке), потом - что их длина равна 81 или 162 символам.
Далее он выполняет последнюю проверку - выясняет, не присутствует ли в строке символ,
отличный от цифр 0 ...9. Для этого он создает регулярное выражение, совпадающее с любым
из таких символов ([ л 0-9J), и выполняет поиск в строке с даннь1ми посредством быстро
выполняющегося метода rnatch() (более подробно о работе с регулярными выражениями
рассказьmалось в главе 7).
И только если все проверки выполнены, вызьmается метод setDataAllCells(), и ему пере
дается строка с даннь1ми для вставки. После чего сразу же выполняется выход из метода.
Если же какая-лдбо проверка завершилась неудачей, будет выполнено самое последнее вы
ражение - вызов метода dataErrorMsg(), выводящего сообщение об ошибке. Мы напишем
этот метод позже.
def onPasteDataExcel(self):
data = QtWidgets.QApplication.clipboard().text()
786 Часть 11. Библиотека PyQt б
if data:
data = data.replace ("\r", "")
r = re.compile(r"([0-9]?[\t\n]){81)")
if r.match(data):
result = []
if data[-1] == "\n":
data = data[:-1]
dl = data.split("\n")
for sl in dl:
dli = sl.split("\t")
for sli in dli;
if len(sli) ==·о:
result.append("00")
else:
result.append('�О" + sli[0J)
data = "".join(result)
self.sudoku.setDataAllCells(data)
return
self.dataErrorMsg()
Метод onPasteDataExcel() вставит из буфера обмена данные, представленные в формате
для Excel, разумеется, также выполнив необходимые проверки (листинг 32.20). Сначала он
убедится, что дairnыe для вставки есть, и для удобства их дальнейшей проверки и обработки
удалит из них символы возврата каретки (для этого можно использовать метод replace()
класса str, указав у этого метода первым параметром удаляемый символ, а вторым - пус
тую строку).
Полученная строка представляет собой набор из строго 81 комбинации двух символов:
цифры от О до 9, которая может присутствовать в единственном числе или отсутствовать,
и символа табуляции или перевода строки. Это правило прекрасно формализуется регуляр
ным выражением ([О-9]?[\t\n]){81 J. Мы сравниваем с ним строку с данными и выполня
ем дальнейшие манипуляции, _только если сравнение выполняется.
Сначала подготавливаем пустой список, в который будем помещать отдельные строки �
фрагменты вставляемой головоломки. Удаляем из полученной строки с данными завер
шающий символ перевода строки, если он там есть. Разбиваем эту строку по символам пе
ревода строки, воспользовавшись методом split() класса str, и получаем список строк,
представляющих отдельные строки поля судоку. Перебираем этот список и каждую из
имеющихся в нем строк тем же методом разбиваем по символам табуляции, получив список
строк, каждая из которых представляет сведения об одной ячейке. Перебираем этот список.
Если очередной его элемент-строка пуст (т. е. ячейка не имеет цифры), добавляем в список
строку "ОО", где первая цифра обозначает, что ячейка не заблокирована, а вторая - отсут
ствие цифры в ячейке. Если же элемент не пуст, значит, он представляет собой цифру,
которую следует занести в ячейку, и мы добавляем в список строку вида "О<Эта цифра>.
Наконец, объединяем все элементы списка в строку, передаем ее методу setDataAllCells()
класса поля судоку и выполняем возврат из метода.
Последнее выражение, выполняющееся, ,если какая-либо проверка из описанных ранее за
вершилась неудачей, вызовет все тот же метод dataErrorMsg(), который выведет сообщение
о неправильном формате данных.
Глава 32. Программа «Судоку» 787
Осталось написать этот метод. Его код приведен в листише 32.21 - как видим, он очень
прост.
j Листинг 32.�1. Метод dataErroi:Мsg 6
def dataErrorMsg(self):
QtWidgets.QMessageBox.infoпnation(self, "Судаку",
"Данные имеют неправильный формат")
Запустим программу и проверим , как работает копирование и вставка данных в разных
форматах. Проще всего сделать это, занеся цифры в некоторые ячейки поля судоку, выпол
нив копирование в каком-либо формате, очистив поле и произведя вставку. После этого
поле судоку должно выглядеть так же, как перед копированием.
32.З. 7. Сохранение и загрузка данных
Сохранять головоломки мы будем в тех же форматах, в каких они копировались в буфер
обмена, - это позволит нам использовать написанные в разд. 32.3.6.2 методы класса
Wid�et, выполняющие копирование данньrх.
Чтобы дать нашей программе возможность сохранять и загружать данные, добавим в класс
MainWindow следующие методы:
♦ onOpenFile () - загрузит сохраненную в файле головоломку;
♦ onsave () - сохранит головоломку в файл в полном формате;
♦ onSaveMini i) - сохранит головоломку в файл в компактном формате;
♦ saveSVDFile () - этот метод станет вызываться обоими предыдущими методами для
выполнения собственно сохранения данных в файл. Эти данньrе он будет получать
с единственньrм параметром.
И внесем исправления в код конструктора - их можно увидеть в листИJП'е 32.2 2 (добавлен
ный код выделен полужирным шрифтом).
def init (self, parent=None):
action = myMenuFile.addAction(QtGui.Qicon(r"images/new.png"),
"&Новый", self.sudoku.onClearAllCells,
QtCore.Qt.CTRL + QtCore.Qt.Key_N)
toolBar.addAction(action)
action.setStatusTip("Coздaниe новой, пустой головоломки")
action = myМenuFile.addAction(QtGui.Qicon(r"images/open.png"),
"&Открыть ...", self.onOpenFile,
QtGui. QКeySequence ( "Ctrl+о"))
toolВar.addAction(action)
action.setstatusTip("Зarpyзкa головаnомки из файnа")
action = myМenuFile.addAction(QtGui.Qicon(r"i.mages/save.png"),
"Со&хранить ...", self.onSave,
QtGui.QКeySequence("Ctrl+S"))
788 Часть 11. Библиотека PyQt б
toolВar.addAction(action)
action.setstatusTip("Сохранение гоnоваiiомки в файле")
action = myМenuFile.addAction("&Co:xpaнить компахтно . ..",
self.onSaveМ:i.ni) ·'
action.setstatusTip("Coxpaнeниe гоnоваnомки в компактном ФQРGте")
myМenuFile.addSeparator()
toolBar.addSeparator()
Этот код добавит в меюо Файл, между пунктом Новый и разделителем, пункты Открыть,
Сохранить и Сохранить компактно. В качестве обработчиков указаны описанные ранее
методы. Также выщшняется добавление еще двух кнопок в панель инструментов.
Листи
._ _,..1,-.,..
· def onOpenFile(self) :
fileName = QtWidgets.QFileDialog.getOpenFileName(self,
"Выберите файл", QtCore.QDir.homePath() ,
"Судаку (* .svd) ") [О]
if fileName:
data =· ""
try:
with open(fileName, newline="") as f:
data = f. read()
except:
QtWidgets.QМessageBox.information(self, "Судоку",
"Не удалось _открыть файл")
return
if len(data) > 2:
if data[-1] == "\n":
data = data[:-1]
if len(data) == 81 or len(data) 162:
r = re.compile(r"[л0-9]")
if not r.match(data) :
self.sudoku.setDataAllCells(data)
return
self.dataErrorMsg()
В методе onOpenFile (), загружающем данные из файла (листинг 32.23), мы выводим стан
дартное диалоговое окно открытия файла, указав в качестве начального каталог пользова
тельского профиля. Если пользователь выбрал файл и нажал кнопку Открыть, мы в блоке
обработки исключения открываем этот файл для чтения и читаем его содержимое. Если
файл прочитать не удалось и бьшо сгенерировано·исключение, выводим соответстзующее
сообщение и выполняем возврат из метода.
Если данные были прочитаны, мы проверяем, имеют ли они длину 81 или 162 символа и не
включают ли в себя символы, отличные от цифр 0... 9. Если это так, передаем загруженные
данные все тому же методу setDataAllCells() класса поля судоку и выполняем возврат.
Глава 32. Программа «Судоку» 789
Если же все эти проверки не увенчаются успехом, выполняется последнее выражение, ко
торое вызовет метод dataErrorMsg() класса MainWindow, написанный нами ранее.
def onSave(self):
self.saveSVDFile(self.sudoku.getDataAllCells() )
def onSaveMini(self):
self.saveSVDFile(self.sudoku.getDataAllCellsMini() )
Методы onSave() и onSaveMini(), сохраняющие данные в файл (листинг 32.24), очень про
сты - они лишь вызывают метод saveSVDFile(), передав ему результат, возвращеннь1й
методами соответственно getDataAllCells() и getDataAllCellsMini() класса поля судоку.
def saveSVDFile(self, data):
fileName = QtWidgets.QFileDialog.getSaveFileName(self,
"Выберите файл", QtCore.QDir.homePath() ,
"Судаку (* .svd) ") [О]
if fileName:
try:
with open(fileName, mode="w", newline="") as f:
f.write(data)
self.statusBar() .showМessage("Фaйл сохранен", 10000)
except:
QtWidgets.QМessageBox.information(self, "Судаку",
"Не удалось сохранить файл")
Метод saveSVDFile(), непосредственно сохраняющий даннь1е (листинг 32.25), также не
сложен. Сначала мы выводим стандартное диалоговое окно сохранения файла. Если поль
зователь задал имя файла для сохранения и нажал кнопку Сохранить, открываем файл на
запись (если файл с заданным именем отсутствует, он будет создан), записываем в него
данные, полученнь1е с параметром, и выводим в строке состояния сообщение об успехе.
Открытие файла и запись в него выполняем в блоке обработки исключений - в случае воз
никновения исключения на экран будет выведено сообщение об ошибке записи.
Запустим программу, поставим в н�которые ячейки цифры, сохраним головоломку в пол
ном формате, очистим поле судоку и загрузим сохраненную головоломку. После чего по
пробуем сохранить и загрузить головоломку в компактном формате.
32.3.8. Печать и предварительный просмотр
Условимся, что головоломка будет печататься в том же виде, в каком представлена на экра
не. Ячейки будут им�ть размеры 30 х 30 пикселов, темно-серую рамку, оранжевый или
светло-серый цвет фона. Цифры в ячейках будут вьiводиться черным цветом, шрифтом
Verdana размером 14 пунктов и выравниваться посередине.
790 Часть 11. Библиотека PyQt б
32.3.8.1. Реализация печати в классе Widget
Все действия по формированmо печатного представления головоломки мы будем выпол
нять в классе поля судоку Widget. Для этого определим в нем метод print(), который в ка
честве единственного параметра получит принтер, на котором · должна быть выполнена
печать, и который представляется объектом класса QPrinter. п
Код метода print() не очень велик, но требует развернутых пояснений. Мы рассмотрим его
по частям.
def print(self, printer):
penText = QtGui.QPen(QtGui.QColor(MyLabel.colorBlack), 1)
penBorder = QtGui.QPen(QtGui.QColor(QtCore.Qt .GlobalColor.darkGray), 1)
brushOrange = QtGui.QBrush(QtGui.QColor(MyLabel.colorOrange))
brushGrey = QtGui.QBrush(QtGui.QColor(MyLabel.colorGrey))
Сразу же создаем два пера: для вывода цифр (черное) и рамок ячеек (темно-серое) и две
кисти: оранжевую и светло-серую.
painter = QtGui.QPainter()
painter.begin(printer)
Начинаем печать.
painter.setFont(QtGui.QFont("Verdana", pointSize= l4))
Указываем шрифт для вывода цифр в ячейках.
i = о
Объявляем переменную, в которой будет храниться номер печатаемой в настоящий момент
ячейки.
for j in range(0, 9):
Запускаем цикл, который станет перебирать числа из диапазона 0 ...8 включительно. Эти
числа будут представлять номера печатаемых строк поля судоку.
for k in range(0, 9):
Внутри этого цикла запускаем другой, аналогичный, который будет перебирать номера яче
ек текущей строки.
х = k * 30
у= j * 30
Вычисляем координаты левого верхнего угла печатаемой в настоящий момент ячейки. Го
ризонтальную координату мы можем получить, взяв номер текущей ячейки текущей строки
и умножив его на ширину ячейки (30 пикселов). Вертикальная координата вычисляется
аналогично на основе номера текущей строки и ее высоты (также 30 пикселов).
painter.setPen(penBorder)
Теперь нам нужно вывести сам квадратик, создающий ячейку. Задаем темно-серое перо для
печати рамки этого квадратика.
painter.setBrush(brushGrey if. \
self.cells[i] .bgColorDefault == MyLabel.colorGrey \
else brushOrange)
Если для фона ячейки задан светло-серый цвет, задаем светло-серое перо, в противном слу
чае - оранжевое.
Глава 32. Программа «Судоку» 791
painter.drawRect(x, у, 30, 30)
Рисуем квадратик.
painter.'setPen(penText)
;.,
Задаем черное перо, которым будет выведена цифра.
painter.drawТext(x, у, 30, 30,
QtCore.Qt.AlignmentFlag.AlignCenter,
self.cells[i] .text())
Вьmодим поверх квадратика цифру - содержимое ячейки.
i += l
Увеличиваем значение номера текущей ячейки на единицу, чтобы на следующем проходе
цикла напечатать следующую ячейку.
painter.end ()
И завершаем печать.
32.3.8.2. Класс PreviewDialog:
диалоговое окно предварительного просмотра
Класс PreviewDialog реализует функциональность диалогового окна предварительного про
смотра головоломки перед печатью (рис. 32.3). Это окно позволит просматривать голово
ломку в масштабе 1: 1, увеличивать, уменьшать масштаб и сбрасывать его к изначальному
значению.
1Ш Предварительный просмотр х
5
-t--+=+----+--+ 6
--+-=-i'-"+--< i
c-:-'t---+-+--+-+-t•--i'--i-.:..J
41
Рис. 32.З. Диалоговое окно предварительного просмотра
792 Часть 11. Библиотека PyQt б
Код класса PreviewDialog мы сохраним в модуле previewdialog.pyw в каталоге modules. Он
весьма велик и использует примечательные приемы программирования, о которых следует
поговорить, поэтому рассмотрим его по частям.
from PyQtб import QtCore, QtWidgets, QtPrintSupport
class PreviewDialog(QtWidgets.QDialog):
Окно предварительного просмотра мы делаем подклассом класса Dialog. Это позволит нам
без особых проблем сделать размеры окна неизменяемыми, а само окно - модальным.
def init (self, parent=None):
QtWidgets.QDialog. init (self, parent)
self.setWindowТitle("Пpeдвapитeльный просмотр")
self.resize(б00, 400)
vBox = QtWidgets.QVBoxLayout()
Интерфейс окна включает две горизонтальные группы элементов управления, расположен
ные друг над другом (см. рис. 32.3). Поэтому для размещения групп мы создадим верти
кальный контейнер QVBoxlayout.
hBoxl = QtWidgets.QHBoxLayout()
Верхняя группа будет содержать три кнопки: для увеличения, уменьшения и сброса мас
штаба. Поскольку элементы в группе должны располагаться по горизонтали, используем
для их расстановки контейнер QHBoxLayout.
ЬtnZoomin = QtWidgets.QPushButton("&+")
ЬtnZoomin.setFocusPolicy(QtCore.Qt.FocusPolicy.NoFocus)
hBoxl.addWidget(ЬtnZoomin, alignment=QtCore.Qt.AlignmentFlag.AlignLeft)
ЬtnZoomOut = QtWidgets.QPushВutton("&-")
ЬtnZoomOut.setFocusPolicy(QtCore.Qt.FocusPolicy.NoFocus)
hBoxl.addWidget(ЬtnZoomOut,
alignment=QtCore.Qt.AlignmentFlag.AlignLeft)
ЬtnZoomReset = QtWidgets.QPushButton("&Cбpoc")
ЬtnZoomReset.setFocusPolicy(QtCore.Qt.FocusPolicy.NoFocus)
ЬtnZoomReset.clicked.connect(self.zoomReset)
hBoxl.addWidget(ЬtnZoomReset,
alignment=QtCore.Qt.AlignmentFlag.AlignLeft)
Создаем все эти три кнощш и добавляем их в контейнер. У каждой кнопки указываем, что
она не может принимать фокус ввода, вызвав у нее метод setFocusPolicy() с параметром
NoFocus, - таким образом, мы создадим в нашем диалоговом окне подобие панели инстру
ментов. Также у всех трех кнопок указываем выравнивание по левому краю.
У кнопки сброса масштаба мы сразу же указываем в качестве обработчика сигнала. clicked
метод zoomReset() класса PreviewDialog. У остальных кнопок мы пока не указьшаем обра
ботчики этого сигнала.
hBoxl.addStretch()
Добавляем в горизонтальный контейнер растягивающуюся область, чтобы все кнопки ока
зались прижатыми к левому краю контейнера.
vBox.addLayout(hBoxl)
Добавляем сам горизонтальный контейнер в вертикальный.
Глава 32. Программа «Судоку» 793
hBox2 = QtWidgets.QHBoxLayout()
Создаем еще один горизонтальный контейнер, в котором будут выводиться панель предва
рительного просмотра и кнопка Закрыть.
self.ppw = QtPrintSupport.QPrintPreviewWidget(parent.printer)
self.ppw.paintRequested.connect(parent.sudoku.print)
hBox2.addWidget(self.ppw)
Создаем панель предварительного просмотра (объект класса QPrintPreviewWidget) и· связы
ваем его сигнал paintRequested с методом print() компонента поля судоку, иначе эта па
нель ничего не вьIВедет. Компонент поля судоку хранится в атрибуте sudoku основного окна
программы, а основное окно мы получим с параметром parent конструктора. Напоследок
добавляем панель просмотра во второй горизонтальный контейнер.
btnZoomin.clicked.connect(self.ppw.zoomin)
btnZoomOUt.clicked.connect(self.ppw.zoomOut)
Создав панель предварительного просмотра, связываем с ее методами zoomin() и zoomout()
сигналы clicked кнопок увеличения и уменьшения масштаба.
Ьох = QtWidgets.QDialogButtonBox(
QtWidgets.QDialogButtonВox.StandardВutton.Close,
QtCore.Qt.Orientation.Vertical)
Создаем контейнер для кнопок, которые обычно вьIВодятся в диалоговом окне, добавляем
в него кнопку закрытия и располагаем по вертикали.
btnClose = box.button(QtWidgets.QDialogButtonВox.StandardВutton.Close)
btnClose.setText("&Зaкpьгrь")
btnClose.setFixedSize(96, 64)
btnClose.clicked.connect(self.accept)
Получаем только что созданную в контейнере кнопку, задаем у нее надпись Закрыть, уве
личеннь1е размеры и связываем ее сигнал clicked с методом accept() , унаследованнь1м
нашим р:иалоговым окном от класса Dialog.
hВox2.addWidget(box, alignment=QtCore.Qt.AlignmentFlag.AlignRight
QtCore.Qt.AlignmentFlag.AlignTop)
Добавляем контейнер с кнопками во второй горизонтальный контейнер, указав выравнива
ние по правой и верхней границам, - т. е. расположение в верхнем правом углу.
vBox.addLayout(hВox2)
self.setLayout(vBox)
Добавляем второй горизонтальный контейнер в вертикальный контейнер и помещаем по
следний в окно.
self.zoomReset()
Указываем масштаб по умолчанию - 1: 1, вызвав метод zoomReset() окна.
def zoomReset(self):
self.ppw.setZoomFactor(l)
И, не откладывая дела в долгий ящик, определим этот метод.
794 Часть 11. Библиотека PyQt б
32.3.8.3. Реализация печати в классе MainWindow
Теперь внесем необходимые дополнения в код класса MainWindow. Нам понадобится доба
вить в конструктор код, создающий необходимые пункты меmо и кнопки панели инстру
ментов, и три метода:
♦ onPrint() - печатает головоломку;
♦ onPreview() - выводит на экран созданное ранее окно предварительного просмотра;
♦ onPageSetup() - производит настройку параметров страницы.
Поскольку предварительный просмотр у нас будет выполняться в только что созданном
окне PreviewDialog, нам следует добавить в самое начало кода класса MainWindow выраже
ние, выполняющее импорт класса PreviewDialog:
from modules.previewdialog import PreviewDialog
Дополнения, которые следует внести в код .конструктора класса MainWindow, показаны
в листинге 32.26 (добавленный код, как обычно, выделен полужирным шрифтом).
· �32.28. �ктор (допоnненмя)
def init (self, parent=None):
action = myMenuFile.addAction("&Coxpaнить компактно...",
self.onSaveмini)
action.setStatusTip( "Сохранение головоломки в компактном формате")
myМenuFile.addSeparator()
toolВar. addSeparator ()
action = myМenuFile.addAction(QtGui.Qicon(r"illlages/print.pnq"),
11 &Печать..." , self.onPrint,
QtGui. QКeySequence("Ctrl+P") )
toolВar.addAction(action)
action.setStatusTip ("Печать гаnовоnсмки")
action = myМenuFile.addAction(QtGui.Qicon(r"illlages/preview.png"),
"П&редвар,rrельный просмотр...", self.onPreview)
toolВar.addAction(action)
action. setStatusTip ("Предвар,rrельный просмотр гаnовоnсмки•i)
action = myМenuFile. acldAction("П&арамвтр.1 страиицw.... 11 ,
self. onPageSetup)
action.setStatusTip ("Задание параметров страиицw")
myМenuFile.addSeparator()
toolBar.addSeparator()
action = myMenuFile.addAction("&Bыxoд",
QtWidgets.QApplication.instance().quit,
QtGui.QKeySequence("Ctrl+P"))
Глава 32. Пfjограмма «Судаку» 795
Между пунктами главного меню, вызывающими файловые операции, мы вставляем разде
литель и пункты Печать, Предварительный просмотр и Параметры страницы. Не забы
ваем добащ,1ть соответствующие КНОПI<И на панель инструментов.
def onPrint(self):
pd = QtPrintSupport.QPrintDialog(self.printer, parent=self)
pd.setOptions(
QtPrintSupport.QPrintDialog.PrintDialogOption.PrintToFile
QtPrintSupport.QPrintDiqlog.PrintDialogOption.PrintSelection)
if pd.exec() == QtWidgets.QDialog.DialogCode.Accepted:
self.sudoku.print(self.printer)
def on.Preview(sеЦ) :
pd = PreviewDialog(self)
pd.exec()
def onPageSetup(self):
pd = QtPrintSupport.QPageSetupDialog(self.printer, parent=self)
pd.exec()
Код методов onPrint(), onPreview() и onPageSetup(), производящих печать, предваритель
ный просмотр и настройку страницы, очень прост (листинг 32.27). Единственная деталь,
достойная рассмотрения: в диалоговом окне печати мы задаем только возможность указа
ния печати в файл и выбора принтера, на котором будет выполняться печать. Остальные
параметры - в частности выбор печатаемых страниц - в нашем случае .не нужны.
Запустим программу, создадим какую-либо головоломку и проверим, как работает печать,
предварительный просмотр и настройка параметров страницы.
На этом работу над программой «Судоку» можно считать завершенной. Собственно, подо
шел конец и книге, посвященной замечательному языку Python и не менее замечательной
библиотеке PyQt.
Заключение
Вот и закончилось наше путешествие в мир Python 3 и PyQt 6. Материал книги описьmает
лишь базовые возможности этих замечательных программных платформ. А здесь мы рас
скажем, где найти дополнительную информацию, чтобы продолжить изучение.
Самыми важными источниками информации является официальный сайт Python https://
www.python.org/ - на нем вы найдете дистрибутив, новости, а также ссылки на все другие
ресурсы в Интернете. А на сайте https://docs.python.org/3/ имеется документация по Python 3,
которая обновляется в режиме реального времени.
Описание библиотеки PyQt можно найти на сайте https://www.riverbankcomputing.com/, но
от него мало толку. Поэтому лучше сразу наведаться на сайт https://doc.qt.io/, где приведена
полная документация по фреймворку Qt, лежащему в основе PyQt.
Описание всевозможных дополнительных библиотек, расширяющих возможности Python,
созданных сторонними разработчиками и доступных для свободного скачивания, вы найде
те на сайте https://pypi.python.org/pypi.
Следует отметить библиотеку Qt for Python (https://www.qt.io/qt-for-python), бывшую
PySide, созданную специалистами компании Nokia, а ныне поддерживаемую независимыми
разработчиками. Эта библиотека является полным аналогом PyQt и распространяется по
лицензии LGPL. Существуют другие библиотеки для создания оконных программ: wxPython
(https://www.wxpython.org/), PyGObject (https://pygobjectreadthedocs.io/enЛatest/indeLhtml,
бьmшая РуGТК), PyWin32 (https://mhammond.github.io/pywin32/) и pyFLTK (http://pyfltk.
sourceforge.net/). Обратите внимание и на библиотеку pygame (http://www.pygame.org/),
позволяющую разрабатывать игры, и на фреймворк Django (https://www.djangoprojectcom/),
с помощью которого можно создавать веб-сайтьr.
Если в процессе изучения у вас возникнут какие-либо вопросы, вспомните, что в Интернете
можно найти решения самых разнообразных проблем, - достаточно лишь набрать свой
вопрос в строке запроса того или J:ПIОГО поискового портала (например, https://www.
blng.com/ или https://www.google.ru/).
Засим авторы прощаются с вами, уважаемые читатели, и желают успехов в нелегком, но
таком увлекательном деле, как программирование!
ПРИЛОЖЕНИЕ
Описание электронного архива
Электронный архив с материалами, сопровождающими книгу, можно скачать с сервера из
дательства «БХВ» по ссылке https://zip.bhv.ru/9785977517065.zip или со страницы книги на
сайте https://Ьhv.ru.
Структура архива представлена в табл. П.1.
Таблица n.1. Структура электронного архива
Файл или каталог Описание
!main Все листинги, представленные в книге
additional Более 750 дополнительных листингов, демонстрирующих возможности
библиотеки PyQt (к части II книги)
sudoku Каталог с исходными текстами программы «Судаку»
readme.txt Описание электронного архива
Предметный указатель
_hash_()268
@ _iadd_()269
@abstractmethod272,276 _iand_()270
@classmethod272 _ifloordiv_()269
@staticmethod271 _ilshift_()270
_imod_()269
_import_()245
_imul_()269.
_abs_()269 _index_()268
_add_()269 _init_()260
_all_248,253 _int_()268
_and_()270 _invert_()270
-annotations- 242 _ior_() 270
- bases- 264 _ipow_()269
_bool_()267,268 _irshift_() 270
_call_()266 _isub_()269
- cause- 288 _iter_()292
-class- 301 _itruediv_() 269
_complex_()268 _ixor_()270
_contains_()271,294 _le_()271
_debug_291 _len_()267
_del_()261 _lshift_()270
_delattr_()267 _lt_()271
_delitem_() 294 _mod_()269
_dict_246,267 - mro- 265
_dir_()249 _mul_()269
_ doc_ 43,44,94 _name_243,301
_enter_()284 _ne_()270
_eq_()270 _neg_()269
_ exit_()284 _next_()236,287,292; 310,317
-file- 307 _or_()270
_float_()268 _pos_()269
_floordiv_()269 _pow_()269
_ge_()271 _radd_()269
_getattr_()249,266 _rand_()270
_getattribute_()267 _repr_()268
_getitem_()292,293 _rfloordiv_()269
_gt_()271 _rlshift_()270
Предметный указатель 799
_rmod_() 269 activeSubWindow() 691
_rmul_() 269 activeVideoTrack() 699
_ror_() 270 actualLocationChanged() 712
_round_() 268 actua!Size() 602
_rpow_() 269 add() 174
_пshift_() 270 addAction() 675,676,679,683,685
_rshift_() 270 addActions() 679
_rsub_() 269 addBindValue() 558, 560
_rtruediv_() 269 addButton() 637,641
_rxor_() 270 addDatabase() 551
_setattr_() 267 addDockWidget() 672
_setitem.:_() 294 addEllipse() 604
-slots- 274 addFile() 601
_str_() 268 addltem() 470,516,604
_sub_() 269 addltems() 516
_truediv_() 269 addLayout() 454,456
_xor_() 270 addLine() 604
addMenu() 675,677
А addPage() 664
addPath() 605
АВС 272,276 addPermanentWidget() 690
abort() 730 addPixmap() 602,605
about() 645 addPolygon() 604
aboutQt() 645 addRect() 604
aboutТoActivate() 694 addRow() 458
aboutТoHide() 679 addSection() 677
aboutToShow() 679 addSeparator() 676,677,685
abs() 85,269 addSimpleText() 605
abspath() 325 addSpacing() 454
accept() 426,448,635 addStretch() 454
accepted() 636,639 addSubWindow() 691
acceptНoverEvents() 629 addTab() 466
AcceptMode 653 addText() 605
acceptProposedAction() 447,631 addToGroup() 623
acceptRichText() 487 addToo!Bar() 671
access() 320 addToo!BarBreak() 672
accumulate() 182 addWidget() 453,454,456,460,472,605,
acos() 88 685,690
actionChanged() 445 adjust() 396
actionGroup() 682 adjusted() 396
actions() 679,683 adjustSize() 386
actionTriggered() 509,686 alignment() 463,491
activated() 506,519,534,695 AlignmentFlag 380, 454
activateNextSubWindow() 692 all() 164
activatePreviousSubWindow() 692 allKeys() 756
activateWindow() 399 alpha() 577,578
activationOrder() 692 alphaF() 577-579
ActivationReason 695 anchorClicked() 498
activeAction() 676,677 and 67
activeAudioTrack() 698 angleDelta() 441
activeMatch() 513 animateClick() 478
activeSubtitleTrack() 699 answerRect() 448
800 Предметный указатель
any() 164 baseSize() 386
append() 126,161,486,583 BatchExecutionMode 560
appendColurnn() 525,529 beforeDelete() 568
appendRow() 525,529 beforelnsert() 568
appendRows() 529 beforeUpdate() 568
applicationName() 753 begin() 586,730
AreaOption 693 beginEditВlock() 497
argv 36,350 beginGroup() 755
ArrowType 687 beginReadArray() 757
as 243 beginWriteArray() 757
as_integer_ratio() 87 Ьin() 84,268
ASCII 132,136 ЬindValue() 559,560
ascii() 109 Ыасk() 578
asctime() 196 ЫackF() 578
asin() 88 Ыаkе2Ь() 130
AspectRatioMode 596 Ыake2s() 129
aspectRatioModeChanged() 708 Ыосk() 496
assert 286, 290 ЫockCount() 493
AssertionError 286 ЫockCountChanged() 493
at() 561 BlockingIOError 337
atan() 88 ЫockNumber() 496
atВlockEnd() 496 ЫockSignals() 419
atBlockStart() 496 Ыuе() 577
atEnd() 496 ЫueF() 577
atStart() 496 ЫurRadius() 624,625
AttributeError 286 ЫurRadiusChanged() 624,625
AudioCodec 713 bold() 584
audiolnput() 709 ВОМ31
audiolnputs() 710 Ьоо\47
audioOutput() 696,709 bool() 53,268
audioOutputs() 700 bottom() 397
audioTracks() 698 bottomLeft() 397
auto() 298 bottomRight() 397
AutoFormattingFlag 489 boundedTo() 392
availaЫeGeometry() 389 boundingRect() 583,585,590,614
availaЫePrinterNames() 747 boundValue() 563
availaЫePrinters() 747 boundValues() 563
availaЫeRedoSteps() 492 break 77-79
availaЫeSize() 388 BrushStyle 581
availaЫeSizes() 602 bspTreeDepth() 604
availaЫeUndoSteps() 492 buffer 312
bufferProgress() 698
в bufferProgressChanged() 699
button() 439,628,638,642,666
back() 513,664 buttonClicked() 642
backgroundColor() 515 buttonDownPos() 628
backspace() 481 buttonDownScenePos() 628
backward() 498 buttonDownScreenPos() 628
backwardA vailaЫe() 498 ButtonRole 638,641
backwardHistoryCount() 498 buttonRole() 638,642
BaseException 286 buttons() 439,628,629,631,638,642
basename() 325 ButtonSymbols 499
Предметный указатель 801
buttonText() 666,668 clearEditText() 518
bytearray 48,125 clearFocus() 433,607,616
bytearray() 54,55,125,126 clearHistory() 498
bytes 48,121 clearMessage() 380,690
bytes() 54,121,122 clearSelection() 496,533,545,608
BytesIO 318 clearSpans() 538
clearUndoRedoStacks() 492
с clearValues() 568
click() 478
CacheModeFlag 61О clicked() 464,479,506,534,639
Calendar 213 clickedButton() 642
calendar() 218 clipboard() 448
carnera() 709 clone() 531
cancel() 663 cloneDatabase() 553
canceled() 663 Close 409
canPaste() 487 close() 307,314,315,330,409,553
capitalize() 114 Close() 339
capture() 720 closeActiveSubWindow() 692
captureToFile() 720 closeAIISubWindows() 692
cascadeSubWindows() 692 closeAIIWindows() 409
case 71 closed 312,315
casefold() 114 closeEvent() 431
CaseSensitivity 546 CloseKey() 339
ceil() 88 collapse() 540
cellRect() 457 collapseAII() 540
center() 103,397,582 collapsed() 541
centerOn() 613 collateCopies() 1i8
centralWidget() 671 collides Withltem() 617
chain() 183 collidingltems() 606,617
changed() 609,683 color() 624,625
changeEvent() 429 color0 �97
changeOverrideCursor() 442 colorl 597
characterCount() 493 colorChanged() 624,625
chdir() 307 colorData() 446
checkВox() 642 ColorDialogOption 659
checkedAction() 683 ColorGroup 404
checkOverflow() 507 ColorMode 728
CheckState 480 colorMode() 729
checkState() 480,531 colorNarnes() 576
child() 53.0 ColorRole 404
childGroups() 756 column() 522,528
childltems() 617 columnCount() 457, 525, 528
childKeys() 754 columnlntersectsSelection() 544
chmod() 321 columnSpan() 538
choice() 90,165 columnWidth() 538,540
choices() 166 combinations() 178
chr() 114 comblnations_with_replacement() 179
class 256,259,261,263 comblne() 209
cleanText() 500 commit() 552
cleanupPage() 664,669 commonpath() 326
clear() 163,175,192,331,446,449,467,477, commonprefix() 326
481,487,492,500,517,526,562,583,598, compile() 131
605,639,676,677,685,754 completeChanged() 669
802 Предметный указатель
CompleteHtmlSaveFormat 515 cuпentCharFormat() 491
9omplex 49,82 cuттentCharFormatChanged() 488
complex() 268 cuпentColurnnChanged() 545
compress() 181 cuттentData() 517
connect() 414,416 cuттentFont() 490,520
ConnectionEттor 337 cuпentFontChanged() 520
connectionName() 552 cuттentld() 664
connectionNames() 553 cuттentldChanged() 667
ConnectionType 416 curtentlndex() 460,468,470,517,521,
ConnectRegistry() 340 532,545
contains() 398,553,555,617,754 cuттentlndexChanged() 519
contentsChange() 493 cuттentMessage() 690
contentsChanged() 493 cuттentPage() 664,747
contentsSize() 515 cuттentPageChanged() 506
contextMenu() 695 cuттentRowChanged() 545
contextMenuEvent() 679 cuттentSection() 503
ContextMenuPolicy 679 cuттentSectionlndex() 503
continue 79 cuттentSubWindow() 691
Contro!Type 461 cuттentТext() 517
ConversionМode 713 cuттentТextChanged() 519
convertFromlmage() 595 cuттentUrlChanged() 655
convertTo{) 579 cuттentWidget() 460,468,470
convertToFormat() 600 cursor() 442
сору() 151,174,186,192,321,483,487, cursorBackward() 482
596,600 cursorForPosition() 494
сору2() 322 cursorForward() 482
соруАvailaЫe() 488 cursorPosition() 482
copyCount() 728 cursorPositionChanged() 483,488, 493
copyfile() 321 CursorShape 442
Comer 673 cursorWordBackward() 482
comer() 674 cursor\VordForward() 482
CoттectionMode 499 customВuttonClicked() 667
cos() 88 customEvent() 450
count() 115,164,177,460,468,471,473,517, cut() 483,487
542,554,583 cyan() 578
createEditor() 548 cyanF() 578
createltemGroup() 605 cycle() 178
CreateKey() 341
CreateKeyEx() 341 D
createMaskFromColor() 596
createPopupMenu() 671 darker() 577
createStandardContextMenu() 483,487 data() 446,522,524,527,530,564,682
critical() 644 database() 553
cssclass month 216 databaseText() 556
cssclass-month-head 216 dataChanged() 449,569
cssclass_noday 216 date 201
cssclass_year 216 date() 210,502
cssclass_year_head 216 dateChanged() 504
cssclasses 215 datetime 207
cssclasses_weekday_head 216 dateTime() 502
ctime() 197,203,212 dateTimeChanged() 504
cuттentChanged() 460,468,471,545,655 day 202,209
Предметный указатель воз
day_abbr219 directoryEntered() 655
day_name219 directoryUrl() 654
DayOfWeek506 directoryUr\Entered() 655
days199 DirEntry335
decimal59 dimame() 325
decode() 124,128 discard() 174
deepcopy() 151, 187 disconnect() 419
def222,229 display() 506
defaultAction() 445,678,687 displayText() 481
defaultAudiolnput() 710 divmod() 86
defaultAudioOutput() 700 dockLocationChanged() 689
defaultColorMode() 749 DockOption672
defaultDuplexМode() 749 dockOptions() 673
defaultPageSize() 749 DockWidgetArea672
defaultPrinter() 747 dockWidgetArea() 672
defaultPrinterName() 747 DockWidgetFeature 688
defaultSectionSize() 542 document() 491,622
defaultTextColor() 622 documentMargin() 493
defaultValue() 555 documentТitle() 486
defaultVideolnput() 717 done() 635
degrees() 88 DOTALL 132,133
del56,127,162,188,258,267 douЫeClicked() 534
del() 481 douЫeClicklnterval() 439
delattr() 258 douЬleValue() 648
deleteChar() 496 douЫeValueChanged() 648
DeleteKey() 342 douЫeValueSelected() 649
DeleteKeyEx() 343 dragCursor() 445
deletePreviousChar()497 DragDropMode 534
deleter()275 dragEnterEvent() 447,630
DeleteValue() 342 dragLeaveEvent() 447,630
delta() 629 DragMode 61 О
depth() 596,599 dragMode() 61 О
description() 700,717,748 dragMoveEvent() 447,630
deselect() 481 draw() 623
desktop() 388 drawArc() 589
destroyltemGroup() 605 drawBackground() 604
devic�() 700 drawChord() 589
deviceChanged() 701 drawEllipse() 588
DialogCode634 drawForeground() 604
DialogLabel654 drawlmage() 591
dict 48 drawLine() 587
dict() 185,186 drawLines() 587
dict items190 drawPicture() 593
dict_keys190 drawPie() 589
dict values190 drawPixmap() 590
difference() 171. drawPoint() 587
difference_update() 171 drawPoints() 587
digest() 129 drawPolygon() 588
digest_size129 drawPolyline() 587
dir() 44,246 drawRect() 588
Direction455,508 drawRoundedRect() 588
directory() 654 drawText() 589
804 Предметный указатель
drivers() 553 Error698,712,721
driverText() 556 error() 698,712,721
DropAction444 errorOccured() 699, 712,721
dropAction() 448,631 errorString() 698,712,721
dropEvent() 447,630 ErrorType556
dropwhile() 180 escape() 149
dump() 328,329 event() 428,682
dumps() 128 eventFilter() 449
dup() 315 EventPriority450
duplex() 728 ехс_info() 280
DuplexМode728 except279-282
duration() 697,712 Exception286,289
durationChanged() 699,712 ExclusionPolicy684
dx() 582 ехес() 370,444,557,558,634,635,640,646,
dy() 582 653,678
execBatch() 560
executedQuery() 563
Е exists() 322
е 88 exit() 350,363,370
EchoMode481 ехр() 88
edit() 533 expand() 144,148,540
editingFinished() 483,500 expandAll() 540
EditStrategy 566 expanded() 541
editTextChanged() 519 expandedTo{) 393
EditTrigger533 expandtabs()102
elif68 expandToDepth{) 540
else68,71,77,78,279,282 extertd()126,161
emit() 421
Empty374
empty() 374
F
enaЫedChanged() 624 F ОК320
encode() 121 fabs() 89
encoding312 factorial() 89
EncodingMode711 Fatse47
end() 144,483,586,730 families() 585
endArray() 757 family() 584
endEditBlock() 497 fdopen() 315
endGroup() 755 features() 689
endpos142 field() 555,665,668
endswith() 116 FieldGrowthPolicy459
ensureCursorVisiЫe() 487 fieldlndex() 567
ensureVisiЫe() 473,613,618 fieldName() 554
ensureWidgetVisiЬle() 473 FileExistsError337
entered() 534 FileForrnat712,720
enterEvent()441 FileMode653
Enum297 fileName() 753
enumerate() 156 fileno() 31 О
EnumКey() 344 FileNotFoundError337
EnumMeta299 fileSelected() 655
EnumValue() 343 filesSelected() 655
env31 fill() 596,599
EOFError286 'fillRect() 588
Предметный указатель 805
FillRule 588 fontUnderline() 491
filter() 160,565 fontWeight() 490
filterfalse() 180 for 77
filterSelected() 655 Format 598,753
finally 279,282 format() 104,599,753
find() 114,487,492 format_excepti.on() 280
findall() 145 format_exception_only() 280
findBlock() 493 formatmonth() 214,215
findBlockВyLineNumber() 493 formats() 446
findBlockВyNumber() 493 formatyear() 214,216
. FindChildOptions 454 formatyearpage() 216
findData() 518 forward() 498,513
FindFlag 488,513 forwardA vailaЫe() 498 .
findltems() 527 forwardHistoryCount() 498
finditer() 146 fractions 83
findText() 513,518 frameGeometry() 387,388
finish() 380 frameSize() 387
finished() 365,636 FRIDAY 213
first() 561 from 236,251,287,289
firstВlock() 493 from_iteraЫe() 183
firstweekday() 217 fromCmyk() 578
fitlnView() (il3,746 fromCmykF() 578
fitТoWidth() 746 fromData() 599
Flag 298 fromhex() 122,126
tlags 142 fromHsv() 578
tlags() 440,522,524,531,615 fromHsvF() 578
tloat 47,82,87 fromlmage() 596,598
tloat() 53,84,268 fromisocalendar() 202,208
tloor() 88 fromisoformat() 202,205,208
Flow 536 fromkeys() 186
tlush() 310,318 fromordinal() 202,208
FlushКey() 343 fromPage() 728
fmod() 89 fromRgb() 577
focuslnEvent() 434, 627 fromRgba() 577
focusltem() 607 fromRgbF() 577
focusltemChanged() 609 fromtimestamp() 201,208
focusNextChild() 433 frozenset 48
focusNextPrevChild() 433 frozenset() 175
focusOutEvent() 434,627 fsum() 89
FocusPolicy 433 Full 373
focusPolicy() 433 full() 374
focusPreviousChild() 433 fullmatch() 141
focusProxy() 433,627 fullRect() 738
FocusReason 432 fullRectPixels() 738
focusWidget() 433 fullRectPoints() 738
fold 205,207,209 fullScreenChanged() 707
font() 621,622,682 function 49,233
FontDialogOption 660
fontFamily() 490
FontFilter 520
G
fontlta]ic() 490 geometry() 386,388,695
fontPointSize() 490 get() 188,191,330,373
806 Предметный указатель
get_admin_tools() 345 global 226
get_appdata() 345 Globa!Color 576
get_common_admin_tools() 345 globa\Pos() 680
get_common_appdata() 345 globa\Position() 439
get_common_documents() 345 globals() 227
get_ desktop() 344 globa\X() 680
get_local_appdata() 345 globa!Y() 680
get_ ту_documents() 344 gmtime() 194
get_ ту_pictures() 344 gotFocus() 434
get_nowait() 374 grabKeyboard() 433,616
get_program_ files() 345 grabMouse() 616
get_program_ files_common() 345 grabShortcut() 435
get_programs() 344 GraphicltemChange 631
get_recent() 344 GraphicltemFlag 615
get_startup() 344 graphicsEffect() 623
get_system() 345 green() 577
get_windows() 345 greenF() 577
getatime() 323 group() 143,623,756
getattr() 244, 258 groupby() 183
getbuffer() 319 groupdict() 143
getCmyk() 578 groupindex 142
getCmykF() 578 groups 142
getColor() 659 groups() 144
getCoords() 397
getctime() 323
getcwd() 306
н
getDouЬ!e() 650 hasAcceptaЫelnput() 484
getExistingDirectory() 655 hasAlpha() 597
getExistingDirectoryUrl() 655 hasA\phaChannel() 597
getFont() 660 hasattr() 244,258
getHsv() 578 hasAudio() 698
getНsvF() 579 hasChildren() 528,530
getlnt() 649 hasColor() 446
getltem() 651 hasComplexSelection() 496
getlocale() 113 hasFocus() 433; 607,616
getmtime() 323 hasFormat() 446
getMultiLineText() 651 hash() 268
getOpenFileName() 656 hasHtml() 445
getOpenFileNames() 657 haslmage() 446
getOpenFileUrl() 656 hasSelectedText() 477,481
getOpenFileUrls() 657 hasSelection() 496,513,544
getRect() 397 hasText() 445
getrecursionlimit() 240 hasTracking() 509
getrefcount() 51 hasUrls() 446
getRgb() 577 hasVideo() 698
getRgbF() 577 hasVisitedPage() 664
getSaveFileName() 658 header() 540
getSaveFileUrl() 658 headerData() 527,564
getsize() 323 height() 386,391,397,585,596,599,603
getТext() 649 heightForWidth() 462
getvalue() 315 help 40
glob() 334 help() 42,43
Предметный указатель 807
helpRequested() 639,667 ignore() 426,448
hex() 84, 124,268 IGNORECASE131
hexdigest() 129 image() 448
hiddenSectionCount() 543 imageCapture() 709
hide() 383,616,635,695 imageCaptured() 721
hideColumn() 538,540 ImageConversionFlag592
hideEvent() 429 imageData() 446
hidePopup() 518 imageSaved() 721
hideRow() 538 import243
hideSection() 542 ImportError286
hideTearOffМenu() 678 in61,66,77,172,187,271,300
highlighted() 499,519 In558
historyChanged() 499 lndentationError 286
historyTitle() 498 index() 115,163,521,523,527,531,564
historyUrl() 498 IndexError286
НКЕУ-CLASSES-ROOT339 indexesMoved() 537
HКEY_CURRENT_CONFIG339 indexFromltem() 527
НКЕУ-CURRENT-USER339 indexOf() 461,468,470,473,555
НКЕУ DYN DATA339 indexWidget() 532
НКЕУ-LOCAL-MACHINE339 information() 6.43
HКEY_pERFORМANCE_DATA339 initializePage() 664,669
НКЕУ USERS339 input() 35
home() 482,498 InputDialogOption648
horizontalAdvance() 585 InputMethodHint 649
horizontalНeader()537 InputMode 647
HorizontalНeaderFormat505 inputRejected() 483
horizontalHeaderitem() 527 insert() 127,162,481,583
horizontalScrollВar() 474 insertAction() 679
hotSpot() 444 insertActions()679
hour204,205,207,209 insertColumn() 526,529
hours199 insertColumns() 526,530
hover() 682 insertHtml() 486,497
hovered() 676, 678,683,684 insertltem() 470,516
hoverEnterEvent() 628 insertltems() 516
hoverLeaveEvent() 628 insertLayout() 454
hoverMoveEvent() 628 insertMenu() 675,677
hsvHue() 578 insertPermanentWidget() 690
hsvHueF() 579 insertPlainText() 486
hsvSaturation() 578 InsertPolicy517
hsvSaturationF() 579 insertRecord() 566,567
html() 445 insertRow() 459,525,529
HТМLCalendar215 insertRows() 523,526,529,566
insertSe�tion() 677
insertSeparator() 516,676,677,685
insertSpacing() 454
Icon639 insertStretch()454
icon() 513,677,680,694 insertTab() 466
iconChanged() 514 insertText() 497
iconSize() 672,686 insertToolВar() 671
id() 555 insertToo!ВarBreak() 672
IDLE24,32 insertWidget() 453,454,460,472,685,690
IDLE Shell25 install37
if68,71 installEventFilter() 449
808 Предметный указатель
installSceneEventFilter() 631 isdigit() 118
instance() 350 isdir() 333
int 47,82,87 isDirty() 567
int() 53,84,268 isdisjoint() 173
IntEnum 298 isDockNestingEnaЬ!ed() 673
InterruptedError 337 isDown() 479
intersected() 398 isDriverAvailaЫe() 553
intersection() 172 isEmpty() 392,398,492,555,583,677,705
intersection_update() 172 isEnaЬ!ed() 616,623,682,684
intersects() 398 isEquivalentТo() 737
interval() 425 isExpanded() 541
lntFlag 299 isfile() 334
intValue() 507,647 isFinalPage() 669
intValueChanged() 648 isFinished() 366
intValueSelected() 648 isFlat() 464
invalidate() 608 isFloataЫe() 686
invalidateScene() 614 isFloating() 686,688
InvertMode 601 isForwardA vailaЬ!e() 498
invertPixels() 601 isFullScreen() 400,707
InvertRgb 60 l 1sGenerated() 568
InvertRgba 601 isHeaderHidden() 540
invisiЫeRootltem() 526 isHidden() 383
is 50,67 isidentifier() 119
is not 67 islndexНidden() 538,540
is_dir() 336 isinstance() 53
is_file() 336 islnteractive() 61О
is_integer() 87 isltemEnaЫed() 470
is_symlink() 336 iskeyword() 120
isabs() 325 isleap() 218
isAccepted() 426 islink() 334
isActive() 425,562',586,608 isLoaded() 723
isActiveWindow() 400 islower() 119
IsADirectoryError 337 isMaximized() 400
isalnum() 118 isMinimized() 400
isalpha() 118 isModal() 401
isAmЬiguous() 436 isModified() 481,492
isascii() 118 isMovaЬ!e() 686
isatty() 327 isMuted() 700,723
isAudioMuted() 515 isNull() 391,392,397,495,561,567,568,
isAutoRepeat() 438 581,595,599,601,748
isAutoValue() 556 isnumeric() 118
isAvailaЫe() 711,720 isocalendar() 204,211
isBackwardAvailaЬ!e() 498 isoformat() 203,206,211
isCheckaЫe() 464,530,681 isOpen() 552
isChecked() 464,478,681 isOpenError() 552
isColumnНidden() 538,540 isoweekday() 204,211
isColumnSelected() 544 isPlaying() 723
isCommitPage() 669 isprintaЫe() 119
isComplete() 669 isQBitmap() 596
isdecimal() 118 isReadOnly() 482,489,556
isDefault() 748 isReadyForCapture() 720
isDescending() 556 isRedoAvailaЬ!e() 483,492
Предметный указатель 809
isRemote() 748
isRowHidden() 537,538,540
к
isRowSelected() 544 Кеу 435,704
isRunning() 366 key() 436,437
isSectionHidden() 542 КЕУ ALL ACCESS 339
isSeekaЫe() 697 КЕУ-CREAТЕ-SUВ-КЕУ 339
isSelect() 561 КEY_ENUMERATE_SUB_KEYS 339
isSelected() 544,616 КЕУ EXECUTE 339
isSeparator() 681 КЕУ NOТIFY 339
isShaded() 694 КEY_QUERY_VALUE 339
isSingleShot() 425 КЕУ READ 339
isSizeGripEnaЫed() 635 КЕУ SET VALUE 339
isslice() 181 КЕУ_WOW64_32КEY 339,343
isspace() 119 КЕУ_WOW64_64КEY 339,343
issubset() 173 КЕУ WRITE 339
issuperset() 173 Keyboardlnterrupt 286
isSystemTrayAvailaЫe() 694 KeyboardModifier 438
isTabEnaЫed() 468 КеуЕттоr 286
isTabVisiЫe() 468 keyPressEvent() 437, 627
isTearOffEnaЫed() 678 keyReleaseEvent() 437, 627
isTearQffМenuVisiЫe() 678
keys() 190,330,705
istitle() 119
killTimer() 423
isTristate() 480
isUndoAvailaЫe() 483,492
· isUndoRedoEnaЫed() 487,492 L
isupper() 118
isUserTristate() 531 lambda 234
isValid() 392,398,522,553,557,561,575, last() 561
727 lastВlock() 493
isValidColor() 576 lastEттor() 552,563,564
isVisiЫe() 383,616,682,684,695 lastgroup 143
isWritaЫe() 759 lastindex 142
italic() 584 lastlnsertld() 563
item() 526 lastPos() 628,629
itemAt() 605, 612 lastQuery() 563
itemChange() 631 lastScenePos() 628,629
itemChanged() 528 lastScreenPos() 628,629
itemData 517 LayoutDirection 454
ItemDataRole 520 LayoutMode 536
ItemFlag 522 LC ALL 113
itemFromlndex() 527 LC COLLATE 113
ItemlndexMethod 604 LC СТУРЕ 113
items() 190,330,606,612 LC MONETARY 113
itemsBoundingRect() 604 LC NUMERIC 113
ItemSelectionМode 606 LC ТIМЕ 113
ItemSelectionOperation 608 leapdays() 218
itemText() 470,517 leaveEvent() 441
left() 397
J len() 97,109,153,188,267
length() 555
join() 111,168,326,374 LifoQueue 372
JoinМode 571 lighter() 577
joinPreviousEditВlock() 497 line() 618
810 Предметный указатель
lineCount()493 mapToGlobal()440
LineWrapMode 489 mapToParent()441
linkActivated()477,622 mapToScene()612
linkНovered()477,622 marginsAdded() 395
list 39,47 marginsRemoved()395
list()55, 150,151 mask()596
listdir() 332 MaskМode 596
ljust()103 match 71
load()328, 329,512,593,595,599 Mat�h 142
loadedChanged()724 match()140
loadFinished()514 matches()438
loadFromData()595,599 MatchFlag 518
loadProgress()514 max 201,204,206, 212
loads()128 max()85
loadStarted()514 iµaximumВlockCount()493
loadUi()359 maximumНeight()386
loadUiType()360 maximumPhysicalPageSize()749
LOCALE 132 maximumSectionSize()542
localeconv()113 maximumSize()386
LocaleHTMLCalendar 215 maximumWidth()386
LocaleTextCalendar 213 МАХУЕАR 201
locals()227 md5()129
localtime()195 mdiArea()693
location()748 МDI-программа 670
lock()376 MediaStatus 698
log()88 mediaStatus()698
logl 0()88 mediaStatusChanged()699
log2()88 MemoryError 286
logicallndex() 543 memoryview()319
loops()697 menu()479,687
loopsRemaining()723 menuAction()677
loopsRemainingChanged()724 menuBar()671
lostFocus()434 menuWidget()671
lower()114 messageChanged()690
lseek()314 messageClicked()695
lstrip()11О Messagelcon 695
metaData() 698
м metaDataChanged()699
microsecond 205,207,209
magenta()578 microseconds 199
magentaF()578 milliseconds 199
make_shortcut() 346 mimeData()444,447,449,630
makeAndModel()748 MimeHtmlSaveFormat 515
makedirs()331 min 201,204,206,212
maketrans()117 min()86
manhattanLength()391 minimumНeight()386
map()158 minimumPhysicalPageSize()749
mapFrom() 441 minimumSectionSize()542
mapFromGlobal()441 minimumSize()386
mapFromParent()441 minimumSizeHint()386
mapFromScene()611 minimumWidth()386
mapTo()441 minute 204,205,207,209
Предметный указатель 811
minutes199
MINYEAR201
N
mirror() 601 name300,312,335
mirrored() 601 name() 555,556,576,737
mkdir() 331 NameError287
mktime() 195 NameFormat576
rnnemonic() 435 nativeErrorCode() 557
mode312 newPage() 730
Mode507,602 next() 561,664
model() 522,531,532 nextld() 664,669
modificationChanged() 494 NoDockWidgetArea672
modifiers() 438,440,628,629,631 None49
module49 NoneType49
ModuleNotFoundError287 nonlocal241
modules245 normalized() 398
MONDAY213 normcase()333
month202,209 normpath()326
month() 217 not67
month abbr220 not in61,66,173,187,300
month name219 NotADirectoryError337
monthcalendar() 217 Notation485
monthrange() 218 NotlmplementedError 287
monthShown() 505 now() 208
MouseButton 439 numberOfМatches() 513
mouseDouЬ!eClickEvent() 439,627 numRowsAffected() 563
MouseEventCreatedDouЬ!eClick440
MouseEventFlag440
mouseGrabberltem() 608
о
mouseMoveEvent() 440,627 О APPEND313
mousePressEvent()439,627 О BlNARY313
mouseReleaseEvent() 439,627 О CREAT313
move() 322,387 О EXCL313
moveBottom() 396 О RDONLY313
moveBottomLeft() 396 О RDWR313
moveBottomRight() 396 О-SHORT-LIVED313
moveBy() 615 О TEМPORARY313
moveCenter() 396 О ТЕХТ313
moveCursor() 494 О TRUNC313
moveEvent() 430 О WRONLY313
Movement536 objectName() 410
MoveMode495 oct() 84,268
MoveOperation494 offset() 620,624
movePosition() 495 offsetChanged() 624
moveRight() 396 oldPos() 430
moveSection() 543 oldSize() 430
moveTo() 395 oldState() 429
moveTop() 396 opacity() 615,626
moveTopLeft() 396 opacityChanged() 626
moveTopRight() 396 opacityMask() 626
msleep() 368 opacityMaskChanged() 626
МULТILINE131,133 open() 302,307,313,329,552,635
mutedChanged() 700,724 ОреnКеу() 339
812 Предметный указатель
ОреnКеуЕх() 339 Pdtversion750
Option653 PenCapStyle580
options() 740 PenJoinStyle 580
or68 PenStyle 579
ord() 114 PennissionEпor337
organizationName() 753 pennutations()179
Orientation527,727 pi88
orientation() 629,746 Pickler329
OSEпor287 pip37
outputFileName() 727 pixel() 600
OutputFonnat727 pixe!Delta() 441
outputFonnat() 727 pixe!Size() 584
overflow() 507 pixmap() 380,444,449,602,620
OverflowEпor287 platfonn 338
overline() 585 play() 697,723
oveпideCursor() 442 playbackRate() 697
overwriteMode() 489 playbackRateChanged() 699
PlaybackState697
р playbackState() 697
playbackStateChanged() 699
pl() 582. playingChanged() 724
р2 () 582 point() 583
page() 514,664 pointSize() 584
pageAdded() 667 pointSizeF() 584
pageCount() 747 Policy461
pagelds() 664 polygon() 619
pageLayout() 728 рор () 127,162,174,191,331
pageRect() 730 popitem() 191,331
pageRemoved() 667 popup() 678
PageSizeld735 popupMode() 687
paint() 614 pos142
paintEvent() 431 pos() 388,430,439,443,614,627,629,630,
paintRectPixels() 738 679
paintRectPoints() 738 Position716
paintRequested() 743 position() 439,496,697
pairwise()179 positionChanged() 699
palette() 404 positionlnBlock() 496
paperRect() 730 possiЬleActions() 447,630
PaperSource729 postEvent() 450
paperSource() 729 pow() 85,88
ParamType 558 prcal() 218
parent() 522,528; 530 precision() 555
parentltem() 617 prepare() 558
parentWidget() 383 prepareGeometryChange() 615
partial() 418 prepend() 583
partition()111 pressed() 479,534
pass63 · previewChanged() 747
paste() 483,487 previous() 561
path249,335 primarylndex() 553
pattem 142 primaryKey() 567
PattemOption493 primelnsert() 568
pause() 697, 711 print() 33,268,327,488,492,514,747
Предметный указатель 813
print_exception() 280 QAudiolnput 710
print_tb() 280 QAudioOutput 699
PrintDialogOption 740 QBitmap 597
printer() 740,741 QBrush 580
printerlnfo() 748 QButtonGroup 479
PrinterMode 726 QCalendarWidget 504
printerName() 727,748 QCamera 716
PrinterState 748 QCameraDevice 717
PrintRange 728 QCheckВox 480
printToPdf() 514 QClipboard 448
Priority 365,682 QCloseEvent 431
priority() 365,682 QColor 575
PriorityQueue 372 QColorDialog 659
prmonth() 214,217 QComboBox 516
processEvents() 364 QCompleter 482
ProcessEventsFlag 364 QConica!Gradient 581
product() 179 QContextMenuEvent 679
property 275 QCursor 442,443
property() 275 QDateEdit 501
proposedAction() 447,631 QDateTimeEdit 501
pryear() 215 QDial 510
purge() 149 QDialog 634
put() 373 QDialogВuttonВox 636
put_nowait() 373 QDockWidget 688
pydoc 42 QDouЬ!eSpinВox 499
РуНКЕУ 339,340 QDouЬ!eValidator 485
РуР137 QDrag 444
PyQt 349 QDragEnterEvent 447
PYQT_VERSION_SТR 349 QDragLeaveEvent 447
PyQt6 362 QDragMoveEvent 447,448
PyQt6-WebEngine 511 QDropEvent 447
pyqtSignal() 421 QEnterEvent 441
pyqtSiot() 417 QEпorMessage 661
pyshortcuts 345 QEvent 426
PYTHONPAТН 250 QFileDialog 652
pyuic6 361 QFocusEvent 434
QFont 584
Q QFontComboBox 519
QFontDatabase 585
QAbstractButton 478 QFontDialog 660
QAbstractGraphicsShapeltem 618 QFontМetrics 585
QAbstractltemDelegate 549 QFontMetricsF 586
QAbstractltemView 521,532 QFormLayout 457
QAbstractListModel 523 QFrame 382,464
QAbstractProxyModel 546 QGradient 581
QAbstractScroIIArea 474 QGraphicsBlurEffect 625
QAbstractSiider 508 QGraphicsColorizeEffect 625
QAbstractSpinВox 499 QGraphicsDropShadowEffect 624
QAction 437,679,680 QGraphicsEffect 623
QActionGroup 683 QGraphicsEIIipseltem 619
QApplication 350 QGraphicsltem 614
QAudioDevice 700 QGraphicsltemGroup 622
814 Предметный указатель
QGraphicsLineltem618 QMetaType 555
QGraphicsOpacityEffect625 QMimeData445
QGraphicsPixmapltem620 QModellndex521
QGraphicsPolygonltem619 QMouseEvent439
QGraphicsProxyWidget605 QMoveEvent430
QGraphicsRectltem619 ' ' ·· QMutex376
QGraphicsScene603 QMutexLocker378
QGraphicsSceneDragDropEvent630 QObject353
QGraphicsSceneEvent627 QPagedPaintDevice586,726
QGraphicsSceneHoverEvent629 QPageLayout727, 737
QGraphicsSceneMouseEvent627 QPageSetupDialog740
QGraphicsScene WheelEvent629 QPageSize735
QGraphicsSimpleTextltem 621 QPaintDevice586
QGraphicsTextltem621 QPainter586
QGraphicsView609 QPaintEvent431
QGridLayout455 QPalette404
QGroupBox462 QPdfWriter749
QHBoxLayout452 QPen579
QHeaderView541 QPersistentModellndex522
QHideEvent429 QPicture586, 593
Qlcon601 QPixmap586, 594
Qlmage 586, 598 QPlainTextEdit486
QlmageCapture720 QPoint390
QlmageReader 403, 594 QPointF390
QlmageWriter594 QPolygon582
QlnputDialog 646, 649 QPolygonF583
QlntValidator485 QPrintDialog 739
QltemDelegate548 QPrinter726
QltemSelectionМodel544 QPrinterlnfo747
QKeyEvent 437 QPrintPreviewDialog742
QKeySequence435 QPrintPreviewWidget745
QLabel475 QProgressBar507
QLCDNumber506 QProgressDialog662
QLeaveEvent 441 QPushВutton477, 479
QLine581 QRadia!Gradient581
QLinearGradient 581 QRadioButton479
QLineEdit480 QRect393
QLineF582 QRectF390
QListView535 QRegion431
QMairiWindow670 QRegularExpression485
QMargins 395 QRegularExpressionValidator48.5
QMdiArea690 QResizeEvent430
QMdiSubWindow693 QScreen388
QMediaCaptureSession709 QScrollArea 473
QMediaDevices700, 710, 716 QScrollBar474, 511
QMediaFormat712 QSettings752
QMediaМetaData704 QShortcut437
QMediaPlayer696 QShortcutEvent436
QMediaRecorder710 QShowEvent429
QMenu676 QSize391
QMenuВar 675 qsize() 374
QMessageBox.639 QSizeF390
Предметный указатель 815
QSizePolicy461 QToo!Box469
QS!ider508 QToo!Button686
QSortFilterProxyModel546 QtPrintSupport362
QSoundEffect722 QTransforrn 593,616
QSpinBox499 QTreeView539
QSplashScreen379 QtSql363
QSplitter471 QtSvg363
QSq!Database551 QtWebEngineCore362
QSq!Error 556 QtWebEngineWidgets362
QSq!Field 555 QtWidgets362
QSqllndex 556 QtXml363
QSq!Query557 QtXm!Pattems363
QSq!QueryModel563 Quality711,720
QSq!Record554,567 query() 564
QSq!Relation571 QuerylnfoKey() 343
QSq!Relationa!Delegate573 QueryValue() 341
QSqlRelationa!ТaЫeModel571 QueryValueEx() 340
QSq!TaЬleModel 565 question() 643
QStackedLayout460 Queue372
QStackedWidget460 quit() 363,370,417
QStandardltem524,528 QUrl497
QStandardltemМodel524 QValidator485
QStatusBar 689 QVariant423
QStatusTipEvent 682 QVBoxLayout452
QStringListModel523 QVideoWidget707
QStyledltemDelegate548 QWebEngineDownloadRequest515
QStyleOption548 QWebEngineFindTextResult513
QStyleOptionViewltem548 QWebEnginePage513,515
QSystemTraylcon 694 QWebEngineView511
Qt349 QWhee!Event441
Qt Designer 356 QWidget382,586
QT_VERSION_SТR349 QWindowStateChangeEvent429
QTaЫeView537 QWizard663
QTabWidget465 QWizardPage667
QtCore362
QTextВlock493
QTextBrowser497
R
QTextCharForrnat491, 506 R ОК320
QTextCursor494 radians() 88
QTextDocument491 raise287
QTextDocumentFragment496 raise_() 635
QTextEdit486 randint() 90
QTextOption489,590 random() 89
QtGui362 randrange() 90
QtHelp 363 range48
QThread365 range() 156,175
QTimeEdit501 rangeChanged()51 О
,QTimer424, 426 re142
QtMultimedia362 read() 308, 314,316
QtMultimediaWidgets362 readaЫe() 31 О
QtNetwork363 readline() 309,317
QToo!Вar685 readlines() 309,317
816 Предметный указатель
readyForCaptureChanged() 721 removeFormat() 446
reason() 434 removeFromGroup() 623
record() 553,561,564,711 removeltem()470,517,605
recorder() 709 removePage() 664
RecorderState712 removeprefix() 112
recorderState() 712 removeRow() 530
recorderStateChanged() 712 removeRows() 523,526,530,566
recort() 561 removeSceneEventFilter() 631
rect()386,431,596,599,619,620,736 removeSelectedText() 496
rectPixels() 736 removeSubWindow() 692
rectPoints() 737 removesuffix() 112
RecursionEпor287 removeTab()467
red() 577 removeToolВar() 671
redF() 577 removeToolBarBreak()672
redo() 483,487,492 removeWidget() 453,690
redoAvailaЫe() 488,494 rename() 322
reduce() 160 render() 608,613
REG BINARY 342 RenderНint589,611
REG DWORD342 repaint() 431
REG_DWORD_BIG_ENDIAN342 repeat()178,221
REG_DWORD_LIТTLE_ENDIAN342 replace() 116,203,206,210
REG_EXPAND_SZ 341 replaceWidget() 453
REG_FULL_RESOURCE_DESCRIPTOR repr() 109,268
342 RequiredStatus555
REG LINK342 requiredStatus() 555
REG-МULТ1-SZ 342 reset() 508,663
REG NONE342 resetCachedContent() 61 О
REG_QWORD342 ,resetТransform() 613,617
REG_QWORD_LIТTLE_ENDIAN342 resize() 384
REG-RESOURCE-LIST342 resizeColurnnsToContents() 538
REG_RESOURCE_REQUIREМENTS_LIST resizeColurnnToContents() 538,540
342 resizeDocks() 674
REG SZ 341 resizeEvent() 430
region()431 ResizeMode 536,542
registerEventType() 428 resizeRowsToContents() 538
registerField() 668 resizeRowToContents() 538
reject() 635 resizeSection() 542
rejected() 636,639 resolution201,204,206,212
released() 479 resolution() 729,750
releaseKeyboard()433 ResourceType497
releaseShortcut() 436 restart() 664
reload()251,498,513 restore() 593
relock() 379 restoreDockWidget() 674
remainingTime() 425 restoreGeometry() 674
remove() 127,162,174,322,583,754 restoreOveпideCursor()442,443
removeAction() 679,683 restoreState() 472,543,655,674
removeButton() 639,642 result() 635
removeColumn() 530 retrieveData() 446
removeColurnns() 526,530 retum 223
removeDatabase() 553 returnPressed() 483
removeDockWidget() 672 reverse() 127,164
removeEventFilter()449 reversed() 165,192
Предметный указатель 817
revert() 567 scope() 753
revertAII() 567 sci-eenPos() 628,629,630
rfind() 115 ScrollBarPolicy 474
rgb() 577 ScrollHint 533
rgba() 577 scrollPosition() 515
right() 397 scrollTo() 533
rindex() 115 scrollToBottom() 534
rjust() 103 scrollToTop() 534
rmdir() 332 SDI-программа 670
rmtree() 333 search() 141
rollback() 552 second 205,207,209
rootlndex() 532 seconds 199
rotate() 592,612 Section 503
rotation() 617 sectionAt() 503
round() 85,268 sectionClicked() 543
row() 522,528 sectionCount() 503
rowCount() 457,524,525,528,564 sectionDouЬ\eClicked() 543
rowHeight() 537,540 sectionMoved() 543
rowlntersectsSelection() 544 sectionPressed() 543
rowSpan() 538 sectionResized() 543
RowWrapPolicy 459 sectionsHidden() 542
rpartition() 111 sectionSize() 542
rsplit() 110 sectionsMovaЫe() 543
rstrip() 11О sectionText() 503
run() 365 seed() 89
RuntimeError 287 �eek() 311,315,561
SEEK_CUR 311,314
5 SEEK_END 311,314
SEEK_SET 311,314
SameFileError �21 seekaЬ\e() 312
sample() 90,165 SegmentStyle 507
SATURDAУ 213 select() 496,545,565
save() 515,593,595,599 selectAll() 481,487,500,533
saveGeometry() 674 selectColumn() 537
SavePageFormat 515 selectedColumns() 544
saveState() 472,543,654, 674 selectedDate() 504
scale() 392,593,613,617 selectedFiles() 654
scaled() 392,596,600 se\ectedindexes() 532,544
scaledToHeight() 597,601 selecteditems() 608
scaledToWidth() 597,600 selectedRows() 544
scandir() 335 se\ectedText() 477,481,496,513
scene() 610,615 se\ectedUrls() 654
sceneBoundingRect() 615 se\ectFile() 654
sceneEvent() 631 se\ection() 496,545
sceneEventFilter() 631 se\ectionArea() 608
SceneLayers 609 SelectionВehavior 533
scenePos() 615,627,629,630 selectionChanged() 483,488,506,514,545,
scenePosition() 439 609
sceneRect() 603,610 se\ectionEnd() 481,496
sceneRectChanged() 609 SelectionF\ag 545
sceneTransform() 616 Se\ectionМode 505,532
Scope 752 selectionМodel() 532
818 Предметный указатель
selectionStart() 477,481,496 setAutoRepeat() 478,682
SelectionType 496 setAutoReset() 663
selectRow() 537,567 setAutoScroll() 534
selectUrl() 654 setAutoScrollMargin() 534
self256 setBackground() 530,693
sendEvent() 450 setBackgroundBrush() 604,610
sep 305 .setBackgroundColor() 515
set 48 setBar() 663
set() 170 setBaseSize() 386
setAccelerated() 500 setBatchSize() 536
setAcceptDrops() 447,630 setBinМode() 507
setAccepted() 426 setBlue() 577
setAcceptedMouseButtons() 627 setBlueF() 577
setAcceptНoverEvents() 629 setBlurRadius() 624,625
setAcceptMode() 653 setBold() 584
setAcceptRichText() 487 setBottom() 394
setActionGroup() 682 setBottomLeft() 394
setActivationOrder() 692 setBottomМargin() 738
setActiveAction() 676, 677 setBottomRight() 394
setActiveAudioTrack() 698 setBrush() 405,580,587,619
setActiveSubtitleTrack() 699 setBspTreeDepth() 604
setActiveSubWindow() 692 setBuddy() 476
setActiveVideoTrack() 699 setButton() 665
setAlignment() 463,473,476,482,491,500, setButtonLayout() 666
610 setВuttonSymbols() 499
setAllowedAreas() 685,688 setВuttonText() 666,668
setAllPagesViewMode() 746 setCacheMode 61О
setAlpha() 577 setCalendarPopup() 503
setAlphaF() 577 setCamera() 709
setAltematingRowColors() 532 setCameraDevice() 717
setAnimated() 541,672 setCance!Button(} 663
setApplicationName() 752 setCance!ButtonText() 647,663
setAттaylndex() 757 setCapStyle() 580
setAттowType() 687 setCascadingSectionResizes() 542
setAspectRatioMode() 707 setCenterButtons() 639
setattr() 258 setCentra!Widget() 670
setAttribute() 409 setCheckaЫe() 463,478,530,681
setAudioBitRate() 711 setCheckВox() 642
setAudioChanne!Count() 711 setChecked() 464,478,681
setAudioCodec() 713 setCheckState() 480,530
setAudioDevice() 723 setChild() 528
setAudiolnput() 709 setChildrenCollapsiЬ!e() 472
setAudioMuted() 515 setClearButtonEnaЫed() 483
setAudioOutput() 696,709 setCmyk() 577
setAudioSampleRate() 711 setCmykF() 578
setAutoAcceptChildRows() 547 setCollapsiЫe() 472
setAutoC!ose() 663 setCollateCopies() 728
setAutoDefault() 479 setColor() 404,580,581,624,625
setAutoExclusive() 478 setColorData() 446
setAutoFillBackground() 404 setColorMode() 728
setAutoFormatting() 489 setColumnCount() 525,528
setAutoRaise() 687 setColumnHidden() 538,540
Предметный указатель 819
setColumnMinimumWidth() 457 setDigitCount() 507
setColumnStretch() 457 setDirection() 455
setColumnWidth() 538, 540 setDirectory() 654
setComboBoxEditaЫe() 648 setDirectoryUrl() 654
setComboBoxitems() 648 setDisaЫed() 682,684
setCommitPage() 669 setDisplayFormat() 502
setCompleter() 482,518 setDockNestingEnaЫed() 673
setConnectOptions() 552 setDockOptions() 672
setContectMenuPolicy() 679 setDocument() 491,622
setContentsMargins() 455,457,459 setDocumentMargin() 493
setContextMenu() 694 setDocumentMode() 467
setControlType() 462 setDocumentTitle() 486
setCoords() 395 setDouЬleClickinterval() 439
setCopyCount() 728 setDouЫeDecimals() 648
setComer() 673 setDouЬJeMaximum() 648
setComerButtonEnaЫed() 539 setDouЫeMinimum() 648
setCorrectionMode() 499 setDouЫeRange() 648
setCreator() 750 setDouЫeStep() 648
setCurrentCharFormat() 491 se,DouЫeValue() 647
setCurrentFont() 490,520 setDown() 479
setCurrentlndex() 460,468,470,517,532,545 setDragCursor() 444
setCurrentPage() 505,747 setDragDropMode() 534
setCurrentSection() 503 setDragEnaЫed() 482,531,534
setCurrentSectionlndex() 503 setDragMode() 61О
setCurrentТext() 517 setDrapDropOverwriteMode() 534
setCurrentWidget() 460,468,470 setDropAction() 448, 631
setCursor() 442,616 setDropEnaЫed() 531
setCursorPosition() 482 setDroplndicatorShown() 534
setCursorWidth() 490 setDuplex() 728
setData() 446, 523,527, 530,682 setDuplicatesEnaЫed() 518
setDatabaseName() 552 setDynamicSortFilter() 547
setDate() 502 setEchoMode() 481
setDateRange() 502,504 setEditaЫe() 517,531
setDateTextFormat() 506 setEditorData() 548
setDateTime() 502 setEditStrategy() 566
setDateTimeRange() 502 setEditТext() 518
setDecimals() 501 setEditТriggers() 533
setDecMode() 507 setElideMode() 467
setdefault() 188,191,330 setEnaЫed() 531,616,623,682,684
setDefault() 479 setEncodingМode() 711
setDefaultAction() 677,687 setEscapeButton() 642
setDefaultAlignment() 543 setExclusionPolicy() 684
setDefaultButton() 642 setExclusive() 684
setDefaultFont() 493 setExpanded() 540
setDefaultProperty() 668 setExpandsOnDouЬleClick() 541
setDefaultSectionSize() 542 setFacingPagesViewMode() 746
setDefaultStyleSheet() 493 setFamily() 584
setDefaultSuffix() 654 setFeatures() 688
setDefaultТextColor() 622 setField() 665,668
setDefaultUp() 676 setFieldGrowthPolicy() 459
setDetailedText() 641 setFileFormat() 713,720
setDevice() 700,710 setFileMode() 653
820 Предметный указатель
setFil!Rule() 619 setGridVisiЫe() 505
setFilter() 565 setGroup() 623
setFilterCaseSensitivity() 547 setНandleWidth() 472
setFilterFixedString() 546 setНeaderData() 527,564
setFilterKeyColumn() 547 setHeaderHidden() 540
setFilterRegularExpression() 546 setНeaderTextFormat() 506
setFilterRole() 547 setНeight() 392,395
setFiltersChildEvents() 631 setНeightForWidth() 462
setFilterWildcard() 547 setНexМode() 507
setFinalPage() 669 setНighlightSections() 543
setFirstColumnSpanned() 541 setНistory() 654
setFirstDayOfWeek() 505 setНorizontalНeaderFormat() 505
setfirstweekday() 21 3,217 setНorizontalНeaderltem() 527
setFixedНeight() 385 setНorizontalHeaderLabels() 527
setFixedSize() 385 setНorizontalPolicy() 462
setFixedWidth() 385 setНorizontalScrollBarPolicy() 474
setF\ag() 615 setHorizontalSpacing() 457,459
setFlags() 531,615 setHorizonta\Stretch() 462
setFlat() 464,479 setНostName() 551
setFloataЫe() 686 setHotSpot() 444
setFloating() 688 setНsv() 578
setFlow() 536 setНsvF() 578
setFocus() 432,607,616 setНtml() 445,486,491,512,621
setFocusltem() 607 setlcon() 478,530,640,677,680,694
setFocusPolicy() 433 setlconPixmap() 640
setFocusProxy() 433,627 setlconSize() 467,478,518,533,672,686
setFont() 530,584,604,621,622,682 setlconVisiЬ\elnМenu() '680
setFontEmbeddingEnaЫed() 729 setlmage() 448
setFontFamily() 490 setlmageCapture() 709
setFontFilters() 520 setlmageData() 446
setFontltalic() 490 setlndent() 477
setFontPointSize() 490 · setlndentation() 541
setFontUnderline() 490 setlndexWidget() 532
setFontWeight() 490 setlnformativeText() 640
setForeground() 530 setlnputMask() 484
setForegroundBrush() 604,61 О setlnputMode() 647
setFormAlignment() 459 setlnsertPolicy() 517
setFormat() 508 setlnteractive() 61О
setForwardOnly() 560 setlnterval() 424
setFrame() 482,500,518 setlntMaximum() 647
setFrameRect() 465 setlntMinimum() 647
setFrameShadow() 465 setlntRange() 647
setFrameShape() 464 setlntStep() 647
setFrameStyle() 465 setlntValue() 647
setFromTo() 728 setlnvertedAppearance() 508,509
setFullScreen() 707 setlnvertedControls() 509
setGenerated() 568 setltalic() 584
setGeometry() 385,388 setltem() 525
setGraphicsEffect() 623 setltemData() 517
setGreen() 577 setltemDe\egate() 549
setGridSize() 536 setltemDelegateForColumn() 549
setGridStyle() 538 setltemDelegateForRow() 549
Предметный указатель 821
setltemEnaЬ!ed() 470 setMinimumDate() 502,504
setltemlcon() 470,517 setMinimumDateTime() 502
setltemlndexМethod() 604 setMinimumDuration() 663
setltemsExpandaЬ!e() 541 setMinimumHeight() 385
setltemText() 470, 516 setMinimumМargins() 738
setltemToolTip() 470 setMinimumSectionSize() 542
setJoinMode() 571 setMinimumSize() 385
setJoinStyle() 580 setMinimumTime() 502
setKeepPositionOnlnsert() 497 setMinimumWidth() 385
setKeyboardPageStep() 693 setMiterLimit() 580
setKeyboardSingleStep() 693 setModal() 635
setLabel() 663 setMode() 507
setLabelAlignment() 459 setModel() 532
setLabeIТext() 647,654,663 setModelColumn() 536
setLandscapeOrientation() 745 setModelData() 549
setLayout() 452 setModified() 481,492
setLayoutDirection() 454 setMouseTracking() 440
setLayoutMode() 536 setMovaЬ!e() 467,686
setLeft() 394 setМovement() 536
setLeftMargin() 738 setMuted() 700,723
setLine() 581,618 setNamedColor() 576
setLineWidth() 465, setNameFilter() 654
setLineWrapColurnnOrWidth() 489 setNameFilters() 654
setLineWrapMode() 489 setNavigationBarVisiЬ!e() 505
setlocale() 112 setNotation() 485
setLoopCount() 723 setNotchesVisiЬ!e() 511
setLoops() 697 setNotchTarget() 511
setМargin() 477 setNull() 568
setMargins() 738 setNum() 476
setMarkdown() 491 setObjectName() 410
setMarkn() 486 setOctMode() 507
setMask() 407,596 setOffset() 620,624
setMaxCount() 518 setOkВuttonText() 647
setMaximum() 500,507,509,663 setOpacity() 615,626
setMaximumВlockCount() 493 setdpacityMask() 626
setMaximumDate() 502,504 setOpaqueResize() 472
setMaximumDateТime() 502 setOpenExtemalLinks() 476,498,622
setMaximumHeight() 386 setOpenLinks() 498
setMaximumSectionSize() 542 setOption() 648,653,666,693,694,740
setMaximumSize() 385 setOptions() 648,654,667,740
setMaximumTime() 502 setOrganizationName() 752
setMaximum Width() 385 setOrientation() 472,508,509,637,738,745
setMaxLength() 482 setOrientation(<Ориентация>) 685
setMaxVisiЬleltems() 518 setOutputFileName() 727
setMediaFormat() 711 setOutputFormat() 727
setMenu() 479,687 setOutputLocation() 711
setМenuBar() 671 setOverline() 585
setMenuWidget() 671 setOveпideCursor() 442,443
setMidLineWidth() 465 setOverwriteMode() 489
setМimeData() 444,449 setPl() 581
setMinimum() 500,507,509, 663 setP2() 582
setМinimumContentsLength() 518 setPage() 664
822 Предметный указатель
setPageLayout() 728,750 setRgb() 576,577
setPageMargins() 727, 750 setRgba() 577
setPageOrientation() 727,750 setRgbF() 577
setPageSize() 727,738,750 setRight() 394
setPageStep() 509 setRightMargin() 738
setPalette() 404 setRootlndex() 532
setPaperSource() 729 setRootlsDecorated() 541
setParent() 383 setRotation() 617
setParentltem() 617 setRowCount() 525,528
setPassword() 552 setRowHeight() 537
setPattemOptions() 493 setRowHidden() 537,538, 540
setPdfVersion() 750 setRowMinimumНeight() 457
setPen() 587,618,619 setRowStretch() 457
setPicture() 476 setRowWrapPolicy() 459
setPixel() 599 setRubberBandSelectionMode() 611
setPixe!Size() 584 setScale() 617
setPixmap() 380,444,448,476,620,666,668 setScaledContents() 476
setPlaceholderText() 482 setScene() 61О
setPlainText() 486,491,621 setSceneRect() 603,610
setPlaybackRate() 697 setSectionНidden() 542
setPoint() 583 setSectionResizeMode() 542
setPoints() 581,583 setSectionsClickaЫe() 543
setPointSize() 584 setSectionsMovaЫe() 543
setPointSizeF() 584 setSegmentStyle() 507
setPolygon() 619 setSelectaЬ!e() 531
setPopupMode() 687 setSelected() 616
setPort() 551 setSelectedDate() 504
setPortraitOrientation() 745 setSelectedSection() 503
setPos() 443,614 setSelection() 477,481
setPosition() 495,697 setSelectionArea() 607
setPrefix() 500 setSelectionBehavior() 533
setPrinterName() 727 setSelectionМode() 505, 532
setPrintRange() 728 setSelectionModel() 532
setPriority() 365,682 setSelectionRectVisiЫe() 536
setQuality() 711,720 setSeparator() 680
setQuery() 564 setSeparatorsCol\apsiЫe() 678
setQuitOnLastWindowClosed() 363 setShapeMode() 620
setRange() 500,507,509,663 setShortcut() 478,681
setReadOnly() 482,489, 500 setShortcutContext() 681
setRecord() 567 setShortcutEnaЫed() 436
setRecorder() 709 setShortcuts() 681
setRect() 395,619,620 setShowGrid() 539
setRecursiveFilteringEnaЫed() 547 setSidebarUrls() 654
setRed() 577 setSideWidget() 667
setRedF() 577 setSinglePageViewMode() 746
setRelation() 571 setSingleShot() 425
setRenderHint() 589,611 setSingleStep() 500,509
setRenderHints() 611 setSize() 395
setResizeMode() 536 setSizeAdjustPolicy() 518
setResolution() 720,729,750 setSizeGripEnaЫed() 635,690
setResult() 635 setSizePolicy() 461
setRetainSizeWhenНidden() 462 setSizes() 472
Предмет11ый указатель 823
setSliderPosition() 509 setТextAlignment() 530
setSmallDecima!Point() 507 setTextBackgroundColor() 491
setSort() 565 setTextColor() 491
setSortCaseSensitivity() 546 setTextCursor() 494,622
setSortingEnaЫed() 539, 541 setТextDirection() 508
setSortLocaleA ware() 546 setТextEchoMode() 647
setSortRole() 528,546 setTextElideMode() 533
setSource() 497,697,723 setТextFormat() 476,641 ··
setSourceModel() 546 setТextlnteractionFlags() 477,488,622
setSpacing() 455,457,459,536 setТextMargins() 482
setSpan() 538 setТexture() 581
setSpanAngle() 620 setТextureimage() 581
setSpecia!ValueText() 500 setТextValue() 647
setStackingМode() 460 setТextVisiЫe() 508
setStandardButtons() 637,641 setТextWidth() 622
setStartAngle() 620 setТickinterval() 51 О
setStartDragDistance() 443 setТickPosition() 51 О
setStartDragTime() 443 setТime() 502
setStartid() 664 setТimeRange() 502
setStatusBar() 671 setТimerType() 425
setStatusTip() 681 setТimeSpec() 502
setStickyFocus() 607
setТitle() 463,667,677,750
setStrength() 625
setTitleBarWidget() 688
setStretchFactor() 472
setTitleFormat() 665
setStretchLastSection() 542
setStrikeOut() 585 setТoo!ButtonStyle() 671,686,687
setStringList() 523 setТoo!Тip() 408,530,615,681,695
setStyle() 580,581 setТoo!ТipDuration() 408
setStyleSheet() 409 setТoo!ТipsVisiЫe() 678
setSubТitle() 667 setТop() 394
setSubTitleFormat() 665 setТopLeft() 394
setSuffix() 500 setТopMargin() 738
setSystemМenu() 693 setTopRight() 394
setТabBarAutoНide() 467 setTracking() 509
setТabChangesFocus() 490,622 setТransform() 593,616
setТabEnaЫed() 468 setТransformationМode() 621
setТaЫcon() 467 setТransformOriginPoint() 617
setTabKeyNavigation() 533 setТristate() 480
setTaЬ!e() 565 setUnderline() 584
setTabOrder() 433 setUndoRedoEnaЬ!ed() 487,492
setТabPosition() 467,673,692 setUniformitemSizes() 536
setTabsClosaЫe() 467,693 setUniformRowHeights() 540
setТabShape() 467,673,692 setUnits() 738
setТabsMovaЫe() 692 setUpdatesEnaЫed() 431
setТabStopDistance() 490 setupUi() 360
setTabText() 467 setUrl() 512
setТabToo!Tip() 467 setUrls() 446
setTabVisiЫe() 468 setUserName() 552
setTab WhatsThis() 468 setUserTristate() 531
setTearOffEnaЫed() 678 setUsesScrollButtons() 467
setter() 275 setValidator() 485,518
setТext() 445,448,475,478,481,486,530, setValue() 500, 507,508,567,662,753,755
621,640,680 SetValue() 342
824 Предметный указатель
SetValueEx() 341 shake_128() 129
setVertica!НeaderF ormat() 505 shake_256() 129
setVertica!Нeaderltem() 527 Shape 464
setVerticalНeaderLabels() 527 shape() 614
setVertica!Policy() 462 ShapeMode 620
setVertica!Scrol!BarPolicy() 474 shear() 593,613
setVertica!Spacing() 457,459 Shortcut 346,436
setVertica!Stretch() 462 ShortcutContext 435
setVideoBitRate() 711 shortcutld() 436
setVideoCodec() 713 show 39
setVideoFrameRate() 711 show() 380,383,616,635,695
setVideoOutput() 696,709 showColumn() 538,540
setVideoResolution() 711 showEvent() 429
setViewMode() 536,653,692,746 showFul!Screen() 399
setViewport() 592 showMaximized() 399
setVisiЫe() 383,616,635,676,682,684,695 showMenu() 479,687
setVolume() 700,723 showMessage() 380,661,690,695
setWeekdayTextFormat() 506 showMinimized() 399
setWeight() 584 showNextMonth() 505
setWhatsThis() 408,530,681 showNextYear() 505
setWidget() 473,688,693 showNorrnal() 399
setWidgetResizaЬle() 473 showPopup() 518
setWidth() 391,395,580 showPreviousMonth() 505
setWidthF() 580 showPreviousYear() 505
setWindow() 592 showRow() 538
setWindowFlags() 383 showSection() 542
setWindowlcon() 403 showSelectedDate() 505
setWindowModality() 401 showShaded() 694
setWindowOpacity() 401 showStatusText() 682
setWindowState() 399 showSystemМenu() 693
setWindowTitle() 383,640 showTearOffМenu() 678
setWizardStyle() 665 showToday() 505
setWordWrap() 476,536,539,541 shuffle() 90,165
setWordWrapMode() 489 . siЫing() 522
setWrapping() 500,511,536 siЫingAtColumn() 522
setX() 390,394,615 siЫingAtRow() 522
setXOffset() 624 signalsBlocked() 419
setY() 391,394,615 SimpleQueue 373
setYOffset() 624 sin() 88
setZoomFactor() 513,746 SingleHtm!SaveForrnat 515
setZoomMode() 746 singleShot() 426
setZValue() 615 size() 386,388,397,430,561,583,596,599,
shal () 129 736
sha224() 129 SizeAdjustPolicy 518
sha256() 129 sizeHint() 386
shaЗ _224() 129 SizeMatchPolicy 735
sha3_256() 129 SizeMode 588
sha3_384() 129 sizePixels() 736,737
shaЗ _512() 129 sizePoints() 737
sha384() 129 sizePolicy() 461
sha512()-129 sizes() 473
Shadow 465 sleep() 198,368
Предметный указатель 825
SliderAction 509 StatusTip 682
sliderMoved() 51О statusTip() 681
sliderPosition() 509 stderr 326
s\iderPressed() 51О stdin 35,326
sliderReleased() 51О . stdout 33,312,326
smoothSizes() 585 step 177
SordOrder 524 stepBy() 500
sort() 166,524,527,546 stepUp() 500
sortByColumn() 539,541 stickyFocus() 607
sortChildren() 531 stop 177
sorted() 167 stop() 425,513,697,712,723
source() 445,448,498; 631,697 Stoplteration 287
sourceChanged() 499,699 str 47
sourceModel() 546 str() 54,93,109,268
span() 144 strength() 625
spanAngle() 620 strengthChanged() 625
Spec 579 Stretch 666
spec() 579 strftime() 196,203,206,212
sp\it() 110,148,149,325 strikeOut() 585
sp\itDockWidget() 674 string 142
splitdrive() 326 StringlO 315
sp\itext() 326 stringList() 523
sp\it\ines() 111 stringValue() 705
splitterMoved() 473 strip() 109
spontaneous() 426 strptime() 196,209
sqrt() 88 struct_time 194,195
StackingMode 460 styles() 585
stackingМode() 460 sub() 146,147
Stacks 492 submit() 566
StandardButton 637,639 submitAll() 566
standardButton() 638,642 subn() 148
standardButtons() 638,642 subTitle() 668
StandardKey 438,681 subtitleTracks() 698
starmap() 181 subWindowActivated() 693
start 177 subWindowList() 691
start() 144,365,425,717 SubWindowOption 694
startAngle() 620 sum() 86
startDragDistance() 443 SUNDAY213
startDragTime() 443 super() 262
started() 365 supportedActions() 445
startld() 664 supportedAudioCodecs() 713
startswith() 116 supportedColorModes() 749
startTimer() 423 supportedFileFormats() 713
stat() 323,336 supportedlmageFormats() 403,594
stat result 324 supportedMimeTypes() 723 .
State 602 supportedPageSizes() 748
state() 748 supportedResolutions() 729,748
stateChanged() 480 supportedVideoCodecs() 713
Status 723,759 supportsCustomPageSizes() 748
status() 723,759 supportsMessages() 695
statusBar() 671 supportsMultipleCopies() 729
statusChanged() 724 swap() 597,737,738
826 Предметный ука3атель
swapcase() 114 TextFlag589
swapSections() 543 TextFormat476
symmetric_difference() 172 textНighlighted() 519
symmetric_difference_update() 172 TextinteractionFlag477,488
sync() 754 textValue() 647
SyntaxEпor287 textValueChanged() 648
SystemEпor287 textValueSelected() 648
systemМenu() 693 textWidth() 622
THURSDAY213
т TickPosition51 О
tileSubWindows() 692
tabBarC!icked() 468 time204
tabBarDouЫeClicked() 468 time() 194,210,502
tabCloseRequested() 468 timeChanged() 504
ТаЬЕттоr 287 timedelta198
taЬifiedDockWidgetActivated() 675 timegm() 219
taЬifiedDockWidgets()674 timeit() 220
taЬifyDockWidget() 674 timeout424
taЫeName() 565 TimeoutEпor337
taЫes() 552 Timer220
ТаЫеТуре 552 timerid() 423,425
TabPosition467,673 ТimerType423
tabPosition() 673,692 timerType() 425
TabShape467 TimeSpec502
tabShape() 673,692 timestamp() 210,440
tabStopDistance() 490 timetuple() 203,211
taЫext() 467 timetz() 21 О
takeChild() 530 tip() 682
takeColumn() 526,530 title() 114,463,512,667,677
takeitem() 526 titleBarWidget() 688
takeRow() 526,530 titleChanged() 514
takewhile() 180 tobytes() 319
takeWidget() 474 toCmyk() 579
tan() 88 today() 201,208
target() 445 toggle() 478,683
targetChanged() 445 toggled()464,479,683
task_done() 374 toggleViewAction() 686,689
tau88 toHsl() 579
tee() 183 toHsv() 579
.tell() 311,315 toHtml() 487,491,496,621
terminate() 370 toimage() 596
testOption() 693,694, 740 tolist() 319
text() 438,445,448,476,478,481,500, 507, toMarkdown()487,491
530,556,621,680 Too!ВarArea671,685
textActivated() 519 too!ВarArea() 671
textВackgroundColor() 491 too!ВarBreak() 672
TextCalendar213 Too!ВuttonPopupMode687
textChanged() 483,488,501 Too!ButtonStyle671
textColor() 491 too!ButtonStyle() 672,686,687
textCursor() 494,622 too!Tip() 408,681,695
textEdited() 483 too!TipDuration() 408
TextElideMode467 toordinal() 202,204,208,211
Предметный указатель 827
top() 397 union() 171
toPage() 728 unique 297
toPlainText() 487,491,496,621 Unit 727,730,736
topLeft() 397 united() 398
topLeve!Changed() 686,689 unlink() 322
topLeve!Item() 617 unlock() 376,379
topRight() 397 Unpickler 329
toPyDate() 501 unsetCursor() 442,616
toPyDateTime() 501 update() 129,171,192,331,431,534,609,
toPyTime() 502 618,623
toRgb() 579 updateEditorGeometry() 548
total_seconds() 200 updatePreview() 747
transaction() 552 updateScene() 614
transfoпn() 616 updateSceneRect() 614
TransfoпnationМode 597 upper() 113
transfoпned() 597,598,601 url() 512
translate() 117,396,592,612 ur!Changed() 515
translated() 396 urls() 446
transpose() 393 ur!Selected() 655
transposed() 393 urlsSelected() 655
trigger() 683 usleep() 368
triggered() 676,678,683,684,687 utcfromtimestamp() 208
triggerPageAction() 513 utcnow() 208
True 47 utctimetuple() 211
truncate() 311,318 utime() 324
try 279
tryLock() 376
TUESDAY 213
V
tuple 48 validateCurrentPage() 665
tuple() 55, 169 validatePage() 669
type 49 value 300
Туре 427 value() 500,507,508,561,567,578,663,704,
type() 52; 427,555, 556 754
TypeError 287 valueChanged() 501,508,510
tzinfo 205,207,209 ValueError 287
valueF() 579
u values() 190,330
vars() 227
UnbolindLoca!Error 287 VERВOSE 132
underline() 585 vertica!Нeader() 537
undo() 483,487,492 Vertica!HeaderFoпnat 505
undoAvailaЫe() 488, 494 vertica!Headerltem() 527
undoCommandAdded() 494 vertica!ScrollBar() 474
ungrabKeyboard() 616 VideoCodec 713
ungrabMouse() 616 videolnputs() 717
UNICODE 132 videoOutput() 697,71О
UnicodeDecodeError 287 videoTracks() 698
UnicodeEncodeError 287 ViewMode 536,653,692,746
UnicodeError 287 viewMode() 692,746
UnicodeTran�lationError 287 viewport() 592
unifoпn() 90 viewportEntered() 534
uninstall 40 views() 608
828 Предметный указатель
visibilityChanged()686,689 WizardButton 665
visitedlds()664 WizardOption 666
visualindex()543 WizardPixrnap 666
volume()700,723 WizardStyle 665
volumeChanged()700,724 WrapMode 489
writaЫe()308
w write()35,307,314,316
writelines()308,316
W ок 320
wait() 370
walk() 332
х
warning() 644 хо 388,390,397,615,679
wasCanceled()663 Х_ОК320
WebAction 513 xl()582
WEDNESDAУ 213 х2()582
weekday()204,211,219 xOffset()624
weekheader()218
weeks 199
Weight 584 у
weight()584 у()388,390,397,615,679
whatsThis()408,681 yl()582
wheelEvent() 441,628 у2()582
where 78 year 202,209
widget()460,468,470,473,688,693 yearShown()505
widgetForAction()685 yellow()578
widgetRemoved()460 yellowF()578
width()386,391,397,596,599,603 yield 236
window()592 yieldCuпentТhread()368
windowFlags()384 yOffset()624
windowlcon()403
WindowModality 401
windowModality()401 z
windowOpacity()401
ZeroDivisionEпor 287
WindowOrder 691
zfill()104
WindowState 399
zip()159,185
windowState()400
zip_longest()182
windowStateChanged()694
zoomFactor()513,747
windowTitle()383
zoomln()487,746
WindowType 383,384
ZoomMode 746
windowType() 384
zoomМode()746
winpath 344
zoomOut() 487,746
with 283
zValue()615
wizard() 667
Предметный указатель 829
А Делегат521, 547
◊ связанный573
Абсолютное позиционирование451 Делетер275
Автоблокировщик378 Десериализация128
Аккордеон469 Дескриптор313
Аннотация242 Деструктор261
Атрибут87,256, 257 Диапазон48,175
◊ закрытый259, 273
◊ класса259
◊ общедоступный259
з
◊ экземпляра объекта258 Заставка379
Захват фрагмента137
Звуковой эффект722
Б
Блок29
Блокировщик376
и
Блокнот465 Импорт243
◊ идентификатора246, 251
в ◊ модуля243
◊ модуля из пакета252,253
Валидатор485 Индекс 150
Ветвь338 Индикатор процесса328
Взаимная блокировка379 Инструкция26
Временная отметка194 ◊ ветвления65,68,71
Временной промежуток 198 ◊ выбора65,71
Всплывающая подсказка408 ◊ закомментированная 30
Вхождение 66 ◊ проверочная290
Вызов функции223, 228 Интерактивный режим24, 26,28,32, 257
Выражение26 Интерпретатор 21
Выражение-генератор157 Исключение278
◊ вторичное288
г ◊ первичное288
◊ пользовательское289
Генератор Исполняющая среда21
◊ множества175 Источник
◊ словаря193 ◊ сигнала414
◊ списка156 ◊ события414
Геттер274 Итератор157,292
Горячая клавиша435 Итерация29, 77
Графическая сцена603
Графическое представление603
Группа137,462
к
◊ именованная138 Каталог текущий рабочий306
Квантификатор136
д Клавиша быстрого доступа435
Класс87,256
Двоичные данные92 ◊ базовый261
Действие675· ◊ встроенный256
Декоратор ◊ пользовательский256
◊ класса276 ◊ производный261
◊ функции237 ◊ символов136
830 Предметный указатель
Ключ185,755
Ключевое слово46
н
Комментарий30 Наследование261
Компиляция44 ◊ множественное263
Конкатенация60 Невхождение66
◊ неявная98
Консоль 23
Конструктор260
о
Контейнер293,451 Обработка
◊ отображение293 ◊ исключения278
◊ последовательность293 ◊ события414
Контекст283 Обработчик
Копия ◊ исключений279
◊ поверхностная151 ◊ контекста283
◊ полная151 ◊ сигнала352,414
Кортеж48,169 ◊ собьпия352,414
Куст338 Обратная ссьmка138
Объект49,256,257,261
л ◊ текущий87
Окно
Логическая величина47 ◊ вложенное670
Локаль112 ◊ главное670
Лямбда-функция234 ◊ модальное401
м
Операнд57
Оператор28,57
◊ присваивания46,50
Маска прав доступа320 ◊ присваивания в составе инструкции80
Мастер663 ◊ пустой63
Менеджер контекста283
◊ сравнения66
Меню
Определение
◊ · главное675 ◊ класса256,259
◊ контекстное675
◊. функции222,229
Метасимвол133 Отображение48, 185
Метод87,256 Очередь372
◊ абстрактный272 Ошибка
◊ закрытый259,273 ◊ времени выполнения278
◊ класса272 ◊ логическая278
◊ общедоступный 259 ◊ синтаксическая278
◊ специальный266
◊ статический271
Множество48,170 п
◊ неизменяемое175 Пакет252
Модель521 Палитра404
◊ вьщеления521 Параметр26,222
◊ промежуточная521 ◊ двоякий229
Модуль26,243 ◊ именованный228
◊ встроенный243 ◊ необязательный230
◊ главный243 ◊ ПОЗИЦИОННЫЙ 228
Мьютекс376 ◊ строго именованный229
◊ строго позиционный229
Предметный указатель 831
Перегрузка оператора269
Перезагрузка251
с
Перекрытие метода261 Сборщик мусора781
Переменная27,46 Свойство274
◊ глобальная226,235 Сегмент пути305
◊ локальная 222,225 Секция677
Переопределение метода262 Сериализация128
Перехват исключения278 Сетка455
Перечисление296 Сеттер275
Подкласс261 Сигнал352,414
Подключение243 ◊ перегруженный422
Подрежим открытия файла302 ◊ пользовательский421
◊ бинарный303 Словарь48,185
◊ ДВОИЧНЫЙ 303 Слот352,414
◊ текстовый303
◊ перегруженный417
Последовательность48,150
Событие352,414
◊ непронумерованная150
◊ пользовательское450
◊ пронумерованная150
Поток основной365 Специальный символ92,94, 132
Потомок351 Список47,150
Представление521 ◊ вложенный151
Приемник ◊ многомерный 155
◊ сигнала414 Срез 97,153
◊ события414 Ссьmка49
Примесь265 Стандартная библиотека35,243
Приоритет операторов63 Стек372,460
Присваивание46,50 · Стопка452
◊ групповое50 Строка47,92
◊ позиционное51 ◊ длина97
Программа ◊ документирования30,94
◊ главная243 ◊ необрабатываемая95
◊ многопоточная365 ◊ форматируемая108
◊ оконная349 Суперкласс261
Процесс365
Псевдоним244
Путь т
◊ абсолютный306 Тело
◊ относительный306 ◊ функции222
◊ цикла77
Тип данных47
◊ изменяемый49
Размер150,185
Распаковка233 ◊ неизменяемый 50
Расширенная подсказка 408 Точечная нотация 244, 257
Регулярное выражение131 Транспорт709
\ Редактор547
Режим открытия файла302
Результат35
Рекурсия239 Указатель302
◊ проход240 Условие65
Репозиторий37
Родитель351
832 Предметный указатель
ф ц
Файл в памяти 315 ЦИЮI65
Форма 356,457 ◊ бесконечный 78
Функция 26, 222 ◊ обработки собьfГий 363
◊ анонимная 234 ◊ перебора последовательности 77
◊ вложенная 240 ◊ с условием 78
◊ встроенная 222
◊ генератор 236
◊ обратного вызова 233
ч
◊ пользовательская 222 Число
◊ родительская 240 ◊ вещественное 47,82,83
◊ специальная 249 ◊ восьмеричное 82
◊ двоичное 82
х ◊ десятичное 82
◊ комплексное 82,84
Хранилище настроек 752 ◊ целое 82
◊ шестнадцатеричное 82
э
Элемент 47, 150, 185,296,338
Вам также может понравиться
- Лернер Р Python Pandas На Практике 200 Упражнений По Анализу ДанныхОценок пока нетЛернер Р Python Pandas На Практике 200 Упражнений По Анализу Данных554 страницы
- ПРОЕКТИРОВАНИЕ СОБЫТИЙНО- ОРИЕНТИРОВАННЫХ СИСТЕМ Концепции и шаблоны проектирования сервисов потоковой обработки данных с использованием Apache Kafka Перевод с английского Иркутск ITSumma Press 2019Оценок пока нетПРОЕКТИРОВАНИЕ СОБЫТИЙНО- ОРИЕНТИРОВАННЫХ СИСТЕМ Концепции и шаблоны проектирования сервисов потоковой обработки данных с использованием Apache Kafka Перевод с английского Иркутск ITSumma Press 2019198 страниц
- Кальб Ирв Объектно ориентированное программирование с помощью Python100% (1)Кальб Ирв Объектно ориентированное программирование с помощью Python515 страниц
- Тони Гэддис - Начинаем Программировать На Python (5-е Изд) - 2022100% (1)Тони Гэддис - Начинаем Программировать На Python (5-е Изд) - 2022880 страниц
- Разработка веб-приложений Flask: на языке PythonОценок пока нетРазработка веб-приложений Flask: на языке Python25 страниц
- Свейгарт Эл Автоматизация рутинных задач с помощью Python, 2 е изд100% (1)Свейгарт Эл Автоматизация рутинных задач с помощью Python, 2 е изд674 страницы
- Райан Митчелл - Скрапинг Веб-сайтов с Помощью Python-2016Оценок пока нетРайан Митчелл - Скрапинг Веб-сайтов с Помощью Python-2016280 страниц
- Прохоренок Н.А., Дронов В.А. - Python 3. Самое необходимое - 2019 PDFОценок пока нетПрохоренок Н.А., Дронов В.А. - Python 3. Самое необходимое - 2019 PDF610 страниц
- Основы Программирования На Языке Python в Примерах и Задачах100% (1)Основы Программирования На Языке Python в Примерах и Задачах129 страниц
- ООП - на - Python - Учебное пособие - var5aОценок пока нетООП - на - Python - Учебное пособие - var5a49 страниц
- System Design Подготовка к Сложному Интервью Библиотека Программиста100% (1)System Design Подготовка к Сложному Интервью Библиотека Программиста304 страницы
- +Топ-20 Бесплатных Ресурсов Для Изучения PythonОценок пока нет+Топ-20 Бесплатных Ресурсов Для Изучения Python3 страницы
- Ш.Пауэрс - Изучаем Node. Переходим на сторону сервераОценок пока нетШ.Пауэрс - Изучаем Node. Переходим на сторону сервера304 страницы
- SQL I Relyatsionnaya Teoriya Kak Gramotno Pisat Kod Na SQL Rulit100% (1)SQL I Relyatsionnaya Teoriya Kak Gramotno Pisat Kod Na SQL Rulit474 страницы
- Бертран Мейер - Объектно-ориентированное Конструирование Программных Систем0% (1)Бертран Мейер - Объектно-ориентированное Конструирование Программных Систем768 страниц
- Основны программной инженерии - Лекции и курсовой проект - 2023Оценок пока нетОсновны программной инженерии - Лекции и курсовой проект - 2023172 страницы
- Зумштейн Ф. - Python Для Excel - 2023Оценок пока нетЗумштейн Ф. - Python Для Excel - 2023326 страниц
- Конструируем роботов на ScratchDuino. Первые шаги (PDFDrive)100% (1)Конструируем роботов на ScratchDuino. Первые шаги (PDFDrive)119 страниц
- Разработка Бэкенда На Python - Полное Руководство Для Начинающих - DataCampОценок пока нетРазработка Бэкенда На Python - Полное Руководство Для Начинающих - DataCamp15 страниц
- В. Усов - Swift. Основы Разработки Приложений Под IOS (Библиотека Программиста) - 2016Оценок пока нетВ. Усов - Swift. Основы Разработки Приложений Под IOS (Библиотека Программиста) - 2016304 страницы
- Алгоритмы, программирование и структуры данныхОценок пока нетАлгоритмы, программирование и структуры данных24 страницы
- Аарон Хиллегасс - Objective-C Программирование для iOS и MacOSОценок пока нетАарон Хиллегасс - Objective-C Программирование для iOS и MacOS300 страниц
- УКРОЩЕНИЕ БОЛЬШИХ ДАННЫХ. КАК ИЗВЛЕКАТЬ ЗНАНИЯ ИЗ МАССИВОВ ИНФОРМАЦИИ С ПОМОЩЬЮ ГЛУБОКОЙ АНАЛИТИКИОценок пока нетУКРОЩЕНИЕ БОЛЬШИХ ДАННЫХ. КАК ИЗВЛЕКАТЬ ЗНАНИЯ ИЗ МАССИВОВ ИНФОРМАЦИИ С ПОМОЩЬЮ ГЛУБОКОЙ АНАЛИТИКИ342 страницы
- Computer Science для программиста-самоучки. Все, что нужно знать о структурах данных и алгоритмах (2023) Кори Альтхофф100% (1)Computer Science для программиста-самоучки. Все, что нужно знать о структурах данных и алгоритмах (2023) Кори Альтхофф240 страниц
- Фишер Д., Ван Нин - Грокаем Стриминг (Библиотека Программиста) - 2023Оценок пока нетФишер Д., Ван Нин - Грокаем Стриминг (Библиотека Программиста) - 2023288 страниц
- Iskusstvennyy Intellekt Python Ozon PDFОценок пока нетIskusstvennyy Intellekt Python Ozon PDF23 страницы
- Zingaro D. Python Bez Problem - FragmentОценок пока нетZingaro D. Python Bez Problem - Fragment25 страниц
- Prohorenok N. Python I PyQt - FragmentОценок пока нетProhorenok N. Python I PyQt - Fragment30 страниц
- Python Django и Bootstrap Для Начинающих BssLGyОценок пока нетPython Django и Bootstrap Для Начинающих BssLGy626 страниц
- Php и Mysql. 25 Уроков Для Начинающих 2021Оценок пока нетPhp и Mysql. 25 Уроков Для Начинающих 2021434 страницы
- API Яндекс, Google и других популярных веб-сервисов. Готовые решения для вашего сайтаОценок пока нетAPI Яндекс, Google и других популярных веб-сервисов. Готовые решения для вашего сайта477 страниц
- Улли Соммер. Программирование. Микроконтроллерных Плат Arduino - Freeduino. Санкт-ПетербургОценок пока нетУлли Соммер. Программирование. Микроконтроллерных Плат Arduino - Freeduino. Санкт-Петербург239 страниц
- Qt 6 Разработка оконных приложений на C++Оценок пока нетQt 6 Разработка оконных приложений на C++506 страниц
- Разработка информационной системы медицинского учреждения с использованием современных информационных технологий управленияОценок пока нетРазработка информационной системы медицинского учреждения с использованием современных информационных технологий управления85 страниц
