ASPxClientMenuItem.SetImageUrl(value) Method

Sets the URL which points to the image displayed within the menu item.

Declaration

SetImageUrl(
    value: string
): void

Parameters

Name Type Description
value string

A string value specifying the URL to the image displayed within the menu item.

Remarks

All graphic file formats which can be interpreted by internet browsers are supported. The image’s URL can represent either an absolute or relative path.

NOTE

If a menu item image is not initialized on the server side (the item’s MenuItem.Image.Url and control’s ASPxMenuBase.ItemImage.Url properties are not specified), the corresponding DOM element is not created. In this case, the SetImageUrl property is not in effect.

Example

This example demonstrates how specific item characteristics (the text, visibility, availability to end-users, checked state) of a control (the ASPxMenu in this case) can be changed on the client side using available JavaScript methods.

<html xmlns="http://www.w3.org/1999/xhtml" >
 <head id="Head1" runat="server">
     <title>Client methods that affect an item's visibility, 
    text, navigation location and associated image</title>
 </head>
 <body>
     <form id="form2" runat="server">
     <div>
         <table border="0" cellpadding="2" cellspacing="0"><tr>
             <td><dxe:ASPxCheckBox ID="cbVisible" Checked="True" runat="server" Text="Visible">
                 <ClientSideEvents CheckedChanged="function(s, e) {
    myMenu.GetItem(0).SetVisible(s.GetChecked());
 }" />
             </dxe:ASPxCheckBox></td>
         </tr><tr>
             <td><dxe:ASPxCheckBox ID="cbEnabled" Checked="True" runat="server" Text="Enabled">
                 <ClientSideEvents CheckedChanged="function(s, e) {
    myMenu.GetItem(0).SetEnabled(s.GetChecked());
 }" />
             </dxe:ASPxCheckBox></td>
         </tr><tr>
             <td><dxe:ASPxCheckBox ID="cbChecked" Checked="False" runat="server" Text="Checked">
                 <ClientSideEvents CheckedChanged="function(s, e) {
    myMenu.GetItem(0).SetChecked(s.GetChecked());
 }" />
             </dxe:ASPxCheckBox></td>
         </tr><tr>
             <td><dxe:ASPxButton ID="bText" runat="server" Text="SetText()" AutoPostBack="False">
                 <ClientSideEvents Click="function(s, e) {
    myMenu.GetItem(0).SetText('Text is changed');
 }" />
             </dxe:ASPxButton></td>
         </tr><tr>
             <td><dxe:ASPxButton ID="bNavigateUrl" runat="server" 
            Text="SetNavigateUrl()" AutoPostBack="False">
                 <ClientSideEvents Click="function(s, e) {
    myMenu.GetItem(0).SetNavigateUrl('http://www.google.com');
 }" />
             </dxe:ASPxButton></td>
         </tr><tr>
             <td><dxe:ASPxButton ID="bImageUrl" runat="server" 
            Text="SetImageUrl()" AutoPostBack="False">
                 <ClientSideEvents Click="function(s, e) {
    myMenu.GetItem(0).SetImageUrl('Images/UserSelected.gif');
 }" />
             </dxe:ASPxButton></td>
         </tr></table>
         <br/>
         <dxm:ASPxMenu ID="ASPxMenu1" runat="server" ClientInstanceName="myMenu" 
          ItemImagePosition="Top">
             <Items>
                 <dxm:MenuItem Text="Menu Item" GroupName="SingleGroup" 
                      NavigateUrl='http://www.yahoo.com'>
                     <Image Url="Images/User.gif" 
                    UrlDisabled="../Images/Images/UserDisabled.gif" />
                 </dxm:MenuItem>
                 <dxm:MenuItem Text="Menu Item">
                     <Image Url="Images/User.gif" />
                 </dxm:MenuItem>
             </Items>
         </dxm:ASPxMenu>
     </div>
     </form>
 </body>
 </html>
See Also