CharmListView (Gluon Mobile 4.3.4 API)

java.lang.Object
- javafx.scene.Node
- - javafx.scene.Parent
  - - javafx.scene.layout.Region
    - - javafx.scene.control.Control
      - com.gluonhq.charm.glisten.control.CharmListView<T,K>

Type Parameters:

T - This type is used to represent the type of the objects stored in the CharmListViews items ObservableList.

K - This is type returned by the headers function when applied to the items to generate the keys in a sorted map that will define the headers. It extends Comparable, so elements can have a natural order, without the need to specify a comparator. usually one field of T, so the CharmListView control can differ headers for the list by applying a Function over the elements.

All Implemented Interfaces:

javafx.css.Styleable, javafx.event.EventTarget, javafx.scene.control.Skinnable
```
@DefaultProperty(value="items")
public class CharmListView<T,K extends java.lang.Comparable>
extends javafx.scene.control.Control
```
A CharmListView displays a vertical list of items from which the user may select, while new items are inserted as headers, as a result of applying over the underlying model a header function. Headers can be seen as the keys in a sorted map, that once defined are used to classify the items. For every category, the first item is duplicated and marked as header. Different formatting and sorting options can be applied to the header items so they can be distinguised from the standard items. By default the header for the top most visible item is displayed floating on top of the list, and it is replaced with the next one when the list is scrolled with a slide out effect. The control uses internally a HeadersList class: an ObservableList that wraps a SortedList and the headers created by the header function.
Populating a CharmListView

A simple example of how to create and populate a CharmListView of names (Strings) ordered and classified by their number of letters is shown here:
```
 
 ObservableList<String> names = FXCollections.observableArrayList(
          "Julia", "Ian", "Sue", "Matthew", "Hannah", "Stephan", "Denise");
 
 CharmListView<String, Integer> charmListView = new CharmListView<>(names);
 charmListView.setHeadersFunction(String::length);
 
```
Another feasible approach for setting the items is to simply call:
```
 
 ObservableList<T> content = ...
 charmListView.setItems(content);
 
```
The elements of the CharmListView are contained within the items ObservableList. This ObservableList is automatically observed by the CharmListView, such that any changes that occur inside the ObservableList will be automatically shown in the CharmListView itself and, consequently, headers will be updated too.
Formatting the Headers of a CharmListView

Following with the previous example, now a cell factory for the headers will be provided:
```
  charmListView.setHeaderCellFactory( p->new ListCellImpl<String>(){
       @Override protected void updateItem(String item, boolean empty) {
          super.updateItem(item, empty);
          if(item!=null && !empty){
              setText("Length: " + Integer.toString(item.length()));
              setGraphic(null);
          } else {
              setText(null);
              setGraphic(null);
           }
       }
  });
 
```
The same result could be achieved by providing a StringConverter to the function:
```
  charmListView.setConverter(new StringConverter <Integer>() {
      @Override public String toString(Integer object) {
          return "Length: " + Integer.toString(object);
      }
  });
 
```
and calling toString on the header cell factory updateItem:
```
 
  setText(charmListView.toString(item));
 
```
Sorting headers and items
There are two type of comparators that can be added to a CharmListView to sort the items: comparatorProperty() for the standard items, and headersComparatorProperty() for the header items. For instance, this comparator will reverse the natural order for the cells within headers:
```
  charmListView.setComparator((s1,s2)->s2.compareTo(s1)); 
 
 {"3", "Sue", "Ian", "5", "Julia", "6", "Hannah", "Denise", "7", "Stephan", "Matthew"}
 
```
If no comparator is provided, the cells will be placed in the same order they were provided. This will reverse the order on the headers, while sorting by natural order on the standard cells:
```
 
 charmListView.setHeaderComparator((i1,i2)->i2-i1);
 charmListView.setComparator((s1,s2)->s1.compareTo(s2));
 
 {"7", "Matthew", "Stephan", "6", "Denise", "Hannah", "5", "Julia", "3", "Ian", "Sue"}
 
```
Since:

1.0.0

See Also:

CharmListCell

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>>`	`cellFactory` The cell factory for standard items.
`javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>>`	`cellHeaderFactory` The cell factory for header items.
`javafx.beans.property.ObjectProperty<java.util.Comparator<? super T>>`	`comparator` The comparator that denotes the order of the items within the headers.
`javafx.beans.property.ObjectProperty<javafx.util.StringConverter<K>>`	`converter` The `StringConverter` property used to format the result of type K after applying the `headers function` to the data model
`javafx.beans.property.BooleanProperty`	`floatingHeaderVisible` By default the header for the most top visible item is displayed floating on top of the list, and it is replaced with the next one when the list is scrolled with a slide out effect.
`javafx.beans.property.ObjectProperty<java.util.Comparator<? super K>>`	`headersComparator` The comparator that denotes the order of the headers.
`javafx.beans.property.ObjectProperty<java.util.function.Function<? super T,K>>`	`headersFunction` The `Function` for the CharmListView.
`javafx.beans.property.ListProperty<T>`	`items` The underlying data model for the CharmListView.
`javafx.beans.property.ObjectProperty<javafx.event.EventHandler<javafx.event.ActionEvent>>`	`onPullToRefresh` The `EventHandler` to be called whenever there's a Swipe Refresh.
`javafx.beans.property.ObjectProperty<javafx.scene.Node>`	`placeholder` This Node is shown to the user when the CharmListView has no content to show.
`javafx.beans.property.BooleanProperty`	`refreshIndicatorVisible` The visibility of a refresh indicator that will signal to the user that this list is busy updating itself.
`javafx.beans.property.ObjectProperty<T>`	`selectedItem` Refers to the selected item property, which is used to indicate the currently selected item in the CharmListView.

Properties inherited from class javafx.scene.control.Control
contextMenu, skinClassName, skin, tooltip

Properties inherited from class javafx.scene.layout.Region
background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width

Properties inherited from class javafx.scene.Parent
impl_traversalEngine, needsLayout

Properties inherited from class javafx.scene.Node
accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, impl_showMnemonics, impl_treeVisible, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, visible

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
`CharmListView()` Creates a default CharmListView which will display contents stacked vertically.
`CharmListView(javafx.collections.ObservableList<T> list)` Creates a default CharmListView which will stack the contents retrieved from the provided `ObservableList` vertically.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>>`	`cellFactoryProperty()` The cell factory for standard items.
`javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>>`	`cellHeaderFactoryProperty()` The cell factory for header items.
`javafx.beans.property.ObjectProperty<java.util.Comparator<? super T>>`	`comparatorProperty()` The comparator that denotes the order of the items within the headers.
`javafx.beans.property.ObjectProperty<javafx.util.StringConverter<K>>`	`converterProperty()` The `StringConverter` property used to format the result of type K after applying the `headers function` to the data model
`protected javafx.scene.control.Skin<?>`	`createDefaultSkin()`
`javafx.beans.property.BooleanProperty`	`floatingHeaderVisibleProperty()` By default the header for the most top visible item is displayed floating on top of the list, and it is replaced with the next one when the list is scrolled with a slide out effect.
`javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>`	`getCellFactory()` Returns the current cell factory callback function for standard items.
`java.util.Comparator<? super T>`	`getComparator()` Returns the `Comparator` that is used to sort the standard items
`javafx.util.StringConverter<K>`	`getConverter()` Returns the `StringConverter` used to format the headers.
`javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>`	`getHeaderCellFactory()` Returns the current cell factory callback function for header items.
`java.util.Comparator<? super K>`	`getHeaderComparator()` Returns the `Comparator` that is used to sort the headers items
`java.util.function.Function<? super T,K>`	`getHeadersFunction()` Returns the `Function` that is used to generate the headers
`javafx.collections.ObservableList<T>`	`getHeadersList()` Returns an `ObservableList` that contains the items currently being shown to the user including the headers.
`javafx.event.EventHandler<javafx.event.ActionEvent>`	`getOnPullToRefresh()` Gets the value of the property onPullToRefresh.
`javafx.scene.Node`	`getPlaceholder()` Returns the `Node` to be shown to the user when the CharmListView has no content to show.
`T`	`getSelectedItem()` Gets the value of the property selectedItem.
`javafx.beans.property.ObjectProperty<java.util.Comparator<? super K>>`	`headersComparatorProperty()` The comparator that denotes the order of the headers.
`javafx.beans.property.ObjectProperty<java.util.function.Function<? super T,K>>`	`headersFunctionProperty()` The `Function` for the CharmListView.
`boolean`	`isFloatingHeaderVisible()` Returns true if the floating header for the most top visible item is visible, or false otherwise.
`boolean`	`isRefreshIndicatorVisible()` Gets the value of the property refreshIndicatorVisible.
`javafx.beans.property.ListProperty<T>`	`itemsProperty()` The underlying data model for the CharmListView.
`javafx.beans.property.ObjectProperty<javafx.event.EventHandler<javafx.event.ActionEvent>>`	`onPullToRefreshProperty()` The `EventHandler` to be called whenever there's a Swipe Refresh.
`javafx.beans.property.ObjectProperty<javafx.scene.Node>`	`placeholderProperty()` This Node is shown to the user when the CharmListView has no content to show.
`void`	`refresh()` Calling `refresh()` forces the CharmListView control to recreate and repopulate the cells necessary to populate the visual bounds of the control.
`javafx.beans.property.BooleanProperty`	`refreshIndicatorVisibleProperty()` The visibility of a refresh indicator that will signal to the user that this list is busy updating itself.
`void`	`scrollTo(T object)` Scrolls the CharmListView so that the given item is the first visible item within the viewport, after the floating header if the latter is visible
`void`	`scrollToHeader(T object)` Scrolls the CharmListView so that the given header is the first visible header within the viewport
`javafx.beans.property.ObjectProperty<T>`	`selectedItemProperty()` Refers to the selected item property, which is used to indicate the currently selected item in the CharmListView.
`void`	`setCellFactory(javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>> value)` Sets a new cell factory to use for the standard items in the CharmListView.
`void`	`setComparator(java.util.Comparator<? super T> comparator)` Sets the comparator for the standard items of the CharmListView.
`void`	`setConverter(javafx.util.StringConverter<K> value)` Sets the `StringConverter` to be used to format the headers
`void`	`setFloatingHeaderVisible(boolean visible)` Sets the visibility of the floating header for the most top visible item.
`void`	`setHeaderCellFactory(javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>> value)` Sets a new cell factory to use for the header items in the CharmListView.
`void`	`setHeaderComparator(java.util.Comparator<? super K> headerComparator)` Sets the comparator for the header items of the CharmListView.
`void`	`setHeadersFunction(java.util.function.Function<? super T,K> function)` Sets the headers function for the CharmListView.
`void`	`setItems(javafx.collections.ObservableList<T> value)` Sets the underlying data model for the CharmListView.
`void`	`setOnPullToRefresh(javafx.event.EventHandler<javafx.event.ActionEvent> eventHandler)` Sets the value of the property onPullToRefresh.
`void`	`setPlaceholder(javafx.scene.Node value)` Sets a `Node` to be shown to the user when the CharmListView has no content to show.
`void`	`setRefreshIndicatorVisible(boolean value)` Sets the value of the property refreshIndicatorVisible.
`void`	`setSelectedItem(T value)` Sets the value of the property selectedItem.
`java.lang.String`	`toString(T item)` A convenient method to format the result of applying the `headers function` to the given item, using the `string converter` if it is provided.

Methods inherited from class javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, executeAccessibleAction, getBaselineOffset, getClassCssMetaData, getContextMenu, getControlCssMetaData, getCssMetaData, getSkin, getTooltip, impl_cssGetFocusTraversableInitialValue, impl_processCSS, isResizable, layoutChildren, queryAccessibleAttribute, 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, getUserAgentStylesheet, 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
accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, 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, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, 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_findStyles, impl_geomChanged, 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, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, 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, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, 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
  - items
```
public final javafx.beans.property.ListProperty<T> itemsProperty
```
    The underlying data model for the CharmListView. Note that it has a generic type that must match the type of the CharmListView itself. CharmListView control reacts to changes in this model.
    
    See Also:
    
    setItems(ObservableList)
  - headersFunction
```
public final javafx.beans.property.ObjectProperty<java.util.function.Function<? super T,K extends java.lang.Comparable>> headersFunctionProperty
```
    The Function for the CharmListView. Note that it has a generic type T that must match the type of the CharmListView itself, and a generic type K that implements Comparable. The provided function will by applied to all the T items, returning elements of type K that will be sorted to obtain the unique keys that define the headers. CharmListView control reacts to changes in this function.
    
    See Also:
    
    getHeadersFunction(), setHeadersFunction(Function)
  - comparator
```
public final javafx.beans.property.ObjectProperty<java.util.Comparator<? super T>> comparatorProperty
```
    The comparator that denotes the order of the items within the headers. This criterion is applied after the header criterion. CharmListView control reacts to changes in this comparator.
    
    See Also:
    
    getComparator(), setComparator(Comparator)
  - headersComparator
```
public final javafx.beans.property.ObjectProperty<java.util.Comparator<? super K extends java.lang.Comparable>> headersComparatorProperty
```
    The comparator that denotes the order of the headers. This criterion is applied in the first place to sort the headers. Note the type K of the comparator: the comparison will be applied of over the result of applying the headers function to the items of the list, and not over the items themselves. CharmListView control reacts to changes in this comparator.
  - converter
```
public final javafx.beans.property.ObjectProperty<javafx.util.StringConverter<K extends java.lang.Comparable>> converterProperty
```
    The StringConverter property used to format the result of type K after applying the headers function to the data model
    
    See Also:
    
    getConverter(), setConverter(StringConverter)
  - cellFactory
```
public final javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K extends java.lang.Comparable>,CharmListCell<T>>> cellFactoryProperty
```
    The cell factory for standard items. Setting a custom cell factory has the effect of deferring all cell creation, allowing for total customization of the cell. Internally, the CharmListView is responsible for reusing CharmListCells - all that is necessary is for the custom cell factory to return from this function a CharmListCell which might be usable for representing any item in the CharmListView. Refer to the Cell class documentation for more detail.
    
    See Also:
    
    getCellFactory(), setCellFactory(Callback)
  - cellHeaderFactory
```
public final javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K extends java.lang.Comparable>,CharmListCell<T>>> cellHeaderFactoryProperty
```
    The cell factory for header items. Setting a custom cell factory has the effect of deferring all cell creation, allowing for total customization of the cell. Internally, the CharmListView is responsible for reusing CharmListCells - all that is necessary is for the custom cell factory to return from this function a CharmListCell which might be usable for representing any item in the CharmListView. Refer to the Cell class documentation for more detail.
  - floatingHeaderVisible
```
public final javafx.beans.property.BooleanProperty floatingHeaderVisibleProperty
```
    By default the header for the most top visible item is displayed floating on top of the list, and it is replaced with the next one when the list is scrolled with a slide out effect. This can be enabled or disabled with this property.
    
    See Also:
    
    isFloatingHeaderVisible(), setFloatingHeaderVisible(boolean)
  - placeholder
```
public final javafx.beans.property.ObjectProperty<javafx.scene.Node> placeholderProperty
```
    This Node is shown to the user when the CharmListView has no content to show. This may be the case because the list model has no data in the first place or that a filter has been applied to the list model, resulting in there being nothing to show the user.
    
    See Also:
    
    getPlaceholder(), setPlaceholder(Node)
  - onPullToRefresh
```
public final javafx.beans.property.ObjectProperty<javafx.event.EventHandler<javafx.event.ActionEvent>> onPullToRefreshProperty
```
    The EventHandler to be called whenever there's a Swipe Refresh. This EventHandler will run on a background thread. To enable pull to refresh set a handler for this property.
    
    See Also:
    
    getOnPullToRefresh(), setOnPullToRefresh(EventHandler)
  - refreshIndicatorVisible
```
public final javafx.beans.property.BooleanProperty refreshIndicatorVisibleProperty
```
    The visibility of a refresh indicator that will signal to the user that this list is busy updating itself.
    
    See Also:
    
    isRefreshIndicatorVisible(), setRefreshIndicatorVisible(boolean)
  - selectedItem
```
public final javafx.beans.property.ObjectProperty<T> selectedItemProperty
```
    Refers to the selected item property, which is used to indicate the currently selected item in the CharmListView. The selected item is either null, to represent that there is no selection, or an Object that is retrieved from the underlying data model of the control the selection model is associated with.
    
    See Also:
    
    getSelectedItem(), setSelectedItem(T)
- Constructor Detail
  - CharmListView
```
public CharmListView()
```
    Creates a default CharmListView which will display contents stacked vertically. An empty ObservableList is created. To add elements to the control the recommended approach is calling setItems(javafx.collections.ObservableList).
    Refer to the CharmListView class documentation for details on the default state of other properties.
  - CharmListView
```
public CharmListView(javafx.collections.ObservableList<T> list)
```
    Creates a default CharmListView which will stack the contents retrieved from the provided ObservableList vertically.
    Refer to the CharmListView class documentation for details on the default state of other properties.
    
    Parameters:
    
    list - An observable list of elements of type T
- Method Detail
  - getHeadersList
```
public final javafx.collections.ObservableList<T> getHeadersList()
```
    Returns an ObservableList that contains the items currently being shown to the user including the headers.
    
    Returns:
    
    An ObservableList containing the items to be shown to the user, including the inserted headers if a Function is provided.
  - setItems
```
public final void setItems(javafx.collections.ObservableList<T> value)
```
    Sets the underlying data model for the CharmListView. Note that it has a generic type that must match the type of the CharmListView itself.
    
    Parameters:
    
    value - An observable list of elements of type T
  - itemsProperty
```
public final javafx.beans.property.ListProperty<T> itemsProperty()
```
    The underlying data model for the CharmListView. Note that it has a generic type that must match the type of the CharmListView itself. CharmListView control reacts to changes in this model.
    
    See Also:
    
    setItems(ObservableList)
  - headersFunctionProperty
```
public final javafx.beans.property.ObjectProperty<java.util.function.Function<? super T,K>> headersFunctionProperty()
```
    The Function for the CharmListView. Note that it has a generic type T that must match the type of the CharmListView itself, and a generic type K that implements Comparable. The provided function will by applied to all the T items, returning elements of type K that will be sorted to obtain the unique keys that define the headers. CharmListView control reacts to changes in this function.
    
    See Also:
    
    getHeadersFunction(), setHeadersFunction(Function)
  - getHeadersFunction
```
public final java.util.function.Function<? super T,K> getHeadersFunction()
```
    Returns the Function that is used to generate the headers
    
    Returns:
    
    The Function used to generate the headers
  - setHeadersFunction
```
public final void setHeadersFunction(java.util.function.Function<? super T,K> function)
```
    Sets the headers function for the CharmListView. Note that it has a generic type T that must match the type of the CharmListView itself, and a generic type K that implements Comparable
    
    Parameters:
    
    function - The Function to generate the headers
  - comparatorProperty
```
public final javafx.beans.property.ObjectProperty<java.util.Comparator<? super T>> comparatorProperty()
```
    The comparator that denotes the order of the items within the headers. This criterion is applied after the header criterion. CharmListView control reacts to changes in this comparator.
    
    See Also:
    
    getComparator(), setComparator(Comparator)
  - getComparator
```
public final java.util.Comparator<? super T> getComparator()
```
    Returns the Comparator that is used to sort the standard items
    
    Returns:
    
    The Comparator used to sort the standard items
  - setComparator
```
public final void setComparator(java.util.Comparator<? super T> comparator)
```
    Sets the comparator for the standard items of the CharmListView. Note that it has a generic type T that must match the type of the CharmListView itself.
    
    Parameters:
    
    comparator - The Comparator used to sort the standard items
  - headersComparatorProperty
```
public final javafx.beans.property.ObjectProperty<java.util.Comparator<? super K>> headersComparatorProperty()
```
    The comparator that denotes the order of the headers. This criterion is applied in the first place to sort the headers. Note the type K of the comparator: the comparison will be applied of over the result of applying the headers function to the items of the list, and not over the items themselves. CharmListView control reacts to changes in this comparator.
  - getHeaderComparator
```
public final java.util.Comparator<? super K> getHeaderComparator()
```
    Returns the Comparator that is used to sort the headers items
    
    Returns:
    
    The Comparator used to sort the headers items
  - setHeaderComparator
```
public final void setHeaderComparator(java.util.Comparator<? super K> headerComparator)
```
    Sets the comparator for the header items of the CharmListView. Note that it has a generic type K, since the comparator is applied over the result of applying the headers function to the items of the list, and not over the items themselves.
    
    Parameters:
    
    headerComparator - The Comparator used to sort the header items
  - converterProperty
```
public final javafx.beans.property.ObjectProperty<javafx.util.StringConverter<K>> converterProperty()
```
    The StringConverter property used to format the result of type K after applying the headers function to the data model
    
    See Also:
    
    getConverter(), setConverter(StringConverter)
  - setConverter
```
public final void setConverter(javafx.util.StringConverter<K> value)
```
    Sets the StringConverter to be used to format the headers
    
    Parameters:
    
    value - The StringConverter used to format the headers
  - getConverter
```
public final javafx.util.StringConverter<K> getConverter()
```
    Returns the StringConverter used to format the headers.
    
    Returns:
    
    The StringConverter used to format the headers
  - setCellFactory
```
public final void setCellFactory(javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>> value)
```
    Sets a new cell factory to use for the standard items in the CharmListView. This forces all old CharmListCell's to be thrown away, and new CharmListCell's created with the new cell factory. In order to specialize the Cell used for the CharmListView on standard items, an implementation of the cellFactory callback function defined on the CharmListView must be provided, taking care of creating a new Cell instance and configuring that Cell such that it reacts to changes in its state. It is convenient the use of anonymous inner classes, that simply return instances of CharmListCell whenever it is called, overriding the updateItem method.
    
    Parameters:
    
    value - The cell factory callback function to create standard CharmListCells.
  - getCellFactory
```
public final javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>> getCellFactory()
```
    Returns the current cell factory callback function for standard items.
    
    Returns:
    
    The cell factory callback function used to create standard CharmListCells.
  - cellFactoryProperty
```
public final javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>> cellFactoryProperty()
```
    The cell factory for standard items. Setting a custom cell factory has the effect of deferring all cell creation, allowing for total customization of the cell. Internally, the CharmListView is responsible for reusing CharmListCells - all that is necessary is for the custom cell factory to return from this function a CharmListCell which might be usable for representing any item in the CharmListView. Refer to the Cell class documentation for more detail.
    
    See Also:
    
    getCellFactory(), setCellFactory(Callback)
  - setHeaderCellFactory
```
public final void setHeaderCellFactory(javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>> value)
```
    Sets a new cell factory to use for the header items in the CharmListView. This forces all old CharmListCell's to be thrown away, and new CharmListCell's created with the new cell factory. In order to specialize the Cell used for the CharmListView on header items, an implementation of the cellFactory callback function defined on the CharmListView must be provided, taking care of creating a new Cell instance and configuring that Cell such that it reacts to changes in its state. It is convenient the use of anonymous inner classes, that simply return instances of CharmListCell whenever it is called, overriding the updateItem method.
    
    Parameters:
    
    value - The cell factory callback function to create header CharmListCells.
  - getHeaderCellFactory
```
public final javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>> getHeaderCellFactory()
```
    Returns the current cell factory callback function for header items.
    
    Returns:
    
    The cell factory callback function used to create header CharmListCells.
  - cellHeaderFactoryProperty
```
public final javafx.beans.property.ObjectProperty<javafx.util.Callback<CharmListView<T,K>,CharmListCell<T>>> cellHeaderFactoryProperty()
```
    The cell factory for header items. Setting a custom cell factory has the effect of deferring all cell creation, allowing for total customization of the cell. Internally, the CharmListView is responsible for reusing CharmListCells - all that is necessary is for the custom cell factory to return from this function a CharmListCell which might be usable for representing any item in the CharmListView. Refer to the Cell class documentation for more detail.
  - setFloatingHeaderVisible
```
public final void setFloatingHeaderVisible(boolean visible)
```
    Sets the visibility of the floating header for the most top visible item. By default it will be displayed floating on top of the list, and it will be replaced with the next header when the list is scrolled, with a slide out effect.
    
    Parameters:
    
    visible - Boolean parameter to set the floating header visible or not
  - isFloatingHeaderVisible
```
public final boolean isFloatingHeaderVisible()
```
    Returns true if the floating header for the most top visible item is visible, or false otherwise.
    
    Returns:
    
    boolean parameter with the visibility of the floating header
  - floatingHeaderVisibleProperty
```
public final javafx.beans.property.BooleanProperty floatingHeaderVisibleProperty()
```
    By default the header for the most top visible item is displayed floating on top of the list, and it is replaced with the next one when the list is scrolled with a slide out effect. This can be enabled or disabled with this property.
    
    See Also:
    
    isFloatingHeaderVisible(), setFloatingHeaderVisible(boolean)
  - placeholderProperty
```
public final javafx.beans.property.ObjectProperty<javafx.scene.Node> placeholderProperty()
```
    This Node is shown to the user when the CharmListView has no content to show. This may be the case because the list model has no data in the first place or that a filter has been applied to the list model, resulting in there being nothing to show the user.
    
    See Also:
    
    getPlaceholder(), setPlaceholder(Node)
  - setPlaceholder
```
public final void setPlaceholder(javafx.scene.Node value)
```
    Sets a Node to be shown to the user when the CharmListView has no content to show.
    
    Parameters:
    
    value - A Node for the place holder
  - getPlaceholder
```
public final javafx.scene.Node getPlaceholder()
```
    Returns the Node to be shown to the user when the CharmListView has no content to show.
    
    Returns:
    
    The Node used on the place holder
  - onPullToRefreshProperty
```
public final javafx.beans.property.ObjectProperty<javafx.event.EventHandler<javafx.event.ActionEvent>> onPullToRefreshProperty()
```
    The EventHandler to be called whenever there's a Swipe Refresh. This EventHandler will run on a background thread. To enable pull to refresh set a handler for this property.
    
    See Also:
    
    getOnPullToRefresh(), setOnPullToRefresh(EventHandler)
  - setOnPullToRefresh
```
public final void setOnPullToRefresh(javafx.event.EventHandler<javafx.event.ActionEvent> eventHandler)
```
    Sets the value of the property onPullToRefresh.
    
    Property description:
    
    The EventHandler to be called whenever there's a Swipe Refresh. This EventHandler will run on a background thread. To enable pull to refresh set a handler for this property.
  - getOnPullToRefresh
```
public final javafx.event.EventHandler<javafx.event.ActionEvent> getOnPullToRefresh()
```
    Gets the value of the property onPullToRefresh.
    
    Property description:
    
    The EventHandler to be called whenever there's a Swipe Refresh. This EventHandler will run on a background thread. To enable pull to refresh set a handler for this property.
  - refreshIndicatorVisibleProperty
```
public final javafx.beans.property.BooleanProperty refreshIndicatorVisibleProperty()
```
    The visibility of a refresh indicator that will signal to the user that this list is busy updating itself.
    
    See Also:
    
    isRefreshIndicatorVisible(), setRefreshIndicatorVisible(boolean)
  - setRefreshIndicatorVisible
```
public final void setRefreshIndicatorVisible(boolean value)
```
    Sets the value of the property refreshIndicatorVisible.
    
    Property description:
    
    The visibility of a refresh indicator that will signal to the user that this list is busy updating itself.
  - isRefreshIndicatorVisible
```
public final boolean isRefreshIndicatorVisible()
```
    Gets the value of the property refreshIndicatorVisible.
    
    Property description:
    
    The visibility of a refresh indicator that will signal to the user that this list is busy updating itself.
  - selectedItemProperty
```
public final javafx.beans.property.ObjectProperty<T> selectedItemProperty()
```
    Refers to the selected item property, which is used to indicate the currently selected item in the CharmListView. The selected item is either null, to represent that there is no selection, or an Object that is retrieved from the underlying data model of the control the selection model is associated with.
    
    See Also:
    
    getSelectedItem(), setSelectedItem(T)
  - getSelectedItem
```
public final T getSelectedItem()
```
    Gets the value of the property selectedItem.
    
    Property description:
    
    Refers to the selected item property, which is used to indicate the currently selected item in the CharmListView. The selected item is either null, to represent that there is no selection, or an Object that is retrieved from the underlying data model of the control the selection model is associated with.
  - setSelectedItem
```
public final void setSelectedItem(T value)
```
    Sets the value of the property selectedItem.
    
    Property description:
    
    Refers to the selected item property, which is used to indicate the currently selected item in the CharmListView. The selected item is either null, to represent that there is no selection, or an Object that is retrieved from the underlying data model of the control the selection model is associated with.
  - scrollTo
```
public void scrollTo(T object)
```
    Scrolls the CharmListView so that the given item is the first visible item within the viewport, after the floating header if the latter is visible
    
    Parameters:
    
    object - The object that should be visible to the user.
  - scrollToHeader
```
public void scrollToHeader(T object)
```
    Scrolls the CharmListView so that the given header is the first visible header within the viewport
    
    Parameters:
    
    object - The header that should be visible to the user.
  - toString
```
public java.lang.String toString(T item)
```
    A convenient method to format the result of applying the headers function to the given item, using the string converter if it is provided.
    
    Parameters:
    
    item - to apply the headers function and format with the string converter
    
    Returns:
    
    A String with the formatted result
  - refresh
```
public void refresh()
```
    Calling refresh() forces the CharmListView control to recreate and repopulate the cells necessary to populate the visual bounds of the control. In other words, this forces the CharmListView to update what it is showing to the user. This is useful in cases where the underlying data source has changed in a way that is not observed by the CharmListView itself.
    
    Since:
    
    3.1.0
  - createDefaultSkin
```
protected javafx.scene.control.Skin<?> createDefaultSkin()
```
    Overrides:
    
    createDefaultSkin in class javafx.scene.control.Control

Class CharmListView<T,K extends java.lang.Comparable>

Populating a CharmListView

Formatting the Headers of a CharmListView

Sorting headers and items

Property Summary

Properties inherited from class javafx.scene.control.Control

Properties inherited from class javafx.scene.layout.Region

Properties inherited from class javafx.scene.Parent

Properties inherited from class javafx.scene.Node

Field Summary

Fields inherited from class javafx.scene.layout.Region

Fields inherited from class javafx.scene.Node

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.control.Control

Methods inherited from class javafx.scene.layout.Region

Methods inherited from class javafx.scene.Parent

Methods inherited from class javafx.scene.Node

Methods inherited from class java.lang.Object

Property Detail

items

headersFunction

comparator

headersComparator

converter

cellFactory

cellHeaderFactory

floatingHeaderVisible

placeholder

onPullToRefresh

refreshIndicatorVisible

selectedItem

Constructor Detail

CharmListView

CharmListView

Method Detail

getHeadersList

setItems

itemsProperty

headersFunctionProperty

getHeadersFunction

setHeadersFunction

comparatorProperty

getComparator

setComparator

headersComparatorProperty

getHeaderComparator

setHeaderComparator

converterProperty

setConverter

getConverter

setCellFactory

getCellFactory

cellFactoryProperty

setHeaderCellFactory

getHeaderCellFactory

cellHeaderFactoryProperty

setFloatingHeaderVisible

isFloatingHeaderVisible

floatingHeaderVisibleProperty

placeholderProperty

setPlaceholder

getPlaceholder

onPullToRefreshProperty

setOnPullToRefresh

getOnPullToRefresh

refreshIndicatorVisibleProperty

setRefreshIndicatorVisible

isRefreshIndicatorVisible

selectedItemProperty

getSelectedItem

setSelectedItem

scrollTo

scrollToHeader

toString

refresh

createDefaultSkin