This document introduces JavaFX dialogs, including alert dialogs that return button types, text input dialogs that return input text, and choice dialogs that return selected items. It discusses creating and configuring dialogs, setting properties, showing dialogs modally or non-modally, and handling results. Tips are provided on resizing dialogs and creating simple dialog-based applications. In conclusion, dialogs represent pop-up windows in JavaFX and are shown using the showAndWait() method after configuration.

1. Introduction to
JavaFX Dialogs
HASUNUMA Kenji
k.hasunuma@coppermine.jp
@khasunuma

2. Overview

3. JavaFX Dialogs (8u40)
• Alert - returns any ButtonType
• TextInputDialog - returns input text
• ChoiceDialog - returns choosen item
• Dialog - superclass of all dialogs

4. Alert - INFORMATION

5. Alert - WARNING

6. Alert - ERROR

7. Alert - CONFIRMATION

8. Alert - NONE

9. TextInputDialog

10. ChoiceDialog

11. Usage

12. Dialog on code
• Works instead of Stage.
• Often, exists into a controller as a part of
event procedures.
• showAndWait() - show and wait, then
returns a value as Optional<R>.
• show() - show and wait, then returns no
value.

13. Layout
DialogPane
ButtonTypes
Graphic
HeaderText
ContentText
Dialog

14. // Create a dialog
Alert alert = new Alert(INFORMATION);
!
// Setting properties
alert.setTitle("Title (INFORMATION)");
alert.setHeaderText("Header Text");
alert.setContentText("Content Text");
!
// Show and obtain the result
Optional<ButtonType> result
= alert.showAndWait();
!
// Another way if the result is needless
// alert.show();

15. Result types
Dialog Result type
Alert
ButtonType
!
OK, CANCEL, CLOSE, APPLY,
FINISH, YES, NO, NEXT, PREVIOUS
TextInputDialog String
ChoiceDialog Type of choosen item

16. Tips

17. I want such a dialog...
How?

18. I want such a dialog...
How?
// Add following code
alert.setHeaderText(null);

19. /**
* Tips #2: the way to resize a dialog.
*/
public class SomeController {
@FXML
public void onClick(ActionEvent event) {
. . .
Alert alert = new Alert(INFORMATION);
// Using following methods to resize;
// setPrefWidth, setPrefHeight and setPrefSize
alert.getDialogPane().setPrefSize(400.0, 300.0);
Optional<String> result = dialog.showAndWait();
/* Handle the result */
}
}

20. /**
* Tips #3: Simple dialog-based application.
*/
public class DialogApp extends Application {
@Overrides
public void start(Stage stage) throws Exception {
TextInputDialog dialog = new TextInputDialog();
/* setting the dialog */
Optional<String> result = dialog.showAndWait();
/* handle the result */
}
public static void main(String...args) {
launch(args);
}
}

21. Conclusion

22. • The representation of JavaFX dialogs
are Dialog and their subclasses.
• JavaFX Dialog looks like Stage, but is
not Stage.
• At first create and configure a dialog,
and call showAndWait method.

23. Introduction to
JavaFX Dialogs
HASUNUMA Kenji
k.hasunuma@coppermine.jp
@khasunuma