97 lines
2.6 KiB
Python
97 lines
2.6 KiB
Python
"""
|
|
Components/Screen
|
|
=================
|
|
|
|
:class:`~kivy.uix.screenmanager.Screen` class equivalent. Simplifies working
|
|
with some widget properties. For example:
|
|
|
|
Screen
|
|
------
|
|
|
|
.. code-block:: kv
|
|
|
|
Screen:
|
|
canvas:
|
|
Color:
|
|
rgba: app.theme_cls.primaryColor
|
|
RoundedRectangle:
|
|
pos: self.pos
|
|
size: self.size
|
|
radius: [25, 0, 0, 0]
|
|
|
|
MDScreen
|
|
--------
|
|
|
|
.. code-block:: kv
|
|
|
|
MDScreen:
|
|
radius: [25, 0, 0, 0]
|
|
md_bg_color: self.theme_cls.primaryColor
|
|
"""
|
|
|
|
from kivy.properties import ListProperty, ObjectProperty
|
|
from kivy.uix.screenmanager import Screen
|
|
|
|
from kivymd.theming import ThemableBehavior
|
|
from kivymd.uix import MDAdaptiveWidget
|
|
from kivymd.uix.behaviors import DeclarativeBehavior, BackgroundColorBehavior
|
|
from kivymd.uix.hero import MDHeroTo
|
|
|
|
|
|
class MDScreen(
|
|
DeclarativeBehavior,
|
|
ThemableBehavior,
|
|
BackgroundColorBehavior,
|
|
Screen,
|
|
MDAdaptiveWidget,
|
|
):
|
|
"""
|
|
Screen is an element intended to be used with a
|
|
:class:`~kivymd.uix.screenmanager.MDScreenManager`.
|
|
|
|
For more information see in the
|
|
:class:`~kivymd.uix.behaviors.declarative_behavior.DeclarativeBehavior` and
|
|
:class:`~kivymd.theming.ThemableBehavior` and
|
|
:class:`~kivymd.uix.behaviors.backgroundcolor_behavior.BackgroundColorBehavior` and
|
|
:class:`~kivy.uix.screenmanager.Screen` and
|
|
:class:`~kivymd.uix.MDAdaptiveWidget`
|
|
classes documentation.
|
|
"""
|
|
|
|
hero_to = ObjectProperty(deprecated=True)
|
|
"""
|
|
Must be a :class:`~kivymd.uix.hero.MDHeroTo` class.
|
|
|
|
See the documentation of the
|
|
`MDHeroTo <https://kivymd.readthedocs.io/en/latest/components/hero/>`_
|
|
widget for more detailed information.
|
|
|
|
.. deprecated:: 1.0.0
|
|
Use attr:`heroes_to` attribute instead.
|
|
|
|
:attr:`hero_to` is an :class:`~kivy.properties.ObjectProperty`
|
|
and defaults to `None`.
|
|
"""
|
|
|
|
heroes_to = ListProperty()
|
|
"""
|
|
Must be a list of :class:`~kivymd.uix.hero.MDHeroTo` class.
|
|
|
|
.. versionadded:: 1.0.0
|
|
|
|
:attr:`heroes_to` is an :class:`~kivy.properties.LiatProperty`
|
|
and defaults to `[]`.
|
|
"""
|
|
|
|
def on_hero_to(self, screen, widget: MDHeroTo) -> None:
|
|
"""Fired when the value of the :attr:`hero_to` attribute changes."""
|
|
|
|
if not isinstance(widget, MDHeroTo) or not issubclass(
|
|
widget.__class__, MDHeroTo
|
|
):
|
|
raise TypeError(
|
|
f"The `{widget}` widget must be an `kivymd.uix.hero.MDHeroTo` "
|
|
f"class or inherited from this class"
|
|
)
|
|
self.heroes_to = [widget]
|