TextAttribute (Java Platform SE 8)

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とnew Float(2.0)は同じWEIGHTを示します。
WEIGHT、WIDTH、POSTURE、SIZE、JUSTIFICATION、およびTRACKINGに使用されるNumber型の属性値は、その固有の範囲内で変化でき、定義済み定数に制限されることはありません。 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`	テキストのバックグラウンドの描画に使用されるペイントを表す属性キーです。
`static TextAttribute`	`BIDI_EMBEDDING`	テキストの埋込みレベルを表す属性キーです。
`static TextAttribute`	`CHAR_REPLACEMENT`	文字のフォントの標準グリフの代わりに表示する、ユーザー定義のグリフを表す属性キーです。
`static TextAttribute`	`FAMILY`	フォント名を表す属性キーです。
`static TextAttribute`	`FONT`	テキストの描画に使用するフォントを指定するための属性キーです。
`static TextAttribute`	`FOREGROUND`	テキストの描画に使用されるペイントを表す属性キーです。
`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の10進数をほかの10進数の範囲に変換するための属性キーです。
`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`	フォアグラウンドとバックグラウンドの`Paints`の入れ替えを表す属性キーです。
`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`	フォントのウエイトを表す属性キーです。
`static Float`	`WEIGHT_BOLD`	標準の太字ウエイトです。
`static Float`	`WEIGHT_DEMIBOLD`	`WEIGHT_BOLD`よりやや軽いウエイトです。
`static Float`	`WEIGHT_DEMILIGHT`	`WEIGHT_LIGHT`と`WEIGHT_STANDARD`の中間のウエイトです。
`static Float`	`WEIGHT_EXTRA_LIGHT`	もっとも軽い定義済みウエイトです。
`static Float`	`WEIGHT_EXTRABOLD`	非常に重いウエイトです。
`static Float`	`WEIGHT_HEAVY`	`WEIGHT_BOLD`よりやや重いウエイトです。
`static Float`	`WEIGHT_LIGHT`	標準の軽量ウエイトです。
`static Float`	`WEIGHT_MEDIUM`	`WEIGHT_REGULAR`と`WEIGHT_BOLD`の中間のウエイトです。
`static Float`	`WEIGHT_REGULAR`	標準のウエイトです。
`static Float`	`WEIGHT_SEMIBOLD`	`WEIGHT_REGULAR`よりやや重いウエイトです。
`static Float`	`WEIGHT_ULTRABOLD`	もっとも重い定義済みウエイトです。
`static TextAttribute`	`WIDTH`	フォントの幅を表す属性キーです。
`static Float`	`WIDTH_CONDENSED`	もっとも狭い定義済みの幅です。
`static Float`	`WIDTH_EXTENDED`	もっとも広い定義済みの幅です。
`static Float`	`WIDTH_REGULAR`	標準の幅です。
`static Float`	`WIDTH_SEMI_CONDENSED`	やや狭い幅です。
`static Float`	`WIDTH_SEMI_EXTENDED`	やや広い幅です。

クラス java.text.AttributedCharacterIterator.Attributeから継承されたフィールド
INPUT_METHOD_SEGMENT, LANGUAGE, READING

コンストラクタのサマリー

コンストラクタ
修飾子コンストラクタ説明

protected TextAttribute(String name)
指定された名前のTextAttributeを構築します。

コンストラクタ
修飾子	コンストラクタ	説明
`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に対応する定数を定義します。
    これは、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
  - WEIGHT_LIGHT
```
public static final Float WEIGHT_LIGHT
```
    標準の軽量ウエイトです。
    
    関連項目:
    
    WEIGHT
  - WEIGHT_DEMILIGHT
```
public static final Float WEIGHT_DEMILIGHT
```
    WEIGHT_LIGHTとWEIGHT_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_REGULARとWEIGHT_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_CONDENSED、WIDTH_SEMI_CONDENSED、WIDTH_REGULAR、WIDTH_SEMI_EXTENDED、WIDTH_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_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パラメータに対応します。
    非常に大きいサイズや小さいサイズを指定すると、描画パフォーマンスに影響を与え、描画システムによってテキストが指定のサイズで描画されない場合もあります。負のサイズは不正であり、その場合はデフォルトのサイズになります。
    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_SUPERとSUPERSCRIPT_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への通常の解決が実行されることを示します。
    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)を使用するようにしてください。
    
    関連項目:
    
    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を参照)。
    
    関連項目:
    
    Paint、SWAP_COLORS
  - BACKGROUND
```
public static final TextAttribute BACKGROUND
```
    テキストのバックグラウンドの描画に使用されるペイントを表す属性キーです。値はPaintのインスタンスです。デフォルト値はnullで、バックグラウンドが描画されないことを示します。
    この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では、残りのスペースの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を指定する場合、これらのランを個別に描画する必要があるときは、InputMethodHighlightsをAnnotationインスタンスにラップする必要があります。
    インプット・メソッドのハイライトは、テキストをインプット・メソッドで変換する場合に使用されます。通常は書式化されていないテキストだけを扱うものであっても、テキスト編集コンポーネントはハイライトを保持し、描画ルーチンで使用できるようにします。
    
    関連項目:
    
    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
```
    フォアグラウンドとバックグラウンドの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_TIGHTとTRACKING_LOOSEが用意されています。
    各グリフ・クラスタに追加すべき量を決定するために、トラッキング値にフォントのポイント・サイズが乗算されて、フォント変換を通して渡されます。正のトラッキング値は、オプション合字の作成を禁止します。トラッキング値の範囲は通常-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
```
    直列化復元されるインスタンスを定義済み定数に解決します。
    
    オーバーライド:
    
    readResolve、クラスAttributedCharacterIterator.Attribute
    
    戻り値:
    
    解決されたAttributeオブジェクト
    
    例外:
    
    InvalidObjectException - 解決するオブジェクトがAttributeのインスタンスではない場合

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスTextAttribute

値

属性のサマリー

フィールドのサマリー

クラス java.text.AttributedCharacterIterator.Attributeから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.text.AttributedCharacterIterator.Attributeから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

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