ComponentView (Java Platform SE 8)

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などにアクセスできるようになります。親ビュー・パラメータの値がnull以外で、コンポーネントがまだ作成されていない場合は、スーパークラスの動作が実行された後に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, 2014, 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