javafx
Szenenbildner

Einführung

Bemerkungen

Grundlegendes JavaFX-Projekt mit FXML

Dies ist ein Basisprojekt, das FXML verwendet, das mit NetBeans erstellt wurde (Neues Projekt -> JavaFX -> JavaFX FXML-Anwendung). Es enthält nur drei Dateien:

Hauptanwendungsklasse

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

FXML-Datei

<?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>

Regler

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!");
    }

}

Lauf

Beim Erstellen und Ausführen des Projekts sollte ein kleines Fenster mit einer anklickbaren Schaltfläche angezeigt werden:

Wie es funktioniert

Kurz gesagt lädt der FXMLLoader in der Hauptanwendungsklasse basicFXML.fxml aus dem jar / FXMLLoader.load(getClass().getResource("BasicFXML.fxml")) , wie von FXMLLoader.load(getClass().getResource("BasicFXML.fxml")) .

Beim Laden von basicFXML.fxml findet der Loader den Namen der Controller-Klasse, wie in fx:controller="org.stackoverflow.BasicFXMLController" in der FXML angegeben.

Dann erstellt der Loader eine Instanz dieser Klasse, in der versucht wird, alle Objekte @FXML , die eine fx:id in der FXML haben und in der Controller-Klasse mit der @FXML FXML-Annotation gekennzeichnet sind.

In diesem Beispiel erstellt der FXMLLoader das Label basierend auf <Label ... fx:id="label"/> und @FXML private Label label; die @FXML private Label label; in das @FXML private Label label; des @FXML private Label label; .

Wenn die gesamte FXML geladen ist, ruft der FXMLLoader schließlich die initialize des Controllers auf, und der Code, der einen Aktionshandler mit der Schaltfläche registriert, wird ausgeführt.

Bearbeitung

Die FXML-Datei kann zwar innerhalb der IDE bearbeitet werden, wird jedoch nicht empfohlen, da die IDE nur eine grundlegende Syntaxprüfung und automatische Vervollständigung, jedoch keine visuelle Anleitung bietet.

Am besten öffnen Sie die FXML-Datei mit Scene Builder, in dem alle Änderungen in der Datei gespeichert werden.

Der Scene Builder kann gestartet werden, um die Datei zu öffnen:

Oder die Datei kann mit Scene Builder direkt von der IDE aus geöffnet werden:

• Doppelklicken Sie in NetBeans auf der Registerkarte "Projekt" auf die Datei oder klicken Sie mit der rechten Maustaste und wählen Sie " Open .
• Klicken Sie in IntelliJ auf der Registerkarte "Projekt" mit der rechten Maustaste auf die Datei und wählen Sie " Open In Scene Builder .
• Klicken Sie in Eclipse auf der Registerkarte "Projekt" mit der rechten Maustaste auf die Datei und wählen Sie " Open with Scene Builder .

Wenn Scene Builder ordnungsgemäß installiert und der Pfad zur IDE hinzugefügt wurde (siehe Anmerkungen unten), wird die Datei geöffnet:

Sie können Änderungen vornehmen, indem Sie neue Container oder neue Steuerelemente aus den linken Bereichen ziehen. Eigenschaften und Layoutwerte können in den rechten Bereichen geändert werden.

Beachten Sie, dass eines der ID-Tags, das das Injizieren der FXML in den Java-Code ermöglicht, fx:id . Es kann in der festgelegt werden - Code - Fenster:

Speichern Sie die Datei nach dem Anwenden der Änderungen (Scene Builder -> Datei -> Speichern). Wenn Sie Änderungen an der Datei über die IDE vornehmen, werden diese beim Speichern der Datei in Scene Builder aktualisiert.