Component (DoJa 3.5 (APIリファレンス))

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

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
関連項目:: Font.getDefaultFont()

概要