Bookmark.MoveStartUntil(Object, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Word

Zestaw:

Microsoft.Office.Tools.Word.dll

Przenosi pozycję początkową Bookmark kontrolki do momentu znalezienia jednego z określonych znaków w dokumencie.

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

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 zostanie przeniesiona Bookmark do przodu w dokumencie. Jeśli jest to liczba ujemna, kontrolka zostanie przeniesiona do tyłu Bookmark . Wartość domyślna to wdForward.

Zwraca

Int32

Liczba znaków, za pomocą których pozycja początkowa kontrolki Bookmark została przeniesiona. 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 przenosi zakres zakładki do momentu znalezienia spacji.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Jeśli ruch jest do tyłu przez dokument, kontrolka zostanie rozwinięta Bookmark .

Jeśli pozycja początkowa zostanie przeniesiona do przodu do punktu poza pozycją końcową, Bookmark kontrolka zostanie zwinięty, a zarówno pozycje początkowe, jak i końcowe zostaną przeniesione razem.

Parametry opcjonalne

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