Examples: SetEnd method

This agents gets a requested range of paragraphs from the Body item of the current document. The user specifies the numbers of the first and last paragraphs. The code uses SetBegin to mark the first paragraph in the range, and SetPositionAtEnd followed by SetEnd to mark and include the last paragraph in the range.

Sub Initialize
  Dim session As New NotesSession
  Dim db As NotesDatabase
  Dim dc As NotesDocumentCollection
  Dim doc As NotesDocument
  Dim body As NotesRichTextItem
  Dim rtnavBody As NotesRichTextNavigator
  Dim rtrangePara As NotesRichTextRange
  Dim rtnavPara As NotesRichTextNavigator
  Dim rtrangePara2 As NotesRichTextRange
  Dim stringPara As String
  Dim firstPara As Integer
  Dim lastPara As Integer
  Dim counter As Integer
  Set db = session.CurrentDatabase
  Set dc = db.UnprocessedDocuments
  Set doc = dc.GetFirstDocument
  Set body = doc.GetFirstItem("Body")
  REM Create navigator
  Set rtnavBody = body.CreateNavigator
  REM Get first paragraph user wants and set range
  stringPara = Inputbox("Number of first paragraph","First paragraph")
  If stringPara = "" Then Exit Sub
  If Not Isnumeric(stringPara) Then Exit Sub
  firstPara = Cint(stringPara)
  If Not rtnavBody.FindNthElement( _
  RTELEM_TYPE_TEXTPARAGRAPH, firstPara) Then
    Messagebox "Body item does not have this paragraph",, _
    "Paragraph " & firstPara
    Exit Sub
  End If
  Set rtrangePara = body.CreateRange
  '*** Set the beginning of subrange at beginning of paragraph***
  Call rtrangePara.SetBegin(rtnavBody)
  REM Get last paragraph user wants and set range
  stringPara = Inputbox("Number of last paragraph","Last paragraph")
  If stringPara = "" Then Exit Sub
  If Not Isnumeric(stringPara) Then Exit Sub
  lastPara = Cint(stringPara)
  If lastPara < firstPara Then Exit Sub
  If Not rtnavBody.FindNthElement( _
  RTELEM_TYPE_TEXTPARAGRAPH, lastPara) Then
    Messagebox "Body item does not have this paragraph",, _
    "Paragraph " & lastPara
    Exit Sub
  End If
  '***Move the navigator position to the end of the paragraph***
  Call rtnavBody.SetPositionAtEnd(rtnavBody)
  '***Set the end of the subrange at the end of this paragraph***
  Call rtrangePara.SetEnd(rtnavBody)
  REM Navigate through range and get paragraphs
  Set rtnavPara = rtrangePara.Navigator
  Set rtrangePara2 = body.CreateRange
  Call rtnavPara.FindFirstElement(RTELEM_TYPE_TEXTPARAGRAPH)
  counter = firstPara
  Do
    Call rtrangePara2.SetBegin(rtnavPara)
    Messagebox rtrangePara2.TextParagraph,, "Paragraph " & counter
    counter = counter + 1
  Loop While rtnavPara.FindNextElement(RTELEM_TYPE_TEXTPARAGRAPH)
End Sub