Функция RegisterClipboardFormat

Функция RegisterClipboardFormat регистрирует новый формат буфера обмена. Этот формат может затем быть использован как допустимый формат буфера обмена.

Синтаксис

UINT RegisterClipboardFormat(      
    LPCTSTR lpszFormat
);

Параметры

lpszFormat

[in] Указатель на символьную строку с нулем в конце, которая именует новый формат.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение идентифицирует зарегистрированный формат буфера обмена.

Если функция завершается с ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.

Замечания

Если зарегистрированный формат с заданным названием уже существует, новый формат не регистрируется, а возвращаемое значение идентифицирует существующий формат. Это дает возможность копировать и вставлять данные больше чем одному приложению, используя тот же самый зарегистрированный формат буфера обмена.

Обратите внимание! на то, что сравнение названия формата происходит без учета регистра.

Зарегистрированные форматы буфера обмена идентифицируются значениями в диапазоне от 0xC000 до 0xFFFF.

Когда зарегистрированные форматы буфера обмена помещаются в буфер или извлекаются из него, они должны быть в форме значения HGLOBAL.

Windows 95/98/Me: RegisterClipboardFormatW поддерживается программой Microsoft Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Пример

Смотри также

Обзор Буфер обмена, CountClipboardFormats, EnumClipboardFormats, GetClipboardFormatName

Размещение и совместимость RegisterClipboardFormat
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	User32.lib
Заголовочный файл
- объявлено в	Winuser.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется