clipboardData | NN 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 | |||
|
|||
Objektspezifische Methoden | |||
|
|||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | |||
Keine. |
dropEffect, effectAllowed | NN 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 | |
|
|
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 | |
|
|
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 | |
|
|
Zurückgegebener Wert | |
Boolescher Wert: true | false. |