Bookmark.MoveStart(Object, Object) Methode

Definition

Verschiebt die Anfangsposition des Bookmark-Steuerelements.

public int MoveStart (ref object unit, ref object count);
abstract member MoveStart : obj * obj -> int
Public Function MoveStart (Optional ByRef unit As Object, Optional ByRef count As Object) As Integer

Parameter

unit
Object

Microsoft.Office.Interop.Word.WdUnits. Die Einheit, um die die Anfangsposition des angegebenen Bereichs oder der angegebenen Auswahl verschoben werden soll.

count
Object

Die maximale Anzahl von Einheiten, um die das Bookmark-Steuerelement verschoben werden soll. Wenn Count es sich um eine positive Zahl handelt, wird die Startposition des Bookmark Steuerelements im Dokument nach vorne verschoben. Wenn es eine negative Zahl ist, wird die Anfangsposition nach oben verschoben. 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. Der Standardwert ist 1.

Gibt zurück

Die Anzahl der Einheiten, um die die Anfangsposition des Bookmark-Steuerelements tatsächlich verschoben wurde. Es wird 0 (null) zurückgegeben, wenn die Verschiebung nicht erfolgreich war.

Beispiele

Im folgenden Codebeispiel wird dem ersten Absatz ein Bookmark Steuerelement mit Text hinzugefügt und dann die Startposition der Lesezeichen verschoben.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

private void BookmarkMoveStart()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Text = "This is sample text.";
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range.Words[3],
        "bookmark1");
    
    object Unit = Word.WdUnits.wdCharacter;
    object Count = 3;

    bookmark1.MoveStart(ref Unit, ref Count);
                
}
Private Sub BookmarkMoveStart()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Text = "This is sample text."
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range.Words(3), _
        "Bookmark1")

    MessageBox.Show("First word of bookmark prior to calling MoveStart: " _
        & Bookmark1.Words.First.Text)

    Bookmark1.MoveStart(Word.WdUnits.wdCharacter, 4)
    
    MessageBox.Show("First word of bookmark prior to calling MoveStart: " _
        & Bookmark1.Words.First.Text)
End Sub

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für: