Foxit PDF SDK
FSHTML2PDFSettingData Class Reference

Inherits NSObject.

Instance Methods

(id) - init
 Constructor.

 
(id) - initWithPage_width:page_height:is_to_page_scale:page_margin:is_convert_link:rotate_degrees:is_generate_tag:page_mode:to_generate_bookmarks:scaling_mode:encoding_format:to_render_images:to_remove_underline_for_link:to_set_headerfooter:headerfooter_title:headerfooter_url:bookmark_root_name:to_resize_objects:to_print_background:to_optimize_tag_tree:media_style:
 Constructor, with parameters.
More...
 
(void) - set:page_height:is_to_page_scale:page_margin:is_convert_link:rotate_degrees:is_generate_tag:page_mode:to_generate_bookmarks:scaling_mode:encoding_format:to_render_images:to_remove_underline_for_link:to_set_headerfooter:headerfooter_title:headerfooter_url:bookmark_root_name:to_resize_objects:to_print_background:to_optimize_tag_tree:media_style:
 Set value.
More...
 

Properties

NSString * bookmark_root_name
 The bookmark's root name.

 
FSHTML2PDFSettingDataHTML2PDFEncodingFormat encoding_format
 The HTML encoding format Please refer to values starting from and this should be one of these values.
 
NSString * headerfooter_title
 The header-footer title which is content for center header.

 
NSString * headerfooter_url
 The header-footer url which is content for left footer.

 
BOOL is_convert_link
 Used to decide whether the web link should be converted or not.

 
BOOL is_generate_tag
 Used to decide whether the tag should be generated or not.

 
BOOL is_to_page_scale
 Used to decide whether to scale the converted PDF page or not.
More...
 
FSHTML2PDFSettingDataHTML2PDFMediaStyle media_style
 The media style used for the converted PDF document. Please refer to values starting from FSHTML2PDFSettingDataMediaStyleScreen and this should be one of these values.

 
float page_height
 The page height used for the converted PDF document.
More...
 
FSRectFpage_margin
 The page margin used for converted PDF document.
More...
 
FSHTML2PDFSettingDataHTML2PDFPageMode page_mode
 The page mode used for the converting. Please refer to values starting from FSHTML2PDFSettingDataPageModeSinglePage and this should be one of these values.

 
float page_width
 The page width used for the converted PDF document.
More...
 
FSRotation rotate_degrees
 The rotation degree used for the converted PDF page.Please refer to values starting from FSRotation0 and this should be one of these values.

 
FSHTML2PDFSettingDataHTML2PDFScalingMode scaling_mode
 The scaling mode used for the converted PDF document. Please refer to values starting from FSHTML2PDFSettingDataScalingModeNone and this should be one of these values.

 
BOOL to_generate_bookmarks
 Used to decide whether bookmarks should be generated or not.

 
BOOL to_optimize_tag_tree
 Used to decide whether to optimize tag tree or not.

 
BOOL to_print_background
 Used to decide whether to print background or not.

 
BOOL to_remove_underline_for_link
 Used to decide whether to remove underline decoration for link.

 
BOOL to_render_images
 Used to decide whether to render images or not.

 
BOOL to_resize_objects
 Whether to enable the Javascripts related resizing of the objects during rendering process.

 
BOOL to_set_headerfooter
 Used to decide whether to set header-footer or not.

 

Detailed Description

This class represents setting data used for converting HTML to PDF.

Method Documentation

◆ initWithPage_width:page_height:is_to_page_scale:page_margin:is_convert_link:rotate_degrees:is_generate_tag:page_mode:to_generate_bookmarks:scaling_mode:encoding_format:to_render_images:to_remove_underline_for_link:to_set_headerfooter:headerfooter_title:headerfooter_url:bookmark_root_name:to_resize_objects:to_print_background:to_optimize_tag_tree:media_style:()

- (id) initWithPage_width: (float)  page_width
page_height: (float)  page_height
is_to_page_scale: (BOOL)  is_to_page_scale
page_margin: (FSRectF*)  page_margin
is_convert_link: (BOOL)  is_convert_link
rotate_degrees: (FSRotation rotate_degrees
is_generate_tag: (BOOL)  is_generate_tag
page_mode: (FSHTML2PDFSettingDataHTML2PDFPageMode page_mode
to_generate_bookmarks: (BOOL)  to_generate_bookmarks
scaling_mode: (FSHTML2PDFSettingDataHTML2PDFScalingMode scaling_mode
encoding_format: (FSHTML2PDFSettingDataHTML2PDFEncodingFormat encoding_format
to_render_images: (BOOL)  to_render_images
to_remove_underline_for_link: (BOOL)  to_remove_underline_for_link
to_set_headerfooter: (BOOL)  to_set_headerfooter
headerfooter_title: (NSString *)  headerfooter_title
headerfooter_url: (NSString *)  headerfooter_url
bookmark_root_name: (NSString *)  bookmark_root_name
to_resize_objects: (BOOL)  to_resize_objects
to_print_background: (BOOL)  to_print_background
to_optimize_tag_tree: (BOOL)  to_optimize_tag_tree
media_style: (FSHTML2PDFSettingDataHTML2PDFMediaStyle media_style 

Constructor, with parameters.

Parameters
[in]page_widthThe page width used for the converted PDF document.
[in]page_heightThe page height used for the converted PDF document. This would be ignored if page mode FSHTML2PDFSettingDataPageModeSinglePage is used.
[in]is_to_page_scale(Deprecated)Used to decide whether to scale the converted PDF page or not.
[in]page_marginThe page margin used for converted PDF document.
[in]is_convert_linkUsed to decide whether the web link should be converted or not.
[in]rotate_degreesThe rotation degree used for the converted PDF page.Please refer to values starting from FSRotation0 and this should be one of these values.
[in]is_generate_tagUsed to decide whether the tag should be generated or not.
[in]page_modeThe page mode used for the converting. Please refer to values starting from FSHTML2PDFSettingDataPageModeSinglePage and this should be one of these values.
[in]to_generate_bookmarksUsed to decide whether bookmarks should be generated or not.
[in]scaling_modeThe scaling mode used for the converted PDF document. Please refer to values starting from FSHTML2PDFSettingDataScalingModeNone and this should be one of these values.
[in]encoding_formatThe HTML encoding format Please refer to values starting from and this should be one of these values.
[in]to_render_imagesWhether to render images or not.
[in]to_remove_underline_for_linkWhether to remove underline decoration for link or not.
[in]to_set_headerfooterWhether to set header-footer or not.
[in]headerfooter_titleThe header-footer title which is content for center header.
[in]headerfooter_urlThe header-footer url which is content for left footer.
[in]bookmark_root_nameThe bookmark's root name.
[in]to_resize_objectsWhether to enable the Javascripts related resizing of the objects during rendering process.
[in]to_print_backgroundWhether to print background or not.
[in]to_optimize_tag_treeWhether to optimize tag tree or not.
[in]media_styleThe media style used for the converted PDF document. Please refer to values starting from FSHTML2PDFSettingDataMediaStyleScreen and this should be one of these values.
Returns
None.

◆ set:page_height:is_to_page_scale:page_margin:is_convert_link:rotate_degrees:is_generate_tag:page_mode:to_generate_bookmarks:scaling_mode:encoding_format:to_render_images:to_remove_underline_for_link:to_set_headerfooter:headerfooter_title:headerfooter_url:bookmark_root_name:to_resize_objects:to_print_background:to_optimize_tag_tree:media_style:()

- (void) set: (float)  page_width
page_height: (float)  page_height
is_to_page_scale: (BOOL)  is_to_page_scale
page_margin: (FSRectF*)  page_margin
is_convert_link: (BOOL)  is_convert_link
rotate_degrees: (FSRotation rotate_degrees
is_generate_tag: (BOOL)  is_generate_tag
page_mode: (FSHTML2PDFSettingDataHTML2PDFPageMode page_mode
to_generate_bookmarks: (BOOL)  to_generate_bookmarks
scaling_mode: (FSHTML2PDFSettingDataHTML2PDFScalingMode scaling_mode
encoding_format: (FSHTML2PDFSettingDataHTML2PDFEncodingFormat encoding_format
to_render_images: (BOOL)  to_render_images
to_remove_underline_for_link: (BOOL)  to_remove_underline_for_link
to_set_headerfooter: (BOOL)  to_set_headerfooter
headerfooter_title: (NSString *)  headerfooter_title
headerfooter_url: (NSString *)  headerfooter_url
bookmark_root_name: (NSString *)  bookmark_root_name
to_resize_objects: (BOOL)  to_resize_objects
to_print_background: (BOOL)  to_print_background
to_optimize_tag_tree: (BOOL)  to_optimize_tag_tree
media_style: (FSHTML2PDFSettingDataHTML2PDFMediaStyle media_style 

Set value.

Parameters
[in]page_widthThe page width used for the converted PDF document.
[in]page_heightThe page height used for the converted PDF document. This would be ignored if page mode FSHTML2PDFSettingDataPageModeSinglePage is used.
[in]is_to_page_scale(Deprecated)Used to decide whether to scale the converted PDF page or not.
[in]page_marginThe page margin used for converted PDF document.
[in]is_convert_linkUsed to decide whether the web link should be converted or not.
[in]rotate_degreesThe rotation degree used for the converted PDF page.Please refer to values starting from FSRotation0 and this should be one of these values.
[in]is_generate_tagUsed to decide whether the tag should be generated or not.
[in]page_modeThe page mode used for the converting. Please refer to values starting from FSHTML2PDFSettingDataPageModeSinglePage and this should be one of these values.
[in]to_generate_bookmarksUsed to decide whether bookmarks should be generated or not.
[in]scaling_modeThe scaling mode used for the converted PDF document. Please refer to values starting from FSHTML2PDFSettingDataScalingModeNone and this should be one of these values.
[in]encoding_formatThe HTML encoding format Please refer to values starting from and this should be one of these values.
[in]to_render_imagesWhether to render images or not.
[in]to_remove_underline_for_linkWhether to remove underline decoration for link or not.
[in]to_set_headerfooterWhether to set header-footer or not.
[in]headerfooter_titleThe header-footer title which is content for center header.
[in]headerfooter_urlThe header-footer url which is content for left footer.
[in]bookmark_root_nameThe bookmark's root name.
[in]to_resize_objectsWhether to enable the Javascripts related resizing of the objects during rendering process.
[in]to_print_backgroundWhether to print background or not.
[in]to_optimize_tag_treeWhether to optimize tag tree or not.
[in]media_styleThe media style used for the converted PDF document. Please refer to values starting from FSHTML2PDFSettingDataMediaStyleScreen and this should be one of these values.
Returns
None.

Property Documentation

◆ is_to_page_scale

- (BOOL) is_to_page_scale
readwritenonatomicassign

Used to decide whether to scale the converted PDF page or not.

Deprecated:
Current property has been deprecated since Foxit PDF SDK 8.2. This property will not have any effect on converting PDF any more. For scaling mode, please refer to scaling_mode.

◆ page_height

- (float) page_height
readwritenonatomicassign

The page height used for the converted PDF document.

This value minus the sum of the top and bottom margins must be bigger than 16.

Note
The page height would be ignored if page mode FSHTML2PDFSettingDataPageModeSinglePage is used.

◆ page_margin

- (FSRectF *) page_margin
readwritenonatomicweak

The page margin used for converted PDF document.

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.

◆ page_width

- (float) page_width
readwritenonatomicassign

The page width used for the converted PDF document.

This value minus the sum of the left and right margins must be bigger than 16.