DocumentBase.Range Method

Article
07/25/2011

Returns a Microsoft.Office.Interop.Word.Range by using the specified starting and ending character positions.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
Public Function Range ( _
    ByRef start As Object, _
    ByRef end As Object _
) As Range

public Range Range(
    ref Object start,
    ref Object end
)

Parameters

start
Type: System.Object%
The starting character position.

end
Type: System.Object%
The ending character position.

Return Value

Type: Microsoft.Office.Interop.Word.Range
A Microsoft.Office.Interop.Word.Range that uses the specified starting and ending character positions.

Remarks

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example uses the Range method to add the string "This is a line of text" to the current document, and then gets a Microsoft.Office.Interop.Word.Range that includes only the first seven letters of the string. To use this example, run it from the ThisDocument class in a document-level project.

Private Sub DocumentRange()
    Me.Range(0, 0).Text = "This is a line of text. "

    ' Display only the first seven characters in the string.
    Dim range2 As Word.Range = Me.Range(0, 7)
    MessageBox.Show(range2.Text)
End Sub

private void DocumentRange()
{
    // Add a string to the document.
    object start = 0;
    object end = 0;
    string newText = "This is a line of text. ";
    Word.Range range1 = this.Range(ref start, ref end);
    range1.Text = newText;

    // Display only the first seven characters in the string.
    end = 7;
    Word.Range range2 = this.Range(ref start, ref end);
    MessageBox.Show("The first seven characters: " +
        range2.Text);
}

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via