javax.swing.text
クラス IconView

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

すべての実装インタフェース:

SwingConstants

public class IconView

extends View

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

フィールドの概要

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

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

インタフェース javax.swing.SwingConstants から継承したフィールド

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

コンストラクタの概要

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) アイコンをペイントします。
int	viewToModel(float x, float y, Shape a, Position.Bias[] bias) ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

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

append, breakView, changedUpdate, createFragment, forwardUpdate, forwardUpdateToView, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setParent, setSize, updateChildren, updateLayout, 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)

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

定義:

クラス View 内の paint

パラメータ:

g - 使用する描画表面

a - 描画のために割り当てられた領域

関連項目:

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

getPreferredSpan

public float getPreferredSpan(int axis)

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

定義:

クラス View 内の getPreferredSpan

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

例外:

IllegalArgumentException - 軸が無効な場合

関連項目:

View.getPreferredSpan(int)

getAlignment

public float getAlignment(int axis)

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

オーバーライド:

クラス View 内の getAlignment

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

modelToView

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

ドキュメントモデルの座標空間からビューの座標空間へのマッピングを提供します。

定義:

クラス View 内の modelToView

パラメータ:

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

a - 描画のために割り当てられた領域

b - 位置が 2 つのビューの境界である場合に、オフセットによって表される直前の文字または次の文字へのバイアス。b の値は以下のどれか

• Position.Bias.Forward
• Position.Bias.Backward

戻り値:

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

例外:

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

関連項目:

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

viewToModel

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

ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

定義:

クラス View 内の viewToModel

パラメータ:

x - X 座標 >= 0

y - Y 座標 >= 0

a - 描画のために割り当てられた領域

戻り値:

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

関連項目:

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