javax.swing.text
クラス ComponentView

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

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

SwingConstants

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

FormView, ObjectView

public class ComponentView

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, NORTH, NORTH_EAST, NORTH_WEST, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

コンストラクタの概要

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 から継承したメソッド

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

実際の描画の動作は、コンポーネントがその親コンテナ (このビューを収容するコンテナ) との間にある関連性から発生します。実装されていても何も行いません。

オーバーライド:

クラス View 内の paint

パラメータ:

g - グラフィックスコンテキスト

a - 形状

関連項目:

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

getPreferredSpan

public float getPreferredSpan(int axis)

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

オーバーライド:

クラス View 内の getPreferredSpan

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

例外:

IllegalArgumentException - 軸が無効な場合

getMinimumSpan

public float getMinimumSpan(int axis)

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

オーバーライド:

クラス View 内の getMinimumSpan

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

例外:

IllegalArgumentException - 軸が無効な場合

getMaximumSpan

public float getMaximumSpan(int axis)

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

オーバーライド:

クラス View 内の getMaximumSpan

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

例外:

IllegalArgumentException - 軸が無効な場合

getAlignment

public float getAlignment(int axis)

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

オーバーライド:

クラス View 内の getAlignment

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

setSize

public void setSize(float width,
                    float height)

ビューのサイズを設定します。このメソッドは、コンポーネント自体が、ホスト Container にインストールされた LayoutManager が確立するサイズを取得するので、実装されていても何も行いません。

オーバーライド:

クラス View 内の setSize

パラメータ:

width - 幅 >= 0

height - 高さ >= 0

setParent

public void setParent(View p)

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

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

オーバーライド:

クラス View 内の setParent

パラメータ:

p - 親

modelToView

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

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

オーバーライド:

クラス View 内の modelToView

パラメータ:

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

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

戻り値:

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

例外:

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

戻り値:

指定されたビュー内の点をもっとも適切に表現するモデル内の位置

関連項目:

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