Partager via


Bookmark.MoveStartWhile, méthode

Déplace la position de début du 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 MoveStartWhile ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer
int MoveStartWhile(
    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.Si c'est un nombre négatif, le contrôle Bookmark est déplacé vers l'arrière.La valeur par défaut est wdForward.

Valeur de retour

Type : System.Int32
Déplacement de la position de début du contrôle Bookmark, exprimé en nombre de caractères.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

Si un caractère de Cset est trouvé, la position de début du contrôle Bookmark est déplacée.

Si la position de début est avancée jusqu'à une position au-delà de la position de fin d'origine, la nouvelle position de début devient aussi la position de fin.

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 déplace la plage du signet jusqu'à ce qu'il trouve les caractères T, h, i ou s.

Cet exemple illustre une personnalisation au niveau du document.

Private Sub BookmarkMoveStartWhile()

    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.MoveStartWhile("This", Bookmark1.Characters.Count)
End Sub
private void BookmarkMoveStartWhile()
{
    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 = "This";

    bookmark1.MoveStartWhile(ref cSet, ref Count);
}

Sécurité .NET Framework

Voir aussi

Référence

Bookmark Interface

Microsoft.Office.Tools.Word, espace de noms