|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Object | +--com.nttdocomo.ui.Frame | +--com.nttdocomo.ui.Canvas
低レベルAPIのための表示面を定義します。 キャンバス クラスは、 低レベル API で使用するフレームクラスです。 キャンバスは、スクロール機能を持ちません。
Panel
,
Dialog
フィールドの概要 | |
static int |
IME_CANCELED
IMEイベントの通知において、入力がキャンセルされたことを表します(=1)。 |
static int |
IME_COMMITTED
IMEイベントの通知において、入力が確定したことを表します(=0)。 |
クラス com.nttdocomo.ui.Frame から継承したフィールド |
SOFT_KEY_1, SOFT_KEY_2 |
コンストラクタの概要 | |
Canvas()
キャンバスオブジェクトを生成します。 |
メソッドの概要 | |
Graphics |
getGraphics()
キャンバスに描画するためのグラフィクスオブジェクトを取得します。 |
int |
getKeypadState()
キーパッド状態を返すメソッドです。 |
int |
getKeypadState(int group) [iアプリオプションAPI]
キーのグループを指定してキーパッド状態を取得します。 |
void |
imeOn(String text,
int displayMode,
int inputMode)
キャンバスにおいてIMEを起動します。 |
abstract void |
paint(Graphics g)
キャンバスに表示するために使用するメソッドです。 |
void |
processEvent(int type,
int param)
低レベルイベントが通知されたときに呼ばれるメソッドです。 |
void |
processIMEEvent(int type,
String text)
IMEイベントが通知されたときに呼ばれるメソッドです。 |
void |
repaint()
キャンバス全体を再描画することを指示します。 |
void |
repaint(int x,
int y,
int width,
int height)
キャンバスの一部の矩形領域を再描画することを指示します。 |
クラス com.nttdocomo.ui.Frame から継承したメソッド |
getHeight, getWidth, setBackground, setSoftLabel |
クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
public static final int IME_COMMITTED
processIMEEvent
メソッドのtype引数として使用されます。
public static final int IME_CANCELED
processIMEEvent
メソッドのtype引数として使用されます。
コンストラクタの詳細 |
public Canvas()
メソッドの詳細 |
public Graphics getGraphics()
public abstract void paint(Graphics g)
引数で渡されたグラフィックスオブジェクトは、アプリケーションプログラマが Graphics.dispose メソッドで破棄してはなりません。 paint メソッドの呼出し元が、機種依存の処理をしたあとで dispose メソッドを呼び出して破棄します。 アプリケーションプログラマが disposeメソッドを呼び出した場合の振舞は、機種依存です。
g
- 描画に使用する Graphics オブジェクトが渡されます。public void repaint()
public void repaint(int x, int y, int width, int height)
x
- 矩形の左上のX座標を指定します。y
- 矩形の左上のY座標を指定します。width
- 矩形の幅を指定します。height
- 矩形の高さを指定します。
IllegalArgumentException
- 引数 width, height のどちらかまたは両方に 0 未満の値が指定された場合に発生します。
public void processEvent(int type, int param)
type
- イベントのタイプが渡されます。param
- イベントのパラメータが渡されます。
パラメータの意味はイベントによって異なります。
パラメータを持たないイベントの場合は、0が渡されます。
詳細は、「ユーザインタフェース機能仕様書」を参照してください。public int getKeypadState()
戻り値の各ビットの位置がDisplayクラスで定義されているキーに対応します。 ビットとキーの対応は、1<<(Displayクラスで定義されているキーの値) となり、 MSBが31で、LSBが0に対応します。たとえば、KEY_0 に対応するビットは、ビット0で、 KEY_1に対応するビットは、ビット1です。
b31 b2 b1 b0 +---+---+-------------||------+---+---+---+ | | | | | | | +---+---+-------------||------+---+---+---+
押された状態になっているキーに対応するビットは1に、 押されていない状態になっているキーに対応するビットは、0になっています。
アプリケーションプログラマは、タイマドリブンの処理中で、このメソッドを呼ぶか、 KEY_PRESS_EVENT, KEY_RELEASE_EVENTのイベントが発生したときに、このメソッドを 呼ぶかして、複数のキーの状態を取得します。
キャンバスが表示されている、いないに関わらず、このメソッドを呼び出した場合、 現在のキーパッドの状態が戻り値として返されます。
[DoJa-3.0 (505iS) 以降]
このメソッドは、getKeypadState(0)
を呼び出した場合と同じ結果を返します。
public int getKeypadState(int group) [iアプリオプションAPI]
キーのグループを指定してキーパッド状態を取得します。
Display
クラスで定義されるキーについて、
それぞれ (キーの値 >> 5)
がグループとなります。
このメソッドでは、引数で指定されたグループに含まれるキー(最大 32 個)の状態を取得します。
戻り値の各ビットの位置がDisplayクラスで定義されているキーに対応します。
ビットとキーの対応は、(1 << (キーの値 - グループ * 32))
となり、
MSBが (31 + グループ * 32)
で、LSBが (0 + グループ * 32)
に対応します。
例えば、グループ 0 を指定した場合、
KEY_0 に対応するビットは b0、KEY_1 に対応するビットは b1、KEY_SELECT に対応するビットは b20 になります。
また、グループ 1 を指定した場合、
KEY_CLEAR に対応するビットは b0、KEY_MAIL に対応するビットは b1、KEY_SUB1 に対応するビットは b18 になります。
b31 b2 b1 b0 +---+---+-------------||------+---+---+---+ | | | | | | | +---+---+-------------||------+---+---+---+
押された状態になっているキーに対応するビットは1に、 押されていない状態になっているキーに対応するビットは0になっています。
アプリケーションプログラマは、タイマドリブンの処理中でこのメソッドを呼ぶか、
Display.KEY_PRESSED_EVENT
, Display.KEY_RELEASED_EVENT
のイベントが発生したときにこのメソッドを呼ぶかして、
複数のキーの状態を取得します。
なお、グループ 0 以外のキーについては PhoneSystem.DEV_KEYPAD
属性を設定しないと
Display.KEY_PRESSED_EVENT
, Display.KEY_RELEASED_EVENT
のイベントも発生しませんし、
このメソッドによるキーパッド状態の取得も行うことができません。
キャンバスが表示されている、いないに関わらず、このメソッドを呼び出した場合、 現在のキーパッドの状態が戻り値として返されます。
group
- キーパッド状態を取得するキーのグループを指定します。
IllegalArgumentException
- 引数 group に 0 未満の値が指定された場合に発生します。
PhoneSystem.DEV_KEYPAD
public void imeOn(String text, int displayMode, int inputMode)
このメソッドはブロックしないメソッドです。
IMEでの入力が完了するまで待つことはありません。
IMEでの入力が完了すると(キャンセルも含みます)、
processIMEEvent
メソッドが呼ばれます。
このキャンバスがカレントフレームでない場合には、 このメソッドの呼び出しは無視されます。 ダイアログが表示されている場合も同様です。
text
- IMEに渡す初期文字列を指定します。
nullの場合、空文字列("")として扱われます。displayMode
- 文字列の表示モードを指定します。
TextBoxクラスのDISPLAY_ANY
またはDISPLAY_PASSWORD
を指定します。inputMode
- 初期入力モードを指定します。
TextBoxクラスのNUMBER
、
ALPHA
、
KANA
のいずれかを指定します。
IllegalStateException
- 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
IllegalArgumentException
- 引数 displayMode、inputMode
に不正な値が指定された場合に発生します。
UIException
- 既にIMEが起動されている場合に発生します(BUSY_RESOURCE)。
TextBox
public void processIMEEvent(int type, String text)
このメソッドはimeOn
メソッドにより起動されたIMEへの入力が確定した場合、
またはキャンセルされた場合に呼び出されます。
入力がキャンセルされた場合には、 引数 text はimeOnメソッドで渡した文字列です。 null を渡した場合、nullが返ります。 入力が確定された場合には、引数 text に入力された文字列が返ります。 何も入力されなかった場合、空文字列("")が渡されます。
type
- イベントのタイプが渡されます。text
- 入力された文字列が渡されます。
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
NTT DoCoMo,Inc.
本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ(その他に許諾者がある場合は当該許諾者も含めて)の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。
Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。
「iモード」、「iアプリ/アイアプリ」、「i-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。