モジュール 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 Integer SUPERSCRIPT_SUPER、SUPERSCRIPT_SUB 0 (標準のグリフとメトリックスを使用します)
FONT Font none null (フォントの解決をオーバーライドしません)
CHAR_REPLACEMENT GraphicAttribute none null (フォントのグリフを使用してテキストを描画します)
FOREGROUND Paint none null (現在のグラフィックスのペイントを使用します)
BACKGROUND Paint none 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 none 0 (基本の行方向を使用します)
JUSTIFICATION 数値 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 none null (数字の形状決定を行いません)
KERNING Integer KERNING_ON 0 (カーニングを要求しません)
LIGATURES Integer LIGATURES_ON 0 (オプション合字を作成しません)
TRACKING 数値 TRACKING_LOOSE、TRACKING_TIGHT 0 (トラッキングを追加しません)
関連項目:

  • フィールド詳細

    • FAMILY

      public static final TextAttribute FAMILY
      フォント名を表す属性キーです。 値はStringのインスタンスです。 デフォルト値は"Default"で、その場合はプラットフォームのデフォルトのフォント・ファミリが使用されます。

      Fontクラスは、論理フォント名DIALOG、DIALOG_INPUT、SANS_SERIF、SERIF、およびMONOSPACEDに対応する定数を定義します。

      これは、Fontコンストラクタにnameとして渡される値を定義します。 論理フォント名と物理フォント名の両方を使用できます。 指定された名前を持つフォントが見つからない場合は、デフォルトのフォントが使用されます。

      ノート: この属性はファミリだけでなくフェース名も指定するので、この属性名は不適切です。 「Lucida Sans Bold」などの値を指定すると、そのフェースが存在する場合はそれが選択されます。 ただし、要求されたフェースが存在しない場合は、標準ウエイトのデフォルトが使用されます。 名前に含まれている「Bold」はフェース名の一部であり、フォントのウエイトを太字にするという個別の要求ではありません。

    • WEIGHT

      public static final TextAttribute 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_EXTRA_LIGHT

      public static final Float WEIGHT_EXTRA_LIGHT
      もっとも軽い定義済みウエイトです。
      関連項目:

    • WEIGHT_LIGHT

      public static final Float WEIGHT_LIGHT
      標準の軽量ウエイトです。
      関連項目:

    • WEIGHT_DEMILIGHT

      public static final Float WEIGHT_DEMILIGHT
      WEIGHT_LIGHTとWEIGHT_STANDARDの中間のウエイトです。
      関連項目:

    • WEIGHT_REGULAR

      public static final Float WEIGHT_REGULAR
      標準のウエイトです。 これが、WEIGHTのデフォルト値です。
      関連項目:

    • WEIGHT_SEMIBOLD

      public static final Float WEIGHT_SEMIBOLD
      WEIGHT_REGULARよりやや重いウエイトです。
      関連項目:

    • WEIGHT_MEDIUM

      public static final Float WEIGHT_MEDIUM
      WEIGHT_REGULARとWEIGHT_BOLDの中間のウエイトです。
      関連項目:

    • WEIGHT_DEMIBOLD

      public static final Float WEIGHT_DEMIBOLD
      WEIGHT_BOLDよりやや軽いウエイトです。
      関連項目:

    • WEIGHT_BOLD

      public static final Float WEIGHT_BOLD
      標準の太字ウエイトです。
      関連項目:

    • WEIGHT_HEAVY

      public static final Float WEIGHT_HEAVY
      WEIGHT_BOLDよりやや重いウエイトです。
      関連項目:

    • WEIGHT_EXTRABOLD

      public static final Float WEIGHT_EXTRABOLD
      非常に重いウエイトです。
      関連項目:

    • WEIGHT_ULTRABOLD

      public static final Float WEIGHT_ULTRABOLD
      もっとも重い定義済みウエイトです。
      関連項目:

    • WIDTH

      public static final TextAttribute WIDTH
      フォントの幅を表す属性キーです。 値はNumberのインスタンスです。 デフォルト値はWIDTH_REGULARです。

      いくつかの定数値が用意されています。WIDTH_CONDENSED、WIDTH_SEMI_CONDENSED、WIDTH_REGULAR、WIDTH_SEMI_EXTENDED、WIDTH_EXTENDEDを参照してください。

      この値は、標準幅に対する有効幅の比率にほぼ等しくなります。

      指定された値はシステムで補間される場合があります。

    • WIDTH_CONDENSED

      public static final Float WIDTH_CONDENSED
      もっとも狭い定義済みの幅です。
      関連項目:

    • WIDTH_SEMI_CONDENSED

      public static final Float WIDTH_SEMI_CONDENSED
      やや狭い幅です。
      関連項目:

    • WIDTH_REGULAR

      public static final Float WIDTH_REGULAR
      標準の幅です。 これが、WIDTHのデフォルト値です。
      関連項目:

    • WIDTH_SEMI_EXTENDED

      public static final Float WIDTH_SEMI_EXTENDED
      やや広い幅です。
      関連項目:

    • WIDTH_EXTENDED

      public static final Float WIDTH_EXTENDED
      もっとも広い定義済みの幅です。
      関連項目:

    • POSTURE

      public static final TextAttribute POSTURE
      フォントのポスチャを表す属性キーです。 値はNumberのインスタンスです。 デフォルト値はPOSTURE_REGULARです。

      2つの定数値が用意されています。POSTURE_REGULARとPOSTURE_OBLIQUEを参照してください。 値POSTURE_OBLIQUEは、Fontコンストラクタに渡されるスタイル値Font.ITALICに対応します。

      この値は、フォントのステムの傾きを水平距離/垂直高さで表したものにほぼ等しくなります。 正の値の場合は、右側へ傾いています。

      指定された値はシステムで補間される場合があります。

      これは、Font.getItalicAngleで返されるフォントのイタリックの角度に影響を与えます。

      関連項目:

    • POSTURE_REGULAR

      public static final Float POSTURE_REGULAR
      標準ポスチャである垂直です。 これが、POSTUREのデフォルト値です。
      関連項目:

    • POSTURE_OBLIQUE

      public static final Float POSTURE_OBLIQUE
      標準イタリック・ポスチャです。
      関連項目:

    • SIZE

      public static final TextAttribute SIZE
      フォント・サイズを表す属性キーです。 値はNumberのインスタンスです。 デフォルト値は12ptです。

      これは、Fontコンストラクタに渡されるsizeパラメータに対応します。

      非常に大きいサイズや小さいサイズを指定すると、描画パフォーマンスに影響を与え、描画システムによってテキストが指定のサイズで描画されない場合もあります。 負のサイズは不正であり、その場合はデフォルトのサイズになります。

      2倍に変換された12ptのフォントの外観およびメトリックスは、変換されていない24ptのフォントの外観およびメトリックスと異なる場合があります。

    • TRANSFORM

      public static final TextAttribute TRANSFORM
      フォントの変換を表す属性キーです。 値はTransformAttributeのインスタンスです。 デフォルト値はTransformAttribute.IDENTITYです。

      TransformAttributeクラスは、定数IDENTITYを定義します。

      これは、Font.deriveFont(AffineTransform)に渡される変換に対応します。 変換は可変ですが、TextAttribute値は不変でなければならないため、TransformAttributeラッパー・クラスが使用されます。

      主な目的は、(ほかの効果にも使用できますが)スケーリングとスキューをサポートすることです。

      一部の変換では、ベースラインの回転や移動が発生します。 テキストが新しいベースラインに沿うように、テキストとベースラインは一緒に変換されます。 たとえば、テキストが水平のベースライン上にある場合、新しいベースラインは変換を通して渡された単位xベクトルの向きに従います。 テキストのメトリックスは、この新しいベースラインに対して測定されます。 したがって、たとえば、回転されるTRANSFORMでテキストを描画した場合と回転されないTRANSFORMでテキストを描画した場合では、ほかの条件が等しければ、測定されるアセント、ディセント、および有効幅は同じになります。

      書式付きテキストでは、このような各ランのベースラインが順にそろえられ、テキストのラン全体のベースラインは直線でなくなる場合があります。 詳細は、TextLayout.getLayoutPath()を参照してください。

      関連項目:

    • SUPERSCRIPT

      public static final TextAttribute SUPERSCRIPT
      上付き文字や下付き文字を表す属性キーです。 値はIntegerのインスタンスです。 デフォルト値は0で、上付き文字や下付き文字を使用しないことを意味します。

      2つの定数値が用意されています。SUPERSCRIPT_SUPERとSUPERSCRIPT_SUBを参照してください。 これらの値はそれぞれ1と -1です。 絶対値が大きいほど、定義される上付きまたは下付きのレベルが大きくなります。たとえば、2は上付きの上付き、3は上付きの上付きの上付きに対応します。負の値と下付きについても同様です。7 (または -7)までのレベルがあります。 この範囲を超える値は予約済みで、その動作はプラットフォームに依存します。

      SUPERSCRIPTは、フォントのアセントとディセントに影響を与えることがあります。 ただし、アセントとディセントが負になることはあり得ません。

    • SUPERSCRIPT_SUPER

      public static final Integer SUPERSCRIPT_SUPER
      標準の上付き文字です。
      関連項目:

    • SUPERSCRIPT_SUB

      public static final Integer SUPERSCRIPT_SUB
      標準の下付き文字です。
      関連項目:

    • FONT

      public static final TextAttribute FONT
      テキストの描画に使用するフォントを指定するための属性キーです。 値はFontのインスタンスです。 デフォルト値はnullで、属性からFontへの通常の解決が実行されることを示します。

      TextLayoutとAttributedCharacterIteratorは、TextAttributesのMapsとして動作します。 通常、Fontインスタンスを選択したり設定したりするときには、すべての属性が調べられ、使用されます。 ただし、FONT属性が存在する場合は、それに関連付けられているFontが使用されます。 ユーザーは、この方法を使用して、フォント属性のFontへの解決をオーバーライドしたり、特定のFontのインスタンスを強制的に使用したりできます。 これにより、Fontがサブクラス化できる場合に、ユーザーがFontのサブクラスを指定することもできます。

      FONTは、クライアントがFontインスタンスをすでに持っているが、MapベースのAPIを引き続き使用しなければならない特殊な状況に使用されます。 通常、Mapには、FONT属性以外の属性はありません。 MapベースのAPIでは、一般的にはすべての属性を個別に指定するため、FONTは不要または望ましいものではありません。

      ただし、MapにFONTとほかの属性が両方とも存在する場合、描画システムは、Fontで定義されている属性とほかの属性をマージします。 マージ処理では、TextAttributesが2つのグループに分類されます。 1つは、フォントの選択とメトリックスの動作にとって基本的と見なされる「プライマリ」グループです。 このような属性は、FAMILY、WEIGHT、WIDTH、POSTURE、SIZE、TRANSFORM、SUPERSCRIPT、およびTRACKINGです。 もう1つは、FONT自体を除くその他すべての定義済み属性で構成される「2次」グループです。

      新しいMapを生成するときは、まずFONT属性からFontが取得され、そのすべての属性が新しいMapに抽出されます。 次に、元のMapから新しいMapに、2次属性だけが追加されます。 したがって、主要属性の値は、Fontだけから取得されます。2次属性の値は、最初はFontから取得されますが、Map内のほかの値でオーバーライドされる場合があります。

      ノート: フォントの MapベースのコンストラクタとderiveFontメソッドは、新しいFontオブジェクトの作成に使用されるので、FONT属性を処理しません。 FONT属性を処理するには、代わりにFont.getFont(Map)を使用するようにしてください。

      関連項目:

    • CHAR_REPLACEMENT

      public static final TextAttribute CHAR_REPLACEMENT
      文字のフォントの標準グリフの代わりに表示する、ユーザー定義のグリフを表す属性キーです。 値はGraphicAttributeのインスタンスです。 デフォルト値はnullで、フォントの標準グリフが使用されることを示します。

      この属性は、テキストの行内に埋め込まれる図形などのコンポーネントの領域を確保するために使用されます。 双方向の並べ替え(Bidiを参照)を実行するときに、「インライン」コンポーネントを行内に正しく配置するために必要です。 各文字(Unicodeコード・ポイント)は、指定されたGraphicAttributeを使用して描画されます。 通常、この属性が適用される文字は\uFFFCです。

      GraphicAttributeは、テキストの論理境界と視覚境界を決定します。実際のFont値は無視されます。

      関連項目:

    • FOREGROUND

      public static final TextAttribute FOREGROUND
      テキストの描画に使用されるペイントを表す属性キーです。 値はPaintのインスタンスです。 デフォルト値はnullで、描画時にGraphics2Dに設定されているPaintが使用されることを示します。

      グリフは、Graphicsに設定されているPaint値にかかわらず、このPaintを使用して描画されます(ただし、SWAP_COLORSを参照)。

      関連項目:

    • BACKGROUND

      public static final TextAttribute BACKGROUND
      テキストのバックグラウンドの描画に使用されるペイントを表す属性キーです。 値はPaintのインスタンスです。 デフォルト値はnullで、バックグラウンドが描画されないことを示します。

      このPaintを使用してテキストの論理境界が塗りつぶされたあと、その上にテキストが描画されます(ただし、SWAP_COLORSを参照)。

      必要に応じて、テキストの視覚境界が論理境界を含むように拡張されます。 輪郭は影響を受けません。

      関連項目:

    • UNDERLINE

      public static final TextAttribute UNDERLINE
      下線を表す属性キーです。 値はIntegerのインスタンスです。 デフォルト値は -1で、下線がないことを意味します。

      定数値UNDERLINE_ONが提供されています。

      下線は、テキストの視覚境界と輪郭の両方に影響を与えます。

    • UNDERLINE_ON

      public static final Integer UNDERLINE_ON
      標準の下線です。
      関連項目:

    • STRIKETHROUGH

      public static final TextAttribute STRIKETHROUGH
      取消し線を表す属性キーです。 値はBooleanのインスタンスです。 デフォルト値はfalseで、取消し線がないことを意味します。

      定数値STRIKETHROUGH_ONが提供されています。

      取消し線は、テキストの視覚境界と輪郭の両方に影響を与えます。

    • STRIKETHROUGH_ON

      public static final Boolean STRIKETHROUGH_ON
      一重取消し線です。
      関連項目:

    • RUN_DIRECTION

      public static final TextAttribute RUN_DIRECTION
      行のラン方向を表す属性キーです。 値はBooleanのインスタンスです。 デフォルト値はnullで、ラン方向を決定する標準のBIDIアルゴリズムを値Bidi.DIRECTION_DEFAULT_LEFT_TO_RIGHTで使用することを指定します。

      定数RUN_DIRECTION_RTLとRUN_DIRECTION_LTRが提供されています。

      これは、段落内のテキストの順方向を選択するためにBidiコンストラクタに渡される値を決定します。

      ノート: この属性の値は、段落内のすべてのテキストについて同じであるべきです。そうでない場合、動作は不定になります。

      関連項目:

    • RUN_DIRECTION_LTR

      public static final Boolean RUN_DIRECTION_LTR
      ランの方向は左から右です。
      関連項目:

    • RUN_DIRECTION_RTL

      public static final Boolean RUN_DIRECTION_RTL
      ランの方向は右から左です。
      関連項目:

    • BIDI_EMBEDDING

      public static final TextAttribute BIDI_EMBEDDING
      テキストの埋込みレベルを表す属性キーです。 値はIntegerのインスタンスです。 デフォルト値はnullであり、双方向アルゴリズムは明示的な埋め込みなしで実行する必要があることを示します。

      1から61の正の値は埋め込みレベル、-1から -61の負の値はオーバーライド・レベルです。 値0は、基本の行方向が使用されることを意味します。 これらのレベルは、埋込みレベル配列に格納されてBidiコンストラクタに渡されます。

      ノート: この属性が段落内に指定されている場合、その段落内にあるUnicodeのBIDI制御文字RLO、LRO、RLE、LRE、およびPDFは無視されます。また、テキスト内にこの属性が存在していない場合、そのテキストのランは、この属性が値0で指定されている場合と同様に処理されます。

      関連項目:

    • JUSTIFICATION

      public static final TextAttribute JUSTIFICATION
      段落の位置揃えを表す属性キーです。 値はNumberのインスタンスです。 デフォルト値は1で、指定された幅全体を使用して位置揃えを行うことを示します。 値は範囲[0..1]に固定されます。

      定数JUSTIFICATION_FULLとJUSTIFICATION_NONEが提供されています。

      TextLayoutに対して位置揃えが要求された場合に、余分な領域のどの部分を使用するかを指定します。 たとえば、行が50ポイント幅で、70ポイントへの位置揃えが要求された場合、値0.75では、残りのスペースの3/4 (つまり15ポイント)を使用するようにパディングされて、結果的に行の長さが65ポイントになります。

      ノート: この属性の値は、段落内のすべてのテキストについて同じであるべきです。そうでない場合、動作は不定になります。

      関連項目:

    • JUSTIFICATION_FULL

      public static final Float JUSTIFICATION_FULL
      要求された幅全体に行をそろえます。 これが、JUSTIFICATIONのデフォルト値です。
      関連項目:

    • JUSTIFICATION_NONE

      public static final Float JUSTIFICATION_NONE
      行の位置揃えを許可しません。
      関連項目:

    • INPUT_METHOD_HIGHLIGHT

      public static final TextAttribute INPUT_METHOD_HIGHLIGHT
      インプット・メソッドのハイライトのスタイルを表す属性キーです。

      値はInputMethodHighlightまたはAnnotationのインスタンスです。 デフォルト値はnullで、描画の前にインプット・メソッドのスタイルが適用されないことを意味します。

      隣接するテキストのランに同じInputMethodHighlightを指定する場合、これらのランを個別に描画する必要があるときは、InputMethodHighlightsを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
      関連項目:

    • UNDERLINE_LOW_TWO_PIXEL

      public static final Integer UNDERLINE_LOW_TWO_PIXEL
      ダブル・ピクセルの実線の下線です。
      導入されたバージョン:
      1.3
      関連項目:

    • UNDERLINE_LOW_DOTTED

      public static final Integer UNDERLINE_LOW_DOTTED
      シングル・ピクセルの点線の下線です。
      導入されたバージョン:
      1.3
      関連項目:

    • UNDERLINE_LOW_GRAY

      public static final Integer UNDERLINE_LOW_GRAY
      ダブル・ピクセルのグレーの下線です。
      導入されたバージョン:
      1.3
      関連項目:

    • UNDERLINE_LOW_DASHED

      public static final Integer UNDERLINE_LOW_DASHED
      シングル・ピクセルの破線の下線です。
      導入されたバージョン:
      1.3
      関連項目:

    • SWAP_COLORS

      public static final TextAttribute SWAP_COLORS
      フォアグラウンドとバックグラウンドのPaintsの入れ替えを表す属性キーです。 値はBooleanのインスタンスです。 デフォルト値はfalseで、色を交換しないことを意味します。

      定数値SWAP_COLORS_ONが定義されています。

      FOREGROUND属性が設定されている場合は、そのPaintがバックグラウンドとして使用され、それ以外の場合は、Graphicsの現在のPaintが使用されます。 BACKGROUND属性が設定されている場合は、そのPaintがフォアグラウンドとして使用されます。それ以外の場合は、テキストが見えるようにするために、(解決された)バックグラウンドに対してコントラストのある色がシステムで検索されます。

      関連項目:

    • SWAP_COLORS_ON

      public static final Boolean SWAP_COLORS_ON
      フォアグラウンドとバックグラウンドを入れ替えます。
      導入されたバージョン:
      1.3
      関連項目:

    • NUMERIC_SHAPING

      public static final TextAttribute NUMERIC_SHAPING
      ASCIIの10進数をほかの10進数の範囲に変換するための属性キーです。 値はNumericShaperのインスタンスです。 デフォルトはnullで、数字の形状決定を行わないことを意味します。

      数字の形状決定要因が定義されている場合は、テキストのほかの分析が実行される前に、まずその形状決定要因によってテキストが処理されます。

      ノート: この属性の値は、段落内のすべてのテキストについて同じであるべきです。そうでない場合、動作は不定になります。

      導入されたバージョン:
      1.4
      関連項目:

    • KERNING

      public static final TextAttribute KERNING
      カーニングを要求するための属性キーです。 値はIntegerのインスタンスです。 デフォルト値は0で、カーニングを要求しないことを意味します。

      定数値KERNING_ONが提供されています。

      「To」や「AWAY」など、文字シーケンスによっては個々の文字のデフォルトの有効幅が適さない場合があります。 カーニングを使用しないと、隣接する文字の間隔が広すぎるように見えます。 カーニングは、選択された文字シーケンスの間隔を変えて、より美しい外観に整えます。

      導入されたバージョン:
      1.6

    • KERNING_ON

      public static final Integer KERNING_ON
      標準のカーニングを要求します。
      導入されたバージョン:
      1.6
      関連項目:

    • LIGATURES

      public static final TextAttribute LIGATURES
      オプション合字を使用可能にするための属性キーです。 値はIntegerのインスタンスです。 デフォルト値は0で、オプション合字を使用しないことを意味します。

      定数値LIGATURES_ONが定義されています。

      書記法で必要とされる合字は、常に使用可能になります。

      導入されたバージョン:
      1.6

    • LIGATURES_ON

      public static final Integer LIGATURES_ON
      標準のオプション合字を要求します。
      導入されたバージョン:
      1.6
      関連項目:

    • TRACKING

      public static final TextAttribute TRACKING
      トラッキングを制御するための属性キーです。 値はNumberのインスタンスです。 デフォルト値は0で、追加のトラッキングを行わないことを意味します。

      定数値TRACKING_TIGHTとTRACKING_LOOSEが用意されています。

      各グリフ・クラスタに追加すべき量を決定するために、トラッキング値にフォントのポイント・サイズが乗算されて、フォント変換を通して渡されます。 正のトラッキング値は、オプション合字の作成を禁止します。 トラッキング値は、通常、-0.1と0.3の間にあります。この範囲外の値は一般に望ましくありません。

      導入されたバージョン:
      1.6

    • TRACKING_TIGHT

      public static final Float TRACKING_TIGHT
      密なトラッキングを実行します。
      導入されたバージョン:
      1.6
      関連項目:

    • TRACKING_LOOSE

      public static final Float TRACKING_LOOSE
      疎なトラッキングを実行します。
      導入されたバージョン:
      1.6
      関連項目:

  • コンストラクタの詳細

    • TextAttribute

      protected TextAttribute(String name)
      指定された名前のTextAttributeを構築します。
      パラメータ:
      name - このTextAttributeに割り当てる属性名

  • メソッドの詳細