Más información Xceed Words para .NET
Esta semana, veremos 2 elementos más que se pueden añadir en tus documentos: Marcadores e Hipervínculos.
Marcadores
Un marcador en un archivo DocX funciona como un marcador que podrías colocar en un libro, marca un lugar que quieres poder volver a encontrar fácilmente. Puede dar a cada marcador un nombre único para que sean fáciles de identificar, y no hay límite de cuántos puede tener en un documento determinado.
Añadir marcadores
Para añadir un marcador, llame a Insertar marca en el Documento. También puede añadir un marcador a un párrafo específico llamando a Añadir marca en ese párrafo.
// Insert a bookmark in the document.
document.InsertBookmark( "Bookmark1" );
// Append a bookmark to a specific paragraph.
var p2 = document.Paragraphs[ 2 ];
p2.AppendBookmark( "Bookmark2" );
Eliminar marcadores
La eliminación de un marcador existente de un párrafo se realiza llamando a Eliminar marca en el Apartado.
// Remove an existing bookmark from a paragraph
var p3 = document.Paragraphs[ 3 ];
p3.RemoveBookmark( "Bookmark3" );
Uso de marcadores
Los marcadores pueden utilizarse para mostrar o insertar fácilmente texto en la posición específica que indican.
Esto puede hacerse llamando a InsertAtBookmark en Documento o Apartado, o llamando al ReplaceAtBookmark en el párrafo.
- InsertAtBookmark: inserta el texto proporcionado antes de la posición del Marcador.
- ReplaceAtBookmark: sustituye el texto en la posición del Marcador.
// Insert new text before a document’s bookmark.
document.InsertAtBookmark( "Text to insert", "Bookmark1" );
// Insert new text before a paragraph’s bookmark.
var p2 = document.Paragraphs[ 2 ];
p2.InsertAtBookmark( "Text to insert", "Bookmark2" );
// Replace a bookmark’s text
var p3 = document.Paragraphs[ 3 ];
p3.ReplaceAtBookmark( "New Text", "Bookmark3" );
Nota: ambos InsertAtBookmark y ReplaceAtBookmark aceptan un 3er parámetro opcional para especificar el Formato a aplicar sobre el texto a insertar o reemplazar.
Recuperar favoritos
La lista de Marcadores existentes puede recuperarse llamando a Marcadores en Documento, o Obtener favoritos en el párrafo.
- Marcadores: obtiene la colección de marcadores del Documento.
- Obtener marcadores: obtiene la lista de marcadores del párrafo.
// Get a document’s list of bookmarks
var dBookmarks = document.Bookmarks;
// Get a paragraph’s list of bookmarks.
var p = document.Paragraphs[ 2 ];
var pBookmarks = p.GetBookmarks();
Hiperenlaces
Un hipervínculo en un archivo DocX es una o más palabras sobre las que se puede hacer clic para saltar a una nueva ubicación, ya sea en otra parte del documento actual, o a otra ubicación (como la URL de un sitio web para abrirlo en un navegador web). Los hipervínculos suelen ser azules y estar subrayados, pero pueden tener cualquier formato que usted decida aplicarles.
Añadir hipervínculos
Para añadir un hiperenlace, primero hay que llamar a Añadir hipervínculo en el Documento para añadir ese enlace a la colección de hipervínculos del documento. A continuación, ese hipervínculo puede añadirse a un párrafo llamando a InsertHyperlink o AppendHyperlink en el párrafo.
// Add a hyperlink to the Document’s Hyperlink collection
Hyperlink link = document.AddHyperlink( "website", new Uri( "http://xceed.com" ) );
// Add a paragraph that uses the hyperlink
document.InsertParagraph( "Visit our " ).AppendHyperlink( link ).Append( " for more information." );
Eliminar hipervínculos
La eliminación de un hiperenlace existente de un párrafo se realiza llamando a EliminarHiperenlace en el Apartado.
// Remove a hyperlink from a paragraph
var p3 = document.Paragraphs[ 3 ];
p3.RemoveHyperlink( 2 );
Recuperación de hipervínculos
La lista de Hiperenlaces existentes puede recuperarse llamando a Hiperenlaces en Documento o Párrafo.
// Get a document’s list of hyperlinks
var dBookmarks = document.Hyperlinks;
// Get a paragraph’s list of bookmarks.
var p = document.Paragraphs[ 2 ];
var pBookmarks = p.Hyperlinks;
