次の方法で共有


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

End キーの機能を模倣します。

構文

HRESULT EndKey(
  long Unit,
  long Extend,
  long *pDelta
);

パラメーター

Unit

型: long

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

説明
tomLine
[拡張] に応じて、カーソル位置またはアクティブな終点を選択範囲の最後の行の末尾に移動します。 既定値です。
tomStory
拡張に応じて、ストーリーの最後の行の末尾に挿入ポイントまたはアクティブな終点が移動します。
tomColumn
[拡張] に応じて、カーソルまたはアクティブな終点が選択範囲の最後の列の末尾に移動します。 これは、TOM エンジンがテーブルをサポートしている場合にのみ使用できます。
tomRow
[拡張] に応じて、選択範囲の最後の行の末尾に挿入ポイントまたはアクティブな末尾が移動します。 これは、TOM エンジンがテーブルをサポートしている場合にのみ使用できます。

Extend

型: long

選択範囲を変更する方法を示すフラグ。 Extend が 0 (または tomMove) の場合、 メソッドは選択範囲を挿入ポイントまで折りたたみます。 Extend が 1 (または tomExtend) の場合、メソッドはアクティブな終了を移動し、もう一方の端だけを残します。 既定値はゼロです。

pDelta

種類: long*

挿入ポイントまたはアクティブな末尾が移動される文字数を受け取る変数へのポインター。 このパラメーターには、null を指定できます。

戻り値

種類: HRESULT

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

リターン コード 説明
E_INVALIDARG
Unit は tomLine でも tomStory でもありません。
S_FALSE
何らかの理由で失敗しました。

解説

[拡張]を tomExtend (または 0 以外) に設定すると、押されている Shift キーに対応します。 UnittomLine に設定すると、Ctrl キーが押されていない場合に対応します。 UnittomStory に設定して Ctrl キーを押します。 pDelta パラメーターは、挿入ポイントまたはアクティブ終了が移動される文字数を受け取ります。

ITextSelection::HomeKey メソッドと ITextSelection::EndKey メソッドは、標準の Home/End キー動作を模倣するために使用されます。

tomLine 値は、Ctrl キーを押さずに Home キーまたは End キーの動作を模倣し、tomStory は Ctrl キーを押して動作を模倣します。 同様に、 tomMove は Shift キーを押 さずに Home キーまたは End キーの動作を模倣し、 tomExtend は Shift キーを押 して動作を模倣します。 したがって、 EndKey(tomStory) 選択範囲を関連付けられたストーリーの末尾の挿入ポイントに変換し EndKey(tomStory, tomExtend) 、選択範囲のアクティブな終了をストーリーの末尾に移動し、もう一方の終了位置に移動します。

HomeKey メソッドと EndKey メソッドは、方向メソッドではなく、Move* メソッドのような論理メソッドです。 したがって、関連する言語に依存します。 たとえば、アラビア語のテキストでは HomeKey は行の右端に移動しますが、英語のテキストでは左に移動します。 したがって、 HomeKeyEndKeyMoveLeft メソッドと MoveRight メソッドとは異なります。 また、 EndKey メソッドは、選択範囲の最後にある End プロパティ cp とは大きく異なることがあります。 HomeKeyEndKey、StartOf メソッドと EndOf メソッドとは異なり、アクティブな終了から拡張されるのに対し、 StartOf は Start から拡張され 、EndOf は End から拡張されます。

要件

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

関連項目

概念

EndOf

HomeKey

ITextSelection

移動

MoveLeft

MoveRight

リファレンス

StartOf

Text オブジェクト モデル