ASPxClientMenuItem.SetText(value) Method
Sets the text to be displayed within the menu item.
Declaration
SetText(
value: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| value | string | A string value specifying the text to be displayed within the menu item. |
Remarks
Note
- If the MenuItem.Text property is empty and an item image is specified, a text element markup is not rendered. In this case, it is impossible to set a text on the client side using the SetText method.
- The SetText method HTML encodes the specified text.
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