Bookmark.MoveEnd-Methode

Artikel
08/10/2011

Verschiebt die Position des Endzeichens eines Bookmark-Steuerelements.

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

Syntax

'Declaration
Function MoveEnd ( _
    ByRef unit As Object, _
    ByRef count As Object _
) As Integer

int MoveEnd(
    ref Object unit,
    ref Object count
)

Parameter

unit
Typ: System.Object%
Die Einheit, um die die Position des Endzeichens verschoben wird.

count
Typ: System.Object%
Die Anzahl der Einheiten, um die der Bereich verschoben wird.Wenn diese Zahl positiv ist, wird die Position des Endzeichens im Dokument nach unten verschoben.Wenn diese Zahl negativ ist, wird die Position des Endzeichens im Dokument nach oben verschoben.Wenn die Endposition mit der Anfangsposition übereinstimmt, wird der Bereich reduziert, und beide Zeichenpositionen werden zusammengelegt.Der Standardwert ist 1.

Rückgabewert

Typ: System.Int32
Die Anzahl der Einheiten, um die das Bookmark-Steuerelement tatsächlich verschoben wurde. Es wird 0 (null) zurückgegeben, wenn die Verschiebung nicht erfolgreich war.

Hinweise

Optionale Parameter

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

Beispiele

Im folgenden Codebeispiel wird dem ersten Absatz ein Bookmark-Steuerelement mit Text hinzugefügt. Anschließend wird das letzte Wort im Lesezeichen in einem Meldungsfeld angezeigt. Der Code ruft dann die MoveEnd-Methode auf und zeigt das letzte Wort des Lesezeichens in einem neuen Meldungsfeld an.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

    MessageBox.Show("Last word of bookmark prior to calling MoveEnd: " _
        & Bookmark1.Words.Last.Text)

    Bookmark1.MoveEnd(Word.WdUnits.wdWord, 1)

    MessageBox.Show("Last word of bookmark after calling MoveEnd: " _
        & Bookmark1.Words.Last.Text)
End Sub

private void BookmarkMoveEnd()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Text = "This is sample text.";
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range.Words[3],
        "bookmark1");

    object Unit = Word.WdUnits.wdWord;
    object Count = 1;

    MessageBox.Show("Last word of bookmark prior to calling MoveEnd: "
        + bookmark1.Words.Last.Text);

    bookmark1.MoveEnd(ref Unit, ref Count);

    MessageBox.Show("Last word of bookmark after calling MoveEnd: "
        + bookmark1.Words.Last.Text);

}

.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