モジュール java.desktop
パッケージ 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を構築します。

    • フィールドの詳細

      • 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オブジェクト。