_Application.RefreshFormRegionDefinition(String) Method

Definition

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.

Applies to