ITextRange::MoveEndWhile メソッド (tom.h)

  • [アーティクル]

範囲の末尾を Count 文字または Cset で指定された文字のセットに含まれる連続するすべての文字の後に移動します。どちらか小さい方にします。

構文

HRESULT MoveEndWhile(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

パラメーター

Cset

型: VARIANT*

一致で使用する文字セット。 これは、文字の明示的な文字列または文字セット インデックスである可能性があります。 詳細については、「 文字一致セット」を参照してください。

Count

型: long

過去に移動する最大文字数。 既定値は tomForward で、ストーリーの末尾まで検索されます。 Count が 0 より大きい場合、検索は (ストーリーの末尾に向かって) 前方に移動します。 Count が 0 未満の場合、検索は (ストーリーの先頭に向かって) 後方に移動します。 Count が 0 の場合、終了位置は変更されません。

pDelta

型: long*

末尾が移動される実際の文字数。 値は null でもかまいません。

戻り値

型: HRESULT

メソッドは HRESULT 値を返します。 メソッドが成功すると、 S_OKが返されます。 メソッドが失敗した場合は、次のいずれかのエラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

リターン コード 説明
E_INVALIDARG
 Cset が無効です。
S_FALSE
 何らかの理由でエラーが発生しました。

解説

新しい終了が古い開始の前にある場合、新しい開始は新しい終了と同じに設定されます。

ITextRange::MoveEndWhile によって記述されるモーションは、幾何学的ではなく論理的です。 つまり、モーションは、ストーリーの末尾または開始に向かって行います。 言語によっては、ストーリーの最後に移動すると、左に移動したり、右に移動したりする場合があります。

詳細については、「 ITextRange 」および「 ITextRange::Move」を参照してください。

要件

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

関連項目

概念

ITextRange

移動

MoveWhile

リファレンス

Text オブジェクト モデル