Metodo Bookmark.MoveUntil

Articolo
05/17/2013

Sposta il controllo Bookmark finché non viene trovato nel documento uno dei caratteri specificati.

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

Sintassi

'Dichiarazione
Function MoveUntil ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveUntil(
    ref Object cset,
    ref Object count
)

Parametri

cset
Tipo: System.Object%
Uno o più caratteri.Se viene trovato un carattere in Cset prima della scadenza del valore Count, il controllo Bookmark verrà posizionato come punto di inserimento immediatamente prima di tale carattere.L'argomento prevede la distinzione tra maiuscole e minuscole.

count
Tipo: System.Object%
Numero massimo di caratteri in base al quale spostare il controllo Bookmark.Può essere un numero o la costante wdForward o wdBackward.Se Count è un numero positivo, il controllo Bookmark verrà spostato in avanti nel documento, iniziando in corrispondenza della posizione finale.Se è un numero negativo, il controllo Bookmark verrà spostato indietro, iniziando in corrispondenza della posizione iniziale.Il valore predefinito è wdForward.

Valore restituito

Tipo: System.Int32
Numero di caratteri in base al quale è stato spostato il controllo Bookmark.Se Count è maggiore di 0 (zero), questo metodo restituirà il numero di caratteri spostati più uno.Se Count è minore di 0 (zero), questo metodo restituirà il numero di caratteri spostati meno uno.Se non vengono trovati caratteri Cset, il controllo Bookmark non verrà modificato e il metodo restituirà 0 (zero).

Note

L'oggetto Bookmark viene compresso in un segnalibro di lunghezza zero.

Parametri facoltativi

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

Esempi

Nell'esempio di codice seguente vengono aggiunti un controllo Bookmark con testo al primo paragrafo e un altro controllo Bookmark alla terza parola nel primo segnalibro.L'intervallo del secondo segnalibro viene quindi spostato quando viene trovato uno spazio vuoto.

Questo esempio è valido per una personalizzazione a livello di documento.

Private Sub BookmarkMoveUntil()

    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."

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")

    Bookmark2.MoveUntil(" ", Bookmark1.Characters.Count)
End Sub

private void BookmarkMoveUntil()
{
    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.";

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(bookmark1.Words[3],
        "bookmark2");

    object Count = bookmark1.Characters.Count;
    object cSet = " ";

    bookmark2.MoveUntil(ref cSet, ref Count);
}

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