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

クラスTextAttribute

  • すべての実装されたインタフェース:
    Serializable

    public final class TextAttribute
    extends AttributedCharacterIterator.Attribute
    TextAttributeクラスは、テキストのレンダリングに使用する属性キーおよび属性値を定義します。

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

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

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

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

    属性のサマリー

    すべてのTextAttributesのキー、値の型、主な定数、およびデフォルト値の動作
    キー 値の型 主な定数 デフォルト値
    FAMILY String フォントDIALOGDIALOG_INPUT
    SERIFSANS_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, 直列化された形式
    • フィールドの詳細

      • FAMILY

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

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

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

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

      • WEIGHT_EXTRA_LIGHT

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

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

        public static final Float WEIGHT_DEMILIGHT
        WEIGHT_LIGHTWEIGHT_STANDARDの中間のウエイトです。
        関連項目:
        WEIGHT
      • WEIGHT_REGULAR

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

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

        public static final Float WEIGHT_MEDIUM
        WEIGHT_REGULARWEIGHT_BOLDの中間のウエイトです。
        関連項目:
        WEIGHT
      • WEIGHT_DEMIBOLD

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

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

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

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

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

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

        いくつかの定数値が用意されています。WIDTH_CONDENSEDWIDTH_SEMI_CONDENSEDWIDTH_REGULARWIDTH_SEMI_EXTENDEDWIDTH_EXTENDEDを参照してください。

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

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

      • WIDTH_CONDENSED

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

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

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

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

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

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

        2つの定数値が用意されています。POSTURE_REGULARPOSTURE_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パラメータに対応します。

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

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

      • TRANSFORM

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

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

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

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

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

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

        関連項目:
        TransformAttribute, AffineTransform
      • SUPERSCRIPT

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

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

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

      • 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への通常の解決が実行されることを示します。

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

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

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

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

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

        関連項目:
        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のインスタンスです。 デフォルト値はnullで、描画時にGraphics2Dに設定されているPaintが使用されることを示します。

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

        関連項目:
        PaintSWAP_COLORS
      • BACKGROUND

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

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

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

        関連項目:
        PaintSWAP_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_RTLRUN_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_FULLJUSTIFICATION_NONEが提供されています。

        TextLayoutに対して位置揃えが要求された場合に、余分な領域のどの部分を使用するかを指定します。 たとえば、行が50ポイント幅で、70ポイントへの位置揃えが要求された場合、値0.75では、残りのスペースの3/4 (つまり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を指定する場合、これらのランを個別に描画する必要があるときは、InputMethodHighlightsAnnotationインスタンスにラップする必要があります。

        インプット・メソッドのハイライトは、テキストをインプット・メソッドで変換する場合に使用されます。 通常は書式化されていないテキストだけを扱うものであっても、テキスト編集コンポーネントはハイライトを保持し、描画ルーチンで使用できるようにします。

        関連項目:
        Font, InputMethodHighlight, Annotation
      • INPUT_METHOD_UNDERLINE

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

        いくつかの定数値が用意されています。UNDERLINE_LOW_ONE_PIXELUNDERLINE_LOW_TWO_PIXELUNDERLINE_LOW_DOTTEDUNDERLINE_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
        フォアグラウンドとバックグラウンドのPaintsの入れ替えを表す属性キーです。 値は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の10進数をほかの10進数の範囲に変換するための属性キーです。 値はNumericShaperのインスタンスです。 デフォルトはnullで、数字の形状決定を行わないことを意味します。

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

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

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

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

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

        「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_TIGHTTRACKING_LOOSEが用意されています。

        各グリフ・クラスタに追加すべき量を決定するために、トラッキング値にフォントのポイント・サイズが乗算されて、フォント変換を通して渡されます。 正のトラッキング値は、オプション合字の作成を禁止します。 トラッキング値は、通常、-0.10.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に割り当てる属性名