/******************************************************************************* * Copyright (c) 2000, 2011 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ package org.eclipse.swt.widgets; import org.eclipse.swt.internal.carbon.CFRange; import org.eclipse.swt.internal.carbon.OS; import org.eclipse.swt.internal.carbon.DataBrowserCallbacks; import org.eclipse.swt.internal.carbon.DataBrowserCustomCallbacks; import org.eclipse.swt.internal.carbon.DataBrowserListViewColumnDesc; import org.eclipse.swt.internal.carbon.DataBrowserListViewHeaderDesc; import org.eclipse.swt.internal.carbon.DataBrowserAccessibilityItemInfo; import org.eclipse.swt.internal.carbon.HMHelpContentRec; import org.eclipse.swt.internal.carbon.Rect; import org.eclipse.swt.internal.carbon.CGPoint; import org.eclipse.swt.*; import org.eclipse.swt.events.*; import org.eclipse.swt.graphics.*; /** * Instances of this class implement a selectable user interface * object that displays a list of images and strings and issues * notification when selected. * <p> * The item children that may be added to instances of this class * must be of type <code>TableItem</code>. * </p><p> * Style <code>VIRTUAL</code> is used to create a <code>Table</code> whose * <code>TableItem</code>s are to be populated by the client on an on-demand basis * instead of up-front. This can provide significant performance improvements for * tables that are very large or for which <code>TableItem</code> population is * expensive (for example, retrieving values from an external source). * </p><p> * Here is an example of using a <code>Table</code> with style <code>VIRTUAL</code>: * <code><pre> * final Table table = new Table (parent, SWT.VIRTUAL | SWT.BORDER); * table.setItemCount (1000000); * table.addListener (SWT.SetData, new Listener () { * public void handleEvent (Event event) { * TableItem item = (TableItem) event.item; * int index = table.indexOf (item); * item.setText ("Item " + index); * System.out.println (item.getText ()); * } * }); * </pre></code> * </p><p> * Note that although this class is a subclass of <code>Composite</code>, * it does not normally make sense to add <code>Control</code> children to * it, or set a layout on it, unless implementing something like a cell * editor. * </p><p> * <dl> * <dt><b>Styles:</b></dt> * <dd>SINGLE, MULTI, CHECK, FULL_SELECTION, HIDE_SELECTION, VIRTUAL, NO_SCROLL</dd> * <dt><b>Events:</b></dt> * <dd>Selection, DefaultSelection, SetData, MeasureItem, EraseItem, PaintItem</dd> * </dl> * </p><p> * Note: Only one of the styles SINGLE, and MULTI may be specified. * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * * @see <a href="http://www.eclipse.org/swt/snippets/#table">Table, TableItem, TableColumn snippets</a> * @see <a href="http://www.eclipse.org/swt/examples.php">SWT Example: ControlExample</a> * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * @noextend This class is not intended to be subclassed by clients. */ public class Table extends Composite { TableItem [] items; TableColumn [] columns; TableItem currentItem; TableColumn sortColumn; GC paintGC; int sortDirection; int itemCount, columnCount, column_id, idCount, anchorFirst, anchorLast, savedAnchor, headerHeight, lastIndexOf; boolean ignoreSelect, wasSelected, fixScrollWidth, drawBackground; Rectangle imageBounds; int showIndex, lastHittest, lastHittestColumn; static final int CHECK_COLUMN_ID = 1024; static final int COLUMN_ID = 1025; static final int GRID_WIDTH = 1; static final int ICON_AND_TEXT_GAP = 4; static final int CELL_CONTENT_INSET = 12; static final int BORDER_INSET = 1; static final String [] AX_ATTRIBUTES = { OS.kAXChildrenAttribute, OS.kAXTitleAttribute, }; /** * Constructs a new instance of this class given its parent * and a style value describing its behavior and appearance. * <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#SINGLE * @see SWT#MULTI * @see SWT#CHECK * @see SWT#FULL_SELECTION * @see SWT#HIDE_SELECTION * @see SWT#VIRTUAL * @see SWT#NO_SCROLL * @see Widget#checkSubclass * @see Widget#getStyle */ public Table (Composite parent, int style) { super (parent, checkStyle (style)); } /** * Adds the listener to the collection of listeners who will * be notified when the user changes the receiver's selection, by sending * it one of the messages defined in the <code>SelectionListener</code> * interface. * <p> * When <code>widgetSelected</code> is called, the item field of the event object is valid. * If the receiver has the <code>SWT.CHECK</code> style and the check selection changes, * the event object detail field contains the value <code>SWT.CHECK</code>. * <code>widgetDefaultSelected</code> 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. * </p> * * @param listener the listener which should be notified when the user changes the receiver's selection * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</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> * * @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); } void _addListener (int eventType, Listener listener) { super._addListener (eventType, listener); for (int i = 0; i < items.length; i++) { if (items [i] != null) items [i].width = -1; } } TableItem _getItem (int index) { if ((style & SWT.VIRTUAL) == 0) return items [index]; if (items [index] != null) return items [index]; return items [index] = new TableItem (this, SWT.NULL, -1, false); } int callPaintEventHandler (int control, int damageRgn, int visibleRgn, int theEvent, int nextHandler) { /* * Feature in the Macintosh. The draw item proc is not called if the column width * is zero. This means that the SWT.MeasureItem listener is not called and the column * does not get wider ever. The fix is to change the column width to one. */ if (columnCount == 0 && (hooks (SWT.MeasureItem) || hooks (SWT.EraseItem) || hooks (SWT.PaintItem))) { short [] width = new short [1]; OS.GetDataBrowserTableViewNamedColumnWidth (handle, column_id, width); if (width [0] == 0) { OS.SetDataBrowserTableViewNamedColumnWidth (handle, column_id, (short) 1); } } GC currentGC = paintGC; if (currentGC == null) { GCData data = new GCData (); data.paintEvent = theEvent; data.visibleRgn = visibleRgn; paintGC = GC.carbon_new (this, data); } fixScrollWidth = false; drawBackground = findBackgroundControl () != null; int result = super.callPaintEventHandler (control, damageRgn, visibleRgn, theEvent, nextHandler); if (itemCount == 0 && drawBackground) { drawBackground = false; Rectangle rect = getClientArea (); int headerHeight = getHeaderHeight (); rect.y += headerHeight; rect.height -= headerHeight; fillBackground (handle, paintGC.handle, rect); } if (fixScrollWidth) { fixScrollWidth = false; if (setScrollWidth (items, true)) redraw (); } if (currentGC == null) { paintGC.dispose (); paintGC = null; } return result; } boolean checkData (TableItem item, boolean redraw) { if (item.cached) return true; if ((style & SWT.VIRTUAL) != 0) { item.cached = true; Event event = new Event (); event.item = item; event.index = indexOf (item); currentItem = item; sendEvent (SWT.SetData, event); //widget could be disposed at this point currentItem = null; if (isDisposed () || item.isDisposed ()) return false; if (redraw) { if (!setScrollWidth (item)) item.redraw (OS.kDataBrowserNoItem); } } return true; } void checkItems (boolean setScrollWidth) { int [] count = new int [1]; if (OS.GetDataBrowserItemCount (handle, OS.kDataBrowserNoItem, true, OS.kDataBrowserItemAnyState, count) != OS.noErr) { error (SWT.ERROR_CANNOT_GET_COUNT); } if (itemCount != count [0]) { /* * Feature in the Mac. When AddDataBrowserItems() is used * to add items, item notification callbacks are issued with * the message kDataBrowserItemAdded. When many items are * added, this is slow. The fix is to temporarily remove * the item notification callback. */ DataBrowserCallbacks callbacks = new DataBrowserCallbacks (); OS.GetDataBrowserCallbacks (handle, callbacks); callbacks.v1_itemNotificationCallback = 0; OS.SetDataBrowserCallbacks (handle, callbacks); int delta = itemCount - count [0]; if (delta < 1024) { int [] ids = new int [delta]; for (int i=0; i<ids.length; i++) { ids [i] = count [0] + i + 1; } if (OS.AddDataBrowserItems (handle, OS.kDataBrowserNoItem, ids.length, ids, OS.kDataBrowserItemNoProperty) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_ADDED); } OS.UpdateDataBrowserItems (handle, 0, 0, null, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); } else { if (OS.AddDataBrowserItems (handle, 0, itemCount, null, OS.kDataBrowserItemNoProperty) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_ADDED); } } callbacks.v1_itemNotificationCallback = display.itemNotificationProc; OS.SetDataBrowserCallbacks (handle, callbacks); } if (setScrollWidth) setScrollWidth (items, true); } static int checkStyle (int style) { /* * Feature in Windows. Even when WS_HSCROLL or * WS_VSCROLL is not specified, Windows creates * trees and tables with scroll bars. The fix * is to set H_SCROLL and V_SCROLL. * * NOTE: This code appears on all platforms so that * applications have consistent scroll bar behavior. */ if ((style & SWT.NO_SCROLL) == 0) { style |= SWT.H_SCROLL | SWT.V_SCROLL; } return checkBits (style, SWT.SINGLE, SWT.MULTI, 0, 0, 0, 0); } protected void checkSubclass () { if (!isValidSubclass ()) error (SWT.ERROR_INVALID_SUBCLASS); } /** * Clears the item at the given zero-relative index in the receiver. * The text, icon and other attributes of the item are set to the default * value. If the table was created with the <code>SWT.VIRTUAL</code> style, * these attributes are requested again as needed. * * @param index the index of the item to clear * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list minus 1 (inclusive)</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> * * @see SWT#VIRTUAL * @see SWT#SetData * * @since 3.0 */ public void clear (int index) { checkWidget(); if (!(0 <= index && index < itemCount)) error (SWT.ERROR_INVALID_RANGE); TableItem item = items [index]; if (item != null) { if (currentItem != item) item.clear (); if (currentItem == null && getDrawing ()) { int [] id = new int [] {getId (index)}; OS.UpdateDataBrowserItems (handle, 0, id.length, id, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); } setScrollWidth (item); } } /** * Removes the items from the receiver which are between the given * zero-relative start and end indices (inclusive). The text, icon * and other attributes of the items are set to their default values. * If the table was created with the <code>SWT.VIRTUAL</code> style, * these attributes are requested again as needed. * * @param start the start index of the item to clear * @param end the end index of the item to clear * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if either the start or end are not between 0 and the number of elements in the list minus 1 (inclusive)</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> * * @see SWT#VIRTUAL * @see SWT#SetData * * @since 3.0 */ public void clear (int start, int end) { checkWidget(); if (start > end) return; if (!(0 <= start && start <= end && end < itemCount)) { error (SWT.ERROR_INVALID_RANGE); } if (start == 0 && end == itemCount - 1) { clearAll (); } else { for (int i=start; i<=end; i++) { clear (i); } } } /** * Clears the items at the given zero-relative indices in the receiver. * The text, icon and other attributes of the items are set to their default * values. If the table was created with the <code>SWT.VIRTUAL</code> style, * these attributes are requested again as needed. * * @param indices the array of indices of the items * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list minus 1 (inclusive)</li> * <li>ERROR_NULL_ARGUMENT - if the indices array is null</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> * * @see SWT#VIRTUAL * @see SWT#SetData * * @since 3.0 */ public void clear (int [] indices) { checkWidget(); if (indices == null) error (SWT.ERROR_NULL_ARGUMENT); if (indices.length == 0) return; for (int i=0; i<indices.length; i++) { if (!(0 <= indices [i] && indices [i] < itemCount)) { error (SWT.ERROR_INVALID_RANGE); } } for (int i=0; i<indices.length; i++) { clear (indices [i]); } } /** * Clears all the items in the receiver. The text, icon and other * attributes of the items are set to their default values. If the * table was created with the <code>SWT.VIRTUAL</code> style, these * attributes are requested again as needed. * * @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> * * @see SWT#VIRTUAL * @see SWT#SetData * * @since 3.0 */ public void clearAll () { checkWidget(); for (int i=0; i<itemCount; i++) { TableItem item = items [i]; if (item != null) item.clear (); } if (currentItem == null && getDrawing ()) { OS.UpdateDataBrowserItems (handle, 0, 0, null, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); } setScrollWidth (items, true); } public Point computeSize (int wHint, int hHint, boolean changed) { checkWidget(); int width = 0; if (wHint == SWT.DEFAULT) { if (columnCount != 0) { for (int i=0; i<columnCount; i++) { width += columns [i].getWidth (); } } else { int columnWidth = 0; GC gc = new GC (this); for (int i=0; i<itemCount; i++) { TableItem item = items [i]; if (item != null) { columnWidth = Math.max (columnWidth, item.calculateWidth (0, gc)); } } gc.dispose (); width += columnWidth + getInsetWidth (); } if ((style & SWT.CHECK) != 0) width += getCheckColumnWidth (); } else { width = wHint; } if (width <= 0) width = DEFAULT_WIDTH; int height = 0; if (hHint == SWT.DEFAULT) { height = itemCount * getItemHeight () + getHeaderHeight(); } else { height = hHint; } if (height <= 0) height = DEFAULT_HEIGHT; Rectangle rect = computeTrim (0, 0, width, height); return new Point (rect.width, rect.height); } public Rectangle computeTrim (int x, int y, int width, int height) { checkWidget(); int border = getBorderWidth (); Rect rect = new Rect (); OS.GetDataBrowserScrollBarInset (handle, rect); x -= rect.left + border; y -= rect.top + border; width += rect.left + rect.right + border + border; height += rect.top + rect.bottom + border + border; return new Rectangle (x, y, width, height); } boolean contains(int shellX, int shellY) { CGPoint pt = new CGPoint (); int [] contentView = new int [1]; OS.HIViewFindByID (OS.HIViewGetRoot (OS.GetControlOwner (handle)), OS.kHIViewWindowContentID (), contentView); OS.HIViewConvertPoint (pt, handle, contentView [0]); int x = shellX - (int) pt.x; int y = shellY - (int) pt.y; if (y < getHeaderHeight ()) return false; return getClientArea ().contains (x, y); } void createHandle () { column_id = COLUMN_ID; int [] outControl = new int [1]; int window = OS.GetControlOwner (parent.handle); OS.CreateDataBrowserControl (window, null, OS.kDataBrowserListView, outControl); OS.SetAutomaticControlDragTrackingEnabledForWindow (window, true); if (outControl [0] == 0) error (SWT.ERROR_NO_HANDLES); handle = outControl [0]; if (!drawFocusRing ()) { OS.SetControlData (handle, OS.kControlEntireControl, OS.kControlDataBrowserIncludesFrameAndFocusTag, 1, new byte[] {0}); } int selectionFlags = (style & SWT.SINGLE) != 0 ? OS.kDataBrowserSelectOnlyOne | OS.kDataBrowserNeverEmptySelectionSet : OS.kDataBrowserCmdTogglesSelection; OS.SetDataBrowserSelectionFlags (handle, selectionFlags); short [] height = new short [1]; OS.GetDataBrowserListViewHeaderBtnHeight (handle, height); headerHeight = height [0]; OS.SetDataBrowserListViewHeaderBtnHeight (handle, (short) 0); OS.SetDataBrowserHasScrollBars (handle, (style & SWT.H_SCROLL) != 0, (style & SWT.V_SCROLL) != 0); if (OS.VERSION >= 0x1040) { OS.DataBrowserSetMetric (handle, OS.kDataBrowserMetricCellContentInset, false, 4); } int position = 0; if ((style & SWT.CHECK) != 0) { DataBrowserListViewColumnDesc checkColumn = new DataBrowserListViewColumnDesc (); checkColumn.headerBtnDesc_version = OS.kDataBrowserListViewLatestHeaderDesc; checkColumn.propertyDesc_propertyID = CHECK_COLUMN_ID; checkColumn.propertyDesc_propertyType = OS.kDataBrowserCheckboxType; checkColumn.propertyDesc_propertyFlags = OS.kDataBrowserPropertyIsMutable; int checkWidth = getCheckColumnWidth (); checkColumn.headerBtnDesc_minimumWidth = (short) checkWidth; checkColumn.headerBtnDesc_maximumWidth = (short) checkWidth; checkColumn.headerBtnDesc_initialOrder = (short) OS.kDataBrowserOrderIncreasing; OS.AddDataBrowserListViewColumn (handle, checkColumn, position++); } DataBrowserListViewColumnDesc column = new DataBrowserListViewColumnDesc (); column.headerBtnDesc_version = OS.kDataBrowserListViewLatestHeaderDesc; column.propertyDesc_propertyID = column_id; column.propertyDesc_propertyType = OS.kDataBrowserCustomType; column.propertyDesc_propertyFlags = OS.kDataBrowserListViewSelectionColumn | OS.kDataBrowserDefaultPropertyFlags | OS.kDataBrowserListViewSortableColumn; column.headerBtnDesc_maximumWidth = 0x7fff; column.headerBtnDesc_initialOrder = (short) OS.kDataBrowserOrderIncreasing; OS.AddDataBrowserListViewColumn (handle, column, position); OS.SetDataBrowserTableViewNamedColumnWidth (handle, column_id, (short) 0); /* * Feature in the Macintosh. Scroll bars are not created until * the data browser needs to draw them. The fix is to force the scroll * bars to be created by temporarily giving the widget a size, drawing * it on a offscreen buffer to avoid flashes and then restoring it to * size zero. */ if (OS.VERSION < 0x1040) { OS.HIViewSetDrawingEnabled (handle, false); int size = 50; Rect rect = new Rect (); rect.right = rect.bottom = (short) size; OS.SetControlBounds (handle, rect); int bpl = size * 4; int [] gWorld = new int [1]; int data = OS.NewPtr (bpl * size); OS.NewGWorldFromPtr (gWorld, OS.k32ARGBPixelFormat, rect, 0, 0, 0, data, bpl); int [] curPort = new int [1]; int [] curGWorld = new int [1]; OS.GetGWorld (curPort, curGWorld); OS.SetGWorld (gWorld [0], curGWorld [0]); OS.DrawControlInCurrentPort (handle); OS.SetGWorld (curPort [0], curGWorld [0]); OS.DisposeGWorld (gWorld [0]); OS.DisposePtr (data); rect.right = rect.bottom = (short) 0; OS.SetControlBounds (handle, rect); OS.HIViewSetDrawingEnabled (handle, true); } } void createItem (TableColumn column, int index) { if (!(0 <= index && index <= columnCount)) error (SWT.ERROR_INVALID_RANGE); column.id = column_id + idCount++; int position = index + ((style & SWT.CHECK) != 0 ? 1 : 0); if (columnCount != 0) { DataBrowserListViewColumnDesc desc = new DataBrowserListViewColumnDesc (); desc.headerBtnDesc_version = OS.kDataBrowserListViewLatestHeaderDesc; desc.propertyDesc_propertyID = column.id; desc.propertyDesc_propertyType = OS.kDataBrowserCustomType; desc.propertyDesc_propertyFlags = OS.kDataBrowserListViewSelectionColumn | OS.kDataBrowserDefaultPropertyFlags | OS.kDataBrowserListViewSortableColumn; desc.headerBtnDesc_maximumWidth = 0x7fff; desc.headerBtnDesc_initialOrder = OS.kDataBrowserOrderIncreasing; desc.headerBtnDesc_btnFontStyle_just = OS.teFlushLeft; if ((style & SWT.CENTER) != 0) desc.headerBtnDesc_btnFontStyle_just = OS.teCenter; if ((style & SWT.RIGHT) != 0) desc.headerBtnDesc_btnFontStyle_just = OS.teFlushRight; desc.headerBtnDesc_btnFontStyle_flags |= OS.kControlUseJustMask; OS.AddDataBrowserListViewColumn (handle, desc, position); OS.SetDataBrowserTableViewNamedColumnWidth (handle, column.id, (short)0); } if (columnCount == columns.length) { TableColumn [] newColumns = new TableColumn [columnCount + 4]; System.arraycopy (columns, 0, newColumns, 0, columns.length); columns = newColumns; } System.arraycopy (columns, index, columns, index + 1, columnCount++ - index); columns [index] = column; if (columnCount > 1) { for (int i=0; i<itemCount; i++) { TableItem item = items [i]; if (item != null) { String [] strings = item.strings; if (strings != null) { String [] temp = new String [columnCount]; System.arraycopy (strings, 0, temp, 0, index); System.arraycopy (strings, index, temp, index+1, columnCount-index-1); temp [index] = ""; item.strings = temp; } if (index == 0) item.text = ""; Image [] images = item.images; if (images != null) { Image [] temp = new Image [columnCount]; System.arraycopy (images, 0, temp, 0, index); System.arraycopy (images, index, temp, index+1, columnCount-index-1); item.images = temp; } if (index == 0) item.image = null; Color [] cellBackground = item.cellBackground; if (cellBackground != null) { Color [] temp = new Color [columnCount]; System.arraycopy (cellBackground, 0, temp, 0, index); System.arraycopy (cellBackground, index, temp, index+1, columnCount-index-1); item.cellBackground = temp; } Color [] cellForeground = item.cellForeground; if (cellForeground != null) { Color [] temp = new Color [columnCount]; System.arraycopy (cellForeground, 0, temp, 0, index); System.arraycopy (cellForeground, index, temp, index+1, columnCount-index-1); item.cellForeground = temp; } Font [] cellFont = item.cellFont; if (cellFont != null) { Font [] temp = new Font [columnCount]; System.arraycopy (cellFont, 0, temp, 0, index); System.arraycopy (cellFont, index, temp, index+1, columnCount-index-1); item.cellFont = temp; } } } } int [] lastPosition = new int [1]; for (int i=0; i<columnCount; i++) { TableColumn c = columns [i]; OS.GetDataBrowserTableViewColumnPosition (handle, c.id, lastPosition); c.lastPosition = lastPosition [0]; } } void createItem (TableItem item, int index) { if (!(0 <= index && index <= itemCount)) error (SWT.ERROR_INVALID_RANGE); if (savedAnchor != 0) { int savedIndex = getIndex (savedAnchor); if (index <= savedIndex) { savedAnchor = getId (Math.min (itemCount - 1, savedIndex + 1)); } } boolean add = getDrawing () || index != itemCount; if (add) { checkItems (false); int [] id = new int [] {itemCount + 1}; if (OS.AddDataBrowserItems (handle, OS.kDataBrowserNoItem, 1, id, OS.kDataBrowserItemNoProperty) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_ADDED); } if (index != itemCount) fixSelection (index, true); } if (itemCount == items.length) { /* Grow the array faster when redraw is off */ int length = getDrawing () ? items.length + 4 : Math.max (4, items.length * 3 / 2); TableItem [] newItems = new TableItem [length]; System.arraycopy (items, 0, newItems, 0, items.length); items = newItems; } System.arraycopy (items, index, items, index + 1, itemCount++ - index); items [index] = item; if (add) OS.UpdateDataBrowserItems (handle, 0, 0, null, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); } ScrollBar createScrollBar (int style) { return createStandardBar (style); } void createWidget () { super.createWidget (); items = new TableItem [4]; columns = new TableColumn [4]; showIndex = -1; if (OS.VERSION >= 0x1050) { OS.DataBrowserChangeAttributes (handle, OS.kDataBrowserAttributeAutoHideScrollBars, 0); } } Color defaultBackground () { return display.getSystemColor (SWT.COLOR_LIST_BACKGROUND); } Color defaultForeground () { return display.getSystemColor (SWT.COLOR_LIST_FOREGROUND); } int defaultThemeFont () { if (display.smallFonts) return OS.kThemeSmallSystemFont; return OS.kThemeViewsFont; } /** * Deselects the item at the given zero-relative index in the receiver. * If the item at the index was already deselected, it remains * deselected. Indices that are out of range are ignored. * * @param index the index of the item to deselect * * @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 deselect (int index) { checkWidget(); if (0 <= index && index < itemCount) { int [] ids = new int [] {getId (index)}; deselect (ids, ids.length); } } /** * Deselects the items at the given zero-relative indices in the receiver. * If the item at the given zero-relative index in the receiver * is selected, it is deselected. If the item at the index * was not selected, it remains deselected. The range of the * indices is inclusive. Indices that are out of range are ignored. * * @param start the start index of the items to deselect * @param end the end index of the items to deselect * * @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 deselect (int start, int end) { checkWidget(); //TODO - check range if (start == 0 && end == itemCount - 1) { deselectAll (); } else { int length = end - start + 1; if (length <= 0) return; int [] ids = new int [length]; for (int i=0; i<length; i++) ids [i] = getId (end - i); deselect (ids, length); } } /** * Deselects the items at the given zero-relative indices in the receiver. * If the item at the given zero-relative index in the receiver * is selected, it is deselected. If the item at the index * was not selected, it remains deselected. Indices that are out * of range and duplicate indices are ignored. * * @param indices the array of indices for the items to deselect * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the set of indices is null</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> */ public void deselect (int [] indices) { checkWidget(); if (indices == null) error (SWT.ERROR_NULL_ARGUMENT); //TODO - check range int length = indices.length; int [] ids = new int [length]; for (int i=0; i<length; i++) ids [i] = getId (indices [length - i - 1]); deselect (ids, length); } void deselect (int [] ids, int count) { ignoreSelect = true; /* * Bug in the Macintosh. When the DataBroswer selection flags includes * both kDataBrowserNeverEmptySelectionSet and kDataBrowserSelectOnlyOne, * two items are selected when SetDataBrowserSelectedItems() is called * with kDataBrowserItemsAssign to assign a new seletion despite the fact * that kDataBrowserSelectOnlyOne was specified. The fix is to save and * restore kDataBrowserNeverEmptySelectionSet around each call to * SetDataBrowserSelectedItems(). */ int [] selectionFlags = null; if ((style & SWT.SINGLE) != 0) { selectionFlags = new int [1]; OS.GetDataBrowserSelectionFlags (handle, selectionFlags); OS.SetDataBrowserSelectionFlags (handle, selectionFlags [0] & ~OS.kDataBrowserNeverEmptySelectionSet); } OS.SetDataBrowserSelectedItems (handle, count, ids, OS.kDataBrowserItemsRemove); if ((style & SWT.SINGLE) != 0) { OS.SetDataBrowserSelectionFlags (handle, selectionFlags [0]); } ignoreSelect = false; } /** * Deselects all selected items in the receiver. * * @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 deselectAll () { checkWidget (); deselect (null, 0); } void destroyItem (TableColumn column) { int index = 0; while (index < columnCount) { if (columns [index] == column) break; index++; } for (int i=0; i<itemCount; i++) { TableItem item = items [i]; if (item != null) { if (columnCount <= 1) { item.strings = null; item.images = null; item.cellBackground = null; item.cellForeground = null; item.cellFont = null; } else { if (item.strings != null) { String [] strings = item.strings; if (index == 0) { item.text = strings [1] != null ? strings [1] : ""; } String [] temp = new String [columnCount - 1]; System.arraycopy (strings, 0, temp, 0, index); System.arraycopy (strings, index + 1, temp, index, columnCount - 1 - index); item.strings = temp; } else { if (index == 0) item.text = ""; } if (item.images != null) { Image [] images = item.images; if (index == 0) item.image = images [1]; Image [] temp = new Image [columnCount - 1]; System.arraycopy (images, 0, temp, 0, index); System.arraycopy (images, index + 1, temp, index, columnCount - 1 - index); item.images = temp; } else { if (index == 0) item.image = null; } if (item.cellBackground != null) { Color [] cellBackground = item.cellBackground; Color [] temp = new Color [columnCount - 1]; System.arraycopy (cellBackground, 0, temp, 0, index); System.arraycopy (cellBackground, index + 1, temp, index, columnCount - 1 - index); item.cellBackground = temp; } if (item.cellForeground != null) { Color [] cellForeground = item.cellForeground; Color [] temp = new Color [columnCount - 1]; System.arraycopy (cellForeground, 0, temp, 0, index); System.arraycopy (cellForeground, index + 1, temp, index, columnCount - 1 - index); item.cellForeground = temp; } if (item.cellFont != null) { Font [] cellFont = item.cellFont; Font [] temp = new Font [columnCount - 1]; System.arraycopy (cellFont, 0, temp, 0, index); System.arraycopy (cellFont, index + 1, temp, index, columnCount - 1 - index); item.cellFont = temp; } } } } if (columnCount == 1) { column_id = column.id; idCount = 0; DataBrowserListViewHeaderDesc desc = new DataBrowserListViewHeaderDesc (); desc.version = OS.kDataBrowserListViewLatestHeaderDesc; short [] width = new short [1]; OS.GetDataBrowserTableViewNamedColumnWidth (handle, column_id, width); desc.minimumWidth = desc.maximumWidth = width [0]; int str = OS.CFStringCreateWithCharacters (OS.kCFAllocatorDefault, null, 0); desc.titleString = str; OS.SetDataBrowserListViewHeaderDesc (handle, column_id, desc); OS.CFRelease (str); } else { if (OS.RemoveDataBrowserTableViewColumn (handle, column.id) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_REMOVED); } } System.arraycopy (columns, index + 1, columns, index, --columnCount - index); columns [columnCount] = null; for (int i=index; i<columnCount; i++) { columns [i].sendEvent (SWT.Move); } } void destroyItem (TableItem item) { int index = 0; while (index < itemCount) { if (items [index] == item) break; index++; } if (savedAnchor != 0) { int savedIndex = getIndex (savedAnchor); if (index < savedIndex) { savedAnchor = getId (Math.max (0, savedIndex - 1)); } } if (index != itemCount - 1) fixSelection (index, false); int [] id = new int [] {itemCount}; if (OS.RemoveDataBrowserItems (handle, OS.kDataBrowserNoItem, id.length, id, 0) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_REMOVED); } System.arraycopy (items, index + 1, items, index, --itemCount - index); items [itemCount] = null; OS.UpdateDataBrowserItems (handle, 0, 0, null, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); if (itemCount == 0) { setTableEmpty (); } else { fixScrollBar (); } } void destroyScrollBar (ScrollBar bar) { if ((bar.style & SWT.H_SCROLL) != 0) style &= ~SWT.H_SCROLL; if ((bar.style & SWT.V_SCROLL) != 0) style &= ~SWT.V_SCROLL; OS.SetDataBrowserHasScrollBars (handle, (style & SWT.H_SCROLL) != 0, (style & SWT.V_SCROLL) != 0); } int drawItemProc (int browser, int id, int property, int itemState, int theRect, int gdDepth, int colorDevice) { int index = getIndex (id); if (!(0 <= index && index < itemCount)) return OS.noErr; int columnIndex = 0; if (columnCount > 0) { for (columnIndex=0; columnIndex<columnCount; columnIndex++) { if (columns [columnIndex].id == property) break; } if (columnIndex == columnCount) return OS.noErr; } Rect rect = new Rect (); lastIndexOf = index; TableItem item = _getItem (index); if ((style & SWT.VIRTUAL) != 0) { if (!item.cached) { if (!checkData (item, false)) return OS.noErr; if (setScrollWidth (item)) { if (OS.GetDataBrowserItemPartBounds (handle, id, property, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { int x = rect.left; int y = rect.top; int width = rect.right - rect.left; int height = rect.bottom - rect.top; redrawWidget (handle, x, y, width, height, false); } return OS.noErr; } } } OS.memmove (rect, theRect, Rect.sizeof); int x = rect.left; int y = rect.top; int width = rect.right - rect.left; int height = rect.bottom - rect.top; GC gc = paintGC; if (gc == null) { GCData data = new GCData (); int [] port = new int [1]; OS.GetPort (port); data.port = port [0]; gc = GC.carbon_new (this, data); } OS.GetDataBrowserItemPartBounds (handle, id, property, OS.kDataBrowserPropertyEnclosingPart, rect); int gridWidth = getLinesVisible () ? GRID_WIDTH : 0; int itemX = rect.left + gridWidth; int itemY = rect.top; int itemWidth = rect.right - rect.left - gridWidth; int itemHeight = rect.bottom - rect.top + 1; if (drawBackground) { drawBackground = false; Region region = new Region (display); Rectangle clientArea = getClientArea (); int headerHeight = getHeaderHeight (); clientArea.y += headerHeight; clientArea.height -= headerHeight; if (clientArea.height < 0) clientArea.height = 0; region.add (clientArea); if ((style & SWT.CHECK) != 0 || gridWidth != 0) { int rgn = OS.NewRgn(); if ((style & SWT.CHECK) != 0) { if (OS.GetDataBrowserItemPartBounds (handle, id, Table.CHECK_COLUMN_ID, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { OS.SetRectRgn (rgn, (short)rect.left, (short)clientArea.y, (short)(rect.right + gridWidth), (short)(clientArea.y + clientArea.height)); OS.DiffRgn (region.handle, rgn, region.handle); } } if (gridWidth != 0) { if (columnCount == 0) { if (OS.GetDataBrowserItemPartBounds (handle, id, Table.COLUMN_ID, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { OS.SetRectRgn (rgn, (short)rect.right, (short)clientArea.y, (short)(rect.right + gridWidth), (short)(clientArea.y + clientArea.height)); OS.DiffRgn (region.handle, rgn, region.handle); } } else { for (int i = 0; i < columnCount; i++) { if (OS.GetDataBrowserItemPartBounds (handle, id, columns[i].id, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { OS.SetRectRgn (rgn, (short)rect.right, (short)clientArea.y, (short)(rect.right + gridWidth), (short)(clientArea.y + clientArea.height)); OS.DiffRgn (region.handle, rgn, region.handle); } } } } OS.DisposeRgn (rgn); } if (region != null) gc.setClipping (region); fillBackground (handle, gc.handle, null); if (region != null) { gc.setClipping ((Rectangle)null); region.dispose (); } } OS.CGContextSaveGState (gc.handle); int itemRgn = OS.NewRgn (); OS.SetRectRgn (itemRgn, (short) itemX, (short) itemY, (short) (itemX + itemWidth), (short) (itemY + itemHeight)); int clip = OS.NewRgn (); OS.GetClip (clip); OS.SectRgn (clip, itemRgn, itemRgn); OS.DisposeRgn (clip); Region region = Region.carbon_new (display, itemRgn); Font font = item.getFont (columnIndex); Color background = item.getBackground (columnIndex); Color foreground = item.getForeground (columnIndex); Image image = item.getImage (columnIndex); String text = item.getText (columnIndex); gc.setClipping (region); gc.setFont (font); Point extent = gc.stringExtent (text); int contentWidth = extent.x; Rectangle imageBounds = null; int gap = 0; if (image != null) { gap = getGap (); imageBounds = image.getBounds (); contentWidth += this.imageBounds.width + gap; } int paintWidth = contentWidth; if (hooks (SWT.MeasureItem)) { Event event = new Event (); event.item = item; event.index = columnIndex; event.gc = gc; event.width = contentWidth; event.height = itemHeight; sendEvent (SWT.MeasureItem, event); if (itemHeight < event.height) { itemHeight = event.height; OS.SetDataBrowserTableViewRowHeight (handle, (short) event.height); redrawWidget (handle, false); } if (setScrollWidth (item)) { redrawWidget (handle, false); } contentWidth = event.width; gc.setClipping (region); gc.setFont (font); } int drawState = SWT.FOREGROUND; if (item.background != null || (item.cellBackground != null && item.cellBackground [columnIndex] != null)) drawState |= SWT.BACKGROUND; if ((itemState & (OS.kDataBrowserItemIsSelected | OS.kDataBrowserItemIsDragTarget)) != 0) drawState |= SWT.SELECTED; boolean wasSelected = (drawState & SWT.SELECTED) != 0; if ((drawState & SWT.SELECTED) != 0 && ((style & SWT.FULL_SELECTION) != 0 || columnIndex == 0)) { gc.setBackground (display.getSystemColor (SWT.COLOR_LIST_SELECTION)); gc.setForeground (display.getSystemColor (SWT.COLOR_LIST_SELECTION_TEXT)); } else { gc.setBackground (background); gc.setForeground (foreground); } if (hooks (SWT.EraseItem)) { Event event = new Event (); event.item = item; event.index = columnIndex; event.gc = gc; event.x = itemX; event.y = itemY; event.width = itemWidth; event.height = itemHeight; event.detail = drawState; sendEvent (SWT.EraseItem, event); drawState = event.doit ? event.detail : 0; gc.setClipping (region); gc.setFont (font); if ((drawState & SWT.SELECTED) != 0 && ((style & SWT.FULL_SELECTION) != 0 || columnIndex == 0)) { gc.setBackground (display.getSystemColor (SWT.COLOR_LIST_SELECTION)); gc.setForeground (display.getSystemColor (SWT.COLOR_LIST_SELECTION_TEXT)); } else { gc.setBackground (background); if (!wasSelected) gc.setForeground (foreground); } } if (columnCount != 0 && columnIndex != 0) { TableColumn column = columns [columnIndex]; if ((column.style & SWT.CENTER) != 0) x += (width - contentWidth) / 2; if ((column.style & SWT.RIGHT) != 0) x += width - contentWidth; } int stringX = x, imageWidth = 0; if (image != null) stringX += imageWidth = this.imageBounds.width + gap; if ((drawState & SWT.SELECTED) != 0 && ((style & SWT.FULL_SELECTION) != 0 || columnIndex == 0)) { if ((style & SWT.HIDE_SELECTION) == 0 || hasFocus ()) { if ((style & SWT.FULL_SELECTION) != 0) { gc.fillRectangle (itemX, itemY, itemWidth, itemHeight - 1); drawState &= ~SWT.BACKGROUND; } else if (columnIndex == 0) { gc.fillRectangle (stringX - 1, y, (contentWidth - imageWidth) + 2, itemHeight - 1); drawState &= ~SWT.BACKGROUND; } } else { if ((drawState & SWT.BACKGROUND) != 0) gc.setBackground (background); } } if ((drawState & SWT.BACKGROUND) != 0) { if (columnCount == 0) { gc.fillRectangle (stringX - 1, y, (contentWidth - imageWidth) + 2, itemHeight - 1); } else { gc.fillRectangle (itemX, itemY, itemWidth, itemHeight); } } if ((drawState & SWT.FOREGROUND) != 0) { if (image != null) { int imageX = x, imageY = y + (height - this.imageBounds.height) / 2; gc.drawImage (image, 0, 0, imageBounds.width, imageBounds.height, imageX, imageY, this.imageBounds.width, this.imageBounds.height); } gc.drawString (text, stringX, y + (height - extent.y) / 2, true); } if (hooks (SWT.PaintItem)) { Event event = new Event (); event.item = item; event.index = columnIndex; event.gc = gc; event.x = x; event.y = y; event.width = paintWidth; event.height = itemHeight; event.detail = drawState; sendEvent (SWT.PaintItem, event); } OS.CGContextRestoreGState (gc.handle); OS.DisposeRgn (itemRgn); if (gc != paintGC) gc.dispose (); return OS.noErr; } void enableWidget (boolean enabled) { super.enableWidget (enabled); /* * Bug in the Macintosh. For some reason, the data browser does not * redraw the checkboxes when the enable state changes. The fix is * to force a redraw. */ redrawWidget (handle, false); } void fixScrollBar () { /* * Bug in the Macintosh. For some reason, the data browser does not update * the vertical scrollbar when it is scrolled to the bottom and items are * removed. The fix is to check if the scrollbar value is bigger the * maximum number of visible items and clamp it when needed. */ int [] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); int maximum = Math.max (0, getItemHeight () * itemCount - getClientArea ().height); if (top [0] > maximum) { OS.SetDataBrowserScrollPosition (handle, maximum, left [0]); } } void fixSelection (int index, boolean add) { int [] selection = getSelectionIndices (); if (selection.length == 0) return; int newCount = 0, offset = add ? 1 : -1; boolean fix = false, down = sortDirection == SWT.DOWN && sortColumn != null; for (int i = 0; i < selection.length; i++) { if (!add && selection [i] == index) { fix = true; } else { int newIndex = newCount++; int sel = selection [i]; selection [newIndex] = getId (sel); if ((down && sel < index) || (!down && sel >= index)) { selection [newIndex] += offset; fix = true; } } } if (fix) select (selection, newCount, true); } String [] getAxAttributes () { return AX_ATTRIBUTES; } public int getBorderWidth () { checkWidget (); int border = 0; byte [] hasBorder = new byte [1]; OS.GetControlData (handle, (short) OS.kControlEntireControl, OS.kControlDataBrowserIncludesFrameAndFocusTag, 1, hasBorder, null); if (hasBorder [0] != 0) { int [] outMetric = new int [1]; OS.GetThemeMetric (OS.kThemeMetricFocusRectOutset, outMetric); border += outMetric [0] - BORDER_INSET; } return border; } int getCheckColumnWidth () { int inset = 0; if (OS.VERSION >= 0x1040) { float [] metric = new float [1]; OS.DataBrowserGetMetric (handle, OS.kDataBrowserMetricCellContentInset, null, metric); inset = (int) metric [0]; } else { inset = CELL_CONTENT_INSET; } int [] checkWidth = new int [1]; OS.GetThemeMetric (OS.kThemeMetricCheckBoxWidth, checkWidth); return checkWidth [0] + inset * 2; } public Rectangle getClientArea () { checkWidget(); int border = getBorderWidth (); Rect rect = new Rect (), inset = new Rect (); OS.GetControlBounds (handle, rect); OS.GetDataBrowserScrollBarInset (handle, inset); int width = Math.max (0, rect.right - rect.left - inset.right - border - border); int height = Math.max (0, rect.bottom - rect.top - inset.bottom - border - border); return new Rectangle (inset.left + border, inset.top + border, width, height); } /** * Returns the column at the given, zero-relative index in the * receiver. Throws an exception if the index is out of range. * Columns are returned in the order that they were created. * If no <code>TableColumn</code>s were created by the programmer, * this method will throw <code>ERROR_INVALID_RANGE</code> despite * the fact that a single column of data may be visible in the table. * This occurs when the programmer uses the table like a list, adding * items but never creating a column. * * @param index the index of the column to return * @return the column at the given index * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list minus 1 (inclusive)</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> * * @see Table#getColumnOrder() * @see Table#setColumnOrder(int[]) * @see TableColumn#getMoveable() * @see TableColumn#setMoveable(boolean) * @see SWT#Move */ public TableColumn getColumn (int index) { checkWidget (); if (!(0 <=index && index < columnCount)) error (SWT.ERROR_INVALID_RANGE); return columns [index]; } /** * Returns the number of columns contained in the receiver. * If no <code>TableColumn</code>s were created by the programmer, * this value is zero, despite the fact that visually, one column * of items may be visible. This occurs when the programmer uses * the table like a list, adding items but never creating a column. * * @return the number of columns * * @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 getColumnCount () { checkWidget (); return columnCount; } /** * Returns an array of zero-relative integers that map * the creation order of the receiver's items to the * order in which they are currently being displayed. * <p> * Specifically, the indices of the returned array represent * the current visual order of the items, and the contents * of the array represent the creation order of the items. * </p><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 current visual order of 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> * * @see Table#setColumnOrder(int[]) * @see TableColumn#getMoveable() * @see TableColumn#setMoveable(boolean) * @see SWT#Move * * @since 3.1 */ public int [] getColumnOrder () { checkWidget (); int [] order = new int [columnCount]; int [] position = new int [1]; for (int i=0; i<columnCount; i++) { TableColumn column = columns [i]; OS.GetDataBrowserTableViewColumnPosition (handle, column.id, position); if ((style & SWT.CHECK) != 0) position [0] -= 1; order [position [0]] = i; } return order; } /** * Returns an array of <code>TableColumn</code>s which are the * columns in the receiver. Columns are returned in the order * that they were created. If no <code>TableColumn</code>s were * created by the programmer, the array is empty, despite the fact * that visually, one column of items may be visible. This occurs * when the programmer uses the table like a list, adding items but * never creating a column. * <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 items in the receiver * * @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> * * @see Table#getColumnOrder() * @see Table#setColumnOrder(int[]) * @see TableColumn#getMoveable() * @see TableColumn#setMoveable(boolean) * @see SWT#Move */ public TableColumn [] getColumns () { checkWidget (); TableColumn [] result = new TableColumn [columnCount]; System.arraycopy (columns, 0, result, 0, columnCount); return result; } int getGap () { if (OS.VERSION >= 0x1040) { float [] metric = new float [1]; OS.DataBrowserGetMetric (handle, OS.kDataBrowserMetricIconAndTextGap, null, metric); return (int) metric [0]; } return ICON_AND_TEXT_GAP; } /** * Returns the width in pixels of a grid line. * * @return the width of a grid line in pixels * * @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 getGridLineWidth () { checkWidget (); return 0; } /** * Returns the height of the receiver's header * * @return the height of the header or zero if the header is not visible * * @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 int getHeaderHeight () { checkWidget (); short [] height = new short [1]; OS.GetDataBrowserListViewHeaderBtnHeight (handle, height); return height [0]; } /** * Returns <code>true</code> if the receiver's header is visible, * and <code>false</code> otherwise. * <p> * If one of the receiver's ancestors is not visible or some * other condition makes the receiver not visible, this method * may still indicate that it is considered visible even though * it may not actually be showing. * </p> * * @return the receiver's header's visibility 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 getHeaderVisible () { checkWidget (); short [] height = new short [1]; OS.GetDataBrowserListViewHeaderBtnHeight (handle, height); return height [0] != 0; } int getId (int index) { if (sortDirection == SWT.DOWN && sortColumn != null) { return itemCount - index; } return index + 1; } int getIndex (int id) { if (sortDirection == SWT.DOWN && sortColumn != null) { return itemCount - id; } return id - 1; } int getInsetWidth () { if (OS.VERSION >= 0x1040) { float [] metric = new float [1]; OS.DataBrowserGetMetric (handle, OS.kDataBrowserMetricCellContentInset, null, metric); return (int) metric [0] * 2; } return CELL_CONTENT_INSET * 2; } /** * Returns the item at the given, zero-relative index in the * receiver. Throws an exception if the index is out of range. * * @param index the index of the item to return * @return the item at the given index * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list minus 1 (inclusive)</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> */ public TableItem getItem (int index) { checkWidget (); if (!(0 <= index && index < itemCount)) error (SWT.ERROR_INVALID_RANGE); return _getItem (index); } /** * 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. * <p> * The item that is returned represents an item that could be selected by the user. * For example, if selection only occurs in items in the first column, then null is * returned if the point is outside of the item. * Note that the SWT.FULL_SELECTION style hint, which specifies the selection policy, * determines the extent of the selection. * </p> * * @param point the point used to locate the item * @return the item at the given point, or null if the point is not in a selectable item * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the point is null</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> */ public TableItem getItem (Point point) { checkWidget (); checkItems (true); if (point == null) error (SWT.ERROR_NULL_ARGUMENT); short [] height = new short [1]; OS.GetDataBrowserTableViewRowHeight (handle, height); Rect rect = new Rect (); org.eclipse.swt.internal.carbon.Point pt = new org.eclipse.swt.internal.carbon.Point (); OS.SetPt (pt, (short) point.x, (short) point.y); int lastHittestIndex = getIndex (lastHittest); if (0 <= lastHittestIndex && lastHittestIndex < itemCount && lastHittestColumn != 0) { if (OS.GetDataBrowserItemPartBounds (handle, lastHittest, lastHittestColumn, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { rect.bottom = (short)(rect.top + height [0]); if (OS.PtInRect (pt, rect)) return _getItem (lastHittestIndex); if (rect.top <= pt.v && pt.v < rect.bottom) { for (int j = 0; j < columnCount; j++) { if (OS.GetDataBrowserItemPartBounds (handle, lastHittest, columns [j].id, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { rect.bottom = (short)(rect.top + height [0]); if (OS.PtInRect (pt, rect)) return _getItem (lastHittestIndex); } } return null; } } } int [] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); short [] header = new short [1]; OS.GetDataBrowserListViewHeaderBtnHeight (handle, header); int [] offsets = new int [] {0, 1, -1}; for (int i = 0; i < offsets.length; i++) { int index = (top[0] - header [0] + point.y) / height [0] + offsets [i]; if (0 <= index && index < itemCount) { int columnId = columnCount == 0 ? column_id : columns [0].id; if (OS.GetDataBrowserItemPartBounds (handle, getId (index), columnId, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { rect.bottom = (short)(rect.top + height [0]); if (rect.top <= pt.v && pt.v < rect.bottom) { if (columnCount == 0) { if (OS.PtInRect (pt, rect)) return _getItem (index); } else { for (int j = 0; j < columnCount; j++) { if (OS.GetDataBrowserItemPartBounds (handle, getId (index), columns [j].id, OS.kDataBrowserPropertyEnclosingPart, rect) == OS.noErr) { rect.bottom = (short)(rect.top + height [0]); if (OS.PtInRect (pt, rect)) return _getItem (index); } } } return null; } } } } return null; } /** * Returns the number of items contained in 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 itemCount; } /** * Returns the height of the area which would be used to * display <em>one</em> of the items in the receiver. * * @return the height of one 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 int getItemHeight () { checkWidget (); short [] height = new short [1]; if (OS.GetDataBrowserTableViewRowHeight (handle, height) != OS.noErr) { error (SWT.ERROR_CANNOT_GET_ITEM_HEIGHT); } return height [0]; } /** * Returns a (possibly empty) array of <code>TableItem</code>s which * are the items in 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 items in the receiver * * @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 TableItem [] getItems () { checkWidget (); TableItem [] result = new TableItem [itemCount]; if ((style & SWT.VIRTUAL) != 0) { for (int i=0; i<itemCount; i++) { result [i] = _getItem (i); } } else { System.arraycopy (items, 0, result, 0, itemCount); } return result; } /** * Returns <code>true</code> if the receiver's lines are visible, * and <code>false</code> otherwise. Note that some platforms draw * grid lines while others may draw alternating row colors. * <p> * If one of the receiver's ancestors is not visible or some * other condition makes the receiver not visible, this method * may still indicate that it is considered visible even though * it may not actually be showing. * </p> * * @return the visibility state of the lines * * @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 getLinesVisible () { checkWidget (); if (OS.VERSION >= 0x1040) { int [] attrib = new int [1]; OS.DataBrowserGetAttributes (handle, attrib); return (attrib [0] & (OS.kDataBrowserAttributeListViewAlternatingRowColors | OS.kDataBrowserAttributeListViewDrawColumnDividers)) != 0; } return false; } /** * Returns an array of <code>TableItem</code>s that are currently * selected in the receiver. The order of the items is unspecified. * An empty array indicates that no items are selected. * <p> * Note: This is not the actual structure used by the receiver * to maintain its selection, so modifying the array will * not affect the receiver. * </p> * @return an array representing the selection * * @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 TableItem [] getSelection () { checkWidget (); int ptr = OS.NewHandle (0); if (OS.GetDataBrowserItems (handle, OS.kDataBrowserNoItem, true, OS.kDataBrowserItemIsSelected, ptr) != OS.noErr) { error (SWT.ERROR_CANNOT_GET_SELECTION); } int count = OS.GetHandleSize (ptr) / 4; TableItem [] result = new TableItem [count]; if (count > 0) { OS.HLock (ptr); int [] id = new int [1]; OS.memmove (id, ptr, 4); if (sortDirection == SWT.DOWN && sortColumn != null) { int offset = id [0]; for (int i=0; i<count; i++, offset += 4) { OS.memmove (id, offset, 4); result [i] = _getItem (getIndex (id [0])); } } else { int offset = id [0] + (count - 1) * 4; for (int i=0; i<count; i++, offset -= 4) { OS.memmove (id, offset, 4); result [i] = _getItem (getIndex (id [0])); } } OS.HUnlock (ptr); } return result; } /** * Returns the number of selected items contained in the receiver. * * @return the number of selected 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 getSelectionCount () { checkWidget (); int [] count = new int [1]; if (OS.GetDataBrowserItemCount (handle, OS.kDataBrowserNoItem, true, OS.kDataBrowserItemIsSelected, count) != OS.noErr) { error (SWT.ERROR_CANNOT_GET_COUNT); } return count [0]; } /** * Returns the zero-relative index of the item which is currently * selected in the receiver, or -1 if no item is selected. * * @return the index of the selected 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 int getSelectionIndex () { checkWidget(); int [] first = new int [1], last = new int [1]; if (OS.GetDataBrowserSelectionAnchor (handle, first, last) != OS.noErr) return -1; return getIndex (first [0]); } /** * Returns the zero-relative indices of the items which are currently * selected in the receiver. The order of the indices is unspecified. * The array is empty if no items are selected. * <p> * Note: This is not the actual structure used by the receiver * to maintain its selection, so modifying the array will * not affect the receiver. * </p> * @return the array of indices of the selected 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 [] getSelectionIndices () { checkWidget (); int ptr = OS.NewHandle (0); if (OS.GetDataBrowserItems (handle, OS.kDataBrowserNoItem, true, OS.kDataBrowserItemIsSelected, ptr) != OS.noErr) { error (SWT.ERROR_CANNOT_GET_SELECTION); } int count = OS.GetHandleSize (ptr) / 4; int [] result = new int [count]; if (count > 0) { OS.HLock (ptr); OS.memmove (result, ptr, 4); OS.memmove (result, result [0], count * 4); OS.HUnlock (ptr); if (sortDirection == SWT.DOWN && sortColumn != null) { for (int i=0; i<count; i++) { result [i] = getIndex (result [i]); } } else { for (int start=0, end=count - 1; start<=end; start++, end--) { int temp = result [start]; result [start] = getIndex (result [end]); result [end] = getIndex (temp); } } } OS.DisposeHandle (ptr); return result; } /** * Returns the column which shows the sort indicator for * the receiver. The value may be null if no column shows * the sort indicator. * * @return the sort indicator * * @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> * * @see #setSortColumn(TableColumn) * * @since 3.2 */ public TableColumn getSortColumn () { checkWidget (); return sortColumn; } /** * Returns the direction of the sort indicator for the receiver. * The value will be one of <code>UP</code>, <code>DOWN</code> * or <code>NONE</code>. * * @return the sort direction * * @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> * * @see #setSortDirection(int) * * @since 3.2 */ public int getSortDirection () { checkWidget (); return sortDirection; } /** * Returns the zero-relative index of the item which is currently * at the top of the receiver. This index can change when items are * scrolled or new items are added or removed. * * @return the index of the top 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 int getTopIndex () { checkWidget(); int[] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); return top [0] / getItemHeight (); } int helpProc (int inControl, int inGlobalMouse, int inRequest, int outContentProvided, int ioHelpContent) { if (toolTipText == null) { switch (inRequest) { case OS.kHMSupplyContent: { if (!(toolTipText != null && toolTipText.length () != 0)) { Rect rect = new Rect (); int window = OS.GetControlOwner (handle); OS.GetWindowBounds (window, (short) OS.kWindowContentRgn, rect); short windowLeft = rect.left, windowTop = rect.top; org.eclipse.swt.internal.carbon.Point pt = new org.eclipse.swt.internal.carbon.Point (); OS.memmove(pt, new int[] {inGlobalMouse}, 4); pt.h -= windowLeft; pt.v -= windowTop; String toolTipText = null; int tagSide = OS.kHMAbsoluteCenterAligned; CGPoint inPt = new CGPoint (); int [] contentView = new int [1]; OS.HIViewFindByID (OS.HIViewGetRoot (OS.GetControlOwner (handle)), OS.kHIViewWindowContentID (), contentView); OS.HIViewConvertPoint (inPt, handle, contentView [0]); pt.h -= (int) inPt.x; pt.v -= (int) inPt.y; windowLeft += (int) inPt.x; windowTop += (int) inPt.y; int x = pt.h; int y = pt.v; int headerHeight = getHeaderHeight (); if (headerHeight != 0 && (0 <= y && y < headerHeight) ) { int startX = 0; for (int i = 0; i < columnCount; i++) { TableColumn column = columns [i]; int width = column.lastWidth; if (startX <= x && x < startX + width) { toolTipText = column.toolTipText; rect.left = (short) startX; rect.top = (short) 0; rect.right = (short) (rect.left + width); rect.bottom = (short) (rect.top + headerHeight); tagSide = OS.kHMOutsideBottomRightAligned; break; } startX += width; } } else { TableItem item = null; int index = getIndex (lastHittest); if (0 <= index && index < itemCount) { if (OS.GetDataBrowserItemPartBounds (handle, lastHittest, lastHittestColumn, OS.kDataBrowserPropertyContentPart, rect) == OS.noErr) { item = _getItem (index); } } if (item != null) { int columnIndex = 0; TableColumn column = null; if (columnCount > 0) { for (int i = 0; i < columnCount; i++) { if (columns[i].id == lastHittestColumn) { column = columns[i]; columnIndex = i; break; } } } int columnId = lastHittestColumn; GC gc = new GC (this); int inset = getInsetWidth (); int width = item.calculateWidth (columnIndex, gc) + inset; gc.dispose (); int columnWidth; if (columnCount == 0) { columnWidth = getClientArea ().width; } else { short [] w = new short [1]; OS.GetDataBrowserTableViewNamedColumnWidth (handle, columnId, w); columnWidth = w[0]; } if (width > columnWidth) { toolTipText = item.getText (columnIndex); Image image = item.getImage (columnIndex); int imageWidth = image != null ? image.getBounds ().width + getGap () : 0; int style = column == null ? SWT.LEFT : column.style; if ((style & SWT.LEFT) != 0) { rect.left += imageWidth; rect.right = (short) (rect.left + width - imageWidth - inset); } if ((style & SWT.RIGHT) != 0) { rect.left = (short) (rect.right - width + imageWidth + inset); } if ((style & SWT.CENTER) != 0) { rect.left += imageWidth; } } } } if (toolTipText != null && toolTipText.length () != 0) { char [] buffer = new char [toolTipText.length ()]; toolTipText.getChars (0, buffer.length, buffer, 0); int length = fixMnemonic (buffer); if (display.helpString != 0) OS.CFRelease (display.helpString); display.helpString = OS.CFStringCreateWithCharacters (OS.kCFAllocatorDefault, buffer, length); HMHelpContentRec helpContent = new HMHelpContentRec (); OS.memmove (helpContent, ioHelpContent, HMHelpContentRec.sizeof); display.helpWidget = this; helpContent.version = OS.kMacHelpVersion; helpContent.tagSide = (short) tagSide; helpContent.absHotRect_left = (short) (rect.left + windowLeft); helpContent.absHotRect_top = (short) (rect.top + windowTop); helpContent.absHotRect_right = (short) (rect.right + windowLeft); helpContent.absHotRect_bottom = (short) (rect.bottom + windowTop); helpContent.content0_contentType = OS.kHMCFStringContent; helpContent.content0_tagCFString = display.helpString; helpContent.content1_contentType = OS.kHMCFStringContent; helpContent.content1_tagCFString = display.helpString; OS.memmove (ioHelpContent, helpContent, HMHelpContentRec.sizeof); OS.memmove (outContentProvided, new short[]{OS.kHMContentProvided}, 2); return OS.noErr; } } break; } } } return super.helpProc (inControl, inGlobalMouse, inRequest, outContentProvided, ioHelpContent); } int hitTestProc (int browser, int id, int property, int theRect, int mouseRect) { lastHittest = id; lastHittestColumn = property; return 1; } void hookEvents () { super.hookEvents (); DataBrowserCallbacks callbacks = new DataBrowserCallbacks (); callbacks.version = OS.kDataBrowserLatestCallbacks; OS.InitDataBrowserCallbacks (callbacks); callbacks.v1_itemDataCallback = display.itemDataProc; callbacks.v1_itemNotificationCallback = display.itemNotificationProc; OS.SetDataBrowserCallbacks (handle, callbacks); DataBrowserCustomCallbacks custom = new DataBrowserCustomCallbacks (); custom.version = OS.kDataBrowserLatestCustomCallbacks; OS.InitDataBrowserCustomCallbacks (custom); custom.v1_drawItemCallback = display.drawItemProc; custom.v1_hitTestCallback = display.hitTestProc; custom.v1_trackingCallback = display.trackingProc; OS.SetDataBrowserCustomCallbacks (handle, custom); } /** * Searches the receiver's list starting at the first column * (index 0) until a column is found that is equal to the * argument, and returns the index of that column. If no column * is found, returns -1. * * @param column the search column * @return the index of the column * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the column is null</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> */ public int indexOf (TableColumn column) { checkWidget (); if (column == null) error (SWT.ERROR_NULL_ARGUMENT); for (int i=0; i<columnCount; i++) { if (columns [i] == column) return i; } return -1; } /** * Searches the receiver's list starting at the first item * (index 0) until an item is found that is equal to the * argument, and returns the index of that item. If no item * is found, returns -1. * * @param item the search item * @return the index of the item * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the item is null</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> */ public int indexOf (TableItem item) { checkWidget (); if (item == null) error (SWT.ERROR_NULL_ARGUMENT); if (1 <= lastIndexOf && lastIndexOf < itemCount - 1) { if (items [lastIndexOf] == item) return lastIndexOf; if (items [lastIndexOf + 1] == item) return ++lastIndexOf; if (items [lastIndexOf - 1] == item) return --lastIndexOf; } if (lastIndexOf < itemCount / 2) { for (int i=0; i<itemCount; i++) { if (items [i] == item) return lastIndexOf = i; } } else { for (int i=itemCount - 1; i>=0; --i) { if (items [i] == item) return lastIndexOf = i; } } return -1; } /** * Returns <code>true</code> if the item is selected, * and <code>false</code> otherwise. Indices out of * range are ignored. * * @param index the index of the item * @return the selection state of the item at the index * * @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 isSelected (int index) { checkWidget(); return OS.IsDataBrowserItemSelected (handle, getId (index)); } int itemDataProc (int browser, int id, int property, int itemData, int setValue) { int index = getIndex (id); if (!(0 <= index && index < items.length)) return OS.noErr; switch (property) { case CHECK_COLUMN_ID: { TableItem item = _getItem (index); if (!checkData (item, false)) return OS.noErr; if (setValue != 0) { item.checked = !item.checked; if (item.checked && item.grayed) { OS.SetDataBrowserItemDataButtonValue (itemData, (short) OS.kThemeButtonMixed); } else { int theData = item.checked ? OS.kThemeButtonOn : OS.kThemeButtonOff; OS.SetDataBrowserItemDataButtonValue (itemData, (short) theData); } Event event = new Event (); event.item = item; event.detail = SWT.CHECK; sendSelectionEvent (SWT.Selection, event, false); /* * Bug in the Macintosh. When the height of the row is smaller than the * check box, the tail of the check mark draws outside of the item part * bounds. This means it will not be redrawn when the item is unckeched. * The fix is to redraw the area. */ if (!item.checked) item.redraw(Table.CHECK_COLUMN_ID); } else { int theData = OS.kThemeButtonOff; if (item.checked) theData = item.grayed ? OS.kThemeButtonMixed : OS.kThemeButtonOn; OS.SetDataBrowserItemDataButtonValue (itemData, (short) theData); } break; } } return OS.noErr; } int itemNotificationProc (int browser, int id, int message) { if (message == OS.kDataBrowserUserStateChanged) { boolean resized = false; short [] width = new short [1]; int [] position = new int [1]; TableColumn [] columns = getColumns (); for (int i = 0; i < columnCount; i++) { TableColumn column = columns [i]; if (!column.isDisposed ()) { OS.GetDataBrowserTableViewNamedColumnWidth (handle, column.id, width); if (width [0] != column.lastWidth) { column.resized (width [0]); resized = true; } } if (!column.isDisposed ()) { OS.GetDataBrowserTableViewColumnPosition (handle, column.id, position); if (position [0] != column.lastPosition) { column.lastPosition = position [0]; column.sendEvent (SWT.Move); resized = true; } } } int [] property = new int [1]; OS.GetDataBrowserSortProperty (handle, property); if (property [0] != 0) { if (!resized) { for (int i = 0; i < columnCount; i++) { TableColumn column = columns [i]; if (property [0] == column.id) { column.sendSelectionEvent (display.clickCount == 2 ? SWT.DefaultSelection : SWT.Selection); break; } } } OS.SetDataBrowserSortProperty (handle, 0); if (sortColumn != null && !sortColumn.isDisposed () && sortDirection != SWT.NONE) { OS.SetDataBrowserSortProperty (handle, sortColumn.id); int order = sortDirection == SWT.DOWN ? OS.kDataBrowserOrderDecreasing : OS.kDataBrowserOrderIncreasing; OS.SetDataBrowserSortOrder (handle, (short) order); } } return OS.noErr; } /* * The items in the databrowser lose their selection when we * drag them (when we call OS.TrackDrag() in DragSource.drag()). * We get kDataBrowserItemDeselected notification message * for each of the items. The workaround is to select the * deselected items in this case. DRAG_STARTED is set/unset * before/after the call to OS.TrackDrag(). * * This doesn't happen for Table with SWT.SINGLE style because * we have set the OS.kDataBrowserNeverEmptySelectionSet flag. */ if (message == OS.kDataBrowserItemDeselected && (style & SWT.MULTI) != 0 && getData(DRAG_STARTED) != null) { ignoreSelect = true; OS.SetDataBrowserSelectedItems (handle, 1, new int[] {id}, OS.kDataBrowserItemsAdd); ignoreSelect = false; return OS.noErr; } int index = getIndex (id); if (!(0 <= index && index < items.length)) return OS.noErr; switch (message) { case OS.kDataBrowserItemSelected: savedAnchor = 0; break; case OS.kDataBrowserItemDeselected: { int [] selectionCount = new int [1]; if (OS.GetDataBrowserItemCount (handle, OS.kDataBrowserNoItem, true, OS.kDataBrowserItemIsSelected, selectionCount) == OS.noErr) { if (selectionCount [0] == 0) savedAnchor = id; } break; } } switch (message) { case OS.kDataBrowserItemSelected: case OS.kDataBrowserItemDeselected: { TableItem item = _getItem (index); wasSelected = true; if (ignoreSelect) break; int [] first = new int [1], last = new int [1]; OS.GetDataBrowserSelectionAnchor (handle, first, last); boolean selected = false; if ((style & SWT.MULTI) != 0) { int modifiers = OS.GetCurrentEventKeyModifiers (); if ((modifiers & OS.shiftKey) != 0) { if (message == OS.kDataBrowserItemSelected) { selected = first [0] == id || last [0] == id; } else { selected = id == anchorFirst || id == anchorLast; } } else { if ((modifiers & OS.cmdKey) != 0) { selected = true; } else { selected = first [0] == last [0]; index = getIndex (last [0]); if (0 <= index && index < items.length) item = _getItem (index); } } } else { selected = message == OS.kDataBrowserItemSelected; } if (selected) { anchorFirst = first [0]; anchorLast = last [0]; Event event = new Event (); event.item = item; sendSelectionEvent (SWT.Selection, event, false); } break; } case OS.kDataBrowserItemDoubleClicked: { wasSelected = true; if (display.clickCount == 2) { Event event = new Event (); event.item = _getItem (index); sendSelectionEvent (SWT.DefaultSelection, event, false); } break; } } return OS.noErr; } int kEventAccessibleGetNamedAttribute (int nextHandler, int theEvent, int userData) { int code = OS.eventNotHandledErr; int [] stringRef = new int [1]; OS.GetEventParameter (theEvent, OS.kEventParamAccessibleAttributeName, OS.typeCFStringRef, null, 4, null, stringRef); int length = 0; if (stringRef [0] != 0) length = OS.CFStringGetLength (stringRef [0]); char [] buffer = new char [length]; CFRange range = new CFRange (); range.length = length; OS.CFStringGetCharacters (stringRef [0], range, buffer); String attributeName = new String(buffer); if (attributeName.equals(OS.kAXHeaderAttribute)) { short [] height = new short [1]; OS.GetDataBrowserListViewHeaderBtnHeight (handle, height); if (height [0] == 0) { /* * Bug in the Macintosh. Even when the header is not visible, * VoiceOver still reports each column header's role for every row. * This is confusing and overly verbose. The fix is to return * "no header" when the screen reader asks for the header, by * returning noErr without setting the event parameter. */ code = OS.noErr; } } else { int [] ref = new int [1]; OS.GetEventParameter (theEvent, OS.kEventParamAccessibleObject, OS.typeCFTypeRef, null, 4, null, ref); int axuielementref = ref [0]; DataBrowserAccessibilityItemInfo itemInfo = new DataBrowserAccessibilityItemInfo (); int err = OS.AXUIElementGetDataBrowserItemInfo (axuielementref, handle, 0, itemInfo); if (err == OS.noErr && itemInfo.v0_columnProperty != OS.kDataBrowserItemNoProperty && itemInfo.v0_item != OS.kDataBrowserNoItem && itemInfo.v0_propertyPart == OS.kDataBrowserPropertyEnclosingPart) { int columnIndex = 0; for (columnIndex = 0; columnIndex < columnCount; columnIndex++) { if (columns [columnIndex].id == itemInfo.v0_columnProperty) break; } if (columnIndex != columnCount || columnCount == 0) { int index = getIndex (itemInfo.v0_item); if (0 <= index && index < itemCount) { TableItem tableItem = _getItem (index); if (attributeName.equals (OS.kAXRoleAttribute) || attributeName.equals (OS.kAXRoleDescriptionAttribute)) { String roleText = OS.kAXStaticTextRole; buffer = new char [roleText.length ()]; roleText.getChars (0, buffer.length, buffer, 0); stringRef [0] = OS.CFStringCreateWithCharacters (OS.kCFAllocatorDefault, buffer, buffer.length); if (stringRef [0] != 0) { if (attributeName.equals (OS.kAXRoleAttribute)) { OS.SetEventParameter (theEvent, OS.kEventParamAccessibleAttributeValue, OS.typeCFStringRef, 4, stringRef); } else { // kAXRoleDescriptionAttribute int stringRef2 = OS.HICopyAccessibilityRoleDescription (stringRef [0], 0); OS.SetEventParameter (theEvent, OS.kEventParamAccessibleAttributeValue, OS.typeCFStringRef, 4, new int [] {stringRef2}); OS.CFRelease(stringRef2); } OS.CFRelease(stringRef [0]); code = OS.noErr; } } else if (attributeName.equals(OS.kAXChildrenAttribute)) { int children = OS.CFArrayCreateMutable (OS.kCFAllocatorDefault, 0, 0); OS.SetEventParameter (theEvent, OS.kEventParamAccessibleAttributeValue, OS.typeCFMutableArrayRef, 4, new int [] {children}); OS.CFRelease(children); code = OS.noErr; } else if (attributeName.equals (OS.kAXTitleAttribute) || attributeName.equals (OS.kAXDescriptionAttribute)) { String text = tableItem.getText (columnIndex); buffer = new char [text.length ()]; text.getChars (0, buffer.length, buffer, 0); stringRef [0] = OS.CFStringCreateWithCharacters (OS.kCFAllocatorDefault, buffer, buffer.length); if (stringRef [0] != 0) { OS.SetEventParameter (theEvent, OS.kEventParamAccessibleAttributeValue, OS.typeCFStringRef, 4, stringRef); OS.CFRelease(stringRef [0]); code = OS.noErr; } } } } } } if (accessible != null) { code = accessible.internal_kEventAccessibleGetNamedAttribute (nextHandler, theEvent, code); } return code; } int kEventMouseDown (int nextHandler, int theEvent, int userData) { int result = super.kEventMouseDown (nextHandler, theEvent, userData); if (result == OS.noErr) return result; wasSelected = false; result = OS.CallNextEventHandler (nextHandler, theEvent); if (isDisposed ()) return OS.noErr; if (!wasSelected) { if (OS.IsDataBrowserItemSelected (handle, lastHittest)) { int index = getIndex (lastHittest); if (0 <= index && index < itemCount) { Event event = new Event (); event.item = _getItem (index); sendSelectionEvent (SWT.Selection, event, false); } } } return result; } int kEventControlGetClickActivation (int nextHandler, int theEvent, int userData) { OS.SetEventParameter (theEvent, OS.kEventParamClickActivation, OS.typeClickActivationResult, 4, new int [] {OS.kActivateAndHandleClick}); return OS.noErr; } int kEventControlSetCursor (int nextHandler, int theEvent, int userData) { if (!isEnabledCursor ()) return OS.noErr; if (isEnabledModal ()) { org.eclipse.swt.internal.carbon.Point pt = new org.eclipse.swt.internal.carbon.Point (); int sizeof = org.eclipse.swt.internal.carbon.Point.sizeof; OS.GetEventParameter (theEvent, OS.kEventParamMouseLocation, OS.typeQDPoint, null, sizeof, null, pt); if (!contains (pt.h, pt.v)) return OS.eventNotHandledErr; } return super.kEventControlSetCursor (nextHandler, theEvent, userData); } int kEventUnicodeKeyPressed (int nextHandler, int theEvent, int userData) { int result = super.kEventUnicodeKeyPressed (nextHandler, theEvent, userData); if (result == OS.noErr) return result; int [] keyboardEvent = new int [1]; OS.GetEventParameter (theEvent, OS.kEventParamTextInputSendKeyboardEvent, OS.typeEventRef, null, keyboardEvent.length * 4, null, keyboardEvent); int [] keyCode = new int [1]; OS.GetEventParameter (keyboardEvent [0], OS.kEventParamKeyCode, OS.typeUInt32, null, keyCode.length * 4, null, keyCode); switch (keyCode [0]) { case 49: { /* Space */ int [] first = new int [1], last = new int [1]; if (OS.GetDataBrowserSelectionAnchor (handle, first, last) == OS.noErr) { if (first [0] != 0) { TableItem item = _getItem (getIndex (first [0])); if ((style & SWT.CHECK) != 0) { item.setChecked (!item.getChecked (), true); } } } break; } case 76: /* KP Enter */ case 36: { /* Return */ sendSelectionEvent (SWT.DefaultSelection); break; } /* * Feature in the Macintosh. For some reason, when the user hits an * up or down arrow to traverse the items in a Data Browser, the item * scrolls to the left such that the white space that is normally * visible to the right of the every item is scrolled out of view. * The fix is to save and restore the horizontal scroll position. */ case 125: /* Down */ case 126: /* Up*/ { if (itemCount == 0) break; int [] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); boolean selectItem = false; int [] selectionCount = new int [1]; if (OS.GetDataBrowserItemCount (handle, OS.kDataBrowserNoItem, true, OS.kDataBrowserItemIsSelected, selectionCount) == OS.noErr) { selectItem = savedAnchor != 0 && selectionCount [0] == 0; } if (selectItem) { int index = getIndex (savedAnchor) + (keyCode [0] == 125 ? 1 : -1); index = Math.max (0, Math.min (itemCount - 1, index)); int [] itemId = new int [] {getId (index)}; OS.SetDataBrowserSelectedItems (handle, 1, itemId, OS.kDataBrowserItemsAssign); result = OS.noErr; } else { result = OS.CallNextEventHandler (nextHandler, theEvent); } OS.GetDataBrowserScrollPosition (handle, top, null); OS.SetDataBrowserScrollPosition (handle, top [0], left [0]); redrawBackgroundImage (); break; } } return result; } void redrawBackgroundImage () { super.redrawBackgroundImage(); /* * Bug in Carbon. The data browser copies bits from the window buffer when * scrolling. If the control is obscured be a sibling control, the bits of the * sibling are copied causing pixel corruption. The fix is to detect that the * data browser is obscured and redraw any control that overlaps with the data * browser bounds. */ if (isDisposed()) return; redrawObscured (); } void releaseChildren (boolean destroy) { if (items != null) { for (int i=0; i<itemCount; i++) { TableItem item = items [i]; if (item != null && !item.isDisposed ()) { item.release (false); } } items = null; } if (columns != null) { for (int i=0; i<columnCount; i++) { TableColumn column = columns [i]; if (column != null && !column.isDisposed ()) { column.release (false); } } columns = null; } super.releaseChildren (destroy); } void releaseWidget () { super.releaseWidget (); currentItem = null; sortColumn = null; paintGC = null; imageBounds = null; /* * Feature in the Mac. When RemoveDataBrowserItems() is used * to remove items, item notification callbacks are issued with * the message kDataBrowserItemRemoved When many items are * removed, this is slow. The fix is to temporarily remove * the item notification callback. */ DataBrowserCallbacks callbacks = new DataBrowserCallbacks (); OS.GetDataBrowserCallbacks (handle, callbacks); callbacks.v1_itemNotificationCallback = 0; OS.SetDataBrowserCallbacks (handle, callbacks); } /** * Removes the item from the receiver at the given * zero-relative index. * * @param index the index for the item * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list minus 1 (inclusive)</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> */ public void remove (int index) { checkWidget(); checkItems (true); if (!(0 <= index && index < itemCount)) error (SWT.ERROR_INVALID_RANGE); TableItem item = items [index]; if (item != null) item.release (false); if (savedAnchor != 0) { int savedIndex = getIndex (savedAnchor); if (index < savedIndex) { savedAnchor = getId (Math.max (0, savedIndex - 1)); } } if (index != itemCount - 1) fixSelection (index, false); int [] id = new int [] {itemCount}; if (OS.RemoveDataBrowserItems (handle, OS.kDataBrowserNoItem, id.length, id, 0) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_REMOVED); } System.arraycopy (items, index + 1, items, index, --itemCount - index); items [itemCount] = null; OS.UpdateDataBrowserItems (handle, 0, 0, null, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); if (itemCount == 0) { setTableEmpty (); } else { fixScrollBar (); } } /** * Removes the items from the receiver which are * between the given zero-relative start and end * indices (inclusive). * * @param start the start of the range * @param end the end of the range * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if either the start or end are not between 0 and the number of elements in the list minus 1 (inclusive)</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> */ public void remove (int start, int end) { checkWidget(); checkItems (true); if (start > end) return; if (!(0 <= start && start <= end && end < itemCount)) { error (SWT.ERROR_INVALID_RANGE); } if (start == 0 && end == itemCount - 1) { removeAll (); } else { int length = end - start + 1; int [] indices = new int [length]; for (int i=0; i<length; i++) indices [i] = i + start; remove(indices); } } /** * Removes the items from the receiver's list at the given * zero-relative indices. * * @param indices the array of indices of the items * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list minus 1 (inclusive)</li> * <li>ERROR_NULL_ARGUMENT - if the indices array is null</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> */ public void remove (int [] indices) { checkWidget (); checkItems (true); if (indices == null) error (SWT.ERROR_NULL_ARGUMENT); if (indices.length == 0) return; int [] newIndices = new int [indices.length]; System.arraycopy (indices, 0, newIndices, 0, indices.length); sort (newIndices); int start = newIndices [newIndices.length - 1], end = newIndices [0]; if (!(0 <= start && start <= end && end < itemCount)) { error (SWT.ERROR_INVALID_RANGE); } int duplicates = 0; int last = -1; for (int i = 0; i < newIndices.length; i++) { if (newIndices [i] == last) duplicates++; last = newIndices [i]; } int [] id = new int [newIndices.length - duplicates]; int idIndex = id.length - 1; last = -1; for (int i = 0; i < newIndices.length; i++) { int index = newIndices [i]; if (index != last) { TableItem item = items [index]; if (item != null && !item.isDisposed ()) item.release (false); if (savedAnchor != 0) { int savedIndex = getIndex (savedAnchor); if (index < savedIndex) { savedAnchor = getId (Math.max (0, savedIndex - 1)); } } if (index != itemCount - 1) fixSelection (index, false); id [idIndex--] = itemCount; System.arraycopy (items, index + 1, items, index, --itemCount - index); items [itemCount] = null; last = index; } } if (OS.RemoveDataBrowserItems (handle, OS.kDataBrowserNoItem, id.length, id, 0) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_REMOVED); } OS.UpdateDataBrowserItems (handle, 0, 0, null, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); if (itemCount == 0) { setTableEmpty (); } else { fixScrollBar (); } } /** * Removes all of the items from the receiver. * * @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 removeAll () { checkWidget(); for (int i=0; i<itemCount; i++) { TableItem item = items [i]; if (item != null && !item.isDisposed ()) item.release (false); } /* * Feature in the Mac. When RemoveDataBrowserItems() is used * to remove items, item notification callbacks are issued with * the message kDataBrowserItemRemoved When many items are * removed, this is slow. The fix is to temporarily remove * the item notification callback. */ DataBrowserCallbacks callbacks = new DataBrowserCallbacks (); OS.GetDataBrowserCallbacks (handle, callbacks); callbacks.v1_itemNotificationCallback = 0; OS.SetDataBrowserCallbacks (handle, callbacks); OS.RemoveDataBrowserItems (handle, OS.kDataBrowserNoItem, 0, null, 0); callbacks.v1_itemNotificationCallback = display.itemNotificationProc; OS.SetDataBrowserCallbacks (handle, callbacks); setTableEmpty (); } /** * Removes the listener from the collection of listeners who will * be notified when the user changes the receiver's selection. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</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> * * @see SelectionListener * @see #addSelectionListener(SelectionListener) */ public void removeSelectionListener(SelectionListener listener) { checkWidget (); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.Selection, listener); eventTable.unhook (SWT.DefaultSelection,listener); } void resetVisibleRegion (int control) { super.resetVisibleRegion (control); if (showIndex != -1) { showIndex (showIndex); } } void reskinChildren (int flags) { if (items != null) { for (int i=0; i<itemCount; i++) { TableItem item = items [i]; if (item != null) item.reskin (flags); } } if (columns != null) { for (int i=0; i<columnCount; i++) { TableColumn column = columns [i]; if (!column.isDisposed ()) column.reskin (flags); } } super.reskinChildren (flags); } /** * Selects the item at the given zero-relative index in the receiver. * If the item at the index was already selected, it remains * selected. Indices that are out of range are ignored. * * @param index the index of the item to select * * @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 select (int index) { checkWidget(); checkItems (false); if (0 <= index && index < itemCount) { int [] ids = new int [] {getId (index)}; select (ids, ids.length, false); } } /** * Selects the items in the range specified by the given zero-relative * indices in the receiver. The range of indices is inclusive. * The current selection is not cleared before the new items are selected. * <p> * If an item in the given range is not selected, it is selected. * If an item in the given range was already selected, it remains selected. * Indices that are out of range are ignored and no items will be selected * if start is greater than end. * If the receiver is single-select and there is more than one item in the * given range, then all indices are ignored. * </p> * * @param start the start of the range * @param end the end of the range * * @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> * * @see Table#setSelection(int,int) */ public void select (int start, int end) { checkWidget (); checkItems (false); if (end < 0 || start > end || ((style & SWT.SINGLE) != 0 && start != end)) return; if (itemCount == 0 || start >= itemCount) return; if (start == 0 && end == itemCount - 1) { selectAll (); } else { start = Math.max (0, start); end = Math.min (end, itemCount - 1); int length = end - start + 1; int [] ids = new int [length]; for (int i=0; i<length; i++) ids [i] = getId (end - i); select (ids, length, false); } } /** * Selects the items at the given zero-relative indices in the receiver. * The current selection is not cleared before the new items are selected. * <p> * If the item at a given index is not selected, it is selected. * If the item at a given index was already selected, it remains selected. * Indices that are out of range and duplicate indices are ignored. * If the receiver is single-select and multiple indices are specified, * then all indices are ignored. * </p> * * @param indices the array of indices for the items to select * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the array of indices is null</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> * * @see Table#setSelection(int[]) */ public void select (int [] indices) { checkWidget (); checkItems (false); if (indices == null) error (SWT.ERROR_NULL_ARGUMENT); int length = indices.length; if (length == 0 || ((style & SWT.SINGLE) != 0 && length > 1)) return; int [] ids = new int [length]; int count = 0; for (int i=0; i<length; i++) { int index = indices [length - i - 1]; if (index >= 0 && index < itemCount) { ids [count++] = getId (index); } } if (count > 0) select (ids, count, false); } void selectIndices (int [] indices, int count, boolean clear) { for (int i = 0; i < count; i++) { indices [i] = getId (indices [i]); } select(indices, count, clear); } void select (int [] ids, int count, boolean clear) { ignoreSelect = true; /* * Bug in the Macintosh. When the DataBroswer selection flags includes * both kDataBrowserNeverEmptySelectionSet and kDataBrowserSelectOnlyOne, * two items are selected when SetDataBrowserSelectedItems() is called * with kDataBrowserItemsAssign to assign a new seletion despite the fact * that kDataBrowserSelectOnlyOne was specified. The fix is to save and * restore kDataBrowserNeverEmptySelectionSet around each call to * SetDataBrowserSelectedItems(). */ int [] selectionFlags = null; if ((style & SWT.SINGLE) != 0) { selectionFlags = new int [1]; OS.GetDataBrowserSelectionFlags (handle, selectionFlags); OS.SetDataBrowserSelectionFlags (handle, selectionFlags [0] & ~OS.kDataBrowserNeverEmptySelectionSet); } int operation = OS.kDataBrowserItemsAssign; if ((style & SWT.MULTI) != 0 && !clear) operation = OS.kDataBrowserItemsAdd; OS.SetDataBrowserSelectedItems (handle, count, ids, operation); if ((style & SWT.SINGLE) != 0) { OS.SetDataBrowserSelectionFlags (handle, selectionFlags [0]); } ignoreSelect = false; } /** * Selects all of the items in the receiver. * <p> * If the receiver is single-select, do nothing. * </p> * * @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 selectAll () { checkWidget (); checkItems (false); if ((style & SWT.SINGLE) != 0) return; select (null, 0, false); } void setBackground (float [] color) { /* * Bug in the Macintosh. The default background of a window changes when * the background of a data browser is set using SetControlFontStyle(). This * also affects the background of any TNXObject created on that window. The * fix is to avoid calling SetControlFontStyle() which has no effect * in a data browser anyways. */ } int setBounds (int x, int y, int width, int height, boolean move, boolean resize, boolean events) { /* * Ensure that the top item is visible when the tree is resized * from a zero size to a size that can show the selection. */ int result = super.setBounds (x, y, width, height, move, resize, events); if (showIndex != -1) { showIndex (showIndex); } return result; } /** * Sets the order that the items in the receiver should * be displayed in to the given argument which is described * in terms of the zero-relative ordering of when the items * were added. * * @param order the new order to display the 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> * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the item order is null</li> * <li>ERROR_INVALID_ARGUMENT - if the item order is not the same length as the number of items</li> * </ul> * * @see Table#getColumnOrder() * @see TableColumn#getMoveable() * @see TableColumn#setMoveable(boolean) * @see SWT#Move * * @since 3.1 */ public void setColumnOrder (int [] order) { checkWidget (); if (order == null) error (SWT.ERROR_NULL_ARGUMENT); if (columnCount == 0) { if (order.length != 0) error (SWT.ERROR_INVALID_ARGUMENT); return; } if (order.length != columnCount) error (SWT.ERROR_INVALID_ARGUMENT); int [] oldOrder = getColumnOrder (); boolean reorder = false; boolean [] seen = new boolean [columnCount]; for (int i=0; i<order.length; i++) { int index = order [i]; if (index < 0 || index >= columnCount) error (SWT.ERROR_INVALID_ARGUMENT); if (seen [index]) error (SWT.ERROR_INVALID_ARGUMENT); seen [index] = true; if (order [i] != oldOrder [i]) reorder = true; } if (reorder) { int x = 0; short [] width = new short [1]; int [] oldX = new int [oldOrder.length]; for (int i=0; i<oldOrder.length; i++) { int index = oldOrder [i]; TableColumn column = columns [index]; oldX [index] = x; OS.GetDataBrowserTableViewNamedColumnWidth(handle, column.id, width); x += width [0]; } x = 0; int [] newX = new int [order.length]; for (int i=0; i<order.length; i++) { int index = order [i]; TableColumn column = columns [index]; int position = (style & SWT.CHECK) != 0 ? i + 1 : i; OS.SetDataBrowserTableViewColumnPosition(handle, column.id, position); column.lastPosition = position; newX [index] = x; OS.GetDataBrowserTableViewNamedColumnWidth(handle, column.id, width); x += width [0]; } TableColumn[] newColumns = new TableColumn [columnCount]; System.arraycopy (columns, 0, newColumns, 0, columnCount); for (int i=0; i<columnCount; i++) { TableColumn column = newColumns [i]; if (!column.isDisposed ()) { if (newX [i] != oldX [i]) { column.sendEvent (SWT.Move); } } } } } void setFontStyle (Font font) { super.setFontStyle (font); if (items == null) return; for (int i = 0; i < items.length; i++) { TableItem item = items [i]; if (item != null) item.width = -1; } setScrollWidth (items, true); setItemHeight (null); } /** * Marks the receiver's header as visible if the argument is <code>true</code>, * and marks it invisible otherwise. * <p> * If one of the receiver's ancestors is not visible or some * other condition makes the receiver not visible, marking * it visible may not actually cause it to be displayed. * </p> * * @param show the new visibility 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 setHeaderVisible (boolean show) { checkWidget (); short [] height = new short [1]; OS.GetDataBrowserListViewHeaderBtnHeight (handle, height); if ((height [0] != 0) != show) { OS.SetDataBrowserListViewHeaderBtnHeight (handle, (short) (show ? headerHeight : 0)); invalidateVisibleRegion (handle); } } /** * Sets the number of items contained in the receiver. * * @param count 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> * * @since 3.0 */ public void setItemCount (int count) { checkWidget (); checkItems (true); count = Math.max (0, count); if (count == itemCount) return; setRedraw (false); int[] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); DataBrowserCallbacks callbacks = new DataBrowserCallbacks (); OS.GetDataBrowserCallbacks (handle, callbacks); callbacks.v1_itemNotificationCallback = 0; OS.SetDataBrowserCallbacks (handle, callbacks); if (count < itemCount) { int oldAnchor = savedAnchor; int selectionCount = getSelectionCount (); int index = count; int[] id = new int [itemCount - count]; while (index < itemCount) { TableItem item = items [index]; if (item != null) item.release (false); id [index-count] = index + 1; index++; } if (OS.RemoveDataBrowserItems (handle, OS.kDataBrowserNoItem, id.length, id, 0) != OS.noErr) { error (SWT.ERROR_ITEM_NOT_REMOVED); } boolean fixAnchor = selectionCount != 0 && getSelectionCount () == 0; if (fixAnchor || (savedAnchor != 0 && savedAnchor != oldAnchor)) { savedAnchor = getId (Math.max (0, count - 1)); } } int length = Math.max (4, (count + 3) / 4 * 4); TableItem [] newItems = new TableItem [length]; System.arraycopy (items, 0, newItems, 0, Math.min (count, itemCount)); items = newItems; if ((style & SWT.VIRTUAL) == 0) { for (int i=itemCount; i<count; i++) { items [i] = new TableItem (this, SWT.NONE, i, false); } } itemCount = count; OS.AddDataBrowserItems (handle, 0, itemCount, null, OS.kDataBrowserItemNoProperty); callbacks.v1_itemNotificationCallback = display.itemNotificationProc; OS.SetDataBrowserCallbacks (handle, callbacks); fixScrollBar (); if (sortColumn != null && !sortColumn.isDisposed () && sortDirection == SWT.DOWN) { OS.UpdateDataBrowserItems (handle, 0, 0, null, OS.kDataBrowserItemNoProperty, OS.kDataBrowserNoItem); } setRedraw (true); } /*public*/ void setItemHeight (int itemHeight) { checkWidget (); if (itemHeight < -1) error (SWT.ERROR_INVALID_ARGUMENT); if (itemHeight == -1) { //TODO - reset item height, ensure other API's such as setFont don't do this } else { OS.SetDataBrowserTableViewRowHeight (handle, (short) itemHeight); } } void setItemHeight (Image image) { Rectangle bounds = image != null ? image.getBounds () : imageBounds; if (bounds == null) return; imageBounds = bounds; short [] height = new short [1]; if (OS.GetDataBrowserTableViewRowHeight (handle, height) == OS.noErr) { if (height [0] < bounds.height) { OS.SetDataBrowserTableViewRowHeight (handle, (short) bounds.height); } } } /** * Marks the receiver's lines as visible if the argument is <code>true</code>, * and marks it invisible otherwise. Note that some platforms draw grid lines * while others may draw alternating row colors. * <p> * If one of the receiver's ancestors is not visible or some * other condition makes the receiver not visible, marking * it visible may not actually cause it to be displayed. * </p> * * @param show the new visibility 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 setLinesVisible (boolean show) { checkWidget (); if (OS.VERSION >= 0x1040) { int attrib = OS.kDataBrowserAttributeListViewAlternatingRowColors | OS.kDataBrowserAttributeListViewDrawColumnDividers; OS.DataBrowserChangeAttributes (handle, show ? attrib : 0, !show ? attrib : 0); redraw (); } } public void setRedraw (boolean redraw) { checkWidget(); super.setRedraw (redraw); if (redraw && drawCount == 0) { /* Resize the item array to match the item count */ if (items.length > 4 && items.length - itemCount > 3) { int length = Math.max (4, (itemCount + 3) / 4 * 4); TableItem [] newItems = new TableItem [length]; System.arraycopy (items, 0, newItems, 0, itemCount); items = newItems; } checkItems (true); } } boolean setScrollBarVisible (ScrollBar bar, boolean visible) { boolean [] horiz = new boolean [1], vert = new boolean [1]; OS.GetDataBrowserHasScrollBars (handle, horiz, vert); if ((bar.style & SWT.H_SCROLL) != 0) horiz [0] = visible; if ((bar.style & SWT.V_SCROLL) != 0) vert [0] = visible; if (!visible) { bar.redraw (); bar.deregister (); } if (OS.SetDataBrowserHasScrollBars (handle, horiz [0], vert [0]) == OS.noErr) { if (visible) { bar.handle = findStandardBar (bar.style); bar.register (); bar.hookEvents (); bar.redraw (); } else { bar.handle = 0; } return true; } else { if (!visible) { bar.register (); } } return false; } boolean setScrollWidth (TableItem item) { if (columnCount != 0) return false; if (currentItem != null) { if (currentItem != item) fixScrollWidth = true; return false; } if (!getDrawing ()) return false; GC gc = new GC (this); int newWidth = item.calculateWidth (0, gc); gc.dispose (); newWidth += getInsetWidth (); short [] width = new short [1]; OS.GetDataBrowserTableViewNamedColumnWidth (handle, column_id, width); if (width [0] < newWidth) { OS.SetDataBrowserTableViewNamedColumnWidth (handle, column_id, (short) newWidth); return true; } return false; } boolean setScrollWidth (TableItem [] items, boolean set) { if (columnCount != 0) return false; if (currentItem != null) { fixScrollWidth = true; return false; } if (!getDrawing ()) return false; GC gc = new GC (this); int newWidth = 0; for (int i = 0; i < items.length; i++) { TableItem item = items [i]; if (item != null) { newWidth = Math.max (newWidth, item.calculateWidth (0, gc)); } } gc.dispose (); newWidth += getInsetWidth (); if (!set) { short [] width = new short [1]; OS.GetDataBrowserTableViewNamedColumnWidth (handle, column_id, width); if (width [0] >= newWidth) return false; } OS.SetDataBrowserTableViewNamedColumnWidth (handle, column_id, (short) newWidth); return true; } /** * Selects the item at the given zero-relative index in the receiver. * The current selection is first cleared, then the new item is selected. * * @param index the index of the item to select * * @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> * * @see Table#deselectAll() * @see Table#select(int) */ public void setSelection (int index) { checkWidget(); checkItems (false); deselectAll (); setSelection (index, false); } void setSelection (int index, boolean notify) { // checkWidget(); if (0 <= index && index < itemCount) { int [] ids = new int [] {getId (index)}; select (ids, ids.length, true); showIndex (index); if (notify) { Event event = new Event (); event.item = _getItem (index); sendSelectionEvent (SWT.Selection, event, false); } } } /** * Selects the items in the range specified by the given zero-relative * indices in the receiver. The range of indices is inclusive. * The current selection is cleared before the new items are selected. * <p> * Indices that are out of range are ignored and no items will be selected * if start is greater than end. * If the receiver is single-select and there is more than one item in the * given range, then all indices are ignored. * </p> * * @param start the start index of the items to select * @param end the end index of the items to select * * @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> * * @see Table#deselectAll() * @see Table#select(int,int) */ public void setSelection (int start, int end) { checkWidget (); checkItems (false); deselectAll (); if (end < 0 || start > end || ((style & SWT.SINGLE) != 0 && start != end)) return; if (itemCount == 0 || start >= itemCount) return; start = Math.max (0, start); end = Math.min (end, itemCount - 1); int length = end - start + 1; int [] ids = new int [length]; for (int i=0; i<length; i++) ids [i] = getId (end - i); select (ids, length, true); showIndex (getIndex (ids [0])); } /** * Selects the items at the given zero-relative indices in the receiver. * The current selection is cleared before the new items are selected. * <p> * Indices that are out of range and duplicate indices are ignored. * If the receiver is single-select and multiple indices are specified, * then all indices are ignored. * </p> * * @param indices the indices of the items to select * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the array of indices is null</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> * * @see Table#deselectAll() * @see Table#select(int[]) */ public void setSelection (int [] indices) { checkWidget (); checkItems (false); if (indices == null) error (SWT.ERROR_NULL_ARGUMENT); deselectAll (); int length = indices.length; if (length == 0 || ((style & SWT.SINGLE) != 0 && length > 1)) return; int [] ids = new int [length]; int count = 0; for (int i=0; i<length; i++) { int index = indices [length - i - 1]; if (index >= 0 && index < itemCount) { ids [count++] = getId (index); } } if (count > 0) { select (ids, count, true); showIndex (getIndex (ids [0])); } } /** * Sets the receiver's selection to the given item. * The current selection is cleared before the new item is selected. * <p> * If the item is not in the receiver, then it is ignored. * </p> * * @param item the item to select * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the item is null</li> * <li>ERROR_INVALID_ARGUMENT - if the item 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 3.2 */ public void setSelection (TableItem item) { checkWidget (); if (item == null) error (SWT.ERROR_NULL_ARGUMENT); setSelection (new TableItem [] {item}); } /** * Sets the receiver's selection to be the given array of items. * The current selection is cleared before the new items are selected. * <p> * Items that are not in the receiver are ignored. * If the receiver is single-select and multiple items are specified, * then all items are ignored. * </p> * * @param items the array of items * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the array of items is null</li> * <li>ERROR_INVALID_ARGUMENT - if one of the items 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> * * @see Table#deselectAll() * @see Table#select(int[]) * @see Table#setSelection(int[]) */ public void setSelection (TableItem [] items) { checkWidget (); checkItems (false); if (items == null) error (SWT.ERROR_NULL_ARGUMENT); deselectAll (); int length = items.length; if (length == 0 || ((style & SWT.SINGLE) != 0 && length > 1)) return; int [] ids = new int [length]; int count = 0; for (int i=0; i<length; i++) { int index = indexOf (items [length - i - 1]); if (index != -1) { ids [count++] = getId (index); } } if (count > 0) { select (ids, count, true); showIndex (getIndex (ids [0])); } } /** * Sets the column used by the sort indicator for the receiver. A null * value will clear the sort indicator. The current sort column is cleared * before the new column is set. * * @param column the column used by the sort indicator or <code>null</code> * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_ARGUMENT - if the column is 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 3.2 */ public void setSortColumn (TableColumn column) { checkWidget (); if (column != null && column.isDisposed ()) error (SWT.ERROR_INVALID_ARGUMENT); if (column == sortColumn) return; int [] indices = getSelectionIndices (); sortColumn = column; int id = 0, order = OS.kDataBrowserOrderIncreasing; if (sortColumn != null && !sortColumn.isDisposed () && sortDirection != SWT.NONE) { id = sortColumn.id; if (sortDirection == SWT.DOWN) order = OS.kDataBrowserOrderDecreasing; } OS.SetDataBrowserSortProperty (handle, id); OS.SetDataBrowserSortOrder (handle, (short) order); selectIndices (indices, indices.length, true); } /** * Sets the direction of the sort indicator for the receiver. The value * can be one of <code>UP</code>, <code>DOWN</code> or <code>NONE</code>. * * @param direction the direction of the sort indicator * * @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.2 */ public void setSortDirection (int direction) { checkWidget (); if (direction != SWT.UP && direction != SWT.DOWN && direction != SWT.NONE) return; if (direction == sortDirection) return; int [] indices = getSelectionIndices (); sortDirection = direction; int id = 0, order = OS.kDataBrowserOrderIncreasing; if (sortColumn != null && !sortColumn.isDisposed () && sortDirection != SWT.NONE) { id = sortColumn.id; if (sortDirection == SWT.DOWN) order = OS.kDataBrowserOrderDecreasing; } OS.SetDataBrowserSortProperty (handle, id); OS.SetDataBrowserSortOrder (handle, (short) order); selectIndices (indices, indices.length, true); } void setTableEmpty () { OS.SetDataBrowserScrollPosition (handle, 0, 0); itemCount = anchorFirst = anchorLast = savedAnchor = 0; items = new TableItem [4]; if (imageBounds != null) { /* Reset the item height to the font height */ imageBounds = null; setFontStyle (font); } } /** * Sets the zero-relative index of the item which is currently * at the top of the receiver. This index can change when items * are scrolled or new items are added and removed. * * @param index the index of the top 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 void setTopIndex (int index) { checkWidget(); checkItems (false); int itemHeight = getItemHeight (); int [] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); top [0] = Math.max (0, Math.min (itemHeight * itemCount + getHeaderHeight () - getClientArea ().height, index * itemHeight)); OS.SetDataBrowserScrollPosition (handle, top [0], left [0]); } /** * Shows the column. If the column is already showing in the receiver, * this method simply returns. Otherwise, the columns are scrolled until * the column is visible. * * @param column the column to be shown * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the column is null</li> * <li>ERROR_INVALID_ARGUMENT - if the column 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 3.0 */ public void showColumn (TableColumn column) { checkWidget (); if (column == null) error (SWT.ERROR_NULL_ARGUMENT); if (column.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); if (column.parent != this) return; int index = indexOf (column); if (columnCount <= 1 || !(0 <= index && index < columnCount)) return; // Get width and horizontal position of column short [] w = new short [1]; OS.GetDataBrowserTableViewNamedColumnWidth (handle, column.id, w); int width = w [0]; int x = 0; for (int i = 0; i < index; i++) { w = new short [1]; OS.GetDataBrowserTableViewNamedColumnWidth (handle, columns[i].id, w); x += w [0]; } // Get current scroll position int [] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); // Scroll column into view if (x < left[0]) { OS.SetDataBrowserScrollPosition(handle, top [0], x); } else { Rectangle rect = getClientArea (); int maxWidth = rect.width; width = Math.min(width, maxWidth); if (x + width > left [0] + maxWidth) { left [0] = x + width - maxWidth; OS.SetDataBrowserScrollPosition(handle, top [0], left [0]); } } } void showIndex (int index) { if (0 <= index && index < itemCount) { /* * Bug in the Macintosh. When there is not room to show a * single item in the data browser, RevealDataBrowserItem() * scrolls the item such that it is above the top of the data * browser. The fix is to remember the index and scroll when * the data browser is resized. * * Bug in the Macintosh. When items are added to the data * browser after is has been hidden, RevealDataBrowserItem() * when called before the controls behind the data browser * are repainted causes a redraw. This redraw happens right * away causing pixel corruption. The fix is to remember the * index and scroll when the data browser is shown. */ Rectangle rect = getClientArea (); if (rect.height < getItemHeight () || !OS.IsControlVisible (handle)) { showIndex = index; return; } showIndex = -1; TableItem item = _getItem (index); Rectangle itemRect = item.getBounds (0); if (!itemRect.isEmpty()) { if (rect.contains (itemRect.x, itemRect.y) && rect.contains (itemRect.x, itemRect.y + itemRect.height)) return; } int [] top = new int [1], left = new int [1]; OS.GetDataBrowserScrollPosition (handle, top, left); OS.RevealDataBrowserItem (handle, getId (index), OS.kDataBrowserNoItem, (byte) OS.kDataBrowserRevealWithoutSelecting); /* * Bug in the Macintosh. For some reason, when the DataBrowser is scrolled * by RevealDataBrowserItem(), the scrollbars are not redrawn. The fix is to * force a redraw. */ int [] newTop = new int [1], newLeft = new int [1]; OS.GetDataBrowserScrollPosition (handle, newTop, newLeft); if (horizontalBar != null && newLeft [0] != left [0]) horizontalBar.redraw (); if (verticalBar != null && newTop [0] != top [0]) verticalBar.redraw (); } } /** * Shows the item. If the item is already showing in the receiver, * this method simply returns. Otherwise, the items are scrolled until * the item is visible. * * @param item the item to be shown * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the item is null</li> * <li>ERROR_INVALID_ARGUMENT - if the item 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> * * @see Table#showSelection() */ public void showItem (TableItem item) { checkWidget (); checkItems (false); if (item == null) error (SWT.ERROR_NULL_ARGUMENT); if (item.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); int index = indexOf (item); if (index != -1) showIndex (index); } /** * 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 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> * * @see Table#showItem(TableItem) */ public void showSelection () { checkWidget(); checkItems (false); int index = getSelectionIndex (); if (index >= 0) showIndex (index); } int trackingProc (int browser, int id, int property, int theRect, int startPt, int modifiers) { return 1; } }