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 [デスクトップ アプリのみ] |
| ヘッダー |
|