Embedded/lvgl
1
0
Fork 0
mirror of https://github.com/lvgl/lvgl.git synced 2025-01-28 07:03:00 +08:00
Code Issues Projects Releases Wiki Activity

docs(event): minor naming fixes (#6939)

Browse Source
This commit is contained in:
Gabor Kiss-Vamosi 2024-09-26 11:16:48 +02:00 committed by GitHub
parent 40577fe685
commit 99b2061d5b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/overview/event.rst
View File

@ -13,6 +13,8 @@ interesting to the user, e.g. when an object:
- is redrawn, etc. - is redrawn, etc.
Besides widgets, events can registered from displays and input devices too. Besides widgets, events can registered from displays and input devices too.
It's not detailed below, however the same applies to displays and indevs as well
by changing the prefix of the functions from ``lv_obj_`` to ``lv_display_`` or ``lv_indev_``.
Add events to a widget Add events to a widget
********************** **********************
@ -188,11 +190,11 @@ Display events
Custom events Custom events
------------- -------------
Any custom event codes can be registered by Any number of custom event codes can be registered by
``uint32_t MY_EVENT_1 =`` :cpp:func:`lv_event_register_id` ``uint32_t MY_EVENT_1 =`` :cpp:func:`lv_event_register_id`
They can be sent to any object with They can be sent to any objects with
:cpp:expr:`lv_event_send(obj, MY_EVENT_1, &some_data)` :cpp:expr:`lv_obj_send_event(obj, MY_EVENT_1, &some_data)`
Sending events Sending events
************** **************
@ -207,7 +209,7 @@ simulating a button press (although there are simpler ways to do this):
/*Simulate the press of the first button (indexes start from zero)*/ /*Simulate the press of the first button (indexes start from zero)*/
uint32_t btn_id = 0; uint32_t btn_id = 0;
lv_event_send(mbox, LV_EVENT_VALUE_CHANGED, &btn_id); lv_obj_send_event(mbox, LV_EVENT_VALUE_CHANGED, &btn_id);
The same works for display and input devices with The same works for display and input devices with
:cpp:expr:`lv_display_send_event(obj, <EVENT_CODE>, &some_data)` and :cpp:expr:`lv_display_send_event(obj, <EVENT_CODE>, &some_data)` and
@ -234,7 +236,7 @@ contains all data about the event. The following values can be gotten from it:
- :cpp:expr:`lv_event_get_current_target(e)`: get the object to which an event was sent. I.e. the object whose event handler is being called. - :cpp:expr:`lv_event_get_current_target(e)`: get the object to which an event was sent. I.e. the object whose event handler is being called.
- :cpp:expr:`lv_event_get_target(e)`: get the object that originally triggered the event (different from :cpp:func:`lv_event_get_target` if :ref:`event bubbling <events_bubbling>` is enabled) - :cpp:expr:`lv_event_get_target(e)`: get the object that originally triggered the event (different from :cpp:func:`lv_event_get_target` if :ref:`event bubbling <events_bubbling>` is enabled)
- :cpp:expr:`lv_event_get_user_data(e)`: get the pointer passed as the last parameter of :cpp:func:`lv_obj_add_event`. - :cpp:expr:`lv_event_get_user_data(e)`: get the pointer passed as the last parameter of :cpp:func:`lv_obj_add_event`.
- :cpp:expr:`lv_event_get_param(e)`: get the parameter passed as the last parameter of :cpp:func:`lv_event_send` - :cpp:expr:`lv_event_get_param(e)`: get the parameter passed as the last parameter of :cpp:func:`lv_obj_send_event`
.. _events_bubbling: .. _events_bubbling: