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 |
|