Bookmark.MoveUntil(Object, Object) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Déplace le contrôle Bookmark jusqu'à ce qu'il trouve dans le document un des caractères spécifiés.

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

Paramètres

cset: Object

Un ou plusieurs caractères. Si un caractère dans Cset est trouvé avant l’expiration de la Count valeur, le Bookmark contrôle est positionné en tant que point d’insertion immédiatement avant ce caractère. Cet argument respecte la casse.

count: Object

Nombre maximal de caractères de déplacement du contrôle Bookmark. Il peut s'agir d'un nombre ou de la constante wdForward ou wdBackward. Si Count est un nombre positif, le Bookmark contrôle est déplacé vers l’avant dans le document, en commençant à la position de fin. Si c'est un nombre négatif, le contrôle Bookmark est déplacé vers l'arrière, en commençant à la position de début. La valeur par défaut est wdForward.

Retours

Int32

Nombre de caractères selon lequel le contrôle Bookmark a été déplacé. Si Count est supérieur à 0 (zéro), cette méthode retourne le nombre de caractères déplacé plus un. Si Count est inférieur à 0 (zéro), cette méthode retourne le nombre de caractères déplacé moins un. Si aucun caractère Cset n'est trouvé, le contrôle Bookmark n'est pas modifié et la méthode retourne 0 (zéro).

Exemples

L’exemple de code suivant ajoute un Bookmark contrôle avec du texte au premier paragraphe, puis ajoute un autre Bookmark contrôle au troisième mot du premier signet. Le code déplace ensuite la plage du deuxième signet alors qu’il peut trouver un espace vide.

Cet exemple concerne une personnalisation au niveau du document.

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

Remarques

le Bookmark est réduit à un signet de longueur zéro.

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à

Share via