AWTK 控件焦點相關問題

控件焦點相關問題

1、啓用焦點停留 (tab stop)

除了 edit 控件外，其它控件若是須要焦點停留功能，能夠指定控件的 focusable 屬性爲 true 來實現。

在 XML 中，能夠這樣指定：

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

在 C 代碼中，能夠這樣指定：

widget_set_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" />

2、先後切換焦點的按鍵

1. 缺省用 tab 鍵循環切換焦點。

#ifndef TK_KEY_MOVE_FOCUS_NEXT
#define TK_KEY_MOVE_FOCUS_NEXT "tab"
#endif /*TK_KEY_MOVE_FOCUS_NEXT*/

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 移動到下一個焦點控件。

3、上下左右切換焦點的按鍵

在一些特殊的硬件設備上，沒有觸摸屏，只有上、下、左、右、肯定和取消六個鍵。

爲了快速切換焦點，AWTK 支持經過左右鍵切換水平焦點，經過上下鍵切換垂直焦點。能夠經過窗口的下列屬性來設置：

• move_focus_up_key 向上移動焦點的鍵。
• move_focus_down_key 向下移動焦點的鍵。
• move_focus_left_key 向左移動焦點的鍵。
• move_focus_right_key 向右移動焦點的鍵。

示例：

<window text="Custom Soft Keyboard" anim_hint="htranslate"
  move_focus_up_key="up" move_focus_down_key="down" move_focus_left_key="left" move_focus_right_key="right">

  <edit name="edit" x="c" y="10" w="90%" h="30" focused="true" input_type="custom" text="" tips="custom"/>
  <view y="60" x="c" w="90%" h="-60" is_keyboard="true" grab_keys="true"
    children_layout="default(r=4,c=4,m=5,s=5)" >
    <button focusable="true" name="key0" text="0" />
    <button focusable="true" name="key1" text="1" />
    <button focusable="true" name="key2" text="2" />
    <button focusable="true" name="key3" text="3" />
    <button focusable="true" name="key4" text="4" />
    <button focusable="true" name="key5" text="5" />
    <button focusable="true" name="key6" text="6" />
    <button focusable="true" name="key7" text="7" />
    <button focusable="true" name="key8" text="8" />
    <button focusable="true" name="key9" text="9" />
    <button focusable="true" name="key#" text="#" />
    <button focusable="true" name="backspace" text="<=" />
  </view>
</window>

在這個例子中，方向鍵 up 移動到上方的焦點控件，方向鍵 down 移動到下方的焦點控件。 方向鍵 left 移動到左方的焦點控件，方向鍵 right 移動到右方的焦點控件。

軟鍵盤自己不能獲得焦點，爲了收到按鍵消息，須要指定屬性 grab_keys="true"。

4、設置初始焦點

能夠指定控件的 focused 屬性爲 true 將控件設置爲初始焦點控件。

在 XML 中，能夠這樣指定：

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

在 C 中，能夠這樣指定：

widget_set_prop_bool(widget, WIDGET_PROP_FOCUSED, TRUE);

5、參考

• 鍵名的定義：https://github.com/zlgopen/awtk/blob/master/src/base/enums.c。

• 鍵值映射：https://github.com/zlgopen/awtk/blob/master/docs/map_key.md