combit List & Label - Programmierer-Referenz - combit GmbH

7.1.9. Arbeiten mit Vorschau-Dateien
Arbeiten mit der .NET Komponente
Die List & Label Storage-API erlaubt den Zugriff auf die LL-Vorschaudateien. Sie können
allgemeine Informationen oder die einzelnen Seiten abfragen, mehrere Dateien zusammenfügen
und Benutzerdaten abspeichern. Die Möglichkeiten der API werden bei der
.NET Komponente über zwei Klassen PreviewFile und PreviewPage abgebildet, die jeweils
eine gesamte Vorschaudatei beziehungsweise eine einzelne Seite aus einer Datei
repräsentieren.
7.1.9.1. Aufruf einer Vorschaudatei
Sie können dem Konstruktor der Klasse PreviewFile den Dateinamen der zu öffnenden
Vorschaudatei übergeben. Über eine ganze Reihe von Eigenschaften stehen nun allgemeine
Informationen über die Datei zur Verfügung.
Eigenschaft Datentyp Beschreibung
Handle IntPtr Handle auf die Vorschaudatei
FileVersion int Version der Datei
APIVersion Int Version der API
Units LlUnits Bei der Erstellung verwendete Maßeinheit
PrinterCount int Anzahl der hinterlegten Drucker
BoxType int Typ des anzuzeigenden Fortschrittdialogs
Filename string Dateiname
Count int Anzahl der Seiten
Beispiel:
PreviewFile sf = new PreviewFile("c:\\test.ll");
int PageCount = sf.Count;
...
Über die Methode Close kann eine geöffnete Datei geschlossen werden. Soll diese
gelöscht werden, verwenden Sie die Methode DeleteFiles. Selbstverständlich können
Sie die Datei auch auf dem Drucker ausgeben. Einige Überladungen der Methode Print
erlauben die Angabe eines oder mehrerer Drucker sowie eines Seitenbereichs, der gedruckt
werden soll.
7.1.9.2. Zusammenführen mehrer Vorschaudateien
Sie können mehrere Vorschaudateien zusammenführen. Hierzu müssen Sie zunächst die
Zieldatei öffnen. Da ein schreibender Zugriff notwendig ist, müssen Sie für den zweiten
Parameter ReadOnly false übergeben. Anschließend können Sie den Dateinamen der
anzuhängenden Datei der Methode Append übergeben. Alternativ können Sie auch ein
Handle auf eine Vorschaudatei im Speicher oder eine andere Instanz der PreviewFile
zuweisen.
89