鸿蒙OS TabList

TabList

java.lang.Object

|—ohos.agp.components.Component

|—|—ohos.agp.components.ComponentContainer

|—|—|—ohos.agp.components.StackLayout

|—|—|—|—ohos.agp.components.ScrollView

|—|—|—|—|—ohos.agp.components.TabList

public class TabList
extends ScrollView

显示选项卡的方向布局，并允许布局中的内容沿布局方向滚动。

您可以使用 TabList 对象创建选项卡，然后使用 addTab(ohos.agp.components.TabList.Tab) 将新选项卡添加到列表中。 布局方向可以是 Component.HORIZONTAL 或 Component.VERTICAL。 默认方向是水平的。

Since:

3

嵌套类摘要

字段摘要

构造函数摘要

方法总结

字段详细信息

INDICATOR_BOTTOM_LINE

public static final int INDICATOR_BOTTOM_LINE

表示选择指示器是选项卡的底线。

Since:

3

INDICATOR_INVISIBLE

public static final int INDICATOR_INVISIBLE

表示选择指示器已隐藏。

Since:

3

INDICATOR_LEFT_LINE

public static final int INDICATOR_LEFT_LINE

表示选择指示器是选项卡左侧的垂直线。

Since:

3

INDICATOR_OVAL

public static final int INDICATOR_OVAL

指示选择指示器是选项卡上的椭圆形背景。

Since:

3

构造函数详细信息

TabList

public TabList(Context context)

默认构造函数用于使用默认属性集和样式创建 TabList 实例。

参数：

TabList

public TabList(Context context, AttrSet attrSet)

用于在 XML 文件解析后使用指定的属性集和默认样式创建 TabList 实例的构造函数。

参数：

TabList

public TabList(Context context, AttrSet attrSet, String styleName)

用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TabList 实例的构造函数。

参数：

方法详情

addTab

public void addTab(TabList.Tab tab)

在当前布局的末尾添加一个选项卡。

参数：

Throws:

Since:

3

addTab

public void addTab(TabList.Tab tab, int pos)

将选项卡添加到当前布局中的指定位置。

参数：

Throws:

Since:

3

addTab

public void addTab(TabList.Tab tab, boolean selected)

在当前布局的末尾添加一个选项卡并指定它是否被选中。

参数：

Throws:

Since:

3

addTab

public void addTab(TabList.Tab tab, int pos, boolean selected)

将选项卡添加到当前布局中的某个位置并指定它是否被选中。

参数：

Throws:

Since:

3

removeTab

public void removeTab(TabList.Tab tab)

删除选项卡。

参数：

Throws:

Since:

3

removeTab

public void removeTab(int pos)

从指定位置删除选项卡。

参数：

Throws:

Since:

3

removeAllComponents

public void removeAllComponents()

从当前组件中删除所有选项卡。

覆盖：

ComponentContainer 类中的 removeAllComponents

getTabAt

public TabList.Tab getTabAt(int pos)

获取指定位置的选项卡。

此方法返回指定位置的选项卡，如果位置无效，则返回空指针。

参数：

返回:

返回指定位置的选项卡。

Throws:

Since:

3

selectTabAt

public void selectTabAt(int pos)

选择表中指定位置的选项卡。

参数：

Throws:

Since:

4

selectTab

public void selectTab(TabList.Tab tab)

选择一个选项卡。

如果之前选择的选项卡属于当前组件，则会自动取消选择它。

参数：

Throws:

Since:

3

getSelectedTab

public TabList.Tab getSelectedTab()

获取组件中选定的选项卡。

返回:

返回选定的选项卡或 null 未选择选项卡。

getSelectedTabIndex

public int getSelectedTabIndex()

获取选定选项卡在组件中的位置。

返回:

返回选定选项卡的位置。 该值必须是非负整数。

Since:

4

getTabCount

public int getTabCount()

获取组件中的选项卡数。

返回:

返回组件中选项卡的数量，为非负整数。

setTabTextColors

public void setTabTextColors(int normal, int selected)

设置选定和取消选定选项卡的文本颜色。

参数：

Since:

3

getNormalTabTextColor

public int getNormalTabTextColor()

获取该选项卡处于正常状态时的文本颜色。

返回:

返回一个非负整数，表示选项卡的文本颜色值。

Since:

5

getSelectedTabTextColor

public int getSelectedTabTextColor()

获取该选项卡被选中时的文本颜色。

返回:

返回一个非负整数，表示选项卡的文本颜色值。

Since:

5

setTabTextSize

public void setTabTextSize(int size)

设置组件中所有选项卡的文本大小。

参数：

Throws:

Since:

3

getTabTextSize

public int getTabTextSize()

获取表格的文本大小。

返回:

返回表示文本大小的非负整数，以像素为单位。

Since:

4

getTabTextAlignment

public int getTabTextAlignment()

获取表格的文本对齐方式。

返回:

返回表示文本对齐模式的非负整数。

• TextAlignment.LEFT：左对齐
• TextAlignment.RIGHT：右对齐
• TextAlignment.HORIZONTAL_CENTER：水平居中
• TextAlignment.TOP：顶部对齐
• TextAlignment.VERTICAL_CENTER：垂直居中
• TextAlignment.BOTTOM：底部对齐
• TextAlignment.CENTER：水平和垂直居中
• TextAlignment.START：开始对齐
• TextAlignment.END：结束对齐

Since:

4

getTabLength

public int getTabLength()

获取表中所有标签的长度，为非负整数。

返回:

返回长度。

Since:

4

getTabMargin

public int getTabMargin()

获取表格中两个相邻选项卡之间的边距（以像素为单位）。

返回:

返回表示边距的非负整数，以像素为单位。

Since:

4

setTabTextAlignment

public void setTabTextAlignment(int alignment)

设置组件中所有选项卡的文本对齐方式。

参数：

Throws:

setTabLength

public void setTabLength(int length)

设置布局中所有选项卡的宽度或高度。

选项卡宽度在水平布局中设置，而选项卡高度在垂直布局中设置。 该值必须是非负整数。

参数：

Since:

3

setTabMargin

public void setTabMargin(int margin)

设置组件中两个选项卡之间的边距。

参数：

Throws:

Since:

3

setFixedMode

public void setFixedMode(boolean isFixed)

设置是否修复所有选项卡并同时显示它们。

如果禁用固定模式，则布局的宽度或高度等于其中所有选项卡的总宽度或高度。 如果启用了固定模式，则布局的宽度或高度是固定的，并且其中的每个选项卡具有相同的宽度或高度。

参数：

Since:

3

isFixedMode

public boolean isFixedMode()

获取是否开启固定模式。 默认情况下，固定模式被禁用。

返回:

如果启用了固定模式，则返回 true； 否则返回 false。

Since:

3

setSelectedTabIndicatorColor

public void setSelectedTabIndicatorColor(int color)

设置选定选项卡的颜色。

参数：

getSelectedTabIndicatorColor

public int getSelectedTabIndicatorColor()

获取所选标签指示器的颜色。

返回:

返回选定选项卡指示器的颜色。

Since:

3

setSelectedTabIndicatorHeight

public void setSelectedTabIndicatorHeight(int height)

设置选定选项卡的高度。

参数：

Throws:

Since:

3

getSelectedTabIndicatorHeight

public int getSelectedTabIndicatorHeight()

获取所选标签指示器的高度。

返回:

返回选定选项卡指示器的高度。

Since:

3

setOrientation

public void setOrientation(int orientation)

设置布局方向。

参数：

Since:

3

getOrientation

public int getOrientation()

获取布局方向。

返回:

返回布局方向。

Since:

3

setIndicatorType

public void setIndicatorType(int type)

设置选项卡指示器类型。

参数：

Since:

3

getIndicatorType

public int getIndicatorType()

获取选项卡指示器类型。

返回:

返回选项卡指示器类型，可以是 INDICATOR_INVISIBLE、INDICATOR_BOTTOM_LINE、INDICATOR_LEFT_LINE 或 INDICATOR_OVAL。

Since:

3

addTabSelectedListener

public void addTabSelectedListener(TabList.TabSelectedListener listener)

将选定的侦听器添加到列表中的选项卡。

参数：

Since:

3

removeTabSelectedListener

public void removeTabSelectedListener(TabList.TabSelectedListener listener)

从布局中的选项卡中删除选定事件的侦听器。

参数：

Since:

3