awtk/docs/manual/dialog_highlighter_t.md

dialog_highlighter_t

概述

对话框高亮策略。

高亮策略的基本思路是对背景进行处理，比如将背景变暗或变模糊。

---

函数

函数名称	说明
dialog_highlighter_create	创建对话框高亮策略对象。
dialog_highlighter_destroy	销毁对话框高亮策略对象。
dialog_highlighter_draw	绘制背景。
dialog_highlighter_prepare	初始化。在绘制完背景，在截图前调用。
dialog_highlighter_set_bg	设置背景图片。

属性

属性名称	类型	说明
canvas	canvas_t*	画布。
dialog	widget_t*	对应的对话框。
img	bitmap_t	底层窗口的截图。

dialog_highlighter_create 函数

---

• 函数功能：

创建对话框高亮策略对象。

供子类构造函数用。

• 函数原型：

dialog_highlighter_t* dialog_highlighter_create (const dialog_highlighter_vtable_t* vt);

• 参数说明：

参数	类型	说明
返回值	dialog_highlighter_t*	返回对话框高亮策略对象
vt	const dialog_highlighter_vtable_t*	虚表对象。

dialog_highlighter_destroy 函数

---

• 函数功能：

销毁对话框高亮策略对象。

• 函数原型：

ret_t dialog_highlighter_destroy (dialog_highlighter_t* h);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
h	dialog_highlighter_t*	对话框高亮策略对象。

dialog_highlighter_draw 函数

---

• 函数功能：

绘制背景。

• 函数原型：

ret_t dialog_highlighter_draw (dialog_highlighter_t* h, float_t percent);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
h	dialog_highlighter_t*	对话框高亮策略对象。
percent	float_t	动画进度(0-1)，1表示打开已经完成。

dialog_highlighter_prepare 函数

---

• 函数功能：

初始化。在绘制完背景，在截图前调用。

• 函数原型：

ret_t dialog_highlighter_prepare (dialog_highlighter_t* h, canvas_t* c);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
h	dialog_highlighter_t*	对话框高亮策略对象。
c	canvas_t*	画布。

dialog_highlighter_set_bg 函数

---

• 函数功能：

设置背景图片。

• 函数原型：

ret_t dialog_highlighter_set_bg (dialog_highlighter_t* h, bitmap_t* img, framebuffer_object_t* fbo);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
h	dialog_highlighter_t*	对话框高亮策略对象。
img	bitmap_t*	背景截图。
fbo	framebuffer_object_t*	fbo对象。

canvas 属性

---

画布。

• 类型：canvas_t*

dialog 属性

---

对应的对话框。

• 类型：widget_t*

img 属性

---

底层窗口的截图。

• 类型：bitmap_t