ダイアログの使い方

ここでは特にButtonTypeボタンの有無による動作の違いについて述べる。

Converting ButtonType to Return Type

Dialogの型パラメータはDialogの返り値を示すはずだが、ボタンをつけると全く意味がなくなる。以下のresultはString型のはずだが、そのままではButtonTypeが返されてしまうため、ClassCastExceptionが発生する。この場合ResultConverterの設定が必要。

Type Parameter of Dialog class should designate the return type of it. But if you use some buttons, it has no meaning. Actually the Dialog returns ButtonType. So the following code will occur ClassCastException. You need ResultConverter.

import java.util.*;

import javafx.application.*;
import javafx.scene.*;
import javafx.scene.control.*;
import javafx.stage.*;

public class DialogTest1 extends Dialog<String> {

  public DialogTest1() {
    Label label = new Label("test dialog");
    this.getDialogPane().setContent(label);
    this.getDialogPane().getButtonTypes().addAll(ButtonType.OK, ButtonType.CANCEL);
    // setResultConverter(type-> type == ButtonType.OK? "OK":"CANCEL");
  }
    
  public static class Kicker extends Application {
    DialogTest1 dialogTest = new DialogTest1();
    public void start(Stage stage) {
      Button open = new Button("open");
      open.setOnAction(a-> {        
        Optional<String> result = dialogTest.showAndWait();
        System.out.println("result " + result.orElse(null)); <-- Without ResultConverter, ClassCastException raised
      });
      stage.setScene(new Scene(open));
      stage.show();
    }
  }
  
  public static void main(String[] args) throws Exception {
    Kicker.launch(Kicker.class);
  }
}

ちなみに、ダイアログ表示中にEscapeキー押下すると、CANCELとみなされる。また、ResultConverterにてOKの時にnull値を返すと、それもCANCELとみなされる。

Hitting Escape key on the Dialog is regarded as CANCEL. Returning (String)null value when clicking OK button is also regarded as CANCEL.

Prevent closing when OK

OKボタンが押された時に条件が満たされない場合にクローズを拒否するには以下。

Prevent closing without condition fulfilled.

  public DialogTest1() {
    Label label = new Label("test dialog");
    this.getDialogPane().setContent(label);
    this.getDialogPane().getButtonTypes().addAll(ButtonType.OK, ButtonType.CANCEL);
    setResultConverter(type-> type == ButtonType.OK? null:"CANCEL");
    ((Button)getDialogPane().lookupButton(ButtonType.OK)).addEventFilter(ActionEvent.ACTION, e -> {
      if (true) e.consume(); 
    });
  }

Dialog without Buttons

ボタンの無いダイアログの場合、GUIからクローズする方法がなくなる。ダイアログウインドウのXボタンを押しても閉じない。プログラム的に閉じる必要があるが、これはresultPropertyを変更することで行うらしい。ただし、同じ値を設定しても何も起こらないので、表示前に初期化しておく。

There's no way to close a Dialog without buttons from GUI operation. Even if clicking dialog window's X button, it won' close. In this case, you should set resultProperty when it should be closed. Notice that setting the same value to resultProperty doesn't occur closing. So initialize it beforehand.

import java.util.*;

import javafx.application.*;
import javafx.scene.*;
import javafx.scene.control.*;
import javafx.stage.*;

public class DialogTest2 extends Dialog<String> {

  public DialogTest2() {
    Label label = new Label("test dialog");
    this.getDialogPane().setContent(label);
  }

  public static class Kicker extends Application {
    DialogTest2 dialogTest = new DialogTest2();
    public void start(Stage stage) {
      Button open = new Button("open");
      open.setOnAction(a-> {        
        new Thread() { public void run() {
          try { Thread.sleep(1000); } catch (InterruptedException ex) {}
          Platform.runLater(()-> dialogTest.setResult("CLOSED"));
        }}.start();
        dialogTest.setResult(null);
        Optional<String> result = dialogTest.showAndWait();
        System.out.println("result " + result.orElse(null));
      });
      stage.setScene(new Scene(open));
      stage.show();
    }
  }
  
  public static void main(String[] args) throws Exception {
    Kicker.launch(Kicker.class);
  }
}

Closing by Dialog window's X button

上とは逆にダイアログウインドウのXボタンで閉じたい場合には以下。

Contrary to the above, the following code closes the Dialog when Dialog window's X button clicked.

import java.util.*;

import javafx.application.*;
import javafx.scene.*;
import javafx.scene.control.*;
import javafx.stage.*;

public class DialogTest3 extends Dialog<String> {

  public DialogTest3() {
    Label label = new Label("test dialog");
    this.getDialogPane().setContent(label);
    Window window = getDialogPane().getScene().getWindow();
    window.setOnCloseRequest(event -> window.hide());
  }

  public static class Kicker extends Application {
    DialogTest3 dialogTest = new DialogTest3();
    public void start(Stage stage) {
      Button open = new Button("open");
      open.setOnAction(a-> {        
        Optional<String> result = dialogTest.showAndWait();
        System.out.println("result " + result.orElse(null));
      });
      stage.setScene(new Scene(open));
      stage.show();
    }
  }
  
  public static void main(String[] args) throws Exception {
    Kicker.launch(Kicker.class);
  }
}

Setting icon to Dialog

ダイアログのウインドウを取得すると、それはStageなのでStageと同様にiconを設定できる。

If you get the Window of a Dialog, it should be a Stage. So you can set icon to it.

  Stage stage = (Stage)dialog.getDialogPane().getScene().getWindow();
  stage.getIcons().add(iconImage);

stylesheetsはDialogPaneにある。 Stylesheets is in DialogPane.

   ObservableList<String> stylesheets = dialog.getDialogPane().getStylesheets()