モジュール java.desktop
パッケージ java.awt.font

クラスTextAttribute

java.lang.Object
java.text.AttributedCharacterIterator.Attribute
java.awt.font.TextAttribute
すべての実装されたインタフェース:
Serializable
public final class TextAttribute extends AttributedCharacterIterator.Attribute
TextAttributeクラスは、テキストのレンダリングに使用する属性キーおよび属性値を定義します。

TextAttributeのインスタンスは、テキスト属性を扱うFont、TextLayout、AttributedCharacterIteratorなどのクラスで属性を識別するための属性キーとして使用されます。 このクラスで定義されているその他の定数は属性値として使用できます。

各テキスト属性に関して、このドキュメントでは次の項目について説明しています。

  • 値の型
  • 関連する定義済み定数(存在する場合)
  • 属性が設定されていない場合のデフォルトの効果
  • 制限がある場合の有効値
  • 効果の説明

値

  • 属性値は常に不変でなければなりません。
  • 値の制限がある場合、その制限に該当しない値は将来の使用に備えて確保され、デフォルトとして扱われます。
  • null値はデフォルト値と同じものとして扱われ、結果としてデフォルトの動作になります。
  • 値の型が適切でない場合、その属性は無視されます。
  • 値の識別情報は重要ではなく、実際の値が考慮されます。 たとえば、TextAttribute.WEIGHT_BOLDとFloat.valueOf(2.0f)は、同じWEIGHTを示します。
  • WEIGHT、WIDTH、POSTURE、SIZE、JUSTIFICATION、およびTRACKINGに使用されるNumber型の属性値は、その固有の範囲内で変化でき、定義済み定数に制限されることはありません。 Number.floatValue()は、Numberから実際の値を取得するために使用されます。
  • WEIGHT、WIDTH、およびPOSTUREの値はシステムで補間され、ユーザーの要求に近づけるために「もっとも近い使用可能なフォント」を選択するなどの技法が使用される場合があります。

属性のサマリー

すべてのTextAttributesのキー、値の型、主な定数、およびデフォルト値の動作
Key 値の型 主な定数 デフォルト値
FAMILY String 「フォント」DIALOG、DIALOG_INPUT、
SERIF、SANS_SERIFおよびMONOSPACED。 		「Default」(プラットフォームのデフォルトを使用します)
WEIGHT 数値 WEIGHT_REGULAR、WEIGHT_BOLD WEIGHT_REGULAR
WIDTH 数値 WIDTH_CONDENSED、WIDTH_REGULAR、
WIDTH_EXTENDED 		WIDTH_REGULAR
POSTURE 数値 POSTURE_REGULAR、POSTURE_OBLIQUE POSTURE_REGULAR
SIZE 数値 none 12.0
TRANSFORM TransformAttribute TransformAttribute IDENTITYを参照 TransformAttribute.IDENTITY
SUPERSCRIPT 整数 SUPERSCRIPT_SUPER、SUPERSCRIPT_SUB 0 (標準のグリフとメトリックスを使用します)
FONT Font none null (フォントの解決をオーバーライドしません)
CHAR_REPLACEMENT GraphicAttribute none null (フォントのグリフを使用してテキストを描画します)
FOREGROUND Paint none null (現在のグラフィックスのペイントを使用します)
BACKGROUND Paint none null (バックグラウンドを描画しません)
UNDERLINE 整数 UNDERLINE_ON -1 (下線を描画しません)
STRIKETHROUGH Boolean STRIKETHROUGH_ON false (取消し線を描画しません)
RUN_DIRECTION Boolean RUN_DIRECTION_LTR
RUN_DIRECTION_RTL 		null (Bidi標準のデフォルトを使用します)
BIDI_EMBEDDING 整数 none 0 (基本の行方向を使用します)
JUSTIFICATION 数値 JUSTIFICATION_FULL JUSTIFICATION_FULL
INPUT_METHOD_HIGHLIGHT InputMethodHighlight,
Annotation 		(クラスを参照) null (インプット・ハイライトを適用しません)
INPUT_METHOD_UNDERLINE 整数 UNDERLINE_LOW_ONE_PIXEL、
UNDERLINE_LOW_TWO_PIXEL 		-1 (下線を描画しません)
SWAP_COLORS Boolean SWAP_COLORS_ON false (色を交換しません)
NUMERIC_SHAPING NumericShaper none null (数字の形状決定を行いません)
KERNING 整数 KERNING_ON 0 (カーニングを要求しません)
LIGATURES 整数 LIGATURES_ON 0 (オプション合字を作成しません)
TRACKING 数値 TRACKING_LOOSE、TRACKING_TIGHT 0 (トラッキングを追加しません)
関連項目: