javax.swing.text
クラス ComponentView

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

直接の既知のサブクラス:

FormView, ObjectView

public class ComponentView

extends View

ビューのインタフェースを実装するコンポーネントデコレータです。要素の全体が、コンポーネントの表示に使用されます。表示のみの View の実装から対話型の軽量コンポーネントへのゲートウェイとして動作し、コンポーネントを View 階層に埋め込めるようにします。

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

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

コンストラクタの概要

ComponentView(Element elem)
新しい ComponentView オブジェクトを作成します。

メソッドの概要

protected Component	createComponent() このビューに関連付けられたコンポーネントを作成します。
float	getAlignment(int axis) ビューの望ましい整列を、軸に沿って決定します。
Component	getComponent() ビューに関連付けられたコンポーネントを取得します。
float	getMaximumSpan(int axis) ビューの最大スパンを、軸に沿って決定します。
float	getMinimumSpan(int axis) ビューの最小のスパンを、軸に沿って決定します。
float	getPreferredSpan(int axis) ビューの望ましいスパンを、軸に沿って決定します。
Shape	modelToView(int pos, Shape a, Position.Bias b) モデルの座標空間から、ビューの座標空間へのマッピングを提供します。
void	paint(Graphics g, Shape a) コンポーネントのビューを描画します。
void	setParent(View p) 子ビューの親を設定します。
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, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getView, getViewCount, getViewFactory, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, removeUpdate, viewToModel

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

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

コンストラクタの詳細

ComponentView

public ComponentView(Element elem)

新しい ComponentView オブジェクトを作成します。

パラメータ:

elem - 装飾の対象となる要素

メソッドの詳細

createComponent

protected Component createComponent()

このビューに関連付けられたコンポーネントを作成します。このメソッドは、新しいコンポーネントが必要と判断されたときに呼び出されます。setParent が呼び出されたとき、あるいは属性の変更が通知された結果、このメソッドが呼び出されます。

getComponent

public final Component getComponent()

ビューに関連付けられたコンポーネントを取得します。

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)

ビューの望ましいスパンを、軸に沿って決定します。このメソッドは、指定された軸に沿って、Component.getPreferredSize によって返された値を返すように実装されています。

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

ビューが描画されるスパン >= 0。通常、ビューは返されたスパンに描画されるが、この保証はない。親は、ビューの大きさの変更、あるいはブレークを行う可能性がある

例外:

IllegalArgumentException - 軸が無効な場合

オーバーライド:

クラス View 内の getPreferredSpan

getMinimumSpan

public float getMinimumSpan(int axis)

ビューの最小のスパンを、軸に沿って決定します。このメソッドは、指定された軸に沿って、Component.getMinimumSize によって返された値を返すように実装されています。

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

ビューが描画されるスパン >= 0。通常、ビューは返されたスパンに描画されるが、この保証はない。親は、ビューの大きさの変更、あるいはブレークを行う可能性がある

例外:

IllegalArgumentException - 軸が無効な場合

オーバーライド:

クラス View 内の getMinimumSpan

getMaximumSpan

public float getMaximumSpan(int axis)

ビューの最大スパンを、軸に沿って決定します。このメソッドは、指定された軸に沿って、Component.getMaximumSize によって返された値を返すように実装されています。

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

ビューが描画されるスパン >= 0。通常、ビューは返されたスパンに描画されるが、この保証はない。親は、ビューの大きさの変更、あるいはブレーク行う可能性がある

例外:

IllegalArgumentException - 軸が無効な場合

オーバーライド:

クラス View 内の getMaximumSpan

getAlignment

public float getAlignment(int axis)

ビューの望ましい整列を、軸に沿って決定します。埋め込みコンポーネントの整列のために実装されています。

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

オーバーライド:

クラス View 内の getAlignment

setSize

public void setSize(float width,
                    float height)

ビューのサイズを設定します。このメソッドは、コンポーネントのサイズをビューのサイズに一致させるために実装されています。

コンポーネントのサイズ変更は、コンポーネントのロックに影響を与えることがあるため、View 階層に対して安全ではありません。したがって、この機能は、イベントスレッド上の場合にはただちに実行され、別のスレッドから呼び出された場合 (非同期の更新からの変更の通知の場合) はイベントキューに入れられます。

パラメータ:

width - 幅 >= 0

height - 高さ >= 0

オーバーライド:

クラス View 内の setSize

setParent

public void setParent(View p)

子ビューの親を設定します。子に自分が親であることを知らせるために、親が呼び出します。これによってビューは親の Container などにアクセスできるようになります。コンポーネントがまだ作成されていない場合には、スーパークラスの動作が実行されたあとに createComponent が呼び出され、埋め込みコンポーネントの親が getContainer によって返された値に設定されます。

コンポーネントのサイズ変更は、コンポーネントのロックに影響を与えることがあるため、View 階層に対して安全ではありません。したがって、この機能は、イベントスレッド上の場合にはただちに実行され、別のスレッドから呼び出された場合 (非同期の更新からの変更の通知の場合) はイベントキューに入れられます。

パラメータ:

p - 親

オーバーライド:

クラス View 内の setParent

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 - 描画に割り当てられた領域

戻り値:

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

オーバーライド:

クラス View 内の viewToModel

関連項目:

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