Page tree
Skip to end of metadata
Go to start of metadata

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.
pItem
Type: NAVSETITEM *
The structure that defines the item you wish to add.

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