awtk/docs/manual/locale_info_t.md

locale_info_t

概述

本地化信息。提供字符串翻译数据管理，当前语言改变的事件通知等等。

---

函数

函数名称	说明
locale_info	获取缺省locale_info。
locale_info_change	设置当前的国家和语言。
locale_info_create	创建locale_info。
locale_info_deinit	释放全部资源。
locale_info_destroy	释放全部资源并销毁locale_info对象。
locale_info_init	初始化locale_info。
locale_info_off	注销指定事件的处理函数。
locale_info_on	注册指定事件的处理函数。
locale_info_set	设置缺省locale_info。
locale_info_tr	翻译字符串。

属性

名属性称	类型	说明
country;	char*	国家或地区。如：CN
language	char*	语言。如：zh

locale_info 函数

---

• 函数功能：

获取缺省locale_info。

• 函数原型：

locale_info_t* locale_info ();

• 参数说明：

参数	类型	说明
返回值	locale_info_t*	返回locale_info对象。

locale_info_change 函数

---

• 函数功能：

设置当前的国家和语言。

• 函数原型：

ret_t locale_info_change (locale_info_t* locale_info, char* language, char* country);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
locale_info	locale_info_t*	locale_info对象。
language	char*	语言。
country	char*	国家或地区。

locale_info_create 函数

---

• 函数功能：

创建locale_info。

• 函数原型：

locale_info_t* locale_info_create (char* language, char* country);

• 参数说明：

参数	类型	说明
返回值	locale_info_t*	返回locale_info对象。
language	char*	语言。
country	char*	国家或地区。

locale_info_deinit 函数

---

• 函数功能：

释放全部资源。

• 函数原型：

ret_t locale_info_deinit (locale_info_t* locale_info);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
locale_info	locale_info_t*	locale_info对象。

locale_info_destroy 函数

---

• 函数功能：

释放全部资源并销毁locale_info对象。

• 函数原型：

ret_t locale_info_destroy (locale_info_t* locale_info);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
locale_info	locale_info_t*	locale_info对象。

locale_info_init 函数

---

• 函数功能：

初始化locale_info。

• 函数原型：

locale_info_t* locale_info_init (locale_info_t* locale_info, char* language, char* country);

• 参数说明：

参数	类型	说明
返回值	locale_info_t*	返回locale_info对象。
locale_info	locale_info_t*	locale_info对象。
language	char*	语言。
country	char*	国家或地区。

locale_info_off 函数

---

• 函数功能：

注销指定事件的处理函数。

• 函数原型：

ret_t locale_info_off (locale_info_t* locale_info, uint32_t id);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
locale_info	locale_info_t*	控件对象。
id	uint32_t	locale_info_on返回的ID。

locale_info_on 函数

---

• 函数功能：

注册指定事件的处理函数。

• 函数原型：

uint32_t locale_info_on (locale_info_t* locale_info, event_type_t type, event_func_t on_event, void* ctx);

• 参数说明：

参数	类型	说明
返回值	uint32_t	返回id，用于locale_info_off。
locale_info	locale_info_t*	控件对象。
type	event_type_t	事件类型，目前固定为EVT_LOCALE_CHANGED。
on_event	event_func_t	事件处理函数。
ctx	void*	事件处理函数上下文。

locale_info_set 函数

---

• 函数功能：

设置缺省locale_info。

• 函数原型：

ret_t locale_info_set (locale_info_t* locale_info);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
locale_info	locale_info_t*	locale_info对象。

locale_info_tr 函数

---

• 函数功能：

翻译字符串。

• 函数原型：

char* locale_info_tr (locale_info_t* locale_info, char* text);

• 参数说明：

参数	类型	说明
返回值	char*	返回翻译之后的字符串。
locale_info	locale_info_t*	locale_info对象。
text	char*	待翻译的文本。

country; 属性

---

国家或地区。如：CN

• 类型：char*

特性	是否支持
可直接读取	是
可直接修改	否

language 属性

---

语言。如：zh

• 类型：char*

特性	是否支持
可直接读取	是
可直接修改	否