Elemento MapToIcon (Exibição)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Retorna o nome do arquivo do ícone associado a uma determinada extensão de nome de arquivo e ProgID.

<MapToIcon>
    ProgID|File_Extension
</MapToIcon>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Nenhuma

Elementos filho

Numerosos

Elementos pai

Numerosos

Occurrences

Mínimo: 0
Máximo: Desvinculado

Comentários

O elemento MapToIcon usa a seguinte sintaxe, separando o ProgID da extensão de nome do arquivo com um símbolo de pipe ("|"):

<MapToIcon>ProgID|File_Extension </MapToIcon>

Esse elemento pode ser usado em qualquer cenário de renderização (por exemplo, em uma exibição ou como elemento autônomo em um documento), mas é mais útil em uma exibição de uma biblioteca de documentos.

Por exemplo, <MapToIcon>|xls</MapToIcon> renderiza o arquivo .gif do Microsoft Excel definido dentro do elemento ByExtension do arquivo DocIcon.xml e o uso <MapToIcon>Excel.Sheet|htm</MapToIcon> renderiza o arquivo do Excel .gif definido no elemento ByProgID de DocIcon.xml, mas <MapToIcon>CustomApp.Baz|htm</MapToIcon> renderizaria o ícone HTML genérico porque o ProgID, "CustomApp.Baz", é desconhecido.

Observe que o conjunto de extensões de nome de arquivo e ProgIDs com suporte são extensíveis pelo administrador do sistema. Eles podem ser editados em DocIcon.xml e, em seguida, os arquivos de imagem podem ser incluídos no \TEMPLATES\1033 diretório. Após essa modificação, Serviços de Informações da Internet da Microsoft (IIS) precisa ser reiniciada. Posteriormente, todos os novos sites com base no Microsoft SharePoint Foundation darão suporte aos novos tipos de arquivo e exibirão os ícones corretos. O número de ícones e ProgIDs que podem ser suportados é limitado apenas pelos recursos do sistema (memória e espaço em disco).

Exemplo

O exemplo a seguir cria o ícone do aplicativo vinculado que aparece na barra de ferramentas na exibição Editar Propriedades para um item de biblioteca de documentos. O exemplo usa o elemento MapToIcon para construir a URL do ícone com base na extensão de arquivo do documento e no ProgID do aplicativo associado ao 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>

Partilhar via