author | hgs |
Fri, 15 Oct 2010 12:29:39 +0300 | |
changeset 80 | d6dafc5d983f |
parent 50 | 023eef975703 |
permissions | -rw-r--r-- |
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
1 |
/******************************************************************************* |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
2 |
* Copyright (c) 2004 IBM Corp. |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
3 |
* Portion Copyright (c) 2005, 2008 Nokia Corporation and/or its subsidiary(-ies). |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
4 |
* All rights reserved. This program and the accompanying materials |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
5 |
* are made available under the terms of the Eclipse Public License v1.0 |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
6 |
* which accompanies this distribution, and is available at |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
7 |
* http://www.eclipse.org/legal/epl-v10.html |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
8 |
* |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
9 |
* Contributors: |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
10 |
* Mark Rogalski (IBM Corp.) - initial API specification |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
11 |
* Nokia Corporation - S60 implementation |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
12 |
* Nokia Corporation - QT implementation |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
13 |
*******************************************************************************/ |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
14 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
15 |
package org.eclipse.ercp.swt.mobile; |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
16 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
17 |
import java.util.Vector; |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
18 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
19 |
import org.eclipse.swt.SWT; |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
20 |
import org.eclipse.swt.internal.qt.OS; |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
21 |
import org.eclipse.swt.widgets.Display; |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
22 |
import org.eclipse.swt.widgets.Internal_PackageSupport; |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
23 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
24 |
/** |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
25 |
* Instances of this class represent the device that is being used. |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
26 |
* It provides methods that enable applications to learn more about the device |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
27 |
* specific characteristics and capabilities. |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
28 |
* <p> |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
29 |
* Applications can query what input features and display screens are permanently |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
30 |
* part of the device. These are considered <i>local</i> features. Some devices also |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
31 |
* allow input mechanisms or screens to be attached to the device at runtime. These |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
32 |
* are considered <i>remote</i> features. Since local features do not come and go, |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
33 |
* it is sufficient to query for them once. On the other hand, since remote devices |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
34 |
* can be added or removed at any time, an application needs to add a <code> |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
35 |
* MobileDeviceListener</code> to be informed of these events. |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
36 |
* <p> |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
37 |
* Local features may also be <i>internal</i> or <i>external</i>. |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
38 |
* External features are only available when a device is closed. |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
39 |
* Internal features are only available when a device is opened. |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
40 |
* |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
41 |
* @see Screen |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
42 |
* @see Input |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
43 |
* @see MobileDeviceListener |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
44 |
*/ |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
45 |
public class MobileDevice { |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
46 |
|
50 | 47 |
private static int handleMobileDevice; |
48 |
private Vector mobileDeviceListeners; |
|
49 |
private Screen[] screens; |
|
50 |
private Input[] inputs; |
|
51 |
private int alertLevel; |
|
52 |
private boolean isOpen; |
|
53 |
private static int desktopWidgetHandle; |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
54 |
static MobileDevice currentMobileDevice; |
50 | 55 |
private int activeScreenId; |
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
56 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
57 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
58 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
59 |
|
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
60 |
/** |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
61 |
* feature which is permanently attached to the mobile device and always available |
50 | 62 |
*/ |
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
63 |
public static final int LOCAL = 0; |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
64 |
|
50 | 65 |
/** |
66 |
* local feature which is only available when mobile device is opened |
|
67 |
*/ |
|
68 |
public static final int INTERNAL = 1; |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
69 |
|
50 | 70 |
/** |
71 |
* local feature which is only available when mobile device is closed |
|
72 |
*/ |
|
73 |
public static final int EXTERNAL = 2; |
|
74 |
||
75 |
/** |
|
76 |
* feature which is not part of the mobile device unless connected via wire or wireless signal |
|
77 |
*/ |
|
78 |
public static final int REMOTE = 3; |
|
79 |
||
80 |
/** |
|
81 |
* alert level indicating simple notification (ex. e-mail arrival) |
|
82 |
*/ |
|
83 |
public static final int ALERT_LOW_IMPORTANCE = 1; |
|
84 |
||
85 |
/** |
|
86 |
* alert level indicating user attention desired (ex. instant message arrival) |
|
87 |
*/ |
|
88 |
public static final int ALERT_HIGH_IMPORTANCE = 2; |
|
89 |
||
90 |
/** |
|
91 |
* alert level indicating immediate attention is required (ex. battery level at 1%) |
|
92 |
*/ |
|
93 |
public static final int ALERT_CRITICAL = 3; |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
94 |
/** |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
95 |
* virtual keyboard status indicating normal show and hide operation |
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
96 |
*/ |
50 | 97 |
public static final int VK_NORMAL = 1; |
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
98 |
|
50 | 99 |
/** |
100 |
* virtual keyboard status indicating keyboard is always visible |
|
101 |
*/ |
|
102 |
public static final int VK_ALWAYS_ON = 2; |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
103 |
|
50 | 104 |
/** |
105 |
* virtual keyboard status indicating keyboard is always hidden |
|
106 |
*/ |
|
107 |
public static final int VK_ALWAYS_OFF = 3; |
|
108 |
||
109 |
/** |
|
110 |
* Constructs a new instance of this class. Non-public to prevent |
|
111 |
* instantiation outside this package. |
|
112 |
* |
|
113 |
*/ |
|
114 |
MobileDevice () { |
|
115 |
||
116 |
(getDisplay()).syncExec(new Runnable() { |
|
117 |
public void run() { |
|
118 |
handleMobileDevice = Internal_PackageSupport.initializeMobileDevice( |
|
119 |
Internal_PackageSupport.getDisplayInstance()); |
|
120 |
if (handleMobileDevice == 0) { |
|
121 |
SWT.error(SWT.ERROR_NO_HANDLES); |
|
122 |
} |
|
123 |
OS.MobileDevice_createFlipWatch(handleMobileDevice); |
|
124 |
} |
|
125 |
}); |
|
126 |
mobileDeviceListeners = new Vector(); |
|
127 |
isOpen = true; |
|
128 |
} |
|
129 |
||
130 |
private static Display getDisplay(){ |
|
131 |
Display display = Internal_PackageSupport.getDisplayInstance(); |
|
132 |
||
133 |
// Following if-statement (getting default display) should be removed |
|
134 |
// if agreed that MobileDevice shouldn't create the display. |
|
135 |
if(display==null){ |
|
136 |
display = Display.getDefault(); |
|
137 |
} |
|
138 |
||
139 |
if(display == null || display.isDisposed()){ |
|
140 |
SWT.error(SWT.ERROR_DEVICE_DISPOSED); |
|
141 |
} |
|
142 |
return display; |
|
143 |
} |
|
144 |
||
145 |
private void sendMobileDeviceChangedEvent(int eventType) { |
|
146 |
// MobileDevice changed event for open and closed |
|
147 |
int count = mobileDeviceListeners.size(); |
|
148 |
for (int i = 0; i <count; ++i) { |
|
149 |
MobileDeviceEvent event = new MobileDeviceEvent(this); |
|
150 |
event.type = eventType; |
|
151 |
MobileDeviceListener listener = (MobileDeviceListener) mobileDeviceListeners.elementAt(i); |
|
152 |
listener.deviceChanged(event); |
|
153 |
} |
|
154 |
} |
|
155 |
||
156 |
void qt_swt_event_mobiledevice_changed(boolean aStatus) { |
|
157 |
// update MobileDevice status to opened/closed |
|
158 |
isOpen = aStatus; |
|
159 |
||
160 |
if(isOpen){ |
|
161 |
sendMobileDeviceChangedEvent(MobileDeviceEvent.OPENED); |
|
162 |
}else{ |
|
163 |
sendMobileDeviceChangedEvent(MobileDeviceEvent.CLOSED); |
|
164 |
} |
|
165 |
} |
|
166 |
||
167 |
void qt_swt_event_mobiledevice_screen_activate(boolean aStatus) { |
|
168 |
||
169 |
if(screens.length > 0 && activeScreenId<screens.length){ |
|
170 |
if(aStatus){ |
|
171 |
// update the active screen |
|
172 |
activeScreenId = OS.getScreenDeviceNumber(); |
|
173 |
//forward to screen activated event to new active screen |
|
174 |
screens[activeScreenId].internal_sendScreenEventActivated(); |
|
175 |
}else { |
|
176 |
//forward to screen deactivated event to old active screen |
|
177 |
screens[activeScreenId].internal_sendScreenEventDeactivated(); |
|
178 |
} |
|
179 |
} |
|
180 |
} |
|
181 |
||
182 |
void qt_swt_event_mobiledevice_orientationchanged() { |
|
183 |
activeScreenId = OS.getScreenDeviceNumber(); |
|
184 |
if(activeScreenId<screens.length){ |
|
185 |
// forward to orientation change event to active screen |
|
186 |
screens[activeScreenId].internal_sendOrientationScreenChanged(); |
|
187 |
} |
|
188 |
} |
|
189 |
||
190 |
private void sendMobileDeviceScreenChangedEvent(int eventType, Screen screen) { |
|
191 |
int count = mobileDeviceListeners.size(); |
|
192 |
for (int i = 0; i <count; ++i) { |
|
193 |
MobileDeviceEvent event = new MobileDeviceEvent(this); |
|
194 |
event.type = eventType; |
|
195 |
event.data = screen; |
|
196 |
event.feature = screen; |
|
197 |
MobileDeviceListener listener = (MobileDeviceListener) mobileDeviceListeners.elementAt(i); |
|
198 |
listener.screenChanged(event); |
|
199 |
} |
|
200 |
} |
|
201 |
||
202 |
void qt_signal_screen_changed(int aCount) { |
|
203 |
int type = 0; |
|
204 |
Screen screen = null; |
|
205 |
Screen []newScreens = new Screen[aCount]; |
|
206 |
||
207 |
// if getScreen is not called and if still want |
|
208 |
// screen changed event in the MobileDevice |
|
209 |
if(screens.length==0){ |
|
210 |
getScreens(); |
|
211 |
} |
|
212 |
||
213 |
if(screens.length > aCount){ |
|
214 |
// screen removed |
|
215 |
int screenHandle = 0; |
|
216 |
for(int j=0; j<screens.length; j++) { |
|
217 |
// found removed screen |
|
218 |
boolean found = false; |
|
219 |
for(int i=0; i<aCount; i++) { |
|
220 |
screenHandle = OS.QDesktopWidget_screen(desktopWidgetHandle, i); |
|
221 |
if(screens[j].screenHandle== screenHandle){ |
|
222 |
newScreens[i] = screens[j]; |
|
223 |
newScreens[i].id = i; |
|
224 |
found = true; |
|
225 |
break; |
|
226 |
} |
|
227 |
} |
|
228 |
if(!found){ |
|
229 |
screen = screens[j]; |
|
230 |
screens[j].internal_dispose(); |
|
231 |
} |
|
232 |
} |
|
233 |
screens = new Screen[aCount]; |
|
234 |
// remove detached screen from 'screens' |
|
235 |
System.arraycopy(newScreens, 0, screens, 0, aCount); |
|
236 |
type = MobileDeviceEvent.REMOVED; |
|
237 |
} else if( screens.length < aCount){ |
|
238 |
// screen attached |
|
239 |
for(int i=0; i<aCount; i++) { |
|
240 |
// found added screen |
|
241 |
int screenHandle = OS.QDesktopWidget_screen(desktopWidgetHandle, i); |
|
242 |
boolean found=false; |
|
243 |
for(int j=0; j<screens.length; j++) { |
|
244 |
if(screens[j].screenHandle== screenHandle){ |
|
245 |
newScreens[i] = screens[j]; |
|
246 |
newScreens[i].id = i; |
|
247 |
found = true; |
|
248 |
break; |
|
249 |
} |
|
250 |
} |
|
251 |
if(!found){ |
|
252 |
screen = screens[i]; |
|
253 |
newScreens[i] = new Screen(i, desktopWidgetHandle); |
|
254 |
} |
|
255 |
} |
|
256 |
screens = new Screen[aCount]; |
|
257 |
// add attached screen to 'screens' |
|
258 |
System.arraycopy(newScreens, 0, screens, 0, aCount); |
|
259 |
type = MobileDeviceEvent.ADDED; |
|
260 |
} |
|
261 |
sendMobileDeviceScreenChangedEvent(type, screen); |
|
262 |
activeScreenId = OS.getScreenDeviceNumber(); |
|
263 |
} |
|
264 |
||
265 |
private static void hookEvents() { |
|
266 |
int screenSignalProxy = OS.SignalHandler_new(desktopWidgetHandle, OS.QSIGNAL_QDESKTOPWIDGET_SCREENCOUNTCHANGED); |
|
267 |
OS.QObject_connectOrThrow(desktopWidgetHandle, "screenCountChanged(int)", screenSignalProxy, |
|
268 |
"widgetSignal(int)", OS.QT_AUTOCONNECTION); |
|
269 |
} |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
270 |
|
50 | 271 |
/** |
272 |
* Adds the listener to the collection of listeners who will be notified when a device |
|
273 |
* configuration change occurs, by calling one of the methods defined in the |
|
274 |
* <code>MobileDeviceListener</code> interface. |
|
275 |
* <p> |
|
276 |
* <code>screenChanged</code> is called when a monitor configuration changes.<br> |
|
277 |
* <code>inputChanged</code> is called when an input configuration changes.<br> |
|
278 |
* <code>deviceChanged</code> is called when the device is opened or closed.<br> |
|
279 |
* |
|
280 |
* @param listener instance called when device events occur |
|
281 |
* |
|
282 |
* @exception IllegalArgumentException <ul> |
|
283 |
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li> |
|
284 |
* </ul> |
|
285 |
* @exception SWTError <ul> |
|
286 |
* <li>ERROR_ITEM_NOT_ADDED - if the operation fails because of an operating system failure</li> |
|
287 |
* </ul> |
|
288 |
* |
|
289 |
* @see #removeMobileDeviceListener |
|
290 |
* @see MobileDeviceListener |
|
291 |
*/ |
|
292 |
public void addMobileDeviceListener(MobileDeviceListener listener) { |
|
293 |
if (listener == null) { |
|
294 |
SWT.error (SWT.ERROR_NULL_ARGUMENT); |
|
295 |
} |
|
296 |
mobileDeviceListeners.addElement(listener); |
|
297 |
} |
|
298 |
||
299 |
||
300 |
/** |
|
301 |
* Alerts the user using device specific mechanisms such as sounds, flashing, or |
|
302 |
* vibration. <code>Level</code> must be one of ALERT_LOW_IMPORTANCE, |
|
303 |
* ALERT_HIGH_IMPORTANCE, or ALERT_CRITICAL. The method maps these levels to |
|
304 |
* device specific features that may also be dependent upon user configuration |
|
305 |
* or current profile. |
|
306 |
* |
|
307 |
* @param level |
|
308 |
* constant describing the importance of the alert |
|
309 |
* |
|
310 |
* @exception IllegalArgumentException |
|
311 |
* <ul> |
|
312 |
* <li>ERROR_INVALID_ARGUMENT - if level is not one of the |
|
313 |
* allowed class constants</li> |
|
314 |
* </ul> |
|
315 |
* |
|
316 |
* @see #ALERT_LOW_IMPORTANCE |
|
317 |
* @see #ALERT_HIGH_IMPORTANCE |
|
318 |
* @see #ALERT_CRITICAL |
|
319 |
*/ |
|
320 |
public void alert(int level) { |
|
321 |
if ( level != ALERT_LOW_IMPORTANCE && |
|
322 |
level != ALERT_HIGH_IMPORTANCE && |
|
323 |
level != ALERT_CRITICAL) { |
|
324 |
SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
|
325 |
} |
|
326 |
alertLevel = level; |
|
327 |
(getDisplay()).syncExec(new Runnable() { |
|
328 |
public void run() { |
|
329 |
if(alertLevel == ALERT_LOW_IMPORTANCE){ |
|
330 |
OS.QApplication_beep(); |
|
331 |
}else if(alertLevel == ALERT_HIGH_IMPORTANCE){ |
|
332 |
OS.MobileDevice_flashLights(handleMobileDevice, 3000); |
|
333 |
OS.MobileDevice_vibration(handleMobileDevice, 3000); |
|
334 |
}else if(alertLevel == ALERT_CRITICAL){ |
|
335 |
OS.QApplication_beep(); |
|
336 |
OS.MobileDevice_flashLights(handleMobileDevice, 3000); |
|
337 |
OS.MobileDevice_vibration(handleMobileDevice, 3000); |
|
338 |
} |
|
339 |
||
340 |
} |
|
341 |
}); |
|
342 |
} |
|
343 |
||
344 |
||
345 |
/** |
|
346 |
* Returns an array of Input objects describing the input features available to the device. |
|
347 |
* The return value may be <code>null</code> if there are no input features available. |
|
348 |
* |
|
349 |
* @exception SWTError <ul> |
|
350 |
* <li>ERROR_CANNOT_GET_SELECTION - if the operation fails because |
|
351 |
* of an operating system failure</li> |
|
352 |
* </ul> |
|
353 |
* |
|
354 |
* @see Input |
|
355 |
*/ |
|
356 |
public Input[] getInputs() { |
|
357 |
if(inputs == null) { |
|
358 |
try { |
|
359 |
(getDisplay()).syncExec(new Runnable() { |
|
360 |
public void run() { |
|
361 |
int mask = OS.getHwInputs(); |
|
362 |
int nbInputs = 0; |
|
363 |
||
364 |
// finding out number of keyboards available |
|
365 |
if((mask & OS.SYMBIAN_KEYBOARD_FULL)!=0){ |
|
366 |
nbInputs+=2; |
|
367 |
} |
|
368 |
||
369 |
if((mask & OS.SYMBIAN_KEYBOARD_KEYPAD)!=0){ |
|
370 |
nbInputs+=2; |
|
371 |
} |
|
372 |
// create java counter part of Inputs and |
|
373 |
// add location and type |
|
374 |
inputs = new Input[nbInputs]; |
|
375 |
int i=0; |
|
376 |
int location; |
|
377 |
if((mask & OS.SYMBIAN_KEYBOARD_FULL)!=0){ |
|
378 |
if((mask & OS.SYMBIAN_KEYBOARD_KEYPAD)!=0){ |
|
379 |
location = MobileDevice.INTERNAL; |
|
380 |
} else { |
|
381 |
location = MobileDevice.LOCAL; |
|
382 |
} |
|
383 |
inputs[i] = new Input(i); |
|
384 |
inputs[i].setLocation(location); |
|
385 |
inputs[i].setType(Input.SOFTKEYS); |
|
386 |
i+=1; |
|
387 |
inputs[i] = new Input(i); |
|
388 |
inputs[i].setLocation(location); |
|
389 |
inputs[i].setType(Input.FULL_KEYBOARD); |
|
390 |
i+=1; |
|
391 |
} |
|
392 |
||
393 |
if((mask & OS.SYMBIAN_KEYBOARD_KEYPAD)!=0){ |
|
394 |
if((mask & OS.SYMBIAN_KEYBOARD_FULL)!=0){ |
|
395 |
location = MobileDevice.EXTERNAL; |
|
396 |
} else { |
|
397 |
location = MobileDevice.LOCAL; |
|
398 |
} |
|
399 |
inputs[i] = new Input(i); |
|
400 |
inputs[i].setLocation(location); |
|
401 |
inputs[i].setType(Input.SOFTKEYS); |
|
402 |
i+=1; |
|
403 |
inputs[i] = new Input(i); |
|
404 |
inputs[i].setLocation(location); |
|
405 |
inputs[i].setType(Input.KEYPAD); |
|
406 |
} |
|
407 |
} |
|
408 |
}); |
|
409 |
} catch(Throwable e) { |
|
410 |
SWT.error(SWT.ERROR_CANNOT_GET_SELECTION); |
|
411 |
} |
|
412 |
} |
|
413 |
return inputs; |
|
414 |
} |
|
415 |
||
416 |
||
417 |
/** |
|
418 |
* Returns an array of Screen objects describing the display features available to the device. |
|
419 |
* The return value may be <code>null</code> if there are no display screens available. |
|
420 |
* |
|
421 |
* @exception SWTError <ul> |
|
422 |
* <li>ERROR_CANNOT_GET_SELECTION - if the operation fails because |
|
423 |
* of an operating system failure</li> |
|
424 |
* </ul> |
|
425 |
* |
|
426 |
* @see Screen |
|
427 |
*/ |
|
428 |
public Screen[] getScreens() { |
|
429 |
if(screens == null) { |
|
430 |
try { |
|
431 |
(getDisplay()).syncExec(new Runnable() { |
|
432 |
public void run() { |
|
433 |
int nbScreens = OS.QDesktopWidget_screenCount(desktopWidgetHandle); |
|
434 |
activeScreenId = OS.getScreenDeviceNumber(); |
|
435 |
screens = new Screen[nbScreens]; |
|
436 |
for(int i=0; i<nbScreens; i++) { |
|
437 |
screens[i] = new Screen(i, desktopWidgetHandle); |
|
438 |
} |
|
439 |
} |
|
440 |
}); |
|
441 |
} catch(Throwable e) { |
|
442 |
SWT.error(SWT.ERROR_CANNOT_GET_SELECTION); |
|
443 |
} |
|
444 |
} |
|
445 |
return screens; |
|
446 |
} |
|
447 |
||
448 |
||
449 |
/** |
|
450 |
* Returns singleton instance of MobileDevice class. |
|
451 |
* |
|
452 |
* @return singleton of MobileDevice class. Must not be Null. |
|
453 |
* |
|
454 |
* @exception SWTError <ul> |
|
455 |
* <li>ERROR_CANNOT_GET_SELECTION - if the operation fails because of |
|
456 |
* an operating system failure</li> |
|
457 |
* </ul> |
|
458 |
*/ |
|
459 |
public static MobileDevice getMobileDevice() { |
|
460 |
if(currentMobileDevice == null) { |
|
461 |
try { |
|
462 |
currentMobileDevice = new MobileDevice(); |
|
463 |
Internal_PackageSupport.setMobileDevice(getDisplay(),currentMobileDevice); |
|
464 |
desktopWidgetHandle = OS.QApplication_desktop(); |
|
465 |
hookEvents(); |
|
466 |
} catch (Throwable e) { |
|
467 |
SWT.error(SWT.ERROR_CANNOT_GET_SELECTION); |
|
468 |
} |
|
469 |
} |
|
470 |
return currentMobileDevice; |
|
471 |
} |
|
472 |
||
473 |
||
474 |
/** |
|
475 |
* Returns whether device is opened. For devices that have no internal screens |
|
476 |
* or input features, the method always returns <code>true</code>. |
|
477 |
*/ |
|
478 |
public boolean isOpen() { |
|
479 |
getDisplay(); |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
480 |
|
50 | 481 |
return isOpen; |
482 |
} |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
483 |
|
50 | 484 |
|
485 |
/** |
|
486 |
* Call to dispose the Screen object. |
|
487 |
* |
|
488 |
*/ |
|
489 |
void internal_dispose() { |
|
490 |
if (inputs != null) { |
|
491 |
for (int i = 0; i < inputs.length; i++) { |
|
492 |
if (inputs[i] != null) { |
|
493 |
inputs[i].internal_dispose(); |
|
494 |
} |
|
495 |
} |
|
496 |
} |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
497 |
|
50 | 498 |
if (screens != null) { |
499 |
for (int i = 0; i < screens.length; i++) { |
|
500 |
if (screens[i] != null) { |
|
501 |
screens[i].internal_dispose(); |
|
502 |
} |
|
503 |
} |
|
504 |
} |
|
505 |
// actual native counter part is deleted in display |
|
506 |
currentMobileDevice = null; |
|
507 |
handleMobileDevice = 0; |
|
508 |
inputs = null; |
|
509 |
screens = null; |
|
510 |
desktopWidgetHandle = 0; |
|
511 |
} |
|
512 |
||
513 |
||
514 |
/** |
|
515 |
* Removes the listener from the collection of listeners who will be notified when a device |
|
516 |
* configuration change occurs. |
|
517 |
* |
|
518 |
* @param listener instance called when device events occur |
|
519 |
* |
|
520 |
* @exception IllegalArgumentException <ul> |
|
521 |
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li> |
|
522 |
* </ul> |
|
523 |
* @exception SWTError <ul> |
|
524 |
* <li>ERROR_ITEM_NOT_REMOVED - if the operation fails because |
|
525 |
* of an operating system failure</li> |
|
526 |
* </ul> |
|
527 |
* |
|
528 |
* @see #addMobileDeviceListener |
|
529 |
* @see MobileDeviceListener |
|
530 |
*/ |
|
531 |
public void removeMobileDeviceListener(MobileDeviceListener listener) { |
|
532 |
if (listener == null) { |
|
533 |
SWT.error (SWT.ERROR_NULL_ARGUMENT); |
|
534 |
} |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
535 |
|
50 | 536 |
//remove listener |
537 |
//Remove method of Vector class never fails, |
|
538 |
//so ERROR_ITEM_NOT_REMOVED could never be thrown. |
|
539 |
mobileDeviceListeners.removeElement(listener); |
|
540 |
} |
|
541 |
||
542 |
/** |
|
543 |
* Sets the status of the system virtual keyboard (if one is available). |
|
544 |
* By default, or when status is set to VK_NORMAL, a system virtual keyboard |
|
545 |
* is displayed when a widget capable of text input gains focus and is |
|
546 |
* hidden when that widget looses focus. However, there are cases where |
|
547 |
* an application may wish to continuously display the virtual keyboard |
|
548 |
* or always keep it hidden. Setting the status to VK_ALWAYS_ON or VK_ALWAYS_OFF |
|
549 |
* will accomplish this and the effect is immediate. Changing focus will |
|
550 |
* then have no affect on the virtual keyboard. Note: By default, widgets which |
|
551 |
* normally accept input but are set to <i>read only</i> do not cause the |
|
552 |
* the virtual keyboard to display. |
|
553 |
* |
|
554 |
* @param status virtual keyboard mode. One of VK_NORMAL, VK_ALWAYS_ON, VK_ALWAYS_OFF |
|
555 |
* |
|
556 |
* @exception IllegalArgumentException <ul> |
|
557 |
* <li>ERROR_INVALID_ARGUMENT - if the status parameter is not valid</li> |
|
558 |
* </ul> |
|
559 |
* |
|
560 |
* @see #VK_NORMAL |
|
561 |
* @see #VK_ALWAYS_ON |
|
562 |
* @see #VK_ALWAYS_OFF |
|
563 |
*/ |
|
564 |
public void setVKStatus(int status){ |
|
565 |
||
566 |
} |
|
21
2a9601315dfc
Revision: v2.1.22
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
567 |
} |