clipboardDataNN nicht zutreffend IE 5(Win) DOM nicht zutreffend

Das clipboardData-Objekt (auf das als Eigenschaft eines window- oder frame-Objekts zugegriffen werden kann) ist ein temporärer Container, den Skripts in IE für Windows ab Version 5 vor allem in solchen skriptgesteuerten Operationen für die Übertragung von Textdaten verwenden können, die Ausschneiden/Kopieren/Einfügen-Funktionen simulieren oder die entsprechenden Mausoperationen steuern. Hierbei legt das Skript fest, welche Daten im clipboardData-Objekt gespeichert werden (z. B. nur der Text eines Elements, der gesamte HTML-Inhalt eines Elements oder die URL eines Bildes). Angenommen, in einer für Kinder konzipierten Seite werden einfache Bildsymbole angezeigt, die verschiedene Tiere darstellen. Beginnt der Benutzer, das Hundsymbol mit der Maus zu ziehen, so speichert das durch die onDragStart-Ereignisbehandlungsroutine des img-Elements aufgerufene Skript einen benutzerdefinierten Attributwert dieses Elements (etwa die URL eines niedlichen Hundefotos) im clipboardData-Objekt. Wenn der Benutzer das Symbol auf dem angegebenen Bereich ablegt, liest die Funktion der onDrop-Ereignisbehandlungsroutine die Daten des clipboardData-Objekts und lädt das entsprechende Foto an dieser Position in die Seite.

 

Die in diesem Objekt gespeicherten Daten bleiben erhalten, wenn der Benutzer zu anderen Seiten innerhalb derselben Domäne navigiert, die durch dasselbe Protokoll gesteuert werden. Daher können Sie dieses Objekt auch verwenden, um Textdaten (einschließlich von der Array.join( )-Methode in Zeichenfolgen umgewandelte Arrays) ohne den Einsatz von Cookies oder location.search-Strings von einer Seite an eine andere zu übergeben. Aus Sicherheitsgründen wird hierbei nicht auf die Zwischenablage zugegriffen.

 

Weitere Informationen zum Übertragen von Daten über dieses Objekt und das event.dataTransfer-Objekt finden Sie unter http://msdn.microsoft.com/workshop/author/datatransfer/overview.asp.

 
HTML-Äquivalent

Keines.

 
Objektmodellreferenz
 
[window.]clipboardData
 
Objektspezifische Eigenschaften
 
dropEffecteffectAllowed
 
Objektspezifische Methoden
 
clearData( )getData( )setData( )
 
Objektspezifische Ereignisbehandlungsroutineneigenschaften

Keine.

dropEffect, effectAllowedNN nicht zutreffend IE 5(Win) DOM nicht zutreffend

Lesen/Schreiben

Diese beiden Eigenschaften erbt das clipboardData-Objekt vom dataTransfer-Objekt, zu dem sie ursprünglich gehören. Sie können diese Eigenschaften beim clipboardData-Objekt ignorieren.

clearData( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

clearData([dataFormat])

Entfernt Daten aus dem clipboardData-Objekt.

 
Parameter
 
  • Eine optionale Zeichenfolge, die nur ein einziges Format für die zu entfernenden Daten angibt. Das Vorhaben, Unterstützung für mehrere Datentypen hinzuzufügen, wurde offensichtlich fallen gelassen. Bei IE 6 funktioniert einzig das Format Text zuverlässig. Wenn Sie diesen Parameter weglassen, werden sämtliche Daten aller Typen entfernt.
 
Zurückgegebener Wert

Keiner.

getData( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

getData(dataFormat)

Gibt eine Kopie der Daten aus dem clipboardData-Objekt zurück. Der Inhalt des clipboardData-Objekts bleibt erhalten und kann in weiteren Skriptanweisungen erneut ausgelesen werden.

 
Parameter
 
  • Eine Zeichenfolge, die das Format der zu lesenden Daten angibt. Das Vorhaben, Unterstützung für mehrere Datentypen hinzuzufügen, wurde offensichtlich fallen gelassen. Bei IE 6 funktioniert einzig das Format Text zuverlässig.
 
Zurückgegebener Wert

Zeichenfolge.

setData( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

setData(dataFormat, stringData)

Speichert Zeichenfolgendaten im clipboardData-Objekt. Gibt den Booleschen Wert true zurück, wenn die Zuweisung erfolgreich war.

 
Parameter
 
  • Eine Zeichenfolge, die das Format der zu lesenden Daten angibt. Das Vorhaben, Unterstützung für mehrere Datentypen hinzuzufügen, wurde offensichtlich fallen gelassen. Bei IE 6 funktioniert einzig das Format Text zuverlässig. Die Methode akzeptiert zwar auch das Format URL, ein in diesem Format gesetzter Wert kann jedoch nicht gelesen werden.
  • Eine beliebige Zeichenfolge, die auch HTML-Tags enthalten kann.
 
Zurückgegebener Wert

Boolescher Wert: true | false.