Metodo Bookmark.Collapse

Articolo
08/11/2011

Comprime un controllo Bookmark nella posizione iniziale o finale.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

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

void Collapse(
    ref Object direction
)

Parametri

direction
Tipo: System.Object%
Direzione in base a cui comprimere l'oggetto Bookmark.Può essere una delle seguenti costanti WdCollapseDirection: wdCollapseEnd o wdCollapseStart.Il valore predefinito è wdCollapseStart.

Note

Dopo la compressione di un controllo Bookmark, i punti iniziale e finale saranno uguali.

Se si utilizza wdCollapseEnd per comprimere un controllo Bookmark che fa riferimento a un intero paragrafo, l'intervallo verrà posizionato dopo il segno di paragrafo finale (ossia, all'inizio del paragrafo successivo). Tuttavia, dopo la compressione dell'intervallo del controllo Bookmark, è possibile riportare indietro l'intervallo di un carattere mediante il metodo MoveEnd.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente viene aggiunto un controllo Bookmark con testo e viene visualizzata la posizione iniziale e finale del segnalibro prima e dopo la relativa compressione.

Questo esempio è valido per una personalizzazione a livello di 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());
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Bookmark Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite