combit List & Label 24 - .NET Online Web Help
ConvertTo(String,String) Method


combit.ListLabel24 Namespace > PreviewFile Class > ConvertTo Method : ConvertTo(String,String) Method
Name of the target file. It is also possible to use the placeholder "%d" (e.g. "page %d"). This is important e.g. for converting JPEGs, because without the placeholder only one page will result.

Target format. Valid values are:

This parameter allows you to declare a semicolon-separated list with further export options. You will find the accepted values in the chapter for the export modules in the Programmer's Manual. Please note that not all options can be supported with this API. An example is the parameter "PDF;PDF.EncryptionFile=1".


Additional to the mentioned parameters above the following parameters can be used:

Value Meaning
PageIndexRange Analog to the print options dialog a range for pages can be set.
JobIndexRange Analog to the print options dialog a range for the job can be set.
IssueIndexRange Analog to the print options dialog a range for the issues can be set.

 

Converts the preview file into the given filename.  Allows to specify the format and additional options.
Syntax
'Declaration
 
Public Overloads Sub ConvertTo( _
   ByVal filename As String, _
   ByVal targetFormat As String _
) 
public void ConvertTo( 
   string filename,
   string targetFormat
)
public:
void ConvertTo( 
   String^ filename,
   String^ targetFormat
) 

Parameters

filename
Name of the target file. It is also possible to use the placeholder "%d" (e.g. "page %d"). This is important e.g. for converting JPEGs, because without the placeholder only one page will result.
targetFormat

Target format. Valid values are:

  • "TIFF" (also "PICTURE_MULTITIFF")
  • "JPEG" (also "PICTURE_JPEG")
  • "PNG" (also "PICTURE_PNG")
  • "EMF"
  • "TTY"
  • "PDF"
  • "PRN"
  • "XPS"
  • "TXT"  

This parameter allows you to declare a semicolon-separated list with further export options. You will find the accepted values in the chapter for the export modules in the Programmer's Manual. Please note that not all options can be supported with this API. An example is the parameter "PDF;PDF.EncryptionFile=1".


Additional to the mentioned parameters above the following parameters can be used:

Value Meaning
PageIndexRange Analog to the print options dialog a range for pages can be set.
JobIndexRange Analog to the print options dialog a range for the job can be set.
IssueIndexRange Analog to the print options dialog a range for the issues can be set.

 

Example

An example of this is the use of "PDF;Export.PageIndexRange=2-3" and"PDF.FontMode=1". With this, only pages 2 and 3 are converted to PDF. Furthermore all TrueType-Fonts are embedded into the PDF.

// Open existing preview file
PreviewFile previewFile = new PreviewFile(@"C:\preview.ll");

// Convert the preview file into PDF with the following options:
// - only pages 2-3
// - embed TrueType-Fonts
previewFile.ConvertTo(@"C:\preview.pdf","PDF;Export.PageIndexRange=2-3;PDF.FontMode=1");

// Close and free preview file
previewFile.Close();
previewFile.Dispose();
' Open existing preview file
Dim previewFile As New PreviewFile("C:\preview.ll")

' Convert the preview file into PDF with the following options:
' - only pages 2-3
' - embed TrueType-Fonts
previewFile.ConvertTo("C:\preview.pdf", "PDF;Export.PageIndexRange=2-3;PDF.FontMode=1")

' Close and free preview file
previewFile.Close()
previewFile.Dispose()

 

Requirements

Platforms: Windows Vista - Windows 10 Version 1809, Windows Server 2008 - 2016

See Also

Reference

PreviewFile Class
PreviewFile Members
Overload List