【JFace】ComboViewer 简介

简介

ComboViewer是JFace提供的一个组合框控件，它可以与一个下拉框和一个文本框结合起来，使用户可以在下拉框中选择一个已有的值或输入一个新值。ComboViewer可以用于许多场景，如选择配置选项、输入搜索关键字等。

ComboViewer是基于JFace的Viewers框架实现的，它提供了一系列的API和控件，使用户可以方便地创建和管理用户界面。

使用

创建ComboViewer

ComboViewer的创建非常简单。以下是一个创建ComboViewer的示例代码：

ComboViewer comboViewer = new ComboViewer(parent, SWT.READ_ONLY);
comboViewer.setContentProvider(ArrayContentProvider.getInstance());
comboViewer.setInput(new String[] {"Item 1", "Item 2", "Item 3"});

在这个示例中，我们首先创建一个ComboViewer对象，并将其添加到指定的父容器(parent)中。我们还指定了一个SWT.READ_ONLY标志，使ComboViewer只读，用户无法在文本框中输入新值。

接下来，我们设置了ComboViewer的内容提供者(Content Provider)和输入(Input)。这里我们使用了ArrayContentProvider.getInstance()作为内容提供者，这个内容提供者可以将一个数组转换为ComboViewer中的列表项。我们还设置了一个字符串数组作为输入，这些字符串将成为ComboViewer中的列表项。

给ComboViewer设置默认值

要将默认值设置为ComboViewer中的某个项，可以使用setSelection()方法。以下是一个将默认值设置为第一个列表项的示例代码：

comboViewer.setSelection(new StructuredSelection("Item 1"));

问题：设置了默认值不起作用？
如果comboViewer.setSelection(new StructuredSelection(items[1]))不起作用，可能是由于以下原因之一：

1. 内容提供者(Content Provider)设置了不同的元素类型：在使用StructuredSelection设置选中项时，它需要与ComboViewer内容提供者返回的元素类型匹配。如果它们不匹配，StructuredSelection将无法识别要选中的元素。例如，如果ComboViewer的内容提供者返回的是Person对象，那么在使用StructuredSelection设置选中项时，需要使用new StructuredSelection(selectedPerson)。

2. 选中项不存在于ComboViewer的内容中：当使用StructuredSelection设置选中项时，确保它存在于ComboViewer的内容中。否则，ComboViewer将不会选择任何项。

3. 选中项在内容提供者中具有不同的对象实例：当使用StructuredSelection设置选中项时，它需要与ComboViewer内容提供者返回的元素对象实例匹配。如果它们不匹配，StructuredSelection将无法识别要选中的元素。在这种情况下，可以尝试在内容提供者中为每个元素返回一个唯一的标识符，并使用StructuredSelection设置选中项时，将标识符作为参数传递。

如果您仍然无法解决问题，请检查控件的其他设置和属性，以确保它们没有干扰选中项的设置。例如，将ComboViewer的样式设置为SWT.READ_ONLY，以确保用户无法手动更改选中项。

获取选择的项

要获取用户选择的项，可以使用getStructuredSelection()方法。以下是一个获取选择项的示例代码：

StructuredSelection selection = (StructuredSelection) comboViewer.getStructuredSelection();
String selectedItem = (String) selection.getFirstElement();

选择变更事件

当用户选择ComboViewer中的项时，我们可以通过添加选择监听器(Selection Listener)来捕获选择变更事件并执行相应的操作。

以下是一个ComboViewer选择变更的示例代码：

comboViewer.addSelectionChangedListener(new ISelectionChangedListener() {
    @Override
    public void selectionChanged(SelectionChangedEvent event) {
        StructuredSelection selection = (StructuredSelection) event.getSelection();
        String selectedItem = (String) selection.getFirstElement();
        System.out.println("Selected item: " + selectedItem);
    }
});

在这个示例中，我们首先创建了一个选择变更监听器，并将其添加到ComboViewer中。当用户选择ComboViewer中的项时，选择变更监听器的selectionChanged()方法将被调用。

在selectionChanged()方法中，我们首先获取用户选择的项，然后将其转换为字符串。最后，我们将选择的项打印到控制台中。

需要注意的是，当用户通过文本框输入新值时，ComboViewer不会触发选择变更事件。如果需要捕获文本框中的输入事件，可以添加文本值变更监听器(Text Value Listener)来实现。

在这个示例中，我们首先调用getStructuredSelection()方法来获取用户选择的项的结构化选择(Structured Selection)。然后，我们获取选择的第一个元素，并将其转换为字符串。

设置样式

ComboViewer可以使用SWT的样式标志来设置其外观和行为。以下是一些常见的样式标志：

• SWT.READ_ONLY：使ComboViewer只读，用户无法在文本框中输入新值。
• SWT.DROP_DOWN：显示下拉箭头，在用户点击箭头时显示下拉列表。
• SWT.BORDER：显示边框。
• SWT.FLAT：显示扁平外观，去掉默认的3D效果。
• SWT.SIMPLE：显示简单外观，去掉默认的下拉箭头。

以下是一个使用样式标志设置ComboViewer外观的示例代码：

ComboViewer comboViewer = new ComboViewer(parent, SWT.READ_ONLY | SWT.DROP_DOWN | SWT.BORDER);

在这个示例中，我们使用了SWT.READ_ONLY、SWT.DROP_DOWN和SWT.BORDER标志来设置ComboViewer的样式。这将使ComboViewer只读，显示下拉箭头，并显示边框。

除了使用样式标志，我们还可以使用SWT的布局数据(Layout Data)来设置ComboViewer的位置和大小。以下是一个设置ComboViewer大小和位置的示例代码：

GridData comboViewerGridData = new GridData(SWT.FILL, SWT.CENTER, true, false);
comboViewerGridData.widthHint = 200;
comboViewerGridData.heightHint = 20;

ComboViewer comboViewer = new ComboViewer(parent, SWT.READ_ONLY | SWT.DROP_DOWN | SWT.BORDER);
comboViewer.getCombo().setLayoutData(comboViewerGridData);

在这个示例中，我们首先创建了一个GridData对象，并设置了它的宽度和高度。然后，我们创建了一个ComboViewer对象，并将其添加到指定的父容器中。最后，我们将ComboViewer的布局数据设置为我们创建的GridData对象，以便设置其大小和位置。

需要注意的是，ComboViewer的布局数据应该设置在其下拉框上，而不是ComboViewer本身上。因此，我们使用了comboViewer.getCombo()方法来获取ComboViewer下拉框的控件，并将其布局数据设置为我们创建的GridData对象。

总结

ComboViewer是JFace提供的一个非常方便的组合框控件，它可以与下拉框和文本框结合起来，使用户可以选择一个已有的值或输入一个新值。在使用ComboViewer时，我们可以通过设置内容提供者、输入和选择来定制其行为。ComboViewer还提供了许多其他的功能，如过滤和排序等，可以根据具体的需求进行使用。