モジュール java.desktop
パッケージ javax.swing.text

クラス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行のテキストで表します。
関連項目:
View
  • フィールド詳細

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

      @Deprecated(since="9")protected int drawUnselectedText​(Graphics g, int x, int y, int p0, int p1) throws BadLocationException
      Deprecated.
      モデル内の指定された範囲を通常の選択されていないテキストとしてレンダリングします。 フォアグラウンド・カラーまたは使用不可の色を使ってテキストを描画します。
      パラメータ:
      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
      Deprecated.
      モデル内の指定された範囲を、選択されたテキストとしてレンダリングします。 このメソッドは、収容側コンポーネントで指定された色でテキストを描画するために実装されます。 このメソッドは、ハイライタが選択されたバックグラウンドを描画することを前提にしています。
      パラメータ:
      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 - 描画するために割り当てられた領域
      関連項目:
      View.paint(java.awt.Graphics, java.awt.Shape)
    • 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 - 描画するために割り当てられた領域
      bias - 戻りバイアス
      戻り値:
      指定されたビュー内の点をもっとも適切に表現するモデル内の位置>= 0
      関連項目:
      View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])
    • insertUpdate

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

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

      public void changedUpdate​(DocumentEvent changes, Shape a, ViewFactory f)
      このビューが扱う位置で属性が変更されたことをドキュメントから通知します。
      オーバーライド:
      changedUpdate、クラス: View
      パラメータ:
      changes - 関連するドキュメントからの変更情報
      a - ビューの現在の割当て
      f - ビューが子を持つ場合に再構築に使用するファクトリ
      関連項目:
      View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)
    • 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)
      指定された行範囲を再ペイントします。
      パラメータ:
      host - ビューを収容するコンポーネント(再描画の呼出しに使用)
      a - 描画のためにビューに割り当てられた領域
      line0 - 再描画の開始行番号。 モデル内の有効な行番号である必要がある。
      line1 - 再描画の終了行番号。 モデル内の有効な行番号である必要がある。
      導入されたバージョン:
      1.4
    • lineToRect

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