日历(lv_calendar):

Calendar对象是经典的日历,可以:

  • 突出显示当天
  • 突出显示任何用户定义的日期
  • 显示日期名称
  • 单击按钮进入下一个/上一个月
  • 突出显示点击的日子

零件和样式

日历的主要部分称为 LV_CALENDAR_PART_BG 。它使用典型的背景样式属性绘制背景。

除以下虚拟部分外:

  • LV_CALENDAR_PART_HEADER 显示当前年和月名称的上部区域。它还具有用于移动下一个/上个月的按钮。它使用典型的背景属性以及填充来调整其大小和边距,以设置距日历顶部的距离和日历下方的日期。
  • LV_CALENDAR_PART_DAY_NAMES 在标题下方显示日期名称。它使用文本样式属性填充来与背景(左,右),标题(上)和日期(下)保持一定距离。
  • LV_CALENDAR_PART_DATES 显示从1..28 / 29/30/31开始的日期数字(取决于当月)。根据本部分中定义的状态来绘制状态的不同“状态”:
  • 正常日期:以 LV_STATE_DEFAULT 样式绘制
  • 按日期范围:以 LV_STATE_PRESSED 样式绘制
  • 今天:以 LV_STATE_FOCUSED 样式绘制
  • 高亮显示的日期:以 LV_STATE_CHECKED 样式绘制

用法

概述

要在日历中设置和获取日期,使用 lv_calendar_date_t 类型,该类型是具有  ,  和  字段的结构。

当前日期

要设置当前日期(今天),请使用 lv_calendar_set_today_date(calendar, &today_date) 函数。

显示日期

要设置显示日期,请使用 lv_calendar_set_shown_date(calendar, &shown_date) ;

高亮日期

高亮显示的日期列表应存储在由 lv_calendar_set_highlighted_dates(calendar, &highlighted_dates) 加载的 lv_calendar_date_t 数组中。

仅将保存数组指针,因此数组应为静态或全局变量。

日期名称

可以使用 lv_calendar_set_day_names(calendar, day_names) 来调整日期的名称,其中 day_names 类似于 const char * day_names[7] = {"Su", "Mo", ...};

月份名称

与 day_names 相似,可以使用 lv_calendar_set_month_names(calendar, month_names_array) 设置月份名称。

事件

除了 通用事件 外,日历还会发送以下特殊事件:当当前月份更改时,还会发送 LV_EVENT_VALUE_CHANGED 。

在与输入设备相关的事件中, lv_calendar_get_pressed_date(calendar) 指示当前正在按下的日期,如果没有按下任何日期,则返回 NULL 。