屏保控件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
用途：屏保控件是在屏幕上显示屏幕保护程序的用户界面元素。它在设备长时间未操作时自动启动，显示动画、图像、时钟等内容，以保护屏幕和提供美观的视觉效果。

屏保控件的本质其实是一个 ``页面控件`` ， 可以在屏保控件页面上自由添加任何控件。

.. attention:: 
    一个工程中只能存在一个屏保控件！！！

属性
---------------------------------
.. image:: image/屏保/属性.png
    :align: center
    :alt: 屏保属性

|

**基础属性 :**  参考控件概念- :ref:`基础属性`

**坐标属性 :**  参考控件概念- :ref:`坐标属性`

**背景属性 :**  参考控件概念- :ref:`背景属性`

**特有属性 :**

.. image:: image/屏保/特有属性.png
    :align: center
    :alt: 屏保特有属性

|

- 唤醒源(trig) ：待机后唤醒方式，0-触摸屏幕，1-串口指令，2-两者均可（只读）
- 待机时间(time)：屏幕无任何动作待机时间，单位秒，范围：10-65535（只读）
- 背光亮度(bl)：待机厚背光亮度，范围：0-100（只读）

---------------------------------

事件
---------------------------------

**唤醒事件：** 屏保唤醒后执行

**待机事件：** 屏保待机后执行

.. attention:: 
    - 屏保唤醒后，不会执行页面初始化事件

-----------------------------------------


功能演示
---------------------------------

`点击下载演示工程 <http://www.openedv.com/ATK-Prod/ATK-HMI/file_download/wid_demo/project(wid_demo).zip>`_

|

.. tip:: 
    把工程配置的启动页面(pid)改为当前页面ID可以立即显示此页面。

|


使用屏保
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: image/屏保/屏保demo.png
    :align: center
    :alt: 屏保demo

|


- 功能：演示屏保功能
- 原理：添加一个屏保，当屏幕无触摸或者串口无数据时，会自动进入屏保页面。进入屏保会执行待机事件，退出屏保执行唤醒事件。

    1、新建一个页面, 在页面中创建 ``屏保控件``

    2、选择 ``屏保`` 控件， 并修改特有属性， ``唤醒源(trig)：两者均可`` 、 ``待机时间(time)：10`` 、 ``背光亮度：50`` 如下图所示

    .. image:: image/屏保/屏保控件demo.png
        :align: center
        :alt: 屏保控件demo

    3、在屏保控件的 ``唤醒事件`` 下，添加以下脚本

    .. code-block::
        :linenos:
    
        prints("屏保唤醒事件");
    
    4、在屏保控件的 ``待机事件`` 下，添加以下脚本

    .. code-block::
        :linenos:
    
        prints("屏保待机事件");