setClipboardViewer 函式 (winuser.h)

將指定的視窗新增至剪貼簿查看器鏈結。每當剪貼簿的內容變更時，剪貼簿查看器視窗就會收到 WM_DRAWCLIPBOARD 訊息。此函式用於與舊版 Windows 的回溯相容性。

語法

HWND SetClipboardViewer(
  [in] HWND hWndNewViewer
);

[in] hWndNewViewer

類型： HWND

要新增至剪貼簿鏈結之視窗的句柄。

類型： HWND

如果函式成功，傳回值會識別剪貼簿查看器鏈結中的下一個視窗。如果發生錯誤，或剪貼簿查看器鏈結中沒有其他視窗，則傳回值為 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

屬於剪貼簿查看器鏈結的視窗，稱為剪貼簿查看器視窗，必須處理剪貼簿訊息 WM_CHANGECBCHAIN 和 WM_DRAWCLIPBOARD。每個剪貼簿查看器視窗都會呼叫 SendMessage 函式，將這些訊息傳遞給剪貼簿查看器鏈結中的下一個視窗。

剪貼簿查看器視窗最終必須藉由呼叫 ChangeClipboardChain 函式，從剪貼簿查看器鏈中移除本身，例如，回應 WM_DESTROY 訊息。

SetClipboardViewer 函式存在，以提供與舊版 Windows 的回溯相容性。無法正確處理剪貼簿鏈結訊息的應用程式可能會中斷剪貼簿查看器鏈結。新的應用程式應該使用更健全的技術，例如剪貼簿序號或剪貼簿格式接聽程序的註冊。如需這些替代技術的詳細資訊，請參閱監視剪貼簿內容。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-misc-l1-5-1 (於 Windows 10 10.0.14393 版)