Description

McDataNodes.Add{*} prior to the BeforeAdd{*} event. The parameters may be changed prior to the command invocation.

Syntax

Private Sub object_BeforeAdd(pmcdatanodesNewParent, eSource, vSource, eStorage, lProcessingOrdinalb1, lProcessingCount, eCancel)

The BeforeAdd Event syntax has these parts:

PartDescription
objectA McDataManager object.
pmcdatanodesNewParentA McDataNodes object.
eSourceA mcDataAddSource enumeration, as described in settings. The Type of Source given.
vSourceA Variant value. The Source data.
eStorageA mcDataNodeStorageMethods enumeration, as described in settings. The storage mode to be used.
lProcessingOrdinalb1A Long value. The ordinal (1 based) number of the current root item being processed in the current mcdatanodes command.
lProcessingCountA Long value. The count of root items to be processed in the current mcdatanodes command.
eCancelA mcDataCancel enumeration, as described in settings. Fail or bypass (because already implemented) the current entry or all enties of the command.

Settings

The settings for eSource are:

ConstantValueDescription
 mcdataas_Other0

Used by BeforeAdd to signify datatype of source is not known.

 mcdataas_Object1

Used by BeforeAdd to signify datatype of source is a COM object.

 mcdataas_File2

Used by BeforeAdd to signify datatype of source is a file.

 mcdataas_Clipboard3

Used by BeforeAdd to signify datatype of source is the clipboard.

 mcdataas_DataObject4

Used by BeforeAdd to signify datatype of source is a data object.

 mcdataas_OLEDocument5

Used by BeforeAdd to signify datatype of source is a visible OLE Document object.

 mcdataas_StringBuffer6

Used by BeforeAdd to signify datatype of source is a String Buffer.

 mcdataas_ArrayBuffer7

Used by BeforeAdd to signify datatype of source is a Array Buffer.

The settings for eStorage are:

ConstantValueDescription
 mcdatnsm_NotSpecified0

No Value. Use default value specified to the database type.

 mcdatnsm_StoreFilepath65536

Store the filename of a file (file must be already saved)

 mcdatnsm_StoreFileData131072

Save the data in the database

 mcdatnsm_StoreCopyFileName262144

Save to a database managed file and store filename in database

 mcdatnsm_All458752

Not a valid value. Use for bit mask of possible values.

The settings for eCancel are:

ConstantValueDescription
 mcdatac_Continue0

VBA.False; Continue as normal.

 mcdatac_AbortWholeCommand-1

(VBA.True) Will rollback when in a transaction.

 mcdatac_IgnoreCurrentEntry-2

Will skip (not process) the single instance on a multi-instance command (Same as mcdatac_AbortWholeCommand for single instance command)

 mcdatac_AlreadyProcessedAll-1

Will skip all remaining instance without processing but will not rollback.

 mcdatac_AlreadyProcessedCurrentEntry0

Will skip all current instance without processing (same as skip but signifies handled).