Package javafx.scene

Class Scene

java.lang.Object
javafx.scene.Scene
All Implemented Interfaces:
EventTarget

@DefaultProperty("root") public class Scene extends Object implements EventTarget
The JavaFX Scene class is the container for all content in a scene graph. The background of the scene is filled as specified by the fill property.

The application must specify the root Node for the scene graph by setting the root property. If a Group is used as the root, the contents of the scene graph will be clipped by the scene's width and height and changes to the scene's size (if user resizes the stage) will not alter the layout of the scene graph. If a resizable node (layout Region or Control) is set as the root, then the root's size will track the scene's size, causing the contents to be relayed out as necessary.

The scene's size may be initialized by the application during construction. If no size is specified, the scene will automatically compute its initial size based on the preferred size of its content. If only one dimension is specified, the other dimension is computed using the specified dimension, respecting content bias of a root.

An application may request depth buffer support or scene anti-aliasing support at the creation of a Scene. A scene with only 2D shapes and without any 3D transforms does not need a depth buffer nor scene anti-aliasing support. A scene containing 3D shapes or 2D shapes with 3D transforms may use depth buffer support for proper depth sorted rendering; to avoid depth fighting (also known as Z fighting), disable depth testing on 2D shapes that have no 3D transforms. See depthTest for more information. A scene with 3D shapes may enable scene anti-aliasing to improve its rendering quality.

The depthBuffer and antiAliasing flags are conditional features. With the respective default values of: false and SceneAntialiasing.DISABLED. See ConditionalFeature.SCENE3D for more information.

A default headlight will be added to a scene that contains one or more Shape3D nodes, but no light nodes. This light source is a Color.WHITE PointLight placed at the camera position.

A Scene may be created and modified on any thread until it is attached to a Window that is showing. After that, it must be modified only on the JavaFX Application Thread. Note that Scene is not thread-safe; modifying a Scene on multiple threads at the same time will lead to unpredictable results and must be avoided.

The JavaFX Application Thread is created as part of the startup process for the JavaFX runtime. See the Application class and the Platform.startup(Runnable) method for more information.

Example:

import javafx.scene.*;
import javafx.scene.paint.*;
import javafx.scene.shape.*;

Group root = new Group();
Scene s = new Scene(root, 300, 300, Color.BLACK);

Rectangle r = new Rectangle(25,25,250,250);
r.setFill(Color.BLUE);

root.getChildren().add(r);
 
Since:
JavaFX 2.0
  • Property Details

  • Constructor Details

    • Scene

      public Scene(Parent root)
      Creates a Scene for a specific root Node.
      Parameters:
      root - The root node of the scene graph
      Throws:
      NullPointerException - if root is null
    • Scene

      public Scene(Parent root, double width, double height)
      Creates a Scene for a specific root Node with a specific size.
      Parameters:
      root - The root node of the scene graph
      width - The width of the scene
      height - The height of the scene
      Throws:
      NullPointerException - if root is null
    • Scene

      public Scene(Parent root, Paint fill)
      Creates a Scene for a specific root Node with a fill.
      Parameters:
      root - The parent
      fill - The fill
      Throws:
      NullPointerException - if root is null
    • Scene

      public Scene(Parent root, double width, double height, Paint fill)
      Creates a Scene for a specific root Node with a specific size and fill.
      Parameters:
      root - The root node of the scene graph
      width - The width of the scene
      height - The height of the scene
      fill - The fill
      Throws:
      NullPointerException - if root is null
    • Scene

      public Scene(Parent root, double width, double height, boolean depthBuffer)
      Constructs a scene consisting of a root, with a dimension of width and height, and specifies whether a depth buffer is created for this scene.

      A scene with only 2D shapes and without any 3D transforms does not need a depth buffer. A scene containing 3D shapes or 2D shapes with 3D transforms may use depth buffer support for proper depth sorted rendering; to avoid depth fighting (also known as Z fighting), disable depth testing on 2D shapes that have no 3D transforms. See depthTest for more information.

      Parameters:
      root - The root node of the scene graph
      width - The width of the scene
      height - The height of the scene
      depthBuffer - The depth buffer flag

      The depthBuffer flag is a conditional feature and its default value is false. See ConditionalFeature.SCENE3D for more information.

      Throws:
      NullPointerException - if root is null
      See Also:
    • Scene

      public Scene(Parent root, double width, double height, boolean depthBuffer, SceneAntialiasing antiAliasing)
      Constructs a scene consisting of a root, with a dimension of width and height, specifies whether a depth buffer is created for this scene and specifies whether scene anti-aliasing is requested.

      A scene with only 2D shapes and without any 3D transforms does not need a depth buffer nor scene anti-aliasing support. A scene containing 3D shapes or 2D shapes with 3D transforms may use depth buffer support for proper depth sorted rendering; to avoid depth fighting (also known as Z fighting), disable depth testing on 2D shapes that have no 3D transforms. See depthTest for more information. A scene with 3D shapes may enable scene anti-aliasing to improve its rendering quality.

      Parameters:
      root - The root node of the scene graph
      width - The width of the scene
      height - The height of the scene
      depthBuffer - The depth buffer flag
      antiAliasing - The scene anti-aliasing attribute. A value of null is treated as DISABLED.

      The depthBuffer and antiAliasing are conditional features. With the respective default values of: false and SceneAntialiasing.DISABLED. See ConditionalFeature.SCENE3D for more information.

      Throws:
      NullPointerException - if root is null
      Since:
      JavaFX 8.0
      See Also:
  • Method Details

    • addPreLayoutPulseListener

      public final void addPreLayoutPulseListener(Runnable r)
      Adds a new scene pre layout pulse listener to this scene. Every time a pulse occurs, this listener will be called on the JavaFX Application Thread directly before the CSS and layout passes, and also before any rendering is done for this frame. This scene pulse listener is suitable for knowing when a scenegraph pulse is happening and also for modifying the scenegraph (as it is called before CSS and layout, so any changes made will be properly styled and positioned). This method must be called on the JavaFX Application thread.
      Parameters:
      r - The Runnable to be called when the pulse occurs.
      Throws:
      IllegalStateException - if this method is called on a thread other than the JavaFX Application Thread.
      NullPointerException - if the provided Runnable is null.
      Since:
      9
    • removePreLayoutPulseListener

      public final void removePreLayoutPulseListener(Runnable r)
      Removes a previously registered scene pre layout pulse listener from listening to pulses in this scene. This method does nothing if the specified Runnable is not already in the list. This method must be called on the JavaFX Application thread.
      Parameters:
      r - The Runnable that should no longer be called when the pulse occurs for this scene.
      Throws:
      IllegalStateException - if this method is called on a thread other than the JavaFX Application Thread.
      Since:
      9
    • addPostLayoutPulseListener

      public final void addPostLayoutPulseListener(Runnable r)
      Adds a new scene post layout pulse listener to this scene. Every time a pulse occurs, this listener will be called on the JavaFX Application Thread directly after the CSS and layout passes, but before any rendering is done for this frame. This scene pulse listener is suitable for knowing when a scenegraph pulse is happening, but it is not suited to use cases related to modifying the scenegraph (as it is called after CSS and layout, so any changes will possibly be incorrect until the next pulse is run). An alternative (and better) solution for situations where a scenegraph modification is required to happen is to use either the addPreLayoutPulseListener(Runnable) API or the the AnimationTimer API. This method must be called on the JavaFX Application thread.
      Parameters:
      r - The Runnable to be called when the pulse occurs.
      Throws:
      IllegalStateException - if this method is called on a thread other than the JavaFX Application Thread.
      NullPointerException - if the provided Runnable is null.
      Since:
      9
    • removePostLayoutPulseListener

      public final void removePostLayoutPulseListener(Runnable r)
      Removes a previously registered scene post layout pulse listener from listening to pulses in this scene. This method does nothing if the specified Runnable is not already in the list. This method must be called on the JavaFX Application thread.
      Parameters:
      r - The Runnable that should no longer be called when the pulse occurs for this scene.
      Throws:
      IllegalStateException - if this method is called on a thread other than the JavaFX Application Thread.
      Since:
      9
    • getAntiAliasing

      public final SceneAntialiasing getAntiAliasing()
      Return the defined SceneAntialiasing for this Scene.

      Note: this is a conditional feature. See ConditionalFeature.SCENE3D and SceneAntialiasing for more information.

      Returns:
      the SceneAntialiasing for this scene
      Since:
      JavaFX 8.0
    • getWindow

      public final Window getWindow()
      Gets the value of the window property.
      Property description:
      The Window for this Scene
      Returns:
      the value of the window property
      See Also:
    • windowProperty

      public final ReadOnlyObjectProperty<Window> windowProperty()
      The Window for this Scene
      Returns:
      the window property
      See Also:
    • getX

      public final double getX()
      Gets the value of the x property.
      Property description:
      The horizontal location of this Scene on the Window.
      Returns:
      the value of the x property
      See Also:
    • xProperty

      public final ReadOnlyDoubleProperty xProperty()
      The horizontal location of this Scene on the Window.
      Returns:
      the x property
      See Also:
    • getY

      public final double getY()
      Gets the value of the y property.
      Property description:
      The vertical location of this Scene on the Window.
      Returns:
      the value of the y property
      See Also:
    • yProperty

      public final ReadOnlyDoubleProperty yProperty()
      The vertical location of this Scene on the Window.
      Returns:
      the y property
      See Also:
    • getWidth

      public final double getWidth()
      Gets the value of the width property.
      Property description:
      The width of this Scene
      Returns:
      the value of the width property
      See Also:
    • widthProperty

      public final ReadOnlyDoubleProperty widthProperty()
      The width of this Scene
      Returns:
      the width property
      See Also:
    • getHeight

      public final double getHeight()
      Gets the value of the height property.
      Property description:
      The height of this Scene
      Returns:
      the value of the height property
      See Also:
    • heightProperty

      public final ReadOnlyDoubleProperty heightProperty()
      The height of this Scene
      Returns:
      the height property
      See Also:
    • setCamera

      public final void setCamera(Camera value)
      Sets the value of the camera property.
      Property description:
      Specifies the type of camera use for rendering this Scene. If camera is null, a parallel camera is used for rendering. It is illegal to set a camera that belongs to other Scene or SubScene.

      Note: this is a conditional feature. See ConditionalFeature.SCENE3D for more information.

      Default value:
      null
      Parameters:
      value - the value for the camera property
      See Also:
    • getCamera

      public final Camera getCamera()
      Gets the value of the camera property.
      Property description:
      Specifies the type of camera use for rendering this Scene. If camera is null, a parallel camera is used for rendering. It is illegal to set a camera that belongs to other Scene or SubScene.

      Note: this is a conditional feature. See ConditionalFeature.SCENE3D for more information.

      Default value:
      null
      Returns:
      the value of the camera property
      See Also:
    • cameraProperty

      public final ObjectProperty<Camera> cameraProperty()
      Specifies the type of camera use for rendering this Scene. If camera is null, a parallel camera is used for rendering. It is illegal to set a camera that belongs to other Scene or SubScene.

      Note: this is a conditional feature. See ConditionalFeature.SCENE3D for more information.

      Default value:
      null
      Returns:
      the camera property
      See Also:
    • setFill

      public final void setFill(Paint value)
      Sets the value of the fill property.
      Property description:
      Defines the background fill of this Scene. Both a null value meaning 'paint no background' and a Paint with transparency are supported. The default fill of the Scene is Color.WHITE, but it is more commonly the case that the initial color shown to users is the background fill of the root node of the Scene, as it typically is stretched to take up all available space in the Scene. The root node of the Scene is given the CSS style class 'root', and the default user agent stylesheets that ship with JavaFX (presently Caspian and Modena) apply styling on to this root style class. In the case of Caspian this does not impact the background fill color of the root node, but in the case of Modena the default fill is set to be a light gray color.
      Default value:
      WHITE
      Parameters:
      value - the value for the fill property
      See Also:
    • getFill

      public final Paint getFill()
      Gets the value of the fill property.
      Property description:
      Defines the background fill of this Scene. Both a null value meaning 'paint no background' and a Paint with transparency are supported. The default fill of the Scene is Color.WHITE, but it is more commonly the case that the initial color shown to users is the background fill of the root node of the Scene, as it typically is stretched to take up all available space in the Scene. The root node of the Scene is given the CSS style class 'root', and the default user agent stylesheets that ship with JavaFX (presently Caspian and Modena) apply styling on to this root style class. In the case of Caspian this does not impact the background fill color of the root node, but in the case of Modena the default fill is set to be a light gray color.
      Default value:
      WHITE
      Returns:
      the value of the fill property
      See Also:
    • fillProperty

      public final ObjectProperty<Paint> fillProperty()
      Defines the background fill of this Scene. Both a null value meaning 'paint no background' and a Paint with transparency are supported. The default fill of the Scene is Color.WHITE, but it is more commonly the case that the initial color shown to users is the background fill of the root node of the Scene, as it typically is stretched to take up all available space in the Scene. The root node of the Scene is given the CSS style class 'root', and the default user agent stylesheets that ship with JavaFX (presently Caspian and Modena) apply styling on to this root style class. In the case of Caspian this does not impact the background fill color of the root node, but in the case of Modena the default fill is set to be a light gray color.
      Default value:
      WHITE
      Returns:
      the fill property
      See Also:
    • setRoot

      public final void setRoot(Parent value)
      Sets the value of the root property.
      Property description:
      Defines the root Node of the scene graph. If a Group is used as the root, the contents of the scene graph will be clipped by the scene's width and height and changes to the scene's size (if user resizes the stage) will not alter the layout of the scene graph. If a resizable node (layout Region or Control) is set as the root, then the root's size will track the scene's size, causing the contents to be relayed out as necessary. Scene doesn't accept null root.
      Parameters:
      value - the value for the root property
      See Also:
    • getRoot

      public final Parent getRoot()
      Gets the value of the root property.
      Property description:
      Defines the root Node of the scene graph. If a Group is used as the root, the contents of the scene graph will be clipped by the scene's width and height and changes to the scene's size (if user resizes the stage) will not alter the layout of the scene graph. If a resizable node (layout Region or Control) is set as the root, then the root's size will track the scene's size, causing the contents to be relayed out as necessary. Scene doesn't accept null root.
      Returns:
      the value of the root property
      See Also:
    • rootProperty

      public final ObjectProperty<Parent> rootProperty()
      Defines the root Node of the scene graph. If a Group is used as the root, the contents of the scene graph will be clipped by the scene's width and height and changes to the scene's size (if user resizes the stage) will not alter the layout of the scene graph. If a resizable node (layout Region or Control) is set as the root, then the root's size will track the scene's size, causing the contents to be relayed out as necessary. Scene doesn't accept null root.
      Returns:
      the root property
      See Also:
    • snapshot

      public WritableImage snapshot(WritableImage image)
      Takes a snapshot of this scene and returns the rendered image when it is ready. CSS and layout processing will be done for the scene prior to rendering it. The entire destination image is cleared using the fill Paint of this scene. The nodes in the scene are then rendered to the image. The point (0,0) in scene coordinates is mapped to (0,0) in the image. If the image is smaller than the size of the scene, then the rendering will be clipped by the image.

      When taking a snapshot of a scene that is being animated, either explicitly by the application or implicitly (such as chart animation), the snapshot will be rendered based on the state of the scene graph at the moment the snapshot is taken and will not reflect any subsequent animation changes.

      Parameters:
      image - the writable image that will be used to hold the rendered scene. It may be null in which case a new WritableImage will be constructed. If the image is non-null, the scene will be rendered into the existing image. In this case, the width and height of the image determine the area that is rendered instead of the width and height of the scene.
      Returns:
      the rendered image
      Throws:
      IllegalStateException - if this method is called on a thread other than the JavaFX Application Thread.
      Since:
      JavaFX 2.2
    • snapshot

      public void snapshot(Callback<SnapshotResult,Void> callback, WritableImage image)
      Takes a snapshot of this scene at the next frame and calls the specified callback method when the image is ready. CSS and layout processing will be done for the scene prior to rendering it. The entire destination image is cleared using the fill Paint of this scene. The nodes in the scene are then rendered to the image. The point (0,0) in scene coordinates is mapped to (0,0) in the image. If the image is smaller than the size of the scene, then the rendering will be clipped by the image.

      This is an asynchronous call, which means that other events or animation might be processed before the scene is rendered. If any such events modify a node in the scene that modification will be reflected in the rendered image (as it will also be reflected in the frame rendered to the Stage).

      When taking a snapshot of a scene that is being animated, either explicitly by the application or implicitly (such as chart animation), the snapshot will be rendered based on the state of the scene graph at the moment the snapshot is taken and will not reflect any subsequent animation changes.

      Parameters:
      callback - a class whose call method will be called when the image is ready. The SnapshotResult that is passed into the call method of the callback will contain the rendered image and the source scene that was rendered. The callback parameter must not be null.
      image - the writable image that will be used to hold the rendered scene. It may be null in which case a new WritableImage will be constructed. If the image is non-null, the scene will be rendered into the existing image. In this case, the width and height of the image determine the area that is rendered instead of the width and height of the scene.
      Throws:
      IllegalStateException - if this method is called on a thread other than the JavaFX Application Thread.
      NullPointerException - if the callback parameter is null.
      Since:
      JavaFX 2.2
    • setCursor

      public final void setCursor(Cursor value)
      Sets the value of the cursor property.
      Property description:
      Defines the mouse cursor for this Scene.
      Parameters:
      value - the value for the cursor property
      See Also:
    • getCursor

      public final Cursor getCursor()
      Gets the value of the cursor property.
      Property description:
      Defines the mouse cursor for this Scene.
      Returns:
      the value of the cursor property
      See Also:
    • cursorProperty

      public final ObjectProperty<Cursor> cursorProperty()
      Defines the mouse cursor for this Scene.
      Returns:
      the cursor property
      See Also:
    • lookup

      public Node lookup(String selector)
      Looks for any node within the scene graph based on the specified CSS selector. If more than one node matches the specified selector, this function returns the first of them. If no nodes are found with this id, then null is returned.
      Parameters:
      selector - The css selector to look up
      Returns:
      the Node in the scene which matches the CSS selector, or null if none is found.
    • getStylesheets

      public final ObservableList<String> getStylesheets()
      Gets an observable list of string URLs linking to the stylesheets to use with this scene's contents.

      The URL is a hierarchical URI of the form [scheme:][//authority][path]. If the URL does not have a [scheme:] component, the URL is considered to be the [path] component only. Any leading '/' character of the [path] is ignored and the [path] is treated as a path relative to the root of the application's classpath.

      The RFC 2397 "data" scheme for URLs is supported in addition to the protocol handlers that are registered for the application. If a URL uses the "data" scheme and the MIME type is either empty, "text/plain", or "text/css", the payload will be interpreted as a CSS file. If the MIME type is "application/octet-stream", the payload will be interpreted as a binary CSS file (see Stylesheet.convertToBinary(File, File)).

      
      
       package com.example.javafx.app;
      
       import javafx.application.Application;
       import javafx.scene.Group;
       import javafx.scene.Scene;
       import javafx.stage.Stage;
      
       public class MyApp extends Application {
      
           @Override public void start(Stage stage) {
               Scene scene = new Scene(new Group());
               scene.getStylesheets().add("/com/example/javafx/app/mystyles.css");
               stage.setScene(scene);
               stage.show();
           }
      
           public static void main(String[] args) {
               launch(args);
           }
       }
       
      For additional information about using CSS with the scene graph, see the CSS Reference Guide.
      Returns:
      the list of stylesheets to use with this scene
    • userAgentStylesheetProperty

      public final ObjectProperty<String> userAgentStylesheetProperty()
      Gets the userAgentStylesheet property.
      Returns:
      the userAgentStylesheet property
      Since:
      JavaFX 8u20
      See Also:
    • getUserAgentStylesheet

      public final String getUserAgentStylesheet()
      Get the URL of the user-agent stylesheet that will be used by this Scene. If the URL has not been set, the platform-default user-agent stylesheet will be used.

      For additional information about using CSS with the scene graph, see the CSS Reference Guide.

      Returns:
      The URL of the user-agent stylesheet that will be used by this Scene, or null if has not been set.
      Since:
      JavaFX 8u20
    • setUserAgentStylesheet

      public final void setUserAgentStylesheet(String url)
      Set the URL of the user-agent stylesheet that will be used by this Scene in place of the the platform-default user-agent stylesheet. If the URL does not resolve to a valid location, the platform-default user-agent stylesheet will be used.

      The URL is a hierarchical URI of the form [scheme:][//authority][path]. If the URL does not have a [scheme:] component, the URL is considered to be the [path] component only. Any leading '/' character of the [path] is ignored and the [path] is treated as a path relative to the root of the application's classpath.

      The RFC 2397 "data" scheme for URLs is supported in addition to the protocol handlers that are registered for the application. If a URL uses the "data" scheme and the MIME type is either empty, "text/plain", or "text/css", the payload will be interpreted as a CSS file. If the MIME type is "application/octet-stream", the payload will be interpreted as a binary CSS file (see Stylesheet.convertToBinary(File, File)).

      For additional information about using CSS with the scene graph, see the CSS Reference Guide.

      Parameters:
      url - the URL of the user-agent stylesheet
      Since:
      JavaFX 8u20
    • isDepthBuffer

      public final boolean isDepthBuffer()
      Retrieves the depth buffer attribute for this scene.
      Returns:
      the depth buffer attribute.
    • getFocusOwner

      public final Node getFocusOwner()
      Gets the value of the focusOwner property.
      Property description:
      The scene's current focus owner node. This node's "focused" variable might be false if this scene has no window, or if the window is inactive (window.focused == false).
      Returns:
      the value of the focusOwner property
      Since:
      JavaFX 2.2
      See Also:
    • focusOwnerProperty

      public final ReadOnlyObjectProperty<Node> focusOwnerProperty()
      The scene's current focus owner node. This node's "focused" variable might be false if this scene has no window, or if the window is inactive (window.focused == false).
      Returns:
      the focusOwner property
      Since:
      JavaFX 2.2
      See Also:
    • setEventDispatcher

      public final void setEventDispatcher(EventDispatcher value)
      Sets the value of the eventDispatcher property.
      Property description:
      Specifies the event dispatcher for this scene. When replacing the value with a new EventDispatcher, the new dispatcher should forward events to the replaced dispatcher to keep the scene's default event handling behavior.
      Parameters:
      value - the value for the eventDispatcher property
      See Also:
    • getEventDispatcher

      public final EventDispatcher getEventDispatcher()
      Gets the value of the eventDispatcher property.
      Property description:
      Specifies the event dispatcher for this scene. When replacing the value with a new EventDispatcher, the new dispatcher should forward events to the replaced dispatcher to keep the scene's default event handling behavior.
      Returns:
      the value of the eventDispatcher property
      See Also:
    • eventDispatcherProperty

      public final ObjectProperty<EventDispatcher> eventDispatcherProperty()
      Specifies the event dispatcher for this scene. When replacing the value with a new EventDispatcher, the new dispatcher should forward events to the replaced dispatcher to keep the scene's default event handling behavior.
      Returns:
      the eventDispatcher property
      See Also:
    • addEventHandler

      public final <T extends Event> void addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
      Registers an event handler to this scene. The handler is called when the scene receives an Event of the specified type during the bubbling phase of event delivery.
      Type Parameters:
      T - the specific event class of the handler
      Parameters:
      eventType - the type of the events to receive by the handler
      eventHandler - the handler to register
      Throws:
      NullPointerException - if the event type or handler is null
    • removeEventHandler

      public final <T extends Event> void removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
      Unregisters a previously registered event handler from this scene. One handler might have been registered for different event types, so the caller needs to specify the particular event type from which to unregister the handler.
      Type Parameters:
      T - the specific event class of the handler
      Parameters:
      eventType - the event type from which to unregister
      eventHandler - the handler to unregister
      Throws:
      NullPointerException - if the event type or handler is null
    • addEventFilter

      public final <T extends Event> void addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
      Registers an event filter to this scene. The filter is called when the scene receives an Event of the specified type during the capturing phase of event delivery.
      Type Parameters:
      T - the specific event class of the filter
      Parameters:
      eventType - the type of the events to receive by the filter
      eventFilter - the filter to register
      Throws:
      NullPointerException - if the event type or filter is null
    • removeEventFilter

      public final <T extends Event> void removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
      Unregisters a previously registered event filter from this scene. One filter might have been registered for different event types, so the caller needs to specify the particular event type from which to unregister the filter.
      Type Parameters:
      T - the specific event class of the filter
      Parameters:
      eventType - the event type from which to unregister
      eventFilter - the filter to unregister
      Throws:
      NullPointerException - if the event type or filter is null
    • setEventHandler

      protected final <T extends Event> void setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
      Sets the handler to use for this event type. There can only be one such handler specified at a time. This handler is guaranteed to be called first. This is used for registering the user-defined onFoo event handlers.
      Type Parameters:
      T - the specific event class of the handler
      Parameters:
      eventType - the event type to associate with the given eventHandler
      eventHandler - the handler to register, or null to unregister
      Throws:
      NullPointerException - if the event type is null
    • addMnemonic

      public void addMnemonic(Mnemonic m)
      Registers the specified mnemonic.
      Parameters:
      m - The mnemonic
    • removeMnemonic

      public void removeMnemonic(Mnemonic m)
      Unregisters the specified mnemonic.
      Parameters:
      m - The mnemonic
    • getMnemonics

      Gets the list of mnemonics for this Scene.
      Returns:
      the list of mnemonics
    • getAccelerators

      public ObservableMap<KeyCombination,Runnable> getAccelerators()
      Gets the list of accelerators for this Scene.
      Returns:
      the list of accelerators
    • buildEventDispatchChain

      public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
      Construct an event dispatch chain for this scene. The event dispatch chain contains all event dispatchers from the stage to this scene.
      Specified by:
      buildEventDispatchChain in interface EventTarget
      Parameters:
      tail - the initial chain to build from
      Returns:
      the resulting event dispatch chain for this scene
    • setOnContextMenuRequested

      public final void setOnContextMenuRequested(EventHandler<? super ContextMenuEvent> value)
      Sets the value of the onContextMenuRequested property.
      Property description:
      Defines a function to be called when a mouse button has been clicked (pressed and released) on this Scene.
      Parameters:
      value - the value for the onContextMenuRequested property
      Since:
      JavaFX 2.1
      See Also:
    • getOnContextMenuRequested

      public final EventHandler<? super ContextMenuEvent> getOnContextMenuRequested()
      Gets the value of the onContextMenuRequested property.
      Property description:
      Defines a function to be called when a mouse button has been clicked (pressed and released) on this Scene.
      Returns:
      the value of the onContextMenuRequested property
      Since:
      JavaFX 2.1
      See Also:
    • onContextMenuRequestedProperty

      public final ObjectProperty<EventHandler<? super ContextMenuEvent>> onContextMenuRequestedProperty()
      Defines a function to be called when a mouse button has been clicked (pressed and released) on this Scene.
      Returns:
      the onContextMenuRequested property
      Since:
      JavaFX 2.1
      See Also:
    • setOnMouseClicked

      public final void setOnMouseClicked(EventHandler<? super MouseEvent> value)
      Sets the value of the onMouseClicked property.
      Property description:
      Defines a function to be called when a mouse button has been clicked (pressed and released) on this Scene.
      Parameters:
      value - the value for the onMouseClicked property
      See Also:
    • getOnMouseClicked

      public final EventHandler<? super MouseEvent> getOnMouseClicked()
      Gets the value of the onMouseClicked property.
      Property description:
      Defines a function to be called when a mouse button has been clicked (pressed and released) on this Scene.
      Returns:
      the value of the onMouseClicked property
      See Also:
    • onMouseClickedProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseClickedProperty()
      Defines a function to be called when a mouse button has been clicked (pressed and released) on this Scene.
      Returns:
      the onMouseClicked property
      See Also:
    • setOnMouseDragged

      public final void setOnMouseDragged(EventHandler<? super MouseEvent> value)
      Sets the value of the onMouseDragged property.
      Property description:
      Defines a function to be called when a mouse button is pressed on this Scene and then dragged.
      Parameters:
      value - the value for the onMouseDragged property
      See Also:
    • getOnMouseDragged

      public final EventHandler<? super MouseEvent> getOnMouseDragged()
      Gets the value of the onMouseDragged property.
      Property description:
      Defines a function to be called when a mouse button is pressed on this Scene and then dragged.
      Returns:
      the value of the onMouseDragged property
      See Also:
    • onMouseDraggedProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseDraggedProperty()
      Defines a function to be called when a mouse button is pressed on this Scene and then dragged.
      Returns:
      the onMouseDragged property
      See Also:
    • setOnMouseEntered

      public final void setOnMouseEntered(EventHandler<? super MouseEvent> value)
      Sets the value of the onMouseEntered property.
      Property description:
      Defines a function to be called when the mouse enters this Scene.
      Parameters:
      value - the value for the onMouseEntered property
      See Also:
    • getOnMouseEntered

      public final EventHandler<? super MouseEvent> getOnMouseEntered()
      Gets the value of the onMouseEntered property.
      Property description:
      Defines a function to be called when the mouse enters this Scene.
      Returns:
      the value of the onMouseEntered property
      See Also:
    • onMouseEnteredProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseEnteredProperty()
      Defines a function to be called when the mouse enters this Scene.
      Returns:
      the onMouseEntered property
      See Also:
    • setOnMouseExited

      public final void setOnMouseExited(EventHandler<? super MouseEvent> value)
      Sets the value of the onMouseExited property.
      Property description:
      Defines a function to be called when the mouse exits this Scene.
      Parameters:
      value - the value for the onMouseExited property
      See Also:
    • getOnMouseExited

      public final EventHandler<? super MouseEvent> getOnMouseExited()
      Gets the value of the onMouseExited property.
      Property description:
      Defines a function to be called when the mouse exits this Scene.
      Returns:
      the value of the onMouseExited property
      See Also:
    • onMouseExitedProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseExitedProperty()
      Defines a function to be called when the mouse exits this Scene.
      Returns:
      the onMouseExited property
      See Also:
    • setOnMouseMoved

      public final void setOnMouseMoved(EventHandler<? super MouseEvent> value)
      Sets the value of the onMouseMoved property.
      Property description:
      Defines a function to be called when mouse cursor moves within this Scene but no buttons have been pushed.
      Parameters:
      value - the value for the onMouseMoved property
      See Also:
    • getOnMouseMoved

      public final EventHandler<? super MouseEvent> getOnMouseMoved()
      Gets the value of the onMouseMoved property.
      Property description:
      Defines a function to be called when mouse cursor moves within this Scene but no buttons have been pushed.
      Returns:
      the value of the onMouseMoved property
      See Also:
    • onMouseMovedProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseMovedProperty()
      Defines a function to be called when mouse cursor moves within this Scene but no buttons have been pushed.
      Returns:
      the onMouseMoved property
      See Also:
    • setOnMousePressed

      public final void setOnMousePressed(EventHandler<? super MouseEvent> value)
      Sets the value of the onMousePressed property.
      Property description:
      Defines a function to be called when a mouse button has been pressed on this Scene.
      Parameters:
      value - the value for the onMousePressed property
      See Also:
    • getOnMousePressed

      public final EventHandler<? super MouseEvent> getOnMousePressed()
      Gets the value of the onMousePressed property.
      Property description:
      Defines a function to be called when a mouse button has been pressed on this Scene.
      Returns:
      the value of the onMousePressed property
      See Also:
    • onMousePressedProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onMousePressedProperty()
      Defines a function to be called when a mouse button has been pressed on this Scene.
      Returns:
      the onMousePressed property
      See Also:
    • setOnMouseReleased

      public final void setOnMouseReleased(EventHandler<? super MouseEvent> value)
      Sets the value of the onMouseReleased property.
      Property description:
      Defines a function to be called when a mouse button has been released on this Scene.
      Parameters:
      value - the value for the onMouseReleased property
      See Also:
    • getOnMouseReleased

      public final EventHandler<? super MouseEvent> getOnMouseReleased()
      Gets the value of the onMouseReleased property.
      Property description:
      Defines a function to be called when a mouse button has been released on this Scene.
      Returns:
      the value of the onMouseReleased property
      See Also:
    • onMouseReleasedProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseReleasedProperty()
      Defines a function to be called when a mouse button has been released on this Scene.
      Returns:
      the onMouseReleased property
      See Also:
    • setOnDragDetected

      public final void setOnDragDetected(EventHandler<? super MouseEvent> value)
      Sets the value of the onDragDetected property.
      Property description:
      Defines a function to be called when drag gesture has been detected. This is the right place to start drag and drop operation.
      Parameters:
      value - the value for the onDragDetected property
      See Also:
    • getOnDragDetected

      public final EventHandler<? super MouseEvent> getOnDragDetected()
      Gets the value of the onDragDetected property.
      Property description:
      Defines a function to be called when drag gesture has been detected. This is the right place to start drag and drop operation.
      Returns:
      the value of the onDragDetected property
      See Also:
    • onDragDetectedProperty

      public final ObjectProperty<EventHandler<? super MouseEvent>> onDragDetectedProperty()
      Defines a function to be called when drag gesture has been detected. This is the right place to start drag and drop operation.
      Returns:
      the onDragDetected property
      See Also:
    • setOnMouseDragOver

      public final void setOnMouseDragOver(EventHandler<? super MouseDragEvent> value)
      Sets the value of the onMouseDragOver property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture progresses within this Scene.
      Parameters:
      value - the value for the onMouseDragOver property
      Since:
      JavaFX 2.1
      See Also:
    • getOnMouseDragOver

      public final EventHandler<? super MouseDragEvent> getOnMouseDragOver()
      Gets the value of the onMouseDragOver property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture progresses within this Scene.
      Returns:
      the value of the onMouseDragOver property
      Since:
      JavaFX 2.1
      See Also:
    • onMouseDragOverProperty

      public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragOverProperty()
      Defines a function to be called when a full press-drag-release gesture progresses within this Scene.
      Returns:
      the onMouseDragOver property
      Since:
      JavaFX 2.1
      See Also:
    • setOnMouseDragReleased

      public final void setOnMouseDragReleased(EventHandler<? super MouseDragEvent> value)
      Sets the value of the onMouseDragReleased property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture ends within this Scene.
      Parameters:
      value - the value for the onMouseDragReleased property
      Since:
      JavaFX 2.1
      See Also:
    • getOnMouseDragReleased

      public final EventHandler<? super MouseDragEvent> getOnMouseDragReleased()
      Gets the value of the onMouseDragReleased property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture ends within this Scene.
      Returns:
      the value of the onMouseDragReleased property
      Since:
      JavaFX 2.1
      See Also:
    • onMouseDragReleasedProperty

      public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragReleasedProperty()
      Defines a function to be called when a full press-drag-release gesture ends within this Scene.
      Returns:
      the onMouseDragReleased property
      Since:
      JavaFX 2.1
      See Also:
    • setOnMouseDragEntered

      public final void setOnMouseDragEntered(EventHandler<? super MouseDragEvent> value)
      Sets the value of the onMouseDragEntered property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture enters this Scene.
      Parameters:
      value - the value for the onMouseDragEntered property
      Since:
      JavaFX 2.1
      See Also:
    • getOnMouseDragEntered

      public final EventHandler<? super MouseDragEvent> getOnMouseDragEntered()
      Gets the value of the onMouseDragEntered property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture enters this Scene.
      Returns:
      the value of the onMouseDragEntered property
      Since:
      JavaFX 2.1
      See Also:
    • onMouseDragEnteredProperty

      public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragEnteredProperty()
      Defines a function to be called when a full press-drag-release gesture enters this Scene.
      Returns:
      the onMouseDragEntered property
      Since:
      JavaFX 2.1
      See Also:
    • setOnMouseDragExited

      public final void setOnMouseDragExited(EventHandler<? super MouseDragEvent> value)
      Sets the value of the onMouseDragExited property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture exits this Scene.
      Parameters:
      value - the value for the onMouseDragExited property
      Since:
      JavaFX 2.1
      See Also:
    • getOnMouseDragExited

      public final EventHandler<? super MouseDragEvent> getOnMouseDragExited()
      Gets the value of the onMouseDragExited property.
      Property description:
      Defines a function to be called when a full press-drag-release gesture exits this Scene.
      Returns:
      the value of the onMouseDragExited property
      Since:
      JavaFX 2.1
      See Also:
    • onMouseDragExitedProperty

      public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragExitedProperty()
      Defines a function to be called when a full press-drag-release gesture exits this Scene.
      Returns:
      the onMouseDragExited property
      Since:
      JavaFX 2.1
      See Also:
    • setOnScrollStarted

      public final void setOnScrollStarted(EventHandler<? super ScrollEvent> value)
      Sets the value of the onScrollStarted property.
      Property description:
      Defines a function to be called when a scrolling gesture is detected.
      Parameters:
      value - the value for the onScrollStarted property
      Since:
      JavaFX 2.2
      See Also:
    • getOnScrollStarted

      public final EventHandler<? super ScrollEvent> getOnScrollStarted()
      Gets the value of the onScrollStarted property.
      Property description:
      Defines a function to be called when a scrolling gesture is detected.
      Returns:
      the value of the onScrollStarted property
      Since:
      JavaFX 2.2
      See Also:
    • onScrollStartedProperty

      public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollStartedProperty()
      Defines a function to be called when a scrolling gesture is detected.
      Returns:
      the onScrollStarted property
      Since:
      JavaFX 2.2
      See Also:
    • setOnScroll

      public final void setOnScroll(EventHandler<? super ScrollEvent> value)
      Sets the value of the onScroll property.
      Property description:
      Defines a function to be called when user performs a scrolling action.
      Parameters:
      value - the value for the onScroll property
      See Also:
    • getOnScroll

      public final EventHandler<? super ScrollEvent> getOnScroll()
      Gets the value of the onScroll property.
      Property description:
      Defines a function to be called when user performs a scrolling action.
      Returns:
      the value of the onScroll property
      See Also:
    • onScrollProperty

      public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollProperty()
      Defines a function to be called when user performs a scrolling action.
      Returns:
      the onScroll property
      See Also:
    • setOnScrollFinished

      public final void setOnScrollFinished(EventHandler<? super ScrollEvent> value)
      Sets the value of the onScrollFinished property.
      Property description:
      Defines a function to be called when a scrolling gesture ends.
      Parameters:
      value - the value for the onScrollFinished property
      Since:
      JavaFX 2.2
      See Also:
    • getOnScrollFinished

      public final EventHandler<? super ScrollEvent> getOnScrollFinished()
      Gets the value of the onScrollFinished property.
      Property description:
      Defines a function to be called when a scrolling gesture ends.
      Returns:
      the value of the onScrollFinished property
      Since:
      JavaFX 2.2
      See Also:
    • onScrollFinishedProperty

      public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollFinishedProperty()
      Defines a function to be called when a scrolling gesture ends.
      Returns:
      the onScrollFinished property
      Since:
      JavaFX 2.2
      See Also:
    • setOnRotationStarted

      public final void setOnRotationStarted(EventHandler<? super RotateEvent> value)
      Sets the value of the onRotationStarted property.
      Property description:
      Defines a function to be called when a rotating gesture is detected.
      Parameters:
      value - the value for the onRotationStarted property
      Since:
      JavaFX 2.2
      See Also:
    • getOnRotationStarted

      public final EventHandler<? super RotateEvent> getOnRotationStarted()
      Gets the value of the onRotationStarted property.
      Property description:
      Defines a function to be called when a rotating gesture is detected.
      Returns:
      the value of the onRotationStarted property
      Since:
      JavaFX 2.2
      See Also:
    • onRotationStartedProperty

      public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationStartedProperty()
      Defines a function to be called when a rotating gesture is detected.
      Returns:
      the onRotationStarted property
      Since:
      JavaFX 2.2
      See Also:
    • setOnRotate

      public final void setOnRotate(EventHandler<? super RotateEvent> value)
      Sets the value of the onRotate property.
      Property description:
      Defines a function to be called when user performs a rotating action.
      Parameters:
      value - the value for the onRotate property
      Since:
      JavaFX 2.2
      See Also:
    • getOnRotate

      public final EventHandler<? super RotateEvent> getOnRotate()
      Gets the value of the onRotate property.
      Property description:
      Defines a function to be called when user performs a rotating action.
      Returns:
      the value of the onRotate property
      Since:
      JavaFX 2.2
      See Also:
    • onRotateProperty

      public final ObjectProperty<EventHandler<? super RotateEvent>> onRotateProperty()
      Defines a function to be called when user performs a rotating action.
      Returns:
      the onRotate property
      Since:
      JavaFX 2.2
      See Also:
    • setOnRotationFinished

      public final void setOnRotationFinished(EventHandler<? super RotateEvent> value)
      Sets the value of the onRotationFinished property.
      Property description:
      Defines a function to be called when a rotating gesture ends.
      Parameters:
      value - the value for the onRotationFinished property
      Since:
      JavaFX 2.2
      See Also:
    • getOnRotationFinished

      public final EventHandler<? super RotateEvent> getOnRotationFinished()
      Gets the value of the onRotationFinished property.
      Property description:
      Defines a function to be called when a rotating gesture ends.
      Returns:
      the value of the onRotationFinished property
      Since:
      JavaFX 2.2
      See Also:
    • onRotationFinishedProperty

      public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationFinishedProperty()
      Defines a function to be called when a rotating gesture ends.
      Returns:
      the onRotationFinished property
      Since:
      JavaFX 2.2
      See Also:
    • setOnZoomStarted

      public final void setOnZoomStarted(EventHandler<? super ZoomEvent> value)
      Sets the value of the onZoomStarted property.
      Property description:
      Defines a function to be called when a zooming gesture is detected.
      Parameters:
      value - the value for the onZoomStarted property
      Since:
      JavaFX 2.2
      See Also:
    • getOnZoomStarted

      public final EventHandler<? super ZoomEvent> getOnZoomStarted()
      Gets the value of the onZoomStarted property.
      Property description:
      Defines a function to be called when a zooming gesture is detected.
      Returns:
      the value of the onZoomStarted property
      Since:
      JavaFX 2.2
      See Also:
    • onZoomStartedProperty

      public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomStartedProperty()
      Defines a function to be called when a zooming gesture is detected.
      Returns:
      the onZoomStarted property
      Since:
      JavaFX 2.2
      See Also:
    • setOnZoom

      public final void setOnZoom(EventHandler<? super ZoomEvent> value)
      Sets the value of the onZoom property.
      Property description:
      Defines a function to be called when user performs a zooming action.
      Parameters:
      value - the value for the onZoom property
      Since:
      JavaFX 2.2
      See Also:
    • getOnZoom

      public final EventHandler<? super ZoomEvent> getOnZoom()
      Gets the value of the onZoom property.
      Property description:
      Defines a function to be called when user performs a zooming action.
      Returns:
      the value of the onZoom property
      Since:
      JavaFX 2.2
      See Also:
    • onZoomProperty

      public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomProperty()
      Defines a function to be called when user performs a zooming action.
      Returns:
      the onZoom property
      Since:
      JavaFX 2.2
      See Also:
    • setOnZoomFinished

      public final void setOnZoomFinished(EventHandler<? super ZoomEvent> value)
      Sets the value of the onZoomFinished property.
      Property description:
      Defines a function to be called when a zooming gesture ends.
      Parameters:
      value - the value for the onZoomFinished property
      Since:
      JavaFX 2.2
      See Also:
    • getOnZoomFinished

      public final EventHandler<? super ZoomEvent> getOnZoomFinished()
      Gets the value of the onZoomFinished property.
      Property description:
      Defines a function to be called when a zooming gesture ends.
      Returns:
      the value of the onZoomFinished property
      Since:
      JavaFX 2.2
      See Also:
    • onZoomFinishedProperty

      public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomFinishedProperty()
      Defines a function to be called when a zooming gesture ends.
      Returns:
      the onZoomFinished property
      Since:
      JavaFX 2.2
      See Also:
    • setOnSwipeUp

      public final void setOnSwipeUp(EventHandler<? super SwipeEvent> value)
      Sets the value of the onSwipeUp property.
      Property description:
      Defines a function to be called when an upward swipe gesture happens in this scene.
      Parameters:
      value - the value for the onSwipeUp property
      Since:
      JavaFX 2.2
      See Also:
    • getOnSwipeUp

      public final EventHandler<? super SwipeEvent> getOnSwipeUp()
      Gets the value of the onSwipeUp property.
      Property description:
      Defines a function to be called when an upward swipe gesture happens in this scene.
      Returns:
      the value of the onSwipeUp property
      Since:
      JavaFX 2.2
      See Also:
    • onSwipeUpProperty

      public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeUpProperty()
      Defines a function to be called when an upward swipe gesture happens in this scene.
      Returns:
      the onSwipeUp property
      Since:
      JavaFX 2.2
      See Also:
    • setOnSwipeDown

      public final void setOnSwipeDown(EventHandler<? super SwipeEvent> value)
      Sets the value of the onSwipeDown property.
      Property description:
      Defines a function to be called when an downward swipe gesture happens in this scene.
      Parameters:
      value - the value for the onSwipeDown property
      Since:
      JavaFX 2.2
      See Also:
    • getOnSwipeDown

      public final EventHandler<? super SwipeEvent> getOnSwipeDown()
      Gets the value of the onSwipeDown property.
      Property description:
      Defines a function to be called when an downward swipe gesture happens in this scene.
      Returns:
      the value of the onSwipeDown property
      Since:
      JavaFX 2.2
      See Also:
    • onSwipeDownProperty

      public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeDownProperty()
      Defines a function to be called when an downward swipe gesture happens in this scene.
      Returns:
      the onSwipeDown property
      Since:
      JavaFX 2.2
      See Also:
    • setOnSwipeLeft

      public final void setOnSwipeLeft(EventHandler<? super SwipeEvent> value)
      Sets the value of the onSwipeLeft property.
      Property description:
      Defines a function to be called when an leftward swipe gesture happens in this scene.
      Parameters:
      value - the value for the onSwipeLeft property
      Since:
      JavaFX 2.2
      See Also:
    • getOnSwipeLeft

      public final EventHandler<? super SwipeEvent> getOnSwipeLeft()
      Gets the value of the onSwipeLeft property.
      Property description:
      Defines a function to be called when an leftward swipe gesture happens in this scene.
      Returns:
      the value of the onSwipeLeft property
      Since:
      JavaFX 2.2
      See Also:
    • onSwipeLeftProperty

      public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeLeftProperty()
      Defines a function to be called when an leftward swipe gesture happens in this scene.
      Returns:
      the onSwipeLeft property
      Since:
      JavaFX 2.2
      See Also:
    • setOnSwipeRight

      public final void setOnSwipeRight(EventHandler<? super SwipeEvent> value)
      Sets the value of the onSwipeRight property.
      Property description:
      Defines a function to be called when an rightward swipe gesture happens in this scene.
      Parameters:
      value - the value for the onSwipeRight property
      Since:
      JavaFX 2.2
      See Also:
    • getOnSwipeRight

      public final EventHandler<? super SwipeEvent> getOnSwipeRight()
      Gets the value of the onSwipeRight property.
      Property description:
      Defines a function to be called when an rightward swipe gesture happens in this scene.
      Returns:
      the value of the onSwipeRight property
      Since:
      JavaFX 2.2
      See Also:
    • onSwipeRightProperty

      public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeRightProperty()
      Defines a function to be called when an rightward swipe gesture happens in this scene.
      Returns:
      the onSwipeRight property
      Since:
      JavaFX 2.2
      See Also:
    • setOnTouchPressed

      public final void setOnTouchPressed(EventHandler<? super TouchEvent> value)
      Sets the value of the onTouchPressed property.
      Property description:
      Defines a function to be called when a new touch point is pressed.
      Parameters:
      value - the value for the onTouchPressed property
      Since:
      JavaFX 2.2
      See Also:
    • getOnTouchPressed

      public final EventHandler<? super TouchEvent> getOnTouchPressed()
      Gets the value of the onTouchPressed property.
      Property description:
      Defines a function to be called when a new touch point is pressed.
      Returns:
      the value of the onTouchPressed property
      Since:
      JavaFX 2.2
      See Also:
    • onTouchPressedProperty

      public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchPressedProperty()
      Defines a function to be called when a new touch point is pressed.
      Returns:
      the onTouchPressed property
      Since:
      JavaFX 2.2
      See Also:
    • setOnTouchMoved

      public final void setOnTouchMoved(EventHandler<? super TouchEvent> value)
      Sets the value of the onTouchMoved property.
      Property description:
      Defines a function to be called when a touch point is moved.
      Parameters:
      value - the value for the onTouchMoved property
      Since:
      JavaFX 2.2
      See Also:
    • getOnTouchMoved

      public final EventHandler<? super TouchEvent> getOnTouchMoved()
      Gets the value of the onTouchMoved property.
      Property description:
      Defines a function to be called when a touch point is moved.
      Returns:
      the value of the onTouchMoved property
      Since:
      JavaFX 2.2
      See Also:
    • onTouchMovedProperty

      public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchMovedProperty()
      Defines a function to be called when a touch point is moved.
      Returns:
      the onTouchMoved property
      Since:
      JavaFX 2.2
      See Also:
    • setOnTouchReleased

      public final void setOnTouchReleased(EventHandler<? super TouchEvent> value)
      Sets the value of the onTouchReleased property.
      Property description:
      Defines a function to be called when a new touch point is pressed.
      Parameters:
      value - the value for the onTouchReleased property
      Since:
      JavaFX 2.2
      See Also:
    • getOnTouchReleased

      public final EventHandler<? super TouchEvent> getOnTouchReleased()
      Gets the value of the onTouchReleased property.
      Property description:
      Defines a function to be called when a new touch point is pressed.
      Returns:
      the value of the onTouchReleased property
      Since:
      JavaFX 2.2
      See Also:
    • onTouchReleasedProperty

      public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchReleasedProperty()
      Defines a function to be called when a new touch point is pressed.
      Returns:
      the onTouchReleased property
      Since:
      JavaFX 2.2
      See Also:
    • setOnTouchStationary

      public final void setOnTouchStationary(EventHandler<? super TouchEvent> value)
      Sets the value of the onTouchStationary property.
      Property description:
      Defines a function to be called when a touch point stays pressed and still.
      Parameters:
      value - the value for the onTouchStationary property
      Since:
      JavaFX 2.2
      See Also:
    • getOnTouchStationary

      public final EventHandler<? super TouchEvent> getOnTouchStationary()
      Gets the value of the onTouchStationary property.
      Property description:
      Defines a function to be called when a touch point stays pressed and still.
      Returns:
      the value of the onTouchStationary property
      Since:
      JavaFX 2.2
      See Also:
    • onTouchStationaryProperty

      public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchStationaryProperty()
      Defines a function to be called when a touch point stays pressed and still.
      Returns:
      the onTouchStationary property
      Since:
      JavaFX 2.2
      See Also:
    • setOnDragEntered

      public final void setOnDragEntered(EventHandler<? super DragEvent> value)
      Sets the value of the onDragEntered property.
      Property description:
      Defines a function to be called when drag gesture enters this Scene.
      Parameters:
      value - the value for the onDragEntered property
      See Also:
    • getOnDragEntered

      public final EventHandler<? super DragEvent> getOnDragEntered()
      Gets the value of the onDragEntered property.
      Property description:
      Defines a function to be called when drag gesture enters this Scene.
      Returns:
      the value of the onDragEntered property
      See Also:
    • onDragEnteredProperty

      public final ObjectProperty<EventHandler<? super DragEvent>> onDragEnteredProperty()
      Defines a function to be called when drag gesture enters this Scene.
      Returns:
      function to be called when drag gesture enters this scene
      See Also:
    • setOnDragExited

      public final void setOnDragExited(EventHandler<? super DragEvent> value)
      Sets the value of the onDragExited property.
      Property description:
      Defines a function to be called when drag gesture exits this Scene.
      Parameters:
      value - the value for the onDragExited property
      See Also:
    • getOnDragExited

      public final EventHandler<? super DragEvent> getOnDragExited()
      Gets the value of the onDragExited property.
      Property description:
      Defines a function to be called when drag gesture exits this Scene.
      Returns:
      the value of the onDragExited property
      See Also:
    • onDragExitedProperty

      public final ObjectProperty<EventHandler<? super DragEvent>> onDragExitedProperty()
      Defines a function to be called when drag gesture exits this Scene.
      Returns:
      the function to be called when drag gesture exits this scene
      See Also:
    • setOnDragOver

      public final void setOnDragOver(EventHandler<? super DragEvent> value)
      Sets the value of the onDragOver property.
      Property description:
      Defines a function to be called when drag gesture progresses within this Scene.
      Parameters:
      value - the value for the onDragOver property
      See Also:
    • getOnDragOver

      public final EventHandler<? super DragEvent> getOnDragOver()
      Gets the value of the onDragOver property.
      Property description:
      Defines a function to be called when drag gesture progresses within this Scene.
      Returns:
      the value of the onDragOver property
      See Also:
    • onDragOverProperty

      public final ObjectProperty<EventHandler<? super DragEvent>> onDragOverProperty()
      Defines a function to be called when drag gesture progresses within this Scene.
      Returns:
      the function to be called when drag gesture progresses within this scene
      See Also:
    • setOnDragDropped

      public final void setOnDragDropped(EventHandler<? super DragEvent> value)
      Sets the value of the onDragDropped property.
      Property description:
      Defines a function to be called when the mouse button is released on this Scene during drag and drop gesture. Transfer of data from the DragEvent's dragboard should happen in this function.
      Parameters:
      value - the value for the onDragDropped property
      See Also:
    • getOnDragDropped

      public final EventHandler<? super DragEvent> getOnDragDropped()
      Gets the value of the onDragDropped property.
      Property description:
      Defines a function to be called when the mouse button is released on this Scene during drag and drop gesture. Transfer of data from the DragEvent's dragboard should happen in this function.
      Returns:
      the value of the onDragDropped property
      See Also:
    • onDragDroppedProperty

      public final ObjectProperty<EventHandler<? super DragEvent>> onDragDroppedProperty()
      Defines a function to be called when the mouse button is released on this Scene during drag and drop gesture. Transfer of data from the DragEvent's dragboard should happen in this function.
      Returns:
      the function to be called when the mouse button is released on this scene during drag and drop gesture
      See Also:
    • setOnDragDone

      public final void setOnDragDone(EventHandler<? super DragEvent> value)
      Sets the value of the onDragDone property.
      Property description:
      Defines a function to be called when this Scene is a drag and drop gesture source after its data has been dropped on a drop target. The transferMode of the event shows what just happened at the drop target. If transferMode has the value MOVE, then the source can clear out its data. Clearing the source's data gives the appropriate appearance to a user that the data has been moved by the drag and drop gesture. A transferMode that has the value NONE indicates that no data was transferred during the drag and drop gesture. Positional data for the DragEvent is invalid. Valid positional data for the DragEvent is presented in the onDragDropped event handler.
      Parameters:
      value - the value for the onDragDone property
      See Also:
    • getOnDragDone

      public final EventHandler<? super DragEvent> getOnDragDone()
      Gets the value of the onDragDone property.
      Property description:
      Defines a function to be called when this Scene is a drag and drop gesture source after its data has been dropped on a drop target. The transferMode of the event shows what just happened at the drop target. If transferMode has the value MOVE, then the source can clear out its data. Clearing the source's data gives the appropriate appearance to a user that the data has been moved by the drag and drop gesture. A transferMode that has the value NONE indicates that no data was transferred during the drag and drop gesture. Positional data for the DragEvent is invalid. Valid positional data for the DragEvent is presented in the onDragDropped event handler.
      Returns:
      the value of the onDragDone property
      See Also:
    • onDragDoneProperty

      public final ObjectProperty<EventHandler<? super DragEvent>> onDragDoneProperty()
      Defines a function to be called when this Scene is a drag and drop gesture source after its data has been dropped on a drop target. The transferMode of the event shows what just happened at the drop target. If transferMode has the value MOVE, then the source can clear out its data. Clearing the source's data gives the appropriate appearance to a user that the data has been moved by the drag and drop gesture. A transferMode that has the value NONE indicates that no data was transferred during the drag and drop gesture. Positional data for the DragEvent is invalid. Valid positional data for the DragEvent is presented in the onDragDropped event handler.
      Returns:
      the function to be called when this scene is a drag and drop gesture source after its data has been dropped on a drop target
      See Also:
    • startDragAndDrop

      public Dragboard startDragAndDrop(TransferMode... transferModes)
      Confirms a potential drag and drop gesture that is recognized over this Scene. Can be called only from a DRAG_DETECTED event handler. The returned Dragboard is used to transfer data during the drag and drop gesture. Placing this Scene's data on the Dragboard also identifies this Scene as the source of the drag and drop gesture. More detail about drag and drop gestures is described in the overivew of DragEvent.
      Parameters:
      transferModes - The supported TransferMode(s) of this Node
      Returns:
      A Dragboard to place this Scene's data on
      Throws:
      IllegalStateException - if drag and drop cannot be started at this moment (it's called outside of DRAG_DETECTED event handling).
      See Also:
    • startFullDrag

      public void startFullDrag()
      Starts a full press-drag-release gesture with this scene as gesture source. This method can be called only from a DRAG_DETECTED mouse event handler. More detail about dragging gestures can be found in the overview of MouseEvent and MouseDragEvent.
      Throws:
      IllegalStateException - if the full press-drag-release gesture cannot be started at this moment (it's called outside of DRAG_DETECTED event handling).
      Since:
      JavaFX 2.1
      See Also:
    • setOnKeyPressed

      public final void setOnKeyPressed(EventHandler<? super KeyEvent> value)
      Sets the value of the onKeyPressed property.
      Property description:
      Defines a function to be called when some Node of this Scene has input focus and a key has been pressed. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Parameters:
      value - the value for the onKeyPressed property
      See Also:
    • getOnKeyPressed

      public final EventHandler<? super KeyEvent> getOnKeyPressed()
      Gets the value of the onKeyPressed property.
      Property description:
      Defines a function to be called when some Node of this Scene has input focus and a key has been pressed. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Returns:
      the value of the onKeyPressed property
      See Also:
    • onKeyPressedProperty

      public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyPressedProperty()
      Defines a function to be called when some Node of this Scene has input focus and a key has been pressed. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Returns:
      the onKeyPressed property
      See Also:
    • setOnKeyReleased

      public final void setOnKeyReleased(EventHandler<? super KeyEvent> value)
      Sets the value of the onKeyReleased property.
      Property description:
      Defines a function to be called when some Node of this Scene has input focus and a key has been released. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Parameters:
      value - the value for the onKeyReleased property
      See Also:
    • getOnKeyReleased

      public final EventHandler<? super KeyEvent> getOnKeyReleased()
      Gets the value of the onKeyReleased property.
      Property description:
      Defines a function to be called when some Node of this Scene has input focus and a key has been released. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Returns:
      the value of the onKeyReleased property
      See Also:
    • onKeyReleasedProperty

      public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyReleasedProperty()
      Defines a function to be called when some Node of this Scene has input focus and a key has been released. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Returns:
      the onKeyReleased property
      See Also:
    • setOnKeyTyped

      public final void setOnKeyTyped(EventHandler<? super KeyEvent> value)
      Sets the value of the onKeyTyped property.
      Property description:
      Defines a function to be called when some Node of this Scene has input focus and a key has been typed. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Parameters:
      value - the value for the onKeyTyped property
      See Also:
    • getOnKeyTyped

      public final EventHandler<? super KeyEvent> getOnKeyTyped()
      Gets the value of the onKeyTyped property.
      Property description:
      Defines a function to be called when some Node of this Scene has input focus and a key has been typed. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Returns:
      the value of the onKeyTyped property
      See Also:
    • onKeyTypedProperty

      public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyTypedProperty()
      Defines a function to be called when some Node of this Scene has input focus and a key has been typed. The function is called only if the event hasn't been already consumed during its capturing or bubbling phase.
      Returns:
      the onKeyTyped property
      See Also:
    • setOnInputMethodTextChanged

      public final void setOnInputMethodTextChanged(EventHandler<? super InputMethodEvent> value)
      Sets the value of the onInputMethodTextChanged property.
      Property description:
      Defines a function to be called when this Node has input focus and the input method text has changed. If this function is not defined in this Node, then it receives the result string of the input method composition as a series of onKeyTyped function calls.

      When the Node loses the input focus, the JavaFX runtime automatically commits the existing composed text if any.

      Parameters:
      value - the value for the onInputMethodTextChanged property
      See Also:
    • getOnInputMethodTextChanged

      public final EventHandler<? super InputMethodEvent> getOnInputMethodTextChanged()
      Gets the value of the onInputMethodTextChanged property.
      Property description:
      Defines a function to be called when this Node has input focus and the input method text has changed. If this function is not defined in this Node, then it receives the result string of the input method composition as a series of onKeyTyped function calls.

      When the Node loses the input focus, the JavaFX runtime automatically commits the existing composed text if any.

      Returns:
      the value of the onInputMethodTextChanged property
      See Also:
    • onInputMethodTextChangedProperty

      public final ObjectProperty<EventHandler<? super InputMethodEvent>> onInputMethodTextChangedProperty()
      Defines a function to be called when this Node has input focus and the input method text has changed. If this function is not defined in this Node, then it receives the result string of the input method composition as a series of onKeyTyped function calls.

      When the Node loses the input focus, the JavaFX runtime automatically commits the existing composed text if any.

      Returns:
      the onInputMethodTextChanged property
      See Also:
    • getProperties

      public final ObservableMap<Object,Object> getProperties()
      Returns an observable map of properties on this node for use primarily by application developers.
      Returns:
      an observable map of properties on this node for use primarily by application developers
      Since:
      JavaFX 8u40
    • hasProperties

      public boolean hasProperties()
      Tests if Scene has properties.
      Returns:
      true if node has properties.
      Since:
      JavaFX 8u40
    • setUserData

      public void setUserData(Object value)
      Convenience method for setting a single Object property that can be retrieved at a later date. This is functionally equivalent to calling the getProperties().put(Object key, Object value) method. This can later be retrieved by calling getUserData().
      Parameters:
      value - The value to be stored - this can later be retrieved by calling getUserData().
      Since:
      JavaFX 8u40
    • getUserData

      public Object getUserData()
      Returns a previously set Object property, or null if no such property has been set using the setUserData(java.lang.Object) method.
      Returns:
      The Object that was previously set, or null if no property has been set or if null was set.
      Since:
      JavaFX 8u40
    • setNodeOrientation

      public final void setNodeOrientation(NodeOrientation orientation)
      Sets the value of the nodeOrientation property.
      Property description:
      Property holding NodeOrientation.

      Node orientation describes the flow of visual data within a node. In the English speaking world, visual data normally flows from left-to-right. In an Arabic or Hebrew world, visual data flows from right-to-left. This is consistent with the reading order of text in both worlds. The default value is left-to-right.

      Parameters:
      orientation - the value for the nodeOrientation property
      Since:
      JavaFX 8.0
      See Also:
    • getNodeOrientation

      public final NodeOrientation getNodeOrientation()
      Gets the value of the nodeOrientation property.
      Property description:
      Property holding NodeOrientation.

      Node orientation describes the flow of visual data within a node. In the English speaking world, visual data normally flows from left-to-right. In an Arabic or Hebrew world, visual data flows from right-to-left. This is consistent with the reading order of text in both worlds. The default value is left-to-right.

      Returns:
      the value of the nodeOrientation property
      Since:
      JavaFX 8.0
      See Also:
    • nodeOrientationProperty

      public final ObjectProperty<NodeOrientation> nodeOrientationProperty()
      Property holding NodeOrientation.

      Node orientation describes the flow of visual data within a node. In the English speaking world, visual data normally flows from left-to-right. In an Arabic or Hebrew world, visual data flows from right-to-left. This is consistent with the reading order of text in both worlds. The default value is left-to-right.

      Returns:
      NodeOrientation
      Since:
      JavaFX 8.0
      See Also:
    • getEffectiveNodeOrientation

      public final NodeOrientation getEffectiveNodeOrientation()
      Gets the value of the effectiveNodeOrientation property.
      Property description:
      The effective node orientation of a scene resolves the inheritance of node orientation, returning either left-to-right or right-to-left.
      Returns:
      the value of the effectiveNodeOrientation property
      Since:
      JavaFX 8.0
      See Also:
    • effectiveNodeOrientationProperty

      public final ReadOnlyObjectProperty<NodeOrientation> effectiveNodeOrientationProperty()
      The effective node orientation of a scene resolves the inheritance of node orientation, returning either left-to-right or right-to-left.
      Returns:
      the effective node orientation of this scene
      Since:
      JavaFX 8.0
      See Also: