idx = zip.AddFile(id, f$[, table])

Die folgenden Tags werden derzeit vom optionalen Argument table erkannt:

NewName:

Mit diesem Tag können Sie diese Datei unter einem neuen Namen im Zip-Archiv speichern. Wenn Sie die Datei in einem Unterverzeichnis im ZIP-Archiv speichern möchten, müssen Sie auch diesen Tag verwenden und den Namen des/der Unterverzeichnisse(s) in NewName angeben. Wenn NewName weggelassen wird, wird die Datei immer im Stammverzeichnis des Zip-Archivs gespeichert.

Encryption:

Mit diesem Tag können Sie die gewünschte Verschlüsselungsmethode für die Datei festlegen. Es kann auf eine der folgenden speziellen Konstanten eingestellt werden:

#ZIP_EM_NONE:

Keine Verschlüsselung. Dies ist der Standardwert.

#ZIP_EM_AES_128:

Winzip AES-128-Verschlüsselung.

#ZIP_EM_AES_192:

Winzip AES-192-Verschlüsselung.

#ZIP_EM_AES_256:

Winzip AES-256-Verschlüsselung.

Wenn Sie den Tag Encryption angeben, müssen Sie auch ein Passwort im Tag Password angeben (siehe unten), das zum Entschlüsseln der Datei benötigt wird. Wenn Sie den Tag Password nicht verwenden, wird das mit zip.SetDefaultPassword() festgelegte Standard-Passwort verwendet.

Password:

Wenn der Tag Encryption auf einen anderen Wert als #ZIP_EM_NONE gesetzt wurde (siehe oben), kann dieser Tag auf ein Passwort gesetzt werden, welches zum Schutz der Datei verwendet werden soll. Wenn Sie diesen Tag nicht angeben, wird das mit zip.SetDefaultPassword() festgelegte Standard-Passwort verwendet.

Compression:

Mit diesem Tag kann die gewünschte Komprimierungsmethode für die Datei festgelegt werden. Die folgenden Komprimierungsmethoden werden derzeit unterstützt:

#ZIP_CM_DEFAULT:

Dies ist die Standardeinstellung. Derzeit identisch mit #ZIP_CM_DEFLATE.

#ZIP_CM_STORE:

Die Datei unkomprimiert speichern.

#ZIP_CM_BZIP2:

Die Datei mit dem bzip2-Algorithmus komprimieren.

#ZIP_CM_DEFLATE:

Die Datei mit dem zlib-Algorithmus und den Standardoptionen komprimieren.

Beachten Sie, dass nur #ZIP_CM_DEFLATE und #ZIP_CM_STORE als universell unterstützt gelten.

Wenn Sie diesen Tag angeben, können Sie auch den Tag CompressionFlags übergeben, um die Komprimierungsstufe festzulegen (siehe unten).

CompressionFlags:

Mit diesem Tag kann die Komprimierungsstufe definiert werden. Sie geht von 1 für die schnellste Komprimierung bis 9 für die höchste Komprimierung. Sie können auch 0 übergeben, um die Standardeinstellungen des Komprimierers zu verwenden. Der Standardwert ist 0.

Comment:

Mit diesem Tag kann die Datei dem Zip-Archiv mit einem angehängten Kommentar hinzugefügt werden.

Time:

Mit diesem Tag kann der Datumsstempel der Datei geändert werden. Standardmäßig wird der Datumsstempel aus der in f$ angegebenen Datei genommen. Wenn Sie der Datei einen anderen Datumsstempel zuweisen möchten, müssen Sie diesem Tag eine Zeichenkette im Standard-Hollywood-Datumsformat von dd-mmm-yyyy hh:mm:ss übergeben.

Encoding:

Mit diesem Tag kann die Zeichensatzcodierung eingestellt werden, die beim Speichern des Verzeichnisnamens verwendet werden soll. Dies kann eine der folgenden speziellen Konstanten sein:

#ZIP_FL_ENC_UTF_8:

Verwendet die UTF-8-Codierung. Dies ist die Standardeinstellung.

#ZIP_FL_ENC_CP437:

Verwendet die Codepage 437-Codierung. Da dies die Standardcodierung unter MS-DOS war, war es auch die Standardcodierung des ursprünglichen Zip-Formats. Wenn Sie also maximale Kompatibilität benötigen, können Sie diese Codierung verwenden. Aber denken Sie daran, dass sie nur westliche Zeichen speichern kann.

(V1.2)

Beachten Sie, dass dieser Befehl nicht sofort beginnt, die Datei zu komprimieren und in das Zip-Archiv zu schreiben. Stattdessen wird die Datei nur in eine interne Liste eingefügt und das Komprimieren und Schreiben erfolgt, sobald Sie zip.CloseArchive() aufrufen. Das bedeutet, dass Sie sicherstellen müssen, dass die in f$ angegebene Datei noch verfügbar ist, wenn Sie zip.CloseArchive() aufrufen. Beachten Sie deshalb, dass wenn Sie den Namen einer temporären Datei an f$ übergeben, Sie diese temporäre Datei nicht löschen, bevor Sie zip.CloseArchive() aufrufen.

id

Identifikator des zu verwendenden Zip-Archivs

f$

Pfad zu einer Datei, die dem ZIP-Archiv hinzugefügt werden soll

table

Optional: Tabelle mit weiteren Optionen (siehe oben)

idx

Index der neu hinzugefügten Datei im ZIP-Archiv