function CopyToClipboard(Source: TIECopyPasteType = iecpAuto): Boolean;
Copies the selected region, image or layer to the clipboard.
Possible values for Source
|Item ||Effect |
|iecpAuto || ImageEn automatically detects what to copy. If there is a valid selection, it is copied. If not, and a layer (other than the background) is selected, it is copied. If not, and the image is valid it is copied |
|iecpFullImage || If the image is valid, it is copied to the clipboard, then cleared. Otherwise, it fails. |
|iecpSelection || If there is a selection in the associated TImageEnView, it is copied to the clipboard then copied from the image. If there is no selection, it fails |
|iecpLayer || If there is a layer selected in the associated TImageEnView, which is not the background layer, it is copied to the clipboard (as an image and a layer) and then removed from the image |
Returns true if successful.
- The main reason for unexpected failures are very large images that exceed the available memory.
- If the TImageEnProc is attached to a TIEBitmap, TImageEnMView or TImageEnFolderMView then only iecpFullImage is relevant (iecpAuto will have the same effect as iecpFullImage. iecpSelection and iecpLayer will always fail)
// General copy to clipboard method
if ImageEnView1.Proc.CopyToClipboard(iecpAuto) = False then
MessageDlg( 'Unable to copy to the clipboard. There is insufficient memory available for the operation.', mtError, [ mbOK ], 0 );
// Copying of selection to clipboard
ImageEnView1.Proc.CopyToClipboard( iecpSelection );
// Copying of selected layers to clipboard
ImageEnView1.Proc.CopyToClipboard( iecpLayer );
// Copying the whole image to the clipboard
ImageEnView1.Proc.CopyToClipboard( iecpFullImage );
// Copy the selected image in a TImageEnMView to the clipboard
if IEMView1.SelectedImage >= 0 then