ASPxClientMenuItem.SetImageUrl(value) Method
Sets the URL which points to the image displayed within the menu item.
Declaration
SetImageUrl(
value: string
): voidParameters
| 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>