Überblick Anhänge

Anhänge (Attachments) sind Dateien, die in der UniPlot-Datei gespeichert werden, ähnlich wie Anhänge bei E-Mails. Die Dateien können in UniPlot eingebettet werden oder es kann nur eine Referenz auf die Datei gehalten werden.

Attachments können z. B. verwendet werden um Image-Dateien (png, jpg, bmp, …) im laufenden Text auszugeben, Script-Dateien, Text-, Excel- oder PDF-Dateien einer ipz-Datei zuzufügen. Mit dem Befehl Bearbeiten=>Attachments können Attachments zugefügt oder entfernt werden.

Attachments können nur bei IPZ Dateiformat verwendet werden und nicht bei IPW-Dateien.

att_open

att_open öffnet die Anhänge (Attachments) eines Dokuments oder einer externen Attachment-Datei.

atts = att_open(hDoc)
atts = att_open(ssAttachmentFilename)

Beispiel

a = att_open("d:/test.ipz");
att_dir(a, "*.jpg");
att_close(a)
a = att_open("d:/test.ipz");
a.dir("*.jpg");
a.close()
// att_close(a)

att_close

att_close schliesst die Attachments. Bevor ein Dokument gespeichert werden kann, müssen die Attachments geschlossen werden.

Falls der atts-Pointer auf 0 gesetzt wird (atts = 0) oder er eine lokale Variable ist und die Funktion verlassen wird, wird att_close automatisch aufgerufen.

bool = att_close(atts)

att_add_file

att_add_file kopiert eine Datei von der Festplatte in die Attachments. Falls bLink TRUE ist, wird nur eine Verknüpfung zu der Datei erzeugt. ret ist TRUE (1) oder ein error-Objekt (siehe error_create).

ret = att_add_file(atts, ssFile, name)
ret = att_add_file(atts, ssFile, name, bLink)

att_add_data

att_add_data

bool = att_add_data(atts, ssData, name)

att_get_data

att_get_data

ssData = att_get_data(atts, name)

att_get_props

att_get_props liefert die Name/Wert-Pärchen zu der Datei name.

Die folgenden vier Namen sollten vorhanden sein:

Name Wert
Path Der vollständige Pfad der Datei auf der Festplatte: Z. B. "C:\\Images\\Test.png".
Link "0": Datei ist eingebettet. "1": Datei ist verknüpft.
FileSize Anzahl an Bytes (als String).
FileTime String der Form: "%Y-%m-%d %H:%M:%S", siehe DT_Format. Beispiel: "2017-04-27 10:43:13,45".
oProps = att_get_props(atts, name)

att_set_props

att_set_props

bool = att_set_props(atts, name, oProps)

att_dir

att_dir

svDir = att_dir(atts)
svDir = att_dir(atts, ssPattern)

att_rename

att_rename nennt eine Datei um.

bool = att_rename(atts, name, new_name)

att_move

att_move verschiebt eine Datei in ein Anderes Verzeichnis.

bool = att_move(atts, name, path)

att_delete

att_delete löscht eine Datei.

bool = att_delete(atts, name)

att_export

att_export speichert die angegebenen Dateien in einem Verzeichnis auf der Festplatte.

bool = att_export(atts, svNames, ssPath [, options])
options = [. flat = 1, bFailIfExists = 1, bWriteEvent = 1]

att_save

att_save speichert die angegebenen Dateien in einer Attachment-Datei oder IPZ-Datei.

bool = att_save(atts, svNames, ssAttachFile, bOverwrite)

att_load

att_load kopiert Anhänge aus der Attachment-Datei attsSource in die geöffnete Datei. Wenn bOverwrite gleich TRUE ist (Default ist FALSE) werden vorhandene Anhänge mit gleichem Namen überschrieben, sonst ignoriert.

bool = att_load(atts, svNames, attsSource)
bool = att_load(atts, svNames, attsSource, bOverwrite)

Beispiel

a = att_open(hDoc);
aSrc = att_open("d:/test.ipz");
svNames = aSrc.dir("*.jpg");
a.load(svNames, aSrc);
a = aSrc = 0; // close

att_dialog

att_dialog zeigt den Attachment-Dialog an.

bool = att_dialog(atts)
bool = att_dialog(atts, ssPattern)

Beispiel

def test_attachments()
{
}

Kommentar

History

Version Beschreibung
R2017 Neu.

id-686295