フォーム領域に表示されるアイコンを指定する

  • [アーティクル]

IPM.Note.Customer などのカスタム メッセージ クラスのフォーム領域を定義するときは、そのメッセージ クラスに属するアイテムに関してエクスプローラー、インスペクター、およびリボンに表示するカスタム アイコンを指定できます。

アイコンは、Win32 リソース DLL ファイルのリソースとして指定します。 標準の Win32 埋め込みアイコン表記のアイコン ファイルを参照してください。 例:

  • <default>c:\myicon.ico<.default> と指定すると、指定されたパス c:¥ から既定のアイコンが読み込まれます。

  • <unread>c:\myresource.dll,101</unread> と指定すると、指定されたパス c:¥ にあるリソース ファイル myresource.dll からリソース ID が 101 のアイコン リソースが読み込まれます。

ファイル パス名には環境変数を指定できますが、汎用名前付け規則 (UNC) でパスを指定することはできません。 既定では、カスタム アイコンを指定しない場合は、親メッセージ クラスに割り当てられたアイコンが使用されます。 たとえば、IPM のフォーム領域にアイコンを指定しない場合 です。Note.Customer、次に IPM のアイコン。注 が使用されます。

項目の種類に応じて、項目の状態が異なるため、個別のアイコンで区別することを検討できます。 たとえば、エクスプローラーでは、タスク 項目でカスタム アイコンを使用してそれ自体を繰り返しのアイコンとして識別でき、メール アイテムはカスタム アイコンを使用して返信されたと識別できます。 アイテムの種類を指定できる状態ごとに個別のアイコンを指定する必要はありません。エクスプローラー、インスペクター、リボンのすべての状態に表示される既定のアイコンを指定して、そのアイテムの種類に適用できます。

エクスプローラー、インスペクター、またはリボンでカスタム アイコンを使用して識別できるアイコンの状態を次の表に示します。 フォーム領域のすべてのカスタム アイコンは、そのフォーム領域のフォーム領域マニフェスト XML ファイルの icons 要素の下で指定します。 各状態は、icons 要素の XML 子要素にマップされます。 Windows レジストリにフォーム領域を登録するときに、このフォーム領域マニフェスト XML ファイルを指定します。 フォーム領域を登録する方法の詳細については、「Windows レジストリでフォーム領域を指定する」を参照してください。

アイテムの状態 XML 子要素 例
その状態に対して他のカスタム アイコンが定義されていない場合に、アイテムに適用される任意の状態 default <default>c:\default.ico</default>
アイテムが暗号化されていることをエクスプローラー内で示すアイコン 暗号化 <encrypted>c:\encryptedicon.ico</encrypted>
アイテムが転送済みであることをエクスプローラー内で示すアイコン 転送 <forwarded>c:\forwardedicon.ico</forwarded>
アイテムが特定の派生メッセージ クラスに属することをリボン内で示すアイコン ページ <page>c:\pageicon.ico</page>
アイテムが既読であることをエクスプローラー内で示すアイコン 読む <read>c:\readicon.ico</read>
定期的なアイテムであることをエクスプローラー内で示すアイコン 繰り返し <recurring>c:\recurringicon.ico</recurring>
アイテムが返信済みであることをエクスプローラー内で示すアイコン 答えた <replied>c:\repliedicon.ico</replied>
アイテムがデジタル署名で署名されていることをエクスプローラー内で示すアイコン 署名 <signed>c:\signedicon.ico</signed>
アイテムが送信済みであることをエクスプローラー内で示すアイコン 提出 <submitted>c:\submittedicon.ico</submitted>
アイテムが未読であることをエクスプローラー内で示すアイコン 未 読 <unread>c:\unreadicon.ico</unread>
アイテムが保留中であり、まだ送信されていないことをエクスプローラー内で示すアイコン 未送信 <unsent>c:\unsenticon.ico</unsent>
このアイテムの種類が開かれているときにインスペクターに表示するアイコン ウィンドウ <window>c:\windowicon.ico</window>

フォーム領域のカスタム アイコンを指定するには

  1. フォーム領域マニフェスト XML ファイルの icons 要素の下で、カスタマイズする状態にマップする子要素を指定します。

  2. カスタム アイコン ファイルの指定方法に応じて、次のいずれかの操作を行います。

  • Outlook がアイコン ファイルまたはリソース ファイルからアイコンを読み込むように指定する場合は、アイコンを読み込むアイコン ファイルまたはリソース ファイルの場所を子要素に指定します。
  • アドインで表示するアイコンを Outlook に通知する場合は、子要素で を指定 addin します。

次の例では、フォーム領域でサポートされるメッセージ クラスに属するアイテムに関する複数の状態のカスタム アイコンを指定します。

<icons> 
 <default>c:\icons\MyIcon.ico</default> 
 <unread>c:\icons\MyUnReadIcon.ico</unread> 
 <read>c:\icons\MyReadIcon.ico</read> 
 <encrypted>%windir%\myresource.dll,101</encrypted> 
</icons>

この 4 つのカスタム アイコンには、以下が含まれます。

  • 既読状態用のカスタム アイコン ファイル
  • 未読状態用のカスタム アイコン ファイル
  • 暗号化されている状態用のリソース ファイル内の場所
  • アイテムの他のすべての状態に適用される既定のアイコン ファイル

注:

子要素の値は、アイコン ファイルまたはリソース ファイルへのファイル パスとして、または として addin表すことができます。 ファイル パスは、フォーム領域マニフェスト XML ファイルの場所への完全なパスまたは相対パスとして表すことができ、システム変数を含めることができます。 アドインを使用してアイコンを指定する方法の詳細については、「使い方: アドインを使用してフォーム領域のアイコンを指定する」を参照してください。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。