EM_SETCHARFORMAT メッセージ

  • [アーティクル]

リッチ エディット コントロールの文字書式を設定します。

パラメーター

wParam

コントロールに適用される文字書式。 このパラメーターが 0 の場合、既定の文字形式が設定されます。 それ以外の場合は、次のいずれかの値を指定できます。

値 説明
SCF_ALL
 コントロール内のすべてのテキストに書式を適用します。 SCF_SELECTIONまたはSCF_WORDでは無効です。
SCF_ASSOCIATEFONT
 RichEdit 4.1: 特定のスクリプトにフォントを関連付け、そのスクリプトの既定のフォントを変更します。 フォントを指定するには、 CHARFORMAT2 の yHeight、 bCharSet、 bPitchAndFamily、 szFaceName、 lcid のメンバーを使用します。
SCF_ASSOCIATEFONT2
 RichEdit 4.1: サロゲート (plane-2) フォントを特定のスクリプトに関連付け、そのスクリプトの既定のフォントを変更します。 フォントを指定するには、 CHARFORMAT2 の yHeight、 bCharSet、 bPitchAndFamily、 szFaceName、 lcid のメンバーを使用します。
SCF_CHARREPFROMLCID
 LCID から文字のレパートアを取得します。
SCF_DEFAULT
 RichEdit 4.1: コントロールの既定のフォントを設定します。
SPF_DONTSETDEFAULT
 リッチ エディット コントロールが空の場合に、既定の段落書式を設定できないようにします。
SCF_NOKBUPDATE
 RichEdit 4.1: フォントに合わせてキーボードを切り替えないようにします。 たとえば、アラビア語のフォントが設定されている場合、通常、Bidi 言語の自動キーボード機能は、キーボードをアラビア語のキーボードに変更します。
SCF_SELECTION
 現在の選択範囲に書式を適用します。 選択範囲が空の場合、文字書式はカーソルに適用され、新しい文字書式はカーソルが変更されるまで有効になります。
SPF_SETDEFAULT
 既定の段落書式属性を設定します。
SCF_SMARTFONT
 スクリプトを処理できる場合にのみフォントを適用します。
SCF_USEUIRULES
 RichEdit 4.1:SCF_SELECTIONで使用されます。 書式がツール バーまたはその他の UI ツールから取得されたことを示します。そのため、リテラルの書式設定の代わりに UI 書式設定ルールを使用する必要があります。
SCF_WORD
 選択した単語に書式を適用します。 選択範囲が空で、カーソルが単語内にある場合は、その単語に書式が適用されます。 SCF_WORD値は、SCF_SELECTION値と組み合わせて使用する必要があります。

lParam

使用する文字書式を指定する CHARFORMAT 構造体へのポインター。 dwMask メンバーによって指定された書式設定属性のみが変更されます。

Microsoft Rich Edit 2.0 以降: このパラメーターには、CHARFORMAT 構造体の拡張機能である CHARFORMAT2構造体への ポインターを指定できます。 EM_SETCHARFORMAT メッセージを送信する前に、構造体の cbSize メンバーを にsizeof(CHARFORMAT)設定するか、使用sizeof(CHARFORMAT2)されている構造体のバージョンを示します。

文字に対して無効な場合、 szFaceName メンバーと bCharSet メンバーが無効になる場合があります(例: 漢字の Arial)。

戻り値

操作が成功した場合、戻り値は 0 以外の値になります。

操作が失敗した場合、戻り値は 0 です。

解説

このメッセージが同じパラメーターで複数回送信される場合、テキストへの影響は切り替えられます。 つまり、メッセージを 1 回送信すると効果が生成され、メッセージを 2 回送信すると効果が取り消されます。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー
Richedit.h

関連項目

参照

Charformat

CHARFORMAT2