/*******************************************************************************
 * Copyright (c) 2006, 2007 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *     Tom Schindl <tom.schindl@bestsolution.at> - initial API and implementation
 *                                                 fix in bug 151295,167325,201905
 * Port to the D programming language:
 *     Frank Benoit <benoit@tionex.de>
 *******************************************************************************/

module dwtx.jface.viewers.EditingSupport;

import dwtx.jface.viewers.ColumnViewer;
import dwtx.jface.viewers.CellEditor;
import dwtx.jface.viewers.ViewerCell;

import dwtx.core.runtime.Assert;

import dwt.dwthelper.utils;

/**
 * EditingSupport is the abstract superclass of the support for cell editing.
 *
 * @since 3.3
 *
 */
public abstract class EditingSupport {

    private ColumnViewer viewer;

    /**
     * @param viewer
     *            a new viewer
     */
    public this(ColumnViewer viewer) {
        Assert.isNotNull(viewer, "Viewer is not allowed to be null"); //$NON-NLS-1$
        this.viewer = viewer;
    }

    /**
     * The editor to be shown
     *
     * @param element
     *            the model element
     * @return the CellEditor
     */
    protected abstract CellEditor getCellEditor(Object element);
    package CellEditor getCellEditor_package(Object element){
        return getCellEditor(element);
    }

    /**
     * Is the cell editable
     *
     * @param element
     *            the model element
     * @return true if editable
     */
    protected abstract bool canEdit(Object element);
    package bool canEdit_package(Object element){
        return canEdit(element);
    }

    /**
     * Get the value to set to the editor
     *
     * @param element
     *            the model element
     * @return the value shown
     */
    protected abstract Object getValue(Object element);

    /**
     * Restore the value from the CellEditor
     *
     * <p>
     * <b>Subclasses should overwrite!</b>
     * </p>
     *
     * @param element
     *            the model element
     * @param value
     *            the new value
     */
    protected abstract void setValue(Object element, Object value);

    /**
     * @return the viewer this editing support works for
     */
    public ColumnViewer getViewer() {
        return viewer;
    }

    /**
     * Initialize the editor. Frameworks like Databinding can hook in here and provide
     * a customized implementation. <p><b>Standard customers should not overwrite this method but {@link #getValue(Object)}</b></p>
     *
     * @param cellEditor
     *            the cell editor
     * @param cell
     *            the cell the editor is working for
     */
    protected void initializeCellEditorValue(CellEditor cellEditor, ViewerCell cell) {
        Object value = getValue(cell.getElement());
        cellEditor.setValue(value);
    }
    package void initializeCellEditorValue_package(CellEditor cellEditor, ViewerCell cell) {
        initializeCellEditorValue(cellEditor, cell);
    }

    /**
     * Save the value of the cell editor back to the model. Frameworks like Databinding can hook in here and provide
     * a customized implementation. <p><b>Standard customers should not overwrite this method but {@link #setValue(Object, Object)} </b></p>
     * @param cellEditor
     *            the cell-editor
     * @param cell
     *            the cell the editor is working for
     */
    protected void saveCellEditorValue(CellEditor cellEditor, ViewerCell cell) {
        Object value = cellEditor.getValue();
        setValue(cell.getElement(), value);
    }
    package void saveCellEditorValue_package(CellEditor cellEditor, ViewerCell cell) {
        saveCellEditorValue(cellEditor, cell);
    }

    bool isLegacySupport() {
        return false;
    }
}