McDataManager Object
    
 
Description

Exposes the root of the DataManager object model.

Object Model






Remarks

A McDataManager is a creatable COM object that is at the root of the DataManager object model. The IQApp.McApplication Application object model exposes a created McDataManager as the Application.DataManager property. It is not suggested to create this object yourself.
A McDataManager exposes the following:
* McDBLib Database Utility API - Specific functions to aid in using McDBLib in the DataManager context.
* AddIn server support - provides IDTExtensibility2 implementation.
* Serialization support - provides PropertyBag implementation.
* Exposes McDataSources - Registration database of McDataHandler Servers supporting File,Object,Clipboard,McDBNode interoperation commands.
* Exposes McDataNodes - A Database McDBNode Selection with support for Database operations and File,Object,Clipboard interoperations.
* Exposes McDataJournal - Semi-persistent historic data cache.
* Exposes McDataManager event sink - Notification from the McDataNodes creates by the McDataManager.

PROGID McAddInData.McDataManager
ObjectFlags Creatable

Members

Methods
AddStockAttributesToType Add the standard application specific fields to a database type.
CheckNodeName Validates a node name for valid characters and optionally for uniqueness against a McDBNodes collection.
ConvertDataType Transforms a Data Type value between two different data type contexts.
CopyDatabase Copies McDBDatabase database.
CreateDatabase Creates a new application compliant database.
CreateDataNodes Creates and returns a new McDataNodes Object.
FindPhysicalDatabase Returns a logical name and McDBDatabase reference for a physical database path.
GetChildName Returns the name of the link between a parent McDBNode and one of its children.
GetDatabaseFileFolder Returns the folder path used to store database data files.
GetDBNode Opens a Database and Finds a McDBNode for a given path.
GetDBNodesGlobalID Returns a McDBNode Global ID from a McDBNodes and 0 based ordinal.
GetDBNodesIndex Returns an 0 based ordinal in a McDBNodes collection for a given property.
GetDBNodeValue Returns a value stored relative to a McDBNode instance.
GetDefaultDatabaseFileFolder Returns the folder path used to store database data files.
GetLastErrObject Copy properties to a VBA.ErrObject from a the last error in the McDataManager object model.
GetNodeStorageFilename Returns the file path which is being used to store the data for a given McDBNode.
GetNodeStorageFilePath Returns the storage directory path for data of a McDBNode instance when mcdatnsm_StoreCopyFileName is used.
GetNodeStorageMethod Get the storage method used when the McDBNode.Data content was stored.
GetPathAncestorPath Extracts the path to an ancestor from a given path. This function supports any path that is delimited with the "\" character.
GetStorageFilePath Returns the storage directory path for data of a McDBType in a McDBDatabase (mcdatnsm_StoreCopyFileName).
GetStorageMethod Returns the method used to store McDBNode.Data content for a McDBType.
IsAutoList Returns whether a McDBAttributeType should produce a list of all known values in the query user-interface.
IsDatabaseSame Returns whether two McDatabase references are using the same backing database (files)
IsDBNodeChildOf Returns true when the given parent McDBNode has the given child McDBNode.
IsDBNodeSame Returns True when the 2 given McDBNode references point to the same Database object.
IsFolder Returns whether a McDBNode is a 'Folder'.
IsHidden Returns whether a McDBNode, McDBType or McDBAttributeType is a not to be shown in the user-interface.
IsLocal Returns whether a database content is copied outside of the same database.
IsReadOnly Returns whether a McDBNode or McDBAttribute is 'ReadOnly'.
IsSystem Returns whether a McDBNode, McDBType or McDBAttributeType flags (hidden, readonly,..) should not be edited in the user-interface.
MakeFileName Validates a file name for character set and optionally for uniqueness in a file folder.
MakeIconPicture Create a thumbnail for a Picture or McImage and return it as a Picture (DIB) or McImage.
MakeTypeExist Ensures a particular McDBType exist in a destination database.
OpenDatabase Open a database for a given McDBDatabase Logical Name or McDBDatabase Item Key
ParsePath Returns a logical name, node path and node name for a path string.
SetAttribute A simplified method of setting an attribute value.
SetNodeIcon Create a thumbnail for a Picture or McImage and store it in a McDBNode Icon property.
SetNodeStorageMethod Set the storage method used when McDBNode.Data content is stored.
SetStorageMethod Sets the default storage method and path for a McDBType in a McDBDatabase used by future store operations.

Properties
ActiveDataNodesRead-only property Pre-created McDataNodes for general scripting use.
ApplicationRead-only property The Root of the Application Object Model.
DefaultLargeIconSizeRead-write property The suggested size in pixels (squared) of the picture to store in the McDBNode.Icon(mcdbLarge) property.
JournalRead-only property The Journal for the current identity.
LastErrRead-only property The last error received by the McDataManager object model.
LastErrCommentRead-only property The last error comment received by the McDataManager object model.
LastErrSourceRead-only property The last error source received by the McDataManager object model.
LastErrStringRead-only property The last error string received by the McDataManager object model.
NotificationsRead-write property Stores the enable state of the individual event notifications.
ParentRead-only property The Object that created this instance.
SelectedDataNodesRead-only property Returns a pre-created McDataNodes for general scripting configured to the last selection and current used by a user interface viewer.
SourcesRead-only property The collection of the available McDataSource registered entries.
TargetDataNodesRead-only property Returns a pre-created McDataNodes that retains an application-wide configured McDataNodes.

Events
AfterAddNode McDataNodes.AddToNode after adding each mcdbnode.
AfterAddNodeFile McDataNodes.AddFile after each McDBNode creation.
AfterAddNodeFile2 McDataNodes.AddFile after each McDBNode creation.
AfterAddNodeObject McDataNodes.AddObject after each McDBNode creation.
AfterAddNodeObject2 McDataNodes.AddObject after each McDBNode creation.
AfterClipboardData Called by McDataNodes.ClipboardData after processing.
AfterCreateNode McDataNodes.AddFolder after the McDBNode creation.
AfterDelete McDataNodes.Delete after each mcdbnode deletion.
AfterMove McDataNodes.Move after each mcdbnode movement.
AfterObjectClipboardData Called by McDataNodes.ObjectClipboardData after processing.
AfterObjectClose McDataJournal.ObjectClose after calling McDataHandler (implementation).
AfterOpen McDataNodes.NodeOpen after opening each McDBNode.data content.
AfterOpen2 McDataNodes.NodeOpen after opening each McDBNode.data content.
AfterQuery McDataManager.MakeQuery prior to McDBQuery Execute.
AfterRemove McDataNodes.Remove after each mcdbnode link removal.
AfterRename McDataNodes.Rename after the McDBNode modification.
AfterReParent McDataNodes.ReParent after the mcdbnode primary parent change.
BeforeAdd McDataNodes.Add{*} prior to the BeforeAdd{*} event. The parameters may be changed prior to the command invocation.
BeforeAddNode Called by AddToNode member of McDataNodes after adding each McDBNode.
BeforeAddNodeFile McDataNodes.AddFile prior to the McDBNode creation.
BeforeAddNodeFile2 McDataNodes.AddFile prior to the McDBNode creation.
BeforeAddNodeObject called by McDataNodes.AddObject prior to each McDBNode creation.
BeforeClipboardData Called by McDataNodes.ClipboardData prior to processing.
BeforeCreateNode McDataNodes.AddFolder prior to the McDBNode creation.
BeforeDelete McDataNodes.Delete prior to each mcdbnode deletion.
BeforeMove McDataNodes.Move prior to each mcdbnode movement.
BeforeObjectClipboardData Called by McDataNodes.ObjectClipboardData prior to processing.
BeforeObjectClose McDataJournal.ObjectClose prior to calling McDataHandler (implementation).
BeforeOpen McDataNodes.NodeOpen prior to opening each McDBNode.data content.
BeforeQuery McDataManager.MakeQuery prior to McDBQuery Execute.
BeforeRemove McDataNodes.Remove prior to each mcdbnode link removal.
BeforeRename McDataNodes.Rename before the McDBNode modification.
BeforeRename2 McDataNodes.Rename before the McDBNode modification.
BeforeReParent McDataNodes.ReParent prior to the mcdbnode primary parent change.
CalculateValue Called when a calculated value for an object (pUnknown is a raw object or mcdbnode object) is needed.
ErrorInfo An error has occurred in the McAddInData library.
MultipleItemCommand Reveals looping behaviour of a McDataNodes command and allows cancellation.