TransparentImage (DoJa-5.0 (オプションAPIリファレンス))

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

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

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

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

com.nttdocomo.opt.ui
クラス TransparentImage

Object
  com.nttdocomo.ui.Image
      com.nttdocomo.opt.ui.TransparentImage

public abstract class TransparentImage
extends com.nttdocomo.ui.Image

透明色を持つイメージを定義します。ユーザは、イメージ中のどの色を透明色とみなすのかを自由に設定することができます。また、透明色設定を無効化することにより、非透明イメージとして扱うこともできます。 TransparentImageがどの描画メソッドで使用できるのかは機種依存です。 TransparentImageに対応していないメソッドの引数にTransparentImageオブジェクトを指定した場合には、UIException(UNSUPPORTED_FORMAT)となります。

端末によってサポートされていない場合があります。未サポートの場合、メソッドが呼び出された時点でUnsupportedOperationExceptionを発生します。

[DoJa-3.0]
基本 API の中で Image オブジェクトを引数に取るメソッドが TransparentImage に対応しているかどうかは機種依存です。 TransparentImage に対応していないメソッドの引数に TransparentImage オブジェクトを指定して呼び出した場合、特に例外は発生しませんが、描画内容については機種依存となります。

導入されたバージョン:: DoJa-2.0

コンストラクタの概要

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

メソッドの概要

static TransparentImage createTransparentImage(com.nttdocomo.ui.Image image)
           通常のイメージから透明色を持つイメージを生成します。

int getAlpha()
          このクラスのインスタンスに対して呼び出すことはできません。

com.nttdocomo.ui.Graphics getGraphics()
           このクラスのインスタンスに対して呼び出すことはできません。

int getTransparentColor()
          このクラスのインスタンスに対して呼び出すことはできません。

void setAlpha(int alpha)
          このクラスのインスタンスに対して呼び出すことはできません。

void setTransparentColor(int color)
           透明色を設定します。

void setTransparentEnabled(boolean b)
           透明色を使用するかどうかを設定します。

クラス com.nttdocomo.ui.Image から継承したメソッド

createImage, createImage, dispose, getHeight, getWidth

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

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

コンストラクタの詳細

TransparentImage

protected TransparentImage()

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

メソッドの詳細

createTransparentImage

public static TransparentImage createTransparentImage(com.nttdocomo.ui.Image image)

通常のイメージから透明色を持つイメージを生成します。デフォルトでは透明色を使用しません。なお、本メソッドに通常のイメージを継承した拡張イメージ(TransparentImage, PalettedImage など)を指定することはできません。

[DoJa-5.0 (903i) 以降]
引数に指定されたイメージに、透過色やα値の指定がなされていた場合には、それらの指定は無視されます。動作の詳細はスーパークラスの説明を参照して下さい。

[DoJa-5.0 (903i) 以降]
引数に、透過 GIF から生成されたイメージが指定された場合の振る舞いは、スーパークラスの説明とは異なり、機種依存です。

パラメータ:: image - イメージを指定します。
戻り値:: 透明色を持つイメージを生成して返します。
例外:: NullPointerException - 引数 image に null が指定された場合に発生します。; com.nttdocomo.ui.UIException - 引数 image に拡張イメージが指定された場合に発生します(UNSUPPORTED_FORMAT)。; com.nttdocomo.ui.UIException - 引数 image に既に dispose されているイメージが指定された場合に発生します(ILLEGAL_STATE)。

setTransparentEnabled

public void setTransparentEnabled(boolean b)

透明色を使用するかどうかを設定します。

[DoJa-5.0 (903i) 以降]
スーパークラスの同名メソッドの振る舞いと異なり、 setTransparentColor(int) による透明色指定は即座に反映されます。

パラメータ:: b - 透明色を使用する場合は true を、使用しない場合は false を指定します。
例外:: com.nttdocomo.ui.UIException - 既に dispose されているオブジェクトに対して呼ばれた場合に発生します(ILLEGAL_STATE)。
関連項目:: setTransparentColor(int)

setTransparentColor

public void setTransparentColor(int color)

透明色を設定します。

createTransparentImage(Image) メソッドを用いて TransparentImage オブジェクトを取得した直後の、デフォルトの透明色設定は機種依存です。
なお、透明色は Graphics.getColorOfRGB(int, int, int) メソッド等で返される端末内部表現で指定されます。したがって、端末のサポートする色数がオリジナルのイメージの色数よりも少ない場合には、減色処理によって似た色が同じ色に書換えられている場合があります。この場合、ユーザの意図よりも広い領域が透明色と見なされる可能性があります。

[DoJa-5.0 (903i) 以降]
スーパークラスの同名メソッドの振る舞いとは異なり、このメソッド呼び出しによる透明色指定は setTransparentEnabled(boolean) を呼び出さずとも、即座に反映されます。

パラメータ:: color - 透明色を指定します。透明色には Graphics.getColorOfRGB メソッド等で返される値を指定します。実装によってはこのメソッドの処理に時間がかかる場合があります。
例外:: com.nttdocomo.ui.UIException - 既に dispose されているオブジェクトに対して呼ばれた場合に発生します(ILLEGAL_STATE)。; IllegalArgumentException - 引数 color に不正な値が指定された場合に発生します。
関連項目:: setTransparentEnabled(boolean)

getGraphics

public final com.nttdocomo.ui.Graphics getGraphics()

このクラスのインスタンスに対して呼び出すことはできません。

戻り値:: イメージに描画するためのグラフィックスオブジェクトを返します。
例外:: com.nttdocomo.lang.UnsupportedOperationException - このメソッドが呼ばれた場合に発生します。

getTransparentColor

public final int getTransparentColor()

このクラスのインスタンスに対して呼び出すことはできません。

戻り値:: 常に例外が発生するので、戻り値が返ることはありません。
例外:: com.nttdocomo.lang.UnsupportedOperationException - このメソッドが呼ばれた場合に発生します。
導入されたバージョン:: DoJa-5.0 (903i)
関連項目:: Image.setTransparentColor(int)

setAlpha

public final void setAlpha(int alpha)

このクラスのインスタンスに対して呼び出すことはできません。

パラメータ:: alpha - 何を指定しても無視されます。
例外:: com.nttdocomo.lang.UnsupportedOperationException - このメソッドが呼ばれた場合に発生します。
導入されたバージョン:: DoJa-5.0 (903i)

getAlpha

public final int getAlpha()

このクラスのインスタンスに対して呼び出すことはできません。

戻り値:: 常に例外が発生するので、戻り値が返ることはありません。
例外:: com.nttdocomo.lang.UnsupportedOperationException - このメソッドが呼ばれた場合に発生します。
導入されたバージョン:: DoJa-5.0 (903i)

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

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

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

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

NTT DoCoMo,Inc.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。

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

メソッドの概要
`static TransparentImage`	`createTransparentImage(com.nttdocomo.ui.Image image)` 通常のイメージから透明色を持つイメージを生成します。
`int`	`getAlpha()` このクラスのインスタンスに対して呼び出すことはできません。
`com.nttdocomo.ui.Graphics`	`getGraphics()` このクラスのインスタンスに対して呼び出すことはできません。
`int`	`getTransparentColor()` このクラスのインスタンスに対して呼び出すことはできません。
`void`	`setAlpha(int alpha)` このクラスのインスタンスに対して呼び出すことはできません。
`void`	`setTransparentColor(int color)` 透明色を設定します。
`void`	`setTransparentEnabled(boolean b)` 透明色を使用するかどうかを設定します。

com.nttdocomo.opt.ui クラス TransparentImage

TransparentImage

createTransparentImage

setTransparentEnabled

setTransparentColor

getGraphics

getTransparentColor

setAlpha

getAlpha

com.nttdocomo.opt.ui
クラス TransparentImage