Data Binding Using Mapping Properties
When Menu binds to an arbitrary data source, a MVCxMenuItem object is created automatically for every recognized data item. The individual item’s characteristics (such as text, name, image path, navigation location, and tooltip text) are obtained from the data fields (item attributes) of corresponding data items. Menu exposes its specific data-related properties, allowing you to specify which data source fields the item information should be retrieved from. The table below lists these properties and the corresponding properties of a MVCxMenuItem object.
| Menu data-related properties | Corresponding MVCxMenuItem object properties |
|---|---|
| MenuSettingsBase.ImageUrlField (via MenuSettings.ImageUrlField) | ImagePropertiesBase.Url (via MVCxMenuItem.Image.Url) |
| MenuSettingsBase.NameField (via MenuSettings.NameField) | MenuItem.Name (via MVCxMenuItem.Name) |
| MenuSettingsBase.NavigateUrlField (via MenuSettings.NavigateUrlField) | MenuItem.NavigateUrl (via MVCxMenuItem.NavigateUrl) |
| MenuSettingsBase.TextField (via MenuSettings.TextField) | MenuItem.Text (via MVCxMenuItem.Text) |
| MenuSettingsBase.ToolTipField (via MenuSettings.ToolTipField) | MenuItem.ToolTip (via MVCxMenuItem.ToolTip) |
The picture below demonstrates the data retrieval path during the binding to an XML file.
