カスタムフォームでフォーム領域の場所を指定する

[アーティクル]
04/07/2023

フォーム領域はユーザー設定のユーザーインターフェイスの部品で、フォームに追加することができます。複数の方法のうちのいずれかの方法で、ユーザー設定フォーム内にフォーム領域が表示されるよう指定できます。そのためには、対応するフォーム領域マニフェスト XML ファイル内のフォーム領域 XML スキーマの formRegionType 要素と displayAfter 要素を指定します。

既定のページに表示する

標準フォームの既定ページに 1 つ以上のフォーム領域を表示するには、複数の方法があります。

フォーム領域を既定のページに追加するには

In the form region manifest XML file, specify adjoining as the value of the formRegionType element.

フォーム領域は、元の標準フォームの既定ページの下部に追加され、インスペクターまたは閲覧ウィンドウに表示されます。

たとえば、標準メッセージフォームの既定ページの下部にフォーム領域を追加するには、フォーム領域のフォーム領域マニフェスト XML ファイルで以下を指定します。

<formRegionType>adjoining</formRegionType>

結果のカスタムフォームを使用して、元の標準フォームと同じメッセージクラスの項目を表示するか、カスタムフォームの派生メッセージクラスを割り当てて、カスタムフォームを使用して派生メッセージクラスの項目のみを表示できます。

既定のページに複数のフォーム領域を追加するには

For each form region, in the corresponding form region manifest XML file, specify adjoining as the value of the formRegionType element.
既定ページに最初のフォーム領域として表示されるフォーム領域を除くその他のフォーム領域それぞれについて、対応するフォーム領域マニフェスト XML ファイルで、そのフォーム領域の前に表示するフォーム領域の内部名を displayAfter 要素の値として指定します。

最初のフォーム領域は、元の標準フォームの既定のページの下部に追加され、対応する displayAfter 要素で指定した順序で他のフォーム領域によって追加されます。

たとえば、内部名 FormRegionA、FormRegionB、および FormRegionC を A、B、C の順に表示する 3 つのフォーム領域 A、B、C を注文する場合は、A のフォーム領域マニフェスト XML ファイルで次を指定します。

<formRegionType>adjoining</formRegionType>

B のフォーム領域マニフェスト XML ファイルで次を指定します。

<formRegionType>adjoining</formRegionType>
<displayAfter>FormRegionA</displayAfter>

C のフォーム領域マニフェスト XML ファイルで次を指定します。

<formRegionType>adjoining</formRegionType>
<displayAfter>FormRegionB</displayAfter>

注:

displayAfter 要素を使用して、カスタムフォーム内の複数の隣接するフォーム領域の順序を指定します。ただし、この順番は、フォームがユーザーのローカルコンピューターに初めて表示される場合に限り有効です。ユーザーは、フォームを開き、フォーム領域ヘッダーのショートカットメニューを使用して、既定ページでフォーム領域を上下に移動することで、隣接するフォーム領域の順番を変更できます。更新された順番はキャッシュされ、フォームの以後の表示ではそのキャッシュされた順番が使用されます。

既定のページ全体をフォーム領域で "置換" するには

In the form region manifest XML file, specify replace as the value of the formRegionType element.
When you register the form region in the Windows registry, under the local machine key (as HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) or the current user key (as HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), create a separate key for the derived message class for this form region. Add a value of the type REG_SZ, specifying the internal name of the form region as the name of the key, and the full local file path name to the form region manifest XML file as the data of the key.

When you are "replacing" the default page of a standard form, you are in reality using the standard form as a template and creating a new custom form that has your form region as the default page. 元の標準フォームに他のフォームページまたは別のフォーム領域が含まれている場合、それらはカスタムフォームの一部として残ります。

派生メッセージクラスを結果のカスタムフォームに割り当て、フォームを使用してそのメッセージクラスの項目を表示する必要があります。

たとえば、c:\Form Regions で内部名 CustomPage とフォーム領域マニフェスト XML ファイルCustomPage.xmlを持つフォーム領域を作成しました。 To use the form region to replace the default page of the standard Message form, you can specify the following in the form region manifest XML file of CustomPage:

<formRegionType>replace</formRegionType>

When you register this form region in the Windows registry, you must not specify the message class of the original standard form, IPM.Note, but specify a derived message class, such as IPM.Note.CustomPage. この例では、キー IPM を作成して、現在のユーザーキー HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegionsの下にフォーム領域を登録します 。Note.CustomPage。次に、 REG_SZ型の値を追加し、フォーム領域の内部名 CustomPage をキーの名前として指定し、完全なローカルファイルパス名をフォーム領域マニフェスト XML ファイル c:\Form Regions\CustomPage.xmlキーのデータとして指定します。

標準フォーム全体をフォーム領域で "置換" するには

In the form region manifest XML file, specify replaceall as the value of the formRegionType element.
When you register the form region in the Windows registry, under the local machine key (as HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) or the current user key (as HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), create a separate key for the derived message class for this form region. Add a value of the type REG_SZ, specifying the internal name of the form region as the name of the key, and the full local file path name to the form region manifest XML file as the data of the key.

When you are "replacing" the entire standard form with a form region, you are in reality using the standard form as a template and creating a new custom form that has the form region as the default page. 元の標準フォームに他のフォームページまたは別のフォーム領域が含まれている場合、それらはカスタムフォームの一部として残りません。

派生メッセージクラスを結果のカスタムフォームに割り当て、フォームを使用してそのメッセージクラスの項目を表示する必要があります。

たとえば、c:\Form Region で内部名 CustomMessage とフォーム領域マニフェスト XML ファイルCustomMessage.xmlを持つフォーム領域を作成しました。 To use the standard Message form as the template for a new custom form that will contain CustomMessage as the default page, you can specify the following in the form region manifest XML file of CustomMessage:

<formRegionType>replaceall</formRegionType>

このフォーム領域を Windows レジストリに登録する場合は、IPM などの派生メッセージクラスを指定します 。Note.CustomMessage。この例では、キー IPM を作成して、現在のユーザーキー HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegionsの下にフォーム領域を登録します 。Note.CustomMessage。次に、 REG_SZ型の値を追加し、フォーム領域の内部名 CustomMessage をキーの名前として指定し、完全なローカルファイルパス名をフォーム領域マニフェスト XML ファイル c:\Form Regions\CustomMessage.xmlにキーのデータとして指定します。

既定のページ以外のページ

1 つ以上のフォーム領域を個別ページとして標準フォームに追加できます。

フォーム領域を別のページとして追加するには

In the form region manifest XML file, specify separate as the value of the formRegionType element.

フォーム領域は、元の標準フォームの既存のすべてのページの後に個別ページとして追加され、インスペクターでスタンドアロンページとして表示されます。

たとえば、標準連絡先フォームにフォーム領域を個別ページとして追加するには、フォーム領域のフォーム領域マニフェスト XML ファイルで以下を指定します。

<formRegionType>separate</formRegionType>

フォーム領域は、標準連絡先フォームの [すべてのフィールド] ページの後に個別ページとして表示されます。

複数のフォーム領域を個別のページとして追加するには

For each form region, in the corresponding form region manifest XML file, specify separate as the value of the formRegionType element.
ユーザー設定フォームに最初のフォーム領域として表示されるフォーム領域を除くその他のフォーム領域それぞれについて、対応するフォーム領域マニフェスト XML ファイルで、そのフォーム領域の前に表示するフォーム領域の内部名を displayAfter 要素の値として指定します。

最初のフォーム領域は、元の標準フォームの別のページとして追加され、対応する displayAfter 要素で指定した順序で他のフォーム領域によって追加されます。

たとえば、内部名 FormRegionA、FormRegionB、および FormRegionC を個別のページとして A、B、C の順に表示する、A、B、C の 3 つの個別のフォーム領域を注文する場合は、A のフォーム領域マニフェスト XML ファイルで次を指定します。

<formRegionType>separate</formRegionType>