CRichEditCtrl::SetSelectionCharFormat

發行項
06/10/2015

將文字的字元格式屬性在這 CRichEditCtrl 物件目前的選取範圍。

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

參數

cf
在第一個版本，為含有目前選取範圍的 CHARFORMAT 結構指標新字元格式化屬性。

在第二個版本，則 CHARFORMAT2 結構的指標，是 Rich Edit 2.0 擴充。 CHARFORMAT 結構，其中包含新的字元格式目前選取範圍的屬性。

傳回值

如果不是零，則成功，則為，否則為 0。

備註

這個函式變更 cf 的 dwMask 成員指定的屬性。

如需詳細資訊，請參閱 EM_SETCHARFORMAT 和 CHARFORMAT 和 CHARFORMAT2 結構在 Windows SDK。

範例

CHARFORMAT cf;

// Modify the selection format so that the selected text is  
// displayed in bold and not striked out.
cf.cbSize = sizeof(cf);
cf.dwMask = CFM_STRIKEOUT|CFM_BOLD;
cf.dwEffects = CFE_BOLD;
m_myRichEditCtrl.SetSelectionCharFormat(cf);

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