Bezeichnung
xad.ExtractFile -- entpackt die Datei aus dem xad-Archiv
Übersicht
xad.ExtractFile(id, idx, dst$[, table])
Beschreibung
Dieser Befehl kann verwendet werden, um die Datei im Index idx innerhalb des durch id angegebenen xad-Archivs in die externe Datei zu entpacken, die in dst$ angegeben wird. Wenn dst$ bereits existiert, wird es überschrieben. Mit dem optionalen Tabellenargument table können Sie weitere Optionen für die Operation angeben.

Die folgenden Tags werden derzeit im optionalen Argument table erkannt:

Password:
Wenn die Datei, die Sie entpacken möchten, durch ein Passwort geschützt ist, müssen Sie dieses Passwort hier angeben. Wenn Sie diesen Tag nicht angeben, wird das mit xad.SetDefaultPassword() festgelegte Standardpasswort verwendet.

Callback:
Mit diesem Tag können Sie eine Funktion übergeben, die von Zeit zu Zeit aufgerufen wird. Dies kann nützlich sein, wenn Sie eine Statusleiste oder etwas anzeigen möchten, während die xad-Datei entpackt wird. Die Funktion erhält eine Tabelle als einziges Argument. In der Tabelle werden folgende Felder initialisiert:

Action:
Enthält die Zeichenkette "ExtractFile".

ID:
Enthält die ID des XAD-Archivs.

Progress:
Enthält einen Wert zwischen 0 und 100, der angibt, wie viel Prozent der Arbeit bereits erledigt wurde.

UserData:
Enthält den Wert, den Sie im Argument UserData übergeben haben (siehe unten).

Sie können auch Benutzerdaten, die an Ihrer Callback-Funktion weitergeleitet werden sollen, mit dem Tag unten verwenden.

UserData:
Dieser Tag kann auf beliebige Daten festgelegt werden, die an die Callback-Funktion übergeben werden sollen, den Sie im Tag Callback übergeben haben. Wenn Sie diesen ohne den Tag Callback angeben, wird der Tag UserData einfach ignoriert.

Eingaben
id
ID des zu verwendenden XAD-Archivs
idx
Index der zu entpackenden Datei
dst$
gewünschte Zieldatei
table
optional: Tabelle mit weiteren Parametern

Navigation zeigen