package org.eclipse.swt.widgets;
/*
* Copyright (c) 2000, 2002 IBM Corp. All rights reserved.
* This file is 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
*/
import org.eclipse.swt.*;
import org.eclipse.swt.internal.gtk.*;
import org.eclipse.swt.graphics.*;
import org.eclipse.swt.events.*;
/**
* Instances of this class provide a selectable user interface object
* that displays a hierarchy of items and issue notificiation when an
* item in the hierarchy is selected.
*
* The item children that may be added to instances of this class
* must be of type TreeItem
.
*
* Note that although this class is a subclass of Composite
,
* it does not make sense to add Control
children to it,
* or set a layout on it.
*
*
* - Styles:
* - SINGLE, MULTI, CHECK
* - Events:
* - Selection, DefaultSelection, Collapse, Expand
*
*
* Note: Only one of the styles SINGLE and MULTI may be specified.
*
* IMPORTANT: This class is not intended to be subclassed.
*
*/
public class Tree extends Composite {
int modelHandle, checkRenderer;
TreeItem[] items;
ImageList imageList;
/**
* Constructs a new instance of this class given its parent
* and a style value describing its behavior and appearance.
*
* The style value is either one of the style constants defined in
* class SWT
which is applicable to instances of this
* class, or must be built by bitwise OR'ing together
* (that is, using the int
"|" operator) two or more
* of those SWT
style constants. The class description
* lists the style constants that are applicable to the class.
* Style bits are also inherited from superclasses.
*
*
* @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
* - ERROR_NULL_ARGUMENT - if the parent is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
* - ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
*
*
* @see SWT#SINGLE
* @see SWT#MULTI
* @see SWT#CHECK
* @see Widget#checkSubclass
* @see Widget#getStyle
*/
public Tree (Composite parent, int style) {
super (parent, checkStyle (style));
}
static int checkStyle (int style) {
style |= SWT.H_SCROLL | SWT.V_SCROLL;
return checkBits (style, SWT.SINGLE, SWT.MULTI, 0, 0, 0, 0);
}
/**
* Adds the listener to the collection of listeners who will
* be notified when the receiver's selection changes, by sending
* it one of the messages defined in the SelectionListener
* interface.
*
* When widgetSelected
is called, the item field of the event object is valid.
* If the reciever has SWT.CHECK
style set and the check selection changes,
* the event object detail field contains the value SWT.CHECK
.
* widgetDefaultSelected
is typically called when an item is double-clicked.
* The item field of the event object is valid for default selection, but the detail field is not used.
*
*
* @param listener the listener which should be notified
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see SelectionListener
* @see #removeSelectionListener
* @see SelectionEvent
*/
public void addSelectionListener(SelectionListener listener) {
checkWidget ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
TypedListener typedListener = new TypedListener (listener);
addListener (SWT.Selection, typedListener);
addListener (SWT.DefaultSelection, typedListener);
}
/**
* Adds the listener to the collection of listeners who will
* be notified when an item in the receiver is expanded or collapsed
* by sending it one of the messages defined in the TreeListener
* interface.
*
* @param listener the listener which should be notified
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see TreeListener
* @see #removeTreeListener
*/
public void addTreeListener(TreeListener listener) {
checkWidget ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
TypedListener typedListener = new TypedListener (listener);
addListener (SWT.Expand, typedListener);
addListener (SWT.Collapse, typedListener);
}
public Point computeSize (int wHint, int hHint, boolean changed) {
checkWidget ();
Point size = computeNativeSize (handle, wHint, hHint, changed);
Rectangle trim = computeTrim (0, 0, size.x, size.y);
size.x = trim.width;
size.y = trim.height;
return size;
}
void createHandle (int index) {
state |= HANDLE;
fixedHandle = OS.gtk_fixed_new ();
if (fixedHandle == 0) error (SWT.ERROR_NO_HANDLES);
OS.gtk_fixed_set_has_window (fixedHandle, true);
scrolledHandle = OS.gtk_scrolled_window_new (0, 0);
if (scrolledHandle == 0) error (SWT.ERROR_NO_HANDLES);
/*
* Columns:
* 0 - text
* 1 - pixmap
* 2 - foreground
* 3 - background
* 4 - id
* 5 - checked (if needed)
*/
int [] types = new int [(style & SWT.CHECK) !=0 ? 6 : 5];
types [0] = OS.G_TYPE_STRING ();
types [1] = OS.GDK_TYPE_PIXBUF ();
types [2] = OS.GDK_TYPE_COLOR ();
types [3] = OS.GDK_TYPE_COLOR ();
types [4] = OS.G_TYPE_INT ();
if ((style & SWT.CHECK) != 0) types [5] = OS.G_TYPE_BOOLEAN ();
modelHandle = OS.gtk_tree_store_newv (types.length, types);
if (modelHandle == 0) error (SWT.ERROR_NO_HANDLES);
handle = OS.gtk_tree_view_new_with_model (modelHandle);
if (handle == 0) error (SWT.ERROR_NO_HANDLES);
int columnHandle = OS.gtk_tree_view_column_new ();
if (columnHandle == 0) error (SWT.ERROR_NO_HANDLES);
if ((style & SWT.CHECK) != 0) {
checkRenderer = OS.gtk_cell_renderer_toggle_new ();
if (checkRenderer == 0) error (SWT.ERROR_NO_HANDLES);
OS.gtk_tree_view_column_pack_start (columnHandle, checkRenderer, false);
OS.gtk_tree_view_column_add_attribute (columnHandle, checkRenderer, "active", 5);
}
int pixbufRenderer = OS.gtk_cell_renderer_pixbuf_new ();
if (pixbufRenderer == 0) error (SWT.ERROR_NO_HANDLES);
OS.gtk_tree_view_column_pack_start (columnHandle, pixbufRenderer, false);
OS.gtk_tree_view_column_add_attribute (columnHandle, pixbufRenderer, "pixbuf", 1);
/*
* Feature on GTK. When a tree view column contains only one activatable
* cell renderer such as a toggle renderer, mouse clicks anywhere in a cell
* activate that renderer. The workaround is to set a second cell renderer
* to be activatable.
*/
if ((style & SWT.CHECK) != 0) {
OS.g_object_set (pixbufRenderer, OS.mode, OS.GTK_CELL_RENDERER_MODE_ACTIVATABLE);
}
int textRenderer = OS.gtk_cell_renderer_text_new ();
if (textRenderer == 0) error (SWT.ERROR_NO_HANDLES);
OS.gtk_tree_view_column_pack_start (columnHandle, textRenderer, true);
OS.gtk_tree_view_column_add_attribute (columnHandle, textRenderer, "text", 0);
OS.gtk_tree_view_column_add_attribute (columnHandle, textRenderer, "foreground-gdk", 2);
OS.gtk_tree_view_column_add_attribute (columnHandle, textRenderer, "background-gdk", 3);
OS.gtk_tree_view_insert_column (handle, columnHandle, 0);
int parentHandle = parent.parentingHandle ();
OS.gtk_container_add (parentHandle, fixedHandle);
OS.gtk_container_add (fixedHandle, scrolledHandle);
OS.gtk_container_add (scrolledHandle, handle);
OS.gtk_widget_show (fixedHandle);
OS.gtk_widget_show (scrolledHandle);
OS.gtk_widget_show (handle);
int mode = (style & SWT.MULTI) != 0 ? OS.GTK_SELECTION_MULTIPLE : OS.GTK_SELECTION_BROWSE;
int selectionHandle = OS.gtk_tree_view_get_selection (handle);
OS.gtk_tree_selection_set_mode (selectionHandle, mode);
OS.gtk_tree_view_set_headers_visible (handle, false);
int hsp = (style & SWT.H_SCROLL) != 0 ? OS.GTK_POLICY_AUTOMATIC : OS.GTK_POLICY_NEVER;
int vsp = (style & SWT.V_SCROLL) != 0 ? OS.GTK_POLICY_AUTOMATIC : OS.GTK_POLICY_NEVER;
OS.gtk_scrolled_window_set_policy (scrolledHandle, hsp, vsp);
if ((style & SWT.BORDER) != 0) OS.gtk_scrolled_window_set_shadow_type (scrolledHandle, OS.GTK_SHADOW_ETCHED_IN);
}
void createItem (TreeItem item, int iter, int index) {
if (index != -1) {
int count = OS.gtk_tree_model_iter_n_children (modelHandle, iter);
if (!(0 <= index && index <= count)) error (SWT.ERROR_INVALID_RANGE);
}
int id = 0;
while (id < items.length && items [id] != null) id++;
if (id == items.length) {
TreeItem [] newItems = new TreeItem [items.length + 4];
System.arraycopy (items, 0, newItems, 0, items.length);
items = newItems;
}
item.handle = OS.g_malloc (OS.GtkTreeIter_sizeof ());
if (item.handle == 0) error(SWT.ERROR_NO_HANDLES);
if (index == -1) {
OS.gtk_tree_store_append (modelHandle, item.handle, iter);
} else {
OS.gtk_tree_store_insert (modelHandle, item.handle, iter, index);
}
OS.gtk_tree_store_set (modelHandle, item.handle, 4, id, -1);
items [id] = item;
}
void createWidget (int index) {
super.createWidget (index);
items = new TreeItem [4];
}
GdkColor defaultBackground () {
Display display = getDisplay ();
return display.COLOR_LIST_BACKGROUND;
}
GdkColor defaultForeground () {
Display display = getDisplay ();
return display.COLOR_LIST_FOREGROUND;
}
void deregister () {
super.deregister ();
WidgetTable.remove (OS.gtk_tree_view_get_selection (handle));
if (checkRenderer != 0) WidgetTable.remove (checkRenderer);
}
/**
* Deselects all selected items in the receiver.
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public void deselectAll() {
checkWidget();
int selection = OS.gtk_tree_view_get_selection (handle);
OS.g_signal_handlers_block_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
OS.gtk_tree_selection_unselect_all (selection);
OS.g_signal_handlers_unblock_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
}
void destroyItem (TreeItem item) {
int [] index = new int [1];
releaseItems (item.getItems (), index);
releaseItem (item, index);
OS.gtk_tree_store_remove (modelHandle, item.handle);
}
void destroyWidget () {
/*
* Bug in GTK. Sometimes GTK causes a segment fault when a tree widget is
* destroyed and it has outstanding events or idle handlers. This only happens
* on versions earlier than 2.0.5. The fix is to flush all outstanding events before
* destroying the widget.
*/
if (OS.gtk_major_version () == 2 && OS.gtk_minor_version () == 0 && OS.gtk_micro_version () < 5) {
while (OS.gtk_events_pending () != 0) OS.gtk_main_iteration ();
}
super.destroyWidget ();
}
GdkColor getBackgroundColor () {
return getBaseColor ();
}
TreeItem getFocusItem () {
int [] path = new int [1];
OS.gtk_tree_view_get_cursor (handle, path, null);
if (path [0] == 0) return null;
int iter = OS.g_malloc (OS.GtkTreeIter_sizeof ());
OS.gtk_tree_model_get_iter (modelHandle, iter, path [0]);
int [] index = new int [1];
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
OS.g_free (iter);
OS.gtk_tree_path_free (path [0]);
return items [index [0]];
}
GdkColor getForegroundColor () {
return getTextColor ();
}
/**
* Returns the item at the given point in the receiver
* or null if no such item exists. The point is in the
* coordinate system of the receiver.
*
* @param point the point used to locate the item
* @return the item at the given point
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public TreeItem getItem (Point point) {
checkWidget ();
int [] path = new int [1];
if (!OS.gtk_tree_view_get_path_at_pos(handle, point.x, point.y, path, null, null, null)) return null;
if (path [0] == 0) return null;
int iter = OS.g_malloc (OS.GtkTreeIter_sizeof ());
OS.gtk_tree_model_get_iter (modelHandle, iter, path [0]);
int [] index = new int [1];
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
OS.g_free (iter);
return items [index [0]];
}
/**
* Returns the number of items contained in the receiver
* that are direct item children of the receiver. The
* number that is returned is the number of roots in the
* tree.
*
* @return the number of items
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public int getItemCount () {
checkWidget ();
return OS.gtk_tree_model_iter_n_children (modelHandle, 0);
}
/**
* Returns the height of the area which would be used to
* display one of the items in the tree.
*
* @return the height of one item
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public int getItemHeight () {
checkWidget ();
// FIXME
// I (bgs) am not sure what to do with this.
// In GTK2, rows may have different heights, so asking
// this question will only make sense given the item.
if (OS.gtk_tree_model_iter_n_children (modelHandle, 0) == 0) return 18;
GdkRectangle rect = new GdkRectangle ();
int path = OS.gtk_tree_path_new_first ();
OS.gtk_tree_view_get_cell_area (handle, path, 0, rect);
OS.gtk_tree_path_free (path);
return rect.height;
}
/**
* Returns the number of items contained in the receiver
* that are direct item children of the receiver. These
* are the roots of the tree.
*
* 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.
*
*
* @return the number of items
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public TreeItem [] getItems () {
checkWidget();
return getItems (0);
}
TreeItem [] getItems (int parent) {
int length = OS.gtk_tree_model_iter_n_children (modelHandle, parent);
TreeItem[] result = new TreeItem [length];
if (length == 0) return result;
int i = 0;
int[] index = new int [1];
int iter = OS.g_malloc (OS.GtkTreeIter_sizeof ());
boolean valid = OS.gtk_tree_model_iter_children (modelHandle, iter, parent);
while (valid) {
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
result [i++] = items [index [0]];
valid = OS.gtk_tree_model_iter_next (modelHandle, iter);
}
OS.g_free (iter);
return result;
}
/**
* Returns the receiver's parent item, which must be a
* TreeItem
or null when the receiver is a
* root.
*
* @return the receiver's parent item
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public TreeItem getParentItem () {
checkWidget ();
return null;
}
/**
* Returns an array of TreeItem
s that are currently
* selected in the receiver. An empty array indicates that no
* items are selected.
*
* Note: This is not the actual structure used by the receiver
* to maintain its selection, so modifying the array will
* not affect the receiver.
*
* @return an array representing the selection
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public TreeItem[] getSelection () {
checkWidget();
if ((style & SWT.MULTI) != 0) {
Display display = getDisplay ();
display.treeSelectionLength = 0;
display.treeSelection = new int [items.length];
int selection = OS.gtk_tree_view_get_selection (handle);
OS.gtk_tree_selection_selected_foreach (selection, display.treeSelectionProc, handle);
TreeItem [] result = new TreeItem [display.treeSelectionLength];
for (int i=0; i
* ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public int getSelectionCount () {
checkWidget();
Display display = getDisplay ();
display.treeSelectionLength = 0;
display.treeSelection = null;
int selection = OS.gtk_tree_view_get_selection (handle);
OS.gtk_tree_selection_selected_foreach (selection, display.treeSelectionProc, handle);
return display.treeSelectionLength;
}
int gtk_changed (int widget) {
TreeItem item = getFocusItem ();
if (item != null) {
Event event = new Event ();
event.item = item;
postEvent (SWT.Selection, event);
}
return 0;
}
int gtk_key_press_event (int widget, int eventPtr) {
int result = super.gtk_key_press_event (widget, eventPtr);
if (result != 0) return result;
/*
* Feature in GTK. When an item is default selected using
* the return key, GTK does not issue notification. The fix is
* to issue this notification when the return key is pressed.
*/
GdkEventKey keyEvent = new GdkEventKey ();
OS.memmove (keyEvent, eventPtr, GdkEventKey.sizeof);
int key = keyEvent.keyval;
switch (key) {
case OS.GDK_Return:
case OS.GDK_KP_Enter: {
Event event = new Event ();
event.item = getFocusItem ();
postEvent (SWT.DefaultSelection, event);
break;
}
}
return result;
}
int gtk_row_activated (int tree, int path, int column) {
int iter = OS.g_malloc (OS.GtkTreeIter_sizeof ());
OS.gtk_tree_model_get_iter (modelHandle, iter, path);
int [] index = new int [1];
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
OS.g_free (iter);
Event event = new Event ();
event.item = items [index [0]];
postEvent (SWT.DefaultSelection, event);
return 0;
}
int gtk_row_collapsed (int tree, int iter, int path) {
int [] index = new int [1];
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
Event event = new Event ();
event.item = items [index [0]];
sendEvent (SWT.Collapse, event);
return 0;
}
int gtk_row_expanded (int tree, int iter, int path) {
int [] index = new int [1];
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
Event event = new Event ();
event.item = items [index [0]];
sendEvent (SWT.Expand, event);
int selection = OS.gtk_tree_view_get_selection (handle);
OS.g_signal_handlers_block_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
OS.gtk_tree_view_expand_row (handle, path, false);
OS.g_signal_handlers_unblock_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
return 0;
}
int gtk_toggled (int renderer, int pathStr) {
int path = OS.gtk_tree_path_new_from_string (pathStr);
if (path == 0) return 0;
int iter = OS.g_malloc (OS.GtkTreeIter_sizeof());
OS.gtk_tree_model_get_iter (modelHandle, iter, path);
int [] index = new int [1];
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
OS.g_free (iter);
OS.gtk_tree_path_free (path);
TreeItem item = items [index [0]];
item.setChecked (!item.getChecked ());
Event event = new Event ();
event.detail = SWT.CHECK;
event.item = item;
postEvent (SWT.Selection, event);
return 0;
}
int gtk_button_press_event (int widget, int event) {
int result = super.gtk_button_press_event (widget, event);
if (result != 0) return result;
/*
* Note on GTK. When multiple items are already selected, the default handler
* toggles the selection state of the item and clears any former selection.
* This is not the desired behaviour when bringing up a popup menu. The
* workaround is to detect that case and not run the default handler when the
* item is already part of the current selection.
*/
if (menu != null && (style & SWT.MULTI) != 0) {
GdkEventButton gdkEvent = new GdkEventButton ();
OS.memmove (gdkEvent, event, GdkEventButton.sizeof);
int button = gdkEvent.button;
if (button == 3 && gdkEvent.type == OS.GDK_BUTTON_PRESS) {
int [] path = new int [1];
if (OS.gtk_tree_view_get_path_at_pos (handle, (int)gdkEvent.x, (int)gdkEvent.y, path, null, null, null)) {
if (path [0] != 0) {
int selection = OS.gtk_tree_view_get_selection (handle);
if (OS.gtk_tree_selection_path_is_selected (selection, path [0])) result = 1;
OS.gtk_tree_path_free (path [0]);
}
}
}
}
return result;
}
void hookEvents () {
super.hookEvents ();
Display display = getDisplay ();
int selection = OS.gtk_tree_view_get_selection(handle);
OS.g_signal_connect_after (selection, OS.changed, display.windowProc2, CHANGED);
OS.g_signal_connect (handle, OS.row_activated, display.windowProc4, ROW_ACTIVATED);
OS.g_signal_connect (handle, OS.row_expanded, display.windowProc4, ROW_EXPANDED);
OS.g_signal_connect (handle, OS.row_collapsed, display.windowProc4, ROW_COLLAPSED);
if (checkRenderer != 0) {
OS.g_signal_connect (checkRenderer, OS.toggled, display.windowProc3, TOGGLED);
}
}
int paintWindow () {
OS.gtk_widget_realize (handle);
return OS.gtk_tree_view_get_bin_window (handle);
}
void register () {
super.register ();
WidgetTable.put (OS.gtk_tree_view_get_selection (handle), this);
if (checkRenderer != 0) WidgetTable.put (checkRenderer, this);
}
boolean releaseItem (TreeItem item, int [] index) {
if (item.isDisposed ()) return false;
OS.gtk_tree_model_get (modelHandle, item.handle, 4, index, -1);
items [index [0]] = null;
return true;
}
void releaseItems (TreeItem [] nodes, int [] index) {
for (int i=0; i
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public void removeAll () {
checkWidget ();
OS.gtk_tree_store_clear (modelHandle);
for (int i=0; i
* ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see SelectionListener
* @see #addSelectionListener
*/
public void removeSelectionListener (SelectionListener listener) {
checkWidget ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
eventTable.unhook (SWT.Selection, listener);
eventTable.unhook (SWT.DefaultSelection, listener);
}
/**
* Removes the listener from the collection of listeners who will
* be notified when items in the receiver are expanded or collapsed..
*
* @param listener the listener which should no longer be notified
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see TreeListener
* @see #addTreeListener
*/
public void removeTreeListener(TreeListener listener) {
checkWidget ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
if (eventTable == null) return;
eventTable.unhook (SWT.Expand, listener);
eventTable.unhook (SWT.Collapse, listener);
}
public void setInsertMark (TreeItem item, boolean set) {
checkWidget ();
//NOT IMPLEMENTED
}
/**
* Selects all the items in the receiver.
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*/
public void selectAll () {
checkWidget();
int selection = OS.gtk_tree_view_get_selection (handle);
OS.g_signal_handlers_block_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
OS.gtk_tree_selection_select_all (OS.gtk_tree_view_get_selection (handle));
OS.g_signal_handlers_unblock_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
}
void setBackgroundColor (GdkColor color) {
super.setBackgroundColor (color);
OS.gtk_widget_modify_base (handle, 0, color);
}
void setForegroundColor (GdkColor color) {
super.setForegroundColor (color);
OS.gtk_widget_modify_text (handle, 0, color);
}
/**
* Sets the receiver's selection to be the given array of items.
* The current selected is first cleared, then the new items are
* selected.
*
* @param items the array of items
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the array of items is null
* - ERROR_INVALID_ARGUMENT - if one of the item has been disposed
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see Tree#deselectAll()
*/
public void setSelection (TreeItem [] items) {
checkWidget();
if (items == null) error (SWT.ERROR_NULL_ARGUMENT);
int selection = OS.gtk_tree_view_get_selection (handle);
OS.g_signal_handlers_block_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
OS.gtk_tree_selection_unselect_all (selection);
int i = 0;
boolean first = true;
while (i < items.length) {
TreeItem item = items [i];
if (item == null) continue;
if (item.isDisposed ()) break;
if (first) {
int path = OS.gtk_tree_model_get_path (modelHandle, item.handle);
showItem (path);
OS.gtk_tree_view_set_cursor (handle, path, 0, false);
OS.gtk_tree_path_free (path);
first = false;
}
OS.gtk_tree_selection_select_iter (selection, item.handle);
i++;
}
OS.g_signal_handlers_unblock_matched (selection, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CHANGED);
if (i < items.length) error (SWT.ERROR_INVALID_ARGUMENT);
}
/**
* Shows the selection. If the selection is already showing in the receiver,
* this method simply returns. Otherwise, the items are scrolled until
* the selection is visible.
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see Tree#showItem(TreeItem)
*/
public void showSelection () {
checkWidget();
TreeItem [] items = getSelection ();
if (items.length == 0 && items [0] != null) showItem (items [0]);
}
void showItem (int path) {
int depth = OS.gtk_tree_path_get_depth (path);
if (depth > 1) {
int [] indices = new int [depth - 1];
int indicesPtr = OS.gtk_tree_path_get_indices (path);
OS.memmove (indices, indicesPtr, indices.length * 4);
int tempPath = OS.gtk_tree_path_new ();
for (int i=0; i
* ERROR_NULL_ARGUMENT - if the item is null
* ERROR_INVALID_ARGUMENT - if the item has been disposed
*
* @exception SWTException
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see Tree#showSelection()
*/
public void showItem (TreeItem item) {
checkWidget ();
if (item == null) error (SWT.ERROR_NULL_ARGUMENT);
if (item.isDisposed ()) error(SWT.ERROR_INVALID_ARGUMENT);
int path = OS.gtk_tree_model_get_path (modelHandle, item.handle);
showItem (path);
OS.gtk_tree_path_free (path);
}
int treeSelectionProc (int model, int path, int iter, int[] selection, int length) {
if (selection != null) {
int [] index = new int [1];
OS.gtk_tree_model_get (modelHandle, iter, 4, index, -1);
selection [length] = index [0];
}
return 0;
}
}