TClipboardViewer Component

Unit
ClipView

Description
Компонента TClipboardViewer предназначена для отображения содержимого буфера обмена Windows (Clipboard) в ваших формах. Текущее содержимое буфера обмена может быть представлено в форматах, определенных типом TClipboardViewFormat.
Вы можете изменить текущий формат отображения данных Clipboard с помощью свойства ViewFormat. Индексированное свойство ClipboardFormatNames[Index: Integer] (run-time and read only) служит для определения строковых имен зарегистрированных форматов Clipboard.

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


Declaration
type
TClipboardViewFormat = (cvDefault, cvEmpty, cvUnknown, cvText, cvBitmap, cvMetafile, cvPalette, cvOemText, cvPicture, cvComponent, cvIcon);
Description
Тип используется компонентой TClipboardViewer для задания формата отображения текущих данных, содержащихся в буфере обмена.


Declaration
property ViewFormat: TClipboardViewFormat;

Description
Свойство определяет текущий формат отображения данных буфера обмена в компоненте TClipboardViewer. В случае установки этого свойства в значение, недопустимое для текущего содержимого буфера обмена, содержимое Clipboard отображается в допустимом формате "по умолчанию".


Declaration
property ClipboardFormatNames[Index: Integer]: string;

Description
Индексированное свойство ClipboardFormatNames (только для чтения) служит для определения текстовых имен доступных форматов буфера обмена. Целочисленное значение Index соответствует индексу свойства Formats класса TClipboard и может изменяться в пределах от 0 до значения свойства FormatCount класса TClipboard.

Значения этого свойства могут быть вами использованы, например, для вывода в меню доступных для отображения форматов Clipboard (совместно со значениями, возвращаемыми функцией класса CanDrawFormat).


Declaration
property OnChange: TNotifyEvent;

Description
Событие OnChange происходит при изменении содержимого буфера обмена (Clipboard). Вы можете использовать обработчик этого события для задания необходимого вам формата отображения данных (свойство ViewFormat) в компоненте TClipboardViewer.


Declaration
class function CanDrawFormat(ClipboardFormat: Word): Boolean;

Description
Функция класса возвращает True, если формат буфера обмена, заданный параметром ClipboardFormat, может быть отображен компонентой TClipboardViewer, и False в противном случае.