label_t

概述

文本控件。用于显示一行或多行文本。

文本控件不会根据文本的长度自动换行，只有文本内容包含换行符时才会换行。

如需自动换行请使用rich_text_t控件。

label_t是widget_t的子类控件，widget_t的函数均适用于label_t控件。

在xml中使用”label”标签创建文本控件。如：

 <label style="center" text="center"/>

更多用法请参考：label.xml

在c代码中使用函数label_create创建文本控件。如：

  widget_t* label = label_create(win, 10, 10, 128, 30);
  widget_set_text(label, L"hello awtk!");

创建之后，需要用widget_set_text或widget_set_text_utf8设置文本内容。

完整示例请参考：label demo

可用通过style来设置控件的显示风格，如字体的大小和颜色等等。如：

  <style name="left">
   <normal text_color="red" text_align_h="left" border_color="#a0a0a0" margin="4" />
  </style>

更多用法请参考：
theme default

函数

属性

label_cast 函数

• 函数功能：

转换为label对象(供脚本语言使用)。

• 函数原型：

widget_t* label_cast (widget_t* widget);

• 参数说明：

label_create 函数

• 函数功能：

创建label对象

• 函数原型：

widget_t* label_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);

• 参数说明：

label_resize_to_content 函数

• 函数功能：

根据文本内容调节控件大小。

• 函数原型：

ret_t label_resize_to_content (widget_t* widget, uint32_t min_w, uint32_t max_w, uint32_t min_h, uint32_t max_h);

• 参数说明：

label_set_length 函数

• 函数功能：

设置显示字符的个数(小余0时全部显示)。。

• 函数原型：

ret_t label_set_length (widget_t* widget, int32_t length);

• 参数说明：

length 属性

显示字符的个数(小余0时全部显示)。
主要用于动态改变显示字符的个数，来实现类似[拨号中…]的动画效果。

• 类型：int32_t