CRichEditCtrl::SetParaFormat

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

更新 : 2007 年 11 月

CRichEditCtrl オブジェクトの現在の選択の段落書式属性を設定します。

BOOL SetParaFormat(
   PARAFORMAT& pf 
);
BOOL SetParaFormat(
   PARAFORMAT2& pf 
);

パラメータ

pf
最初の形式では、新しい既定の段落書式属性を保持する PARAFORMAT 構造体へのポインタです。

2 番目の形式では、既定の段落書式属性を持ち、PARAFORMAT 構造体に対するリッチエディット 2.0 拡張機能である PARAFORMAT2 構造体へのポインタです。

戻り値

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

解説

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

詳細については、Windows SDK の EM_SETPARAFORMAT メッセージ、PARAFORMAT 構造体、および PARAFORMAT2 構造体の説明を参照してください。

使用例

PARAFORMAT pf;

// Modify the paragraph format so that the text is centered. 
pf.cbSize = sizeof(PARAFORMAT);
pf.dwMask = PFM_ALIGNMENT;
pf.wAlignment = PFA_CENTER;
m_myRichEditCtrl.SetParaFormat(pf);

// Verify the settings are what is expected.
m_myRichEditCtrl.GetParaFormat(pf);
ASSERT(pf.dwMask&PFM_ALIGNMENT);
ASSERT(pf.wAlignment == PFA_CENTER);