Bookmark.IsEqual-Methode

Artikel
08/10/2011

Bestimmt, ob das Bookmark-Steuerelement, auf das diese Methode angewendet wird, mit dem vom Range-Argument angegebenen Bereich übereinstimmt.

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

Syntax

'Declaration
Function IsEqual ( _
    Range As Range _
) As Boolean

bool IsEqual(
    Range Range
)

Parameter

Range
Typ: Microsoft.Office.Interop.Word.Range
Das Range-Objekt, das mit dem Bookmark-Steuerelement verglichen wird.

Rückgabewert

Typ: System.Boolean
true, wenn das Bookmark-Steuerelement, auf das diese Methode angewendet wird, mit dem vom Range-Argument angegebenen Bereich übereinstimmt; andernfalls false.

Hinweise

Diese Methode vergleicht die Positionen der Anfangszeichen und der Endzeichen sowie den Texttyp. Wenn für beide Objekte alle drei dieser Elemente übereinstimmen, sind die Objekte gleich.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird dem Dokument ein Bookmark-Steuerelement mit Text hinzugefügt und anschließend überprüft, ob der Bereich des Lesezeichens mit dem Bereich des ersten Absatzes übereinstimmt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkIsEqual()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "This is sample bookmark text."
    Bookmark1.InsertAfter(" This is additional text.")

    If Bookmark1.IsEqual(Me.Paragraphs(1).Range) Then
        MessageBox.Show("The bookmark's range is equal to " _
            & "the range of the first paragraph.")
    Else
        MessageBox.Show("The bookmark's range is not equal to " _
            & "the range of the first paragraph.")
    End If

End Sub

private void BookmarkIsEqual()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";
    bookmark1.InsertAfter(" This is additional text.");
    if (bookmark1.IsEqual(this.Paragraphs[1].Range))
    {
        MessageBox.Show("The bookmark's range is equal to "+
            "the range of the first paragraph.");
    }
    else
    {
        MessageBox.Show("The bookmark's range is not equal to " +
            "the range of the first paragraph.");
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über