Bookmark.Collapse-Methode

Artikel
08/10/2011

Reduziert ein Bookmark-Steuerelement auf die Anfangsposition oder die Endposition.

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

Syntax

'Declaration
Sub Collapse ( _
    ByRef direction As Object _
)

void Collapse(
    ref Object direction
)

Parameter

direction
Typ: System.Object%
Die Richtung, in die Bookmark reduziert wird.Kann eine der folgenden WdCollapseDirection-Konstanten sein: wdCollapseEnd oder wdCollapseStart.Der Standardwert ist wdCollapseStart.

Hinweise

Nachdem ein Bookmark-Steuerelement reduziert wurde, stimmen die Anfangspunkte und die Endpunkte überein.

Wenn Sie zum Reduzieren von einem auf einen ganzen Absatz verweisendes Bookmark-Steuerelement wdCollapseEnd verwenden, befindet sich der Bereich nach der Markierung für das Ende des Absatzes (am Anfang des nächsten Absatzes). Sie können jedoch den Bereich um ein Zeichen zurück verschieben, indem Sie die MoveEnd-Methode verwenden, nachdem der Bereich des Bookmark-Steuerelements reduziert wurde.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird ein Bookmark-Steuerelement mit Text hinzugefügt und anschließend die Anfangsposition und die Endposition des Lesezeichens vor und nach dem Reduzieren des Lesezeichens angezeigt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkCollapse()

    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."
    MessageBox.Show("Start and end of Bookmark1 before calling Collapse: " _
        & Bookmark1.Start.ToString() & " and " & Bookmark1.End.ToString)

    Dim Direction As Object = Word.WdCollapseDirection.wdCollapseEnd
    Bookmark1.Collapse(Direction)

    MessageBox.Show("Start and end of Bookmark1 after calling Collapse: " _
        & Bookmark1.Start.ToString() & " and " & Bookmark1.End.ToString)

End Sub

private void BookmarkCollapse()
{
    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.";
    MessageBox.Show("Start and end of bookmark1 before calling Collapse: " +
        bookmark1.Start.ToString() + " and " + bookmark1.End.ToString());

    object Direction = Word.WdCollapseDirection.wdCollapseEnd;
    bookmark1.Collapse(ref Direction);

    MessageBox.Show("Start and end of bookmark1 after calling Collapse: " +
        bookmark1.Start.ToString() + " and " + bookmark1.End.ToString());
}

.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