Outlook) (FormRegionStartup.GetFormRegionIcon 方法
會取得將針對表單區域之特定圖示類型顯示的圖示影像。
語法
expression。 GetFormRegionIcon( _FormRegionName_ , _LCID_ , _Icon_ )
表達 代表 'FormRegionStartup' 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| FormRegionName | 必要 | 字串 | 表單區域的名稱，也就是在 Windows 登錄中登錄表單區域時所用的名稱。 |
| LCID | 必要 | Long | 識別 Outlook 目前使用之語言的地區設定識別碼。 這個值是用來為表單區域取得相對應於此語言的當地語系化字串。 |
| Icon | 必要 | OlFormRegionIcon | 識別圖示類型的常數。 |
傳回值
Variant，代表影像檔原始位元組的位元組陣列或 IPictureDisp 物件。
註解
此方法的設計是要由增益集來實作，並由 Outlook 呼叫。 作為 FormRegionStartup 介面的一部分，這個方法和 GetFormRegionManifest 方法會提供一個機制，讓增益集可以註冊表單區域，並為 Outlook 提供 XML 資訊清單和表單區域的圖示。
如果您想要增益集提供表單區域的圖示，當您在 Windows 登錄中登錄表單區域時，請指定增益集的 ProgID。 如需登錄表單區域的詳細資訊，請參閱在 Windows 登錄中指定表單區域。 增益集必須實作FormRegionStartup介面的GetFormRegionManifest和GetFormRegionIcon方法。
在表單區域的 XML 資訊清單中， 于 icons 元素下方，指定您想要使用自訂圖示之每個子專案的值 addin 。 實作 GetFormRegionIcon ，如此一來，當 Outlook 將該類型的圖示當做 Icon 的引數傳遞時， GetFormRegionIcon 會 傳回自訂圖示的影像。 如果您想要 Outlook 顯示預設圖示，請實作 GetFormRegionIcon，這樣它就會對該類型的圖示傳回 null (在 Visual Basic 中為 Nothing)。 當Icon為olFormRegionIconDefault時，GetFormRegionIcon也應該在 Visual Basic) 中傳回null (Nothing。
當 Outlook 啟動時，會從 Windows 登錄中讀取一份表單區域清單，並快取與表單區域相關聯的資料。 如果表單區域已向 ProgID 註冊，Outlook 會藉由呼叫其 GetFormRegionIcon 的實作，針對 XML 資訊清單中具有 addin做為 icons 元素子項目值的任何圖示，來使用對應的增益集。 請注意，如果您未在 Windows 登錄中指定任何 ProgID，Outlook 將不會呼叫 GetFormRegionManifest 和 GetFormRegionIcon 方法。
另請參閱
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。