Método Bookmark.Collapse

Artigo
08/01/2011

Recolhe uma Bookmark o controle para a posição inicial ou final.

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

Sintaxe

'Declaração
Sub Collapse ( _
    ByRef direction As Object _
)

void Collapse(
    ref Object direction
)

Parâmetros

direction
Tipo: System.Object%
A direção na qual recolher o Bookmark.Pode ser uma das seguintes WdCollapseDirection constantes: wdCollapseEnd or wdCollapseStart.O valor padrão é wdCollapseStart.

Comentários

Após um Bookmark está recolhido, os pontos inicial e final são iguais.

Se você usar wdCollapseEnd para recolher uma Bookmark o controle que se refere a um parágrafo inteiro, o intervalo está localizado após a marca de parágrafo final (o início do próximo parágrafo). No entanto, você pode mover o intervalo de um caractere de volta usando o MoveEnd método após o intervalo da Bookmark está recolhido.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir adiciona um Bookmark o controle com texto e, em seguida, exibe posicionar o início e no final do indicador antes e depois recolhendo o indicador.

Este exemplo é para uma personalização em nível de documento.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Bookmark Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via