IVsFontAndColorEvents Interface
TOC
Collapse the table of content
Expand the table of content

IVsFontAndColorEvents Interface

 

Notifies VSPackages using font and color information about changes in font and color settings.

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

[InterfaceTypeAttribute(1)]
[GuidAttribute("F73E1D1E-3D1B-44F0-B736-D59F960B7F9E")]
public interface IVsFontAndColorEvents

NameDescription
System_CAPS_pubmethodOnApply()

Called by the environment when user has clicked the OK or Apply button on the Fonts and Colors property page in the Options dialog box.

System_CAPS_pubmethodOnFontChanged(Guid, FontInfo[], LOGFONTW[], UInt32)

Called by the Visual Studio environment when the fonts of one Categories of the items listed in the Display Items drop-down list is modified.

System_CAPS_pubmethodOnItemChanged(Guid, String, Int32, ColorableItemInfo[], UInt32, UInt32)

Called by the environment whenever an item in the Display Items drop-down list is modified.

System_CAPS_pubmethodOnReset(Guid)

Called by the environment whenever the items in the Display Items list are reset to their default values.

System_CAPS_pubmethodOnResetToBaseCategory(Guid)

Called by the environment whenever all of a category's attributes are reset to its alternate set of default values, as specified by its base category.

Implementing IVsFontAndColorEvents is not required. However, if it is not implemented, VSPackages must explicitly poll for changes in font and color settings using the GetItem or GetItem methods.

Fonts and Colors Events are broadcast when:

  • Font or color attributes are changed,

  • Font or color setting are reset to their defaults, or

  • The Options dialog box in the Tools menu is closed.

It is not necessary to advise the environment that a process is handling IVsFontAndColorEvents, because the Fonts and Colors property page uses the list of categories in the registry to poll all services implementing fonts and color support.

Notes to Implementers:

Implement the IVsFontAndColorEvents interface if you want the environment to call the VSPackage whenever the fonts and colors setting for a Category it manages changes. These changes can be initiated programmatically or through the Fonts and Colors property page.

Return to top
Show:
© 2016 Microsoft