Share via


IVsTextManagerEvents2.OnUserPreferencesChanged2 Method

Fired when the user's global preferences are changed.

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

Syntax

'Declaration
Function OnUserPreferencesChanged2 ( _
    pViewPrefs As VIEWPREFERENCES2(), _
    pFramePrefs As FRAMEPREFERENCES2(), _
    pLangPrefs As LANGPREFERENCES2(), _
    pColorPrefs As FONTCOLORPREFERENCES2() _
) As Integer
int OnUserPreferencesChanged2(
    VIEWPREFERENCES2[] pViewPrefs,
    FRAMEPREFERENCES2[] pFramePrefs,
    LANGPREFERENCES2[] pLangPrefs,
    FONTCOLORPREFERENCES2[] pColorPrefs
)
int OnUserPreferencesChanged2(
    [InAttribute] array<VIEWPREFERENCES2>^ pViewPrefs, 
    [InAttribute] array<FRAMEPREFERENCES2>^ pFramePrefs, 
    [InAttribute] array<LANGPREFERENCES2>^ pLangPrefs, 
    [InAttribute] array<FONTCOLORPREFERENCES2>^ pColorPrefs
)
abstract OnUserPreferencesChanged2 : 
        pViewPrefs:VIEWPREFERENCES2[] * 
        pFramePrefs:FRAMEPREFERENCES2[] * 
        pLangPrefs:LANGPREFERENCES2[] * 
        pColorPrefs:FONTCOLORPREFERENCES2[] -> int
function OnUserPreferencesChanged2(
    pViewPrefs : VIEWPREFERENCES2[], 
    pFramePrefs : FRAMEPREFERENCES2[], 
    pLangPrefs : LANGPREFERENCES2[], 
    pColorPrefs : FONTCOLORPREFERENCES2[]
) : int

Parameters

  • pColorPrefs
    Type: array<Microsoft.VisualStudio.TextManager.Interop.FONTCOLORPREFERENCES2[]

    [in] Specifies color preferences. If non-nulla null reference (Nothing in Visual Basic), the pguidColorService member of the FONTCOLORPREFERENCES structure indicates which colorable item provider is associated with the pColorTable member. If this is non-nulla null reference (Nothing in Visual Basic), preferences that affect the colors or font used by a text view have changed.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From textmgr2.idl:

void IVsTextManagerEvents2::OnUserPreferencesChanged2(
   [in] const VIEWPREFERENCES2 * pViewPrefs,
   [in] const FRAMEPREFERENCES2 * pFramePrefs,
   [in] const LANGPREFERENCES2 * pLangPrefs,
   [in] const FONTCOLORPREFERENCES2 * pColorPrefs
);

Use this method to modify your application in response to changes in user preferences. When the user changes global preferences, either due to changing settings from the Options command in the Tools menu or due to invoking a command, such as hitting the Insert key, this event is fired.

.NET Framework Security

See Also

Reference

IVsTextManagerEvents2 Interface

Microsoft.VisualStudio.TextManager.Interop Namespace