archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-09-18 18:14:38 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8138838: docs cleanup for java.desktop

Browse source 
Docs cleanup for java.desktop

Reviewed-by: serb
This commit is contained in:
Alexander Stepanov 2016-01-11 17:51:54 +03:00
parent aeccbee0e7
commit 73fb68a80d
609 changed files with 19168 additions and 19160 deletions
Download patch file Download diff file Expand all files Collapse all files

44
jdk/src/java.desktop/share/classes/java/awt/Stroke.java
View file

@ -26,43 +26,43 @@
package java.awt;
/**
* The <code>Stroke</code> interface allows a
* The {@code Stroke} interface allows a
* {@link Graphics2D} object to obtain a {@link Shape} that is the
* decorated outline, or stylistic representation of the outline,
* of the specified <code>Shape</code>.
* Stroking a <code>Shape</code> is like tracing its outline with a
* of the specified {@code Shape}.
* Stroking a {@code Shape} is like tracing its outline with a
* marking pen of the appropriate size and shape.
* The area where the pen would place ink is the area enclosed by the
* outline <code>Shape</code>.
* outline {@code Shape}.
* <p>
* The methods of the <code>Graphics2D</code> interface that use the
* outline <code>Shape</code> returned by a <code>Stroke</code> object
* include <code>draw</code> and any other methods that are
* The methods of the {@code Graphics2D} interface that use the
* outline {@code Shape} returned by a {@code Stroke} object
* include {@code draw} and any other methods that are
* implemented in terms of that method, such as
* <code>drawLine</code>, <code>drawRect</code>,
* <code>drawRoundRect</code>, <code>drawOval</code>,
* <code>drawArc</code>, <code>drawPolyline</code>,
* and <code>drawPolygon</code>.
* {@code drawLine}, {@code drawRect},
* {@code drawRoundRect}, {@code drawOval},
* {@code drawArc}, {@code drawPolyline},
* and {@code drawPolygon}.
* <p>
* The objects of the classes implementing <code>Stroke</code>
* must be read-only because <code>Graphics2D</code> does not
* The objects of the classes implementing {@code Stroke}
* must be read-only because {@code Graphics2D} does not
* clone these objects either when they are set as an attribute
* with the <code>setStroke</code> method or when the
* <code>Graphics2D</code> object is itself cloned.
* If a <code>Stroke</code> object is modified after it is set in
* the <code>Graphics2D</code> context then the behavior
* with the {@code setStroke} method or when the
* {@code Graphics2D} object is itself cloned.
* If a {@code Stroke} object is modified after it is set in
* the {@code Graphics2D} context then the behavior
* of subsequent rendering would be undefined.
* @see BasicStroke
* @see Graphics2D#setStroke
*/
public interface Stroke {
/**
* Returns an outline <code>Shape</code> which encloses the area that
* should be painted when the <code>Shape</code> is stroked according
* Returns an outline {@code Shape} which encloses the area that
* should be painted when the {@code Shape} is stroked according
* to the rules defined by the
* object implementing the <code>Stroke</code> interface.
* @param p a <code>Shape</code> to be stroked
* @return the stroked outline <code>Shape</code>.
* object implementing the {@code Stroke} interface.
* @param p a {@code Shape} to be stroked
* @return the stroked outline {@code Shape}.
*/
Shape createStrokedShape (Shape p);
}