Bookmark.MoveUntil-Methode

Artikel
08/10/2011

Verschiebt das Bookmark-Steuerelement, bis 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 MoveUntil ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveUntil(
    ref Object cset,
    ref Object count
)

Parameter

cset
Typ: System.Object%
Ein oder mehrere Zeichen.Wenn ein beliebiges Zeichen in Cset gefunden wird, bevor der Count-Wert abläuft, wird das Bookmark-Steuerelement als Einfügemarke unmittelbar vor diesem Zeichen platziert.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 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.

Hinweise

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 verschiebt dann den Bereich des zweiten Lesezeichens, solange Leerzeichen gefunden werden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

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

.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