-
- All Known Implementing Classes:
- AbstractRegionPainter
public interface Painter<T>
A painting delegate. The Painter interface defines exactly one method,
paint
. It is used in situations where the developer can change the painting routine of a component without having to resort to subclassing the component. It is also generically useful when doing any form of painting delegation.Painter
s are simply encapsulations of Java2D code and make it fairly trivial to reuse existingPainter
s or to combine them together. Implementations of this interface are also trivial to write, such that if you can't find aPainter
that does what you need, you can write one with minimal effort. Writing aPainter
requires knowledge of Java2D.A
Painter
may be created with a type parameter. This type will be expected in thepaint
method. For example, you may wish to write aPainter
that only works with subclasses ofComponent
. In that case, when thePainter
is declared, you may declare that it requires aComponent
, allowing the paint method to be type safe. Ex:Painter<Component> p = new Painter<Component>() { public void paint(Graphics2D g, Component c, int width, int height) { g.setColor(c.getBackground()); //and so forth } }
This interface makes no guarantees of threadsafety.
-
-
Method Summary
Methods Modifier and Type Method and Description void
paint(Graphics2D g, T object, int width, int height)
Renders to the givenGraphics2D
object.
-
-
-
Method Detail
-
paint
void paint(Graphics2D g, T object, int width, int height)
Renders to the given
Graphics2D
object. Implementations of this method may modify state on theGraphics2D
, and are not required to restore that state upon completion. In most cases, it is recommended that the caller pass in a scratch graphics object. TheGraphics2D
must never be null.State on the graphics object may be honored by the
paint
method, but may not be. For instance, setting the antialiasing rendering hint on the graphics may or may not be respected by thePainter
implementation.The supplied object parameter acts as an optional configuration argument. For example, it could be of type
Component
. APainter
that expected it could then read state from thatComponent
and use the state for painting. For example, an implementation may read the backgroundColor and use that.Generally, to enhance reusability, most standard
Painter
s ignore this parameter. They can thus be reused in any context. Theobject
may be null. Implementations must not throw a NullPointerException if the object parameter is null.Finally, the
width
andheight
arguments specify the width and height that thePainter
should paint into. More specifically, the specified width and height instruct the painter that it should paint fully within this width and height. Any specified clip on theg
param will further constrain the region.For example, suppose I have a
Painter
implementation that draws a gradient. The gradient goes from white to black. It "stretches" to fill the painted region. Thus, if I use thisPainter
to paint a 500 x 500 region, the far left would be black, the far right would be white, and a smooth gradient would be painted between. I could then, without modification, reuse thePainter
to paint a region that is 20x20 in size. This region would also be black on the left, white on the right, and a smooth gradient painted between.- Parameters:
g
- The Graphics2D to render to. This must not be null.object
- an optional configuration parameter. This may be null.width
- width of the area to paint.height
- height of the area to paint.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/swing/Painter.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.