Logo FluentUI

TabView QML Type

一个具有可拖拽标签和可关闭按钮的选项卡视图组件。. More...

Import Statement: import FluentUI.Controls 1.0

Properties

Signals

Methods

  • void appendTab(string icon, string text, Component page, var argument)
  • int count()
  • void createTab(string icon, string text, Component page, var argument)
  • void setTabList(list<var> list)

Detailed Description

`TabView` 组件提供了一个选项卡界面,允许用户通过拖拽重新排序选项卡,并通过点击关闭按钮删除选项卡。它支持添加新选项卡的按钮,以及显示和隐藏选项卡的功能。

示例用法:

 TabView {
  tabWidthBehavior: TabViewType.Equal
  closeButtonVisibility: TabViewType.OnHover
  addButtonVisibility: true

  onNewPressed: {
      // 处理新选项卡的创建
  }
 }

Property Documentation

addButtonVisibility : bool

控制添加新选项卡按钮的可见性。如果设置为 `true`,则显示添加按钮;否则隐藏按钮。

默认值为 `true`。


closeButtonVisibility : int

控制选项卡关闭按钮的可见性。可以是以下值之一: - `TabViewType.Never`:从不显示关闭按钮。 - `TabViewType.OnHover`:仅在选项卡悬停时显示关闭按钮。 - `TabViewType.Always`:始终显示关闭按钮。

默认值为 `TabViewType.Always`。


itemWidth : int

选项卡的默认宽度。该属性在 `tabWidthBehavior` 为 `TabViewType.SizeToContent` 或 `TabViewType.Compact` 时有效。

默认值为 `146`。


tabWidthBehavior : int

控制选项卡宽度的行为。可以是以下值之一: - `TabViewType.Equal`:所有选项卡的宽度相等。 - `TabViewType.SizeToContent`:选项卡的宽度根据其内容调整。 - `TabViewType.Compact`:只有在选项卡被悬停或选中时才会显示完整宽度。

默认值为 `TabViewType.Equal`。


Signal Documentation

void newPressed()

当用户点击添加新选项卡按钮时发出的信号。

Note: The corresponding handler is onNewPressed.


Method Documentation

void appendTab(string icon, string text, Component page, var argument)

将一个新选项卡添加到选项卡模型中。

icon 选项卡图标的资源路径。 text 选项卡的显示文本。 page 选项卡的内容组件。 argument 附加参数。


int count()

获取当前选项卡的数量。


void createTab(string icon, string text, Component page, var argument)

创建一个新的选项卡数据对象。

icon 选项卡图标的资源路径。 text 选项卡的显示文本。 page 选项卡的内容组件。 argument 附加参数,默认为空对象。


void setTabList(list<var> list)

设置选项卡列表,替换当前所有选项卡。

list 包含选项卡数据对象的列表。