Bookmark.MoveUntil (Método)
Desplaza el control Bookmark hasta que encuentra 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 MoveUntil ( _
ByRef cset As Object, _
ByRef count As Object _
) As Integer
int MoveUntil(
ref Object cset,
ref Object count
)
Parámetros
- cset
Tipo: System.Object%
Uno o más caracteres.Si se encuentra cualquier carácter en Cset antes de que el valor Count expire, el control Bookmark se coloca inmediatamente antes de ese carácter como punto de inserción.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 avanza en el documento comenzando por la posición final.Si es un número negativo, el control Bookmark retrocede comenzando por la posición inicial.El valor predeterminado es wdForward.
Valor devuelto
Tipo: System.Int32
El número de caracteres que se ha desplazado el control Bookmark.Si Count es mayor que 0 (cero), este método devuelve el número de caracteres que se ha desplazado más uno.Si Count es menor que 0 (cero), este método devuelve el número de caracteres que se ha desplazado menos uno.Si no se encuentra ningún carácter Cset, el control Bookmark no cambia y el método devuelve 0 (cero).
Comentarios
El control Bookmark se contrae a un marcador de longitud cero.
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 agrega otro control Bookmark a la tercera palabra del primer marcador.A continuación, el código mueve el intervalo del segundo marcador siempre que encuentre un espacio en blanco.
Se trata de un ejemplo para una personalización en el nivel del documento.
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
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);
}
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.