Selection Members

Include Protected Members
Include Inherited Members

Represents the current selection in a window or pane.

The Selection type exposes the following members.

Methods

  Name Description
Public method BoldRun Adds the bold character format to or removes it from the current run.
Public method Calculate Calculates a mathematical expression within a selection.
Public method ClearCharacterAllFormatting Removes all character formatting (formatting applied either through character styles or manually applied formatting) from the selected text.
Public method ClearCharacterDirectFormatting Removes character formatting (formatting that has been applied manually using the buttons on the Ribbon or through the dialog boxes) from the selected text.
Public method ClearCharacterStyle Removes character formatting that has been applied through character styles from the selected text.
Public method ClearFormatting Removes text and paragraph formatting from a selection.
Public method ClearParagraphAllFormatting Removes all paragraph formatting (formatting applied either through paragraph styles or manually applied formatting) from the selected text.
Public method ClearParagraphDirectFormatting Removes paragraph formatting that has been applied manually (using the buttons on the Ribbon or through the dialog boxes) from the selected text.
Public method ClearParagraphStyle Removes paragraph formatting that has been applied through paragraph styles from the selected text.
Public method Collapse Collapses a selection to the starting or ending position.
Public method ConvertToTable Converts text within a selection to a table.
Public method ConvertToTableOld Reserved for internal use.
Public method Copy Copies the specified object to the Clipboard.
Public method CopyAsPicture Copies the specified object to the Clipboard.
Public method CopyFormat Copies the character formatting of the first character in the selected text.
Public method CreateAutoTextEntry Adds a new AutoTextEntry object to the AutoTextEntries collection, based on the current selection.
Public method CreateTextbox Adds a default-size text box around the selection.
Public method Cut Removes the specified object from the document and places it on the Clipboard.
Public method Delete Deletes the specified number of characters or words.
Public method DetectLanguage Analyzes the specified text to determine the language that it is written in.
Public method EndKey Moves or extends the selection to the end of the specified unit.
Public method EndOf Moves or extends the ending character position of a selection to the end of the nearest specified text unit.
Public method EscapeKey Cancels a mode such as extend or column select (equivalent to pressing the ESC key).
Public method Expand Expands the specified selection.
Public method ExportAsFixedFormat Saves the current selection as PDF or XPS format. .
Public method Extend Turns extend mode on, or extends the selection to the next larger unit of text if Extend mode is already on.
Public method GoTo Moves the insertion point to the character position immediately preceding the specified item.
Public method GoToEditableRange Returns a Range object that represents an area of a document that can be modified by the specified user or group of users.
Public method GoToNext Returns a Range object that refers to the start position of the next item or location specified by the What argument.
Public method GoToPrevious Returns a Range object that refers to the start position of the previous item or a specified location.
Public method HomeKey Moves or extends the selection to the beginning of the specified unit.
Public method InRange Determines if the selection to which the method is applied is contained in a specified range.
Public method InsertAfter Inserts the specified text at the end of a selection.
Public method InsertBefore Inserts the specified text before the specified selection.
Public method InsertBreak Inserts a page, column, or section break.
Public method InsertCaption Inserts a caption immediately preceding or following the specified selection.
Public method InsertCaptionXP Reserved for internal use.
Public method InsertCells Adds cells to an existing table.
Public method InsertColumns Inserts columns to the left of the column that contains the selection.
Public method InsertColumnsRight Inserts columns to the right of the current selection.
Public method InsertCrossReference Inserts a cross-reference to a heading, bookmark, footnote, or endnote, or to an item for which a caption label is defined (for example, an equation, figure, or table).
Public method InsertCrossReference_2002 Reserved for internal use.
Public method InsertDateTime Inserts the current date or time, or both, either as text or as a TIME field.
Public method InsertDateTimeOld Reserved for internal use.
Public method InsertFile Inserts all or part of the specified file.
Public method InsertFormula Inserts an = (Formula) field that contains a formula at the selection.
Public method InsertNewPage Inserts a new page at the position of the Insertion Point.
Public method InsertParagraph Replaces the specified selection with a new paragraph.
Public method InsertParagraphAfter Inserts a paragraph mark after a selection.
Public method InsertParagraphBefore Inserts a new paragraph before the specified selection.
Public method InsertRows Inserts the specified number of new rows above the row that contains the selection.
Public method InsertRowsAbove Inserts rows above the current selection.
Public method InsertRowsBelow Inserts rows below the current selection.
Public method InsertStyleSeparator Inserts a special hidden paragraph mark that allows Microsoft Word to join paragraphs formatted using different paragraph styles.
Public method InsertSymbol Inserts a symbol in place of the specified selection.
Public method InsertXML Inserts the specified XML text into the specified selection.
Public method InStory Determines if the selection to which this method is applied is in the same story as the specified range.
Public method IsEqual Determines if the selection to which this method is applied is equal to the range specified by the Range argument.
Public method ItalicRun Adds the italic character format to or removes it from the current run.
Public method LtrPara Sets the reading order and alignment of the specified paragraphs to left-to-right.
Public method LtrRun Sets the reading order and alignment of the specified run to left-to-right.
Public method Move Collapses the specified selection to its start or end position and then moves the collapsed object by the specified number of units.
Public method MoveDown Moves the selection down and returns the number of units it's been moved.
Public method MoveEnd Moves the ending character position of a selection.
Public method MoveEndUntil Moves the end position of the specified selection until any of the specified characters are found in the document.
Public method MoveEndWhile Moves the ending character position of a selection while any of the specified characters are found in the document.
Public method MoveLeft Moves the selection to the left and returns the number of units it's been moved.
Public method MoveRight Moves the selection to the right and returns the number of units it's been moved.
Public method MoveStart Moves the start position of the specified selection.
Public method MoveStartUntil Moves the start position of the specified selection until one of the specified characters is found in the document.
Public method MoveStartWhile Moves the start position of the specified selection while any of the specified characters are found in the document.
Public method MoveUntil Moves the specified selection until one of the specified characters is found in the document.
Public method MoveUp Moves the selection up and returns the number of units it's been moved.
Public method MoveWhile Moves the specified selection while any of the specified characters are found in the document.
Public method Next Returns a Range object that represents the specified unit relative to the specified selection.
Public method NextField Selects the next field.
Public method NextRevision Locates and returns the next tracked change as a Revision object.
Public method NextSubdocument Moves the selection to the next subdocument.
Public method Paste Inserts the contents of the Clipboard at the specified selection.
Public method PasteAndFormat Pastes the selected table cells and formats them as specified.
Public method PasteAppendTable Merges pasted cells into an existing table by inserting the pasted rows between the selected rows.
Public method PasteAsNestedTable Pastes a cell or group of cells as a nested table into the selected range.
Public method PasteExcelTable Pastes and formats a Microsoft Excel table.
Public method PasteFormat Applies formatting copied with the CopyFormat method to the selection.
Public method PasteSpecial Inserts the contents of the Clipboard.
Public method Previous Returns a Range object relative to the specified selection.
Public method PreviousField Selects the previous field.
Public method PreviousRevision Locates and returns the previous tracked change as a Revision object.
Public method PreviousSubdocument Moves the selection to the previous subdocument.
Public method ReadingModeGrowFont Increases the size of the displayed text one point size when the document is displayed in Reading mode.
Public method ReadingModeShrinkFont Decreases the size of the displayed text one point size when the document is displayed in Reading mode.
Public method RtlPara Sets the reading order and alignment of the specified paragraphs to right-to-left.
Public method RtlRun Sets the reading order and alignment of the specified run to right-to-left.
Public method Select Selects the specified object.
Public method SelectCell Selects the entire cell containing the current selection.
Public method SelectColumn Selects the column that contains the insertion point, or selects all columns that contain the selection.
Public method SelectCurrentAlignment Extends the selection forward until text with a different paragraph alignment is encountered.
Public method SelectCurrentColor Extends the selection forward until text with a different color is encountered.
Public method SelectCurrentFont Extends the selection forward until text in a different font or font size is encountered.
Public method SelectCurrentIndent Extends the selection forward until text with different left or right paragraph indents is encountered.
Public method SelectCurrentSpacing Extends the selection forward until a paragraph with different line spacing is encountered.
Public method SelectCurrentTabs Extends the selection forward until a paragraph with different tab stops is encountered.
Public method SelectRow Selects the row that contains the insertion point, or selects all rows that contain the selection.
Public method SetRange Sets the starting and ending character positions for the selection.
Public method Shrink Shrinks the selection to the next smaller unit of text.
Public method ShrinkDiscontiguousSelection Deselects all but the most recently selected text when a selection contains multiple, unconnected selections.
Public method Sort Sorts the paragraphs in the specified selection.
Public method Sort2000 Reserved for internal use.
Public method SortAscending Sorts paragraphs or table rows in ascending alphanumeric order.
Public method SortDescending Sorts paragraphs or table rows in descending alphanumeric order.
Public method SortOld Reserved for internal use.
Public method SplitTable Inserts an empty paragraph above the first row in the selection.
Public method StartOf Moves or extends the start position of the specified selection to the beginning of the nearest specified text unit.
Public method ToggleCharacterCode Switches a selection between a Unicode character and its corresponding hexadecimal value.
Public method TypeBackspace Deletes the character preceding a collapsed selection (an insertion point).
Public method TypeParagraph Inserts a new, blank paragraph.
Public method TypeText Inserts the specified text.
Public method WholeStory Expands a selection to include the entire story.

Top

Properties

  Name Description
Public property Active Determines if the selection in the specified window or pane is active.
Public property Application Returns a _Application object that represents the Microsoft Word application.
Public property BookmarkID Returns the number of the bookmark that encloses the beginning of the specified selection or 0 (zero) if there's no corresponding bookmark.
Public property Bookmarks Returns a Bookmarks collection that represents all the bookmarks in a selection.
Public property Borders Returns a Borders collection that represents all the borders for the specified object.
Public property Cells Returns a Cells collection that represents the table cells in a selection.
Public property Characters Returns a Characters collection that represents the characters in a selection.
Public property ChildShapeRange Returns a ShapeRange object representing the child shapes of a selection.
Public property Columns Returns a Columns collection that represents all the table columns in the selection.
Public property ColumnSelectMode Determines if column selection mode is active.
Public property Comments Returns a Comments collection that represents all the comments in the specified selection.
Public property ContentControls Returns a ContentControls collection that represents the content controls contained within a range. Read-only.
Public property Creator Returns a 32-bit integer that indicates the application in which the specified object was created.
Public property Document Returns a Document object associated with the specified selection.
Public property Editors Returns a Editors object that represents all the users authorized to modify a selection within a document.
Public property End Returns or sets the ending character position of a selection.
Public property EndnoteOptions Returns a EndnoteOptions object that represents the endnotes in a selection.
Public property Endnotes Returns a Endnotes collection that represents all the endnotes in a selection.
Public property EnhMetaFileBits Returns an Object that represents a picture representation of how a selection of text appears.
Public property ExtendMode Determines if Extend mode is active.
Public property Fields Returns a read-only Fields collection that represents all the fields in the selection.
Public property Find Returns a Find object that contains the criteria for a find operation.
Public property FitTextWidth Returns or sets the width (in the current measurement units) in which Microsoft Word fits the text in the current selection.
Public property Flags Returns or sets properties of the selection.
Public property Font Returns or sets a Font object that represents the character formatting of the specified object.
Public property FootnoteOptions Returns a FootnoteOptions object that represents the footnote properties in a selection.
Public property Footnotes Returns a Footnotes collection that represents all the footnotes in a selection.
Public property FormattedText Returns or sets a Range object that includes the formatted text in the specified selection.
Public property FormFields Returns a FormFields collection that represents all the form fields in the selection.
Public property Frames Returns a Frames collection that represents all the frames in a selection.
Public property HasChildShapeRange Determines if the selection contains child shapes.
Public property HeaderFooter Returns a HeaderFooter object for the specified selection.
Public property HTMLDivisions Returns a HTMLDivisions object that represents an HTML division in a Web document.
Public property Hyperlinks Returns a Hyperlinks collection that represents all the hyperlinks in the specified selection.
Public property Information Returns information about the specified selection or range.
Public property InlineShapes Returns a InlineShapes collection that represents all the InlineShape objects in a selection.
Public property IPAtEndOfLine Determines if the insertion point is at the end of a line that wraps to the next line.
Public property IsEndOfRowMark Determines if the specified selection is collapsed and is located at the end-of-row mark in a table.
Public property LanguageDetected Returns or sets a value that specifies whether Microsoft Word has detected the language of the specified text.
Public property LanguageID Returns or sets the language for the specified object.
Public property LanguageIDFarEast Returns or sets an East Asian language for the specified object.
Public property LanguageIDOther Returns or sets the language for the specified object.
Public property NoProofing Determines if the spelling and grammar checker ignores the specified text.
Public property OMaths Returns an OMaths collection that represents the OMath objects within the current selection. Read-only.
Public property Orientation Returns or sets the orientation of text in a selection when the Text Direction feature is enabled.
Public property PageSetup Returns a PageSetup object that's associated with the specified selection.
Public property ParagraphFormat Returns or sets a ParagraphFormat object that represents the paragraph settings for the specified selection.
Public property Paragraphs Returns a Paragraphs collection that represents all the paragraphs in the specified selection.
Public property Parent Returns an object that represents the parent object of the specified object.
Public property ParentContentControl Returns a ContentControl object that represents the parent content control for the specified range. Read-only.
Public property PreviousBookmarkID Returns the number of the last bookmark that starts before or at the same place as the specified selection or returns 0 (zero) if there's no corresponding bookmark.
Public property Range Returns a Range object that represents the portion of a document that's contained in the specified object.
Public property Rows Returns a Rows collection that represents all the table rows in a selection.
Public property Sections Returns a Sections collection that represents the sections in the specified selection.
Public property Sentences Returns a Sentences collection that represents all the sentences in the selection.
Public property Shading Returns a Shading object that refers to the shading formatting for the specified object.
Public property ShapeRange Returns a ShapeRange collection that represents all the Shape objects in the specified range or selection.
Public property SmartTags Returns a SmartTags object that represents a smart tag in a document.
Public property Start Returns or sets the starting character position of a selection.
Public property StartIsActive Determines if the beginning of the selection is active.
Public property StoryLength Returns the number of characters in the story that contains the specified selection.
Public property StoryType Returns the story type for the specified selection.
Public property Style Returns or sets the style for the specified object.
Public property Tables Returns a Tables collection that represents all the tables in the specified selection.
Public property Text Returns or sets the text in the specified selection.
Public property TopLevelTables Returns a Tables collection that represents the tables at the outermost nesting level in the current selection.
Public property Type Returns the selection type.
Public property WordOpenXML Returns a String that represents the XML contained within the selection in the Microsoft Office Word Open XML format. Read-only.
Public property Words Returns a Words collection that represents all the words in a selection.
Public property XML Returns a String that represents the XML text in the specified object.
Public property XMLNodes Returns a XMLNodes collection that represents the collection of all XML elements in a selection — including those elements that are only partially within the selection.
Public property XMLParentNode Returns a XMLNode object that represents the parent node of a selection.

Top

See Also

Reference

Selection Interface

Microsoft.Office.Interop.Word Namespace