EM_LIMITTEXT メッセージ
編集コントロールのテキスト制限を設定します。 テキスト制限は、ユーザーが編集コントロールに入力できるテキストの最大量 ( TCHAR単位) です。 このメッセージは、編集コントロールまたはリッチ エディット コントロールに送信できます。
編集コントロールと Microsoft Rich Edit 1.0 では、バイトが使用されます。 Microsoft Rich Edit 2.0 以降では、文字が使用されます。
パラメーター
-
wParam
-
ユーザーが入力できる TCHARの最大数。 ANSI テキストの場合、これはバイト数です。Unicode テキストの場合、これは文字数です。 この数値には、終端の null 文字は含まれません。
豊富な編集コントロール: このパラメーターが 0 の場合、テキストの長さは 64,000 文字に設定されます。
このパラメーターが 0 の場合、テキストの長さは、1 行の編集コントロールの場合は0x7FFFFFFE文字、複数行編集コントロールの場合は -1 に設定されます。
-
lParam
-
このパラメーターは使用されません。
戻り値
このメッセージは値を返しません。
解説
EM_LIMITTEXT メッセージは、ユーザーが入力できるテキストのみを制限します。 メッセージの送信時に編集コントロールに既に含まれているテキストには影響しません。また、 WM_SETTEXT メッセージによって編集コントロールにコピーされたテキストの長さにも影響しません。 アプリケーションで WM_SETTEXT メッセージを使用して、 EM_LIMITTEXTメッセージで 指定されているよりも多くのテキストを編集コントロールに配置する場合、ユーザーは編集コントロールの内容全体を編集できます。
EM_LIMITTEXTが呼び出される前に、ユーザーが編集コントロールに入力できるテキストの量の既定の制限は 32,767 文字です。
1 行編集コントロールの場合、テキスト制限は 0x7FFFFFFE バイトか wParam パラメーターの値のいずれか小さい方です。 複数行の編集コントロールの場合、この値は -1 バイトか wParam パラメーターの値のいずれか小さい方です。
リッチエディット: Microsoft Rich Edit 1.0 以降でサポートされています。 64,000 を超えるテキスト長の値には、メッセージ EM_EXLIMITTEXT を使用します。 リッチ エディット バージョンとさまざまなシステム バージョンの互換性については、「 Rich Edit Controls について」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| ヘッダー |
|
関連項目
-
参照
-
その他のリソース