javax.microedition.lcdui
クラス Ticker

java.lang.Object
  javax.microedition.lcdui.Ticker

public class Ticker
extends Object

ディスプレイに連続的に文字をスクロールさせて表示する「ティッカーテープ（テロップ）」を表現するクラスです。 スクロールする方向および速度は実装に依存します。 ディスプレイに表示されている間、ティッカー文字列は連続的にスクロールします。 つまり、文字列がディスプレイからスクロールをし終える際に、ティッカーは最初からスクロールを再スタートします。

ティッカーを開始および終了するための API は提供されていません。 アプリケーションモデルは、ティッカーが常時連続的にスクロールしているということです。 しかし、実装はティッカーを休止させることが許されています。 例えば、消費電力を抑える目的で、ユーザーが一定時間デバイスと対話を行わなかった場合にスクロールを停止します。 この場合、実装はユーザーがデバイスと再び対話を行った場合に、ティッカーのスクロールを再開します。

同じティッカーを複数の Screen オブジェクトによって共有することができます。 これは、複数の Screen オブジェクトの setTicker(Ticker) によって設定することができます。 一般的な使用方法は、アプリケーションがその Screen 全てに同じティッカーを置くことです。 アプリケーションが同じティッカーを持っている２つの Screen を切り替える場合、望ましい結果はディスプレイの同じ位置にティッカーが表示され、同じ位置でその内容をスクロールしつづけることです。 これは、各スクリーンに置かれたティッカーがディスプレイに備わっているかのように見せます。

代替の使用方法は、アプリケーションが異なる Screen セット上に異なるティッカーを使用することです。 アプリケーションがこのモデルを実装する場合には、ティッカーは Screen クラスの属性のようなものです。 スクリーン間をユーザーがスイッチする際のメッセージとしてティッカーを更新します。

Ticker

public Ticker(String str)

初期設定する内容文字列を受け取って、新たな Ticker オブジェクトを構築します。

パラメータ:

str - Ticker に設定する文字列を渡します。

例外:

NullPointerException - str に null が渡された場合に throw します。

setString

public void setString(String str)

Ticker によって表示する文字列を設定します。 このティッカーがアクティブでディスプレイ上に表示されている場合、直ちに新しい文字列の表示を開始します。

パラメータ:

str - Ticker に設定する文字列を渡します。

例外:

NullPointerException - str に null が渡された場合に throw します。

getString

public String getString()

Ticker に現在設定されている文字列を返します。

戻り値:

Ticker に設定されている文字列を返します。