DOC-03-05 开关按钮(Toggle Button)
在这一章，你将学习ToggleButton类，它是JavaFX API中另一种可用的按钮。
两个或以上的Toggle Button可以组合在一个Group中，同时只有一个Toggle Button可以被选中，或者都无需选中。图5-1是在一个Group中组合了三个Toggle Button的应用程序屏幕截图。应用程序会根据选中的Toggle
Button绘制一个特定颜色的矩形。
图5-1三个Toggle Button
创建一个Toggle Button
你可以使用ToggleButton类中三个构造方法的任何一个来为你的应用程序创建一个Toggle Button，如例5-1所示。
例5-1创建Toggle Button
Java
//一个不带任何文本或图标的Toggle Button
ToggleButton tb1 = new ToggleButton();
//一个带有文本的Toggle Button
ToggleButton tb2 = new ToggleButton("Press me");
//一个带有文本和图标的Toggle Button
Image image = new Image(getClass().getResourceAsStream("icon.png"));
ToggleButton tb3 = new ToggleButton ("Press me", new ImageView(image));
//一个不带任何文本或图标的Toggle Button
ToggleButtontb1=newToggleButton();
//一个带有文本的Toggle Button
ToggleButtontb2=newToggleButton("Press me");
//一个带有文本和图标的Toggle Button
Imageimage=newImage(getClass().getResourceAsStream("icon.png"));
ToggleButtontb3=newToggleButton("Press me",newImageView(image));
ToggleButton类是Labeled类的扩展，所以你可以为其指定一个文本标题、一个图像，或者同时指定二者。你可以通过Labeled类的setText和setGraphic方法来为ToggleButton指定文本或者图像内容。
一旦你在你的代码中定义了多个Toggle Button，你可以将它们组合到一个Group中，并且设定一个特定的行为。
添加Toggle Button到Group
ToggleButton类的具体实现和RadioButton类非常相似。但是，和Radio Button不同的是，在一个组中并不试图强制选中至少一个Toggle Button。也就是说，点击一个选中状态的Toggle Button就会变为非选中状态，而点击一个组中选中状态的Radio Button则没有响应。
现在先花时间看一下代码片段例5-2。
例5-2组合Toggle Button到Group
Java
final ToggleGroup Group = new ToggleGroup();
ToggleButton tb1 = new ToggleButton("Minor");
tb1.setToggleGroup(Group);
tb1.setSelected(true);
ToggleButton tb2 = new ToggleButton("Major");
tb2.setToggleGroup(Group);
ToggleButton tb3 = new ToggleButton("Critical");
tb3.setToggleGroup(Group);
finalToggleGroupGroup=newToggleGroup();
ToggleButtontb1=newToggleButton("Minor");
tb1.setToggleGroup(Group);
tb1.setSelected(true);
ToggleButtontb2=newToggleButton("Major");
tb2.setToggleGroup(Group);
ToggleButtontb3=newToggleButton("Critical");
tb3.setToggleGroup(Group);
例5-2创建了三个Toggle Button，并添加到了一个Toggle Group中。为rb1 Toggle Button调用了setSelected方法，所以在应用程序启动时rb1是选中状态。但是你可以取消选中Minor Toggle
Button，以使应用程序启动时组中没有Toggle Button被选中，如图5-2。
图5-2三个Toggle
Button在一组
通常，你可以使用一组Toggle Button来为每个Button指定一个特定的行为。下一节会向你说明如何使用三个Toggle Button来改变一个矩形的颜色。
设置行为
ToggleButton类从Node类继承来的setUserData方法可以帮你为选中项关联一个特别的值。例5-3中，User Data指示了应该使用哪种颜色来绘制矩形。
例5-3为Toggle Button设置User Data
Java
tb1.setUserData(Color.LIGHTGREEN);
tb2.setUserData(Color.LIGHTBLUE);
tb3.setUserData(Color.SALMON);
Rectangle rect = new Rectangle();
rect.setHeight(50);
rect.setFill(Color.WHITE);
rect.setStroke(Color.DARKGRAY);
rect.setStrokeWidth(2);
rect.setArcHeight(10);
rect.setArcWidth(10);
final ToggleGroup Group = new ToggleGroup();
Group.selectedToggleProperty().addListener(
(ObservableValue extends Toggle> ov,
Toggle toggle, Toggle new_toggle) -> {
if (new_toggle == null)
rect.setFill(Color.WHITE);
else
rect.setFill((Color) Group.getSelectedToggle().getUserData());
});
rect.setWidth(hbox.getWidth());
tb1.setUserData(Color.LIGHTGREEN);
tb2.setUserData(Color.LIGHTBLUE);
tb3.setUserData(Color.SALMON);
Rectanglerect=newRectangle();
rect.setHeight(50);
rect.setFill(Color.WHITE);
rect.setStroke(Color.DARKGRAY);
rect.setStrokeWidth(2);
rect.setArcHeight(10);
rect.setArcWidth(10);
finalToggleGroupGroup=newToggleGroup();
Group.selectedToggleProperty().addListener(
(ObservableValue<?extendsToggle>ov,
Toggletoggle,Togglenew_toggle)->{
if(new_toggle==null)
rect.setFill(Color.WHITE);
else
rect.setFill((Color)Group.getSelectedToggle().getUserData());
});
rect.setWidth(hbox.getWidth());
ChangeListener对象监听组中的选中项。如果没有Toggle Button被选中，矩形就绘制成白色。如果其中一个Toggle Button被选中，连续调用getSelectedToggle和getUserData方法会返回一个Color来绘制矩形。
例如，如果用户选中了tb2 Toggle Button，getSelectedToggle().getUserData()方法将会返回Color.LIGHTBLUE，运行结果如图5-3。
图5-3使用Toggle Button绘制Rectangle
应用程序完整的代码见ToggleButtonSample.java文件。
为Toggle Button设置样式
你可以为Toggle Button添加CSS样式来加强你的应用程序。在JavaFX应用程序中使用CSS和在HTML中使用类似，因为这两者都是基于相同的CSS规范。
首先，你要在ControlStyle.css文件中为Toggle Button声明样式，如例5-4。
例5-4为Toggle Button声明不同的颜色
Java
.toggle-button1{
-fx-base: lightgreen;
}
.toggle-button2{
-fx-base: lightblue;
}
.toggle-button3{
-fx-base: salmon;
}
.toggle-button1{
-fx-base:lightgreen;
}
.toggle-button2{
-fx-base:lightblue;
}
.toggle-button3{
-fx-base:salmon;
}
其次，在ToggleButtonSample应用程序中启用这些样式，见例5-5中的实现。
例5-5为Toggle Button启用CSS样式
Java
scene.getStylesheets().add("togglebuttonsample/ControlStyle.css");
tb1.getStyleClass().add("toggle-button1");
tb2.getStyleClass().add("toggle-button2");
tb3.getStyleClass().add("toggle-button3");
scene.getStylesheets().add("togglebuttonsample/ControlStyle.css");
tb1.getStyleClass().add("toggle-button1");
tb2.getStyleClass().add("toggle-button2");
tb3.getStyleClass().add("toggle-button3");
当把这些代码添加到应用程序后，将会改变Toggle Button的显示效果，如图5-4。
图5-4绘制Toggle Button
你可能想尝试一下ToggleButton类的其他CSS属性，或者应用动画、变换以及其他JavaFX API中的可视化特效。
相关的API文档
·ToggleButton
·ToggleGroup
