1 Star 0 Fork 338

seasky100 / awtk

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
dialog_highlight.md 2.78 KB
一键复制 编辑 原始数据 按行查看 历史
lixianjing 提交于 2019-11-14 18:09 . Update dialog_highlight.md

对话框高亮策略

一、介绍

在弹出除对话框时,通常希望让背景窗口变暗或者变模糊,以突显当前的对话框的重要性。我们把让背景窗口变暗或者变模糊的方法称为对话框高亮策略。并把对话框高亮策略抽象成接口,开发者可以自己实现特殊效果的高亮策略,也可以使用缺省的高亮策略。

缺省的对话框高亮策略是让背景窗口变暗,可以是静态的(固定alpha),也可以是动态的。动态的高亮策略在对话框打开的动画过程中,背景窗口逐渐变暗,这有更好的视觉效果,但也需要更多的计算开销,开发者可以根据实际情况选用静态还是动态效果。

二、使用方法

通过对话框的hightlight属性来指定对话框的高亮策略,"default"表示缺省的对话框的高亮策略。如:

使用静态效果:

<dialog anim_hint="popdown" highlight="default(alpha=40)"  
  x="0" y="0" w="100%" h="160">

使用动态效果:

<dialog anim_hint="popup" highlight="default(start_alpha=0, end_alpha=80)" 
  x="0" y="bottom" w="100%" h="160">

三、参数说明

参数其格式为类似函数调用的参数格式。 缺省的对话框高亮策略支持以下几个参数:

  • start_alpha 起始alpha值(0-255)。
  • end_alpha 结束alpha值(0-255)。
  • alpha 相当于将start_alpha和end_alpha设置为同一个值。

当alpha=0时,显示效果没有变化,但相当于了缓存背景窗口的绘制到图片中,从而提高显示效率,在特殊情况下可以酌情使用。

四、自定义对话框高亮策略

开发者可以自定义高亮策略,自定义的高亮策略可以像内置高亮策略一样,可以用以上方法在XML文件中启用。

1.实现dialog_highlighter_t接口。如:

static const dialog_highlighter_vtable_t s_dialog_highlighter_default_vt = { 
    .type = "dialog_highlighter_default_t",
    .desc = "dialog_highlighter_default_t",
    .size = sizeof(dialog_highlighter_default_t),
    .prepare = dialog_highlighter_default_prepare,
    .draw = dialog_highlighter_default_draw};

dialog_highlighter_t* dialog_highlighter_default_create(object_t* args) {
  value_t v;
  dialog_highlighter_t* h = dialog_highlighter_create(&s_dialog_highlighter_default_vt);
  dialog_highlighter_default_t* dh = (dialog_highlighter_default_t*)h;
  return_value_if_fail(h != NULL, NULL);

  dh->end_alpha = 0;
  dh->start_alpha = 0;

...

  return h;
}

2.注册到dialog_highlighter_factory工厂。如:

  dialog_highlighter_factory_register(f, DIALOG_HIGHLIGHTER_DEFAULT,
                                      dialog_highlighter_default_create);

完整示例请参考:https://github.com/zlgopen/awtk/tree/master/src/dialog_highlighters

C
1
https://gitee.com/seasky100/awtk.git
git@gitee.com:seasky100/awtk.git
seasky100
awtk
awtk
master

搜索帮助

53164aa7 5694891 3bd8fe86 5694891