Как ни странно, в офф документации (может не открыться из-за vpn) я не нашел описания класса Window. Оказалось, что это не обычный класс, результат следующей функции `Window = core_select_lib(‘window’, window_impl, True)`, вызываемой в пространстве kivy.core.window.
Авторы фреймворка советуют описаться на базовый класс:
class kivy.core.window.
WindowBase
(**kwargs)
Наследован от kivy.event.EventDispatcher
.
Абстрактный виджет окна для любой реализации окна. (обратите внимание, виджет! — примечание переводчика)
Параметры конструктора:
- borderless: str, one of (‘0’, ‘1’) — устанавливает состояние границы окна
- fullscreen: str, one of (‘0’, ‘1’, ‘auto’, ‘fake’)
- width: int — ширина окна
- height: int — высота окна
- minimum_width: int — минимальная ширина окна
- minimum_height: int — минимальная высота окна
- allow_screensaver: bool — Разрешить устройству показывать экранную заставку или переходить в спящий режим на мобильных устройствах. По умолчанию установлено значение True. Работает только для поставщика окон sdl2.
События:
- on_motion: etype, motionevent — Fired when a new MotionEvent is dispatched
- on_touch_down: Срабатывает при инициировании нового события касания
- on_touch_move: Срабатывает при изменении местоположения существующего события касания
- on_touch_up: Срабатывает при завершении существующего события касания.
- on_draw: срабатывает при прорисовке окна
- on_flip: срабатывает когда поверхность GL окна переворачивается
- on_rotate: rotation — Срабатывает при повороте окна.
- on_close: срабатывает, когда окно закрыто
- on_request_close: Срабатывает, когда цикл событий хочет закрыть окно, или если клавиша escape нажата и exit_on_escape имеет значение True. Если функция, привязанная к этому событию, возвращает True, окно не будет закрыто. Если событие инициируется из-за клавиши escape клавиатуры, источник аргумента ключевого слова отправляется вместе со значением клавиатуры связанным функциям.
- on_cursor_enter: Срабатывает, когда курсор входит в окно.
- on_cursor_leave: Срабатывает, когда курсор покидает окно.
- on_minimize: срабатывает, когда окно сворачивается
- New in version 1.10.0: on_maximize: срабатывает, когда окно разворачивается
- New in version 1.10.0: on_restore: Срабатывает при восстановлении окна.
- New in version 1.10.0: on_hide: срабатывает, когда окно скрыто
- New in version 1.10.0: on_show: Срабатывает, когда отображается окно.
- New in version 1.10.0: on_keyboard: key, scancode, codepoint, modifier — Срабатывает, когда клавиатура используется для ввода.
- on_key_down: key, scancode, codepoint, modifier — Fired when a key pressed.
- on_key_up: key, scancode, codepoint — Срабатывает при отпускании кнопки.
- on_dropfile: str — Срабатывает при перетаскивании файла в приложении.
- on_memorywarning: Fired when the platform have memory issue (iOS / Android mostly) You can listen to this one, and clean whatever you can.
- on_textedit(self, text): срабатывает при вводе с IME. В качестве параметра этого события задается строка, вводимая с помощью IME.
Атрибуты:
add_widget
(widget, canvas=None)allow_screensaver
-Включена ли заставка, или на мобильных устройствах, разрешено ли устройству спать, пока приложение открыто.borderless
— Если установлено значение True,это свойство удаляет границу окна/оформление.center
— Center of the rotated window.children
— List of the children of this window.clear
() — Clear the window with the background colorclearcolor()
— Цвет, используемый для очистки окна.
from kivy.core.window import Window # red background color Window.clearcolor = (1, 0, 0, 1) # don't clear background at all Window.clearcolor = None
clearcolor is an AliasProperty and defaults to (0, 0, 0, 1).
close
() — закрывает окноcreate_window
(*largs) — Создает главное окно и настраивает его. (This method is called automatically at runtime. If you call it, it will recreate a RenderContext and Canvas. This means you’ll have a new graphics tree, and the old one will be unusable.This method exist to permit the creation of a new OpenGL context AFTER closing the first one. (Like using runTouchApp() and stopTouchApp()).
This method has only been tested in a unittest environment and is not suitable for Applications.
Again, don’t use this method unless you know exactly what you are doing)
dpi
() — Вернуть разрешение экрана. Если реализация не поддерживает поиск DPI, она просто вернет 96. (Это значение не является кросс-платформенным. Используйте киви.основа.EventLoop.dpi вместо этого)flip
() — Переключается между buffersfocus
— Проверяет, имеет ли окно в данный момент фокус. focus является свойством псевдонима только для чтения и по умолчанию имеет значение True.fullscreen
— Это свойство задает полноэкранный режим окна. Доступные опции: True, False, ‘auto’ и ‘fake’. Проверьте документацию по конфигурации для получения более подробных объяснений по этим значениям.get_gl_backend_name
() — Возвращает серверную часть gl, которая будет или используется с этим окном.gl_backends_allowed
= [] — Список имен бэкендов Kivy gl, которые если не пусты, то будут эксклюзивным списком бэкендов gl, которые можно использовать с этим окном.height
— меняет высоту окнаicon
— путь к иконке окнаmodifiers
— Список модификаторов клавиатуры, которые в настоящее время активны.on_close
(*largs) — происходит, когда окно закрываетсяon_cursor_enter
(*largs) — происходит. когда курсор попадает в область окнаon_cursor_leave
(*largs) — когда покидаетon_key_down
(key, scancode=None, codepoint=None, modifier=None, **kwargs)on_key_up
(key, scancode=None, codepoint=None, modifier=None, **kwargs)on_motion
(etype, me) — etype — строка, имеющая одно из значений: ‘begin’, ‘update’, ‘end’, me — MotionEvent
on_mouse_down
(x, y, button, modifiers)on_mouse_move
(x, y, modifiers)on_mouse_up
(x, y, button, modifiers)on_request_close
(*largs, **kwargs) — Событие вызывается перед закрытием окна. Если связанная функция возвращает True, окно не будет закрыто. Если событие инициируется из-за клавиши escape клавиатуры, источник аргумента ключевого слова отправляется вместе со значением клавиатуры связанным функциям.on_resize
(width, height) — Событие вызывается при изменении размера окна.on_rotate
(rotation) — Событие вызывается при повороте экрана.parent
— Родитель этого окна (by default=None).screenshot
(name=’screenshot{:04d}.png’) — сохраняет фактическое отображаемое изображение в файл.set_icon
(filename) — устанавливает новую иконку окнаset_title
(title) — устанавливает заголовок окнаshape_image
— Изображение для формы окна (работает только для поставщика окон sdl2). Размеры изображения должны совпадать с размерами окна.shaped
— Свойство только для чтения, чтобы проверить, является ли окно формируемым или нет (работает только для поставщика окон sdl2).softinput_mode
— Это определяет поведение содержимого окна при отображении программной клавиатуры на мобильных платформах. Это может быть один из ‘, ‘pan’, ‘scale’, ‘resize’ или ‘below_target’. Их последствия перечислены ниже.system_size
— Реальный размер окна, игнорируя вращение