CRichEditCtrl::SetDefaultCharFormat

Article
03/04/2013

Définit les attributs de mise en forme de caractère pour le nouveau texte de cet objet d' CRichEditCtrl .

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

Paramètres

cf
Dans la première version, un pointeur vers une structure de CHARFORMAT contenant les nouveaux attributs de mise en forme de caractère par défaut.

Dans la deuxième version, un pointeur vers une structure de CHARFORMAT2 , qui est une extension riche de la modification 2,0 à la structure de CHARFORMAT , contenant les attributs de mise en forme de caractère par défaut.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon, 0.

Notes

Seuls les attributs spécifiés par le membre de dwMask d' cf sont modifiés par cette fonction.

Pour plus d'informations, consultez le message d' EM_SETCHARFORMAT et les structures de CHARFORMAT et de CHARFORMAT2 dans Kit de développement logiciel Windows.

Exemple

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);