Application.RefreshFormRegionDefinition method (Outlook)

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.

Syntax

expression.RefreshFormRegionDefinition (RegionName)

expression A variable that represents an Application object.

Parameters

Name Required/Optional Data type Description
RegionName Required 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 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.

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.