Praca ze znakiem wodnym

W tym temacie omówiono sposób programowej pracy ze znakiem wodnym przy użyciu formatu Aspose.Words. Znak wodny to obraz tła wyświetlany za tekstem w dokumencie. Znak wodny może zawierać tekst lub obraz reprezentowany przez klasę Watermark.

Spróbuj online

Możesz wypróbować tę funkcjonalność w naszym Bezpłatny znak wodny dokumentu online.

Jak dodać znak wodny do dokumentu

W Microsoft Word znak wodny można łatwo wstawić do dokumentu za pomocą polecenia Wstaw znak wodny. Aspose.Words udostępnia klasę Watermark do dodawania lub usuwania znaku wodnego w dokumentach. Aspose.Words udostępnia wyliczenie WatermarkType definiujące trzy możliwe typy znaków wodnych (TEXT, IMAGE i NONE), z którymi można pracować

Dodaj tekstowy znak wodny

Poniższy przykład kodu demonstruje, jak wstawić tekstowy znak wodny do dokumentu, definiując TextWatermarkOptions przy użyciu metody set_text.

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Document.docx")

options = aw.TextWatermarkOptions()
    
options.font_family = "Arial"
options.font_size = 36
options.color = drawing.Color.black
options.layout = aw.WatermarkLayout.HORIZONTAL
options.is_semitrasparent = False
    

doc.watermark.set_text("Test", options)

doc.save(docs_base.artifacts_dir + "WorkWithWatermark.add_text_watermark_with_specific_options.docx")

Dodaj znak wodny obrazu

Poniższy przykład kodu demonstruje, jak wstawić obrazowy znak wodny do dokumentu, definiując ImageWatermarkOptions przy użyciu metody set_image:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Document.docx")

options = aw.ImageWatermarkOptions()
    
options.scale = 5
options.is_washout = False
    

doc.watermark.set_image(docs_base.images_dir + "Transparent background logo.png", options)

doc.save(docs_base.artifacts_dir + "WorkWithWatermark.add_image_watermark.docx")

Znak wodny można również wstawić za pomocą klasy kształtu. Bardzo łatwo jest wstawić dowolny kształt lub obraz do nagłówka lub stopki i w ten sposób utworzyć znak wodny dowolnego możliwego typu.

Poniższy przykład kodu wstawia znak wodny do dokumentu programu Word:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
def test_add_and_remove_watermark(self) :
    
    doc = aw.Document(docs_base.my_dir + "Document.docx")

    self.insert_watermark_text(doc, "CONFIDENTIAL")
    doc.save(docs_base.artifacts_dir + "TestFile.watermark.docx")

    self.remove_watermark_text(doc)
    doc.save(docs_base.artifacts_dir + "WorkWithWatermark.remove_watermark.docx")
    

# <summary>
# Inserts a watermark into a document.
# </summary>
# <param name="doc">The input document.</param>
# <param name="watermarkText">Text of the watermark.</param>
def insert_watermark_text(self, doc : aw.Document, watermarkText : str) :
    
    # Create a watermark shape, this will be a WordArt shape.
    watermark = aw.drawing.Shape(doc, aw.drawing.ShapeType.TEXT_PLAIN_TEXT)
    watermark.name = "Watermark" 

    watermark.text_path.text = watermarkText
    watermark.text_path.font_family = "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.fill_color = drawing.Color.gray 
    watermark.stroke_color = drawing.Color.gray

    # Place the watermark in the page center.
    watermark.relative_horizontal_position = aw.drawing.RelativeHorizontalPosition.PAGE
    watermark.relative_vertical_position = aw.drawing.RelativeVerticalPosition.PAGE
    watermark.wrap_type = aw.drawing.WrapType.NONE
    watermark.vertical_alignment = aw.drawing.VerticalAlignment.CENTER
    watermark.horizontal_alignment = aw.drawing.HorizontalAlignment.CENTER

    # Create a new paragraph and append the watermark to this paragraph.
    watermarkPara = aw.Paragraph(doc)
    watermarkPara.append_child(watermark)

    # Insert the watermark into all headers of each document section.
    for sect in doc.sections :
        sect = sect.as_section()
        # 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.
        self.insert_watermark_into_header(watermarkPara, sect, aw.HeaderFooterType.HEADER_PRIMARY)
        self.insert_watermark_into_header(watermarkPara, sect, aw.HeaderFooterType.HEADER_FIRST)
        self.insert_watermark_into_header(watermarkPara, sect, aw.HeaderFooterType.HEADER_EVEN)
        
    

def insert_watermark_into_header(self, watermarkPara : aw.Paragraph, sect : aw.Section, headerType : aw.HeaderFooterType) :
    
    header = sect.headers_footers.get_by_header_footer_type(headerType)

    if (header == None) :
        
        # There is no header of the specified type in the current section, so we need to create it.
        header = aw.HeaderFooter(sect.document, headerType)
        sect.headers_footers.add(header)
        

    # Insert a clone of the watermark into the header.
    header.append_child(watermarkPara.clone(True))
    

Możesz pobrać plik szablonu tego przykładu z Tutaj

Usuń znak wodny z dokumentu

Klasa Watermark udostępnia metodę usuwania służącą do usuwania znaku wodnego z dokumentu.

Poniższy przykład kodu pokazuje, jak usunąć znak wodny z dokumentów:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document()

# Add a plain text watermark.
doc.watermark.set_text("Aspose Watermark")

# If we wish to edit the text formatting using it as a watermark,
# we can do so by passing a TextWatermarkOptions object when creating the watermark.
textWatermarkOptions = aw.TextWatermarkOptions()
textWatermarkOptions.font_family = "Arial"
textWatermarkOptions.font_size = 36
textWatermarkOptions.color = drawing.Color.black
textWatermarkOptions.layout = aw.WatermarkLayout.DIAGONAL
textWatermarkOptions.is_semitrasparent = False

doc.watermark.set_text("Aspose Watermark", textWatermarkOptions)

doc.save(docs_base.artifacts_dir + "Document.text_watermark.docx")

# We can remove a watermark from a document like this.
if (doc.watermark.type == aw.WatermarkType.TEXT) :
    doc.watermark.remove()

doc.save(docs_base.artifacts_dir + "WorkWithWatermark.remove_watermark_from_document.docx")

Jeżeli znaki wodne dodawane są przy pomocy obiektu klasy Shape to aby usunąć znak wodny z dokumentu należy podczas wstawiania ustawić jedynie nazwę kształtu znaku wodnego i następnie usunąć kształt znaku wodnego o przypisaną nazwę.

Poniższy przykład kodu pokazuje, jak ustawić nazwę kształtu znaku wodnego i usunąć go z dokumentu:

# 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-Python-via-.NET
def remove_watermark_text(self, doc : aw.Document) :
    
    for hf in doc.get_child_nodes(aw.NodeType.HEADER_FOOTER, True) :
        hf = hf.as_header_footer()

        for shape in hf.get_child_nodes(aw.NodeType.SHAPE, True) :
            shape = shape.as_shape()

            if shape.name.find("WaterMark") >= 0 :
                shape.remove()
                
            

Dodaj znak wodny w komórce tabeli

Czasami trzeba wstawić znak wodny/obrazek do komórki tabeli i wyświetlić go poza tabelą, można użyć właściwości is_layout_in_cell. Ta właściwość pobiera lub ustawia flagę wskazującą, czy kształt jest wyświetlany wewnątrz tabeli, czy poza nią. Należy pamiętać, że ta właściwość działa tylko w przypadku optymalizacji dokumentu dla formatu Microsoft Word 2010 przy użyciu metody optimize_for.

Poniższy przykład kodu pokazuje, jak używać tej właściwości:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.start_table()
builder.row_format.height = 100
builder.row_format.height_rule = aw.HeightRule.EXACTLY

for i in range(0, 31) :
    
    if (i != 0 and i % 7 == 0) :
        builder.end_row()
    builder.insert_cell()
    builder.write("Cell contents")
    

builder.end_table()

watermark = aw.drawing.Shape(doc, aw.drawing.ShapeType.TEXT_PLAIN_TEXT)
    
watermark.relative_horizontal_position = aw.drawing.RelativeHorizontalPosition.PAGE
watermark.relative_vertical_position = aw.drawing.RelativeVerticalPosition.PAGE
watermark.is_layout_in_cell = True # Display the shape outside of the table cell if it will be placed into a cell.
watermark.width = 300
watermark.height = 70
watermark.horizontal_alignment = aw.drawing.HorizontalAlignment.CENTER
watermark.vertical_alignment = aw.drawing.VerticalAlignment.CENTER
watermark.rotation = -40
    

watermark.fill_color = drawing.Color.gray
watermark.stroke_color = drawing.Color.gray

watermark.text_path.text = "watermarkText"
watermark.text_path.font_family = "Arial"

watermark.name = "WaterMark_" + str(uuid.uuid4())
watermark.wrap_type = aw.drawing.WrapType.NONE

run = doc.get_child_nodes(aw.NodeType.RUN, True)[doc.get_child_nodes(aw.NodeType.RUN, True).count - 1].as_run()

builder.move_to(run)
builder.insert_node(watermark)
doc.compatibility_options.optimize_for(aw.settings.MsWordVersion.WORD2010)

doc.save(docs_base.artifacts_dir + "WorkingWithShapes.layout_in_cell.docx")