原文地址http://download.oracle.com/javafx/2.0/ui_controls/checkbox.htm
CheckBox类让你可以在应用中创建复选框。尽管复选框看起来很想单选框
,但是它们并不能被放置进一个开关组中来实现很多选项的选择。你可以复习一下前面关于Radio Button 和Toggle Button相关的内容。
Figure 6-1 是有三个复选框的一个应用,这些复选框用来控制工具栏中的图标是否显示。
创建Checkbox
Example 6-1 creates two simple checkboxes.
- //Example 6-1 Creating Checkboxes
- //A checkbox without a caption
- CheckBox cb1 = new CheckBox();
- //A checkbox with a string caption
- CheckBox cb2 = new CheckBox("Second");
- cb1.setText("First");
- cb1.setSelected(true);
创建复选框后,就可以使用JavaFX API中的方法对它们进行设置。在Example 6-1 中 setText方法为
c1这个复选框定义了标题,设置setSelected方法为
true以使程序运行后
cb1是选中的。
定义状态
复选框能被定义为明确或不明确。被定义为明确后就可以被选中或取消选中,但是不明确的话就不能被选中或取消选中。结合使用CheckBox类的 setSelected
和setIndeterminate方法来为复选框指定状态。
Table 6-1 是三个不同状态的复选框,它们的 INDETERMINATE
和SELECTED属性不相同。
Table 6-1 States of a Checkbox
Property Values | Checkbox Appearance |
---|---|
|
|
|
|
|
|
当复选框要呈现多种状态的UI元素时要为它们指定三种状态,如"Yes", "No", "Not Applicable"。CheckBox 类的allowIndeterminatePropety设置了复选框对象是否能在全部三种状态(选中、取消选中、不明确)中循环
。如果设置了
,这个控件就可以在三种状态中循环。否则
,这控件只能在选中和取消选中两种状态中切换。下一部分的应用中构造了三个复选框,并且只有两个状态。
设置行为
Example 6-2 中的代码块创建了三个复选框,这样当一个复选框被选中后,相应的图标就显示出来。
- //Example 6-2 Setting the Behavior for the Checkboxes
- final String[] names = new String[]{"Security", "Project", "Chart"};
- final Image[] images = new Image[names.length];
- final ImageView[] icons = new ImageView[names.length];
- final CheckBox[] cbs = new CheckBox[names.length];
- for (int i = 0; i < names.length; i++)
- { final Image image = images[i] =
- new Image(getClass().getResourceAsStream(names[i] + ".png"));
- final ImageView icon = icons[i] = new ImageView();
- final CheckBox cb = cbs[i] = new CheckBox(names[i]);
- cb.selectedProperty().addListener
- (new ChangeListener<Boolean>() {
- public void changed(ObservableValue<? extends Boolean> ov, Boolean old_val, Boolean new_val)
- { icon.setImage(new_val ? image : null);
- } });
- }
names这个数组使用了一个
for循环来创建复选框和相应的图标。比如说,
cbs[0]是第一个复选框,被分配了"Security"这个标题;同时image[0]接收了"Security.png"作为getResourceStream方法的文件名。如果一个特定的复选框被选中后,相应的图片就被分配成它的图标。如果一个复选框被取消选中,图标接收
null图片所以没有图标分配。
Figure 6-2 是应用中的 Security 和Chart 复选框被选中,Project 取消选中。
Figure 6-2 Checkbox Application in Action
Description of "Figure 6-2 Checkbox Application in Action"
美化Checkbox
Figure 6-2 中的复选框有CheckBox 类 默认的外观和感觉。可以通过使用 setStyle
方法来改变它的样子,见Example 6-3 .
- //Example 6-3 Styling a Checkbox
- cb1.setStyle( "-fx-border-color: lightblue; "
- + "-fx-font-size: 20;"
- + "-fx-border-insets: -5; "
- + "-fx-border-radius: 5;"
- + "-fx-border-style: dotted;"
- + "-fx-border-width: 2;" );
新风格包括了一条浅蓝色点边框和一个扩大字体的标题。Figure 6-3 是使用了这种风格的 cb1复选框。
要为应用中的所有复选框设置特定的风格,按照下面的步骤:
-
创建一个 .css文件;
-
在 .css文件中创建
checkbox
CSS 类。 -
在
checkbox
CSS 类中定义所有需要的风格。 -
在你的JavaFX应用中,使用
setStyleClass
方法来使用CSS文件。