Selection 接口

定义

命名空间:

Microsoft.Office.Interop.Word

程序集:

Microsoft.Office.Interop.Word.dll

表示窗口或窗格中的当前选内容。

public interface class Selection

[System.Runtime.InteropServices.Guid("00020975-0000-0000-C000-000000000046")]
public interface Selection

type Selection = interface

Public Interface Selection

属性

GuidAttribute

注解

选定内容表示文档中的选定（或突出显示）区域，或者代表插入点（如果未选择文档中的任何内容）。 每个文档窗口窗格只能有一个 Selection 对象，并且整个应用程序中只能有一个 Selection 对象处于活动状态。

Selection使用 属性返回 Selection 对象。 如果没有对象限定符与 属性一起使用Selection，Microsoft Word将从活动文档窗口的活动窗格中返回所选内容。

文档不必处于活动状态，就可以访问其当前所选内容。

Text使用 属性可设置或返回当前选定内容中的文本。

对象 Selection 具有各种方法和属性，你可以使用这些方法和属性：

使用 、 Information[WdInformation]和 Type 等Flags属性可返回有关当前所选内容的信息。

即使选定内容折叠到插入点，也不一定为空。 例如， Text 属性仍将返回插入点右侧的字符;此字符也出现在 对象的集合Selection中Characters。 但是，从折叠的选定内容调用 或 Copy() 等Cut()方法将导致错误。

用户可以在文档中选择不表示连续文本的区域 (例如，将 Alt 键与鼠标) 一起使用时。 由于此类选择的行为可能是不可预知的，因此你可能希望在代码中包含一个步骤，该步骤在对所选内容执行任何操作之前检查 Type 所选内容的属性。 同样地，包含表单元格的选定内容也会导致出现不可预测的行为。 属性 Information[WdInformation] 将告诉你所选内容是否位于表中。

由于 Range 对象与对象共享许多相同的方法和属性 Selection ，因此在没有理由以物理方式更改当前选定内容时，最好使用 Range 对象来操作文档。

属性

Active	确定指定窗口或窗格中的选择是否处于活动状态。
Application	返回一个 _Application 对象，该对象代表 Microsoft Word 应用程序。
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	返回一个 Object 类型的值 ，该对象代表所选文本的显示方式的图片表示形式。
ExtendMode	确定扩展模式是否处于活动状态。
Fields	返回一个只读 Fields 集合，该集合代表所选内容中的所有字段。
Find	返回一个 Find 对象，该对象包含查找操作的条件。
FitTextWidth	返回或设置在其中 Microsoft Word 文本适合当前所选内容中的宽度 (以当前度量单位)。
Flags	返回或设置所选内容的属性。
Font	返回或设置一个 Font 对象，该对象表示指定对象的字符格式设置。
FootnoteOptions	返回一个 FootnoteOptions 对象，该对象代表选定内容中的脚注属性。
Footnotes	返回一个 Footnotes 集合，该集合代表选定内容中的所有脚注。
FormattedText	返回或设置一个 Range 对象，该对象在指定的选定内容中包含带格式的文本。
FormFields	返回一个 FormFields 集合，该集合代表所选内容中的所有窗体字段。
Frames	返回一个 Frames 集合，该集合代表选定内容中的所有帧。
HasChildShapeRange	确定所选内容是否包含子形状。
HeaderFooter	返回 HeaderFooter 指定选定内容的 对象。
HTMLDivisions	返回一个 HTMLDivisions 对象，该对象代表 Web 文档中的 HTML 除法。
Hyperlinks	返回一个 Hyperlinks 集合，该集合表示指定选定内容中的所有超链接。
Information[WdInformation]	返回有关指定选择或范围的信息。
InlineShapes	返回一个 InlineShapes 集合，该集合代表选定内容中的所有 InlineShape 对象。
IPAtEndOfLine	确定插入点是否位于换行到下一行的线条的末尾。
IsEndOfRowMark	确定指定的选定内容是否折叠，并且是否位于表中的行尾标记处。
LanguageDetected	返回或设置一个值，指定 Word 是否已检测到指定的文本的语言。
LanguageID	返回或设置指定对象的语言。
LanguageIDFarEast	返回或设置指定对象的东亚语言。
LanguageIDOther	返回或设置指定对象的语言。
NoProofing	确定拼写和语法检查器是否忽略指定的文本。
OMaths	返回一个 OMaths 集合，该 OMath 集合表示当前选定内容中的 对象。 此为只读属性。
Orientation	返回或设置选定内容中的文字排列方向，当启用了文字方向功能时。
PageSetup	返回与 PageSetup 指定选定内容关联的 对象。
ParagraphFormat	返回或设置一个 ParagraphFormat 对象，该对象代表指定选定内容的段落设置。
Paragraphs	返回一个 Paragraphs 集合，该集合代表指定选定内容中的所有段落。
Parent	返回一个对象，代表指定对象的父对象。
ParentContentControl	返回一个 ContentControl 对象，该对象代表指定区域的父内容控件。 此为只读属性。
PreviousBookmarkID	返回在指定选定内容之前或同一位置开始的最后一个书签的编号，如果没有相应的书签，则返回 0 (零) 。
Range	返回一个 Range 对象，该对象表示包含在指定 对象中的文档部分。
Rows	返回一个 Rows 集合，该集合代表选定内容中的所有表格行。
Sections	返回一个 Sections 集合，该集合代表指定选定内容中的节。
Sentences	返回一个 Sentences 集合，该集合代表所选内容中的所有句子。
Shading	返回一个 Shading 对象，该对象引用指定对象的底纹格式。
ShapeRange	返回一个 ShapeRange 集合，该集合表示指定区域或选定区域中的所有 Shape 对象。
SmartTags	返回一个 SmartTags 对象，该对象代表文档中的智能标记。
Start	返回或设置选定内容的起始字符位置。
StartIsActive	确定所选内容的开头是否处于活动状态。
StoryLength	返回包含指定的所选内容的文章中的字符数。
StoryType	返回指定的所选内容的文字部分类型。
Style	返回或设置指定对象的样式。
Tables	返回一个 Tables 集合，该集合代表指定选定内容中的所有表。
Text	返回或设置指定的选定内容中的文本。
TopLevelTables	返回一个 Tables 集合，该集合表示当前选定内容中最外层嵌套级别的表。
Type	返回选择类型。
WordOpenXML	返回一个 String 类型的值，该值代表 Microsoft Office Word Open XML 格式所选内容中包含的 XML。 此为只读属性。
Words	返回一个 Words 集合，该集合代表选定内容中的所有单词。
XML[Boolean]	返回一个 String 类型的值，该值代表指定对象中的 XML 文本。
XMLNodes	此对象、成员或枚举已被弃用并且不适合在您的代码中使用。
XMLParentNode	此对象、成员或枚举已被弃用并且不适合在您的代码中使用。

方法

BoldRun()	在当前局部添加粗体字符格式或删除该格式。
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)	AutoTextEntry根据当前所选内容向AutoTextEntries集合添加新对象。
CreateTextbox()	在选定内容周围添加一个默认大小的文本框。
Cut()	将指定对象从文档中移到剪贴板上。
Delete(Object, Object)	删除指定数量的字符或单词。
DetectLanguage()	分析指定文本，以确定书写文本的语言类型。
EndKey(Object, Object)	将选定内容移动或扩展到指定单位的末尾。
EndOf(Object, Object)	将所选内容的结束字符位置移动或扩展到最近的指定文本单元的末尾。
EscapeKey()	取消某种模式，如取消扩展或列选定模式（与按 ESC 相同）。
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)	返回一个 Range 对象，该对象引用自变量指定的下一项或位置的 What 起始位置。
GoToPrevious(WdGoToItem)	返回一个 对象，该对象引用上一 Range 项或指定位置的起始位置。
HomeKey(Object, Object)	将所选内容移动或扩展到指定单元的开头。
InRange(Range)	确定所应用方法的选定内容是否包含在指定的范围内。
InsertAfter(String)	在所选内容的末尾插入指定的文本。
InsertBefore(String)	在指定的选定内容之前插入指定的文本。
InsertBreak(Object)	插入分页符、分栏符或分节符。
InsertCaption(Object, Object, Object, Object, Object)	紧靠在指定的所选内容之前或之后插入题注。
InsertCaptionXP(Object, Object, Object, Object)	仅供内部使用。
InsertCells(Object)	向原有表添加单元格。
InsertColumns()	在选定内容的左侧插入新列。
InsertColumnsRight()	在当前选定内容的右边插入列。
InsertCrossReference(Object, WdReferenceKind, Object, Object, Object, Object, Object)	插入对标题、书签、脚注、尾注或定义了题注标签的项（如公式、图表或表格）的交叉引用。
InsertCrossReference_2002(Object, WdReferenceKind, Object, Object, Object)	仅供内部使用。
InsertDateTime(Object, Object, Object, Object, Object)	以文本或 TIME 域的形式插入当前日期或时间，或将两者都插入。
InsertDateTimeOld(Object, Object, Object)	仅供内部使用。
InsertFile(String, Object, Object, Object, Object)	插入指定文件的全部或一部分。
InsertFormula(Object, Object)	插入包含选定内容的公式的 = (Formula) 域。
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)	确定要应用此方法的选定内容是否等于 参数指定的 Range 范围。
ItalicRun()	在当前局部中添加或删除斜体字符格式。
LtrPara()	将指定段落的对齐方式和阅读顺序设置为从左向右。
LtrRun()	用于将指定局部的阅读顺序和对齐方式设置为从左向右。
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()	将一个或一组单元格作为嵌套表格粘贴到所选范围。
PasteExcelTable(Boolean, Boolean, Boolean)	粘贴 Microsoft Excel 表格并设置其格式。
PasteFormat()	将使用 CopyFormat() 方法复制的格式应用于所选内容。
PasteSpecial(Object, Object, Object, Object, Object, Object, Object)	插入“剪贴板”中的内容。
Previous(Object, Object)	返回相对于 Range 指定选定内容的 对象。
PreviousField()	选择上一个字段。
PreviousRevision(Object)	定位并返回以前跟踪的更改作为 Revision 对象。
PreviousSubdocument()	将所选内容移至上一个子文档。
ReadingModeGrowFont()	在以阅读模式显示文档时，将所显示文本的大小增大一磅。
ReadingModeShrinkFont()	在以阅读模式显示文档时，将所显示文本的大小减小一磅。
RtlPara()	将指定段落的阅读顺序和对齐方式设置为从右向左。
RtlRun()	将指定的局部的阅读顺序和对齐方式设置为从右向左。
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 字符和其相应的十六进制值之间切换选定内容。
TypeBackspace()	删除折叠的选定内容（即一个插入点）前面的字符。
TypeParagraph()	插入一个新的空段落。
TypeText(String)	插入指定的文本。
WholeStory()	扩展某一所选内容，使其包括整个文章。