ItemImagePropertiesBase.UrlSelected Property

Gets or sets the URL of the image used for an element’s selected state.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue("")]
public string UrlSelected { get; set; }

VB.NET

<DefaultValue("")>
Public Property UrlSelected As String

Property Value

Type	Default	Description
String	String.Empty	A String value that specifies the location of an image.

Remarks

Use the UrlSelected property to specify the URL of an image which is defined by the current ItemImagePropertiesBase object, and is used to represent the corresponding element in a selected state.

You can use a relative or an absolute URL. A relative URL relates the location of the image to the location of the Web page without specifying a complete path on the server. The path is relative to the location of the Web page. This makes it easier to move the entire site to another directory on the server without updating the code. An absolute URL provides the complete path, thus moving the site to another directory requires a code update.

An image’s size can be defined via the ImagePropertiesBase.Width and ImagePropertiesBase.Height properties. Note that in order to correctly display a PNG file with alpha channel at runtime, the image’s size (the ImagePropertiesBase.Width and ImagePropertiesBase.Height properties) should be specified explicitly.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UrlSelected property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

asp-net-web-forms-create-responsive-web-app/CS/ResponsiveWebApplication/Root.master.cs#L85

    e.Item.Image.Url = string.Format("Content/Images/{0}.svg", e.Item.Text);
    e.Item.Image.UrlSelected = string.Format("Content/Images/{0}-white.svg", e.Item.Text);
}