Filigran ile çalışma

Bu konuda Aspose.Words kullanarak filigranla programlı olarak nasıl çalışılacağı anlatılmaktadır. Filigran, belgedeki metnin arkasında görüntülenen bir arka plan görüntüsüdür. Filigran, Watermark sınıfı tarafından temsil edilen bir metin veya resim içerebilir.

Çevrimiçi deneyin

Bu işlevselliği bizim ile deneyebilirsiniz Ücretsiz çevrimiçi belge filigranı.

Belgeye Filigran Nasıl Eklenir

Microsoft Word ‘te Filigran Ekle komutunu kullanarak bir belgeye kolayca filigran eklenebilir. Aspose.Words belgelere filigran eklemek veya kaldırmak için Watermark sınıfını sağlar. Aspose.Words çalışmak için üç olası filigran türünü (TEXT, IMAGE ve NONE) tanımlayan WatermarkType numaralandırmasını sağlar.

Metin Filigranı Ekle

Aşağıdaki kod örneği, set_text yöntemini kullanarak TextWatermarkOptions tanımlayarak bir belgeye nasıl metin filigranı ekleneceğini gösterir:

# 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")

Resim Filigranı Ekle

Aşağıdaki kod örneği, set_image yöntemini kullanarak ImageWatermarkOptions tanımlayarak bir belgeye resim filigranının nasıl ekleneceğini gösterir:

# 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")

Görüntü filigranı görüntü, dize veya akış olarak eklenebilir.

Filigran, shape sınıfı kullanılarak da eklenebilir. Bir üstbilgi veya altbilgiye herhangi bir şekil veya görüntü eklemek ve böylece akla gelebilecek herhangi bir türde bir filigran oluşturmak çok kolaydır.

Aşağıdaki kod örneği Word belgesine filigran ekler:

# 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))
    

Bu örneğin şablon dosyasını şu adresten indirebilirsiniz: burada.

Bir Belgeden Filigranı Kaldırma

Watermark sınıfı, filigranı bir belgeden kaldırmak için kaldır yöntemini sağlar.

Aşağıdaki kod örneği, belgelerden filigranın nasıl kaldırılacağını gösterir:

# 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")

Filigranlar Shape sınıf nesnesi kullanılarak eklenirse, filigranı bir belgeden kaldırmak için ekleme sırasında yalnızca filigran şeklinin adını ayarlamanız ve ardından filigran şeklini atanmış bir adla kaldırmanız gerekir.

Aşağıdaki kod örneği, filigran şeklinin adını nasıl ayarlayacağınızı ve belgeden nasıl kaldıracağınızı gösterir:

# 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()
                
            

Tablo Hücresine Filigran Ekleme

Bazen bir tablonun hücresine filigran / resim eklemeniz ve tablonun dışında görüntülemeniz gerekir, is_layout_in_cell özelliğini kullanabilirsiniz. Bu özellik, şeklin bir tablonun içinde mi yoksa dışında mı görüntülendiğini gösteren bir bayrak alır veya ayarlar. Bu özelliğin yalnızca optimize_for yöntemini kullanarak belgeyi Microsoft Word 2010 için en iyileştirdiğinizde çalıştığını unutmayın.

Aşağıdaki kod örneği, bu özelliğin nasıl kullanılacağını gösterir:

# 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")