The IconSet data visualization allows you to use arguments to select an image from an image strip and display it either as a TextBox BackgroundImage, or as an Image Value. You can use the standard image strips included with Data Dynamics Reports, or create custom image strips.

Standard Image Strips

Name	Image
3TrafficLights
Arrows
Blank
Flags
GrayArrows
Quarters
Ratings
RedToBlack
Signs
Symbols1
Symbols2
TrafficLights

To use these image strips, place code like the following in the BackgroundImage property of a TextBox report item, or in the Value property of an Image report item.

Note: When using icon sets, you must set the Source property to Database.

The first argument designates the name of the icon set to use. Following that argument, there are five Boolean arguments. The first argument to evaluate to True displays the corresponding image. Use data expressions that evaluate to a Boolean value to replace the literal values in the code above. For example:

This expression displays the first symbol (the green check mark) on each row in which the Quantity exceeds 700, and displays the third symbol (the red x) on each row in which the quantity is below 600. Notice that because of the literal False value in the second argument, the yellow exclamation point symbol never appears.

In several of the included image strips, the last spots are empty. When using the 3TrafficLights, Flags, Signs, Symbols1, or Symbols2 image strip, it generally makes sense for the final two Boolean values to be False. By the same token, when using the RedToBlack or TrafficLights image strip, the last Boolean value should be False.

The Blank image strip is included so that you can customize it. See below for details.

Custom Image Strips

Custom image strips must conform to the following rules.

1. The format must be of a type that is handled by the .NET framework.
2. The size of the strip must be 120 x 24 pixels.
3. Each image must be 24 x 24 pixels in size.
4. There must be no more than five images in the strip.
5. If there are fewer than five images in the strip, there must be blank spaces in the image to fill in.

Types of Custom Images

Here is the syntax for various types of custom images, followed by examples of each.

• External image
  =IconSet(location of image strip, condition#1, condition#2, condition#3, condition#4, condition#5)

  Example:

  =IconSet("C:\Images\customstrip.bmp", 4 > 9, 5 > 9, 10 > 9, False, False) =IconSet("http://mysite.com/images/customstrip.gif", 4 > 9, 5 > 9, 10 > 9, False, False)
• Image from an assembly resource
  =IconSet("res:[Assembly Name]/Resource name", condition#1, condition#2, condition#3, condition#4, condition#5)

  Example:

  =IconSet("res:ReportAssembly, Version=1.1.1.1./ReportAssembly.Resources.Images.CustomImage.png", 4 > 9, 5 > 9, 10 > 9, False, False)
• Embedded image
  =IconSet("embeddedImage:ImageName", condition#1, condition#2, condition#3, condition#4, condition#5)

  Example:

  =IconSet("embeddedImage:Grades", Fields!Score.Value >=90, Fields!Score.Value >=80, Fields!Score.Value >=70, Fields!Score.Value >=60, True)
• Theme image
  =IconSet("theme:ThemeImageName", condition#1, condition#2, condition#3, condition#4, condition#5)

  Example:

  =IconSet("theme:Grades", Fields!Score.Value >=90, Fields!Score.Value >=80, Fields!Score.Value >=70, Fields!Score.Value >=60, True)

Dialog

Selecting <Data Visualizer...> from the Smart Panel or Property Grid for a property that supports this data visualization will launch the following dialog.  To build the data visualizer expression, just select the appropriate values for each of the options on the dialog.

See Also