Inserts a new navigation item. This function can insert all types of navigation items.
There is a collection of helper functions in sdk/helpers/navitemhelpers.cpp(h) which provide a more convenient method of adding new navigation items.
Syntax
Parameters
hParent
Type:
NavHandle
The parent node to insert the new item under. Can be any node you have previously created via NavInsertItem or obtained via a call to NavGetItem
strName
Type:
LPCWSTR
The name of the subitem you are adding.
Return Value
Type: bool
true = the item was inserted. false = failed to insert.
Some common reasons for failure are:
Item with the same name already exists.
The NAVSETITEM structure was invalid for the type of item you were inserting.
Remarks
Qbik highly recommends that you use aliases to find parent items when inserting your own navigation items. This ensures that your items continue to operate correctly even when the underlying navigation paths change.
Examples
See Also