openClipboard 函式 (winuser.h)
開啟剪貼簿以供檢查,並防止其他應用程式修改剪貼簿內容。
語法
BOOL OpenClipboard(
[in, optional] HWND hWndNewOwner
);
參數
[in, optional] hWndNewOwner
類型: HWND
要與開啟剪貼簿相關聯的視窗句柄。 如果此參數為 NULL,則開啟的剪貼簿會與目前的工作相關聯。
傳回值
類型: BOOL
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
如果另一個視窗已開啟剪貼簿,OpenClipboard 就會失敗。
應用程式應該在每次成功呼叫 OpenClipboard 之後呼叫 CloseClipboard 函式。
除非呼叫 EmptyClipboard 函式,否則 hWndNewOwner 參數所識別的視窗不會成為剪貼簿擁有者。
如果應用程式呼叫 OpenClipboard 並將 hwnd 設定為 NULL,EmptyClipboard 會將剪貼簿擁有者設定為 NULL; 這會導致 SetClipboardData 失敗。
範例
如需範例,請參閱 將資訊複製到剪貼簿。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-misc-l1-2-0 (於 Windows 8.1) |
另請參閱
概念
參考