Package org.zefer.pd4ml
Class PD4PageMark
- java.lang.Object
-
- org.zefer.pd4ml.PD4PageMark
-
- All Implemented Interfaces:
Serializable
public class PD4PageMark extends Object implements Serializable
-
-
Field Summary
Fields Modifier and Type Field Description static intCENTER_ALIGNstatic intLEFT_ALIGNstatic intRIGHT_ALIGN
-
Constructor Summary
Constructors Constructor Description PD4PageMark()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanfirstPageDiffers()checks if the header/footer definition for the first page differs the default definitionintgetAreaHeight()returns header or footer height.ColorgetColor()FontgetFont()returns font currently used for header or footerFontgetFont(int pageNumber)returns font currently used for header or footer The method can be overridden in order to add page dependent header/footer font definitionintgetFontSize()StringgetHtmlTemplate()returns HTML template used to print entire document header/footer area.StringgetHtmlTemplate(int pageNumber)returns string template used to print HTML header or footer The method can be overridden in order to add page dependent template specificationintgetInitialPageNumber()returns initial value for the PDF document page counter.ColorgetPageBackgroundColor()returns default page background colorColorgetPageBackgroundColor(int pageNumber)returns background color for the specified page The method can be overridden in order to add page dependent color definitionStringgetPageBackgroundImageUrl()returns default page background image URLStringgetPageBackgroundImageUrl(int pageNumber)returns background image URL for the specified page The method can be overridden in order to add page dependent background image definitionintgetPageNumberAlignment()returns page number alignmentStringgetPageNumberTemplate()returns string template used to print page numbersStringgetPageNumberTemplate(int pageNumber)returns string template used to print page numbers.intgetPagesToSkip()returns number of pages that should not be marked with header or footer areaintgetTitleAlignment()returns title alignment valueStringgetTitleTemplate()returns string template used to print document title in header or footer areaStringgetTitleTemplate(int pageNumber)returns string template used to print document title in header or footer area The method can be overridden in order to add page dependent template specificationRectanglegetWatermarkBounds()intgetWatermarkOpacity()StringgetWatermarkUrl()StringgetWatermarkUrl(int pageNumber)voidsetAreaHeight(int i)defines height of the header or footer areavoidsetColor(Color color)setColor() sets the color of header or footer textvoidsetFont(Font font)sets font for header (footer) (since v1.2.0b2)voidsetFontSize(int size)sets font size for the header of footervoidsetHtmlTemplate(String template)sets HTML template used to print entire document header/footer area.voidsetInitialPageNumber(int i)defines initial value for the PDF document page counter.voidsetPageBackgroundColor(Color pageBackgroundColor)defines default page background colorvoidsetPageBackgroundImageUrl(String pageBackgroundImageUrl)defines default page background image (form, letterhead)voidsetPageNumberAlignment(int i)defines alignment for the page numbers in the document's header of footer areavoidsetPageNumberTemplate(String string)defines a template for page number representation
No page numbering is printed, if the pageNumberTemplate is set to null.
Default value is null.
If HTML template specified, than the method call is ignored.voidsetPagesToSkip(int i)defines a number of pages from the document beginning, that should not be marked with the header or footer info.voidsetTitleAlignment(int i)defines alignment for the page title string in the document's header of footer.
Note: only single line headers are supportedvoidsetTitleTemplate(String string)defines a template for page title representation.
No title is printed, if the titleTemplate is set to null.voidsetWatermark(String url, Rectangle bounds, int opacity)specifies watermark image to be printed on every page.StringtoString()
-
-
-
Field Detail
-
LEFT_ALIGN
public static final int LEFT_ALIGN
- See Also:
- Constant Field Values
-
CENTER_ALIGN
public static final int CENTER_ALIGN
- See Also:
- Constant Field Values
-
RIGHT_ALIGN
public static final int RIGHT_ALIGN
- See Also:
- Constant Field Values
-
-
Method Detail
-
setWatermark
public void setWatermark(String url, Rectangle bounds, int opacity)
specifies watermark image to be printed on every page. Available only in Pro version of PD4ML.- Parameters:
url- image locationbounds- image position and size in typographical pointsopacity- image opacity in range from 0 to 100
-
getWatermarkBounds
public Rectangle getWatermarkBounds()
- Returns:
- watermark image position and size in typographical points
- See Also:
setWatermark(String, Rectangle, int)
-
getWatermarkOpacity
public int getWatermarkOpacity()
- Returns:
- watermark image opacity
- See Also:
setWatermark(String, Rectangle, int)
-
getWatermarkUrl
public String getWatermarkUrl()
- Returns:
- watermark image location
- See Also:
setWatermark(String, Rectangle, int)
-
getWatermarkUrl
public String getWatermarkUrl(int pageNumber)
- Returns:
- watermark image location
- See Also:
setWatermark(String, Rectangle, int)
-
getInitialPageNumber
public int getInitialPageNumber()
returns initial value for the PDF document page counter.- Returns:
- initial value
- See Also:
setInitialPageNumber(int)
-
getPageNumberAlignment
public int getPageNumberAlignment()
returns page number alignment- Returns:
- alignment
- See Also:
setPageNumberAlignment(int),LEFT_ALIGN,RIGHT_ALIGN,CENTER_ALIGN
-
getPageNumberTemplate
public String getPageNumberTemplate()
returns string template used to print page numbers- Returns:
- template string
- See Also:
setPageNumberTemplate(String)
-
getPageNumberTemplate
public String getPageNumberTemplate(int pageNumber)
returns string template used to print page numbers. The method can be overridden in order to add page dependent template specification- Parameters:
pageNumber- destination page number- Returns:
- template string
-
getPagesToSkip
public int getPagesToSkip()
returns number of pages that should not be marked with header or footer area- Returns:
- number of pages
- See Also:
setPagesToSkip(int)
-
getTitleAlignment
public int getTitleAlignment()
returns title alignment value- Returns:
- alignment
- See Also:
setTitleAlignment(int)
-
getTitleTemplate
public String getTitleTemplate()
returns string template used to print document title in header or footer area- Returns:
- template string
- See Also:
setTitleTemplate(String)
-
getTitleTemplate
public String getTitleTemplate(int pageNumber)
returns string template used to print document title in header or footer area The method can be overridden in order to add page dependent template specification- Parameters:
pageNumber- destination page number- Returns:
- template string
-
getHtmlTemplate
public String getHtmlTemplate()
returns HTML template used to print entire document header/footer area. If HTML template specified, than titleTemplate and pageNumberTemplate attributes are ignored. Available only in Pro version of PD4ML.- Returns:
- template string
- See Also:
setTitleTemplate(String),setPageNumberTemplate(String),setHtmlTemplate(String)
-
getHtmlTemplate
public String getHtmlTemplate(int pageNumber)
returns string template used to print HTML header or footer The method can be overridden in order to add page dependent template specification- Parameters:
pageNumber- destination page number- Returns:
- template string
-
setHtmlTemplate
public void setHtmlTemplate(String template)
sets HTML template used to print entire document header/footer area. If HTML template specified, than titleTemplate and pageNumberTemplate attributes are ignored. Available only in Pro version of PD4ML.
-
setInitialPageNumber
public void setInitialPageNumber(int i)
defines initial value for the PDF document page counter. Default is 1.- Parameters:
i- initial page number
-
setPageNumberAlignment
public void setPageNumberAlignment(int i) throws InvalidParameterExceptiondefines alignment for the page numbers in the document's header of footer area- Parameters:
i- - alignment- Throws:
InvalidParameterException- See Also:
LEFT_ALIGN,RIGHT_ALIGN,CENTER_ALIGN
-
setPageNumberTemplate
public void setPageNumberTemplate(String string)
defines a template for page number representation
No page numbering is printed, if the pageNumberTemplate is set to null.
Default value is null.
If HTML template specified, than the method call is ignored.- Parameters:
string- a string with static text or/and special markups: ${page} - for current page number, ${total} - for total number of pages in the document. The both numeric values can be affected by setInitailPageNumber()- See Also:
setHtmlTemplate(String)
-
setPagesToSkip
public void setPagesToSkip(int i) throws InvalidParameterExceptiondefines a number of pages from the document beginning, that should not be marked with the header or footer info.- Parameters:
i- number of pages to skip- Throws:
InvalidParameterException
-
setTitleAlignment
public void setTitleAlignment(int i) throws InvalidParameterExceptiondefines alignment for the page title string in the document's header of footer.
Note: only single line headers are supported- Parameters:
i- - alignment- Throws:
InvalidParameterException- See Also:
LEFT_ALIGN,RIGHT_ALIGN,CENTER_ALIGN
-
setTitleTemplate
public void setTitleTemplate(String string)
defines a template for page title representation.
No title is printed, if the titleTemplate is set to null. Default value is null.
If HTML template specified, than the method call is ignored.- Parameters:
string- a string with static text or/and special markups: ${title} - page title, ${page} - current page number, ${total} - for total number of pages in the document. The both numeric values can be affected by setInitailPageNumber() call- See Also:
setHtmlTemplate(String)
-
getAreaHeight
public int getAreaHeight()
returns header or footer height.- Returns:
- header/footer area height
-
setAreaHeight
public void setAreaHeight(int i) throws InvalidParameterExceptiondefines height of the header or footer area- Parameters:
i- height in points; "-1" value forces PD4ML to predict HTML header or footer height and to use the calculated value.- Throws:
InvalidParameterException
-
getColor
public Color getColor()
- Returns:
- area color
- See Also:
setColor(Color)
-
getFont
public Font getFont()
returns font currently used for header or footer- Returns:
- header/footer font
-
getFont
public Font getFont(int pageNumber)
returns font currently used for header or footer The method can be overridden in order to add page dependent header/footer font definition- Parameters:
pageNumber- destination page number- Returns:
- header/footer font for specified page
-
getFontSize
public int getFontSize()
- Returns:
- font size
- See Also:
setFontSize(int)
-
setColor
public void setColor(Color color)
setColor() sets the color of header or footer text- Parameters:
color-
-
setFontSize
public void setFontSize(int size) throws InvalidParameterExceptionsets font size for the header of footer- Parameters:
size-- Throws:
InvalidParameterException
-
setFont
public void setFont(Font font) throws InvalidParameterException
sets font for header (footer) (since v1.2.0b2)- Parameters:
font-- Throws:
InvalidParameterException
-
getPageBackgroundColor
public Color getPageBackgroundColor(int pageNumber)
returns background color for the specified page The method can be overridden in order to add page dependent color definition- Parameters:
pageNumber- destination page number- Returns:
- background color for the specified page
-
getPageBackgroundImageUrl
public String getPageBackgroundImageUrl(int pageNumber)
returns background image URL for the specified page The method can be overridden in order to add page dependent background image definition- Parameters:
pageNumber- destination page number- Returns:
- background image URL for the specified page
-
getPageBackgroundColor
public Color getPageBackgroundColor()
returns default page background color- Returns:
- background color
-
setPageBackgroundColor
public void setPageBackgroundColor(Color pageBackgroundColor)
defines default page background color- Parameters:
pageBackgroundColor-
-
getPageBackgroundImageUrl
public String getPageBackgroundImageUrl()
returns default page background image URL- Returns:
- background image URL
-
setPageBackgroundImageUrl
public void setPageBackgroundImageUrl(String pageBackgroundImageUrl)
defines default page background image (form, letterhead)- Parameters:
pageBackgroundImageUrl-
-
firstPageDiffers
public boolean firstPageDiffers()
checks if the header/footer definition for the first page differs the default definition
-
-