javafx
Scene Builder

introduzione

Osservazioni

Progetto JavaFX di base tramite FXML

Questo è un progetto di base che utilizza FXML, creato con NetBeans (Nuovo progetto -> JavaFX -> Applicazione FXML JavaFX). Contiene solo tre file:

Principali classi di applicazione

package org.stackoverflow;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;

public class BasicApplication extends Application {

    @Override
    public void start(Stage stage) throws Exception {
        Parent root = FXMLLoader.load(getClass().getResource("BasicFXML.fxml"));

        Scene scene = new Scene(root);

        stage.setScene(scene);
        stage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

File FXML

<?xml version="1.0" encoding="UTF-8"?>

<?import java.lang.*?>
<?import java.util.*?>
<?import javafx.scene.*?>
<?import javafx.scene.control.*?>
<?import javafx.scene.layout.*?>

<AnchorPane id="AnchorPane" prefHeight="200" prefWidth="320" xmlns:fx="http://javafx.com/fxml/1" fx:controller="org.stackoverflow.BasicFXMLController">
    <children>
        <Button layoutX="126" layoutY="90" text="Click Me!" onAction="#handleButtonAction" fx:id="button" />
        <Label layoutX="126" layoutY="120" minHeight="16" minWidth="69" fx:id="label" />
    </children>
</AnchorPane>

controllore

package org.stackoverflow;

import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.scene.control.Label;

public class BasicFXMLController {

    @FXML
    private Label label;

    public void initialize() {
        // TODO
    }   

    @FXML
    private void handleButtonAction(ActionEvent event) {
        label.setText("Hello World!");
    }

}

Correre

Costruire ed eseguire il progetto dovrebbe visualizzare una piccola finestra con un pulsante cliccabile:

Come funziona

Brevemente, nella classe principale dell'applicazione, FXMLLoader caricherà basicFXML.fxml dal jar / classpath, come specificato da FXMLLoader.load(getClass().getResource("BasicFXML.fxml")) .

Quando si carica basicFXML.fxml , il loader troverà il nome della classe controller, come specificato da fx:controller="org.stackoverflow.BasicFXMLController" in FXML.

Quindi il loader creerà un'istanza di quella classe, in cui proverà a iniettare tutti gli oggetti che hanno un fx:id nel FXML e sono contrassegnati con l'annotazione @FXML nella classe controller.

In questo esempio, FXMLLoader creerà l'etichetta basata su <Label ... fx:id="label"/> e inietterà l'istanza @FXML private Label label; .

Infine, quando l'intero FXML è stato caricato, FXMLLoader chiamerà il metodo di initialize del controller e verrà eseguito il codice che registra un gestore di azioni con il pulsante.

La modifica

Sebbene il file FXML possa essere modificato all'interno dell'IDE, non è consigliabile, poiché l'IDE fornisce solo il controllo sintattico di base e il completamento automatico, ma non la guida visiva.

L'approccio migliore è aprire il file FXML con Scene Builder, in cui tutte le modifiche verranno salvate nel file.

È possibile avviare Scene Builder per aprire il file:

O il file può essere aperto con Scene Builder direttamente dall'IDE:

• Da NetBeans, nella scheda del progetto, fare doppio clic sul file o fare clic con il tasto destro e selezionare Open .
• Da IntelliJ, nella scheda del progetto, fai clic con il pulsante destro del mouse sul file e seleziona Open In Scene Builder .
• Da Eclipse, nella scheda del progetto, fare clic con il tasto destro sul file e selezionare Open with Scene Builder .

Se Scene Builder è installato correttamente e il suo percorso viene aggiunto all'IDE (vedi Note sotto), verrà aperto il file:

Le modifiche possono essere apportate trascinando nuovi contenitori o nuovi controlli dai riquadri di sinistra e le proprietà e i valori di layout possono essere modificati nei riquadri di destra.

Si noti che uno dei tag id che consente l'iniezione di FXML nel codice Java è fx:id . Può essere impostato nel riquadro Code :

Dopo aver applicato le modifiche, salvare il file (Scene Builder -> File -> Salva). Se vengono apportate modifiche alla modifica del file dall'IDE, al momento del salvataggio del file, queste verranno aggiornate in Scene Builder.