Свойства, методы, события, типы, классы_______________________981

Прототип

virtual void_fastcail Assign(Classes::TPersistent * Source);

Описание

Метод Assign копирует изображение, содержащееся в объекте Source, в дан-
ный объект. Типы объектов источника и приемника должны быть одинаковыми.
Исключение составляет свойство Graphic объекта TPicture. Graphic может участ-
вовать в обменах изображениями с объектами типов TBitMap. TIcon. TMetaFile.

Объектом копирования для классов TBitMap. TIcon. TMetaFile может быть
также буфер обмена — объект Clipboard. При этом надо не забыть включить в при-
ложение директиву

ttinclude <vcl\Clipbrd.hpp>.

Свойство Graphic объекта TPicture может участвовать только в копировании в
буфер обмена, но не в копировании из буфера.

Примеры

1. Два приведенных ниже оператора делают одно и то же: копируют изображе-
ние из компонента Image2 в компонент Imagel. Но второй выполняется
успешно только в том случае, если тип графического объекта в Image2 —
TBitMap.

Imagel->Picture->Bitmap->Assign(Image2->Picture->Bitmap);

Imagel->Picture->Bitmap->Assign(Image2->Picture->Graphic);

2. Каждый из приведенных ниже операторов копирует изображение из компо-
нента Image2 в буфер обмена Clipboard.

Clipboard()->Assign(Image2->Picture->Bitmap) ;

Clipboard()->Assign(Image2->Picture->Graphic);

3. Приведенный ниже оператор читает изображение из буфера обмена Clipboard
в компонент Imagel. Если в Clipboard хранится не битовая матрица, будет ге-
нерироваться исключение.

Imagel->Picture->Bitmap->Assign(Clipboard());

Assign — метод копирования объектов

Копирует один объект в другой, создавая копию всех данных объекта

Классы TBIobField, TBrush, TCheckConstraint, TClipboard, TCollection, TCo-
lumn, TColumnTitle, TControlScrollBar, TCoolBand, TCustomImageList, TDateTi-
meColors, TDimensionItems, TField, TFieldDefs, TFont, THeaderSection, TIndex-
Defs, TJPEGImage, TListColumn, TListItems, TOleGraphic, TParaAttributes, TPa-
ram, TParams, TPen, TPersistent, TSmallIntArray, TStatusPanel, TStringGridSt-
rings, TStrings, TTextAttributes, TTreeNode, TTreeNodes.

Определение

<o6beKT-HasHa4eHMe>->Assign(<объект-источник>);

Описание

Метод Assign копирует данные одного объекта в другой. Объявлен в классе
TPersistent и перегружен в классах, производных от него. Некоторое число клас-
сов C++Builder поддерживает присваивание объектов разных типов. Для большин-
ства же классов, производных от TPersistent. применение Assign к несовпадаю-