This documentation is archived and is not being maintained.

Mapping Element

SharePoint 2003

The Mapping element is used in DOCICON.XML to map particular document types to their respective icons.

Syntax

<Mapping
  AcceptHeader = "Text"
  EditText = "Text"
  Extension = "Text"
  HandlerUrl = "Text"
  Key = "Text"
  OpenControl = "Text"
  ProgId = "Text"
  Value = "Text">
</Mapping>

Attributes

NameDescription
AcceptHeader Optional Text. Specifies the application to use to open a file in a document library. If HTML viewing is enabled, Windows SharePoint Services compares the value of this attribute with the Accept-Header HTTP header of the request and either opens the document in its native format through the specified application, or offers to convert the document to HTML. For more information, see Programming with the Microsoft.HtmlTrans.Interface Namespace.
EditTextOptional Text. Specifies the name of the application used to edit the type of document.
ExtensionOptional Text. Specifies the file name extension for the document type.
HandlerUrlOptional Text. Specifies the URL of a back-end converter program used to handle a request when the client computer does not have the Microsoft Office application installed.
KeyRequired Text. Specifies either a ProgID or a file name extension.
OpenControlOptional Text. Specifies the name of the Microsoft ActiveX control used to open the type of document.
ProgIdOptional Text. Specifies the name of the ActiveX control used to open the type of document.
Value Required Text. Specifies the URL to the image.

Element Relationships

Parent Elements
ByExtension, ByProgID, HtmlTrInfo

Example

The following code 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, "doc" maps to icdoc.gif.
  • 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"/>
    <Mapping Key="PowerPoint.Slide" Value="ichtmppt.gif"/>
    <Mapping Key="Word.Document" Value="ichtmdoc.gif"/>
  </ByProgID>
  <ByExtension>
    <Mapping Key="doc" Value="icdoc.gif"/>
    <Mapping Key="gif" Value="icgif.gif"/>
    <Mapping Key="htm" Value="ichtm.gif"/>
    <Mapping Key="html" Value="ichtm.gif"/>
    <Mapping Key="ppt" Value="icppt.gif"/>
  </ByExtension>
  <Default>
    <Mapping Value="icgen.gif"/>
  </Default>
</DocIcons>

Show: