com.itextpdf.layout.border

Class DottedBorder

java.lang.Object

com.itextpdf.layout.border.Border

com.itextpdf.layout.border.DottedBorder

public class DottedBorder
extends Border

Draws a dotted border around the element it has been set to. Do note that this border draw square dots, if you want to draw round dots, see RoundDotsBorder.

Nested Class Summary

Nested classes/interfaces inherited from class com.itextpdf.layout.border.Border

Border.Side

Field Summary

Fields inherited from class com.itextpdf.layout.border.Border

_3D_GROOVE, _3D_INSET, _3D_OUTSET, _3D_RIDGE, color, DASHED, DOTTED, DOUBLE, NO_BORDER, ROUND_DOTS, SOLID, transparentColor, type, width

Constructor Summary

Constructors

Constructor and Description
DottedBorder(Color color, float width) Creates a DottedBorder instance with the specified width and color.
DottedBorder(Color color, float width, float opacity) Creates a DottedBorder with the specified width, color and opacity.
DottedBorder(float width) Creates a DottedBorder instance with the specified width.

Method Summary

Modifier and Type	Method and Description
void	draw(PdfCanvas canvas, float x1, float y1, float x2, float y2, float outerRadius, Border.Side side, float borderWidthBefore, float borderWidthAfter) All borders are supposed to be drawn in such way, that inner content of the element is on the right from the drawing direction.
void	draw(PdfCanvas canvas, float x1, float y1, float x2, float y2, float borderWidthBefore, float borderWidthAfter) All borders are supposed to be drawn in such way, that inner content of the element is on the right from the drawing direction.
void	drawCellBorder(PdfCanvas canvas, float x1, float y1, float x2, float y2) Draws the border of a cell.
protected float	getDotsGap(double distance, float initialGap) Adjusts the size of the gap between dots
int	getType() Returns the type of the border

Methods inherited from class com.itextpdf.layout.border.Border

draw, equals, getBorderSide, getBorderSide, getColor, getIntersectionPoint, getOpacity, getWidth, hashCode, setColor, setWidth

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DottedBorder

public DottedBorder(float width)

Creates a DottedBorder instance with the specified width. The color is set to the default: black.

Parameters:

width - width of the border

DottedBorder

public DottedBorder(Color color,
                    float width)

Creates a DottedBorder instance with the specified width and color.

Parameters:

color - color of the border

width - width of the border

DottedBorder

public DottedBorder(Color color,
                    float width,
                    float opacity)

Creates a DottedBorder with the specified width, color and opacity.

Parameters:

color - color of the border

width - width of the border

opacity - width of the border

Method Detail

getType

public int getType()

Returns the type of the border

Specified by:

getType in class Border

draw

public void draw(PdfCanvas canvas,
                 float x1,
                 float y1,
                 float x2,
                 float y2,
                 float borderWidthBefore,
                 float borderWidthAfter)

All borders are supposed to be drawn in such way, that inner content of the element is on the right from the drawing direction. Borders are drawn in this order: top, right, bottom, left.

Given points specify the line which lies on the border of the content area, therefore the border itself should be drawn to the left from the drawing direction.

borderWidthBefore and borderWidthAfter parameters are used to define the widths of the borders that are before and after the current border, e.g. for the bottom border, borderWidthBefore specifies width of the right border and borderWidthAfter - width of the left border. Those width are used to handle areas of border joins.

Specified by:

draw in class Border

Parameters:

canvas - PdfCanvas to be written to

x1 - x coordinate of the beginning point of the element side, that should be bordered

y1 - y coordinate of the beginning point of the element side, that should be bordered

x2 - x coordinate of the ending point of the element side, that should be bordered

y2 - y coordinate of the ending point of the element side, that should be bordered

borderWidthBefore - defines width of the border that is before the current one

borderWidthAfter - defines width of the border that is after the current one

draw

public void draw(PdfCanvas canvas,
                 float x1,
                 float y1,
                 float x2,
                 float y2,
                 float outerRadius,
                 Border.Side side,
                 float borderWidthBefore,
                 float borderWidthAfter)

Description copied from class: Border

All borders are supposed to be drawn in such way, that inner content of the element is on the right from the drawing direction. Borders are drawn in this order: top, right, bottom, left.

Given points specify the line which lies on the border of the content area, therefore the border itself should be drawn to the left from the drawing direction.

borderWidthBefore and borderWidthAfter parameters are used to define the widths of the borders that are before and after the current border, e.g. for the bottom border, borderWidthBefore specifies width of the right border and borderWidthAfter - width of the left border. Those width are used to handle areas of border joins.

Specified by:

draw in class Border

Parameters:

canvas - PdfCanvas to be written to

x1 - x coordinate of the beginning point of the element side, that should be bordered

y1 - y coordinate of the beginning point of the element side, that should be bordered

x2 - x coordinate of the ending point of the element side, that should be bordered

y2 - y coordinate of the ending point of the element side, that should be bordered

outerRadius - border radius

side - the Border.Side, that represents element side, that should be bordered

borderWidthBefore - defines width of the border that is before the current one

borderWidthAfter - defines width of the border that is after the current one

drawCellBorder

public void drawCellBorder(PdfCanvas canvas,
                           float x1,
                           float y1,
                           float x2,
                           float y2)

Draws the border of a cell.

Specified by:

drawCellBorder in class Border

Parameters:

canvas - PdfCanvas to be written to

x1 - x coordinate of the beginning point of the element side, that should be bordered

y1 - y coordinate of the beginning point of the element side, that should be bordered

x2 - x coordinate of the ending point of the element side, that should be bordered

y2 - y coordinate of the ending point of the element side, that should be bordered

getDotsGap

protected float getDotsGap(double distance,
                           float initialGap)

Adjusts the size of the gap between dots

Parameters:

distance - the border length

initialGap - the initial size of the gap

Returns:

the adjusted size of the gap