_Application.RefreshFormRegionDefinition(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Refreshes the cache by obtaining the current definition from the Windows registry for one or all of the form regions that are defined for the local machine and the current user.
public:
void RefreshFormRegionDefinition(System::String ^ RegionName);public void RefreshFormRegionDefinition (string RegionName);Public Sub RefreshFormRegionDefinition (RegionName As String)Parameters
- RegionName
- String
The internal name of the form region whose definition you want to refresh in the cache. To refresh all form region definitions, specify an empty string.
Remarks
When Microsoft Outlook starts, it reads the Windows registry to obtain a list of form regions and their definitions, and then caches the data. The definitions are stored in the registry under the local machine key (as HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) and under the current user key (as HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions). The definitions describe the layout, behavior, and other characteristics of each form region. If you register a form region or modify the definition of a form region after Outlook starts, you can use the RefreshFormRegionDefinition method to instruct Outlook to obtain the updated information.
The RegionName argument should match the InternalName property of the form region whose definition you are refreshing. The internal name of a form region supports only ASCII characters. If you specify an empty string, Outlook reads the Windows registry to obtain definitions for all of the form regions that are defined for the local machine and the current user.
For more information about registering form regions, see Specifying Form Regions in the Windows Registry.