Bookmark.Collapse Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Сворачивает элемент управления Bookmark до начального или конечного положения.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Sub Collapse ( _
    ByRef Direction As Object _
)
'Применение
Dim instance As Bookmark
Dim Direction As Object

instance.Collapse(Direction)

public void Collapse(
    ref Object Direction
)

Параметры

Direction
Тип: System.Object%
Направление, в котором необходимо свернуть элемент управления Bookmark. Свойство может принимать значения одной из следующих констант WdCollapseDirection: wdCollapseEnd или wdCollapseStart. Значение по умолчанию — wdCollapseStart.

Заметки

После сворачивания элемента управления Bookmark начальная и конечная точки совпадают.

При использовании метода wdCollapseEnd для сворачивания элемента управления Bookmark, который ссылается на целый абзац, диапазон размещается после знака конца абзаца (в начале следующего абзаца). Однако диапазон можно переместить на один знак назад, вызвав метод MoveEnd после сворачивания диапазона элемента управления Bookmark.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В приведенном ниже примере кода в документ добавляется элемент управления Bookmark с текстом, после чего начальное и конечное положение закладки выводятся до и после сворачивания закладки.

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Поделиться через