MapToIcon, élément (View)

Article
09/24/2014

Dernière modification : vendredi 30 mai 2008

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

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>

Attributs

Attribut	Description
Aucun	N/A

Éléments enfants

Nombreux

Éléments parents

Nombreux

Occurrences

Minimum : 0

Maximum : illimité

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> restitue le fichier .gif Microsoft Excel défini dans l'élément ByExtension du fichier Présentation des fichiers DocIcon.xml, et grâce à <MapToIcon>Excel.Sheet|htm</MapToIcon> il restitue le fichier .gif Excel défini dans l'élément ByProgID de DocIcon.xml, mais <MapToIcon>CustomApp.Baz|htm</MapToIcon> afficherait l'icône HTML générique parce que 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 des images peuvent être inclus dans le répertoire \TEMPLATES\1033. Après cette modification, Microsoft Internet Information Services (IIS) doit être redémarré. Par la suite, tous les nouveaux sites Web reposant sur Microsoft SharePoint Foundation prendront en charge les nouveaux types de fichiers et afficheront les icônes correctes. 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