javax.swing.text
類別 GlyphView.GlyphPainter

java.lang.Object
  javax.swing.text.GlyphView.GlyphPainter

正在封閉類別：

GlyphView

public abstract static class GlyphView.GlyphPainter
extends Object

執行字形呈現的類別。此類別可實作為無狀態的，或將某些資訊存儲為快取記憶體，以便更快地呈現和模型/視圖轉換。至少，GlyphPainter 允許 View 實作獨立於特定的 JVM 版本和功能選擇（即向國際化並軌）來執行其職責。

從以下版本開始：

1.3

建構子摘要

GlyphView.GlyphPainter()

方法摘要

abstract float	getAscent(GlyphView v)
abstract int	getBoundedPosition(GlyphView v, int p0, float x, float len) 確定表示符合給定區域的最大 advance 的模型位置。
abstract float	getDescent(GlyphView v)
abstract float	getHeight(GlyphView v)
int	getNextVisualPositionFrom(GlyphView v, int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) 提供確定下一個以可視化形式表示的模型位置的方法，使用者可以在此位置放置一個插入符。
GlyphView.GlyphPainter	getPainter(GlyphView v, int p0, int p1) 創建用於給定 GlyphView 的 painter。
abstract float	getSpan(GlyphView v, int p0, int p1, TabExpander e, float x) 確定給定開始位置（相對於選項卡擴展而言）的字形區域。
abstract Shape	modelToView(GlyphView v, int pos, Position.Bias bias, Shape a) 提供從文檔模型坐標空間到所映射的視圖坐標空間的映射。
abstract void	paint(GlyphView v, Graphics g, Shape a, int p0, int p1) 繪製表示給定範圍的字形。
abstract int	viewToModel(GlyphView v, float x, float y, Shape a, Position.Bias[] biasReturn) 提供從視圖坐標空間到模型邏輯坐標空間的映射。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

GlyphView.GlyphPainter

public GlyphView.GlyphPainter()

方法詳細資訊

getSpan

public abstract float getSpan(GlyphView v,
                              int p0,
                              int p1,
                              TabExpander e,
                              float x)

確定給定開始位置（相對於選項卡擴展而言）的字形區域。

getHeight

public abstract float getHeight(GlyphView v)

getAscent

public abstract float getAscent(GlyphView v)

getDescent

public abstract float getDescent(GlyphView v)

paint

public abstract void paint(GlyphView v,
                           Graphics g,
                           Shape a,
                           int p0,
                           int p1)

繪製表示給定範圍的字形。

modelToView

public abstract Shape modelToView(GlyphView v,
                                  int pos,
                                  Position.Bias bias,
                                  Shape a)
                           throws BadLocationException

提供從文檔模型坐標空間到所映射的視圖坐標空間的映射。這由拆分後的視圖共享。

參數：

v - 套件含目標坐標空間的 GlyphView

pos - 要轉換的位置

bias - 可以是 Position.Bias.Forward，也可以是 Position.Bias.Backward

a - 視圖的邊界

返回：

給定位置的邊界框

拋出：

BadLocationException - 如果給定位置不表示相關文檔中的有效位置

另請參見：

View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

viewToModel

public abstract int viewToModel(GlyphView v,
                                float x,
                                float y,
                                Shape a,
                                Position.Bias[] biasReturn)

提供從視圖坐標空間到模型邏輯坐標空間的映射。

參數：

v - 要為其提供映射的 GlyphView

x - X 坐標

y - Y 坐標

a - 要呈現的分派區域

biasReturn - 將 Position.Bias.Forward 或 Position.Bias.Backward 返回，作為此陣列中的第零個元素

返回：

模型中最能代表視圖中給定點的位置

另請參見：

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

getBoundedPosition

public abstract int getBoundedPosition(GlyphView v,
                                       int p0,
                                       float x,
                                       float len)

確定表示符合給定區域的最大 advance 的模型位置。此方法可用於拆分給定的視圖。結果應為一個不完全佔用給定 advance 的位置。這與 viewToModel 不同，後者將返回充分利用最大 advance 的位置。

參數：

v - 尋找在其處拆分的模型位置的視圖。

p0 - 模型中片段應開始其表示形式的位置，該值 >= 0。

x - 沿已拆分視圖可能佔用的軸的圖形位置，該值 >= 0。這可能對選項卡計算之類別的情況有用。

len - 向需要潛在拆分的視圖指定的距離，該值 >= 0.

返回：

能用於拆分的最大模型位置。

另請參見：

View.breakView(int, int, float, float)

getPainter

public GlyphView.GlyphPainter getPainter(GlyphView v,
                                         int p0,
                                         int p1)

創建用於給定 GlyphView 的 painter。如果該 painter 狀態正常，則它可以創建另一個 painter 以表示正在創建的新 GlyphView。如果該 painter 未處於有效狀態，則可能返回其自身。預設行為是返回其自身。

參數：

v - 要為其提供 painter 的 GlyphView

p0 - 初始文檔偏移量，該值 >= 0

p1 - 結束文檔偏移量，該值 >= p0

getNextVisualPositionFrom

public int getNextVisualPositionFrom(GlyphView v,
                                     int pos,
                                     Position.Bias b,
                                     Shape a,
                                     int direction,
                                     Position.Bias[] biasRet)
                              throws BadLocationException

提供確定下一個以可視化形式表示的模型位置的方法，使用者可以在此位置放置一個插入符。有些視圖可能不可見，它們可能與該模型中發現的順序不同，或它們可能只是不允許存取該模型中的某些位置。

參數：

v - 要使用的視圖

pos - 要轉換的位置，該值 >= 0

b - 可以是 Position.Bias.Forward，也可以是 Position.Bias.Backward

a - 要呈現的分派區域

direction - 相對當前位置的方向，通常可視為鍵盤上找到的箭頭鍵。此可以是 SwingConstants.WEST、SwingConstants.EAST、SwingConstants.NORTH 或 SwingConstants.SOUTH。

biasRet - 將 Position.Bias.Forward 或 Position.Bias.Backward 作為此陣列中的第零個元素返回

返回：

模型中最能表示下一個可視位置的位置。

拋出：

BadLocationException

IllegalArgumentException - 如果方向無效