Bookmark.MoveStartWhile (Método)
Mueve la posición inicial del control Bookmark hasta que se encuentre en el documento alguno de los caracteres especificados.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Function MoveStartWhile ( _
ByRef cset As Object, _
ByRef count As Object _
) As Integer
int MoveStartWhile(
ref Object cset,
ref Object count
)
Parámetros
- cset
Tipo: System.Object%
Uno o más caracteres.Este argumento distingue entre mayúsculas y minúsculas.
- count
Tipo: System.Object%
Número máximo de caracteres que se ha de desplazar el control Bookmark.Puede ser un número o la constante wdForward o wdBackward.Si Count es un número positivo, el control Bookmark se mueve hacia delante en el documento.Si es un número negativo, el control Bookmark retrocede.El valor predeterminado es wdForward.
Valor devuelto
Tipo: System.Int32
El número de caracteres que se ha desplazado la posición inicial del control Bookmark.Si no se encuentra ningún carácter Cset, el control Bookmark no cambia y el método devuelve 0 (cero).
Comentarios
Mientras se encuentre algún carácter en Cset, se desplaza la posición inicial del control Bookmark.
Si la posición inicial avanza una posición más allá de la posición final original, la posición final se establece como la nueva posición inicial.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente agrega un control Bookmark con texto al primer párrafo y, a continuación, mueve el intervalo del marcador mientras encuentra los caracteres T, h, i o s.
Se trata de un ejemplo para una personalización en el nivel del documento.
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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.