InsertHyperlink

Inserta un hipervínculo en el documento.

public Field InsertHyperlink(string displayText, string urlOrBookmark, bool isBookmark)
ParámetroEscribeDescripción
displayTextStringTexto del enlace que se mostrará en el documento.
urlOrBookmarkStringDestino del enlace. Puede ser una URL o el nombre de un marcador dentro del documento. Este método siempre agrega apóstrofos al principio y al final de la URL.
isBookmarkBooleanverdadero si el parámetro anterior es el nombre de un marcador dentro del documento; FALSO es el parámetro anterior es una URL.

Valor_devuelto

AField objeto que representa el campo insertado.

Observaciones

Tenga en cuenta que debe especificar el formato de fuente para el texto mostrado del hipervínculo explícitamente usando elFont propiedad.

Este método llama internamenteInsertField para insertar un HIPERVÍNCULO de MS Word field en el documento.

Ejemplos

Muestra cómo insertar un hipervínculo que haga referencia a un marcador 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.");

// Inserta un campo HIPERVÍNCULO que enlace al marcador. Podemos pasar interruptores de campo.
// al método "InsertHyperlink" como parte del argumento que contiene el nombre del marcador al que se hace referencia.
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");

Muestra cómo insertar un campo de hipervínculo.

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

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

// Inserta un hipervínculo y enfatízalo con un formato personalizado.
// El hipervínculo será un fragmento de texto en el que se puede hacer clic y que nos llevará a la ubicación especificada en la URL.
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;
builder.InsertHyperlink("Google website", "https://www.google.com", falso);
builder.Font.ClearFormatting();
builder.Writeln(".");

// Ctrl + clic izquierdo en el enlace del texto en Microsoft Word nos llevará a la URL a través de una nueva ventana del navegador web.
doc.Save(ArtifactsDir + "DocumentBuilder.InsertHyperlink.docx");

Muestra cómo utilizar la pila de formato del generador de documentos.

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

// Configure el formato de fuente y luego escriba el texto que va antes del hipervínculo.
builder.Font.Name = "Arial";
builder.Font.Size = 24;
builder.Write("To visit Google, hold Ctrl and click ");

// Preserva nuestra configuración de formato actual en la pila.
builder.PushFont();

// Modificar el formato actual del constructor aplicando un nuevo estilo.
builder.Font.StyleIdentifier = StyleIdentifier.Hyperlink;
builder.InsertHyperlink("here", "http://www.google.com", falso);

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

// Restaura el formato de fuente que guardamos anteriormente y elimina el elemento de la pila.
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");

Ver también

DocumentBuilder.InsertHtml DocumentBuilder.InsertImage