PageNumberingTemplate Property

Template to use for the individual file names when the output format does not support multipages.

public string PageNumberingTemplate { get; set; } 

public:  
   property String^ PageNumberingTemplate 
   { 
      String^ get() 
      void set(String^ value) 
   } 

public String getPageNumberingTemplate() 
public void setPageNumberingTemplate(String value) 

PageNumberingTemplate # get and set (DocumentConverterOptions) 

Property Value

A string that contains the template to use for the individual file names when the output format does not support multipages. Default value is ##name##_Page(##page##).##extension##".

This template is used when the input document has multiple pages but the output format chosen contains does not support creating files with multiple pages. For example, when converting from a multipage PDF file to PNG raster image format.

The converter understands the following placeholders:

• ##name##: Will be replaced by the file name without the extension

• ##page##: Will be replaced by the 1-based page number of the source file

• ##extension##: Will be replaced by extension of the output format

This template will be applied to the value of DocumentConverterJobData.OutputDocumentFileName. In the example of PDF input and PNG output above assume the user passed C:\Dir\Output.png as the value for OutputDocumentFileName, and assume the PDF file has 4 pages. After the conversion is performed, the following files are created if the default template is used:

C:\Dir\Output_Page1.png 
C:\Dir\Output_Page2.png 
C:\Dir\Output_Page3.png 
C:\Dir\Output_Page4.png 

You can omit any part of the template when modifying it. For example, if you set the value to result_##page##.##extension## then the files created are:

C:\Dir\result_Page1.png 
C:\Dir\result_Page2.png 
C:\Dir\result_Page3.png 
C:\Dir\result_Page4.png 

And the text "Output" is omitted and not used.

OutputSinglePages can be used to override the behavior when converting to raster documents (such as TIF and Raster PDF).

Target Platforms

Reference

DocumentConverterOptions Class

DocumentConverterOptions Members

Leadtools.Document.Converter Namespace

Using LEADTOOLS Document Converter