Ü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_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_move¶
att_move verschiebt eine Datei in ein Anderes Verzeichnis.
-
bool = att_move(atts, name, path)
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. |
Siehe auch
id-686295