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 [デスクトップ アプリのみ]
ヘッダー	Winuser.h (Windows.h を含む)

関連項目

参照

EM_EXLIMITTEXT

Edit_LimitText

その他のリソース

WM_SETTEXT