IVsFontAndColorCacheManager Interface

 

Controls the caching of font and color settings.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.dll)

[GuidAttribute("55D3D8C8-F08C-4B31-B70D-FCC52468A5B2")]
[InterfaceTypeAttribute(1)]
public interface IVsFontAndColorCacheManager

NameDescription
System_CAPS_pubmethodCheckCache(Guid, Int32)

Determines if a given Category's state is cached and current.

System_CAPS_pubmethodCheckCacheable(Guid, Int32)

Determines if a given Category's state can be cached.

System_CAPS_pubmethodClearAllCaches()

Clears all Categories' state information from the Fonts and Colors cache.

System_CAPS_pubmethodClearCache(Guid)

Clears a given Category's state information from the Fonts and Colors cache.

System_CAPS_pubmethodRefreshCache(Guid)

Force the Visual Studio environment to update cached Fonts and Colors information with the current state data of a given Category.

The Visual Studio Tools Options page's Fonts and Colors default setting information is cached to avoid unnecessarily loading VSPackages to get or set Fonts and Colors info.

Notes to Callers:

The Visual Studio environment implements the IVsFontAndColorCacheManager interface.

COM programmers can obtain an IVsFontAndColorCacheManager interface by calling QueryService with

a service ID SID_SVsFontAndColorCacheManager and the interface ID IID_IVsFontAndColorCacheManager:

CComPtr<IVsFontAndColorCacheManager> srpFCCacheMgr;
pSP->QueryService(SID_SVsFontAndColorCacheManager , IID_IVsFontAndColorCacheManager , (void**)&srpFCCacheMgr);
VSASSERT(SUCCEEDED(hr), " IVsFontAndColorCacheManager not provided");

VSPackages developed using managed code can obtain an IVsFontAndColorCacheManager interface by calling GetService with an argument of SVsFontAndColorCacheManager:

IVsFontAndColorCacheManager store=null;
store=GetService(typeof(SVsFontAndColorCacheManager)) as IVsFontAndColorCacheManager;
if (store == null ){
    throw new ApplicationException("Unable to obtain IVsFontAndColorCacheManager Interface");
}

If a VSPackage providing Fonts and Colors changes its default settings, it must call ClearCache or ClearAllCaches. This will force the reloading of Fonts and Colors providers, ensure the propagation of its setting, and the currency of future Fonts and Colors queries.

Return to top
Show: