MapToIcon 要素 (ビュー)

  • [アーティクル]

適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

特定のファイル名拡張子および ProgID に関連付けられたアイコンのファイル名を返します。

<MapToIcon>
    ProgID|File_Extension
</MapToIcon>

要素と属性

以下のセクションで、属性、子要素、親要素について説明します。

属性

なし

子要素

多数

親要素

多数

Occurrences

  • 最小 : 0
  • 最大: 制約なし

注釈

MapToIcon 要素は次の構文を使用します。ProgID とファイル名拡張子はパイプ記号 (|) で区切ります。

<MapToIcon>ProgID|File_Extension </MapToIcon>

この要素は、あらゆるレンダリング シナリオで (たとえば、ビューやドキュメント内のスタンドアロン要素として) 使用できますが、最も役立つのはドキュメント ライブラリのビューで使用する場合です。

たとえば、<MapToIcon>|xls</MapToIcon>DocIcon.xmlファイルの ByExtension 要素内で定義されている Microsoft Excel .gif ファイルをレンダリングし、 を使用すると<MapToIcon>Excel.Sheet|htm</MapToIcon>、DocIcon.xmlの ByProgID 要素で定義された Excel .gif ファイルがレンダリングされますが<MapToIcon>CustomApp.Baz|htm</MapToIcon>、ProgID "CustomApp.Baz" が不明であるため、汎用 HTML アイコンがレンダリングされます。

サポートされるファイル名拡張子のセットと ProgIDs は、システム管理者が拡張できます。 DocIcon.xmlで編集し、イメージ ファイルをディレクトリに \TEMPLATES\1033 含めることができます。 このような変更の後で、Microsoft インターネット インフォメーション サービス (IIS) を再起動する必要があります。 その後、Microsoft SharePoint Foundation に基づく新しい Web サイトでは、新しいファイルの種類がサポートされ、正しいアイコンが表示されます。 サポートできるアイコンと ProgIDs の数は、システム リソース (メモリおよびディスク容量) のみによって制限されます。

例

次の例は、ドキュメント ライブラリのアイテムに対するプロパティの編集ビューで、ツール バーに表示されるリンク先アプリケーション アイコンを作成します。 例では、MapToIcon 要素を使用し、ドキュメントのファイル拡張子とドキュメントに関連付けられたアプリケーションの ProgID に基づいて、アイコンの URL を作成します。

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