布局容器类组件开发指导

布局类容器组件由视图基础类组成,通过直接设置视图位置,可以达到嵌套和重叠布局的目的;通过设置布局类型和边距达到规格化布局子组件的目的;通过调用相关接口可实现根据父组件及兄弟节点布局视图的目的。

UISwipeView

使用场景

UISwipeView继承UIViewGroup,除提供容器类组件Add、Remove、Insert等方法外还提供按页面滑动功能,滑动结束后当前页面居中对齐显示。该组件分为水平方向和垂直方向,通过Add方法添加的子组件会根据Add的顺序和UISwipeView方向自动水平对齐或则垂直对齐。

接口说明

表 1 SwipeView接口说明

方法

功能

void SetCurrentPage(uint16_t index);

设置当前页

uint16_t GetCurrentPage()

获取当前页

UIView GetCurrentView() const

获取当前页组件

void SetOnSwipeListener(OnSwipeListener& onSwipeListener)

设置滑动回调类

void SetAnimatorTime(uint16_t time);

设置动画事件

void SetLoopState(bool loop)

设置是否循环

UIView GetViewByIndex(uint16_t index);

通过index获取view

开发步骤(水平滑动,不可循环)

  1. 创建一个水平滑动的UISwipeView。

    1. UISwipeView* swipe =newUISwipeView(UISwipeView::HORIZONTAL);
  2. 向UISwipeView中添加子组件。

    1. UILabelButton* button1 =newUILabelButton();
    2. button1->SetPosition(0,0, g_ButtonW, g_ButtonH);
    3. button1->SetText("button1");
    4. swipe->Add(button1);
    5. UILabelButton* button2 =newUILabelButton();
    6. button2->SetPosition(0,0, g_ButtonW, g_ButtonH);
    7. button2->SetText("button2");
    8. swipe->Add(button2);
    9. UILabelButton* button3 =newUILabelButton();
    10. button3->SetPosition(0,0, g_ButtonW, g_ButtonH);
    11. button3->SetText("button3");
    12. swipe->Add(button3);
  3. 检查实现效果,水平滑动,不可循环。

    图 1 UISwipeView水平滑动效果图

  1. ![](/projects/openharmony-1.0-zh-cn/subsystems/figures/zh-cn_image_0000001053247975.gif)

开发步骤(水平滑动,可循环)

  1. 创建一个水平滑动的UISwipeView并添加子组件。

    1. UISwipeView* swipe =newUISwipeView(UISwipeView::HORIZONTAL);
    2. UILabelButton* button1 =newUILabelButton();
    3. button1->SetPosition(0,0, g_ButtonW, g_ButtonH);
    4. button1->SetText("button1");
    5. swipe->Add(button1);
    6. UILabelButton* button2 =newUILabelButton();
    7. button2->SetPosition(0,0, g_ButtonW, g_ButtonH);
    8. button2->SetText("button2");
    9. swipe->Add(button2);
    10. UILabelButton* button3 =newUILabelButton();
    11. button3->SetPosition(0,0, g_ButtonW, g_ButtonH);
    12. button3->SetText("button3");
    13. swipe->Add(button3);
  2. 设置UISwipeView循环滑动。

    1. swipe->SetLoopState(true);
  3. 检查实现效果,水平循环滑动。

    图 2 UISwipeView水平滑动循环效果图

  1. ![](/projects/openharmony-1.0-zh-cn/subsystems/figures/zh-cn_image_0000001053207924.gif)

GridLayout

使用场景

提供基础布局能力,可设置网格行数和列数,通过Add方法添加的子组件在调用LayoutChildren()方法后自动进行排列布局。

接口说明

表 2 GridLayout接口说明

方法

功能

void SetRows(const uint16_t& rows)

设置行数

void SetCols(const uint16_t& cols)

设置列数

void LayoutChildren(bool needInvalidate = false)

布局子组件

开发步骤

  1. 构造GridLayout并设置位置、大小信息。

    1. GridLayout* layout_ =newGridLayout();
    2. layout_->SetPosition(0, g_y, HROIZONTAL_RESOLUTION,200);
    3. layout_->SetLayoutDirection(LAYOUT_HOR);
    4. layout_->SetRows(2);
    5. layout_->SetCols(2);
  2. 构造子组件button。

    1. UILabelButton* bt1 =newUILabelButton();
    2. bt1->SetPosition(0,0,100,50);
    3. bt1->SetText("bt1");
    4. UILabelButton* bt2 =newUILabelButton();
    5. bt2->SetPosition(0,0,100,50);
    6. bt2->SetText("bt2");
    7. UILabelButton* bt3 =newUILabelButton();
    8. bt3->SetPosition(0,0,100,50);
    9. bt3->SetText("bt3");
    10. UILabelButton* bt4 =newUILabelButton();
    11. bt4->SetPosition(0,0,100,50);
    12. bt4->SetText("bt4");
  3. 添加子组件并调用LayoutChildren()。

    1. layout_->Add(bt1);
    2. layout_->Add(bt2);
    3. layout_->Add(bt3);
    4. layout_->Add(bt4);
    5. layout_->LayoutChildren();
  4. 检查button组件布局效果如下图所示。

    图 3 设置2*2网格并添加4个button组件进行布局
    布局容器类组件开发指导 - 图1