/*******************************************************************************
* Copyright (c) 2000, 2005 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.swt.widgets;
import org.eclipse.swt.internal.*;
import org.eclipse.swt.internal.win32.*;
import org.eclipse.swt.*;
import org.eclipse.swt.graphics.*;
/**
* Instances of this class are responsible for managing the
* connection between SWT and the underlying operating
* system. Their most important function is to implement
* the SWT event loop in terms of the platform event model.
* They also provide various methods for accessing information
* about the operating system, and have overall control over
* the operating system resources which SWT allocates.
*
* Applications which are built with SWT will almost always
* require only a single display. In particular, some platforms
* which SWT supports will not allow more than one active
* display. In other words, some platforms do not support
* creating a new display if one already exists that has not been
* sent the dispose()
message.
*
* In SWT, the thread which creates a Display
* instance is distinguished as the user-interface thread
* for that display.
*
* The user-interface thread for a particular display has the
* following special attributes:
*
* -
* The event loop for that display must be run from the thread.
*
* -
* Some SWT API methods (notably, most of the public methods in
*
Widget
and its subclasses), may only be called
* from the thread. (To support multi-threaded user-interface
* applications, class Display
provides inter-thread
* communication methods which allow threads other than the
* user-interface thread to request that it perform operations
* on their behalf.)
*
* -
* The thread is not allowed to construct other
*
Display
s until that display has been disposed.
* (Note that, this is in addition to the restriction mentioned
* above concerning platform support for multiple displays. Thus,
* the only way to have multiple simultaneously active displays,
* even on platforms which support it, is to have multiple threads.)
*
*
* Enforcing these attributes allows SWT to be implemented directly
* on the underlying operating system's event model. This has
* numerous benefits including smaller footprint, better use of
* resources, safer memory management, clearer program logic,
* better performance, and fewer overall operating system threads
* required. The down side however, is that care must be taken
* (only) when constructing multi-threaded applications to use the
* inter-thread communication mechanisms which this class provides
* when required.
*
* All SWT API methods which may only be called from the user-interface
* thread are distinguished in their documentation by indicating that
* they throw the "ERROR_THREAD_INVALID_ACCESS
"
* SWT exception.
*
*
* - Styles:
* - (none)
* - Events:
* - Close, Dispose
*
*
* IMPORTANT: This class is not intended to be subclassed.
*
* @see #syncExec
* @see #asyncExec
* @see #wake
* @see #readAndDispatch
* @see #sleep
* @see Device#dispose
*/
public class Display extends Device {
/**
* the handle to the OS message queue
* (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.
*
*/
public MSG msg = new MSG ();
/* Windows and Events */
Event [] eventQueue;
Callback windowCallback;
int windowProc, threadId;
TCHAR windowClass, windowShadowClass;
static int WindowClassCount;
static final String WindowName = "SWT_Window"; //$NON-NLS-1$
static final String WindowShadowName = "SWT_WindowShadow"; //$NON-NLS-1$
EventTable eventTable, filterTable;
/* Widget Table */
int freeSlot;
int [] indexTable;
Control [] controlTable;
static final int GROW_SIZE = 1024;
static final int SWT_OBJECT_INDEX;
static final boolean USE_PROPERTY = !OS.IsWinCE;
static {
if (USE_PROPERTY) {
SWT_OBJECT_INDEX = OS.GlobalAddAtom (new TCHAR (0, "SWT_OBJECT_INDEX", true)); //$NON-NLS-1$
} else {
SWT_OBJECT_INDEX = 0;
}
}
/* Focus */
int focusEvent;
Control focusControl;
/* Menus */
Menu [] bars, popups;
MenuItem [] items;
/*
* The start value for WM_COMMAND id's.
* Windows reserves the values 0..100.
*
* The SmartPhone SWT resource file reserves
* the values 101..107.
*/
static final int ID_START = 108;
/* Filter Hook */
Callback msgFilterCallback;
int msgFilterProc, filterHook;
MSG hookMsg = new MSG ();
boolean ignoreMsgFilter;
/* Idle Hook */
Callback foregroundIdleCallback;
int foregroundIdleProc, idleHook;
/* Message Hook and Embedding */
Callback getMsgCallback, embeddedCallback;
int getMsgProc, msgHook, embeddedHwnd, embeddedProc;
static final String AWT_WINDOW_CLASS = "SunAwtWindow";
/* Sync/Async Widget Communication */
Synchronizer synchronizer = new Synchronizer (this);
Thread thread;
/* Display Shutdown */
Runnable [] disposeList;
/* System Tray */
Tray tray;
int nextTrayId = 0;
/* Timers */
int [] timerIds;
Runnable [] timerList;
int nextTimerId;
/* Keyboard and Mouse State */
int lastKey, lastAscii, lastMouse;
boolean lastVirtual, lastNull, lastDead;
byte [] keyboard = new byte [256];
boolean accelKeyHit, mnemonicKeyHit;
boolean lockActiveWindow;
/* MDI */
boolean ignoreRestoreFocus;
Control lastHittestControl;
int lastHittest;
/* Message Only Window */
Callback messageCallback;
int hwndMessage, messageProc;
int [] systemFonts;
/* System Images Cache */
int errorIcon, infoIcon, questionIcon, warningIcon;
/* System Cursors Cache */
Cursor [] cursors = new Cursor [SWT.CURSOR_HAND + 1];
/* ImageList Cache */
ImageList[] imageList, toolImageList, toolHotImageList, toolDisabledImageList;
/* Custom Colors for ChooseColor */
int lpCustColors;
/* Display Data */
Object data;
String [] keys;
Object [] values;
/* Key Mappings */
static final int [] [] KeyTable = {
/* Keyboard and Mouse Masks */
{OS.VK_MENU, SWT.ALT},
{OS.VK_SHIFT, SWT.SHIFT},
{OS.VK_CONTROL, SWT.CONTROL},
// {OS.VK_????, SWT.COMMAND},
/* NOT CURRENTLY USED */
// {OS.VK_LBUTTON, SWT.BUTTON1},
// {OS.VK_MBUTTON, SWT.BUTTON3},
// {OS.VK_RBUTTON, SWT.BUTTON2},
/* Non-Numeric Keypad Keys */
{OS.VK_UP, SWT.ARROW_UP},
{OS.VK_DOWN, SWT.ARROW_DOWN},
{OS.VK_LEFT, SWT.ARROW_LEFT},
{OS.VK_RIGHT, SWT.ARROW_RIGHT},
{OS.VK_PRIOR, SWT.PAGE_UP},
{OS.VK_NEXT, SWT.PAGE_DOWN},
{OS.VK_HOME, SWT.HOME},
{OS.VK_END, SWT.END},
{OS.VK_INSERT, SWT.INSERT},
/* Virtual and Ascii Keys */
{OS.VK_BACK, SWT.BS},
{OS.VK_RETURN, SWT.CR},
{OS.VK_DELETE, SWT.DEL},
{OS.VK_ESCAPE, SWT.ESC},
{OS.VK_RETURN, SWT.LF},
{OS.VK_TAB, SWT.TAB},
/* Functions Keys */
{OS.VK_F1, SWT.F1},
{OS.VK_F2, SWT.F2},
{OS.VK_F3, SWT.F3},
{OS.VK_F4, SWT.F4},
{OS.VK_F5, SWT.F5},
{OS.VK_F6, SWT.F6},
{OS.VK_F7, SWT.F7},
{OS.VK_F8, SWT.F8},
{OS.VK_F9, SWT.F9},
{OS.VK_F10, SWT.F10},
{OS.VK_F11, SWT.F11},
{OS.VK_F12, SWT.F12},
{OS.VK_F13, SWT.F13},
{OS.VK_F14, SWT.F14},
{OS.VK_F15, SWT.F15},
/* Numeric Keypad Keys */
{OS.VK_MULTIPLY, SWT.KEYPAD_MULTIPLY},
{OS.VK_ADD, SWT.KEYPAD_ADD},
{OS.VK_RETURN, SWT.KEYPAD_CR},
{OS.VK_SUBTRACT, SWT.KEYPAD_SUBTRACT},
{OS.VK_DECIMAL, SWT.KEYPAD_DECIMAL},
{OS.VK_DIVIDE, SWT.KEYPAD_DIVIDE},
{OS.VK_NUMPAD0, SWT.KEYPAD_0},
{OS.VK_NUMPAD1, SWT.KEYPAD_1},
{OS.VK_NUMPAD2, SWT.KEYPAD_2},
{OS.VK_NUMPAD3, SWT.KEYPAD_3},
{OS.VK_NUMPAD4, SWT.KEYPAD_4},
{OS.VK_NUMPAD5, SWT.KEYPAD_5},
{OS.VK_NUMPAD6, SWT.KEYPAD_6},
{OS.VK_NUMPAD7, SWT.KEYPAD_7},
{OS.VK_NUMPAD8, SWT.KEYPAD_8},
{OS.VK_NUMPAD9, SWT.KEYPAD_9},
// {OS.VK_????, SWT.KEYPAD_EQUAL},
/* Other keys */
{OS.VK_CAPITAL, SWT.CAPS_LOCK},
{OS.VK_NUMLOCK, SWT.NUM_LOCK},
{OS.VK_SCROLL, SWT.SCROLL_LOCK},
{OS.VK_PAUSE, SWT.PAUSE},
{OS.VK_CANCEL, SWT.BREAK},
{OS.VK_SNAPSHOT, SWT.PRINT_SCREEN},
// {OS.VK_????, SWT.HELP},
};
/* Multiple Displays */
static Display Default;
static Display [] Displays = new Display [4];
/* Multiple Monitors */
static Monitor[] monitors = null;
static int monitorCount = 0;
/* Modality */
Shell [] modalShells;
Shell modalDialogShell;
static boolean TrimEnabled = false;
/* Private SWT Window Messages */
static final int SWT_GETACCELCOUNT = OS.WM_APP;
static final int SWT_GETACCEL = OS.WM_APP + 1;
static final int SWT_KEYMSG = OS.WM_APP + 2;
static final int SWT_DESTROY = OS.WM_APP + 3;
static final int SWT_RESIZE = OS.WM_APP + 4;
static final int SWT_TRAYICONMSG = OS.WM_APP + 5;
static int SWT_TASKBARCREATED;
/* Package Name */
static final String PACKAGE_PREFIX = "org.eclipse.swt.widgets."; //$NON-NLS-1$
/*
* This code is intentionally commented. In order
* to support CLDC, .class cannot be used because
* it does not compile on some Java compilers when
* they are targeted for CLDC.
*/
// static {
// String name = Display.class.getName ();
// int index = name.lastIndexOf ('.');
// PACKAGE_PREFIX = name.substring (0, index + 1);
// }
/*
* TEMPORARY CODE. Install the runnable that
* gets the current display. This code will
* be removed in the future.
*/
static {
DeviceFinder = new Runnable () {
public void run () {
Device device = getCurrent ();
if (device == null) {
device = getDefault ();
}
setDevice (device);
}
};
}
/*
* TEMPORARY CODE.
*/
static void setDevice (Device device) {
CurrentDevice = device;
}
/**
* Constructs a new instance of this class.
*
* Note: The resulting display is marked as the current
* display. If this is the first display which has been
* constructed since the application started, it is also
* marked as the default display.
*
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
* - ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
*
*
* @see #getCurrent
* @see #getDefault
* @see Widget#checkSubclass
* @see Shell
*/
public Display () {
this (null);
}
public Display (DeviceData data) {
super (data);
}
Control _getFocusControl () {
return findControl (OS.GetFocus ());
}
void addBar (Menu menu) {
if (bars == null) bars = new Menu [4];
int length = bars.length;
for (int i=0; ihandleEvent() message.
*
* Setting the type of an event to SWT.None
from
* within the handleEvent()
method can be used to
* change the event type and stop subsequent Java listeners
* from running. Because event filters run before other listeners,
* event filters can both block other listeners and set arbitrary
* fields within an event. For this reason, event filters are both
* powerful and dangerous. They should generally be avoided for
* performance, debugging and code maintenance reasons.
*
*
* @param eventType the type of event to listen for
* @param listener the listener which should be notified when the event occurs
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see Listener
* @see #removeFilter
* @see #removeListener
*
* @since 3.0
*/
public void addFilter (int eventType, Listener listener) {
checkDevice ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
if (filterTable == null) filterTable = new EventTable ();
filterTable.hook (eventType, listener);
}
/**
* Adds the listener to the collection of listeners who will
* be notifed when an event of the given type occurs. When the
* event does occur in the display, the listener is notified by
* sending it the handleEvent()
message.
*
* @param eventType the type of event to listen for
* @param listener the listener which should be notified when the event occurs
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see Listener
* @see #removeListener
*
* @since 2.0
*/
public void addListener (int eventType, Listener listener) {
checkDevice ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
if (eventTable == null) eventTable = new EventTable ();
eventTable.hook (eventType, listener);
}
void addMenuItem (MenuItem item) {
if (items == null) items = new MenuItem [64];
for (int i=0; irun() method of the runnable to
* be invoked by the user-interface thread at the next
* reasonable opportunity. The caller of this method continues
* to run in parallel, and is not notified when the
* runnable has completed.
*
* @param runnable code to run on the user-interface thread.
*
* @exception SWTException
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #syncExec
*/
public void asyncExec (Runnable runnable) {
if (isDisposed ()) error (SWT.ERROR_DEVICE_DISPOSED);
synchronizer.asyncExec (runnable);
}
/**
* Causes the system hardware to emit a short sound
* (if it supports this capability).
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public void beep () {
checkDevice ();
OS.MessageBeep (OS.MB_OK);
}
/**
* Checks that this class can be subclassed.
*
* IMPORTANT: See the comment in Widget.checkSubclass()
.
*
*
* @exception SWTException
* - ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
*
*
* @see Widget#checkSubclass
*/
protected void checkSubclass () {
if (!isValidClass (getClass ())) error (SWT.ERROR_INVALID_SUBCLASS);
}
protected void checkDevice () {
if (thread == null) error (SWT.ERROR_WIDGET_DISPOSED);
if (thread != Thread.currentThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
if (isDisposed ()) error (SWT.ERROR_DEVICE_DISPOSED);
}
static synchronized void checkDisplay (Thread thread) {
for (int i=0; i
* ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see Device#dispose
*
* @since 2.0
*/
public void close () {
checkDevice ();
Event event = new Event ();
sendEvent (SWT.Close, event);
if (event.doit) dispose ();
}
/**
* Creates the device in the operating system. If the device
* does not have a handle, this method may do nothing depending
* on the device.
*
* This method is called before init
.
*
*
* @param data the DeviceData which describes the receiver
*
* @see #init
*/
protected void create (DeviceData data) {
checkSubclass ();
checkDisplay (thread = Thread.currentThread ());
createDisplay (data);
register (this);
if (Default == null) Default = this;
}
void createDisplay (DeviceData data) {
}
static synchronized void deregister (Display display) {
for (int i=0; i
* This method is called after release
.
*
* @see #dispose
* @see #release
*/
protected void destroy () {
if (this == Default) Default = null;
deregister (this);
destroyDisplay ();
}
void destroyDisplay () {
}
/**
* Causes the run()
method of the runnable to
* be invoked by the user-interface thread just before the
* receiver is disposed.
*
* @param runnable code to run at dispose time.
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public void disposeExec (Runnable runnable) {
checkDevice ();
if (disposeList == null) disposeList = new Runnable [4];
for (int i=0; i> 16, flags);
break;
}
}
return OS.DefWindowProc (hwnd, msg, wParam, lParam);
}
/**
* Does whatever display specific cleanup is required, and then
* uses the code in SWTError.error
to handle the error.
*
* @param code the descriptive error code
*
* @see SWTError#error
*/
void error (int code) {
SWT.error (code);
}
boolean filterEvent (Event event) {
if (filterTable != null) filterTable.sendEvent (event);
return false;
}
boolean filters (int eventType) {
if (filterTable == null) return false;
return filterTable.hooks (eventType);
}
boolean filterMessage (MSG msg) {
int message = msg.message;
if (OS.WM_KEYFIRST <= message && message <= OS.WM_KEYLAST) {
Control control = findControl (msg.hwnd);
if (control != null) {
if (translateAccelerator (msg, control) || translateMnemonic (msg, control) || translateTraversal (msg, control)) {
lastAscii = lastKey = 0;
lastVirtual = lastNull = lastDead = false;
return true;
}
}
}
return false;
}
Control findControl (int handle) {
if (handle == 0) return null;
do {
Control control = getControl (handle);
if (control != null) return control;
} while ((handle = OS.GetParent (handle)) != 0);
return null;
}
/**
* Given the operating system handle for a widget, returns
* the instance of the Widget
subclass which
* represents it in the currently running application, if
* such exists, or null if no matching widget can be found.
*
* IMPORTANT: This method should not be called from
* application code. The arguments are platform-specific.
*
*
* @param handle the handle for the widget
* @return the SWT widget that the handle represents
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Widget findWidget (int handle) {
checkDevice ();
return getControl (handle);
}
/**
* Given the operating system handle for a widget,
* and widget-specific id, returns the instance of
* the Widget
subclass which represents
* the handle/id pair in the currently running application,
* if such exists, or null if no matching widget can be found.
*
* IMPORTANT: This method should not be called from
* application code. The arguments are platform-specific.
*
*
* @param handle the handle for the widget
* @param id the id for the subwidget (usually an item)
* @return the SWT widget that the handle/id pair represents
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 3.1
*/
public Widget findWidget (int handle, int id) {
Control control = getControl (handle);
return control != null ? control.findItem (id) : null;
}
int foregroundIdleProc (int code, int wParam, int lParam) {
if (code >= 0) {
if (getMessageCount () > 0) wakeThread ();
}
return OS.CallNextHookEx (idleHook, code, wParam, lParam);
}
/**
* Returns the display which the given thread is the
* user-interface thread for, or null if the given thread
* is not a user-interface thread for any display.
*
* @param thread the user-interface thread
* @return the display for the given thread
*/
public static synchronized Display findDisplay (Thread thread) {
for (int i=0; iShell, or null
* if no shell belonging to the currently running application
* is active.
*
* @return the active shell or null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Shell getActiveShell () {
checkDevice ();
Control control = findControl (OS.GetActiveWindow ());
return control != null ? control.getShell () : null;
}
/**
* Returns a rectangle describing the receiver's size and location.
*
* @return the bounding rectangle
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Rectangle getBounds () {
checkDevice ();
if (OS.GetSystemMetrics (OS.SM_CMONITORS) < 2) {
int width = OS.GetSystemMetrics (OS.SM_CXSCREEN);
int height = OS.GetSystemMetrics (OS.SM_CYSCREEN);
return new Rectangle (0, 0, width, height);
}
int x = OS.GetSystemMetrics (OS.SM_XVIRTUALSCREEN);
int y = OS.GetSystemMetrics (OS.SM_YVIRTUALSCREEN);
int width = OS.GetSystemMetrics (OS.SM_CXVIRTUALSCREEN);
int height = OS.GetSystemMetrics (OS.SM_CYVIRTUALSCREEN);
return new Rectangle (x, y, width, height);
}
/**
* Returns the display which the currently running thread is
* the user-interface thread for, or null if the currently
* running thread is not a user-interface thread for any display.
*
* @return the current display
*/
public static synchronized Display getCurrent () {
return findDisplay (Thread.currentThread ());
}
/**
* Returns a rectangle which describes the area of the
* receiver which is capable of displaying data.
*
* @return the client area
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #getBounds
*/
public Rectangle getClientArea () {
checkDevice ();
if (OS.GetSystemMetrics (OS.SM_CMONITORS) < 2) {
RECT rect = new RECT ();
OS.SystemParametersInfo (OS.SPI_GETWORKAREA, 0, rect, 0);
int width = rect.right - rect.left;
int height = rect.bottom - rect.top;
return new Rectangle (rect.left, rect.top, width, height);
}
int x = OS.GetSystemMetrics (OS.SM_XVIRTUALSCREEN);
int y = OS.GetSystemMetrics (OS.SM_YVIRTUALSCREEN);
int width = OS.GetSystemMetrics (OS.SM_CXVIRTUALSCREEN);
int height = OS.GetSystemMetrics (OS.SM_CYVIRTUALSCREEN);
return new Rectangle (x, y, width, height);
}
Control getControl (int handle) {
if (handle == 0) return null;
int index;
if (USE_PROPERTY) {
index = OS.GetProp (handle, SWT_OBJECT_INDEX) - 1;
} else {
index = OS.GetWindowLong (handle, OS.GWL_USERDATA) - 1;
}
if (0 <= index && index < controlTable.length) {
Control control = controlTable [index];
/*
* Because GWL_USERDATA can be used by native widgets that
* do not belong to SWT, it is possible that GWL_USERDATA
* could return an index that is in the range of the table,
* but was not put there by SWT. Therefore, it is necessary
* to check the handle of the control that is in the table
* against the handle that provided the GWL_USERDATA.
*/
if (control != null && control.checkHandle (handle)) {
return control;
}
}
return null;
}
/**
* Returns the control which the on-screen pointer is currently
* over top of, or null if it is not currently over one of the
* controls built by the currently running application.
*
* @return the control under the cursor
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Control getCursorControl () {
checkDevice ();
POINT pt = new POINT ();
if (!OS.GetCursorPos (pt)) return null;
return findControl (OS.WindowFromPoint (pt));
}
/**
* Returns the location of the on-screen pointer relative
* to the top left corner of the screen.
*
* @return the cursor location
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Point getCursorLocation () {
checkDevice ();
POINT pt = new POINT ();
OS.GetCursorPos (pt);
return new Point (pt.x, pt.y);
}
/**
* Returns an array containing the recommended cursor sizes.
*
* @return the array of cursor sizes
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 3.0
*/
public Point [] getCursorSizes () {
checkDevice ();
return new Point [] {
new Point (OS.GetSystemMetrics (OS.SM_CXCURSOR), OS.GetSystemMetrics (OS.SM_CYCURSOR))};
}
/**
* Returns the default display. One is created (making the
* thread that invokes this method its user-interface thread)
* if it did not already exist.
*
* @return the default display
*/
public static synchronized Display getDefault () {
if (Default == null) Default = new Display ();
return Default;
}
static boolean isValidClass (Class clazz) {
String name = clazz.getName ();
int index = name.lastIndexOf ('.');
return name.substring (0, index + 1).equals (PACKAGE_PREFIX);
}
/**
* Returns the application defined property of the receiver
* with the specified name, or null if it has not been set.
*
* Applications may have associated arbitrary objects with the
* receiver in this fashion. If the objects stored in the
* properties need to be notified when the display is disposed
* of, it is the application's responsibility provide a
* disposeExec()
handler which does so.
*
*
* @param key the name of the property
* @return the value of the property or null if it has not been set
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the key is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #setData(String, Object)
* @see #disposeExec(Runnable)
*/
public Object getData (String key) {
checkDevice ();
if (key == null) error (SWT.ERROR_NULL_ARGUMENT);
if (keys == null) return null;
for (int i=0; idisplay specific data is a single,
* unnamed field that is stored with every display.
*
* Applications may put arbitrary objects in this field. If
* the object stored in the display specific data needs to
* be notified when the display is disposed of, it is the
* application's responsibility provide a
* disposeExec()
handler which does so.
*
*
* @return the display specific data
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #setData(Object)
* @see #disposeExec(Runnable)
*/
public Object getData () {
checkDevice ();
return data;
}
/**
* Returns the button dismissal alignment, one of LEFT
or RIGHT
.
* The button dismissal alignment is the ordering that should be used when positioning the
* default dismissal button for a dialog. For example, in a dialog that contains an OK and
* CANCEL button, on platforms where the button dismissal alignment is LEFT
, the
* button ordering should be OK/CANCEL. When button dismissal alignment is RIGHT
,
* the button ordering should be CANCEL/OK.
*
* @return the button dismissal order
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 2.1
*/
public int getDismissalAlignment () {
checkDevice ();
return SWT.LEFT;
}
/**
* Returns the longest duration, in milliseconds, between
* two mouse button clicks that will be considered a
* double click by the underlying operating system.
*
* @return the double click time
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public int getDoubleClickTime () {
checkDevice ();
return OS.GetDoubleClickTime ();
}
/**
* Returns the control which currently has keyboard focus,
* or null if keyboard events are not currently going to
* any of the controls built by the currently running
* application.
*
* @return the control under the cursor
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Control getFocusControl () {
checkDevice ();
if (focusControl != null && !focusControl.isDisposed ()) {
return focusControl;
}
return _getFocusControl ();
}
/**
* Returns true when the high contrast mode is enabled.
* Otherwise, false is returned.
*
* Note: This operation is a hint and is not supported on
* platforms that do not have this concept.
*
*
* @return the high contrast mode
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 3.0
*/
public boolean getHighContrast () {
checkDevice ();
if (OS.IsWinCE) return false;
HIGHCONTRAST pvParam = new HIGHCONTRAST ();
pvParam.cbSize = HIGHCONTRAST.sizeof;
OS.SystemParametersInfo (OS.SPI_GETHIGHCONTRAST, 0, pvParam, 0);
return (pvParam.dwFlags & OS.HCF_HIGHCONTRASTON) != 0;
}
/**
* Returns the maximum allowed depth of icons on this display.
* On some platforms, this may be different than the actual
* depth of the display.
*
* @return the maximum icon depth
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public int getIconDepth () {
checkDevice ();
/* Use the character encoding for the default locale */
TCHAR buffer1 = new TCHAR (0, "Control Panel\\Desktop\\WindowMetrics", true); //$NON-NLS-1$
int [] phkResult = new int [1];
int result = OS.RegOpenKeyEx (OS.HKEY_CURRENT_USER, buffer1, 0, OS.KEY_READ, phkResult);
if (result != 0) return 4;
int depth = 4;
int [] lpcbData = {128};
/* Use the character encoding for the default locale */
TCHAR lpData = new TCHAR (0, lpcbData [0]);
TCHAR buffer2 = new TCHAR (0, "Shell Icon BPP", true); //$NON-NLS-1$
result = OS.RegQueryValueEx (phkResult [0], buffer2, 0, null, lpData, lpcbData);
if (result == 0) {
try {
depth = Integer.parseInt (lpData.toString (0, lpData.strlen ()));
} catch (NumberFormatException e) {}
}
OS.RegCloseKey (phkResult [0]);
return depth;
}
/**
* Returns an array containing the recommended icon sizes.
*
* @return the array of icon sizes
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see Decorations#setImages(Image[])
*
* @since 3.0
*/
public Point [] getIconSizes () {
checkDevice ();
return new Point [] {
new Point (OS.GetSystemMetrics (OS.SM_CXSMICON), OS.GetSystemMetrics (OS.SM_CYSMICON)),
new Point (OS.GetSystemMetrics (OS.SM_CXICON), OS.GetSystemMetrics (OS.SM_CYICON)),
};
}
ImageList getImageList (Point size) {
if (imageList == null) imageList = new ImageList [4];
int i = 0;
int length = imageList.length;
while (i < length) {
ImageList list = imageList [i];
if (list == null) break;
if (list.getImageSize().equals(size)) {
list.addRef();
return list;
}
i++;
}
if (i == length) {
ImageList [] newList = new ImageList [length + 4];
System.arraycopy (imageList, 0, newList, 0, length);
imageList = newList;
}
ImageList list = new ImageList();
imageList [i] = list;
list.addRef();
return list;
}
ImageList getToolImageList (Point size) {
if (toolImageList == null) toolImageList = new ImageList [4];
int i = 0;
int length = toolImageList.length;
while (i < length) {
ImageList list = toolImageList [i];
if (list == null) break;
if (list.getImageSize().equals(size)) {
list.addRef();
return list;
}
i++;
}
if (i == length) {
ImageList [] newList = new ImageList [length + 4];
System.arraycopy (toolImageList, 0, newList, 0, length);
toolImageList = newList;
}
ImageList list = new ImageList();
toolImageList [i] = list;
list.addRef();
return list;
}
ImageList getToolHotImageList (Point size) {
if (toolHotImageList == null) toolHotImageList = new ImageList [4];
int i = 0;
int length = toolHotImageList.length;
while (i < length) {
ImageList list = toolHotImageList [i];
if (list == null) break;
if (list.getImageSize().equals(size)) {
list.addRef();
return list;
}
i++;
}
if (i == length) {
ImageList [] newList = new ImageList [length + 4];
System.arraycopy (toolHotImageList, 0, newList, 0, length);
toolHotImageList = newList;
}
ImageList list = new ImageList();
toolHotImageList [i] = list;
list.addRef();
return list;
}
ImageList getToolDisabledImageList (Point size) {
if (toolDisabledImageList == null) toolDisabledImageList = new ImageList [4];
int i = 0;
int length = toolDisabledImageList.length;
while (i < length) {
ImageList list = toolDisabledImageList [i];
if (list == null) break;
if (list.getImageSize().equals(size)) {
list.addRef();
return list;
}
i++;
}
if (i == length) {
ImageList [] newList = new ImageList [length + 4];
System.arraycopy (toolDisabledImageList, 0, newList, 0, length);
toolDisabledImageList = newList;
}
ImageList list = new ImageList();
toolDisabledImageList [i] = list;
list.addRef();
return list;
}
int getLastEventTime () {
return OS.IsWinCE ? OS.GetTickCount () : OS.GetMessageTime ();
}
MenuItem getMenuItem (int id) {
if (items == null) return null;
id = id - ID_START;
if (0 <= id && id < items.length) return items [id];
return null;
}
int getMessageCount () {
return synchronizer.getMessageCount ();
}
Shell getModalShell () {
if (modalShells == null) return null;
int index = modalShells.length;
while (--index >= 0) {
Shell shell = modalShells [index];
if (shell != null) return shell;
}
return null;
}
Shell getModalDialogShell () {
if (modalDialogShell != null && modalDialogShell.isDisposed ()) modalDialogShell = null;
return modalDialogShell;
}
/**
* Returns an array of monitors attached to the device.
*
* @return the array of monitors
*
* @since 3.0
*/
public Monitor [] getMonitors () {
checkDevice ();
if (OS.IsWinCE || OS.WIN32_VERSION < OS.VERSION (4, 10)) {
return new Monitor [] {getPrimaryMonitor ()};
}
monitors = new Monitor [4];
Callback callback = new Callback (this, "monitorEnumProc", 4); //$NON-NLS-1$
int lpfnEnum = callback.getAddress ();
OS.EnumDisplayMonitors (0, null, lpfnEnum, 0);
callback.dispose ();
Monitor [] result = new Monitor [monitorCount];
System.arraycopy (monitors, 0, result, 0, monitorCount);
monitors = null;
monitorCount = 0;
return result;
}
int getMsgProc (int code, int wParam, int lParam) {
if (embeddedHwnd == 0) {
int hInstance = OS.GetModuleHandle (null);
embeddedHwnd = OS.CreateWindowEx (0,
windowClass,
null,
OS.WS_OVERLAPPED,
0, 0, 0, 0,
0,
0,
hInstance,
null);
embeddedCallback = new Callback (this, "embeddedProc", 4); //$NON-NLS-1$
embeddedProc = embeddedCallback.getAddress ();
if (embeddedProc == 0) error (SWT.ERROR_NO_MORE_CALLBACKS);
OS.SetWindowLong (embeddedHwnd, OS.GWL_WNDPROC, embeddedProc);
}
if (code >= 0 && wParam != OS.PM_NOREMOVE) {
MSG msg = new MSG ();
OS.MoveMemory (msg, lParam, MSG.sizeof);
switch (msg.message) {
case SWT_RESIZE: {
if (msg.hwnd == 0 && msg.wParam != 0) {
OS.PostMessage (embeddedHwnd, SWT_RESIZE, msg.wParam, msg.lParam);
msg.message = OS.WM_NULL;
OS.MoveMemory (lParam, msg, MSG.sizeof);
}
break;
}
case OS.WM_KEYDOWN:
case OS.WM_KEYUP:
case OS.WM_SYSKEYDOWN:
case OS.WM_SYSKEYUP: {
int hHeap = OS.GetProcessHeap ();
int keyMsg = OS.HeapAlloc (hHeap, OS.HEAP_ZERO_MEMORY, MSG.sizeof);
OS.MoveMemory (keyMsg, msg, MSG.sizeof);
OS.PostMessage (hwndMessage, SWT_KEYMSG, wParam, keyMsg);
msg.message = OS.WM_NULL;
OS.MoveMemory (lParam, msg, MSG.sizeof);
}
}
}
return OS.CallNextHookEx (msgHook, code, wParam, lParam);
}
/**
* Returns the primary monitor for that device.
*
* @return the primary monitor
*
* @since 3.0
*/
public Monitor getPrimaryMonitor () {
checkDevice ();
if (OS.IsWinCE || OS.WIN32_VERSION < OS.VERSION (4, 10)) {
Monitor monitor = new Monitor();
int width = OS.GetSystemMetrics (OS.SM_CXSCREEN);
int height = OS.GetSystemMetrics (OS.SM_CYSCREEN);
monitor.width = width;
monitor.height = height;
RECT rect = new RECT ();
OS.SystemParametersInfo (OS.SPI_GETWORKAREA, 0, rect, 0);
monitor.clientX = rect.left;
monitor.clientY = rect.top;
monitor.clientWidth = rect.right - rect.left;
monitor.clientHeight = rect.bottom - rect.top;
return monitor;
}
monitors = new Monitor [4];
Callback callback = new Callback (this, "monitorEnumProc", 4); //$NON-NLS-1$
int lpfnEnum = callback.getAddress ();
OS.EnumDisplayMonitors (0, null, lpfnEnum, 0);
callback.dispose ();
Monitor result = null;
MONITORINFO lpmi = new MONITORINFO ();
lpmi.cbSize = MONITORINFO.sizeof;
for (int i = 0; i < monitorCount; i++) {
Monitor monitor = monitors [i];
OS.GetMonitorInfo (monitors [i].handle, lpmi);
if ((lpmi.dwFlags & OS.MONITORINFOF_PRIMARY) != 0) {
result = monitor;
break;
}
}
monitors = null;
monitorCount = 0;
return result;
}
/**
* Returns an array containing all shells which have not been
* disposed and have the receiver as their display.
*
* @return the receiver's shells
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Shell [] getShells () {
checkDevice ();
int count = 0;
for (int i=0; isyncExec
* or null if no such runnable is currently being invoked by
* the user-interface thread.
*
* Note: If a runnable invoked by asyncExec is currently
* running, this method will return null.
*
*
* @return the receiver's sync-interface thread
*
* @exception SWTException
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Thread getSyncThread () {
if (isDisposed ()) error (SWT.ERROR_DEVICE_DISPOSED);
return synchronizer.syncThread;
}
/**
* Returns the matching standard color for the given
* constant, which should be one of the color constants
* specified in class SWT
. Any value other
* than one of the SWT color constants which is passed
* in will result in the color black. This color should
* not be free'd because it was allocated by the system,
* not the application.
*
* @param id the color constant
* @return the matching color
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see SWT
*/
public Color getSystemColor (int id) {
checkDevice ();
int pixel = 0x02000000;
switch (id) {
case SWT.COLOR_WIDGET_DARK_SHADOW: pixel = OS.GetSysColor (OS.COLOR_3DDKSHADOW); break;
case SWT.COLOR_WIDGET_NORMAL_SHADOW: pixel = OS.GetSysColor (OS.COLOR_3DSHADOW); break;
case SWT.COLOR_WIDGET_LIGHT_SHADOW: pixel = OS.GetSysColor (OS.COLOR_3DLIGHT); break;
case SWT.COLOR_WIDGET_HIGHLIGHT_SHADOW: pixel = OS.GetSysColor (OS.COLOR_3DHIGHLIGHT); break;
case SWT.COLOR_WIDGET_BACKGROUND: pixel = OS.GetSysColor (OS.COLOR_3DFACE); break;
case SWT.COLOR_WIDGET_BORDER: pixel = OS.GetSysColor (OS.COLOR_WINDOWFRAME); break;
case SWT.COLOR_WIDGET_FOREGROUND:
case SWT.COLOR_LIST_FOREGROUND: pixel = OS.GetSysColor (OS.COLOR_WINDOWTEXT); break;
case SWT.COLOR_LIST_BACKGROUND: pixel = OS.GetSysColor (OS.COLOR_WINDOW); break;
case SWT.COLOR_LIST_SELECTION: pixel = OS.GetSysColor (OS.COLOR_HIGHLIGHT); break;
case SWT.COLOR_LIST_SELECTION_TEXT: pixel = OS.GetSysColor (OS.COLOR_HIGHLIGHTTEXT);break;
case SWT.COLOR_INFO_FOREGROUND: pixel = OS.GetSysColor (OS.COLOR_INFOTEXT); break;
case SWT.COLOR_INFO_BACKGROUND: pixel = OS.GetSysColor (OS.COLOR_INFOBK); break;
case SWT.COLOR_TITLE_FOREGROUND: pixel = OS.GetSysColor (OS.COLOR_CAPTIONTEXT); break;
case SWT.COLOR_TITLE_BACKGROUND: pixel = OS.GetSysColor (OS.COLOR_ACTIVECAPTION); break;
case SWT.COLOR_TITLE_BACKGROUND_GRADIENT:
pixel = OS.GetSysColor (OS.COLOR_GRADIENTACTIVECAPTION);
if (pixel == 0) pixel = OS.GetSysColor (OS.COLOR_ACTIVECAPTION);
break;
case SWT.COLOR_TITLE_INACTIVE_FOREGROUND: pixel = OS.GetSysColor (OS.COLOR_INACTIVECAPTIONTEXT); break;
case SWT.COLOR_TITLE_INACTIVE_BACKGROUND: pixel = OS.GetSysColor (OS.COLOR_INACTIVECAPTION); break;
case SWT.COLOR_TITLE_INACTIVE_BACKGROUND_GRADIENT:
pixel = OS.GetSysColor (OS.COLOR_GRADIENTINACTIVECAPTION);
if (pixel == 0) pixel = OS.GetSysColor (OS.COLOR_INACTIVECAPTION);
break;
default:
return super.getSystemColor (id);
}
return Color.win32_new (this, pixel);
}
/**
* Returns the matching standard platform cursor for the given
* constant, which should be one of the cursor constants
* specified in class SWT
. This cursor should
* not be free'd because it was allocated by the system,
* not the application. A value of null
will
* be returned if the supplied constant is not an swt cursor
* constant.
*
* @param id the swt cursor constant
* @return the corresponding cursor or null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see SWT#CURSOR_ARROW
* @see SWT#CURSOR_WAIT
* @see SWT#CURSOR_CROSS
* @see SWT#CURSOR_APPSTARTING
* @see SWT#CURSOR_HELP
* @see SWT#CURSOR_SIZEALL
* @see SWT#CURSOR_SIZENESW
* @see SWT#CURSOR_SIZENS
* @see SWT#CURSOR_SIZENWSE
* @see SWT#CURSOR_SIZEWE
* @see SWT#CURSOR_SIZEN
* @see SWT#CURSOR_SIZES
* @see SWT#CURSOR_SIZEE
* @see SWT#CURSOR_SIZEW
* @see SWT#CURSOR_SIZENE
* @see SWT#CURSOR_SIZESE
* @see SWT#CURSOR_SIZESW
* @see SWT#CURSOR_SIZENW
* @see SWT#CURSOR_UPARROW
* @see SWT#CURSOR_IBEAM
* @see SWT#CURSOR_NO
* @see SWT#CURSOR_HAND
*
* @since 3.0
*/
public Cursor getSystemCursor (int id) {
checkDevice ();
if (!(0 <= id && id < cursors.length)) return null;
if (cursors [id] == null) {
cursors [id] = new Cursor (this, id);
}
return cursors [id];
}
/**
* Returns a reasonable font for applications to use.
* On some platforms, this will match the "default font"
* or "system font" if such can be found. This font
* should not be free'd because it was allocated by the
* system, not the application.
*
* Typically, applications which want the default look
* should simply not set the font on the widgets they
* create. Widgets are always created with the correct
* default font for the class of user-interface component
* they represent.
*
*
* @return a font
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Font getSystemFont () {
checkDevice ();
int hFont = systemFont ();
return Font.win32_new (this, hFont);
}
/**
* Returns the matching standard platform image for the given
* constant, which should be one of the icon constants
* specified in class SWT
. This image should
* not be free'd because it was allocated by the system,
* not the application. A value of null
will
* be returned either if the supplied constant is not an
* swt icon constant or if the platform does not define an
* image that corresponds to the constant.
*
* @param id the swt icon constant
* @return the corresponding image or null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see SWT#ICON_ERROR
* @see SWT#ICON_INFORMATION
* @see SWT#ICON_QUESTION
* @see SWT#ICON_WARNING
* @see SWT#ICON_WORKING
*
* @since 3.0
*/
public Image getSystemImage (int id) {
checkDevice ();
int hIcon = 0;
switch (id) {
case SWT.ICON_ERROR:
if (errorIcon == 0) {
errorIcon = OS.LoadImage (0, OS.OIC_HAND, OS.IMAGE_ICON, 0, 0, OS.LR_SHARED);
}
hIcon = errorIcon;
break;
case SWT.ICON_WORKING:
case SWT.ICON_INFORMATION:
if (infoIcon == 0) {
infoIcon = OS.LoadImage (0, OS.OIC_INFORMATION, OS.IMAGE_ICON, 0, 0, OS.LR_SHARED);
}
hIcon = infoIcon;
break;
case SWT.ICON_QUESTION:
if (questionIcon == 0) {
questionIcon = OS.LoadImage (0, OS.OIC_QUES, OS.IMAGE_ICON, 0, 0, OS.LR_SHARED);
}
hIcon = questionIcon;
break;
case SWT.ICON_WARNING:
if (warningIcon == 0) {
warningIcon = OS.LoadImage (0, OS.OIC_BANG, OS.IMAGE_ICON, 0, 0, OS.LR_SHARED);
}
hIcon = warningIcon;
break;
}
if (hIcon == 0) return null;
return Image.win32_new (this, SWT.ICON, hIcon);
}
/**
* Returns the single instance of the system tray or null
* when there is no system tray available for the platform.
*
* @return the system tray or null
*
* @exception SWTException
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 3.0
*/
public Tray getSystemTray () {
checkDevice ();
if (tray != null) return tray;
return tray = new Tray (this, SWT.NONE);
}
/**
* Returns the user-interface thread for the receiver.
*
* @return the receiver's user-interface thread
*
* @exception SWTException
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*/
public Thread getThread () {
if (isDisposed ()) error (SWT.ERROR_DEVICE_DISPOSED);
return thread;
}
/**
* Invokes platform specific functionality to allocate a new GC handle.
*
* IMPORTANT: This method is not part of the public
* API for Display
. 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
*
* @exception SWTException
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
* @exception SWTError
* - ERROR_NO_HANDLES if a handle could not be obtained for gc creation
*
*/
public int internal_new_GC (GCData data) {
if (isDisposed()) SWT.error(SWT.ERROR_DEVICE_DISPOSED);
int hDC = OS.GetDC (0);
if (hDC == 0) SWT.error (SWT.ERROR_NO_HANDLES);
if (data != null) {
int mask = SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT;
if ((data.style & mask) != 0) {
data.layout = (data.style & SWT.RIGHT_TO_LEFT) != 0 ? OS.LAYOUT_RTL : 0;
} else {
data.style |= SWT.LEFT_TO_RIGHT;
}
data.device = this;
data.hFont = systemFont ();
}
return hDC;
}
/**
* Initializes any internal resources needed by the
* device.
*
* This method is called after create
.
*
*
* @see #create
*/
protected void init () {
super.init ();
/* Create the callbacks */
windowCallback = new Callback (this, "windowProc", 4); //$NON-NLS-1$
windowProc = windowCallback.getAddress ();
if (windowProc == 0) error (SWT.ERROR_NO_MORE_CALLBACKS);
/* Remember the current thread id */
threadId = OS.GetCurrentThreadId ();
/* Use the character encoding for the default locale */
windowClass = new TCHAR (0, WindowName + WindowClassCount, true);
windowShadowClass = new TCHAR (0, WindowShadowName + WindowClassCount, true);
WindowClassCount++;
/* Register the SWT window class */
int hHeap = OS.GetProcessHeap ();
int hInstance = OS.GetModuleHandle (null);
WNDCLASS lpWndClass = new WNDCLASS ();
lpWndClass.hInstance = hInstance;
lpWndClass.lpfnWndProc = windowProc;
lpWndClass.style = OS.CS_BYTEALIGNWINDOW | OS.CS_DBLCLKS;
lpWndClass.hCursor = OS.LoadCursor (0, OS.IDC_ARROW);
int byteCount = windowClass.length () * TCHAR.sizeof;
lpWndClass.lpszClassName = OS.HeapAlloc (hHeap, OS.HEAP_ZERO_MEMORY, byteCount);
OS.MoveMemory (lpWndClass.lpszClassName, windowClass, byteCount);
OS.RegisterClass (lpWndClass);
/* Register the SWT drop shadow window class */
if (OS.WIN32_VERSION >= OS.VERSION (5, 1)) {
lpWndClass.style |= OS.CS_DROPSHADOW;
}
byteCount = windowShadowClass.length () * TCHAR.sizeof;
lpWndClass.lpszClassName = OS.HeapAlloc (hHeap, OS.HEAP_ZERO_MEMORY, byteCount);
OS.MoveMemory (lpWndClass.lpszClassName, windowShadowClass, byteCount);
OS.RegisterClass (lpWndClass);
/* Initialize the system font */
int systemFont = 0;
if (!OS.IsWinCE) {
NONCLIENTMETRICS info = OS.IsUnicode ? (NONCLIENTMETRICS) new NONCLIENTMETRICSW () : new NONCLIENTMETRICSA ();
info.cbSize = NONCLIENTMETRICS.sizeof;
if (OS.SystemParametersInfo (OS.SPI_GETNONCLIENTMETRICS, 0, info, 0)) {
systemFont = OS.CreateFontIndirect (OS.IsUnicode ? (LOGFONT) ((NONCLIENTMETRICSW)info).lfMessageFont : ((NONCLIENTMETRICSA)info).lfMessageFont);
}
}
if (systemFont == 0) systemFont = OS.GetStockObject (OS.DEFAULT_GUI_FONT);
if (systemFont == 0) systemFont = OS.GetStockObject (OS.SYSTEM_FONT);
if (systemFont != 0) systemFonts = new int [] {systemFont};
/* Create the message only HWND */
hwndMessage = OS.CreateWindowEx (0,
windowClass,
null,
OS.WS_OVERLAPPED,
0, 0, 0, 0,
0,
0,
hInstance,
null);
messageCallback = new Callback (this, "messageProc", 4); //$NON-NLS-1$
messageProc = messageCallback.getAddress ();
if (messageProc == 0) error (SWT.ERROR_NO_MORE_CALLBACKS);
OS.SetWindowLong (hwndMessage, OS.GWL_WNDPROC, messageProc);
/* Create the filter hook */
if (!OS.IsWinCE) {
msgFilterCallback = new Callback (this, "msgFilterProc", 3); //$NON-NLS-1$
msgFilterProc = msgFilterCallback.getAddress ();
if (msgFilterProc == 0) error (SWT.ERROR_NO_MORE_CALLBACKS);
filterHook = OS.SetWindowsHookEx (OS.WH_MSGFILTER, msgFilterProc, 0, threadId);
}
/* Create the idle hook */
if (!OS.IsWinCE) {
foregroundIdleCallback = new Callback (this, "foregroundIdleProc", 3); //$NON-NLS-1$
foregroundIdleProc = foregroundIdleCallback.getAddress ();
if (foregroundIdleProc == 0) error (SWT.ERROR_NO_MORE_CALLBACKS);
idleHook = OS.SetWindowsHookEx (OS.WH_FOREGROUNDIDLE, foregroundIdleProc, 0, threadId);
}
/* Register the task bar created message */
SWT_TASKBARCREATED = OS.RegisterWindowMessage (new TCHAR (0, "TaskbarCreated", true));
/* Initialize OLE */
if (!OS.IsWinCE) {
OS.OleInitialize (0);
}
/* Initialize the Widget Table */
indexTable = new int [GROW_SIZE];
controlTable = new Control [GROW_SIZE];
for (int i=0; i
* IMPORTANT: This method is not part of the public
* API for Display
. 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
*/
public void internal_dispose_GC (int hDC, GCData data) {
OS.ReleaseDC (0, hDC);
}
boolean isValidThread () {
return thread == Thread.currentThread ();
}
/**
* Maps a point from one coordinate system to another.
* When the control is null, coordinates are mapped to
* the display.
*
* NOTE: On right-to-left platforms where the coordinate
* systems are mirrored, special care needs to be taken
* when mapping coordinates from one control to another
* to ensure the result is correctly mirrored.
*
* Mapping a point that is the origin of a rectangle and
* then adding the width and height is not equivalent to
* mapping the rectangle. When one control is mirrored
* and the other is not, adding the width and height to a
* point that was mapped causes the rectangle to extend
* in the wrong direction. Mapping the entire rectangle
* instead of just one point causes both the origin and
* the corner of the rectangle to be mapped.
*
*
* @param from the source Control
or null
* @param to the destination Control
or null
* @param point to be mapped
* @return point with mapped coordinates
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the point is null
* - ERROR_INVALID_ARGUMENT - if the Control from or the Control to have been disposed
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 2.1.2
*/
public Point map (Control from, Control to, Point point) {
checkDevice ();
if (point == null) error (SWT.ERROR_NULL_ARGUMENT);
return map (from, to, point.x, point.y);
}
/**
* Maps a point from one coordinate system to another.
* When the control is null, coordinates are mapped to
* the display.
*
* NOTE: On right-to-left platforms where the coordinate
* systems are mirrored, special care needs to be taken
* when mapping coordinates from one control to another
* to ensure the result is correctly mirrored.
*
* Mapping a point that is the origin of a rectangle and
* then adding the width and height is not equivalent to
* mapping the rectangle. When one control is mirrored
* and the other is not, adding the width and height to a
* point that was mapped causes the rectangle to extend
* in the wrong direction. Mapping the entire rectangle
* instead of just one point causes both the origin and
* the corner of the rectangle to be mapped.
*
*
* @param from the source Control
or null
* @param to the destination Control
or null
* @param x coordinates to be mapped
* @param y coordinates to be mapped
* @return point with mapped coordinates
*
* @exception IllegalArgumentException
* - ERROR_INVALID_ARGUMENT - if the Control from or the Control to have been disposed
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 2.1.2
*/
public Point map (Control from, Control to, int x, int y) {
checkDevice ();
if (from != null && from.isDisposed()) error (SWT.ERROR_INVALID_ARGUMENT);
if (to != null && to.isDisposed()) error (SWT.ERROR_INVALID_ARGUMENT);
int hwndFrom = from != null ? from.handle : 0;
int hwndTo = to != null ? to.handle : 0;
POINT point = new POINT ();
point.x = x;
point.y = y;
OS.MapWindowPoints (hwndFrom, hwndTo, point, 1);
return new Point (point.x, point.y);
}
/**
* Maps a point from one coordinate system to another.
* When the control is null, coordinates are mapped to
* the display.
*
* NOTE: On right-to-left platforms where the coordinate
* systems are mirrored, special care needs to be taken
* when mapping coordinates from one control to another
* to ensure the result is correctly mirrored.
*
* Mapping a point that is the origin of a rectangle and
* then adding the width and height is not equivalent to
* mapping the rectangle. When one control is mirrored
* and the other is not, adding the width and height to a
* point that was mapped causes the rectangle to extend
* in the wrong direction. Mapping the entire rectangle
* instead of just one point causes both the origin and
* the corner of the rectangle to be mapped.
*
*
* @param from the source Control
or null
* @param to the destination Control
or null
* @param rectangle to be mapped
* @return rectangle with mapped coordinates
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the rectangle is null
* - ERROR_INVALID_ARGUMENT - if the Control from or the Control to have been disposed
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 2.1.2
*/
public Rectangle map (Control from, Control to, Rectangle rectangle) {
checkDevice ();
if (rectangle == null) error (SWT.ERROR_NULL_ARGUMENT);
return map (from, to, rectangle.x, rectangle.y, rectangle.width, rectangle.height);
}
/**
* Maps a point from one coordinate system to another.
* When the control is null, coordinates are mapped to
* the display.
*
* NOTE: On right-to-left platforms where the coordinate
* systems are mirrored, special care needs to be taken
* when mapping coordinates from one control to another
* to ensure the result is correctly mirrored.
*
* Mapping a point that is the origin of a rectangle and
* then adding the width and height is not equivalent to
* mapping the rectangle. When one control is mirrored
* and the other is not, adding the width and height to a
* point that was mapped causes the rectangle to extend
* in the wrong direction. Mapping the entire rectangle
* instead of just one point causes both the origin and
* the corner of the rectangle to be mapped.
*
*
* @param from the source Control
or null
* @param to the destination Control
or null
* @param x coordinates to be mapped
* @param y coordinates to be mapped
* @param width coordinates to be mapped
* @param height coordinates to be mapped
* @return rectangle with mapped coordinates
*
* @exception IllegalArgumentException
* - ERROR_INVALID_ARGUMENT - if the Control from or the Control to have been disposed
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 2.1.2
*/
public Rectangle map (Control from, Control to, int x, int y, int width, int height) {
checkDevice ();
if (from != null && from.isDisposed()) error (SWT.ERROR_INVALID_ARGUMENT);
if (to != null && to.isDisposed()) error (SWT.ERROR_INVALID_ARGUMENT);
int hwndFrom = from != null ? from.handle : 0;
int hwndTo = to != null ? to.handle : 0;
RECT rect = new RECT ();
rect.left = x;
rect.top = y;
rect.right = x + width;
rect.bottom = y + height;
OS.MapWindowPoints (hwndFrom, hwndTo, rect, 2);
return new Rectangle (rect.left, rect.top, rect.right - rect.left, rect.bottom - rect.top);
}
/*
* Returns a single character, converted from the default
* multi-byte character set (MBCS) used by the operating
* system widgets to a wide character set (WCS) used by Java.
*
* @param ch the MBCS character
* @return the WCS character
*/
static char mbcsToWcs (int ch) {
return mbcsToWcs (ch, 0);
}
/*
* Returns a single character, converted from the specified
* multi-byte character set (MBCS) used by the operating
* system widgets to a wide character set (WCS) used by Java.
*
* @param ch the MBCS character
* @param codePage the code page used to convert the character
* @return the WCS character
*/
static char mbcsToWcs (int ch, int codePage) {
if (OS.IsUnicode) return (char) ch;
int key = ch & 0xFFFF;
if (key <= 0x7F) return (char) ch;
byte [] buffer;
if (key <= 0xFF) {
buffer = new byte [1];
buffer [0] = (byte) key;
} else {
buffer = new byte [2];
buffer [0] = (byte) ((key >> 8) & 0xFF);
buffer [1] = (byte) (key & 0xFF);
}
char [] unicode = new char [1];
int cp = codePage != 0 ? codePage : OS.CP_ACP;
int count = OS.MultiByteToWideChar (cp, OS.MB_PRECOMPOSED, buffer, buffer.length, unicode, 1);
if (count == 0) return 0;
return unicode [0];
}
int messageProc (int hwnd, int msg, int wParam, int lParam) {
switch (msg) {
case SWT_KEYMSG:
boolean consumed = false;
MSG keyMsg = new MSG ();
OS.MoveMemory (keyMsg, lParam, MSG.sizeof);
Control control = findControl (keyMsg.hwnd);
if (control != null) {
keyMsg.hwnd = control.handle;
int flags = OS.PM_REMOVE | OS.PM_NOYIELD | OS.PM_QS_INPUT | OS.PM_QS_POSTMESSAGE;
do {
if (!(consumed |= filterMessage (keyMsg))) {
OS.TranslateMessage (keyMsg);
consumed |= OS.DispatchMessage (keyMsg) == 1;
}
} while (OS.PeekMessage (keyMsg, keyMsg.hwnd, OS.WM_KEYFIRST, OS.WM_KEYLAST, flags));
}
if (consumed) {
int hHeap = OS.GetProcessHeap ();
OS.HeapFree (hHeap, 0, lParam);
} else {
OS.PostMessage (embeddedHwnd, SWT_KEYMSG, wParam, lParam);
}
return 0;
case SWT_TRAYICONMSG:
if (tray != null) {
TrayItem [] items = tray.items;
for (int i=0; i= monitors.length) {
Monitor[] newMonitors = new Monitor [monitors.length + 4];
System.arraycopy (monitors, 0, newMonitors, 0, monitors.length);
monitors = newMonitors;
}
MONITORINFO lpmi = new MONITORINFO ();
lpmi.cbSize = MONITORINFO.sizeof;
OS.GetMonitorInfo (hmonitor, lpmi);
Monitor monitor = new Monitor ();
monitor.handle = hmonitor;
monitor.x = lpmi.rcMonitor_left;
monitor.y = lpmi.rcMonitor_top;
monitor.width = lpmi.rcMonitor_right - lpmi.rcMonitor_left;
monitor.height = lpmi.rcMonitor_bottom - lpmi.rcMonitor_top;
monitor.clientX = lpmi.rcWork_left;
monitor.clientY = lpmi.rcWork_top;
monitor.clientWidth = lpmi.rcWork_right - lpmi.rcWork_left;
monitor.clientHeight = lpmi.rcWork_bottom - lpmi.rcWork_top;
monitors [monitorCount++] = monitor;
return 1;
}
int msgFilterProc (int code, int wParam, int lParam) {
if (!ignoreMsgFilter) {
if (code >= 0) {
OS.MoveMemory (hookMsg, lParam, MSG.sizeof);
if (hookMsg.message == OS.WM_NULL) {
if (runAsyncMessages (false)) wakeThread ();
}
}
}
return OS.CallNextHookEx (filterHook, code, wParam, lParam);
}
int numpadKey (int key) {
switch (key) {
case OS.VK_NUMPAD0: return '0';
case OS.VK_NUMPAD1: return '1';
case OS.VK_NUMPAD2: return '2';
case OS.VK_NUMPAD3: return '3';
case OS.VK_NUMPAD4: return '4';
case OS.VK_NUMPAD5: return '5';
case OS.VK_NUMPAD6: return '6';
case OS.VK_NUMPAD7: return '7';
case OS.VK_NUMPAD8: return '8';
case OS.VK_NUMPAD9: return '9';
case OS.VK_MULTIPLY: return '*';
case OS.VK_ADD: return '+';
case OS.VK_SEPARATOR: return '\0';
case OS.VK_SUBTRACT: return '-';
case OS.VK_DECIMAL: return '.';
case OS.VK_DIVIDE: return '/';
}
return 0;
}
/**
* Generate a low level system event.
*
* post
is used to generate low level keyboard
* and mouse events. The intent is to enable automated UI
* testing by simulating the input from the user. Most
* SWT applications should never need to call this method.
*
* Note that this operation can fail when the operating system
* fails to generate the event for any reason. For example,
* this can happen when there is no such key or mouse button
* or when the system event queue is full.
*
*
* Event Types:
*
KeyDown, KeyUp
*
The following fields in the Event
apply:
*
* - (in) type KeyDown or KeyUp
* Either one of:
*
- (in) character a character that corresponds to a keyboard key
* - (in) keyCode the key code of the key that was typed,
* as defined by the key code constants in class
SWT
*
* MouseDown, MouseUp
* The following fields in the Event
apply:
*
* - (in) type MouseDown or MouseUp
*
- (in) button the button that is pressed or released
*
* MouseMove
* The following fields in the Event
apply:
*
* - (in) type MouseMove
*
- (in) x the x coordinate to move the mouse pointer to in screen coordinates
*
- (in) y the y coordinate to move the mouse pointer to in screen coordinates
*
*
*
* @param event the event to be generated
*
* @return true if the event was generated or false otherwise
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the event is null
*
* @exception SWTException
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 3.0
*
*/
public boolean post (Event event) {
if (isDisposed ()) error (SWT.ERROR_DEVICE_DISPOSED);
if (event == null) error (SWT.ERROR_NULL_ARGUMENT);
int type = event.type;
switch (type){
case SWT.KeyDown:
case SWT.KeyUp: {
KEYBDINPUT inputs = new KEYBDINPUT ();
inputs.wVk = (short) untranslateKey (event.keyCode);
if (inputs.wVk == 0) {
char key = event.character;
switch (key) {
case SWT.BS: inputs.wVk = (short) OS.VK_BACK; break;
case SWT.CR: inputs.wVk = (short) OS.VK_RETURN; break;
case SWT.DEL: inputs.wVk = (short) OS.VK_DELETE; break;
case SWT.ESC: inputs.wVk = (short) OS.VK_ESCAPE; break;
case SWT.TAB: inputs.wVk = (short) OS.VK_TAB; break;
/*
* Since there is no LF key on the keyboard, do not attempt
* to map LF to CR or attempt to post an LF key.
*/
// case SWT.LF: inputs.wVk = (short) OS.VK_RETURN; break;
case SWT.LF: return false;
default: {
if (OS.IsWinCE) {
inputs.wVk = OS.CharUpper ((short) key);
} else {
inputs.wVk = OS.VkKeyScan ((short) wcsToMbcs (key, 0));
if (inputs.wVk == -1) return false;
}
}
}
}
inputs.dwFlags = type == SWT.KeyUp ? OS.KEYEVENTF_KEYUP : 0;
int hHeap = OS.GetProcessHeap ();
int pInputs = OS.HeapAlloc (hHeap, OS.HEAP_ZERO_MEMORY, INPUT.sizeof);
OS.MoveMemory(pInputs, new int[] {OS.INPUT_KEYBOARD}, 4);
OS.MoveMemory (pInputs + 4, inputs, KEYBDINPUT.sizeof);
boolean result = OS.SendInput (1, pInputs, INPUT.sizeof) != 0;
OS.HeapFree (hHeap, 0, pInputs);
return result;
}
case SWT.MouseDown:
case SWT.MouseMove:
case SWT.MouseUp: {
MOUSEINPUT inputs = new MOUSEINPUT ();
if (type == SWT.MouseMove){
inputs.dwFlags = OS.MOUSEEVENTF_MOVE | OS.MOUSEEVENTF_ABSOLUTE;
inputs.dx = event.x * 65535 / (OS.GetSystemMetrics (OS.SM_CXSCREEN) - 1);
inputs.dy = event.y * 65535 / (OS.GetSystemMetrics (OS.SM_CYSCREEN) - 1);
} else {
switch (event.button) {
case 1: inputs.dwFlags = type == SWT.MouseDown ? OS.MOUSEEVENTF_LEFTDOWN : OS.MOUSEEVENTF_LEFTUP; break;
case 2: inputs.dwFlags = type == SWT.MouseDown ? OS.MOUSEEVENTF_MIDDLEDOWN : OS.MOUSEEVENTF_MIDDLEUP; break;
case 3: inputs.dwFlags = type == SWT.MouseDown ? OS.MOUSEEVENTF_RIGHTDOWN : OS.MOUSEEVENTF_RIGHTUP; break;
default: return false;
}
}
int hHeap = OS.GetProcessHeap ();
int pInputs = OS.HeapAlloc (hHeap, OS.HEAP_ZERO_MEMORY, INPUT.sizeof);
OS.MoveMemory(pInputs, new int[] {OS.INPUT_MOUSE}, 4);
OS.MoveMemory (pInputs + 4, inputs, MOUSEINPUT.sizeof);
boolean result = OS.SendInput (1, pInputs, INPUT.sizeof) != 0;
OS.HeapFree (hHeap, 0, pInputs);
return result;
}
}
return false;
}
void postEvent (Event event) {
/*
* Place the event at the end of the event queue.
* This code is always called in the Display's
* thread so it must be re-enterant but does not
* need to be synchronized.
*/
if (eventQueue == null) eventQueue = new Event [4];
int index = 0;
int length = eventQueue.length;
while (index < length) {
if (eventQueue [index] == null) break;
index++;
}
if (index == length) {
Event [] newQueue = new Event [length + 4];
System.arraycopy (eventQueue, 0, newQueue, 0, length);
eventQueue = newQueue;
}
eventQueue [index] = event;
}
/**
* Reads an event from the operating system's event queue,
* dispatches it appropriately, and returns true
* if there is potentially more work to do, or false
* if the caller can sleep until another event is placed on
* the event queue.
*
* In addition to checking the system event queue, this method also
* checks if any inter-thread messages (created by syncExec()
* or asyncExec()
) are waiting to be processed, and if
* so handles them before returning.
*
*
* @return false
if the caller can sleep upon return from this method
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
* - ERROR_FAILED_EXEC - if an exception occurred while running an inter-thread message
*
*
* @see #sleep
* @see #wake
*/
public boolean readAndDispatch () {
checkDevice ();
drawMenuBars ();
runPopups ();
if (OS.PeekMessage (msg, 0, 0, 0, OS.PM_REMOVE)) {
if (!filterMessage (msg)) {
OS.TranslateMessage (msg);
OS.DispatchMessage (msg);
}
runDeferredEvents ();
return true;
}
return runAsyncMessages (false);
}
static synchronized void register (Display display) {
for (int i=0; i
* Disposes all shells which are currently open on the display.
* After this method has been invoked, all related related shells
* will answer true
when sent the message
* isDisposed()
.
*
* When a device is destroyed, resources that were acquired
* on behalf of the programmer need to be returned to the
* operating system. For example, if the device allocated a
* font to be used as the system font, this font would be
* freed in release
. Also,to assist the garbage
* collector and minimize the amount of memory that is not
* reclaimed when the programmer keeps a reference to a
* disposed device, all fields except the handle are zero'd.
* The handle is needed by destroy
.
*
* This method is called before destroy
.
*
* @see #dispose
* @see #destroy
*/
protected void release () {
sendEvent (SWT.Dispose, new Event ());
Shell [] shells = getShells ();
for (int i=0; i 0) return;
list.dispose ();
System.arraycopy (imageList, i + 1, imageList, i, --length - i);
imageList [length] = null;
for (int j=0; j 0) return;
list.dispose ();
System.arraycopy (toolImageList, i + 1, toolImageList, i, --length - i);
toolImageList [length] = null;
for (int j=0; j 0) return;
list.dispose ();
System.arraycopy (toolHotImageList, i + 1, toolHotImageList, i, --length - i);
toolHotImageList [length] = null;
for (int j=0; j 0) return;
list.dispose ();
System.arraycopy (toolDisabledImageList, i + 1, toolDisabledImageList, i, --length - i);
toolDisabledImageList [length] = null;
for (int j=0; j
* ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
*
*
* @see Listener
* @see #addFilter
* @see #addListener
*
* @since 3.0
*/
public void removeFilter (int eventType, Listener listener) {
checkDevice ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
if (filterTable == null) return;
filterTable.unhook (eventType, listener);
if (filterTable.size () == 0) filterTable = null;
}
/**
* Removes the listener from the collection of listeners who will
* be notifed when an event of the given type occurs.
*
* @param eventType the type of event to listen for
* @param listener the listener which should no longer be notified when the event occurs
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the listener is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see Listener
* @see #addListener
*
* @since 2.0
*/
public void removeListener (int eventType, Listener listener) {
checkDevice ();
if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
if (eventTable == null) return;
eventTable.unhook (eventType, listener);
}
void removeBar (Menu menu) {
if (bars == null) return;
for (int i=0; iNote: It is typically considered bad practice for a
* program to move the on-screen pointer location.
*
* @param x the new x coordinate for the cursor
* @param y the new y coordinate for the cursor
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 2.1
*/
public void setCursorLocation (int x, int y) {
checkDevice ();
OS.SetCursorPos (x, y);
}
/**
* Sets the location of the on-screen pointer relative to the top left corner
* of the screen. Note: It is typically considered bad practice for a
* program to move the on-screen pointer location.
*
* @param point new position
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_NULL_ARGUMENT - if the point is null
*
- ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @since 2.0
*/
public void setCursorLocation (Point point) {
checkDevice ();
if (point == null) error (SWT.ERROR_NULL_ARGUMENT);
setCursorLocation (point.x, point.y);
}
/**
* Sets the application defined property of the receiver
* with the specified name to the given argument.
*
* Applications may have associated arbitrary objects with the
* receiver in this fashion. If the objects stored in the
* properties need to be notified when the display is disposed
* of, it is the application's responsibility provide a
* disposeExec()
handler which does so.
*
*
* @param key the name of the property
* @param value the new value for the property
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the key is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #getData(String)
* @see #disposeExec(Runnable)
*/
public void setData (String key, Object value) {
checkDevice ();
if (key == null) error (SWT.ERROR_NULL_ARGUMENT);
/* Remove the key/value pair */
if (value == null) {
if (keys == null) return;
int index = 0;
while (index < keys.length && !keys [index].equals (key)) index++;
if (index == keys.length) return;
if (keys.length == 1) {
keys = null;
values = null;
} else {
String [] newKeys = new String [keys.length - 1];
Object [] newValues = new Object [values.length - 1];
System.arraycopy (keys, 0, newKeys, 0, index);
System.arraycopy (keys, index + 1, newKeys, index, newKeys.length - index);
System.arraycopy (values, 0, newValues, 0, index);
System.arraycopy (values, index + 1, newValues, index, newValues.length - index);
keys = newKeys;
values = newValues;
}
return;
}
/* Add the key/value pair */
if (keys == null) {
keys = new String [] {key};
values = new Object [] {value};
return;
}
for (int i=0; idisplay specific data is a single,
* unnamed field that is stored with every display.
*
* Applications may put arbitrary objects in this field. If
* the object stored in the display specific data needs to
* be notified when the display is disposed of, it is the
* application's responsibility provide a
* disposeExec()
handler which does so.
*
*
* @param data the new display specific data
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #getData()
* @see #disposeExec(Runnable)
*/
public void setData (Object data) {
checkDevice ();
this.data = data;
}
/**
* On platforms which support it, sets the application name
* to be the argument. On Motif, for example, this can be used
* to set the name used for resource lookup.
*
* @param name the new app name
*/
public static void setAppName (String name) {
/* Do nothing */
}
void setModalDialogShell (Shell modalDailog) {
if (modalDialogShell != null && modalDialogShell.isDisposed ()) modalDialogShell = null;
this.modalDialogShell = modalDailog;
Shell [] shells = getShells ();
for (int i=0; i
* ERROR_NULL_ARGUMENT - if the synchronizer is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
* - ERROR_FAILED_EXEC - if an exception occurred while running an inter-thread message
*
*/
public void setSynchronizer (Synchronizer synchronizer) {
checkDevice ();
if (synchronizer == null) error (SWT.ERROR_NULL_ARGUMENT);
if (this.synchronizer != null) {
this.synchronizer.runAsyncMessages(true);
}
this.synchronizer = synchronizer;
}
int shiftedKey (int key) {
if (OS.IsWinCE) return 0;
/* Clear the virtual keyboard and press the shift key */
for (int i=0; isleep (that is,
* to be put in a state where it does not consume CPU cycles)
* until an event is received or it is otherwise awakened.
*
* @return true
if an event requiring dispatching was placed on the queue.
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #wake
*/
public boolean sleep () {
checkDevice ();
if (getMessageCount () != 0) return true;
if (OS.IsWinCE) {
OS.MsgWaitForMultipleObjectsEx (0, 0, OS.INFINITE, OS.QS_ALLINPUT, OS.MWMO_INPUTAVAILABLE);
return true;
}
return OS.WaitMessage ();
}
/**
* Causes the run()
method of the runnable to
* be invoked by the user-interface thread at the next
* reasonable opportunity. The thread which calls this method
* is suspended until the runnable completes.
*
* @param runnable code to run on the user-interface thread.
*
* @exception SWTException
* - ERROR_FAILED_EXEC - if an exception occured when executing the runnable
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #asyncExec
*/
public void syncExec (Runnable runnable) {
if (isDisposed ()) error (SWT.ERROR_DEVICE_DISPOSED);
synchronizer.syncExec (runnable);
}
int systemFont () {
int hFont = 0;
if (systemFonts != null) {
int length = systemFonts.length;
if (length != 0) hFont = systemFonts [length - 1];
}
if (hFont == 0) hFont = OS.GetStockObject (OS.DEFAULT_GUI_FONT);
if (hFont == 0) hFont = OS.GetStockObject (OS.SYSTEM_FONT);
return hFont;
}
/**
* Causes the run()
method of the runnable to
* be invoked by the user-interface thread after the specified
* number of milliseconds have elapsed. If milliseconds is less
* than zero, the runnable is not executed.
*
* @param milliseconds the delay before running the runnable
* @param runnable code to run on the user-interface thread
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the runnable is null
*
* @exception SWTException
* - ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #asyncExec
*/
public void timerExec (int milliseconds, Runnable runnable) {
checkDevice ();
if (runnable == null) error (SWT.ERROR_NULL_ARGUMENT);
if (timerList == null) timerList = new Runnable [4];
if (timerIds == null) timerIds = new int [4];
int index = 0;
while (index < timerList.length) {
if (timerList [index] == runnable) break;
index++;
}
int timerId = 0;
if (index != timerList.length) {
timerId = timerIds [index];
if (milliseconds < 0) {
OS.KillTimer (hwndMessage, timerId);
timerList [index] = null;
timerIds [index] = 0;
return;
}
} else {
if (milliseconds < 0) return;
index = 0;
while (index < timerList.length) {
if (timerList [index] == null) break;
index++;
}
nextTimerId++;
timerId = nextTimerId;
if (index == timerList.length) {
Runnable [] newTimerList = new Runnable [timerList.length + 4];
System.arraycopy (timerList, 0, newTimerList, 0, timerList.length);
timerList = newTimerList;
int [] newTimerIds = new int [timerIds.length + 4];
System.arraycopy (timerIds, 0, newTimerIds, 0, timerIds.length);
timerIds = newTimerIds;
}
}
int newTimerID = OS.SetTimer (hwndMessage, timerId, milliseconds, 0);
if (newTimerID != 0) {
timerList [index] = runnable;
timerIds [index] = newTimerID;
}
}
boolean translateAccelerator (MSG msg, Control control) {
accelKeyHit = true;
boolean result = control.translateAccelerator (msg);
accelKeyHit = false;
return result;
}
static int translateKey (int key) {
for (int i=0; i
* ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see Control#update()
*/
public void update() {
checkDevice ();
Shell[] shells = getShells ();
for (int i=0; isleep'ing,
* causes it to be awakened and start running again. Note that this
* method may be called from any thread.
*
* @exception SWTException
* - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
*
*
* @see #sleep
*/
public void wake () {
if (isDisposed ()) error (SWT.ERROR_DEVICE_DISPOSED);
if (thread == Thread.currentThread ()) return;
wakeThread ();
}
void wakeThread () {
if (OS.IsWinCE) {
OS.PostMessage (hwndMessage, OS.WM_NULL, 0, 0);
} else {
OS.PostThreadMessage (threadId, OS.WM_NULL, 0, 0);
}
}
/*
* Returns a single character, converted from the wide
* character set (WCS) used by Java to the specified
* multi-byte character set used by the operating system
* widgets.
*
* @param ch the WCS character
* @param codePage the code page used to convert the character
* @return the MBCS character
*/
static int wcsToMbcs (char ch, int codePage) {
if (OS.IsUnicode) return ch;
if (ch <= 0x7F) return ch;
TCHAR buffer = new TCHAR (codePage, ch, false);
return buffer.tcharAt (0);
}
/*
* Returns a single character, converted from the wide
* character set (WCS) used by Java to the default
* multi-byte character set used by the operating system
* widgets.
*
* @param ch the WCS character
* @return the MBCS character
*/
static int wcsToMbcs (char ch) {
return wcsToMbcs (ch, 0);
}
int windowProc (int hwnd, int msg, int wParam, int lParam) {
int index;
if (USE_PROPERTY) {
index = OS.GetProp (hwnd, SWT_OBJECT_INDEX) - 1;
} else {
index = OS.GetWindowLong (hwnd, OS.GWL_USERDATA) - 1;
}
if (0 <= index && index < controlTable.length) {
Control control = controlTable [index];
if (control != null) {
return control.windowProc (hwnd, msg, wParam, lParam);
}
}
return OS.DefWindowProc (hwnd, msg, wParam, lParam);
}
static String withCrLf (String string) {
/* If the string is empty, return the string. */
int length = string.length ();
if (length == 0) return string;
/*
* Check for an LF or CR/LF and assume the rest of
* the string is formated that way. This will not
* work if the string contains mixed delimiters.
*/
int i = string.indexOf ('\n', 0);
if (i == -1) return string;
if (i > 0 && string.charAt (i - 1) == '\r') {
return string;
}
/*
* The string is formatted with LF. Compute the
* number of lines and the size of the buffer
* needed to hold the result
*/
i++;
int count = 1;
while (i < length) {
if ((i = string.indexOf ('\n', i)) == -1) break;
count++; i++;
}
count += length;
/* Create a new string with the CR/LF line terminator. */
i = 0;
StringBuffer result = new StringBuffer (count);
while (i < length) {
int j = string.indexOf ('\n', i);
if (j == -1) j = length;
result.append (string.substring (i, j));
if ((i = j) < length) {
result.append ("\r\n"); //$NON-NLS-1$
i++;
}
}
return result.toString ();
}
}