Unofficial
"CLDC 1.1
+ MIDP 2.0"
API Reference.
(日本語版)

javax.microedition.lcdui
インタフェース ItemStateListener


public interface ItemStateListener

このインタフェースは Form スクリーン内の対話型アイテムの内部状態が変化したことを示すイベントを受け取る必要があるアプリケーションが実装すべき定義を提供しています。

導入されたバージョン:
MIDP 1.0
関連項目:
Form.setItemStateListener(ItemStateListener)

メソッドの概要
 void itemStateChanged(Item item)
          アイテムの内部状態がユーザーによって変更されたときに呼ばれます。
 

メソッドの詳細

itemStateChanged

void itemStateChanged(Item item)

アイテムの内部状態がユーザーによって変更されたときに呼ばれます。 内部状態が変更されるのは以下の場合です。

それがいつ、アイテムに新しい値に変更されたとするかは機器によって判断が異なります。 特に TextField の編集を行う実装は機器によって大きく異なります。

一般に、全ての変更が行われた後にリスナーが呼ばれるだろうということは仮定できません。 しかし、アイテムの値が変更された場合、他のアイテムの変更がリスナーに通知されたりコマンドが CommandListener へ通知されたりする前に、リスナーへ通知されます。 入力フォーカスの概念を持っている実装では、状態が変更されたアイテムからフォーカスが移動する前にリスナーを呼び出すべきです。 アイテムの値が実際に変更された場合のみ、リスナーを呼び出すべきです。

アプリケーションが対話型アイテムの値を変更する場合、リスナーは呼び出されません。

パラメータ:
item - 変更されたアイテムが渡されます。

Unofficial
"CLDC 1.1
+ MIDP 2.0"
API Reference.
(日本語版)

公式仕様書原文の著作権表記等(※):

Mobile Information Device Profile Specification ("Specification")
Version: 2.0
Status: FCS
Release: November 5, 2002

Copyright 2002 Sun Microsystems, Inc. and Motorola, Inc.
All rights reserved.
※ただしこの API リファレンスは英語仕様を一語一句正確に翻訳したものではなく、一度私が英語の仕様原文を読んだ上で元の意味と構造をなるべく保つように書き起こしたものです。このため一部は完全に異なる説明となっています。また CLDC 1.1 部分は同仕様の範囲外であるため、まったく参考とはしていません。

※仕様書のライセンス上、問題は無いと考えておりますが、万が一問題があるとお考えの関係者の方がいらっしゃいましたらメールにて連絡をいただけると幸いに存じます(第一言語に日本語、第二言語に英語を希望しますが、返信は基本的に日本語で行います)。

この API リファレンスは仕様書の日本語版という位置づけでは作成していませんし、仕様書ほど厳格でもありません。MUST、SHOULD、MAY などの仕様の条件を強調する文を維持していません(反映すらしていない個所もあります)。仮想マシンおよび MIDP の実装のために使用することは避けてください。そのような用途には必ず公式仕様書原文そのものを用いるべきです。
この API リファレンスに記載されている内容は"さかきけい"が Sun Microsystems, Inc や Motorola, Inc、Java Community Process が公開している各種公式資料を元に、独自に調査・編集したものであり、Sun Microsystems, Inc や Motorola, Inc、Java Community Process 等とは一切関係ありません。したがってこの API リファレンスに関する問い合わせを関係各社等に対して行うことを固く禁じます。
また、記載された内容には既知か否かに関らず誤りが含まれる可能性があり、一切保証はありません。本 API リファレンスを使用した結果、不利益が生じたとしても"さかきけい"は一切の責任を負いません。
許可無く公開/非公開および Internet/Intranet/LAN を問わず他サイトに転載すること、複写および複製すること、ローカル・ファイル等に保存することを禁じます。


Copyright© 2001-2002,2005-2009,2011 by KEI SAKAKI.
ALL RIGHTS RESERVED.
無断転載を禁じます。

Unofficial "CLDC 1.0 + MIDP 1.0" API Reference はこちらです。