/******************************************************************************* * Copyright (c) 2000, 2004 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Common Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/cpl-v10.html *  * Contributors: *     IBM Corporation - initial API and implementation *******************************************************************************/package org.eclipse.swt.widgets; import org.eclipse.swt.internal.win32.*;import org.eclipse.swt.*;import org.eclipse.swt.graphics.*;/** * Instances of this class represent a selectable user interface object * that represents an item in a table. * <dl> * <dt><b>Styles:</b></dt> * <dd>(none)</dd> * <dt><b>Events:</b></dt> * <dd>(none)</dd> * </dl> * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> */public class TableItem extends Item {	Table parent;	String [] strings;	Image [] images;	boolean checked, grayed, cached;	int background = -1, foreground = -1, font = -1, imageIndent;	int [] cellBackground, cellForeground, cellFont;/** * Constructs a new instance of this class given its parent * (which must be a <code>Table</code>) and a style value * describing its behavior and appearance. The item is added * to the end of the items maintained by its parent. * <p> * The style value is either one of the style constants defined in * class <code>SWT</code> which is applicable to instances of this * class, or must be built by <em>bitwise OR</em>'ing together  * (that is, using the <code>int</code> "|" operator) two or more * of those <code>SWT</code> style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. * </p> * * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * * @exception IllegalArgumentException <ul> *    <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * @exception SWTException <ul> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li> *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li> * </ul> * * @see SWT * @see Widget#checkSubclass * @see Widget#getStyle */public TableItem (Table parent, int style) {	this (parent, style, checkNull (parent).getItemCount (), true);}/** * Constructs a new instance of this class given its parent * (which must be a <code>Table</code>), a style value * describing its behavior and appearance, and the index * at which to place it in the items maintained by its parent. * <p> * The style value is either one of the style constants defined in * class <code>SWT</code> which is applicable to instances of this * class, or must be built by <em>bitwise OR</em>'ing together  * (that is, using the <code>int</code> "|" operator) two or more * of those <code>SWT</code> style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. * </p> * * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * @param index the index to store the receiver in its parent * * @exception IllegalArgumentException <ul> *    <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * @exception SWTException <ul> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li> *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li> * </ul> * * @see SWT * @see Widget#checkSubclass * @see Widget#getStyle */public TableItem (Table parent, int style, int index) {	this (parent, style, index, true);}TableItem (Table parent, int style, int index, boolean create) {	super (parent, style);	this.parent = parent;	if (create) parent.createItem (this, index);}static Table checkNull (Table control) {	if (control == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);	return control;}protected void checkSubclass () {	if (!isValidSubclass ()) error (SWT.ERROR_INVALID_SUBCLASS);}void clear () {	text = "";	image = null;	strings = null;	images = null;	imageIndent = 0;	checked = grayed = false;	background = foreground = font = -1;	cellBackground = cellForeground = cellFont = null;	if ((parent.style & SWT.VIRTUAL) != 0) cached = false;}/** * Returns the receiver's background color. * * @return the background color * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> *  * @since 2.0 *  */public Color getBackground () {	checkWidget ();	int pixel = (background == -1) ? parent.getBackgroundPixel() : background;	return Color.win32_new (display, pixel);}/** * Returns the background color at the given column index in the receiver. * * @param index the column index * @return the background color * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> *  * @since 3.0 */public Color getBackground (int index) {	checkWidget ();	int count = Math.max (1, parent.getColumnCount ());	if (0 > index || index > count - 1) return getBackground ();	int pixel = cellBackground != null ? cellBackground [index] : -1;	return pixel == -1 ? getBackground () : Color.win32_new (display, pixel);}/** * Returns a rectangle describing the receiver's size and location * relative to its parent at a column in the table. * * @param index the index that specifies the column * @return the receiver's bounding column rectangle * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */public Rectangle getBounds (int index) {	checkWidget();	int itemIndex = parent.indexOf (this);	if (itemIndex == -1) return new Rectangle (0, 0, 0, 0);	int hwnd = parent.handle;		int hwndHeader =  OS.SendMessage (hwnd, OS.LVM_GETHEADER, 0, 0);	int count = OS.SendMessage (hwndHeader, OS.HDM_GETITEMCOUNT, 0, 0);	if (!(0 <= index && index < count)) return new Rectangle (0, 0, 0, 0); 	int gridWidth = parent.getLinesVisible () ? parent.getGridLineWidth () : 0;	/*	* Feature in Windows.  Calling LVM_GETSUBITEMRECT with LVIR_LABEL and	* zero for the column number gives the bounds of the first item without	* including the bounds of the icon.  This behavior is undocumented.	* When called with values greater than zero, the icon bounds are	* included and this behavior is documented.	*/	RECT rect = new RECT ();	rect.top = index;	rect.left = OS.LVIR_LABEL;	OS.SendMessage (hwnd, OS. LVM_GETSUBITEMRECT, itemIndex, rect);	if (index == 0) {		RECT iconRect = new RECT ();		iconRect.left = OS.LVIR_ICON;		OS.SendMessage (hwnd, OS.LVM_GETSUBITEMRECT, itemIndex, iconRect);			rect.left = iconRect.left - gridWidth;	}	int width = Math.max (0, rect.right - rect.left - gridWidth);	int height = Math.max (0, rect.bottom - rect.top - gridWidth);	/*	* Bug in Windows.  In version 5.80 of COMCTL32.DLL, the top	* of the rectangle returned by LVM_GETSUBITEMRECT is off by	* the grid width when the grid is visible.  The fix is to	* move the top of the rectangle up by the grid width.	*/	if ((OS.COMCTL32_MAJOR << 16 | OS.COMCTL32_MINOR) >= (5 << 16 | 80)) {		rect.top -= gridWidth;	}	return new Rectangle (rect.left + gridWidth, rect.top + gridWidth, width, height);}/** * Returns <code>true</code> if the receiver is checked, * and false otherwise.  When the parent does not have * the <code>CHECK</code> style, return false. * * @return the checked state of the checkbox * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */public boolean getChecked () {	checkWidget();	if ((parent.style & SWT.CHECK) == 0) return false;	return checked;}/** * Returns the font that the receiver will use to paint textual information for this item. * * @return the receiver's font * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @since 3.0 */public Font getFont () {	checkWidget ();	return font == -1 ? parent.getFont () : Font.win32_new (display, font);}/** * Returns the font that the receiver will use to paint textual information * for the specified cell in this item. * * @param index the column index * @return the receiver's font * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @since 3.0 */public Font getFont (int index) {	checkWidget ();	int count = Math.max (1, parent.getColumnCount ());	if (0 > index || index > count -1) return getFont ();	int hFont = (cellFont != null) ? cellFont [index] : font;	return hFont == -1 ? getFont () : Font.win32_new (display, hFont);}/** * Returns the foreground color that the receiver will use to draw. * * @return the receiver's foreground color * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> *  * @since 2.0 *  */public Color getForeground () {	checkWidget ();	int pixel = (foreground == -1) ? parent.getForegroundPixel () : foreground;	return Color.win32_new (display, pixel);}/** *  * Returns the foreground color at the given column index in the receiver. * * @param index the column index * @return the foreground color * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> *  * @since 3.0 */public Color getForeground (int index) {	checkWidget ();	int count = Math.max (1, parent.getColumnCount ());	if (0 > index || index > count -1) return getForeground ();	int pixel = cellForeground != null ? cellForeground [index] : -1;	return pixel == -1 ? getForeground () : Color.win32_new (display, pixel);}/** * Returns <code>true</code> if the receiver is grayed, * and false otherwise. When the parent does not have * the <code>CHECK</code> style, return false. * * @return the grayed state of the checkbox * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */public boolean getGrayed () {	checkWidget();	if ((parent.style & SWT.CHECK) == 0) return false;	return grayed;}/** * Returns the image stored at the given column index in the receiver, * or null if the image has not been set or if the column does not exist. * * @param index the column index * @return the image stored at the given column index in the receiver * * @exception SWTException <ul> *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>