javafx combobox

### JavaFX ComboBox 组件使用教程

#### 创建并初始化 ComboBox 实例
为了创建一个 `ComboBox`，可以通过实例化 `ComboBox<T>` 类来完成。这里 `<T>` 表示组合框内项目的类型。

// 定义选项列表
ObservableList<String> options = FXCollections.observableArrayList(
    "Option 1", "Option 2", "Option 3"
);

// 初始化 ComboBox 并设置其项集合
ComboBox<String> comboBox = new ComboBox<>(options);

#### 设置默认选中项
如果希望指定某个特定条目作为初始选择，则可调用 `setValue()` 方法：

comboBox.setValue("Option 2");

#### 获取当前选定值
当需要获取用户所作的选择时，可以访问 `valueProperty()` 属性，并通过 `getValue()` 方法读取实际数据。

String selectedValue = comboBox.getValue();
System.out.println("Selected value is: " + selectedValue); // 打印被选中的值[^1]

#### 处理事件监听器
为了让程序响应用户的交互行为，在 `ComboBox` 上注册相应的事件处理器是非常重要的。下面的例子展示了如何捕捉到某一项被点击后的动作。

comboBox.setOnAction(event -> {
    System.out.println("An item was selected.");
});

#### 自定义显示转换器
有时可能想要改变下拉菜单内部以及顶部展示区域中文本的表现形式；这时就可以利用 `setConverter()` 函数来自定义呈现逻辑。

comboBox.setConverter(new StringConverter<>() {
    @Override
    public String toString(String object) {
        return "Custom Display Text For [" + object + "]";
    }

    @Override
    public String fromString(String stringRepresentation) {
        throw new UnsupportedOperationException(); // 不支持反向解析
    }
});

#### 控制最大宽度
对于某些应用场景而言，限定组件的最大尺寸可能是必要的。这能够帮助保持界面美观度一致性和适应不同屏幕分辨率的需求。

comboBox.setMaxWidth(200d); // 将最大宽度设为200像素单位[^3]