Bookmark.MoveWhile, méthode

Article
01/06/2014

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

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Function MoveWhile ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

int MoveWhile(
    ref Object cset,
    ref Object count
)

Paramètres

cset
Type : System.Object%
Un ou plusieurs caractères.Cet argument respecte la casse.

count
Type : System.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 contrôle Bookmark est avancé 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.

Valeur de retour

Type : System.Int32
Nombre de caractères selon lequel le contrôle Bookmark a été déplacé.Si aucun caractère Cset n'est trouvé, le contrôle Bookmark n'est pas modifié et la méthode retourne 0 (zéro).

Notes

Jusqu'à ce qu'un caractère de Cset soit trouvé, le contrôle Bookmark est déplacé. Le Bookmark est réduit à un signet de longueur nulle.

Paramètres optionnels

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

Exemples

L'exemple de code suivant ajoute au premier paragraphe un contrôle Bookmark avec du texte, puis ajoute un autre contrôle Bookmark au troisième mot du premier signet. Ensuite, le code réduit et déplace le deuxième signet jusqu'à ce qu'il trouve les caractères b, o, o ou k.

Cet exemple illustre une personnalisation au niveau du document.

Private Sub BookmarkMoveWhile()

    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.MoveWhile("stamp", Bookmark1.Characters.Count)
End Sub

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

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

Bookmark Interface

Microsoft.Office.Tools.Word, espace de noms

Partager via