Manager: Scrap Manager


Carbon supports only the LoadScrap and UnloadScrap functions from the original Scrap Manager. However, Carbon supplies new features, including support for "promises," to the Scrap Manager.

Supported  CallInScrapPromises

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ClearCurrentScrap

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ClearScrap

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Supported  DisposeScrapPromiseKeeperUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetCurrentScrap

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  GetScrap

You should instead use the functions GetScrapFlavorSize and GetScrapFlavorData. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetScrapByName

On Mac OS 8 and 9, GetScrapByName only supports the clipboard scrap. Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Supported  GetScrapFlavorCount

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetScrapFlavorData

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetScrapFlavorFlags

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetScrapFlavorInfoList

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetScrapFlavorSize

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  InfoScrap

The InfoScrap function is not supported in Carbon. You should use the function GetCurrentScrap instead. Your application can determine if the scrap contents have changed by storing the scrap reference returned by GetCurrentScrap and comparing it against the scrap reference returned by GetCurrentScrap at a later time. If the two scrap references are different, the scrap has changed. Not available in CarbonLib. Not available in Mac OS X.

Supported  InvokeScrapPromiseKeeperUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  LoadScrap

Carbon applications may continue calling this function on Mac OS 8; however, on Mac OS X it does nothing and is no longer necessary. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  NewScrapPromiseKeeperUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  PutScrap

You should instead use the function PutScrapFlavor. Not available in CarbonLib. Not available in Mac OS X.

Supported  PutScrapFlavor

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetScrapPromiseKeeper

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  UnloadScrap

Carbon applications may continue calling this function on Mac OS 8; however, on Mac OS X it does nothing and is no longer necessary. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  ZeroScrap

You should instead use the function ClearCurrentScrap. Not available in CarbonLib. Not available in Mac OS X.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.