JavaTM 2
Platform
Std. Ed. v1.4.0

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[])

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.