Top Description Fields Constructors Methods
javafx.scene

public abstract non-sealed Class Parent

extends Node
Class Inheritance
Known Direct Subclasses
javafx.scene.layout.Region, javafx.scene.Group
Imports
com.sun.javafx.scene.traversal.ParentTraversalEngine, javafx.beans.property.ReadOnlyBooleanProperty, .ReadOnlyBooleanWrapper, javafx.collections.FXCollections, .ListChangeListener.Change, .ObservableList, java.util.ArrayList, .HashSet, .List, .Set, .Collections, com.sun.javafx.util.TempState, .Utils, com.sun.javafx.collections.TrackableObservableList, .VetoableListDecorator, javafx.css.PseudoClass, .Selector, com.sun.javafx.css.StyleManager, com.sun.javafx.geom.BaseBounds, .PickRay, .Point2D, .RectBounds, com.sun.javafx.geom.transform.BaseTransform, .NoninvertibleTransformException, com.sun.javafx.scene.CssFlags, .DirtyBits, .LayoutFlags, .NodeHelper, .ParentHelper, com.sun.javafx.scene.input.PickResultChooser, com.sun.javafx.sg.prism.NGGroup, .NGNode, com.sun.javafx.tk.Toolkit, com.sun.javafx.stage.WindowHelper, javafx.stage.Window
The base class for all nodes that have children in the scene graph.

This class handles all hierarchical scene graph operations, including adding/removing child nodes, marking branches dirty for layout and rendering, picking, bounds calculations, and executing the layout pass on each pulse.

There are two direct concrete Parent subclasses

Since
JavaFX 2.0

Field Summary

Modifier and TypeField and Description
private Node
bottom

private static final int
BOTTOM_INVALID

private BaseBounds
cachedBounds

The cached bounds for the Group.

private boolean
cachedBoundsInvalid

Indicates that the cachedBounds is invalid (or old) and need to be recomputed.

private final ObservableList<Node>
children

private boolean
childrenTriggerPermutation

private final Set<Node>
childSet

private boolean
childSetModified

private Node
currentLayoutChild

It stores the reference to the current child being laid out by its parent.

private Node
currentlyProcessedChild

pack-priv static final int
DIRTY_CHILDREN_THRESHOLD

private ArrayList<Node>
dirtyChildren

This set is used to track all of the children of this group which are dirty.

private int
dirtyChildrenCount

The number of dirty children which bounds haven't been incorporated into the cached bounds yet.

private Node
far

private static final int
FAR_INVALID

private boolean
forceParentLayout

private boolean
geomChanged

pack-priv LayoutFlags
layoutFlag

pack-priv boolean
layoutRoot

Keeps track of whether this node is a layout root.

private Node
left

private static final int
LEFT_INVALID

private double
minHeightCache

private double
minWidthCache

private Node
near

private static final int
NEAR_INVALID

private ReadOnlyBooleanWrapper
needsLayout

Indicates that this Node and its subnodes requires a layout pass on the next pulse.

private boolean
performingLayout

This is used only by CCS in Node.

private int
pgChildrenSize

private double
prefHeightCache

private double
prefWidthCache

private List<Node>
removed

private static final int
REMOVED_CHILDREN_THRESHOLD

Threshold when it's worth to populate list of removed children.

private boolean
removedChildrenOptimizationDisabled

Do not populate list of removed children when its number exceeds threshold, but mark whole parent dirty.

private Node
right

private static final int
RIGHT_INVALID

private boolean
sceneRoot

This field is managed by the Scene, and set on any node which is the root of a Scene.

private boolean
sizeCacheClear

private int
startIdx

private final ObservableList<String>
stylesheets

A ObservableList of string URLs linking to the stylesheets to use with this scene's contents.

private BaseBounds
tmp

private Node
top

private static final int
TOP_INVALID

private ParentTraversalEngine
traversalEngine

private final ObservableList<Node>
unmodifiableChildren

A constant reference to an unmodifiable view of the children, such that every time we ask for an unmodifiable list of children, we don't actually create a new collection and return it.

private List<Node>
unmodifiableManagedChildren

A cached reference to the unmodifiable managed children of this Parent.

private final List<Node>
viewOrderChildren

The viewOrderChildren is a list children sorted in decreasing viewOrder order if it is not empty.

private static final boolean
warnOnAutoMove

Inherited from javafx.scene.Node:
accessibilityPropertiesaccessibleBASELINE_OFFSET_SAME_AS_HEIGHTboundsChangedcssFlagfocusVisiblepseudoClassStatesstyleHelper

Constructor Summary

AccessConstructor and Description
protected
Parent()

Constructs a new Parent.

Method Summary

Modifier and TypeMethod and Description
pack-priv void
childBoundsChanged(Node node)

Called by Node whenever its bounds have changed.

private void
childExcluded(final Node node)

private void
childIncluded(final Node node)

pack-priv void
childVisibilityChanged(Node node)

Called by node whenever the visibility of the node changes.

pack-priv void
clearSizeCache()

protected double

Returns:

the calculated min height
computeMinHeight(double
the width that should be used if min height depends on it
width)

Calculates the min height of this Parent.

protected double

Returns:

the calculated min width
computeMinWidth(double
the height that should be used if min width depends on it
height)

Calculates the minimum width of this Parent.

protected double

Returns:

the calculated preferred height
computePrefHeight(double
the width that should be used if preferred height depends on it
width)

Calculates the preferred height of this Parent.

protected double

Returns:

the calculated preferred width
computePrefWidth(double
the height that should be used if preferred width depends on it
height)

Calculates the preferred width of this Parent.

private void
computeViewOrderChildren()

private void
createCachedBounds(final List<Node> fromNodes)

private boolean
doComputeContains(double localX, double localY)

private BaseBounds
doComputeGeomBounds(BaseBounds bounds, BaseTransform tx)

private NGNode
doCreatePeer()

private List<String>
doGetAllParentStylesheets()

private void
doPickNodeLocal(PickRay pickRay, PickResultChooser result)

Hides javafx.scene.Node.doPickNodeLocal.

private void
doProcessCSS()

Hides javafx.scene.Node.doProcessCSS.

private void
doUpdatePeer()

Hides javafx.scene.Node.doUpdatePeer.

public double

Returns:

baseline offset
getBaselineOffset()

Overrides javafx.scene.Node.getBaselineOffset.

Calculates the baseline offset based on the first managed child.

protected ObservableList<Node>

Returns:

the list of children of this Parent.
getChildren()

Gets the list of children of this Parent.

public ObservableList<Node>

Returns:

read-only access to this parent's children ObservableList
getChildrenUnmodifiable()

Gets the list of children of this Parent as a read-only list.

private BaseBounds
getChildTransformedBounds(Node node, BaseTransform tx, BaseBounds bounds)

protected <
the type of the children nodes
E extends Node> List<E>

Returns:

list of all managed children in this parent
getManagedChildren()

Gets the list of all managed children of this Parent.

private List<Node>
getOrderedChildren()

public final ObservableList<String>

Returns:

the list of stylesheets to use with this Parent
getStylesheets()

Gets an observable list of string URLs linking to the stylesheets to use with this Parent's contents.

private final ParentTraversalEngine
getTraversalEngine()

pack-priv boolean
isConnected()

Overrides javafx.scene.Node.isConnected.

Determines whether this node is connected anywhere in the scene graph.

pack-priv boolean
isCurrentLayoutChild(Node node)

public final boolean
isNeedsLayout()

pack-priv boolean
isPerformingLayout()

pack-priv final boolean
isSceneRoot()

public final void
layout()

Executes a top-down layout pass on the scene graph under this parent.

protected void
layoutChildren()

Invoked during the layout pass to layout the children in this Parent.

public Node
lookup(String
The css selector of the node to find
selector)

Overrides javafx.scene.Node.lookup.

Finds this Node, or the first sub-node, based on the given CSS selector.

pack-priv List<Node>
lookupAll(Selector
the css selector of the nodes to find
selector, List<Node>
the results
results)

Overrides javafx.scene.Node.lookupAll.

Note

This method should never create the results set, let the Node class implementation do this!

pack-priv final void
managedChildChanged()

Called by Node whenever its managed state may have changed, this method will cause the view of managed children to be updated such that it properly includes or excludes this child.

private void
markDirtyLayout(boolean local, boolean forceParentLayout)

pack-priv void
markViewOrderChildrenDirty()

public double
minHeight(double
the width that should be used if minimum height depends on it
width)

Overrides javafx.scene.Node.minHeight.

Returns the node's minimum height for use in layout calculations.

public double
minWidth(double
the height that should be used if minimum width depends on it
height)

Overrides javafx.scene.Node.minWidth.

Returns the node's minimum width for use in layout calculations.

public final ReadOnlyBooleanProperty
needsLayoutProperty()

pack-priv void
nodeResolvedOrientationChanged()

Overrides javafx.scene.Node.nodeResolvedOrientationChanged.

pack-priv final void
notifyManagedChanged()

Overrides javafx.scene.Node.notifyManagedChanged.

Called whenever the "managed" flag has changed.

pack-priv boolean
pickChildrenNode(PickRay pickRay, PickResultChooser result)

public double
prefHeight(double
the width that should be used if preferred height depends on it
width)

Overrides javafx.scene.Node.prefHeight.

Returns the node's preferred height for use in layout calculations.

public double
prefWidth(double
the height that should be used if preferred width depends on it
height)

Overrides javafx.scene.Node.prefWidth.

Returns the node's preferred width for use in layout calculations.

pack-priv void
printSeq(String prefix, List<Node> nodes)

public Object
queryAccessibleAttribute(AccessibleAttribute
the requested attribute
attribute, Object...
optional list of parameters
parameters)

Overrides javafx.scene.Node.queryAccessibleAttribute.

This method is called by the assistive technology to request the value for an attribute.

private void
recomputeBounds()

Recomputes the bounds from scratch and saves the cached bounds.

pack-priv void
releaseAccessible()

Overrides javafx.scene.Node.releaseAccessible.

public void
requestLayout()

Requests a layout pass to be performed before the next scene is rendered.

pack-priv void
requestLayout(boolean forceParentLayout)

A package scope method used by Node and serves as a helper method for requestLayout() (see above).

protected final void
requestParentLayout()

Requests a layout pass of the parent to be performed before the next scene is rendered.

pack-priv void
requestParentLayout(boolean forceParentLayout)

A package scope method used by Node and serves as a helper method for requestParentLayout() (see above).

pack-priv void
scenesChanged(final Scene newScene, final SubScene newSubScene, final Scene oldScene, final SubScene oldSubScene)

Overrides javafx.scene.Node.scenesChanged.

Exists for Parent and LightBase

private void
setChildDirty(final Node node, final boolean dirty)

pack-priv void
setDerivedDepthTest(boolean value)

Overrides javafx.scene.Node.setDerivedDepthTest.

pack-priv void
setLayoutFlag(LayoutFlags flag)

protected final void
setNeedsLayout(boolean value)

private final void
setTraversalEngine(ParentTraversalEngine value)

pack-priv List<Node>
test_getRemoved()

Note

The only user of this method is in unit test: Parent_structure_sync_Test.

pack-priv List<Node>
test_getViewOrderChildren()

Note

The only user of this method is in unit test: Parent_viewOrderChildren_sync_Test.

pack-priv final void
toBack(Node node)

pack-priv final void
toFront(Node node)

protected void
updateBounds()

Overrides javafx.scene.Node.updateBounds.

Updates the bounds of this Parent and its children.

private boolean
updateCachedBounds(final List<Node> dirtyNodes, int remainingDirtyNodes)

pack-priv void
validatePG()

Inherited from javafx.scene.Node:
accessibleHelpPropertyaccessibleRoleDescriptionPropertyaccessibleRolePropertyaccessibleTextPropertyaddEventFilteraddEventHandleralmostZeroapplyCssautosizeblendModePropertyboundedSizeboundsInLocalPropertyboundsInParentPropertybuildEventDispatchChaincacheHintPropertycachePropertyclearDirtyclearInitialCssStateFlagclipPropertycompleteTransitionTimerscomputeAreaInScreencomputeDerivedDepthTestcontainscontainscursorPropertydepthTestPropertydisabledPropertydisablePropertyeffectiveNodeOrientationPropertyeffectPropertyeventDispatcherPropertyexecuteAccessibleActionfindStylesfireEventfocusedPropertyfocusTraversablePropertyfocusVisiblePropertyfocusWithinPropertygetAccessiblegetAccessibleHelpgetAccessibleRolegetAccessibleRoleDescriptiongetAccessibleTextgetBlendModegetBoundsInLocalgetBoundsInParentgetCacheHintgetClassCssMetaDatagetClipgetClipParentgetContentBiasgetCSSFlagsgetCssMetaDatagetCurrentLocalToSceneTransformStategetCursorgetDepthTestgetEffectgetEffectiveNodeOrientationgetEventDispatchergetGeomBoundsgetIdgetInitialCursorgetInitialFocusTraversablegetInputMethodRequestsgetLayoutBoundsgetLayoutXgetLayoutYgetLeafTransformgetLocalBoundsgetLocalToParentTransformgetLocalToParentTransformgetLocalToSceneTransformgetMatchingStylesgetNodeOrientationgetOnContextMenuRequestedgetOnDragDetectedgetOnDragDonegetOnDragDroppedgetOnDragEnteredgetOnDragExitedgetOnDragOvergetOnInputMethodTextChangedgetOnKeyPressedgetOnKeyReleasedgetOnKeyTypedgetOnMouseClickedgetOnMouseDragEnteredgetOnMouseDragExitedgetOnMouseDraggedgetOnMouseDragOvergetOnMouseDragReleasedgetOnMouseEnteredgetOnMouseExitedgetOnMouseMovedgetOnMousePressedgetOnMouseReleasedgetOnRotategetOnRotationFinishedgetOnRotationStartedgetOnScrollgetOnScrollFinishedgetOnScrollStartedgetOnSwipeDowngetOnSwipeLeftgetOnSwipeRightgetOnSwipeUpgetOnTouchMovedgetOnTouchPressedgetOnTouchReleasedgetOnTouchStationarygetOnZoomgetOnZoomFinishedgetOnZoomStartedgetOpacitygetParentgetPeergetPivotXgetPivotYgetPivotZgetPropertiesgetPseudoClassStatesgetRotategetRotationAxisgetScaleXgetScaleYgetScaleZgetScenegetStylegetStyleableParentgetStyleClassgetStyleMapgetSubScenegetTransformedBoundsgetTransformsgetTransitionDefinitionsgetTransitionTimersgetTranslateXgetTranslateYgetTranslateZgetTypeSelectorgetUserDatagetViewOrderhasMirroringhasPropertieshoverPropertyidPropertyindentinputMethodRequestsPropertyintersectsintersectsintersectsintersectsBoundsisCacheisCanReceiveFocusisDerivedDepthTestisDirtyisDisableisDisabledisFocusedisFocusTraversableisFocusVisibleisFocusWithinisHoverisManagedisMouseTransparentisPickOnBoundsisPressedisResizableisShowMnemonicsisTreeShowingisTreeVisibleisVisiblelayoutBoundsChangedlayoutBoundsPropertylayoutXPropertylayoutYPropertylocalBoundsChangedlocalToParentlocalToParentlocalToParentlocalToParentlocalToParentlocalToParentlocalToParentlocalToParentTransformPropertylocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToScenelocalToSceneTransformPropertylocalToScreenlocalToScreenlocalToScreenlocalToScreenlocalToScreenlookupAllmanagedPropertymarkDirtyLayoutBranchmaxHeightmaxWidthmouseTransparentPropertynodeOrientationPropertynodeResolvedOrientationInvalidatednotifyAccessibleAttributeChangednotifyFocusListenersnotifyParentOfBoundsChangenotifyParentsOfInvalidatedCSSonContextMenuRequestedPropertyonDragDetectedPropertyonDragDonePropertyonDragDroppedPropertyonDragEnteredPropertyonDragExitedPropertyonDragOverPropertyonInputMethodTextChangedPropertyonKeyPressedPropertyonKeyReleasedPropertyonKeyTypedPropertyonMouseClickedPropertyonMouseDragEnteredPropertyonMouseDragExitedPropertyonMouseDraggedPropertyonMouseDragOverPropertyonMouseDragReleasedPropertyonMouseEnteredPropertyonMouseExitedPropertyonMouseMovedPropertyonMousePressedPropertyonMouseReleasedPropertyonRotatePropertyonRotationFinishedPropertyonRotationStartedPropertyonScrollFinishedPropertyonScrollPropertyonScrollStartedPropertyonSwipeDownPropertyonSwipeLeftPropertyonSwipeRightPropertyonSwipeUpPropertyonTouchMovedPropertyonTouchPressedPropertyonTouchReleasedPropertyonTouchStationaryPropertyonZoomFinishedPropertyonZoomPropertyonZoomStartedPropertyopacityPropertyparentPropertyparentResolvedOrientationInvalidatedparentToLocalparentToLocalparentToLocalparentToLocalparentToLocalparentToLocalparentToLocalpickNodepickOnBoundsPropertypressedPropertyprocessCSSpseudoClassStateChangedreapplyCSSrecalculateRelativeSizePropertiesrelocateremoveEventFilterremoveEventHandlerrequestFocusrequestFocusTraversalresizeresizeRelocaterotatePropertyrotationAxisPropertyscaleXPropertyscaleYPropertyscaleZPropertyscenePropertysceneToLocalsceneToLocalsceneToLocalsceneToLocalsceneToLocalsceneToLocalsceneToLocalsceneToLocalsceneToLocalsceneToLocalscreenToLocalscreenToLocalscreenToLocalsetAccessibleHelpsetAccessibleRolesetAccessibleRoleDescriptionsetAccessibleTextsetBlendModesetCachesetCacheHintsetClipsetCursorsetDepthTestsetDisablesetDisabledsetEffectsetEventDispatchersetEventHandlersetFocusedsetFocusQuietlysetFocusTraversablesetHoversetIdsetInputMethodRequestssetLayoutXsetLayoutYsetManagedsetMouseTransparentsetNodeOrientationsetOnContextMenuRequestedsetOnDragDetectedsetOnDragDonesetOnDragDroppedsetOnDragEnteredsetOnDragExitedsetOnDragOversetOnInputMethodTextChangedsetOnKeyPressedsetOnKeyReleasedsetOnKeyTypedsetOnMouseClickedsetOnMouseDragEnteredsetOnMouseDragExitedsetOnMouseDraggedsetOnMouseDragOversetOnMouseDragReleasedsetOnMouseEnteredsetOnMouseExitedsetOnMouseMovedsetOnMousePressedsetOnMouseReleasedsetOnRotatesetOnRotationFinishedsetOnRotationStartedsetOnScrollsetOnScrollFinishedsetOnScrollStartedsetOnSwipeDownsetOnSwipeLeftsetOnSwipeRightsetOnSwipeUpsetOnTouchMovedsetOnTouchPressedsetOnTouchReleasedsetOnTouchStationarysetOnZoomsetOnZoomFinishedsetOnZoomStartedsetOpacitysetParentsetPickOnBoundssetPressedsetRotatesetRotationAxissetScaleXsetScaleYsetScaleZsetScenessetShowMnemonicssetStylesetStyleMapsetTranslateXsetTranslateYsetTranslateZsetTreeVisiblesetUserDatasetViewOrdersetVisibleshowMnemonicsPropertysnapshotsnapshotstartDragAndDropstartFullDragstylePropertysyncPeertoBacktoFronttoStringtransformedBoundsChangedtranslateXPropertytranslateYPropertytranslateZPropertytraversetreeVisiblePropertyupdateGeomBoundsupdateLocalToParentTransformupdateTxBoundsusesMirroringviewOrderPropertyvisiblePropertywouldCreateCycle