Bookmark.MoveUntil(Object, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

Microsoft.Office.Tools.Word.dll

Przenosi kontrolkę Bookmark do momentu znalezienia jednego z określonych znaków w dokumencie.

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

abstract member MoveUntil : obj * obj -> int

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

Parametry

cset

Object

Co najmniej jeden znak. Jeśli jakikolwiek znak w pliku Cset zostanie znaleziony przed Count wygaśnięciem wartości, Bookmark kontrolka zostanie umieszczona jako punkt wstawiania bezpośrednio przed tym znakiem. 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 Count wartość jest większa niż 0 (zero), ta metoda zwraca liczbę znaków przeniesionych plus jeden. Jeśli Count wartość jest mniejsza niż 0 (zero), ta metoda zwraca liczbę znaków przeniesionych minus jeden. 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 przenosi zakres drugiej zakładki, gdy może znaleźć puste miejsce.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

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

Uwagi

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.