Chip 1998 November/Chip_1998-11_cd.bin/tema/Cafe/jfc.bin/TableColumnModel.java

Text File | 1998-02-26 | 6KB | 174 lines

/*
 * @(#)TableColumnModel.java    1.11 98/01/30
 *
 * Copyright (c) 1997 Sun Microsystems, Inc. All Rights Reserved.
 *
 * This software is the confidential and proprietary information of Sun
 * Microsystems, Inc. ("Confidential Information").  You shall not
 * disclose such Confidential Information and shall use it only in
 * accordance with the terms of the license agreement you entered into
 * with Sun.
 *
 * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF THE
 * SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 * PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR ANY DAMAGES
 * SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING
 * THIS SOFTWARE OR ITS DERIVATIVES.
 *
 */

package com.sun.java.swing.table;

import java.util.Enumeration;
import com.sun.java.swing.event.ChangeEvent;
import com.sun.java.swing.event.*;
import com.sun.java.swing.*;


/**
 *
 * @version 1.11 01/30/98
 * @author Alan Chung
 * @author Philip Milne
 * @see DefaultTableColumnModel
 */

public interface TableColumnModel
{
//
// Modifying the model
//

    /**
     *  Appends <I>aColumn</I> to the end of the receiver's tableColumns array.
     *  This method also posts the columnAdded() event to its listeners.
     *
     * @param    aColumn        The <B>TableColumn</B> to be added
     * @see    #removeColumn()
     */
    public void addColumn(TableColumn aColumn);

    /**
     *  Deletes the <B>TableColumn</B> <I>column</I> from the
     *  receiver's table columns array.  This method will do nothing if
     *  <I>column</I> is not in the table's columns list.
     *  This method also posts the columnRemoved() event to its listeners.
     *
     * @param    column        The <B>TableColumn</B> to be removed
     * @see    #addColumn()
     */
    public void removeColumn(TableColumn column);

    /**
     * Moves the column and heading at <I>columnIndex</I> to <I>newIndex</I>.
     * The old column at <I>columnIndex</I> will now be found at <I>newIndex</I>,
     * The column that used to be at <I>newIndex</I> is shifted left or right
     * to make room.
     * This will not move any columns if <I>columnIndex</I> equals <I>newIndex</I>.
     * This method also posts the columnMoved() event to its listeners.
     *
     * @param    columnIndex            the index of column to be moved
     * @param    newIndex            New index to move the column
     * @exception IllegalArgumentException    if <I>column</I> or
     *                         <I>newIndex</I>
     *                        are not in the valid range
     */
    public void moveColumn(int columnIndex, int newIndex);

    /**
     * Sets the <B>TableColumn's</B> column margin to <I>newMargin</I>.
     * This method also posts the columnMarginChanged() event to its
     * listeners.
     *
     * @param    newMargin        the width margin of the column
     * @see    #getColumnMargin()
     */
    public void setColumnMargin(int newMargin);

//
// Querying the model
//

    /** Returns the number of columns in the model */
    public int getColumnCount();

    /** Returns an Enumeration of all the columns in the model */
    public Enumeration getColumns();

    /**
     * Returns the index of the first column in the receiver's
     * columns array whose identifier is equal to <I>identifier</I>,
     * when compared using <I>equals()</I>.
     *
     * @return        the index of the first table column in the receiver's
     *            tableColumns array whose identifier is equal to
     *            <I>identifier</I>, when compared using equals().
     * @param        identifier            the identifier object
     * @exception IllegalArgumentException    if <I>identifier</I> is null or no TableColumn has this identifier
     * @see        #getColumn()
     */
    public int getColumnIndex(Object columnIdentifier);

    /**
     * Returns the <B>TableColumn</B> object for the column at <I>columnIndex</I>
     *
     * @return    the TableColumn object for the column at <I>columnIndex</I>
     * @param    columnIndex    the index of the column desired
     */
    public TableColumn getColumn(int columnIndex);

    /** Returns the width margin between each column */
    public int getColumnMargin();

    /**
     * Returns the index of the column that lies on the <I>xPosition</I>,
     * or -1 if it lies outside the any of the column's bounds.
     *
     * @return    the index of the column or -1 if no column is found
     */
    public int getColumnIndexAtX(int xPosition);

    /** Returns the total width of all the columns. */
    public int getTotalColumnWidth();

//
// Selection
//

    /**
     * Sets whether the columns in this model can be selected.
     * @see #getColumnSelectionAllowed()
     */
    public void setColumnSelectionAllowed(boolean flag);

    /**
     * @return true if columns can be selected.
     * @see #setColumnSelectionAllowed()
     */
    public boolean getColumnSelectionAllowed();

    /**
     * @return the indices of all selected columns, or an empty int array if
     *         no column is selected.
     * @see #getSelectedColumn()
     */
    public int[] getSelectedColumns();

    /**
     * @return the number of selected columns.  0 if no columns are selected.
     */
    public int getSelectedColumnCount();

    public void setSelectionModel(ListSelectionModel newModel);

    public ListSelectionModel getSelectionModel();

//
// Listener
//

    public void addColumnModelListener(TableColumnModelListener x);
    public void removeColumnModelListener(TableColumnModelListener x);
}