org.controlsfx.control

Class MasterDetailPane

java.lang.Object

javafx.scene.Node

javafx.scene.Parent

javafx.scene.layout.Region

javafx.scene.control.Control

org.controlsfx.control.MasterDetailPane

All Implemented Interfaces:

javafx.css.Styleable, EventTarget, Skinnable

public class MasterDetailPane
extends Control

A master / detail pane is used to display two nodes with a strong relationship to each other. Most of the time the user works with the information displayed in the master node but every once in a while additional information is required and can be made visible via the detail node. By default the detail appears with a short slide-in animation and disappears with a slide-out. This control allows the detail node to be positioned in four different locations (top, bottom, left, or right).

Screenshot

To better describe what a master / detail pane is, please refer to the picture below:

Code Sample

 
 MasterDetailPane pane = new MasterDetailPane();
 pane.setMasterNode(new TableView());
 pane.setDetailNode(new PropertySheet());
 pane.setDetailSide(Side.RIGHT);
 pane.setShowDetailNode(true);
 

Property Summary

Type	Property and Description
BooleanProperty	animated The property used to store the "animated" flag.
ObjectProperty<Node>	detailNode The property used to store the detail node.
ObjectProperty<Side>	detailSide The property used to store the side where the detail node will be shown.
DoubleProperty	dividerPosition Stores the location of the divider.
ObjectProperty<Node>	masterNode The property used to store the master node.
BooleanProperty	showDetailNode The property used to store the visibility of the detail node.

Properties inherited from class javafx.scene.control.Control

contextMenuProperty, skinClassNameProperty, skinProperty, tooltipProperty

Properties inherited from class javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, heightProperty, insetsProperty, maxHeightProperty, maxWidthProperty, minHeightProperty, minWidthProperty, opaqueInsetsProperty, paddingProperty, prefHeightProperty, prefWidthProperty, scaleShapeProperty, shapeProperty, snapToPixelProperty, widthProperty

Properties inherited from class javafx.scene.Parent

impl_traversalEngineProperty, needsLayoutProperty

Properties inherited from class javafx.scene.Node

blendModeProperty, boundsInLocalProperty, boundsInParentProperty, cacheHintProperty, cacheProperty, clipProperty, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, focusedProperty, focusTraversableProperty, hoverProperty, idProperty, impl_showMnemonicsProperty, impl_treeVisibleProperty, inputMethodRequestsProperty, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParentTransformProperty, localToSceneTransformProperty, managedProperty, mouseTransparentProperty, nodeOrientationProperty, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, pickOnBoundsProperty, pressedProperty, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, styleProperty, translateXProperty, translateYProperty, translateZProperty, visibleProperty

Field Summary

Fields inherited from class javafx.scene.layout.Region

USE_COMPUTED_SIZE, USE_PREF_SIZE

Fields inherited from class javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

Constructor Summary

Constructors

Constructor and Description
MasterDetailPane() Constructs a new pane with two placeholder nodes.
MasterDetailPane(Side pos) Constructs a new pane with two placeholder nodes.
MasterDetailPane(Side pos, boolean showDetail) Constructs a new pane with two placeholder nodes.
MasterDetailPane(Side side, Node masterNode, Node detailNode, boolean showDetail) Constructs a new pane.

Method Summary

Modifier and Type	Method and Description
BooleanProperty	animatedProperty() The property used to store the "animated" flag.
protected Skin<?>	createDefaultSkin()
ObjectProperty<Node>	detailNodeProperty() The property used to store the detail node.
ObjectProperty<Side>	detailSideProperty() The property used to store the side where the detail node will be shown.
DoubleProperty	dividerPositionProperty() Stores the location of the divider.
Node	getDetailNode() Returns the value of the detail node property.
Side	getDetailSide() Returns the value of the detail side property.
double	getDividerPosition() Returns the value of the divider position property.
Node	getMasterNode() Returns the value of the master node property.
protected String	getUserAgentStylesheet()
boolean	isAnimated() Returns the value of the "animated" property.
boolean	isShowDetailNode() Returns the value of the "show detail node" property.
ObjectProperty<Node>	masterNodeProperty() The property used to store the master node.
void	setAnimated(boolean animated) Sets the value of the "animated" property.
void	setDetailNode(Node node) Sets the value of the detail node property.
void	setDetailSide(Side side) Sets the value of the detail side property.
void	setDividerPosition(double position) Sets the value of the divider position property.
void	setMasterNode(Node node) Sets the value of the master node property.
void	setShowDetailNode(boolean show) Sets the value of the "show detail node" property.
BooleanProperty	showDetailNodeProperty() The property used to store the visibility of the detail node.

Methods inherited from class javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getClassCssMetaData, getContextMenu, getControlCssMetaData, getCssMetaData, getSkin, getTooltip, impl_cssGetFocusTraversableInitialValue, impl_processCSS, isResizable, layoutChildren, setContextMenu, setSkin, setTooltip, skinClassNameProperty, skinProperty, tooltipProperty

Methods inherited from class javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getWidth, heightProperty, impl_computeContains, impl_computeGeomBounds, impl_computeLayoutBounds, impl_createPeer, impl_notifyLayoutBoundsChanged, impl_pickNodeLocal, impl_updatePeer, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapSize, snapSpace, snapToPixelProperty, widthProperty

Methods inherited from class javafx.scene.Parent

getChildren, getChildrenUnmodifiable, getImpl_traversalEngine, getManagedChildren, getStylesheets, impl_getAllParentStylesheets, impl_processMXNode, impl_traversalEngineProperty, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, requestParentLayout, setImpl_traversalEngine, setNeedsLayout, updateBounds

Methods inherited from class javafx.scene.Node

addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, containsBounds, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, hasProperties, hoverProperty, idProperty, impl_clearDirty, impl_computeIntersects, impl_cssGetCursorInitialValue, impl_geomChanged, impl_getAccessible, impl_getLeafTransform, impl_getMatchingStyles, impl_getPeer, impl_getPivotX, impl_getPivotY, impl_getPivotZ, impl_getStyleMap, impl_hasTransforms, impl_intersects, impl_intersectsBounds, impl_isDirty, impl_isDirtyEmpty, impl_isShowMnemonics, impl_isTreeVisible, impl_layoutBoundsChanged, impl_markDirty, impl_pickNode, impl_processCSS, impl_reapplyCSS, impl_setShowMnemonics, impl_setStyleMap, impl_showMnemonicsProperty, impl_syncPeer, impl_transformsChanged, impl_traverse, impl_treeVisibleProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Property Detail

detailSide

public final ObjectProperty<Side> detailSideProperty

The property used to store the side where the detail node will be shown.

See Also:

getDetailSide(), setDetailSide(Side)

showDetailNode

public final BooleanProperty showDetailNodeProperty

The property used to store the visibility of the detail node.

See Also:

isShowDetailNode(), setShowDetailNode(boolean)

masterNode

public final ObjectProperty<Node> masterNodeProperty

The property used to store the master node.

See Also:

getMasterNode(), setMasterNode(Node)

detailNode

public final ObjectProperty<Node> detailNodeProperty

The property used to store the detail node.

See Also:

getDetailNode(), setDetailNode(Node)

animated

public final BooleanProperty animatedProperty

The property used to store the "animated" flag. If true then the detail node will be shown / hidden with a short slide in / out animation.

See Also:

isAnimated(), setAnimated(boolean)

dividerPosition

public final DoubleProperty dividerPositionProperty

Stores the location of the divider.

See Also:

getDividerPosition(), setDividerPosition(double)

Constructor Detail

MasterDetailPane

public MasterDetailPane(Side side,
                        Node masterNode,
                        Node detailNode,
                        boolean showDetail)

Constructs a new pane.

Parameters:

side - the position where the detail will be shown (top, bottom, left, right)

masterNode - the master node (always visible)

detailNode - the detail node (slides in and out)

showDetail - the initial state of the detail node (shown or hidden)

MasterDetailPane

public MasterDetailPane(Side pos,
                        boolean showDetail)

Constructs a new pane with two placeholder nodes.

Parameters:

pos - the position where the details will be shown (top, bottom, left, right)

showDetail - the initial state of the detail node (shown or hidden)

MasterDetailPane

public MasterDetailPane(Side pos)

Constructs a new pane with two placeholder nodes. The detail node will be shown.

Parameters:

pos - the position where the details will be shown (top, bottom, left, right)

MasterDetailPane

public MasterDetailPane()

Constructs a new pane with two placeholder nodes. The detail node will be shown and to the right of the master node.

Parameters:

pos - the position where the details will be shown (top, bottom, left, right)

Method Detail

createDefaultSkin

protected Skin<?> createDefaultSkin()

Overrides:

createDefaultSkin in class Control

getUserAgentStylesheet

protected String getUserAgentStylesheet()

Overrides:

getUserAgentStylesheet in class Control

detailSideProperty

public final ObjectProperty<Side> detailSideProperty()

The property used to store the side where the detail node will be shown.

See Also:

getDetailSide(), setDetailSide(Side)

getDetailSide

public final Side getDetailSide()

Returns the value of the detail side property.

Returns:

the side where the detail node will be shown (left, right, top, bottom)

setDetailSide

public final void setDetailSide(Side side)

Sets the value of the detail side property.

Parameters:

side - the side where the detail node will be shown (left, right, top, bottom)

showDetailNodeProperty

public final BooleanProperty showDetailNodeProperty()

The property used to store the visibility of the detail node.

See Also:

isShowDetailNode(), setShowDetailNode(boolean)

isShowDetailNode

public final boolean isShowDetailNode()

Returns the value of the "show detail node" property.

Returns:

true if the pane is currently expanded (shows the detail node)

setShowDetailNode

public final void setShowDetailNode(boolean show)

Sets the value of the "show detail node" property.

Parameters:

show - if true the pane will show the detail node

masterNodeProperty

public final ObjectProperty<Node> masterNodeProperty()

The property used to store the master node.

See Also:

getMasterNode(), setMasterNode(Node)

getMasterNode

public final Node getMasterNode()

Returns the value of the master node property.

Returns:

the master node

setMasterNode

public final void setMasterNode(Node node)

Sets the value of the master node property.

Parameters:

node - the new master node

detailNodeProperty

public final ObjectProperty<Node> detailNodeProperty()

The property used to store the detail node.

See Also:

getDetailNode(), setDetailNode(Node)

getDetailNode

public final Node getDetailNode()

Returns the value of the detail node property.

Returns:

the detail node

setDetailNode

public final void setDetailNode(Node node)

Sets the value of the detail node property.

Parameters:

node - the new master node

animatedProperty

public final BooleanProperty animatedProperty()

The property used to store the "animated" flag. If true then the detail node will be shown / hidden with a short slide in / out animation.

See Also:

isAnimated(), setAnimated(boolean)

isAnimated

public final boolean isAnimated()

Returns the value of the "animated" property.

Returns:

true if the detail node will be shown with a short animation (slide in)

setAnimated

public final void setAnimated(boolean animated)

Sets the value of the "animated" property.

Parameters:

animated - if true the detail node will be shown with a short animation (slide in)

dividerPositionProperty

public final DoubleProperty dividerPositionProperty()

Stores the location of the divider.

See Also:

getDividerPosition(), setDividerPosition(double)

getDividerPosition

public final double getDividerPosition()

Returns the value of the divider position property.

Returns:

the position of the divider

setDividerPosition

public final void setDividerPosition(double position)

Sets the value of the divider position property.

Parameters:

position - the new divider position.