<< Click to Display Table of Contents >> Range (object) |
Access paths:
▪Application à Documents à Item à Paragraphs à Item à Range
▪Application à ActiveDocument à Paragraphs à Item à Range
1 Description
The Range object is a child object of the Paragraph object. It returns the start and end position of the paragraph, expressed as the number of characters from the top of the document.
2 Access to the object
For each Paragraph object there is exactly one Range object. This Range object can be accessed solely through the object pointer Range in the associated Paragraph object:
' Display the end position of the first paragraph in the active document
MsgBox tm.ActiveDocument.Paragraphs.Item(1).Range.End
3 Properties, objects, collections and methods
Properties:
▪Start R/O
▪End R/O
Objects:
▪Application → Application
▪Parent → Paragraph
Start (property, R/O)
Data type: Long
Returns the start position of the paragraph, expressed as the number of character from the top of the document.
End (property, R/O)
Data type: Long
Returns the end position of the paragraph, expressed as the number of characters from the top of the document.
An example for Start and End:
If the first paragraph of a document consists of the text "The first paragraph", the following applies:
▪tm.ActiveDocument.Paragraphs.Item(1).Range.Start returns the value 0 ("the zeroth character from the beginning of the document").
▪tm.ActiveDocument.Paragraphs.Item(1).Range.End returns 20.
You can use these values to select a paragraph or a part of it:
' Select the first two characters of the first paragraph
tm.ActiveDocument.Selection.SetRange 0, 1
' Select the whole paragraph
With tm.ActiveDocument
.Selection.SetRange .Paragraphs(1).Range.Start, .Paragraphs(1).Range.End
End With
You can select the first four paragraphs of a document as follows:
With tm.ActiveDocument
.Selection.SetRange .Paragraphs(1).Range.Start, .Paragraphs(4).Range.End
End With
Application (pointer to object)
Data type: Object
Returns the Application object.
Parent (pointer to object)
Data type: Object
Returns the parent object, i.e. an object of the type Paragraph.