java.awt.font

クラスGraphicAttribute

java.lang.Object

java.awt.font.GraphicAttribute

直系の既知のサブクラス:

ImageGraphicAttribute, ShapeGraphicAttribute

public abstract class GraphicAttribute
extends Object

このクラスはCHAR_REPLACEMENT属性とともに使用します。

GraphicAttributeクラスは、テキストに埋め込まれたグラフィックを表します。クライアントはこのクラスをサブクラス化して、charと置き換えるグラフィックを実装します。テキストに図形やイメージを埋め込む場合は、このクラスをサブクラス化する必要はありません。代わりに、ShapeGraphicAttributeクラスやImageGraphicAttributeクラスを使用できます。

サブクラスでは、いったん構築したオブジェクトが不変であるようにする必要があります。TextLayoutで使用されているGraphicAttributeを変更した場合のTextLayoutの動作は保証されません。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static int	BOTTOM_ALIGNMENT グラフィックの下端を行の下端にそろえて配置します。
static int	CENTER_BASELINE グラフィックの原点を行のセンター・ベースラインにそろえて配置します。
static int	HANGING_BASELINE グラフィックの原点を行のぶら下がりベースラインにそろえて配置します。
static int	ROMAN_BASELINE グラフィックの原点を行のローマン・ベースラインにそろえて配置します。
static int	TOP_ALIGNMENT グラフィックの上端を行の上端にそろえて配置します。

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

コンストラクタ

修飾子	コンストラクタと説明
protected	GraphicAttribute(int alignment) GraphicAttributeを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
abstract void	draw(Graphics2D graphics, float x, float y) このGraphicAttributeを指定された位置にレンダリングします。
abstract float	getAdvance() このGraphicAttributeの有効幅を返します。
int	getAlignment() GraphicAttributeの配置方法を返します。
abstract float	getAscent() このGraphicAttributeのアセントを返します。
Rectangle2D	getBounds() このGraphicAttributeによってレンダリングされる全ビットを囲む、Rectangle2Dを返します。これは、レンダリング位置を基準にして示されます。
abstract float	getDescent() このGraphicAttributeのディセントを返します。
GlyphJustificationInfo	getJustificationInfo() このGraphicAttributeの位置揃えプロパティを返します。
Shape	getOutline(AffineTransform tx) このGraphicAttributeによってレンダリングされる領域を表すShapeを返します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

TOP_ALIGNMENT

public static final int TOP_ALIGNMENT

グラフィックの上端を行の上端にそろえて配置します。

関連項目:

定数フィールド値

BOTTOM_ALIGNMENT

public static final int BOTTOM_ALIGNMENT

グラフィックの下端を行の下端にそろえて配置します。

関連項目:

定数フィールド値

ROMAN_BASELINE

public static final int ROMAN_BASELINE

グラフィックの原点を行のローマン・ベースラインにそろえて配置します。

関連項目:

定数フィールド値

CENTER_BASELINE

public static final int CENTER_BASELINE

グラフィックの原点を行のセンター・ベースラインにそろえて配置します。

関連項目:

定数フィールド値

HANGING_BASELINE

public static final int HANGING_BASELINE

グラフィックの原点を行のぶら下がりベースラインにそろえて配置します。

関連項目:

定数フィールド値

コンストラクタの詳細

GraphicAttribute

protected GraphicAttribute(int alignment)

GraphicAttributeを構築します。サブクラスではこれを使用してグラフィックの配置方法を定義します。

パラメータ:

alignment - GraphicAttributeの位置合わせフィールドの1つを表すint値

例外:

IllegalArgumentException - alignmentが、定義されている5つの値のどれでもない場合。

メソッドの詳細

getAscent

public abstract float getAscent()

このGraphicAttributeのアセントを返します。グラフィックはアセントの上にレンダリングされます。

戻り値:

このGraphicAttributeのアセント。

関連項目:

getBounds()

getDescent

public abstract float getDescent()

このGraphicAttributeのディセントを返します。グラフィックはディセントの下にレンダリングされます。

戻り値:

このGraphicAttributeのディセント。

関連項目:

getBounds()

getAdvance

public abstract float getAdvance()

このGraphicAttributeの有効幅を返します。GraphicAttributeオブジェクトの有効幅とは、グラフィックがレンダリングされる地点から次の文字またはグラフィックがレンダリングされる地点までの距離です。グラフィックは、有効幅を超えてレンダリングすることもできます。

戻り値:

このGraphicAttributeの有効幅。

関連項目:

getBounds()

getBounds

public Rectangle2D getBounds()

このGraphicAttributeによってレンダリングされる全ビットを囲む、Rectangle2Dを返します。これは、レンダリング位置を基準にして示されます。グラフィックは、原点、アセント、ディセント、有効幅を超えてレンダリングできますが、その場合はグラフィックをレンダリングする位置をこのメソッドの実装で示す必要があります。デフォルトの境界は矩形(0、- アセント、有効幅、アセント+ディセント)です。

戻り値:

このGraphicAttributeによってレンダリングされる全ビットを囲むRectangle2D。

getOutline

public Shape getOutline(AffineTransform tx)

このGraphicAttributeによってレンダリングされる領域を表すShapeを返します。これはTextLayoutがテキストの輪郭を返すように要求されたときに使用されます。(変換されていない)形状は、getBoundsによって返される矩形境界の内側に収まっている必要があります。デフォルトの実装は、getBounds()によって返される矩形を、指定されたAffineTransformで変換したものを返します。

パラメータ:

tx - このGraphicAttributeの輪郭に適用するオプションのAffineTransform。nullを指定できる。

戻り値:

ストローク描画や塗りつぶしに適した、このGraphicAttributeを表すShape。

導入されたバージョン:

1.6

draw

public abstract void draw(Graphics2D graphics,
                          float x,
                          float y)

このGraphicAttributeを指定された位置にレンダリングします。

パラメータ:

graphics - グラフィックのレンダリング先のGraphics2D

x - グラフィックがレンダリングされるユーザー空間X座標

y - グラフィックがレンダリングされるユーザー空間Y座標

getAlignment

public final int getAlignment()

GraphicAttributeの配置方法を返します。特定のベースラインにそろえる配置方法や、行の上端または下端にそろえる配置方法があります。

戻り値:

このGraphicAttributeの配置方法。

getJustificationInfo

public GlyphJustificationInfo getJustificationInfo()

このGraphicAttributeの位置揃えプロパティを返します。サブクラスでこのメソッドをオーバーライドし、別の位置揃えプロパティを指定することもできます。

戻り値:

このGraphicAttributeの位置揃え情報を含むGlyphJustificationInfoオブジェクト。