Bookmark.Collapse (Método)
Contrae un control Bookmark hasta la posición inicial o final.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Sub Collapse ( _
ByRef direction As Object _
)
void Collapse(
ref Object direction
)
Parámetros
- direction
Tipo: System.Object%
Dirección en la que se contrae el control Bookmark.Puede ser una de las constantes WdCollapseDirection siguientes: wdCollapseEnd o wdCollapseStart.El valor predeterminado es wdCollapseStart.
Comentarios
Después de contraer un control Bookmark, los puntos inicial y final serán iguales.
Si se utiliza wdCollapseEnd para contraer un control Bookmark que hace referencia a un párrafo completo, el intervalo se ubicará tras la marca de párrafo final (el principio del párrafo siguiente). No obstante, puede hacer retroceder el intervalo en un carácter con el método MoveEnd después de que se contraiga el intervalo del control Bookmark.
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 y, a continuación, muestra la posición inicial y final antes y después de la contracción del marcador.
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub BookmarkCollapse()
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."
MessageBox.Show("Start and end of Bookmark1 before calling Collapse: " _
& Bookmark1.Start.ToString() & " and " & Bookmark1.End.ToString)
Dim Direction As Object = Word.WdCollapseDirection.wdCollapseEnd
Bookmark1.Collapse(Direction)
MessageBox.Show("Start and end of Bookmark1 after calling Collapse: " _
& Bookmark1.Start.ToString() & " and " & Bookmark1.End.ToString)
End Sub
private void BookmarkCollapse()
{
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.";
MessageBox.Show("Start and end of bookmark1 before calling Collapse: " +
bookmark1.Start.ToString() + " and " + bookmark1.End.ToString());
object Direction = Word.WdCollapseDirection.wdCollapseEnd;
bookmark1.Collapse(ref Direction);
MessageBox.Show("Start and end of bookmark1 after calling Collapse: " +
bookmark1.Start.ToString() + " and " + bookmark1.End.ToString());
}
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.