Selection Methods (Word)

GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Methods

Name

Description

BoldRun

Adds the bold character format to or removes it from the current run.

Calculate

Calculates a mathematical expression within a selection. Returns the result as a Single.

ClearCharacterAllFormatting

Removes all character formatting (formatting applied either through character styles or manually applied formatting) from the selected text.

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.

ClearCharacterStyle

Removes character formatting that has been applied through character styles from the selected text.

ClearFormatting

Removes text and paragraph formatting from a selection.

ClearParagraphAllFormatting

Removes all paragraph formatting (formatting applied either through paragraph styles or manually applied formatting) from the selected text.

ClearParagraphDirectFormatting

Removes paragraph formatting that has been applied manually (using the buttons on the ribbon or through the dialog boxes) from the selected text.

ClearParagraphStyle

Removes paragraph formatting that has been applied through paragraph styles from the selected text.

Collapse

Collapses a selection to the starting or ending position. After a selection is collapsed, the starting and ending points are equal.

ConvertToTable

Converts text within a range to a table. Returns the table as a Table object.

Copy

Copies the specified selection to the Clipboard.

CopyAsPicture

The CopyAsPicture method works the same way as the Copy method.

CopyFormat

Copies the character formatting of the first character in the selected text.

CreateAutoTextEntry

Adds a new AutoTextEntry object to the AutoTextEntries collection, based on the current selection.

CreateTextbox

Adds a default-size text box around the selection.

Cut

Removes the specified object from the document and moves it to the Clipboard.

Delete

Deletes the specified number of characters or words.

DetectLanguage

Analyzes the specified text to determine the language that it is written in.

EndKey

Moves or extends the selection to the end of the specified unit.

EndOf

Moves or extends the ending character position of a range or selection to the end of the nearest specified text unit.

EscapeKey

Cancels a mode such as extend or column select (equivalent to pressing the ESC key).

Expand

Expands the specified range or selection. Returns the number of characters added to the range or selection. Long.

ExportAsFixedFormat

Saves the current selection as PDF or XPS format. .

Extend

Turns on extend mode, or if extend mode is already on, extends the selection to the next larger unit of text.

GoTo

Moves the insertion point to the character position immediately preceding the specified item, and returns a Range object (except for the wdGoToGrammaticalError, wdGoToProofreadingError, or wdGoToSpellingError constant).

GoToEditableRange

Returns a Range object that represents an area of a document that can be modified by the specified user or group of users.

GoToNext

Returns a Range object that refers to the start position of the next item or location specified by the What argument. If you apply this method to the Selection object, the method moves the selection to the specified item (except for the wdGoToGrammaticalError, wdGoToProofreadingError, and wdGoToSpellingError constants).

GoToPrevious

Returns a Range object that refers to the start position of the previous item or location specified by the What argument. If applied to a Selection object, GoToPrevious moves the selection to the specified item. Range object.

HomeKey

Moves or extends the selection to the beginning of the specified unit. This method returns an integer that indicates the number of characters the selection was actually moved, or it returns 0 (zero) if the move was unsuccessful.This method corresponds to functionality of the HOME key.

InRange

True if the selection to which the method is applied is contained within the range specified by the Range argument.

InsertAfter

Inserts the specified text at the end of a range or selection.

InsertBefore

Inserts the specified text before the specified selection. .

InsertBreak

Inserts a page, column, or section break.

InsertCaption

Inserts a caption immediately preceding or following the specified selection.

InsertCells

Adds cells to an existing table.

InsertColumns

Inserts columns to the left of the column that contains the selection.

InsertColumnsRight

Inserts columns to the right of the current selection.

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).

InsertDateTime

Inserts the current date or time, or both, either as text or as a TIME field.

InsertFile

Inserts all or part of the specified file.

InsertFormula

Inserts an = (Formula) field that contains a formula at the selection.

InsertNewPage

Inserts a new page at the position of the Insertion Point.

InsertParagraph

Replaces the specified selection with a new paragraph.

InsertParagraphAfter

Inserts a paragraph mark after a selection.

InsertParagraphBefore

Inserts a new paragraph before the specified selection or range.

InsertRows

Inserts the specified number of new rows above the row that contains the selection. If the selection isn't in a table, an error occurs.

InsertRowsAbove

Inserts rows above the current selection.

InsertRowsBelow

Inserts rows below the current selection.

InsertStyleSeparator

Inserts a special hidden paragraph mark that allows Microsoft Word to join paragraphs formatted using different paragraph styles, so lead-in headings can be inserted into a table of contents.

InsertSymbol

Inserts a symbol in place of the specified selection.

InsertXML

Inserts the specified XML into the document at the cursor, replacing any selected text.

InStory

True if the selection to which this method is applied is in the same story as the range specified by the Range argument.

IsEqual

True if the selection to which this method is applied is equal to the range specified by the Range argument.

ItalicRun

Adds the italic character format to or removes it from the current run.

LtrPara

Sets the reading order and alignment of the specified paragraphs to left-to-right.

LtrRun

Sets the reading order and alignment of the specified run to left-to-right.

Move

Collapses the specified selection to its start or end position and then moves the collapsed object by the specified number of units. This method returns a Long value that represents the number of units by which the selection was moved, or it returns 0 (zero) if the move was unsuccessful.

MoveDown

Moves the selection down and returns the number of units it has been moved.

MoveEnd

Moves the ending character position of a range or selection.

MoveEndUntil

Moves the end position of the specified selection until any of the specified characters are found in the document.

MoveEndWhile

Moves the ending character position of a selection while any of the specified characters are found in the document.

MoveLeft

Moves the selection to the left and returns the number of units it has been moved.

MoveRight

Moves the selection to the right and returns the number of units it has been moved.

MoveStart

Moves the start position of the specified selection.

MoveStartUntil

Moves the start position of the specified selection until one of the specified characters is found in the document. If the movement is backward through the document, the selection is expanded.

MoveStartWhile

Moves the start position of the specified selection while any of the specified characters are found in the document.

MoveUntil

Moves the specified selection until one of the specified characters is found in the document.

MoveUp

Moves the selection up and returns the number of units that it has been moved.

MoveWhile

Moves the specified selection while any of the specified characters are found in the document.

Next

Returns a Range object that represents the next unit relative to the specified selection.

NextField

Selects the next field.

NextRevision

Locates and returns the next tracked change as a Revision object.

NextSubdocument

Moves the selection to the next subdocument.

Paste

Inserts the contents of the Clipboard at the specified selection.

PasteAndFormat

Pastes the selected table cells and formats them as specified.

PasteAppendTable

Merges pasted cells into an existing table by inserting the pasted rows between the selected rows. No cells are overwritten.

PasteAsNestedTable

Pastes a cell or group of cells as a nested table into the selection.

PasteExcelTable

Pastes and formats a Microsoft Excel table.

PasteFormat

Applies formatting copied with the CopyFormat method to the selection.

PasteSpecial

Inserts the contents of the Clipboard.

Previous

Moves the selected text by the specified number of units, and returns a Range object relative to the collapsed selection.

PreviousField

Selects and returns the previous field.

PreviousRevision

Locates and returns the previous tracked change as a Revision object.

PreviousSubdocument

Moves the selection to the previous subdocument.

ReadingModeGrowFont

Increases the size of the displayed text one point size when the document is displayed in Reading mode.

ReadingModeShrinkFont

Decreases the size of the displayed text one point size when the document is displayed in Reading mode.

RtlPara

Sets the reading order and alignment of the specified paragraphs to right-to-left.

RtlRun

Sets the reading order and alignment of the specified run to right-to-left.

Select

Selects the specified text.

SelectCell

Selects the entire cell containing the current selection.

SelectColumn

Selects the column that contains the insertion point, or selects all columns that contain the selection.

SelectCurrentAlignment

Extends the selection forward until text with a different paragraph alignment is encountered.

SelectCurrentColor

Extends the selection forward until text with a different color is encountered.

SelectCurrentFont

Extends the selection forward until text in a different font or font size is encountered.

SelectCurrentIndent

Extends the selection forward until text with different left or right paragraph indents is encountered.

SelectCurrentSpacing

Extends the selection forward until a paragraph with different line spacing is encountered.

SelectCurrentTabs

Extends the selection forward until a paragraph with different tab stops is encountered.

SelectRow

Selects the row that contains the insertion point, or selects all rows that contain the selection.

SetRange

Sets the starting and ending character positions for the selection.

Shrink

Shrinks the selection to the next smaller unit of text.

ShrinkDiscontiguousSelection

Cancels the selection of all but the most recently selected text when a selection contains multiple, unconnected selections.

Sort

Sorts the paragraphs in the specified selection.

SortAscending

Sorts paragraphs or table rows in ascending alphanumeric order.

SortByHeadings

Sorts the headings in the specified selection.

SortDescending

Sorts paragraphs or table rows within the selection in descending alphanumeric order.

SplitTable

Inserts an empty paragraph above the first row in the selection. .

StartOf

Moves or extends the start position of the specified range or selection to the beginning of the nearest specified text unit. This method returns a Long that indicates the number of characters by which the range or selection was moved or extended. The method returns a negative number if the movement is backward through the document.

ToggleCharacterCode

Switches a selection between a Unicode character and its corresponding hexadecimal value.

TypeBackspace

Deletes the character preceding a collapsed selection (an insertion point).

TypeParagraph

Inserts a new, blank paragraph.

TypeText

Inserts the specified text.

WholeStory

Expands a selection to include the entire story.