Message Bar items are messages with an accompanying hyperlink that, when clicked, navigates the user to a location in the navigation tree.
Adding Message Bar items
Add a message bar item with NavInsertItem.
Items added in the manner shown above display the strLabel text as the message, followed by a link that says "Go There". If you click the link, the WMC navigates to the location specified in strDestination. You can provide a custom formatted message and link by specifying the NI_FLAG_MESSAGEBAR_CUSTOMMESSAGE flag . See Custom link text.
The flags field of the NAVSETITEM structure dictates how the message bar item will be handled.
Flag | Description |
---|---|
NI_FLAG_MESSAGEBAR_ICONWARNING NI_FLAG_MESSAGEBAR_ICONINFO NI_FLAG_MESSAGEBAR_ICONSHIELD | The type of icon to show. Mutually exclusive. |
NI_FLAG_MESSAGEBAR_NOTIFY | Notify the item of the click. Calls the NavItemNotify handler of the notification interface supplied in NavInsertItem. Without this flag the default behaviour is to go to a navigation location. |
NI_FLAG_MESSAGEBAR_CUSTOMMESSAGE | Specify to supply message text with an embedded link with customised text. See below for details. |
Custom link text
The default link text is Go There but it can be customised by providing your own message string with your link text surrounded by the <a></a> tags when inserting the element. To use a custom message you need to set the flag NI_FLAG_MESSAGEBAR_CUSTOMMESSAGE in the NAVSETITEM structure.