ListView

ListView 是一个基本实现，提供了绘制项目列表的功能。ListView 继承自 BoxView。

ListView<T> 作为一个项目被类型化，可以接受任何对象。进一步的项目处理发生在 CellFactory 中。为方便起见，它支持通用的高级列表功能，显示选中状态，如普通复选框和单选框类型。本质上，你可以有一个项目列表，这些项目可以原样显示，或者显示为任何项目都可以具有选中状态，或者只有一个项目可以具有选中状态。

ListView<String> view = new ListView<>();
view.setItems(List.of("item1", "item2"));

默认的项目样式是 nocheck，但可以更改。

支持 NOCHECK、CHECK 和 RADIO

ListView<String> view = new ListView<>(ItemStyle.CHECKED);

自定义

单个单元格的显示方式取决于 CellFactory。默认实现只是使用其 toString() 方法显示项目。

可以通过修改所使用的 CellFactory 进行自定义。

record ExampleData(String name) {
};

static class ExampleListCell extends AbstractListCell<ExampleData> {

	public ExampleListCell(ExampleData item) {
		super(item);
	}

	@Override
	public void draw(Screen screen) {
		Rectangle rect = getRect();
		Writer writer = screen.writerBuilder().style(getStyle()).build();
		writer.text(getItem().name(), rect.x(), rect.y());
		writer.background(rect, getBackgroundColor());
	}
}

并将其设置为工厂

ListView<ExampleData> view = new ListView<>();
view.setCellFactory((list, item) -> new ExampleListCell(item));

默认绑定

默认的视图命令是

表 1. 视图命令
命令	描述
LINE_UP	选择向上移动。
LINE_DOWN	选择向下移动。

默认的按键绑定是

表 2. 键
命令	描述
光标上移	绑定视图命令 LINE_UP
光标下移	绑定视图命令 LINE_DOWN
Enter	选择活动项目。
空格	更改活动项目的选择状态。

默认的鼠标绑定是

表 3. 鼠标
命令	描述
滚轮 \| 滚轮上移	绑定视图命令 LINE_UP
滚轮 \| 滚轮下移	绑定视图命令 LINE_DOWN
释放 \| Button1	选择项

事件

事件根据所使用的列表类型发送。

表 4. ListView 事件
事件	描述
ListViewOpenSelectedItemEvent	请求打开活动项目。
ListViewSelectedItemChangedEvent	活动项目已更改。