FormRegionStartup.GetFormRegionManifest 方法 (Outlook)
取得表單區域的 XML 資訊清單。
語法
expression。 GetFormRegionManifest( _FormRegionName_ , _LCID_ )
表達 代表 'FormRegionStartup' 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| FormRegionName | 必要 | 字串 | 表單區域的名稱，也就是在 Windows 登錄中登錄表單區域時所用的名稱。 |
| LCID | 必要 | Long | 識別 Outlook 目前使用之語言的地區設定識別碼。 這個值是用來為表單區域取得相對應於此語言的當地語系化字串。 |
傳回值
Variant，代表表單區域的 XML 資訊清單。 這個 XML 字串包含表單區域的特性，例如由 title 元素) 指定的顯示名稱 (、任何相關聯的配置檔案或增益集、任何支援的使用者動作，以及任何當地語系化字串。 此 XML 必須遵循表單區域 XML 結構描述。 如需表單區域 XML 架構的詳細資訊，請參閱MSDN Library 中的Microsoft Outlook 2010 XML 架構參考。
註解
此方法的設計是要由增益集來實作，並由 Outlook 呼叫。 作為 FormRegionStartup 介面的一部分，這個方法和 GetFormRegionIcon 方法提供一個機制，讓增益集可以註冊表單區域，並為 Outlook 提供 XML 資訊清單和表單區域的圖示。
如果您想要增益集提供表單區域的 XML 資訊清單，請在 Windows 登錄中註冊表單區域時指定增益集的 ProgID 。 如需登錄表單區域的詳細資訊，請參閱在 Windows 登錄中指定表單區域。 增益集必須實作FormRegionStartup介面的GetFormRegionManifest方法。 請注意，如果您未在 Windows 登錄中指定任何 ProgID ，Outlook 將不會呼叫此方法。
依靠增益集提供表單區域的 XML 資訊清單，就表示您也允許增益集提供表單區域的任何圖示。 此增益集也必須實作 FormRegionStartup 介面的 GetFormRegionIcon 方法。 Outlook 會呼叫 GetFormRegionIcon 以取得增益集為表單區域指定的任何圖示。 如需使用增益集指定圖示的詳細資訊，請參閱操作方法：使用增益集來指定表單區域的圖示。
當 Outlook 啟動時，它會從 Windows 登錄中讀取表單區域清單並快取資料。 根據此資料，如果 Outlook 注意到已指定增益集來提供表單區域的 XML 資訊清單，Outlook 將會使用快取資料中提供的 ProgID ，並呼叫此增益集所實作的 GetFormRegionManifest 方法，以取得它需要顯示表單區域的 XML。 如果 XML 資訊清單無效，並且不符合表單區域的 XML 結構描述，Outlook 將無法載入表單區域。 此外，如果您未在 Windows 登錄中指定任何 ProgID ，Outlook 將不會呼叫 GetFormRegionManifest 和 GetFormRegionIcon 方法。
當增益集提供 XML 資訊清單時，Outlook 會忽略下列元素：
name ：Outlook 會忽略為此元素指定的值，並且會使用為登錄中的表單區域指定的名稱。
layoutFile ：Outlook 會忽略此元素，因為增益集正在擴充這個表單區域。
addin ：Outlook 會使用前面加上等號的值， (= 登錄中的) 做為增益集的 ProgID 。
stringOverride的file屬性：Outlook 會忽略stringOverride元素所指定的任何次要當地語系化檔案。 增益集可以實作GetFormRegionManifest來傳回指定之 LCID之字串當地語系化的內嵌 XML 資訊清單，或以其他方式管理字串當地語系化，例如，使用.NET Framework當地語系化，然後傳回指定之 LCID的適當 XML 資訊清單。
另請參閱
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。