javax.microedition.lcdui
クラス Ticker

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

public class Ticker
extends Object

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

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

ティッカーのテキストは改行を含むことがあります。 ティッカーは全文を表示しなければなりません。 改行文字を表示すべきではありませんが、区切りとしては使用するかもしれません。

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

代替の使用方法は、アプリケーションが異なる Screen セット上に異なるティッカーを使用することです。 アプリケーションはティッカーを Displayable クラスの属性とし、ユーザーによってスクリーンの切り替えが行われる際に表示されているティッカーの更新を省く実装モデルを採用することができます。

導入されたバージョン:

MIDP 1.0

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()

getString

public String getString()

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

戻り値:

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

関連項目:

setString(java.lang.String)