# 容器类组件开发指导


容器类组件，指能包含其它UI组件的组件，容器类组件继承于UIViewGroup（带Add方法），基于实际组件的使用场景，将需要增加其他子组件的组件，放置到容器类继承结构下。如UIAnalogClock内，通常会Add需要的计步信息，时分秒图标等。


  **图1** 普通容器类组件结构

  ![zh-cn_image_0000001057990780](figures/zh-cn_image_0000001057990780.png)


RootView、UIAbstractScroll、UIPicker组件从UIViewGroup继承，UIList、UIScrollView、UISwipeView组件从UIAbstractScroll继承。


## UIViewGroup


### 使用场景

UIViewGroup是容器类组件基类，实现增加、删除、插入等操作，通过增加方法可以添加子组件。普通容器类组件子组件需要设置位置信息，位置信息为相对父组件的相对坐标。组件树结构如下图：

  **图2** 组件树结构示意图

  ![zh-cn_image_0000001197407385](figures/zh-cn_image_0000001197407385.png)

往根节点rootView里添加ViewGroup1容器组件和View1组件，往ViewGroup1容器组件里再添加View2组件和ViewGroup2容器组件，在View1之后添加View3组件。

- 关于渲染：容器类组件在渲染时会遍历所有子组件OnDraw方法，以达到刷新所有组件的目的。

- 关于坐标：子组件位置信息为相对父组件的相对坐标，系统在渲染时计算绝对坐标并显示。

- 关于树结构遍历：UIViewGroup提供如下方法实现遍历、查找、管理组件树。


### 接口说明

  **表1** ViewGroup接口说明

| 方法 | 功能 | 
| -------- | -------- |
| virtual void Add(UIView\* view) | 添加子组件 | 
| virtual void Insert(UIView\* prevView, UIView\* insertView) | 插入子组件 | 
| virtual void Remove(UIView\* view) | 删除子组件 | 
| virtual void RemoveAll() | 删除所有子组件 | 
| virtual void GetTargetView(const Point& point, UIView\*\* last) | 获取目标视图 | 
| virtual void MoveChildByOffset(int16_t x, int16_t y) | 偏移子组件 | 
| UIView\* GetChildrenHead() const | 获取视图头节点 | 
| UIView\* GetChildrenTail() const | 获取视图最后那个节点 | 
| virtual UIView\* GetChildById(const char\* id) const override | 通过id获取子视图 | 


### 开发步骤

1. 构造button实例并设置坐标信息。
     
   ```
   UILabelButton* btn1 = new UILabelButton();
   btn1->SetPosition(0, 0, 100, 50);
   btn1->SetText("btn1");
   
   UILabelButton* btn2 = new UILabelButton();
   btn2->SetPosition(50, 50, 100, 50);
   btn2->SetText("btn2");
   
   UILabelButton* btn3 = new UILabelButton();
   btn3->SetPosition(100, 100, 100, 50);
   btn3->SetText("btn3");
   ```

2. 构造UIViewGroup实例，并设置坐标信息。
     
   ```
   UIViewGroup* group = new UIViewGroup();
   group->SetPosition(0, 0, 300, 300);
   ```

3. 使用Add方法添加Button实例到UIViewGroup。
     
   ```
   group->Add(btn1);
   group->Add(btn2);
   group->Add(btn3);
   ```

4. 检查ViewGroup效果如下图所示。
     
     **图3** ViewGroup添加view实例效果图

     ![zh-cn_image_0000001197367485](figures/zh-cn_image_0000001197367485.png)


## UIScrollView


### 使用场景

UIScrollView提供可滑动的容器类组件，子组件可在触摸事件驱动下上下、左右滑动，并提供水平和垂直方向的游标显示功能。


### 接口说明

  **表2** ScrollView接口说明

| 方法 | 功能 | 
| -------- | -------- |
| void ScrollBy(int16_t xDistance, int16_t yDistance) | 移动视图 | 
| void SetScrollbarWidth(uint8_t width) | 设置滑动条宽度 | 
| void SetHorizontalScrollState(bool state) | 设置水平滑动状态 | 
| bool GetHorizontalScrollState() const | 获取水平是否可滑动状态 | 
| void SetVerticalScrollState(bool state) | 设置垂直滑动状态 | 
| bool GetVerticalScrollState() const | 获取垂直是否可滑动状态 | 
| void SetXScrollBarVisible(bool state) | 设置X轴滑动条是否可见 | 
| void SetYScrollBarVisible(bool state) | 设置Y轴滑动条是否可见 | 
| void RegisterScrollListener(OnScrollListener\* scrollListener) | 注册滑动事件回调类 | 
| void RefreshScrollBar() | 刷新滑动条 | 
| virtual void OnScrollStart() {} | 滚动开始回调函数 | 
| virtual void OnScrollEnd() {} | 滚动结束回调函数 | 
| uint8_t GetScrollState() const | 获取滚动状态 | 
| void SetScrollState(uint8_t state) | 设置滚动状态 | 


### 开发步骤

添加两个button子组件，并显示水平、垂直方向游标。

  
```
scrollView* scroll = new UIScrollView();
scroll->SetStyle(STYLE_BACKGROUND_COLOR, Color::Red().full);
scroll->SetPosition(0,0, 200, 200);
scroll->SetXScrollBarVisible(true);
scroll->SetYScrollBarVisible(true);
UILabelButton* button1 = new UILabelButton();
button1->SetText("button1");
button1->SetPosition(0, 0, 300, 300);
UILabelButton* button2 = new UILabelButton();
button2->SetText("button2");
button2->SetPosition(0, 300, 300, 300);
scroll->Add(button1);
scroll->Add(button2);
```

  **图4** 水平、垂直方向可滑动效果图
  
  ![zh-cn_image_0000001151367828](figures/zh-cn_image_0000001151367828.gif)