Bookmark.MoveStartUntil(Object, Object) Metodo

Definizione

Spazio dei nomi:

Microsoft.Office.Tools.Word

Assembly:

Microsoft.Office.Tools.Word.dll

Sposta la posizione iniziale del controllo Bookmark finché non viene trovato nel documento uno dei caratteri specificati.

public int MoveStartUntil (ref object cset, ref object count);

abstract member MoveStartUntil : obj * obj -> int

Public Function MoveStartUntil (ByRef cset As Object, Optional ByRef count As Object) As Integer

Parametri

cset

Object

Uno o più caratteri. L'argomento prevede la distinzione tra maiuscole e minuscole.

count

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 Bookmark controllo viene spostato in avanti nel documento. Se è un numero negativo, il controllo Bookmark verrà spostato indietro. Il valore predefinito è wdForward.

Restituisce

Int32

Numero di caratteri in base al quale è stata spostata la posizione iniziale del controllo Bookmark. Se il parametro Count è maggiore di 0 (zero), questo metodo restituirà il numero di caratteri spostati più 1. Se il parametro Count è minore di 0 (zero), questo metodo restituirà il numero di caratteri spostati meno 1. Se non vengono trovati caratteri Cset, il controllo Bookmark non verrà modificato e il metodo restituirà 0 (zero).

Esempio

Nell'esempio di codice seguente viene aggiunto un Bookmark controllo con testo al primo paragrafo e quindi viene spostato l'intervallo del segnalibro finché non viene trovato uno spazio.

Questo esempio è relativo a una personalizzazione a livello di documento.

private void BookmarkMoveStartUntil()
{
    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.";
 
    object Count = bookmark1.Characters.Count;
    object cSet = " ";

    bookmark1.MoveStartUntil(ref cSet, ref Count);
}

Private Sub BookmarkMoveStartUntil()

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

    Bookmark1.MoveStartUntil(" ", Bookmark1.Characters.Count)
End Sub

Commenti

Se lo spostamento viene eseguito all'indietro nel documento, il Bookmark controllo viene espanso.

Se la posizione iniziale viene spostata in avanti a un punto oltre la posizione finale, il Bookmark controllo viene compresso e entrambe le posizioni iniziale e finale vengono spostate insieme.

Parametri facoltativi

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