Class Node
- All Implemented Interfaces:
-
Styleable,EventTarget
- Direct Known Subclasses:
-
com.sun.javafx.scene.AbstractNode,Camera,Canvas,ImageView,LightBase,Parent,Shape,Shape3D,SubScene
@IDProperty("id") public abstract sealed class Node extends Object implements EventTarget, Styleable permits Camera, LightBase, Parent, SubScene, Canvas, ImageView, Shape, Shape3D (not exhaustive) Each item in the scene graph is called a Node. Branch nodes are of type Parent, whose concrete subclasses are Group, Region, and Control, or subclasses thereof.
Leaf nodes are classes such as Rectangle, Text, ImageView, MediaView, or other such leaf classes which cannot have children. Only a single node within each scene graph tree will have no parent, which is referred to as the "root" node.
There may be several trees in the scene graph. Some trees may be part of a Scene, in which case they are eligible to be displayed. Other trees might not be part of any Scene.
A node may occur at most once anywhere in the scene graph. Specifically, a node must appear no more than once in all of the following: as the root node of a Scene, the children ObservableList of a Parent, or as the clip of a Node.
The scene graph must not have cycles. A cycle would exist if a node is an ancestor of itself in the tree, considering the Group content ObservableList, Parent children ObservableList, and Node clip relationships mentioned above.
If a program adds a child node to a Parent (including Group, Region, etc) and that node is already a child of a different Parent or the root of a Scene, the node is automatically (and silently) removed from its former parent. If a program attempts to modify the scene graph in any other way that violates the above rules, an exception is thrown, the modification attempt is ignored and the scene graph is restored to its previous state.
It is possible to rearrange the structure of the scene graph, for example, to move a subtree from one location in the scene graph to another. In order to do this, one would normally remove the subtree from its old location before inserting it at the new location. However, the subtree will be automatically removed as described above if the application doesn't explicitly remove it.
Node objects may be constructed and modified on any thread as long they are not yet attached to a Scene in a Window that is showing. An application must attach nodes to such a Scene or modify them on the JavaFX Application Thread.
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.
String ID
Each node in the scene graph can be given a unique id. This id is much like the "id" attribute of an HTML tag in that it is up to the designer and developer to ensure that the id is unique within the scene graph. A convenience function called lookup(String) can be used to find a node with a unique id within the scene graph, or within a subtree of the scene graph. The id can also be used identify nodes for applying styles; see the CSS section below.
Coordinate System
The Node class defines a traditional computer graphics "local" coordinate system in which the x axis increases to the right and the y axis increases downwards. The concrete node classes for shapes provide variables for defining the geometry and location of the shape within this local coordinate space. For example, Rectangle provides x, y, width, height variables while Circle provides centerX, centerY, and radius.
At the device pixel level, integer coordinates map onto the corners and cracks between the pixels and the centers of the pixels appear at the midpoints between integer pixel locations. Because all coordinate values are specified with floating point numbers, coordinates can precisely point to these corners (when the floating point values have exact integer values) or to any location on the pixel. For example, a coordinate of (0.5, 0.5) would point to the center of the upper left pixel on the Stage. Similarly, a rectangle at (0, 0) with dimensions of 10 by 10 would span from the upper left corner of the upper left pixel on the Stage to the lower right corner of the 10th pixel on the 10th scanline. The pixel center of the last pixel inside that rectangle would be at the coordinates (9.5, 9.5).
In practice, most nodes have transformations applied to their coordinate system as mentioned below. As a result, the information above describing the alignment of device coordinates to the pixel grid is relative to the transformed coordinates, not the local coordinates of the nodes. The Shape class describes some additional important context-specific information about coordinate mapping and how it can affect rendering.
Transformations
Any Node can have transformations applied to it. These include translation, rotation, scaling, or shearing.
A translation transformation is one which shifts the origin of the node's coordinate space along either the x or y axis. For example, if you create a Rectangle which is drawn at the origin (x=0, y=0) and has a width of 100 and a height of 50, and then apply a Translate with a shift of 10 along the x axis (x=10), then the rectangle will appear drawn at (x=10, y=0) and remain 100 points wide and 50 tall. Note that the origin was shifted, not the x variable of the rectangle.
A common node transform is a translation by an integer distance, most often used to lay out nodes on the stage. Such integer translations maintain the device pixel mapping so that local coordinates that are integers still map to the cracks between pixels.
A rotation transformation is one which rotates the coordinate space of the node about a specified "pivot" point, causing the node to appear rotated. For example, if you create a Rectangle which is drawn at the origin (x=0, y=0) and has a width of 100 and height of 30 and you apply a Rotate with a 90 degree rotation (angle=90) and a pivot at the origin (pivotX=0, pivotY=0), then the rectangle will be drawn as if its x and y were zero but its height was 100 and its width -30. That is, it is as if a pin is being stuck at the top left corner and the rectangle is rotating 90 degrees clockwise around that pin. If the pivot point is instead placed in the center of the rectangle (at point x=50, y=15) then the rectangle will instead appear to rotate about its center.
Note that as with all transformations, the x, y, width, and height variables of the rectangle (which remain relative to the local coordinate space) have not changed, but rather the transformation alters the entire coordinate space of the rectangle.
A scaling transformation causes a node to either appear larger or smaller depending on the scaling factor. Scaling alters the coordinate space of the node such that each unit of distance along the axis in local coordinates is multiplied by the scale factor. As with rotation transformations, scaling transformations are applied about a "pivot" point. You can think of this as the point in the Node around which you "zoom". For example, if you create a Rectangle with a strokeWidth of 5, and a width and height of 50, and you apply a Scale with scale factors (x=2.0, y=2.0) and a pivot at the origin (pivotX=0, pivotY=0), the entire rectangle (including the stroke) will double in size, growing to the right and downwards from the origin.
A shearing transformation, sometimes called a skew, effectively rotates one axis so that the x and y axes are no longer perpendicular.
Multiple transformations may be applied to a node. Custom transforms are applied using the transforms list. Predefined transforms are applied using the properties specified below. The matrices that represent the transforms are multiplied in this order:
- Layout (
layoutX,layoutY) and translate (translateX,translateY,translateZ) - Rotate (
rotate) - Scale (
scaleX,scaleY,scaleZ) - Transforms list (
transforms) starting from element 0
Bounding Rectangles
Since every Node has transformations, every Node's geometric bounding rectangle can be described differently depending on whether transformations are accounted for or not.
Each Node has a read-only boundsInLocal variable which specifies the bounding rectangle of the Node in untransformed local coordinates. boundsInLocal includes the Node's shape geometry, including any space required for a non-zero stroke that may fall outside the local position/size variables, and its clip and effect variables.
Each Node also has a read-only boundsInParent variable which specifies the bounding rectangle of the Node after all transformations have been applied as specified in the Transformations section. It is called "boundsInParent" because the rectangle will be relative to the parent's coordinate system. This is the 'visual' bounds of the node.
Finally, the layoutBounds variable defines the rectangular bounds of the Node that should be used as the basis for layout calculations and may differ from the visual bounds of the node. For shapes, Text, and ImageView, layoutBounds by default includes only the shape geometry, including space required for a non-zero strokeWidth, but does not include the effect, clip, or any transforms. For resizable classes (Regions and Controls) layoutBounds will always map to 0,0 width x height.
The image shows a node without any transformation and its boundsInLocal:
boundsInParent in the coordinate space of the Node's parent. The boundsInLocal stays the same as in the first image, the green rectangle in this image represents boundsInLocal in the coordinate space of the Node. The images show a filled and stroked rectangle and their bounds. The first rectangle [x:10.0 y:10.0 width:100.0 height:100.0 strokeWidth:0] has the following bounds bounds: [x:10.0 y:10.0 width:100.0 height:100.0]. The second rectangle [x:10.0 y:10.0 width:100.0 height:100.0 strokeWidth:5] has the following bounds: [x:7.5 y:7.5 width:105 height:105] (the stroke is centered by default, so only half of it is outside of the original bounds; it is also possible to create inside or outside stroke). Since neither of the rectangles has any transformation applied, boundsInParent and boundsInLocal are the same.
CSS
The Node class contains id, styleClass, and style variables that are used in styling this node from CSS. The id and styleClass variables are used in CSS style sheets to identify nodes to which styles should be applied. The style variable contains style properties and values that are applied directly to this node.
For further information about CSS and how to apply CSS styles to nodes, see the CSS Reference Guide.
- Since:
- JavaFX 2.0
Property Summary
| Type | Property | Description |
|---|---|---|
final ObjectProperty |
accessibleHelp |
The accessible help text for this Node. |
final ObjectProperty |
accessibleRoleDescription |
The role description of this Node. |
final ObjectProperty |
accessibleRole |
The accessible role for this Node. |
final ObjectProperty |
accessibleText |
The accessible text for this Node. |
final ObjectProperty |
blendMode |
The BlendMode used to blend this individual node into the scene behind it. |
final ReadOnlyObjectProperty |
boundsInLocal |
The rectangular bounds of this Node in the node's untransformed local coordinate space. |
final ReadOnlyObjectProperty |
boundsInParent |
The rectangular bounds of this Node in the parent coordinate system. |
final ObjectProperty |
cacheHint |
Additional hint for controlling bitmap caching. |
final BooleanProperty |
cache |
A performance hint to the system to indicate that this Node should be cached as a bitmap. |
final ObjectProperty |
clip |
Specifies a Node to use to define the clipping shape for this Node. |
final ObjectProperty |
cursor |
Defines the mouse cursor for this Node and subnodes. |
final ObjectProperty |
depthTest |
Indicates whether depth testing is used when rendering this node. |
final ReadOnlyBooleanProperty |
disabled |
Indicates whether or not this Node is disabled. |
final BooleanProperty |
disable |
Defines the individual disabled state of this Node. |
final ReadOnlyObjectProperty |
effectiveNodeOrientation |
The effective orientation of a node resolves the inheritance of node orientation, returning either left-to-right or right-to-left. |
final ObjectProperty |
effect |
Specifies an effect to apply to this Node. |
final ObjectProperty |
eventDispatcher |
Specifies the event dispatcher for this node. |
final ReadOnlyBooleanProperty |
focused |
Indicates whether this Node currently has the input focus. |
final BooleanProperty |
focusTraversable |
Specifies whether this Node should be a part of focus traversal cycle. |
final ReadOnlyBooleanProperty |
focusVisible |
Indicates whether this Node should visibly indicate focus. |
final ReadOnlyBooleanProperty |
focusWithin |
Indicates whether this Node or any of its descendants currently has the input focus. |
final ReadOnlyBooleanProperty |
hover |
Whether or not this Node is being hovered over. |
final StringProperty |
id |
The id of this Node. |
final ObjectProperty |
inputMethodRequests |
Property holding InputMethodRequests. |
final ReadOnlyObjectProperty |
layoutBounds |
The rectangular bounds that should be used for layout calculations for this node. |
final DoubleProperty |
layoutX |
Defines the x coordinate of the translation that is added to this Node's transform for the purpose of layout. |
final DoubleProperty |
layoutY |
Defines the y coordinate of the translation that is added to this Node's transform for the purpose of layout. |
final ReadOnlyObjectProperty |
localToParentTransform |
An affine transform that holds the computed local-to-parent transform. |
final ReadOnlyObjectProperty |
localToSceneTransform |
An affine transform that holds the computed local-to-scene transform. |
final BooleanProperty |
managed |
Defines whether or not this node's layout will be managed by its parent. |
final BooleanProperty |
mouseTransparent |
If true, this node (together with all its children) is completely transparent to mouse events. |
final ObjectProperty |
nodeOrientation |
Node orientation describes the flow of visual data within a node. |
final ObjectProperty |
onContextMenuRequested |
Defines a function to be called when a context menu has been requested on this Node. |
final ObjectProperty |
onDragDetected |
Defines a function to be called when drag gesture has been detected. |
final ObjectProperty |
onDragDone |
Defines a function to be called when this Node is a drag and drop gesture source after its data has been dropped on a drop target. |
final ObjectProperty |
onDragDropped |
Defines a function to be called when the mouse button is released on this Node during drag and drop gesture. |
final ObjectProperty |
onDragEntered |
Defines a function to be called when drag gesture enters this Node. |
final ObjectProperty |
onDragExited |
Defines a function to be called when drag gesture exits this Node. |
final ObjectProperty |
onDragOver |
Defines a function to be called when drag gesture progresses within this Node. |
final ObjectProperty |
onInputMethodTextChanged |
Defines a function to be called when this Node has input focus and the input method text has changed. |
final ObjectProperty |
onKeyPressed |
Defines a function to be called when this Node or its child Node has input focus and a key has been pressed. |
final ObjectProperty |
onKeyReleased |
Defines a function to be called when this Node or its child Node has input focus and a key has been released. |
final ObjectProperty |
onKeyTyped |
Defines a function to be called when this Node or its child Node has input focus and a key has been typed. |
final ObjectProperty |
onMouseClicked |
Defines a function to be called when a mouse button has been clicked (pressed and released) on this Node. |
final ObjectProperty |
onMouseDragEntered |
Defines a function to be called when a full press-drag-release gesture enters this Node. |
final ObjectProperty |
onMouseDragExited |
Defines a function to be called when a full press-drag-release gesture leaves this Node. |
final ObjectProperty |
onMouseDragged |
Defines a function to be called when a mouse button is pressed on this Node and then dragged. |
final ObjectProperty |
onMouseDragOver |
Defines a function to be called when a full press-drag-release gesture progresses within this Node. |
final ObjectProperty |
onMouseDragReleased |
Defines a function to be called when a full press-drag-release gesture ends (by releasing mouse button) within this Node. |
final ObjectProperty |
onMouseEntered |
Defines a function to be called when the mouse enters this Node. |
final ObjectProperty |
onMouseExited |
Defines a function to be called when the mouse exits this Node. |
final ObjectProperty |
onMouseMoved |
Defines a function to be called when mouse cursor moves within this Node but no buttons have been pushed. |
final ObjectProperty |
onMousePressed |
Defines a function to be called when a mouse button has been pressed on this Node. |
final ObjectProperty |
onMouseReleased |
Defines a function to be called when a mouse button has been released on this Node. |
final ObjectProperty |
onRotate |
Defines a function to be called when user performs a rotation action. |
final ObjectProperty |
onRotationFinished |
Defines a function to be called when a rotation gesture ends. |
final ObjectProperty |
onRotationStarted |
Defines a function to be called when a rotation gesture is detected. |
final ObjectProperty |
onScrollFinished |
Defines a function to be called when a scrolling gesture ends. |
final ObjectProperty |
onScroll |
Defines a function to be called when user performs a scrolling action. |
final ObjectProperty |
onScrollStarted |
Defines a function to be called when a scrolling gesture is detected. |
final ObjectProperty |
onSwipeDown |
Defines a function to be called when a downward swipe gesture centered over this node happens. |
final ObjectProperty |
onSwipeLeft |
Defines a function to be called when a leftward swipe gesture centered over this node happens. |
final ObjectProperty |
onSwipeRight |
Defines a function to be called when an rightward swipe gesture centered over this node happens. |
final ObjectProperty |
onSwipeUp |
Defines a function to be called when an upward swipe gesture centered over this node happens. |
final ObjectProperty |
onTouchMoved |
Defines a function to be called when a touch point is moved. |
final ObjectProperty |
onTouchPressed |
Defines a function to be called when a new touch point is pressed. |
final ObjectProperty |
onTouchReleased |
Defines a function to be called when a touch point is released. |
final ObjectProperty |
onTouchStationary |
Defines a function to be called when a touch point stays pressed and still. |
final ObjectProperty |
onZoomFinished |
Defines a function to be called when a zooming gesture ends. |
final ObjectProperty |
onZoom |
Defines a function to be called when user performs a zooming action. |
final ObjectProperty |
onZoomStarted |
Defines a function to be called when a zooming gesture is detected. |
final DoubleProperty |
opacity |
Specifies how opaque (that is, solid) the Node appears. |
final ReadOnlyObjectProperty |
parent |
The parent of this Node. |
final BooleanProperty |
pickOnBounds |
Defines how the picking computation is done for this node when triggered by a MouseEvent or a contains function call. |
final ReadOnlyBooleanProperty |
pressed |
Whether or not the Node is pressed. |
final DoubleProperty |
rotate |
Defines the angle of rotation about the Node's center, measured in degrees. |
final ObjectProperty |
rotationAxis |
Defines the axis of rotation of this Node. |
final DoubleProperty |
scaleX |
Defines the factor by which coordinates are scaled about the center of the object along the X axis of this Node. |
final DoubleProperty |
scaleY |
Defines the factor by which coordinates are scaled about the center of the object along the Y axis of this Node. |
final DoubleProperty |
scaleZ |
Defines the factor by which coordinates are scaled about the center of the object along the Z axis of this Node. |
final ReadOnlyObjectProperty |
scene |
The Scene that this Node is part of. |
final StringProperty |
style |
A string representation of the CSS style associated with this specific Node. |
final DoubleProperty |
translateX |
Defines the x coordinate of the translation that is added to this Node's transform. |
final DoubleProperty |
translateY |
Defines the y coordinate of the translation that is added to this Node's transform. |
final DoubleProperty |
translateZ |
Defines the Z coordinate of the translation that is added to the transformed coordinates of this Node. |
final DoubleProperty |
viewOrder |
Defines the rendering and picking order of this Node within its parent. |
final BooleanProperty |
visible |
Specifies whether this Node and any subnodes should be rendered as part of the scene graph. |
Field Summary
| Modifier and Type | Field | Description |
|---|---|---|
static final double |
BASELINE_OFFSET_SAME_AS_HEIGHT |
This is a special value that might be returned by getBaselineOffset(). |
Constructor Summary
| Modifier | Constructor | Description |
|---|---|---|
protected |
Creates a new instance of Node. |
Method Summary
| Modifier and Type | Method | Description |
|---|---|---|
final ObjectProperty |
accessibleHelpProperty() |
The accessible help text for this Node. |
final ObjectProperty |
accessibleRoleDescriptionProperty() |
The role description of this Node. |
final ObjectProperty |
accessibleRoleProperty() |
The accessible role for this Node. |
final ObjectProperty |
accessibleTextProperty() |
The accessible text for this Node. |
final <T extends Event> |
addEventFilter |
Registers an event filter for this target. |
final <T extends Event> |
addEventHandler |
Registers an event handler for this target. |
final void |
applyCss() |
If required, apply styles to this Node and its children, if any. |
final void |
autosize() |
If the node is resizable, will set its layout bounds to its current preferred width and height. |
final ObjectProperty |
blendModeProperty() |
The BlendMode used to blend this individual node into the scene behind it. |
final ReadOnlyObjectProperty |
boundsInLocalProperty() |
The rectangular bounds of this Node in the node's untransformed local coordinate space. |
final ReadOnlyObjectProperty |
boundsInParentProperty() |
The rectangular bounds of this Node in the parent coordinate system. |
EventDispatchChain |
buildEventDispatchChain |
Construct an event dispatch chain for this target. |
final ObjectProperty |
cacheHintProperty() |
Additional hint for controlling bitmap caching. |
final BooleanProperty |
cacheProperty() |
A performance hint to the system to indicate that this Node should be cached as a bitmap. |
final ObjectProperty |
clipProperty() |
Specifies a Node to use to define the clipping shape for this Node. |
double |
computeAreaInScreen() |
Returns the area of this Node projected onto the physical screen in pixel units. |
boolean |
contains |
Returns true if the given point (specified in the local coordinate space of this Node) is contained within the shape of this Node. |
boolean |
contains |
Returns true if the given point (specified in the local coordinate space of this Node) is contained within the shape of this Node. |
final ObjectProperty |
cursorProperty() |
Defines the mouse cursor for this Node and subnodes. |
final ObjectProperty |
depthTestProperty() |
Indicates whether depth testing is used when rendering this node. |
final ReadOnlyBooleanProperty |
disabledProperty() |
Indicates whether or not this Node is disabled. |
final BooleanProperty |
disableProperty() |
Defines the individual disabled state of this Node. |
final ReadOnlyObjectProperty |
effectiveNodeOrientationProperty() |
The effective orientation of a node resolves the inheritance of node orientation, returning either left-to-right or right-to-left. |
final ObjectProperty |
effectProperty() |
Specifies an effect to apply to this Node. |
final ObjectProperty |
eventDispatcherProperty() |
Specifies the event dispatcher for this node. |
void |
executeAccessibleAction |
This method is called by the assistive technology to request the action indicated by the argument should be executed. |
final void |
fireEvent |
Fires the specified event. |
final ReadOnlyBooleanProperty |
focusedProperty() |
Indicates whether this Node currently has the input focus. |
final BooleanProperty |
focusTraversableProperty() |
Specifies whether this Node should be a part of focus traversal cycle. |
final ReadOnlyBooleanProperty |
focusVisibleProperty() |
Indicates whether this Node should visibly indicate focus. |
final ReadOnlyBooleanProperty |
focusWithinProperty() |
Indicates whether this Node or any of its descendants currently has the input focus. |
final String |
getAccessibleHelp() |
Gets the value of the accessibleHelp property. |
final AccessibleRole |
getAccessibleRole() |
Gets the value of the accessibleRole property. |
final String |
getAccessibleRoleDescription() |
Gets the value of the accessibleRoleDescription property. |
final String |
getAccessibleText() |
Gets the value of the accessibleText property. |
double |
getBaselineOffset() |
The 'alphabetic' (or 'roman') baseline offset from the node's layoutBounds.minY location that should be used when this node is being vertically aligned by baseline with other nodes. |
final BlendMode |
getBlendMode() |
Gets the value of the blendMode property. |
final Bounds |
getBoundsInLocal() |
Gets the value of the boundsInLocal property. |
final Bounds |
getBoundsInParent() |
Gets the value of the boundsInParent property. |
final CacheHint |
getCacheHint() |
Gets the value of the cacheHint property. |
static List |
getClassCssMetaData() |
Gets the CssMetaData associated with this class, which may include the CssMetaData of its superclasses. |
final Node |
getClip() |
Gets the value of the clip property. |
Orientation |
getContentBias() |
Returns the orientation of a node's resizing bias for layout purposes. |
List |
getCssMetaData() |
This method should delegate to getClassCssMetaData() so that a Node's CssMetaData can be accessed without the need for reflection. |
final Cursor |
getCursor() |
Gets the value of the cursor property. |
final DepthTest |
getDepthTest() |
Gets the value of the depthTest property. |
final Effect |
getEffect() |
Gets the value of the effect property. |
final NodeOrientation |
getEffectiveNodeOrientation() |
Gets the value of the effectiveNodeOrientation property. |
final EventDispatcher |
getEventDispatcher() |
Gets the value of the eventDispatcher property. |
final String |
getId() |
The id of this Node. |
protected Cursor |
getInitialCursor() |
Returns the initial cursor state of this node, for use by the JavaFX CSS engine to correctly set its initial value. |
protected Boolean |
getInitialFocusTraversable() |
Returns the initial focus traversable state of this node, for use by the JavaFX CSS engine to correctly set its initial value. |
final InputMethodRequests |
getInputMethodRequests() |
Gets the value of the inputMethodRequests property. |
final Bounds |
getLayoutBounds() |
Gets the value of the layoutBounds property. |
final double |
getLayoutX() |
Gets the value of the layoutX property. |
final double |
getLayoutY() |
Gets the value of the layoutY property. |
final Transform |
getLocalToParentTransform() |
Gets the value of the localToParentTransform property. |
final Transform |
getLocalToSceneTransform() |
Gets the value of the localToSceneTransform property. |
final NodeOrientation |
getNodeOrientation() |
Gets the value of the nodeOrientation property. |
final EventHandler |
getOnContextMenuRequested() |
Gets the value of the onContextMenuRequested property. |
final EventHandler |
getOnDragDetected() |
Gets the value of the onDragDetected property. |
final EventHandler |
getOnDragDone() |
Gets the value of the onDragDone property. |
final EventHandler |
getOnDragDropped() |
Gets the value of the onDragDropped property. |
final EventHandler |
getOnDragEntered() |
Gets the value of the onDragEntered property. |
final EventHandler |
getOnDragExited() |
Gets the value of the onDragExited property. |
final EventHandler |
getOnDragOver() |
Gets the value of the onDragOver property. |
final EventHandler |
getOnInputMethodTextChanged() |
Gets the value of the onInputMethodTextChanged property. |
final EventHandler |
getOnKeyPressed() |
Gets the value of the onKeyPressed property. |
final EventHandler |
getOnKeyReleased() |
Gets the value of the onKeyReleased property. |
final EventHandler |
getOnKeyTyped() |
Gets the value of the onKeyTyped property. |
final EventHandler |
getOnMouseClicked() |
Gets the value of the onMouseClicked property. |
final EventHandler |
getOnMouseDragEntered() |
Gets the value of the onMouseDragEntered property. |
final EventHandler |
getOnMouseDragExited() |
Gets the value of the onMouseDragExited property. |
final EventHandler |
getOnMouseDragged() |
Gets the value of the onMouseDragged property. |
final EventHandler |
getOnMouseDragOver() |
Gets the value of the onMouseDragOver property. |
final EventHandler |
getOnMouseDragReleased() |
Gets the value of the onMouseDragReleased property. |
final EventHandler |
getOnMouseEntered() |
Gets the value of the onMouseEntered property. |
final EventHandler |
getOnMouseExited() |
Gets the value of the onMouseExited property. |
final EventHandler |
getOnMouseMoved() |
Gets the value of the onMouseMoved property. |
final EventHandler |
getOnMousePressed() |
Gets the value of the onMousePressed property. |
final EventHandler |
getOnMouseReleased() |
Gets the value of the onMouseReleased property. |
final EventHandler |
getOnRotate() |
Gets the value of the onRotate property. |
final EventHandler |
getOnRotationFinished() |
Gets the value of the onRotationFinished property. |
final EventHandler |
getOnRotationStarted() |
Gets the value of the onRotationStarted property. |
final EventHandler |
getOnScroll() |
Gets the value of the onScroll property. |
final EventHandler |
getOnScrollFinished() |
Gets the value of the onScrollFinished property. |
final EventHandler |
getOnScrollStarted() |
Gets the value of the onScrollStarted property. |
final EventHandler |
getOnSwipeDown() |
Gets the value of the onSwipeDown property. |
final EventHandler |
getOnSwipeLeft() |
Gets the value of the onSwipeLeft property. |
final EventHandler |
getOnSwipeRight() |
Gets the value of the onSwipeRight property. |
final EventHandler |
getOnSwipeUp() |
Gets the value of the onSwipeUp property. |
final EventHandler |
getOnTouchMoved() |
Gets the value of the onTouchMoved property. |
final EventHandler |
getOnTouchPressed() |
Gets the value of the onTouchPressed property. |
final EventHandler |
getOnTouchReleased() |
Gets the value of the onTouchReleased property. |
final EventHandler |
getOnTouchStationary() |
Gets the value of the onTouchStationary property. |
final EventHandler |
getOnZoom() |
Gets the value of the onZoom property. |
final EventHandler |
getOnZoomFinished() |
Gets the value of the onZoomFinished property. |
final EventHandler |
getOnZoomStarted() |
Gets the value of the onZoomStarted property. |
final double |
getOpacity() |
Gets the value of the opacity property. |
final Parent |
getParent() |
Gets the value of the parent property. |
final ObservableMap |
getProperties() |
Returns an observable map of properties on this node for use primarily by application developers. |
final ObservableSet |
getPseudoClassStates() |
Return the pseudo-class state of this Styleable. |
final double |
getRotate() |
Gets the value of the rotate property. |
final Point3D |
getRotationAxis() |
Gets the value of the rotationAxis property. |
final double |
getScaleX() |
Gets the value of the scaleX property. |
final double |
getScaleY() |
Gets the value of the scaleY property. |
final double |
getScaleZ() |
Gets the value of the scaleZ property. |
final Scene |
getScene() |
Gets the value of the scene property. |
final String |
getStyle() |
A string representation of the CSS style associated with this specific Node. |
Styleable |
getStyleableParent() |
Return the parent of this Styleable, or null if there is no parent. |
final ObservableList |
getStyleClass() |
A list of String identifiers which can be used to logically group Nodes, specifically for an external style engine. |
final ObservableList |
getTransforms() |
|
final double |
getTranslateX() |
Gets the value of the translateX property. |
final double |
getTranslateY() |
Gets the value of the translateY property. |
final double |
getTranslateZ() |
Gets the value of the translateZ property. |
String |
getTypeSelector() |
The type of this Styleable that is to be used in selector matching. |
Object |
getUserData() |
Returns a previously set Object property, or null if no such property has been set using the setUserData(java.lang.Object) method. |
final double |
getViewOrder() |
Gets the value of the viewOrder property. |
boolean |
hasProperties() |
Tests if Node has properties. |
final ReadOnlyBooleanProperty |
hoverProperty() |
Whether or not this Node is being hovered over. |
final StringProperty |
idProperty() |
The id of this Node. |
final ObjectProperty |
inputMethodRequestsProperty() |
Property holding InputMethodRequests. |
boolean |
intersects |
Returns true if the given rectangle (specified in the local coordinate space of this Node) intersects the shape of this Node. |
boolean |
intersects |
Returns true if the given bounds (specified in the local coordinate space of this Node) intersects the shape of this Node. |
final boolean |
isCache() |
Gets the value of the cache property. |
final boolean |
isDisable() |
Gets the value of the disable property. |
final boolean |
isDisabled() |
Gets the value of the disabled property. |
final boolean |
isFocused() |
Gets the value of the focused property. |
final boolean |
isFocusTraversable() |
Gets the value of the focusTraversable property. |
final boolean |
isFocusVisible() |
Gets the value of the focusVisible property. |
final boolean |
isFocusWithin() |
Gets the value of the focusWithin property. |
final boolean |
isHover() |
Gets the value of the hover property. |
final boolean |
isManaged() |
Gets the value of the managed property. |
final boolean |
isMouseTransparent() |
Gets the value of the mouseTransparent property. |
final boolean |
isPickOnBounds() |
Gets the value of the pickOnBounds property. |
final boolean |
isPressed() |
Gets the value of the pressed property. |
boolean |
isResizable() |
Indicates whether this node is a type which can be resized by its parent. |
final boolean |
isVisible() |
Gets the value of the visible property. |
final ReadOnlyObjectProperty |
layoutBoundsProperty() |
The rectangular bounds that should be used for layout calculations for this node. |
final DoubleProperty |
layoutXProperty() |
Defines the x coordinate of the translation that is added to this Node's transform for the purpose of layout. |
final DoubleProperty |
layoutYProperty() |
Defines the y coordinate of the translation that is added to this Node's transform for the purpose of layout. |
Point2D |
localToParent |
Transforms a point from the local coordinate space of this Node into the coordinate space of its parent. |
Point3D |
localToParent |
Transforms a point from the local coordinate space of this Node into the coordinate space of its parent. |
Bounds |
localToParent |
Transforms a bounds from the local coordinate space of this Node into the coordinate space of its parent. |
Point2D |
localToParent |
Transforms a point from the local coordinate space of this Node into the coordinate space of its parent. |
Point3D |
localToParent |
Transforms a point from the local coordinate space of this Node into the coordinate space of its parent. |
final ReadOnlyObjectProperty |
localToParentTransformProperty() |
An affine transform that holds the computed local-to-parent transform. |
Point2D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
Point2D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
Point3D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
Point3D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
Bounds |
localToScene |
Transforms a bounds from the local coordinate space of this Node into the coordinate space of its scene. |
Bounds |
localToScene |
Transforms a bounds from the local coordinate space of this Node into the coordinate space of its scene. |
Point2D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
Point2D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
Point3D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
Point3D |
localToScene |
Transforms a point from the local coordinate space of this Node into the coordinate space of its scene. |
final ReadOnlyObjectProperty |
localToSceneTransformProperty() |
An affine transform that holds the computed local-to-scene transform. |
Point2D |
localToScreen |
Transforms a point from the local coordinate space of this Node into the coordinate space of its Screen. |
Point2D |
localToScreen |
Transforms a point from the local coordinate space of this Node into the coordinate space of its Screen. |
Bounds |
localToScreen |
Transforms a bounds from the local coordinate space of this Node into the coordinate space of its Screen. |
Point2D |
localToScreen |
Transforms a point from the local coordinate space of this Node into the coordinate space of its Screen. |
Point2D |
localToScreen |
Transforms a point from the local coordinate space of this Node into the coordinate space of its Screen. |
Node |
lookup |
Finds this Node, or the first sub-node, based on the given CSS selector. |
Set |
lookupAll |
Finds all Nodes, including this one and any children, which match the given CSS selector. |
final BooleanProperty |
managedProperty() |
Defines whether or not this node's layout will be managed by its parent. |
double |
maxHeight |
Returns the node's maximum height for use in layout calculations. |
double |
maxWidth |
Returns the node's maximum width for use in layout calculations. |
double |
minHeight |
Returns the node's minimum height for use in layout calculations. |
double |
minWidth |
Returns the node's minimum width for use in layout calculations. |
final BooleanProperty |
mouseTransparentProperty() |
If true, this node (together with all its children) is completely transparent to mouse events. |
final ObjectProperty |
nodeOrientationProperty() |
Node orientation describes the flow of visual data within a node. |
final void |
notifyAccessibleAttributeChanged |
This method is called by the application to notify the assistive technology that the value for an attribute has changed. |
final ObjectProperty |
onContextMenuRequestedProperty() |
Defines a function to be called when a context menu has been requested on this Node. |
final ObjectProperty |
onDragDetectedProperty() |
Defines a function to be called when drag gesture has been detected. |
final ObjectProperty |
onDragDoneProperty() |
Defines a function to be called when this Node is a drag and drop gesture source after its data has been dropped on a drop target. |
final ObjectProperty |
onDragDroppedProperty() |
Defines a function to be called when the mouse button is released on this Node during drag and drop gesture. |
final ObjectProperty |
onDragEnteredProperty() |
Defines a function to be called when drag gesture enters this Node. |
final ObjectProperty |
onDragExitedProperty() |
Defines a function to be called when drag gesture exits this Node. |
final ObjectProperty |
onDragOverProperty() |
Defines a function to be called when drag gesture progresses within this Node. |
final ObjectProperty |
onInputMethodTextChangedProperty() |
Defines a function to be called when this Node has input focus and the input method text has changed. |
final ObjectProperty |
onKeyPressedProperty() |
Defines a function to be called when this Node or its child Node has input focus and a key has been pressed. |
final ObjectProperty |
onKeyReleasedProperty() |
Defines a function to be called when this Node or its child Node has input focus and a key has been released. |
final ObjectProperty |
onKeyTypedProperty() |
Defines a function to be called when this Node or its child Node has input focus and a key has been typed. |
final ObjectProperty |
onMouseClickedProperty() |
Defines a function to be called when a mouse button has been clicked (pressed and released) on this Node. |
final ObjectProperty |
onMouseDragEnteredProperty() |
Defines a function to be called when a full press-drag-release gesture enters this Node. |
final ObjectProperty |
onMouseDragExitedProperty() |
Defines a function to be called when a full press-drag-release gesture leaves this Node. |
final ObjectProperty |
onMouseDraggedProperty() |
Defines a function to be called when a mouse button is pressed on this Node and then dragged. |
final ObjectProperty |
onMouseDragOverProperty() |
Defines a function to be called when a full press-drag-release gesture progresses within this Node. |
final ObjectProperty |
onMouseDragReleasedProperty() |
Defines a function to be called when a full press-drag-release gesture ends (by releasing mouse button) within this Node. |
final ObjectProperty |
onMouseEnteredProperty() |
Defines a function to be called when the mouse enters this Node. |
final ObjectProperty |
onMouseExitedProperty() |
Defines a function to be called when the mouse exits this Node. |
final ObjectProperty |
onMouseMovedProperty() |
Defines a function to be called when mouse cursor moves within this Node but no buttons have been pushed. |
final ObjectProperty |
onMousePressedProperty() |
Defines a function to be called when a mouse button has been pressed on this Node. |
final ObjectProperty |
onMouseReleasedProperty() |
Defines a function to be called when a mouse button has been released on this Node. |
final ObjectProperty |
onRotateProperty() |
Defines a function to be called when user performs a rotation action. |
final ObjectProperty |
onRotationFinishedProperty() |
Defines a function to be called when a rotation gesture ends. |
final ObjectProperty |
onRotationStartedProperty() |
Defines a function to be called when a rotation gesture is detected. |
final ObjectProperty |
onScrollFinishedProperty() |
Defines a function to be called when a scrolling gesture ends. |
final ObjectProperty |
onScrollProperty() |
Defines a function to be called when user performs a scrolling action. |
final ObjectProperty |
onScrollStartedProperty() |
Defines a function to be called when a scrolling gesture is detected. |
final ObjectProperty |
onSwipeDownProperty() |
Defines a function to be called when a downward swipe gesture centered over this node happens. |
final ObjectProperty |
onSwipeLeftProperty() |
Defines a function to be called when a leftward swipe gesture centered over this node happens. |
final ObjectProperty |
onSwipeRightProperty() |
Defines a function to be called when an rightward swipe gesture centered over this node happens. |
final ObjectProperty |
onSwipeUpProperty() |
Defines a function to be called when an upward swipe gesture centered over this node happens. |
final ObjectProperty |
onTouchMovedProperty() |
Defines a function to be called when a touch point is moved. |
final ObjectProperty |
onTouchPressedProperty() |
Defines a function to be called when a new touch point is pressed. |
final ObjectProperty |
onTouchReleasedProperty() |
Defines a function to be called when a touch point is released. |
final ObjectProperty |
onTouchStationaryProperty() |
Defines a function to be called when a touch point stays pressed and still. |
final ObjectProperty |
onZoomFinishedProperty() |
Defines a function to be called when a zooming gesture ends. |
final ObjectProperty |
onZoomProperty() |
Defines a function to be called when user performs a zooming action. |
final ObjectProperty |
onZoomStartedProperty() |
Defines a function to be called when a zooming gesture is detected. |
final DoubleProperty |
opacityProperty() |
Specifies how opaque (that is, solid) the Node appears. |
final ReadOnlyObjectProperty |
parentProperty() |
The parent of this Node. |
Point2D |
parentToLocal |
Transforms a point from the coordinate space of the parent into the local coordinate space of this Node. |
Point3D |
parentToLocal |
Transforms a point from the coordinate space of the parent into the local coordinate space of this Node. |
Bounds |
parentToLocal |
Transforms a rectangle from the coordinate space of the parent into the local coordinate space of this Node. |
Point2D |
parentToLocal |
Transforms a point from the coordinate space of the parent into the local coordinate space of this Node. |
Point3D |
parentToLocal |
Transforms a point from the coordinate space of the parent into the local coordinate space of this Node. |
final BooleanProperty |
pickOnBoundsProperty() |
Defines how the picking computation is done for this node when triggered by a MouseEvent or a contains function call. |
double |
prefHeight |
Returns the node's preferred height for use in layout calculations. |
double |
prefWidth |
Returns the node's preferred width for use in layout calculations. |
final ReadOnlyBooleanProperty |
pressedProperty() |
Whether or not the Node is pressed. |
final void |
pseudoClassStateChanged |
Used to specify that a pseudo-class of this Node has changed. |
Object |
queryAccessibleAttribute |
This method is called by the assistive technology to request the value for an attribute. |
void |
relocate |
Sets the node's layoutX and layoutY translation properties in order to relocate this node to the x,y location in the parent. |
final <T extends Event> |
removeEventFilter |
Unregisters a previously registered event filter from this target. |
final <T extends Event> |
removeEventHandler |
Unregisters a previously registered event handler from this target. |
void |
requestFocus() |
Requests that this Node get the input focus, and that this Node's top-level ancestor become the focused window. |
final boolean |
requestFocusTraversal |
Requests to move the focus from this Node in the specified direction. |
void |
resize |
If the node is resizable, will set its layout bounds to the specified width and height. |
void |
resizeRelocate |
If the node is resizable, will set its layout bounds to the specified width and height. |
final DoubleProperty |
rotateProperty() |
Defines the angle of rotation about the Node's center, measured in degrees. |
final ObjectProperty |
rotationAxisProperty() |
Defines the axis of rotation of this Node. |
final DoubleProperty |
scaleXProperty() |
Defines the factor by which coordinates are scaled about the center of the object along the X axis of this Node. |
final DoubleProperty |
scaleYProperty() |
Defines the factor by which coordinates are scaled about the center of the object along the Y axis of this Node. |
final DoubleProperty |
scaleZProperty() |
Defines the factor by which coordinates are scaled about the center of the object along the Z axis of this Node. |
final ReadOnlyObjectProperty |
sceneProperty() |
The Scene that this Node is part of. |
Point2D |
sceneToLocal |
Transforms a point from the coordinate space of the scene into the local coordinate space of this Node. |
Point2D |
sceneToLocal |
Transforms a point from the coordinate space of the scene into the local coordinate space of this Node. |
Point3D |
sceneToLocal |
Transforms a point from the coordinate space of the scene into the local coordinate space of this Node. |
Bounds |
sceneToLocal |
Transforms a rectangle from the coordinate space of the scene into the local coordinate space of this Node. |
Bounds |
sceneToLocal |
Transforms a bounds from the coordinate space of the scene into the local coordinate space of this Node. |
Point2D |
sceneToLocal |
Transforms a point from the coordinate space of the scene into the local coordinate space of this Node. |
Point2D |
sceneToLocal |
Transforms a point from the coordinate space of the scene into the local coordinate space of this Node. |
Point3D |
sceneToLocal |
Transforms a point from the coordinate space of the scene into the local coordinate space of this Node. |
Point2D |
screenToLocal |
Transforms a point from the coordinate space of the Screen into the local coordinate space of this Node. |
Bounds |
screenToLocal |
Transforms a rectangle from the coordinate space of the Screen into the local coordinate space of this Node. |
Point2D |
screenToLocal |
Transforms a point from the coordinate space of the Screen into the local coordinate space of this Node. |
final void |
setAccessibleHelp |
Sets the value of the accessibleHelp property. |
final void |
setAccessibleRole |
Sets the value of the accessibleRole property. |
final void |
setAccessibleRoleDescription |
Sets the value of the accessibleRoleDescription property. |
final void |
setAccessibleText |
Sets the value of the accessibleText property. |
final void |
setBlendMode |
Sets the value of the blendMode property. |
final void |
setCache |
Sets the value of the cache property. |
final void |
setCacheHint |
Sets the value of the cacheHint property. |
final void |
setClip |
Sets the value of the clip property. |
final void |
setCursor |
Sets the value of the cursor property. |
final void |
setDepthTest |
Sets the value of the depthTest property. |
final void |
setDisable |
Sets the value of the disable property. |
protected final void |
setDisabled |
Sets the value of the disabled property. |
final void |
setEffect |
Sets the value of the effect property. |
final void |
setEventDispatcher |
Sets the value of the eventDispatcher property. |
protected final <T extends Event> |
setEventHandler |
Sets the handler to use for this event type. |
protected final void |
setFocused |
Sets the value of the focused property. |
final void |
setFocusTraversable |
Sets the value of the focusTraversable property. |
protected final void |
setHover |
Sets the value of the hover property. |
final void |
setId |
Sets the value of the id property. |
final void |
setInputMethodRequests |
Sets the value of the inputMethodRequests property. |
final void |
setLayoutX |
Sets the value of the layoutX property. |
final void |
setLayoutY |
Sets the value of the layoutY property. |
final void |
setManaged |
Sets the value of the managed property. |
final void |
setMouseTransparent |
Sets the value of the mouseTransparent property. |
final void |
setNodeOrientation |
Sets the value of the nodeOrientation property. |
final void |
setOnContextMenuRequested |
Sets the value of the onContextMenuRequested property. |
final void |
setOnDragDetected |
Sets the value of the onDragDetected property. |
final void |
setOnDragDone |
Sets the value of the onDragDone property. |
final void |
setOnDragDropped |
Sets the value of the onDragDropped property. |
final void |
setOnDragEntered |
Sets the value of the onDragEntered property. |
final void |
setOnDragExited |
Sets the value of the onDragExited property. |
final void |
setOnDragOver |
Sets the value of the onDragOver property. |
final void |
setOnInputMethodTextChanged |
Sets the value of the onInputMethodTextChanged property. |
final void |
setOnKeyPressed |
Sets the value of the onKeyPressed property. |
final void |
setOnKeyReleased |
Sets the value of the onKeyReleased property. |
final void |
setOnKeyTyped |
Sets the value of the onKeyTyped property. |
final void |
setOnMouseClicked |
Sets the value of the onMouseClicked property. |
final void |
setOnMouseDragEntered |
Sets the value of the onMouseDragEntered property. |
final void |
setOnMouseDragExited |
Sets the value of the onMouseDragExited property. |
final void |
setOnMouseDragged |
Sets the value of the onMouseDragged property. |
final void |
setOnMouseDragOver |
Sets the value of the onMouseDragOver property. |
final void |
setOnMouseDragReleased |
Sets the value of the onMouseDragReleased property. |
final void |
setOnMouseEntered |
Sets the value of the onMouseEntered property. |
final void |
setOnMouseExited |
Sets the value of the onMouseExited property. |
final void |
setOnMouseMoved |
Sets the value of the onMouseMoved property. |
final void |
setOnMousePressed |
Sets the value of the onMousePressed property. |
final void |
setOnMouseReleased |
Sets the value of the onMouseReleased property. |
final void |
setOnRotate |
Sets the value of the onRotate property. |
final void |
setOnRotationFinished |
Sets the value of the onRotationFinished property. |
final void |
setOnRotationStarted |
Sets the value of the onRotationStarted property. |
final void |
setOnScroll |
Sets the value of the onScroll property. |
final void |
setOnScrollFinished |
Sets the value of the onScrollFinished property. |
final void |
setOnScrollStarted |
Sets the value of the onScrollStarted property. |
final void |
setOnSwipeDown |
Sets the value of the onSwipeDown property. |
final void |
setOnSwipeLeft |
Sets the value of the onSwipeLeft property. |
final void |
setOnSwipeRight |
Sets the value of the onSwipeRight property. |
final void |
setOnSwipeUp |
Sets the value of the onSwipeUp property. |
final void |
setOnTouchMoved |
Sets the value of the onTouchMoved property. |
final void |
setOnTouchPressed |
Sets the value of the onTouchPressed property. |
final void |
setOnTouchReleased |
Sets the value of the onTouchReleased property. |
final void |
setOnTouchStationary |
Sets the value of the onTouchStationary property. |
final void |
setOnZoom |
Sets the value of the onZoom property. |
final void |
setOnZoomFinished |
Sets the value of the onZoomFinished property. |
final void |
setOnZoomStarted |
Sets the value of the onZoomStarted property. |
final void |
setOpacity |
Sets the value of the opacity property. |
final void |
setPickOnBounds |
Sets the value of the pickOnBounds property. |
protected final void |
setPressed |
Sets the value of the pressed property. |
final void |
setRotate |
Sets the value of the rotate property. |
final void |
setRotationAxis |
Sets the value of the rotationAxis property. |
final void |
setScaleX |
Sets the value of the scaleX property. |
final void |
setScaleY |
Sets the value of the scaleY property. |
final void |
setScaleZ |
Sets the value of the scaleZ property. |
final void |
setStyle |
A string representation of the CSS style associated with this specific Node. |
final void |
setTranslateX |
Sets the value of the translateX property. |
final void |
setTranslateY |
Sets the value of the translateY property. |
final void |
setTranslateZ |
Sets the value of the translateZ property. |
void |
setUserData |
Convenience method for setting a single Object property that can be retrieved at a later date. |
final void |
setViewOrder |
Sets the value of the viewOrder property. |
final void |
setVisible |
Sets the value of the visible property. |
WritableImage |
snapshot |
Takes a snapshot of this node and returns the rendered image when it is ready. |
void |
snapshot |
Takes a snapshot of this node at the next frame and calls the specified callback method when the image is ready. |
Dragboard |
startDragAndDrop |
Confirms a potential drag and drop gesture that is recognized over this Node. |
void |
startFullDrag() |
Starts a full press-drag-release gesture with this node as gesture source. |
final StringProperty |
styleProperty() |
A string representation of the CSS style associated with this specific Node. |
void |
toBack() |
Moves this Node to the back of its sibling nodes in terms of z-order. |
void |
toFront() |
Moves this Node to the front of its sibling nodes in terms of z-order. |
String |
toString() |
Returns a string representation for the object. |
final DoubleProperty |
translateXProperty() |
Defines the x coordinate of the translation that is added to this Node's transform. |
final DoubleProperty |
translateYProperty() |
Defines the y coordinate of the translation that is added to this Node's transform. |
final DoubleProperty |
translateZProperty() |
Defines the Z coordinate of the translation that is added to the transformed coordinates of this Node. |
boolean |
usesMirroring() |
Determines whether a node should be mirrored when node orientation is right-to-left. |
final DoubleProperty |
viewOrderProperty() |
Defines the rendering and picking order of this Node within its parent. |
final BooleanProperty |
visibleProperty() |
Specifies whether this Node and any subnodes should be rendered as part of the scene graph. |
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods declared in interface javafx.css.Styleable
getStyleableNode
Property Details
parent
public final ReadOnlyObjectProperty<Parent> parentProperty
Node. If this Node has not been added to a scene graph, then parent will be null.- Default value:
- null
- See Also:
scene
public final ReadOnlyObjectProperty<Scene> sceneProperty
Scene that this Node is part of. If the Node is not part of a scene, then this variable will be null.- Default value:
- null
- See Also:
id
public final StringProperty idProperty
Node. This simple string identifier is useful for finding a specific Node within the scene graph. While the id of a Node should be unique within the scene graph, this uniqueness is not enforced. This is analogous to the "id" attribute on an HTML element (CSS ID Specification). For example, if a Node is given the id of "myId", then the lookup method can be used to find this node as follows: scene.lookup("#myId");.
- Default value:
- null
- See Also:
style
public final StringProperty styleProperty
Node. This is analogous to the "style" attribute of an HTML element. Note that, like the HTML style attribute, this variable contains style properties and values and not the selector portion of a style rule.- Default value:
- empty string
- See Also:
visible
public final BooleanProperty visibleProperty
Node and any subnodes should be rendered as part of the scene graph. A node may be visible and yet not be shown in the rendered scene if, for instance, it is off the screen or obscured by another Node. Invisible nodes never receive mouse events or keyboard focus and never maintain keyboard focus when they become invisible.- Default value:
- true
- See Also:
cursor
public final ObjectProperty<Cursor> cursorProperty
Node and subnodes. If null, then the cursor of the first parent node with a non-null cursor will be used. If no Node in the scene graph defines a cursor, then the cursor of the Scene will be used.- Default value:
- null
- See Also:
opacity
public final DoubleProperty opacityProperty
Node appears. A Node with 0% opacity is fully translucent. That is, while it is still visible and rendered, you generally won't be able to see it. The exception to this rule is when the Node is combined with a blending mode and blend effect in which case a translucent Node may still have an impact in rendering. An opacity of 50% will render the node as being 50% transparent. A visible node with any opacity setting still receives mouse events and can receive keyboard focus. For example, if you want to have a large invisible rectangle overlay all Nodes in the scene graph in order to intercept mouse events but not be visible to the user, you could create a large Rectangle that had an opacity of 0%.
Opacity is specified as a value between 0 and 1. Values less than 0 are treated as 0, values greater than 1 are treated as 1.
On some platforms ImageView might not support opacity variable.
There is a known limitation of mixing opacity < 1.0 with a 3D Transform. Opacity/Blending is essentially a 2D image operation. The result of an opacity < 1.0 set on a Group node with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children.
- Default value:
- 1.0
- See Also:
blendMode
public final ObjectProperty<BlendMode> blendModeProperty
BlendMode used to blend this individual node into the scene behind it. If this node is a Group, then all of the children will be composited individually into a temporary buffer using their own blend modes and then that temporary buffer will be composited into the scene using the specified blend mode. A value of null is treated as pass-through. This means no effect on a parent (such as a Group), and the equivalent of SRC_OVER for a single Node.- Default value:
null- See Also:
clip
public final ObjectProperty<Node> clipProperty
Node to use to define the clipping shape for this Node. This clipping Node is not a child of this Node in the scene graph sense. Rather, it is used to define the clip for this Node. For example, you can use an ImageView Node as a mask to represent the Clip. Or you could use one of the geometric shape Nodes such as Rectangle or Circle. Or you could use a Text node to represent the Clip.
See the class documentation for Node for scene graph structure restrictions on setting the clip. If these restrictions are violated by a change to the clip variable, the change is ignored and the previous value of the clip variable is restored.
Note that this is a conditional feature. See ConditionalFeature.SHAPE_CLIP for more information.
There is a known limitation of mixing Clip with a 3D Transform. Clipping is essentially a 2D image operation. The result of a Clip set on a Group node with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children.
- Default value:
- null
- See Also:
cache
public final BooleanProperty cacheProperty
Node should be cached as a bitmap. Rendering a bitmap representation of a node will be faster than rendering primitives in many cases, especially in the case of primitives with effects applied (such as a blur). However, it also increases memory usage. This hint indicates whether that trade-off (increased memory usage for increased performance) is worthwhile. Also note that on some platforms such as GPU accelerated platforms there is little benefit to caching Nodes as bitmaps when blurs and other effects are used since they are very fast to render on the GPU. The cacheHintProperty() variable provides additional options for enabling more aggressive bitmap caching. Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants.
- Default value:
- false
- See Also:
cacheHint
public final ObjectProperty<CacheHint> cacheHintProperty
Under certain circumstances, such as animating nodes that are very expensive to render, it is desirable to be able to perform transformations on the node without having to regenerate the cached bitmap. An option in such cases is to perform the transforms on the cached bitmap itself.
This technique can provide a dramatic improvement to animation performance, though may also result in a reduction in visual quality. The cacheHint variable provides a hint to the system about how and when that trade-off (visual quality for animation performance) is acceptable.
It is possible to enable the cacheHint only at times when your node is animating. In this way, expensive nodes can appear on screen with full visual quality, yet still animate smoothly.
Example:
expensiveNode.setCache(true);
expensiveNode.setCacheHint(CacheHint.QUALITY);
...
// Do an animation
expensiveNode.setCacheHint(CacheHint.SPEED);
new Timeline(
new KeyFrame(Duration.seconds(2),
new KeyValue(expensiveNode.scaleXProperty(), 2.0),
new KeyValue(expensiveNode.scaleYProperty(), 2.0),
new KeyValue(expensiveNode.rotateProperty(), 360),
new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY)
)
).play();
Note that cacheHint is only a hint to the system. Depending on the details of the node or the transform, this hint may be ignored. If Node.cache is false, cacheHint is ignored. Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants.
- Default value:
- CacheHint.DEFAULT
- See Also:
effect
public final ObjectProperty<Effect> effectProperty
Node. Note that this is a conditional feature. See ConditionalFeature.EFFECT for more information.
There is a known limitation of mixing Effect with a 3D Transform. Effect is essentially a 2D image operation. The result of an Effect set on a Group node with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children.
- Default value:
- null
- See Also:
depthTest
public final ObjectProperty<DepthTest> depthTestProperty
DepthTest.DISABLE, then depth testing is disabled for this node. If the depthTest flag is DepthTest.ENABLE, then depth testing is enabled for this node. If the depthTest flag is DepthTest.INHERIT, then depth testing is enabled for this node if it is enabled for the parent node or the parent node is null. The depthTest flag is only used when the depthBuffer flag for the Scene is true (meaning that the Scene has an associated depth buffer)
Depth test comparison is only done among nodes with depthTest enabled. A node with depthTest disabled does not read, test, or write the depth buffer, that is to say its Z value will not be considered for depth testing with other nodes.
Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
See the constructor in Scene with depthBuffer as one of its input arguments.
- Default value:
- INHERIT
- See Also:
disable
public final BooleanProperty disableProperty
Node. Setting disable to true will cause this Node and any subnodes to become disabled. This property should be used only to set the disabled state of a Node. For querying the disabled state of a Node, the disabled property should instead be used, since it is possible that a Node was disabled as a result of an ancestor being disabled even if the individual disable state on this Node is false.- Default value:
- false
- See Also:
pickOnBounds
public final BooleanProperty pickOnBoundsProperty
MouseEvent or a contains function call. If pickOnBounds is true, then picking is computed by intersecting with the bounds of this node, else picking is computed by intersecting with the geometric shape of this node. The default value of this property is false unless overridden by a subclass. The default value is true for Region.- Default value:
- false; true for
Region - See Also:
disabled
public final ReadOnlyBooleanProperty disabledProperty
Node is disabled. A Node will become disabled if disable is set to true on either itself or one of its ancestors in the scene graph. A disabled Node should render itself differently to indicate its disabled state to the user. Such disabled rendering is dependent on the implementation of the Node. The shape classes contained in javafx.scene.shape do not implement such rendering by default, therefore applications using shapes for handling input must implement appropriate disabled rendering themselves. The user-interface controls defined in javafx.scene.control will implement disabled-sensitive rendering, however.
A disabled Node does not receive mouse or key events.
- Default value:
- false
- See Also:
onDragEntered
public final ObjectProperty<EventHandler<? super DragEvent>> onDragEnteredProperty
Node.- See Also:
onDragExited
public final ObjectProperty<EventHandler<? super DragEvent>> onDragExitedProperty
Node.- See Also:
onDragOver
public final ObjectProperty<EventHandler<? super DragEvent>> onDragOverProperty
Node.- See Also:
onDragDropped
onDragDone
public final ObjectProperty<EventHandler<? super DragEvent>> onDragDoneProperty
Node 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.- See Also:
managed
public final BooleanProperty managedProperty
layoutBounds calculations and will lay it out during the scene's layout pass. If a managed node's layoutBounds changes, it will automatically trigger relayout up the scene-graph to the nearest layout root (which is typically the scene's root node). If the node is unmanaged, its parent will ignore the child in both preferred size computations and layout. Changes in layoutBounds will not trigger relayout above it. If an unmanaged node is of type Parent, it will act as a "layout root", meaning that calls to Parent.requestLayout() beneath it will cause only the branch rooted by the node to be relayed out, thereby isolating layout changes to that root and below. It's the application's responsibility to set the size and position of an unmanaged node.
By default all nodes are managed.
- See Also:
layoutX
public final DoubleProperty layoutXProperty
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its current layoutBounds minX position (which might not be 0) to the desired location. For example, if textnode should be positioned at finalX
textnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());
Failure to subtract layoutBounds minX may result in misplacement of the node. The relocate(x, y) method will automatically do the correct computation and should generally be used over setting layoutX directly.
The node's final translation will be computed as layoutX + translateX, where layoutX establishes the node's stable position and translateX optionally makes dynamic adjustments to that position.
If the node is managed and has a Region as its parent, then the layout region will set layoutX according to its own layout policy. If the node is unmanaged or parented by a Group, then the application may set layoutX directly to position it.
- See Also:
layoutY
public final DoubleProperty layoutYProperty
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its current layoutBounds minY position (which might not be 0) to the desired location. For example, if textnode should be positioned at finalY
textnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());
Failure to subtract layoutBounds minY may result in misplacement of the node. The relocate(x, y) method will automatically do the correct computation and should generally be used over setting layoutY directly.
The node's final translation will be computed as layoutY + translateY, where layoutY establishes the node's stable position and translateY optionally makes dynamic adjustments to that position.
If the node is managed and has a Region as its parent, then the region will set layoutY according to its own layout policy. If the node is unmanaged or parented by a Group, then the application may set layoutY directly to position it.
- See Also:
boundsInParent
public final ReadOnlyObjectProperty<Bounds> boundsInParentProperty
Node in the parent coordinate system. boundsInParent is calculated by taking the local bounds and applying the node transforms as specified in the Transformations section of the class doc. The resulting bounds will be conceptually in the coordinate space of the Node's parent, however, the node need not have a parent to calculate these bounds.
Note that this method does not take the node's visibility into account; the computation is based on the geometry of this Node only.
This property will always have a non-null value.
Note that boundsInParent is automatically recomputed whenever the geometry of a node changes, or when any of the following the change: transforms ObservableList, any of the translate, layout or scale variables, or the rotate variable. For this reason, it is an error to bind any of these values in a node to an expression that depends upon this variable. For example, the x or y variables of a shape, or translateX, translateY should never be bound to boundsInParent for the purpose of positioning the node.
See also the Bounding Rectangles section.
- See Also:
boundsInLocal
public final ReadOnlyObjectProperty<Bounds> boundsInLocalProperty
Node in the node's untransformed local coordinate space. For nodes that extend Shape, the local bounds will also include space required for a non-zero stroke that may fall outside the shape's geometry that is defined by position and size attributes. The local bounds will also include any clipping set with clip as well as effects set with effect. Note that this method does not take the node's visibility into account; the computation is based on the geometry of this Node only.
This property will always have a non-null value.
Note that boundsInLocal is automatically recomputed whenever the geometry of a node changes. For this reason, it is an error to bind any of these values in a node to an expression that depends upon this variable. For example, the x or y variables of a shape should never be bound to boundsInLocal for the purpose of positioning the node.
- See Also:
layoutBounds
public final ReadOnlyObjectProperty<Bounds> layoutBoundsProperty
layoutBounds may differ from the visual bounds of the node and is computed differently depending on the node type. If the node type is resizable (Region, Control, or WebView) then the layoutBounds will always be 0,0 width x height. If the node type is not resizable (Shape, Text, or Group), then the layoutBounds are computed based on the node's geometric properties and does not include the node's clip, effect, or transforms. See individual class documentation for details.
Note that the layoutX, layoutY, translateX, and translateY variables are not included in the layoutBounds. This is important because layout code must first determine the current size and location of the node (using layoutBounds) and then set layoutX and layoutY to adjust the translation of the node so that it will have the desired layout position.
Because the computation of layoutBounds is often tied to a node's geometric variables, it is an error to bind any such variables to an expression that depends upon layoutBounds. For example, the x or y variables of a shape should never be bound to layoutBounds for the purpose of positioning the node.
Note that for 3D shapes, the layout bounds is actually a rectangular box with X, Y, and Z values, although only X and Y are used in layout calculations.
The layoutBounds will never be null.
- See Also:
viewOrder
public final DoubleProperty viewOrderProperty
Node within its parent. This property is used to alter the rendering and picking order of a node within its parent without reordering the parent's children list. For example, this can be used as a more efficient way to implement transparency sorting. To do this, an application can assign the viewOrder value of each node to the computed distance between that node and the viewer.
The parent will traverse its children in decreasing viewOrder order. This means that a child with a lower viewOrder will be in front of a child with a higher viewOrder. If two children have the same viewOrder, the parent will traverse them in the order they appear in the parent's children list.
However, viewOrder does not alter the layout and focus traversal order of this Node within its parent. A parent always traverses its children list in order when doing layout or focus traversal.
- Default value:
- 0.0
- Since:
- 9
- See Also:
translateX
public final DoubleProperty translateXProperty
Node's transform. The node's final translation will be computed as layoutX + translateX, where layoutX establishes the node's stable position and translateX optionally makes dynamic adjustments to that position.
This variable can be used to alter the location of a node without disturbing its layoutBounds, which makes it useful for animating a node's location.
- Default value:
- 0
- See Also:
translateY
public final DoubleProperty translateYProperty
Node's transform. The node's final translation will be computed as layoutY + translateY, where layoutY establishes the node's stable position and translateY optionally makes dynamic adjustments to that position.
This variable can be used to alter the location of a node without disturbing its layoutBounds, which makes it useful for animating a node's location.
- Default value:
- 0
- See Also:
translateZ
public final DoubleProperty translateZProperty
Node. This value will be added to any translation defined by the transforms ObservableList and layoutZ. This variable can be used to alter the location of a Node without disturbing its layout bounds, which makes it useful for animating a node's location.
Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
- Default value:
- 0
- See Also:
scaleX
public final DoubleProperty scaleXProperty
Node. This is used to stretch or shrink the node either manually or by using an animation. This scale factor is not included in layoutBounds by default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.
The pivot point about which the scale occurs is the center of the untransformed layoutBounds.
- Default value:
- 1.0
- See Also:
scaleY
public final DoubleProperty scaleYProperty
Node. This is used to stretch or shrink the node either manually or by using an animation. This scale factor is not included in layoutBounds by default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.
The pivot point about which the scale occurs is the center of the untransformed layoutBounds.
- Default value:
- 1.0
- See Also:
scaleZ
public final DoubleProperty scaleZProperty
Node. This is used to stretch or shrink the node either manually or by using an animation. This scale factor is not included in layoutBounds by default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.
The pivot point about which the scale occurs is the center of the rectangular bounds formed by taking boundsInLocal and applying all the transforms in the transforms ObservableList.
Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
- Default value:
- 1.0
- See Also:
rotate
public final DoubleProperty rotateProperty
Node's center, measured in degrees. This is used to rotate the Node. This rotation factor is not included in layoutBounds by default, which makes it ideal for rotating the entire node after all effects and transforms have been taken into account.
The pivot point about which the rotation occurs is the center of the untransformed layoutBounds.
Note that because the pivot point is computed as the center of this Node's layout bounds, any change to the layout bounds will cause the pivot point to change, which can move the object. For a leaf node, any change to the geometry will cause the layout bounds to change. For a group node, any change to any of its children, including a change in a child's geometry, clip, effect, position, orientation, or scale, will cause the group's layout bounds to change. If this movement of the pivot point is not desired, applications should instead use the Node's transforms ObservableList, and add a Rotate transform, which has a user-specifiable pivot point.
- Default value:
- 0.0
- See Also:
rotationAxis
public final ObjectProperty<Point3D> rotationAxisProperty
Node. Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
- Default value:
- Rotate.Z_AXIS
- See Also:
localToParentTransform
public final ReadOnlyObjectProperty<Transform> localToParentTransformProperty
- Since:
- JavaFX 2.2
- See Also:
localToSceneTransform
public final ReadOnlyObjectProperty<Transform> localToSceneTransformProperty
SubScene, this property represents transforms up to the subscene, not the root scene. Note that when you register a listener or a binding to this property, it needs to listen for invalidation on all its parents to the root node. This means that registering a listener on this property on many nodes may negatively affect performance of transformation changes in their common parents.
- Since:
- JavaFX 2.2
- See Also:
nodeOrientation
public final ObjectProperty<NodeOrientation> nodeOrientationProperty
- Default value:
NodeOrientation.INHERIT- Since:
- JavaFX 8.0
- See Also:
effectiveNodeOrientation
public final ReadOnlyObjectProperty<NodeOrientation> effectiveNodeOrientationProperty
- Since:
- JavaFX 8.0
- See Also:
mouseTransparent
public final BooleanProperty mouseTransparentProperty
true, this node (together with all its children) is completely transparent to mouse events. When choosing target for mouse event, nodes with mouseTransparent set to true and their subtrees won't be taken into account.- See Also:
hover
public final ReadOnlyBooleanProperty hoverProperty
Node is being hovered over. Typically this is due to the mouse being over the node, though it could be due to a pen hovering on a graphics tablet or other form of input. Note that current implementation of hover relies on mouse enter and exit events to determine whether this Node is in the hover state; this means that this feature is currently supported only on systems that have a mouse. Future implementations may provide alternative means of supporting hover.
- Default value:
- false
- See Also:
pressed
public final ReadOnlyBooleanProperty pressedProperty
Node is pressed. Typically this is true when the primary mouse button is down, though subclasses may define other mouse button state or key state to cause the node to be "pressed".- Default value:
- false
- See Also:
onContextMenuRequested
public final ObjectProperty<EventHandler<? super ContextMenuEvent>> onContextMenuRequestedProperty
Node.- Since:
- JavaFX 2.1
- See Also:
onMouseClicked
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseClickedProperty
Node.- See Also:
onMouseDragged
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseDraggedProperty
Node and then dragged.- See Also:
onMouseEntered
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseEnteredProperty
Node.- See Also:
onMouseExited
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseExitedProperty
Node.- See Also:
onMouseMoved
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseMovedProperty
Node but no buttons have been pushed.- See Also:
onMousePressed
public final ObjectProperty<EventHandler<? super MouseEvent>> onMousePressedProperty
Node.- See Also:
onMouseReleased
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseReleasedProperty
Node.- See Also:
onDragDetected
public final ObjectProperty<EventHandler<? super MouseEvent>> onDragDetectedProperty
- See Also:
onMouseDragOver
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragOverProperty
Node.- Since:
- JavaFX 2.1
- See Also:
onMouseDragReleased
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragReleasedProperty
Node.- Since:
- JavaFX 2.1
- See Also:
onMouseDragEntered
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragEnteredProperty
Node.- Since:
- JavaFX 2.1
- See Also:
onMouseDragExited
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragExitedProperty
Node.- Since:
- JavaFX 2.1
- See Also:
onScrollStarted
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollStartedProperty
- Since:
- JavaFX 2.2
- See Also:
onScroll
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollProperty
- See Also:
onScrollFinished
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollFinishedProperty
- Since:
- JavaFX 2.2
- See Also:
onRotationStarted
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationStartedProperty
- Since:
- JavaFX 2.2
- See Also:
onRotate
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotateProperty
- Since:
- JavaFX 2.2
- See Also:
onRotationFinished
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationFinishedProperty
- Since:
- JavaFX 2.2
- See Also:
onZoomStarted
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomStartedProperty
- Since:
- JavaFX 2.2
- See Also:
onZoom
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomProperty
- Since:
- JavaFX 2.2
- See Also:
onZoomFinished
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomFinishedProperty
- Since:
- JavaFX 2.2
- See Also:
onSwipeUp
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeUpProperty
- Since:
- JavaFX 2.2
- See Also:
onSwipeDown
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeDownProperty
- Since:
- JavaFX 2.2
- See Also:
onSwipeLeft
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeLeftProperty
- Since:
- JavaFX 2.2
- See Also:
onSwipeRight
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeRightProperty
- Since:
- JavaFX 2.2
- See Also:
onTouchPressed
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchPressedProperty
- Since:
- JavaFX 2.2
- See Also:
onTouchMoved
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchMovedProperty
- Since:
- JavaFX 2.2
- See Also:
onTouchReleased
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchReleasedProperty
- Since:
- JavaFX 2.2
- See Also:
onTouchStationary
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchStationaryProperty
- Since:
- JavaFX 2.2
- See Also:
onKeyPressed
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyPressedProperty
Node or its child Node 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.- See Also:
onKeyReleased
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyReleasedProperty
Node or its child Node 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.- See Also:
onKeyTyped
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyTypedProperty
Node or its child Node 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.- See Also:
onInputMethodTextChanged
public final ObjectProperty<EventHandler<? super InputMethodEvent>> onInputMethodTextChangedProperty
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.
- See Also:
inputMethodRequests
public final ObjectProperty<InputMethodRequests> inputMethodRequestsProperty
- See Also:
focused
public final ReadOnlyBooleanProperty focusedProperty
Node currently has the input focus. To have the input focus, a node must be the Scene's focus owner, and the scene must be in a Stage that is visible and active. See requestFocus() for more information.- Default value:
- false
- See Also:
focusVisible
public final ReadOnlyBooleanProperty focusVisibleProperty
Node should visibly indicate focus. This flag is set when the node acquires input focus via keyboard navigation, and it is cleared when the node loses focus or when requestFocus() is called.- Default value:
- false
- Since:
- 19
- See Also:
focusWithin
public final ReadOnlyBooleanProperty focusWithinProperty
Node or any of its descendants currently has the input focus.- Default value:
- false
- Since:
- 19
- See Also:
focusTraversable
public final BooleanProperty focusTraversableProperty
Node should be a part of focus traversal cycle. When this property is true focus can be moved to this Node and from this Node using regular focus traversal keys. On a desktop such keys are usually TAB for moving focus forward and SHIFT+TAB for moving focus backward. When a Scene is created, the system gives focus to a Node whose focusTraversable variable is true and that is eligible to receive the focus, unless the focus had been set explicitly via a call to requestFocus().- Default value:
- false
- See Also:
eventDispatcher
public final ObjectProperty<EventDispatcher> eventDispatcherProperty
EventDispatcher, the new dispatcher should forward events to the replaced dispatcher to maintain the node's default event handling behavior.- See Also:
accessibleRole
public final ObjectProperty<AccessibleRole> accessibleRoleProperty
Node. The screen reader uses the role of a node to determine the attributes and actions that are supported.
- Default value:
AccessibleRole.NODE- Since:
- JavaFX 8u40
- See Also:
accessibleRoleDescription
public final ObjectProperty<String> accessibleRoleDescriptionProperty
Node. Normally, when a role is provided for a node, the screen reader speaks the role as well as the contents of the node. When this value is set, it is possible to override the default. This is useful because the set of roles is predefined. For example, it is possible to set the role of a node to be a button, but have the role description be arbitrary text.
- Default value:
- null
- Since:
- JavaFX 8u40
- See Also:
accessibleText
public final ObjectProperty<String> accessibleTextProperty
Node. This property is used to set the text that the screen reader will speak. If a node normally speaks text, that text is overriden. For example, a button usually speaks using the text in the control but will no longer do this when this value is set.
- Default value:
- null
- Since:
- JavaFX 8u40
- See Also:
accessibleHelp
public final ObjectProperty<String> accessibleHelpProperty
Node. The help text provides a more detailed description of the accessible text for a node. By default, if the node has a tool tip, this text is used.
- Default value:
- null
- Since:
- JavaFX 8u40
- See Also:
Field Details
BASELINE_OFFSET_SAME_AS_HEIGHT
public static final double BASELINE_OFFSET_SAME_AS_HEIGHT
getBaselineOffset(). This means that the Parent (layout Pane) of this Node should use the height of this Node as a baseline.- See Also:
Constructor Details
Node
protected Node()
Method Details
getProperties
public final ObservableMap<Object,Object> getProperties()
- API Note:
- Layout managers use this map as well to specify layout constraints on the node, such as
HBox#setHgrow, so the developer should be mindful of clearing the map or overriding its values. These entries are not removed automatically if the node is removed from the layout manager, so unused entries can exist throughout the life of the node. - Returns:
- an observable map of properties on this node for use primarily by application developers
hasProperties
public boolean hasProperties()
- Returns:
- true if node has properties.
setUserData
public void setUserData(Object value)
getUserData().- Parameters:
-
value- The value to be stored - this can later be retrieved by callinggetUserData().
getUserData
public Object getUserData()
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.
getParent
public final Parent getParent()
parent property.- Property description:
- The parent of this
Node. If thisNodehas not been added to a scene graph, then parent will be null. - Default value:
- null
- Returns:
- the value of the
parentproperty - See Also:
parentProperty
public final ReadOnlyObjectProperty<Parent> parentProperty()
Node. If this Node has not been added to a scene graph, then parent will be null.- Default value:
- null
- Returns:
- the
parentproperty - See Also:
getScene
public final Scene getScene()
scene property.- Property description:
- The
Scenethat thisNodeis part of. If the Node is not part of a scene, then this variable will be null. - Default value:
- null
- Returns:
- the value of the
sceneproperty - See Also:
sceneProperty
public final ReadOnlyObjectProperty<Scene> sceneProperty()
Scene that this Node is part of. If the Node is not part of a scene, then this variable will be null.- Default value:
- null
- Returns:
- the
sceneproperty - See Also:
setId
public final void setId(String value)
id property.- Property description:
- The id of this
Node. This simple string identifier is useful for finding a specific Node within the scene graph. While the id of a Node should be unique within the scene graph, this uniqueness is not enforced. This is analogous to the "id" attribute on an HTML element (CSS ID Specification).For example, if a Node is given the id of "myId", then the lookup method can be used to find this node as follows:
scene.lookup("#myId");. - Default value:
- null
- Parameters:
-
value- the value for theidproperty - See Also:
getId
public final String getId()
Node. This simple string identifier is useful for finding a specific Node within the scene graph. While the id of a Node should be unique within the scene graph, this uniqueness is not enforced. This is analogous to the "id" attribute on an HTML element (CSS ID Specification).idProperty
public final StringProperty idProperty()
Node. This simple string identifier is useful for finding a specific Node within the scene graph. While the id of a Node should be unique within the scene graph, this uniqueness is not enforced. This is analogous to the "id" attribute on an HTML element (CSS ID Specification). For example, if a Node is given the id of "myId", then the lookup method can be used to find this node as follows: scene.lookup("#myId");.
- Default value:
- null
- Returns:
- the
idproperty - See Also:
getStyleClass
public final ObservableList<String> getStyleClass()
Styleable- Specified by:
-
getStyleClassin interfaceStyleable - Returns:
- a list of String identifiers which can be used to logically group Nodes, specifically for an external style engine
- See Also:
setStyle
public final void setStyle(String value)
Node. This is analogous to the "style" attribute of an HTML element. Note that, like the HTML style attribute, this variable contains style properties and values and not the selector portion of a style rule.- Default value:
- empty string
- Parameters:
-
value- The inline CSS style to use for thisNode.nullis implicitly converted to an empty String. - See Also:
getStyle
public final String getStyle()
Node. This is analogous to the "style" attribute of an HTML element. Note that, like the HTML style attribute, this variable contains style properties and values and not the selector portion of a style rule.styleProperty
public final StringProperty styleProperty()
Node. This is analogous to the "style" attribute of an HTML element. Note that, like the HTML style attribute, this variable contains style properties and values and not the selector portion of a style rule.- Default value:
- empty string
- Returns:
- the
styleproperty - See Also:
setVisible
public final void setVisible(boolean value)
visible property.- Property description:
- Specifies whether this
Nodeand any subnodes should be rendered as part of the scene graph. A node may be visible and yet not be shown in the rendered scene if, for instance, it is off the screen or obscured by another Node. Invisible nodes never receive mouse events or keyboard focus and never maintain keyboard focus when they become invisible. - Default value:
- true
- Parameters:
-
value- the value for thevisibleproperty - See Also:
isVisible
public final boolean isVisible()
visible property.- Property description:
- Specifies whether this
Nodeand any subnodes should be rendered as part of the scene graph. A node may be visible and yet not be shown in the rendered scene if, for instance, it is off the screen or obscured by another Node. Invisible nodes never receive mouse events or keyboard focus and never maintain keyboard focus when they become invisible. - Default value:
- true
- Returns:
- the value of the
visibleproperty - See Also:
visibleProperty
public final BooleanProperty visibleProperty()
Node and any subnodes should be rendered as part of the scene graph. A node may be visible and yet not be shown in the rendered scene if, for instance, it is off the screen or obscured by another Node. Invisible nodes never receive mouse events or keyboard focus and never maintain keyboard focus when they become invisible.- Default value:
- true
- Returns:
- the
visibleproperty - See Also:
setCursor
public final void setCursor(Cursor value)
cursor property.- Property description:
- Defines the mouse cursor for this
Nodeand subnodes. If null, then the cursor of the first parent node with a non-null cursor will be used. If no Node in the scene graph defines a cursor, then the cursor of theScenewill be used. - Default value:
- null
- Parameters:
-
value- the value for thecursorproperty - See Also:
getCursor
public final Cursor getCursor()
cursor property.- Property description:
- Defines the mouse cursor for this
Nodeand subnodes. If null, then the cursor of the first parent node with a non-null cursor will be used. If no Node in the scene graph defines a cursor, then the cursor of theScenewill be used. - Default value:
- null
- Returns:
- the value of the
cursorproperty - See Also:
cursorProperty
public final ObjectProperty<Cursor> cursorProperty()
Node and subnodes. If null, then the cursor of the first parent node with a non-null cursor will be used. If no Node in the scene graph defines a cursor, then the cursor of the Scene will be used.- Default value:
- null
- Returns:
- the mouse cursor for this
Nodeand subnodes - See Also:
setOpacity
public final void setOpacity(double value)
opacity property.- Property description:
- Specifies how opaque (that is, solid) the
Nodeappears. A Node with 0% opacity is fully translucent. That is, while it is stillvisibleand rendered, you generally won't be able to see it. The exception to this rule is when theNodeis combined with a blending mode and blend effect in which case a translucent Node may still have an impact in rendering. An opacity of 50% will render the node as being 50% transparent.A
visiblenode with any opacity setting still receives mouse events and can receive keyboard focus. For example, if you want to have a large invisible rectangle overlay allNodes in the scene graph in order to intercept mouse events but not be visible to the user, you could create a largeRectanglethat had an opacity of 0%.Opacity is specified as a value between 0 and 1. Values less than 0 are treated as 0, values greater than 1 are treated as 1.
On some platforms ImageView might not support opacity variable.
There is a known limitation of mixing opacity < 1.0 with a 3D Transform. Opacity/Blending is essentially a 2D image operation. The result of an opacity < 1.0 set on a
Groupnode with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children. - Default value:
- 1.0
- Parameters:
-
value- the value for theopacityproperty - See Also:
getOpacity
public final double getOpacity()
opacity property.- Property description:
- Specifies how opaque (that is, solid) the
Nodeappears. A Node with 0% opacity is fully translucent. That is, while it is stillvisibleand rendered, you generally won't be able to see it. The exception to this rule is when theNodeis combined with a blending mode and blend effect in which case a translucent Node may still have an impact in rendering. An opacity of 50% will render the node as being 50% transparent.A
visiblenode with any opacity setting still receives mouse events and can receive keyboard focus. For example, if you want to have a large invisible rectangle overlay allNodes in the scene graph in order to intercept mouse events but not be visible to the user, you could create a largeRectanglethat had an opacity of 0%.Opacity is specified as a value between 0 and 1. Values less than 0 are treated as 0, values greater than 1 are treated as 1.
On some platforms ImageView might not support opacity variable.
There is a known limitation of mixing opacity < 1.0 with a 3D Transform. Opacity/Blending is essentially a 2D image operation. The result of an opacity < 1.0 set on a
Groupnode with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children. - Default value:
- 1.0
- Returns:
- the value of the
opacityproperty - See Also:
opacityProperty
public final DoubleProperty opacityProperty()
Node appears. A Node with 0% opacity is fully translucent. That is, while it is still visible and rendered, you generally won't be able to see it. The exception to this rule is when the Node is combined with a blending mode and blend effect in which case a translucent Node may still have an impact in rendering. An opacity of 50% will render the node as being 50% transparent. A visible node with any opacity setting still receives mouse events and can receive keyboard focus. For example, if you want to have a large invisible rectangle overlay all Nodes in the scene graph in order to intercept mouse events but not be visible to the user, you could create a large Rectangle that had an opacity of 0%.
Opacity is specified as a value between 0 and 1. Values less than 0 are treated as 0, values greater than 1 are treated as 1.
On some platforms ImageView might not support opacity variable.
There is a known limitation of mixing opacity < 1.0 with a 3D Transform. Opacity/Blending is essentially a 2D image operation. The result of an opacity < 1.0 set on a Group node with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children.
- Default value:
- 1.0
- Returns:
- the
opacityproperty - See Also:
setBlendMode
public final void setBlendMode(BlendMode value)
blendMode property.- Property description:
- The
BlendModeused to blend this individual node into the scene behind it. If this node is aGroup, then all of the children will be composited individually into a temporary buffer using their own blend modes and then that temporary buffer will be composited into the scene using the specified blend mode. A value ofnullis treated as pass-through. This means no effect on a parent (such as aGroup), and the equivalent ofSRC_OVERfor a singleNode. - Default value:
null- Parameters:
-
value- the value for theblendModeproperty - See Also:
getBlendMode
public final BlendMode getBlendMode()
blendMode property.- Property description:
- The
BlendModeused to blend this individual node into the scene behind it. If this node is aGroup, then all of the children will be composited individually into a temporary buffer using their own blend modes and then that temporary buffer will be composited into the scene using the specified blend mode. A value ofnullis treated as pass-through. This means no effect on a parent (such as aGroup), and the equivalent ofSRC_OVERfor a singleNode. - Default value:
null- Returns:
- the value of the
blendModeproperty - See Also:
blendModeProperty
public final ObjectProperty<BlendMode> blendModeProperty()
BlendMode used to blend this individual node into the scene behind it. If this node is a Group, then all of the children will be composited individually into a temporary buffer using their own blend modes and then that temporary buffer will be composited into the scene using the specified blend mode. A value of null is treated as pass-through. This means no effect on a parent (such as a Group), and the equivalent of SRC_OVER for a single Node.- Default value:
null- Returns:
- the
blendModeproperty - See Also:
setClip
public final void setClip(Node value)
clip property.- Property description:
- Specifies a
Nodeto use to define the clipping shape for this Node. This clipping Node is not a child of thisNodein the scene graph sense. Rather, it is used to define the clip for thisNode.For example, you can use an
ImageViewNode as a mask to represent the Clip. Or you could use one of the geometric shape Nodes such asRectangleorCircle. Or you could use aTextnode to represent the Clip.See the class documentation for
Nodefor scene graph structure restrictions on setting the clip. If these restrictions are violated by a change to the clip variable, the change is ignored and the previous value of the clip variable is restored.Note that this is a conditional feature. See
ConditionalFeature.SHAPE_CLIPfor more information.There is a known limitation of mixing Clip with a 3D Transform. Clipping is essentially a 2D image operation. The result of a Clip set on a
Groupnode with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children. - Default value:
- null
- Parameters:
-
value- the value for theclipproperty - See Also:
getClip
public final Node getClip()
clip property.- Property description:
- Specifies a
Nodeto use to define the clipping shape for this Node. This clipping Node is not a child of thisNodein the scene graph sense. Rather, it is used to define the clip for thisNode.For example, you can use an
ImageViewNode as a mask to represent the Clip. Or you could use one of the geometric shape Nodes such asRectangleorCircle. Or you could use aTextnode to represent the Clip.See the class documentation for
Nodefor scene graph structure restrictions on setting the clip. If these restrictions are violated by a change to the clip variable, the change is ignored and the previous value of the clip variable is restored.Note that this is a conditional feature. See
ConditionalFeature.SHAPE_CLIPfor more information.There is a known limitation of mixing Clip with a 3D Transform. Clipping is essentially a 2D image operation. The result of a Clip set on a
Groupnode with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children. - Default value:
- null
- Returns:
- the value of the
clipproperty - See Also:
clipProperty
public final ObjectProperty<Node> clipProperty()
Node to use to define the clipping shape for this Node. This clipping Node is not a child of this Node in the scene graph sense. Rather, it is used to define the clip for this Node. For example, you can use an ImageView Node as a mask to represent the Clip. Or you could use one of the geometric shape Nodes such as Rectangle or Circle. Or you could use a Text node to represent the Clip.
See the class documentation for Node for scene graph structure restrictions on setting the clip. If these restrictions are violated by a change to the clip variable, the change is ignored and the previous value of the clip variable is restored.
Note that this is a conditional feature. See ConditionalFeature.SHAPE_CLIP for more information.
There is a known limitation of mixing Clip with a 3D Transform. Clipping is essentially a 2D image operation. The result of a Clip set on a Group node with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children.
- Default value:
- null
- Returns:
- the the clipping shape for this
Node - See Also:
setCache
public final void setCache(boolean value)
cache property.- Property description:
- A performance hint to the system to indicate that this
Nodeshould be cached as a bitmap. Rendering a bitmap representation of a node will be faster than rendering primitives in many cases, especially in the case of primitives with effects applied (such as a blur). However, it also increases memory usage. This hint indicates whether that trade-off (increased memory usage for increased performance) is worthwhile. Also note that on some platforms such as GPU accelerated platforms there is little benefit to caching Nodes as bitmaps when blurs and other effects are used since they are very fast to render on the GPU. ThecacheHintProperty()variable provides additional options for enabling more aggressive bitmap caching.Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants.
- Default value:
- false
- Parameters:
-
value- the value for thecacheproperty - See Also:
isCache
public final boolean isCache()
cache property.- Property description:
- A performance hint to the system to indicate that this
Nodeshould be cached as a bitmap. Rendering a bitmap representation of a node will be faster than rendering primitives in many cases, especially in the case of primitives with effects applied (such as a blur). However, it also increases memory usage. This hint indicates whether that trade-off (increased memory usage for increased performance) is worthwhile. Also note that on some platforms such as GPU accelerated platforms there is little benefit to caching Nodes as bitmaps when blurs and other effects are used since they are very fast to render on the GPU. ThecacheHintProperty()variable provides additional options for enabling more aggressive bitmap caching.Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants.
- Default value:
- false
- Returns:
- the value of the
cacheproperty - See Also:
cacheProperty
public final BooleanProperty cacheProperty()
Node should be cached as a bitmap. Rendering a bitmap representation of a node will be faster than rendering primitives in many cases, especially in the case of primitives with effects applied (such as a blur). However, it also increases memory usage. This hint indicates whether that trade-off (increased memory usage for increased performance) is worthwhile. Also note that on some platforms such as GPU accelerated platforms there is little benefit to caching Nodes as bitmaps when blurs and other effects are used since they are very fast to render on the GPU. The cacheHintProperty() variable provides additional options for enabling more aggressive bitmap caching. Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants.
- Default value:
- false
- Returns:
- the hint to cache for this
Node - See Also:
setCacheHint
public final void setCacheHint(CacheHint value)
cacheHint property.- Property description:
- Additional hint for controlling bitmap caching.
Under certain circumstances, such as animating nodes that are very expensive to render, it is desirable to be able to perform transformations on the node without having to regenerate the cached bitmap. An option in such cases is to perform the transforms on the cached bitmap itself.
This technique can provide a dramatic improvement to animation performance, though may also result in a reduction in visual quality. The
cacheHintvariable provides a hint to the system about how and when that trade-off (visual quality for animation performance) is acceptable.It is possible to enable the cacheHint only at times when your node is animating. In this way, expensive nodes can appear on screen with full visual quality, yet still animate smoothly.
Example:
Note thatexpensiveNode.setCache(true); expensiveNode.setCacheHint(CacheHint.QUALITY); ... // Do an animation expensiveNode.setCacheHint(CacheHint.SPEED); new Timeline( new KeyFrame(Duration.seconds(2), new KeyValue(expensiveNode.scaleXProperty(), 2.0), new KeyValue(expensiveNode.scaleYProperty(), 2.0), new KeyValue(expensiveNode.rotateProperty(), 360), new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY) ) ).play();cacheHintis only a hint to the system. Depending on the details of the node or the transform, this hint may be ignored.If
Node.cacheis false, cacheHint is ignored. Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants. - Default value:
- CacheHint.DEFAULT
- Parameters:
-
value- the value for thecacheHintproperty - See Also:
getCacheHint
public final CacheHint getCacheHint()
cacheHint property.- Property description:
- Additional hint for controlling bitmap caching.
Under certain circumstances, such as animating nodes that are very expensive to render, it is desirable to be able to perform transformations on the node without having to regenerate the cached bitmap. An option in such cases is to perform the transforms on the cached bitmap itself.
This technique can provide a dramatic improvement to animation performance, though may also result in a reduction in visual quality. The
cacheHintvariable provides a hint to the system about how and when that trade-off (visual quality for animation performance) is acceptable.It is possible to enable the cacheHint only at times when your node is animating. In this way, expensive nodes can appear on screen with full visual quality, yet still animate smoothly.
Example:
Note thatexpensiveNode.setCache(true); expensiveNode.setCacheHint(CacheHint.QUALITY); ... // Do an animation expensiveNode.setCacheHint(CacheHint.SPEED); new Timeline( new KeyFrame(Duration.seconds(2), new KeyValue(expensiveNode.scaleXProperty(), 2.0), new KeyValue(expensiveNode.scaleYProperty(), 2.0), new KeyValue(expensiveNode.rotateProperty(), 360), new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY) ) ).play();cacheHintis only a hint to the system. Depending on the details of the node or the transform, this hint may be ignored.If
Node.cacheis false, cacheHint is ignored. Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants. - Default value:
- CacheHint.DEFAULT
- Returns:
- the value of the
cacheHintproperty - See Also:
cacheHintProperty
public final ObjectProperty<CacheHint> cacheHintProperty()
Under certain circumstances, such as animating nodes that are very expensive to render, it is desirable to be able to perform transformations on the node without having to regenerate the cached bitmap. An option in such cases is to perform the transforms on the cached bitmap itself.
This technique can provide a dramatic improvement to animation performance, though may also result in a reduction in visual quality. The cacheHint variable provides a hint to the system about how and when that trade-off (visual quality for animation performance) is acceptable.
It is possible to enable the cacheHint only at times when your node is animating. In this way, expensive nodes can appear on screen with full visual quality, yet still animate smoothly.
Example:
expensiveNode.setCache(true);
expensiveNode.setCacheHint(CacheHint.QUALITY);
...
// Do an animation
expensiveNode.setCacheHint(CacheHint.SPEED);
new Timeline(
new KeyFrame(Duration.seconds(2),
new KeyValue(expensiveNode.scaleXProperty(), 2.0),
new KeyValue(expensiveNode.scaleYProperty(), 2.0),
new KeyValue(expensiveNode.rotateProperty(), 360),
new KeyValue(expensiveNode.cacheHintProperty(), CacheHint.QUALITY)
)
).play();
Note that cacheHint is only a hint to the system. Depending on the details of the node or the transform, this hint may be ignored. If Node.cache is false, cacheHint is ignored. Caching may be disabled for any node that has a 3D transform on itself, any of its ancestors, or any of its descendants.
- Default value:
- CacheHint.DEFAULT
- Returns:
- the
CacheHintfor thisNode - See Also:
setEffect
public final void setEffect(Effect value)
effect property.- Property description:
- Specifies an effect to apply to this
Node.Note that this is a conditional feature. See
ConditionalFeature.EFFECTfor more information.There is a known limitation of mixing Effect with a 3D Transform. Effect is essentially a 2D image operation. The result of an Effect set on a
Groupnode with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children. - Default value:
- null
- Parameters:
-
value- the value for theeffectproperty - See Also:
getEffect
public final Effect getEffect()
effect property.- Property description:
- Specifies an effect to apply to this
Node.Note that this is a conditional feature. See
ConditionalFeature.EFFECTfor more information.There is a known limitation of mixing Effect with a 3D Transform. Effect is essentially a 2D image operation. The result of an Effect set on a
Groupnode with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children. - Default value:
- null
- Returns:
- the value of the
effectproperty - See Also:
effectProperty
public final ObjectProperty<Effect> effectProperty()
Node. Note that this is a conditional feature. See ConditionalFeature.EFFECT for more information.
There is a known limitation of mixing Effect with a 3D Transform. Effect is essentially a 2D image operation. The result of an Effect set on a Group node with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children.
- Default value:
- null
- Returns:
- the effect for this
Node - See Also:
setDepthTest
public final void setDepthTest(DepthTest value)
depthTest property.- Property description:
- Indicates whether depth testing is used when rendering this node. If the depthTest flag is
DepthTest.DISABLE, then depth testing is disabled for this node. If the depthTest flag isDepthTest.ENABLE, then depth testing is enabled for this node. If the depthTest flag isDepthTest.INHERIT, then depth testing is enabled for this node if it is enabled for the parent node or the parent node is null.The depthTest flag is only used when the depthBuffer flag for the
Sceneis true (meaning that theScenehas an associated depth buffer)Depth test comparison is only done among nodes with depthTest enabled. A node with depthTest disabled does not read, test, or write the depth buffer, that is to say its Z value will not be considered for depth testing with other nodes.
Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information.See the constructor in Scene with depthBuffer as one of its input arguments.
- Default value:
- INHERIT
- Parameters:
-
value- the value for thedepthTestproperty - See Also:
getDepthTest
public final DepthTest getDepthTest()
depthTest property.- Property description:
- Indicates whether depth testing is used when rendering this node. If the depthTest flag is
DepthTest.DISABLE, then depth testing is disabled for this node. If the depthTest flag isDepthTest.ENABLE, then depth testing is enabled for this node. If the depthTest flag isDepthTest.INHERIT, then depth testing is enabled for this node if it is enabled for the parent node or the parent node is null.The depthTest flag is only used when the depthBuffer flag for the
Sceneis true (meaning that theScenehas an associated depth buffer)Depth test comparison is only done among nodes with depthTest enabled. A node with depthTest disabled does not read, test, or write the depth buffer, that is to say its Z value will not be considered for depth testing with other nodes.
Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information.See the constructor in Scene with depthBuffer as one of its input arguments.
- Default value:
- INHERIT
- Returns:
- the value of the
depthTestproperty - See Also:
depthTestProperty
public final ObjectProperty<DepthTest> depthTestProperty()
DepthTest.DISABLE, then depth testing is disabled for this node. If the depthTest flag is DepthTest.ENABLE, then depth testing is enabled for this node. If the depthTest flag is DepthTest.INHERIT, then depth testing is enabled for this node if it is enabled for the parent node or the parent node is null. The depthTest flag is only used when the depthBuffer flag for the Scene is true (meaning that the Scene has an associated depth buffer)
Depth test comparison is only done among nodes with depthTest enabled. A node with depthTest disabled does not read, test, or write the depth buffer, that is to say its Z value will not be considered for depth testing with other nodes.
Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
See the constructor in Scene with depthBuffer as one of its input arguments.
- Default value:
- INHERIT
- Returns:
- the depth test setting for this
Node - See Also:
setDisable
public final void setDisable(boolean value)
disable property.- Property description:
- Defines the individual disabled state of this
Node. Settingdisableto true will cause thisNodeand any subnodes to become disabled. This property should be used only to set the disabled state of aNode. For querying the disabled state of aNode, thedisabledproperty should instead be used, since it is possible that aNodewas disabled as a result of an ancestor being disabled even if the individualdisablestate on thisNodeisfalse. - Default value:
- false
- Parameters:
-
value- the value for thedisableproperty - See Also:
isDisable
public final boolean isDisable()
disable property.- Property description:
- Defines the individual disabled state of this
Node. Settingdisableto true will cause thisNodeand any subnodes to become disabled. This property should be used only to set the disabled state of aNode. For querying the disabled state of aNode, thedisabledproperty should instead be used, since it is possible that aNodewas disabled as a result of an ancestor being disabled even if the individualdisablestate on thisNodeisfalse. - Default value:
- false
- Returns:
- the value of the
disableproperty - See Also:
disableProperty
public final BooleanProperty disableProperty()
Node. Setting disable to true will cause this Node and any subnodes to become disabled. This property should be used only to set the disabled state of a Node. For querying the disabled state of a Node, the disabled property should instead be used, since it is possible that a Node was disabled as a result of an ancestor being disabled even if the individual disable state on this Node is false.- Default value:
- false
- Returns:
- the disabled state for this
Node - See Also:
setPickOnBounds
public final void setPickOnBounds(boolean value)
pickOnBounds property.- Property description:
- Defines how the picking computation is done for this node when triggered by a
MouseEventor acontainsfunction call. IfpickOnBoundsistrue, then picking is computed by intersecting with the bounds of this node, else picking is computed by intersecting with the geometric shape of this node. The default value of this property isfalseunless overridden by a subclass. The default value istrueforRegion. - Default value:
- false; true for
Region - Parameters:
-
value- the value for thepickOnBoundsproperty - See Also:
isPickOnBounds
public final boolean isPickOnBounds()
pickOnBounds property.- Property description:
- Defines how the picking computation is done for this node when triggered by a
MouseEventor acontainsfunction call. IfpickOnBoundsistrue, then picking is computed by intersecting with the bounds of this node, else picking is computed by intersecting with the geometric shape of this node. The default value of this property isfalseunless overridden by a subclass. The default value istrueforRegion. - Default value:
- false; true for
Region - Returns:
- the value of the
pickOnBoundsproperty - See Also:
pickOnBoundsProperty
public final BooleanProperty pickOnBoundsProperty()
MouseEvent or a contains function call. If pickOnBounds is true, then picking is computed by intersecting with the bounds of this node, else picking is computed by intersecting with the geometric shape of this node. The default value of this property is false unless overridden by a subclass. The default value is true for Region.- Default value:
- false; true for
Region - Returns:
- the
pickOnBoundsproperty - See Also:
setDisabled
protected final void setDisabled(boolean value)
disabled property.- Property description:
- Indicates whether or not this
Nodeis disabled. ANodewill become disabled ifdisableis set totrueon either itself or one of its ancestors in the scene graph.A disabled
Nodeshould render itself differently to indicate its disabled state to the user. Such disabled rendering is dependent on the implementation of theNode. The shape classes contained injavafx.scene.shapedo not implement such rendering by default, therefore applications using shapes for handling input must implement appropriate disabled rendering themselves. The user-interface controls defined injavafx.scene.controlwill implement disabled-sensitive rendering, however.A disabled
Nodedoes not receive mouse or key events. - Default value:
- false
- Parameters:
-
value- the value for thedisabledproperty - See Also:
isDisabled
public final boolean isDisabled()
disabled property.- Property description:
- Indicates whether or not this
Nodeis disabled. ANodewill become disabled ifdisableis set totrueon either itself or one of its ancestors in the scene graph.A disabled
Nodeshould render itself differently to indicate its disabled state to the user. Such disabled rendering is dependent on the implementation of theNode. The shape classes contained injavafx.scene.shapedo not implement such rendering by default, therefore applications using shapes for handling input must implement appropriate disabled rendering themselves. The user-interface controls defined injavafx.scene.controlwill implement disabled-sensitive rendering, however.A disabled
Nodedoes not receive mouse or key events. - Default value:
- false
- Returns:
- the value of the
disabledproperty - See Also:
disabledProperty
public final ReadOnlyBooleanProperty disabledProperty()
Node is disabled. A Node will become disabled if disable is set to true on either itself or one of its ancestors in the scene graph. A disabled Node should render itself differently to indicate its disabled state to the user. Such disabled rendering is dependent on the implementation of the Node. The shape classes contained in javafx.scene.shape do not implement such rendering by default, therefore applications using shapes for handling input must implement appropriate disabled rendering themselves. The user-interface controls defined in javafx.scene.control will implement disabled-sensitive rendering, however.
A disabled Node does not receive mouse or key events.
- Default value:
- false
- Returns:
- the
disabledproperty - See Also:
lookup
public Node lookup(String selector)
Node, or the first sub-node, based on the given CSS selector. If this node is a Parent, then this function will traverse down into the branch until it finds a match. If more than one sub-node matches the specified selector, this function returns the first of them. If the lookup selector does not specify a pseudo class, the lookup will ignore pseudo class states; it will return the first matching node whether or not it contains pseudo classes.
For example, if a Node is given the id of "myId", then the lookup method can be used to find this node as follows: scene.lookup("#myId");.
For example, if two nodes, NodeA and NodeB, have the same style class "myStyle" and NodeA has a pseudo state "myPseudo", then to find NodeA, the lookup method can be used as follows: scene.lookup(".myStyle:myPseudo"); or scene.lookup(":myPseudo");.
- Parameters:
-
selector- The css selector of the node to find - Returns:
- The first node, starting from this
Node, which matches the CSSselector, null if none is found.
lookupAll
public Set<Node> lookupAll(String selector)
Nodes, including this one and any children, which match the given CSS selector. If no matches are found, an empty unmodifiable set is returned. The set is explicitly unordered. If the lookupAll selector does not specify a pseudo class, the lookupAll will ignore pseudo class states; it will return all matching nodes whether or not the nodes contain pseudo classes.
For example, if there are multiple nodes with same style class "myStyle", then the lookupAll method can be used to find all these nodes as follows: scene.lookupAll(".myStyle");.
For example, if multiple nodes have same style class "myStyle" and few nodes have a pseudo state "myPseudo", then to find all nodes with "myPseudo" state, the lookupAll method can be used as follows: scene.lookupAll(".myStyle:myPseudo"); or scene.lookupAll(":myPseudo");.
- Parameters:
-
selector- The css selector of the nodes to find - Returns:
- All nodes, starting from and including this
Node, which match the CSSselector. The returned set is always unordered and unmodifiable, and never null.
toBack
public void toBack()
Node to the back of its sibling nodes in terms of z-order. This is accomplished by moving this Node to the first position in its parent's content ObservableList. This function has no effect if this Node is not part of a group.toFront
public void toFront()
Node to the front of its sibling nodes in terms of z-order. This is accomplished by moving this Node to the last position in its parent's content ObservableList. This function has no effect if this Node is not part of a group.snapshot
public WritableImage snapshot(SnapshotParameters params, WritableImage image)
Paint specified by the SnapshotParameters. This node is then rendered to the image. If the viewport specified by the SnapshotParameters is null, the upper-left pixel of the boundsInParent of this node, after first applying the transform specified by the SnapshotParameters, is mapped to the upper-left pixel (0,0) in the image. If a non-null viewport is specified, the upper-left pixel of the viewport is mapped to upper-left pixel (0,0) in the image. In both cases, this mapping to (0,0) of the image is done with an integer translation. The portion of the node that is outside of the rendered image 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.
NOTE: In order for CSS and layout to function correctly, the node must be part of a Scene (the Scene may be attached to a Stage, but need not be).
- Parameters:
-
params- the snapshot parameters containing attributes that will control the rendering. If the SnapshotParameters object is null, then the Scene's attributes will be used if this node is part of a scene, or default attributes will be used if this node is not part of a scene. -
image- the writable image that will be used to hold the rendered node. It may be null in which case a new WritableImage will be constructed. The new image is constructed using integer width and height values that are derived either from the transformed bounds of this Node or from the size of the viewport as specified in the SnapShotParameters. These integer values are chosen such that the image will wholly contain the bounds of this Node or the specified viewport. If the image is non-null, the node 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 bounds or viewport. - 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, SnapshotParameters params, WritableImage image)
Paint specified by the SnapshotParameters. This node is then rendered to the image. If the viewport specified by the SnapshotParameters is null, the upper-left pixel of the boundsInParent of this node, after first applying the transform specified by the SnapshotParameters, is mapped to the upper-left pixel (0,0) in the image. If a non-null viewport is specified, the upper-left pixel of the viewport is mapped to upper-left pixel (0,0) in the image. In both cases, this mapping to (0,0) of the image is done with an integer translation. The portion of the node that is outside of the rendered image will be clipped by the image. This is an asynchronous call, which means that other events or animation might be processed before the node is rendered. If any such events modify the node, or any of its children, that modification will be reflected in the rendered image (just like it will also be reflected in the frame rendered to the Stage, if this node is part of a live scene graph).
When taking a snapshot of a node 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.
NOTE: In order for CSS and layout to function correctly, the node must be part of a Scene (the Scene may be attached to a Stage, but need not be).
- 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, the source node that was rendered, and a copy of the SnapshotParameters. The callback parameter must not be null. -
params- the snapshot parameters containing attributes that will control the rendering. If the SnapshotParameters object is null, then the Scene's attributes will be used if this node is part of a scene, or default attributes will be used if this node is not part of a scene. -
image- the writable image that will be used to hold the rendered node. It may be null in which case a new WritableImage will be constructed. The new image is constructed using integer width and height values that are derived either from the transformed bounds of this Node or from the size of the viewport as specified in the SnapShotParameters. These integer values are chosen such that the image will wholly contain the bounds of this Node or the specified viewport. If the image is non-null, the node 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 bounds or viewport. - 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
setOnDragEntered
public final void setOnDragEntered(EventHandler<? super DragEvent> value)
onDragEntered property.- Property description:
- Defines a function to be called when drag gesture enters this
Node. - Parameters:
-
value- the value for theonDragEnteredproperty - See Also:
getOnDragEntered
public final EventHandler<? super DragEvent> getOnDragEntered()
onDragEntered property.- Property description:
- Defines a function to be called when drag gesture enters this
Node. - Returns:
- the value of the
onDragEnteredproperty - See Also:
onDragEnteredProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragEnteredProperty()
Node.- Returns:
- the event handler that is called when drag gesture enters this
Node - See Also:
setOnDragExited
public final void setOnDragExited(EventHandler<? super DragEvent> value)
onDragExited property.- Property description:
- Defines a function to be called when drag gesture exits this
Node. - Parameters:
-
value- the value for theonDragExitedproperty - See Also:
getOnDragExited
public final EventHandler<? super DragEvent> getOnDragExited()
onDragExited property.- Property description:
- Defines a function to be called when drag gesture exits this
Node. - Returns:
- the value of the
onDragExitedproperty - See Also:
onDragExitedProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragExitedProperty()
Node.- Returns:
- the event handler that is called when drag gesture exits this
Node - See Also:
setOnDragOver
public final void setOnDragOver(EventHandler<? super DragEvent> value)
onDragOver property.- Property description:
- Defines a function to be called when drag gesture progresses within this
Node. - Parameters:
-
value- the value for theonDragOverproperty - See Also:
getOnDragOver
public final EventHandler<? super DragEvent> getOnDragOver()
onDragOver property.- Property description:
- Defines a function to be called when drag gesture progresses within this
Node. - Returns:
- the value of the
onDragOverproperty - See Also:
onDragOverProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragOverProperty()
Node.- Returns:
- the event handler that is called when drag gesture progresses within this
Node - See Also:
setOnDragDropped
public final void setOnDragDropped(EventHandler<? super DragEvent> value)
onDragDropped property.getOnDragDropped
public final EventHandler<? super DragEvent> getOnDragDropped()
onDragDropped property.onDragDroppedProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragDroppedProperty()
Node during drag and drop gesture. Transfer of data from the DragEvent's dragboard should happen in this function.- Returns:
- the event handler that is called when the mouse button is released on this
Node - See Also:
setOnDragDone
public final void setOnDragDone(EventHandler<? super DragEvent> value)
onDragDone property.- Property description:
- Defines a function to be called when this
Nodeis a drag and drop gesture source after its data has been dropped on a drop target. ThetransferModeof the event shows what just happened at the drop target. IftransferModehas the valueMOVE, 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. AtransferModethat has the valueNONEindicates that no data was transferred during the drag and drop gesture. - Parameters:
-
value- the value for theonDragDoneproperty - See Also:
getOnDragDone
public final EventHandler<? super DragEvent> getOnDragDone()
onDragDone property.- Property description:
- Defines a function to be called when this
Nodeis a drag and drop gesture source after its data has been dropped on a drop target. ThetransferModeof the event shows what just happened at the drop target. IftransferModehas the valueMOVE, 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. AtransferModethat has the valueNONEindicates that no data was transferred during the drag and drop gesture. - Returns:
- the value of the
onDragDoneproperty - See Also:
onDragDoneProperty
public final ObjectProperty<EventHandler<? super DragEvent>> onDragDoneProperty()
Node 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.- Returns:
- the event handler that is called when this
Nodeis a drag and drop gesture source after its data has been dropped on a drop target - See Also:
startDragAndDrop
public Dragboard startDragAndDrop(TransferMode... transferModes)
Node. 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 Node's data on the Dragboard also identifies this Node 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 supportedTransferMode(s) of thisNode - Returns:
- A
Dragboardto place thisNode's data on - Throws:
-
IllegalStateException- if drag and drop cannot be started at this moment (it's called outside ofDRAG_DETECTEDevent handling or this node is not in scene). - See Also:
startFullDrag
public void startFullDrag()
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 ofDRAG_DETECTEDevent handling or this node is not in scene). - Since:
- JavaFX 2.1
- See Also:
setManaged
public final void setManaged(boolean value)
managed property.- Property description:
- Defines whether or not this node's layout will be managed by its parent. If the node is managed, its parent will factor the node's geometry into its own preferred size and
layoutBoundscalculations and will lay it out during the scene's layout pass. If a managed node's layoutBounds changes, it will automatically trigger relayout up the scene-graph to the nearest layout root (which is typically the scene's root node).If the node is unmanaged, its parent will ignore the child in both preferred size computations and layout. Changes in layoutBounds will not trigger relayout above it. If an unmanaged node is of type
Parent, it will act as a "layout root", meaning that calls toParent.requestLayout()beneath it will cause only the branch rooted by the node to be relayed out, thereby isolating layout changes to that root and below. It's the application's responsibility to set the size and position of an unmanaged node.By default all nodes are managed.
- Parameters:
-
value- the value for themanagedproperty - See Also:
isManaged
public final boolean isManaged()
managed property.- Property description:
- Defines whether or not this node's layout will be managed by its parent. If the node is managed, its parent will factor the node's geometry into its own preferred size and
layoutBoundscalculations and will lay it out during the scene's layout pass. If a managed node's layoutBounds changes, it will automatically trigger relayout up the scene-graph to the nearest layout root (which is typically the scene's root node).If the node is unmanaged, its parent will ignore the child in both preferred size computations and layout. Changes in layoutBounds will not trigger relayout above it. If an unmanaged node is of type
Parent, it will act as a "layout root", meaning that calls toParent.requestLayout()beneath it will cause only the branch rooted by the node to be relayed out, thereby isolating layout changes to that root and below. It's the application's responsibility to set the size and position of an unmanaged node.By default all nodes are managed.
- Returns:
- the value of the
managedproperty - See Also:
managedProperty
public final BooleanProperty managedProperty()
layoutBounds calculations and will lay it out during the scene's layout pass. If a managed node's layoutBounds changes, it will automatically trigger relayout up the scene-graph to the nearest layout root (which is typically the scene's root node). If the node is unmanaged, its parent will ignore the child in both preferred size computations and layout. Changes in layoutBounds will not trigger relayout above it. If an unmanaged node is of type Parent, it will act as a "layout root", meaning that calls to Parent.requestLayout() beneath it will cause only the branch rooted by the node to be relayed out, thereby isolating layout changes to that root and below. It's the application's responsibility to set the size and position of an unmanaged node.
By default all nodes are managed.
- Returns:
- the
managedproperty - See Also:
setLayoutX
public final void setLayoutX(double value)
layoutX property.- Property description:
- Defines the x coordinate of the translation that is added to this
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its currentlayoutBounds minXposition (which might not be 0) to the desired location.For example, if
textnodeshould be positioned atfinalXtextnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());Failure to subtract
layoutBounds minXmay result in misplacement of the node. Therelocate(x, y)method will automatically do the correct computation and should generally be used over setting layoutX directly.The node's final translation will be computed as
layoutX+translateX, wherelayoutXestablishes the node's stable position andtranslateXoptionally makes dynamic adjustments to that position.If the node is managed and has a
Regionas its parent, then the layout region will setlayoutXaccording to its own layout policy. If the node is unmanaged or parented by aGroup, then the application may setlayoutXdirectly to position it. - Parameters:
-
value- the value for thelayoutXproperty - See Also:
getLayoutX
public final double getLayoutX()
layoutX property.- Property description:
- Defines the x coordinate of the translation that is added to this
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its currentlayoutBounds minXposition (which might not be 0) to the desired location.For example, if
textnodeshould be positioned atfinalXtextnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());Failure to subtract
layoutBounds minXmay result in misplacement of the node. Therelocate(x, y)method will automatically do the correct computation and should generally be used over setting layoutX directly.The node's final translation will be computed as
layoutX+translateX, wherelayoutXestablishes the node's stable position andtranslateXoptionally makes dynamic adjustments to that position.If the node is managed and has a
Regionas its parent, then the layout region will setlayoutXaccording to its own layout policy. If the node is unmanaged or parented by aGroup, then the application may setlayoutXdirectly to position it. - Returns:
- the value of the
layoutXproperty - See Also:
layoutXProperty
public final DoubleProperty layoutXProperty()
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its current layoutBounds minX position (which might not be 0) to the desired location. For example, if textnode should be positioned at finalX
textnode.setLayoutX(finalX - textnode.getLayoutBounds().getMinX());
Failure to subtract layoutBounds minX may result in misplacement of the node. The relocate(x, y) method will automatically do the correct computation and should generally be used over setting layoutX directly.
The node's final translation will be computed as layoutX + translateX, where layoutX establishes the node's stable position and translateX optionally makes dynamic adjustments to that position.
If the node is managed and has a Region as its parent, then the layout region will set layoutX according to its own layout policy. If the node is unmanaged or parented by a Group, then the application may set layoutX directly to position it.
- Returns:
- the
layoutXproperty - See Also:
setLayoutY
public final void setLayoutY(double value)
layoutY property.- Property description:
- Defines the y coordinate of the translation that is added to this
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its currentlayoutBounds minYposition (which might not be 0) to the desired location.For example, if
textnodeshould be positioned atfinalYtextnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());Failure to subtract
layoutBounds minYmay result in misplacement of the node. Therelocate(x, y)method will automatically do the correct computation and should generally be used over setting layoutY directly.The node's final translation will be computed as
layoutY+translateY, wherelayoutYestablishes the node's stable position andtranslateYoptionally makes dynamic adjustments to that position.If the node is managed and has a
Regionas its parent, then the region will setlayoutYaccording to its own layout policy. If the node is unmanaged or parented by aGroup, then the application may setlayoutYdirectly to position it. - Parameters:
-
value- the value for thelayoutYproperty - See Also:
getLayoutY
public final double getLayoutY()
layoutY property.- Property description:
- Defines the y coordinate of the translation that is added to this
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its currentlayoutBounds minYposition (which might not be 0) to the desired location.For example, if
textnodeshould be positioned atfinalYtextnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());Failure to subtract
layoutBounds minYmay result in misplacement of the node. Therelocate(x, y)method will automatically do the correct computation and should generally be used over setting layoutY directly.The node's final translation will be computed as
layoutY+translateY, wherelayoutYestablishes the node's stable position andtranslateYoptionally makes dynamic adjustments to that position.If the node is managed and has a
Regionas its parent, then the region will setlayoutYaccording to its own layout policy. If the node is unmanaged or parented by aGroup, then the application may setlayoutYdirectly to position it. - Returns:
- the value of the
layoutYproperty - See Also:
layoutYProperty
public final DoubleProperty layoutYProperty()
Node's transform for the purpose of layout. The value should be computed as the offset required to adjust the position of the node from its current layoutBounds minY position (which might not be 0) to the desired location. For example, if textnode should be positioned at finalY
textnode.setLayoutY(finalY - textnode.getLayoutBounds().getMinY());
Failure to subtract layoutBounds minY may result in misplacement of the node. The relocate(x, y) method will automatically do the correct computation and should generally be used over setting layoutY directly.
The node's final translation will be computed as layoutY + translateY, where layoutY establishes the node's stable position and translateY optionally makes dynamic adjustments to that position.
If the node is managed and has a Region as its parent, then the region will set layoutY according to its own layout policy. If the node is unmanaged or parented by a Group, then the application may set layoutY directly to position it.
- Returns:
- the
layoutYproperty - See Also:
relocate
public void relocate(double x, double y)
This method does not alter translateX or translateY, which if also set will be added to layoutX and layoutY, adjusting the final location by corresponding amounts.
- Parameters:
-
x- the target x coordinate location -
y- the target y coordinate location
isResizable
public boolean isResizable()
If this method returns false, then the parent cannot resize it during layout (resize() is a no-op) and it should return its layoutBounds for minimum, preferred, and maximum sizes. Group, Text, and all Shapes are not resizable and hence depend on the application to establish their sizing by setting appropriate properties (e.g. width/height for Rectangle, text on Text, and so on). Non-resizable nodes may still be relocated during layout.
- Returns:
- whether or not this node type can be resized by its parent during layout
- See Also:
getContentBias
public Orientation getContentBias()
Resizable subclasses should override this method to return an appropriate value.
- Returns:
- orientation of width/height dependency or null if there is none
- See Also:
minWidth
public double minWidth(double height)
Layout code which calls this method should first check the content-bias of the node. If the node has a vertical content-bias, then callers should pass in a height value that the minimum width should be based on. If the node has either a horizontal or null content-bias, then the caller should pass in -1.
Node subclasses with a vertical content-bias should honor the height parameter whether -1 or a positive value. All other subclasses may ignore the height parameter (which will likely be -1).
If Node's maxWidth(double) is lower than this number, minWidth takes precedence. This means the Node should never be resized below minWidth.
- Parameters:
-
height- the height that should be used if minimum width depends on it - Returns:
- the minimum width that the node should be resized to during layout. The result will never be NaN, nor will it ever be negative.
- See Also:
minHeight
public double minHeight(double width)
Layout code which calls this method should first check the content-bias of the node. If the node has a horizontal content-bias, then callers should pass in a width value that the minimum height should be based on. If the node has either a vertical or null content-bias, then the caller should pass in -1.
Node subclasses with a horizontal content-bias should honor the width parameter whether -1 or a positive value. All other subclasses may ignore the width parameter (which will likely be -1).
If Node's maxHeight(double) is lower than this number, minHeight takes precedence. This means the Node should never be resized below minHeight.
- Parameters:
-
width- the width that should be used if minimum height depends on it - Returns:
- the minimum height that the node should be resized to during layout The result will never be NaN, nor will it ever be negative.
- See Also:
prefWidth
public double prefWidth(double height)
Layout code which calls this method should first check the content-bias of the node. If the node has a vertical content-bias, then callers should pass in a height value that the preferred width should be based on. If the node has either a horizontal or null content-bias, then the caller should pass in -1.
Node subclasses with a vertical content-bias should honor the height parameter whether -1 or a positive value. All other subclasses may ignore the height parameter (which will likely be -1).
- Parameters:
-
height- the height that should be used if preferred width depends on it - Returns:
- the preferred width that the node should be resized to during layout The result will never be NaN, nor will it ever be negative.
- See Also:
prefHeight
public double prefHeight(double width)
Layout code which calls this method should first check the content-bias of the node. If the node has a horizontal content-bias, then callers should pass in a width value that the preferred height should be based on. If the node has either a vertical or null content-bias, then the caller should pass in -1.
Node subclasses with a horizontal content-bias should honor the height parameter whether -1 or a positive value. All other subclasses may ignore the height parameter (which will likely be -1).
- Parameters:
-
width- the width that should be used if preferred height depends on it - Returns:
- the preferred height that the node should be resized to during layout The result will never be NaN, nor will it ever be negative.
- See Also:
maxWidth
public double maxWidth(double height)
If the node is not resizable, returns its layoutBounds width.
Layout code which calls this method should first check the content-bias of the node. If the node has a vertical content-bias, then callers should pass in a height value that the maximum width should be based on. If the node has either a horizontal or null content-bias, then the caller should pass in -1.
Node subclasses with a vertical content-bias should honor the height parameter whether -1 or a positive value. All other subclasses may ignore the height parameter (which will likely be -1).
If Node's minWidth(double) is greater, it should take precedence over the maxWidth. This means the Node should never be resized below minWidth.
- Parameters:
-
height- the height that should be used if maximum width depends on it - Returns:
- the maximum width that the node should be resized to during layout The result will never be NaN, nor will it ever be negative.
- See Also:
maxHeight
public double maxHeight(double width)
If the node is not resizable, returns its layoutBounds height.
Layout code which calls this method should first check the content-bias of the node. If the node has a horizontal content-bias, then callers should pass in a width value that the maximum height should be based on. If the node has either a vertical or null content-bias, then the caller should pass in -1.
Node subclasses with a horizontal content-bias should honor the width parameter whether -1 or a positive value. All other subclasses may ignore the width parameter (which will likely be -1).
If Node's minHeight(double) is greater, it should take precedence over the maxHeight. This means the Node should never be resized below minHeight.
- Parameters:
-
width- the width that should be used if maximum height depends on it - Returns:
- the maximum height that the node should be resized to during layout The result will never be NaN, nor will it ever be negative.
- See Also:
resize
public void resize(double width, double height)
This method should generally only be called by parent nodes from their layoutChildren() methods. All Parent classes will automatically resize resizable children, so resizing done directly by the application will be overridden by the node's parent, unless the child is unmanaged.
Parents are responsible for ensuring the width and height values fall within the resizable node's preferred range. The autosize() method may be used if the parent just needs to resize the node to its preferred size.
- Parameters:
-
width- the target layout bounds width -
height- the target layout bounds height - See Also:
autosize
public final void autosize()
This method automatically queries the node's content-bias and if it's horizontal, will pass in the node's preferred width to get the preferred height; if vertical, will pass in the node's preferred height to get the width, and if null, will compute the preferred width/height independently.
- See Also:
resizeRelocate
public void resizeRelocate(double x, double y, double width, double height)
Once the node has been resized (if resizable) then sets the node's layoutX and layoutY translation properties in order to relocate it to x,y in the parent's coordinate space.
This method should generally only be called by parent nodes from their layoutChildren() methods. All Parent classes will automatically resize resizable children, so resizing done directly by the application will be overridden by the node's parent, unless the child is unmanaged.
Parents are responsible for ensuring the width and height values fall within the resizable node's preferred range. The autosize() and relocate() methods may be used if the parent just needs to resize the node to its preferred size and reposition it.
- Parameters:
-
x- the target x coordinate location -
y- the target y coordinate location -
width- the target layout bounds width -
height- the target layout bounds height - See Also:
getBaselineOffset
public double getBaselineOffset()
BASELINE_OFFSET_SAME_AS_HEIGHT for resizable Nodes and layoutBounds height for non-resizable. Subclasses which contain text should override this method to return their actual text baseline offset.- Returns:
- offset of text baseline from layoutBounds.minY for non-resizable Nodes or
BASELINE_OFFSET_SAME_AS_HEIGHTotherwise
computeAreaInScreen
public double computeAreaInScreen()
Node projected onto the physical screen in pixel units.- Returns:
- the area of this
Nodeprojected onto the physical screen - Since:
- JavaFX 8.0
getBoundsInParent
public final Bounds getBoundsInParent()
boundsInParent property.- Property description:
- The rectangular bounds of this
Nodein the parent coordinate system.boundsInParentis calculated by taking the local bounds and applying the node transforms as specified in the Transformations section of the class doc.The resulting bounds will be conceptually in the coordinate space of the
Node's parent, however, the node need not have a parent to calculate these bounds.Note that this method does not take the node's visibility into account; the computation is based on the geometry of this
Nodeonly.This property will always have a non-null value.
Note that
boundsInParentis automatically recomputed whenever the geometry of a node changes, or when any of the following the change: transformsObservableList, any of the translate, layout or scale variables, or the rotate variable. For this reason, it is an error to bind any of these values in a node to an expression that depends upon this variable. For example, the x or y variables of a shape, ortranslateX,translateYshould never be bound toboundsInParentfor the purpose of positioning the node.See also the Bounding Rectangles section.
- Returns:
- the value of the
boundsInParentproperty - See Also:
boundsInParentProperty
public final ReadOnlyObjectProperty<Bounds> boundsInParentProperty()
Node in the parent coordinate system. boundsInParent is calculated by taking the local bounds and applying the node transforms as specified in the Transformations section of the class doc. The resulting bounds will be conceptually in the coordinate space of the Node's parent, however, the node need not have a parent to calculate these bounds.
Note that this method does not take the node's visibility into account; the computation is based on the geometry of this Node only.
This property will always have a non-null value.
Note that boundsInParent is automatically recomputed whenever the geometry of a node changes, or when any of the following the change: transforms ObservableList, any of the translate, layout or scale variables, or the rotate variable. For this reason, it is an error to bind any of these values in a node to an expression that depends upon this variable. For example, the x or y variables of a shape, or translateX, translateY should never be bound to boundsInParent for the purpose of positioning the node.
See also the Bounding Rectangles section.
- Returns:
- the
boundsInParentproperty for thisNode - See Also:
getBoundsInLocal
public final Bounds getBoundsInLocal()
boundsInLocal property.- Property description:
- The rectangular bounds of this
Nodein the node's untransformed local coordinate space. For nodes that extendShape, the local bounds will also include space required for a non-zero stroke that may fall outside the shape's geometry that is defined by position and size attributes. The local bounds will also include any clipping set withclipas well as effects set witheffect.Note that this method does not take the node's visibility into account; the computation is based on the geometry of this
Nodeonly.This property will always have a non-null value.
Note that boundsInLocal is automatically recomputed whenever the geometry of a node changes. For this reason, it is an error to bind any of these values in a node to an expression that depends upon this variable. For example, the x or y variables of a shape should never be bound to boundsInLocal for the purpose of positioning the node.
- Returns:
- the value of the
boundsInLocalproperty - See Also:
boundsInLocalProperty
public final ReadOnlyObjectProperty<Bounds> boundsInLocalProperty()
Node in the node's untransformed local coordinate space. For nodes that extend Shape, the local bounds will also include space required for a non-zero stroke that may fall outside the shape's geometry that is defined by position and size attributes. The local bounds will also include any clipping set with clip as well as effects set with effect. Note that this method does not take the node's visibility into account; the computation is based on the geometry of this Node only.
This property will always have a non-null value.
Note that boundsInLocal is automatically recomputed whenever the geometry of a node changes. For this reason, it is an error to bind any of these values in a node to an expression that depends upon this variable. For example, the x or y variables of a shape should never be bound to boundsInLocal for the purpose of positioning the node.
- Returns:
- the boundsInLocal for this
Node - See Also:
getLayoutBounds
public final Bounds getLayoutBounds()
layoutBounds property.- Property description:
- The rectangular bounds that should be used for layout calculations for this node.
layoutBoundsmay differ from the visual bounds of the node and is computed differently depending on the node type.If the node type is resizable (
Region,Control, orWebView) then the layoutBounds will always be0,0 width x height. If the node type is not resizable (Shape,Text, orGroup), then thelayoutBoundsare computed based on the node's geometric properties and does not include the node's clip, effect, or transforms. See individual class documentation for details.Note that the
layoutX,layoutY,translateX, andtranslateYvariables are not included in the layoutBounds. This is important because layout code must first determine the current size and location of the node (usinglayoutBounds) and then setlayoutXandlayoutYto adjust the translation of the node so that it will have the desired layout position.Because the computation of layoutBounds is often tied to a node's geometric variables, it is an error to bind any such variables to an expression that depends upon
layoutBounds. For example, the x or y variables of a shape should never be bound tolayoutBoundsfor the purpose of positioning the node.Note that for 3D shapes, the layout bounds is actually a rectangular box with X, Y, and Z values, although only X and Y are used in layout calculations.
The
layoutBoundswill never be null. - Returns:
- the value of the
layoutBoundsproperty - See Also:
layoutBoundsProperty
public final ReadOnlyObjectProperty<Bounds> layoutBoundsProperty()
layoutBounds may differ from the visual bounds of the node and is computed differently depending on the node type. If the node type is resizable (Region, Control, or WebView) then the layoutBounds will always be 0,0 width x height. If the node type is not resizable (Shape, Text, or Group), then the layoutBounds are computed based on the node's geometric properties and does not include the node's clip, effect, or transforms. See individual class documentation for details.
Note that the layoutX, layoutY, translateX, and translateY variables are not included in the layoutBounds. This is important because layout code must first determine the current size and location of the node (using layoutBounds) and then set layoutX and layoutY to adjust the translation of the node so that it will have the desired layout position.
Because the computation of layoutBounds is often tied to a node's geometric variables, it is an error to bind any such variables to an expression that depends upon layoutBounds. For example, the x or y variables of a shape should never be bound to layoutBounds for the purpose of positioning the node.
Note that for 3D shapes, the layout bounds is actually a rectangular box with X, Y, and Z values, although only X and Y are used in layout calculations.
The layoutBounds will never be null.
- Returns:
- the
layoutBoundsproperty - See Also:
contains
public boolean contains(double localX, double localY)
true if the given point (specified in the local coordinate space of this Node) is contained within the shape of this Node. Note that this method does not take visibility into account; the test is based on the geometry of this Node only.- Parameters:
-
localX- the x coordinate of the point in Node's space -
localY- the y coordinate of the point in Node's space - Returns:
- the result of contains for this
Node
contains
public boolean contains(Point2D localPoint)
true if the given point (specified in the local coordinate space of this Node) is contained within the shape of this Node. Note that this method does not take visibility into account; the test is based on the geometry of this Node only.- Parameters:
-
localPoint- the 2D point in Node's space - Returns:
- the result of contains for this
Node
intersects
public boolean intersects(double localX, double localY, double localWidth, double localHeight)
true if the given rectangle (specified in the local coordinate space of this Node) intersects the shape of this Node. Note that this method does not take visibility into account; the test is based on the geometry of this Node only. The default behavior of this function is simply to check if the given coordinates intersect with the local bounds.- Parameters:
-
localX- the x coordinate of a rectangle in Node's space -
localY- the y coordinate of a rectangle in Node's space -
localWidth- the width of a rectangle in Node's space -
localHeight- the height of a rectangle in Node's space - Returns:
- the result of intersects for this
Node
intersects
public boolean intersects(Bounds localBounds)
true if the given bounds (specified in the local coordinate space of this Node) intersects the shape of this Node. Note that this method does not take visibility into account; the test is based on the geometry of this Node only. The default behavior of this function is simply to check if the given coordinates intersect with the local bounds.- Parameters:
-
localBounds- the bounds - Returns:
- the result of intersects for this
Node
screenToLocal
public Point2D screenToLocal(double screenX, double screenY)
Screen into the local coordinate space of this Node.- Parameters:
-
screenX- x coordinate of a point on a Screen -
screenY- y coordinate of a point on a Screen - Returns:
- local Node's coordinates of the point or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible. - Since:
- JavaFX 8.0
screenToLocal
public Point2D screenToLocal(Point2D screenPoint)
Screen into the local coordinate space of this Node.- Parameters:
-
screenPoint- a point on a Screen - Returns:
- local Node's coordinates of the point or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible. - Since:
- JavaFX 8.0
screenToLocal
public Bounds screenToLocal(Bounds screenBounds)
Screen into the local coordinate space of this Node. Returns reasonable result only in 2D space.- Parameters:
-
screenBounds- bounds on a Screen - Returns:
- bounds in the local Node'space or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible. - Since:
- JavaFX 8.0
sceneToLocal
public Point2D sceneToLocal(double x, double y, boolean rootScene)
Node. If the Node does not have any SubScene or rootScene is set to true, the arguments are in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling sceneToLocal(double, double).- Parameters:
-
x- the x coordinate -
y- the y coordinate -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- local coordinates of the point
- Since:
- JavaFX 8u40
sceneToLocal
public Point2D sceneToLocal(Point2D point, boolean rootScene)
Node. If the Node does not have any SubScene or rootScene is set to true, the arguments are in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling sceneToLocal(javafx.geometry.Point2D).- Parameters:
-
point- the point -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- local coordinates of the point
- Since:
- JavaFX 8u40
sceneToLocal
public Bounds sceneToLocal(Bounds bounds, boolean rootScene)
Node. If the Node does not have any SubScene or rootScene is set to true, the arguments are in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling sceneToLocal(javafx.geometry.Bounds). Since 3D bounds cannot be converted with rootScene set to true, trying to convert 3D bounds will yield null.
- Parameters:
-
bounds- the bounds -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- local coordinates of the bounds
- Since:
- JavaFX 8u40
sceneToLocal
public Point2D sceneToLocal(double sceneX, double sceneY)
Node. Note that if this node is in a SubScene, the arguments should be in the subscene coordinates, not that of Scene.- Parameters:
-
sceneX- x coordinate of a point on a Scene -
sceneY- y coordinate of a point on a Scene - Returns:
- local Node's coordinates of the point or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible.
sceneToLocal
public Point2D sceneToLocal(Point2D scenePoint)
Node. Note that if this node is in a SubScene, the arguments should be in the subscene coordinates, not that of Scene.- Parameters:
-
scenePoint- a point on a Scene - Returns:
- local Node's coordinates of the point or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible.
sceneToLocal
public Point3D sceneToLocal(Point3D scenePoint)
Node. Note that if this node is in a SubScene, the arguments should be in the subscene coordinates, not that of Scene.- Parameters:
-
scenePoint- a point on a Scene - Returns:
- local Node's coordinates of the point or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible. - Since:
- JavaFX 8.0
sceneToLocal
public Point3D sceneToLocal(double sceneX, double sceneY, double sceneZ)
Node. Note that if this node is in a SubScene, the arguments should be in the subscene coordinates, not that of Scene.- Parameters:
-
sceneX- x coordinate of a point on a Scene -
sceneY- y coordinate of a point on a Scene -
sceneZ- z coordinate of a point on a Scene - Returns:
- local Node's coordinates of the point or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible. - Since:
- JavaFX 8.0
sceneToLocal
public Bounds sceneToLocal(Bounds sceneBounds)
Node. Note that if this node is in a SubScene, the arguments should be in the subscene coordinates, not that of Scene.- Parameters:
-
sceneBounds- bounds on a Scene - Returns:
- bounds in the local Node'space or null if Node is not in a
Window. Null is also returned if the transformation from local to Scene is not invertible.
localToScreen
public Point2D localToScreen(double localX, double localY)
Node into the coordinate space of its Screen.- Parameters:
-
localX- x coordinate of a point in Node's space -
localY- y coordinate of a point in Node's space - Returns:
- screen coordinates of the point or null if Node is not in a
Window - Since:
- JavaFX 8.0
localToScreen
localToScreen
public Point2D localToScreen(double localX, double localY, double localZ)
Node into the coordinate space of its Screen.- Parameters:
-
localX- x coordinate of a point in Node's space -
localY- y coordinate of a point in Node's space -
localZ- z coordinate of a point in Node's space - Returns:
- screen coordinates of the point or null if Node is not in a
Window - Since:
- JavaFX 8.0
localToScreen
localToScreen
localToScene
public Point2D localToScene(double localX, double localY)
Node into the coordinate space of its scene. Note that if this node is in a SubScene, the result is in the subscene coordinates, not that of Scene.- Parameters:
-
localX- x coordinate of a point in Node's space -
localY- y coordinate of a point in Node's space - Returns:
- scene coordinates of the point or null if Node is not in a
Window
localToScene
public Point2D localToScene(Point2D localPoint)
Node into the coordinate space of its scene. Note that if this node is in a SubScene, the result is in the subscene coordinates, not that of Scene.- Parameters:
-
localPoint- a point in Node's space - Returns:
- scene coordinates of the point or null if Node is not in a
Window
localToScene
public Point3D localToScene(Point3D localPoint)
Node into the coordinate space of its scene. Note that if this node is in a SubScene, the result is in the subscene coordinates, not that of Scene.- Parameters:
-
localPoint- a 3D point in Node's space - Returns:
- the transformed 3D point in Scene's space
- Since:
- JavaFX 8.0
- See Also:
localToScene
public Point3D localToScene(double x, double y, double z)
Node into the coordinate space of its scene. Note that if this node is in a SubScene, the result is in the subscene coordinates, not that of Scene.- Parameters:
-
x- the x coordinate of a point in Node's space -
y- the y coordinate of a point in Node's space -
z- the z coordinate of a point in Node's space - Returns:
- the transformed 3D point in Scene's space
- Since:
- JavaFX 8.0
- See Also:
localToScene
public Point3D localToScene(Point3D localPoint, boolean rootScene)
Node into the coordinate space of its scene. If the Node does not have any SubScene or rootScene is set to true, the result point is in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling localToScene(javafx.geometry.Point3D).- Parameters:
-
localPoint- the point in local coordinates -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- transformed point
- Since:
- JavaFX 8u40
- See Also:
localToScene
public Point3D localToScene(double x, double y, double z, boolean rootScene)
Node into the coordinate space of its scene. If the Node does not have any SubScene or rootScene is set to true, the result point is in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling localToScene(double, double, double).- Parameters:
-
x- the x coordinate of the point in local coordinates -
y- the y coordinate of the point in local coordinates -
z- the z coordinate of the point in local coordinates -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- transformed point
- Since:
- JavaFX 8u40
- See Also:
localToScene
public Point2D localToScene(Point2D localPoint, boolean rootScene)
Node into the coordinate space of its scene. If the Node does not have any SubScene or rootScene is set to true, the result point is in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling localToScene(javafx.geometry.Point2D).- Parameters:
-
localPoint- the point in local coordinates -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- transformed point
- Since:
- JavaFX 8u40
- See Also:
localToScene
public Point2D localToScene(double x, double y, boolean rootScene)
Node into the coordinate space of its scene. If the Node does not have any SubScene or rootScene is set to true, the result point is in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling localToScene(double, double).- Parameters:
-
x- the x coordinate of the point in local coordinates -
y- the y coordinate of the point in local coordinates -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- transformed point
- Since:
- JavaFX 8u40
- See Also:
localToScene
public Bounds localToScene(Bounds localBounds, boolean rootScene)
Node into the coordinate space of its scene. If the Node does not have any SubScene or rootScene is set to true, the result bounds are in Scene coordinates of the Node returned by getScene(). Otherwise, the subscene coordinates are used, which is equivalent to calling localToScene(javafx.geometry.Bounds).- Parameters:
-
localBounds- the bounds in local coordinates -
rootScene- whether Scene coordinates should be used even if the Node is in a SubScene - Returns:
- transformed bounds
- Since:
- JavaFX 8u40
- See Also:
localToScene
public Bounds localToScene(Bounds localBounds)
Node into the coordinate space of its scene. Note that if this node is in a SubScene, the result is in the subscene coordinates, not that of Scene.- Parameters:
-
localBounds- bounds in Node's space - Returns:
- the bounds in the scene coordinates or null if Node is not in a
Window - See Also:
parentToLocal
public Point2D parentToLocal(double parentX, double parentY)
Node.- Parameters:
-
parentX- the x coordinate in Parent's space -
parentY- the y coordinate in Parent's space - Returns:
- the transformed 2D point in Node's space
parentToLocal
public Point2D parentToLocal(Point2D parentPoint)
Node.- Parameters:
-
parentPoint- the 2D point in Parent's space - Returns:
- the transformed 2D point in Node's space
parentToLocal
public Point3D parentToLocal(Point3D parentPoint)
Node.- Parameters:
-
parentPoint- parentPoint the 3D point in Parent's space - Returns:
- the transformed 3D point in Node's space
- Since:
- JavaFX 8.0
parentToLocal
public Point3D parentToLocal(double parentX, double parentY, double parentZ)
Node.- Parameters:
-
parentX- the x coordinate in Parent's space -
parentY- the y coordinate in Parent's space -
parentZ- the z coordinate in Parent's space - Returns:
- the transformed 3D point in Node's space
- Since:
- JavaFX 8.0
parentToLocal
public Bounds parentToLocal(Bounds parentBounds)
Node.- Parameters:
-
parentBounds- the bounds in Parent's space - Returns:
- the transformed bounds in Node's space
localToParent
public Point2D localToParent(double localX, double localY)
Node into the coordinate space of its parent.- Parameters:
-
localX- the x coordinate of the point in Node's space -
localY- the y coordinate of the point in Node's space - Returns:
- the transformed 2D point in Parent's space
localToParent
public Point2D localToParent(Point2D localPoint)
Node into the coordinate space of its parent.- Parameters:
-
localPoint- the 2D point in Node's space - Returns:
- the transformed 2D point in Parent's space
localToParent
public Point3D localToParent(Point3D localPoint)
Node into the coordinate space of its parent.- Parameters:
-
localPoint- the 3D point in Node's space - Returns:
- the transformed 3D point in Parent's space
- Since:
- JavaFX 8.0
localToParent
public Point3D localToParent(double x, double y, double z)
Node into the coordinate space of its parent.- Parameters:
-
x- the x coordinate of the point in Node's space -
y- the y coordinate of the point in Node's space -
z- the z coordinate of the point in Node's space - Returns:
- the transformed 3D point in Parent's space
- Since:
- JavaFX 8.0
localToParent
public Bounds localToParent(Bounds localBounds)
Node into the coordinate space of its parent.- Parameters:
-
localBounds- the bounds in Node's space - Returns:
- the transformed bounds in Parent's space
viewOrderProperty
public final DoubleProperty viewOrderProperty()
Node within its parent. This property is used to alter the rendering and picking order of a node within its parent without reordering the parent's children list. For example, this can be used as a more efficient way to implement transparency sorting. To do this, an application can assign the viewOrder value of each node to the computed distance between that node and the viewer.
The parent will traverse its children in decreasing viewOrder order. This means that a child with a lower viewOrder will be in front of a child with a higher viewOrder. If two children have the same viewOrder, the parent will traverse them in the order they appear in the parent's children list.
However, viewOrder does not alter the layout and focus traversal order of this Node within its parent. A parent always traverses its children list in order when doing layout or focus traversal.
- Default value:
- 0.0
- Returns:
- the view order for this
Node - Since:
- 9
- See Also:
setViewOrder
public final void setViewOrder(double value)
viewOrder property.- Property description:
- Defines the rendering and picking order of this
Nodewithin its parent.This property is used to alter the rendering and picking order of a node within its parent without reordering the parent's
childrenlist. For example, this can be used as a more efficient way to implement transparency sorting. To do this, an application can assign the viewOrder value of each node to the computed distance between that node and the viewer.The parent will traverse its
childrenin decreasingviewOrderorder. This means that a child with a lowerviewOrderwill be in front of a child with a higherviewOrder. If two children have the sameviewOrder, the parent will traverse them in the order they appear in the parent'schildrenlist.However,
viewOrderdoes not alter the layout and focus traversal order of this Node within its parent. A parent always traverses itschildrenlist in order when doing layout or focus traversal. - Default value:
- 0.0
- Parameters:
-
value- the value for theviewOrderproperty - Since:
- 9
- See Also:
getViewOrder
public final double getViewOrder()
viewOrder property.- Property description:
- Defines the rendering and picking order of this
Nodewithin its parent.This property is used to alter the rendering and picking order of a node within its parent without reordering the parent's
childrenlist. For example, this can be used as a more efficient way to implement transparency sorting. To do this, an application can assign the viewOrder value of each node to the computed distance between that node and the viewer.The parent will traverse its
childrenin decreasingviewOrderorder. This means that a child with a lowerviewOrderwill be in front of a child with a higherviewOrder. If two children have the sameviewOrder, the parent will traverse them in the order they appear in the parent'schildrenlist.However,
viewOrderdoes not alter the layout and focus traversal order of this Node within its parent. A parent always traverses itschildrenlist in order when doing layout or focus traversal. - Default value:
- 0.0
- Returns:
- the value of the
viewOrderproperty - Since:
- 9
- See Also:
getTransforms
public final ObservableList<Transform> getTransforms()
ObservableList of custom Transforms to be applied to this Node. These transforms are applied before the predefined transforms. See also the Transformations section.
- Default value:
- empty
- Returns:
- the transforms for this
Node
setTranslateX
public final void setTranslateX(double value)
translateX property.- Property description:
- Defines the x coordinate of the translation that is added to this
Node's transform.The node's final translation will be computed as
layoutX+translateX, wherelayoutXestablishes the node's stable position andtranslateXoptionally makes dynamic adjustments to that position.This variable can be used to alter the location of a node without disturbing its
layoutBounds, which makes it useful for animating a node's location. - Default value:
- 0
- Parameters:
-
value- the value for thetranslateXproperty - See Also:
getTranslateX
public final double getTranslateX()
translateX property.- Property description:
- Defines the x coordinate of the translation that is added to this
Node's transform.The node's final translation will be computed as
layoutX+translateX, wherelayoutXestablishes the node's stable position andtranslateXoptionally makes dynamic adjustments to that position.This variable can be used to alter the location of a node without disturbing its
layoutBounds, which makes it useful for animating a node's location. - Default value:
- 0
- Returns:
- the value of the
translateXproperty - See Also:
translateXProperty
public final DoubleProperty translateXProperty()
Node's transform. The node's final translation will be computed as layoutX + translateX, where layoutX establishes the node's stable position and translateX optionally makes dynamic adjustments to that position.
This variable can be used to alter the location of a node without disturbing its layoutBounds, which makes it useful for animating a node's location.
- Default value:
- 0
- Returns:
- the translateX for this
Node - See Also:
setTranslateY
public final void setTranslateY(double value)
translateY property.- Property description:
- Defines the y coordinate of the translation that is added to this
Node's transform.The node's final translation will be computed as
layoutY+translateY, wherelayoutYestablishes the node's stable position andtranslateYoptionally makes dynamic adjustments to that position.This variable can be used to alter the location of a node without disturbing its
layoutBounds, which makes it useful for animating a node's location. - Default value:
- 0
- Parameters:
-
value- the value for thetranslateYproperty - See Also:
getTranslateY
public final double getTranslateY()
translateY property.- Property description:
- Defines the y coordinate of the translation that is added to this
Node's transform.The node's final translation will be computed as
layoutY+translateY, wherelayoutYestablishes the node's stable position andtranslateYoptionally makes dynamic adjustments to that position.This variable can be used to alter the location of a node without disturbing its
layoutBounds, which makes it useful for animating a node's location. - Default value:
- 0
- Returns:
- the value of the
translateYproperty - See Also:
translateYProperty
public final DoubleProperty translateYProperty()
Node's transform. The node's final translation will be computed as layoutY + translateY, where layoutY establishes the node's stable position and translateY optionally makes dynamic adjustments to that position.
This variable can be used to alter the location of a node without disturbing its layoutBounds, which makes it useful for animating a node's location.
- Default value:
- 0
- Returns:
- the translateY for this
Node - See Also:
setTranslateZ
public final void setTranslateZ(double value)
translateZ property.- Property description:
- Defines the Z coordinate of the translation that is added to the transformed coordinates of this
Node. This value will be added to any translation defined by thetransformsObservableList andlayoutZ.This variable can be used to alter the location of a Node without disturbing its layout bounds, which makes it useful for animating a node's location.
Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information. - Default value:
- 0
- Parameters:
-
value- the value for thetranslateZproperty - See Also:
getTranslateZ
public final double getTranslateZ()
translateZ property.- Property description:
- Defines the Z coordinate of the translation that is added to the transformed coordinates of this
Node. This value will be added to any translation defined by thetransformsObservableList andlayoutZ.This variable can be used to alter the location of a Node without disturbing its layout bounds, which makes it useful for animating a node's location.
Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information. - Default value:
- 0
- Returns:
- the value of the
translateZproperty - See Also:
translateZProperty
public final DoubleProperty translateZProperty()
Node. This value will be added to any translation defined by the transforms ObservableList and layoutZ. This variable can be used to alter the location of a Node without disturbing its layout bounds, which makes it useful for animating a node's location.
Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
- Default value:
- 0
- Returns:
- the translateZ for this
Node - See Also:
setScaleX
public final void setScaleX(double value)
scaleX property.- Property description:
- Defines the factor by which coordinates are scaled about the center of the object along the X axis of this
Node. This is used to stretch or shrink the node either manually or by using an animation.This scale factor is not included in
layoutBoundsby default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.The pivot point about which the scale occurs is the center of the untransformed
layoutBounds. - Default value:
- 1.0
- Parameters:
-
value- the value for thescaleXproperty - See Also:
getScaleX
public final double getScaleX()
scaleX property.- Property description:
- Defines the factor by which coordinates are scaled about the center of the object along the X axis of this
Node. This is used to stretch or shrink the node either manually or by using an animation.This scale factor is not included in
layoutBoundsby default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.The pivot point about which the scale occurs is the center of the untransformed
layoutBounds. - Default value:
- 1.0
- Returns:
- the value of the
scaleXproperty - See Also:
scaleXProperty
public final DoubleProperty scaleXProperty()
Node. This is used to stretch or shrink the node either manually or by using an animation. This scale factor is not included in layoutBounds by default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.
The pivot point about which the scale occurs is the center of the untransformed layoutBounds.
- Default value:
- 1.0
- Returns:
- the scaleX for this
Node - See Also:
setScaleY
public final void setScaleY(double value)
scaleY property.- Property description:
- Defines the factor by which coordinates are scaled about the center of the object along the Y axis of this
Node. This is used to stretch or shrink the node either manually or by using an animation.This scale factor is not included in
layoutBoundsby default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.The pivot point about which the scale occurs is the center of the untransformed
layoutBounds. - Default value:
- 1.0
- Parameters:
-
value- the value for thescaleYproperty - See Also:
getScaleY
public final double getScaleY()
scaleY property.- Property description:
- Defines the factor by which coordinates are scaled about the center of the object along the Y axis of this
Node. This is used to stretch or shrink the node either manually or by using an animation.This scale factor is not included in
layoutBoundsby default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.The pivot point about which the scale occurs is the center of the untransformed
layoutBounds. - Default value:
- 1.0
- Returns:
- the value of the
scaleYproperty - See Also:
scaleYProperty
public final DoubleProperty scaleYProperty()
Node. This is used to stretch or shrink the node either manually or by using an animation. This scale factor is not included in layoutBounds by default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.
The pivot point about which the scale occurs is the center of the untransformed layoutBounds.
- Default value:
- 1.0
- Returns:
- the scaleY for this
Node - See Also:
setScaleZ
public final void setScaleZ(double value)
scaleZ property.- Property description:
- Defines the factor by which coordinates are scaled about the center of the object along the Z axis of this
Node. This is used to stretch or shrink the node either manually or by using an animation.This scale factor is not included in
layoutBoundsby default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.The pivot point about which the scale occurs is the center of the rectangular bounds formed by taking
boundsInLocaland applying all the transforms in thetransformsObservableList.Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information. - Default value:
- 1.0
- Parameters:
-
value- the value for thescaleZproperty - See Also:
getScaleZ
public final double getScaleZ()
scaleZ property.- Property description:
- Defines the factor by which coordinates are scaled about the center of the object along the Z axis of this
Node. This is used to stretch or shrink the node either manually or by using an animation.This scale factor is not included in
layoutBoundsby default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.The pivot point about which the scale occurs is the center of the rectangular bounds formed by taking
boundsInLocaland applying all the transforms in thetransformsObservableList.Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information. - Default value:
- 1.0
- Returns:
- the value of the
scaleZproperty - See Also:
scaleZProperty
public final DoubleProperty scaleZProperty()
Node. This is used to stretch or shrink the node either manually or by using an animation. This scale factor is not included in layoutBounds by default, which makes it ideal for scaling the entire node after all effects and transforms have been taken into account.
The pivot point about which the scale occurs is the center of the rectangular bounds formed by taking boundsInLocal and applying all the transforms in the transforms ObservableList.
Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
- Default value:
- 1.0
- Returns:
- the scaleZ for this
Node - See Also:
setRotate
public final void setRotate(double value)
rotate property.- Property description:
- Defines the angle of rotation about the
Node's center, measured in degrees. This is used to rotate theNode.This rotation factor is not included in
layoutBoundsby default, which makes it ideal for rotating the entire node after all effects and transforms have been taken into account.The pivot point about which the rotation occurs is the center of the untransformed
layoutBounds.Note that because the pivot point is computed as the center of this
Node's layout bounds, any change to the layout bounds will cause the pivot point to change, which can move the object. For a leaf node, any change to the geometry will cause the layout bounds to change. For a group node, any change to any of its children, including a change in a child's geometry, clip, effect, position, orientation, or scale, will cause the group's layout bounds to change. If this movement of the pivot point is not desired, applications should instead use the Node'stransformsObservableList, and add aRotatetransform, which has a user-specifiable pivot point. - Default value:
- 0.0
- Parameters:
-
value- the value for therotateproperty - See Also:
getRotate
public final double getRotate()
rotate property.- Property description:
- Defines the angle of rotation about the
Node's center, measured in degrees. This is used to rotate theNode.This rotation factor is not included in
layoutBoundsby default, which makes it ideal for rotating the entire node after all effects and transforms have been taken into account.The pivot point about which the rotation occurs is the center of the untransformed
layoutBounds.Note that because the pivot point is computed as the center of this
Node's layout bounds, any change to the layout bounds will cause the pivot point to change, which can move the object. For a leaf node, any change to the geometry will cause the layout bounds to change. For a group node, any change to any of its children, including a change in a child's geometry, clip, effect, position, orientation, or scale, will cause the group's layout bounds to change. If this movement of the pivot point is not desired, applications should instead use the Node'stransformsObservableList, and add aRotatetransform, which has a user-specifiable pivot point. - Default value:
- 0.0
- Returns:
- the value of the
rotateproperty - See Also:
rotateProperty
public final DoubleProperty rotateProperty()
Node's center, measured in degrees. This is used to rotate the Node. This rotation factor is not included in layoutBounds by default, which makes it ideal for rotating the entire node after all effects and transforms have been taken into account.
The pivot point about which the rotation occurs is the center of the untransformed layoutBounds.
Note that because the pivot point is computed as the center of this Node's layout bounds, any change to the layout bounds will cause the pivot point to change, which can move the object. For a leaf node, any change to the geometry will cause the layout bounds to change. For a group node, any change to any of its children, including a change in a child's geometry, clip, effect, position, orientation, or scale, will cause the group's layout bounds to change. If this movement of the pivot point is not desired, applications should instead use the Node's transforms ObservableList, and add a Rotate transform, which has a user-specifiable pivot point.
- Default value:
- 0.0
- Returns:
- the rotate for this
Node - See Also:
setRotationAxis
public final void setRotationAxis(Point3D value)
rotationAxis property.- Property description:
- Defines the axis of rotation of this
Node.Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information. - Default value:
- Rotate.Z_AXIS
- Parameters:
-
value- the value for therotationAxisproperty - See Also:
getRotationAxis
public final Point3D getRotationAxis()
rotationAxis property.- Property description:
- Defines the axis of rotation of this
Node.Note that this is a conditional feature. See
ConditionalFeature.SCENE3Dfor more information. - Default value:
- Rotate.Z_AXIS
- Returns:
- the value of the
rotationAxisproperty - See Also:
rotationAxisProperty
public final ObjectProperty<Point3D> rotationAxisProperty()
Node. Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.
- Default value:
- Rotate.Z_AXIS
- Returns:
- the rotationAxis for this
Node - See Also:
localToParentTransformProperty
public final ReadOnlyObjectProperty<Transform> localToParentTransformProperty()
- Returns:
- the localToParent transform for this
Node - Since:
- JavaFX 2.2
- See Also:
getLocalToParentTransform
public final Transform getLocalToParentTransform()
localToParentTransform property.- Property description:
- An affine transform that holds the computed local-to-parent transform. This is the concatenation of all transforms in this node, including all of the convenience transforms.
- Returns:
- the value of the
localToParentTransformproperty - Since:
- JavaFX 2.2
- See Also:
localToSceneTransformProperty
public final ReadOnlyObjectProperty<Transform> localToSceneTransformProperty()
SubScene, this property represents transforms up to the subscene, not the root scene. Note that when you register a listener or a binding to this property, it needs to listen for invalidation on all its parents to the root node. This means that registering a listener on this property on many nodes may negatively affect performance of transformation changes in their common parents.
- Returns:
- the localToScene transform for this
Node - Since:
- JavaFX 2.2
- See Also:
getLocalToSceneTransform
public final Transform getLocalToSceneTransform()
localToSceneTransform property.- Property description:
- An affine transform that holds the computed local-to-scene transform. This is the concatenation of all transforms in this node's parents and in this node, including all of the convenience transforms up to the root. If this node is in a
SubScene, this property represents transforms up to the subscene, not the root scene.Note that when you register a listener or a binding to this property, it needs to listen for invalidation on all its parents to the root node. This means that registering a listener on this property on many nodes may negatively affect performance of transformation changes in their common parents.
- Returns:
- the value of the
localToSceneTransformproperty - Since:
- JavaFX 2.2
- See Also:
setNodeOrientation
public final void setNodeOrientation(NodeOrientation orientation)
nodeOrientation property.- Property description:
- 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.
- Default value:
NodeOrientation.INHERIT- Parameters:
-
orientation- the value for thenodeOrientationproperty - Since:
- JavaFX 8.0
- See Also:
getNodeOrientation
public final NodeOrientation getNodeOrientation()
nodeOrientation property.- Property description:
- 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.
- Default value:
NodeOrientation.INHERIT- Returns:
- the value of the
nodeOrientationproperty - Since:
- JavaFX 8.0
- See Also:
nodeOrientationProperty
public final ObjectProperty<NodeOrientation> nodeOrientationProperty()
- Default value:
NodeOrientation.INHERIT- Returns:
- the
nodeOrientationproperty - Since:
- JavaFX 8.0
- See Also:
getEffectiveNodeOrientation
public final NodeOrientation getEffectiveNodeOrientation()
effectiveNodeOrientation property.- Property description:
- The effective orientation of a node resolves the inheritance of node orientation, returning either left-to-right or right-to-left.
- Returns:
- the value of the
effectiveNodeOrientationproperty - Since:
- JavaFX 8.0
- See Also:
effectiveNodeOrientationProperty
public final ReadOnlyObjectProperty<NodeOrientation> effectiveNodeOrientationProperty()
- Returns:
- the node orientation for this
Node - Since:
- JavaFX 8.0
- See Also:
usesMirroring
public boolean usesMirroring()
When a node is mirrored, the origin is automatically moved to the top right corner causing the node to layout children and draw from right to left using a mirroring transformation. Some nodes may wish to draw from right to left without using a transformation. These nodes will answer false and implement right-to-left orientation without using the automatic transformation.
- Returns:
- true if this
Nodeshould be mirrored - Since:
- JavaFX 8.0
setMouseTransparent
public final void setMouseTransparent(boolean value)
mouseTransparent property.- Property description:
- If
true, this node (together with all its children) is completely transparent to mouse events. When choosing target for mouse event, nodes withmouseTransparentset totrueand their subtrees won't be taken into account. - Parameters:
-
value- the value for themouseTransparentproperty - See Also:
isMouseTransparent
public final boolean isMouseTransparent()
mouseTransparent property.- Property description:
- If
true, this node (together with all its children) is completely transparent to mouse events. When choosing target for mouse event, nodes withmouseTransparentset totrueand their subtrees won't be taken into account. - Returns:
- the value of the
mouseTransparentproperty - See Also:
mouseTransparentProperty
public final BooleanProperty mouseTransparentProperty()
true, this node (together with all its children) is completely transparent to mouse events. When choosing target for mouse event, nodes with mouseTransparent set to true and their subtrees won't be taken into account.- Returns:
- is this
Node(together with all its children) is completely transparent to mouse events. - See Also:
setHover
protected final void setHover(boolean value)
hover property.- Property description:
- Whether or not this
Nodeis being hovered over. Typically this is due to the mouse being over the node, though it could be due to a pen hovering on a graphics tablet or other form of input.Note that current implementation of hover relies on mouse enter and exit events to determine whether this Node is in the hover state; this means that this feature is currently supported only on systems that have a mouse. Future implementations may provide alternative means of supporting hover.
- Default value:
- false
- Parameters:
-
value- the value for thehoverproperty - See Also:
isHover
public final boolean isHover()
hover property.- Property description:
- Whether or not this
Nodeis being hovered over. Typically this is due to the mouse being over the node, though it could be due to a pen hovering on a graphics tablet or other form of input.Note that current implementation of hover relies on mouse enter and exit events to determine whether this Node is in the hover state; this means that this feature is currently supported only on systems that have a mouse. Future implementations may provide alternative means of supporting hover.
- Default value:
- false
- Returns:
- the value of the
hoverproperty - See Also:
hoverProperty
public final ReadOnlyBooleanProperty hoverProperty()
Node is being hovered over. Typically this is due to the mouse being over the node, though it could be due to a pen hovering on a graphics tablet or other form of input. Note that current implementation of hover relies on mouse enter and exit events to determine whether this Node is in the hover state; this means that this feature is currently supported only on systems that have a mouse. Future implementations may provide alternative means of supporting hover.
- Default value:
- false
- Returns:
- the
hoverproperty - See Also:
setPressed
protected final void setPressed(boolean value)
pressed property.- Property description:
- Whether or not the
Nodeis pressed. Typically this is true when the primary mouse button is down, though subclasses may define other mouse button state or key state to cause the node to be "pressed". - Default value:
- false
- Parameters:
-
value- the value for thepressedproperty - See Also:
isPressed
public final boolean isPressed()
pressed property.- Property description:
- Whether or not the
Nodeis pressed. Typically this is true when the primary mouse button is down, though subclasses may define other mouse button state or key state to cause the node to be "pressed". - Default value:
- false
- Returns:
- the value of the
pressedproperty - See Also:
pressedProperty
public final ReadOnlyBooleanProperty pressedProperty()
Node is pressed. Typically this is true when the primary mouse button is down, though subclasses may define other mouse button state or key state to cause the node to be "pressed".- Default value:
- false
- Returns:
- the
pressedproperty - See Also:
setOnContextMenuRequested
public final void setOnContextMenuRequested(EventHandler<? super ContextMenuEvent> value)
onContextMenuRequested property.- Property description:
- Defines a function to be called when a context menu has been requested on this
Node. - Parameters:
-
value- the value for theonContextMenuRequestedproperty - Since:
- JavaFX 2.1
- See Also:
getOnContextMenuRequested
public final EventHandler<? super ContextMenuEvent> getOnContextMenuRequested()
onContextMenuRequested property.- Property description:
- Defines a function to be called when a context menu has been requested on this
Node. - Returns:
- the value of the
onContextMenuRequestedproperty - Since:
- JavaFX 2.1
- See Also:
onContextMenuRequestedProperty
public final ObjectProperty<EventHandler<? super ContextMenuEvent>> onContextMenuRequestedProperty()
Node.- Returns:
- the event handler that is called when a context menu has been requested on this
Node - Since:
- JavaFX 2.1
- See Also:
setOnMouseClicked
public final void setOnMouseClicked(EventHandler<? super MouseEvent> value)
onMouseClicked property.- Property description:
- Defines a function to be called when a mouse button has been clicked (pressed and released) on this
Node. - Parameters:
-
value- the value for theonMouseClickedproperty - See Also:
getOnMouseClicked
public final EventHandler<? super MouseEvent> getOnMouseClicked()
onMouseClicked property.- Property description:
- Defines a function to be called when a mouse button has been clicked (pressed and released) on this
Node. - Returns:
- the value of the
onMouseClickedproperty - See Also:
onMouseClickedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseClickedProperty()
Node.- Returns:
- the event handler that is called when a mouse button has been clicked (pressed and released) on this
Node - See Also:
setOnMouseDragged
public final void setOnMouseDragged(EventHandler<? super MouseEvent> value)
onMouseDragged property.- Property description:
- Defines a function to be called when a mouse button is pressed on this
Nodeand then dragged. - Parameters:
-
value- the value for theonMouseDraggedproperty - See Also:
getOnMouseDragged
public final EventHandler<? super MouseEvent> getOnMouseDragged()
onMouseDragged property.- Property description:
- Defines a function to be called when a mouse button is pressed on this
Nodeand then dragged. - Returns:
- the value of the
onMouseDraggedproperty - See Also:
onMouseDraggedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseDraggedProperty()
Node and then dragged.- Returns:
- the event handler that is called when a mouse button is pressed on this
Nodeand then dragged - See Also:
setOnMouseEntered
public final void setOnMouseEntered(EventHandler<? super MouseEvent> value)
onMouseEntered property.- Property description:
- Defines a function to be called when the mouse enters this
Node. - Parameters:
-
value- the value for theonMouseEnteredproperty - See Also:
getOnMouseEntered
public final EventHandler<? super MouseEvent> getOnMouseEntered()
onMouseEntered property.- Property description:
- Defines a function to be called when the mouse enters this
Node. - Returns:
- the value of the
onMouseEnteredproperty - See Also:
onMouseEnteredProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseEnteredProperty()
Node.- Returns:
- the event handler that is called when a mouse enters this
Node - See Also:
setOnMouseExited
public final void setOnMouseExited(EventHandler<? super MouseEvent> value)
onMouseExited property.- Property description:
- Defines a function to be called when the mouse exits this
Node. - Parameters:
-
value- the value for theonMouseExitedproperty - See Also:
getOnMouseExited
public final EventHandler<? super MouseEvent> getOnMouseExited()
onMouseExited property.- Property description:
- Defines a function to be called when the mouse exits this
Node. - Returns:
- the value of the
onMouseExitedproperty - See Also:
onMouseExitedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseExitedProperty()
Node.- Returns:
- the event handler that is called when a mouse exits this
Node - See Also:
setOnMouseMoved
public final void setOnMouseMoved(EventHandler<? super MouseEvent> value)
onMouseMoved property.- Property description:
- Defines a function to be called when mouse cursor moves within this
Nodebut no buttons have been pushed. - Parameters:
-
value- the value for theonMouseMovedproperty - See Also:
getOnMouseMoved
public final EventHandler<? super MouseEvent> getOnMouseMoved()
onMouseMoved property.- Property description:
- Defines a function to be called when mouse cursor moves within this
Nodebut no buttons have been pushed. - Returns:
- the value of the
onMouseMovedproperty - See Also:
onMouseMovedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseMovedProperty()
Node but no buttons have been pushed.- Returns:
- the event handler that is called when a mouse cursor moves within this
Nodebut no buttons have been pushed - See Also:
setOnMousePressed
public final void setOnMousePressed(EventHandler<? super MouseEvent> value)
onMousePressed property.- Property description:
- Defines a function to be called when a mouse button has been pressed on this
Node. - Parameters:
-
value- the value for theonMousePressedproperty - See Also:
getOnMousePressed
public final EventHandler<? super MouseEvent> getOnMousePressed()
onMousePressed property.- Property description:
- Defines a function to be called when a mouse button has been pressed on this
Node. - Returns:
- the value of the
onMousePressedproperty - See Also:
onMousePressedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMousePressedProperty()
Node.- Returns:
- the event handler that is called when a mouse button has been pressed on this
Node - See Also:
setOnMouseReleased
public final void setOnMouseReleased(EventHandler<? super MouseEvent> value)
onMouseReleased property.- Property description:
- Defines a function to be called when a mouse button has been released on this
Node. - Parameters:
-
value- the value for theonMouseReleasedproperty - See Also:
getOnMouseReleased
public final EventHandler<? super MouseEvent> getOnMouseReleased()
onMouseReleased property.- Property description:
- Defines a function to be called when a mouse button has been released on this
Node. - Returns:
- the value of the
onMouseReleasedproperty - See Also:
onMouseReleasedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onMouseReleasedProperty()
Node.- Returns:
- the event handler that is called when a mouse button has been released on this
Node - See Also:
setOnDragDetected
public final void setOnDragDetected(EventHandler<? super MouseEvent> value)
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 theonDragDetectedproperty - See Also:
getOnDragDetected
public final EventHandler<? super MouseEvent> getOnDragDetected()
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
onDragDetectedproperty - See Also:
onDragDetectedProperty
public final ObjectProperty<EventHandler<? super MouseEvent>> onDragDetectedProperty()
- Returns:
- the event handler that is called when drag gesture has been detected
- See Also:
setOnMouseDragOver
public final void setOnMouseDragOver(EventHandler<? super MouseDragEvent> value)
onMouseDragOver property.- Property description:
- Defines a function to be called when a full press-drag-release gesture progresses within this
Node. - Parameters:
-
value- the value for theonMouseDragOverproperty - Since:
- JavaFX 2.1
- See Also:
getOnMouseDragOver
public final EventHandler<? super MouseDragEvent> getOnMouseDragOver()
onMouseDragOver property.- Property description:
- Defines a function to be called when a full press-drag-release gesture progresses within this
Node. - Returns:
- the value of the
onMouseDragOverproperty - Since:
- JavaFX 2.1
- See Also:
onMouseDragOverProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragOverProperty()
Node.- Returns:
- the event handler that is called when a full press-drag-release gesture progresses within this
Node - Since:
- JavaFX 2.1
- See Also:
setOnMouseDragReleased
public final void setOnMouseDragReleased(EventHandler<? super MouseDragEvent> value)
onMouseDragReleased property.- Property description:
- Defines a function to be called when a full press-drag-release gesture ends (by releasing mouse button) within this
Node. - Parameters:
-
value- the value for theonMouseDragReleasedproperty - Since:
- JavaFX 2.1
- See Also:
getOnMouseDragReleased
public final EventHandler<? super MouseDragEvent> getOnMouseDragReleased()
onMouseDragReleased property.- Property description:
- Defines a function to be called when a full press-drag-release gesture ends (by releasing mouse button) within this
Node. - Returns:
- the value of the
onMouseDragReleasedproperty - Since:
- JavaFX 2.1
- See Also:
onMouseDragReleasedProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragReleasedProperty()
Node.- Returns:
- the event handler that is called when a full press-drag-release gesture ends (by releasing mouse button) within this
Node - Since:
- JavaFX 2.1
- See Also:
setOnMouseDragEntered
public final void setOnMouseDragEntered(EventHandler<? super MouseDragEvent> value)
onMouseDragEntered property.- Property description:
- Defines a function to be called when a full press-drag-release gesture enters this
Node. - Parameters:
-
value- the value for theonMouseDragEnteredproperty - Since:
- JavaFX 2.1
- See Also:
getOnMouseDragEntered
public final EventHandler<? super MouseDragEvent> getOnMouseDragEntered()
onMouseDragEntered property.- Property description:
- Defines a function to be called when a full press-drag-release gesture enters this
Node. - Returns:
- the value of the
onMouseDragEnteredproperty - Since:
- JavaFX 2.1
- See Also:
onMouseDragEnteredProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragEnteredProperty()
Node.- Returns:
- the event handler that is called when a full press-drag-release gesture enters this
Node - Since:
- JavaFX 2.1
- See Also:
setOnMouseDragExited
public final void setOnMouseDragExited(EventHandler<? super MouseDragEvent> value)
onMouseDragExited property.- Property description:
- Defines a function to be called when a full press-drag-release gesture leaves this
Node. - Parameters:
-
value- the value for theonMouseDragExitedproperty - Since:
- JavaFX 2.1
- See Also:
getOnMouseDragExited
public final EventHandler<? super MouseDragEvent> getOnMouseDragExited()
onMouseDragExited property.- Property description:
- Defines a function to be called when a full press-drag-release gesture leaves this
Node. - Returns:
- the value of the
onMouseDragExitedproperty - Since:
- JavaFX 2.1
- See Also:
onMouseDragExitedProperty
public final ObjectProperty<EventHandler<? super MouseDragEvent>> onMouseDragExitedProperty()
Node.- Returns:
- the event handler that is called when a full press-drag-release gesture leaves this
Node - Since:
- JavaFX 2.1
- See Also:
setOnScrollStarted
public final void setOnScrollStarted(EventHandler<? super ScrollEvent> value)
onScrollStarted property.- Property description:
- Defines a function to be called when a scrolling gesture is detected.
- Parameters:
-
value- the value for theonScrollStartedproperty - Since:
- JavaFX 2.2
- See Also:
getOnScrollStarted
public final EventHandler<? super ScrollEvent> getOnScrollStarted()
onScrollStarted property.- Property description:
- Defines a function to be called when a scrolling gesture is detected.
- Returns:
- the value of the
onScrollStartedproperty - Since:
- JavaFX 2.2
- See Also:
onScrollStartedProperty
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollStartedProperty()
- Returns:
- the event handler that is called when a scrolling gesture is detected
- Since:
- JavaFX 2.2
- See Also:
setOnScroll
public final void setOnScroll(EventHandler<? super ScrollEvent> value)
onScroll property.- Property description:
- Defines a function to be called when user performs a scrolling action.
- Parameters:
-
value- the value for theonScrollproperty - See Also:
getOnScroll
public final EventHandler<? super ScrollEvent> getOnScroll()
onScroll property.- Property description:
- Defines a function to be called when user performs a scrolling action.
- Returns:
- the value of the
onScrollproperty - See Also:
onScrollProperty
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollProperty()
- Returns:
- the event handler that is called when user performs a scrolling action
- See Also:
setOnScrollFinished
public final void setOnScrollFinished(EventHandler<? super ScrollEvent> value)
onScrollFinished property.- Property description:
- Defines a function to be called when a scrolling gesture ends.
- Parameters:
-
value- the value for theonScrollFinishedproperty - Since:
- JavaFX 2.2
- See Also:
getOnScrollFinished
public final EventHandler<? super ScrollEvent> getOnScrollFinished()
onScrollFinished property.- Property description:
- Defines a function to be called when a scrolling gesture ends.
- Returns:
- the value of the
onScrollFinishedproperty - Since:
- JavaFX 2.2
- See Also:
onScrollFinishedProperty
public final ObjectProperty<EventHandler<? super ScrollEvent>> onScrollFinishedProperty()
- Returns:
- the event handler that is called when a scrolling gesture ends
- Since:
- JavaFX 2.2
- See Also:
setOnRotationStarted
public final void setOnRotationStarted(EventHandler<? super RotateEvent> value)
onRotationStarted property.- Property description:
- Defines a function to be called when a rotation gesture is detected.
- Parameters:
-
value- the value for theonRotationStartedproperty - Since:
- JavaFX 2.2
- See Also:
getOnRotationStarted
public final EventHandler<? super RotateEvent> getOnRotationStarted()
onRotationStarted property.- Property description:
- Defines a function to be called when a rotation gesture is detected.
- Returns:
- the value of the
onRotationStartedproperty - Since:
- JavaFX 2.2
- See Also:
onRotationStartedProperty
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationStartedProperty()
- Returns:
- the event handler that is called when a rotation gesture is detected
- Since:
- JavaFX 2.2
- See Also:
setOnRotate
public final void setOnRotate(EventHandler<? super RotateEvent> value)
onRotate property.- Property description:
- Defines a function to be called when user performs a rotation action.
- Parameters:
-
value- the value for theonRotateproperty - Since:
- JavaFX 2.2
- See Also:
getOnRotate
public final EventHandler<? super RotateEvent> getOnRotate()
onRotate property.- Property description:
- Defines a function to be called when user performs a rotation action.
- Returns:
- the value of the
onRotateproperty - Since:
- JavaFX 2.2
- See Also:
onRotateProperty
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotateProperty()
- Returns:
- the event handler that is called when user performs a rotation action
- Since:
- JavaFX 2.2
- See Also:
setOnRotationFinished
public final void setOnRotationFinished(EventHandler<? super RotateEvent> value)
onRotationFinished property.- Property description:
- Defines a function to be called when a rotation gesture ends.
- Parameters:
-
value- the value for theonRotationFinishedproperty - Since:
- JavaFX 2.2
- See Also:
getOnRotationFinished
public final EventHandler<? super RotateEvent> getOnRotationFinished()
onRotationFinished property.- Property description:
- Defines a function to be called when a rotation gesture ends.
- Returns:
- the value of the
onRotationFinishedproperty - Since:
- JavaFX 2.2
- See Also:
onRotationFinishedProperty
public final ObjectProperty<EventHandler<? super RotateEvent>> onRotationFinishedProperty()
- Returns:
- the event handler that is called when a rotation gesture ends
- Since:
- JavaFX 2.2
- See Also:
setOnZoomStarted
public final void setOnZoomStarted(EventHandler<? super ZoomEvent> value)
onZoomStarted property.- Property description:
- Defines a function to be called when a zooming gesture is detected.
- Parameters:
-
value- the value for theonZoomStartedproperty - Since:
- JavaFX 2.2
- See Also:
getOnZoomStarted
public final EventHandler<? super ZoomEvent> getOnZoomStarted()
onZoomStarted property.- Property description:
- Defines a function to be called when a zooming gesture is detected.
- Returns:
- the value of the
onZoomStartedproperty - Since:
- JavaFX 2.2
- See Also:
onZoomStartedProperty
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomStartedProperty()
- Returns:
- the event handler that is called when a zooming gesture is detected
- Since:
- JavaFX 2.2
- See Also:
setOnZoom
public final void setOnZoom(EventHandler<? super ZoomEvent> value)
onZoom property.- Property description:
- Defines a function to be called when user performs a zooming action.
- Parameters:
-
value- the value for theonZoomproperty - Since:
- JavaFX 2.2
- See Also:
getOnZoom
public final EventHandler<? super ZoomEvent> getOnZoom()
onZoom property.- Property description:
- Defines a function to be called when user performs a zooming action.
- Returns:
- the value of the
onZoomproperty - Since:
- JavaFX 2.2
- See Also:
onZoomProperty
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomProperty()
- Returns:
- the event handler that is called when user performs a zooming action
- Since:
- JavaFX 2.2
- See Also:
setOnZoomFinished
public final void setOnZoomFinished(EventHandler<? super ZoomEvent> value)
onZoomFinished property.- Property description:
- Defines a function to be called when a zooming gesture ends.
- Parameters:
-
value- the value for theonZoomFinishedproperty - Since:
- JavaFX 2.2
- See Also:
getOnZoomFinished
public final EventHandler<? super ZoomEvent> getOnZoomFinished()
onZoomFinished property.- Property description:
- Defines a function to be called when a zooming gesture ends.
- Returns:
- the value of the
onZoomFinishedproperty - Since:
- JavaFX 2.2
- See Also:
onZoomFinishedProperty
public final ObjectProperty<EventHandler<? super ZoomEvent>> onZoomFinishedProperty()
- Returns:
- the event handler that is called when a zooming gesture ends
- Since:
- JavaFX 2.2
- See Also:
setOnSwipeUp
public final void setOnSwipeUp(EventHandler<? super SwipeEvent> value)
onSwipeUp property.- Property description:
- Defines a function to be called when an upward swipe gesture centered over this node happens.
- Parameters:
-
value- the value for theonSwipeUpproperty - Since:
- JavaFX 2.2
- See Also:
getOnSwipeUp
public final EventHandler<? super SwipeEvent> getOnSwipeUp()
onSwipeUp property.- Property description:
- Defines a function to be called when an upward swipe gesture centered over this node happens.
- Returns:
- the value of the
onSwipeUpproperty - Since:
- JavaFX 2.2
- See Also:
onSwipeUpProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeUpProperty()
- Returns:
- the event handler that is called when an upward swipe gesture centered over this node happens
- Since:
- JavaFX 2.2
- See Also:
setOnSwipeDown
public final void setOnSwipeDown(EventHandler<? super SwipeEvent> value)
onSwipeDown property.- Property description:
- Defines a function to be called when a downward swipe gesture centered over this node happens.
- Parameters:
-
value- the value for theonSwipeDownproperty - Since:
- JavaFX 2.2
- See Also:
getOnSwipeDown
public final EventHandler<? super SwipeEvent> getOnSwipeDown()
onSwipeDown property.- Property description:
- Defines a function to be called when a downward swipe gesture centered over this node happens.
- Returns:
- the value of the
onSwipeDownproperty - Since:
- JavaFX 2.2
- See Also:
onSwipeDownProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeDownProperty()
- Returns:
- the event handler that is called when a downward swipe gesture centered over this node happens
- Since:
- JavaFX 2.2
- See Also:
setOnSwipeLeft
public final void setOnSwipeLeft(EventHandler<? super SwipeEvent> value)
onSwipeLeft property.- Property description:
- Defines a function to be called when a leftward swipe gesture centered over this node happens.
- Parameters:
-
value- the value for theonSwipeLeftproperty - Since:
- JavaFX 2.2
- See Also:
getOnSwipeLeft
public final EventHandler<? super SwipeEvent> getOnSwipeLeft()
onSwipeLeft property.- Property description:
- Defines a function to be called when a leftward swipe gesture centered over this node happens.
- Returns:
- the value of the
onSwipeLeftproperty - Since:
- JavaFX 2.2
- See Also:
onSwipeLeftProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeLeftProperty()
- Returns:
- the event handler that is called when a leftward swipe gesture centered over this node happens
- Since:
- JavaFX 2.2
- See Also:
setOnSwipeRight
public final void setOnSwipeRight(EventHandler<? super SwipeEvent> value)
onSwipeRight property.- Property description:
- Defines a function to be called when an rightward swipe gesture centered over this node happens.
- Parameters:
-
value- the value for theonSwipeRightproperty - Since:
- JavaFX 2.2
- See Also:
getOnSwipeRight
public final EventHandler<? super SwipeEvent> getOnSwipeRight()
onSwipeRight property.- Property description:
- Defines a function to be called when an rightward swipe gesture centered over this node happens.
- Returns:
- the value of the
onSwipeRightproperty - Since:
- JavaFX 2.2
- See Also:
onSwipeRightProperty
public final ObjectProperty<EventHandler<? super SwipeEvent>> onSwipeRightProperty()
- Returns:
- the event handler that is called when an rightward swipe gesture centered over this node happens
- Since:
- JavaFX 2.2
- See Also:
setOnTouchPressed
public final void setOnTouchPressed(EventHandler<? super TouchEvent> value)
onTouchPressed property.- Property description:
- Defines a function to be called when a new touch point is pressed.
- Parameters:
-
value- the value for theonTouchPressedproperty - Since:
- JavaFX 2.2
- See Also:
getOnTouchPressed
public final EventHandler<? super TouchEvent> getOnTouchPressed()
onTouchPressed property.- Property description:
- Defines a function to be called when a new touch point is pressed.
- Returns:
- the value of the
onTouchPressedproperty - Since:
- JavaFX 2.2
- See Also:
onTouchPressedProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchPressedProperty()
- Returns:
- the event handler that is called when a new touch point is pressed
- Since:
- JavaFX 2.2
- See Also:
setOnTouchMoved
public final void setOnTouchMoved(EventHandler<? super TouchEvent> value)
onTouchMoved property.- Property description:
- Defines a function to be called when a touch point is moved.
- Parameters:
-
value- the value for theonTouchMovedproperty - Since:
- JavaFX 2.2
- See Also:
getOnTouchMoved
public final EventHandler<? super TouchEvent> getOnTouchMoved()
onTouchMoved property.- Property description:
- Defines a function to be called when a touch point is moved.
- Returns:
- the value of the
onTouchMovedproperty - Since:
- JavaFX 2.2
- See Also:
onTouchMovedProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchMovedProperty()
- Returns:
- the event handler that is called when a touch point is moved
- Since:
- JavaFX 2.2
- See Also:
setOnTouchReleased
public final void setOnTouchReleased(EventHandler<? super TouchEvent> value)
onTouchReleased property.- Property description:
- Defines a function to be called when a touch point is released.
- Parameters:
-
value- the value for theonTouchReleasedproperty - Since:
- JavaFX 2.2
- See Also:
getOnTouchReleased
public final EventHandler<? super TouchEvent> getOnTouchReleased()
onTouchReleased property.- Property description:
- Defines a function to be called when a touch point is released.
- Returns:
- the value of the
onTouchReleasedproperty - Since:
- JavaFX 2.2
- See Also:
onTouchReleasedProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchReleasedProperty()
- Returns:
- the event handler that is called when a touch point is released
- Since:
- JavaFX 2.2
- See Also:
setOnTouchStationary
public final void setOnTouchStationary(EventHandler<? super TouchEvent> value)
onTouchStationary property.- Property description:
- Defines a function to be called when a touch point stays pressed and still.
- Parameters:
-
value- the value for theonTouchStationaryproperty - Since:
- JavaFX 2.2
- See Also:
getOnTouchStationary
public final EventHandler<? super TouchEvent> getOnTouchStationary()
onTouchStationary property.- Property description:
- Defines a function to be called when a touch point stays pressed and still.
- Returns:
- the value of the
onTouchStationaryproperty - Since:
- JavaFX 2.2
- See Also:
onTouchStationaryProperty
public final ObjectProperty<EventHandler<? super TouchEvent>> onTouchStationaryProperty()
- Returns:
- the event handler that is called when a touch point stays pressed and still
- Since:
- JavaFX 2.2
- See Also:
setOnKeyPressed
public final void setOnKeyPressed(EventHandler<? super KeyEvent> value)
onKeyPressed property.- Property description:
- Defines a function to be called when this
Nodeor its childNodehas 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 theonKeyPressedproperty - See Also:
getOnKeyPressed
public final EventHandler<? super KeyEvent> getOnKeyPressed()
onKeyPressed property.- Property description:
- Defines a function to be called when this
Nodeor its childNodehas 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
onKeyPressedproperty - See Also:
onKeyPressedProperty
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyPressedProperty()
Node or its child Node 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 event handler that is called when this
Nodeor its childNodehas input focus and a key has been pressed - See Also:
setOnKeyReleased
public final void setOnKeyReleased(EventHandler<? super KeyEvent> value)
onKeyReleased property.- Property description:
- Defines a function to be called when this
Nodeor its childNodehas 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 theonKeyReleasedproperty - See Also:
getOnKeyReleased
public final EventHandler<? super KeyEvent> getOnKeyReleased()
onKeyReleased property.- Property description:
- Defines a function to be called when this
Nodeor its childNodehas 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
onKeyReleasedproperty - See Also:
onKeyReleasedProperty
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyReleasedProperty()
Node or its child Node 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 event handler that is called when this
Nodeor its childNodehas input focus and a key has been released - See Also:
setOnKeyTyped
public final void setOnKeyTyped(EventHandler<? super KeyEvent> value)
onKeyTyped property.- Property description:
- Defines a function to be called when this
Nodeor its childNodehas 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 theonKeyTypedproperty - See Also:
getOnKeyTyped
public final EventHandler<? super KeyEvent> getOnKeyTyped()
onKeyTyped property.- Property description:
- Defines a function to be called when this
Nodeor its childNodehas 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
onKeyTypedproperty - See Also:
onKeyTypedProperty
public final ObjectProperty<EventHandler<? super KeyEvent>> onKeyTypedProperty()
Node or its child Node 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 event handler that is called when this
Nodeor its childNodehas input focus and a key has been typed - See Also:
setOnInputMethodTextChanged
public final void setOnInputMethodTextChanged(EventHandler<? super InputMethodEvent> value)
onInputMethodTextChanged property.- Property description:
- Defines a function to be called when this
Nodehas input focus and the input method text has changed. If this function is not defined in thisNode, then it receives the result string of the input method composition as a series ofonKeyTypedfunction calls.When the
Nodeloses the input focus, the JavaFX runtime automatically commits the existing composed text if any. - Parameters:
-
value- the value for theonInputMethodTextChangedproperty - See Also:
getOnInputMethodTextChanged
public final EventHandler<? super InputMethodEvent> getOnInputMethodTextChanged()
onInputMethodTextChanged property.- Property description:
- Defines a function to be called when this
Nodehas input focus and the input method text has changed. If this function is not defined in thisNode, then it receives the result string of the input method composition as a series ofonKeyTypedfunction calls.When the
Nodeloses the input focus, the JavaFX runtime automatically commits the existing composed text if any. - Returns:
- the value of the
onInputMethodTextChangedproperty - See Also:
onInputMethodTextChangedProperty
public final ObjectProperty<EventHandler<? super InputMethodEvent>> onInputMethodTextChangedProperty()
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 event handler that is called when this
Nodehas input focus and the input method text has changed - See Also:
setInputMethodRequests
public final void setInputMethodRequests(InputMethodRequests value)
inputMethodRequests property.- Property description:
- Property holding InputMethodRequests.
- Parameters:
-
value- the value for theinputMethodRequestsproperty - See Also:
getInputMethodRequests
public final InputMethodRequests getInputMethodRequests()
inputMethodRequests property.- Property description:
- Property holding InputMethodRequests.
- Returns:
- the value of the
inputMethodRequestsproperty - See Also:
inputMethodRequestsProperty
public final ObjectProperty<InputMethodRequests> inputMethodRequestsProperty()
- Returns:
- InputMethodRequestsProperty
- See Also:
setFocused
protected final void setFocused(boolean value)
focused property.- Property description:
- Indicates whether this
Nodecurrently has the input focus. To have the input focus, a node must be theScene's focus owner, and the scene must be in aStagethat is visible and active. SeerequestFocus()for more information. - Default value:
- false
- Parameters:
-
value- the value for thefocusedproperty - See Also:
isFocused
public final boolean isFocused()
focused property.- Property description:
- Indicates whether this
Nodecurrently has the input focus. To have the input focus, a node must be theScene's focus owner, and the scene must be in aStagethat is visible and active. SeerequestFocus()for more information. - Default value:
- false
- Returns:
- the value of the
focusedproperty - See Also:
focusedProperty
public final ReadOnlyBooleanProperty focusedProperty()
Node currently has the input focus. To have the input focus, a node must be the Scene's focus owner, and the scene must be in a Stage that is visible and active. See requestFocus() for more information.- Default value:
- false
- Returns:
- the
focusedproperty - See Also:
isFocusVisible
public final boolean isFocusVisible()
focusVisible property.- Property description:
- Indicates whether this
Nodeshould visibly indicate focus. This flag is set when the node acquires input focus via keyboard navigation, and it is cleared when the node loses focus or whenrequestFocus()is called. - Default value:
- false
- Returns:
- the value of the
focusVisibleproperty - Since:
- 19
- See Also:
focusVisibleProperty
public final ReadOnlyBooleanProperty focusVisibleProperty()
Node should visibly indicate focus. This flag is set when the node acquires input focus via keyboard navigation, and it is cleared when the node loses focus or when requestFocus() is called.- Default value:
- false
- Returns:
- the
focusVisibleproperty - Since:
- 19
- See Also:
isFocusWithin
public final boolean isFocusWithin()
focusWithin property.- Property description:
- Indicates whether this
Nodeor any of its descendants currently has the input focus. - Default value:
- false
- Returns:
- the value of the
focusWithinproperty - Since:
- 19
- See Also:
focusWithinProperty
public final ReadOnlyBooleanProperty focusWithinProperty()
Node or any of its descendants currently has the input focus.- Default value:
- false
- Returns:
- the
focusWithinproperty - Since:
- 19
- See Also:
setFocusTraversable
public final void setFocusTraversable(boolean value)
focusTraversable property.- Property description:
- Specifies whether this
Nodeshould be a part of focus traversal cycle. When this property istruefocus can be moved to thisNodeand from thisNodeusing regular focus traversal keys. On a desktop such keys are usuallyTABfor moving focus forward andSHIFT+TABfor moving focus backward. When aSceneis created, the system gives focus to aNodewhosefocusTraversablevariable is true and that is eligible to receive the focus, unless the focus had been set explicitly via a call torequestFocus(). - Default value:
- false
- Parameters:
-
value- the value for thefocusTraversableproperty - See Also:
isFocusTraversable
public final boolean isFocusTraversable()
focusTraversable property.- Property description:
- Specifies whether this
Nodeshould be a part of focus traversal cycle. When this property istruefocus can be moved to thisNodeand from thisNodeusing regular focus traversal keys. On a desktop such keys are usuallyTABfor moving focus forward andSHIFT+TABfor moving focus backward. When aSceneis created, the system gives focus to aNodewhosefocusTraversablevariable is true and that is eligible to receive the focus, unless the focus had been set explicitly via a call torequestFocus(). - Default value:
- false
- Returns:
- the value of the
focusTraversableproperty - See Also:
focusTraversableProperty
public final BooleanProperty focusTraversableProperty()
Node should be a part of focus traversal cycle. When this property is true focus can be moved to this Node and from this Node using regular focus traversal keys. On a desktop such keys are usually TAB for moving focus forward and SHIFT+TAB for moving focus backward. When a Scene is created, the system gives focus to a Node whose focusTraversable variable is true and that is eligible to receive the focus, unless the focus had been set explicitly via a call to requestFocus().- Default value:
- false
- Returns:
- the
focusTraversableproperty - See Also:
requestFocus
public void requestFocus()
Node get the input focus, and that this Node's top-level ancestor become the focused window. To be eligible to receive the focus, the node must be part of a scene, it and all of its ancestors must be visible, and it must not be disabled. If this node is eligible, this function will cause it to become this Scene's "focus owner". Each scene has at most one focus owner node. The focus owner will not actually have the input focus, however, unless the scene belongs to a Stage that is both visible and active. This method will clear the focusVisible flag.
requestFocusTraversal
public final boolean requestFocusTraversal(TraversalDirection direction)
Node in the specified direction. The Node serves as a reference point and does not have to be focused or focusable. A successful traversal results in a new Node being focused. This method is expected to be called in response to a KeyEvent; therefore the Node receiving focus will have the focusVisible property set.
- Parameters:
-
direction- the direction of focus traversal, non-null - Returns:
-
trueif traversal was successful - Since:
- 24
toString
setEventDispatcher
public final void setEventDispatcher(EventDispatcher value)
eventDispatcher property.- Property description:
- Specifies the event dispatcher for this node. The default event dispatcher sends the received events to the registered event handlers and filters. When replacing the value with a new
EventDispatcher, the new dispatcher should forward events to the replaced dispatcher to maintain the node's default event handling behavior. - Parameters:
-
value- the value for theeventDispatcherproperty - See Also:
getEventDispatcher
public final EventDispatcher getEventDispatcher()
eventDispatcher property.- Property description:
- Specifies the event dispatcher for this node. The default event dispatcher sends the received events to the registered event handlers and filters. When replacing the value with a new
EventDispatcher, the new dispatcher should forward events to the replaced dispatcher to maintain the node's default event handling behavior. - Returns:
- the value of the
eventDispatcherproperty - See Also:
eventDispatcherProperty
public final ObjectProperty<EventDispatcher> eventDispatcherProperty()
EventDispatcher, the new dispatcher should forward events to the replaced dispatcher to maintain the node's default event handling behavior.- Returns:
- the
eventDispatcherproperty - See Also:
addEventHandler
public final <T extends Event> void addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
EventTarget The handler is called when the target receives an Event of the specified type during the bubbling phase of event delivery.
- Specified by:
-
addEventHandlerin interfaceEventTarget - Type Parameters:
-
T- the event class of the handler - Parameters:
-
eventType- the type of the events received by the handler -
eventHandler- the event handler
removeEventHandler
public final <T extends Event> void removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
EventTarget Since it is possible to register a single EventHandler instance for different event types, the caller needs to specify the event type from which the handler should be unregistered.
- Specified by:
-
removeEventHandlerin interfaceEventTarget - Type Parameters:
-
T- the event class of the handler - Parameters:
-
eventType- the event type from which to unregister -
eventHandler- the event handler
addEventFilter
public final <T extends Event> void addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
EventTarget The filter is called when the target receives an Event of the specified type during the capturing phase of event delivery.
- Specified by:
-
addEventFilterin interfaceEventTarget - Type Parameters:
-
T- the event class of the filter - Parameters:
-
eventType- the type of the events received by the filter -
eventFilter- the event filter
removeEventFilter
public final <T extends Event> void removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
EventTarget Since it is possible to register a single EventHandler instance for different event types, the caller needs to specify the event type from which the filter should be unregistered.
- Specified by:
-
removeEventFilterin interfaceEventTarget - Type Parameters:
-
T- the event class of the filter - Parameters:
-
eventType- the event type from which to unregister -
eventFilter- the event filter
setEventHandler
protected final <T extends Event> void setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
addEventHandler(javafx.event.EventType, javafx.event.EventHandler). 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
buildEventDispatchChain
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTargetEventTarget. This event target is not automatically added to the chain, so if it wants to process events, it needs to add an EventDispatcher for itself to the chain. In the case the event target is part of some hierarchy, the chain for it is usually built from event dispatchers collected from the root of the hierarchy to the event target.
The event dispatch chain is constructed by modifications to the provided initial event dispatch chain. The returned chain should have the initial chain at its end so the dispatchers should be prepended to the initial chain.
The caller shouldn't assume that the initial chain remains unchanged nor that the returned value will reference a different chain.
- Specified by:
-
buildEventDispatchChainin interfaceEventTarget - Parameters:
-
tail- the initial chain to build from - Returns:
- the resulting event dispatch chain for this target
fireEvent
public final void fireEvent(Event event)
This method must be called on the FX user thread.
- Parameters:
-
event- the event to fire
getTypeSelector
public String getTypeSelector()
Styleable that is to be used in selector matching. This is analogous to an "element" in HTML. (CSS Type Selector).- Specified by:
-
getTypeSelectorin interfaceStyleable - Returns:
-
getClass().getName()without the package name - Since:
- JavaFX 8.0
getStyleableParent
public Styleable getStyleableParent()
- Specified by:
-
getStyleableParentin interfaceStyleable - Returns:
getParent()- Since:
- JavaFX 8.0
getInitialFocusTraversable
protected Boolean getInitialFocusTraversable()
- Returns:
- the initial focus traversable state for this
Node. - Since:
- 9
getInitialCursor
protected Cursor getInitialCursor()
- Returns:
- the initial cursor state for this
Node. - Since:
- 9
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
CssMetaData associated with this class, which may include the CssMetaData of its superclasses.- Returns:
- the
CssMetaData - Since:
- JavaFX 8.0
getCssMetaData
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
getClassCssMetaData() so that a Node's CssMetaData can be accessed without the need for reflection.- Specified by:
-
getCssMetaDatain interfaceStyleable - Returns:
- The CssMetaData associated with this node, which may include the CssMetaData of its superclasses.
- Since:
- JavaFX 8.0
pseudoClassStateChanged
public final void pseudoClassStateChanged(PseudoClass pseudoClass, boolean active)
invalidated method of a property that is used as a pseudo-class. For example:
private static final PseudoClass MY_PSEUDO_CLASS_STATE = PseudoClass.getPseudoClass("my-state");
BooleanProperty myPseudoClassState = new BooleanPropertyBase(false) {
@Override public void invalidated() {
pseudoClassStateChanged(MY_PSEUDO_CLASS_STATE, get());
}
@Override public Object getBean() {
return MyControl.this;
}
@Override public String getName() {
return "myPseudoClassState";
}
};
- Parameters:
-
pseudoClass- the pseudo-class that has changed state -
active- whether or not the state is active - Since:
- JavaFX 8.0
getPseudoClassStates
public final ObservableSet<PseudoClass> getPseudoClassStates()
Styleable- Specified by:
-
getPseudoClassStatesin interfaceStyleable - Returns:
- The active pseudo-class states of this Node, wrapped in an unmodifiable ObservableSet
- Since:
- JavaFX 8.0
applyCss
public final void applyCss()
Parent.layout() to size a Node before the next pulse, or if the Scene is not in a Stage. Provided that the Node's Scene is not null, CSS is applied to this Node regardless of whether this Node's CSS state is clean. CSS styles are applied from the top-most parent of this Node whose CSS state is other than clean, which may affect the styling of other nodes. This method is a no-op if the Node is not in a Scene. The Scene does not have to be in a Stage.
This method does not invoke the Parent.layout() method. Typically, the caller will use the following sequence of operations.
parentNode.applyCss();
parentNode.layout();
As a more complete example, the following code uses applyCss() and layout() to find the width and height of the Button before the Stage has been shown. If either the call to applyCss() or the call to layout() is commented out, the calls to getWidth() and getHeight() will return zero (until some time after the Stage is shown).
@Override
public void start(Stage stage) throws Exception {
Group root = new Group();
Scene scene = new Scene(root);
Button button = new Button("Hello World");
root.getChildren().add(button);
root.applyCss();
root.layout();
double width = button.getWidth();
double height = button.getHeight();
System.out.println(width + ", " + height);
stage.setScene(scene);
stage.show();
}
- Since:
- JavaFX 8.0
setAccessibleRole
public final void setAccessibleRole(AccessibleRole value)
accessibleRole property.- Property description:
- The accessible role for this
Node.The screen reader uses the role of a node to determine the attributes and actions that are supported.
- Default value:
AccessibleRole.NODE- Parameters:
-
value- the value for theaccessibleRoleproperty - Since:
- JavaFX 8u40
- See Also:
getAccessibleRole
public final AccessibleRole getAccessibleRole()
accessibleRole property.- Property description:
- The accessible role for this
Node.The screen reader uses the role of a node to determine the attributes and actions that are supported.
- Default value:
AccessibleRole.NODE- Returns:
- the value of the
accessibleRoleproperty - Since:
- JavaFX 8u40
- See Also:
accessibleRoleProperty
public final ObjectProperty<AccessibleRole> accessibleRoleProperty()
Node. The screen reader uses the role of a node to determine the attributes and actions that are supported.
- Default value:
AccessibleRole.NODE- Returns:
- the
accessibleRoleproperty - Since:
- JavaFX 8u40
- See Also:
setAccessibleRoleDescription
public final void setAccessibleRoleDescription(String value)
accessibleRoleDescription property.- Property description:
- The role description of this
Node.Normally, when a role is provided for a node, the screen reader speaks the role as well as the contents of the node. When this value is set, it is possible to override the default. This is useful because the set of roles is predefined. For example, it is possible to set the role of a node to be a button, but have the role description be arbitrary text.
- Default value:
- null
- Parameters:
-
value- the value for theaccessibleRoleDescriptionproperty - Since:
- JavaFX 8u40
- See Also:
getAccessibleRoleDescription
public final String getAccessibleRoleDescription()
accessibleRoleDescription property.- Property description:
- The role description of this
Node.Normally, when a role is provided for a node, the screen reader speaks the role as well as the contents of the node. When this value is set, it is possible to override the default. This is useful because the set of roles is predefined. For example, it is possible to set the role of a node to be a button, but have the role description be arbitrary text.
- Default value:
- null
- Returns:
- the value of the
accessibleRoleDescriptionproperty - Since:
- JavaFX 8u40
- See Also:
accessibleRoleDescriptionProperty
public final ObjectProperty<String> accessibleRoleDescriptionProperty()
Node. Normally, when a role is provided for a node, the screen reader speaks the role as well as the contents of the node. When this value is set, it is possible to override the default. This is useful because the set of roles is predefined. For example, it is possible to set the role of a node to be a button, but have the role description be arbitrary text.
- Default value:
- null
- Returns:
- the role description of this
Node. - Since:
- JavaFX 8u40
- See Also:
setAccessibleText
public final void setAccessibleText(String value)
accessibleText property.- Property description:
- The accessible text for this
Node.This property is used to set the text that the screen reader will speak. If a node normally speaks text, that text is overriden. For example, a button usually speaks using the text in the control but will no longer do this when this value is set.
- Default value:
- null
- Parameters:
-
value- the value for theaccessibleTextproperty - Since:
- JavaFX 8u40
- See Also:
getAccessibleText
public final String getAccessibleText()
accessibleText property.- Property description:
- The accessible text for this
Node.This property is used to set the text that the screen reader will speak. If a node normally speaks text, that text is overriden. For example, a button usually speaks using the text in the control but will no longer do this when this value is set.
- Default value:
- null
- Returns:
- the value of the
accessibleTextproperty - Since:
- JavaFX 8u40
- See Also:
accessibleTextProperty
public final ObjectProperty<String> accessibleTextProperty()
Node. This property is used to set the text that the screen reader will speak. If a node normally speaks text, that text is overriden. For example, a button usually speaks using the text in the control but will no longer do this when this value is set.
- Default value:
- null
- Returns:
- accessible text for this
Node. - Since:
- JavaFX 8u40
- See Also:
setAccessibleHelp
public final void setAccessibleHelp(String value)
accessibleHelp property.- Property description:
- The accessible help text for this
Node.The help text provides a more detailed description of the accessible text for a node. By default, if the node has a tool tip, this text is used.
- Default value:
- null
- Parameters:
-
value- the value for theaccessibleHelpproperty - Since:
- JavaFX 8u40
- See Also:
getAccessibleHelp
public final String getAccessibleHelp()
accessibleHelp property.- Property description:
- The accessible help text for this
Node.The help text provides a more detailed description of the accessible text for a node. By default, if the node has a tool tip, this text is used.
- Default value:
- null
- Returns:
- the value of the
accessibleHelpproperty - Since:
- JavaFX 8u40
- See Also:
accessibleHelpProperty
public final ObjectProperty<String> accessibleHelpProperty()
Node. The help text provides a more detailed description of the accessible text for a node. By default, if the node has a tool tip, this text is used.
- Default value:
- null
- Returns:
- the accessible help text for this
Node. - Since:
- JavaFX 8u40
- See Also:
queryAccessibleAttribute
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
This method is commonly overridden by subclasses to implement attributes that are required for a specific role.
If a particular attribute is not handled, the superclass implementation must be called.
- Parameters:
-
attribute- the requested attribute -
parameters- optional list of parameters - Returns:
- the value for the requested attribute
- Since:
- JavaFX 8u40
- See Also:
executeAccessibleAction
public void executeAccessibleAction(AccessibleAction action, Object... parameters)
This method is commonly overridden by subclasses to implement action that are required for a specific role.
If a particular action is not handled, the superclass implementation must be called.
- Parameters:
-
action- the action to execute -
parameters- optional list of parameters - Since:
- JavaFX 8u40
- See Also:
notifyAccessibleAttributeChanged
public final void notifyAccessibleAttributeChanged(AccessibleAttribute attributes)
- Parameters:
-
attributes- the attribute whose value has changed - Since:
- JavaFX 8u40
- See Also:
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.