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.

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.

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:

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:

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:

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"

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: