ITextSelection::MoveRight メソッド (tom.h)

→キーの機能を一般化します。

構文

HRESULT MoveRight(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

パラメーター

Unit

型: long

使用する単位。 次のいずれかになります。

値	対応するキーの組み合わせ	意味
tomCharacter	→ キー	1 文字の位置を右に移動します。 既定値です。
tomWord	Ctrl + →	1 つの単語を右に移動します。

 

Count が 0 未満の場合、移動は左に移動します。

Count

型: long

過去に移動する単位数。 既定値は 1 です。 Count が 0 未満の場合、移動は左に移動します。

Extend

型: long

選択範囲を変更する方法を示すフラグ。 Extend が 0 (または tomMove) の場合、メソッドは選択範囲をアクティブな終点の挿入ポイントに折りたたんでから移動します。 Extend が 1 (または tomExtend) の場合、メソッドはアクティブな終了を移動し、もう一方の端だけを残します。 既定値はゼロです。 0 以外の Extend 値は、 Unit で説明されているキーの組み合わせに加えて、押されている Shift キーに対応します。

pDelta

種類: long*

挿入ポイントまたはアクティブ終了が左に移動する単位の実際の数。 このパラメーターには、null を指定できます。 選択範囲を折りたたむと、 Extend が 0 の場合、1 つの単位としてカウントされます。

戻り値

種類: HRESULT

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

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

注釈

CharRight、CharLeft、WordRight、WordLeft などの Microsoft WordBasic の移動メソッドは、標準の方向キー編集動作に密接に関連する 4 つの操作を実行できるハイブリッドです。

• 選択されていない場合は、現在の挿入ポイントを移動します。
• 選択範囲がある場合は、選択範囲のアクティブな終了位置を移動します。
• 挿入ポイントを選択範囲に変換します。その逆も同様です。
• 移動が発生したかどうかを示すブール値を返します。

MoveLeft および MoveRight の Extend 引数を使用すると、上記の最初の 3 つの項目と一貫性を保ち、pDelta は 4 番目の一般化です。 たとえば、1 つの範囲で構成される選択範囲 s を指定すると、次の対応付けがあります (左から右の文字の場合)。

ITextSelection	Wordbasic	機能
s.MoveRight tomWord, 1, 1	WordRight 1,1	アクティブな末尾を 1 単語右に移動します。
s.MoveLeft tomCharacter、1、1	CharLeft 1,1	アクティブな末尾を 1 文字左に移動します。

 

WordBasic と同様に、 Count が 0 未満の場合、左と右の意味が切り替えられます。これは MoveLeft (Unit, Count, Extend) と同じです MoveRight(Unit, -Count, Extend)。

WordBasic および →キー UI の動作と同様に、縮退した選択範囲で を呼び出すと MoveRight(Unit, Count) 、指定した単位数だけ挿入ポイントが移動します。 縮退範囲では、 が 0 より大きいをCount呼び出すとMoveRight(Unit, Count, 1)、右端がアクティブな終了と共に範囲が非生成になります。

Extend が tomExtend (または 0 以外) の場合、MoveRight は選択範囲のアクティブな終了部分のみを移動し、もう一方の端は移動します。 ただし、Extend が 0 に等しく、選択範囲が非生成範囲として開始された場合、 が Count 0 より大きい場合、MoveRight(Unit, Count)アクティブな終了 Count - 1 単位が右に移動し、もう一方の端がアクティブな終了位置に移動します。 言い換えると、アクティブな終点に挿入ポイントが作成されます。 範囲を折りたたむには、1 つの単位としてカウントされます。 したがって、 MoveRight(tomCharacter) 非生成の選択範囲を、選択範囲の右端にある縮退した選択範囲に変換します。 ここで、 Count の既定値は 1 で、 Extend の既定値は 0 です。 この例は、右方向キーを押すことに対応しています。 MoveLeft と MoveRight は ITextRange 移動メソッドに関連していますが、アクティブな終了 (Shift キーを押して移動した終了) を明示的に使用する点は異なります。

要件

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

関連項目

概念

ITextRange

ITextSelection

MoveLeft

リファレンス

Text オブジェクト モデル