ITextSelection インターフェイス (tom.h)
テキスト選択とは、選択範囲が強調表示されたテキスト範囲です。
継承
ITextSelection インターフェイスは ITextRange から継承されます。 ITextSelection には、次の種類のメンバーもあります。
メソッド
ITextSelection インターフェイスには、これらのメソッドがあります。
|
ITextSelection::EndKey End キーの機能を模倣します。 |
|
ITextSelection::GetFlags テキスト選択フラグを取得します。 |
|
ITextSelection::GetType テキスト選択の種類を取得します。 |
|
ITextSelection::HomeKey ホーム キーの機能を一般化します。 |
|
ITextSelection::MoveDown 下方向キーと下方向キーの機能を模倣します。 |
|
ITextSelection::MoveLeft 左方向キーの機能を一般化します。 |
|
ITextSelection::MoveRight →キーの機能を一般化します。 |
|
ITextSelection::MoveUp 上方向キーとページ上方向キーの機能を模倣します。 |
|
ITextSelection::SetFlags テキスト選択フラグを設定します。 |
|
ITextSelection::TypeText この選択時に bstr によって指定された文字列を、他のユーザーが入力したかのように入力します。 これは基になる SetText メソッドに似ていますが、オートコレクトやスマート クォートなどの Insert/Overtype キーの状態と UI 設定に依存します。 |
注釈
選択は何らかのビューに関連付けられ、キーボード入力をエミュレートできる UI 指向のメソッドがいくつかあります。 したがって、アプリケーションでは、 ITextRange メソッドと ITextSelection メソッドをテキスト選択に使用できます。
キーボード入力エミュレーションの場合、選択範囲で使用される範囲では、 アクティブエンドの概念が使用されます。これは通常、最後に移動された終了です。 たとえば、 ITextRange::Move* メソッドが実際にテキストの選択範囲である範囲に対して動作する場合、最後に移動した末尾はアクティブになります。 アクティブエンドの最も使い慣れた例は、Shift + 方向キーの処理を伴うものであり、アクティブエンドは移動する端です。 したがって、 ITextSelection メソッドには、 MoveLeft や MoveRight などのアクティブ終了の move メソッドと、アクティブな終了状態を取得および設定するためのメソッドが含まれます。 これらのメソッドは、標準のカーソル キーパッド操作と同様の方法で選択を操作します。 これにより、マクロ レコーダー機能などを実装できます。
カーソル キーパッドメソッドの動作を確認するには、次の表を参照してください。 指定されたメソッドは、Ctrl キーと Shift キーを持つカーソル キーパッド キーに対応します。 Unit パラメーターは Ctrl キーを押すか押さないかによって選択され、Extend パラメーターは Shift キーを押すか押さないで選択されます。 MoveUp キーと MoveDown キーは、複数のキーパッド キーに対応しています。 詳細については、メソッドの説明を参照してください。
| メソッド | カーソル キーパッド キー | Ctrl キーを押した (押されていない) 単位 | Shift キーを押して指定された拡張 (押されていない) |
|---|---|---|---|
| EndKey | End | tomStory (tomLine) | tomExtend (tomMove) |
| HomeKey | ホーム | tomStory (tomLine) | tomExtend (tomMove) |
| MoveLeft | ← | tomWord (tomCharacter) | tomExtend (tomMove) |
| MoveRight | → キー | tomWord (tomCharacter) | tomExtend (tomMove) |
| MoveUp | ↑ キー | tomParagraph (tomLine) | tomExtend (tomMove) |
| MoveDown | ↓ キー | tomParagraph (tomLine) | tomExtend (tomMove) |
| MoveUp | PageUp | tomWindow (tomScreen) | tomExtend (tomMove) |
| MoveDown | PageDown | tomWindow (tomScreen) | tomExtend (tomMove) |
通常、アプリケーションは ITextSelection インターフェイスを実装しません。 代わりに、リッチ エディット コントロールなどの Microsoft テキスト ソリューションでは、テキスト オブジェクト モデル (TOM) 実装の一部として ITextSelection が実装されます。
アプリケーションは、GetSelection メソッドを呼び出すことによって 、ITextSelection ポインターを 取得 できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | tom.h |