EM_SETTEXTMODE メッセージ

リッチ エディット コントロールのテキスト モードまたは元に戻すレベルを設定します。 コントロールにテキストが含まれている場合、メッセージは失敗します。

パラメーター

wParam

TEXTMODE 列挙型の 1 つ以上の値。 値は、コントロールのテキスト モードと元に戻すレベルのパラメーターの新しい設定を指定します。

テキスト モード パラメーターを設定するには、次のいずれかの値を指定します。 テキスト モードの値を指定しない場合、テキスト モードは現在の設定のままです。

値	説明
TM_PLAINTEXT	コントロールが標準の編集コントロールに似ているプレーン テキスト モードを示します。 プレーン テキスト モードの詳細については、次の「解説」セクションを参照してください。
TM_RICHTEXT	コントロールに標準のリッチ エディット機能があるリッチ テキスト モードを示します。 リッチ テキスト モードが既定の設定です。

元に戻すレベル パラメーターを設定するには、次のいずれかの値を指定します。 元に戻すレベルの値を指定しない場合、元に戻すレベルは現在の設定のままです。

値	説明
TM_SINGLELEVELUNDO	コントロールを使用すると、ユーザーは元に戻すことができる最後の操作のみを元に戻すことができます。
TM_MULTILEVELUNDO	コントロールでは、複数の元に戻す操作がサポートされています。 これが既定の設定です。 EM_SETUNDOLIMIT メッセージを使用して、元に戻す操作の最大数を設定します。

コード ページ パラメーターを設定するには、次のいずれかの値を指定します。 コード ページの値を指定しない場合、コード ページは現在の設定のままです。

値	説明
TM_SINGLECODEPAGE	コントロールでは、英語キーボードと、既定の文字セットに対応するキーボードのみが許可されます。 たとえば、ギリシャ語と英語を使用できます。 これにより、Unicode テキストがコントロールに入力できなくなることに注意してください。 たとえば、リッチ エディット コントロールを ANSI テキストに制限する必要がある場合は、この値を使用します。
TM_MULTICODEPAGE	コントロールでは、複数のコード ページと Unicode テキストをコントロールに挿入できます。 これが既定の設定です。

lParam

このパラメーターは使用されません。0 にする必要があります。

戻り値

メッセージが成功した場合、戻り値は 0 です。

メッセージが失敗した場合、戻り値は 0 以外の値になります。

解説

リッチ テキスト モードでは、リッチ エディット コントロールには標準のリッチ エディット機能があります。 ただし、プレーン テキスト モードでは、コントロールは標準の編集コントロールに似ています。

• プレーン テキスト コントロール内のテキストの書式は 1 つだけです (太字、10pt Arial など)。
• リッチ テキスト形式 (RTF) や埋め込みオブジェクトなどのリッチ テキスト形式をプレーン テキスト コントロールに貼り付けることはできません。
• リッチ テキスト モード コントロールには、段落の書式を設定するための既定のドキュメント終了マーカーまたは復帰が常に用意されています。 一方、プレーン テキスト コントロールでは、既定のドキュメントの終わりマーカーは必要ないため、省略されます。

コントロールは、 EM_SETTEXTMODE メッセージを受信するときにテキストを含めてはなりません。 テキストがないことを確認するには、空の文字列 ("") を 含むWM_SETTEXT メッセージを送信します。

必要条件

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

関連項目

EM_GETTEXTMODE

EM_SETUNDOLIMIT

Textmode

WM_SETTEXT