Bookmark.MoveEndWhile, méthode
Déplace la position du caractère de fin d'un contrôle Bookmark jusqu'à ce que l'un des caractères spécifiés soit trouvé dans le document.
Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)
Syntaxe
'Déclaration
Function MoveEndWhile ( _
ByRef cset As Object, _
ByRef count As Object _
) As Integer
int MoveEndWhile(
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 finale 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 fin du contrôle Bookmark est déplacée.
En cas de déplacement vers l'arrière de la position de fin jusqu'à un point précédant la position de début d'origine, la nouvelle position de fin devient aussi la position de début.
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. Le code déplace ensuite la plage du deuxième signet jusqu'à ce qu'il trouve les caractères b, o, o, k, m, a, r, ou k.
Cet exemple illustre une personnalisation au niveau du document.
Private Sub BookmarkMoveEndWhile()
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.MoveEndWhile("bookmark", Bookmark1.Characters.Count)
End Sub
private void BookmarkMoveEndWhile()
{
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 = "bookmark";
bookmark2.MoveEndWhile(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.