org.eclipse.swt.widgets.Shell Maven / Gradle / Ivy
/******************************************************************************* * Copyright (c) 2000, 2016 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 java.util.*; import org.eclipse.swt.*; import org.eclipse.swt.events.*; import org.eclipse.swt.graphics.*; import org.eclipse.swt.internal.cocoa.*; /** * Instances of this class represent the "windows" * which the desktop or "window manager" is managing. * Instances that do not have a parent (that is, they * are built using the constructor, which takes a *
if the platform does not support tool bars that * are not part of the content area of the shell, or if the Shell's style does not support * having a tool bar. *Display
as the argument) are described * as top level shells. Instances that do have * a parent are described as secondary or * dialog shells. ** Instances are always displayed in one of the maximized, * minimized or normal states: *
*
*- * When an instance is marked as maximized, the * window manager will typically resize it to fill the * entire visible area of the display, and the instance * is usually put in a state where it can not be resized * (even if it has style
RESIZE
) until it is * no longer maximized. *- * When an instance is in the normal state (neither * maximized or minimized), its appearance is controlled by * the style constants which were specified when it was created * and the restrictions of the window manager (see below). *
- * When an instance has been marked as minimized, * its contents (client area) will usually not be visible, * and depending on the window manager, it may be * "iconified" (that is, replaced on the desktop by a small * simplified representation of itself), relocated to a * distinguished area of the screen, or hidden. Combinations * of these changes are also possible. *
** The modality of an instance may be specified using * style bits. The modality style bits are used to determine * whether input is blocked for other shells on the display. * The
PRIMARY_MODAL
style allows an instance to block * input to its parent. TheAPPLICATION_MODAL
style * allows an instance to block input to every other shell in the * display. TheSYSTEM_MODAL
style allows an instance * to block input to all shells, including shells belonging to * different applications. ** Note: The styles supported by this class are treated * as HINTs, since the window manager for the * desktop on which the instance is visible has ultimate * control over the appearance and behavior of decorations * and modality. For example, some window managers only * support resizable windows and will always assume the * RESIZE style, even if it is not set. In addition, if a * modality style is not supported, it is "upgraded" to a * more restrictive modality style that is supported. For * example, if
PRIMARY_MODAL
is not supported, * it would be upgraded toAPPLICATION_MODAL
. * A modality style may also be "downgraded" to a less * restrictive style. For example, most operating systems * no longer supportSYSTEM_MODAL
because * it can freeze up the desktop, so this is typically * downgraded toAPPLICATION_MODAL
. **
* Class- Styles:
*- BORDER, CLOSE, MIN, MAX, NO_MOVE, NO_TRIM, RESIZE, TITLE, ON_TOP, TOOL, SHEET
*- APPLICATION_MODAL, MODELESS, PRIMARY_MODAL, SYSTEM_MODAL
*- Events:
*- Activate, Close, Deactivate, Deiconify, Iconify
*SWT
provides two "convenience constants" * for the most commonly required style combinations: **
* *- *
SHELL_TRIM
- * the result of combining the constants which are required * to produce a typical application top level shell: (that * is,
*CLOSE | TITLE | MIN | MAX | RESIZE
) *- *
DIALOG_TRIM
- * the result of combining the constants which are required * to produce a typical application dialog shell: (that * is,
*TITLE | CLOSE | BORDER
) ** Note: Only one of the styles APPLICATION_MODAL, MODELESS, * PRIMARY_MODAL and SYSTEM_MODAL may be specified. *
* IMPORTANT: This class is not intended to be subclassed. *
* * @see Decorations * @see SWT * @see Shell snippets * @see SWT Example: ControlExample * @see Sample code and further information * @noextend This class is not intended to be subclassed by clients. */ @SuppressWarnings({"rawtypes", "unchecked"}) public class Shell extends Decorations { NSWindow window; SWTWindowDelegate windowDelegate; long /*int*/ hostWindowClass; NSWindow hostWindow; long /*int*/ tooltipOwner, tooltipTag, tooltipUserData; int glContextCount; boolean opened, moved, resized, fullScreen, center, deferFlushing, scrolling, isPopup; Control lastActive; Rectangle normalBounds; boolean keyInputHappened; NSRect currentFrame; NSRect fullScreenFrame; ToolBar toolBar; Map windowEmbedCounts; MenuItem escMenuItem; static int DEFAULT_CLIENT_WIDTH = -1; static int DEFAULT_CLIENT_HEIGHT = -1; /** * Constructs a new instance of this class. This is equivalent * to callingShell((Display) null)
. * * @exception SWTException*
*/ public Shell () { this ((Display) null); } /** * Constructs a new instance of this class given only the style * value describing its behavior and appearance. This is equivalent * to calling- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
*- ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
*Shell((Display) null, style)
. ** The style value is either one of the style constants defined in * class
* * @param style the style of control to construct * * @exception SWTExceptionSWT
which is applicable to instances of this * class, or must be built by bitwise OR'ing together * (that is, using theint
"|" operator) two or more * of thoseSWT
style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. **
* * @see SWT#BORDER * @see SWT#CLOSE * @see SWT#MIN * @see SWT#MAX * @see SWT#RESIZE * @see SWT#TITLE * @see SWT#TOOL * @see SWT#NO_TRIM * @see SWT#NO_MOVE * @see SWT#SHELL_TRIM * @see SWT#DIALOG_TRIM * @see SWT#ON_TOP * @see SWT#MODELESS * @see SWT#PRIMARY_MODAL * @see SWT#APPLICATION_MODAL * @see SWT#SYSTEM_MODAL * @see SWT#SHEET */ public Shell (int style) { this ((Display) null, style); } /** * Constructs a new instance of this class given only the display * to create it on. It is created with style- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
*- ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
*SWT.SHELL_TRIM
. ** Note: Currently, null can be passed in for the display argument. * This has the effect of creating the shell on the currently active * display if there is one. If there is no current display, the * shell is created on a "default" display. Passing in null as * the display argument is not considered to be good coding style, * and may not be supported in a future release of SWT. *
* * @param display the display to create the shell on * * @exception SWTException*
*/ public Shell (Display display) { this (display, SWT.SHELL_TRIM); } /** * Constructs a new instance of this class given the display * to create it on and a style value describing its behavior * and appearance. *- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
*- ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
** 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 theint
"|" operator) two or more * of thoseSWT
style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. ** Note: Currently, null can be passed in for the display argument. * This has the effect of creating the shell on the currently active * display if there is one. If there is no current display, the * shell is created on a "default" display. Passing in null as * the display argument is not considered to be good coding style, * and may not be supported in a future release of SWT. *
* * @param display the display to create the shell on * @param style the style of control to construct * * @exception SWTException*
* * @see SWT#BORDER * @see SWT#CLOSE * @see SWT#MIN * @see SWT#MAX * @see SWT#RESIZE * @see SWT#TITLE * @see SWT#TOOL * @see SWT#NO_TRIM * @see SWT#NO_MOVE * @see SWT#SHELL_TRIM * @see SWT#DIALOG_TRIM * @see SWT#ON_TOP * @see SWT#MODELESS * @see SWT#PRIMARY_MODAL * @see SWT#APPLICATION_MODAL * @see SWT#SYSTEM_MODAL * @see SWT#SHEET */ public Shell (Display display, int style) { this (display, null, style, 0, false); } Shell (Display display, Shell parent, int style, long /*int*/handle, boolean embedded) { super (); checkSubclass (); if (display == null) display = Display.getCurrent (); if (display == null) display = Display.getDefault (); if (!display.isValidThread ()) { error (SWT.ERROR_THREAD_INVALID_ACCESS); } if (parent != null && parent.isDisposed ()) { error (SWT.ERROR_INVALID_ARGUMENT); } if (!Display.getSheetEnabled ()) { this.center = parent != null && (style & SWT.SHEET) != 0; } this.style = checkStyle (parent, style); this.parent = parent; this.display = display; if (handle != 0) { if (embedded) { view = new NSView(handle); } else { window = new NSWindow(handle); state |= FOREIGN_HANDLE; } } reskinWidget(); createWidget (); } /** * Constructs a new instance of this class given only its * parent. It is created with style- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
*- ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
*SWT.DIALOG_TRIM
. ** Note: Currently, null can be passed in for the parent. * This has the effect of creating the shell on the currently active * display if there is one. If there is no current display, the * shell is created on a "default" display. Passing in null as * the parent is not considered to be good coding style, * and may not be supported in a future release of SWT. *
* * @param parent a shell which will be the parent of the new instance * * @exception IllegalArgumentException*
* @exception SWTException- ERROR_INVALID_ARGUMENT - if the parent is disposed
**
*/ public Shell (Shell parent) { this (parent, SWT.DIALOG_TRIM); } /** * Constructs a new instance of this class given its parent * and a style value describing its behavior and appearance. *- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
*- ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
** 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 theint
"|" operator) two or more * of thoseSWT
style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. ** Note: Currently, null can be passed in for the parent. * This has the effect of creating the shell on the currently active * display if there is one. If there is no current display, the * shell is created on a "default" display. Passing in null as * the parent is not considered to be good coding style, * and may not be supported in a future release of SWT. *
* * @param parent a shell which will be the parent of the new instance * @param style the style of control to construct * * @exception IllegalArgumentException*
* @exception SWTException- ERROR_INVALID_ARGUMENT - if the parent is disposed
**
* * @see SWT#BORDER * @see SWT#CLOSE * @see SWT#MIN * @see SWT#MAX * @see SWT#RESIZE * @see SWT#TITLE * @see SWT#NO_TRIM * @see SWT#NO_MOVE * @see SWT#SHELL_TRIM * @see SWT#DIALOG_TRIM * @see SWT#ON_TOP * @see SWT#TOOL * @see SWT#MODELESS * @see SWT#PRIMARY_MODAL * @see SWT#APPLICATION_MODAL * @see SWT#SYSTEM_MODAL * @see SWT#SHEET */ public Shell (Shell parent, int style) { this (parent != null ? parent.display : null, parent, style, 0, false); } /** * Invokes platform specific functionality to allocate a new shell * that is not embedded. *- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
*- ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
** IMPORTANT: This method is not part of the public * API for
* * @param display the display for the shell * @param handle the handle for the shell * @return a new shell object containing the specified display and handle * * @noreference This method is not intended to be referenced by clients. * * @since 3.3 */ public static Shell internal_new (Display display, long /*int*/ handle) { return new Shell (display, null, SWT.NO_TRIM, handle, false); } /** * Invokes platform specific functionality to allocate a new shell * that is 'embedded'. In this case, the handle represents an NSView * that acts as an embedded SWT Shell in an AWT Canvas. *Shell
. 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. ** IMPORTANT: This method is not part of the public * API for
* * @param display the display for the shell * @param handle the handle for the shell * @return a new shell object containing the specified display and handle * * @noreference This method is not intended to be referenced by clients. * * @since 3.5 */ public static Shell cocoa_new (Display display, long /*int*/ handle) { return new Shell (display, null, SWT.NO_TRIM, handle, true); } static int checkStyle (Shell parent, int style) { style = Decorations.checkStyle (style); style &= ~SWT.TRANSPARENT; int mask = SWT.SYSTEM_MODAL | SWT.APPLICATION_MODAL | SWT.PRIMARY_MODAL; if ((style & SWT.SHEET) != 0) { if (Display.getSheetEnabled ()) { style &= ~(SWT.CLOSE | SWT.TITLE | SWT.MIN | SWT.MAX); if (parent == null) { style &= ~SWT.SHEET; style |= SWT.SHELL_TRIM; } } else { style &= ~SWT.SHEET; style |= parent == null ? SWT.SHELL_TRIM : SWT.DIALOG_TRIM; } if ((style & mask) == 0) { style |= parent == null ? SWT.APPLICATION_MODAL : SWT.PRIMARY_MODAL; } } int bits = style & ~mask; if ((style & SWT.SYSTEM_MODAL) != 0) return bits | SWT.SYSTEM_MODAL; if ((style & SWT.APPLICATION_MODAL) != 0) return bits | SWT.APPLICATION_MODAL; if ((style & SWT.PRIMARY_MODAL) != 0) return bits | SWT.PRIMARY_MODAL; return bits; } @Override boolean accessibilityIsIgnored(long /*int*/ id, long /*int*/ sel) { // The content view of a shell is always ignored. if (id == view.id) return true; return super.accessibilityIsIgnored(id, sel); } /** * Adds the listener to the collection of listeners who will * be notified when operations are performed on the receiver, * by sending the listener one of the messages defined in the *Shell
. 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. *ShellListener
interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException*
* @exception SWTException- ERROR_NULL_ARGUMENT - if the listener is null
**
* * @see ShellListener * @see #removeShellListener */ public void addShellListener(ShellListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener(SWT.Activate,typedListener); addListener(SWT.Close,typedListener); addListener(SWT.Deactivate,typedListener); addListener(SWT.Iconify,typedListener); addListener(SWT.Deiconify,typedListener); } void attachObserversToWindow(NSWindow newWindow) { if (newWindow == null || newWindow.id == 0) return; long /*int*/ newHostWindowClass = OS.object_getClass(newWindow.id); long /*int*/ sendEventImpl = OS.class_getMethodImplementation(newHostWindowClass, OS.sel_sendEvent_); if (sendEventImpl == Display.windowCallback3.getAddress()) return; hostWindow = newWindow; hostWindow.retain(); long /*int*/ embeddedSubclass = display.createWindowSubclass(newHostWindowClass, "SWTAWTWindow", true); OS.object_setClass(hostWindow.id, embeddedSubclass); display.addWidget (hostWindow, this); hostWindowClass = newHostWindowClass; if (windowEmbedCounts == null) windowEmbedCounts = new HashMap(); Integer embedCount = (Integer) windowEmbedCounts.get(hostWindow); if (embedCount == null) { embedCount = Integer.valueOf(0); } embedCount = Integer.valueOf(embedCount.intValue() + 1); windowEmbedCounts.put(hostWindow, embedCount); // Register for notifications. An embedded shell has no control over the host window, // so it isn't correct to install a delegate. NSNotificationCenter defaultCenter = NSNotificationCenter.defaultCenter(); defaultCenter.addObserver(windowDelegate, OS.sel_windowDidBecomeKey_, OS.NSWindowDidBecomeKeyNotification, hostWindow); defaultCenter.addObserver(windowDelegate, OS.sel_windowDidDeminiaturize_, OS.NSWindowDidDeminiaturizeNotification, hostWindow); defaultCenter.addObserver(windowDelegate, OS.sel_windowDidMiniaturize_, OS.NSWindowDidMiniaturizeNotification, hostWindow); defaultCenter.addObserver(windowDelegate, OS.sel_windowDidMove_, OS.NSWindowDidMoveNotification, hostWindow); defaultCenter.addObserver(windowDelegate, OS.sel_windowDidResize_, OS.NSWindowDidResizeNotification, hostWindow); defaultCenter.addObserver(windowDelegate, OS.sel_windowDidResignKey_, OS.NSWindowDidResignKeyNotification, hostWindow); defaultCenter.addObserver(windowDelegate, OS.sel_windowWillClose_, OS.NSWindowWillCloseNotification, hostWindow); } @Override void becomeKeyWindow (long /*int*/ id, long /*int*/ sel) { Shell modal = getModalShell(); if (modal != null && modal.window != null) { modal.window.makeKeyAndOrderFront(null); return; } Display display = this.display; display.keyWindow = view.window(); super.becomeKeyWindow(id, sel); display.checkFocus(); display.keyWindow = null; } @Override void bringToTop (boolean force) { if (getMinimized ()) return; if (force) { forceActive (); } else { setActive (); } } @Override boolean canBecomeKeyWindow (long /*int*/ id, long /*int*/ sel) { if (isPopup) return false; // Only answer if SWT created the window. if (window != null) { if ((style & SWT.NO_FOCUS) != 0) { NSEvent nsEvent = NSApplication.sharedApplication().currentEvent(); if (nsEvent != null && nsEvent.type() == OS.NSLeftMouseDown) { NSView contentView = window.contentView(); if (contentView != null) { NSView view = contentView.hitTest(nsEvent.locationInWindow()); if (view == contentView) return false; } } } long /*int*/ styleMask = window.styleMask(); if (styleMask == OS.NSBorderlessWindowMask || (styleMask & (OS.NSNonactivatingPanelMask | OS.NSDocModalWindowMask | OS.NSResizableWindowMask)) != 0) return true; } return super.canBecomeKeyWindow (id, sel); } @Override void checkOpen () { if (!opened) resized = false; } void center () { if (parent == null) return; Rectangle rect = getBounds (); Rectangle parentRect = display.map (parent, null, parent.getClientArea()); int x = Math.max (parentRect.x, parentRect.x + (parentRect.width - rect.width) / 2); int y = Math.max (parentRect.y, parentRect.y + (parentRect.height - rect.height) / 2); Rectangle monitorRect = parent.getMonitor ().getClientArea(); if (x + rect.width > monitorRect.x + monitorRect.width) { x = Math.max (monitorRect.x, monitorRect.x + monitorRect.width - rect.width); } else { x = Math.max (x, monitorRect.x); } if (y + rect.height > monitorRect.y + monitorRect.height) { y = Math.max (monitorRect.y, monitorRect.y + monitorRect.height - rect.height); } else { y = Math.max (y, monitorRect.y); } setLocation (x, y); } @Override void clearDeferFlushing (long /*int*/ id, long /*int*/ sel) { deferFlushing = false; scrolling = false; if (window != null) window.flushWindowIfNeeded(); } /** * Requests that the window manager close the receiver in * the same way it would be closed when the user clicks on * the "close box" or performs some other platform specific * key or mouse combination that indicates the window * should be removed. * * @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 SWT#Close * @see #dispose */ public void close () { checkWidget(); closeWidget (false); } void closeWidget (boolean force) { if (display.isDisposed()) return; Event event = new Event (); sendEvent (SWT.Close, event); if ((force || event.doit) && !isDisposed ()) dispose (); } @Override public Point computeSize (int wHint, int hHint, boolean changed) { Point size = super.computeSize (wHint, hHint, changed); if (toolBar != null) { if (wHint == SWT.DEFAULT && toolBar.itemCount > 0) { Point tbSize = toolBar.computeSize (SWT.DEFAULT, SWT.DEFAULT); size.x = Math.max (tbSize.x, size.x); } } return size; } @Override public Rectangle computeTrim (int x, int y, int width, int height) { checkWidget(); Rectangle trim = super.computeTrim(x, y, width, height); NSRect rect = new NSRect (); rect.x = trim.x; rect.y = trim.y; rect.width = trim.width; rect.height = trim.height; if (window != null) { if (!_getFullScreen() && !fixResize()) { double /*float*/ h = rect.height; rect = window.frameRectForContentRect(rect); rect.y += h-rect.height; } } return new Rectangle ((int)rect.x, (int)rect.y, (int)rect.width, (int)rect.height); } @Override void createHandle () { state |= HIDDEN; if (window == null && view == null) { int styleMask = OS.NSBorderlessWindowMask; if ((style & (SWT.TOOL | SWT.SHEET)) != 0) { window = (NSWindow) new SWTPanel().alloc(); if ((style & SWT.SHEET) != 0) { styleMask |= OS.NSDocModalWindowMask; } else { styleMask |= OS.NSUtilityWindowMask | OS.NSNonactivatingPanelMask; } } else { window = (NSWindow) new SWTWindow().alloc (); } if ((style & SWT.NO_TRIM) == 0) { if ((style & SWT.TITLE) != 0) styleMask |= OS.NSTitledWindowMask; if ((style & SWT.CLOSE) != 0) styleMask |= OS.NSClosableWindowMask; if ((style & SWT.MIN) != 0) styleMask |= OS.NSMiniaturizableWindowMask; if ((style & SWT.MAX) != 0) styleMask |= OS.NSResizableWindowMask; if ((style & SWT.RESIZE) != 0) styleMask |= OS.NSResizableWindowMask; } NSScreen screen = null; NSScreen primaryScreen = new NSScreen(NSScreen.screens().objectAtIndex(0)); if (parent != null) screen = parentWindow ().screen(); if (screen == null) screen = primaryScreen; window = window.initWithContentRect(new NSRect(), styleMask, OS.NSBackingStoreBuffered, (style & SWT.ON_TOP) != 0, screen); if ((style & (SWT.NO_TRIM | SWT.BORDER | SWT.SHELL_TRIM)) == 0 || (style & (SWT.TOOL | SWT.SHEET)) != 0) { window.setHasShadow (true); } if ((style & SWT.NO_MOVE) != 0 && (OS.VERSION_MMB >= OS.VERSION_MMB(10, 6, 0))) { window.setMovable(false); } if ((style & SWT.TOOL) != 0) { // Feature in Cocoa: NSPanels that use NSUtilityWindowMask are always promoted to the floating window layer. // Fix is to call setFloatingPanel:NO, which turns off this behavior. ((NSPanel)window).setFloatingPanel(false); // By default, panels hide on deactivation. ((NSPanel)window).setHidesOnDeactivate(false); // Normally a panel doesn't become key unless something inside it needs to be first responder. // TOOL shells always become key, so disable that behavior. ((NSPanel)window).setBecomesKeyOnlyIfNeeded(false); } window.setReleasedWhenClosed(true); if ((style & SWT.NO_TRIM) == 0) { NSSize size = window.minSize(); size.width = NSWindow.minFrameWidthWithTitle(NSString.string(), styleMask); window.setMinSize(size); } if (fixResize ()) { if (window.respondsToSelector(OS.sel_setMovable_)) { OS.objc_msgSend(window.id, OS.sel_setMovable_, 0); } } if (OS.VERSION_MMB >= OS.VERSION_MMB(10, 12, 0)) { /* * In macOS 10.12, a new system preference "prefer tabs when opening documents" * has been added which causes automatic tabbing of windows in Eclipse. * Disable automatic window tabbing, by setting the NSWindow.allowsAutomaticWindowTabbing * property to false. */ OS.objc_msgSend(OS.class_NSWindow, OS.sel_setAllowsAutomaticWindowTabbing_, false); } display.cascadeWindow(window, screen); NSRect screenFrame = screen.frame(); double /*float*/ width = screenFrame.width * 5 / 8, height = screenFrame.height * 5 / 8;; NSRect frame = window.frame(); NSRect primaryFrame = primaryScreen.frame(); frame.y = primaryFrame.height - ((primaryFrame.height - (frame.y + frame.height)) + height); frame.width = width; frame.height = height; window.setFrame(frame, false); if ((style & SWT.ON_TOP) != 0) { window.setLevel(OS.NSStatusWindowLevel); } super.createHandle (); topView ().setHidden (true); } else { state &= ~HIDDEN; if (window != null) { // In the FOREIGN_HANDLE case, 'window' is an NSWindow created on our behalf. // It may already have a content view, so if it does, grab and retain, since we release() // the view at disposal time. Otherwise, create a new 'view' that will be used as the window's // content view in setZOrder. view = window.contentView(); if (view == null) { super.createHandle(); } else { view.retain(); } } else { // In the embedded case, 'view' is already set to the NSView we should add the window's content view to as a subview. // In that case we will hold on to the foreign view, create our own SWTCanvasView (which overwrites 'view') and then // add it to the foreign view. NSView parentView = view; super.createHandle(); parentView.addSubview(topView()); } style |= SWT.NO_BACKGROUND; } windowDelegate = (SWTWindowDelegate)new SWTWindowDelegate().alloc().init(); if (window == null) { NSWindow hostWindow = view.window(); attachObserversToWindow(hostWindow); } else { int behavior = 0; if (parent != null) behavior |= OS.NSWindowCollectionBehaviorMoveToActiveSpace; if (OS.VERSION >= 0x1070) { if (parent == null) { if ((style & SWT.TOOL) != 0) { behavior = OS.NSWindowCollectionBehaviorFullScreenAuxiliary; } else { behavior = OS.NSWindowCollectionBehaviorFullScreenPrimary; } } } if (behavior != 0) window.setCollectionBehavior(behavior); window.setAcceptsMouseMovedEvents(true); window.setDelegate(windowDelegate); } if (OS.VERSION < 0x1060) { // Force a WindowRef to be created for this window so we can use // FindWindow() (see Display.findControl()) if (window != null) window.windowRef(); } NSWindow fieldEditorWindow = window; if (fieldEditorWindow == null) fieldEditorWindow = view.window(); id id = fieldEditorWindow.fieldEditor (true, null); if (id != null) { OS.object_setClass (id.id, OS.objc_getClass ("SWTEditorView")); new NSTextView(id).setAllowsUndo(true); } } void deferFlushing () { deferFlushing = true; view.performSelector(OS.sel_clearDeferFlushing, null, 0.0, display.runLoopModes()); } @Override void deregister () { super.deregister (); if (window != null) display.removeWidget (window); if (windowDelegate != null) display.removeWidget (windowDelegate); } @Override void destroyWidget () { NSWindow window = this.window; if (window != null) window.retain(); Display display = this.display; NSView view = topView(); if (view != null) view.retain(); boolean sheet = (style & (SWT.SHEET)) != 0; releaseHandle (); if (window != null) { if (sheet) { NSApplication application = NSApplication.sharedApplication(); application.endSheet(window, 0); } window.close(); } else if (view != null) { view.removeFromSuperview(); } if (view != null) view.release(); // If another shell is not going to become active, clear the menu bar. // Don't modify the menu bar if we are an embedded Shell, though. if (window != null) { if (!display.isDisposed () && display.getShells ().length == 0) { display.setMenuBar (null); } window.release(); } } @Override void drawBackground (long /*int*/ id, NSGraphicsContext context, NSRect rect) { if (id != view.id) return; if (regionPath != null && background == null) { context.saveGraphicsState(); NSColor.windowBackgroundColor().setFill(); NSBezierPath.fillRect(rect); context.restoreGraphicsState(); return; } super.drawBackground (id, context, rect); } @Override Control findBackgroundControl () { return background != null || backgroundImage != null ? this : null; } @Override Composite findDeferredControl () { return layoutCount > 0 ? this : null; } @Override Cursor findCursor () { return cursor; } boolean fixResize () { /* * Feature in Cocoa. It is not possible to have a resizable window * without the title bar. The fix is to resize the content view on * top of the title bar. * * Never do this when the shell is embedded, because the window belongs to the AWT. */ if (window == null) return false; if ((style & SWT.NO_TRIM) == 0) { if ((style & SWT.RESIZE) != 0 && (style & (SWT.SHEET | SWT.TITLE | SWT.CLOSE | SWT.MIN | SWT.MAX)) == 0) { return true; } } return false; } void fixShell (Shell newShell, Control control) { if (this == newShell) return; if (control == lastActive) setActiveControl (null); } /** * If the receiver is visible, moves it to the top of the * drawing order for the display on which it was created * (so that all other shells on that display, which are not * the receiver's children will be drawn behind it) and forces * the window manager to make the shell active. * * @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.0 * @see Control#moveAbove * @see Control#setFocus * @see Control#setVisible * @see Display#getActiveShell * @see Decorations#setDefaultButton(Button) * @see Shell#open * @see Shell#setActive */ public void forceActive () { checkWidget (); if (!isVisible()) return; if (window == null) return; makeKeyAndOrderFront (); NSApplication application = NSApplication.sharedApplication (); application.activateIgnoringOtherApps (true); } /** * Returns the receiver's alpha value. The alpha value * is between 0 (transparent) and 255 (opaque). * * @return the alpha value * * @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 int getAlpha () { checkWidget (); if (window == null) return 255; return (int)(window.alphaValue() * 255); } @Override public Rectangle getBounds () { checkWidget(); if (window != null) { NSRect frame = window.frame(); double /*float*/ y = display.getPrimaryFrame().height - (int)(frame.y + frame.height); return new Rectangle ((int)frame.x, (int)y, (int)frame.width, (int)frame.height); } else { NSRect frame = view.frame(); // Start from view's origin, (0, 0) NSPoint pt = new NSPoint(); NSRect primaryFrame = display.getPrimaryFrame(); if (!view.isFlipped ()) { pt.y = view.bounds().height - pt.y; } pt = view.convertPoint_toView_(pt, null); pt = view.window().convertBaseToScreen(pt); pt.y = primaryFrame.height - pt.y; return new Rectangle((int)pt.x, (int)pt.y, (int)frame.width, (int)frame.height); } } @Override public Rectangle getClientArea () { checkWidget(); NSRect rect; if (window != null) { if (!fixResize ()) { rect = window.contentView().frame(); } else { rect = window.frame(); } } else { rect = topView().frame(); } int width = (int)rect.width, height = (int)rect.height; if (scrollView != null) { NSSize size = new NSSize(); size.width = width; size.height = height; size = NSScrollView.contentSizeForFrameSize(size, (style & SWT.H_SCROLL) != 0, (style & SWT.V_SCROLL) != 0, OS.NSNoBorder); width = (int)size.width; height = (int)size.height; } return new Rectangle (0, 0, width, height); } /** * Returns- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
*- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*true
if the receiver is currently * in fullscreen state, and false otherwise. ** * @return the fullscreen state * * @exception SWTException
*
* * @since 3.4 */ public boolean getFullScreen () { checkWidget(); return _getFullScreen (); } boolean _getFullScreen () { if ((window.collectionBehavior() & OS.NSWindowCollectionBehaviorFullScreenPrimary) != 0) { return (window.styleMask() & OS.NSFullScreenWindowMask) != 0 ? true : false; } return fullScreen; } /** * Returns the receiver's input method editor mode. This * will be the result of bitwise OR'ing together one or * more of the following constants defined in class *- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
*- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*SWT
: *NONE
,ROMAN
,DBCS
, *PHONETIC
,NATIVE
,ALPHA
. * * @return the IME mode * * @exception SWTException*
* * @see SWT */ public int getImeInputMode () { checkWidget(); return SWT.NONE; } @Override public Point getLocation () { checkWidget(); if (window != null) { NSRect frame = window.frame(); double /*float*/ y = display.getPrimaryFrame().height - (int)(frame.y + frame.height); return new Point ((int)frame.x, (int)y); } else { // Start from view's origin, (0, 0) NSPoint pt = new NSPoint(); NSRect primaryFrame = display.getPrimaryFrame(); if (!view.isFlipped ()) { pt.y = view.bounds().height - pt.y; } pt = view.convertPoint_toView_(pt, null); pt = view.window().convertBaseToScreen(pt); pt.y = primaryFrame.height - pt.y; return new Point((int)pt.x, (int)pt.y); } } @Override public boolean getMaximized () { checkWidget(); if (window == null) return false; return !_getFullScreen() && window.isZoomed(); } Shell getModalShell () { Shell shell = null; Shell [] modalShells = display.modalShells; if (modalShells != null) { int bits = SWT.APPLICATION_MODAL | SWT.SYSTEM_MODAL; int index = modalShells.length; while (--index >= 0) { Shell modal = modalShells [index]; if (modal != null) { if ((modal.style & bits) != 0) { Control control = this; while (control != null) { if (control == modal) break; control = control.parent; } if (control != modal) return modal; break; } if ((modal.style & SWT.PRIMARY_MODAL) != 0) { if (shell == null) shell = getShell (); if (modal.parent == shell) return modal; } } } } return null; } /** * Gets the receiver's modified state. * * @return- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
*- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*true
if the receiver is marked as modified, orfalse
otherwise * * @exception SWTException*
* * @since 3.5 */ public boolean getModified () { checkWidget (); return window.isDocumentEdited (); } @Override public boolean getMinimized () { checkWidget(); if (!getVisible ()) return super.getMinimized (); if (window == null) return false; return window.isMiniaturized(); } /** * Returns a point describing the minimum receiver's size. The * x coordinate of the result is the minimum width of the receiver. * The y coordinate of the result is the minimum height of the * receiver. * * @return the receiver's size * * @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.1 */ public Point getMinimumSize () { checkWidget(); if (window == null) return new Point(0, 0); NSSize size = window.minSize(); return new Point((int)size.width, (int)size.height); } /** * Returns the region that defines the shape of the shell, * or- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
*- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*null
if the shell has the default shape. * * @return the region that defines the shape of the shell, ornull
* * @exception SWTException*
* * @since 3.0 * */ @Override public Region getRegion () { /* This method is needed for the @since 3.0 Javadoc */ checkWidget (); return region; } @Override public Shell getShell () { checkWidget(); return this; } /** * Returns an array containing all shells which are * descendants of the receiver. *- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
*- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
** @return the dialog shells * * @exception SWTException
*
*/ public Shell [] getShells () { checkWidget(); int count = 0; Shell [] shells = display.getShells (); for (int i=0; i- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
*- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*null * * @return a ToolBar object representing the Shell's tool bar, 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 *
-
*
- ERROR_WIDGET_DISPOSED - if the receiver has been disposed *
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver *
-
*
- ERROR_WIDGET_DISPOSED - if the receiver has been disposed *
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver *
* This operation requires the operating system's advanced * widgets subsystem which may not be available on some * platforms. *
* @param alpha the alpha value * * @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 *
true
causes the receiver
* to switch to the full screen state, and if the argument is
* false
and the receiver was previously switched
* into full screen state, causes the receiver to switch back
* to either the maximized or normal states.
*
* Note: The result of intermixing calls to setFullScreen(true)
,
* setMaximized(true)
and setMinimized(true)
will
* vary by platform. Typically, the behavior will match the platform user's
* expectations, but not always. This should be avoided if possible.
*
-
*
- ERROR_WIDGET_DISPOSED - if the receiver has been disposed *
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver *
SWT
:
* NONE
, ROMAN
, DBCS
,
* PHONETIC
, NATIVE
, ALPHA
.
*
* @param mode the new IME mode
*
* @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 *
-
*
- ERROR_WIDGET_DISPOSED - if the receiver has been disposed *
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver *
-
*
- ERROR_NULL_ARGUMENT - if the point is null *
-
*
- ERROR_WIDGET_DISPOSED - if the receiver has been disposed *
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver *
-
*
- ERROR_WIDGET_DISPOSED - if the receiver has been disposed *
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver *
* NOTE: This method also sets the size of the shell. Clients should * not call {@link #setSize} or {@link #setBounds} on this shell. * Furthermore, the passed region should not be modified any more. *
* * @param region the region that defines the shape of the shell (or null) * * @exception IllegalArgumentException-
*
- ERROR_INVALID_ARGUMENT - if the region has been disposed *
-
*
- ERROR_WIDGET_DISPOSED - if the receiver has been disposed *
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver *