author | Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> |
Mon, 21 Jun 2010 15:32:50 +0300 | |
branch | RCL_3 |
changeset 46 | 4376525cdefb |
permissions | -rw-r--r-- |
46
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
1 |
/* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
2 |
* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies). |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
3 |
* All rights reserved. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
4 |
* This component and the accompanying materials are made available |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
5 |
* under the terms of "Eclipse Public License v1.0" |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
6 |
* which accompanies this distribution, and is available |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
7 |
* at the URL "http://www.eclipse.org/legal/epl-v10.html". |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
8 |
* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
9 |
* Initial Contributors: |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
10 |
* Nokia Corporation - initial contribution. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
11 |
* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
12 |
* Contributors: |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
13 |
* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
14 |
* Description: TextEditor-API alignment for Nokia-UI |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
15 |
* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
16 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
17 |
package com.nokia.mid.ui; |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
18 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
19 |
import com.nokia.mid.ui.TextEditorListener; |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
20 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
21 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
22 |
* Touch-devices can use a virtual control-panel to replace physical keys, and to facilitate |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
23 |
* textual input. The purpose of this interface is to provide some level of access and control over such a panel, when |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
24 |
* using the TextEditor-API. <p> |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
25 |
* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
26 |
* MIDlets can obtain an instance of this interface via the {@link TextEditorExtensionAccess} in the |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
27 |
* following way: |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
28 |
* <pre> |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
29 |
* TextEditor editor = com.nokia.mid.ui.TextEditor.createTextEditor("hello world", 50, TextField.ANY, 100, 100); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
30 |
* TextEditorTouchControl touchControl = ((TextEditorExtensionAccess)editor).getTouchControl(); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
31 |
* if(touchControl!=null){ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
32 |
* // this is a touch-device |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
33 |
* } |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
34 |
* else{ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
35 |
* // this is a non-touch-device |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
36 |
* } |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
37 |
* </pre> |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
38 |
* The instance is associated with the editor it has been obtained from, and controls only this editor.<p> |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
39 |
* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
40 |
* Because a control-panel covers parts of the display which would otherwise be available to the application, MIDlets may |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
41 |
* choose to only display the panel at certain times, e.g. when the editor is focussed. This is possible with |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
42 |
* {@link TextEditorTouchControl#setPanelMode(int)}. Furthermore, a panel can be positioned anywhere an the display via |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
43 |
* {@link TextEditorTouchControl#setPanelPosition(int, int)}. This interface also allows to query the size of the panel, so |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
44 |
* that applications can integrate it into the Canvas. <p> |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
45 |
* |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
46 |
* On touch-devices, the platform can make use of pointer-input to let the user interact with a TextEditor on a Canvas, without |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
47 |
* that the application knows about this. For example, if the user taps with his stylus or finger somewhere inside a visible |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
48 |
* and focussed TextEditor, the MIDlet might not receive any notification about this via the Canvas-methods pointerPressed, |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
49 |
* pointerDragged or pointerReleased. Instead, the platform could change the position of the cursor and generate the |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
50 |
* according event for the editors {@link TextEditorListener}. Or it may even just ignore this event completely. In general, |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
51 |
* an application should not expect to receive any pointer-events after a "press" inside a focussed TextEditor. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
52 |
* Under certain circumstances however, for example as a response to the {@link TextEditorTouchControl#ACTION_TRAVERSE_OUT_SCROLL_UP} |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
53 |
* or {@link TextEditorTouchControl#ACTION_TRAVERSE_OUT_SCROLL_DOWN} event, an application can decide at any time to override this |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
54 |
* behaviour, and force the platform to deliver all subsequent pointer-events to the Canvas. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
55 |
* This can be done with {@link TextEditorTouchControl#setTouchEnabled(boolean)}. Note that a TextEditor which has been touch-disabled |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
56 |
* this way will not be able to perform any interaction like cursor-positioning or scrolling via touch-input, until is has been |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
57 |
* enabled again. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
58 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
59 |
public interface TextEditorTouchControl |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
60 |
{ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
61 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
62 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
63 |
//native_const(JAVA_TEXTEDITOR) |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
64 |
//{ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
65 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
66 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
67 |
* Constant to disable the display of a keypad/control-panel |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
68 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
69 |
public static final int PANEL_OFF = 1; |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
70 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
71 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
72 |
* Constant to enable the display of a keypad/control-panel. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
73 |
* In this mode the user cannot change the position of the panel, however |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
74 |
* the MIDlet can still do so via {@link TextEditorTouchControl#setPanelPosition(int, int)} |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
75 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
76 |
public static final int PANEL_FIXED_POSITION = 2; |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
77 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
78 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
79 |
* Constant to enable the display of a keypad/control-panel. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
80 |
* In this mode, the user can change the position of the panel of the display e.g. by |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
81 |
* dragging, if this is supported by the device. Changes to the position will generate the |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
82 |
* {@link TextEditorTouchControl#ACTION_PANEL_MOVED}-event. The current panel-position is |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
83 |
* provided via {@link TextEditorTouchControl#getPanelX()} and {@link TextEditorTouchControl#getPanelY()} |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
84 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
85 |
public static final int PANEL_FLOATING = 3; |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
86 |
//} |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
87 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
88 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
89 |
* Event to indicate that the keypad/control-panel has been moved by the user |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
90 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
91 |
public static final int ACTION_PANEL_MOVED = 0x10000000; |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
92 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
93 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
94 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
95 |
* Controls the behaviour of the virtual keypad/control-panel, if the device provides one. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
96 |
* This is a hint which may be disregarded if the device does not support a virtual keypad/control-panel. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
97 |
* @param mode One of {@link TextEditorTouchControl#PANEL_OFF} {@link TextEditorTouchControl#PANEL_FIXED_POSITION} |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
98 |
* or {@link TextEditorTouchControl#PANEL_FLOATING} |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
99 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
100 |
public void setPanelMode(int mode); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
101 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
102 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
103 |
* Gets the current panel-mode |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
104 |
* @return the mode, see {@link TextEditorTouchControl#setPanelMode(int)} |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
105 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
106 |
public int getPanelMode(); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
107 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
108 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
109 |
* Sets the position of the panel on the display. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
110 |
* @param x x-position of the keypad |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
111 |
* @param y y-position of the keypad |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
112 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
113 |
public void setPanelPosition(int x, int y); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
114 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
115 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
116 |
* Gets the width of the panel |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
117 |
* @return the width |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
118 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
119 |
public int getPanelWidth(); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
120 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
121 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
122 |
* Gets the height of the panel |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
123 |
* @return the height |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
124 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
125 |
public int getPanelHeight(); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
126 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
127 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
128 |
* Gets the current x-position of the panel on the display |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
129 |
* @return the x-coordinate |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
130 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
131 |
public int getPanelX(); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
132 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
133 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
134 |
* Gets the current y-position of the panel on the display |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
135 |
* @return the y-coordinate |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
136 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
137 |
public int getPanelY(); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
138 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
139 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
140 |
* Specifies whether or not the editor will receive touch-events. This is enabled by default. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
141 |
* An editor with touch-event disabled won't be able to perform any touch-related functionality |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
142 |
* such as scrolling or positioning the cursor. It may however still be controlled via the |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
143 |
* virtual keypad/control-panel if that is enabled, or receive other input e.g. via physical |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
144 |
* keys |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
145 |
* @param enabled true to enabled touch-event, false to disable |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
146 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
147 |
public void setTouchEnabled(boolean enabled); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
148 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
149 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
150 |
* Gets the current touch-enabled state |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
151 |
* @return true if the editor is touch-enabled, false otherwise |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
152 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
153 |
public boolean isTouchEnabled(); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
154 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
155 |
/** |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
156 |
* Sets the caret as close as possible to a given x/y location. This is a hint to the implementation |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
157 |
* that may be disregarded. |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
158 |
* @param x new x-coordinate for the caret, relative to the editors origin |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
159 |
* @param y new y-coordinate for the caret, relative to the editors origin |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
160 |
*/ |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
161 |
public void setCaret(int x, int y); |
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
162 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
163 |
|
4376525cdefb
Revision: v2.1.30
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
164 |
} |