- java.lang.Object
-
- java.awt.font.GraphicAttribute
-
- Direct Known Subclasses:
- ImageGraphicAttribute, ShapeGraphicAttribute
public abstract class GraphicAttribute extends Object
This class is used with the CHAR_REPLACEMENT attribute.The
GraphicAttribute
class represents a graphic embedded in text. Clients subclass this class to implement their own char replacement graphics. Clients wishing to embed shapes and images in text need not subclass this class. Instead, clients can use theShapeGraphicAttribute
andImageGraphicAttribute
classes.Subclasses must ensure that their objects are immutable once they are constructed. Mutating a
GraphicAttribute
that is used in aTextLayout
results in undefined behavior from theTextLayout
.
-
-
Field Summary
Fields Modifier and Type Field and Description static int
BOTTOM_ALIGNMENT
Aligns bottom of graphic to bottom of line.static int
CENTER_BASELINE
Aligns origin of graphic to center baseline of line.static int
HANGING_BASELINE
Aligns origin of graphic to hanging baseline of line.static int
ROMAN_BASELINE
Aligns origin of graphic to roman baseline of line.static int
TOP_ALIGNMENT
Aligns top of graphic to top of line.
-
Constructor Summary
Constructors Modifier Constructor and Description protected
GraphicAttribute(int alignment)
Constructs aGraphicAttribute
.
-
Method Summary
Methods Modifier and Type Method and Description abstract void
draw(Graphics2D graphics, float x, float y)
Renders thisGraphicAttribute
at the specified location.abstract float
getAdvance()
Returns the advance of thisGraphicAttribute
.int
getAlignment()
Returns the alignment of thisGraphicAttribute
.abstract float
getAscent()
Returns the ascent of thisGraphicAttribute
.Rectangle2D
getBounds()
Returns aRectangle2D
that encloses all of the bits drawn by thisGraphicAttribute
relative to the rendering position.abstract float
getDescent()
Returns the descent of thisGraphicAttribute
.GlyphJustificationInfo
getJustificationInfo()
Returns the justification information for thisGraphicAttribute
.Shape
getOutline(AffineTransform tx)
Return aShape
that represents the region that thisGraphicAttribute
renders.
-
-
-
Field Detail
-
TOP_ALIGNMENT
public static final int TOP_ALIGNMENT
Aligns top of graphic to top of line.- See Also:
- Constant Field Values
-
BOTTOM_ALIGNMENT
public static final int BOTTOM_ALIGNMENT
Aligns bottom of graphic to bottom of line.- See Also:
- Constant Field Values
-
ROMAN_BASELINE
public static final int ROMAN_BASELINE
Aligns origin of graphic to roman baseline of line.- See Also:
- Constant Field Values
-
CENTER_BASELINE
public static final int CENTER_BASELINE
Aligns origin of graphic to center baseline of line.- See Also:
- Constant Field Values
-
HANGING_BASELINE
public static final int HANGING_BASELINE
Aligns origin of graphic to hanging baseline of line.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
GraphicAttribute
protected GraphicAttribute(int alignment)
Constructs aGraphicAttribute
. Subclasses use this to define the alignment of the graphic.- Parameters:
alignment
- an int representing one of theGraphicAttribute
alignment fields- Throws:
IllegalArgumentException
- if alignment is not one of the five defined values.
-
-
Method Detail
-
getAscent
public abstract float getAscent()
Returns the ascent of thisGraphicAttribute
. A graphic can be rendered above its ascent.- Returns:
- the ascent of this
GraphicAttribute
. - See Also:
getBounds()
-
getDescent
public abstract float getDescent()
Returns the descent of thisGraphicAttribute
. A graphic can be rendered below its descent.- Returns:
- the descent of this
GraphicAttribute
. - See Also:
getBounds()
-
getAdvance
public abstract float getAdvance()
Returns the advance of thisGraphicAttribute
. TheGraphicAttribute
object's advance is the distance from the point at which the graphic is rendered and the point where the next character or graphic is rendered. A graphic can be rendered beyond its advance- Returns:
- the advance of this
GraphicAttribute
. - See Also:
getBounds()
-
getBounds
public Rectangle2D getBounds()
Returns aRectangle2D
that encloses all of the bits drawn by thisGraphicAttribute
relative to the rendering position. A graphic may be rendered beyond its origin, ascent, descent, or advance; but if it is, this method's implementation must indicate where the graphic is rendered. Default bounds is the rectangle (0, -ascent, advance, ascent+descent).- Returns:
- a
Rectangle2D
that encloses all of the bits rendered by thisGraphicAttribute
.
-
getOutline
public Shape getOutline(AffineTransform tx)
Return aShape
that represents the region that thisGraphicAttribute
renders. This is used when aTextLayout
is requested to return the outline of the text. The (untransformed) shape must not extend outside the rectangular bounds returned bygetBounds
. The default implementation returns the rectangle returned bygetBounds()
, transformed by the providedAffineTransform
if present.- Parameters:
tx
- an optionalAffineTransform
to apply to the outline of thisGraphicAttribute
. This can be null.- Returns:
- a
Shape
representing this graphic attribute, suitable for stroking or filling. - Since:
- 1.6
-
draw
public abstract void draw(Graphics2D graphics, float x, float y)
Renders thisGraphicAttribute
at the specified location.- Parameters:
graphics
- theGraphics2D
into which to render the graphicx
- the user-space X coordinate where the graphic is renderedy
- the user-space Y coordinate where the graphic is rendered
-
getAlignment
public final int getAlignment()
Returns the alignment of thisGraphicAttribute
. Alignment can be to a particular baseline, or to the absolute top or bottom of a line.- Returns:
- the alignment of this
GraphicAttribute
.
-
getJustificationInfo
public GlyphJustificationInfo getJustificationInfo()
Returns the justification information for thisGraphicAttribute
. Subclasses can override this method to provide different justification information.- Returns:
- a
GlyphJustificationInfo
object that contains the justification information for thisGraphicAttribute
.
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/awt/font/graphicattribute.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.