.. highlightlang:: us

.. _clipboard_get_data:

clipboard_get_data
==================

.. index:: clipboard_get_data

.. us.tag  clipboard_get_data NOTREADYGERMAN clipboard New590

:ref:`clipboard_get_data` liefert die Daten aus der Zwischenablage als Zeichenkette. 
Die Zeichenkette kann Null-Zeichen enthalten.

.. function::  data = clipboard_get_data(iFormat)
    data = clipboard_get_data(ssName)

.. us.return

**Returnwert**

*data* enthält die Daten aus der Zwischenablage als UniScript-Zeichenkette in 
kompakter Form, das heißt 2 Bytes aus der Zwischenablage werden in ein 
UniScript-Zeichen geschrieben.

.. us.params

**Parameter**

.. uparam:: iFormat

   *iFormat* ist die Format-Nummer.

.. uparam:: ssName

   *ssName* ist der Formatname.

.. us.example

**Beispiel**

::

   // Werden im Explorer Dateien in die Zwischenablage kopiert
   // wird ein CF_HDROP-Format in die Zwichenablage geschrieben
   // Es besteht aus einem Header, gefolgt von den Dateinamen, die 
   // durch 0-Zeichen getrennt werden. Am Ende befinden sich zwei
   // 0-Zeichen
   def test_hdrop()
   {
       s = clipboard_get_data("CF_HDROP");
       nBytes = mem_len(s);
       if (nBytes == 0) {
           error("CF_HDROP not available");
       }
       // Der erste Integer gibt einen Offset an 
       // an dem die Dateinamen beginnen
       offset = mem_get(s, 1, "uint32", 1);
       v = mem_get(s, offset+1, "wchar_t", (nBytes-offset)/2);
       idx = find(v == 0);
       start = 1;
       nNames = len(idx)-1;
       sv = strempty(nNames, 1);
       for (i in 1:len(idx)-1) {
           sv[i] = strchar(v[start:idx[i]-1])
           start = idx[i] + 1;
       }
       return sv;
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.9
     - Neu.

.. seealso::
   :ref:`uberblick-zwischenablage`,
   :ref:`mem_len`,
   :ref:`mem_get`,
   :ref:`strchar`

:sub:`id-1931826`