mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-02 12:08:16 +08:00
75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
# 控件焦点相关问题
|
||
|
||
## 一、启用焦点停留 (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](https://github.com/zlgopen/awtk/blob/master/src/base/enums.c#L99)。
|
||
|
||
## 三、设置初始焦点
|
||
|
||
可以指定控件的 focused 属性为 true 将控件设置为初始焦点控件。
|
||
|
||
在 XML 中，可以这样指定：
|
||
|
||
```
|
||
<button ... focused="true"/>
|
||
```
|
||
|
||
在 C 中，可以这样指定：
|
||
|
||
```
|
||
widget_get_prop_bool(widget, WIDGET_PROP_FOCUSED, TRUE);
|
||
```
|