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

  • [アーティクル]

下方向キーと下方向キーの機能を模倣します。

構文

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

パラメーター

Unit

型: long

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

値 対応するキーの組み合わせ 意味
tomLine ↓ キー 1 行下に移動します。 既定値です。
tomParagraph Ctrl + ↓ 1 段落下に移動します。
tomScreen PageDown 1 画面下に移動します。
tomWindow Ctrl + Page Down ウィンドウの最後の文字に移動します。

Count

型: long

過去に移動する単位数。 既定値は 1 です。

Extend

型: long

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

pDelta

種類: long*

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

戻り値

種類: HRESULT

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

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

注釈

ITextSelection::MoveUp メソッドと ITextSelection::MoveDown メソッドは ITextSelection::MoveLeft メソッドと ITextSelection::MoveRight メソッドに似ていますが、カーソル キーパッドの上方向キー、下方向キー、ページ上方向キー、および Page Down キーの動作が反映されている点が異なります。

要件

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

関連項目

概念

ITextSelection

MoveLeft

MoveRight

MoveUp

リファレンス

Text オブジェクト モデル