Elemento MapToIcon (View)

Última modificación: viernes, 30 de mayo de 2008

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

Devuelve el nombre de archivo del icono asociado a una extensión de nombre de archivo y un ProgID determinados.

<MapToIcon>
    ProgID|File_Extension
</MapToIcon>

Atributos

Atributo

Descripción

Ninguno

N/D

Elementos secundarios

Muchos

Elementos primarios

Muchos

Repeticiones

Mínimo: 0

Máximo: sin límite

Comentarios

El elemento MapToIcon usa la sintaxis siguiente y separa el ProgID de la extensión de nombre de archivo con un símbolo de barra vertical (" | "):

<MapToIcon>ProgID|File_Extension </MapToIcon>

Este elemento se puede usar en cualquier escenario de representación (por ejemplo, en una vista o como elemento independiente en un documento), pero resulta más útil en una vista de una biblioteca de documentos.

Por ejemplo, <MapToIcon>|xls</MapToIcon> representa el archivo .gif de Microsoft Excel definido en el elemento ByExtension del archivo Descripción de los archivos DocIcon.xml, y al usar <MapToIcon>Excel.Sheet|htm</MapToIcon> se representa el archivo .gif de Excel definido en el elemento ByProgID de DocIcon.xml; sin embargo, con <MapToIcon>CustomApp.Baz|htm</MapToIcon> se representaría el icono genérico HTML porque el ProgID, "CustomApp.Baz", es desconocido.

Tenga en cuenta que el administrador del sistema puede ampliar el conjunto de extensiones de nombre de archivo y ProgIDs admitidos. Se pueden editar en DocIcon.xml y, posteriormente, los archivos de imagen pueden incluirse en el directorio \TEMPLATES\1033. Después de una modificación de este tipo, Microsoft Internet Information Services (IIS) tiene que reiniciarse. A partir de ahora, los nuevos sitios web basados en Microsoft SharePoint Foundation admitirán los nuevos tipos de archivo y mostrarán los iconos correctos. El número de iconos y ProgIDs que se pueden admitir sólo está limitado por los recursos del sistema (memoria y espacio de disco).

Ejemplo

En el ejemplo siguiente, se crea el icono de aplicación vinculado que aparece en la barra de herramientas en la vista Editar propiedades de un elemento de la biblioteca de documentos. En el ejemplo se usa el elemento MapToIcon para crear la dirección URL del icono a partir de la extensión de archivo del documento y el ProgID de la aplicación asociada al documento.

<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>