Share via

Range.TextRetrievalMode Property

  • Article
Word Developer Reference

Returns a TextRetrievalMode object that controls how text is retrieved from the specified Range. Read/write.

Syntax

expression.TextRetrievalMode

expression   A variable that represents a Range object.

Example

This example retrieves the selected text (excluding any hidden text) and inserts it at the beginning of the third paragraph in the active document.

Visual Basic for Applications 
  If Selection.Type = wdSelectionNormal Then
    Set Range1 = Selection.Range
    Range1.TextRetrievalMode.IncludeHiddenText = False
    Set Range2 = ActiveDocument.Paragraphs(2).Range
    Range2.InsertAfter Range1.Text
End If

This example retrieves and displays the first three paragraphs as they appear in outline view.

Visual Basic for Applications 
  Set myRange = ActiveDocument.Range(Start:=ActiveDocument _
    .Paragraphs(1).Range.Start, _
    End:=ActiveDocument.Paragraphs(3).Range.End)
myRange.TextRetrievalMode.ViewType = wdOutlineView
MsgBox myRange.Text

This example excludes field codes and hidden text from the range that refers to the selected text. The example then displays the text in a message box.

Visual Basic for Applications 
  If Selection.Type = wdSelectionNormal Then
    Set aRange = Selection.Range
    With aRange.TextRetrievalMode
        .IncludeHiddenText = False
        .IncludeFieldCodes = False
    End With
    MsgBox aRange.Text
End If

See Also