bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/TreeItem.java - platform/eclipse.platform.swt.git - Git at Google

 /*******************************************************************************
  * Copyright (c) 2000, 2003 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.*;
 import org.eclipse.swt.internal.*;
 import org.eclipse.swt.internal.gtk.*;
 import org.eclipse.swt.graphics.*;

 /**
  * Instances of this class represent a selectable user interface object
  * that represents a hierarchy of tree items in a tree widget.
  *
  * <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 TreeItem extends Item {
 	Tree parent;
 	boolean grayed;

 /**
  * Constructs a new instance of this class given its parent
  * (which must be a <code>Tree</code> or a <code>TreeItem</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 TreeItem (Tree parent, int style) {
 	super (parent, style);
 	this.parent = parent;
 	parent.createItem (this, 0, -1);
 }

 /**
  * Constructs a new instance of this class given its parent
  * (which must be a <code>Tree</code> or a <code>TreeItem</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 TreeItem (Tree parent, int style, int index) {
 	super (parent, style);
 	if (index < 0) error (SWT.ERROR_INVALID_RANGE);
 	this.parent = parent;
 	parent.createItem (this, 0, index);
 }

 /**
  * Constructs a new instance of this class given its parent
  * (which must be a <code>Tree</code> or a <code>TreeItem</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 parentItem 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 TreeItem (TreeItem parentItem, int style) {
 	super (checkNull (parentItem).parent, style);
 	this.parent = parentItem.parent;
 	parent.createItem (this, parentItem.handle, -1);
 }

 /**
  * Constructs a new instance of this class given its parent
  * (which must be a <code>Tree</code> or a <code>TreeItem</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 parentItem 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 TreeItem (TreeItem parentItem, int style, int index) {
 	super (checkNull (parentItem).parent, style);
 	if (index < 0) error (SWT.ERROR_ITEM_NOT_ADDED);
 	this.parent = parentItem.parent;
 	parent.createItem (this, parentItem.handle, index);
 }

 static TreeItem checkNull (TreeItem item) {
 	if (item == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
 	return item;
 }

 /**
  * 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[] ptr = new int[1];
 	OS.gtk_tree_model_get (parent.modelHandle, handle, 3, ptr, -1);
 	if (ptr [0] == 0) return parent.getBackground ();
 	GdkColor gdkColor = new GdkColor ();
 	OS.memmove (gdkColor, ptr [0], GdkColor.sizeof);
 	return Color.gtk_new (getDisplay (), gdkColor);
 }

 /**
  * Returns a rectangle describing the receiver's size and location
  * relative to its parent.
  *
  * @return the receiver's bounding 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 () {
 	checkWidget ();
 	int parentHandle = parent.handle;
 	GdkRectangle rect = new GdkRectangle ();
 	int column = OS.gtk_tree_view_get_column (parentHandle, 0);
 	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
 	OS.gtk_tree_view_get_cell_area (parentHandle, path, column, rect);
 	OS.gtk_tree_path_free (path);
 	return new Rectangle (rect.x, rect.y, rect.width, rect.height);
 }

 /**
  * Returns <code>true</code> if the receiver is checked,
  * and false otherwise.  When the parent does not have
  * the <code>CHECK style, return false.
  * <p>
  *
  * @return the checked state
  *
  * @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;
 	int [] ptr = new int [1];
 	OS.gtk_tree_model_get (parent.modelHandle, handle, 5, ptr, -1);
 	return ptr [0] != 0;
 }

 public Display getDisplay () {
 	if (parent == null) error (SWT.ERROR_WIDGET_DISPOSED);
 	return parent.getDisplay ();
 }

 /**
  * Returns <code>true</code> if the receiver is expanded,
  * and false otherwise.
  * <p>
  *
  * @return the expanded state
  *
  * @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 getExpanded () {
 	checkWidget();
 	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
 	boolean answer = OS.gtk_tree_view_row_expanded (parent.handle, path);
 	OS.gtk_tree_path_free (path);
 	return answer;
 }

 /**
  * 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 [] ptr = new int [1];
 	OS.gtk_tree_model_get (parent.modelHandle, handle, 2, ptr, -1);
 	if (ptr [0]==0) return parent.getForeground();
 	GdkColor gdkColor = new GdkColor ();
 	OS.memmove (gdkColor, ptr [0], GdkColor.sizeof);
 	return Color.gtk_new (getDisplay (), gdkColor);
 }

 /**
  * Returns <code>true</code> if the receiver is grayed,
  * and false otherwise. When the parent does not have
  * the <code>CHECK style, return false.
  * <p>
  *
  * @return the grayed state
  *
  * @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();
 	//NOT IMPLEMENTED
 	return grayed;
 }

 /**
  * Returns the number of items contained in the receiver
  * that are direct item children of the receiver.
  *
  * @return the number of items
  *
  * @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 int getItemCount () {
 	checkWidget();
 	return OS.gtk_tree_model_iter_n_children (parent.modelHandle, handle);
 }

 /**
  * Returns an array of <code>TreeItem</code>s which are the
  * direct item children of the receiver.
  * <p>
  * Note: This is not the actual structure used by the receiver
  * to maintain its list of items, so modifying the array will
  * not affect the receiver.
  * </p>
  *
  * @return the receiver's items
  *
  * @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 TreeItem [] getItems () {
 	checkWidget();
 	return parent.getItems (handle);
 }

 /**
  * Returns the receiver's parent, which must be a <code>Tree</code>.
  *
  * @return the receiver's parent
  *
  * @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 Tree getParent () {
 	checkWidget();
 	return parent;
 }

 /**
  * Returns the receiver's parent item, which must be a
  * <code>TreeItem</code> or null when the receiver is a
  * root.
  *
  * @return the receiver's parent item
  *
  * @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 TreeItem getParentItem () {
 	checkWidget();
 	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
 	if (OS.gtk_tree_path_get_depth (path) < 2) {
 		OS.gtk_tree_path_free (path);
 		return null;
 	}
 	OS.gtk_tree_path_up (path);
 	int iter = OS.g_malloc (OS.GtkTreeIter_sizeof ());
 	OS.gtk_tree_model_get_iter (parent.modelHandle, iter, path);
 	int [] index = new int [1];
 	OS.gtk_tree_model_get (parent.modelHandle, iter, 4, index, -1);
 	OS.g_free (iter);
 	OS.gtk_tree_path_free (path);
 	return parent.items [index [0]];
 }

 void releaseChild () {
 	super.releaseChild ();
 	parent.destroyItem (this);
 }

 void releaseWidget () {
 	super.releaseWidget ();
 	if (handle != 0) OS.g_free (handle);
 	handle = 0;
 	parent = null;
 }

 /**
  * Sets the receiver's background color to the color specified
  * by the argument, or to the default system color for the item
  * if the argument is null.
  *
  * @param color the new color (or null)
  *
  * @exception IllegalArgumentException <ul>
  *    <li>ERROR_INVALID_ARGUMENT - if the argument has been disposed</li>
  * </ul>
  * @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 void setBackground (Color color) {
 	checkWidget ();
 	if (color != null && color.isDisposed ()) {
 		SWT.error (SWT.ERROR_INVALID_ARGUMENT);
 	}
 	GdkColor gdkColor = color != null ? color.handle : null;
 	OS.gtk_tree_store_set (parent.modelHandle, handle, 3, gdkColor, -1);
 }

 /**
  * Sets the checked state of the receiver.
  * <p>
  *
  * @param checked the new checked state
  *
  * @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 void setChecked (boolean checked) {
 	checkWidget();
 	if ((parent.style & SWT.CHECK) == 0) return;
 	OS.gtk_tree_store_set (parent.modelHandle, handle, 5, checked, -1);
 }

 /**
  * Sets the grayed state of the receiver.
  * <p>
  *
  * @param checked the new grayed state
  *
  * @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 void setGrayed (boolean grayed) {
 	checkWidget();
 	//NOT IMPLEMENTED
 	this.grayed = grayed;
 }

 /**
  * Sets the expanded state of the receiver.
  * <p>
  *
  * @param expanded the new expanded state
  *
  * @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 void setExpanded (boolean expanded) {
 	checkWidget();
 	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
 	if (expanded) {
 		OS.g_signal_handlers_block_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_EXPANDED);
 		OS.gtk_tree_view_expand_row (parent.handle, path, false);
 		OS.g_signal_handlers_unblock_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_EXPANDED);
 	} else {
 		OS.g_signal_handlers_block_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_COLLAPSED);
 		OS.gtk_tree_view_collapse_row (parent.handle, path);
 		OS.g_signal_handlers_unblock_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_COLLAPSED);
 	}
 	OS.gtk_tree_path_free (path);
 }

 /**
  * Sets the receiver's foreground color to the color specified
  * by the argument, or to the default system color for the item
  * if the argument is null.
  *
  * @param color the new color (or null)
  *
  * @since 2.0
  *
  * @exception IllegalArgumentException <ul>
  *    <li>ERROR_INVALID_ARGUMENT - if the argument has been disposed</li>
  * </ul>
  * @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 void setForeground (Color color){
 	checkWidget ();
 	if (color != null && color.isDisposed ()) {
 		SWT.error (SWT.ERROR_INVALID_ARGUMENT);
 	}
 	GdkColor gdkColor = color != null ? color.handle : null;
 	OS.gtk_tree_store_set (parent.modelHandle, handle, 2, gdkColor, -1);
 }

 public void setImage (Image image) {
 	checkWidget();
 	if (image != null && image.isDisposed()) {
 		error(SWT.ERROR_INVALID_ARGUMENT);
 	}
 	super.setImage (image);
 	int pixbuf = 0;
 	if (image != null) {
 		ImageList imageList = parent.imageList;
 		if (imageList == null) imageList = parent.imageList = new ImageList ();
 		int imageIndex = imageList.indexOf (image);
 		if (imageIndex == -1) imageIndex = imageList.add (image);
 		pixbuf = imageList.getPixbuf (imageIndex);
 	}
 	OS.gtk_tree_store_set (parent.modelHandle, handle, 1, pixbuf, -1);
 }

 /**
  * This label will be displayed to the right of the bitmap,
  * or, if the receiver doesn't have a bitmap to the right of
  * the horizontal hierarchy connector line.
  */
 public void setText (String string) {
 	checkWidget();
 	if (string == null) error (SWT.ERROR_NULL_ARGUMENT);
 	super.setText (string);
 	byte[] buffer = Converter.wcsToMbcs (null, string, true);
 	OS.gtk_tree_store_set (parent.modelHandle, handle, 0, buffer, -1);
 }

 }
	/*******************************************************************************
	* Copyright (c) 2000, 2003 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.*;
	import org.eclipse.swt.internal.*;
	import org.eclipse.swt.internal.gtk.*;
	import org.eclipse.swt.graphics.*;

	/**
	* Instances of this class represent a selectable user interface object
	* that represents a hierarchy of tree items in a tree widget.
	*
	* <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 TreeItem extends Item {
	Tree parent;
	boolean grayed;

	/**
	* Constructs a new instance of this class given its parent
	* (which must be a <code>Tree</code> or a <code>TreeItem</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 TreeItem (Tree parent, int style) {
	super (parent, style);
	this.parent = parent;
	parent.createItem (this, 0, -1);
	}

	/**
	* Constructs a new instance of this class given its parent
	* (which must be a <code>Tree</code> or a <code>TreeItem</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 TreeItem (Tree parent, int style, int index) {
	super (parent, style);
	if (index < 0) error (SWT.ERROR_INVALID_RANGE);
	this.parent = parent;
	parent.createItem (this, 0, index);
	}

	/**
	* Constructs a new instance of this class given its parent
	* (which must be a <code>Tree</code> or a <code>TreeItem</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 parentItem 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 TreeItem (TreeItem parentItem, int style) {
	super (checkNull (parentItem).parent, style);
	this.parent = parentItem.parent;
	parent.createItem (this, parentItem.handle, -1);
	}

	/**
	* Constructs a new instance of this class given its parent
	* (which must be a <code>Tree</code> or a <code>TreeItem</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 parentItem 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 TreeItem (TreeItem parentItem, int style, int index) {
	super (checkNull (parentItem).parent, style);
	if (index < 0) error (SWT.ERROR_ITEM_NOT_ADDED);
	this.parent = parentItem.parent;
	parent.createItem (this, parentItem.handle, index);
	}

	static TreeItem checkNull (TreeItem item) {
	if (item == null) SWT.error (SWT.ERROR_NULL_ARGUMENT);
	return item;
	}

	/**
	* 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[] ptr = new int[1];
	OS.gtk_tree_model_get (parent.modelHandle, handle, 3, ptr, -1);
	if (ptr [0] == 0) return parent.getBackground ();
	GdkColor gdkColor = new GdkColor ();
	OS.memmove (gdkColor, ptr [0], GdkColor.sizeof);
	return Color.gtk_new (getDisplay (), gdkColor);
	}

	/**
	* Returns a rectangle describing the receiver's size and location
	* relative to its parent.
	*
	* @return the receiver's bounding 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 () {
	checkWidget ();
	int parentHandle = parent.handle;
	GdkRectangle rect = new GdkRectangle ();
	int column = OS.gtk_tree_view_get_column (parentHandle, 0);
	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
	OS.gtk_tree_view_get_cell_area (parentHandle, path, column, rect);
	OS.gtk_tree_path_free (path);
	return new Rectangle (rect.x, rect.y, rect.width, rect.height);
	}

	/**
	* Returns <code>true</code> if the receiver is checked,
	* and false otherwise. When the parent does not have
	* the <code>CHECK style, return false.
	* <p>
	*
	* @return the checked state
	*
	* @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;
	int [] ptr = new int [1];
	OS.gtk_tree_model_get (parent.modelHandle, handle, 5, ptr, -1);
	return ptr [0] != 0;
	}

	public Display getDisplay () {
	if (parent == null) error (SWT.ERROR_WIDGET_DISPOSED);
	return parent.getDisplay ();
	}

	/**
	* Returns <code>true</code> if the receiver is expanded,
	* and false otherwise.
	* <p>
	*
	* @return the expanded state
	*
	* @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 getExpanded () {
	checkWidget();
	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
	boolean answer = OS.gtk_tree_view_row_expanded (parent.handle, path);
	OS.gtk_tree_path_free (path);
	return answer;
	}

	/**
	* 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 [] ptr = new int [1];
	OS.gtk_tree_model_get (parent.modelHandle, handle, 2, ptr, -1);
	if (ptr [0]==0) return parent.getForeground();
	GdkColor gdkColor = new GdkColor ();
	OS.memmove (gdkColor, ptr [0], GdkColor.sizeof);
	return Color.gtk_new (getDisplay (), gdkColor);
	}

	/**
	* Returns <code>true</code> if the receiver is grayed,
	* and false otherwise. When the parent does not have
	* the <code>CHECK style, return false.
	* <p>
	*
	* @return the grayed state
	*
	* @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();
	//NOT IMPLEMENTED
	return grayed;
	}

	/**
	* Returns the number of items contained in the receiver
	* that are direct item children of the receiver.
	*
	* @return the number of items
	*
	* @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 int getItemCount () {
	checkWidget();
	return OS.gtk_tree_model_iter_n_children (parent.modelHandle, handle);
	}

	/**
	* Returns an array of <code>TreeItem</code>s which are the
	* direct item children of the receiver.
	* <p>
	* Note: This is not the actual structure used by the receiver
	* to maintain its list of items, so modifying the array will
	* not affect the receiver.
	* </p>
	*
	* @return the receiver's items
	*
	* @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 TreeItem [] getItems () {
	checkWidget();
	return parent.getItems (handle);
	}

	/**
	* Returns the receiver's parent, which must be a <code>Tree</code>.
	*
	* @return the receiver's parent
	*
	* @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 Tree getParent () {
	checkWidget();
	return parent;
	}

	/**
	* Returns the receiver's parent item, which must be a
	* <code>TreeItem</code> or null when the receiver is a
	* root.
	*
	* @return the receiver's parent item
	*
	* @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 TreeItem getParentItem () {
	checkWidget();
	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
	if (OS.gtk_tree_path_get_depth (path) < 2) {
	OS.gtk_tree_path_free (path);
	return null;
	}
	OS.gtk_tree_path_up (path);
	int iter = OS.g_malloc (OS.GtkTreeIter_sizeof ());
	OS.gtk_tree_model_get_iter (parent.modelHandle, iter, path);
	int [] index = new int [1];
	OS.gtk_tree_model_get (parent.modelHandle, iter, 4, index, -1);
	OS.g_free (iter);
	OS.gtk_tree_path_free (path);
	return parent.items [index [0]];
	}

	void releaseChild () {
	super.releaseChild ();
	parent.destroyItem (this);
	}

	void releaseWidget () {
	super.releaseWidget ();
	if (handle != 0) OS.g_free (handle);
	handle = 0;
	parent = null;
	}

	/**
	* Sets the receiver's background color to the color specified
	* by the argument, or to the default system color for the item
	* if the argument is null.
	*
	* @param color the new color (or null)
	*
	* @exception IllegalArgumentException <ul>
	* <li>ERROR_INVALID_ARGUMENT - if the argument has been disposed</li>
	* </ul>
	* @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 void setBackground (Color color) {
	checkWidget ();
	if (color != null && color.isDisposed ()) {
	SWT.error (SWT.ERROR_INVALID_ARGUMENT);
	}
	GdkColor gdkColor = color != null ? color.handle : null;
	OS.gtk_tree_store_set (parent.modelHandle, handle, 3, gdkColor, -1);
	}

	/**
	* Sets the checked state of the receiver.
	* <p>
	*
	* @param checked the new checked state
	*
	* @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 void setChecked (boolean checked) {
	checkWidget();
	if ((parent.style & SWT.CHECK) == 0) return;
	OS.gtk_tree_store_set (parent.modelHandle, handle, 5, checked, -1);
	}

	/**
	* Sets the grayed state of the receiver.
	* <p>
	*
	* @param checked the new grayed state
	*
	* @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 void setGrayed (boolean grayed) {
	checkWidget();
	//NOT IMPLEMENTED
	this.grayed = grayed;
	}

	/**
	* Sets the expanded state of the receiver.
	* <p>
	*
	* @param expanded the new expanded state
	*
	* @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 void setExpanded (boolean expanded) {
	checkWidget();
	int path = OS.gtk_tree_model_get_path (parent.modelHandle, handle);
	if (expanded) {
	OS.g_signal_handlers_block_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_EXPANDED);
	OS.gtk_tree_view_expand_row (parent.handle, path, false);
	OS.g_signal_handlers_unblock_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_EXPANDED);
	} else {
	OS.g_signal_handlers_block_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_COLLAPSED);
	OS.gtk_tree_view_collapse_row (parent.handle, path);
	OS.g_signal_handlers_unblock_matched (parent.handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, ROW_COLLAPSED);
	}
	OS.gtk_tree_path_free (path);
	}

	/**
	* Sets the receiver's foreground color to the color specified
	* by the argument, or to the default system color for the item
	* if the argument is null.
	*
	* @param color the new color (or null)
	*
	* @since 2.0
	*
	* @exception IllegalArgumentException <ul>
	* <li>ERROR_INVALID_ARGUMENT - if the argument has been disposed</li>
	* </ul>
	* @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 void setForeground (Color color){
	checkWidget ();
	if (color != null && color.isDisposed ()) {
	SWT.error (SWT.ERROR_INVALID_ARGUMENT);
	}
	GdkColor gdkColor = color != null ? color.handle : null;
	OS.gtk_tree_store_set (parent.modelHandle, handle, 2, gdkColor, -1);
	}

	public void setImage (Image image) {
	checkWidget();
	if (image != null && image.isDisposed()) {
	error(SWT.ERROR_INVALID_ARGUMENT);
	}
	super.setImage (image);
	int pixbuf = 0;
	if (image != null) {
	ImageList imageList = parent.imageList;
	if (imageList == null) imageList = parent.imageList = new ImageList ();
	int imageIndex = imageList.indexOf (image);
	if (imageIndex == -1) imageIndex = imageList.add (image);
	pixbuf = imageList.getPixbuf (imageIndex);
	}
	OS.gtk_tree_store_set (parent.modelHandle, handle, 1, pixbuf, -1);
	}

	/**
	* This label will be displayed to the right of the bitmap,
	* or, if the receiver doesn't have a bitmap to the right of
	* the horizontal hierarchy connector line.
	*/
	public void setText (String string) {
	checkWidget();
	if (string == null) error (SWT.ERROR_NULL_ARGUMENT);
	super.setText (string);
	byte[] buffer = Converter.wcsToMbcs (null, string, true);
	OS.gtk_tree_store_set (parent.modelHandle, handle, 0, buffer, -1);
	}

	}