EM_SETLIMITTEXT メッセージ

  • [アーティクル]

編集コントロールのテキスト制限を設定します。 テキスト制限は、ユーザーが編集コントロールに入力できるテキストの最大量 ( TCHAR単位) です。 このメッセージは、編集コントロールまたはリッチ エディット コントロールのいずれかに送信できます。

編集コントロールと Microsoft Rich Edit 1.0 では、バイトが使用されます。 Microsoft Rich Edit 2.0 以降では、文字が使用されます。

EM_SETLIMITTEXT メッセージは、EM_LIMITTEXT メッセージと同じです。

パラメーター

wParam

ユーザーが入力できる TCHARの最大数。 ANSI テキストの場合、これはバイト数です。Unicode テキストの場合、これは文字数です。 この数値には、終端の null 文字は含まれません。

リッチ エディット コントロール: このパラメーターが 0 の場合、テキストの長さは 64,000 文字に設定されます。

このパラメーターが 0 の場合、テキストの長さは、1 行の編集コントロールの場合は0x7FFFFFFE文字、複数行編集コントロールの場合は 1 に設定されます。

lParam

このパラメーターは使用されません。

戻り値

このメッセージは値を返しません。

解説

EM_SETLIMITTEXT メッセージでは、ユーザーが入力できるテキストのみが制限されます。 メッセージの送信時に編集コントロールに既に含まれているテキストには影響しません。また、WM_SETTEXT メッセージによって編集コントロールにコピーされたテキストの長 さ にも影響しません。 アプリケーションで WM_SETTEXT メッセージを使用して、EM_SETLIMITTEXT メッセージで指定されているよりも多くのテキストを編集コントロールに配置する場合、ユーザーは編集コントロールの内容全体を編集できます。

EM_SETLIMITTEXTが呼び出される前に、ユーザーが編集コントロールに入力できるテキストの量の既定の制限は 32,767 文字です。

1 行の編集コントロールの場合、テキストの制限は 0x7FFFFFFE バイトか 、wParam パラメーターの値のいずれか小さい方です。 複数行の編集コントロールの場合、この値は 1 バイトか wParam パラメーターの値のいずれか小さい方です。

リッチ エディット: Microsoft Rich Edit 1.0 以降でサポートされています。 64,000 を超えるテキスト長の値には、メッセージ EM_EXLIMITTEXT を使用します。 リッチ エディット バージョンとさまざまなシステム バージョンの互換性については、「 リッチ エディット コントロールについて」を参照してください。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー
Winuser.h (Windows.h を含む)

関連項目

EM_GETLIMITTEXT