mirror of
https://github.com/lvgl/lvgl.git
synced 2025-01-14 06:42:58 +08:00
65 lines
1.6 KiB
ReStructuredText
65 lines
1.6 KiB
ReStructuredText
Tile view (lv_tileview)
|
|
=======================
|
|
|
|
Overview
|
|
********
|
|
|
|
The Tile view is a container object whose elements (called *tiles*) can
|
|
be arranged in grid form. A user can navigate between the tiles by
|
|
swiping. Any direction of swiping can be disabled on the tiles
|
|
individually to not allow moving from one tile to another.
|
|
|
|
If the Tile view is screen sized, the user interface resembles what you
|
|
may have seen on smartwatches.
|
|
|
|
Parts and Styles
|
|
****************
|
|
|
|
The Tile view is built from an `lv_obj </widgets/obj>`__ container and
|
|
`lv_obj </widgets/obj>`__ tiles.
|
|
|
|
The parts and styles work the same as for `lv_obj </widgets/obj>`__.
|
|
|
|
Usage
|
|
*****
|
|
|
|
Add a tile
|
|
----------
|
|
|
|
:cpp:expr:`lv_tileview_add_tile(tileview, row_id, col_id, dir)` creates a new
|
|
tile on the ``row_id``\ th row and ``col_id``\ th column. ``dir`` can be
|
|
``LV_DIR_LEFT/RIGHT/TOP/BOTTOM/HOR/VER/ALL`` or OR-ed values to enable
|
|
moving to the adjacent tiles into the given direction by swiping.
|
|
|
|
The returned value is an ``lv_obj_t *`` on which the content of the tab
|
|
can be created.
|
|
|
|
Change tile
|
|
-----------
|
|
|
|
The Tile view can scroll to a tile with
|
|
:cpp:expr:`lv_obj_set_tile(tileview, tile_obj, LV_ANIM_ON/OFF)` or
|
|
:cpp:expr:`lv_obj_set_tile_id(tileview, col_id, row_id, LV_ANIM_ON/OFF)`
|
|
|
|
Events
|
|
******
|
|
|
|
- :cpp:enumerator:`LV_EVENT_VALUE_CHANGED` Sent when a new tile loaded by scrolling.
|
|
:cpp:expr:`lv_tileview_get_tile_act(tabview)` can be used to get current
|
|
tile.
|
|
|
|
Keys
|
|
****
|
|
|
|
*Keys* are not handled by the Tile view.
|
|
|
|
Learn more about :ref:`indev_keys`.
|
|
|
|
Example
|
|
*******
|
|
|
|
.. include:: ../examples/widgets/tileview/index.rst
|
|
|
|
API
|
|
***
|