/*
 * File    : TableRow.java
 * Created : 2004/Apr/30
 *
 * Azureus - a Java Bittorrent client
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License.
 *
 * This program 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 General Public License for more details ( see the LICENSE file ).
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
 
package org.gudy.azureus2.plugins.ui.tables;


/**
 * This interface provides access to an Azureus table row.
 *
 * @author TuxPaper
 * @since 2.0.8.5
 */
public interface TableRow {
  /** Retrieve the data object associated with the current table row.
   *
   * @return The return type is dependent upon which table the cell is for:<br>
   *   TABLE_MYTORRENTS_*: {@link org.gudy.azureus2.plugins.download.Download}
   *                       object for the current row<br>
   *   TABLE_TORRENT_PEERS: {@link org.gudy.azureus2.plugins.peers.Peer} 
   *                        object for the current row<br>
   *   TABLE_TORRENT_FILES: {@link org.gudy.azureus2.plugins.disk.DiskManagerFileInfo}
   *                        object for the current row<br>
   *   TABLE_MYTRACKER: {@link org.gudy.azureus2.plugins.tracker.TrackerTorrent}
   *                    object for the current row<br>
   *   TABLE_MYSHARES: {@link org.gudy.azureus2.plugins.sharing.ShareResource}
   *                    object for the current row<br>
   *   remaining TABLE_* constants: undefined or null<br>
   */
  Object getDataSource();
  
  /** Returns which table the row is being displayed in.
   *
   * @return {@link TableManager}.TABLE_* constant
   */
  String getTableID();

  /**
   * Change the row's foreground color.
  *
  * @param red red value (0 - 255)
  * @param green green value (0 - 255)
  * @param blue blue value (0 - 255)
  * @since 3.0.3.5
  */
  public void setForeground(int red, int green, int blue);
  
  /**
   * Change the row's foreground color
   * 
   * @param rgb int array of red, green, and blue values.  Null to reset to
   *            default color
   *
   * @since 3.0.4.3
   */
  public void setForeground(int[] rgb);

  /**
   * Change the row's foreground color to the user's defined "error" color.
   * 
  * @since 3.0.3.5
  */
  public void setForegroundToErrorColor();


  /** Validility of the row's cells.
   *
   * @return True - Text is the same as last call.  You do not need to update
   *                unless you have new text to display. <br>
   *         False - Cell-to-Datasource link has changed, and the text is
   *                 definitely not valid.
   */
  boolean isValid();

  /** Retrieve a cell based on its column name
   *
   * @param sColumnName Name/ID of column
   * @return TableCell object related to this row and the column specified
   */
  TableCell getTableCell(String sColumnName);
  
  /**
   * Retrieve whether the row is selected by the user
   * 
   * @return selection status
   */
  boolean isSelected();

  /**
	 * Adds a listener that triggers when this TableRow has a mouse event.
	 * 
	 * @param listener
	 * 
	 * @since 3.0.1.7
	 */
	public void addMouseListener(TableRowMouseListener listener);

	/** Remove a previously added TableRowMouseListener
	 *
	 * @param listener Previously added listener
	 * @since 3.0.1.7
	 */
	public void removeMouseListener(TableRowMouseListener listener);

	/**
	 * Get a previously stored value
	 * 
	 * @param id
	 * @return
	 *
	 * @since 4.3.1.5
	 */
	Object getData(String id);

	/**
	 * Store a value against the table row
	 * 
	 * @param id
	 * @param data
	 *
	 * @since 4.3.1.5
	 */
	void setData(String id, Object data);

}
