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 版) |
另請參閱
概念
參考