InsertHyperlink

Infogar en hyperlänk i dokumentet.

public Field InsertHyperlink(string displayText, string urlOrBookmark, bool isBookmark)
ParameterTypBeskrivning
displayTextStringText till länken som ska visas i dokumentet.
urlOrBookmarkStringLänkdestination. Kan vara en webbadress eller ett namn på ett bokmärke inuti dokumentet. Denna metod lägger alltid till apostrof i början och slutet av webbadressen.
isBookmarkBooleanSann om den föregående parametern är ett namn på ett bokmärke i dokumentet; falsk är den föregående parametern är en URL.

Returvärde

AField 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 fast egendom.

Denna metod anropar interntInsertField för att infoga ett MS Word HYPERLINK-fält i dokumentet.

Exempel

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 HYPERLÄNK-fält som länkar till bokmärket. Vi kan passera 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;
builder.InsertHyperlink("Link to Bookmark1", @"Bookmark1"" \o ""Hyperlink Tip", true);

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

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äva den med anpassad formatering.
// Hyperlänken kommer att vara ett klickbart stycke text 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", false);
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 du använder en dokumentbyggares formateringsstack.

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

// Ställ in teckensnittsformatering och skriv sedan texten som går 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 i stacken.
builder.PushFont();

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

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