com.nttdocomo.ui
クラス Component

Object
  com.nttdocomo.ui.Component

直系の既知のサブクラス:

AnchorButton, Button, ImageButton, ImageLabel, Label, ListBox, TextBox, Ticker, VisualPresenter

public abstract class Component

extends Object

コンポーネント (部品) を定義します。 コンポーネントクラスは、 高レベル API の部品を表す抽象クラスです。

コンストラクタの概要

Component()
アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの概要

int	getHeight() コンポーネントの高さを取得します。
int	getWidth() コンポーネントの幅を取得します。
int	getX() コンポーネントの X 座標を取得します。
int	getY() コンポーネントの Y 座標を取得します。
void	setBackground(int c) コンポーネントの背景色を設定します。
void	setFont(Font f) このコンポーネントの文字列描画に使用するフォントを設定します。
void	setForeground(int c) コンポーネントの前景色を設定します。
void	setLocation(int x, int y) コンポーネントの位置を設定します。
void	setSize(int width, int height) コンポーネントの大きさを設定します。
void	setVisible(boolean b) コンポーネントを表示するかどうかを設定します。

クラス Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

Component

public Component()

アプリケーションが直接このクラスのインスタンスを生成することはできません。
このコンストラクタにより、コンポーネントは表示可能に設定されます。 表示可能・表示不能を設定するには、setVisible メソッドを使用します。

メソッドの詳細

setVisible

public void setVisible(boolean b)

コンポーネントを表示するかどうかを設定します。 デフォルトではコンポーネントは表示されます。
[DoJa-1.0 のみ]
コンポーネントが画面に表示された状態で設定を行った場合の動作 （例えば再レイアウトされるかどうか等）は機種依存です。
[DoJa-2.0 以降]
コンポーネントが画面に表示された状態で設定を行った場合、 再レイアウトは行われませんが、画面の更新は行われます。 表示不能に設定した場合もそこにコンポーネントがあるものとしてレイアウトが行われるため、 画面では隙間が空いたように見えます。

[DoJa-1.0 のみ]
フォーカスをもっているコンポーネントがこのメソッドで表示不能になった場合、 獲得していたフォーカスを解放します。フォーカスはつぎにフォーカスを獲得すべきコンポーネントに 移行しますが、どのコンポーネントがフォーカスを獲得するかは 設定されているフォーカスマネージャに依存します。 したがって、フォーカスをもっているコンポーネントを表示不能にし、その直後に 表示可能にした場合、そのコンポーネントがフォーカスを持っている保証はありません。
[DoJa-2.0 以降]
フォーカスをもっているコンポーネントがこのメソッドで表示不能になった場合は、 獲得していたフォーカスを解放し、いずれのコンポーネントもフォーカスを取得していない状態となります。 この時、フォーカス制御キーによる操作が行われるとフォーカスを獲得していたコンポーネントを起点としてフォーカス移動が行われます。

パラメータ:

b - コンポーネントを表示可能にする場合は true、表示不能にする場合は false を指定します。

setBackground

public void setBackground(int c)

コンポーネントの背景色を設定します。 コンポーネント生成時には、機種依存の色が設定されます。
このコンポーネントが表示されているときに、背景色が変更された場合、 その結果は直ちに反映されます。

パラメータ:

c - 背景色を指定します。

例外:

IllegalArgumentException - 引数 c に不正な値が指定された場合に発生します。

setForeground

public void setForeground(int c)

コンポーネントの前景色を設定します。 コンポーネント生成時には、背景色とコントラストのある機種依存の色が設定されます。
このコンポーネントが表示されているときに、前景色が変更された場合、 その結果は直ちに反映されます。

パラメータ:

c - 前景色を指定します。

例外:

IllegalArgumentException - 引数 c に不正な値が指定された場合に発生します。

setLocation

public void setLocation(int x,
                        int y)

コンポーネントの位置を設定します。
[DoJa-1.0 のみ]
ミニマムスペックでは、そのコンポーネントがのっているパネルが 表示されていないときだけ、位置の設定が可能です。 表示されているときに設定できるかどうかは機種依存です。
[DoJa-2.0 以降]
そのコンポーネントがのっているパネルのレイアウトマネージャが null に設定されているときのみ、位置の設定が可能です。 そのコンポーネントがのっているパネルが表示されているときは、 再レイアウトと画面の更新が行われます。

パラメータ:

x - コンポーネントの X 座標を指定します。

y - コンポーネントの Y 座標を指定します。

setSize

public void setSize(int width,
                    int height)

コンポーネントの大きさを設定します。 スクリーンのサイズよりも大きなサイズを引数に指定できますが、 そのとき、その指定を無視してサイズをスクリーンサイズにするかどうかは、 機種依存です。
[DoJa-1.0 のみ]
ミニマムスペックでは、そのコンポーネントがのっているパネルが 表示されていないときだけ、サイズの設定が可能です。 表示されているときに設定できるかどうかは機種依存です。
[DoJa-2.0 以降]
いつでもサイズの設定が可能です。 そのコンポーネントがのっているパネルが表示されているときは、 再レイアウトと画面の更新が行われます。

パラメータ:

width - コンポーネントの幅を指定します。

height - コンポーネントの高さを指定します。

例外:

IllegalArgumentException - 引数 width, height のどちらかまたは両方に 0 未満の値が指定された場合に発生します。

getX

public int getX()

コンポーネントの X 座標を取得します。

戻り値:

コンポーネントの X 座標を返します。

getY

public int getY()

コンポーネントの Y 座標を取得します。

戻り値:

コンポーネントの Y 座標を返します。

getWidth

public final int getWidth()

コンポーネントの幅を取得します。

戻り値:

コンポーネントの幅を返します。

getHeight

public final int getHeight()

コンポーネントの高さを取得します。

戻り値:

コンポーネントの高さを返します。

setFont

public void setFont(Font f)

このコンポーネントの文字列描画に使用するフォントを設定します。 デフォルトでは、コンポーネントが生成されたときのFont クラスの getDefaultFont メソッドが返すフォントが設定されています。 引数に null が指定された場合は、例外が発生します。 文字列描画を伴わないコンポーネントでは無視されます。

パラメータ:

f - 描画に使用するフォントを指定します。

例外:

NullPointerException - 引数 f に null が指定された場合に発生します。

導入されたバージョン:

DoJa-3.0 (505i)

関連項目:

Font.getDefaultFont()