Class Rectangle
java.lang.Object
com.gitlab.pdftk_java.com.lowagie.text.Rectangle
- All Implemented Interfaces:
Element, MarkupAttributes
A
Rectangle is the representation of a geometric figure.
Rectangles support constant width borders using
setBorderWidth(float)and setBorder(int). They also
support borders that vary in width/color on each side using methods like
setBorderWidthLeft(float)or
setBorderColorLeft(java.awt.Color).- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected ColorThis is the color of the background of this rectangle.protected intThis represents the status of the 4 sides of the rectangle.protected ColorThe color of the bottom border of this rectangle.protected ColorThe color of the left border of this rectangle.protected ColorThe color of the right border of this rectangle.protected ColorThe color of the top border of this rectangle.protected floatThis is the width of the border around this rectangle.protected floatThe width of the bottom border of this rectangle.protected floatThe width of the left border of this rectangle.protected floatThe width of the right border of this rectangle.protected floatThe width of the top border of this rectangle.static final intThis represents one side of the border of theRectangle.static final intThis represents a type of border.protected ColorThe color of the border of this rectangle.protected floatThis is the grayscale value of the background of this rectangle.static final intThis represents one side of the border of theRectangle.protected floatthe lower left x-coordinate.protected floatthe lower left y-coordinate.protected PropertiesContains extra markupAttributesstatic final intThis represents a rectangle without borders.static final intThis represents one side of the border of theRectangle.protected intstatic final intThis represents one side of the border of theRectangle.static final intThis is the value that will be used as undefined .protected floatthe upper right x-coordinate.protected floatthe upper right y-coordinate.protected booleanWhether variable width borders are used.Fields inherited from interface Element
ALIGN_BASELINE, ALIGN_BOTTOM, ALIGN_CENTER, ALIGN_JUSTIFIED, ALIGN_JUSTIFIED_ALL, ALIGN_LEFT, ALIGN_MIDDLE, ALIGN_RIGHT, ALIGN_TOP, ALIGN_UNDEFINED, ANCHOR, ANNOTATION, AUTHOR, CCITT_BLACKIS1, CCITT_ENCODEDBYTEALIGN, CCITT_ENDOFBLOCK, CCITT_ENDOFLINE, CCITTG3_1D, CCITTG3_2D, CCITTG4, CELL, CHAPTER, CHUNK, CREATIONDATE, CREATOR, GRAPHIC, HEADER, IMGRAW, IMGTEMPLATE, JPEG, KEYWORDS, LIST, LISTITEM, MULTI_COLUMN_TEXT, PARAGRAPH, PHRASE, PRODUCER, PTABLE, RECTANGLE, ROW, SECTION, SUBJECT, TABLE, TITLE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionGets the backgroundcolor.intborder()Returns the exact type of the border.Gets the color of the border.floatGets the borderwidth.floatbottom()Returns the lower left y-coordinate.floatbottom(float margin) Returns the lower left y-coordinate, considering a given margin.voidCopies all of the parameters from aRectangleobject except the position.voiddisableBorderSide(int side) Disables the border on the specified side.voidenableBorderSide(int side) Enables the border on the specified side.Gets the color of a border.Gets the color of a border.Gets the color of a border.Gets the color of a border.floatGets the width of a border.floatGets the width of a border.floatGets the width of a border.floatGets the width of a border.floatGets all the chunks in this element.floatfloatgetLeft()getMarkupAttribute(String name) Returns the value of the specified attribute.Returns aSetofStringattribute names for theMarkupAttributesimplementor.Return aProperties-object containing all the markupAttributes.floatgetRight()intGets the rotation of the rectanglefloatgetTop()private floatgetVariableBorderWidth(float variableWidthValue, int side) floatgetWidth()floatgrayFill()Gets the grayscale.booleanhasBorder(int type) Indicates if the table has a some type of border.booleanIndicates if the table has borders.floatheight()Returns the height of the rectangle.booleanIndicates whether variable width borders are being used.floatleft()Returns the lower left x-coordinate.floatleft(float margin) Returns the lower left x-coordinate, considering a given margin.voidSwitches lowerleft with upperrightbooleanprocess(ElementListener listener) Processes the element by adding it (or the different parts) to anElementListener.rectangle(float top, float bottom) Gets a Rectangle that is altered to fit on the page.floatright()Returns the upper right x-coordinate.floatright(float margin) Returns the upper right x-coordinate, considering a given margin.rotate()Swaps the values of urx and ury and of lly and llx in order to rotate the rectangle.voidsetBackgroundColor(Color value) Sets the backgroundcolor of the rectangle.voidsetBorder(int value) Enables/Disables the border on the specified sides.voidsetBorderColor(Color value) Sets the color of the border.voidsetBorderColorBottom(Color value) Sets the value of the border colorvoidsetBorderColorLeft(Color value) Sets the value of the border colorvoidsetBorderColorRight(Color value) Sets the value of the border colorvoidsetBorderColorTop(Color value) Sets the value of the border colorvoidsetBorderWidth(float value) Sets the borderwidth of the table.voidsetBorderWidthBottom(float borderWidthBottom) Sets the width of a bordervoidsetBorderWidthLeft(float borderWidthLeft) Sets the width of a bordervoidsetBorderWidthRight(float borderWidthRight) Sets the width of a bordervoidsetBorderWidthTop(float borderWidthTop) Sets the width of a bordervoidsetBottom(float value) Sets the lower left y-coordinate.voidsetGrayFill(float value) Sets the grayscale of the rectangle.voidsetLeft(float value) Sets the lower left x-coordinate.voidsetMarkupAttribute(String name, String value) Sets the specified attribute.voidsetMarkupAttributes(Properties markupAttributes) Sets the markupAttributes.voidsetRight(float value) Sets the upper right x-coordinate.voidsetTop(float value) Sets the upper right y-coordinate.voidsetUseVariableBorders(boolean useVariableBorders) Sets a parameter indicating if the rectangle has variable bordersvoidCopies all of the parameters from aRectangleobject except the position.floattop()Returns the upper right y-coordinate.floattop(float margin) Returns the upper right y-coordinate, considering a given margin.toString()Gets the content of the text element.inttype()Gets the type of the text element.private voidupdateBorderBasedOnWidth(float width, int side) Updates the border flag for a side based on the specified width.floatwidth()Returns the width of the rectangle.
-
Field Details
-
UNDEFINED
public static final int UNDEFINEDThis is the value that will be used as undefined .- See Also:
-
TOP
public static final int TOPThis represents one side of the border of theRectangle.- See Also:
-
BOTTOM
public static final int BOTTOMThis represents one side of the border of theRectangle.- See Also:
-
LEFT
public static final int LEFTThis represents one side of the border of theRectangle.- See Also:
-
RIGHT
public static final int RIGHTThis represents one side of the border of theRectangle.- See Also:
-
NO_BORDER
public static final int NO_BORDERThis represents a rectangle without borders.- See Also:
-
BOX
public static final int BOXThis represents a type of border.- See Also:
-
llx
protected float llxthe lower left x-coordinate. -
lly
protected float llythe lower left y-coordinate. -
urx
protected float urxthe upper right x-coordinate. -
ury
protected float urythe upper right y-coordinate. -
border
protected int borderThis represents the status of the 4 sides of the rectangle. -
borderWidth
protected float borderWidthThis is the width of the border around this rectangle. -
color
The color of the border of this rectangle. -
borderColorLeft
The color of the left border of this rectangle. -
borderColorRight
The color of the right border of this rectangle. -
borderColorTop
The color of the top border of this rectangle. -
borderColorBottom
The color of the bottom border of this rectangle. -
borderWidthLeft
protected float borderWidthLeftThe width of the left border of this rectangle. -
borderWidthRight
protected float borderWidthRightThe width of the right border of this rectangle. -
borderWidthTop
protected float borderWidthTopThe width of the top border of this rectangle. -
borderWidthBottom
protected float borderWidthBottomThe width of the bottom border of this rectangle. -
useVariableBorders
protected boolean useVariableBordersWhether variable width borders are used. -
background
This is the color of the background of this rectangle. -
grayFill
protected float grayFillThis is the grayscale value of the background of this rectangle. -
rotation
protected int rotation -
markupAttributes
Contains extra markupAttributes
-
-
Constructor Details
-
Rectangle
public Rectangle(float llx, float lly, float urx, float ury) Constructs aRectangle-object.- Parameters:
llx- lower left xlly- lower left yurx- upper right xury- upper right y
-
Rectangle
public Rectangle(float urx, float ury) Constructs aRectangle-object starting from the origin (0, 0).- Parameters:
urx- upper right xury- upper right y
-
Rectangle
Constructs aRectangle-object.- Parameters:
rect- anotherRectangle
-
-
Method Details
-
cloneNonPositionParameters
Copies all of the parameters from aRectangleobject except the position.- Parameters:
rect-Rectangleto copy from
-
softCloneNonPositionParameters
Copies all of the parameters from aRectangleobject except the position.- Parameters:
rect-Rectangleto copy from
-
process
Processes the element by adding it (or the different parts) to anElementListener. -
type
-
getChunks
-
normalize
public void normalize()Switches lowerleft with upperright -
rectangle
Gets a Rectangle that is altered to fit on the page.- Parameters:
top- the top positionbottom- the bottom position- Returns:
- a
Rectangle
-
rotate
Swaps the values of urx and ury and of lly and llx in order to rotate the rectangle.- Returns:
- a
Rectangle
-
setLeft
public void setLeft(float value) Sets the lower left x-coordinate.- Parameters:
value- the new value
-
setRight
public void setRight(float value) Sets the upper right x-coordinate.- Parameters:
value- the new value
-
setTop
public void setTop(float value) Sets the upper right y-coordinate.- Parameters:
value- the new value
-
setBottom
public void setBottom(float value) Sets the lower left y-coordinate.- Parameters:
value- the new value
-
setBorder
public void setBorder(int value) Enables/Disables the border on the specified sides. The border is specified as an integer bitwise combination of the constants:LEFT, RIGHT, TOP, BOTTOM.- Parameters:
value- the new value- See Also:
-
enableBorderSide
public void enableBorderSide(int side) Enables the border on the specified side.- Parameters:
side- the side to enable. One ofLEFT, RIGHT, TOP, BOTTOM
-
disableBorderSide
public void disableBorderSide(int side) Disables the border on the specified side.- Parameters:
side- the side to disable. One ofLEFT, RIGHT, TOP, BOTTOM
-
setBorderWidth
public void setBorderWidth(float value) Sets the borderwidth of the table.- Parameters:
value- the new value
-
setBorderColor
Sets the color of the border.- Parameters:
value- the new value
-
setBorderColorRight
Sets the value of the border color- Parameters:
value- a color value
-
setBorderColorLeft
Sets the value of the border color- Parameters:
value- a color value
-
setBorderColorTop
Sets the value of the border color- Parameters:
value- a color value
-
setBorderColorBottom
Sets the value of the border color- Parameters:
value- a color value
-
setBackgroundColor
Sets the backgroundcolor of the rectangle.- Parameters:
value- the new value
-
setGrayFill
public void setGrayFill(float value) Sets the grayscale of the rectangle.- Parameters:
value- the new value
-
left
public float left()Returns the lower left x-coordinate.- Returns:
- the lower left x-coordinate
-
getLeft
public float getLeft() -
right
public float right()Returns the upper right x-coordinate.- Returns:
- the upper right x-coordinate
-
getRight
public float getRight() -
top
public float top()Returns the upper right y-coordinate.- Returns:
- the upper right y-coordinate
-
getTop
public float getTop() -
bottom
public float bottom()Returns the lower left y-coordinate.- Returns:
- the lower left y-coordinate
-
getBottom
public float getBottom() -
left
public float left(float margin) Returns the lower left x-coordinate, considering a given margin.- Parameters:
margin- a margin- Returns:
- the lower left x-coordinate
-
right
public float right(float margin) Returns the upper right x-coordinate, considering a given margin.- Parameters:
margin- a margin- Returns:
- the upper right x-coordinate
-
top
public float top(float margin) Returns the upper right y-coordinate, considering a given margin.- Parameters:
margin- a margin- Returns:
- the upper right y-coordinate
-
bottom
public float bottom(float margin) Returns the lower left y-coordinate, considering a given margin.- Parameters:
margin- a margin- Returns:
- the lower left y-coordinate
-
width
public float width()Returns the width of the rectangle.- Returns:
- a width
-
getWidth
public float getWidth() -
height
public float height()Returns the height of the rectangle.- Returns:
- a height
-
getHeight
public float getHeight() -
hasBorders
public boolean hasBorders()Indicates if the table has borders.- Returns:
- a boolean
-
hasBorder
public boolean hasBorder(int type) Indicates if the table has a some type of border.- Parameters:
type- the type of border- Returns:
- a boolean
-
border
public int border()Returns the exact type of the border.- Returns:
- a value
-
borderWidth
public float borderWidth()Gets the borderwidth.- Returns:
- a value
-
borderColor
-
backgroundColor
-
grayFill
public float grayFill()Gets the grayscale.- Returns:
- a value
-
getRotation
public int getRotation()Gets the rotation of the rectangle- Returns:
- a rotation value
-
setMarkupAttribute
Description copied from interface:MarkupAttributesSets the specified attribute.- Specified by:
setMarkupAttributein interfaceMarkupAttributes- Parameters:
name-Stringattribute name.value-Stringattribute value.- See Also:
-
setMarkupAttributes
Description copied from interface:MarkupAttributesSets the markupAttributes.- Specified by:
setMarkupAttributesin interfaceMarkupAttributes- Parameters:
markupAttributes- aProperties-object containing markupattributes- See Also:
-
getMarkupAttribute
Description copied from interface:MarkupAttributesReturns the value of the specified attribute.- Specified by:
getMarkupAttributein interfaceMarkupAttributes- Parameters:
name-Stringattribute name.- Returns:
String.- See Also:
-
getMarkupAttributeNames
Description copied from interface:MarkupAttributesReturns aSetofStringattribute names for theMarkupAttributesimplementor.- Specified by:
getMarkupAttributeNamesin interfaceMarkupAttributes- Returns:
Set.- See Also:
-
getMarkupAttributes
Description copied from interface:MarkupAttributesReturn aProperties-object containing all the markupAttributes.- Specified by:
getMarkupAttributesin interfaceMarkupAttributes- Returns:
Properties- See Also:
-
getBorderColorLeft
-
getBorderColorRight
-
getBorderColorTop
-
getBorderColorBottom
-
getBorderWidthLeft
public float getBorderWidthLeft()Gets the width of a border.- Returns:
- a width
-
setBorderWidthLeft
public void setBorderWidthLeft(float borderWidthLeft) Sets the width of a border- Parameters:
borderWidthLeft- a width
-
getBorderWidthRight
public float getBorderWidthRight()Gets the width of a border.- Returns:
- a width
-
setBorderWidthRight
public void setBorderWidthRight(float borderWidthRight) Sets the width of a border- Parameters:
borderWidthRight- a width
-
getBorderWidthTop
public float getBorderWidthTop()Gets the width of a border.- Returns:
- a width
-
setBorderWidthTop
public void setBorderWidthTop(float borderWidthTop) Sets the width of a border- Parameters:
borderWidthTop- a width
-
getBorderWidthBottom
public float getBorderWidthBottom()Gets the width of a border.- Returns:
- a width
-
setBorderWidthBottom
public void setBorderWidthBottom(float borderWidthBottom) Sets the width of a border- Parameters:
borderWidthBottom- a width
-
updateBorderBasedOnWidth
private void updateBorderBasedOnWidth(float width, int side) Updates the border flag for a side based on the specified width. A width of 0 will disable the border on that side. Any other width enables it.- Parameters:
width- width of borderside- border side constant
-
getVariableBorderWidth
private float getVariableBorderWidth(float variableWidthValue, int side) -
isUseVariableBorders
public boolean isUseVariableBorders()Indicates whether variable width borders are being used. Returns true ifsetBorderWidthLeft, setBorderWidthRight, setBorderWidthTop, or setBorderWidthBottomhas been called.- Returns:
- true if variable width borders are in use
-
setUseVariableBorders
public void setUseVariableBorders(boolean useVariableBorders) Sets a parameter indicating if the rectangle has variable borders- Parameters:
useVariableBorders- indication if the rectangle has variable borders
-
toString
-