blob: c4fc33b1fddccc07c28d76b0a31cc1d8a9c1acd4 (
plain)
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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
.. _lv_button:
==================
Button (lv_button)
==================
Overview
********
Buttons have no new features compared to the :ref:`Base object <lv_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`
.. _lv_button_parts_and_styles:
Parts and Styles
****************
- :cpp:enumerator:`LV_PART_MAIN` The background of the button. Uses the typical
background style properties.
.. _lv_button_usage:
Usage
*****
There are no new features compared to :ref:`Base object <lv_obj>`.
.. _lv_button_events:
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`.
.. _lv_button_keys:
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 :ref:`Base object <lv_obj>` too.
Learn more about :ref:`indev_keys`.
.. _lv_button_example:
Example
*******
.. include:: ../examples/widgets/button/index.rst
.. _lv_button_api:
API
***
|
