کار با واترمارک

این مبحث نحوه کار برنامه‌نویسی با واترمارک با استفاده از Aspose.Words را مورد بحث قرار می‌دهد. واترمارک یک تصویر پس زمینه است که در پشت متن یک سند نمایش داده می شود. یک واترمارک می تواند حاوی متن یا تصویری باشد که توسط کلاس Watermark نمایش داده می شود.

آنلاین امتحان کنید

می توانید این عملکرد را با واترمارک سند آنلاین رایگان ما امتحان کنید.

یک واترمارک به یک سند اضافه کنید

در Microsoft Word، با استفاده از دستور Insert Watermark به راحتی می توان یک واترمارک را در یک سند درج کرد. Aspose.Words کلاس watermark را برای افزودن یا حذف واترمارک در اسناد فراهم می کند. Aspose.Words شماره نوع واترمارک را ارائه می دهد که سه نوع واترمارک ممکن (متن، تصویر و هیچکدام) را برای کار با آنها تعریف می کند

اضافه کردن واترمارک متن

مثال کد زیر نحوه درج واترمارک متنی را با تعریف TextWatermarkOptions با استفاده از روش SetText نشان می دهد:

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

اضافه کردن واترمارک تصویر

مثال کد زیر نحوه درج واترمارک تصویر را با تعریف ImageWatermarkOptions با استفاده از روش SetImage نشان می دهد:

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

واترمارک را می توان با استفاده از کلاس شکل نیز درج کرد. بسیار آسان است که هر شکل یا تصویری را در هدر یا پاورقی درج کنید و بنابراین یک واترمارک از هر نوع قابل تصوری ایجاد کنید.

مثال کد زیر یک واترمارک را در یک سند Word وارد می کند:

// 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));
}

فایل نمونه این نمونه را می توانید از Aspose.Words GitHub دانلود کنید.

حذف واترمارک از یک سند

کلاس Watermark روش حذف را برای حذف واترمارک از یک سند ارائه می دهد.

مثال کد زیر نحوه حذف واترمارک از اسناد را نشان می دهد:

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

اگر واترمارک ها با استفاده از شی کلاس Shape اضافه می شوند، برای حذف واترمارک از یک سند باید فقط نام شکل واترمارک را در حین درج تنظیم کنید و سپس شکل واترمارک را با نام اختصاص داده شده حذف کنید.

مثال کد زیر به شما نشان می دهد که چگونه نام شکل واترمارک را تنظیم کرده و آن را از سند حذف کنید:

// 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();
            }
        }
    }
}
    }

یک واترمارک به سلول جدول اضافه کنید

گاهی اوقات لازم است یک واترمارک/تصویر را در سلول جدول وارد کنید و آن را در خارج از جدول نمایش دهید، می توانید از ویژگی IsLayoutInCell استفاده کنید. این ویژگی پرچمی را دریافت یا تنظیم می کند که نشان می دهد شکل در داخل جدول یا خارج از آن نمایش داده می شود. توجه داشته باشید که این ویژگی فقط زمانی کار می کند که سند را برای Microsoft Word 2010 با استفاده از روش OptimizeFor بهینه کنید.

مثال کد زیر نحوه استفاده از این ویژگی را نشان می دهد:

// 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);