Функция 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)

См. также раздел

Буфер обмена

CloseClipboard

Основные понятия

EmptyClipboard

Справочные материалы