モジュール java.desktop
パッケージ 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オブジェクト。