org.tentackle.fx.component.FxTreeView Maven / Gradle / Ivy
/*
* Tentackle - https://tentackle.org.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
package org.tentackle.fx.component;
import javafx.beans.property.BooleanProperty;
import javafx.beans.property.ReadOnlyBooleanProperty;
import javafx.collections.ObservableList;
import javafx.scene.control.TreeItem;
import javafx.scene.control.TreeView;
import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyEvent;
import org.tentackle.fx.FxComponent;
import org.tentackle.fx.FxContainer;
import org.tentackle.fx.FxUtilities;
import org.tentackle.fx.ModelToViewListener;
import org.tentackle.fx.ValueTranslator;
import org.tentackle.fx.ViewToModelListener;
import org.tentackle.fx.bind.FxComponentBinding;
import org.tentackle.fx.component.delegate.FxTreeViewDelegate;
import org.tentackle.fx.table.FxTableCell;
import org.tentackle.fx.table.FxTreeTableCell;
import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.List;
/**
* Extended TreeView.
*
* @author harald
* @param the type
*/
public class FxTreeView extends TreeView implements FxComponent {
/**
* Creates an empty TreeView.
*
* Refer to the {@link TreeView} class documentation for details on the default state of other properties.
*/
public FxTreeView() {
super();
addEventFilter(KeyEvent.ANY, this::filterDangerousKeys);
}
/**
* Filters dangerous keys.
* Since the TreeViewBehaviour is private, we cannot modify the input map and filter the keys before
* they reach the key event handler.
*
* @param event the key event
*/
protected void filterDangerousKeys(KeyEvent event) {
if (event.getCode() == KeyCode.MULTIPLY) {
// The handler expands all nodes recursively.
// This is dangerous and may cause an out-of-memory in case of node loops!
event.consume();
// Use safe impl instead
if (event.getEventType() == KeyEvent.KEY_PRESSED) {
if (event.isShiftDown()) {
collapseAll();
}
else {
expandAll();
}
}
}
}
/**
* Expands all nodes.
*/
public void expandAll() {
FxUtilities.getInstance().expandAll(getRoot());
}
/**
* Collapses all nodes.
*/
public void collapseAll() {
if (isShowRoot()) {
scrollTo(0);
FxUtilities.getInstance().collapseAll(getRoot());
}
else {
ObservableList> children = getRoot().getChildren();
if (children != null && !children.isEmpty()) {
scrollTo(0);
FxUtilities.getInstance().collapseAll(children);
}
}
}
/**
* Scrolls the view in such a way that the given row is positioned in the center of the visible rows.
*
* @param row the model row index
*/
public void scrollToCentered(int row) {
scrollTo(FxUtilities.getInstance().computeScrollToCentered(this, row));
}
/**
* Gets the displayed items.
*
* @return the items
*/
public List getItems() {
List items = new ArrayList<>();
if (isShowRoot()) {
getItems(items, getRoot());
}
else {
for (TreeItem treeItem : getRoot().getChildren()) {
getItems(items, treeItem);
}
}
return items;
}
private void getItems(List items, TreeItem treeItem) {
items.add(treeItem.getValue());
if (treeItem.isExpanded()) {
for (TreeItem child : treeItem.getChildren()) {
getItems(items, child);
}
}
}
/**
* Gets all tree items.
*
* @return all tree items, whether shown or not
*/
public List> getTreeItems() {
List> items = new ArrayList<>();
if (isShowRoot()) {
getTreeItems(items, getRoot());
}
else {
for (TreeItem treeItem : getRoot().getChildren()) {
getTreeItems(items, treeItem);
}
}
return items;
}
private void getTreeItems(List> items, TreeItem treeItem) {
items.add(treeItem);
for (TreeItem child : treeItem.getChildren()) {
getTreeItems(items, child);
}
}
/**
* Gets the selected items.
*
* @return the selected items
*/
public List getSelectedItems() {
List items = new ArrayList<>();
for (TreeItem treeItem : getSelectionModel().getSelectedItems()) {
items.add(treeItem.getValue());
}
return items;
}
// @wurblet delegate Include $currentDir/fxcomponent.include
////GEN-BEGIN:delegate
private /**/FxTreeViewDelegate/**/ delegate; // @wurblet < Inject ${classname}Delegate
/**
* Creates the delegate.
*
* @return the delegate
*/
protected /**/FxTreeViewDelegate/**/ createDelegate() { // @wurblet < Inject ${classname}Delegate
return new /**/FxTreeViewDelegate/**/(this); // @wurblet < Inject ${classname}Delegate
}
@Override
public /**/FxTreeViewDelegate/**/ getDelegate() { // @wurblet < Inject ${classname}Delegate
if (delegate == null) {
setDelegate(createDelegate());
}
return delegate;
}
/**
* Sets the delegate.
* Useful for application specific needs.
*
* @param delegate the delegate
*/
public void setDelegate(/**/FxTreeViewDelegate/**/ delegate) { // @wurblet < Inject ${classname}Delegate
this.delegate = delegate;
}
// @wurblet component Include $currentDir/component.include
// //GEN-END:delegate
////GEN-BEGIN:component
@Override
public FxContainer getParentContainer() {
return getDelegate().getParentContainer();
}
@Override
public void setValueTranslator(ValueTranslator valueTranslator) {
getDelegate().setValueTranslator(valueTranslator);
}
@Override
public ValueTranslator getValueTranslator() {
return getDelegate().getValueTranslator();
}
@Override
public void invalidateSavedView() {
getDelegate().invalidateSavedView();
}
@Override
public boolean isSavedViewObjectValid() {
return getDelegate().isSavedViewObjectValid();
}
@Override
public V getViewValue() {
return getDelegate().getViewValue();
}
@Override
public void setViewValue(Object value) {
getDelegate().setViewValue(value);
}
@Override
public void setType(Class type) {
getDelegate().setType(type);
}
@Override
public Class getType() {
return getDelegate().getType();
}
@Override
public void setGenericType(Type type) {
getDelegate().setGenericType(type);
}
@Override
public Type getGenericType() {
return getDelegate().getGenericType();
}
@Override
public void updateView() {
getDelegate().updateView();
}
@Override
public void updateModel() {
getDelegate().updateModel();
}
@Override
public void addModelToViewListener(ModelToViewListener listener) {
getDelegate().addModelToViewListener(listener);
}
@Override
public void removeModelToViewListener(ModelToViewListener listener) {
getDelegate().removeModelToViewListener(listener);
}
@Override
public void addViewToModelListener(ViewToModelListener listener) {
getDelegate().addViewToModelListener(listener);
}
@Override
public void removeViewToModelListener(ViewToModelListener listener) {
getDelegate().removeViewToModelListener(listener);
}
@Override
public void setMandatory(boolean mandatory) {
getDelegate().setMandatory(mandatory);
}
@Override
public boolean isMandatory() {
return getDelegate().isMandatory();
}
@Override
public BooleanProperty mandatoryProperty() {
return getDelegate().mandatoryProperty();
}
@Override
public void setBindingPath(String bindingPath) {
getDelegate().setBindingPath(bindingPath);
}
@Override
public String getBindingPath() {
return getDelegate().getBindingPath();
}
@Override
public void setComponentPath(String componentPath) {
getDelegate().setComponentPath(componentPath);
}
@Override
public String getComponentPath() {
return getDelegate().getComponentPath();
}
@Override
public void setBinding(FxComponentBinding binding) {
getDelegate().setBinding(binding);
}
@Override
public FxComponentBinding getBinding() {
return getDelegate().getBinding();
}
@Override
public void setChangeable(boolean changeable) {
getDelegate().setChangeable(changeable);
}
@Override
public boolean isChangeable() {
return getDelegate().isChangeable();
}
@Override
public ReadOnlyBooleanProperty changeableProperty() {
return getDelegate().changeableProperty();
}
@Override
public void setContainerChangeable(boolean containerChangeable) {
getDelegate().setContainerChangeable(containerChangeable);
}
@Override
public void setContainerChangableIgnored(boolean containerChangeableIgnored) {
getDelegate().setContainerChangableIgnored(containerChangeableIgnored);
}
@Override
public boolean isContainerChangeableIgnored() {
return getDelegate().isContainerChangeableIgnored();
}
@Override
public void setViewModified(boolean viewModified) {
getDelegate().setViewModified(viewModified);
}
@Override
public boolean isViewModified() {
return getDelegate().isViewModified();
}
@Override
public BooleanProperty viewModifiedProperty() {
return getDelegate().viewModifiedProperty();
}
@Override
public void triggerViewModified() {
getDelegate().triggerViewModified();
}
@Override
public void saveView() {
getDelegate().saveView();
}
@Override
public Object getSavedViewObject() {
return getDelegate().getSavedViewObject();
}
@Override
public Object getViewObject() {
return getDelegate().getViewObject();
}
@Override
public void setViewObject(Object viewObject) {
getDelegate().setViewObject(viewObject);
}
@Override
public void setBindable(boolean bindable) {
getDelegate().setBindable(bindable);
}
@Override
public boolean isBindable() {
return getDelegate().isBindable();
}
@Override
public void setHelpUrl(String helpUrl) {
getDelegate().setHelpUrl(helpUrl);
}
@Override
public String getHelpUrl() {
return getDelegate().getHelpUrl();
}
@Override
public void showHelp() {
getDelegate().showHelp();
}
@Override
public String toGenericString() {
return getDelegate().toGenericString();
}
@Override
public void setError(String error) {
getDelegate().setError(error);
}
@Override
public String getError() {
return getDelegate().getError();
}
@Override
public void setErrorTemporary(boolean errorTemporary) {
getDelegate().setErrorTemporary(errorTemporary);
}
@Override
public boolean isErrorTemporary() {
return getDelegate().isErrorTemporary();
}
@Override
public void showErrorPopup() {
getDelegate().showErrorPopup();
}
@Override
public void hideErrorPopup() {
getDelegate().hideErrorPopup();
}
@Override
public void setInfo(String info) {
getDelegate().setInfo(info);
}
@Override
public String getInfo() {
return getDelegate().getInfo();
}
@Override
public void showInfoPopup() {
getDelegate().showInfoPopup();
}
@Override
public void hideInfoPopup() {
getDelegate().hideInfoPopup();
}
@Override
public boolean isModelUpdated() {
return getDelegate().isModelUpdated();
}
@Override
public void setTableCell(FxTableCell tableCell) {
getDelegate().setTableCell(tableCell);
}
@Override
public FxTableCell getTableCell() {
return getDelegate().getTableCell();
}
@Override
public void setTreeTableCell(FxTreeTableCell treeTableCell) {
getDelegate().setTreeTableCell(treeTableCell);
}
@Override
public FxTreeTableCell getTreeTableCell() {
return getDelegate().getTreeTableCell();
}
// //GEN-END:component
}