ComponentView (Java Platform SE 7)

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

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

SwingConstants

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

FormView, ObjectView
```
public class ComponentView
extends View
```
ビューのインタフェースを実装するコンポーネントデコレータです。要素の全体が、コンポーネントの表示に使用されます。表示のみの View の実装から対話型の軽量コンポーネントへのゲートウェイとして動作し、コンポーネントを View 階層に埋め込めるようにします。
コンポーネントは、Component.getAlignmentY によって返された値に従って、テキストベースラインに相対的に配置されます。Swing コンポーネントの場合、JComponent.setAlignmentY メソッドを使うと、この値を簡単に設定できます。たとえば、値を 0.75 に設定すると、コンポーネントの 75 パーセントがベースラインの上に、25 パーセントがベースラインの下になります。
このクラス実装により、すべてのコンポーネントアクセスがイベントスレッド上で確実に行われ、複数スレッドが存在する場合でも (つまり、モデル変更の非同期通知からなど) 適切に動作する必要のある処理が追加で実行されます。
使用されるコンポーネントは、createComponent メソッドの戻り値で決定されます。このメソッドのデフォルトの実装では、(StyleConstants.getComponent を呼び出すことで) 要素の属性として保持されているコンポーネントが返されます。この動作には、複数のコンポーネント (すなわち共有モデル) では使用できないという制限があります。サブクラスでは、createComponent を実装することでこの制約を取り消し、属性に含まれているある種の仕様に基づいたコンポーネントを実際に作成できます。html パッケージの ObjectView クラスは、共有モデルの複数コンポーネントビューをサポートする ComponentView の実装の例です。

フィールドのサマリー
- クラス 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

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

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

コンストラクタ
コンストラクタと説明
`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)` 子ビューの親を設定します。
`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, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setSize, 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)
```
    実際のペイントの動作は通常、コンポーネントがその親コンテナ (このビューを収容するコンテナ) との関連付けから発生します。実装されていても何も行いません。
    
    定義:
    
    paint、クラス: View
    
    パラメータ:
    g - グラフィックスコンテキスト
    a - 形状
    関連項目:
    View.paint(java.awt.Graphics, java.awt.Shape)
  - getPreferredSpan
```
public float getPreferredSpan(int axis)
```
    このビューに適切なスパンを軸に沿って指定します。このメソッドは、指定された軸に沿って、Component.getPreferredSize によって返された値を返すように実装されています。
    
    定義:
    
    getPreferredSpan、クラス: View
    
    パラメータ:
    axis - View.X_AXIS または View.Y_AXIS
    
    戻り値:
    ビューの描画先のスパン >= 0。通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。親はビューのサイズの変更や分割を行う可能性がある。
    
    例外:
    
    IllegalArgumentException - 軸が無効な場合
    関連項目:
    View.getPreferredSpan(int)
  - getMinimumSpan
```
public float getMinimumSpan(int axis)
```
    このビューの最小スパンを軸に沿って指定します。このメソッドは、指定された軸に沿って、Component.getMinimumSize によって返された値を返すように実装されています。
    
    オーバーライド:
    
    getMinimumSpan、クラス: View
    
    パラメータ:
    axis - View.X_AXIS または View.Y_AXIS
    
    戻り値:
    ビューの描画先のスパン >= 0。通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。親はビューのサイズの変更や分割を行う可能性がある。
    
    例外:
    
    IllegalArgumentException - 軸が無効な場合
    関連項目:
    View.getPreferredSpan(int)
  - getMaximumSpan
```
public float getMaximumSpan(int axis)
```
    このビューの最大スパンを軸に沿って指定します。このメソッドは、指定された軸に沿って、Component.getMaximumSize によって返された値を返すように実装されています。
    
    オーバーライド:
    
    getMaximumSpan、クラス: View
    
    パラメータ:
    axis - View.X_AXIS または View.Y_AXIS
    
    戻り値:
    ビューの描画先のスパン >= 0。通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。親はビューのサイズの変更や分割を行う可能性がある。
    
    例外:
    
    IllegalArgumentException - 軸が無効な場合
    関連項目:
    View.getPreferredSpan(int)
  - getAlignment
```
public float getAlignment(int axis)
```
    軸に沿ったこのビューの望ましいレイアウトを決定します。埋め込みコンポーネントの配置のために実装されています。
    
    オーバーライド:
    
    getAlignment、クラス: View
    
    パラメータ:
    axis - View.X_AXIS または View.Y_AXIS
    
    戻り値:
    望ましい配置。この値の範囲は 0.0 から 1.0 で、0 は起点への配置、1.0 は起点から最大限離れた配置を表す。0.5 は、ビューの中央への配置になります。
  - setParent
```
public void setParent(View p)
```
    子ビューの親を設定します。子に自分が親であることを知らせるために、親が呼び出します。これによってビューは親の Container などにアクセスできるようになります。コンポーネントがまだ作成されていない場合には、スーパークラスの動作が実行されたあとに createComponent が呼び出されます。次に、埋め込みコンポーネントの親が getContainer によって返された値に設定されます。親ビューパラメータの値が null の場合、このビューはクリーンアップ中であり、コンポーネントはその親から削除されます。
    コンポーネントの階層の変更は、コンポーネントのロックに影響を与えることがあるため、View 階層に対して安全ではありません。したがって、この機能は、イベントスレッド上の場合にはただちに実行され、別のスレッドから呼び出された場合 (非同期の更新からの変更の通知の場合) はイベントキューに入れられます。
    
    オーバーライド:
    
    setParent、クラス: View
    
    パラメータ:
    p - 親
  - modelToView
```
public Shape modelToView(int pos,
                Shape a,
                Position.Bias b)
                  throws BadLocationException
```
    モデルの座標空間から、ビューの座標空間へのマッピングを提供します。
    定義:
    
    modelToView、クラス: View
    
    パラメータ:
    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)
```
    ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。
    
    定義:
    
    viewToModel、クラス: View
    
    パラメータ:
    x - X 座標 >= 0
    y - Y 座標 >= 0
    a - 描画するために割り当てられた領域
    
    戻り値:
    指定されたビュー内の点をもっとも適切に表現するモデル内の位置
    関連項目:
    View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス ComponentView

フィールドのサマリー

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

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

コンストラクタのサマリー

メソッドのサマリー

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

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

コンストラクタの詳細

ComponentView

メソッドの詳細

createComponent

getComponent

paint

getPreferredSpan

getMinimumSpan

getMaximumSpan

getAlignment

setParent

modelToView

viewToModel