[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Represents the association between a user interface (UI) related management pack element and an image element.

Schema Hierarchy

ManagementPack
  Presentation
    ImageReferences
      ImageReference

Syntax

Xml
<ImageReference ElementID=”ClassID” ImageID=”ImageID”/>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the ImageReference element.

Attributes

Attribute Description

ElementID

Required attribute. The element ID for which the image specified in the ImageID attribute is to be displayed.

ImageID

Required attribute. The ID of the Image element that is to be displayed for the element specified in the ElementID attribute.

Child Elements

None.

Parent Elements

Element Description

ImageReferences

Contains all image reference definitions in a management pack.

Remarks

ImageReference elements are used to associate class type instances with an image.

When defining an image to associate with a user interface-related element, you should always define two: a 16x16 image (u16x16Icon) and an 80x80 image (DiagramIcon). This will ensure that the class type is represented properly in all places in the console.

Example

The following XML sample illustrates how to associate an Image element with a ClassType element by using the ImageReference definition. In this case, Microsoft.Exchange2007 class type instances will appear with the specified custom images in the console.

  Copy Code
<ClassType ID="Microsoft.Exchange2007" Accessibility="Public" Abstract="false" Base="System!System.Service" Hosted="false" Singleton="true" />
…
<Image ID="Microsoft.Exchange2007.Image.Svc16" Accessibility="Public" Category="u16x16Icon">
   <ImageData>…</ImageData>
</Image>
<Image ID="Microsoft.Exchange2007.Image.Svc80" Accessibility="Public" Category="DiagramIcon">
   <ImageData>…</ImageData>
</Image>
…
<ImageReference ElementID="Microsoft.Exchange2007" ImageID="Microsoft.Exchange2007.Image.Svc80" />
<ImageReference ElementID="Microsoft.Exchange2007" ImageID="Microsoft.Exchange2007.Image.Svc16" />

See Also