Export (0) Print
Expand All

Mapping Element (Document Icons)

Last modified: July 15, 2011

Applies to: SharePoint Foundation 2013 | SharePoint Server 2013

In this article
Attributes
Child Elements
Parent Elements
Occurrences

Used in the DocIcon.xml file to map particular document types to their respective icons.


<Mapping
  Key = "Text"
  Value = "Text">
  EditText = "Text"
  OpenControl = "Text"
</Mapping>

Attribute

Description

Key

Required Text. Specifies either a ProgID or a file name extension.

Value

Required Text. Specifies the image file name and extension. The file must exist in the %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\IMAGES folder.

EditText

Optional Text. Specifies text that displays in drop-down menus as the editing item ("Edit in Application Name") for a file that has been uploaded to a list.

OpenControl

Optional Text. Specifies the name of the ActiveX control used to open the type of document.

Minimum: 0

Maximum: Unbounded

The following example maps ProgIDs and file name extensions as follows:

  • For different values of the ProgID <META> tag, it maps ProgIDs to the icons representing the applications. For example, "Excel.Sheet" maps to ichtmxls.gif.

  • It maps file name extensions to appropriate icons. For example, "docx" maps to icdocx.png.

  • If neither of the above causes a match, it provides a default value, icgen.gif, for the mapping.

<DocIcons>
  <ByProgID>
    <Mapping Key="Excel.Sheet" Value="ichtmxls.gif" EditText="Microsoft Excel" OpenControl="SharePoint.OpenDocuments" />
    <Mapping Key="PowerPoint.Slide" Value="ichtmppt.gif" EditText="Microsoft PowerPoint" OpenControl="SharePoint.OpenDocuments" />
    <Mapping Key="Word.Document" Value="ichtmdoc.gif" EditText="Microsoft Word" OpenControl="SharePoint.OpenDocuments"/>
  </ByProgID>
  <ByExtension>
    <Mapping Key="docx" Value="icdocx.png" EditText="Microsoft Word" OpenControl="SharePoint.OpenDocuments"/>
    <Mapping Key="pptx" Value="icpptx.png" EditText="Microsoft PowerPoint" OpenControl="SharePoint.OpenDocuments"/>
    <Mapping Key="xlsx" Value="icxlsx.png" EditText="Microsoft Excel" OpenControl="SharePoint.OpenDocuments"/>
    <Mapping Key="zip" Value="iczip.gif" OpenControl=""/>
  </ByExtension>
  <Default>
    <Mapping Value="icgen.gif"/>
  </Default>
</DocIcons>
Show:
© 2014 Microsoft