跳到主要内容

堆叠控件（StackedWidget）

StackedWidget 类提供了一组堆叠的控件，其中每次只有一个控件是可见的。 在向堆叠控件中添加控件时，这些控件会被加入到一个内部列表中。可以通过以下方式管理控件：

  • 使用 add() 函数将控件添加到列表末尾。
  • 使用 insert() 函数在指定索引位置插入控件。
  • 使用 remove() 函数从堆叠控件中移除某个控件。
  • 使用 at() 函数获取指定索引位置的控件。 堆叠控件包含的控件数量可以通过 count 属性获取。当前显示在屏幕上的控件的索引位置可以通过 index 属性获取。类似地，当前显示的控件可以通过 current 属性获取。

示例代码​

以下代码展示了如何创建一个堆叠控件：

const desktop = Desktop.instance();// 获取桌面实例
const stackedWidget = new StackedWidget(desktop);// 创建堆叠控件并添加到桌面
stackedWidget.size = new Size(200, 80);// 设置堆叠控件的尺寸

// 创建三个按钮
const button1 = new Button(undefined, "Button 1");
const button2 = new Button(undefined, "Button 2");
const button3 = new Button(undefined, "Button 3");

// 将按钮添加到堆叠控件中
stackedWidget.add(button1);
stackedWidget.add(button2);
stackedWidget.add(button3);

// 设置当前显示的控件为索引为 1 的控件（即 Button 2）
stackedWidget.index = 1;

在这个例子中，stackedWidget 包含三个按钮控件，但只有 Button 2 会被显示，因为当前索引（index）被设置为 1。