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 メッセージを送信します。

要求事項

こちらも参照ください

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODEの

WM_SETTEXT