org.controlsfx.control

Class GridView<T>

java.lang.Object

javafx.scene.Node

javafx.scene.Parent

javafx.scene.layout.Region

javafx.scene.control.Control

org.controlsfx.control.GridView<T>

All Implemented Interfaces:

javafx.css.Styleable, EventTarget, Skinnable

public class GridView<T>
extends Control

A GridView is a virtualised control for displaying getItems() in a visual, scrollable, grid-like fashion. In other words, whereas a ListView shows one ListCell per row, in a GridView there will be zero or more GridCell instances on a single row.

This approach means that the number of GridCell instances instantiated will be a significantly smaller number than the number of items in the GridView items list, as only enough GridCells are created for the visible area of the GridView. This helps to improve performance and reduce memory consumption.

Because each GridCell extends from Cell, the same approach of cell factories that is taken in other UI controls is also taken in GridView. This has two main benefits:

1. GridCells are created on demand and without user involvement,
2. GridCells can be arbitrarily complex. A simple GridCell may just have its text property set, whereas a more complex GridCell can have an arbitrarily complex scenegraph set inside its graphic property (as it accepts any Node).

Examples

The following screenshot shows the GridView with the ColorGridCell being used:

To create this GridView was simple. Note that the majority of the code below is related to randomly creating the colours to be represented:

 
 GridView<Color> myGrid = new GridView<>(list);
 myGrid.setCellFactory(new Callback<GridView<Color>, GridCell<Color>>() {
     public GridCell<Color> call(GridView<Color> gridView) {
         return new ColorGridCell();
     }
 });
 Random r = new Random(System.currentTimeMillis());
 for(int i = 0; i < 500; i++) {
     list.add(new Color(r.nextDouble(), r.nextDouble(), r.nextDouble(), 1.0));
 }
 

See Also:

GridCell

Property Summary

Type	Property and Description
ObjectProperty<Callback<GridView<T>,GridCell<T>>>	cellFactory Property representing the cell factory that is currently set in this GridView, or null if no cell factory has been set (in which case the default cell factory provided by the GridView skin will be used).
DoubleProperty	cellHeight Property representing the height that all cells should be.
DoubleProperty	cellWidth Property representing the width that all cells should be.
DoubleProperty	horizontalCellSpacing Property for specifying how much spacing there is between each cell in a row (i.e.
ObjectProperty<ObservableList<T>>	items The items to be displayed in the GridView (as rendered via GridCell instances).
DoubleProperty	verticalCellSpacing Property for specifying how much spacing there is between each cell in a column (i.e.

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

Constructor Summary

Constructors

Constructor and Description
GridView() Creates a default, empty GridView control.
GridView(ObservableList<T> items) Creates a default GridView control with the provided items prepopulated.

Method Summary

Modifier and Type	Method and Description
ObjectProperty<Callback<GridView<T>,GridCell<T>>>	cellFactoryProperty() Property representing the cell factory that is currently set in this GridView, or null if no cell factory has been set (in which case the default cell factory provided by the GridView skin will be used).
DoubleProperty	cellHeightProperty() Property representing the height that all cells should be.
DoubleProperty	cellWidthProperty() Property representing the width that all cells should be.
protected Skin<?>	createDefaultSkin()
Callback<GridView<T>,GridCell<T>>	getCellFactory() Returns the cell factory that will be used to create GridCell instances to show in the GridView.
double	getCellHeight() Returns the height that all cells should be.
double	getCellWidth() Returns the width that all cells should be.
static List<javafx.css.CssMetaData<? extends javafx.css.Styleable,?>>	getClassCssMetaData()
List<javafx.css.CssMetaData<? extends javafx.css.Styleable,?>>	getControlCssMetaData()
double	getHorizontalCellSpacing() Returns the amount of horizontal spacing there is between cells in the same row.
ObservableList<T>	getItems() Returns the currently-in-use items list that is being used by the GridView.
protected String	getUserAgentStylesheet()
double	getVerticalCellSpacing() Returns the amount of vertical spacing there is between cells in the same column.
DoubleProperty	horizontalCellSpacingProperty() Property for specifying how much spacing there is between each cell in a row (i.e.
ObjectProperty<ObservableList<T>>	itemsProperty() The items to be displayed in the GridView (as rendered via GridCell instances).
void	setCellFactory(Callback<GridView<T>,GridCell<T>> value) Sets the cell factory to use to create GridCell instances to show in the GridView.
void	setCellHeight(double value) Sets the height that all cells should be.
void	setCellWidth(double value) Sets the width that all cells should be.
void	setHorizontalCellSpacing(double value) Sets the amount of horizontal spacing there should be between cells in the same row.
void	setItems(ObservableList<T> value) Sets a new ObservableList as the items list underlying GridView.
void	setVerticalCellSpacing(double value) Sets the amount of vertical spacing there should be between cells in the same column.
DoubleProperty	verticalCellSpacingProperty() Property for specifying how much spacing there is between each cell in a column (i.e.

Methods inherited from class javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, 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

Methods inherited from class javafx.scene.Node

addEventFilter, addEventHandler, 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

horizontalCellSpacing

public final DoubleProperty horizontalCellSpacingProperty

Property for specifying how much spacing there is between each cell in a row (i.e. how much horizontal spacing there is).

See Also:

getHorizontalCellSpacing(), setHorizontalCellSpacing(double)

verticalCellSpacing

public final DoubleProperty verticalCellSpacingProperty

Property for specifying how much spacing there is between each cell in a column (i.e. how much vertical spacing there is).

See Also:

getVerticalCellSpacing(), setVerticalCellSpacing(double)

cellWidth

public final DoubleProperty cellWidthProperty

Property representing the width that all cells should be.

See Also:

getCellWidth(), setCellWidth(double)

cellHeight

public final DoubleProperty cellHeightProperty

Property representing the height that all cells should be.

See Also:

getCellHeight(), setCellHeight(double)

cellFactory

public final ObjectProperty<Callback<GridView<T>,GridCell<T>>> cellFactoryProperty

Property representing the cell factory that is currently set in this GridView, or null if no cell factory has been set (in which case the default cell factory provided by the GridView skin will be used). The cell factory is used for instantiating enough GridCell instances for the visible area of the GridView. Refer to the GridView class documentation for more information and examples.

See Also:

getCellFactory(), setCellFactory(Callback)

items

public final ObjectProperty<ObservableList<T>> itemsProperty

The items to be displayed in the GridView (as rendered via GridCell instances). For example, if the ColorGridCell were being used (as in the case at the top of this class documentation), this items list would be populated with Color values. It is important to appreciate that the items list is used for the data, not the rendering. What is meant by this is that the items list should contain Color values, not the nodes that represent the Color. The actual rendering should be left up to the cell factory, where it will take the Color value and create / update the display as necessary.

See Also:

getItems(), setItems(ObservableList)

Constructor Detail

GridView

public GridView()

Creates a default, empty GridView control.

GridView

public GridView(ObservableList<T> items)

Creates a default GridView control with the provided items prepopulated.

Parameters:

items - The items to display inside the GridView.

Method Detail

createDefaultSkin

protected Skin<?> createDefaultSkin()

Overrides:

createDefaultSkin in class Control

getUserAgentStylesheet

protected String getUserAgentStylesheet()

Overrides:

getUserAgentStylesheet in class Control

horizontalCellSpacingProperty

public final DoubleProperty horizontalCellSpacingProperty()

Property for specifying how much spacing there is between each cell in a row (i.e. how much horizontal spacing there is).

See Also:

getHorizontalCellSpacing(), setHorizontalCellSpacing(double)

setHorizontalCellSpacing

public final void setHorizontalCellSpacing(double value)

Sets the amount of horizontal spacing there should be between cells in the same row.

Parameters:

value - The amount of spacing to use.

getHorizontalCellSpacing

public final double getHorizontalCellSpacing()

Returns the amount of horizontal spacing there is between cells in the same row.

verticalCellSpacingProperty

public final DoubleProperty verticalCellSpacingProperty()

Property for specifying how much spacing there is between each cell in a column (i.e. how much vertical spacing there is).

See Also:

getVerticalCellSpacing(), setVerticalCellSpacing(double)

setVerticalCellSpacing

public final void setVerticalCellSpacing(double value)

Sets the amount of vertical spacing there should be between cells in the same column.

Parameters:

value - The amount of spacing to use.

getVerticalCellSpacing

public final double getVerticalCellSpacing()

Returns the amount of vertical spacing there is between cells in the same column.

cellWidthProperty

public final DoubleProperty cellWidthProperty()

Property representing the width that all cells should be.

See Also:

getCellWidth(), setCellWidth(double)

setCellWidth

public final void setCellWidth(double value)

Sets the width that all cells should be.

getCellWidth

public final double getCellWidth()

Returns the width that all cells should be.

cellHeightProperty

public final DoubleProperty cellHeightProperty()

Property representing the height that all cells should be.

See Also:

getCellHeight(), setCellHeight(double)

setCellHeight

public final void setCellHeight(double value)

Sets the height that all cells should be.

getCellHeight

public final double getCellHeight()

Returns the height that all cells should be.

cellFactoryProperty

public final ObjectProperty<Callback<GridView<T>,GridCell<T>>> cellFactoryProperty()

Property representing the cell factory that is currently set in this GridView, or null if no cell factory has been set (in which case the default cell factory provided by the GridView skin will be used). The cell factory is used for instantiating enough GridCell instances for the visible area of the GridView. Refer to the GridView class documentation for more information and examples.

See Also:

getCellFactory(), setCellFactory(Callback)

setCellFactory

public final void setCellFactory(Callback<GridView<T>,GridCell<T>> value)

Sets the cell factory to use to create GridCell instances to show in the GridView.

getCellFactory

public final Callback<GridView<T>,GridCell<T>> getCellFactory()

Returns the cell factory that will be used to create GridCell instances to show in the GridView.

itemsProperty

public final ObjectProperty<ObservableList<T>> itemsProperty()

The items to be displayed in the GridView (as rendered via GridCell instances). For example, if the ColorGridCell were being used (as in the case at the top of this class documentation), this items list would be populated with Color values. It is important to appreciate that the items list is used for the data, not the rendering. What is meant by this is that the items list should contain Color values, not the nodes that represent the Color. The actual rendering should be left up to the cell factory, where it will take the Color value and create / update the display as necessary.

See Also:

getItems(), setItems(ObservableList)

setItems

public final void setItems(ObservableList<T> value)

Sets a new ObservableList as the items list underlying GridView. The old items list will be discarded.

getItems

public final ObservableList<T> getItems()

Returns the currently-in-use items list that is being used by the GridView.

getClassCssMetaData

public static List<javafx.css.CssMetaData<? extends javafx.css.Styleable,?>> getClassCssMetaData()

Returns:

The CssMetaData associated with this class, which may include the CssMetaData of its super classes.

getControlCssMetaData

public List<javafx.css.CssMetaData<? extends javafx.css.Styleable,?>> getControlCssMetaData()

Overrides:

getControlCssMetaData in class Control