/*******************************************************************************
 * 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 Shindl <tom.schindl@bestsolution.at> - initial API and implementation
 *                                                fix for bug 163317,200558
 * Port to the D programming language:
 *     Frank Benoit <benoit@tionex.de>
 *******************************************************************************/

module dwtx.jface.viewers.ViewerColumn;

import dwtx.jface.viewers.CellLabelProvider;
import dwtx.jface.viewers.EditingSupport;
import dwtx.jface.viewers.ILabelProviderListener;
import dwtx.jface.viewers.ColumnViewer;
import dwtx.jface.viewers.ViewerCell;
import dwtx.jface.viewers.LabelProviderChangedEvent;

import dwt.events.DisposeEvent;
import dwt.events.DisposeListener;
import dwt.widgets.Widget;
import dwtx.jface.util.Policy;

import dwt.dwthelper.utils;

/**
 * Instances of this class represent a column of a {@link ColumnViewer}. Label
 * providers and editing support can be configured for each column separately.
 * Concrete subclasses of {@link ColumnViewer} should implement a matching
 * concrete subclass of {@link ViewerColumn}.
 *
 * @since 3.3
 *
 */
public abstract class ViewerColumn {

    private CellLabelProvider labelProvider;

    static String COLUMN_VIEWER_KEY = Policy.JFACE ~ ".columnViewer";//$NON-NLS-1$

    private EditingSupport editingSupport;

    private ILabelProviderListener listener;

    private bool listenerRegistered = false;

    /**
     * Create a new instance of the receiver at columnIndex.
     *
     * @param viewer
     *            the viewer the column is part of
     * @param columnOwner
     *            the widget owning the viewer in case the widget has no columns
     *            this could be the widget itself
     */
    protected this(ColumnViewer viewer, Widget columnOwner) {
        columnOwner.setData(ViewerColumn.COLUMN_VIEWER_KEY, this);
        this.listener = new class ILabelProviderListener {
            ColumnViewer viewer_;
            this(){
                viewer_= viewer;
            }
            public void labelProviderChanged(LabelProviderChangedEvent event) {
                viewer_.handleLabelProviderChanged_package(event);
            }

        };
        columnOwner.addDisposeListener(new class DisposeListener {
            ColumnViewer viewer_;
            this(){
                viewer_= viewer;
            }
            public void widgetDisposed(DisposeEvent e) {
                handleDispose(viewer_);
            }
        });
    }

    /**
     * Return the label provider for the receiver.
     *
     * @return ViewerLabelProvider
     */
    /* package */CellLabelProvider getLabelProvider() {
        return labelProvider;
    }

    /**
     * Set the label provider for the column. Subclasses may extend but must
     * call the super implementation.
     *
     * @param labelProvider
     *            the new {@link CellLabelProvider}
     */
    public void setLabelProvider(CellLabelProvider labelProvider) {
        setLabelProvider(labelProvider, true);
    }

    /**
     * @param labelProvider
     * @param registerListener
     */
    /* package */void setLabelProvider(CellLabelProvider labelProvider,
            bool registerListener) {
        if (listenerRegistered && this.labelProvider !is null) {
            this.labelProvider.removeListener(listener);
            listenerRegistered = false;
        }

        this.labelProvider = labelProvider;

        if (registerListener) {
            this.labelProvider.addListener(listener);
            listenerRegistered = true;
        }
    }

    /**
     * Return the editing support for the receiver.
     *
     * @return {@link EditingSupport}
     */
    /* package */EditingSupport getEditingSupport() {
        return editingSupport;
    }

    /**
     * Set the editing support. Subclasses may extend but must call the super
     * implementation.
     *
     * @param editingSupport
     *            The {@link EditingSupport} to set.
     */
    public void setEditingSupport(EditingSupport editingSupport) {
        this.editingSupport = editingSupport;
    }

    /**
     * Refresh the cell for the given columnIndex. <strong>NOTE:</strong>the
     * {@link ViewerCell} provided to this method is no longer valid after this
     * method returns. Do not cache the cell for future use.
     *
     * @param cell
     *            {@link ViewerCell}
     */
    /* package */void refresh(ViewerCell cell) {
        getLabelProvider().update(cell);
    }

    /**
     * Disposes of the label provider (if set), unregisters the listener and
     * nulls the references to the label provider and editing support. This
     * method is called when the underlying widget is disposed. Subclasses may
     * extend but must call the super implementation.
     */
    protected void handleDispose() {
        bool disposeLabelProvider = listenerRegistered;
        CellLabelProvider cellLabelProvider = labelProvider;
        setLabelProvider(null, false);
        if (disposeLabelProvider) {
            cellLabelProvider.dispose();
        }
        editingSupport = null;
        listener = null;
    }

    private void handleDispose(ColumnViewer viewer) {
        handleDispose();
        viewer.clearLegacyEditingSetup();
    }
}