| FoxitPDFSDKforWeb v11.0.4 Archives Foxit PDF SDK for Web

Public Member Functions | List of all members
HeaderFooter Class Reference
PDF

PDF HeaderFooter object. More...

## Public Member Functions
| constructor (json)
| Constructor of HeaderFooter. More...
| enableFixedSizedForPrint (enable)
| Enable fixed size for print of header or footer or not. More...
| enableTextShrinked (enable)
| Enable text shrinked of header or footer or not. More...
| getContent (position)
| Get content formats. More...
| getUnderline ()
| Get underline text decoration. More...
| isEmpty ()
| Check whether HeaderFooter is empty. More...
| setContentFormat (position, format)
| Set content formats. More...
| setFont (fontId)
| Set font. More...
| setMargin (rect)
| Set margin. More...
| setRange (range)
| Set the page range to which the header or footer will be inserted. More...
| setStartDisplayingPage (index)
| Set first page index to be displayed in first page of range. More...
| setTextColor (color)
| Set text color of header or footer. More...
| setTextSize (size)
| Set text size of header or footer. More...
| setUnderline (underline)
| Set underline text decoration or not. More...

## Detailed Description

PDF HeaderFooter object.

Since
  7.2.0

## Member Function Documentation

## ◆ constructor()

HeaderFooter::constructor | ( |  | json | ) |
| inline

Constructor of HeaderFooter.

Note
  It's recommanded to use method to config header and footer.

Parameters

  [json] | object - A json object specify configuration of header footer. For example: { contentFormats: {TopLeft: [{type:'string',value:'***'}]}, margin: {left: 72, right: 36, top: 72, bottom: 36}, textSize: 12, textColor: 4278190080, hasTextShrinked: false, hasFixedSized: false, startPageNumber: 1, underline:false }

## ◆ enableFixedSizedForPrint()

HeaderFooter::enableFixedSizedForPrint | ( |  | enable | ) |
| inline

Enable fixed size for print of header or footer or not.

Parameters

  enable | boolean - Specifies fixed size for print or not.

## ◆ enableTextShrinked()

HeaderFooter::enableTextShrinked | ( |  | enable | ) |
| inline

Enable text shrinked of header or footer or not.

Parameters

  enable | boolean - Specifies text shrinked or not.

## ◆ getContent()

HeaderFooter::getContent | ( |  | position | ) |
| inline

Get content formats.

Parameters

  position | string - Location of header or footer. Please refer to Position. Position Position::centerLeft, Position::center and Position::centerRight are not available.

## ◆ getUnderline()

HeaderFooter::getUnderline | ( |  | ) |
| inline

Get underline text decoration.

Returns
  boolean - True for underline, false for normal style.

Since
  7.5.0

## ◆ isEmpty()

HeaderFooter::isEmpty | ( |  | ) |
| inline

Check whether HeaderFooter is empty.

Note
  If a HeaderFooter is empty, nothing will happend to call PDFDoc.addHeaderFooter.

Returns
  boolean - Whether HeaderFooter is empty.

Since
  7.3.0

## ◆ setContentFormat()

HeaderFooter::setContentFormat | ( |  | position,
|  |  | format
| ) |  |
| inline

Set content formats.

Parameters

  position | string - Location of header or footer. Please refer to Position. Position Position::centerLeft, Position::center and Position::centerRight are not available.
  format | Array<{type:string,value:any}> - A json array which specifies contents' format. Please refer to date_Format and page_Number_Format for date and page number format's detail.

For Example:

[
{
type:"string",// Type string should be one of "string", "pageNumber" and "date"
value:"abc"
},
{
type:"date",// Type string should be one of "string", "pageNumber" and "date",
value:0, // Date format.
},
{
type:"pageNumber",// Type string should be one of "string", "pageNumber" and "date"
value:0,//Page Number's format type.
}
]

## ◆ setFont()

HeaderFooter::setFont | ( |  | fontId | ) |
| inline

Set font.

Parameters

  fontId | number - An integer which specifies font. Please refer to Standard_Font.

## ◆ setMargin()

HeaderFooter::setMargin | ( |  | rect | ) |
| inline

Set margin.

Parameters

  rect | PDFRect - A rectangle specifies header or footer's margin.

Note
  This value does not represents a rectangle. It just defines the left margin, bottom margin, right margin and top margin of a PDF page. These margins can be used to locate header-footer content in different places:
  - Left margin is used to specify the location for left header or footer content to be started.
  - right margin is used to specify the location for right header or footer content to be ended.
  - bottom margin is used to specify the top location for any footer content to be placed.
  - top margin is used to specify the bottom location for any header content to be placed.
  if bottom margin and top margin is less than or equal to 0, the header or footer content will be invisible. so the default construction has a default value RectF(72.0, 36.0, 72.0, 36.0);

## ◆ setRange()

HeaderFooter::setRange | ( |  | range | ) |
| inline

Set the page range to which the header or footer will be inserted.

Parameters

  range | PageRange - Please refer to PageRange.

## ◆ setStartDisplayingPage()

HeaderFooter::setStartDisplayingPage | ( |  | index | ) |
| inline

Set first page index to be displayed in first page of range.

Parameters

  index | number - Page Index.

## ◆ setTextColor()

HeaderFooter::setTextColor | ( |  | color | ) |
| inline

Set text color of header or footer.

Parameters

  color | number - Text color(0xffRRGGBB). Alpha chennal is ignored, and always is 0xff.

## ◆ setTextSize()

HeaderFooter::setTextSize | ( |  | size | ) |
| inline

Set text size of header or footer.

Parameters

  size | number - Text size.

## ◆ setUnderline()

HeaderFooter::setUnderline | ( |  | underline | ) |
| inline

Set underline text decoration or not.

Parameters

  underline | boolean - True for underline, false for normal style.

Since
  7.5.0

@2025 Foxit Software Incorporated. All rights reserved.