javax.microedition.lcdui
クラス Spacer

java.lang.Object
  javax.microedition.lcdui.Item
      javax.microedition.lcdui.Spacer

public class Spacer
extends Item

最小サイズの占有を行う空白で、そして非対話なアイテムです。 最小の幅は Form の同じ行の中のアイテム間にフレキシブルな量の空間を設けるために使用することができます。 最小の高さは行の最小の高さを割り当てるために使用することができます。 アプリケーションは任意の整数を最小の幅あるいは高さに設定することができます。 実装は最小の幅と高さを、実装が定義する最大の値に制限することができます。

Spacer のロックされていない好ましい幅は現在の最小の幅と同じです。 ロックされていない好ましい高さは現在の最小の高さと同じです。

他のアイテムの位置を調整するのが Spacer の第一の目的であるため、非対話に制限されています。また、アプリケーションは Spacer に Command を加えることはできません。 Item に提供されるラベルの存在がデバイス特有の方法でレイアウトに影響を与える可能性があるため、Spacer のラベルは常に null に制限されています。また、アプリケーションはこれを変更することはできません。

導入されたバージョン:

MIDP 2.0

Spacer

public Spacer(int minWidth,
              int minHeight)

指定された最小サイズの新しい Spacer を作成します。 Spacer のラベルは null です。 最小サイズはゼロ以上でなければなりません。 minWidth が実装で定義された最大の幅より大きいなら、最大の幅が代わりに使用されるでしょう。 minHeight が実装で定義された最大の高さより大きいなら、最大の高さが代わりに使用されるでしょう。

パラメータ:

minWidth - 最小の幅をピクセル数で渡します。

minHeight - 最小の高さをピクセル数で渡します。

例外:

IllegalArgumentException - minWidth か minHeight のいずれかがゼロ未満の場合に throw します。

setMinimumSize

public void setMinimumSize(int minWidth,
                           int minHeight)

この Spacer の最小サイズを設定します。 Form はアイテムをこのサイズより小さくすることはできません。 最小サイズはゼロ以上でなければなりません。 minWidth が実装で定義された最大の幅より大きいなら、最大の幅が代わりに使用されるでしょう。 minHeight が実装で定義された最大の高さより大きいなら、最大の幅が代わりに使用されるでしょう。

パラメータ:

minWidth - 最小の幅をピクセル数で渡します。

minHeight - 最小の高さをピクセル数で渡します。

例外:

IllegalArgumentException - minWidth か minHeight のいずれかがゼロ未満の場合に throw します。

addCommand

public void addCommand(Command cmd)

Spacer が Command を持つことは許されていないため、このメソッドが呼ばれると常に IllegalStateException を throw します。

オーバーライド:

クラス Item 内の addCommand

パラメータ:

cmd - 追加する Command を渡します。

例外:

IllegalStateException - 常に throw します。

setDefaultCommand

public void setDefaultCommand(Command cmd)

Spacer が Command を持つことは許されていないため、このメソッドが呼ばれると常に IllegalStateException を throw します。

オーバーライド:

クラス Item 内の setDefaultCommand

パラメータ:

cmd - 設定する Command を渡します。

例外:

IllegalStateException - 常に throw します。

setLabel

public void setLabel(String label)

Spacer のラベルは null に制限されているため、このメソッドが呼ばれると常に IllegalStateException を throw します。

オーバーライド:

クラス Item 内の setLabel

パラメータ:

label - 設定するラベル文字列を渡します。

例外:

IllegalStateException - 常に throw します。