javafx
Scenbyggare

Introduktion

Anmärkningar

Grundläggande JavaFX-projekt med FXML

Detta är ett grundläggande projekt som använder FXML, skapat med NetBeans (Nytt projekt -> JavaFX -> JavaFX FXML-applikation). Den innehåller bara tre filer:

Huvudsaklig applikationsklass

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

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

Kontrollant

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

}

Springa

Att bygga och driva projektet bör visa ett litet fönster med en klickbar knapp:

Hur det fungerar

Kortfattat, i huvudklassen för applikation, kommer FXMLLoader att ladda basicFXML.fxml från burken / klassvägen, som anges av FXMLLoader.load(getClass().getResource("BasicFXML.fxml")) .

När du laddar basicFXML.fxml lastaren namnet på kontrollerklassen, som anges av fx:controller="org.stackoverflow.BasicFXMLController" i FXML.

Sedan kommer lastaren att skapa en instans av den klassen där den kommer att försöka injicera alla objekt som har en fx:id i FXML och är markerade med @FXML anteckningen i kontrollklassen.

I det här exemplet skapar FXMLLoader etiketten baserad på <Label ... fx:id="label"/> , och den kommer att injicera etikettinstansen i den @FXML private Label label; .

Slutligen, när hela FXML har laddats, kommer FXMLLoader att anropa kontrollerns initialize , och koden som registrerar en åtgärdshanterare med knappen kommer att köras.

redigera

Medan FXML-filen kan redigeras inom IDE, rekommenderas den inte, eftersom IDE ger bara grundläggande syntaxkontroll och autofyllt, men inte visuell vägledning.

Det bästa sättet är att öppna FXML-filen med Scene Builder, där alla ändringar sparas i filen.

Scen Builder kan startas för att öppna filen:

Eller så kan filen öppnas med Scene Builder direkt från IDE:

• Från NetBeans, på projektfliken, dubbelklicka på filen eller högerklicka och välj Open .
• Från IntelliJ, på projektfliken, högerklicka på filen och välj Open In Scene Builder .
• Från Eclipse, på projektfliken, högerklicka på filen och välj Open with Scene Builder .

Om Scen Builder är korrekt installerad och dess sökväg läggs till IDE (se anmärkningar nedan) öppnar den filen:

Ändringar kan göras genom att dra nya behållare eller nya kontroller från de vänstra rutorna, och egenskaper och layoutvärden kan ändras på de högra rutorna.

Observera att en av id-taggen som gör det möjligt att injicera FXML i Java-koden är fx:id . Det kan ställas in i Code rutan:

Spara filen efter Scenebyggare -> Fil -> Spara. Om ändringar görs när du redigerar filen från IDE, kommer de att uppdateras på Scene Builder när du sparar filen.