InsertHyperlink

Infogar en hyperlänk i dokumentet.

public Field InsertHyperlink(string displayText, string urlOrBookmark, bool isBookmark)
ParameterTypBeskrivning
displayTextStringTexten till länken som ska visas i dokumentet.
urlOrBookmarkStringLänkdestination. Kan vara en URL eller namnet på ett bokmärke i dokumentet. Den här metoden lägger alltid till apostrofer i början och slutet av URL:en.
isBookmarkBooleansann om föregående parameter är namnet på ett bokmärke i dokumentet; falsk är den föregående parametern är en URL.

Returvärde

EnField objekt som representerar det infogade fältet.

Anmärkningar

Observera att du måste ange teckensnittsformatering för hyperlänkens visningstext explicit med hjälp avFont egendom.

Denna metod anropar interntInsertFieldför att infoga ett MS Word HYPERLINK field i dokumentet.

Exempel

Visar hur man infogar ett hyperlänkfält.

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

builder.Write("For more information, please visit the ");

// Infoga en hyperlänk och framhäv den med anpassad formatering.
// Hyperlänken kommer att vara en klickbar textbit som tar oss till den plats som anges i URL:en.
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;
builder.InsertHyperlink("Google website", "https://www.google.com", falskt);
builder.Font.ClearFormatting();
builder.Writeln(".");

// Ctrl + vänsterklicka på länken i texten i Microsoft Word tar oss till URL:en via ett nytt webbläsarfönster.
doc.Save(ArtifactsDir + "DocumentBuilder.InsertHyperlink.docx");

Visar hur man infogar en hyperlänk som refererar till ett lokalt bokmärke.

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

// Infoga ett HYPERLINK-fält som länkar till bokmärket. Vi kan skicka fältväxlar
// till metoden "InsertHyperlink" som en del av argumentet som innehåller det refererade bokmärkets namn.
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");

Visar hur man använder formateringsstack för ett dokumentverktyg.

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

// Ställ in teckensnittsformatering och skriv sedan texten som kommer före hyperlänken.
builder.Font.Name = "Arial";
builder.Font.Size = 24;
builder.Write("To visit Google, hold Ctrl and click ");

// Bevara vår nuvarande formateringskonfiguration på stacken.
builder.PushFont();

// Ändra verktygets nuvarande formatering genom att använda en ny stil.
builder.Font.StyleIdentifier = StyleIdentifier.Hyperlink;
builder.InsertHyperlink("here", "http://www.google.com", falskt);

Assert.AreEqual(Color.Blue.ToArgb(), builder.Font.Color.ToArgb());
Assert.AreEqual(Underline.Single, builder.Font.Underline);

// Återställ teckensnittsformateringen som vi sparade tidigare och ta bort elementet från stacken.
builder.PopFont();

Assert.AreEqual(Color.Empty.ToArgb(), builder.Font.Color.ToArgb());
Assert.AreEqual(Underline.None, builder.Font.Underline);

builder.Write(". We hope you enjoyed the example.");

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

Se även

DocumentBuilder.InsertHtml DocumentBuilder.InsertImage