'Deklaration
 
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
) 

Parameter

filename

Name der Zieldatei. Dieser kann auch den Formatierungsplatzhalter "%d" enthalten (z.B. "Seite %d"). Dies ist wichtig z.B. für JPEG-Konvertierung, da sonst nur eine einzige Seite erzeugt werden würde.

targetFormat

Gewünschtes Zielformat. Erlaubte Werte: 

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

Über diesen Parameter kann eine semikolonseparierte Liste mit darin enthaltenen exporterspezifischen Optionen für die Konvertierung gesetzt werden. Die möglichen Parameter finden Sie im Kapitel über die Export-Module in der Programmierer-Referenz dokumentiert.

Beachten Sie, dass nicht alle dort angegebenen Parameter berücksichtigt werden können. Ein Beispiel dafür wäre die Übergabe von "PDF;PDF.Encryption.EncryptFile=1".

Zusätzlich zu den im Kapitel über die Export-Module in der Programmierer-Referenz beschriebenen Parametern können die folgenden Parameter übergeben werden:

Wert	Bedeutung
PageIndexRange	Analog zum Druckdialog kann ein Bereich für die Seiten angegeben werden.
JobIndexRange	Analog zum Druckdialog kann ein Bereich für den Job angegeben werden.
IssueIndexRange	Analog zum Druckdialog kann ein Bereich für die Ausfertigungen angegeben werden.

Ein Beispiel hierfür wäre die Verwendung von "PDF;Export.PageIndexRange=2-3" und "PDF.FontMode=1". Damit werden lediglich die Seiten 2 und 3 in das erzeugte PDF aufgenommen. Darüber hinaus werden alle TrueType-Schriftarten in das PDF eingebettet.

// Existierende Vorschaudatei auf dem System öffnen
PreviewFile previewFile = new PreviewFile(@"C:\preview.ll");

// Vorschaudatei mit den folgenden Optionen nach PDF konvertieren:
// - aber nur Seite 2-3
// - TrueType-Schriftarten einbetten
previewFile.ConvertTo(@"C:\preview.pdf","PDF;Export.PageIndexRange=2-3;PDF.FontMode=1");

// Vorschaudatei schließen und freigeben
previewFile.Close();
previewFile.Dispose();

' Existierende Vorschaudatei auf dem System öffnen
Dim previewFile As New PreviewFile("C:\preview.ll")

' Vorschaudatei mit den folgenden Optionen nach PDF konvertieren:
' - aber nur Seite 2-3
' - TrueType-Schriftarten einbetten
previewFile.ConvertTo("C:\preview.pdf", "PDF;Export.PageIndexRange=2-3;PDF.FontMode=1")

' Vorschaudatei schließen und freigeben
previewFile.Close()
previewFile.Dispose()

Plattformen: Windows 10 (Version 21H2 - 22H2), Windows 11 (21H2 - 23H2), Windows Server 2016 - 2022
.NET: .NET Framework 4.8, .NET 6, .NET 7, .NET 8

Referenz

PreviewFile Klasse
PreviewFile Member
Overload-Liste