Bookmark.MoveStartWhile-Methode

Artikel
08/10/2011

Verschiebt die Anfangsposition des Bookmark-Steuerelements, solange ein beliebiges 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 MoveStartWhile ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveStartWhile(
    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 nach unten verschoben.Wenn es eine negative Zahl ist, wird das Bookmark-Steuerelement nach oben verschoben.Der Standardwert ist wdForward.

Rückgabewert

Typ: System.Int32
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.

Hinweise

Solange beliebige Zeichen in Cset gefunden werden, wird die Anfangsposition des Bookmark-Steuerelements verschoben.

Wenn die Anfangsposition nach unten an eine Stelle hinter die ursprünglichen Endposition verschoben wird, wird die Endposition auf die neue Anfangsposition festgelegt.

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 der Bereich des Lesezeichens verschoben, solange die Zeichen T, h, i oder s gefunden werden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

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);
}

.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