Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Sets the character formatting attributes for new text in this CRichEditCtrl object.
BOOL SetDefaultCharFormat(
CHARFORMAT& cf
);
BOOL SetDefaultCharFormat(
CHARFORMAT2& cf
);
Parameters
cf
In the first version, a pointer to a CHARFORMAT structure containing the new default character formatting attributes.In the second version, a pointer to a CHARFORMAT2 structure, which is a Rich Edit 2.0 extension to the CHARFORMAT structure, containing the default character formatting attributes.
Return Value
Nonzero if successful; otherwise, 0.
Remarks
Only the attributes specified by the dwMask member of cf are changed by this function.
For more information, see the EM_SETCHARFORMAT message and the CHARFORMAT and CHARFORMAT2 structures in the Windows SDK.
Example
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);
Requirements
Header: afxcmn.h
See Also
Reference
CRichEditCtrl::GetDefaultCharFormat
CRichEditCtrl::SetSelectionCharFormat