mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-05 21:49:13 +08:00
14 KiB
14 KiB
system_info_t
概述
当前系统的信息。
函数
函数名称 | 说明 |
---|---|
system_info | 获取system_info对象。 |
system_info_create | 创建system_info对象。 |
system_info_deinit | 释放system_info对象。 |
system_info_fix_font_name | 修正字体名称,如果为NULL,返回缺省字体。 |
system_info_init | 初始化system_info对象。 |
system_info_set_app_root | 设置app root。 |
system_info_set_default_font | 设置缺省字体。 |
system_info_set_device_pixel_ratio | 设置LCD密度。 |
system_info_set_font_scale | 设置字体缩放比例。 |
system_info_set_keyboard_type | 设置键盘类型。 |
system_info_set_lcd_h | 设置LCD高度。 |
system_info_set_lcd_orientation | 设置LCD的旋转角度。 |
system_info_set_lcd_type | 设置LCD类型。 |
system_info_set_lcd_w | 设置LCD宽度。 |
属性
属性名称 | 类型 | 说明 |
---|---|---|
app_name | const char* | 应用程序的名称。 |
app_root | char* | 应用程序的根目录,用于定位资源文件。 |
app_type | app_type_t | 应用程序的类型。 |
country | const char* | locale中的国家。 |
default_font | const char* | 缺省字体。 |
device_orientation | const char* | 显示屏的方向名称,可选值:"portrait"表示竖屏,"landscape"表示横屏。 |
device_pixel_ratio | float_t | 显示屏的密度。 |
flags | uint32_t | 标志。请参考{system_info_flag_t}。 |
font_scale | float_t | 字体缩放比例,用于实现字体整体放大。 |
keyboard_type | keyboard_type_t | 键盘类型。 |
language | const char* | locale中的语言。 |
lcd_h | uint32_t | 显示屏的高度。 |
lcd_orientation | lcd_orientation_t | 显示屏的旋转角度。 |
lcd_type | lcd_type_t | 显示屏的类型。 |
lcd_w | uint32_t | 显示屏的宽度。 |
system_info 函数
- 函数功能:
获取system_info对象。
- 函数原型:
system_info_t* system_info ();
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | system_info_t* | 返回system_info对象。 |
system_info_create 函数
- 函数功能:
创建system_info对象。
- 函数原型:
system_info_t* system_info_create (app_type_t app_type, const char* app_name, const char* app_root);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | system_info_t* | 返回创建的对象指针。 |
app_type | app_type_t | 应用程序的类型。 |
app_name | const char* | 应用程序的名称。 |
app_root | const char* | 应用程序的根目录,用于定位资源文件。 |
system_info_deinit 函数
- 函数功能:
释放system_info对象。
- 函数原型:
ret_t system_info_deinit ();
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
system_info_fix_font_name 函数
- 函数功能:
修正字体名称,如果为NULL,返回缺省字体。
- 函数原型:
const char* system_info_fix_font_name (const char* name);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | const char* | 返回有效的字体名称。 |
name | const char* | 字体名称。 |
system_info_init 函数
- 函数功能:
初始化system_info对象。
- 函数原型:
ret_t system_info_init (app_type_t app_type, const char* app_name, const char* app_root);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
app_type | app_type_t | 应用程序的类型。 |
app_name | const char* | 应用程序的名称。 |
app_root | const char* | 应用程序的根目录,用于定位资源文件。 |
system_info_set_app_root 函数
- 函数功能:
设置app root。
- 函数原型:
ret_t system_info_set_app_root (system_info_t* info, const char* app_root);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
app_root | const char* | app root。 |
system_info_set_default_font 函数
- 函数功能:
设置缺省字体。
- 函数原型:
ret_t system_info_set_default_font (system_info_t* info, const char* default_font);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
default_font | const char* | 缺省字体。 |
system_info_set_device_pixel_ratio 函数
- 函数功能:
设置LCD密度。
- 函数原型:
ret_t system_info_set_device_pixel_ratio (system_info_t* info, float_t device_pixel_ratio);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
device_pixel_ratio | float_t | 设置LCD密度。 |
system_info_set_font_scale 函数
- 函数功能:
设置字体缩放比例。
- 函数原型:
ret_t system_info_set_font_scale (system_info_t* info, float_t font_scale);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
font_scale | float_t | 字体缩放比例。 |
system_info_set_keyboard_type 函数
- 函数功能:
设置键盘类型。
- 函数原型:
ret_t system_info_set_keyboard_type (system_info_t* info, keyboard_type_t keyboard_type);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
keyboard_type | keyboard_type_t | 键盘类型。 |
system_info_set_lcd_h 函数
- 函数功能:
设置LCD高度。
- 函数原型:
ret_t system_info_set_lcd_h (system_info_t* info, uint32_t lcd_h);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
lcd_h | uint32_t | 设置LCD高度。 |
system_info_set_lcd_orientation 函数
- 函数功能:
设置LCD的旋转角度。
- 函数原型:
ret_t system_info_set_lcd_orientation (system_info_t* info, lcd_orientation_t lcd_orientation);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
lcd_orientation | lcd_orientation_t | 设置LCD的旋转角度。 |
system_info_set_lcd_type 函数
- 函数功能:
设置LCD类型。
- 函数原型:
ret_t system_info_set_lcd_type (system_info_t* info, lcd_type_t lcd_type);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
lcd_type | lcd_type_t | 设置LCD类型。 |
system_info_set_lcd_w 函数
- 函数功能:
设置LCD宽度。
- 函数原型:
ret_t system_info_set_lcd_w (system_info_t* info, uint32_t lcd_w);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
info | system_info_t* | system_info对象。 |
lcd_w | uint32_t | 设置LCD宽度。 |
app_name 属性
应用程序的名称。
- 类型:const char*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
app_root 属性
应用程序的根目录,用于定位资源文件。
- 类型:char*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
app_type 属性
应用程序的类型。
- 类型:app_type_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
country 属性
locale中的国家。
只能通过object_get_prop函数访问。
- 类型:const char*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
default_font 属性
缺省字体。
- 类型:const char*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
device_orientation 属性
显示屏的方向名称,可选值:"portrait"表示竖屏,"landscape"表示横屏。
只能通过object_get_prop函数访问。
- 类型:const char*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
device_pixel_ratio 属性
显示屏的密度。
- 类型:float_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
flags 属性
标志。请参考{system_info_flag_t}。
- 类型:uint32_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
font_scale 属性
字体缩放比例,用于实现字体整体放大。
- 类型:float_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
keyboard_type 属性
键盘类型。
- 类型:keyboard_type_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
language 属性
locale中的语言。
只能通过object_get_prop函数访问。
- 类型:const char*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
lcd_h 属性
显示屏的高度。
- 类型:uint32_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
lcd_orientation 属性
显示屏的旋转角度。
- 类型:lcd_orientation_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
lcd_type 属性
显示屏的类型。
- 类型:lcd_type_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
lcd_w 属性
显示屏的宽度。
- 类型:uint32_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |