Share via


Item Monikers

A moniker is the name used by an application to identify an object/data pair. Specifically, a moniker represents an object and the type of data that the object can access. Microsoft Help uses item monikers to specify Navigation objects.

Moniker Tags

All Microsoft Help monikers are defined in the collection definition (.HxC) file using the <ItemMoniker> tag. Each <ItemMoniker> tag corresponds to one of the Navigation objects contained by Microsoft Help. Projects that are converted from HTML Help 1.x format or created using Microsoft Help Workshop contain one or more of the following <ItemMoniker> tags:

<ItemMoniker Name="!DefaultToc" ProgId="HxDs.HxHierarchy" InitData=""/>
<ItemMoniker Name="!DefaultFullTextSearch" ProgId="HxDs.HxFullTextSearch" InitData=""/>
<ItemMoniker Name="!DefaultAssociativeIndex" ProgId="HxDs.HxIndex" InitData="A"/>
<ItemMoniker Name="!DefaultKeywordIndex" ProgId="HxDs.HxIndex" InitData="K"/>
<ItemMoniker Name="!DefaultContextWindowIndex" ProgId="HxDs.HxIndex" InitData="F"/>
<ItemMoniker Name="!SampleInfo" ProgId="HxDs.HxSampleCollection" InitData=""/>

Moniker XML Attributes

The following XML attributes are used in the <ItemMoniker> tag. For more information, see Collection Definition (.Hxc) File.

Attribute

Description

Name

Specifies the name of the moniker, which represents the object/data combination.

ProgID

Points to the Navigation object that provides the data. Currently, you can reference the following objects:

HxDs.HxHierarchy

HxDs.HxFullTextSearch

HxDs.HxIndex

HxDs.HxSampleCollection.

InitData

Used to initialize the Navigation object. For example, it is used to distinguish between different types of indexes, such as context-sensitive and visible. Each index (.HxK) file has a Name attribute that corresponds directly to the InitData attribute of the <ItemMoniker> tag. The value for InitData always must match the Name attribute of the file with which it is associated. If an object does not require initialization data, a blank string can be used for this value.

See Also

Other Resources

Getting Started with Help Content and Integration