Bookmark.MoveUntil(Object, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verschiebt das Bookmark-Steuerelement, bis eines der angegebenen Zeichen im Dokument gefunden wird.

public int MoveUntil (ref object cset, ref object count);

abstract member MoveUntil : obj * obj -> int

Public Function MoveUntil (ByRef cset As Object, Optional ByRef count As Object) As Integer

Parameter

cset: Object

Ein oder mehrere Zeichen. Wenn ein Zeichen in Cset gefunden wird, bevor der Count Wert abläuft, wird das Bookmark Steuerelement als Einfügemarke unmittelbar vor diesem Zeichen positioniert. Bei diesem Argument ist die Groß-/Kleinschreibung zu beachten.

count: Object

Die maximale Anzahl von Zeichen, um die das Bookmark-Steuerelement verschoben werden soll. Kann eine Zahl oder entweder die wdForward-Konstante oder die wdBackward-Konstante sein. Wenn Count eine positive Zahl ist, wird das Bookmark Steuerelement im Dokument nach vorne verschoben, beginnend an der Endposition. Wenn es eine negative Zahl ist, wird das Bookmark-Steuerelement ausgehend von der Anfangsposition nach oben verschoben. Der Standardwert ist wdForward.

Gibt zurück

Int32

Die Anzahl der Zeichen, um die das Bookmark-Steuerelement verschoben wurde. Wenn Count größer als 0 (null) ist, gibt diese Methode die Anzahl der Zeichen plus eins zurück, um die verschoben wurde. Wenn Count kleiner als 0 (null) ist, gibt diese Methode die Anzahl der Zeichen minus eins zurück, um die verschoben wurde. Wenn keine Cset-Zeichen gefunden werden, wird das Bookmark-Steuerelement nicht geändert, und die Methode gibt 0 (null) zurück.

Beispiele

Im folgenden Codebeispiel wird dem ersten Absatz ein Bookmark Steuerelement mit Text und dann dem dritten Wort im ersten Lesezeichen ein weiteres Bookmark Steuerelement hinzugefügt. Der Code verschiebt dann den Bereich des zweiten Lesezeichens, während ein Leerzeichen gefunden werden kann.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

private void BookmarkMoveUntil()
{
    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.";

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(bookmark1.Words[3],
        "bookmark2");

    object Count = bookmark1.Characters.Count;
    object cSet = " ";

    bookmark2.MoveUntil(ref cSet, ref Count);
}

Private Sub BookmarkMoveUntil()

    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."

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")

    Bookmark2.MoveUntil(" ", Bookmark1.Characters.Count)
End Sub

Hinweise

Die Bookmark wird auf ein Lesezeichen der Länge Null reduziert.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über