在 AWTK 中 如何让文本滚动起来

在很多时候，特别是在小屏幕的硬件上，控件比较小而要显示的文本比较长。

此时，我们需要在控件获得焦点时/或点击时，让文本滚动起来，以便让用户看到完整的信息。

AWTK 提供了 hscroll_label_t 控件，可以轻松满足文本滚动的需求。

一、基本用法

示例：

1. 
   
2. <window anim_hint="htranslate" text="hscroll_label" children_layout="default(c=1,h=30,xm=10,s=5)">
   
3.   <hscroll_label text="炫酷的 GUI 引擎。" />
   
4.   <hscroll_label text="炫酷的 GUI 引擎。" style="right"/>
   
5. 
   
6.   <hscroll_label
   
7.     lull="1000"
   
8.     loop="true"
   
9.     yoyo="true"
   
10.     ellipses="true"
    
11.     focusable="true"
    
12.     text="(always ellipses loop yoyo) 为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。" />
    
13. 
    
14.   <hscroll_label
    
15.     focusable="true"
    
16.     only_focus="true"
    
17.     text="(only_focus noloop) 为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。" />
    
18. 
    
19.   <hscroll_label
    
20.     loop="true"
    
21.     ellipses="true"
    
22.     focusable="true"
    
23.     only_focus="true"
    
24.     text="(only_focus ellipses loop) 为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。" />
    
25. 
    
26.   <hscroll_label
    
27.     style="green"
    
28.     loop="true"
    
29.     yoyo="true"
    
30.     ellipses="true"
    
31.     focusable="true"
    
32.     only_focus="true"
    
33.     text="(only_focus ellipses loop yoyo) 为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。" />
    
34. 
    
35. </window>
    

复制代码

二、扩展用法

但有时用的不是单纯的文本控件，而是列表项、多选按钮、单选按钮或其它功能的控件，那该怎么办呢？

其实也很简单，把 hscroll_label 作为该控件的子控件，并指定 only_parent_focus 属性为 true 即可。

示例：

1. 
   
2. <window anim_hint="htranslate" move_focus_prev_key="up" move_focus_next_key="down" text="Basic Controls">
   
3.   <row x="0" y="180" w="-50" h="90" children_layout="default(r=1,c=2,m=2)">
   
4.     <column children_layout="default(r=3,c=1,ym=2,s=10)" >
   
5.       <check_button name="r1" focusable="true" >
   
6.         <hscroll_label only_parent_focus="true" x="right" y="middle" w="-30" h="100%"
   
7.           text="1.AWTK 为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。" />
   
8.       </check_button>
   
9. 
   
10.       <check_button name="r2" focusable="true">
    
11.         <hscroll_label only_parent_focus="true" x="right" y="middle" w="-30" h="100%"
    
12.           text="2.AWTK 为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。" />
    
13.       </check_button>
    
14. 
    
15.       <check_button name="r3" value="true" focusable="true">
    
16.         <hscroll_label only_parent_focus="true" x="right" y="middle" w="-30" h="100%"
    
17.           text="3.AWTK 为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。" />
    
18.       </check_button>
    
19.     </column>
    
20.   </row>
    
21. </window>
    

复制代码