CRichEditCtrl::SetSelectionCharFormat

Artikel
02/26/2013

Legt die Zeichenformatierungsattribute für den Text in der aktuellen Auswahl in diesem CRichEditCtrl-Objekt fest.

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

Parameter

cf
In der ersten Version ein Zeiger auf eine CHARFORMAT-Struktur, die die neuen Zeichenformatierungsattribute für die aktuelle Auswahl enthält.

In der zweiten Version ein Zeiger auf eine Struktur CHARFORMAT2, die umfassende Edit 2.0-Erweiterung zur CHARFORMAT-Struktur ist, die neuen Zeichenformatierungsattribute für die aktuelle Auswahl 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 und die CHARFORMAT und CHARFORMAT2-Strukturen in Windows SDK.

Beispiel

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