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));

1

2

3

4

5

6

7

//一个不带任何文本或图标的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);

1

2

3

4

5

6

7

8

9

10

11

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());

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

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;

}

1

2

3

4

5

6

7

8

9

10

11

.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");

1

2

3

4

5

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

打赏一下

支付宝

微信