Freigeben über


Bookmark.MoveStartWhile(Object, Object) Methode

Definition

Verschiebt die Anfangsposition des Bookmark-Steuerelements, solange ein beliebiges der angegebenen Zeichen im Dokument gefunden wird.

public int MoveStartWhile (ref object cset, ref object count);
abstract member MoveStartWhile : obj * obj -> int
Public Function MoveStartWhile (ByRef cset As Object, Optional ByRef count As Object) As Integer

Parameter

cset
Object

Ein oder mehrere Zeichen. 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 es sich um eine positive Zahl handelt, wird das Bookmark Steuerelement im Dokument nach vorne verschoben. Wenn es eine negative Zahl ist, wird das Bookmark-Steuerelement nach oben verschoben. Der Standardwert ist wdForward.

Gibt zurück

Die Anzahl von Zeichen, um die die Startposition des Bookmark-Steuerelements 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 hinzugefügt und dann der Bereich des Lesezeichens verschoben, während die Zeichen T, h, i oder s gefunden werden können.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

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

    bookmark1.MoveStartWhile(ref cSet, ref Count);
}
Private Sub BookmarkMoveStartWhile()

    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.MoveStartWhile("This", Bookmark1.Characters.Count)
End Sub

Hinweise

Während ein beliebiges Zeichen in Cset gefunden wird, wird die Startposition des Bookmark Steuerelements verschoben.

Wenn die Startposition nach vorne in eine Position verschoben wird, die über die ursprüngliche Endposition hinausgeht, wird die Endposition auf die neue Startposition festgelegt.

Optionale Parameter

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

Gilt für: