/******************************************************************************* * 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.*; import org.eclipse.swt.accessibility.*; import org.eclipse.swt.events.*; import org.eclipse.swt.graphics.*; import org.eclipse.swt.internal.*; import org.eclipse.swt.internal.cocoa.*; /** * Control is the abstract superclass of all windowed user interface classes. *

*

*
Styles: *
BORDER
*
LEFT_TO_RIGHT, RIGHT_TO_LEFT
*
Events: *
DragDetect, FocusIn, FocusOut, Help, KeyDown, KeyUp, MenuDetect, MouseDoubleClick, MouseDown, MouseEnter, * MouseExit, MouseHover, MouseUp, MouseMove, MouseWheel, MouseHorizontalWheel, MouseVerticalWheel, Move, * Paint, Resize, Traverse
*
*

* Only one of LEFT_TO_RIGHT or RIGHT_TO_LEFT may be specified. *

* IMPORTANT: This class is intended to be subclassed only * within the SWT implementation. *

* * @see Control snippets * @see SWT Example: ControlExample * @see Sample code and further information * @noextend This class is not intended to be subclassed by clients. */ public abstract class Control extends Widget implements Drawable { /** * the handle to the OS resource * (Warning: This field is platform dependent) *

* IMPORTANT: This field is not part of the SWT * public API. It is marked public only so that it can be shared * within the packages provided by SWT. It is not available on all * platforms and should never be accessed from application code. *

* * @noreference This field is not intended to be referenced by clients. */ public NSView view; Composite parent; String toolTipText; Object layoutData; int drawCount; Menu menu; float /*double*/ [] foreground, background; Image backgroundImage; Font font; Cursor cursor; Region region; NSBezierPath regionPath; int /*long*/ visibleRgn; Accessible accessible; boolean touchEnabled; final static int CLIPPING = 1 << 10; final static int VISIBLE_REGION = 1 << 12; /** * Magic number comes from experience. There's no API for this value in Cocoa or Carbon. */ static final int DEFAULT_DRAG_HYSTERESIS = 5; Control () { /* Do nothing */ } /** * Constructs a new instance of this class given its parent * and a style value describing its behavior and appearance. *

* The style value is either one of the style constants defined in * class SWT which is applicable to instances of this * class, or must be built by bitwise OR'ing together * (that is, using the int "|" operator) two or more * of those SWT style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. *

* * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * * @exception IllegalArgumentException * @exception SWTException * * @see SWT#BORDER * @see SWT#LEFT_TO_RIGHT * @see SWT#RIGHT_TO_LEFT * @see Widget#checkSubclass * @see Widget#getStyle */ public Control (Composite parent, int style) { super (parent, style); this.parent = parent; createWidget (); } boolean acceptsFirstMouse (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { Shell shell = getShell (); if ((shell.style & SWT.ON_TOP) != 0) return true; return super.acceptsFirstMouse (id, sel, theEvent); } int /*long*/ accessibleHandle() { int /*long*/ returnValue = view.id; if (view instanceof NSControl) { if (((NSControl) view).cell() != null) { returnValue = ((NSControl) view).cell().id; } } return returnValue; } int /*long*/ accessibilityActionDescription(int /*long*/ id, int /*long*/ sel, int /*long*/ arg0) { if (id == accessibleHandle() && accessible != null) { NSString actionName = new NSString(arg0); id returnValue = accessible.internal_accessibilityActionDescription(actionName, ACC.CHILDID_SELF); if (returnValue != null) return returnValue.id; } return super.accessibilityActionDescription(id, sel, arg0); } int /*long*/ accessibilityActionNames(int /*long*/ id, int /*long*/ sel) { int /*long*/ returnValue = super.accessibilityActionNames(id, sel); if (handleIsAccessible(id)) { if (accessible != null) { NSArray baseArray = accessible.internal_accessibilityActionNames(ACC.CHILDID_SELF); if (baseArray != null) returnValue = baseArray.id; } if (hooks(SWT.MenuDetect) || (menu != null && !menu.isDisposed())) { NSArray baseArray = new NSArray(returnValue); NSMutableArray ourNames = NSMutableArray.arrayWithCapacity(baseArray.count() + 1); ourNames.addObjectsFromArray(baseArray); ourNames.addObject(OS.NSAccessibilityShowMenuAction); returnValue = ourNames.id; } } return returnValue; } int /*long*/ accessibilityAttributeNames(int /*long*/ id, int /*long*/ sel) { int /*long*/ returnValue = 0; if (handleIsAccessible(id) && accessible != null) { // See if the accessible is defining the attribute set for the control. id value = accessible.internal_accessibilityAttributeNames(ACC.CHILDID_SELF); returnValue = (value != null ? value.id : 0); // If not, ask Cocoa for the set for this control. if (returnValue == 0) returnValue = super.accessibilityAttributeNames(id, sel); // Add relationship attributes. returnValue = accessible.internal_addRelationAttributes(returnValue); } // If the SWT accessibility didn't give us anything get the default for the view/cell. if (returnValue == 0) returnValue = super.accessibilityAttributeNames(id, sel); return returnValue; } /** * @param id NSView/NSCell that makes up this control. Could be the view itself. * @return true if id is something whose accessible properties can be augmented * or overridden by the SWT Accessible. false if the Cocoa defaults for the control should * be used. */ boolean handleIsAccessible(int /*long*/ id) { return id == accessibleHandle(); } int /*long*/ accessibilityParameterizedAttributeNames(int /*long*/ id, int /*long*/ sel) { if (handleIsAccessible(id) && accessible != null) { NSArray returnValue = accessible.internal_accessibilityParameterizedAttributeNames(ACC.CHILDID_SELF); if (returnValue != null) return returnValue.id; } return super.accessibilityParameterizedAttributeNames(id, sel); } void accessibilityPerformAction(int /*long*/ id, int /*long*/ sel, int /*long*/ arg0) { if (handleIsAccessible(id) && accessible != null) { NSString action = new NSString(arg0); if (accessible.internal_accessibilityPerformAction(action, ACC.CHILDID_SELF)) return; } super.accessibilityPerformAction(id, sel, arg0); } int /*long*/ accessibilityFocusedUIElement(int /*long*/ id, int /*long*/ sel) { id returnValue = null; if (handleIsAccessible(id) && accessible != null) { returnValue = accessible.internal_accessibilityFocusedUIElement(ACC.CHILDID_SELF); } // If we had an accessible and it didn't handle the attribute request, let the // superclass handle it. if (returnValue == null) return super.accessibilityFocusedUIElement(id, sel); else return returnValue.id; } int /*long*/ accessibilityHitTest(int /*long*/ id, int /*long*/ sel, NSPoint point) { id returnValue = null; if (handleIsAccessible(id) && accessible != null) { returnValue = accessible.internal_accessibilityHitTest(point, ACC.CHILDID_SELF); } // If we had an accessible and it didn't handle the attribute request, let the // superclass handle it. if (returnValue == null) return super.accessibilityHitTest(id, sel, point); else return returnValue.id; } int /*long*/ accessibilityAttributeValue(int /*long*/ id, int /*long*/ sel, int /*long*/ arg0) { NSString attribute = new NSString(arg0); int /*long*/ returnValue = 0; id returnObject = null; if (handleIsAccessible(id) && accessible != null) { returnObject = accessible.internal_accessibilityAttributeValue(attribute, ACC.CHILDID_SELF); } // If we had an accessible and it didn't handle the attribute request, let the // superclass handle it. if (returnObject == null) { returnValue = super.accessibilityAttributeValue(id, sel, arg0); // Feature in Cocoa: SWT doesn't use setToolTip for tooltip support, so if the // help attribute was requested return toolTipText. if (returnObject == null) { if (attribute.isEqualToString(OS.NSAccessibilityHelpAttribute)) { if (toolTipText != null) returnValue = NSString.stringWith(toolTipText).id; } } } else { returnValue = returnObject.id; } return returnValue; } int /*long*/ accessibilityAttributeValue_forParameter(int /*long*/ id, int /*long*/ sel, int /*long*/ arg0, int /*long*/ arg1) { NSString attribute = new NSString(arg0); id returnValue = null; if (handleIsAccessible(id) && accessible != null) { id parameter = new id(arg1); returnValue = accessible.internal_accessibilityAttributeValue_forParameter(attribute, parameter, ACC.CHILDID_SELF); } // If we had an accessible and it didn't handle the attribute request, let the // superclass handle it. if (returnValue == null) return super.accessibilityAttributeValue_forParameter(id, sel, arg0, arg1); else return returnValue.id; } boolean accessibilityIsAttributeSettable(int /*long*/ id, int /*long*/ sel, int /*long*/ arg0) { boolean returnValue = false; if (handleIsAccessible(id) && accessible != null) { NSString attribute = new NSString (arg0); returnValue = accessible.internal_accessibilityIsAttributeSettable(attribute, ACC.CHILDID_SELF); } if (!returnValue) { returnValue = super.accessibilityIsAttributeSettable(id, sel, arg0); } return returnValue; } void accessibilitySetValue_forAttribute(int /*long*/ id, int /*long*/ sel, int /*long*/ arg0, int /*long*/ arg1) { if (handleIsAccessible(id) && accessible != null) { id value = new id(arg0); NSString attribute = new NSString(arg1); accessible.internal_accessibilitySetValue_forAttribute(value, attribute, ACC.CHILDID_SELF); } else { super.accessibilitySetValue_forAttribute(id, sel, arg0, arg1); } } /** * Adds the listener to the collection of listeners who will * be notified when the control is moved or resized, by sending * it one of the messages defined in the ControlListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see ControlListener * @see #removeControlListener */ public void addControlListener(ControlListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.Resize,typedListener); addListener (SWT.Move,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when a drag gesture occurs, by sending it * one of the messages defined in the DragDetectListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see DragDetectListener * @see #removeDragDetectListener * * @since 3.3 */ public void addDragDetectListener (DragDetectListener listener) { checkWidget (); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.DragDetect,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when the control gains or loses focus, by sending * it one of the messages defined in the FocusListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see FocusListener * @see #removeFocusListener */ public void addFocusListener(FocusListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener(SWT.FocusIn,typedListener); addListener(SWT.FocusOut,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when gesture events are generated for the control, * by sending it one of the messages defined in the * GestureListener interface. *

* NOTE: If setTouchEnabled(true) has previously been * invoked on the receiver then setTouchEnabled(false) * must be invoked on it to specify that gesture events should be * sent instead of touch events. *

* * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see GestureListener * @see #removeGestureListener * @see #setTouchEnabled * * @since 3.7 */ public void addGestureListener (GestureListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.Gesture, typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when help events are generated for the control, * by sending it one of the messages defined in the * HelpListener interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see HelpListener * @see #removeHelpListener */ public void addHelpListener (HelpListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.Help, typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when keys are pressed and released on the system keyboard, by sending * it one of the messages defined in the KeyListener * interface. *

* When a key listener is added to a control, the control * will take part in widget traversal. By default, all * traversal keys (such as the tab key and so on) are * delivered to the control. In order for a control to take * part in traversal, it should listen for traversal events. * Otherwise, the user can traverse into a control but not * out. Note that native controls such as table and tree * implement key traversal in the operating system. It is * not necessary to add traversal listeners for these controls, * unless you want to override the default traversal. *

* @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see KeyListener * @see #removeKeyListener */ public void addKeyListener(KeyListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener(SWT.KeyUp,typedListener); addListener(SWT.KeyDown,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when the platform-specific context menu trigger * has occurred, by sending it one of the messages defined in * the MenuDetectListener interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see MenuDetectListener * @see #removeMenuDetectListener * * @since 3.3 */ public void addMenuDetectListener (MenuDetectListener listener) { checkWidget (); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.MenuDetect, typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when mouse buttons are pressed and released, by sending * it one of the messages defined in the MouseListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see MouseListener * @see #removeMouseListener */ public void addMouseListener(MouseListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener(SWT.MouseDown,typedListener); addListener(SWT.MouseUp,typedListener); addListener(SWT.MouseDoubleClick,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when the mouse passes or hovers over controls, by sending * it one of the messages defined in the MouseTrackListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see MouseTrackListener * @see #removeMouseTrackListener */ public void addMouseTrackListener (MouseTrackListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.MouseEnter,typedListener); addListener (SWT.MouseExit,typedListener); addListener (SWT.MouseHover,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when the mouse moves, by sending it one of the * messages defined in the MouseMoveListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see MouseMoveListener * @see #removeMouseMoveListener */ public void addMouseMoveListener(MouseMoveListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener(SWT.MouseMove,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when the mouse wheel is scrolled, by sending * it one of the messages defined in the * MouseWheelListener interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see MouseWheelListener * @see #removeMouseWheelListener * * @since 3.3 */ public void addMouseWheelListener (MouseWheelListener listener) { checkWidget (); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.MouseWheel, typedListener); } void addRelation (Control control) { } /** * Adds the listener to the collection of listeners who will * be notified when the receiver needs to be painted, by sending it * one of the messages defined in the PaintListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see PaintListener * @see #removePaintListener */ public void addPaintListener(PaintListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener(SWT.Paint,typedListener); } static final double SYNTHETIC_BOLD = -2.5; static final double SYNTHETIC_ITALIC = 0.2; void addTraits(NSMutableDictionary dict, Font font) { if ((font.extraTraits & OS.NSBoldFontMask) != 0) { dict.setObject(NSNumber.numberWithDouble(SYNTHETIC_BOLD), OS.NSStrokeWidthAttributeName); } if ((font.extraTraits & OS.NSItalicFontMask) != 0) { dict.setObject(NSNumber.numberWithDouble(SYNTHETIC_ITALIC), OS.NSObliquenessAttributeName); } } /** * Adds the listener to the collection of listeners who will * be notified when touch events occur, by sending it * one of the messages defined in the TouchListener * interface. *

* NOTE: You must also call setTouchEnabled(true) to * specify that touch events should be sent, which will cause gesture * events to not be sent. *

* * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see TouchListener * @see #removeTouchListener * @see #setTouchEnabled * * @since 3.7 */ public void addTouchListener (TouchListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.Touch,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when traversal events occur, by sending it * one of the messages defined in the TraverseListener * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException * @exception SWTException * * @see TraverseListener * @see #removeTraverseListener */ public void addTraverseListener (TraverseListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.Traverse,typedListener); } boolean becomeFirstResponder (int /*long*/ id, int /*long*/ sel) { if ((state & DISABLED) != 0) return false; return super.becomeFirstResponder (id, sel); } void beginGestureWithEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!gestureEvent(id, event, SWT.GESTURE_BEGIN)) return; super.beginGestureWithEvent(id, sel, event); } void endGestureWithEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!gestureEvent(id, event, SWT.GESTURE_END)) return; super.endGestureWithEvent(id, sel, event); } void calculateVisibleRegion (NSView view, int /*long*/ visibleRgn, boolean clipChildren) { int /*long*/ tempRgn = OS.NewRgn (); if (!view.isHiddenOrHasHiddenAncestor() && isDrawing()) { int /*long*/ childRgn = OS.NewRgn (); NSWindow window = view.window (); NSView contentView = window.contentView(); NSView frameView = contentView.superview(); NSRect bounds = contentView.visibleRect(); bounds = contentView.convertRect_toView_(bounds, view); short[] rect = new short[4]; OS.SetRect(rect, (short)bounds.x, (short)bounds.y, (short)(bounds.x + bounds.width), (short)(bounds.y + bounds.height)); OS.RectRgn(visibleRgn, rect); NSView tempView = view, lastControl = null; while (tempView.id != frameView.id) { bounds = tempView.visibleRect(); bounds = tempView.convertRect_toView_(bounds, view); OS.SetRect(rect, (short)bounds.x, (short)bounds.y, (short)(bounds.x + bounds.width), (short)(bounds.y + bounds.height)); OS.RectRgn(tempRgn, rect); OS.SectRgn (tempRgn, visibleRgn, visibleRgn); if (OS.EmptyRgn (visibleRgn)) break; if (clipChildren || tempView.id != view.id) { NSArray subviews = tempView.subviews(); int /*long*/ count = subviews.count(); for (int i = 0; i < count; i++) { NSView child = new NSView (subviews.objectAtIndex(count - i - 1)); if (lastControl != null && child.id == lastControl.id) break; if (child.isHidden()) continue; bounds = child.visibleRect(); bounds = child.convertRect_toView_(bounds, view); OS.SetRect(rect, (short)bounds.x, (short)bounds.y, (short)(bounds.x + bounds.width), (short)(bounds.y + bounds.height)); OS.RectRgn(tempRgn, rect); OS.UnionRgn (tempRgn, childRgn, childRgn); } } lastControl = tempView; tempView = tempView.superview(); } OS.DiffRgn (visibleRgn, childRgn, visibleRgn); OS.DisposeRgn (childRgn); } else { OS.CopyRgn (tempRgn, visibleRgn); } OS.DisposeRgn (tempRgn); } void cancelOperation(int /*long*/ id, int /*long*/ sel, int /*long*/ sender) { // Cmd-. and escape arrive here. Forward the current event as a key event. if (hasKeyboardFocus(id)) { NSEvent nsEvent = NSApplication.sharedApplication().currentEvent(); Shell s = this.getShell(); s.keyInputHappened = false; boolean [] consume = new boolean [1]; if (translateTraversal (nsEvent.keyCode (), nsEvent, consume)) return; if (isDisposed ()) return; if (!sendKeyEvent (nsEvent, SWT.KeyDown)) return; } } void checkBackground () { Shell shell = getShell (); if (this == shell) return; state &= ~PARENT_BACKGROUND; Composite composite = parent; do { int mode = composite.backgroundMode; if (mode != 0) { if (mode == SWT.INHERIT_DEFAULT) { Control control = this; do { if ((control.state & THEME_BACKGROUND) == 0) { return; } control = control.parent; } while (control != composite); } state |= PARENT_BACKGROUND; return; } if (composite == shell) break; composite = composite.parent; } while (true); } void checkBuffered () { style |= SWT.DOUBLE_BUFFERED; } void checkToolTip (Widget target) { if (isVisible () && display.tooltipControl == this && (target == null || display.tooltipTarget == target)) { Shell shell = getShell (); shell.sendToolTipEvent (false); shell.sendToolTipEvent (true); } } /** * Returns the preferred size of the receiver. *

* The preferred size of a control is the size that it would * best be displayed at. The width hint and height hint arguments * allow the caller to ask a control questions such as "Given a particular * width, how high does the control need to be to show all of the contents?" * To indicate that the caller does not wish to constrain a particular * dimension, the constant SWT.DEFAULT is passed for the hint. *

* * @param wHint the width hint (can be SWT.DEFAULT) * @param hHint the height hint (can be SWT.DEFAULT) * @return the preferred size of the control * * @exception SWTException * * @see Layout * @see #getBorderWidth * @see #getBounds * @see #getSize * @see #pack(boolean) * @see "computeTrim, getClientArea for controls that implement them" */ public Point computeSize (int wHint, int hHint) { return computeSize (wHint, hHint, true); } /** * Returns the preferred size of the receiver. *

* The preferred size of a control is the size that it would * best be displayed at. The width hint and height hint arguments * allow the caller to ask a control questions such as "Given a particular * width, how high does the control need to be to show all of the contents?" * To indicate that the caller does not wish to constrain a particular * dimension, the constant SWT.DEFAULT is passed for the hint. *

* If the changed flag is true, it indicates that the receiver's * contents have changed, therefore any caches that a layout manager * containing the control may have been keeping need to be flushed. When the * control is resized, the changed flag will be false, so layout * manager caches can be retained. *

* * @param wHint the width hint (can be SWT.DEFAULT) * @param hHint the height hint (can be SWT.DEFAULT) * @param changed true if the control's contents have changed, and false otherwise * @return the preferred size of the control. * * @exception SWTException * * @see Layout * @see #getBorderWidth * @see #getBounds * @see #getSize * @see #pack(boolean) * @see "computeTrim, getClientArea for controls that implement them" */ public Point computeSize (int wHint, int hHint, boolean changed) { checkWidget (); int width = DEFAULT_WIDTH; int height = DEFAULT_HEIGHT; if (wHint != SWT.DEFAULT) width = wHint; if (hHint != SWT.DEFAULT) height = hHint; int border = getBorderWidth (); width += border * 2; height += border * 2; return new Point (width, height); } Widget computeTabGroup () { if (isTabGroup()) return this; return parent.computeTabGroup (); } Widget[] computeTabList() { if (isTabGroup()) { if (getVisible() && getEnabled()) { return new Widget[] {this}; } } return new Widget[0]; } Control computeTabRoot () { Control[] tabList = parent._getTabList(); if (tabList != null) { int index = 0; while (index < tabList.length) { if (tabList [index] == this) break; index++; } if (index == tabList.length) { if (isTabGroup ()) return this; } } return parent.computeTabRoot (); } NSView contentView () { return view; } NSAttributedString createString (String string, Font font, float /*double*/ [] foreground, int alignment, boolean wrap, boolean enabled, boolean mnemonics) { NSMutableDictionary dict = ((NSMutableDictionary)new NSMutableDictionary().alloc()).initWithCapacity(5); if (font == null) font = this.font != null ? this.font : defaultFont(); dict.setObject (font.handle, OS.NSFontAttributeName); addTraits(dict, font); if (enabled) { if (foreground != null) { NSColor color = NSColor.colorWithDeviceRed(foreground[0], foreground[1], foreground[2], foreground[3]); dict.setObject (color, OS.NSForegroundColorAttributeName); } } else { dict.setObject (NSColor.disabledControlTextColor (), OS.NSForegroundColorAttributeName); } NSMutableParagraphStyle paragraphStyle = (NSMutableParagraphStyle)new NSMutableParagraphStyle ().alloc ().init (); paragraphStyle.setLineBreakMode (wrap ? OS.NSLineBreakByWordWrapping : OS.NSLineBreakByClipping); if (alignment != 0) { int align = OS.NSLeftTextAlignment; if ((alignment & SWT.CENTER) != 0) { align = OS.NSCenterTextAlignment; } else if ((alignment & SWT.RIGHT) != 0) { align = OS.NSRightTextAlignment; } paragraphStyle.setAlignment (align); } if ((style & SWT.RIGHT_TO_LEFT) != 0) { paragraphStyle.setBaseWritingDirection(OS.NSWritingDirectionRightToLeft); } else { paragraphStyle.setBaseWritingDirection(OS.NSWritingDirectionLeftToRight); } dict.setObject (paragraphStyle, OS.NSParagraphStyleAttributeName); paragraphStyle.release (); int length = string.length (); char [] chars = new char [length]; string.getChars (0, chars.length, chars, 0); if (mnemonics) length = fixMnemonic (chars); NSString str = ((NSString)new NSString().alloc()).initWithCharacters(chars, length); NSAttributedString attribStr = ((NSAttributedString) new NSAttributedString ().alloc ()).initWithString (str, dict); str.release(); dict.release(); return attribStr; } void createWidget () { state |= DRAG_DETECT; checkOrientation (parent); super.createWidget (); checkBackground (); checkBuffered (); setDefaultFont (); setZOrder (); setRelations (); if ((state & PARENT_BACKGROUND) != 0) { setBackground (); } display.clearPool (); } Color defaultBackground () { return display.getWidgetColor (SWT.COLOR_WIDGET_BACKGROUND); } Font defaultFont () { if (display.smallFonts) return display.getSystemFont (); return Font.cocoa_new (display, defaultNSFont ()); } Color defaultForeground () { return display.getWidgetColor (SWT.COLOR_WIDGET_FOREGROUND); } NSFont defaultNSFont () { return display.getSystemFont().handle; } void deregister () { super.deregister (); display.removeWidget (view); } void destroyWidget () { NSView view = topView (); view.removeFromSuperview (); releaseHandle (); } void doCommandBySelector (int /*long*/ id, int /*long*/ sel, int /*long*/ selector) { if (hasKeyboardFocus(id)) { if (imeInComposition ()) return; Shell s = this.getShell(); NSEvent nsEvent = NSApplication.sharedApplication ().currentEvent (); if (nsEvent != null && nsEvent.type () == OS.NSKeyDown) { /* * Feature in Cocoa. Pressing Alt+UpArrow invokes doCommandBySelector * twice, with selectors moveBackward and moveToBeginningOfParagraph * (Alt+DownArrow behaves similarly). In order to avoid sending * multiple events for these keys, do not send a KeyDown if we already sent one * during this keystroke. This rule does not apply if the command key * is down, because we likely triggered the current key sequence via flagsChanged. */ int /*long*/ modifiers = nsEvent.modifierFlags(); if (s.keyInputHappened == false || (modifiers & OS.NSCommandKeyMask) != 0) { s.keyInputHappened = true; boolean [] consume = new boolean [1]; if (translateTraversal (nsEvent.keyCode (), nsEvent, consume)) return; if (isDisposed ()) return; if (!sendKeyEvent (nsEvent, SWT.KeyDown)) return; if (consume [0]) return; } } if ((state & CANVAS) != 0) return; } super.doCommandBySelector (id, sel, selector); } /** * Detects a drag and drop gesture. This method is used * to detect a drag gesture when called from within a mouse * down listener. * *

By default, a drag is detected when the gesture * occurs anywhere within the client area of a control. * Some controls, such as tables and trees, override this * behavior. In addition to the operating system specific * drag gesture, they require the mouse to be inside an * item. Custom widget writers can use setDragDetect * to disable the default detection, listen for mouse down, * and then call dragDetect() from within the * listener to conditionally detect a drag. *

* * @param event the mouse down event * * @return true if the gesture occurred, and false otherwise. * * @exception IllegalArgumentException * @exception SWTException * * @see DragDetectListener * @see #addDragDetectListener * * @see #getDragDetect * @see #setDragDetect * * @since 3.3 */ public boolean dragDetect (Event event) { checkWidget (); if (event == null) error (SWT.ERROR_NULL_ARGUMENT); return dragDetect (event.button, event.count, event.stateMask, event.x, event.y); } /** * Detects a drag and drop gesture. This method is used * to detect a drag gesture when called from within a mouse * down listener. * *

By default, a drag is detected when the gesture * occurs anywhere within the client area of a control. * Some controls, such as tables and trees, override this * behavior. In addition to the operating system specific * drag gesture, they require the mouse to be inside an * item. Custom widget writers can use setDragDetect * to disable the default detection, listen for mouse down, * and then call dragDetect() from within the * listener to conditionally detect a drag. *

* * @param event the mouse down event * * @return true if the gesture occurred, and false otherwise. * * @exception IllegalArgumentException * @exception SWTException * * @see DragDetectListener * @see #addDragDetectListener * * @see #getDragDetect * @see #setDragDetect * * @since 3.3 */ public boolean dragDetect (MouseEvent event) { checkWidget (); if (event == null) error (SWT.ERROR_NULL_ARGUMENT); return dragDetect (event.button, event.count, event.stateMask, event.x, event.y); } boolean dragDetect (int button, int count, int stateMask, int x, int y) { if (button != 1 || count != 1) return false; if (!dragDetect (x, y, false, null)) return false; return sendDragEvent (button, stateMask, x, y); } boolean dragDetect (int x, int y, boolean filter, boolean [] consume) { /** * Feature in Cocoa. Mouse drag events do not account for hysteresis. * As soon as the mouse drags a mouse dragged event is fired. Fix is to * check for another mouse drag event that is at least 5 pixels away * from the start of the drag. */ NSApplication application = NSApplication.sharedApplication(); boolean dragging = false; int /*long*/ eventType = OS.NSLeftMouseDown; float /*double*/ dragX = x; float /*double*/ dragY = y; /** * To check for an actual drag we need to pull off mouse moved and mouse up events * to detect if the user dragged outside of a 10 x 10 box centered on the mouse down location. * We still want the view to see the events, so save them and re-post when done checking. * If no motion happens for .3 seconds, bail. */ NSEvent mouseUpEvent = null; NSMutableArray dragEvents = NSMutableArray.arrayWithCapacity(10); NSDate timeout = NSDate.dateWithTimeIntervalSinceNow(0.3); while (eventType != OS.NSLeftMouseUp) { NSEvent event = application.nextEventMatchingMask((OS.NSLeftMouseUpMask | OS.NSLeftMouseDraggedMask), timeout, OS.NSEventTrackingRunLoopMode, true); // No event means nextEventMatchingMask timed out. if (event == null) { dragging = true; break; } eventType = event.type(); if (eventType == OS.NSLeftMouseDragged) { dragEvents.addObject(event); NSPoint windowLoc = event.locationInWindow(); NSPoint viewLoc = view.convertPoint_fromView_(windowLoc, null); if (!view.isFlipped ()) { viewLoc.y = view.bounds().height - viewLoc.y; } if ((Math.abs(viewLoc.x - dragX) > DEFAULT_DRAG_HYSTERESIS) || (Math.abs(viewLoc.y - dragY) > DEFAULT_DRAG_HYSTERESIS)) { dragging = true; break; } } else if (eventType == OS.NSLeftMouseUp) { mouseUpEvent = event; } } // Push back any events we took out of the queue so the control can receive them. if (mouseUpEvent != null) application.postEvent(mouseUpEvent, true); if (dragEvents.count() > 0) { while (dragEvents.count() > 0) { NSEvent currEvent = new NSEvent(dragEvents.objectAtIndex(dragEvents.count() - 1).id); dragEvents.removeLastObject(); application.postEvent(currEvent, true); } } return dragging; } boolean drawGripper (int x, int y, int width, int height, boolean vertical) { return false; } boolean drawsBackground() { return true; } void drawWidget (int /*long*/ id, NSGraphicsContext context, NSRect rect) { if (id != paintView().id) return; if (!hooks (SWT.Paint) && !filters (SWT.Paint)) return; /* Send paint event */ GCData data = new GCData (); data.paintRect = rect; GC gc = GC.cocoa_new (this, data); Event event = new Event (); event.gc = gc; event.x = (int)rect.x; event.y = (int)rect.y; event.width = (int)rect.width; event.height = (int)rect.height; sendEvent (SWT.Paint, event); event.gc = null; gc.dispose (); } void enableWidget (boolean enabled) { if (view instanceof NSControl) { ((NSControl)view).setEnabled(enabled); } updateCursorRects (isEnabled ()); } boolean equals(float /*double*/ [] color1, float /*double*/ [] color2) { if (color1 == color2) return true; if (color1 == null) return color2 == null; if (color2 == null) return color1 == null; for (int i = 0; i < color1.length; i++) { if (color1 [i] != color2 [i]) return false; } return true; } NSView eventView () { return view; } void fillBackground (NSView view, NSGraphicsContext context, NSRect rect, int imgHeight) { fillBackground(view, context, rect, imgHeight, null, 0, 0); } void fillBackground (NSView view, NSGraphicsContext context, NSRect rect, int imgHeight, NSView gcView, int tx, int ty) { if (!drawsBackground()) return; Control control = findBackgroundControl(); if (control == null) control = this; Image image = control.backgroundImage; if (image != null && !image.isDisposed()) { context.saveGraphicsState(); NSColor.colorWithPatternImage(image.handle).setFill(); NSPoint phase = new NSPoint(); NSView controlView = control.view; if (!controlView.isFlipped()) { phase.y = controlView.bounds().height; } if (imgHeight == -1) { NSView contentView = controlView.window().contentView(); phase = controlView.convertPoint_toView_(phase, contentView); phase.y = contentView.bounds().height - phase.y; } else { phase = view.convertPoint_toView_(phase, controlView); phase.y += imgHeight - backgroundImage.getBounds().height; } if (gcView != null) { NSPoint pt = gcView.convertPoint_toView_(new NSPoint(), view); phase.x += pt.x; phase.y -= pt.y; } phase.x -= tx; phase.y += ty; context.setPatternPhase(phase); NSBezierPath.fillRect(rect); context.restoreGraphicsState(); return; } float /*double*/ [] background = control.background; float /*double*/ alpha; if (background == null) { if (isTransparent()) return; background = control.defaultBackground ().handle; alpha = getThemeAlpha (); } else { alpha = background[3]; } context.saveGraphicsState (); NSColor.colorWithDeviceRed (background [0], background [1], background [2], alpha).setFill (); NSBezierPath.fillRect (rect); context.restoreGraphicsState (); } Cursor findCursor () { if (cursor != null) return cursor; return parent.findCursor (); } Control findBackgroundControl () { if (backgroundImage != null || background != null) return this; return (!isTransparent() && (state & PARENT_BACKGROUND) != 0) ? parent.findBackgroundControl () : null; } Menu [] findMenus (Control control) { if (menu != null && this != control) return new Menu [] {menu}; return new Menu [0]; } Widget findTooltip (NSPoint pt) { return this; } void fixChildren (Shell newShell, Shell oldShell, Decorations newDecorations, Decorations oldDecorations, Menu [] menus) { oldShell.fixShell (newShell, this); oldDecorations.fixDecorations (newDecorations, this, menus); } void fixFocus (Control focusControl) { Shell shell = getShell (); Control control = this; while (control != shell && (control = control.parent) != null) { if (control.setFocus ()) return; } shell.setSavedFocus (focusControl); NSWindow window = view.window(); if (!window.makeFirstResponder(null)) { // Force first responder to resign. window.endEditingFor(null); } } void flagsChanged (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (hasKeyboardFocus(id)) { if ((state & WEBKIT_EVENTS_FIX) == 0) { Shell s = this.getShell(); s.keyInputHappened = false; int mask = 0; NSEvent nsEvent = new NSEvent (theEvent); int /*long*/ modifiers = nsEvent.modifierFlags (); int keyCode = Display.translateKey (nsEvent.keyCode ()); switch (keyCode) { case SWT.ALT: mask = OS.NSAlternateKeyMask; break; case SWT.CONTROL: mask = OS.NSControlKeyMask; break; case SWT.COMMAND: mask = OS.NSCommandKeyMask; break; case SWT.SHIFT: mask = OS.NSShiftKeyMask; break; case SWT.CAPS_LOCK: Event event = new Event(); event.keyCode = keyCode; setInputState (event, nsEvent, SWT.KeyDown); sendKeyEvent (SWT.KeyDown, event); setInputState (event, nsEvent, SWT.KeyUp); sendKeyEvent (SWT.KeyUp, event); break; } if (mask != 0) { s.keyInputHappened = true; int type = (mask & modifiers) != 0 ? SWT.KeyDown : SWT.KeyUp; Event event = new Event(); event.keyCode = keyCode; setLocationMask(event, nsEvent); setInputState (event, nsEvent, type); if (!sendKeyEvent (type, event)) return; } } } super.flagsChanged (id, sel, theEvent); } NSView focusView () { return view; } /** * Forces the receiver to have the keyboard focus, causing * all keyboard events to be delivered to it. * * @return true if the control got focus, and false if it was unable to. * * @exception SWTException * * @see #setFocus */ public boolean forceFocus () { checkWidget(); if (display.focusEvent == SWT.FocusOut) return false; Decorations shell = menuShell (); shell.setSavedFocus (this); if (!isEnabled () || !isVisible () || !isActive ()) return false; if (isFocusControl ()) return true; shell.setSavedFocus (null); NSView focusView = focusView (); if (!focusView.canBecomeKeyView()) return false; boolean result = forceFocus(focusView); if (isDisposed ()) return false; shell.setSavedFocus (this); /* * Feature in Cocoa. If the window is inactive when forceFocus is called bringToTop * eventually calls makeKeyAndOrderFront. This activates the window immediately, but unlike other platforms, * it also immediately fire notifications that the window was activated, as opposed to posting an event * to be handled on the next pass of readAndDispatch(). * * Shell#windowDidBecomeKey will call Decorations#restoreFocus, so the saved focus must be set * before the window is activated or the wrong control will get focus. */ shell.bringToTop (false); if (isDisposed ()) return false; return result; } boolean forceFocus (NSView focusView) { NSWindow window = view.window (); if(window == null) { return false; } return window.makeFirstResponder (focusView); } boolean gestureEvent(int /*long*/ id, int /*long*/ eventPtr, int detail) { if (!display.sendEvent) return true; display.sendEvent = false; // For cross-platform compatibility, touch events and gestures are mutually exclusive. // Don't send a gesture if touch events are enabled for this control. if (touchEnabled) return true; if (!isEventView (id)) return true; if (!hooks(SWT.Gesture) && !filters(SWT.Gesture)) return true; NSEvent nsEvent = new NSEvent(eventPtr); Event event = new Event(); NSPoint windowPoint; NSView view = eventView (); windowPoint = nsEvent.locationInWindow(); NSPoint point = view.convertPoint_fromView_(windowPoint, null); if (!view.isFlipped ()) { point.y = view.bounds().height - point.y; } event.x = (int) point.x; event.y = (int) point.y; setInputState (event, nsEvent, SWT.Gesture); event.detail = detail; if (detail == SWT.GESTURE_BEGIN) { display.rotation = 0.0; display.magnification = 1.0; display.gestureActive = true; } else if (detail == SWT.GESTURE_END) { display.gestureActive = false; } switch (detail) { case SWT.GESTURE_SWIPE: event.xDirection = (int) -nsEvent.deltaX(); event.yDirection = (int) -nsEvent.deltaY(); break; case SWT.GESTURE_ROTATE: { display.rotation += nsEvent.rotation(); event.rotation = display.rotation; break; } case SWT.GESTURE_MAGNIFY: display.magnification += nsEvent.magnification(); event.magnification = display.magnification; break; case SWT.GESTURE_PAN: // Panning increment is expressed in terms of the direction of movement, // not in terms of scrolling increment. if (display.gestureActive) { event.xDirection = (int) -nsEvent.deltaX(); event.yDirection = (int) -nsEvent.deltaY(); if (event.xDirection == 0 && event.yDirection == 0) return true; } break; } sendEvent (SWT.Gesture, event); return event.doit; } /** * Returns the accessible object for the receiver. *

* If this is the first time this object is requested, * then the object is created and returned. The object * returned by getAccessible() does not need to be disposed. *

* * @return the accessible object * * @exception SWTException * * @see Accessible#addAccessibleListener * @see Accessible#addAccessibleControlListener * * @since 2.0 */ public Accessible getAccessible () { checkWidget (); if (accessible == null) accessible = new_Accessible (this); return accessible; } /** * Returns the receiver's background color. *

* Note: This operation is a hint and may be overridden by the platform. * For example, on some versions of Windows the background of a TabFolder, * is a gradient rather than a solid color. *

* @return the background color * * @exception SWTException */ public Color getBackground () { checkWidget(); Control control = findBackgroundControl (); if (control == null) control = this; return control.getBackgroundColor (); } Color getBackgroundColor () { return background != null ? Color.cocoa_new (display, background) : defaultBackground (); } /** * Returns the receiver's background image. * * @return the background image * * @exception SWTException * * @since 3.2 */ public Image getBackgroundImage () { checkWidget(); Control control = findBackgroundControl (); if (control == null) control = this; return control.backgroundImage; } /** * Returns the receiver's border width. * * @return the border width * * @exception SWTException */ public int getBorderWidth () { checkWidget(); return 0; } /** * Returns a rectangle describing the receiver's size and location * relative to its parent (or its display if its parent is null), * unless the receiver is a shell. In this case, the location is * relative to the display. * * @return the receiver's bounding rectangle * * @exception SWTException */ public Rectangle getBounds () { checkWidget(); NSRect rect = topView().frame(); return new Rectangle((int)rect.x, (int)rect.y, (int)rect.width, (int)rect.height); } /** * Returns true if the receiver is detecting * drag gestures, and false otherwise. * * @return the receiver's drag detect state * * @exception SWTException * * @since 3.3 */ public boolean getDragDetect () { checkWidget (); return (state & DRAG_DETECT) != 0; } boolean getDrawing () { return drawCount <= 0; } /** * Returns the receiver's cursor, or null if it has not been set. *

* When the mouse pointer passes over a control its appearance * is changed to match the control's cursor. *

* * @return the receiver's cursor or null * * @exception SWTException * * @since 3.3 */ public Cursor getCursor () { checkWidget(); return cursor; } /** * Returns true if the receiver is enabled, and * false otherwise. A disabled control is typically * not selectable from the user interface and draws with an * inactive or "grayed" look. * * @return the receiver's enabled state * * @exception SWTException * * @see #isEnabled */ public boolean getEnabled () { checkWidget(); return (state & DISABLED) == 0; } /** * Returns the font that the receiver will use to paint textual information. * * @return the receiver's font * * @exception SWTException */ public Font getFont () { checkWidget(); return font != null ? font : defaultFont (); } /** * Returns the foreground color that the receiver will use to draw. * * @return the receiver's foreground color * * @exception SWTException */ public Color getForeground () { checkWidget(); return getForegroundColor (); } Color getForegroundColor () { return foreground != null ? Color.cocoa_new (display, foreground) : defaultForeground (); } /** * Returns layout data which is associated with the receiver. * * @return the receiver's layout data * * @exception SWTException */ public Object getLayoutData () { checkWidget(); return layoutData; } /** * Returns a point describing the receiver's location relative * to its parent (or its display if its parent is null), unless * the receiver is a shell. In this case, the point is * relative to the display. * * @return the receiver's location * * @exception SWTException */ public Point getLocation () { checkWidget(); NSRect rect = topView().frame(); return new Point((int)rect.x, (int)rect.y); } /** * Returns the receiver's pop up menu if it has one, or null * if it does not. All controls may optionally have a pop up * menu that is displayed when the user requests one for * the control. The sequence of key strokes, button presses * and/or button releases that are used to request a pop up * menu is platform specific. * * @return the receiver's menu * * @exception SWTException */ public Menu getMenu () { checkWidget(); return menu; } int getMininumHeight () { return 0; } /** * Returns the receiver's monitor. * * @return the receiver's monitor * * @exception SWTException * * @since 3.0 */ public Monitor getMonitor () { checkWidget(); Monitor [] monitors = display.getMonitors (); if (monitors.length == 1) return monitors [0]; int index = -1, value = -1; Rectangle bounds = getBounds (); if (this != getShell ()) { bounds = display.map (this.parent, null, bounds); } for (int i=0; i 0 && area > value) { index = i; value = area; } } if (index >= 0) return monitors [index]; int centerX = bounds.x + bounds.width / 2, centerY = bounds.y + bounds.height / 2; for (int i=0; i rect.x + rect.width ? centerX - rect.x - rect.width : 0; int y = centerY < rect.y ? rect.y - centerY : centerY > rect.y + rect.height ? centerY - rect.y - rect.height : 0; int distance = x * x + y * y; if (index == -1 || distance < value) { index = i; value = distance; } } return monitors [index]; } /** * Returns the orientation of the receiver, which will be one of the * constants SWT.LEFT_TO_RIGHT or SWT.RIGHT_TO_LEFT. * * @return the orientation style * * @exception SWTException * * @since 3.7 */ public int getOrientation () { checkWidget (); return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT); } /** * Returns the receiver's parent, which must be a Composite * or null when the receiver is a shell that was created with null or * a display for a parent. * * @return the receiver's parent * * @exception SWTException */ public Composite getParent () { checkWidget(); return parent; } Control [] getPath () { int count = 0; Shell shell = getShell (); Control control = this; while (control != shell) { count++; control = control.parent; } control = this; Control [] result = new Control [count]; while (control != shell) { result [--count] = control; control = control.parent; } return result; } NSBezierPath getPath(Region region) { if (region == null) return null; return getPath(region.handle); } NSBezierPath getPath(int /*long*/ region) { Callback callback = new Callback(this, "regionToRects", 4); if (callback.getAddress() == 0) error(SWT.ERROR_NO_MORE_CALLBACKS); NSBezierPath path = NSBezierPath.bezierPath(); path.retain(); OS.QDRegionToRects(region, OS.kQDParseRegionFromTopLeft, callback.getAddress(), path.id); callback.dispose(); if (path.isEmpty()) path.appendBezierPathWithRect(new NSRect()); return path; } /** * Returns the region that defines the shape of the control, * or null if the control has the default shape. * * @return the region that defines the shape of the shell (or null) * * @exception SWTException * * @since 3.4 */ public Region getRegion () { checkWidget (); return region; } /** * Returns the receiver's shell. For all controls other than * shells, this simply returns the control's nearest ancestor * shell. Shells return themselves, even if they are children * of other shells. * * @return the receiver's shell * * @exception SWTException * * @see #getParent */ public Shell getShell () { checkWidget(); return parent.getShell (); } /** * Returns a point describing the receiver's size. The * x coordinate of the result is the width of the receiver. * The y coordinate of the result is the height of the * receiver. * * @return the receiver's size * * @exception SWTException */ public Point getSize () { checkWidget(); NSRect rect = topView().frame(); return new Point((int)rect.width, (int)rect.height); } float getThemeAlpha () { return 1 * parent.getThemeAlpha (); } /** * Returns the receiver's tool tip text, or null if it has * not been set. * * @return the receiver's tool tip text * * @exception SWTException */ public String getToolTipText () { checkWidget(); return toolTipText; } /** * Returns true if this control is set to send touch events, or * false if it is set to send gesture events instead. This method * also returns false if a touch-based input device is not detected * (this can be determined with Display#getTouchEnabled()). Use * {@link #setTouchEnabled(boolean)} to switch the events that a control sends * between touch events and gesture events. * * @return true if the control is set to send touch events, or false otherwise * * @exception SWTException * * @see #setTouchEnabled * @see Display#getTouchEnabled * * @since 3.7 */ public boolean getTouchEnabled() { checkWidget(); return display.getTouchEnabled() && touchEnabled; } /** * Returns true if the receiver is visible, and * false otherwise. *

* 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. *

* * @return the receiver's visibility state * * @exception SWTException */ public boolean getVisible () { checkWidget(); return (state & HIDDEN) == 0; } int /*long*/ getVisibleRegion () { if (visibleRgn == 0) { visibleRgn = OS.NewRgn (); calculateVisibleRegion (view, visibleRgn, true); } int /*long*/ result = OS.NewRgn (); OS.CopyRgn (visibleRgn, result); return result; } boolean hasBorder () { return (style & SWT.BORDER) != 0; } boolean hasFocus () { return display.getFocusControl() == this; } boolean hasRegion () { return region != null || parent.hasRegion (); } int /*long*/ hitTest (int /*long*/ id, int /*long*/ sel, NSPoint point) { if ((state & DISABLED) != 0) return 0; if (!isActive ()) return 0; if (regionPath != null) { NSView rgnView = topView (); if (!rgnView.isFlipped()) rgnView = eventView (); NSPoint pt = rgnView.convertPoint_fromView_ (point, new NSView (id).superview()); if (!regionPath.containsPoint(pt)) return 0; } return super.hitTest(id, sel, point); } boolean imeInComposition () { return false; } boolean insertText (int /*long*/ id, int /*long*/ sel, int /*long*/ string) { // sendKeyEvent may do something to run the event loop. That would cause // 'string' to be released before any superclass could use it, so save it // until this method finishes. NSObject saver = new NSObject(string); saver.retain(); try { if (hasKeyboardFocus(id)) { Shell s = this.getShell(); NSEvent nsEvent = NSApplication.sharedApplication ().currentEvent (); if (nsEvent != null) { int /*long*/ type = nsEvent.type (); if (type == OS.NSKeyDown || type == OS.NSSystemDefined) { NSString str = new NSString (string); if (str.isKindOfClass (OS.class_NSAttributedString)) { str = new NSAttributedString (string).string (); } int length = (int)/*64*/str.length (); char[] buffer = new char [length]; str.getCharacters(buffer); for (int i = 0; i < buffer.length; i++) { s.keyInputHappened = true; Event event = new Event (); if (i == 0 && type == OS.NSKeyDown) setKeyState (event, SWT.KeyDown, nsEvent); event.character = buffer [i]; if (!sendKeyEvent (SWT.KeyDown, event)) return false; } } } if ((state & CANVAS) != 0) return true; } return super.insertText (id, sel, string); } finally { saver.release(); } } /** * Invokes platform specific functionality to allocate a new GC handle. *

* IMPORTANT: This method is not part of the public * API for Control. It is marked public only so that it * can be shared within the packages provided by SWT. It is not * available on all platforms, and should never be called from * application code. *

* * @param data the platform specific GC data * @return the platform specific GC handle * * @noreference This method is not intended to be referenced by clients. */ public int /*long*/ internal_new_GC (GCData data) { checkWidget(); NSView view = paintView(); int /*long*/ context = 0; if (data != null && data.paintRect != null) { NSGraphicsContext graphicsContext = NSGraphicsContext.currentContext(); context = graphicsContext.id; if (!view.isFlipped()) data.state &= ~VISIBLE_REGION; } else { NSWindow window = view.window(); /* * Force the device to be created before attempting * to create a GC on a deferred NSWindow. */ if (window.windowNumber() <= 0) { float /*double*/ alpha = window.alphaValue(); window.setAlphaValue(0); window.orderBack(null); window.orderOut(null); window.setAlphaValue(alpha); } NSGraphicsContext graphicsContext = NSGraphicsContext.graphicsContextWithWindow (window); NSGraphicsContext flippedContext = NSGraphicsContext.graphicsContextWithGraphicsPort(graphicsContext.graphicsPort(), true); graphicsContext = flippedContext; context = graphicsContext.id; if (data != null) { data.flippedContext = flippedContext; data.state &= ~VISIBLE_REGION; data.visibleRgn = getVisibleRegion(); display.addContext (data); } } if (data != null) { int mask = SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT; if ((data.style & mask) == 0) { data.style |= style & (mask | SWT.MIRRORED); } data.device = display; data.thread = display.thread; data.view = view; data.view.retain(); data.view.window().retain(); data.foreground = getForegroundColor ().handle; Control control = findBackgroundControl (); if (control == null) control = this; data.background = control.getBackgroundColor ().handle; data.font = font != null ? font : defaultFont (); } return context; } /** * Invokes platform specific functionality to dispose a GC handle. *

* IMPORTANT: This method is not part of the public * API for Control. It is marked public only so that it * can be shared within the packages provided by SWT. It is not * available on all platforms, and should never be called from * application code. *

* * @param hDC the platform specific GC handle * @param data the platform specific GC data * * @noreference This method is not intended to be referenced by clients. */ public void internal_dispose_GC (int /*long*/ hDC, GCData data) { checkWidget (); int /*long*/ context = hDC; NSGraphicsContext graphicsContext = new NSGraphicsContext (context); display.removeContext (data); if (data != null) { if (data.paintRect == null) graphicsContext.flushGraphics (); if (data.visibleRgn != 0) OS.DisposeRgn(data.visibleRgn); data.visibleRgn = 0; if (data.view != null) { data.view.window().release(); data.view.release(); data.view = null; } } } void invalidateChildrenVisibleRegion () { } void invalidateVisibleRegion () { int index = 0; Control[] siblings = parent._getChildren (); while (index < siblings.length && siblings [index] != this) index++; for (int i=index; itrue if the receiver is enabled and all * ancestors up to and including the receiver's nearest ancestor * shell are enabled. Otherwise, false is returned. * A disabled control is typically not selectable from the user * interface and draws with an inactive or "grayed" look. * * @return the receiver's enabled state * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #getEnabled */ public boolean isEnabled () { checkWidget(); return getEnabled () && parent.isEnabled (); } boolean isEnabledCursor () { return isEnabled (); } boolean isFocusAncestor (Control control) { while (control != null && control != this && !(control instanceof Shell)) { control = control.parent; } return control == this; } /** * Returns true if the receiver has the user-interface * focus, and false otherwise. * * @return the receiver's focus state * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public boolean isFocusControl () { checkWidget(); Control focusControl = display.focusControl; if (focusControl != null && !focusControl.isDisposed ()) { return this == focusControl; } return hasFocus (); } boolean isObscured () { int /*long*/ visibleRgn = getVisibleRegion(), boundsRgn = OS.NewRgn(); short[] rect = new short[4]; NSRect bounds = view.visibleRect(); OS.SetRect(rect, (short)bounds.x, (short)bounds.y, (short)(bounds.x + bounds.width), (short)(bounds.y + bounds.height)); OS.RectRgn(boundsRgn, rect); OS.DiffRgn(boundsRgn, visibleRgn, boundsRgn); boolean obscured = !OS.EmptyRgn (boundsRgn); OS.DisposeRgn(boundsRgn); OS.DisposeRgn(visibleRgn); return obscured; } /** * Returns true if the underlying operating * system supports this reparenting, otherwise false * * @return true if the widget can be reparented, otherwise false * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public boolean isReparentable () { checkWidget(); return true; } boolean isResizing () { return (state & RESIZING) != 0 || parent.isResizing(); } boolean isShowing () { /* * This is not complete. Need to check if the * widget is obscurred by a parent or sibling. */ if (!isVisible ()) return false; Control control = this; while (control != null) { Point size = control.getSize (); if (size.x == 0 || size.y == 0) { return false; } control = control.parent; } return true; } boolean isTabGroup () { Control [] tabList = parent._getTabList (); if (tabList != null) { for (int i=0; itrue if the receiver is visible and all * ancestors up to and including the receiver's nearest ancestor * shell are visible. Otherwise, false is returned. * * @return the receiver's visibility state * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #getVisible */ public boolean isVisible () { checkWidget(); return getVisible () && parent.isVisible (); } void keyDown (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (hasKeyboardFocus(id)) { Shell s = this.getShell(); s.keyInputHappened = false; boolean textInput = OS.objc_msgSend (id, OS.sel_conformsToProtocol_, OS.objc_getProtocol ("NSTextInput")) != 0; if (!textInput) { // Not a text field, so send a key event here. NSEvent nsEvent = new NSEvent (theEvent); boolean [] consume = new boolean [1]; if (translateTraversal (nsEvent.keyCode (), nsEvent, consume)) return; if (isDisposed ()) return; if (!sendKeyEvent (nsEvent, SWT.KeyDown)) return; if (consume [0]) return; } else { // Control is some kind of text field, so the key event will be sent from insertText: or doCommandBySelector: super.keyDown (id, sel, theEvent); if (imeInComposition ()) return; // If none of those methods triggered a key event send one now. if (!s.keyInputHappened) { NSEvent nsEvent = new NSEvent (theEvent); boolean [] consume = new boolean [1]; if (translateTraversal (nsEvent.keyCode (), nsEvent, consume)) return; if (isDisposed ()) return; if (!sendKeyEvent (nsEvent, SWT.KeyDown)) return; if (consume [0]) return; } return; } } super.keyDown (id, sel, theEvent); } boolean hasKeyboardFocus(int /*long*/ inId) { return view.window().firstResponder().id == inId; } void keyUp (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (hasKeyboardFocus(id)) { NSEvent nsEvent = new NSEvent (theEvent); if (!sendKeyEvent (nsEvent, SWT.KeyUp)) return; } super.keyUp (id, sel, theEvent); } void magnifyWithEvent(int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!gestureEvent(id, event, SWT.GESTURE_MAGNIFY)) return; super.magnifyWithEvent(id, sel, event); } void markLayout (boolean changed, boolean all) { /* Do nothing */ } int /*long*/ menuForEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!isEnabled ()) return 0; NSPoint pt = NSEvent.mouseLocation(); pt.y = (int) (display.getPrimaryFrame().height - pt.y); int x = (int) pt.x; int y = (int) pt.y; Event event = new Event (); event.x = x; event.y = y; NSEvent nsEvent = new NSEvent(theEvent); event.detail = nsEvent.buttonNumber() > 0 ? SWT.MENU_MOUSE : SWT.MENU_KEYBOARD; sendEvent (SWT.MenuDetect, event); //widget could be disposed at this point if (isDisposed ()) return 0; if (!event.doit) return 0; Menu menu = getMenu (); if (menu != null && !menu.isDisposed ()) { if (x != event.x || y != event.y) { menu.setLocation (event.x, event.y); } menu.setVisible(true); return 0; } return super.menuForEvent (id, sel, theEvent); } Decorations menuShell () { return parent.menuShell (); } void scrollWheel (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { boolean handled = false; if (id == view.id) { NSEvent nsEvent = new NSEvent(theEvent); if ((hooks(SWT.Gesture) || filters(SWT.Gesture))) { if (nsEvent.deltaY() != 0 || nsEvent.deltaX() != 0) { if (!gestureEvent(id, theEvent, SWT.GESTURE_PAN)) { handled = true; } } } if (!handled) { if (hooks (SWT.MouseWheel) || filters (SWT.MouseWheel)) { if (nsEvent.deltaY() != 0) { if (!sendMouseEvent(nsEvent, SWT.MouseWheel, true)) { handled = true; } } } if (hooks (SWT.MouseHorizontalWheel) || filters (SWT.MouseHorizontalWheel)) { if (nsEvent.deltaX() != 0) { if (!sendMouseEvent(nsEvent, SWT.MouseHorizontalWheel, true)) { handled = true; } } } } } if (!handled) super.scrollWheel(id, sel, theEvent); } boolean isEventView (int /*long*/ id) { return true; } boolean mouseEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent, int type) { if (!display.sendEvent) return true; display.sendEvent = false; if (!isEventView (id)) return true; boolean dragging = false; boolean[] consume = null; NSEvent nsEvent = new NSEvent(theEvent); int nsType = (int)/*64*/nsEvent.type(); NSInputManager manager = NSInputManager.currentInputManager (); if (manager != null && manager.wantsToHandleMouseEvents ()) { if (manager.handleMouseEvent (nsEvent)) { return true; } } boolean runEnterExit = false; Control runEnterExitControl = null; switch (nsType) { case OS.NSLeftMouseDown: if (nsEvent.clickCount() == 1 && (nsEvent.modifierFlags() & OS.NSControlKeyMask) == 0 && (state & DRAG_DETECT) != 0 && hooks (SWT.DragDetect)) { consume = new boolean[1]; NSPoint location = view.convertPoint_fromView_(nsEvent.locationInWindow(), null); if (!view.isFlipped ()) { location.y = view.bounds().height - location.y; } dragging = dragDetect((int)location.x, (int)location.y, false, consume); } break; case OS.NSLeftMouseDragged: case OS.NSRightMouseDragged: case OS.NSOtherMouseDragged: runEnterExit = true; runEnterExitControl = this; break; case OS.NSLeftMouseUp: case OS.NSRightMouseUp: case OS.NSOtherMouseUp: if (display.clickCount == 2) { sendMouseEvent (nsEvent, SWT.MouseDoubleClick, false); } runEnterExit = true; runEnterExitControl = display.findControl(true); break; } sendMouseEvent (nsEvent, type, false); if (dragging) sendMouseEvent(nsEvent, SWT.DragDetect, false); if (runEnterExit) display.checkEnterExit (runEnterExitControl, nsEvent, false); if (consume != null && consume[0]) return false; return true; } void mouseDown(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseDown)) return; boolean tracking = isEventView (id); Display display = this.display; if (tracking) display.trackingControl = this; super.mouseDown(id, sel, theEvent); if (tracking) display.trackingControl = null; } void mouseUp(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseUp)) return; super.mouseUp(id, sel, theEvent); } void mouseDragged(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseMove)) return; super.mouseDragged(id, sel, theEvent); } void rightMouseDown(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseDown)) return; super.rightMouseDown(id, sel, theEvent); } void rightMouseUp(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseUp)) return; super.rightMouseUp(id, sel, theEvent); } void rightMouseDragged(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseMove)) return; super.rightMouseDragged(id, sel, theEvent); } void otherMouseDown(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseDown)) return; super.otherMouseDown(id, sel, theEvent); } void otherMouseUp(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseUp)) return; super.otherMouseUp(id, sel, theEvent); } void otherMouseDragged(int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { if (!mouseEvent(id, sel, theEvent, SWT.MouseMove)) return; super.otherMouseDragged(id, sel, theEvent); } void moved () { sendEvent (SWT.Move); } /** * Moves the receiver above the specified control in the * drawing order. If the argument is null, then the receiver * is moved to the top of the drawing order. The control at * the top of the drawing order will not be covered by other * controls even if they occupy intersecting areas. * * @param control the sibling control (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the control has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see Control#moveBelow * @see Composite#getChildren */ public void moveAbove (Control control) { checkWidget(); if (control != null) { if (control.isDisposed ()) error (SWT.ERROR_INVALID_ARGUMENT); if (parent != control.parent) return; } setZOrder (control, true); } /** * Moves the receiver below the specified control in the * drawing order. If the argument is null, then the receiver * is moved to the bottom of the drawing order. The control at * the bottom of the drawing order will be covered by all other * controls which occupy intersecting areas. * * @param control the sibling control (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the control has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see Control#moveAbove * @see Composite#getChildren */ public void moveBelow (Control control) { checkWidget(); if (control != null) { if (control.isDisposed ()) error (SWT.ERROR_INVALID_ARGUMENT); if (parent != control.parent) return; } setZOrder (control, false); } Accessible new_Accessible (Control control) { return Accessible.internal_new_Accessible (this); } /** * Causes the receiver to be resized to its preferred size. * For a composite, this involves computing the preferred size * from its layout, if there is one. * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #computeSize(int, int, boolean) */ public void pack () { checkWidget(); pack (true); } /** * Causes the receiver to be resized to its preferred size. * For a composite, this involves computing the preferred size * from its layout, if there is one. *

* If the changed flag is true, it indicates that the receiver's * contents have changed, therefore any caches that a layout manager * containing the control may have been keeping need to be flushed. When the * control is resized, the changed flag will be false, so layout * manager caches can be retained. *

* * @param changed whether or not the receiver's contents have changed * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #computeSize(int, int, boolean) */ public void pack (boolean changed) { checkWidget(); setSize (computeSize (SWT.DEFAULT, SWT.DEFAULT, changed)); } NSView paintView () { return eventView (); } /** * Prints the receiver and all children. * * @param gc the gc where the drawing occurs * @return true if the operation was successful and false otherwise * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the gc is null
  • *
  • ERROR_INVALID_ARGUMENT - if the gc has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @since 3.4 */ public boolean print (GC gc) { checkWidget (); if (gc == null) error (SWT.ERROR_NULL_ARGUMENT); if (gc.isDisposed ()) error (SWT.ERROR_INVALID_ARGUMENT); NSGraphicsContext.static_saveGraphicsState(); NSGraphicsContext.setCurrentContext(gc.handle); NSAffineTransform transform = NSAffineTransform.transform (); transform.translateXBy (0, view.bounds().height); transform.scaleXBy (1, -1); transform.concat (); view.displayRectIgnoringOpacity(view.bounds(), gc.handle); NSGraphicsContext.static_restoreGraphicsState(); return true; } /** * Causes the entire bounds of the receiver to be marked * as needing to be redrawn. The next time a paint request * is processed, the control will be completely painted, * including the background. * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #update() * @see PaintListener * @see SWT#Paint * @see SWT#NO_BACKGROUND * @see SWT#NO_REDRAW_RESIZE * @see SWT#NO_MERGE_PAINTS * @see SWT#DOUBLE_BUFFERED */ public void redraw () { checkWidget(); view.setNeedsDisplay(true); } void redraw (boolean children) { // checkWidget(); view.setNeedsDisplay(true); } /** * Causes the rectangular area of the receiver specified by * the arguments to be marked as needing to be redrawn. * The next time a paint request is processed, that area of * the receiver will be painted, including the background. * If the all flag is true, any * children of the receiver which intersect with the specified * area will also paint their intersecting areas. If the * all flag is false, the children * will not be painted. * * @param x the x coordinate of the area to draw * @param y the y coordinate of the area to draw * @param width the width of the area to draw * @param height the height of the area to draw * @param all true if children should redraw, and false otherwise * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #update() * @see PaintListener * @see SWT#Paint * @see SWT#NO_BACKGROUND * @see SWT#NO_REDRAW_RESIZE * @see SWT#NO_MERGE_PAINTS * @see SWT#DOUBLE_BUFFERED */ public void redraw (int x, int y, int width, int height, boolean all) { checkWidget (); NSRect rect = new NSRect(); rect.x = x; rect.y = y; rect.width = width; rect.height = height; view.setNeedsDisplayInRect(rect); } int /*long*/ regionToRects(int /*long*/ message, int /*long*/ rgn, int /*long*/ r, int /*long*/ path) { NSPoint pt = new NSPoint(); short[] rect = new short[4]; if (message == OS.kQDRegionToRectsMsgParse) { C.memmove(rect, r, rect.length * 2); pt.x = rect[1]; pt.y = rect[0]; OS.objc_msgSend(path, OS.sel_moveToPoint_, pt); pt.x = rect[3]; OS.objc_msgSend(path, OS.sel_lineToPoint_, pt); pt.x = rect[3]; pt.y = rect[2]; OS.objc_msgSend(path, OS.sel_lineToPoint_, pt); pt.x = rect[1]; OS.objc_msgSend(path, OS.sel_lineToPoint_, pt); OS.objc_msgSend(path, OS.sel_closePath); } return 0; } void register () { super.register (); display.addWidget (view, this); } void release (boolean destroy) { Control next = null, previous = null; if (destroy && parent != null) { Control[] children = parent._getChildren (); int index = 0; while (index < children.length) { if (children [index] == this) break; index++; } if (0 < index && (index + 1) < children.length) { next = children [index + 1]; previous = children [index - 1]; } } super.release (destroy); if (destroy) { if (previous != null) previous.addRelation (next); } } void releaseHandle () { super.releaseHandle (); if (view != null) view.release(); view = null; parent = null; } void releaseParent () { invalidateVisibleRegion (); parent.removeControl (this); } void releaseWidget () { super.releaseWidget (); if (display.currentControl == this) { display.currentControl = null; display.timerExec(-1, display.hoverTimer); } if (display.trackingControl == this) display.trackingControl = null; if (display.tooltipControl == this) display.tooltipControl = null; if (menu != null && !menu.isDisposed ()) { menu.dispose (); } menu = null; if (visibleRgn != 0) OS.DisposeRgn (visibleRgn); visibleRgn = 0; layoutData = null; if (accessible != null) { accessible.internal_dispose_Accessible (); } accessible = null; region = null; if (regionPath != null) regionPath.release(); regionPath = null; } /** * Removes the listener from the collection of listeners who will * be notified when the control is moved or resized. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see ControlListener * @see #addControlListener */ public void removeControlListener (ControlListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.Move, listener); eventTable.unhook (SWT.Resize, listener); } /** * Removes the listener from the collection of listeners who will * be notified when a drag gesture occurs. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see DragDetectListener * @see #addDragDetectListener * * @since 3.3 */ public void removeDragDetectListener(DragDetectListener listener) { checkWidget (); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.DragDetect, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the control gains or loses focus. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see FocusListener * @see #addFocusListener */ public void removeFocusListener(FocusListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.FocusIn, listener); eventTable.unhook(SWT.FocusOut, listener); } /** * Removes the listener from the collection of listeners who will * be notified when gesture events are generated for the control. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see GestureListener * @see #addGestureListener * * @since 3.7 */ public void removeGestureListener (GestureListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.Gesture, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the help events are generated for the control. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see HelpListener * @see #addHelpListener */ public void removeHelpListener (HelpListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.Help, listener); } /** * Removes the listener from the collection of listeners who will * be notified when keys are pressed and released on the system keyboard. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see KeyListener * @see #addKeyListener */ public void removeKeyListener(KeyListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.KeyUp, listener); eventTable.unhook(SWT.KeyDown, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the platform-specific context menu trigger has * occurred. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see MenuDetectListener * @see #addMenuDetectListener * * @since 3.3 */ public void removeMenuDetectListener (MenuDetectListener listener) { checkWidget (); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.MenuDetect, listener); } /** * Removes the listener from the collection of listeners who will * be notified when mouse buttons are pressed and released. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see MouseListener * @see #addMouseListener */ public void removeMouseListener(MouseListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.MouseDown, listener); eventTable.unhook(SWT.MouseUp, listener); eventTable.unhook(SWT.MouseDoubleClick, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the mouse moves. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see MouseMoveListener * @see #addMouseMoveListener */ public void removeMouseMoveListener(MouseMoveListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.MouseMove, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the mouse passes or hovers over controls. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see MouseTrackListener * @see #addMouseTrackListener */ public void removeMouseTrackListener(MouseTrackListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.MouseEnter, listener); eventTable.unhook (SWT.MouseExit, listener); eventTable.unhook (SWT.MouseHover, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the mouse wheel is scrolled. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see MouseWheelListener * @see #addMouseWheelListener * * @since 3.3 */ public void removeMouseWheelListener (MouseWheelListener listener) { checkWidget (); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.MouseWheel, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the receiver needs to be painted. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see PaintListener * @see #addPaintListener */ public void removePaintListener(PaintListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.Paint, listener); } /* * Remove "Labeled by" relations from the receiver. */ void removeRelation () { if (!isDescribedByLabel()) return; NSObject accessibleElement = focusView(); if (accessibleElement instanceof NSControl) { NSControl viewAsControl = (NSControl) accessibleElement; if (viewAsControl.cell() != null) accessibleElement = viewAsControl.cell(); } accessibleElement.accessibilitySetOverrideValue(accessibleElement, OS.NSAccessibilityTitleUIElementAttribute); } /** * Removes the listener from the collection of listeners who will * be notified when touch events occur. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see TouchListener * @see #addTouchListener * * @since 3.7 */ public void removeTouchListener(TouchListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.Touch, listener); } /** * Removes the listener from the collection of listeners who will * be notified when traversal events occur. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the listener is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see TraverseListener * @see #addTraverseListener */ public void removeTraverseListener(TraverseListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.Traverse, listener); } void resetVisibleRegion () { if (visibleRgn != 0) { OS.DisposeRgn (visibleRgn); visibleRgn = 0; } GCData[] gcs = display.contexts; if (gcs != null) { int /*long*/ visibleRgn = 0; for (int i=0; i 0 ? Math.max (1, (int)delta) : Math.min (-1, (int)delta); break; } case SWT.MouseHorizontalWheel: { float /*double*/ delta = nsEvent.deltaX(); event.count = delta > 0 ? Math.max (1, (int)delta) : Math.min (-1, (int)delta); break; } } if (event.button != 0) event.count = display.clickCount; NSPoint windowPoint; NSView view = eventView (); if (nsEvent == null || nsEvent.type() == OS.NSMouseMoved) { NSWindow window = view.window(); windowPoint = window.convertScreenToBase(NSEvent.mouseLocation()); } else { windowPoint = nsEvent.locationInWindow(); } NSPoint point = view.convertPoint_fromView_(windowPoint, null); if (!view.isFlipped ()) { point.y = view.bounds().height - point.y; } event.x = (int) point.x; event.y = (int) point.y; setInputState (event, nsEvent, type); if (send) { sendEvent (type, event); if (isDisposed ()) return false; } else { postEvent (type, event); } if (shell != null) shell.setActiveControl(this); return event.doit; } Touch touchStateFromNSTouch(NSTouch touch) { TouchSource source = display.findTouchSource(touch); int /*long*/ osPhase = touch.phase(); long identity = OS.objc_msgSend(touch.id, OS.sel_identity); int state = 0; switch ((int)osPhase) { case OS.NSTouchPhaseBegan: state = SWT.TOUCHSTATE_DOWN; break; case OS.NSTouchPhaseMoved: state = SWT.TOUCHSTATE_MOVE; break; case OS.NSTouchPhaseEnded: case OS.NSTouchPhaseCancelled: state = SWT.TOUCHSTATE_UP; break; } display.touchCounter++; boolean primary = false; NSPoint normalizedPos = touch.normalizedPosition(); double normalizedX = normalizedPos.x; double normalizedY = 1 - normalizedPos.y; if (display.currentTouches().count() == 1) display.primaryIdentifier = identity; if (display.primaryIdentifier == identity) primary = true; NSSize deviceSize = touch.deviceSize(); int deviceX = (int) (normalizedX * deviceSize.width); int deviceY = (int) (normalizedY * deviceSize.height); Touch newTS = new Touch(identity, source, state, primary, deviceX, deviceY); return newTS; } NSTouch findTouchWithId(NSArray touches, NSObject identity) { int /*long*/ count = touches.count(); for (int /*long*/ i = 0; i < count; i++) { NSTouch aTouch = new NSTouch(touches.objectAtIndex(i).id); NSObject currIdentity = new NSObject(OS.objc_msgSend(aTouch.id, OS.sel_identity)); if (currIdentity.isEqual(identity)) return aTouch; } return null; } void setBackground () { if (!drawsBackground()) return; Control control = findBackgroundControl (); if (control == null) control = this; if (control.backgroundImage != null) { setBackgroundImage (control.backgroundImage.handle); } else { float /*double*/ [] color = control.background != null ? control.background : control.defaultBackground().handle; NSColor nsColor = NSColor.colorWithDeviceRed(color[0], color[1], color[2], color[3]); setBackgroundColor (nsColor); } } /** * Sets the receiver's background color to the color specified * by the argument, or to the default system color for the control * if the argument is null. *

* Note: This operation is a hint and may be overridden by the platform. * For example, on Windows the background of a Button cannot be changed. *

* @param color the new color (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the argument has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setBackground (Color color) { checkWidget(); if (color != null) { if (color.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); } float /*double*/ [] background = color != null ? color.handle : null; if (equals (background, this.background)) return; this.background = background; updateBackgroundColor (); redrawWidget(view, true); } /** * Sets the receiver's background image to the image specified * by the argument, or to the default system color for the control * if the argument is null. The background image is tiled to fill * the available space. *

* Note: This operation is a hint and may be overridden by the platform. * For example, on Windows the background of a Button cannot be changed. *

* @param image the new image (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the argument has been disposed
  • *
  • ERROR_INVALID_ARGUMENT - if the argument is not a bitmap
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @since 3.2 */ public void setBackgroundImage (Image image) { checkWidget(); if (image != null && image.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); if (image == backgroundImage) return; backgroundImage = image; updateBackgroundImage(); } void setBackgroundImage (NSImage image) { redrawWidget(view, true); } void setBackgroundColor (NSColor nsColor) { } /** * Sets the receiver's size and location to the rectangular * area specified by the arguments. The x and * y arguments are relative to the receiver's * parent (or its display if its parent is null), unless * the receiver is a shell. In this case, the x * and y arguments are relative to the display. *

* Note: Attempting to set the width or height of the * receiver to a negative number will cause that * value to be set to zero instead. *

* * @param x the new x coordinate for the receiver * @param y the new y coordinate for the receiver * @param width the new width for the receiver * @param height the new height for the receiver * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setBounds (int x, int y, int width, int height) { checkWidget(); setBounds (x, y, Math.max (0, width), Math.max (0, height), true, true); } void setBounds (int x, int y, int width, int height, boolean move, boolean resize) { NSView topView = topView(); if (move && resize) { NSRect rect = new NSRect(); rect.x = x; rect.y = y; rect.width = width; rect.height = height; topView.setFrame (rect); } else if (move) { NSPoint point = new NSPoint(); point.x = x; point.y = y; topView.setFrameOrigin(point); } else if (resize) { NSSize size = new NSSize(); size.width = width; size.height = height; topView.setFrameSize(size); } } /** * Sets the receiver's size and location to the rectangular * area specified by the argument. The x and * y fields of the rectangle are relative to * the receiver's parent (or its display if its parent is null). *

* Note: Attempting to set the width or height of the * receiver to a negative number will cause that * value to be set to zero instead. *

* * @param rect the new bounds for the receiver * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setBounds (Rectangle rect) { checkWidget (); if (rect == null) error (SWT.ERROR_NULL_ARGUMENT); setBounds (rect.x, rect.y, Math.max (0, rect.width), Math.max (0, rect.height), true, true); } /** * If the argument is true, causes the receiver to have * all mouse events delivered to it until the method is called with * false as the argument. Note that on some platforms, * a mouse button must currently be down for capture to be assigned. * * @param capture true to capture the mouse, and false to release it * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setCapture (boolean capture) { checkWidget(); } void setClipRegion (NSView view) { if (regionPath != null) { NSView rgnView = topView (); if (!rgnView.isFlipped ()) rgnView = eventView (); NSPoint pt = view.convertPoint_toView_(new NSPoint(), rgnView); NSAffineTransform transform = NSAffineTransform.transform(); transform.translateXBy(-pt.x, -pt.y); regionPath.transformUsingAffineTransform(transform); regionPath.addClip(); transform.translateXBy(2*pt.x, 2*pt.y); regionPath.transformUsingAffineTransform(transform); } parent.setClipRegion(view); } /** * Sets the receiver's cursor to the cursor specified by the * argument, or to the default cursor for that kind of control * if the argument is null. *

* When the mouse pointer passes over a control its appearance * is changed to match the control's cursor. *

* * @param cursor the new cursor (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the argument has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setCursor (Cursor cursor) { checkWidget(); if (cursor != null && cursor.isDisposed ()) error (SWT.ERROR_INVALID_ARGUMENT); this.cursor = cursor; if (!isEnabled()) return; if (!view.window().areCursorRectsEnabled()) return; display.setCursor (display.currentControl); } void setDefaultFont () { if (display.smallFonts) { setFont (defaultFont ().handle); setSmallSize (); } } /** * Sets the receiver's drag detect state. If the argument is * true, the receiver will detect drag gestures, * otherwise these gestures will be ignored. * * @param dragDetect the new drag detect state * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @since 3.3 */ public void setDragDetect (boolean dragDetect) { checkWidget (); if (dragDetect) { state |= DRAG_DETECT; } else { state &= ~DRAG_DETECT; } } /** * Enables the receiver if the argument is true, * and disables it otherwise. A disabled control is typically * not selectable from the user interface and draws with an * inactive or "grayed" look. * * @param enabled the new enabled state * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setEnabled (boolean enabled) { checkWidget(); if (((state & DISABLED) == 0) == enabled) return; Control control = null; boolean fixFocus = false; if (!enabled) { if (display.focusEvent != SWT.FocusOut) { control = display.getFocusControl (); fixFocus = isFocusAncestor (control); } } if (enabled) { state &= ~DISABLED; } else { state |= DISABLED; } enableWidget (enabled); if (fixFocus) fixFocus (control); } /** * Causes the receiver to have the keyboard focus, * such that all keyboard events will be delivered to it. Focus * reassignment will respect applicable platform constraints. * * @return true if the control got focus, and false if it was unable to. * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #forceFocus */ public boolean setFocus () { checkWidget(); if ((style & SWT.NO_FOCUS) != 0) return false; return forceFocus (); } /** * Sets the font that the receiver will use to paint textual information * to the font specified by the argument, or to the default font for that * kind of control if the argument is null. * * @param font the new font (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the argument has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setFont (Font font) { checkWidget(); if (font != null) { if (font.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); } this.font = font; setFont (font != null ? font.handle : defaultFont().handle); } void setFont (NSFont font) { if (view instanceof NSControl) { ((NSControl)view).setFont(font); } } /** * Sets the receiver's foreground color to the color specified * by the argument, or to the default system color for the control * if the argument is null. *

* Note: This operation is a hint and may be overridden by the platform. *

* @param color the new color (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the argument has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setForeground (Color color) { checkWidget(); if (color != null) { if (color.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); } float /*double*/ [] foreground = color != null ? color.handle : null; if (equals (foreground, this.foreground)) return; this.foreground = foreground; setForeground (foreground); redrawWidget (view, false); } void setForeground (float /*double*/ [] color) { } void setFrameOrigin (int /*long*/ id, int /*long*/ sel, NSPoint point) { NSView topView = topView (); if (topView.id != id) { super.setFrameOrigin(id, sel, point); return; } NSRect frame = topView.frame(); super.setFrameOrigin(id, sel, point); if (frame.x != point.x || frame.y != point.y) { invalidateVisibleRegion(); moved (); } } void setFrameSize (int /*long*/ id, int /*long*/ sel, NSSize size) { NSView topView = topView (); if (topView.id != id) { super.setFrameSize(id, sel, size); return; } NSRect frame = topView.frame(); super.setFrameSize(id, sel, size); if (frame.width != size.width || frame.height != size.height) { invalidateVisibleRegion(); boolean oldResizing = (state & RESIZING) != 0; state |= RESIZING; resized (); if (!oldResizing) state &= ~RESIZING; } } /** * Sets the layout data associated with the receiver to the argument. * * @param layoutData the new layout data for the receiver. * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setLayoutData (Object layoutData) { checkWidget(); this.layoutData = layoutData; } /** * Sets the receiver's location to the point specified by * the arguments which are relative to the receiver's * parent (or its display if its parent is null), unless * the receiver is a shell. In this case, the point is * relative to the display. * * @param x the new x coordinate for the receiver * @param y the new y coordinate for the receiver * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setLocation (int x, int y) { checkWidget(); setBounds (x, y, 0, 0, true, false); } /** * Sets the receiver's location to the point specified by * the arguments which are relative to the receiver's * parent (or its display if its parent is null), unless * the receiver is a shell. In this case, the point is * relative to the display. * * @param location the new location for the receiver * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setLocation (Point location) { checkWidget(); if (location == null) error (SWT.ERROR_NULL_ARGUMENT); setBounds (location.x, location.y, 0, 0, true, false); } /** * Sets the receiver's pop up menu to the argument. * All controls may optionally have a pop up * menu that is displayed when the user requests one for * the control. The sequence of key strokes, button presses * and/or button releases that are used to request a pop up * menu is platform specific. *

* Note: Disposing of a control that has a pop up menu will * dispose of the menu. To avoid this behavior, set the * menu to null before the control is disposed. *

* * @param menu the new pop up menu * * @exception IllegalArgumentException
    *
  • ERROR_MENU_NOT_POP_UP - the menu is not a pop up menu
  • *
  • ERROR_INVALID_PARENT - if the menu is not in the same widget tree
  • *
  • ERROR_INVALID_ARGUMENT - if the menu has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setMenu (Menu menu) { checkWidget(); if (menu != null) { if (menu.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); if ((menu.style & SWT.POP_UP) == 0) { error (SWT.ERROR_MENU_NOT_POP_UP); } if (menu.parent != menuShell ()) { error (SWT.ERROR_INVALID_PARENT); } } this.menu = menu; } /** * Sets the orientation of the receiver, which must be one * of the constants SWT.LEFT_TO_RIGHT or SWT.RIGHT_TO_LEFT. *

* * @param orientation new orientation style * * @exception SWTException

    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @since 3.7 */ public void setOrientation (int orientation) { checkWidget (); } /** * Changes the parent of the widget to be the one provided if * the underlying operating system supports this feature. * Returns true if the parent is successfully changed. * * @param parent the new parent for the control. * @return true if the parent is changed and false otherwise. * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the argument has been disposed
  • *
  • ERROR_NULL_ARGUMENT - if the parent is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public boolean setParent (Composite parent) { checkWidget(); if (parent == null) error (SWT.ERROR_NULL_ARGUMENT); if (parent.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); if (this.parent == parent) return true; if (!isReparentable ()) return false; releaseParent (); Shell newShell = parent.getShell (), oldShell = getShell (); Decorations newDecorations = parent.menuShell (), oldDecorations = menuShell (); if (oldShell != newShell || oldDecorations != newDecorations) { Menu [] menus = oldShell.findMenus (this); fixChildren (newShell, oldShell, newDecorations, oldDecorations, menus); } NSView topView = topView (); topView.retain(); topView.removeFromSuperview(); parent.contentView().addSubview(topView, OS.NSWindowBelow, null); topView.release(); this.parent = parent; reskin (SWT.ALL); return true; } /** * If the argument is false, causes subsequent drawing * operations in the receiver to be ignored. No drawing of any kind * can occur in the receiver until the flag is set to true. * Graphics operations that occurred while the flag was * false are lost. When the flag is set to true, * the entire widget is marked as needing to be redrawn. Nested calls * to this method are stacked. *

* Note: This operation is a hint and may not be supported on some * platforms or for some widgets. *

* * @param redraw the new redraw state * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @see #redraw(int, int, int, int, boolean) * @see #update() */ public void setRedraw (boolean redraw) { checkWidget(); if (redraw) { if (--drawCount == 0) { invalidateVisibleRegion (); redrawWidget(topView (), true); } } else { if (drawCount == 0) { invalidateVisibleRegion (); } drawCount++; } } /** * Sets the shape of the control to the region specified * by the argument. When the argument is null, the * default shape of the control is restored. * * @param region the region that defines the shape of the control (or null) * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the region has been disposed
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
* * @since 3.4 */ public void setRegion (Region region) { checkWidget (); if (region != null && region.isDisposed()) error (SWT.ERROR_INVALID_ARGUMENT); this.region = region; if (regionPath != null) regionPath.release(); regionPath = getPath(region); redrawWidget(view, true); } void setRelations () { if (parent == null) return; Control [] children = parent._getChildren (); int count = children.length; if (count > 1) { /* * the receiver is the last item in the list, so its predecessor will * be the second-last item in the list */ Control child = children [count - 2]; if (child != this) { child.addRelation (this); } } } boolean setRadioSelection (boolean value){ return false; } /** * Sets the receiver's size to the point specified by the arguments. *

* Note: Attempting to set the width or height of the * receiver to a negative number will cause that * value to be set to zero instead. *

* * @param width the new width for the receiver * @param height the new height for the receiver * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setSize (int width, int height) { checkWidget(); setBounds (0, 0, Math.max (0, width), Math.max (0, height), false, true); } /** * Sets the receiver's size to the point specified by the argument. *

* Note: Attempting to set the width or height of the * receiver to a negative number will cause them to be * set to zero instead. *

* * @param size the new size for the receiver * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the point is null
  • *
* @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setSize (Point size) { checkWidget (); if (size == null) error (SWT.ERROR_NULL_ARGUMENT); setBounds (0, 0, Math.max (0, size.x), Math.max (0, size.y), false, true); } void setSmallSize () { if (view instanceof NSControl) { NSCell cell = ((NSControl)view).cell(); if (cell != null) cell.setControlSize (OS.NSSmallControlSize); } } boolean setTabItemFocus () { if (!isShowing ()) return false; return forceFocus (); } /** * Sets the receiver's tool tip text to the argument, which * may be null indicating that the default tool tip for the * control will be shown. For a control that has a default * tool tip, such as the Tree control on Windows, setting * the tool tip text to an empty string replaces the default, * causing no tool tip text to be shown. *

* The mnemonic indicator (character '&') is not displayed in a tool tip. * To display a single '&' in the tool tip, the character '&' can be * escaped by doubling it in the string. *

* * @param string the new tool tip text (or null) * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • *
*/ public void setToolTipText (String string) { checkWidget(); toolTipText = string; checkToolTip (null); } /** * Sets whether this control should send touch events (by default controls do not). * Setting this to false causes the receiver to send gesture events * instead. No exception is thrown if a touch-based input device is not * detected (this can be determined with Display#getTouchEnabled()). * * @param enabled the new touch-enabled state * * @exception SWTException
    *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • * * @see Display#getTouchEnabled * * @since 3.7 */ public void setTouchEnabled(boolean enabled) { checkWidget(); eventView().setAcceptsTouchEvents(enabled); touchEnabled = enabled; } /** * Marks the receiver as visible if the argument is true, * and marks it invisible otherwise. *

    * 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. *

    * * @param visible the new visibility state * * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public void setVisible (boolean visible) { checkWidget(); if (visible) { if ((state & HIDDEN) == 0) return; state &= ~HIDDEN; } else { if ((state & HIDDEN) != 0) return; state |= HIDDEN; } if (visible) { /* * It is possible (but unlikely), that application * code could have disposed the widget in the show * event. If this happens, just return. */ sendEvent (SWT.Show); if (isDisposed ()) return; } /* * Feature in the Macintosh. If the receiver has focus, hiding * the receiver causes no control to have focus. Also, the focus * needs to be cleared from any TXNObject so that it stops blinking * the caret. The fix is to assign focus to the first ancestor * control that takes focus. If no control will take focus, clear * the focus control. */ Control control = null; boolean fixFocus = false; if (!visible) { if (display.focusEvent != SWT.FocusOut) { control = display.getFocusControl (); fixFocus = isFocusAncestor (control); } } topView().setHidden(!visible); if (isDisposed ()) return; invalidateVisibleRegion(); if (!visible) { /* * It is possible (but unlikely), that application * code could have disposed the widget in the show * event. If this happens, just return. */ sendEvent (SWT.Hide); if (isDisposed ()) return; } if (fixFocus) fixFocus (control); } void setZOrder () { NSView topView = topView (); parent.contentView().addSubview(topView, OS.NSWindowBelow, null); } boolean shouldDelayWindowOrderingForEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ theEvent) { Shell shell = getShell (); if ((shell.style & SWT.ON_TOP) != 0) return false; return super.shouldDelayWindowOrderingForEvent (id, sel, theEvent); } void setZOrder (Control sibling, boolean above) { int index = 0, siblingIndex = 0, oldNextIndex = -1; Control[] children = null; /* determine the receiver's and sibling's indexes in the parent */ children = parent._getChildren (); while (index < children.length) { if (children [index] == this) break; index++; } if (sibling != null) { while (siblingIndex < children.length) { if (children [siblingIndex] == sibling) break; siblingIndex++; } } /* remove "Labeled by" relationships that will no longer be valid */ removeRelation (); if (index + 1 < children.length) { oldNextIndex = index + 1; children [oldNextIndex].removeRelation (); } if (sibling != null) { if (above) { sibling.removeRelation (); } else { if (siblingIndex + 1 < children.length) { children [siblingIndex + 1].removeRelation (); } } } NSView otherView = sibling == null ? null : sibling.topView (); NSView topView = topView(); topView.retain(); topView.removeFromSuperview(); parent.contentView().addSubview(topView, above ? OS.NSWindowAbove : OS.NSWindowBelow, otherView); topView.release(); invalidateVisibleRegion(); /* determine the receiver's new index in the parent */ if (sibling != null) { if (above) { index = siblingIndex - (index < siblingIndex ? 1 : 0); } else { index = siblingIndex + (siblingIndex < index ? 1 : 0); } } else { if (above) { index = 0; } else { index = children.length - 1; } } /* add new "Labeled by" relations as needed */ children = parent._getChildren (); if (0 < index) { children [index - 1].addRelation (this); } if (index + 1 < children.length) { addRelation (children [index + 1]); } if (oldNextIndex != -1) { if (oldNextIndex <= index) oldNextIndex--; /* the last two conditions below ensure that duplicate relations are not hooked */ if (0 < oldNextIndex && oldNextIndex != index && oldNextIndex != index + 1) { children [oldNextIndex - 1].addRelation (children [oldNextIndex]); } } } void sort (int [] items) { /* Shell Sort from K&R, pg 108 */ int length = items.length; for (int gap=length/2; gap>0; gap/=2) { for (int i=gap; i=0; j-=gap) { if (items [j] <= items [j + gap]) { int swap = items [j]; items [j] = items [j + gap]; items [j + gap] = swap; } } } } } void swipeWithEvent(int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!gestureEvent(id, event, SWT.GESTURE_SWIPE)) return; super.swipeWithEvent(id, sel, event); } NSSize textExtent (String string) { NSAttributedString attribStr = createString(string, null, null, 0, false, true, false); NSSize size = attribStr.size(); attribStr.release(); return size; } String tooltipText () { return toolTipText; } /** * Returns a point which is the result of converting the * argument, which is specified in display relative coordinates, * to coordinates relative to the receiver. *

    * @param x the x coordinate to be translated * @param y the y coordinate to be translated * @return the translated coordinates * * @exception SWTException

      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    * * @since 2.1 */ public Point toControl (int x, int y) { checkWidget(); return display.map (null, this, x, y); } /** * Returns a point which is the result of converting the * argument, which is specified in display relative coordinates, * to coordinates relative to the receiver. *

    * @param point the point to be translated (must not be null) * @return the translated coordinates * * @exception IllegalArgumentException

      *
    • ERROR_NULL_ARGUMENT - if the point is null
    • *
    * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public Point toControl (Point point) { checkWidget(); if (point == null) error (SWT.ERROR_NULL_ARGUMENT); return toControl (point.x, point.y); } /** * Returns a point which is the result of converting the * argument, which is specified in coordinates relative to * the receiver, to display relative coordinates. *

    * @param x the x coordinate to be translated * @param y the y coordinate to be translated * @return the translated coordinates * * @exception SWTException

      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    * * @since 2.1 */ public Point toDisplay (int x, int y) { checkWidget(); return display.map (this, null, x, y); } /** * Returns a point which is the result of converting the * argument, which is specified in coordinates relative to * the receiver, to display relative coordinates. *

    * @param point the point to be translated (must not be null) * @return the translated coordinates * * @exception IllegalArgumentException

      *
    • ERROR_NULL_ARGUMENT - if the point is null
    • *
    * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public Point toDisplay (Point point) { checkWidget(); if (point == null) error (SWT.ERROR_NULL_ARGUMENT); return toDisplay (point.x, point.y); } NSView topView () { return view; } boolean touchEvent(int /*long*/ id, int /*long*/ sel, int /*long*/ eventPtr) { if (!display.sendEvent) return true; display.sendEvent = false; if (!(hooks(SWT.Touch) || filters(SWT.Touch))) return true; if (!isEventView (id)) return true; if (!touchEnabled) return true; NSEvent nsEvent = new NSEvent(eventPtr); NSMutableArray currentTouches = display.currentTouches(); Event event = new Event (); NSPoint location = view.convertPoint_fromView_(nsEvent.locationInWindow(), null); if (!view.isFlipped ()) { location.y = view.bounds().height - location.y; } event.x = (int) location.x; event.y = (int) location.y; setInputState (event, nsEvent, SWT.Touch); NSSet allTouchesSet = nsEvent.touchesMatchingPhase(OS.NSTouchPhaseAny, null); int /*long*/ touchCount = allTouchesSet.count(); Touch touches[] = new Touch[(int)/*64*/touchCount]; int currTouchIndex = 0; // Process removed/cancelled touches first. NSArray endedTouches = nsEvent.touchesMatchingPhase(OS.NSTouchPhaseEnded | OS.NSTouchPhaseCancelled, null).allObjects(); for (int i = 0; i < endedTouches.count(); i++) { NSTouch touch = new NSTouch(endedTouches.objectAtIndex(i).id); NSObject identity = new NSObject(OS.objc_msgSend(touch.id, OS.sel_identity)); NSTouch endedTouch = findTouchWithId(currentTouches, identity); if (endedTouch != null) currentTouches.removeObject(endedTouch); touches[currTouchIndex++] = touchStateFromNSTouch(touch); } if (currentTouches.count() == 0) display.touchCounter = 0; // Process touches in progress or starting. NSArray activeTouches = nsEvent.touchesMatchingPhase(OS.NSTouchPhaseBegan | OS.NSTouchPhaseMoved | OS.NSTouchPhaseStationary, null).allObjects(); for (int i = 0; i < activeTouches.count(); i++) { NSTouch touch = new NSTouch(activeTouches.objectAtIndex(i).id); NSObject identity = new NSObject(OS.objc_msgSend(touch.id, OS.sel_identity)); NSTouch activeTouch = findTouchWithId(currentTouches, identity); if (activeTouch == null) currentTouches.addObject(touch); touches[currTouchIndex++] = touchStateFromNSTouch(touch); } if (activeTouches.count() != currentTouches.count()) { /** * Bug in Cocoa. Under some situations we don't get the NSTouchPhaseEnded/Cancelled notification. Most commonly this happens * if a 4-finger gesture occurs and the application switcher appears. Workaround is to generate a TOUCHSTATE_UP for the * orphaned touch. */ for (int /*long*/ j = currentTouches.count() - 1; j >= 0 ; j--) { NSTouch touch = new NSTouch(currentTouches.objectAtIndex(j).id); NSObject identity = new NSObject(OS.objc_msgSend(touch.id, OS.sel_identity)); NSTouch activeTouch = findTouchWithId(activeTouches, identity); if (activeTouch == null) { Touch fakeTouchUp = touchStateFromNSTouch(touch); fakeTouchUp.state = SWT.TOUCHSTATE_UP; if (currTouchIndex == touches.length) { Touch newTouchStates[] = new Touch[touches.length + 1]; System.arraycopy(touches, 0, newTouchStates, 0, touches.length); touches = newTouchStates; } touches[currTouchIndex++] = fakeTouchUp; currentTouches.removeObject(activeTouch); } } } event.touches = touches; postEvent (SWT.Touch, event); return true; } void touchesBeganWithEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!touchEvent(id, sel, event)) return; super.touchesBeganWithEvent(id, sel, event); } void touchesCancelledWithEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!touchEvent(id, sel, event)) return; super.touchesCancelledWithEvent(id, sel, event); } void touchesEndedWithEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!touchEvent(id, sel, event)) return; super.touchesEndedWithEvent(id, sel, event); } void touchesMovedWithEvent (int /*long*/ id, int /*long*/ sel, int /*long*/ event) { if (!touchEvent(id, sel, event)) return; super.touchesMovedWithEvent(id, sel, event); } boolean translateTraversal (int key, NSEvent theEvent, boolean [] consume) { int detail = SWT.TRAVERSE_NONE; int code = traversalCode (key, theEvent); boolean all = false; switch (key) { case 53: /* Esc */ { all = true; detail = SWT.TRAVERSE_ESCAPE; break; } case 76: /* KP Enter */ case 36: /* Return */ { all = true; detail = SWT.TRAVERSE_RETURN; break; } case 48: /* Tab */ { int /*long*/ modifiers = theEvent.modifierFlags (); boolean next = (modifiers & OS.NSShiftKeyMask) == 0; detail = next ? SWT.TRAVERSE_TAB_NEXT : SWT.TRAVERSE_TAB_PREVIOUS; break; } case 126: /* Up arrow */ case 123: /* Left arrow */ case 125: /* Down arrow */ case 124: /* Right arrow */ { boolean next = key == 125 /* Down arrow */ || key == 124 /* Right arrow */; detail = next ? SWT.TRAVERSE_ARROW_NEXT : SWT.TRAVERSE_ARROW_PREVIOUS; break; } case 116: /* Page up */ case 121: /* Page down */ { all = true; int /*long*/ modifiers = theEvent.modifierFlags (); if ((modifiers & OS.NSControlKeyMask) == 0) return false; detail = key == 121 /* Page down */ ? SWT.TRAVERSE_PAGE_NEXT : SWT.TRAVERSE_PAGE_PREVIOUS; break; } default: return false; } Event event = new Event (); event.doit = consume [0] = (code & detail) != 0; event.detail = detail; if (!setKeyState (event, SWT.Traverse, theEvent)) return false; Shell shell = getShell (); Control control = this; do { if (control.traverse (event)) return true; if (!event.doit && control.hooks (SWT.Traverse)) { return false; } if (control == shell) return false; control = control.parent; } while (all && control != null); return false; } int traversalCode (int key, NSEvent theEvent) { int code = SWT.TRAVERSE_RETURN | SWT.TRAVERSE_TAB_NEXT | SWT.TRAVERSE_TAB_PREVIOUS | SWT.TRAVERSE_PAGE_NEXT | SWT.TRAVERSE_PAGE_PREVIOUS; Shell shell = getShell (); if (shell.parent != null) code |= SWT.TRAVERSE_ESCAPE; return code; } boolean traverseMnemonic (char key) { return false; } /** * Performs a platform traversal action corresponding to a KeyDown event. * *

    Valid traversal values are * SWT.TRAVERSE_NONE, SWT.TRAVERSE_MNEMONIC, * SWT.TRAVERSE_ESCAPE, SWT.TRAVERSE_RETURN, * SWT.TRAVERSE_TAB_NEXT, SWT.TRAVERSE_TAB_PREVIOUS, * SWT.TRAVERSE_ARROW_NEXT, SWT.TRAVERSE_ARROW_PREVIOUS, * SWT.TRAVERSE_PAGE_NEXT and SWT.TRAVERSE_PAGE_PREVIOUS. * If traversal is SWT.TRAVERSE_NONE then the Traverse * event is created with standard values based on the KeyDown event. If * traversal is one of the other traversal constants then the Traverse * event is created with this detail, and its doit is taken from the * KeyDown event. *

    * * @param traversal the type of traversal, or SWT.TRAVERSE_NONE to compute * this from event * @param event the KeyDown event * * @return true if the traversal succeeded * * @exception IllegalArgumentException
      *
    • ERROR_NULL_ARGUMENT if the event is null
    • *
    * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    * * @since 3.6 */ public boolean traverse (int traversal, Event event) { checkWidget (); if (event == null) error (SWT.ERROR_NULL_ARGUMENT); return traverse (traversal, event.character, event.keyCode, event.keyLocation, event.stateMask, event.doit); } /** * Performs a platform traversal action corresponding to a KeyDown event. * *

    Valid traversal values are * SWT.TRAVERSE_NONE, SWT.TRAVERSE_MNEMONIC, * SWT.TRAVERSE_ESCAPE, SWT.TRAVERSE_RETURN, * SWT.TRAVERSE_TAB_NEXT, SWT.TRAVERSE_TAB_PREVIOUS, * SWT.TRAVERSE_ARROW_NEXT, SWT.TRAVERSE_ARROW_PREVIOUS, * SWT.TRAVERSE_PAGE_NEXT and SWT.TRAVERSE_PAGE_PREVIOUS. * If traversal is SWT.TRAVERSE_NONE then the Traverse * event is created with standard values based on the KeyDown event. If * traversal is one of the other traversal constants then the Traverse * event is created with this detail, and its doit is taken from the * KeyDown event. *

    * * @param traversal the type of traversal, or SWT.TRAVERSE_NONE to compute * this from event * @param event the KeyDown event * * @return true if the traversal succeeded * * @exception IllegalArgumentException
      *
    • ERROR_NULL_ARGUMENT if the event is null
    • *
    * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    * * @since 3.6 */ public boolean traverse (int traversal, KeyEvent event) { checkWidget (); if (event == null) error (SWT.ERROR_NULL_ARGUMENT); return traverse (traversal, event.character, event.keyCode, event.keyLocation, event.stateMask, event.doit); } boolean traverse (int traversal, char character, int keyCode, int keyLocation, int stateMask, boolean doit) { if (traversal == SWT.TRAVERSE_NONE) { switch (keyCode) { case SWT.ESC: { traversal = SWT.TRAVERSE_ESCAPE; doit = true; break; } case SWT.CR: { traversal = SWT.TRAVERSE_RETURN; doit = true; break; } case SWT.ARROW_DOWN: case SWT.ARROW_RIGHT: { traversal = SWT.TRAVERSE_ARROW_NEXT; doit = false; break; } case SWT.ARROW_UP: case SWT.ARROW_LEFT: { traversal = SWT.TRAVERSE_ARROW_PREVIOUS; doit = false; break; } case SWT.TAB: { traversal = (stateMask & SWT.SHIFT) != 0 ? SWT.TRAVERSE_TAB_PREVIOUS : SWT.TRAVERSE_TAB_NEXT; doit = true; break; } case SWT.PAGE_DOWN: { if ((stateMask & SWT.CTRL) != 0) { traversal = SWT.TRAVERSE_PAGE_NEXT; doit = true; } break; } case SWT.PAGE_UP: { if ((stateMask & SWT.CTRL) != 0) { traversal = SWT.TRAVERSE_PAGE_PREVIOUS; doit = true; } break; } default: { /* keyCode does not have a corresponding traversal action */ return false; } } } Event event = new Event (); event.character = character; event.detail = traversal; event.doit = doit; event.keyCode = keyCode; event.keyLocation = keyLocation; event.stateMask = stateMask; Shell shell = getShell (); boolean all = false; switch (traversal) { case SWT.TRAVERSE_ESCAPE: case SWT.TRAVERSE_RETURN: case SWT.TRAVERSE_PAGE_NEXT: case SWT.TRAVERSE_PAGE_PREVIOUS: { all = true; // FALL THROUGH } case SWT.TRAVERSE_ARROW_NEXT: case SWT.TRAVERSE_ARROW_PREVIOUS: case SWT.TRAVERSE_TAB_NEXT: case SWT.TRAVERSE_TAB_PREVIOUS: { /* traversal is a valid traversal action */ break; } case SWT.TRAVERSE_MNEMONIC: /* not supported on OS X */ // FALL THROUGH default: { /* traversal is not a valid traversal action */ return false; } } Control control = this; do { if (control.traverse (event)) return true; if (!event.doit && control.hooks (SWT.Traverse)) return false; if (control == shell) return false; control = control.parent; } while (all && control != null); return false; } /** * Based on the argument, perform one of the expected platform * traversal action. The argument should be one of the constants: * SWT.TRAVERSE_ESCAPE, SWT.TRAVERSE_RETURN, * SWT.TRAVERSE_TAB_NEXT, SWT.TRAVERSE_TAB_PREVIOUS, * SWT.TRAVERSE_ARROW_NEXT, SWT.TRAVERSE_ARROW_PREVIOUS, * SWT.TRAVERSE_PAGE_NEXT and SWT.TRAVERSE_PAGE_PREVIOUS. * * @param traversal the type of traversal * @return true if the traversal succeeded * * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public boolean traverse (int traversal) { checkWidget(); Event event = new Event (); event.doit = true; event.detail = traversal; return traverse (event); } boolean traverse (Event event) { sendEvent (SWT.Traverse, event); if (isDisposed ()) return true; if (!event.doit) return false; switch (event.detail) { case SWT.TRAVERSE_NONE: return true; case SWT.TRAVERSE_ESCAPE: return traverseEscape (); case SWT.TRAVERSE_RETURN: return traverseReturn (); case SWT.TRAVERSE_TAB_NEXT: return traverseGroup (true); case SWT.TRAVERSE_TAB_PREVIOUS: return traverseGroup (false); case SWT.TRAVERSE_ARROW_NEXT: return traverseItem (true); case SWT.TRAVERSE_ARROW_PREVIOUS: return traverseItem (false); case SWT.TRAVERSE_MNEMONIC: return traverseMnemonic (event); case SWT.TRAVERSE_PAGE_NEXT: return traversePage (true); case SWT.TRAVERSE_PAGE_PREVIOUS: return traversePage (false); } return false; } boolean traverseEscape () { return false; } boolean traverseGroup (boolean next) { Control root = computeTabRoot (); Widget group = computeTabGroup (); Widget [] list = root.computeTabList (); int length = list.length; int index = 0; while (index < length) { if (list [index] == group) break; index++; } /* * It is possible (but unlikely), that application * code could have disposed the widget in focus in * or out events. Ensure that a disposed widget is * not accessed. */ if (index == length) return false; int start = index, offset = (next) ? 1 : -1; while ((index = ((index + offset + length) % length)) != start) { Widget widget = list [index]; if (!widget.isDisposed () && widget.setTabGroupFocus ()) { return true; } } if (group.isDisposed ()) return false; return group.setTabGroupFocus (); } boolean traverseItem (boolean next) { Control [] children = parent._getChildren (); int length = children.length; int index = 0; while (index < length) { if (children [index] == this) break; index++; } /* * It is possible (but unlikely), that application * code could have disposed the widget in focus in * or out events. Ensure that a disposed widget is * not accessed. */ if (index == length) return false; int start = index, offset = (next) ? 1 : -1; while ((index = (index + offset + length) % length) != start) { Control child = children [index]; if (!child.isDisposed () && child.isTabItem ()) { if (child.setTabItemFocus ()) return true; } } return false; } boolean traverseReturn () { return false; } boolean traversePage (boolean next) { return false; } boolean traverseMnemonic (Event event) { return false; } /** * Forces all outstanding paint requests for the widget * to be processed before this method returns. If there * are no outstanding paint request, this method does * nothing. *

    * Note: This method does not cause a redraw. *

    * * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    * * @see #redraw() * @see #redraw(int, int, int, int, boolean) * @see PaintListener * @see SWT#Paint */ public void update () { checkWidget(); update (false); } void update (boolean all) { // checkWidget(); if (display.isPainting.containsObject(view)) return; if (isResizing()) return; Shell shell = getShell(); NSWindow window = shell.deferFlushing && shell.scrolling ? view.window() : null; try { if (window != null) { window.retain(); window.disableFlushWindow(); } //TODO - not all view.displayIfNeeded (); } finally { if (window != null) { window.enableFlushWindow(); window.release(); } } } void updateBackgroundColor () { Control control = findBackgroundControl (); if (control == null) control = this; float /*double*/ [] color = control.background != null ? control.background : control.defaultBackground().handle; NSColor nsColor = NSColor.colorWithDeviceRed(color[0], color[1], color[2], color[3]); setBackgroundColor (nsColor); } void updateBackgroundImage () { Control control = findBackgroundControl (); Image image = control != null ? control.backgroundImage : backgroundImage; setBackgroundImage (image != null ? image.handle : null); } void updateBackgroundMode () { int oldState = state & PARENT_BACKGROUND; checkBackground (); if (oldState != (state & PARENT_BACKGROUND)) { setBackground (); } } void resetCursorRects (int /*long*/ id, int /*long*/ sel) { if (isEnabled ()) callSuper (id, sel); } void updateTrackingAreas (int /*long*/ id, int /*long*/ sel) { if (isEnabled ()) callSuper (id, sel); } void updateCursorRects (boolean enabled) { updateCursorRects (enabled, view); } void updateCursorRects (boolean enabled, NSView widget) { if (enabled) { widget.resetCursorRects (); widget.updateTrackingAreas (); } else { widget.discardCursorRects (); NSArray areas = widget.trackingAreas (); for (int i = 0; i < areas.count(); i++) { widget.removeTrackingArea (new NSTrackingArea (areas.objectAtIndex (i))); } } } void updateLayout (boolean all) { /* Do nothing */ } }