Selection インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ウィンドウまたはウィンドウ枠の現在の選択範囲を表します。
public interface class Selection[System.Runtime.InteropServices.Guid("00020975-0000-0000-C000-000000000046")]
public interface Selectiontype Selection = interfacePublic Interface Selection- 属性
注釈
選択範囲はドキュメントで選択 (強調表示) されている領域を表すか、ドキュメントで何も選択されていない場合は挿入ポイントを表します。 文書ウィンドウ ウィンドウごとに存在できる Selection オブジェクトは 1 つだけであり、アプリケーション全体でアクティブにできる Selection オブジェクトは 1 つだけです。
Selection プロパティを使用して、Selection オブジェクトを返します。 Selection プロパティでオブジェクト修飾子が使用されていない場合、Microsoft Word はアクティブなドキュメント ウィンドウのアクティブなウィンドウから選択を返します。
現在の選択にアクセスするために文書がアクティブである必要はありません。
Text プロパティを使用して、現在の選択範囲のテキストを設定または返します。
Selection オブジェクトには、次の操作を行うことができるさまざまなメソッドとプロパティがあります。
現在の選択を折りたたんだり、展開したり、変更したりする
文書内の選択したテキストを編集する
現在の選択範囲の書式を変更する
Flags、Information[WdInformation]、Type などのプロパティを使用して、現在の選択に関する情報を返します。
選択範囲がカーソル位置まで折りたたまれていても、その選択範囲は必ずしも空ではありません。 たとえば、Text プロパティは、挿入ポイントの右側の文字を返します。この文字は、Selection オブジェクトのCharactersコレクションにも表示されます。 ただし、折りたたまれた選択範囲から Cut() や Copy() などのメソッドを呼び出すと、エラーが発生します。
ユーザーが、連続するテキストを表していない文書内の領域を選択することができます (たとえば、Alt キーをマウスで使用する場合)。 このような選択の動作は予測できない可能性があるため、操作を実行する前に選択範囲の Type プロパティをチェックする手順をコードに含めることができます。 同様に、表のセルを含む選択範囲により、予測できない動作が発生する可能性もあります。 Information[WdInformation] プロパティは、選択範囲がテーブル内にあるかどうかを示します。
Rangeオブジェクトは、Selection オブジェクトと同じメソッドとプロパティの多くを共有しているため、現在の選択範囲を物理的に変更する理由がないときにドキュメントを操作するには、Range オブジェクトを使用することをお勧めします。
プロパティ
| 名前 | 説明 |
|---|---|
| Active |
指定したウィンドウまたはウィンドウ内の選択がアクティブかどうかを確認します。 |
| Application |
Microsoft Word アプリケーションを表す _Application オブジェクトを返します。 |
| BookmarkID |
指定した選択範囲の先頭を囲むブックマークの数を返します。または、対応するブックマークがない場合は 0 を返します。 |
| Bookmarks |
選択範囲内のすべてのブックマークを表す Bookmarks コレクションを返します。 |
| Borders |
指定したオブジェクトのすべての縁取りを表す Borders コレクションを返します。 |
| Cells |
選択範囲内のテーブル セルを表す Cells コレクションを返します。 |
| Characters |
選択範囲内の文字を表す Characters コレクションを返します。 |
| ChildShapeRange |
選択範囲の子図形を表す ShapeRange オブジェクトを返します。 |
| Columns |
選択範囲内のすべてのテーブル列を表す Columns コレクションを返します。 |
| ColumnSelectMode |
列選択モードがアクティブかどうかを確認します。 |
| Comments |
指定した選択範囲内のすべてのコメントを表す Comments コレクションを返します。 |
| ContentControls |
範囲内に含まれるコンテンツ コントロールを表す ContentControls コレクションを返します。 読み取り専用です。 |
| Creator |
指定されたオブジェクトを作成したアプリケーションを示す 32 ビットの整数を取得します。 |
| Document |
指定した選択に関連付けられている Document オブジェクトを返します。 |
| Editors |
ドキュメント内の選択範囲を変更する権限を持つすべてのユーザーを表す Editors オブジェクトを返します。 |
| End |
選択範囲の末尾の文字位置を設定または返します。 |
| EndnoteOptions |
選択範囲内の文末脚注を表す EndnoteOptions オブジェクトを返します。 |
| Endnotes |
選択範囲内のすべての文末脚注を表す Endnotes コレクションを返します。 |
| EnhMetaFileBits |
選択したテキストの表示方法を画像表現する オブジェクト を返します。 |
| ExtendMode |
拡張モードがアクティブかどうかを確認します。 |
| Fields |
選択範囲内のすべてのフィールドを表す読み取り専用の Fields コレクションを返します。 |
| Find |
検索操作の条件が含まれる Find オブジェクトを返します。 |
| FitTextWidth |
幅 (現在の計測単位) を収めるテキストの現在の選択範囲を設定または返します。 |
| Flags |
選択範囲のプロパティを設定または返します。 |
| Font |
指定したオブジェクトの文字書式を表す Font オブジェクトを返すか設定します。 |
| FootnoteOptions |
選択範囲内の脚注プロパティを表す FootnoteOptions オブジェクトを返します。 |
| Footnotes |
選択範囲内のすべての脚注を表す Footnotes コレクションを返します。 |
| FormattedText |
指定した選択範囲に書式設定済みのテキストが含まれる Range オブジェクトを返すか設定します。 |
| FormFields |
選択範囲内のすべてのフォーム フィールドを表す FormFields コレクションを返します。 |
| Frames |
選択範囲内のすべてのフレームを表す Frames コレクションを返します。 |
| HasChildShapeRange |
選択範囲に子図形が含まれているかどうかを判別します。 |
| HeaderFooter |
指定した選択範囲の HeaderFooter オブジェクトを返します。 |
| HTMLDivisions |
Web ドキュメント内の HTML 除算を表す HTMLDivisions オブジェクトを返します。 |
| Hyperlinks |
指定した選択範囲内のすべてのハイパーリンクを表す Hyperlinks コレクションを返します。 |
| Information[WdInformation] |
指定した選択または範囲に関する情報を返します。 |
| InlineShapes |
選択範囲内のすべての InlineShape オブジェクトを表すInlineShapesコレクションを返します。 |
| IPAtEndOfLine |
カーソルが次の行に折り返される行の末尾にあるかどうかを指定します。 |
| IsEndOfRowMark |
指定した選択範囲が折りたたまれていて、テーブルの行末マークに位置しているかどうかを確認します。 |
| LanguageDetected |
取得または Microsoft Word が指定したテキストの言語を検出するかどうかを指定する値を設定します。 |
| LanguageID |
オブジェクトの言語を示します。 |
| LanguageIDFarEast |
指定したオブジェクトの東アジア言語を設定または返します。 |
| LanguageIDOther |
オブジェクトの言語を示します。 |
| NoProofing |
スペル チェックと文章校正で指定されたテキストが無視されるかどうかを判別します。 |
| OMaths | |
| Orientation |
取得またはテキストの方向の機能を有効にすると、選択範囲内のテキストの方向を設定します。 |
| PageSetup |
指定した選択に関連付けられている PageSetup オブジェクトを返します。 |
| ParagraphFormat |
指定した選択範囲の段落設定を表す ParagraphFormat オブジェクトを返すか設定します。 |
| Paragraphs |
指定した選択範囲内のすべての段落を表す Paragraphs コレクションを返します。 |
| Parent |
指定されたオブジェクトの親オブジェクトを表すオブジェクトを取得します。 |
| ParentContentControl |
指定した範囲のコンテンツ コントロールの親を表す ContentControl オブジェクトを返します。 読み取り専用です。 |
| PreviousBookmarkID |
指定した選択範囲の前または同じ場所で始まる最後のブックマークの数を返します。または、対応するブックマークがない場合は 0 (ゼロ) を返します。 |
| Range |
指定されたオブジェクトに含まれるドキュメントの一部を表す Range オブジェクトを返します。 |
| Rows |
選択範囲内のすべてのテーブル行を表す Rows コレクションを返します。 |
| Sections |
指定した選択セクションのセクションを表す Sections コレクションを返します。 |
| Sentences |
選択範囲内のすべての文を表す Sentences コレクションを返します。 |
| Shading |
指定されたオブジェクトのシェーディング書式を参照する Shading オブジェクトを返します。 |
| ShapeRange |
指定した範囲または選択範囲内のすべてのShape オブジェクトを表すShapeRangeコレクションを返します。 |
| SmartTags |
ドキュメント内のスマート タグを表す SmartTags オブジェクトを返します。 |
| Start |
選択範囲の開始文字位置を返すか設定します。 |
| StartIsActive |
選択範囲の先頭がアクティブかどうかを確認します。 |
| StoryLength |
指定された選択範囲を含むストーリーの文字数を返します。 |
| StoryType |
指定された選択範囲のストーリーの種類を返します。 |
| Style |
指定したオブジェクトのスタイルを設定または返します。 |
| Tables |
指定した選択範囲内のすべてのテーブルを表す Tables コレクションを返します。 |
| Text |
取得または指定された選択範囲のテキストを設定します。 |
| TopLevelTables |
現在の選択範囲の最も外側の入れ子レベルでテーブルを表す Tables コレクションを返します。 |
| Type |
選択範囲の種類を取得します。 |
| WordOpenXML |
Microsoft Office Word Open XML 形式で、選択範囲に含まれる XML を表す文字列を返します。 読み取り専用です。 |
| Words |
選択範囲内のすべての単語を表す Words コレクションを返します。 |
| XML[Boolean] |
指定されたオブジェクト内の XML テキストを表す 文字列 を返します。 |
| XMLNodes |
このオブジェクト、メンバー、または列挙体は非推奨です。ユーザーのコード内で使用されるものではありません。 |
| XMLParentNode |
このオブジェクト、メンバー、または列挙体は非推奨です。ユーザーのコード内で使用されるものではありません。 |
メソッド
| 名前 | 説明 |
|---|---|
| BoldRun() |
現在の run に対して、太字の文字書式を追加または削除します。 |
| Calculate() |
選択範囲内の数式を計算します。 |
| ClearCharacterAllFormatting() |
選択した文字列からすべての文字書式 (文字スタイルを使用して適用した書式または手動で適用した書式) を削除します。 |
| ClearCharacterDirectFormatting() |
選択したテキストから文字書式 (リボンのボタンまたはダイアログ ボックスを使用して手動で適用した書式) を削除します。 |
| ClearCharacterStyle() |
選択した文字列から、文字スタイルを使用して適用した文字書式を削除します。 |
| ClearFormatting() |
選択範囲から文字列および段落の書式を削除します。 |
| ClearParagraphAllFormatting() |
選択した文字列からすべての段落書式 (段落スタイルを使用して適用した書式または手動で適用した書式) を削除します。 |
| ClearParagraphDirectFormatting() |
選択したテキストから、手動で (リボンのボタンまたはダイアログ ボックスを使用して) 適用した段落書式を削除します。 |
| ClearParagraphStyle() |
選択した文字列から、段落スタイルを使用して適用した段落書式を削除します。 |
| Collapse(Object) |
選択を解除します。 |
| ConvertToTable(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
選択範囲内のテキストを表に変換します。 |
| ConvertToTableOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
内部使用のため予約済みです。 |
| Copy() |
指定したオブジェクトをクリップボードにコピーします。 |
| CopyAsPicture() |
指定したオブジェクトをクリップボードにコピーします。 |
| CopyFormat() |
選択した文字列の最初の文字の書式をコピーします。 |
| CreateAutoTextEntry(String, String) |
現在の選択に基づいて、AutoTextEntriesコレクションに新しい AutoTextEntry オブジェクトを追加します。 |
| CreateTextbox() |
選択範囲の周りに、既定の大きさのテキスト ボックスを追加します。 |
| Cut() |
文書から指定されたオブジェクトを切り取り、クリップボードに貼り付けます。 |
| Delete(Object, Object) |
指定された数だけ文字または単語を削除します。 |
| DetectLanguage() |
指定された文字列を分析して、どの言語で記述されているかを判別します。 |
| EndKey(Object, Object) |
選択範囲を指定された単位の末尾まで移動または拡張します。 |
| EndOf(Object, Object) |
選択範囲の終了文字位置を、最も近い指定されたテキスト単位の末尾まで移動または拡張します。 |
| EscapeKey() |
Cancels a mode such as extend or column select (equivalent to pressing the ESC key). |
| Expand(Object) |
指定した選択範囲を展開します。 |
| ExportAsFixedFormat(String, WdExportFormat, Boolean, WdExportOptimizeFor, Boolean, WdExportItem, Boolean, Boolean, WdExportCreateBookmarks, Boolean, Boolean, Boolean, Object) |
PDF または XPS ファイル形式としては、現在の選択範囲を保存します。 . |
| Extend(Object) |
拡張モードをオンにするか、拡張モードが既にオンになっている場合は、選択範囲を次に大きなテキスト単位まで拡張します。 |
| GoTo(Object, Object, Object, Object) |
指定した項目の直前の文字位置にカーソルを移動します。 |
| GoToEditableRange(Object) |
指定したユーザーまたはユーザー グループが変更できるドキュメントの領域を表す Range オブジェクトを返します。 |
| GoToNext(WdGoToItem) |
|
| GoToPrevious(WdGoToItem) |
前の項目の開始位置または指定した場所を参照する Range オブジェクトを返します。 |
| HomeKey(Object, Object) |
Moves or extends the selection to the beginning of the specified unit. |
| InRange(Range) |
メソッドの適用対象となる選択が指定した範囲内にあるかどうかを確認します。 |
| InsertAfter(String) |
選択したテキストを選択範囲の最後に挿入します。 |
| InsertBefore(String) |
指定した選択範囲の前に指定した文字列を挿入します。 |
| InsertBreak(Object) |
改ページ、段区切り、またはセクション区切りを挿入します。 |
| InsertCaption(Object, Object, Object, Object, Object) |
指定された選択範囲の直前または直後に図表番号を挿入します。 |
| InsertCaptionXP(Object, Object, Object, Object) |
内部使用のため予約済みです。 |
| InsertCells(Object) |
既存の表にセルを追加します。 |
| InsertColumns() |
選択部分を含む列の左側に列を挿入します。 |
| InsertColumnsRight() |
現在の選択範囲の右側に列を挿入します。 |
| InsertCrossReference_2002(Object, WdReferenceKind, Object, Object, Object) |
内部使用のため予約済みです。 |
| InsertCrossReference(Object, WdReferenceKind, Object, Object, Object, Object, Object) |
見出し、ブックマーク、脚注、または文末脚注、あるいは図表番号が定義されている項目 (たとえば、数式、図、表など) への相互参照を挿入します。 |
| InsertDateTime(Object, Object, Object, Object, Object) |
現在の日付または時刻、あるいはその両方を、文字列または TIME フィールドとして挿入します。 |
| InsertDateTimeOld(Object, Object, Object) |
内部使用のため予約済みです。 |
| InsertFile(String, Object, Object, Object, Object) |
指定したファイルのすべてまたは一部を挿入します。 |
| InsertFormula(Object, Object) |
選択範囲に、計算式を含む = (式) フィールドを挿入します。 |
| InsertNewPage() |
挿入ポイントに新しいページを挿入します。 |
| InsertParagraph() |
指定部分を新しい段落に置き換えます。 |
| InsertParagraphAfter() |
選択範囲の終了位置に段落記号を挿入します。 |
| InsertParagraphBefore() |
指定した選択範囲の前に新しい段落を挿入します。 |
| InsertRows(Object) |
選択部分を含む行の上に、指定された数の新しい行を挿入します。 |
| InsertRowsAbove(Object) |
現在の選択範囲の上側に行を挿入します。 |
| InsertRowsBelow(Object) |
現在の選択範囲の下側に行を挿入します。 |
| InsertStyleSeparator() |
Microsoft Word で異なる段落スタイルを使用して書式設定された段落を結合できるようにする、特別な隠し段落記号を挿入します。 |
| InsertSymbol(Int32, Object, Object, Object) |
選択範囲を記号に置き換えます。 |
| InsertXML(String, Object) |
指定した選択範囲に、指定した XML テキストを挿入します。 |
| InStory(Range) |
このメソッドを適用する選択が、指定した範囲と同じ層内にあるかどうかを判別します。 |
| IsEqual(Range) |
このメソッドが適用される選択が |
| ItalicRun() |
現在の run に対して、斜体の文字書式を追加または削除します。 |
| LtrPara() |
指定された段落の読み取り順序および配置を、左から右へに設定します。 |
| LtrRun() |
指定された run の読み取り順序および配置を、左から右へに設定します。 |
| Move(Object, Object) |
その開始位置または終了位置に指定された選択範囲を解除し、指定された単位数で縮小されたオブジェクトを移動します。 |
| MoveDown(Object, Object, Object) |
選択範囲を下に移動し、移動された単位数を返します。 |
| MoveEnd(Object, Object) |
選択範囲の終了文字位置を移動します。 |
| MoveEndUntil(Object, Object) |
文書内で指定された文字のいずれかが見つかるまで、指定された選択範囲の終了位置を移動します。 |
| MoveEndWhile(Object, Object) |
指定された文字のいずれかが文書内で検索されると、選択範囲の末尾の文字位置を移動します。 |
| MoveLeft(Object, Object, Object) |
選択範囲を左に移動し、移動された単位数を返します。 |
| MoveRight(Object, Object, Object) |
選択範囲を右に移動し、移動された単位数を返します。 |
| MoveStart(Object, Object) |
指定された選択範囲の開始位置を移動します。 |
| MoveStartUntil(Object, Object) |
文書内で指定された文字が見つかるまで、指定された選択範囲の開始位置を移動します。 |
| MoveStartWhile(Object, Object) |
指定された文字のいずれかが文書内で検索されると、指定された選択範囲の開始位置を移動します。 |
| MoveUntil(Object, Object) |
文書内で指定された文字のいずれかが見つかるまで、指定された選択範囲を移動します。 |
| MoveUp(Object, Object, Object) |
選択範囲を上に移動し、移動された単位数を返します。 |
| MoveWhile(Object, Object) |
文書内で指定された文字のいずれかを見つけると、指定された選択範囲を移動します。 |
| Next(Object, Object) |
指定した選択範囲に対して指定した単位を表す Range オブジェクトを返します。 |
| NextField() |
次のフィールドを選択します。 |
| NextRevision(Object) |
次に追跡された変更を検索し、 Revision オブジェクトとして返します。 |
| NextSubdocument() |
選択範囲を次のサブ文書に移動します。 |
| Paste() |
クリップボードの内容を、指定された選択範囲に挿入します。 |
| PasteAndFormat(WdRecoveryType) |
選択されたオブジェクトを貼り付け、指定された書式を設定します。 |
| PasteAppendTable() |
貼り付けるセルを既存の表に結合します。このとき、貼り付ける行を選択した行の間に挿入します。 |
| PasteAsNestedTable() |
選択範囲または指定範囲に、1 つまたは複数のセルを複合表として貼り付けます。 |
| PasteExcelTable(Boolean, Boolean, Boolean) |
Excel の表を貼り付け、書式を設定します。 |
| PasteFormat() |
CopyFormat() メソッドでコピーした書式を選択範囲に適用します。 |
| PasteSpecial(Object, Object, Object, Object, Object, Object, Object) |
クリップボードの内容を挿入します。 |
| Previous(Object, Object) |
指定した選択範囲に関連する Range オブジェクトを返します。 |
| PreviousField() |
前のフィールドを選択する。 |
| PreviousRevision(Object) |
以前に記録された変更を検索し、 Revision オブジェクトとして返します。 |
| PreviousSubdocument() |
選択範囲を前のサブ文書に移動します。 |
| ReadingModeGrowFont() |
文書を閲覧モードで表示するときに、表示する文字列のサイズを 1 ポイント大きくします。 |
| ReadingModeShrinkFont() |
文書を閲覧モードで表示するときに、表示する文字列のサイズを 1 ポイント小さくします。 |
| RtlPara() |
指定された段落の読み取り順序および配置を、右から左へに設定します。 |
| RtlRun() |
指定された run の読み取り順序および配置を、右から左へに設定します。 |
| Select() |
指定されたオブジェクトを選択します。 |
| SelectCell() |
現在の選択範囲を含むセル全体を選択します。 |
| SelectColumn() |
カーソルのある列を選択するか、または選択部分を含むすべての列を選択します。 |
| SelectCurrentAlignment() |
配置の異なる段落まで、選択範囲を文書の末尾方向に拡張します。 |
| SelectCurrentColor() |
色の異なる文字列まで、選択範囲を文書の末尾方向に拡張します。 |
| SelectCurrentFont() |
異なるフォントまたはフォント サイズの文字列まで、選択範囲を拡張します。 |
| SelectCurrentIndent() |
左インデント幅または右インデント幅の異なる文字列まで、選択範囲を文書の末尾方向に拡張します。 |
| SelectCurrentSpacing() |
行間が異なる段落まで、選択範囲を文書の末尾方向に拡張します。 |
| SelectCurrentTabs() |
タブ位置が異なる段落まで、選択範囲を文書の末尾方向に拡張します。 |
| SelectRow() |
カーソルのある行を選択するか、または選択部分を含むすべての行を選択します。 |
| SetRange(Int32, Int32) |
選択範囲の開始位置と終了位置を設定します。 |
| Shrink() |
次に小さな文字列要素まで選択範囲を縮小します。 |
| ShrinkDiscontiguousSelection() |
選択範囲に複数の接続されていない選択範囲が含まれている場合に、最後に選択されたテキストを除くすべての選択を解除します。 |
| Sort(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
指定された選択範囲内の段落を並べ替えます。 |
| Sort2000(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
内部使用のため予約済みです。 |
| SortAscending() |
段落や表の行を、英数字の昇順に並べ替えます。 |
| SortByHeadings(Object, Object, Object, Object, Object, Object, Object, Object, Object) |
指定した選択範囲の見出しを並べ替えます。 |
| SortDescending() |
段落または表の行を英数字の降順に並べ替えます。 |
| SortOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
内部使用のため予約済みです。 |
| SplitTable() |
選択範囲の最初の行の上に空白の段落を挿入します。 |
| StartOf(Object, Object) |
指定した選択範囲の開始位置を、最も近い指定したテキスト単位の先頭まで移動または拡張します。 |
| ToggleCharacterCode() |
選択範囲の文字を、Unicode 文字とそれに対応する 16 進数の値との間で切り替えます。 |
| TypeBackspace() |
選択範囲が解除されている場合は、カーソル位置の直前の文字を削除します。 |
| TypeParagraph() |
新しい空白の段落を挿入します。 |
| TypeText(String) |
指定された文字列を挿入します。 |
| WholeStory() |
選択範囲を拡張し、ストーリー全体を選択します。 |