Bookmark.MoveWhile-Methode

Artikel
05/07/2013

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

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

Syntax

'Declaration
Function MoveWhile ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveWhile(
    ref Object cset,
    ref Object count
)

Parameter

cset
Typ: System.Object%
Ein oder mehrere Zeichen.Bei diesem Argument ist die Groß-/Kleinschreibung zu beachten.

count
Typ: System.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 ausgehend von der Endposition nach unten verschoben.Wenn es eine negative Zahl ist, wird das Bookmark-Steuerelement ausgehend von der Anfangsposition nach oben verschoben.Der Standardwert ist wdForward.

Rückgabewert

Typ: System.Int32
Die Anzahl der Zeichen, um die das Bookmark-Steuerelement verschoben wurde.Wenn keine Cset-Zeichen gefunden werden, wird das Bookmark-Steuerelement nicht geändert, und die Methode gibt 0 (null) zurück.

Hinweise

Solange beliebige Zeichen in Cset gefunden werden, wird das Bookmark-Steuerelement verschoben.Das Bookmark wird auf ein Lesezeichen mit einer Länge von 0 (null) reduziert.

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 dem dritten Wort im ersten Lesezeichen ein weiteres Bookmark-Steuerelement hinzugefügt.Der Code wird dann reduziert und verschiebt das zweite Lesezeichen, solange die Zeichen b, o, o oder k gefunden werden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkMoveWhile()

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

private void BookmarkMoveWhile()
{
    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 = "book";

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

.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