Button (lv_btn)

Overview

Buttons have no new features compared to the Base object. 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 LV_SIZE_CONTENT

Parts and Styles

  • LV_PART_MAIN The background of the button. Uses the typical background style properties.

Usage

There are no new features compared to Base object.

Events

  • LV_EVENT_VALUE_CHANGED when the 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 Events.

Keys

Note that the state of LV_KEY_ENTER is translated to LV_EVENT_PRESSED/PRESSING/RELEASED etc.

See the events of the Base object too.

Learn more about Keys.

Example

API

Functions

lv_obj_t *lv_btn_create(lv_obj_t *parent)

Create a button object

Parameters

parent -- pointer to an object, it will be the parent of the new button

Returns

pointer to the created button

Variables

const lv_obj_class_t lv_btn_class
struct lv_btn_t

Public Members

lv_obj_t obj