TextAttribute (Java 2 Platform SE 6)

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 Platform
Standard Ed. 6

上一個類別 下一個類別

框架 無框架

摘要：巢狀 | 欄位 | 建構子 | 方法

詳細資訊：欄位 | 建構子 | 方法

java.awt.font
類別 TextAttribute

java.lang.Object
  java.text.AttributedCharacterIterator.Attribute
      java.awt.font.TextAttribute

所有已實作的介面：: Serializable

public final class TextAttribute
extends AttributedCharacterIterator.Attribute
extends AttributedCharacterIterator.Attribute

TextAttribute 類別定義用於呈現文本的屬性鍵和屬性值。

TextAttribute 實例被用作屬性鍵，標識 Font、TextLayout、AttributedCharacterIterator 和其他處理文本屬性的類別中的屬性。此類別中定義的其他常數可以用作屬性值。

對於每個文本屬性，文檔提供了：

其值的型別，
相關預定義常數（如果有）
屬性不存在時的預設效果
有限制時的有效值
效果的描述。

值

屬性值必須始終是不可變的。
在給出值限制的情況下，限制集合以外的任何值都是為將來使用保留的，該值將被視為預設值。
null 值將被視為預設值並導致預設行為。
如果值的型別不正確，則忽略該屬性。
值的標識無關緊要，只要是實際值即可。例如，TextAttribute.WEIGHT_BOLD 和 new Float(2.0) 指示相同的 WEIGHT。
Number 型別的屬性值（用於 WEIGHT、WIDTH、POSTURE、SIZE、JUSTIFICATION 和 TRACKING）隨其自然範圍的變化而變化，且不受預定義常數的限制。Number.floatValue() 用於從 Number 中獲取實際值。
WEIGHT、WIDTH 和 POSTURE 的值由系統插入，系統可以選擇“最適用的”字體或者其他技巧來大致滿足使用者請求。

屬性摘要

鍵	值型別	主要常數	預設值
`FAMILY`	String	請參閱 Font `DIALOG`、`DIALOG_INPUT`、 `SERIF`、`SANS_SERIF` 和 `MONOSPACED`。	"Default"（使用平臺預設值）
`WEIGHT`	Number	WEIGHT_REGULAR、WEIGHT_BOLD	WEIGHT_REGULAR
`WIDTH`	Number	WIDTH_CONDENSED、WIDTH_REGULAR 、 WIDTH_EXTENDED	WIDTH_REGULAR
`POSTURE`	Number	POSTURE_REGULAR、POSTURE_OBLIQUE	POSTURE_REGULAR
`SIZE`	Number	無	12.0
`TRANSFORM`	`TransformAttribute`	請參閱 TransformAttribute `IDENTITY`	TransformAttribute.IDENTITY
`SUPERSCRIPT`	Integer	SUPERSCRIPT_SUPER、SUPERSCRIPT_SUB	0（使用標準字形和規格）
`FONT`	`Font`	無	null（不覆寫字體分辨率）
`CHAR_REPLACEMENT`	`GraphicAttribute`	無	null（使用字體字形繪製文本）
`FOREGROUND`	`Paint`	無	null（使用當前圖形繪製）
`BACKGROUND`	`Paint`	無	null（不呈現背景）
`UNDERLINE`	Integer	UNDERLINE_ON	-1（不呈現下劃線）
`STRIKETHROUGH`	Boolean	STRIKETHROUGH_ON	false（不呈現刪除線）
`RUN_DIRECTION`	Boolean	RUN_DIRECTION_LTR、 RUN_DIRECTION_RTL	null（使用 `Bidi` 標準預設值）
`BIDI_EMBEDDING`	Integer	無	0（使用基線方向）
`JUSTIFICATION`	Number	JUSTIFICATION_FULL	JUSTIFICATION_FULL
`INPUT_METHOD_HIGHLIGHT`	`InputMethodHighlight` 和 `Annotation`	（參見類別）	null（不應用輸入高亮顯示）
`INPUT_METHOD_UNDERLINE`	Integer	UNDERLINE_LOW_ONE_PIXEL、 UNDERLINE_LOW_TWO_PIXEL	-1（不呈現下劃線）
`SWAP_COLORS`	Boolean	SWAP_COLORS_ON	false（不交換顏色）
`NUMERIC_SHAPING`	`NumericShaper`	無	null（不對數字進行定形）
`KERNING`	Integer	KERNING_ON	0（不要求進行字距調整）
`LIGATURES`	Integer	LIGATURES_ON	0（不形成可選的連字）
`TRACKING`	Number	TRACKING_LOOSE、TRACKING_TIGHT	0（不添加追蹤）

另請參見：: Font, TextLayout, AttributedCharacterIterator, 序列化表格

欄位摘要
`static TextAttribute`	`BACKGROUND` 用於呈現文本背景的 paint 的屬性鍵。
`static TextAttribute`	`BIDI_EMBEDDING` 文本嵌入級別的屬性鍵。
`static TextAttribute`	`CHAR_REPLACEMENT` 用於取代字元的字體標準字型顯示的使用者定義字形的屬性鍵。
`static TextAttribute`	`FAMILY` 字體名稱的屬性鍵。
`static TextAttribute`	`FONT` 用於提供呈現文本字體的屬性鍵。
`static TextAttribute`	`FOREGROUND` 用於呈現文本的 paint 的屬性鍵。
`static TextAttribute`	`INPUT_METHOD_HIGHLIGHT` 用於輸入法高亮顯示樣式的屬性鍵。
`static TextAttribute`	`INPUT_METHOD_UNDERLINE` 輸入法下劃線的屬性鍵。
`static TextAttribute`	`JUSTIFICATION` 段落調整的屬性鍵。
`static Float`	`JUSTIFICATION_FULL` 將線條調整到完整的請求寬度。
`static Float`	`JUSTIFICATION_NONE` 不允許調整線條。
`static TextAttribute`	`KERNING` 請求進行字距調整的屬性鍵。
`static Integer`	`KERNING_ON` 請求標準字距調整。
`static TextAttribute`	`LIGATURES` 啟用可選連字的屬性鍵。
`static Integer`	`LIGATURES_ON` 請求標準可選連字。
`static TextAttribute`	`NUMERIC_SHAPING` 將 ASCII 十進制數字轉換為其他十進制範圍數字的屬性鍵。
`static TextAttribute`	`POSTURE` 字體形態的屬性鍵。
`static Float`	`POSTURE_OBLIQUE` 標準斜體形態。
`static Float`	`POSTURE_REGULAR` 標準直立形態。
`static TextAttribute`	`RUN_DIRECTION` 線條延伸方向的屬性鍵。
`static Boolean`	`RUN_DIRECTION_LTR` 從左到右的延伸方向。
`static Boolean`	`RUN_DIRECTION_RTL` 從右到左的延伸方向。
`static TextAttribute`	`SIZE` 字體大小的屬性鍵。
`static TextAttribute`	`STRIKETHROUGH` 刪除線的屬性鍵。
`static Boolean`	`STRIKETHROUGH_ON` 單刪除線。
`static TextAttribute`	`SUPERSCRIPT` 用於上標和下標的屬性鍵。
`static Integer`	`SUPERSCRIPT_SUB` 標準下標。
`static Integer`	`SUPERSCRIPT_SUPER` 標準上標。
`static TextAttribute`	`SWAP_COLORS` 交換前景和背景 `Paint` 的屬性鍵。
`static Boolean`	`SWAP_COLORS_ON` 交換前景和背景。
`static TextAttribute`	`TRACKING` 控制追蹤的屬性鍵。
`static Float`	`TRACKING_LOOSE` 執行寬鬆追蹤。
`static Float`	`TRACKING_TIGHT` 執行緊密追蹤。
`static TextAttribute`	`TRANSFORM` 字體轉換的屬性鍵。
`static TextAttribute`	`UNDERLINE` 下劃線的屬性鍵。
`static Integer`	`UNDERLINE_LOW_DASHED` 單像素虛線低下劃線。
`static Integer`	`UNDERLINE_LOW_DOTTED` 單像素點線式低下劃線。
`static Integer`	`UNDERLINE_LOW_GRAY` 雙像素灰色低下劃線。
`static Integer`	`UNDERLINE_LOW_ONE_PIXEL` 單像素實心低下劃線。
`static Integer`	`UNDERLINE_LOW_TWO_PIXEL` 雙像素實心低下劃線。
`static Integer`	`UNDERLINE_ON` 標準下劃線。
`static TextAttribute`	`WEIGHT` 字體 weight 的屬性鍵。
`static Float`	`WEIGHT_BOLD` 標準的粗體 weight。
`static Float`	`WEIGHT_DEMIBOLD` 比 `WEIGHT_BOLD` 稍輕的 weight。
`static Float`	`WEIGHT_DEMILIGHT` `WEIGHT_LIGHT` 和 `WEIGHT_STANDARD` 之間的中間 weight。
`static Float`	`WEIGHT_EXTRA_LIGHT` 最輕的預定義 weight。
`static Float`	`WEIGHT_EXTRABOLD` 特別重的 weight。
`static Float`	`WEIGHT_HEAVY` 比 `WEIGHT_BOLD` 稍重的 weight。
`static Float`	`WEIGHT_LIGHT` 標準的輕 weight。
`static Float`	`WEIGHT_MEDIUM` `WEIGHT_REGULAR` 和 `WEIGHT_BOLD` 之間的中間 weight。
`static Float`	`WEIGHT_REGULAR` 標準 weight。
`static Float`	`WEIGHT_SEMIBOLD` 比 `WEIGHT_REGULAR` 稍重的 weight。
`static Float`	`WEIGHT_ULTRABOLD` 最重的預定義 weight。
`static TextAttribute`	`WIDTH` 字體寬度的屬性鍵。
`static Float`	`WIDTH_CONDENSED` 最精簡的預定義 width。
`static Float`	`WIDTH_EXTENDED` 最大擴展的預定義 width。
`static Float`	`WIDTH_REGULAR` 標準 width。
`static Float`	`WIDTH_SEMI_CONDENSED` 適度精簡的 width。
`static Float`	`WIDTH_SEMI_EXTENDED` 適度擴展的 width。

從類別 java.text.AttributedCharacterIterator.Attribute 繼承的欄位
`INPUT_METHOD_SEGMENT, LANGUAGE, READING`

建構子摘要
`protected`	`TextAttribute(String name)` 建構一個具有指定名稱的 `TextAttribute`。

方法摘要
`protected Object`	`readResolve()` 將反序列化的實例解析為預定義常數。

從類別 java.text.AttributedCharacterIterator.Attribute 繼承的方法
`equals, getName, hashCode, toString`

從類別 java.lang.Object 繼承的方法
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

欄位詳細資訊

FAMILY

public static final TextAttribute FAMILY

字體名稱的屬性鍵。這些值是 String 的實例。預設值是 "Default"，該值導致使用平臺預設字體系列。

Font 類別定義用於邏輯字體名稱 DIALOG、DIALOG_INPUT、SANS_SERIF、SERIF 和 MONOSPACED 的常數。

這定義了作為 name 傳遞給 Font 建構子的值。邏輯字體名稱和實際字體名稱都允許使用。如果沒有發現具有所請求名稱的字體，則使用預設字體。

註：此屬性不幸被錯誤命名，因為它指定了外觀名稱，而不只是系列名稱。因此，“Lucida Sans Bold”之類別的值會選擇該外觀（如果存在）。注意，如果請求的外觀不存在，則預設字體可以與常規 weight 一起使用。該名稱中的“Bold”是外觀名稱的一部分，而不是字體 weight 為粗體的單獨請求。

WEIGHT

public static final TextAttribute WEIGHT

字體 weight 的屬性鍵。這些值是 Number 的實例。預設值為 WEIGHT_REGULAR。

這裡提供了一些常數值，請參閱 WEIGHT_EXTRA_LIGHT、WEIGHT_LIGHT、WEIGHT_DEMILIGHT、WEIGHT_REGULAR、WEIGHT_SEMIBOLD、WEIGHT_MEDIUM、WEIGHT_DEMIBOLD、WEIGHT_BOLD、WEIGHT_HEAVY、WEIGHT_EXTRABOLD 和 WEIGHT_ULTRABOLD。WEIGHT_BOLD 值對應於傳遞給 Font 建構子的樣式值 Font.BOLD。

該值大致為詞干寬度與常規 weight 的比。

系統可以插入提供的值。

WEIGHT_EXTRA_LIGHT

public static final Float WEIGHT_EXTRA_LIGHT

最輕的預定義 weight。

另請參見：: WEIGHT

WEIGHT_LIGHT

public static final Float WEIGHT_LIGHT

標準的輕 weight。

另請參見：: WEIGHT

WEIGHT_DEMILIGHT

public static final Float WEIGHT_DEMILIGHT

WEIGHT_LIGHT 和 WEIGHT_STANDARD 之間的中間 weight。

另請參見：: WEIGHT

WEIGHT_REGULAR

public static final Float WEIGHT_REGULAR

標準 weight。這是 WEIGHT 的預設值。

另請參見：: WEIGHT

WEIGHT_SEMIBOLD

public static final Float WEIGHT_SEMIBOLD

比 WEIGHT_REGULAR 稍重的 weight。

另請參見：: WEIGHT

WEIGHT_MEDIUM

public static final Float WEIGHT_MEDIUM

WEIGHT_REGULAR 和 WEIGHT_BOLD 之間的中間 weight。

另請參見：: WEIGHT

WEIGHT_DEMIBOLD

public static final Float WEIGHT_DEMIBOLD

比 WEIGHT_BOLD 稍輕的 weight。

另請參見：: WEIGHT

WEIGHT_BOLD

public static final Float WEIGHT_BOLD

標準的粗體 weight。

另請參見：: WEIGHT

WEIGHT_HEAVY

public static final Float WEIGHT_HEAVY

比 WEIGHT_BOLD 稍重的 weight。

另請參見：: WEIGHT

WEIGHT_EXTRABOLD

public static final Float WEIGHT_EXTRABOLD

特別重的 weight。

另請參見：: WEIGHT

WEIGHT_ULTRABOLD

public static final Float WEIGHT_ULTRABOLD

最重的預定義 weight。

另請參見：: WEIGHT

WIDTH

public static final TextAttribute WIDTH

字體寬度的屬性鍵。這些值是 Number 的實例。預設值為 WIDTH_REGULAR。

這裡提供了一些常數值，請參閱 WIDTH_CONDENSED、WIDTH_SEMI_CONDENSED、WIDTH_REGULAR、WIDTH_SEMI_EXTENDED 和 WIDTH_EXTENDED。

該值大致為 advance 寬度與常規寬度的比。

系統可以插入提供的值。

WIDTH_CONDENSED

public static final Float WIDTH_CONDENSED

最精簡的預定義 width。

另請參見：: WIDTH

WIDTH_SEMI_CONDENSED

public static final Float WIDTH_SEMI_CONDENSED

適度精簡的 width。

另請參見：: WIDTH

WIDTH_REGULAR

public static final Float WIDTH_REGULAR

標準 width。這是 WIDTH 的預設值。

另請參見：: WIDTH

WIDTH_SEMI_EXTENDED

public static final Float WIDTH_SEMI_EXTENDED

適度擴展的 width。

另請參見：: WIDTH

WIDTH_EXTENDED

public static final Float WIDTH_EXTENDED

最大擴展的預定義 width。

另請參見：: WIDTH

POSTURE

public static final TextAttribute POSTURE

字體形態的屬性鍵。這些值是 Number 的實例。預設值為 POSTURE_REGULAR。

這裡提供了兩個常數值 POSTURE_REGULAR 和 POSTURE_OBLIQUE。POSTURE_OBLIQUE 值對應於傳遞給 Font 建構子的樣式值 Font.ITALIC。

該值粗略地表示了字體詞干的傾斜度，它以鄰邊除以對邊的形式表示。正值表示向右傾斜。

系統可以插入提供的值。

這將會影響字體的傾斜角度，該角度由 Font.getItalicAngle 返回。

另請參見：: Font.getItalicAngle()

POSTURE_REGULAR

public static final Float POSTURE_REGULAR

標準直立形態。這是 POSTURE 的預設值。

另請參見：: POSTURE

POSTURE_OBLIQUE

public static final Float POSTURE_OBLIQUE

標準斜體形態。

另請參見：: POSTURE

SIZE

public static final TextAttribute SIZE

字體大小的屬性鍵。這些值是 Number 的實例。預設值為 12pt。

這對應於 Font 建構子的 size 參數。

非常大或非常小的大小將影響呈現性能，呈現系統可能不會以這些大小呈現文本。負大小是非法的，會導致使用預設尺寸。

注意，採用 2x 轉換的 12pt 字體的外觀和規格可能與未轉換的 24pt 字體不同。

TRANSFORM

public static final TextAttribute TRANSFORM

字體轉換的屬性鍵。這些值是 TransformAttribute 的實例。預設值為 TransformAttribute.IDENTITY。

TransformAttribute 類別定義了常數 IDENTITY。

這對應於傳遞給 Font.deriveFont(AffineTransform) 的轉換。由於該轉換是可變的，並且 TextAttribute 值不可以為 null，所以使用的是 TransformAttribute 套件裝器類別。

該值主要用於支持縮放和傾斜，但可能還有其他作用。

某些轉換會導致基線旋轉和/或移位。將文本和基線一起轉換，從而文本將遵循新的基線。例如，對於水平基線上的文本，新的基線將遵循通過轉換得到的 x 向量單元的方向。文本規格是針對此新基線進行測量的。因此，如果其他屬性相同，使用旋轉的 TRANSFORM 和非旋轉的 TRANSFORM 呈現的文本都將視為具有相同上行高度 (ascent)、下行高度 (descent) 和步進 (advance)。

在樣式化文本中，每個這樣延伸的基線都將一個接一個地排列，從而可能為整個文本延伸創建一條非線性的基線。有關更多資訊，請參閱 TextLayout.getLayoutPath()。

另請參見：: TransformAttribute, AffineTransform

SUPERSCRIPT

public static final TextAttribute SUPERSCRIPT

用於上標和下標的屬性鍵。這些值是 Integer 的實例。預設值為 0，意味著沒有使用上標或下標。

這裡提供了兩個常數值，請參閱 SUPERSCRIPT_SUPER 和 SUPERSCRIPT_SUB。這兩個常數的值分別為 1 和 -1。較大的大小值定義上標或下標的較高層級別，例如，2 對應於 super-superscript，3 對應於 super-super-superscript，同樣地，對於負值和下標，級別可以高達 7（或 -7）。超出此範圍的值被保留；這些值代表的行為與平臺有關。

SUPERSCRIPT 會影響字體的 ascent 和 descent。但是，ascent 和 descent 始終不能為負。

SUPERSCRIPT_SUPER

public static final Integer SUPERSCRIPT_SUPER

標準上標。

另請參見：: SUPERSCRIPT

SUPERSCRIPT_SUB

public static final Integer SUPERSCRIPT_SUB

標準下標。

另請參見：: SUPERSCRIPT

FONT

public static final TextAttribute FONT

用於提供呈現文本字體的屬性鍵。這些值是 Font 的實例。預設值為 null，指示應該根據屬性執行 Font 的正常分辨率。

TextLayout 和 AttributedCharacterIterator 根據 TextAttribute 的 Map 進行工作。通常，所有屬性都被檢查，並被用於選擇和配置 Font 實例。然而，如果存在 FONT 屬性，將使用其關聯 Font。這為使用者提供了一種將字體的分辨率屬性覆寫到 Font，或強制使用特定 Font 實例的方法。這還允許使用者在可以子類別化 Font 的情況下指定 Font 的子類別。

FONT 適用於特殊情形，在這些情形下，客戶端已經擁有 Font 實例但是仍然需要使用基於 Map 的 API。通常，Map 中除了 FONT 屬性以外沒有其他屬性。對於基於 Map 的 API，常見情形是單獨指定所有屬性，因此無需 FONT。

但是，如果 FONT 和其他屬性都存在於 Map 中，那麼呈現系統會將 Font 中定義的屬性與附加屬性合併。此合併過程將 TextAttributes 分為兩組。一組（“主要”組）被認為是字體的選擇和規格行為的基礎。這些屬性有 FAMILY、WEIGHT、WIDTH、POSTURE、SIZE、TRANSFORM、SUPERSCRIPT 和 TRACKING。另一組（“次要”組）由除了 FONT 自身以外的所有其他已定義屬性組成。

要產生新的 Map，首先需要從 FONT 屬性獲得 Font，並將它的所有屬性提取為一個新的 Map。然後，只將取自原始 Map 的次要屬性添加到新 Map 的屬性中。因此，主要屬性的值僅取自 Font，而次要屬性的值源自 Font，但可以用 Map 中的其他值覆寫它們。

註：Font 的基於 Map 的建構子和 deriveFont 方法不處理 FONT 屬性，因為這些屬性用於創建新的 Font 物件。相反，Font.getFont(Map) 應該用於處理 FONT 屬性。

另請參見：: Font

CHAR_REPLACEMENT

public static final TextAttribute CHAR_REPLACEMENT

用於取代字元的字體標準字型顯示的使用者定義字形的屬性鍵。這些值是 GraphicAttribute 的實例。預設值為 null，指示應該使用字體提供的標準字形。

此屬性用於為圖形或文本行中嵌入的其他元件保留空間。在執行雙向重排序（請參閱 Bidi）時，它對於正確排列“內聯”元件在某一行中的位置是必需的。每個字元（Unicode 程式碼點）都將使用提供的 GraphicAttribute 呈現。通常，應用此屬性的字元應是 \uFFFC。

GraphicAttribute 確定文本的邏輯邊界和可視邊界；實際 Font 值被忽略。

另請參見：: GraphicAttribute

FOREGROUND

public static final TextAttribute FOREGROUND

用於呈現文本的 paint 的屬性鍵。這些值是 Paint 的實例。預設值為 null，指示使用呈現時在 Graphics2D 上設置的 Paint。

無論 Graphics 上設置的 Paint 值是什麼，字形都將使用此 Paint 呈現（但是請參閱 SWAP_COLORS）。

另請參見：: Paint, SWAP_COLORS

BACKGROUND

public static final TextAttribute BACKGROUND

用於呈現文本背景的 paint 的屬性鍵。這些值是 Paint 的實例。預設值為 null，指示不應呈現背景。

文本的邏輯邊界將使用此 Paint 填充，然後該文本呈現於 Paint 之上（但是請參閱 SWAP_COLORS）。

如果有必要，可以擴展文本的可視邊界來包含邏輯邊界。輪廓不會受影響。

另請參見：: Paint, SWAP_COLORS

UNDERLINE

public static final TextAttribute UNDERLINE

下劃線的屬性鍵。這些值是 Integer 的實例。預設值為 -1，表示沒有下劃線。

提供的常數值是 UNDERLINE_ON。

下劃線可影響可視邊界和文本輪廓。

UNDERLINE_ON

public static final Integer UNDERLINE_ON

標準下劃線。

另請參見：: UNDERLINE

STRIKETHROUGH

public static final TextAttribute STRIKETHROUGH

刪除線的屬性鍵。這些值是 Boolean 的實例。預設值為 false，表示沒有刪除線。

提供的常數值是 STRIKETHROUGH_ON。

刪除線可影響可視邊界和文本輪廓。

STRIKETHROUGH_ON

public static final Boolean STRIKETHROUGH_ON

單刪除線。

另請參見：: STRIKETHROUGH

RUN_DIRECTION

public static final TextAttribute RUN_DIRECTION

線條延伸方向的屬性鍵。這些值是 Boolean 的實例。預設值為 null，指示用來確定延伸方向的標準 Bidi 演算法應該與 Bidi.DIRECTION_DEFAULT_LEFT_TO_RIGHT 值一起使用。

提供的常數是 RUN_DIRECTION_RTL 和 RUN_DIRECTION_LTR。

這確定了傳遞給 Bidi 建構子的值，以選擇段落中文本的主方向。

註：對於段落中的所有文本，此屬性都應該具有相同的值，否則，行為將是不確定的。

另請參見：: Bidi

RUN_DIRECTION_LTR

public static final Boolean RUN_DIRECTION_LTR

從左到右的延伸方向。

另請參見：: RUN_DIRECTION

RUN_DIRECTION_RTL

public static final Boolean RUN_DIRECTION_RTL

從右到左的延伸方向。

另請參見：: RUN_DIRECTION

BIDI_EMBEDDING

public static final TextAttribute BIDI_EMBEDDING

文本嵌入級別的屬性鍵。這些值是 Integer 的實例。預設值為 null，指示在沒有顯式嵌入的情況下應該使用雙向演算法。

1 到 61 的正值是嵌入級別，-1 到 -61 的負值是覆寫級別。0 值表示使用基線方向。這些級別被傳入 Bidi 建構子的嵌入級別陣列。

註：如果此屬性出現在段落中的任何位置，則該段落中的所有 Unicode bidi 控制字元（RLO、LRO、RLE、LRE 和 PDF）都將被忽略，沒有此屬性的情況下，文本延伸時假定此屬性存在，並且屬性值為 0。

另請參見：: Bidi

JUSTIFICATION

public static final TextAttribute JUSTIFICATION

段落調整的屬性鍵。這些值是 Number 的實例。預設值為 1，指示調整時應該使用所提供的完整寬度。這些值被限制在 [0..1] 範圍內。

提供的常數是 JUSTIFICATION_FULL 和 JUSTIFICATION_NONE。

當請求在 TextLayout 上進行調整時，指定要使用的額外空間部分。例如，如果該線條寬為 50 磅，要求調整到 70 磅，則值 0.75 會使用多餘空間的四分之三（或 15 磅）來填補，這樣得到的線條長度為 65 磅。

註：對於段落中的所有文本，此屬性都應該具有相同的值，否則，行為將是不確定的。

另請參見：: TextLayout.getJustifiedLayout(float)

JUSTIFICATION_FULL

public static final Float JUSTIFICATION_FULL

將線條調整到完整的請求寬度。這是 JUSTIFICATION 的預設值。

另請參見：: JUSTIFICATION

JUSTIFICATION_NONE

public static final Float JUSTIFICATION_NONE

不允許調整線條。

另請參見：: JUSTIFICATION

INPUT_METHOD_HIGHLIGHT

public static final TextAttribute INPUT_METHOD_HIGHLIGHT

用於輸入法高亮顯示樣式的屬性鍵。

這些值是 InputMethodHighlight 或 Annotation 的實例。預設值為 null，指示在呈現前不應該應用輸入法樣式。

如果需要單獨呈現具有相同 InputMethodHighlight 的文本鄰近延伸，則應在 Annotation 實例中包裹 InputMethodHighlight。

在使用輸入法撰寫文本時，將使用輸入法高亮顯示。即使是通常只處理無樣式文本的文本編輯元件，也應保留輸入法高亮顯示，並使它們可用於繪製例程。

另請參見：: Font, InputMethodHighlight, Annotation

INPUT_METHOD_UNDERLINE

public static final TextAttribute INPUT_METHOD_UNDERLINE

輸入法下劃線的屬性鍵。這些值是 Integer 的實例。預設值為 -1，表示沒有下劃線。

這裡提供了一些常數值，請參閱 UNDERLINE_LOW_ONE_PIXEL、UNDERLINE_LOW_TWO_PIXEL、UNDERLINE_LOW_DOTTED、UNDERLINE_LOW_GRAY 和 UNDERLINE_LOW_DASHED。

如果需要，此值可以與 UNDERLINE 一起使用。該值主要用於輸入法。在其他地方使用這些簡單裝飾下劃線可能會使使用者迷惑。

輸入法下劃線可影響可視邊界和文本輪廓。

從以下版本開始：: 1.3

UNDERLINE_LOW_ONE_PIXEL

public static final Integer UNDERLINE_LOW_ONE_PIXEL

單像素實心低下劃線。

從以下版本開始：: 1.3
另請參見：: INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_TWO_PIXEL

public static final Integer UNDERLINE_LOW_TWO_PIXEL

雙像素實心低下劃線。

從以下版本開始：: 1.3
另請參見：: INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_DOTTED

public static final Integer UNDERLINE_LOW_DOTTED

單像素點線式低下劃線。

從以下版本開始：: 1.3
另請參見：: INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_GRAY

public static final Integer UNDERLINE_LOW_GRAY

雙像素灰色低下劃線。

從以下版本開始：: 1.3
另請參見：: INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_DASHED

public static final Integer UNDERLINE_LOW_DASHED

單像素虛線低下劃線。

從以下版本開始：: 1.3
另請參見：: INPUT_METHOD_UNDERLINE

SWAP_COLORS

public static final TextAttribute SWAP_COLORS

交換前景和背景 Paint 的屬性鍵。這些值是 Boolean 的實例。預設值為 false，表示不交換顏色。

定義的常數值是 SWAP_COLORS_ON。

如果設置 FOREGROUND 屬性，則它的 Paint 將被用作背景，否則，將使用當前 Graphics 上的 Paint。如果設置 BACKGROUND 屬性，則它的 Paint 將被用作前景，否則，系統將給（已解析）背景找到一種對比色，使文本可見。

另請參見：: FOREGROUND, BACKGROUND

SWAP_COLORS_ON

public static final Boolean SWAP_COLORS_ON

交換前景和背景。

從以下版本開始：: 1.3
另請參見：: SWAP_COLORS

NUMERIC_SHAPING

public static final TextAttribute NUMERIC_SHAPING

將 ASCII 十進制數字轉換為其他十進制範圍數字的屬性鍵。這些值是 NumericShaper 的實例。預設值為 null，表示不執行數字成形。

當定義了一個數字成形器時，在執行其他任何文本分析之前，首先用成形器處理該文本。

註：對於段落中的所有文本，此屬性都應該具有相同的值，否則行為將是不確定的。

從以下版本開始：: 1.4
另請參見：: NumericShaper

KERNING

public static final TextAttribute KERNING

請求進行字距調整的屬性鍵。這些值是 Integer 的實例。預設值為 0，表示不請求進行字距調整。

提供的常數值是 KERNING_ON。

單個字元的預設 advance 不適合某些字元序列，例如，“To”或“AWAY”。若沒有進行字距調整，那麼相鄰字元看起來好像使用了太多的空格來分隔。字距調整使選定的字元序列採用不同的空格來分隔，以獲得更舒適的可視外觀。

從以下版本開始：: 1.6

KERNING_ON

public static final Integer KERNING_ON

請求標準字距調整。

從以下版本開始：: 1.6
另請參見：: KERNING

LIGATURES

public static final TextAttribute LIGATURES

啟用可選連字的屬性鍵。這些值是 Integer 的實例。預設值為 0，表示不使用可選的連字。

定義的常數值是 LIGATURES_ON。

始終啟用書寫系統所需的連字。

從以下版本開始：: 1.6

LIGATURES_ON

public static final Integer LIGATURES_ON

請求標準可選連字。

從以下版本開始：: 1.6
另請參見：: LIGATURES

TRACKING

public static final TextAttribute TRACKING

控制追蹤的屬性鍵。這些值是 Number 的實例。預設值為 0，表示沒有附加的追蹤。

提供的常數值是 TRACKING_TIGHT 和 TRACKING_LOOSE。

追蹤值與字體磅值大小相乘，並通過字體轉換傳遞，以確定要添加到每種字形群的 advance 的附加量。正追蹤值將禁止可選連字格式。追蹤值通常在 -0.1 與 0.3 之間，超出此範圍的值通常是不需要的。

從以下版本開始：: 1.6

TRACKING_TIGHT

public static final Float TRACKING_TIGHT

執行緊密追蹤。

從以下版本開始：: 1.6
另請參見：: TRACKING

TRACKING_LOOSE

public static final Float TRACKING_LOOSE

執行寬鬆追蹤。

從以下版本開始：: 1.6
另請參見：: TRACKING

建構子詳細資訊

TextAttribute

protected TextAttribute(String name)

建構一個具有指定名稱的 TextAttribute。

參數：: name - 分派給此 TextAttribute 的屬性名

方法詳細資訊

readResolve

protected Object readResolve()
                      throws InvalidObjectException

將反序列化的實例解析為預定義常數。

覆寫：: 類別 AttributedCharacterIterator.Attribute 中的 readResolve

拋出：: InvalidObjectException

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 Platform
Standard Ed. 6

上一個類別 下一個類別

框架 無框架

摘要：巢狀 | 欄位 | 建構子 | 方法

詳細資訊：欄位 | 建構子 | 方法

提交錯誤或意見

java.awt.font 類別 TextAttribute

值

屬性摘要

FAMILY

WEIGHT

WEIGHT_EXTRA_LIGHT

WEIGHT_LIGHT

WEIGHT_DEMILIGHT

WEIGHT_REGULAR

WEIGHT_SEMIBOLD

WEIGHT_MEDIUM

WEIGHT_DEMIBOLD

WEIGHT_BOLD

WEIGHT_HEAVY

WEIGHT_EXTRABOLD

WEIGHT_ULTRABOLD

WIDTH

WIDTH_CONDENSED

WIDTH_SEMI_CONDENSED

WIDTH_REGULAR

WIDTH_SEMI_EXTENDED

WIDTH_EXTENDED

POSTURE

POSTURE_REGULAR

POSTURE_OBLIQUE

SIZE

TRANSFORM

SUPERSCRIPT

SUPERSCRIPT_SUPER

SUPERSCRIPT_SUB

FONT

CHAR_REPLACEMENT

FOREGROUND

BACKGROUND

UNDERLINE

UNDERLINE_ON

STRIKETHROUGH

STRIKETHROUGH_ON

RUN_DIRECTION

RUN_DIRECTION_LTR

RUN_DIRECTION_RTL

BIDI_EMBEDDING

JUSTIFICATION

JUSTIFICATION_FULL

JUSTIFICATION_NONE

INPUT_METHOD_HIGHLIGHT

INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_ONE_PIXEL

UNDERLINE_LOW_TWO_PIXEL

UNDERLINE_LOW_DOTTED

UNDERLINE_LOW_GRAY

UNDERLINE_LOW_DASHED

SWAP_COLORS

SWAP_COLORS_ON

NUMERIC_SHAPING

KERNING

KERNING_ON

LIGATURES

LIGATURES_ON

TRACKING

TRACKING_TIGHT

TRACKING_LOOSE

TextAttribute

readResolve

java.awt.font
類別 TextAttribute