CRichEditCtrl::SetSelectionCharFormat

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CRichEditCtrl オブジェクトの現在の選択のテキストの文字書式属性を設定します。

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

パラメータ

cf
最初の形式では、現在の選択の新しい文字書式属性を保持する CHARFORMAT 構造体へのポインタです。

2 番目の形式では、現在の選択の新しい文字書式属性を含む、CHARFORMAT 構造体に対するリッチエディット 2.0 拡張機能である CHARFORMAT2 構造体へのポインタです。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

この関数は、cf の dwMask メンバで指定された属性だけを変更します。

詳細については、Windows SDK の EM_SETCHARFORMAT、CHARFORMAT 、および CHARFORMAT2 の各構造体の説明を参照してください。

使用例

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