FormRegionStartup.GetFormRegionIcon メソッド (Outlook)
フォーム領域の特定の種類のアイコンに対して表示されるアイコン イメージを取得します。
構文
expression. GetFormRegionIcon( _FormRegionName_ , _LCID_ , _Icon_ )
式 'FormRegionStartup' オブジェクトを表す変数。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| FormRegionName | 必須 | String | フォーム領域を Windows レジストリに登録するときに使用されたフォーム領域の名前。 |
| LCID | 必須 | 長整数型 | Outlook が現在使用している言語を表すロケール ID。 この値は、この言語に対応するフォーム領域のローカライズ文字列を取得するために使用します。 |
| Icon | 必須 | OlFormRegionIcon | アイコンの種類を識別する定数を指定します。 |
戻り値
オリジナルのイメージ ファイルのバイト数を表すバイト配列または IPictureDisp オブジェクトのいずれかであるバリアント型です。
注釈
このメソッドはアドインによって実装され、Outlook によって呼び出されます。 FormRegionStartup インターフェイスの一部として、このメソッドと GetFormRegionManifest メソッドには、アドインがフォーム領域を登録し、フォーム領域の XML マニフェストとアイコンを Outlook に提供するメカニズムが用意されています。
フォーム領域のアイコンを提供するアドインの場合は、Windows レジストリでフォーム領域を登録するときにアドインの ProgID を指定します。 フォーム領域を登録する方法の詳細については、 Windows レジストリでフォーム領域を指定するを参照してください。 アドインでは、 GetFormRegionManifest 、 FormRegionStartup インターフェイスの GetFormRegionIcon メソッドを実装しなければなりません。
アイコン 要素の下で、フォーム領域の XML マニフェストには、カスタム アイコンを使用するには子要素のそれぞれの値 addinを指定します。 Outlook がアイコンの引数としてその種類のアイコンを渡すと、GetFormRegionIcon はカスタム アイコンの画像を返すように、GetFormRegionIcon を実装します。 Outlook に既定のアイコンを表示するには、その種類のアイコンに対して null (Visual Basic の場合は Nothing) を返すように、GetFormRegionIcon を実装します。 Icon が olFormRegionIconDefault の場合、GetFormRegionIcon は null (Visual Basic では Nothing) も返す必要があります。
Outlook の起動時、Windows レジストリからフォーム領域の一覧を読み取りし、フォーム領域に関連付けられているデータをキャッシュします。 ProgID を持つフォーム領域を登録している場合 Outlook は アイコン の要素の子要素の値として addinを持つ XML マニフェスト内の任意のアイコンの GetFormRegionIcon の実装を呼び出すことで、対応するアドインを並び替え。 Windows レジストリで ProgID を指定しない場合、Outlook では GetFormRegionManifest メソッドと GetFormRegionIcon メソッドは呼び出されないことに注意してください。
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。