モジュール java.desktop
パッケージ 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

        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
        「非推奨。」 「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 - 軸が無効な場合
        関連項目:
        View.getPreferredSpan(int)

      • 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[])

      • 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