Share via

2.2.2.1.6 Icon Elements

  • Article

The Icon elements specify icons for a resource or application. Icon elements include <Icon16>, <Icon32>, <Icon48>, <Icon64>, <Icon100>, <Icon256>, and <IconRaw>. The numeric part of the name specifies that the image used for the icon MUST be square, with height and width equal to that number. For example, an icon with the name Icon256 must have a height and width of 256 pixels. The <IconRaw> element can contain multiple icons with different sizes.

Icon elements define the following attributes:

  • Dimensions: An attribute that specifies the height and width of the icon with an "x" separating the two entries, such as "32x32". This attribute SHOULD appear only when the icon name is a value that contains a specific size such as Icon16 and SHOULD NOT appear when the icon name is IconRaw.

  • FileType: The file extension for the file type of the image. For example, if the image file on the server is named Paint.ico, then the FileType attribute would be "Ico".

  • FileURL: An optional URL that specifies the location of the image file. This attribute MUST be present if the icon is available from a web server.

  • FileContent: This element is ignored by the client and MUST NOT be used by the server.

  • Index: This attribute is ignored by the client and MUST NOT be used by the server.