En savoir plus sur Xceed Words pour .NET

Cette semaine, nous examinerons deux autres éléments qui peuvent être ajoutés dans vos documents : Les signets et les hyperliens.

Signets

Un signet dans un fichier DocX fonctionne comme un signet que l'on place dans un livre, il marque un endroit que l'on veut pouvoir retrouver facilement. Vous pouvez donner à chaque signet un nom unique pour qu'il soit facile à identifier, et il n'y a pas de limite au nombre de signets que vous pouvez avoir dans un document donné.

Ajout de signets

L'ajout d'un signet peut être effectué en appelant Insérer un signet sur le document. Vous pouvez également ajouter un signet à un paragraphe spécifique en appelant Ajouter un signet sur ce paragraphe.

// Insert a bookmark in the document.
document.InsertBookmark( "Bookmark1" );

// Append a bookmark to a specific paragraph.
var p2 = document.Paragraphs[ 2 ];
p2.AppendBookmark( "Bookmark2" );

Suppression des signets

La suppression d'un signet existant dans un paragraphe s'effectue en appelant Supprimer le signet sur le paragraphe.

// Remove an existing bookmark from a paragraph
var p3 = document.Paragraphs[ 3 ];
p3.RemoveBookmark( "Bookmark3" );

Utilisation des signets

Les signets peuvent être utilisés pour afficher ou insérer facilement du texte à l'endroit précis qu'ils indiquent.

Pour ce faire, il suffit d'appeler InsertAtBookmark sur Document ou Paragraphe, ou en appelant le Remplacer le signet sur le paragraphe.

• InsertAtBookmark : insère le texte fourni avant la position du signet.
• ReplaceAtBookmark : remplace le texte à la position du signet.

// 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" );

Note : les deux InsertAtBookmark et Remplacer le signet accepte un troisième paramètre facultatif pour spécifier le formatage à appliquer au texte à insérer ou à remplacer.

Récupération des signets

La liste des signets existants peut être récupérée en appelant Signets sur Document, ou Obtenir des signets sur le paragraphe.

• Signets : obtient la collection de signets du document.
• Obtenir des signets : obtient la liste des signets du paragraphe.

// 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();

Hyperliens

Un hyperlien dans un fichier DocX est un ou plusieurs mots sur lesquels on peut cliquer pour aller à un nouvel endroit, que ce soit ailleurs dans le document actuel ou à un autre endroit (comme l'URL d'un site web à ouvrir dans un navigateur web). Les hyperliens sont souvent bleus et soulignés, mais ils peuvent avoir le format de votre choix.

Ajout d'hyperliens

L'ajout d'un lien hypertexte se fait en appelant d'abord AddHyperlink sur le document pour ajouter ce lien à la collection d'hyperliens du document. Ensuite, ce lien hypertexte peut être ajouté à un paragraphe en appelant l'une ou l'autre des options suivantes InsertHyperlink ou AppendHyperlink sur le paragraphe.

// 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." );

Suppression des hyperliens

La suppression d'un lien hypertexte existant dans un paragraphe s'effectue en appelant Supprimer le lien hypertexte sur le paragraphe.

// Remove a hyperlink from a paragraph
var p3 = document.Paragraphs[ 3 ];
p3.RemoveHyperlink( 2 );

Récupération des hyperliens

La liste des hyperliens existants peut être récupérée en appelant Hyperliens sur Document ou Paragraphe.

// 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;