StartBookmark

DocumentBuilder.StartBookmark method

Marque la position actuelle dans le document comme début de signet.

public BookmarkStart StartBookmark(string bookmarkName)
ParamètreTaperLa description
bookmarkNameStringNom du signet.

Return_Value

Le nœud de démarrage du signet qui vient d’être créé.

Remarques

Les signets d’un document peuvent se chevaucher et s’étendre sur une plage quelconque. Pour créer un signet valide, vous devez appeler les deux méthodes.StartBookmark etEndBookmark avec le mêmebookmarkName Paramètre .

Les signets mal formés ou les signets avec des noms en double seront ignorés lors de l’enregistrement du document.

Exemples

Montre comment créer un signet.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Un signet valide doit avoir le corps du texte du document entouré de
// Nœuds BookmarkStart et BookmarkEnd créés avec un nom de signet correspondant.
builder.StartBookmark("MyBookmark");
builder.Writeln("Hello world!");
builder.EndBookmark("MyBookmark");

Assert.AreEqual(1, doc.Range.Bookmarks.Count);
Assert.AreEqual("MyBookmark", doc.Range.Bookmarks[0].Name);
Assert.AreEqual("Hello world!", doc.Range.Bookmarks[0].Text.Trim());

Montre comment insérer un lien hypertexte qui fait référence à un signet local.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartBookmark("Bookmark1");
builder.Write("Bookmarked text. ");
builder.EndBookmark("Bookmark1");
builder.Writeln("Text outside of the bookmark.");

// Insérer un champ HYPERLINK pointant vers le signet. Nous pouvons passer des commutateurs de champ.
// à la méthode « InsertHyperlink » dans le cadre de l'argument contenant le nom du signet référencé.
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;
FieldHyperlink hyperlink = (FieldHyperlink)builder.InsertHyperlink("Link to Bookmark1", "Bookmark1", true);
hyperlink.ScreenTip = "Hyperlink Tip";

doc.Save(ArtifactsDir + "DocumentBuilder.InsertHyperlinkToLocalBookmark.docx");

Voir également