Bookmark.MoveStart-Methode

Artikel
08/10/2011

Verschiebt die Anfangsposition des Bookmark-Steuerelements.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Function MoveStart ( _
    ByRef unit As Object, _
    ByRef count As Object _
) As Integer

int MoveStart(
    ref Object unit,
    ref Object count
)

Parameter

unit
Typ: System.Object%
WdUnits.Die Einheit, um die die Anfangsposition des angegebenen Bereichs oder der angegebenen Auswahl verschoben werden soll.

count
Typ: System.Object%
Die maximale Anzahl von Einheiten, um die das Bookmark-Steuerelement verschoben werden soll.Wenn Count eine positive Zahl ist, wird die Anfangsposition des Bookmark-Steuerelements im Dokument nach unten 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.

Rückgabewert

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

Hinweise

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 die Anfangsposition des Lesezeichens verschoben.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

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

}

.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