C++
ACTCUI_PORT BOOL AcTcUiPasteItems( IDataObject* pDataObject, AcTcCatalogItemArray* pItems, AcTcCatalogItemArray* pStockTools, DWORD dwFlag = ACTCUI_PI_SHOW_PROGRESS );
File
AcTcUI.h
Description
Copies the catalog items from the data object if the data object contains items in a known format. The items in the data object can be in custom, i-drop, or file drop format. If the data object includes i-drop format, then the items are automatically downloaded from the Internet. This function can be used to paste items from the Clipboard or from a drag-and-drop object.
The supported Clipboard formats are:
| CF_ACTC_CATALOG_ITEM | Catalog items in custom format |
| CF_IDROP.XML_ACTCUI_TOOL | Tools in i-drop format |
| CF_IDROP.XML_ACTCUI_PALETTE | Palettes in i-drop format |
| CF_IDROP.XML_ACTCUI_PACKAGE | Packages in i-drop format |
| CF_IDROP.XML_ACTCUI_CATEGORY | Categories in i-drop format |
| CF_IDROP.XML_ACTCUI_CATALOG | Catalogs in i-drop format |
| CF_IDROP.XML_ACTCUI_STOCKTOOL | Stock tools in i-drop format |
| HDROP | File Explorer files in standard HDROP format |
The pointers in pItems and pStockTools are allocated on the heap using new(), and the caller is responsible for deleting them.
dwFlag can be one or more of the following values:
| ACTCUI_PI_SHOW_PROGRESS | Show progress dialog (the default). |
| ACTCUI_PI_USE_NEW_IDS | Create new IDs for the newly created items. If this is not specified, the IDs of the newly created items are not changed. |
Returns true if the items are loaded from the data object successfully. Returns false if the data object does not contain catalog items or if the function fails.
Parameters
| Parameters | Description |
|---|---|
| pDataObject | Input data object pointer that contains the items to be copied |
| pItems | Output pointer to an array to receive the new catalog item pointers |
| pStockTools | Output pointer to an array to receive the new stock tool item pointers; if this is NULL, the stock tools are not copied |
| dwFlag | Input flags |