Description Adds the object(s) exposed in a DataObject to the Current.
-
Return Type
-
A Long value. The count of McDBNode objects added to the Current.
-
Syntax
-
object.AddDataObject (pDataObject, [lClipFormat], [eOverWrite], [eDataStorage], [sDisplayName], [eClipDropCommand])
The AddDataObject Method syntax has these parts: |
| object | An expression evaluating to an object of type McDataNodes. | | pDataObject | Required. An IUnknown object. The DataObject reference that contains the data to be added to Current (IVSDataObject, IVBDataObject, VBRun.DataObject ...) | | lClipFormat | Optional. A Long value. The Clipboard format of the data supported by pDataObject to be added. | | eOverWrite | Optional. A mcDataNodeOverwrites enumeration, as described in settings. Specifies the granularity of the store operation. The McDataSource implementation decides how the object is added to the Current.Node.
The default implementation for the McImage actually adds a new McDBNode to the Children collection of the Current.Node.
All implementations must overwrite the Current.Node (itself) when any 'remove' option is specified (mcdaton_Remove*). | | eDataStorage | Optional. A mcDataNodeStorageMethods enumeration, as described in settings. The Data Storage method to be used when storing the Data. | | sDisplayName | Optional. A String value. An identifier specifying a particular McDataSource implementation. | | eClipDropCommand | Optional. An OLEDropEffectConstants enumeration, as described in settings. The drag and drop operation. |
Settings The settings for eOverWrite are:
|
 | mcdaton_NoOverwriteMakeNew | 0 |
Default: FALSE - Add new with all content and make new when instead of overwrite.
|
| mcdaton_Attributes | 1 |
add or overwrite attributes
|
| mcdaton_AttributesRemoveOld | 2 |
remove any existing attributes (prior to save)
|
| mcdaton_Data | 4 |
add or overwrite data
|
| mcdaton_DataRemoveOld | 8 |
remove existing data (prior to save)
|
| mcdaton_Icons | 16 |
add or overwrite icons
|
| mcdaton_IconsRemoveOld | 32 |
remove any existing attributes (prior to save)
|
| mcdaton_Categories | 64 |
add categories
|
| mcdaton_CategoriesRemoveOld | 128 |
remove any existing categories (prior to save)
|
| mcdaton_Children | 256 |
add children
|
| mcdaton_ChildrenRemoveOld | 512 |
remove any existing children (prior to save)
|
| mcdaton_RemoveOld | 682 |
Overwrite All
|
| mcdaton_All | 1023 |
Add or Overwrite all
|
| mcdaton_AllTrue | -1 |
Legacy support. Same as mcdaton_All.
|
The settings for eDataStorage are:
|
| mcdatnsm_NotSpecified | 0 |
No Value. Use default value specified to the database type.
|
| mcdatnsm_StoreFilepath | 65536 |
Store the filename of a file (file must be already saved)
|
| mcdatnsm_StoreFileData | 131072 |
Save the data in the database
|
| mcdatnsm_StoreCopyFileName | 262144 |
Save to a database managed file and store filename in database
|
| mcdatnsm_All | 458752 |
Not a valid value. Use for bit mask of possible values.
|
The settings for eClipDropCommand are:
|
| vbDropEffectNone | 0 |
No OLE drag/drop operation has taken place/would take place.
|
| vbDropEffectCopy | 1 |
A mask to indicate that a copy has taken place/would take place.
|
| vbDropEffectMove | 2 |
A mask to indicate that a move has take place/would take place.
|
| vbDropEffectLink | 4 |
A mask to indicate that a link has take place/would take place.
|
| vbDropEffectScroll | -2147483648 |
A mask to indicate that the drop target window has scrolled/would scroll.
|
| vbDropEffectAll | -2147483641 |
A mask to indicate for all drop target actions known to this type.
|
|
AddDataObject Method
