ListView
Inherits from: Control > Parent > Resizable > TextOffsets > Node
Overview
Displays a horizontal or vertical list of items from which the user may select, or with which the user may interact. A ListView is built from a sequence of "items", which may be any type of domain data object. For example, it may be a sequence of Strings, Numbers, or Customers. It can even be a sequence of Nodes, although this is uncommon.
The data model of the ListView is the items sequence. An item in that sequence may be the selectedItem who's index is available via selectedIndex.
The visuals of the ListView can be entirely customized by creating a cellFactory for the ListView. The cellFactory is used for generating the ListCell which will be used to represent some item in the ListView. See the Cell class documentation for a more complete description of how to write custom Cells.
Profile: common
Variable Summary
| name | type | Default Value | description |
|---|---|---|---|
| items | Object |
The data items contained in this ListView. These may be Numbers, Strings, Customers, or other types of objects. The Skin of the ListView is responsible for displaying and/or formatting these items and placing them in Cells. You may specify exactly how these data items are to be represented in the ListView by specifying your own
| |
| vertical | Boolean |
The orientation of the
| |
| pannable | Boolean |
Denotes whether this ListView is pannable by dragging the list items. |
Inherited Variables
Control
| name | type | Default Value | description |
|---|---|---|---|
| skin | Skin |
Skin responsible for rendering this
There is a one-to-one relationship between a
A skin may be null. |
Resizable
| name | type | Default Value | description |
|---|---|---|---|
| width | Number |
The width of the
Any javafx.scene.Node subclass which mixes in
| |
| height | Number |
The height of the
Any javafx.scene.Node subclass which mixes in
|
Node
| name | type | Default Value | description |
|---|---|---|---|
| id | String |
The id of this
| |
| styleClass | String |
A String identifier which can be used to logically group Nodes, specifically for an external style engine. This variable is exactly analogous to the styleClass attribute on an HTML element. | |
| style | String |
A string representation of the CSS style associated with this specific Node. This is exactly analogous to the "style" attribute on an HTML element, but uses the syntax defined in JavaFX CSS. | |
| visible | Boolean | true |
Specifies whether this
|
| cursor | Cursor | null |
Defines the mouse cursor for this
|
| opacity | Number | 1.0 |
Specifies how opaque (that is, solid) the
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 or greater than 1 are clipped to 0 and 1 respectively. On some platforms ImageView might not support opacity variable. |
| clip | Node | null |
Specifies a
For example, you can use an javafx.scene.image.ImageView Node as a mask to represent the Clip. Or you could use one of the geometric shape Nodes such as javafx.scene.shape.Rectangle or javafx.scene.shape.Circle. Or you could use a javafx.scene.text.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: this is a conditional feature. See javafx.runtime.ConditionalFeature#SHAPE_CLIP ConditionalFeature.SHAPE_CLIP for more information. |
| cache | Boolean | false |
A performance hint to the system to indicate that this
|
| cacheHint | CacheHint | CacheHint.DEFAULT |
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
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 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
|
| effect | Effect | null |
Specifies an effect to apply to this
Note: this is a conditional feature. See javafx.runtime.ConditionalFeature#EFFECT ConditionalFeature.EFFECT for more information. |
| disable | Boolean | false |
Sets the individual disabled state of this
|
| pickOnBounds | Boolean | false |
Defines how the picking computation is done for this node when triggered by a
|
| managed | Boolean | true |
Defines whether or not this node's layout will be managed by it's parent. Each parent class follows a strategy for laying out managed children during the scene's layout pass:
If a
|
| layoutX | Number | 0 |
Defines the X coordinate of the translation that is added to the transformed coordinates of this
For example, if
|
| layoutY | Number | 0 |
Defines the Y coordinate of the translation that is added to the transformed coordinates of this
For example, if
|
| layoutInfo | LayoutInfoBase |
Hook for node-specific layout information used by layout containers. If the node is not a child of a container which supports layout info, this variable will be ignored. Note that layoutInfo object literals may be shared across nodes, which means altering the vars in layoutInfo will affect all such nodes. | |
| transforms | Transform | [] |
Defines the sequence of javafx.scene.transform.Transform objects to be applied to this
By default, #layoutBounds is defined as the local bounds with all the transforms in this sequence applied. |
| translateX | Number | 0 |
Defines the X coordinate of the translation that is added to the transformed coordinates of this
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. |
| translateY | Number | 0 |
Defines the Y coordinate of the translation that is added to the transformed coordinates of this
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. |
| translateZ | Number | 0 |
Defines the Z coordinate of the translation that is added to the transformed coordinates of this
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: this is a conditional feature. See javafx.runtime.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D for more information. |
| scaleX | Number | 1.0 |
Defines the factor by which coordinates are scaled about the center of the object along the X axis of this
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. |
| scaleY | Number | 1.0 |
Defines the factor by which coordinates are scaled about the center of the object along the Y axis of this
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. |
| scaleZ | Number | 1.0 |
Defines the factor by which coordinates are scaled about the center of the object along the Z axis of this
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[] sequence. Note: this is a conditional feature. See javafx.runtime.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D for more information. |
| rotate | Number | 0.0 |
Defines the angle of rotation about the
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
|
| rotationAxis | Point3D | Rotate.Z_AXIS |
Defines the axis of rotation of this
Note: this is a conditional feature. See javafx.runtime.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D for more information. |
| blocksMouse | Boolean | false |
If
|
| focusTraversable | Boolean | false |
Specifies whether this
|
