_FormRegionStartup.GetFormRegionManifest(String, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
フォーム領域の XML マニフェストを取得します。
public:
System::Object ^ GetFormRegionManifest(System::String ^ FormRegionName, int LCID);public object GetFormRegionManifest (string FormRegionName, int LCID);Public Function GetFormRegionManifest (FormRegionName As String, LCID As Integer) As Objectパラメーター
- FormRegionName
- String
フォーム領域を Windows レジストリに登録するときに使用されたフォーム領域の名前。
- LCID
- Int32
Outlook が現在使用している言語を表すロケール ID。 この値は、この言語に対応するフォーム領域のローカライズ文字列を取得するために使用します。
戻り値
フォーム領域の XML マニフェストを表す オブジェクト 。 この XML 文字列には、フォーム領域 (title 要素で指定) と同じ表示名、関連付けられたレイアウト ファイルまたはアドインをサポートされているユーザーの操作、およびローカライズ文字列などの特性が含まれています。 XML は、フォーム領域の XML スキーマに従う必要があります。 フォーム領域 XML スキーマの詳細については、MSDN ライブラリの「Microsoft Outlook 2010 XML スキーマ リファレンス」を参照してください。
注釈
このメソッドは、アドインによる実装を目的としており、Outlook によって呼び出されます。 インターフェイスの FormRegionStartup 一部として、このメソッドと GetFormRegionIcon(String, Int32, OlFormRegionIcon) メソッドは、アドインがフォーム領域を登録し、Outlook に XML マニフェストとフォーム領域のアイコンを提供するメカニズムを提供します。
アドインによってフォーム領域の XML マニフェストを提供するには、フォーム領域を Windows レジストリに登録するときに、アドインのプログラム ID を指定します。 フォーム領域の登録の詳細については、「FormRegionStartup インターフェイスの Windows レジストリGetFormRegionManifest メソッドでのフォーム領域の指定」を参照してください。 Windows レジストリにプログラム ID を指定しないと、このメソッドは Outlook によって呼び出されません。
フォーム領域の XML マニフェストでは、アドインがフォーム領域のアイコンを提供するを許可することを意味を提供するアドインに依存しています。 アドインは、 FormRegionStartup インターフェイスの GetFormRegionIcon の実装する必要がありますもできます。 Outlook では、フォーム領域のアドインを指定されたアイコンを取得するのには GetFormRegionIcon を呼び出します。 アドインを使用してアイコンを指定する方法の詳細については、「方法: アドインを使用してフォーム領域のアイコンを指定する」を参照してください。
Outlook の起動時、Windows レジストリからフォーム領域の一覧を読み取りし、データをキャッシュします。 このデータに基づいて Outlook アドインが指定されているフォーム領域の XML マニフェストを提供するを通知する場合、Outlook はキャッシュされたデータと、 GetFormRegionManifest メソッドによって実装されるこのアドインでフォーム領域を表示する必要のある XML を取得する呼び出しで提供されている ProgIDを使用します。 XML マニフェストが有効ではありません、フォーム領域の XML スキーマに準拠していない場合、Outlook はフォーム領域を読み込むことはできません。 また場合は、Windows レジストリ内の ProgIDを指定しないと、Outlook は GetFormRegionManifest と GetFormRegionIcon メソッドを呼び出しますしません。
Outlook では、アドインによって XML マニフェストが提供される場合、次の要素が無視されます。