Zwischenablage

Die Zwischenablage ist eine Reihe von Funktionen und Meldungen, mit denen Anwendungen Daten übertragen können. Da alle Anwendungen Zugriff auf die Zwischenablage haben, können Daten problemlos zwischen Anwendungen oder innerhalb einer Anwendung übertragen werden.

In dieser Übersicht wird nicht beschrieben, wie verknüpfte oder eingebettete Objekte kopiert und eingefügt werden. Informationen zu diesen Themen finden Sie in der Com-Dokumentation (Component Object Model).

In diesem Abschnitt

Die folgenden Themen enthalten Informationen zur Zwischenablage, Zwischenablageformaten, Zwischenablagevorgängen und Zwischenablagemeldungen. Die API-Referenz enthält die Funktionen und Meldungen, die Sie zum Arbeiten mit der Zwischenablage verwenden können.

Name	Beschreibung
Über die Zwischenablage	Erläutert die Zwischenablage.
Zwischenablageformate	Erläutert die Formate der Zwischenablage. Ein Fenster kann mehrere Objekte in der Zwischenablage platzieren, die jeweils dieselben Informationen in einem anderen Zwischenablageformat darstellen. Benutzer müssen sich nicht über die Formate der Zwischenablage in der Zwischenablage bewusst sein, die für ein Objekt in der Zwischenablage verwendet werden.
Zwischenablagevorgänge	Erläutert Zwischenablagevorgänge. Ein Fenster sollte beim Ausschneiden, Kopieren oder Einfügen von Daten die Zwischenablage verwenden. In einem Fenster werden Daten für Ausschneiden- und Kopiervorgänge in der Zwischenablage platziert und Daten aus der Zwischenablage für Einfügevorgänge abgerufen.
HTML-Zwischenablageformat	Erläutert das HTML-Zwischenablageformat.
Verwenden der Zwischenablage	Ein Anzeigefenster der Zwischenablage zeigt den aktuellen Inhalt der Zwischenablage an und empfängt Nachrichten, wenn sich der Inhalt der Zwischenablage ändert.
Zwischenablagereferenz	Enthält den API-Verweis.

Zwischenablagefunktionen

In der folgenden Tabelle sind die Funktionen aufgeführt, mit denen Sie die Zwischenablage nutzen können:

Name	Beschreibung
AddClipboardFormatListener	Platziert das angegebene Fenster in der Listenerliste des vom System verwalteten Zwischenablageformats.
ChangeClipboardChain	Entfernt ein angegebenes Fenster aus der Kette der Zwischenablageanzeigen.
CloseClipboard	Schließt die Zwischenablage.
CountClipboardFormats	Ruft die Anzahl der verschiedenen Datenformate ab, die sich derzeit in der Zwischenablage befinden.
EmptyClipboard	Leert die Zwischenablage und gibt Daten in der Zwischenablage frei. Die Funktion weist dann dem Fenster, in dem die Zwischenablage geöffnet ist, den Besitz der Zwischenablage zu.
EnumClipboardFormats	Listet die derzeit in der Zwischenablage verfügbaren Datenformate auf. Datenformate der Zwischenablage werden in einer sortierten Liste gespeichert. Zum Aufzählen von Datenformaten in der Zwischenablage rufen Sie die Funktion EnumClipboardFormats mehrmals auf. Für jeden Aufruf gibt das Format Parameter ein verfügbares Zwischenablageformat an, und die Funktion gibt das nächste verfügbare Zwischenablageformat zurück.
GetClipboardData	Ruft Daten aus der Zwischenablage in einem angegebenen Format ab. Die Zwischenablage muss zuvor geöffnet worden sein.
GetClipboardFormatName	Ruft aus der Zwischenablage den Namen des angegebenen registrierten Formats ab. Die Funktion kopiert den Namen in den angegebenen Puffer.
GetClipboardOwner	Ruft das Fensterhandle des aktuellen Besitzers der Zwischenablage ab.
GetClipboardSequenceNumber	Ruft die Sequenznummer der Zwischenablage für die aktuelle Fensterstation ab.
GetClipboardViewer	Ruft das Handle zum ersten Fenster in der Zwischenablageanzeigekette ab.
GetOpenClipboardWindow	Ruft das Handle für das Fenster ab, in dem derzeit die Zwischenablage geöffnet ist.
GetPriorityClipboardFormat	Ruft das erste verfügbare Zwischenablageformat in der angegebenen Liste ab.
GetUpdatedClipboardFormats	Ruft die derzeit unterstützten Formate der Zwischenablage ab.
IsClipboardFormatAvailable	Bestimmt, ob die Zwischenablage Daten im angegebenen Format enthält.
OpenClipboard	Öffnet die Zwischenablage zur Prüfung und verhindert, dass andere Anwendungen den Inhalt der Zwischenablage ändern.
RegisterClipboardFormat	Registriert ein neues Zwischenablageformat. Dieses Format kann dann als gültiges Zwischenablageformat verwendet werden.
RemoveClipboardFormatListener	Entfernt das angegebene Fenster aus der Listenerliste des vom System verwalteten Zwischenablageformats.
SetClipboardData	Platziert Daten in der Zwischenablage in einem angegebenen Zwischenablageformat. Das Fenster muss der aktuelle Besitzer der Zwischenablage sein, und die Anwendung muss die „OpenClipboard“-Funktion aufgerufen haben. (Beim Antworten auf die WM_RENDERFORMAT Nachricht darf der Zwischenablagebesitzer openClipboard nicht aufrufen, bevor SetClipboardData aufgerufen wird.)
SetClipboardViewer	Fügt das angegebene Fenster zur Kette der Zwischenablageanzeigen hinzu. Fenster der Zwischenablageanzeige erhalten eine WM_DRAWCLIPBOARD Nachricht, wenn sich der Inhalt der Zwischenablage ändert.

Nachrichten aus der Zwischenablage

In der folgenden Tabelle sind die Nachrichten aufgeführt, die an die Anzeigefenster der Zwischenablage gesendet werden:

Name	Beschreibung
WM_CLEAR	Wird an ein Bearbeitungssteuerelement oder Kombinationsfeld gesendet, um die aktuelle Auswahl (falls vorhanden) aus dem Bearbeitungssteuerelement zu löschen (zu löschen).
WM_COPY	Wird an ein Bearbeitungssteuerelement oder Kombinationsfeld gesendet, um die aktuelle Auswahl in die Zwischenablage im CF_TEXT Format zu kopieren.
WM_CUT	Wird an ein Bearbeitungssteuerelement oder Kombinationsfeld gesendet, um die aktuelle Auswahl (falls vorhanden) im Bearbeitungssteuerelement zu löschen und den gelöschten Text in die Zwischenablage im CF_TEXT Format zu kopieren.
WM_PASTE	Wird an ein Bearbeitungssteuerelement oder Kombinationsfeld gesendet, um den aktuellen Inhalt der Zwischenablage in das Bearbeitungssteuerelement an der aktuellen Caretposition zu kopieren. Daten werden nur eingefügt, wenn die Zwischenablage Daten im CF_TEXT Format enthält.

Benachrichtigungen für die Zwischenablage

In der folgenden Tabelle sind die Benachrichtigungen der Zwischenablage aufgeführt, die an die Fenster des Zwischenablage-Viewers gesendet werden:

Name	Beschreibung
WM_ASKCBFORMATNAME	Wird von einem Zwischenablageanzeigefenster an den Besitzer der Zwischenablage gesendet, um den Namen eines CF_OWNERDISPLAY-Zwischenablageformats anzufordern.
WM_CHANGECBCHAIN	Wird an das erste Fenster in der Viewerkette der Zwischenablage gesendet, wenn ein Fenster aus der Kette entfernt wird.
WM_CLIPBOARDUPDATE	Gesendet, wenn sich der Inhalt der Zwischenablage geändert hat.
WM_DESTROYCLIPBOARD	Wird an den Besitzer der Zwischenablage gesendet, wenn ein Aufruf der EmptyClipboard-Funktion die Zwischenablage leert.
WM_DRAWCLIPBOARD	Wird an das erste Fenster in der Viewerkette der Zwischenablage gesendet, wenn sich der Inhalt der Zwischenablage ändert. Dadurch kann ein Anzeigefenster der Zwischenablage den neuen Inhalt der Zwischenablage anzeigen.
WM_HSCROLLCLIPBOARD	Wird von einem Anzeigefenster der Zwischenablage an den Besitzer der Zwischenablage gesendet. Dies tritt auf, wenn die Zwischenablage Daten im CF_OWNERDISPLAY-Format enthält und ein Ereignis in der horizontalen Bildlaufleiste des Clipboard-Viewers auftritt. Der Besitzer sollte das Bild der Zwischenablage scrollen und die Bildlaufleistenwerte aktualisieren.
WM_PAINTCLIPBOARD	Wenn die Zwischenablage Daten im CF_OWNERDISPLAY-Format enthält und der Clientbereich des Clipboard Viewers neu gezeichnet werden muss, wird diese Information vom Clipboard Viewer-Fenster an den Besitzer der Zwischenablage gesendet.
WM_RENDERALLFORMATS	Wird vor dem Löschen an den Besitzer der Zwischenablage gesendet, wenn der Besitzer der Zwischenablage das Rendern eines oder mehrerer Zwischenablageformate verzögert hat. Damit der Inhalt der Zwischenablage für andere Anwendungen verfügbar bleibt, muss der Besitzer der Zwischenablage Daten in allen Formaten rendern, die er generieren kann, und die Daten in der Zwischenablage platzieren, indem die SetClipboardData-Funktion aufgerufen wird.
WM_RENDERFORMAT	Wird an den Besitzer der Zwischenablage gesendet, wenn das Rendern eines bestimmten Zwischenablageformats verzögert wurde und eine Anwendung Daten in diesem Format angefordert hat. Der Besitzer der Zwischenablage muss Daten im angegebenen Format rendern und in der Zwischenablage platzieren, indem die SetClipboardData-Funktion aufgerufen wird.
WM_SIZECLIPBOARD	Wird von einem Fenster der Zwischenablageanzeige an den Zwischenablagebesitzer gesendet, wenn die Zwischenablage Daten im CF_OWNERDISPLAY Format enthält und der Clientbereich des Zwischenablage-Viewers die Größe geändert hat.
WM_VSCROLLCLIPBOARD	Wird von einem Fenster der Zwischenablageanzeige an den Besitzer der Zwischenablage gesendet, wenn die Zwischenablage Daten im CF_OWNERDISPLAY Format enthält und ein Ereignis in der vertikalen Bildlaufleiste der Zwischenablageanzeige auftritt. Der Besitzer sollte das Bild der Zwischenablage scrollen und die Bildlaufleistenwerte aktualisieren.

Strukturen

In der folgenden Tabelle sind die Strukturen gelistet, die mit der Zwischenablage verwendet werden.

Name	Beschreibung
METAFILEPICT	Definiert das Metadateibildformat, das für den Austausch von Metadateidaten über die Zwischenablage verwendet wird.