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

  • [アーティクル]

開始位置の Count 文字内に文字が見つかった場合に、Cset で指定された文字セット内にある最初の文字の位置を範囲の開始位置に移動します。

構文

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

パラメーター

Cset

型: VARIANT*

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

Count

型: long

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

pDelta

種類: long*

範囲の先頭が移動される実際の文字数、 Count が 0 より大きい場合は一致する場合は 1、 Count が 0 未満の場合は一致する場合は –1。 値は null でもかまいません。

戻り値

種類: HRESULT

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

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

注釈

開始位置の Count 位置内に Cset の文字が見つからない場合、範囲は変更されません。

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

ITextRange::MoveStartUntil によって記述されるモーションは、ジオメトリックではなく論理的です。 つまり、動きは終わりに向かうか、物語の始まりに向かいます。 言語によっては、ストーリーの最後に移動すると、左または右に移動する可能性があります。

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

要件

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

関連項目

概念

ITextRange

移動

MoveUntil

リファレンス

Text オブジェクト モデル