クラスPlainView

java.lang.Object
javax.swing.text.View
javax.swing.text.PlainView
すべての実装されたインタフェース:
SwingConstants, TabExpander
直系の既知のサブクラス:
FieldView
public class PlainView extends View implements TabExpander
フォントと色が1種類ずつのテキストを含む単純な複数行テキスト・ビューのために、Viewインタフェースを実装します。 ビューは、子要素をそれぞれ1行のテキストで表します。
関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    protected FontMetrics
    metrics
    現在のフォントのフォント・メトリックスです。

    クラスビューで宣言されたフィールド

    BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
    修飾子と型
    フィールド
    説明
    static final int
    BadBreakWeight
    フォーマット目的とするには不完全な分割の機会であるビューを示すウエイトです。
    static final int
    ExcellentBreakWeight
    分割をサポートしているビューを示すウエイトで、分割するのに適した位置であることを表わしています。
    static final int
    ForcedBreakWeight
    分割をサポートしているビューを示すウエイトで、子を分割することで子をフォーマットするビューに配置されている場合に、ビューを正しく表わすには分割しなければいけません。
    static final int
    GoodBreakWeight
    分割をサポートしているビューを示すウエイトですが、もっと良い機会が存在する可能性があります。
    static final int
    X_AXIS
    フォーマット/分割処理の軸です。
    static final int
    Y_AXIS
    フォーマット/分割処理の軸です。

    インタフェースで宣言されたフィールド SwingConstants

    BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
    修飾子と型
    フィールド
    説明
    static final int
    BOTTOM
    ボックスの下端を指定するために使用するボックス配置定数です。
    static final int
    CENTER
    領域内の中央位置です。
    static final int
    EAST
    東(右)の方角です。
    static final int
    HORIZONTAL
    水平方向です。
    static final int
    LEADING
    左から右に記述する言語および右から左に記述する言語で使用するテキストのリーディング・エッジを指定します。
    static final int
    LEFT
    ボックスの左端を指定するために使用するボックス配置定数です。
    static final int
    NEXT
    シーケンス内の次の方向を指定します。
    static final int
    NORTH
    北(上)の方角です。
    static final int
    NORTH_EAST
    北東(右上)の方角です。
    static final int
    NORTH_WEST
    北西(左上)の方角です。
    static final int
    PREVIOUS
    シーケンス内の前の方向を指定します。
    static final int
    RIGHT
    ボックスの右端を指定するために使用するボックス配置定数です。
    static final int
    SOUTH
    南(下)の方角です。
    static final int
    SOUTH_EAST
    南東(右下)の方角です。
    static final int
    SOUTH_WEST
    南西(左下)の方角です。
    static final int
    TOP
    ボックスの上端を指定するために使用するボックス配置定数です。
    static final int
    TRAILING
    左から右に記述する言語および右から左に記述する言語で使用するテキストのトレーリング・エッジを指定します。
    static final int
    VERTICAL
    垂直方向です。
    static final int
    WEST
    西(左)の方角です。

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

    コンストラクタ
    コンストラクタ
    説明
    PlainView(Element elem)
    要素でラップされた新しいPlainViewを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)
    このビューが扱う位置で属性が変更されたことをドキュメントから通知します。
    protected void
    damageLineRange(int line0, int line1, Shape a, Component host)
    指定された行範囲を再ペイントします。
    protected void
    drawLine(int lineIndex, Graphics2D g, float x, float y)
    末尾の余白を抑止し、タブを拡張しながら、1行のテキストをレンダリングします。
    protected void
    drawLine(int lineIndex, Graphics g, int x, int y)
    非推奨。
    drawLine(int, Graphics2D, float, float)に置き換えられました
    protected float
    drawSelectedText(Graphics2D g, float x, float y, int p0, int p1)
    モデル内の指定された範囲を、選択されたテキストとしてレンダリングします。
    protected int
    drawSelectedText(Graphics g, int x, int y, int p0, int p1)
    非推奨。
    drawSelectedText(Graphics2D, float, float, int, int)に置き換えられました
    protected float
    drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1)
    モデル内の指定された範囲を通常の選択されていないテキストとしてレンダリングします。
    protected int
    drawUnselectedText(Graphics g, int x, int y, int p0, int p1)
    非推奨。
    drawUnselectedText(Graphics2D, float, float, int, int)に置き換えられました
    protected final Segment
    getLineBuffer()
    関連するドキュメントからテキストを取得するために使用できるバッファへのアクセスを提供します。
    float
    getPreferredSpan(int axis)
    このビューに適切なスパンを軸に沿って指定します。
    protected int
    getTabSize()
    ドキュメントに設定されたタブのサイズを返します。デフォルトは8です。
    void
    insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)
    このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。
    protected Rectangle
    lineToRect(Shape a, int line)
    指定した行を表す矩形を判別します。
    Shape
    modelToView(int pos, Shape a, Position.Bias b)
    ドキュメント・モデルの座標空間からビューの座標空間へのマッピングを提供します。
    float
    nextTabStop(float x, int tabOffset)
    指定された参照位置より後ろの次のタブストップ位置を返します。
    void
    paint(Graphics g, Shape a)
    指定されたレンダリング表面およびその表面上の領域を使ってレンダリングします。
    void
    removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)
    このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。
    void
    setSize(float width, float height)
    ビューのサイズを設定します。
    protected void
    updateDamage(DocumentEvent changes, Shape a, ViewFactory f)
    指定されたドキュメント・イベントでカバーされる変更領域を再ペイントします。
    protected void
    updateMetrics()
    フォント・メトリックスと最長の線が最新であるかどうかを確認します。
    int
    viewToModel(float x, float y, Shape a, Position.Bias[] bias)
    ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

    Viewクラスで宣言されたメソッド

    append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getAlignment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, updateChildren, updateLayout, viewToModel
    修飾子と型
    メソッド
    説明
    void
    append(View v)
    1つの子ビューを追加します。
    View
    breakView(int axis, int offset, float pos, float len)
    指定された軸でこのビューの分割を試みます。
    View
    createFragment(int p0, int p1)
    要素の一部分を表すビューを作成します。
    protected void
    forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)
    指定されたDocumentEventを、モデルへの変更について通知する必要のある子ビューに転送します。
    protected void
    forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)
    指定された子ビューにDocumentEventを転送します。
    float
    getAlignment(int axis)
    軸に沿ったこのビューの望ましいレイアウトを決定します。
    AttributeSet
    getAttributes()
    描画するときに使用する属性を取得します。
    int
    getBreakWeight(int axis, float pos, float len)
    このビューで分割のウエイトがどのくらい適切かを示します。
    Shape
    getChildAllocation(int index, Shape a)
    指定された子ビューの割り当てを取得します。
    Container
    getContainer()
    ビューを収容するコンテナを取得します。
    Document
    getDocument()
    ビューに関連したモデルを取り出します。
    Element
    getElement()
    このビューがマッピングされる対象の構造部分を取り出します。
    int
    getEndOffset()
    このビューが扱うモデルの一部を取り出します。
    Graphics
    getGraphics()
    レンダリングのためのGraphicsを取得します。
    float
    getMaximumSpan(int axis)
    このビューの最大スパンを軸に沿って指定します。
    float
    getMinimumSpan(int axis)
    このビューの最小スパンを軸に沿って指定します。
    int
    getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)
    キャレットが配置される可能性のある、視覚的に表された次のモデル位置を決定する手段を提供します。
    View
    getParent()
    ビューの親を返します。
    int
    getResizeWeight(int axis)
    指定された軸に沿ってビューのサイズを変更できるかどうかを指定します。
    int
    getStartOffset()
    このビューが扱うモデルの一部を取り出します。
    String
    getToolTipText(float x, float y, Shape allocation)
    指定された位置にあるツールヒントのテキストを返します。
    View
    getView(int n)
    n番目の子ビューを取得します。
    int
    getViewCount()
    このビュー内のビューの数を返します。
    ViewFactory
    getViewFactory()
    ビュー階層を供給しているViewFactoryの実装を取り出します。
    int
    getViewIndex(float x, float y, Shape allocation)
    ビュー内の指定された位置を表す子ビュー・インデックスを返します。
    int
    getViewIndex(int pos, Position.Bias b)
    モデル内の指定された位置を表す子ビューのインデックスを返します。
    void
    insert(int offs, View v)
    1つの子ビューを挿入します。
    boolean
    isVisible()
    ビューが可視かどうかを示すboolean型の値を返します。
    Shape
    modelToView(int pos, Shape a)
    非推奨。 
    Shape
    modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)
    指定した範囲について、ドキュメント・モデル座標空間からビュー座標空間へのマッピングを提供します。
    void
    preferenceChanged(View child, boolean width, boolean height)
    子ビューは親でこのメソッドを呼び出し、設定が変更されたこと、および再度レイアウトが考慮されなければならないことを示すことができます。
    void
    remove(int i)
    指定された位置にある子を1つ削除します。
    void
    removeAll()
    すべての子を削除します。
    void
    replace(int offset, int length, View[] views)
    子ビューを置換します。
    void
    setParent(View parent)
    このビューの親ビューを確立します。
    protected boolean
    updateChildren(DocumentEvent.ElementChange ec, DocumentEvent e, ViewFactory f)
    モデルが変更されたという通知を受け取ると、子ビューを更新します。このビューが扱う要素の変更記録があります。
    protected void
    updateLayout(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a)
    モデルから変更の通知を受け取った場合に、レイアウトを更新します。
    int
    viewToModel(float x, float y, Shape a)
    非推奨。 

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • metrics

      protected FontMetrics metrics
      現在のフォントのフォント・メトリックスです。

  • コンストラクタの詳細

    • PlainView

      public PlainView(Element elem)
      要素でラップされた新しいPlainViewを構築します。
      パラメータ:
      elem - 要素

  • メソッドの詳細

    • getTabSize

      protected int getTabSize()
      ドキュメントに設定されたタブのサイズを返します。デフォルトは8です。
      戻り値:
      タブのサイズ

    • drawLine

      @Deprecated(since="9") protected void drawLine(int lineIndex, Graphics g, int x, int y)
      非推奨。
      drawLine(int, Graphics2D, float, float)に置き換えられました
      末尾の余白を抑止し、タブを拡張しながら、1行のテキストをレンダリングします。 このメソッドは、選択されたテキストまたは選択されていないテキストが描画される方法をカスタマイズできるように、drawUnselectedTextおよびdrawSelectedTextメソッドを呼び出すために実装されます。
      パラメータ:
      lineIndex - 描画する行>= 0
      g - Graphicsコンテキスト
      x - 開始X位置>= 0
      y - 開始Y位置>= 0
      関連項目:

    • drawLine

      protected void drawLine(int lineIndex, Graphics2D g, float x, float y)
      末尾の余白を抑止し、タブを拡張しながら、1行のテキストをレンダリングします。 このメソッドは、選択されたテキストまたは選択されていないテキストが描画される方法をカスタマイズできるように、drawUnselectedTextおよびdrawSelectedTextメソッドを呼び出すために実装されます。
      パラメータ:
      lineIndex - >= 0を描く線
      g - Graphicsコンテキスト
      x - 開始X位置>= 0
      y - 開始Y位置>= 0
      導入されたバージョン:
      9
      関連項目:

    • drawUnselectedText

      @Deprecated(since="9") protected int drawUnselectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException
      非推奨。
      drawUnselectedText(Graphics2D, float, float, int, int)に置き換えられました
      モデル内の指定された範囲を通常の選択されていないテキストとしてレンダリングします。 フォアグラウンド・カラーまたは使用不可の色を使ってテキストを描画します。
      パラメータ:
      g - グラフィックス・コンテキスト
      x - 開始X座標>= 0
      y - 開始Y座標>= 0
      p0 - モデル内の開始位置>= 0
      p1 - モデル内の終了位置>= 0
      戻り値:
      範囲の終了のX位置>= 0
      スロー:
      BadLocationException - 範囲が無効な場合

    • drawUnselectedText

      protected float drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException
      モデル内の指定された範囲を通常の選択されていないテキストとしてレンダリングします。 フォアグラウンド・カラーまたは使用不可の色を使ってテキストを描画します。
      パラメータ:
      g - グラフィックス・コンテキスト
      x - 開始X座標>= 0
      y - 開始Y座標>= 0
      p0 - >= 0モデルの開始位置
      p1 - モデル>= 0の終了位置
      戻り値:
      範囲>= 0の終わりのXロケーション
      スロー:
      BadLocationException - 範囲が無効な場合
      導入されたバージョン:
      9

    • drawSelectedText

      @Deprecated(since="9") protected int drawSelectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException
      非推奨。
      drawSelectedText(Graphics2D, float, float, int, int)に置き換えられました
      モデル内の指定された範囲を、選択されたテキストとしてレンダリングします。 このメソッドは、収容側コンポーネントで指定された色でテキストを描画するために実装されます。 このメソッドは、ハイライタが選択されたバックグラウンドを描画することを前提にしています。
      パラメータ:
      g - グラフィックス・コンテキスト
      x - 開始X座標>= 0
      y - 開始Y座標>= 0
      p0 - モデル内の開始位置>= 0
      p1 - モデル内の終了位置>= 0
      戻り値:
      範囲の終了の位置
      スロー:
      BadLocationException - 範囲が無効な場合

    • drawSelectedText

      protected float drawSelectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException
      モデル内の指定された範囲を、選択されたテキストとしてレンダリングします。 このメソッドは、収容側コンポーネントで指定された色でテキストを描画するために実装されます。 このメソッドは、ハイライタが選択されたバックグラウンドを描画することを前提にしています。
      パラメータ:
      g - グラフィックス・コンテキスト
      x - 開始X座標>= 0
      y - 開始Y座標>= 0
      p0 - >= 0モデルの開始位置
      p1 - モデル>= 0の終了位置
      戻り値:
      範囲の終了の位置
      スロー:
      BadLocationException - 範囲が無効な場合
      導入されたバージョン:
      9

    • getLineBuffer

      protected final Segment getLineBuffer()
      関連するドキュメントからテキストを取得するために使用できるバッファへのアクセスを提供します。
      戻り値:
      バッファ

    • updateMetrics

      protected void updateMetrics()
      フォント・メトリックスと最長の線が最新であるかどうかを確認します。
      導入されたバージョン:
      1.4

    • getPreferredSpan

      public float getPreferredSpan(int axis)
      このビューに適切なスパンを軸に沿って指定します。
      定義:
      getPreferredSpan、クラスView
      パラメータ:
      axis - View.X_AXISまたはView.Y_AXIS
      戻り値:
      ビューの描画先のスパン>= 0。 通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。 親はビューのサイズの変更や分割を行う可能性がある。
      スロー:
      IllegalArgumentException - 軸が無効な場合

    • paint

      public void paint(Graphics g, Shape a)
      指定されたレンダリング表面およびその表面上の領域を使ってレンダリングします。 ビューは、指定された割当てにそれ自体を描画するために、レイアウトを行なったり、子ビューを作成したりする必要がある場合があります。
      定義:
      paint、クラスView
      パラメータ:
      g - 使用する描画表面
      a - 描画するために割り当てられた領域
      関連項目:

    • 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 - 指定された位置が、関連するドキュメント内の有効な位置を示さない場合
      関連項目:

    • viewToModel

      public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)
      ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。
      定義:
      viewToModel、クラスView
      パラメータ:
      x - X座標>= 0
      y - Y座標>= 0
      a - 描画するために割り当てられた領域
      bias - 戻りバイアス
      戻り値:
      指定されたビュー内の点をもっとも適切に表現するモデル内の位置>= 0
      関連項目:

    • insertUpdate

      public void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)
      このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。
      オーバーライド:
      insertUpdate、クラスView
      パラメータ:
      changes - 関連するドキュメントからの変更情報
      a - ビューの現在の割当て
      f - ビューが子を持つ場合に再構築に使用するファクトリ
      関連項目:

    • removeUpdate

      public void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)
      このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。
      オーバーライド:
      removeUpdate、クラスView
      パラメータ:
      changes - 関連するドキュメントからの変更情報
      a - ビューの現在の割当て
      f - ビューが子を持つ場合に再構築に使用するファクトリ
      関連項目:

    • changedUpdate

      public void changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)
      このビューが扱う位置で属性が変更されたことをドキュメントから通知します。
      オーバーライド:
      changedUpdate、クラスView
      パラメータ:
      changes - 関連するドキュメントからの変更情報
      a - ビューの現在の割当て
      f - ビューが子を持つ場合に再構築に使用するファクトリ
      関連項目:

    • setSize

      public void setSize(float width, float height)
      ビューのサイズを設定します。 レイアウトの必要がある場合は、指定した軸に沿ったビューのレイアウトを表示します。
      オーバーライド:
      setSize、クラスView
      パラメータ:
      width - 幅>= 0
      height - 高さ>= 0

    • nextTabStop

      public float nextTabStop(float x, int tabOffset)
      指定された参照位置より後ろの次のタブストップ位置を返します。 この実装は中央揃えなどの機能をサポートしていないので、tabOffset引数を無視します。
      定義:
      nextTabStop、インタフェースTabExpander
      パラメータ:
      x - 現在位置>= 0
      tabOffset - タブが発生するテキスト・ストリーム内の位置>= 0。
      戻り値:
      ポイント単位で測定されたタブストップ>= 0

    • updateDamage

      protected void updateDamage(DocumentEvent changes, Shape a, ViewFactory f)
      指定されたドキュメント・イベントでカバーされる変更領域を再ペイントします。 挿入または削除が単一の行に対してのみ実行される場合をカバーするため、範囲の開始行を損傷します。 複数の行を追加または削除した場合は、ビュー全体を損傷します。 最長の行が変更されていないかどうかチェックされます。
      パラメータ:
      changes - 関連するドキュメントからの変更情報
      a - ビューの現在の割当て
      f - ビューが子を持つ場合に再構築に使用するファクトリ
      導入されたバージョン:
      1.4

    • damageLineRange

      protected void damageLineRange(int line0, int line1, Shape a, Component host)
      指定された行範囲を再ペイントします。
      パラメータ:
      line0 - 再描画の開始行番号。 モデル内の有効な行番号である必要がある。
      line1 - 再描画の終了行番号。 モデル内の有効な行番号である必要がある。
      a - 描画のためにビューに割り当てられた領域
      host - ビューを収容するコンポーネント(再描画の呼出しに使用)
      導入されたバージョン:
      1.4

    • lineToRect

      protected Rectangle lineToRect(Shape a, int line)
      指定した行を表す矩形を判別します。
      パラメータ:
      a - 描画のためにビューに割り当てられた領域
      line - 範囲の検索に使用する行番号。 モデル内の有効な行番号である必要がある。
      戻り値:
      指定された行を表す矩形
      導入されたバージョン:
      1.4