awtk/docs/widget_focus.md
2019-08-22 11:38:23 +08:00

2.1 KiB
Raw Blame History

控件焦点相关问题

一、启用焦点停留 (tab stop)

除了 edit 控件外,其它控件如果需要焦点停留功能,可以指定控件的 focusable 属性为 true 来实现。

在 XML 中,可以这样指定:

 <button ... focusable="true"/>

在 C 中,可以这样指定:

 widget_get_prop_bool(widget, WIDGET_PROP_FOCUSABLE, TRUE);

注意 如果指定了 fucusable 属性为 true请确保控件的 style 中定义了 focused 状态的数据,否则会因为 focused 状态没有 style 数据而无法显示。如:

  <style name="default" border_color="#a0a0a0"  text_color="black">
    <normal     bg_color="#f0f0f0" />
    <pressed    bg_color="#c0c0c0" x_offset="1" y_offset="1"/>
    <over       bg_color="#e0e0e0" />
    <focused    bg_color="#e0e0e0" />
    <disable    bg_color="gray" text_color="#d0d0d0" />
  </style>    <focused    bg_color="#e0e0e0" />

二、切换焦点的按键

1. 缺省的向前和向后移动焦点的键值。

#ifndef TK_KEY_MOVE_FOCUS_NEXT
#define TK_KEY_MOVE_FOCUS_NEXT TK_KEY_TAB
#endif /*TK_KEY_MOVE_FOCUS_NEXT*/

#ifndef TK_KEY_MOVE_FOCUS_PREV
#define TK_KEY_MOVE_FOCUS_PREV TK_KEY_UNKNOWN
#endif /*TK_KEY_MOVE_FOCUS_PREV*/

用户可以重定义以上的宏来自定义这两个键值。

2. 窗口可以为当前窗口指定的向前和向后移动焦点的键值。

  • move_focus_prev_key 指定向前移动焦点的键值。
  • move_focus_next_key 指定向后移动焦点的键值。
<window anim_hint="htranslate" move_focus_prev_key="up" move_focus_next_key="down">

在这个例子中,方向键 up 移动到前一个焦点控件,方向键 down 移动到下一个焦点控件。

键名的定义请参考 enums.c

三、设置初始焦点

可以指定控件的 focused 属性为 true 将控件设置为初始焦点控件。

在 XML 中,可以这样指定:

 <button ... focused="true"/>

在 C 中,可以这样指定:

 widget_get_prop_bool(widget, WIDGET_PROP_FOCUSED, TRUE);