Telerik UI for Windows Phone by Progress

This topic demonstrates how to start using RadMultiResolutionImage for Windows Phone.

To start using RadMultiResolutionImage, the first thing that has to be done is adding references to the required assemblies:

  • Telerik.Windows.Core.dll
  • Telerik.Windows.Controls.Primitives.dll

Then, the following namespace has to be declared:


Windows Phone 8 can run on different resolutions with different aspect ratios, so if you want an image to look good on all screens, without reducing its quality, you will need to provide different images for the different resolutions. With RadMultiResolutionImage you don't need to do nothing else. A single instance of the control will make sure that the correct image is loaded in your application, depending on the resolution of the device that is using it. Here's an example:

<telerikPrimitives:RadMultiResolutionImage Source="Image.png" />

The API of RadMultiResolutionImage is very simple and inspired by the API of the native Image control. You simply need to use the Source property and set it as you would with the native Image.

The pictures that are provided for the different resolutions should be properly named, in order to make the control select the correct one. For example, if the source that is provided is "Image.png", you don't even need a picture named "Image.png". You will need the following images:

  • Image.Screen-WVGA.png - the image that will be used for the WVGA resolution (480x800)
  • Image.Screen-720p.png - the image that will be used for the 720p resolution (720x1280)
  • Image.Screen-WXGA.png - the image that will be used for the WXGA resolution (768x1280)

Please make sure that you have added an image for each resolution that you want to support, bacause if for example you don't add a WVGA image, the image element would not be visible on a device with WVGA resolution.