ITextHost::TxGetMaxLength メソッド (textserv.h)

  • [アーティクル]

テキスト ホストのテキストに許容される最大長を取得します。

構文

HRESULT TxGetMaxLength(
  DWORD *plength
);

パラメーター

plength

種類: DWORD*

許容される最大テキスト長 (文字数)。 INFINITE が返された場合、テキスト サービス オブジェクトは、指定したテキストを格納するために必要な量のメモリを使用できます。

戻り値

種類: HRESULT

戻り値は S_OK。

解説

この最大値に達すると、テキスト サービス オブジェクトは、それ以上の文字挿入と貼り付けテキストを拒否する必要があります。 ただし、TxSetText では、最大長より長いテキストを受け入れる (および設定する) 必要があります。 これは、このメソッドはバインドに使用され、コントロールがバインドされるデータの整合性を維持するために重要であるためです。

このメソッドは、 EM_LIMITTEXT メッセージを並列化します。

返される制限がテキスト サービス オブジェクト内の現在の文字数より小さい場合、データは失われません。 代わりに、テキストが制限を下回るまで、削除 以外 のテキストに対する編集は許可されません。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー textserv.h
[DLL] Msftedit.dll

関連項目

概念

EM_LIMITTEXT

ITextHost

リファレンス

ウィンドウレスリッチエディットコントロール