.. highlightlang:: us

.. index:: Anhänge, Attachments

.. _attachments-overview:
.. _attachments:

Ü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 :ref:`edit-attachments` können
Attachments zugefügt oder entfernt werden.

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

.. ------------------------------------------------------------------------------

.. index:: att_open

.. _att_open:

att_open
--------------

.. us.tag att_open NOTREADYGERMAN New5900 attachments

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

.. function:: atts = att_open(hDoc)
              atts = att_open(ssAttachmentFilename)

.. us.example

**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)

.. ------------------------------------------------------------------------------

.. index:: att_close

.. _att_close:

att_close
--------------

.. us.tag  att_close NOTREADYGERMAN New5900 attachments

:ref:`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 :ref:`att_close` automatisch
aufgerufen.

.. function:: bool = att_close(atts)

.. ------------------------------------------------------------------------------

.. index:: att_add_file

.. _att_add_file:

att_add_file
-----------------------

.. us.tag  att_add_file NOTREADYGERMAN New5900 attachments

:ref:`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 :ref:`error_create`).

.. function:: ret = att_add_file(atts, ssFile, name)
              ret = att_add_file(atts, ssFile, name, bLink)

.. ------------------------------------------------------------------------------

.. index:: att_add_data

.. _att_add_data:

att_add_data
-----------------------

.. us.tag  att_add_data NOTREADYGERMAN New5900 attachments

:ref:`att_add_data`

.. function:: bool = att_add_data(atts, ssData, name)

.. ------------------------------------------------------------------------------

.. index:: att_get_data

.. _att_get_data:

att_get_data
-----------------------

.. us.tag  att_get_data NOTREADYGERMAN New5900 attachments

:ref:`att_get_data`

.. function:: ssData = att_get_data(atts, name)

.. ------------------------------------------------------------------------------

.. index:: att_get_props

.. _att_get_props:

att_get_props
-----------------------

.. us.tag  att_get_props NOTREADYGERMAN New5900 attachments

:ref:`att_get_props` liefert die Name/Wert-Pärchen zu der Datei *name*.

Die folgenden vier Namen sollten vorhanden sein:

.. list-table::
   :header-rows: 1

   * - 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 :ref:`DT_Format`. Beispiel:
       ``"2017-04-27 10:43:13,45"``.

.. function:: oProps = att_get_props(atts, name)

.. ------------------------------------------------------------------------------

.. index:: att_set_props

.. _att_set_props:

att_set_props
-----------------------

.. us.tag  att_set_props NOTREADYGERMAN New5900 attachments

:ref:`att_set_props`

.. function:: bool = att_set_props(atts, name, oProps)

.. ------------------------------------------------------------------------------

.. index:: att_dir

.. _att_dir:

att_dir
-----------------------

.. us.tag  att_dir NOTREADYGERMAN New5900 attachments

:ref:`att_dir`

.. function:: svDir = att_dir(atts)
              svDir = att_dir(atts, ssPattern)

.. ------------------------------------------------------------------------------

.. index:: att_rename

.. _att_rename:

att_rename
-----------------------

.. us.tag  att_rename NOTREADYGERMAN New5900 attachments

:ref:`att_rename` nennt eine Datei um.

.. function:: bool = att_rename(atts, name, new_name)

.. ------------------------------------------------------------------------------

.. index:: att_move

.. _att_move:

att_move
-----------------------

.. us.tag  att_move NOTREADYGERMAN New5900 attachments

:ref:`att_move` verschiebt eine Datei in ein Anderes Verzeichnis.

.. function:: bool = att_move(atts, name, path)

.. ------------------------------------------------------------------------------

.. index:: att_delete

.. _att_delete:

att_delete
-----------------------

.. us.tag  att_delete NOTREADYGERMAN New5900 attachments

:ref:`att_delete` löscht eine Datei.

.. function:: bool = att_delete(atts, name)

.. ------------------------------------------------------------------------------

.. index:: att_export

.. _att_export:

att_export
-----------------------

.. us.tag  att_export NOTREADYGERMAN New5900 attachments

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

.. function:: bool = att_export(atts, svNames, ssPath [, options])

::

   options = [. flat = 1, bFailIfExists = 1, bWriteEvent = 1]

.. ------------------------------------------------------------------------------

.. index:: att_save

.. _att_save:

att_save
-----------------------

.. us.tag  att_save NOTREADYGERMAN New5900 attachments

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

.. function:: bool = att_save(atts, svNames, ssAttachFile, bOverwrite)

.. ------------------------------------------------------------------------------

.. index:: att_load

.. _att_load:

att_load
-----------------------

.. us.tag  att_load NOTREADYGERMAN New5900 attachments

:ref:`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.

.. function:: bool = att_load(atts, svNames, attsSource)
              bool = att_load(atts, svNames, attsSource, bOverwrite)

.. us.example

**Beispiel**

::

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

.. ------------------------------------------------------------------------------

.. index:: att_dialog

.. _att_dialog:

att_dialog
-----------------------

.. us.tag  att_dialog NOTREADYGERMAN New5900 attachments

:ref:`att_dialog` zeigt den Attachment-Dialog an.

.. function:: bool = att_dialog(atts)
              bool = att_dialog(atts, ssPattern)

.. ------------------------------------------------------------------------------

.. us.example

**Beispiel**

::

   def test_attachments()
   {
   }

.. us.comment

**Kommentar**

...

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2017
     - Neu.

.. seealso::
   :ref:`overview-documents`

:sub:`id-686295`