CMFCRibbonFontComboBox 类

项目
10/16/2023

实现包含字体列表的组合框。将组合框置于功能区面板上。

语法

class CMFCRibbonFontComboBox : public CMFCRibbonComboBox

成员

公共构造函数

名称	描述
`CMFCRibbonFontComboBox::~CMFCRibbonFontComboBox`	析构函数。

受保护构造函数

名称	描述
CMFCRibbonFontComboBox::CMFCRibbonFontComboBox	构造并初始化一个 `CMFCRibbonFontComboBox` 对象。

公共方法

名称	描述
CMFCRibbonFontComboBox::BuildFonts	使用具有指定字体类型、字符集以及间距和系列的字体填充功能区字体组合框。
`CMFCRibbonFontComboBox::CreateObject`	由框架用于创建此类类型的动态实例。
CMFCRibbonFontComboBox::GetCharSet	返回指定字符集。
CMFCRibbonFontComboBox::GetFontDesc
CMFCRibbonFontComboBox::GetFontType	返回要在组合框中显示的字体类型。有效选项是是 DEVICE_FONTTYPE、RASTER_FONTTYPE 和 TRUETYPE_FONTTYPE 或是它们的任何按位组合。
CMFCRibbonFontComboBox::GetPitchAndFamily	返回组合框中显示的字体的间距和系列。
`CMFCRibbonFontComboBox::GetThisClass`	由框架用于获取指向与此类类型关联的 CRuntimeClass 对象的指针。
CMFCRibbonFontComboBox::RebuildFonts	使用具有以前指定的字体类型、字符集以及间距和系列的字体填充功能区字体组合框。
CMFCRibbonFontComboBox::SetFont	选择组合框中的指定字体。

备注

创建 CMFCRibbonFontComboBox 对象之后，通过调用 CMFCRibbonPanel::Add 将其添加到功能区面板。

继承层次结构

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonEdit

CMFCRibbonComboBox

CMFCRibbonFontComboBox

要求

标头： afxRibbonComboBox.h

CMFCRibbonFontComboBox::BuildFonts

用字体填充功能区上的组合框。

void BuildFonts(
    int nFontType = DEVICE_FONTTYPE | RASTER_FONTTYPE | TRUETYPE_FONTTYPE,
    BYTE nCharSet = DEFAULT_CHARSET,
    BYTE nPitchAndFamily = DEFAULT_PITCH);

参数

nFontType
[in] 指定要添加的字体的字体类型。

nCharSet
[in] 指定要添加的字体的字符集。

nPitchAndFamily
[in] 指定要添加的字体的间距和系列。

CMFCRibbonFontComboBox::CMFCRibbonFontComboBox

构造并初始化 CMFCRibbonFontComboBox 对象。

CMFCRibbonFontComboBox(
    UINT nID,
    int nFontType = DEVICE_FONTTYPE | RASTER_FONTTYPE | TRUETYPE_FONTTYPE,
    BYTE nCharSet = DEFAULT_CHARSET,
    BYTE nPitchAndFamily = DEFAULT_PITCH,
    int nWidth = -1);

参数

nID
[in] 用户从组合框中选择项时执行的命令的命令 ID。

nFontType
[in] 指定要在组合框中显示的字体类型。有效选项是是 DEVICE_FONTTYPE、RASTER_FONTTYPE 和 TRUETYPE_FONTTYPE 或是它们的任何按位组合。

nCharSet
[in] 将组合框中的字体筛选为属于指定字符集的字体。

nPitchAndFamily
[in] 指定组合框中显示的字体的间距和系列。

nWidth
[in] 指定组合框的宽度（以像素为单位）。

备注

有关可能的 nFontType 参数值的详细信息，请参阅 Windows SDK 文档中的 EnumFontFamProc。

有关可分配给 nCharSet 的有效字符集以及可分配给 nPitchAndFamily 的有效值的详细信息，请参阅 Windows SDK 文档中的 LOGFONT。

CMFCRibbonFontComboBox::GetFontDesc

有关详细信息，请参阅所安装的 Visual Studio 的 C\atlmfc\src\mfc 文件夹中的源代码。

const CMFCFontInfo* GetFontDesc(int iIndex = -1) const;

参数

[in] iIndex

返回值

备注

CMFCRibbonFontComboBox::RebuildFonts

使用具有先前指定的字体类型、字符集以及间距和系列的字体填充功能区上的组合框。

void RebuildFonts();

注解

可以在此类的构造函数中指定要包含在功能区字体组合框中的字体类型、字符集以及字体间距和系列，或通过调用 CMFCRibbonFontComboBox::BuildFonts 来完成。

CMFCRibbonFontComboBox::SetFont

选择组合框中的指定字体。

BOOL SetFont(
    LPCTSTR lpszName,
    BYTE nCharSet = DEFAULT_CHARSET,
    BOOL bExact = FALSE);

参数

lpszName
指定要选择的字体的名称。

nCharSet
指定所选字体的字符集。

bExact
TRUE 指定在选择字体时字符集必须匹配；FALSE 指定在选择字体时可以忽略字符集。

返回值

如果找到并选择了指定的字体，则为非零；否则为零。

备注

CMFCRibbonFontComboBox::GetCharSet

返回指定字符集。

BYTE GetCharSet() const;

返回值

字符集（请参阅 Windows SDK 文档中的 LOGFONT）。

备注

CMFCRibbonFontComboBox::GetFontType

返回要在组合框中显示的字体类型。有效选项是是 DEVICE_FONTTYPE、RASTER_FONTTYPE 和 TRUETYPE_FONTTYPE 或是它们的任何按位组合。

int GetFontType() const;

返回值

字体类型（请参阅 Windows SDK 文档中的 EnumFontFamProc）。

备注

CMFCRibbonFontComboBox::GetPitchAndFamily

返回组合框中显示的字体的间距和系列。

BYTE GetPitchAndFamily() const;

通过