CRichEditCtrl::SetDefaultCharFormat

Articolo
02/19/2013

Imposta gli attributi di formattazione dei caratteri per nuovo testo nell'oggetto CRichEditCtrl.

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

Parametri

cf
Nella prima versione, un puntatore a una struttura CHARFORMAT contenente i nuovi attributi di formattazione carattere predefiniti.

Nella seconda versione, un puntatore a una struttura CHARFORMAT2, che è un'estensione Rich Edit 2,0 alla struttura CHARFORMAT, contenente gli attributi di formattazione carattere predefiniti.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario, 0.

Note

Solo gli attributi specificati dal membro dwMaskcf vengono modificati dalla funzione.

Per ulteriori informazioni, vedere il messaggio EM_SETCHARFORMAT e le strutture CHARFORMAT2 e CHARFORMAT in Windows SDK.

Esempio

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