CRichEditCtrl::SetDefaultCharFormat

Artikel
06/10/2015

Legt die Zeichenformatierungsattribute für neuen Text in diesem CRichEditCtrl-Objekt fest.

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

Parameter

cf
In der ersten Version ein Zeiger auf eine CHARFORMAT-Struktur, die die neuen Standardzeichenformatierungsattribute enthält.

In der zweiten Version schreibt ein Zeiger auf eine Struktur CHARFORMAT2, die umfassende Edit 2.0-Erweiterung zur CHARFORMAT-Struktur ist, die Standardzeichenformatierung zu enthalten.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; andernfalls 0.

Hinweise

Nur die Attribute, die vom dwMask-Member von cf angegeben werden, werden von dieser Funktion geändert.

Weitere Informationen finden Sie unter EM_SETCHARFORMAT die Meldung und die CHARFORMAT und CHARFORMAT2-Strukturen in Windows SDK.

Beispiel

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