diff options
Diffstat (limited to 'bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java')
| -rwxr-xr-x | bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java | 1617 |
1 files changed, 1617 insertions, 0 deletions
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java new file mode 100755 index 0000000000..2773e1b3c3 --- /dev/null +++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java @@ -0,0 +1,1617 @@ +/******************************************************************************* + * Copyright (c) 2000, 2009 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.*; +import org.eclipse.swt.events.*; +import org.eclipse.swt.graphics.*; +import org.eclipse.swt.internal.cocoa.*; + +/** + * Instances of this class are controls that allow the user + * to choose an item from a list of items, or optionally + * enter a new value by typing it into an editable text + * field. Often, <code>Combo</code>s are used in the same place + * where a single selection <code>List</code> widget could + * be used but space is limited. A <code>Combo</code> takes + * less space than a <code>List</code> widget and shows + * similar information. + * <p> + * Note: Since <code>Combo</code>s can contain both a list + * and an editable text field, it is possible to confuse methods + * which access one versus the other (compare for example, + * <code>clearSelection()</code> and <code>deselectAll()</code>). + * The API documentation is careful to indicate either "the + * receiver's list" or the "the receiver's text field" to + * distinguish between the two cases. + * </p><p> + * Note that although this class is a subclass of <code>Composite</code>, + * it does not make sense to add children to it, or set a layout on it. + * </p> + * <dl> + * <dt><b>Styles:</b></dt> + * <dd>DROP_DOWN, READ_ONLY, SIMPLE</dd> + * <dt><b>Events:</b></dt> + * <dd>DefaultSelection, Modify, Selection, Verify</dd> + * </dl> + * <p> + * Note: Only one of the styles DROP_DOWN and SIMPLE may be specified. + * </p><p> + * IMPORTANT: This class is <em>not</em> intended to be subclassed. + * </p> + * + * @see List + * @see <a href="http://www.eclipse.org/swt/snippets/#combo">Combo 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 Combo extends Composite { + int textLimit = LIMIT; + boolean receivingFocus; + boolean ignoreVerify, ignoreSelection; + NSRange selectionRange; + + /** + * the operating system limit for the number of characters + * that the text field in an instance of this class can hold + */ + public static final int LIMIT; + + /* + * These values can be different on different platforms. + * Therefore they are not initialized in the declaration + * to stop the compiler from inlining. + */ + static { + LIMIT = 0x7FFFFFFF; + } + + +/** + * 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#DROP_DOWN + * @see SWT#READ_ONLY + * @see SWT#SIMPLE + * @see Widget#checkSubclass + * @see Widget#getStyle + */ +public Combo (Composite parent, int style) { + super (parent, checkStyle (style)); +} + +/** + * Adds the argument to the end of the receiver's list. + * + * @param string the new item + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the string 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 #add(String,int) + */ +public void add (String string) { + checkWidget (); + if (string == null) error (SWT.ERROR_NULL_ARGUMENT); + NSString str = NSString.stringWith(string); + if ((style & SWT.READ_ONLY) != 0) { + NSPopUpButton widget = (NSPopUpButton)view; + int /*long*/ selection = widget.indexOfSelectedItem(); + NSMenu nsMenu = widget.menu(); + NSMenuItem nsItem = (NSMenuItem)new NSMenuItem().alloc(); + nsItem.initWithTitle(str, 0, NSString.stringWith("")); + nsMenu.addItem(nsItem); + nsItem.release(); + if (selection == -1) widget.selectItemAtIndex(-1); + } else { + ((NSComboBox)view).addItemWithObjectValue(str); + } +} + +/** + * Adds the argument to the receiver's list at the given + * zero-relative index. + * <p> + * Note: To add an item at the end of the list, use the + * result of calling <code>getItemCount()</code> as the + * index or use <code>add(String)</code>. + * </p> + * + * @param string the new item + * @param index the index for the item + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the string is null</li> + * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list (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 #add(String) + */ +public void add (String string, int index) { + checkWidget (); + if (string == null) error (SWT.ERROR_NULL_ARGUMENT); + int count = getItemCount (); + if (0 > index || index > count) error (SWT.ERROR_INVALID_RANGE); + NSString str = NSString.stringWith(string); + if ((style & SWT.READ_ONLY) != 0) { + NSPopUpButton widget = (NSPopUpButton)view; + int /*long*/ selection = widget.indexOfSelectedItem(); + NSMenu nsMenu = widget.menu(); + NSMenuItem nsItem = (NSMenuItem)new NSMenuItem().alloc(); + nsItem.initWithTitle(str, 0, NSString.stringWith("")); + nsMenu.insertItem(nsItem, index); + nsItem.release(); + if (selection == -1) widget.selectItemAtIndex(-1); + } else { + ((NSComboBox)view).insertItemWithObjectValue(str, index); + } +} + +/** + * Adds the listener to the collection of listeners who will + * be notified when the receiver's text is modified, by sending + * it one of the messages defined in the <code>ModifyListener</code> + * interface. + * + * @param listener the listener which should 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 ModifyListener + * @see #removeModifyListener + */ +public void addModifyListener (ModifyListener listener) { + checkWidget(); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + TypedListener typedListener = new TypedListener (listener); + addListener (SWT.Modify, typedListener); +} + +/** + * 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> + * <code>widgetSelected</code> is called when the user changes the combo's list selection. + * <code>widgetDefaultSelected</code> is typically called when ENTER is pressed the combo's text area. + * </p> + * + * @param listener the listener which should 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 #removeSelectionListener + * @see SelectionEvent + */ +public void addSelectionListener(SelectionListener listener) { + checkWidget(); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + TypedListener typedListener = new TypedListener (listener); + addListener (SWT.Selection,typedListener); + addListener (SWT.DefaultSelection,typedListener); +} + +/** + * Adds the listener to the collection of listeners who will + * be notified when the receiver's text is verified, by sending + * it one of the messages defined in the <code>VerifyListener</code> + * interface. + * + * @param listener the listener which should 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 VerifyListener + * @see #removeVerifyListener + * + * @since 3.1 + */ +public void addVerifyListener (VerifyListener listener) { + checkWidget(); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + TypedListener typedListener = new TypedListener (listener); + addListener (SWT.Verify, typedListener); +} + +boolean becomeFirstResponder (int /*long*/ id, int /*long*/ sel) { + receivingFocus = true; + boolean result = super.becomeFirstResponder (id, sel); + receivingFocus = false; + return result; +} + +static int checkStyle (int style) { + /* + * Feature in Windows. It is not possible to create + * a combo box that has a border using Windows style + * bits. All combo boxes draw their own border and + * do not use the standard Windows border styles. + * Therefore, no matter what style bits are specified, + * clear the BORDER bits so that the SWT style will + * match the Windows widget. + * + * The Windows behavior is currently implemented on + * all platforms. + */ + style &= ~SWT.BORDER; + + /* + * Even though it is legal to create this widget + * with scroll bars, they serve no useful purpose + * because they do not automatically scroll the + * widget's client area. The fix is to clear + * the SWT style. + */ + style &= ~(SWT.H_SCROLL | SWT.V_SCROLL); + style = checkBits (style, SWT.DROP_DOWN, SWT.SIMPLE, 0, 0, 0, 0); + if ((style & SWT.SIMPLE) != 0) return style & ~SWT.READ_ONLY; + return style; +} + +protected void checkSubclass () { + if (!isValidSubclass ()) error (SWT.ERROR_INVALID_SUBCLASS); +} + +/** + * Sets the selection in the receiver's text field to an empty + * selection starting just before the first character. If the + * text field is editable, this has the effect of placing the + * i-beam at the start of the text. + * <p> + * Note: To clear the selected items in the receiver's list, + * use <code>deselectAll()</code>. + * </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> + * + * @see #deselectAll + */ +public void clearSelection () { + checkWidget(); + if ((style & SWT.READ_ONLY) == 0) { + Point selection = getSelection (); + selection.y = selection.x; + setSelection (selection); + } +} + +public Point computeSize (int wHint, int hHint, boolean changed) { + checkWidget (); + int width = 0, height = 0; + NSControl widget = (NSControl)view; + NSCell viewCell = widget.cell (); + NSSize size = viewCell.cellSize (); + width = (int)Math.ceil (size.width); + height = (int)Math.ceil (size.height); + + if ((style & SWT.READ_ONLY) == 0) { + ignoreVerify = true; + NSComboBoxCell cell = new NSComboBoxCell (viewCell.id); + NSArray array = cell.objectValues (); + int length = (int)/*64*/array.count (); + if (length > 0) { + cell = new NSComboBoxCell (cell.copy ()); + for (int i = 0; i < length; i++) { + id object = array.objectAtIndex (i); + cell.setTitle (new NSString (object)); + size = cell.cellSize (); + width = Math.max (width, (int)Math.ceil (size.width)); + } + cell.release (); + } + ignoreVerify = false; + } + + /* + * Feature in Cocoa. Attempting to create an NSComboBox with a + * height > 27 spews a very long warning message to stdout and + * often draws the combo incorrectly. The workaround is to limit + * the returned height of editable Combos to the height that is + * required to display their text, even if a larger hHint is specified. + */ + if (hHint != SWT.DEFAULT) { + if ((style & SWT.READ_ONLY) != 0 || hHint < height) height = hHint; + } + if (wHint != SWT.DEFAULT) width = wHint; + return new Point (width, height); +} + +/** + * Copies the selected text. + * <p> + * The current selection is copied to the clipboard. + * </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> + * + * @since 2.1 + */ +public void copy () { + checkWidget (); + Point selection = getSelection (); + if (selection.x == selection.y) return; + copyToClipboard (getText (selection.x, selection.y)); +} + +void createHandle () { + if ((style & SWT.READ_ONLY) != 0) { + NSPopUpButton widget = (NSPopUpButton)new SWTPopUpButton().alloc(); + widget.initWithFrame(new NSRect(), false); + widget.menu().setAutoenablesItems(false); + widget.setTarget(widget); + widget.setAction(OS.sel_sendSelection); + view = widget; + } else { + NSComboBox widget = (NSComboBox)new SWTComboBox().alloc(); + widget.init(); + widget.setDelegate(widget); + widget.setTarget(widget); + widget.setAction(OS.sel_sendSelection); + view = widget; + } +} + +/** + * Cuts the selected text. + * <p> + * The current selection is first copied to the + * clipboard and then deleted from the widget. + * </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> + * + * @since 2.1 + */ +public void cut () { + checkWidget (); + if ((style & SWT.READ_ONLY) != 0) return; + Point selection = getSelection (); + if (selection.x == selection.y) return; + int start = selection.x, end = selection.y; + String text = getText (); + String leftText = text.substring (0, start); + String rightText = text.substring (end, text.length ()); + String oldText = text.substring (start, end); + String newText = ""; + if (hooks (SWT.Verify) || filters (SWT.Verify)) { + newText = verifyText (newText, start, end, null); + if (newText == null) return; + } + char [] buffer = new char [oldText.length ()]; + oldText.getChars (0, buffer.length, buffer, 0); + copyToClipboard (buffer); + setText (leftText + newText + rightText, false); + start += newText.length (); + setSelection (new Point (start, start)); + sendEvent (SWT.Modify); +} + +Color defaultBackground () { + return display.getWidgetColor (SWT.COLOR_LIST_BACKGROUND); +} + +NSFont defaultNSFont() { + if ((style & SWT.READ_ONLY) != 0) return display.popUpButtonFont; + return display.comboBoxFont; +} + +Color defaultForeground () { + return display.getWidgetColor (SWT.COLOR_LIST_FOREGROUND); +} + +void deregister() { + super.deregister(); + display.removeWidget(((NSControl)view).cell()); +} + +/** + * Deselects the item at the given zero-relative index in the receiver's + * list. 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 (index == -1) return; + if (index == getSelectionIndex ()) { + if ((style & SWT.READ_ONLY) != 0) { + ((NSPopUpButton)view).selectItem(null); + sendEvent (SWT.Modify); + } else { + ((NSComboBox)view).deselectItemAtIndex(index); + } + } +} + +/** + * Deselects all selected items in the receiver's list. + * <p> + * Note: To clear the selection in the receiver's text field, + * use <code>clearSelection()</code>. + * </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> + * + * @see #clearSelection + */ +public void deselectAll () { + checkWidget (); + if ((style & SWT.READ_ONLY) != 0) { + ((NSPopUpButton)view).selectItem(null); + sendEvent (SWT.Modify); + } else { + NSComboBox widget = (NSComboBox)view; + int /*long*/ index = widget.indexOfSelectedItem(); + if (index != -1) widget.deselectItemAtIndex(index); + } +} + +boolean dragDetect(int x, int y, boolean filter, boolean[] consume) { + if ((style & SWT.READ_ONLY) == 0) { + NSText fieldEditor = ((NSControl)view).currentEditor(); + if (fieldEditor != null) { + NSRange selectedRange = fieldEditor.selectedRange(); + if (selectedRange.length > 0) { + NSPoint mouseLocation = NSEvent.mouseLocation(); + NSTextView feAsTextView = new NSTextView(fieldEditor); + int /*long*/ charPosition = feAsTextView.characterIndexForInsertionAtPoint(mouseLocation); + if (charPosition != OS.NSNotFound && charPosition >= selectedRange.location && charPosition < (selectedRange.location + selectedRange.length)) { + if (super.dragDetect(x, y, filter, consume)) { + if (consume != null) consume[0] = true; + return true; + } + } + } + } + return false; + } + + return super.dragDetect(x, y, filter, consume); +} + +int getCharCount() { + NSString str; + if ((style & SWT.READ_ONLY) != 0) { + str = ((NSPopUpButton)view).titleOfSelectedItem(); + } else { + str = new NSCell(((NSComboBox)view).cell()).title(); + } + if (str == null) return 0; + return (int)/*64*/str.length(); +} + +/** + * Returns the item at the given, zero-relative index in the + * receiver's list. 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 String getItem (int index) { + checkWidget (); + int count = getItemCount (); + if (0 > index || index >= count) error (SWT.ERROR_INVALID_RANGE); + NSString str; + if ((style & SWT.READ_ONLY) != 0) { + str = ((NSPopUpButton)view).itemTitleAtIndex(index); + } else { + str = new NSString(((NSComboBox)view).itemObjectValueAtIndex(index)); + } + if (str == null) error(SWT.ERROR_CANNOT_GET_ITEM); + return str.getString(); +} + +/** + * Returns the number of items contained in the receiver's list. + * + * @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 (); + if ((style & SWT.READ_ONLY) != 0) { + return (int)/*64*/((NSPopUpButton)view).numberOfItems(); + } else { + return (int)/*64*/((NSComboBox)view).numberOfItems(); + } +} + +/** + * Returns the height of the area which would be used to + * display <em>one</em> of the items in the receiver's list. + * + * @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 (); + //TODO - not supported by the OS + return 26; +} + +/** + * Returns a (possibly empty) array of <code>String</code>s which are + * the items in the receiver's list. + * <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's list + * + * @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 String [] getItems () { + checkWidget (); + int count = getItemCount (); + String [] result = new String [count]; + for (int i=0; i<count; i++) result [i] = getItem (i); + return result; +} + +/** + * Returns <code>true</code> if the receiver's list 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 list'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> + * + * @since 3.4 + */ +public boolean getListVisible () { + //TODO + return false; +} + +int getMininumHeight () { + return getTextHeight (); +} + +/** + * Returns the orientation of the receiver. + * + * @return the orientation style + * + * @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.1.2 + */ +public int getOrientation () { + checkWidget(); + return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT); +} + +/** + * Returns a <code>Point</code> whose x coordinate is the + * character position representing the start of the selection + * in the receiver's text field, and whose y coordinate is the + * character position representing the end of the selection. + * An "empty" selection is indicated by the x and y coordinates + * having the same value. + * <p> + * Indexing is zero based. The range of a selection is from + * 0..N where N is the number of characters in the widget. + * </p> + * + * @return a point representing the selection start and end + * + * @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 Point getSelection () { + checkWidget (); + if ((style & SWT.READ_ONLY) != 0) { + return new Point (0, getCharCount ()); + } else { + if (selectionRange == null) { + NSString str = new NSTextFieldCell (((NSTextField) view).cell ()).title (); + return new Point((int)/*64*/str.length (), (int)/*64*/str.length ()); + } + return new Point((int)/*64*/selectionRange.location, (int)/*64*/(selectionRange.location + selectionRange.length)); + } +} + +/** + * Returns the zero-relative index of the item which is currently + * selected in the receiver's list, 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 (); + if ((style & SWT.READ_ONLY) != 0) { + return (int)/*64*/((NSPopUpButton)view).indexOfSelectedItem(); + } else { + return (int)/*64*/((NSComboBox)view).indexOfSelectedItem(); + } +} + +/** + * Returns a string containing a copy of the contents of the + * receiver's text field, or an empty string if there are no + * contents. + * + * @return the receiver's text + * + * @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 String getText () { + checkWidget (); + return new String (getText(0, -1)); +} + +char [] getText (int start, int end) { + NSString str; + if ((style & SWT.READ_ONLY) != 0) { + str = ((NSPopUpButton)view).titleOfSelectedItem(); + } else { + str = new NSCell(((NSComboBox)view).cell()).title(); + } + if (str == null) return new char[0]; + NSRange range = new NSRange (); + range.location = start; + if (end == -1) { + int /*long*/ length = str.length(); + range.length = length - start; + } else { + range.length = end - start; + } + char [] buffer= new char [(int)/*64*/range.length]; + str.getCharacters(buffer, range); + return buffer; +} + +/** + * Returns the height of the receivers's text field. + * + * @return the text height + * + * @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 getTextHeight () { + checkWidget(); + NSCell cell; + if ((style & SWT.READ_ONLY) != 0) { + cell = ((NSPopUpButton)view).cell(); + } else { + cell = ((NSComboBox)view).cell(); + } + return (int)cell.cellSize().height; +} + +/** + * Returns the maximum number of characters that the receiver's + * text field is capable of holding. If this has not been changed + * by <code>setTextLimit()</code>, it will be the constant + * <code>Combo.LIMIT</code>. + * + * @return the text limit + * + * @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 #LIMIT + */ +public int getTextLimit () { + checkWidget(); + return textLimit; +} + +/** + * Gets the number of items that are visible in the drop + * down portion of the receiver's list. + * <p> + * Note: This operation is a hint and is not supported on + * platforms that do not have this concept. + * </p> + * + * @return the number of items that are 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 3.0 + */ +public int getVisibleItemCount () { + checkWidget (); + if ((style & SWT.READ_ONLY) != 0) { + return getItemCount (); + } else { + return (int)/*64*/((NSComboBox)view).numberOfVisibleItems(); + } +} + +/** + * 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 string the search item + * @return the index of the item + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the string 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 (String string) { + return indexOf (string, 0); +} + +/** + * Searches the receiver's list starting at the given, + * zero-relative index until an item is found that is equal + * to the argument, and returns the index of that item. If + * no item is found or the starting index is out of range, + * returns -1. + * + * @param string the search item + * @param start the zero-relative index at which to begin the search + * @return the index of the item + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the string 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 (String string, int start) { + checkWidget(); + if (string == null) error (SWT.ERROR_NULL_ARGUMENT); + int count = getItemCount (); + if (!(0 <= start && start < count)) return -1; + for (int i=start; i<count; i++) { + if (string.equals (getItem (i))) { + return i; + } + } + return -1; +} + +void insertEditText (String string) { + ignoreVerify = true; + int length = string.length (); + Point selection = getSelection (); + if (hasFocus ()) { + if (textLimit != LIMIT) { + int charCount = getCharCount(); + if (charCount - (selection.y - selection.x) + length > textLimit) { + length = textLimit - charCount + (selection.y - selection.x); + } + } + char [] buffer = new char [length]; + string.getChars (0, buffer.length, buffer, 0); + NSString nsstring = NSString.stringWithCharacters (buffer, buffer.length); + NSText fieldEditor = ((NSTextField) view).currentEditor (); + fieldEditor.replaceCharactersInRange (fieldEditor.selectedRange (), nsstring); + selectionRange = null; + } else { + String oldText = getText (); + if (textLimit != LIMIT) { + int charCount = oldText.length (); + if (charCount - (selection.y - selection.x) + length > textLimit) { + string = string.substring(0, textLimit - charCount + (selection.y - selection.x)); + } + } + String newText = oldText.substring (0, selection.x) + string + oldText.substring (selection.y); + NSString nsstring = NSString.stringWith(newText); + new NSCell (((NSTextField) view).cell ()).setTitle (nsstring); + selectionRange = null; + setSelection (new Point(selection.x + string.length (), 0)); + } + ignoreVerify = false; +} + +boolean isEventView (int /*long*/ id) { + return true; +} + +void mouseDown(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { + // If this is a combo box with an editor field and the control is disposed + // while the view's cell editor is open we crash while tearing down the + // popup window. Fix is to retain the view before letting Cocoa track + // the mouse events. + + // 'view' will be cleared if disposed during the mouseDown so cache it. + NSView viewCopy = view; + viewCopy.retain(); + super.mouseDown(id, sel, theEvent); + viewCopy.release(); +} + +/** + * Pastes text from clipboard. + * <p> + * The selected text is deleted from the widget + * and new text inserted from the clipboard. + * </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> + * + * @since 2.1 + */ +public void paste () { + checkWidget (); + if ((style & SWT.READ_ONLY) != 0) return; + Point selection = getSelection (); + int start = selection.x, end = selection.y; + String text = getText (); + String leftText = text.substring (0, start); + String rightText = text.substring (end, text.length ()); + String newText = getClipboardText (); + if (newText == null) return; + if (hooks (SWT.Verify) || filters (SWT.Verify)) { + newText = verifyText (newText, start, end, null); + if (newText == null) return; + } + if (textLimit != LIMIT) { + int charCount = text.length (); + if (charCount - (end - start) + newText.length() > textLimit) { + newText = newText.substring(0, textLimit - charCount + (end - start)); + } + } + setText (leftText + newText + rightText, false); + start += newText.length (); + setSelection (new Point (start, start)); + sendEvent (SWT.Modify); +} + +void register() { + super.register(); + display.addWidget(((NSControl)view).cell(), this); +} + +void releaseWidget () { + super.releaseWidget (); + if ((style & SWT.READ_ONLY) == 0) { + ((NSControl)view).abortEditing(); + } + selectionRange = null; +} + +/** + * Removes the item from the receiver's list 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 (); + if (index == -1) error (SWT.ERROR_INVALID_RANGE); + int count = getItemCount (); + if (0 > index || index >= count) error (SWT.ERROR_INVALID_RANGE); + if ((style & SWT.READ_ONLY) != 0) { + ((NSPopUpButton)view).removeItemAtIndex(index); + } else { + ((NSComboBox)view).removeItemAtIndex(index); + } +} + +/** + * Removes the items from the receiver's list 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(); + if (start > end) return; + int count = getItemCount (); + if (!(0 <= start && start <= end && end < count)) { + error (SWT.ERROR_INVALID_RANGE); + } + int newEnd = Math.min (end, count - 1); + for (int i=newEnd; i>=start; i--) { + remove(i); + } +} + +/** + * Searches the receiver's list starting at the first item + * until an item is found that is equal to the argument, + * and removes that item from the list. + * + * @param string the item to remove + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the string is null</li> + * <li>ERROR_INVALID_ARGUMENT - if the string is not found in the list</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 (String string) { + checkWidget (); + if (string == null) error (SWT.ERROR_NULL_ARGUMENT); + int index = indexOf (string, 0); + if (index == -1) error (SWT.ERROR_INVALID_ARGUMENT); + remove (index); +} + +/** + * Removes all of the items from the receiver's list and clear the + * contents of receiver's text field. + * <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 removeAll () { + checkWidget (); + if ((style & SWT.READ_ONLY) != 0) { + ((NSPopUpButton)view).removeAllItems(); + } else { + setText ("", true); + ((NSComboBox)view).removeAllItems(); + } +} + +/** + * Removes the listener from the collection of listeners who will + * be notified when the receiver's text is modified. + * + * @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 ModifyListener + * @see #addModifyListener + */ +public void removeModifyListener (ModifyListener listener) { + checkWidget(); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + if (eventTable == null) return; + eventTable.unhook (SWT.Modify, listener); +} + +/** + * 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 + */ +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); +} + +/** + * Removes the listener from the collection of listeners who will + * be notified when the control is verified. + * + * @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 VerifyListener + * @see #addVerifyListener + * + * @since 3.1 + */ +public void removeVerifyListener (VerifyListener listener) { + checkWidget(); + if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); + if (eventTable == null) return; + eventTable.unhook (SWT.Verify, listener); +} + +/** + * Selects the item at the given zero-relative index in the receiver's + * list. 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 (); + int count = getItemCount (); + ignoreSelection = true; + if (0 <= index && index < count) { + if ((style & SWT.READ_ONLY) != 0) { + ((NSPopUpButton)view).selectItemAtIndex(index); + } else { + ((NSComboBox)view).selectItemAtIndex(index); + } + } + ignoreSelection = false; + sendEvent (SWT.Modify); +} + +void sendSelection () { + sendEvent(SWT.Modify); + if (!ignoreSelection) postEvent(SWT.Selection); +} + +boolean sendKeyEvent (NSEvent nsEvent, int type) { + boolean result = super.sendKeyEvent (nsEvent, type); + if (!result) return result; + int stateMask = 0; + int /*long*/ modifierFlags = nsEvent.modifierFlags(); + if ((modifierFlags & OS.NSAlternateKeyMask) != 0) stateMask |= SWT.ALT; + if ((modifierFlags & OS.NSShiftKeyMask) != 0) stateMask |= SWT.SHIFT; + if ((modifierFlags & OS.NSControlKeyMask) != 0) stateMask |= SWT.CONTROL; + if ((modifierFlags & OS.NSCommandKeyMask) != 0) stateMask |= SWT.COMMAND; + if (type != SWT.KeyDown) return result; + short keyCode = nsEvent.keyCode (); + if (stateMask == SWT.COMMAND) { + switch (keyCode) { + case 7: /* X */ + cut (); + return false; + case 8: /* C */ + copy (); + return false; + case 9: /* V */ + paste (); + return false; + case 0: /* A */ + if ((style & SWT.READ_ONLY) == 0) { + ((NSComboBox)view).selectText(null); + return false; + } + } + } + switch (keyCode) { + case 76: /* KP Enter */ + case 36: /* Return */ + postEvent (SWT.DefaultSelection); + } + return result; +} + +void updateBackground () { + NSColor nsColor = null; + if (backgroundImage != null) { + nsColor = NSColor.colorWithPatternImage(backgroundImage.handle); + } else if (background != null) { + nsColor = NSColor.colorWithDeviceRed(background[0], background[1], background[2], background[3]); + } else { + nsColor = NSColor.textBackgroundColor (); + } + + if ((style & SWT.READ_ONLY) != 0) { + //TODO + } else { + ((NSTextField)view).setBackgroundColor(nsColor); + } +} + +void setBounds (int x, int y, int width, int height, boolean move, boolean resize) { + /* + * Feature in Cocoa. Attempting to create an NSComboBox with a + * height > 27 spews a very long warning message to stdout and + * often draws the combo incorrectly. The workaround is to limit + * the height of editable Combos to the height that is required + * to display their text. + */ + if ((style & SWT.READ_ONLY) == 0) { + NSControl widget = (NSControl)view; + NSSize size = widget.cell ().cellSize (); + height = Math.min (height, (int)Math.ceil (size.height)); + } + super.setBounds (x, y, width, height, move, resize); +} + +void setForeground (float /*double*/ [] color) { + NSColor nsColor; + if (color == null) { + nsColor = NSColor.textColor (); + } else { + nsColor = NSColor.colorWithDeviceRed(color[0], color[1], color[2], 1); + } + if ((style & SWT.READ_ONLY) != 0) { + //TODO + } else { + ((NSTextField)view).setTextColor(nsColor); + } +} + +/** + * Sets the text of the item in the receiver's list at the given + * zero-relative index to the string argument. + * + * @param index the index for the item + * @param string the new text 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> + * <li>ERROR_NULL_ARGUMENT - if the string 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 setItem (int index, String string) { + checkWidget (); + if (string == null) error (SWT.ERROR_NULL_ARGUMENT); + int count = getItemCount (); + if (0 > index || index >= count) error (SWT.ERROR_INVALID_RANGE); + NSString str = NSString.stringWith(string); + if ((style & SWT.READ_ONLY) != 0) { + NSMenuItem nsItem = ((NSPopUpButton)view).itemAtIndex(index); + nsItem.setTitle(str); + } else { + NSComboBox widget = (NSComboBox)view; + widget.insertItemWithObjectValue(str, index); + widget.removeItemAtIndex(index + 1); + } +} + +/** + * Sets the receiver's list to be the given array of items. + * + * @param items the array of items + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the items array is null</li> + * <li>ERROR_INVALID_ARGUMENT - if an item in the items 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 setItems (String [] items) { + checkWidget(); + if (items == null) error (SWT.ERROR_NULL_ARGUMENT); + for (int i=0; i<items.length; i++) { + if (items [i] == null) error (SWT.ERROR_INVALID_ARGUMENT); + } + removeAll(); + if (items.length == 0) return; + for (int i= 0; i < items.length; i++) { + NSString str = NSString.stringWith(items[i]); + if ((style & SWT.READ_ONLY) != 0) { + NSMenu nsMenu = ((NSPopUpButton)view).menu(); + NSMenuItem nsItem = (NSMenuItem)new NSMenuItem().alloc(); + nsItem.initWithTitle(str, 0, NSString.stringWith("")); + nsMenu.addItem(nsItem); + nsItem.release(); + //clear the selection + ((NSPopUpButton)view).selectItemAtIndex(-1); + } else { + ((NSComboBox)view).addItemWithObjectValue(str); + } + } +} + +/** + * Marks the receiver's list 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 visible 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> + * + * @since 3.4 + */ +public void setListVisible (boolean visible) { + checkWidget (); + if ((style & SWT.READ_ONLY) != 0) { + ((NSPopUpButton)view).setPullsDown(visible); + } else { + } +} + +/** + * Sets the orientation of the receiver, which must be one + * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>. + * <p> + * + * @param orientation new orientation style + * + * @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.1.2 + */ +public void setOrientation (int orientation) { + checkWidget(); +} + +/** + * Sets the selection in the receiver's text field to the + * range specified by the argument whose x coordinate is the + * start of the selection and whose y coordinate is the end + * of the selection. + * + * @param selection a point representing the new selection start and end + * + * @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 void setSelection (Point selection) { + checkWidget (); + if (selection == null) error (SWT.ERROR_NULL_ARGUMENT); + if ((style & SWT.READ_ONLY) == 0) { + NSComboBox widget = (NSComboBox)view; + NSString str = new NSCell(widget.cell()).title(); + int length = (int)/*64*/str.length(); + int start = Math.min (Math.max (Math.min (selection.x, selection.y), 0), length); + int end = Math.min (Math.max (Math.max (selection.x, selection.y), 0), length); + selectionRange = new NSRange(); + selectionRange.location = start; + selectionRange.length = end - start; + NSText fieldEditor = widget.currentEditor(); + if (fieldEditor != null) fieldEditor.setSelectedRange(selectionRange); + } +} + +/** + * Sets the contents of the receiver's text field to the + * given string. + * <p> + * This call is ignored when the receiver is read only and + * the given string is not in the receiver's list. + * </p> + * <p> + * Note: The text field in a <code>Combo</code> is typically + * only capable of displaying a single line of text. Thus, + * setting the text to a string containing line breaks or + * other special characters will probably cause it to + * display incorrectly. + * </p> + * + * @param string the new text + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the string 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 setText (String string) { + checkWidget (); + if (string == null) error (SWT.ERROR_NULL_ARGUMENT); + setText (string, true); +} + +void setText (String string, boolean notify) { + ignoreVerify = true; + if (notify) { + if (hooks (SWT.Verify) || filters (SWT.Verify)) { + string = verifyText (string, 0, getCharCount (), null); + if (string == null) return; + } + } + if ((style & SWT.READ_ONLY) != 0) { + int index = indexOf (string); + if (index != -1 && index != getSelectionIndex ()) { + select (index); + if (notify) sendEvent (SWT.Modify); + } + } else { + char[] buffer = new char [Math.min(string.length (), textLimit)]; + string.getChars (0, buffer.length, buffer, 0); + NSString nsstring = NSString.stringWithCharacters (buffer, buffer.length); + new NSCell(((NSComboBox)view).cell()).setTitle(nsstring); + if (notify) sendEvent (SWT.Modify); + } + selectionRange = null; + ignoreVerify = false; +} + +/** + * Sets the maximum number of characters that the receiver's + * text field is capable of holding to be the argument. + * <p> + * To reset this value to the default, use <code>setTextLimit(Combo.LIMIT)</code>. + * Specifying a limit value larger than <code>Combo.LIMIT</code> sets the + * receiver's limit to <code>Combo.LIMIT</code>. + * </p> + * @param limit new text limit + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_CANNOT_BE_ZERO - if the limit is zero</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 #LIMIT + */ +public void setTextLimit (int limit) { + checkWidget (); + if (limit == 0) error (SWT.ERROR_CANNOT_BE_ZERO); + textLimit = limit; +} + +/** + * Sets the number of items that are visible in the drop + * down portion of the receiver's list. + * <p> + * Note: This operation is a hint and is not supported on + * platforms that do not have this concept. + * </p> + * + * @param count the new number of items to be 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 3.0 + */ +public void setVisibleItemCount (int count) { + checkWidget (); + if (count < 0) return; + if ((style & SWT.READ_ONLY) != 0) { + //TODO + } else { + ((NSComboBox)view).setNumberOfVisibleItems(count); + } +} + +boolean shouldChangeTextInRange_replacementString(int /*long*/ id, int /*long*/ sel, int /*long*/ affectedCharRange, int /*long*/ replacementString) { + NSRange range = new NSRange(); + OS.memmove(range, affectedCharRange, NSRange.sizeof); + boolean result = callSuperBoolean(id, sel, range, replacementString); + if (hooks (SWT.Verify)) { + String text = new NSString(replacementString).getString(); + NSEvent currentEvent = display.application.currentEvent(); + int /*long*/ type = currentEvent.type(); + if (type != OS.NSKeyDown && type != OS.NSKeyUp) currentEvent = null; + String newText = verifyText(text, (int)/*64*/range.location, (int)/*64*/(range.location+range.length), currentEvent); + if (newText == null) return false; + if (text != newText) { + insertEditText(newText); + result = false; + } + if (!result) sendEvent (SWT.Modify); + } + return result; +} + +void textViewDidChangeSelection(int /*long*/ id, int /*long*/ sel, int /*long*/ aNotification) { + NSNotification notification = new NSNotification(aNotification); + NSText editor = new NSText(notification.object().id); + selectionRange = editor.selectedRange(); +} + +void textDidChange (int /*long*/ id, int /*long*/ sel, int /*long*/ aNotification) { + super.textDidChange (id, sel, aNotification); + postEvent (SWT.Modify); +} + +NSRange textView_willChangeSelectionFromCharacterRange_toCharacterRange(int /*long*/ id, int /*long*/ sel, int /*long*/ aTextView, int /*long*/ oldSelectedCharRange, int /*long*/ newSelectedCharRange) { + /* + * If the selection is changing as a result of the receiver getting focus + * then return the receiver's last selection range, otherwise the full + * text will be automatically selected. + */ + if (receivingFocus && selectionRange != null) return selectionRange; + + /* allow the selection change to proceed */ + NSRange result = new NSRange(); + OS.memmove(result, newSelectedCharRange, NSRange.sizeof); + return result; +} + +String verifyText (String string, int start, int end, NSEvent keyEvent) { + Event event = new Event (); + if (keyEvent != null) setKeyState(event, SWT.MouseDown, keyEvent); + event.text = string; + event.start = start; + event.end = end; + /* + * It is possible (but unlikely), that application + * code could have disposed the widget in the verify + * event. If this happens, answer null to cancel + * the operation. + */ + sendEvent (SWT.Verify, event); + if (!event.doit || isDisposed ()) return null; + return event.text; +} + +} |