SetClipboardViewer-Funktion (winuser.h)

Artikel
03/04/2024

Fügt das angegebene Fenster der Kette der Zwischenablageanzeigen hinzu. Zwischenablageanzeigefenster erhalten eine WM_DRAWCLIPBOARD Meldung, wenn sich der Inhalt der Zwischenablage ändert. Diese Funktion wird für die Abwärtskompatibilität mit früheren Versionen von Windows verwendet.

Syntax

HWND SetClipboardViewer(
  [in] HWND hWndNewViewer
);

Parameter

[in] hWndNewViewer

Typ: HWND

Ein Handle für das Fenster, das der Zwischenablagekette hinzugefügt werden soll.

Rückgabewert

Typ: HWND

Wenn die Funktion erfolgreich ist, identifiziert der Rückgabewert das nächste Fenster in der Zwischenablage-Viewerkette. Wenn ein Fehler auftritt oder keine anderen Fenster in der Zwischenablage-Viewerkette vorhanden sind, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Fenster, die Teil der Zwischenablageanzeigekette sind, sogenannte Zwischenablageanzeigefenster, müssen die Zwischenablagemeldungen WM_CHANGECBCHAIN und WM_DRAWCLIPBOARD verarbeiten. Jedes Zwischenablageanzeigefenster ruft die SendMessage-Funktion auf, um diese Nachrichten an das nächste Fenster in der Zwischenablage-Viewerkette zu übergeben.

Ein Zwischenablageanzeigefenster muss sich schließlich selbst aus der Zwischenablage-Viewerkette entfernen, indem die ChangeClipboardChain-Funktion aufgerufen wird , z. B. als Reaktion auf die WM_DESTROY-Nachricht .

Die SetClipboardViewer-Funktion ist vorhanden, um Abwärtskompatibilität mit früheren Versionen von Windows zu gewährleisten. Die Zwischenablage-Viewerkette kann durch eine Anwendung unterbrochen werden, die die Zwischenablagekettennachrichten nicht ordnungsgemäß verarbeitet. Neue Anwendungen sollten robustere Techniken wie die Zwischenablagesequenznummer oder die Registrierung eines Zwischenablageformatlisteners verwenden. Weitere Informationen zu diesen Alternativen finden Sie unter Überwachen von Zwischenablageinhalten.

Beispiele

Ein Beispiel finden Sie unter Hinzufügen eines Fensters zur Zwischenablageanzeigekette.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-5-1 (eingeführt in Windows 10, Version 10.0.14393)