GetClipboardData 函式 (winuser.h)
以指定的格式從剪貼簿擷取資料。 剪貼簿先前必須已開啟。
語法
HANDLE GetClipboardData(
[in] UINT uFormat
);
參數
[in] uFormat
類型: UINT
剪貼簿格式。 如需標準剪貼簿格式的描述,請參閱 標準剪貼簿格式。
傳回值
類型: HANDLE
如果函式成功,則傳回值是指定格式之剪貼簿物件的控制碼。
如果函式失敗,則傳回值為 Null。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
謹慎 剪貼簿資料不受信任。 先仔細剖析資料,再在您的應用程式中使用它。
剪貼簿會控制 GetClipboardData 函式傳回的控制碼,而不是應用程式。 應用程式應該立即複製資料。 應用程式不得釋放控制碼,也不會將其鎖定。 呼叫EmptyClipboard 或 CloseClipboard函式之後,或呼叫 SetClipboardData函式之後,應用程式不得使用相同的剪貼簿格式使用控制碼。
當應用程式呼叫 GetClipboardData 函式時,系統會在特定剪貼簿格式之間執行隱含的資料格式轉換。 例如,如果 CF_OEMTEXT 格式位於剪貼簿上,則視窗可以擷取 CF_TEXT 格式的資料。 剪貼簿上的格式會視需要轉換成要求的格式。 如需詳細資訊,請參閱 合成剪貼簿格式。
範例
如需範例,請參閱 將資訊複製到剪貼簿。
規格需求
最低支援的用戶端 | 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) |
另請參閱
概念
參考