GetHandler Method

Description

Returns a McDataHandler for the given command properties.

Return Type

A McDataHandler object. A McDataHandler reference to support the command.
Failure Returns Nothing..

Failure conditions:
* Given command properties do not identify a McDataHandler
* McDataHandler could not be created.
* Propogated failure from .SourceHandler, ItemByCommand(), ItemByCommandKey().

Syntax

object.GetHandler (eContentType, sContent, eCommand, sDisplayName, [pDataSourceCmd])

The GetHandler Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McDataSources.
eContentType	Required. A mcDataSourceContent enumeration, as described in settings. ContentType to be found.
sContent	Required. A String value. Content to be found.
eCommand	Required. A mcDataUICommands enumeration, as described in settings. Command to be found.
sDisplayName	Required. A String value. Localized Command to be found.
pDataSourceCmd	Optional. A McDataSourceCommand object.

Settings

The settings for eContentType are:

Constant		Value	Description
	mcdatSC_UnInit	0	Not Initialize - invalid state.
	mcdatSC_DBNode	1	McDBNode Content
	mcdatSC_Object	2	COM Object Content
	mcdatSC_File	3	File Content
	mcdatSC_ClipboardData	4	Clipboard / DataObject Content

The settings for eCommand are:

Constant

Value

Description

mcdatnc_NotACommand

Not Initialize - invalid state.

mcdatnc_AddClipboard

 Current
mcdatnc_StoreToNode        ' Save to a Database Node

mcdatnc_AddDataObject

Drop Special New - UI will Not show value but a value is required to enable.

mcdatnc_AddFile

Open Common Dialog prompt using DataSource's file extensions.

mcdatnc_AddFolder

Open (Browse) Folder shell dialog and recursive Add File with no prompting.

mcdatnc_AddObject

Add ACTIVEObject (McDataHandler.ObjectGetActive is required)

mcdatnc_Import

Many uniquely named Import commands are allowed

mcdatnc_StoreToFile

Save As Common Dialog prompt

mcdatnc_ClipboardCopy

Cop	Will Not show in UI; but a value is required to enable.

mcdatnc_StoreToDataObject

Dra	Will Not show in UI; but a value is required to enable.

mcdatnc_GetActiveObject

returns the activeobject for a registered command

mcdatnc_Open

100

Selection

mcdatnc_ObjectToJournal

101

Sets the Object's Related Node to be the ActiveDataNode.

mcdatnc_StoreToFolder

102

Open (Browse) Folder shell dialog and then recursive Add File with no prompting.

mcdatnc_Custom

103

Many uniquely named Custom commands are allowed.

mcdatnc_Macro

104

Many uniquely named Macro commands are allowed.

mcdatnc_Export

105

Many uniquely named Export commands are allowed.

mcdatnc_GetValue

1000

newer than IQbase1.0

Remarks

Provide a simplified method to retrieve the McDataHandler for a command.
The McDataHandler will be created when it does not already exist.