Bookmark.MoveEndUntil(Object, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

Microsoft.Office.Tools.Word.dll

Przenosi położenie końcowe kontrolki Bookmark do momentu znalezienia w dokumencie dowolnego z określonych znaków.

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

abstract member MoveEndUntil : obj * obj -> int

Public Function MoveEndUntil (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 kontrolka ma zostać przeniesiona Bookmark . Może być liczbą lub stałą wdForward lub wdBackward . Jeśli Count jest liczbą dodatnią, kontrolka zostanie przeniesiona Bookmark do przodu w dokumencie. Jeśli jest to liczba ujemna, kontrolka zostanie przeniesiona Bookmark do tyłu. Wartość domyślna to wdForward.

Zwraca

Int32

Liczba znaków, do których została przeniesiona pozycja końcowa kontrolki Bookmark . Jeśli Count wartość jest większa niż 0 (zero), ta metoda zwraca liczbę znaków przeniesionych plus 1. Jeśli Count wartość jest mniejsza niż 0 (zero), ta metoda zwraca liczbę znaków przeniesionych minus 1. 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 do momentu znalezienia znaku k.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

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

Private Sub BookmarkMoveEndUntil()
    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.MoveEndUntil("k", Bookmark1.Characters.Count)
End Sub

Uwagi

Jeśli ruch jest przekazywany do przodu w dokumencie, kontrolka zostanie rozwinięta Bookmark .

Jeśli pozycja końcowa zostanie przeniesiona do tyłu do punktu poprzedzającego oryginalną pozycję początkową, pozycja początkowa zostanie ustawiona na nową pozycję końcową.

Parametry opcjonalne

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