Bookmark.MoveUntil(Object, Object) Metoda

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Word

Sestavení:: Microsoft.Office.Tools.Word.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přesune Bookmark ovládací prvek, dokud se v dokumentu nenajde jeden ze zadaných znaků.

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

Jeden nebo několik znaků. Pokud je nějaký znak v Cset souboru nalezen před vypršením Count platnosti hodnoty, Bookmark je ovládací prvek umístěn jako kurzor bezprostředně před tímto znakem. Tento argument rozlišuje velká a malá písmena.

count: Object

Maximální počet znaků, o které Bookmark má být ovládací prvek přesunut. Může to být číslo nebo konstantawdForward.wdBackward Pokud Count je kladné číslo, posune Bookmark se ovládací prvek v dokumentu dopředu, počínaje koncovým umístěním. Pokud se jedná o záporné číslo, Bookmark ovládací prvek se přesune dozadu, počínaje počáteční pozicí. Výchozí hodnota je wdForward.

Návraty

Int32

Počet znaků, o které Bookmark byl ovládací prvek přesunut. Pokud Count je větší než 0 (nula), vrátí tato metoda počet přesunutých znaků plus jeden. Pokud Count je menší než 0 (nula), vrátí tato metoda počet přesunutých znaků minus jeden. Pokud nejsou nalezeny žádné Cset znaky, Bookmark ovládací prvek se nezmění a metoda vrátí hodnotu 0 (nula).

Příklady

Následující příklad kódu přidá ovládací prvek Bookmark s textem do prvního odstavce a pak přidá další Bookmark ovládací prvek do třetího slova v první záložce. Kód pak přesune oblast druhé záložky, zatímco může najít prázdné místo.

Tento příklad je pro přizpůsobení na úrovni 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

Poznámky

Je Bookmark sbalený na záložku nulové délky.

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro Systém Office.

Platí pro