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)

另請參閱

剪貼簿

CloseClipboard

概念

EmptyClipboard

參考