mirror of
https://github.com/lvgl/lvgl.git
synced 2025-01-14 06:42:58 +08:00
53 lines
1.2 KiB
ReStructuredText
53 lines
1.2 KiB
ReStructuredText
|
Button (lv_btn)
|
||
|
|
===============
|
||
|
|
|
||
|
|
Overview
|
||
|
|
********
|
||
|
|
|
||
|
|
Buttons have no new features compared to the `Base
|
||
|
|
object </widgets/obj>`__. They are useful for semantic purposes and have
|
||
|
|
slightly different default settings.
|
||
|
|
|
||
|
|
Buttons, by default, differ from Base object in the following ways: -
|
||
|
|
Not scrollable - Added to the default group - Default height and width
|
||
|
|
set to :cpp:enumerator:`LV_SIZE_CONTENT`
|
||
|
|
|
||
|
|
Parts and Styles
|
||
|
|
****************
|
||
|
|
|
||
|
|
- :cpp:enumerator:`LV_PART_MAIN` The background of the button. Uses the typical
|
||
|
|
background style properties.
|
||
|
|
|
||
|
|
Usage
|
||
|
|
*****
|
||
|
|
|
||
|
|
There are no new features compared to `Base object </widgets/obj>`__.
|
||
|
|
|
||
|
|
Events
|
||
|
|
******
|
||
|
|
|
||
|
|
- :cpp:enumerator:`LV_EVENT_VALUE_CHANGED` when the :cpp:enumerator:`LV_OBJ_FLAG_CHECKABLE` flag is
|
||
|
|
enabled and the object is clicked. The event happens on transition
|
||
|
|
to/from the checked state.
|
||
|
|
|
||
|
|
Learn more about :ref:`events`.
|
||
|
|
|
||
|
|
Keys
|
||
|
|
****
|
||
|
|
|
||
|
|
Note that the state of :cpp:enumerator:`LV_KEY_ENTER` is translated to
|
||
|
|
:cpp:enumerator:`LV_EVENT_PRESSED`, :cpp:enumerator:`LV_EVENT_PRESSING`
|
||
|
|
and :cpp:enumerator:`LV_EVENT_RELEASED` etc.
|
||
|
|
|
||
|
|
See the events of the `Base object </widgets/obj>`__ too.
|
||
|
|
|
||
|
|
Learn more about :ref:`indev_keys`.
|
||
|
|
|
||
|
|
Example
|
||
|
|
*******
|
||
|
|
|
||
|
|
.. include:: ../examples/widgets/btn/index.rst
|
||
|
|
|
||
|
|
API
|
||
|
|
***
|