UltimateMenu Server-Side API

UltimateMenu is a web control for ASP.NET. You can drag and drop the control like any other web controls (server controls) onto your Web page in VS.NET, and provide a source for it. You have four options to set the source of your menu.

1. Set MenuSource to an XML file at design-time or run-time: You can create an XML file either by using UltimateMenuDesigner as your visual designer tool, or by manually authoring the file with the help of IntelliSense.

2. Set MenuSourceXml to an XML string at run-time: You can create your menu XML string programmatically by using XMLDocument object model. Sample code is provided with download.

3. Set DatabaseConnStr and DatabaseMenuID at design-time or run-time: You can create a data source (in SQL server, Access or any other database by providing the connection string) either by using UltimateMenuDesigner, or by manually filling the tables (UltimateMenu, UltimateMenuGroup, UltimateMenuItem) in your database.

4. Set DataSource to a dataset at run-time: You can create a dataset from your data source easily by using ADO.NET. Sample code is provided with download.

Public properties of the control may be changed at design-time as well as at run-time. All public properties except MenuSource, MenuSourceXml, DatabaseConnStr, DatabaseMenuID, DataSource, Left, Top are also the attributes of the Menu element, and can be set in the XML file, XML string or database table.

If public properties are set in XML file, at design-time and at run-time all at the same time, the order of precedence is run-time, design-time and XML file.

MenuSource XML file to load the UltimateMenu control from.
MenuSourceXml XML string to load the UltimateMenu control from (run-time only).
DatabaseConnStr Connection string to the database that has the UltimateMenu table.
DatabaseMenuID ID of the menu in the UltimateMenu table in the database.
DataSource Dataset to load the UltimateMenu control from (run-time only).
Left Absolute X-coordinate (horizontal) in pixels to populate the menu at.
Top Absolute Y-coordinate (vertical) in pixels to populate the menu at.


Your menu will be automatically located at the position where you place the UltimateMenu control on your web page. You can set the Left and Top properties to override the absolute position of your control at run-time. If you put the control into a table cell it will be positioned relatively. Therefore you can achieve both relative and absolute positioning by just dragging and dropping the control inside or outside a table.

Menu XML file has a simple hierarchy of Menu, Group, and Item elements where Menu is used for the top-level, Group is used for submenus, and Item is used for the items inside the groups. You can find the XML schema in UltimateMenuSource.xsd.

Here is the list of attributes provided in the Menu, Group and Item elements:
Menu
Public Methods
GetNavigationPath This public method gets one required argument, PathDelimiter, and three optional arguments, DisplayItemsAsLinks, DisplayLastItemAsLink, LinkParameters, and returns the navigation path. This gives you the ability to display a menu path to illustrate to the user his current position in the hierarchial menu structure. You can have the items in your navigation path as hyperlinks (breadcrumbs) by setting the DisplayItemsAsLinks argument to True. The last item that refers to the current page is by default only caption, but you can make it a link as well by setting the DisplayLastItemAsLink argument to True. You can also add additional parameters to your hyperlinks by setting the LinkParameters argument to a string such as "style='color:orange;' target='_blank'", which will affect all hyperlink items the same way.
SetItemAttribute This public method gets item id, attribute name and attribute value, and changes the value of the specified attribute of the specified item. This gives you the ability to change your menu item attributes programmatically at run-time.
Menu Source
ScriptPath Virtual path for the scripts directory. Includes the JavaScript files to be loaded at runtime based on the browser type. This way, page will be loaded with only the necessary JavaScript code, which makes the page load time and menu operations much faster.
ImagePath Virtual path for the images directory. All the images used in the menu, sub menus and items will be searched under this directory.
CssFile Virtual path for the CSS file (.css) for the styles of topmenu, submenus and menu items. CSS class names used for the menu, submenus and menu items will be retrieved from this CSS file.

UltimateMenu.css under UltimateMenuDesigner is the default css file loaded when you open a new (blank) menu in UltimateMenuDesigner. This is a read-only file that is used as a common resource for every new menu. Therefore you should create your own css file for your menus. You can easily do this by just changing this property to a new filename and save it.
Menu Functionality
BaseURL Virtual path for the BaseURL to be added as a prefix to every ItemURL. Note that "/" is not required at the end of the virtual path. If omitted, UltimateMenu will handle it accordingly. Items may override this value if they have a URL property that starts with an absolute path starting with '/' or 'http://' or 'file://', or including a '\' in it. Also note that if the item has a URL starting with '~' it will automatically replace '~' with the application path.
CurrentUser Current user logged into the system will only see the allowed items specified by the AllowedUsers property of an item. If CurrentUser is not specified it first checks CurrentUserSessionVar and then the current user from HttpContext. Then AllowedUsers property of each item will be checked. If AllowedUsers is not specified for an item it will be displayed. Otherwise it needs to include the CurrentUser in its comma-separated list of users and roles.
CurrentUserSessionVar Session variable that holds the current user logged into the system. If you set this property to the session variable name that keeps the username the menu control will automatically retrieve the value of that session variable and set it to the CurrentUser property.
SourceFrame Name of the source frame that UltimateMenu is placed in.
TargetFrame Name of the target frame to open the submenus of UltimateMenu in.
TargetFrameOffsetX Horizontal offset to open the submenus of UltimateMenu in the target frame.
TargetFrameOffsetY Vertical offset to open the submenus of UltimateMenu in the target frame.
ContextMenu Boolean to make UltimateMenu a context menu that opens up with a right-click. You can associate it with any server or HTML control on your page so that it opens on that control. Note that ContextMenu overrides OpenOnClick, i.e. if you set the menu as a ContextMenu, then OpenOnCLick won't take any effect as the menu will show up with a right-click.
ContextMenuSourceID ID of the server or HTML control that the context menu is attached to. When the user right-clicks on that control the corresponding context menu will displayed. If this property is left blank the context menu will be displayed when the user right-clicks anywhere on the page except the controls that are already associated with a context menu.
ContextMenuFadeOverlap Fade overlap duration in seconds for the transition of the context menu when it is displayed. Default is 0.5, and you should set it "0" if you want to get rid of this transition and display the context menu immediately.
OpenOnClick Boolean to make UltimateMenu open up when the mouse is clicked on the topmenu rather than opening it automatically when the mouse is over the topmenu.
HighlightPath Boolean to make UltimateMenu highlight the selected item as well as the other ones on the navigation path with different styles. The selection and the navigation path is handled automatically by finding the item in the menu, which has the same URL as the current page. As the selected item and the navigation path are found by URL matching of items with the current page, you should provide unqiue URLs to your menu items. Otherwise you might experience problems with highlighting a different item and path, which has the same URL. This feature doesn't work with frames because the submenus are generated dynamically and inserted to the TargetFrame, and it is not possible to get the page info in another frame from the current page on server-side.
PathFindingMethod Method to find the navigation path. It can be either MatchPathAndQuery or MatchPathOnly. Default is MatchPathAndQuery, which tries to match item's URL with the current page's URL including the path and the query string. MatchPathOnly discards the query string and tries to match only the path portion of item's URL with current page's URL.
SelectedItemID ID of the selected item to override the automatic matching process handled by the UltimateMenu. If HighlightPath is True and SelectedItemID is left blank, UltimateMenu tries to find the selected item by using either MatchPathAndQuery or MatchPathOnly algorithms. However, if SelectedItemID has a value UltimateMenu will not attempt to find the selected item automatically but use this value as the selected item, and find the navigation path starting from this item and traversing the hierarchical menu up to the top.
DisableSelectedItem Boolean to disable the selectem item. Default is True. If it is set to False the user can click on the item to refresh the current page.
ShowPath Boolean to show the navigation path while passing the mouse through menu items. This is different than the HighlightPath property in the sense that this just shows the mouse traversal path, and has nothing to do with URL matching of the current page as in the case of HighlightPath. Default is True.
TabView Boolean to show the top menu like a tab view. Even though you have the HighlighPath property set to False it tries to match the URL of the page to the URL of the menu items to initially open one of the topmenu items. If it finds a menu item that is either pointing to the current page directly, or in the navigation path to the current page it opens the submenu under that topmenu item and keeps it open until the user clicks on another topmenu item. If it can't find any matches it keeps all topmenu items closed, and waits for the user to open a topmenu item. When the user clicks on any topmenu item the menu opens its submenu and it stays open even though the user drags the mouse outside the menu. Default is False.
MenuOverlay Boolean to make UltimateMenu open over select boxes such as dropdown boxes, list boxes, etc. Normally IE shows the select boxes over the submenus that pop up while navigation the menu. If you set the MenuOverlay property to True it will open the select boxes. While doing this it will not hide the whole select box, but only partially hide the intersecting piece of the select box. Default is True.
UseDefaultRightIcon Boolean for using default right icon for all items having submenus. Possible values are True and False. If set to True, default right icon is shown for items, which have submenus, in vertical layout menus. If set to False, default right icon is not shown. Default value for UseDefaultRightIcon property is True.
UseArrowForNoOnClick Boolean for using default cursor type (an arrow) when mouse is over the menu item if there is no OnClick actions (ClientCall, PostBackValue, or URL) defined for the menu item. Possible values are True and False. If set to True, default cursor, which is an arrow, is shown for the items having no OnClick actions defined. If set to False, cursor type is not affected by OnClick actions. Default value for UseArrowForNoOnClick property is False.
HideTimeout Time out (in milliseconds) for the submenus to disappear when the mouse is not over the submenus. Default value for HideTimeout property is 300 ms.
ShowTimeout Time out (in milliseconds) for the submenus to appear when the mouse is over an item with a submenu. Default value for ShowTimeout property is 100 ms.
ScrollTimeout Time out (in milliseconds) for the scrollable submenus to refresh. When the mouse stands over the scroll arrow, the scrollable menu waits for the value set for ScrollTimeout property times out and then moves to the appropriate direction. Greater values for ScrollTimeout make the scrolling slower, smaller values make it faster. Default value for ScrollTimeout is 10 ms.
ScrollIncrement Increments (in pixels) for the scrollable submenus at each refresh time. Greater values for ScrollIncrement move the scrollable menu more each ScrollTimeout intervals; smaller values move it less. Default value for ScrollIncrement is 3 pixels.
Topmenu Appearance
Layout Menu layout type. Possible values are Horizontal and Vertical. If Horizontal is selected, menu will be shown horizontally. If Vertical is selected, menu will be shown vertically. Default value for Layout property is Horizontal.
MenuCssClass CSS class name for the top-level menu. If it's left blank, UltimateMenu will be used as the default CssClass, which is defined as:

.UltimateMenu {border-style:outset; border-width:2px; border-color:#ffffff; cursor:pointer; cursor:hand; background-color:#CEDBF4;}
MenuItemCssClass CSS class name for the top-level menu item when the mouse is not over the item. If it's left blank, UltimateMenuItem will be used as the default CssClass, which is defined as:

.UltimateMenuItem {background-color:#CEDBF4; border-style:solid; border-width:1px; border-color:#CEDBF4; font-family:Tahoma; font-size:10pt;}
MenuItemOverCssClass CSS class name for the top-level menu item when the mouse is over the item. If it's left blank, UltimateMenuItemOver will be used as the default CssClass, which is defined as:

.UltimateMenuItemOver {background-color:#B0C4DE; border-style:outset; border-width:1px; border-color:#ffffff; font-family:Tahoma; font-size:10pt;}
MenuItemClickCssClass CSS class name for the top-level menu item when the mouse is clicked on the item. If it's left blank, UltimateMenuItemClick will be used as the default CssClass, which is defined as:

.UltimateMenuItemClick {background-color:#B0C4DE; border-style:inset; border-width:1px; border-color:#ffffff; font-family:Tahoma; font-size:10pt;}

Note that this property is valid only if the OpenOnClick property of the menu is set to True.
MenuItemSelectCssClass CSS class name for the top-level menu item when the item has the same URL as the current page. If it's left blank, UltimateMenuItemSelect will be used as the default CssClass, which is defined as:

.UltimateMenuItemSelect {background-color:#DEDBF4; border-style:solid; border-width:1px; border-color:#000000; font-family:Tahoma; font-size:10pt;}

Note that this property is valid only if the HighlightPath property of the menu is set to True.
MenuItemOnPathCssClass CSS class name for the top-level menu item when the item is on the same navigation path with the selected item. If it's left blank, UltimateMenuItemOnPath will be used as the default CssClass, which is defined as:

.UltimateMenuItemOnPath {background-color:#CEDBF4; border-style:solid; border-width:1px; border-color:#000000; font-family:Tahoma; font-size:10pt;}

Note that this property is valid only if the HighlightPath property of the menu is set to True.
MenuItemWidth Width for the top-level menu items. This value is applied to all items in the top-level menu.
MenuItemHeight Height for the top-level menu items. This value is applied to all items in the top-level menu.
MenuItemNowrap Boolean to make top-level menu items wrap or not if the caption is bigger than the item width. Default is True, which means that items are not wrapped.
Default Submenu Appearance
DefaultOffsetX Default horizontal distance between menu and its submenus. DefaultOffsetX will apply to all submenus unless it is defined at the submenu level. Default value for DefaultOffsetX is 0.
DefaultOffsetY Default vertical distance between menu and its submenus. DefaultOffsetY will apply to all submenus unless it is defined at the submenu level. Default value for DefaultOffsetX is 0.
DefaultGroupCssClass Default CSS class name for the submenus. This value is applied to all sub menus unless it is defined at the group level. If it's left blank, UltimateMenuGroup will be used as the default CssClass, which is defined as:

.UltimateMenuGroup {border-style:outset; border-width:2px; border-color:#ffffff; cursor:pointer; cursor:hand; background-color:#CEDBF4;}
DefaultDisabledItemCssClass Default CSS class name for the disabled type of items. If it's left blank, UltimateMenuDisabledItem will be used as the default CssClass, which is defined as:

.UltimateMenuDisabledItem {background-color:#CEDBF4; color:#a9a9a9; cursor:default; font-family:Tahoma; font-size:10pt;}
DefaultScrollArrowCssClass Default CSS class name for the arrow items in a scrollable menu when the mouse is not over the item. If it's left blank, UltimateMenuScrollArrow will be used as the default CssClass, which is defined as:

.UltimateMenuScrollArrow {background-color:#CEDBF4;}
DefaultScrollArrowOverCssClass Default CSS class name for the arrow items in a scrollable menu when the mouse is over the item. If it's left blank, UltimateMenuScrollArrowOver will be used as the default CssClass, which is defined as:

.UltimateMenuScrollArrowOver {background-color:#B0C4DE;}
DefaultDisabledScrollArrowCssClass Default CSS class name for the disabled arrow items in a scrollable menu when it is not possible to scroll in that direction any more. If it's left blank, UltimateMenuDisabledScrollArrow will be used as the default CssClass, which is defined as:

.UltimateMenuDisabledScrollArrow {background-color:#CEDBF4; color:#a9a9a9; cursor:default;}
Default Item Appearance
DefaultItemCssClass Default CSS class name for the submenu items when the mouse is not over the item. This value is applied to all items in the submenus unless it is defined at the item level. If it's left blank, UltimateMenuSubItem will be used as the default CssClass, which is defined as:

.UltimateMenuSubItem {background-color:#CEDBF4; border-style:solid; border-width:1px; border-color:#CEDBF4; font-family:Tahoma; font-size:10pt;}
DefaultItemOverCssClass Default CSS class name for the submenu items when the mouse is over the item. This value is applied to all items in the submenus unless it is defined at the item level. If it's left blank, UltimateMenuSubItemOver will be used as the default CssClass, which is defined as:

.UltimateMenuSubItemOver {background-color:#B0C4DE; border-style:outset; border-width:1px; border-color:#ffffff; font-family:Tahoma; font-size:10pt;}
DefaultItemSelectCssClass Default CSS class name for the submenu item when the item has the same URL as the current page. If it's left blank, UltimateMenuSubItemSelect will be used as the default CssClass, which is defined as:

.UltimateMenuSubItemSelect {background-color:#DEDBF4; border-style:solid; border-width:1px; border-color:#000000; font-family:Tahoma; font-size:10pt;}

Note that this property is valid only if the HighlightPath property of the menu is set to True.
DefaultItemOnPathCssClass Default CSS class name for the submenu item when the item is on the same navigation path with the selected item. If it's left blank, UltimateMenuSubItemOnPath will be used as the default CssClass, which is defined as:

.UltimateMenuSubItemOnPath {background-color:#CEDBF4; border-style:solid; border-width:1px; border-color:#000000; font-family:Tahoma; font-size:10pt;}

Note that this property is valid only if the HighlightPath property of the menu is set to True.
DefaultItemWidth Default width for the submenu items. This value is applied to all items in the submenus unless it is defined at the item level.
DefaultItemHeight Default height for the submenu items. This value is applied to all items in the submenus unless it is defined at the item level.
DefaultItemNowrap Default flag to make submenu items wrap or not if the caption is bigger than the item width. Default is True, which means that items are not wrapped.
Default Icon Appearance
DefaultLeftIconWidth Default width for the left icon of submenu items. This value is applied to all items in the submenus unless it is defined at the item level.
DefaultLeftIconHeight Default height for the left icon of submenu items. This value is applied to all items in the submenus unless it is defined at the item level.
DefaultRightIconWidth Default width for the right icon of submenu items. This value is applied to all items in the submenus unless it is defined at the item level.
DefaultRightIconHeight Default height for the right icon of submenu items. This value is applied to all items in the submenus unless it is defined at the item level.
Group
Submenu Appearance
Layout Submenu layout type. Possible values are Horizontal and Vertical. If Horizontal is selected, submenu will be shown horizontally. If Vertical is selected, submenu will be shown vertically. Default value for Layout property is Horizontal.
VerticalOpenDirection Opening direction of a submenu that is the child of a horizontal menu/submenu. Default is Auto, and it can be set to Up or Down.
HorizontalOpenDirection Opening direction of a submenu that is the child of a vertical menu/submenu. Default is Auto, and it can be set to Left or Right.
VerticalAlign Alignment of a submenu that is the child of a vertical menu/submenu. Default is Auto, and it can be set to Top, Middle or Down.
HorizontalAlign Alignment of a submenu that is the child of a horizontal menu/submenu. Default is Auto, and it can be set to Left, Center or Right.
Scrolling Boolean for making the submenu scrollable. Possible values are True and False. Default value for Scroll property is False.
AutoScrollHeight Boolean to automatically adjust the height of the vertical scrolling submenu based on the height of the browser window. If there is enough space in the browser window it hides the scroll arrows. Otherwise it opens a scrolling submenu with the height of the window, and adds scroll arrows to the top and bottom portion of the submenu. Default is False.
ScrollHeight Height of the scrollable area in a vertical scrollable submenu. Default value for ScrollHeight property is 50.
ScrollWidth Width of the scrollable area in a horizontal scrollable submenu. Default value for ScrollWidth property is 150.
ScrollArrowCssClass Default CSS class name for the arrow items in a scrollable menu when the mouse is not over the item.
ScrollArrowOverCssClass Default CSS class name for the arrow items in a scrollable menu when the mouse is over the item.
DisabledScrollArrowCssClass Default CSS class name for the disabled arrow items in a scrollable menu when it is not possible to scroll in that direction any more.
Filter

Submenu opening filter effect type. Only IE5.5+ provides this functionality. Other types of client-browsers will just ignore this property.

 

Possible values are:


   None


   Transparent (adjusts the opacity)

      Opacity (opacity level between)

         0 (fully transparent) and

         100 (fully opaque)


   Rotation (adjusts the image rotation)

      Rotation (in ninety-degree increments)

         0: Content is not rotated

         1: Content is rotated 90 degrees

         2: Content is rotated 180 degrees

         3: Content is rotated 270 degrees


   DropShadow (creates a solid silhouette)

      Color (color in #AARRGGBB format)

         AA: alpha hexadecimal value

         RR: red hexadecimal value

         GG: green hexadecimal value

         BB: blue hexadecimal value)

      OffsetX (the offset value along the x-axis, in pixels. Positive values move the drop shadow to the right, and negative values move it to the left.)

      OffsetY (the offset value along the y-axis, in pixels. Positive values move the drop shadow down, and negative values move it up.)


   Gradient (displays a colored surface between the background and the content)

      GradientType (orientation of the gradient; possible values are 0, 1)

         0: Displays a vertical gradient

         1: Displays a horizontal gradient

      StartColor (initial opaque color, #AARRGGBB format)

      EndColor (final opaque color, #AARRGGBB format)


   Shadow (creates the illusion of a shadow)

      Direction (direction of the offset, in degrees)

         0: Top

         45: Top right

         90: Right

         135: Bottom right

         180: Bottom

         225: Bottom left

         270: Left

         315: Top left

      Color (final opaque color, #AARRGGBB format)

      Strength (distance, in pixels, that a filter effect extends)


Default value for Filter is None.
Transition

Submenu opening transition effect type. Only IE5.5+ provides this functionality. Other types of client-browsers will just ignore this property.

 

Possible values are:


   None


   Fade (reveals new content of the object by fading out the original content)

      Overlap (fraction of the transition's duration that both original and new content are displayed)

         Floating-point that can range from 0.0 to 1.0.


   GradientWipe (reveals new content of the object by passing a gradient band over the original content)

      GradientSize (percentage of the object that is covered by the gradient band)

         Floating-point that can range from 0.0 to 1.0.

      WipeStyle (orientation of the gradient)

         0: vertical gradient

         1: horizontal gradient

      Motion (indicates whether content is revealed as defined by the WipeStyle property setting, or in the opposite direction)

         Forward: New content is revealed in the direction set by the WipeStyle property

         Reverse: New content is revealed in the opposite direction than that set by the WipeStyle property


   Iris (reveals new content of the object with an iris effect, similar to the opening of a camera aperture)

      IrisStyle (shape of the Iris filter aperture)

         Circle: Circular aperture

         Cross: X-shaped aperture

         Diamond: Diamond-shaped aperture

         Plus: Plus sign-shaped aperture

         Square: Square aperture

         Star: Star-shaped aperture

      Motion (indicates whether new content is revealed from the outside or the inside first)

         Out: The transition moves from the center of the object toward the borders of the object

         In: The transition moves from the borders of the object toward the center


   Pixelate (Displays the content of the object as colored squares that take the average color value of the pixels they replace)

      MaxSquare (maximum width in pixels of a pixelated square)

         Integer that specifies or receives a width that can range from 2 to 50 pixels


   RandomDissolve (Reveals new content of the object by exposing random pixels)

      Duration (length of time the transition takes to complete)

         Floating-point that specifies the length of time to complete the transition. The value is specified in seconds.milliseconds format (0.0000).


Default value for Transition is None.

OffsetX Horizontal distance between submenu and its parent item. Default value for OffsetX is 0.
OffsetY Vertical distance between submenu and its parent item. Default value for OffsetY is 0.
GroupCssClass CSS class name for the submenu.
DisabledItemCssClass Default CSS class name for the disabled type of items. This value is applied to all items in the submenu unless it is defined at the item level.
Default Item Appearance
DefaultItemCssClass Default CSS class name for the submenu items when the mouse is not over the item. This value is applied to all items in the submenu unless it is defined at the item level.
DefaultItemOverCssClass Default CSS class name for the submenu items when the mouse is over the item. This value is applied to all items in the submenu unless it is defined at the item level.
DefaultItemWidth Default width for the submenu items. This value is applied to all items in the submenu unless it is defined at the item level.
DefaultItemHeight Default height for the submenu items. This value is applied to all items in the submenu unless it is defined at the item level.
DefaultItemNowrap Default flag to make submenu items wrap or not if the caption is bigger than the item width. Default is True, which means that items are not wrapped.
Default Icon Appearance
DefaultLeftIconWidth Default width for the left icon of submenu items. This value is applied to all items in the submenu unless it is defined at the item level.
DefaultLeftIconHeight Default height for the left icon of submenu items. This value is applied to all items in the submenu unless it is defined at the item level.
DefaultRightIconWidth Default width for the right icon of submenu items. This value is applied to all items in the submenu unless it is defined at the item level.
DefaultRightIconHeight Default height for the right icon of submenu items. This value is applied to all items in the submenu unless it is defined at the item level.
Item
Item Type Selection
Caption Caption of the item. If the item is of type "Text" this will be shown as the text for the item in the menu. If the item is an "Image" or "Separator" this field will only be displayed in MenuTree in UltimateMenuDesigner, which shows the menu structure in hierarchical form.
Type Type of the item. Possible values are Text, Image, Separator and ServerControl. If Text is selected, item is rendered as text. If Image is selected, an image specified by the user will be shown instead of text. If Separator is selected, a horizontal or vertical separator line is displayed in place of the item depending on the layout type of the submenu. If ServerControl is selected it will find the server with an ID of ServerControlID control on the aspx page, and will render it in place this item.
AllowedUsers Current user logged into the system will only see the allowed items specified by the AllowedUsers property of an item. If CurrentUser is not specified it first checks CurrentUserSessionVar and then the current user from HttpContext. Then AllowedUsers property of each item will be checked. If AllowedUsers is not specified for an item it will be displayed. Otherwise it needs to include the CurrentUser in its comma-separated list of users and roles.
ServerControlID ID of the server control on the aspx page that will rendered in place this item.
OnClick Properties
HotKey Keyboard shortcut for this item. When the user hits the specified combination of keys it will act as if the item is clicked by mouse.
ClientCall JavaScript function to be called when the item is clicked. Parentheses and the required function variables must be provided.
PostBackValue Post back value to be returned when the item is clicked.
URL URL to be redirected when the item is clicked.

Note: ClientCall, PostBackValue and URL can be used in combinations. If all of these parameters are provided, first ClientCall function is called, then PostBackValue is sent and then the page is redirected.
Target String that receives one of the following values for how to navigate to the specified URL.

name The name of the target window or frame.
_blank Load the linked document into a new blank window. This window is not named.
_media Load the linked document into the HTML content area of the Media Bar. Available in Internet Explorer 6 or later.
_parent Load the linked document into the immediate parent of the document the link is in.
_search Load the linked document into the browser search pane. Available in Internet Explorer 5 or later.
_self Default. Load the linked document into the window in which the link was clicked (the active window).
_top Load the linked document into the topmost window.

The property has a default value of _self.

Expressions can be used in place of the preceding value(s), as of Internet Explorer 5.

If there is no existing window or frame with the same name as specified in the target, a new window is opened with a name equal to the value of the target.

Note for frames: If this property is left blank UltimateMenu will automatically open the URL in the frame where submenus open, which is specified by the TargetFrame property of Menu.
Item Appearance
ItemCssClass CSS class name for the item when the mouse is not over the item.
ItemOverCssClass CSS class name for the item when the mouse is over the item.
ItemWidth Width for the item.
ItemHeight Height for the item.
ItemNowrap Boolean to make the item wrap or not if the caption is bigger than the item width. Default is True, which means that items are not wrapped.
ItemToolTip Text to be shown near the item when the mouse is over the item.
ItemStatus Text to be shown at the status line of the browser window when the mouse is over the item.
ItemOverClientCall Client-side function to be called when the mouse is over the menu item.
ItemOutClientCall Client-side function to be called when the mouse leaves the menu item.
Image Appearance
ImagePath Virtual path for the image when the mouse is not over the item.
ImageOverPath Virtual path for the image when the mouse is over the item.
ImageToolTip Text to be shown when the mouse is over the image item.
ImageWidth Width for the image. Use this property to change the width of the original image. If you want to modify the width of the cell that this image is displayed in you should change ItemWidth.
ImageHeight Height for the image. Use this property to change the height of the original image. If you want to modify the height of the cell that this image is displayed in you should change ItemHeight.
Separator Appearance
SeparatorImage Virtual path for the separator image.
SeparatorCssClass CSS class name for the separator image when the mouse is not over it.
SeparatorWidth Width for the separator image.
SeparatorHeight Height for the separator image.
Icon Appearance
LeftIcon Virtual path for the icon on the left of the item when the mouse is not over the item.
LeftIconOver Virtual path for the icon on the left of the item when the mouse is over the item.
LeftIconWidth Width for the icon on the left of the item.
LeftIconHeight Height for the icon on the left of the item.
RightIcon Virtual path for the icon on the right of the item when the mouse is not over the item.
RightIconOver Virtual path for the icon on the right of the item when the mouse is over the item.
RightIconWidth Width for the icon on the right of the item.
RightIconHeight Height for the icon on the right of the item.
Behavior
Enabled Boolean for making the item enabled or disabled. Possible values are True and False. When False is selected, item becomes Disabled and DefaultDisabledItemCssClass style applies to the item; ClientCall, PostBackValue or URL will not respond. If the item is also a group, submenu is not shown when the mouse is over the item.
Visible Boolean for making the item visible or invisible. Possible values are True and False. When False is selected, item is not rendered in the page.