Bookmark.MoveEndUntil-Methode

Artikel
08/10/2011

Verschiebt die Endposition des Bookmark-Steuerelements, 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 MoveEndUntil ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveEndUntil(
    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 Endposition des Bookmark-Steuerelements verschoben wurde.Wenn Count größer als 0 (null) ist, gibt diese Methode die Anzahl der Zeichen plus 1 zurück, um die verschoben wurde.Wenn Count kleiner als 0 (null) ist, gibt diese Methode die Anzahl der Zeichen minus 1 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

Wenn im Dokument nach unten verschoben wird, wird das Bookmark-Steuerelement erweitert.

Wenn die Endposition nach oben an eine Stelle verschoben wird, die vor der ursprünglichen Anfangsposition liegt, wird die Anfangsposition auf die neue Endposition 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 dem dritten Wort im ersten Lesezeichen ein weiteres Bookmark-Steuerelement hinzugefügt. Der Code verschiebt dann den Bereich des zweiten Lesezeichens, bis das Zeichen k gefunden wird.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkMoveEndUntil()
    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.MoveEndUntil("k", Bookmark1.Characters.Count)
End Sub

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

    bookmark2.MoveEndUntil(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