Функция OpenClipboard (winuser.h)
Открывает буфер обмена для проверки и запрещает другим приложениям изменять содержимое буфера обмена.
Синтаксис
BOOL OpenClipboard(
[in, optional] HWND hWndNewOwner
);
Параметры
[in, optional] hWndNewOwner
Тип: HWND
Дескриптор окна, связанного с открытым буфером обмена. Если этот параметр имеет значение NULL, открытый буфер обмена связан с текущей задачей.
Возвращаемое значение
Тип: BOOL
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
OpenClipboard завершается сбоем, если в другом окне открыт буфер обмена.
Приложение должно вызывать функцию CloseClipboard после каждого успешного вызова OpenClipboard.
Окно, определенное параметром hWndNewOwner , не становится владельцем буфера обмена, если не будет вызвана функция EmptyClipboard .
Если приложение вызывает OpenClipboard с параметром hwnd со значением NULL, EmptyClipboard устанавливает для владельца буфера обмена значение NULL; это приводит к сбою SetClipboardData .
Примеры
Пример см. в разделе Копирование данных в буфер обмена.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Набор API | ext-ms-win-ntuser-misc-l1-2-0 (представлено в Windows 8.1) |
См. также раздел
Основные понятия
Справочные материалы