Élément MapToIcon (View)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Renvoie le nom de fichier de l'icône associée avec une extension de nom de fichier donnée et ProgID.

<MapToIcon>
    ProgID|File_Extension
</MapToIcon>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Aucun

Éléments enfants

Nombreux

Éléments parents

Nombreux

Occurrences

Minimum : 0
Maximum : pas de limite

Remarques

L'élément MapToIcon utilise la syntaxe suivante, en séparant la partie ProgID de l'extension de nom de fichier par une barre verticale (|) :

<MapToIcon>ProgID|File_Extension </MapToIcon>

Cet élément peut être utilisé dans n'importe quel scénario de rendu (par exemple dans un affichage ou en tant qu'élément autonome dans un document), mais il est particulièrement utile dans un affichage d'une bibliothèque de documents.

Par exemple, <MapToIcon>|xls</MapToIcon> affiche le fichier de .gif Microsoft Excel défini dans l’élément ByExtension du fichier DocIcon.xml , et l’utilisation <MapToIcon>Excel.Sheet|htm</MapToIcon> de restitue le fichier .gif Excel défini dans l’élément ByProgID de DocIcon.xml, mais <MapToIcon>CustomApp.Baz|htm</MapToIcon> affiche l’icône HTML générique, car le ProgID, « CustomApp.Baz », est inconnu.

Notez que l'ensemble des extensions de nom de fichier et des ProgIDs qui sont pris en charge peut être élargi par l'administrateur système. Ils peuvent être modifiés dans DocIcon.xml, puis les fichiers image peuvent être inclus dans le \TEMPLATES\1033 répertoire. Après cette modification, Microsoft Internet Information Services (IIS) doit être redémarré. Par la suite, tous les nouveaux sites web basés sur Microsoft SharePoint Foundation prendront en charge les nouveaux types de fichiers et afficheront les icônes appropriées. Le nombre d'icônes et de ProgIDs pouvant être pris en charge est limité simplement par les ressources système (mémoire et espace disque).

Exemple

L'exemple suivant crée l'icône d'application liée qui s'affiche dans la barre d'outils de l'affichage Modifier les propriétés d'un élément de la bibliothèque de documents. Cet exemple utilise l'élément MapToIcon pour créer l'URL de l'icône d'après l'extension de fichier du document et le ProgID de l'application associée à ce document.

<HTML><![CDATA[
   <a tabindex=2 class="ms-toolbar" target=_self href="javascript:"
    onclick="javascript:editDocumentWithProgID2(' ]]>
</HTML>
<ScriptQuote NotAddingQuote="TRUE">
   <Field Name="ServerUrl" URLEncodeAsURL="TRUE" />
</ScriptQuote>
<HTML><![CDATA[ ',' ]]></HTML>
<GetVar Name="ProgID" />
<HTML><![CDATA[ ',' ]]></HTML>
<GetVar Name="Editor" />
<HTML><![CDATA[ ');javascript:return false;" ACCESSKEY=I
   ID=diidEditItem> <IMG BORDER=0 ALT=" ]]>
</HTML>
<HTML>Icon</HTML>
<HTML><![CDATA[ " SRC=" ]]></HTML>
<ImagesPath />
<MapToIcon>
   <Column Name="HTML_x0020_File_x0020_Type" />
   <HTML>|</HTML>
   <Column Name="File_x0020_Type" />
</MapToIcon>
<HTML><![CDATA[ "></a>]]></HTML>

Partager via