Bookmark.MoveWhile(Object, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

Microsoft.Office.Tools.Word.dll

Przenosi kontrolkę, Bookmark gdy dowolny z określonych znaków znajduje się w dokumencie.

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

abstract member MoveWhile : obj * obj -> int

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

Parametry

cset

Object

Co najmniej jeden znak. Ten argument uwzględnia wielkość liter.

count

Object

Maksymalna liczba znaków, za pomocą których ma zostać przeniesiona kontrolka Bookmark . Może być liczbą lub stałą wdForward lub wdBackward . Jeśli Count jest liczbą dodatnią, kontrolka Bookmark zostanie przeniesiona do przodu w dokumencie, zaczynając od pozycji końcowej. Jeśli jest to liczba ujemna, kontrolka Bookmark zostanie przeniesiona do tyłu, zaczynając od pozycji początkowej. Wartość domyślna to wdForward.

Zwraca

Int32

Liczba znaków, za pomocą których kontrolka została przeniesiona Bookmark . Jeśli nie Cset znaleziono żadnych znaków, kontrolka Bookmark nie zostanie zmieniona, a metoda zwróci wartość 0 (zero).

Przykłady

Poniższy przykład kodu dodaje kontrolkę Bookmark z tekstem do pierwszego akapitu, a następnie dodaje kolejną Bookmark kontrolkę do trzeciego wyrazu w pierwszej zakładce. Następnie kod zwija się i przenosi drugą zakładkę, gdy może znajdować znaki b, o, o lub k.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

private void BookmarkMoveWhile()
{
    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 = "book";

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

Private Sub BookmarkMoveWhile()

    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.MoveWhile("stamp", Bookmark1.Characters.Count)
End Sub

Uwagi

Podczas znajdowania dowolnego znaku Cset kontrolka jest przenoszona Bookmark . Element Bookmark jest zwinięty do zakładki o zerowej długości.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.