CRichEditCtrl::SetDefaultCharFormat

项目
03/01/2013

设置新文本的字符格式属性本 CRichEditCtrl 对象。

BOOL SetDefaultCharFormat(
   CHARFORMAT& cf 
);
BOOL SetDefaultCharFormat(
   CHARFORMAT2& cf 
);

参数

cf
在第一个版本，转到包含新的默认字符格式设置属性的 CHARFORMAT 结构的指针。

在第二个版本，为 CHARFORMAT2 结构，的指针是rich edit 2.0扩展到 CHARFORMAT 结构，包含默认字符格式设置属性。

返回值

非零，如果成功;否则，0。

备注

此功能更改 cf 的 dwMask 成员指定的特性。

有关更多信息，请参见 EM_SETCHARFORMAT 消息和 CHARFORMAT 和 CHARFORMAT2 结构。Windows SDK。

示例

CHARFORMAT cf = {0};

// Modify the default character format so that all new
// text is striked out and not bold.
cf.cbSize = sizeof(cf);
cf.dwMask = CFM_STRIKEOUT|CFM_BOLD;
cf.dwEffects = CFE_STRIKEOUT;
m_myRichEditCtrl.SetDefaultCharFormat(cf);

// Verify the settings are what is expected.
m_myRichEditCtrl.GetDefaultCharFormat(cf);
ASSERT((cf.dwMask&(CFM_STRIKEOUT|CFM_BOLD)) == 
   (CFM_STRIKEOUT|CFM_BOLD));
ASSERT((cf.dwEffects&(CFE_STRIKEOUT|CFE_BOLD)) == CFE_STRIKEOUT);