IVsFontAndColorEvents.OnFontChanged 方法

调用由 Visual Studio 环境中，当一个在 显示项目 列表项的字体类别下拉列表时修改。

命名空间：  Microsoft.VisualStudio.Shell.Interop
程序集：  Microsoft.VisualStudio.Shell.Interop（在 Microsoft.VisualStudio.Shell.Interop.dll 中）

语法

声明
Function OnFontChanged ( _
    ByRef rguidCategory As Guid, _
    pInfo As FontInfo(), _
    pLOGFONT As LOGFONTW(), _
    HFONT As UInteger _
) As Integer

int OnFontChanged(
    ref Guid rguidCategory,
    FontInfo[] pInfo,
    LOGFONTW[] pLOGFONT,
    uint HFONT
)

参数

• rguidCategory
  类型：System.Guid%
  [in] 指定受影响的类别的 GUID。与类别的 GUID 比较此 GUID 确保操作适用于 VSPackage。

• pInfo
  类型：array<Microsoft.VisualStudio.Shell.Interop.FontInfo[]
  [in] 对包含字体定位信息的 FontInfo 结构的指针。

• pLOGFONT
  类型：array<Microsoft.VisualStudio.Shell.Interop.LOGFONTW[]
  [in] 对包含字体的属性的 LOGFONTW 结构的指针。

• HFONT
  类型：System.UInt32
  [in] 对字体对象的指针。

返回值

类型：System.Int32
如果方法成功，则返回 S_OK。如果失败，它会返回一个错误代码。

备注

COM 签名

从 vsshell.idl:

HRESULT IVsFontAndColorEvents::OnFontChanged(
   [in] REFGUID rguidCategory,
   [in] const FontInfo *pInfo,
   [in] const LOGFONTW *pLOGFONT,
   [in] HFONT hFont
);

字体不类别基类型，则不会显示项目基类型中定义:所有在类别中显示项目共享同一字体。

bFaceNameValid、 bPointSizeValid和 bCharSetValid，返回的 FontInfo 对象 (pInfo) 的成员指示对应的字体属性是否已更改。 应忽略无效的特性。 如果所有属性被标记为无效， pLOGFONT 是 NULL (c++) 或 nullnull 引用（在 Visual Basic 中为 Nothing） (c#)。

hFont 参数是包含的，因此您不需要创建两个不同 HFONT 对象，如创建 HFONT 对象是一个大量占用资源的事件。 ，在方法创建一 HFONT 对象根据需要情况下，该参数可以为 nullnull 引用（在 Visual Basic 中为 Nothing）。

.NET Framework 安全性

• 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。

请参见

参考

IVsFontAndColorEvents 接口

Microsoft.VisualStudio.Shell.Interop 命名空间