Bookmark.MoveStartUntil-Methode

Artikel
01/03/2014

Verschiebt die Anfangsposition 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 MoveStartUntil ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveStartUntil(
    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 Anfangsposition 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 oben verschoben wird, wird das Bookmark-Steuerelement erweitert.

Wenn die Anfangsposition nach unten an eine Stelle hinter die Endposition verschoben wird, wird das Bookmark-Steuerelement reduziert, und die Anfangsposition wird mit der Endposition zusammengelegt.

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, bis ein Leerzeichen gefunden wird.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkMoveStartUntil()

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

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

    bookmark1.MoveStartUntil(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