org.tentackle.fx.component.FxListView 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.scene.control.ListView;
import javafx.scene.input.Clipboard;
import javafx.scene.input.ClipboardContent;
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.FxListViewDelegate;
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 ListView.
*
* @author harald
* @param the item type
*/
public class FxListView extends ListView implements FxComponent {
/**
* Currently displayed info notes.
*/
private List infoNotes;
/**
* Copy to clipboard feature toggle.
*/
private boolean copyToClipboardEnabled;
/**
* Creates a default ListView with no content.
*
* Refer to the {@link ListView} class documentation for details on the default state of other properties.
*/
public FxListView() {
addEventHandler(KeyEvent.ANY, this::handleKeyEvent);
}
/**
* 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));
}
/**
* Scrolls the view in such a way that the given object's row is positioned in the center of the visible rows.
*
* @param object the object to scroll to
*/
public void scrollToCentered(T object) {
if (getItems() != null) {
int row = getItems().indexOf(object);
if (row >= 0) {
scrollToCentered(row);
}
}
}
/**
* Configures the table to copy a cell via Crtl-C to the clipboard.
*
* @param copyToClipboardEnabled true to enable
*/
public void setCopyToClipboardEnabled(boolean copyToClipboardEnabled) {
this.copyToClipboardEnabled = copyToClipboardEnabled;
}
/**
* Returns whether the copy to clipboard feature is enabled.
*
* @return true if enabled
*/
public boolean isCopyToClipboardEnabled() {
return copyToClipboardEnabled;
}
/**
* Copies the selected items to the clipboard.
*
* @param commaSeparated true if separate multiple items via commas instead of newlines
* @return the copied text, null if nothing copied
*/
public String copyToClipboard(boolean commaSeparated) {
String separator = FxUtilities.getInstance().getCsvSeparator();
StringBuilder buf = new StringBuilder();
for (T item : getSelectionModel().getSelectedItems()) {
if (buf.length() > 0) {
if (commaSeparated) {
buf.append(separator);
}
else {
buf.append('\n');
}
}
buf.append(item);
}
if (buf.length() > 0) {
ClipboardContent cbc = new ClipboardContent();
String text = buf.toString();
cbc.putString(text);
Clipboard.getSystemClipboard().setContent(cbc);
return text;
}
return null;
}
/**
* Handles all key events.
*
* @param event the key event
*/
protected void handleKeyEvent(KeyEvent event) {
if (isCopyToClipboardEnabled()) {
if (event.getEventType() == KeyEvent.KEY_PRESSED && event.isControlDown() && event.getCode() == KeyCode.C) {
String text = copyToClipboard(event.isShiftDown()); // shift+ctrl -> comma separated
if (text != null) {
// display copied text for as long as the control button is held down (see setOnKeyReleased below)
Note infoNote = new Note(Note.Position.CENTER, Note.Type.INFO);
infoNote.setText(text);
infoNote.show(this);
if (infoNotes == null) {
infoNotes = new ArrayList<>();
}
infoNotes.add(infoNote);
}
}
else if (event.getEventType() == KeyEvent.KEY_RELEASED && event.getCode() == KeyCode.CONTROL) {
if (infoNotes != null) {
// hide all info notes with the release of the control button
for (Note infoNote : infoNotes) {
infoNote.hide();
}
infoNotes = null;
}
}
}
}
// @wurblet delegate Include $currentDir/fxcomponent.include
////GEN-BEGIN:delegate
private /**/FxListViewDelegate/**/ delegate; // @wurblet < Inject ${classname}Delegate
/**
* Creates the delegate.
*
* @return the delegate
*/
protected /**/FxListViewDelegate/**/ createDelegate() { // @wurblet < Inject ${classname}Delegate
return new /**/FxListViewDelegate/**/(this); // @wurblet < Inject ${classname}Delegate
}
@Override
public /**/FxListViewDelegate/**/ 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(/**/FxListViewDelegate/**/ 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
}