Arbeiten mit Wasserzeichen

In diesem Thema wird erläutert, wie Sie mithilfe von Aspose.Words programmgesteuert mit Wasserzeichen arbeiten. Ein Wasserzeichen ist ein Hintergrundbild, das hinter dem Text in einem Dokument angezeigt wird. Ein Wasserzeichen kann einen Text oder ein Bild enthalten, das durch die Watermark-Klasse dargestellt wird.

Versuchen Sie es online

Sie können diese Funktionalität mit unserem Kostenloses Wasserzeichen für Online Dokumente ausprobieren.

Fügen Sie einem Dokument ein Wasserzeichen hinzu

In Microsoft Word kann mit dem Befehl “Wasserzeichen einfügen” ganz einfach ein Wasserzeichen in ein Dokument eingefügt werden. Aspose.Words stellt die watermark-Klasse zum Hinzufügen oder Entfernen von Wasserzeichen in Dokumenten bereit. Aspose.Words stellt die Wasserzeichentyp-Aufzählung bereit, die drei mögliche Arten von Wasserzeichen (Text, Bild und Keine) definiert, mit denen gearbeitet werden kann

Textwasserzeichen hinzufügen

Das folgende Codebeispiel zeigt, wie Sie ein Textwasserzeichen in ein Dokument einfügen, indem Sie TextWatermarkOptions mithilfe der SetText-Methode definieren:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(dataDir + "Document.doc");

TextWatermarkOptions options = new TextWatermarkOptions()
{
    FontFamily = "Arial",
    FontSize = 36,
    Color = Color.Black,
    Layout = WatermarkLayout.Horizontal,
    IsSemitrasparent = false
};

doc.Watermark.SetText("Test", options);

doc.Save(dataDir + "AddTextWatermark_out.docx");

Bildwasserzeichen hinzufügen

Das folgende Codebeispiel zeigt, wie Sie ein Bildwasserzeichen in ein Dokument einfügen, indem Sie ImageWatermarkOptions mithilfe der SetImage-Methode definieren:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(dataDir + "Document.doc");

ImageWatermarkOptions options = new ImageWatermarkOptions()
{
    Scale = 5,
    IsWashout = false
};

doc.Watermark.SetImage(Image.FromFile(dataDir + "Watermark.png"), options);

doc.Save(dataDir + "AddImageWatermark_out.docx");

Das Wasserzeichen kann auch mithilfe der Formklasse eingefügt werden. Es ist sehr einfach, beliebige Formen oder Bilder in eine Kopf- oder Fußzeile einzufügen und so ein Wasserzeichen jeder erdenklichen Art zu erstellen.

Das folgende Codebeispiel fügt ein Wasserzeichen in ein Word-Dokument ein:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
[Test]
public void AddWatermark()
{
    Document doc = new Document(MyDir + "Document.docx");

    InsertWatermarkText(doc, "CONFIDENTIAL");
    doc.Save(ArtifactsDir + "WorkWithWatermark.AddWatermark.docx");
}

/// <summary>
/// Inserts a watermark into a document.
/// </summary>
/// <param name="doc">The input document.</param>
/// <param name="watermarkText">Text of the watermark.</param>
private void InsertWatermarkText(Document doc, string watermarkText)
{
    // Create a watermark shape, this will be a WordArt shape.
    Shape watermark = new Shape(doc, ShapeType.TextPlainText) { Name = "Watermark" };

    watermark.TextPath.Text = watermarkText;
    watermark.TextPath.FontFamily = "Arial";
    watermark.Width = 500;
    watermark.Height = 100;

    // Text will be directed from the bottom-left to the top-right corner.
    watermark.Rotation = -40;

    // Remove the following two lines if you need a solid black text.
    watermark.FillColor = Color.Gray; 
    watermark.StrokeColor = Color.Gray;

    // Place the watermark in the page center.
    watermark.RelativeHorizontalPosition = RelativeHorizontalPosition.Page;
    watermark.RelativeVerticalPosition = RelativeVerticalPosition.Page;
    watermark.WrapType = WrapType.None;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.HorizontalAlignment = HorizontalAlignment.Center;

    // Create a new paragraph and append the watermark to this paragraph.
    Paragraph watermarkPara = new Paragraph(doc);
    watermarkPara.AppendChild(watermark);

    // Insert the watermark into all headers of each document section.
    foreach (Section sect in doc.Sections)
    {
        // There could be up to three different headers in each section.
        // Since we want the watermark to appear on all pages, insert it into all headers.
        InsertWatermarkIntoHeader(watermarkPara, sect, HeaderFooterType.HeaderPrimary);
        InsertWatermarkIntoHeader(watermarkPara, sect, HeaderFooterType.HeaderFirst);
        InsertWatermarkIntoHeader(watermarkPara, sect, HeaderFooterType.HeaderEven);
    }
}

private void InsertWatermarkIntoHeader(Paragraph watermarkPara, Section sect,
    HeaderFooterType headerType)
{
    HeaderFooter header = sect.HeadersFooters[headerType];

    if (header == null)
    {
        // There is no header of the specified type in the current section, so we need to create it.
        header = new HeaderFooter(sect.Document, headerType);
        sect.HeadersFooters.Add(header);
    }

    // Insert a clone of the watermark into the header.
    header.AppendChild(watermarkPara.Clone(true));
}

Sie können die Beispieldatei dieses Beispiels von Aspose.Words GitHub herunterladen.

Wasserzeichen aus einem Dokument entfernen

Die Watermark-Klasse stellt die Methode “remove” bereit, um das Wasserzeichen aus einem Dokument zu entfernen.

Das folgende Codebeispiel zeigt, wie Sie ein Wasserzeichen aus Dokumenten entfernen:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(dataDir + "AddTextWatermark_out.docx");

if (doc.Watermark.Type == WatermarkType.Text)
{
    doc.Watermark.Remove();
}

doc.Save(dataDir + "RemoveWatermark_out.docx");

Wenn die Wasserzeichen mithilfe des Shape-Klassenobjekts hinzugefügt werden, müssen Sie zum Entfernen des Wasserzeichens aus einem Dokument beim Einfügen nur den Namen der Wasserzeichenform festlegen und dann die Wasserzeichenform über einen zugewiesenen Namen entfernen.

Das folgende Codebeispiel zeigt Ihnen, wie Sie den Namen der Wasserzeichenform festlegen und diese aus dem Dokument entfernen:

// Set name to be able to remove it afterwards
watermark.Name("WaterMark");

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
public static void Run()
{          
    // The path to the documents directory.
    string dataDir = RunExamples.GetDataDir_WorkingWithImages();
    string fileName = "RemoveWatermark.docx";
    Document doc = new Document(dataDir + fileName);
    RemoveWatermarkText(doc);
    dataDir = dataDir + RunExamples.GetOutputFilePath(fileName);
    doc.Save(dataDir);
}

private static void RemoveWatermarkText(Document doc)
{
    foreach (HeaderFooter hf in doc.GetChildNodes(NodeType.HeaderFooter, true))
    {
        foreach (Shape shape in hf.GetChildNodes(NodeType.Shape, true))
        {
            if (shape.Name.Contains("WaterMark"))
            {
                shape.Remove();
            }
        }
    }
}
    }

Fügen Sie einer Tabellenzelle ein Wasserzeichen hinzu

Manchmal müssen Sie ein Wasserzeichen/Bild in die Zelle einer Tabelle einfügen und es außerhalb der Tabelle anzeigen. Dazu können Sie die IsLayoutInCell-Eigenschaft verwenden. Diese Eigenschaft ruft ein Flag ab oder legt es fest, das angibt, ob die Form innerhalb oder außerhalb einer Tabelle angezeigt wird. Beachten Sie, dass diese Eigenschaft nur funktioniert, wenn Sie das Dokument für Microsoft Word 2010 mithilfe der OptimizeFor-Methode optimieren.

Das folgende Codebeispiel zeigt, wie diese Eigenschaft verwendet wird:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(dataDir + @"LayoutInCell.docx");
DocumentBuilder builder = new DocumentBuilder(doc);

Shape watermark = new Shape(doc, ShapeType.TextPlainText);
watermark.RelativeHorizontalPosition = RelativeHorizontalPosition.Page;
watermark.RelativeVerticalPosition = RelativeVerticalPosition.Page;
watermark.IsLayoutInCell = true; // Display the shape outside of table cell if it will be placed into a cell.

watermark.Width = 300;
watermark.Height = 70;
watermark.HorizontalAlignment = HorizontalAlignment.Center;
watermark.VerticalAlignment = VerticalAlignment.Center;

watermark.Rotation = -40;
watermark.Fill.Color = Color.Gray;
watermark.StrokeColor = Color.Gray;

watermark.TextPath.Text = "watermarkText";
watermark.TextPath.FontFamily = "Arial";

watermark.Name = string.Format("WaterMark_{0}", Guid.NewGuid());
watermark.WrapType = WrapType.None;

Run run = doc.GetChildNodes(NodeType.Run, true)[doc.GetChildNodes(NodeType.Run, true).Count - 1] as Run;

builder.MoveTo(run);
builder.InsertNode(watermark);
doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2010);

dataDir = dataDir + "Shape_IsLayoutInCell_out.docx";

// Save the document to disk.
doc.Save(dataDir);