javax.swing.text
クラス IconView

java.lang.Object
  |
  +--javax.swing.text.View
        |
        +--javax.swing.text.IconView

public class IconView

extends View

ビューインタフェースを実装するアイコンデコレータです。要素全体を使ってアイコンを表します。これは、表示専用 View の実装から対話型の軽量アイコンまでのゲートウェイとして動作します (つまり、これはアイコンの View 階層への埋め込みを可能にする)。アイコンの親は、関連付けられているビューファクトリによって与えられるコンテナです。

クラス javax.swing.text.View から継承したフィールド

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

コンストラクタの概要

IconView(Element elem)
要素を表現する新しいアイコンビューを作成します。

メソッドの概要

float	getAlignment(int axis) このビューの望ましい配置を軸に沿って指定します。
float	getPreferredSpan(int axis) このビューの望ましいスパンを軸に沿って指定します。
Shape	modelToView(int pos, Shape a, Position.Bias b) ドキュメントモデルの座標空間からそれに対応付けられるビューの座標空間への対応付けを提供します。
void	paint(Graphics g, Shape a) アイコンをペイントします。
void	setSize(float width, float height) ビューのサイズを設定します。
int	viewToModel(float x, float y, Shape a, Position.Bias[] bias) ビュー座標空間からモデルの論理座標空間への対応付けを提供します。

クラス javax.swing.text.View から継承したメソッド

breakView, changedUpdate, createFragment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getView, getViewCount, getViewFactory, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, removeUpdate, setParent, viewToModel

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

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

コンストラクタの詳細

IconView

public IconView(Element elem)

要素を表現する新しいアイコンビューを作成します。

パラメータ:

elem - ビューを作成する要素

メソッドの詳細

paint

public void paint(Graphics g,
                  Shape a)

アイコンをペイントします。実際の描画動作は、アイコンとその親コンテナ (このビューを収容する同じ上位のコンテナ) との関連付けから自然に発生します。このため、ビューを基準にしてアイコンを適切に配置できます。ビューの座標系は親コンテナなので、子アイコンの配置は簡単です。

パラメータ:

g - 使用する描画表面

a - 描画対象の割り当て領域

オーバーライド:

クラス View 内の paint

関連項目:

View.paint(java.awt.Graphics, java.awt.Shape)

getPreferredSpan

public float getPreferredSpan(int axis)

このビューの望ましいスパンを軸に沿って指定します。

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

ビューの描画対象のスパン。通常、ビューは返されたスパン内に描画されることになるが、保証はない。親はビューのサイズ変更や分割を行う可能性がある

例外:

IllegalArgumentException - 軸が無効な場合

オーバーライド:

クラス View 内の getPreferredSpan

getAlignment

public float getAlignment(int axis)

このビューの望ましい配置を軸に沿って指定します。これを実装すると、y 軸に沿ってアイコンの下端を配置し、x 軸に沿ってデフォルトの配置を実行できます。

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

望ましい配置 >= 0.0f && <= 1.0f。値の範囲は 0.0 〜 1.0 で 、0 は起点への配置、1.0 は起点から最大スパン離れた配置を表す。0.5 は、ビューの中央への配置になる

オーバーライド:

クラス View 内の getAlignment

modelToView

public Shape modelToView(int pos,
                         Shape a,
                         Position.Bias b)
                  throws BadLocationException

ドキュメントモデルの座標空間からそれに対応付けられるビューの座標空間への対応付けを提供します。

パラメータ:

pos - 変換対象の位置 >= 0

a - 描画対象の割り当て領域

戻り値:

指定された位置のバウンディングボックス

例外:

BadLocationException - 指定された位置が、関連付けられているドキュメント内の有効な位置を表していない場合

オーバーライド:

クラス View 内の modelToView

関連項目:

View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

viewToModel

public int viewToModel(float x,
                       float y,
                       Shape a,
                       Position.Bias[] bias)

ビュー座標空間からモデルの論理座標空間への対応付けを提供します。

パラメータ:

x - X 座標 >= 0

y - Y 座標 >= 0

a - 描画対象の割り当て領域

戻り値:

ビューの指定された点を最適に表すモデル内の位置 >= 0

オーバーライド:

クラス View 内の viewToModel

関連項目:

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

setSize

public void setSize(float width,
                    float height)

ビューのサイズを設定します。アイコンはこの機能をサポートしていないので、できることは何もありません。

パラメータ:

width - 幅

height - 高さ

オーバーライド:

クラス View 内の setSize