Existing objects in Word document

Watermarks in Word documents are usually represented by shapes. Using GroupDocs.Watermark API you can easily remove shape of any type from any level of document structure.

Removing watermark from a particular section

Removing watermark from a particular section of a Word document using GroupDocs.Watermark consists of following steps.

  1. Load the document 
  2. Create and initialize image or text search criteria  
  3. Find possible watermarks
  4. Remove found watermarks 
  5. Save the document

Following code sample shows how to remove watermark from a particular section.

advanced_usage.add_watermarks_to_word_processing.WordProcessingRemoveWatermarkFromSection

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                                              
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"                           
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                                     
                                                                                                                                      
// Initialize search criteria                                                                                                         
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");                                          
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");                                                       
                                                                                                                                      
// Call Search method for the section                                                                                                 
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                                  
PossibleWatermarkCollection possibleWatermarks = content.getSections().get_Item(0).search(textSearchCriteria.or(imageSearchCriteria));
                                                                                                                                      
// Remove all found watermarks                                                                                                        
for (int i = possibleWatermarks.getCount() - 1; i >= 0; i--)                                                                          
{                                                                                                                                     
    possibleWatermarks.removeAt(i);                                                                                                   
}                                                                                                                                     
                                                                                                                                      
watermarker.save("document.docx");                                                                                          
                                                                                                                                      
watermarker.close();                                                                                                                  

You can also call search() method for a particular header or footer as shown in the below code sample.

advanced_usage.add_watermarks_to_word_processing.WordProcessingFindWatermarkInHeaderFooter

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
// Initialize search criteria                                                                              
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");               
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");                            
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
PossibleWatermarkCollection possibleWatermarks = content                                                   
        .getSections().get_Item(0)                                                                         
        .getHeadersFooters().getByOfficeHeaderFooterType(OfficeHeaderFooterType.HeaderPrimary)             
        .search(textSearchCriteria.or(imageSearchCriteria));                                               
                                                                                                           
// Remove all found watermarks                                                                             
for (int i = possibleWatermarks.getCount() - 1; i >= 0; i--)                                               
{                                                                                                          
    possibleWatermarks.removeAt(i);                                                                        
}                                                                                                          
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       

Extracting information about all shapes in a Word document

search() method returns a collection of PossibleWatermark instances for all document types. But in some cases, it’s necessary to get more information about Word shapes than common API offers. GroupDocs.Watermark enables you to extract the information about all the shapes as shown in the below code sample.

advanced_usage.add_watermarks_to_word_processing.WordProcessingGetShapesInformation

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
for (WordProcessingSection section : content.getSections())                                                
{                                                                                                          
    for (WordProcessingShape shape : section.getShapes())                                                  
    {                                                                                                      
        if (shape.getHeaderFooter() != null)                                                               
        {                                                                                                  
            System.out.println("In header/footer");                                                        
        }                                                                                                  
                                                                                                           
        System.out.println(shape.getShapeType());                                                          
        System.out.println(shape.getWidth());                                                              
        System.out.println(shape.getHeight());                                                             
        System.out.println(shape.isWordArt());                                                             
        System.out.println(shape.getRotateAngle());                                                        
        System.out.println(shape.getAlternativeText());                                                    
        System.out.println(shape.getName());                                                               
        System.out.println(shape.getX());                                                                  
        System.out.println(shape.getY());                                                                  
        System.out.println(shape.getText());                                                               
        if (shape.getImage() != null)                                                                      
        {                                                                                                  
            System.out.println(shape.getImage().getWidth());                                               
            System.out.println(shape.getImage().getHeight());                                              
            System.out.println(shape.getImage().getBytes().length);                                        
        }                                                                                                  
                                                                                                           
        System.out.println(shape.getHorizontalAlignment());                                                
        System.out.println(shape.getVerticalAlignment());                                                  
        System.out.println(shape.getRelativeHorizontalPosition());                                         
        System.out.println(shape.getRelativeVerticalPosition());                                           
    }                                                                                                      
}                                                                                                          
                                                                                                           
watermarker.close();                                                                                       

Working with shape types

You can extract information about the existing shapes of particular types. The WordProcessingShapeType enum is available to check the types possibly available shapes.

The following code snippet demonstrates the usage of WordProcessingShapeType enum.

advanced_usage.add_watermarks_to_word_processing.WordProcessingShapeTypeUsage

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                                                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"                                                
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                                                          
                                                                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                                                       
for (WordProcessingSection section : content.getSections())                                                                                                
{                                                                                                                                                          
    for (WordProcessingShape shape : section.getShapes())                                                                                                  
    {                                                                                                                                                      
        //Check for Diagonal Corners Rounded shapes                                                                                                        
        if (shape.getShapeType() == WordProcessingShapeType.DiagonalCornersRounded)                                                                        
        {                                                                                                                                                  
            System.out.println("Diagonal Corners Rounded shape found");                                                                                    
                                                                                                                                                           
            //Write text on all Diagonal Corners Rounded shapes                                                                                            
            shape.getFormattedTextFragments().add("I am Diagonal Corner Rounded", new Font("Calibri", 8, FontStyle.Bold), Color.getRed(), Color.getAqua());
        }                                                                                                                                                  
    }                                                                                                                                                      
}                                                                                                                                                          
                                                                                                                                                           
watermarker.save("document.docx");                                                                                                               
                                                                                                                                                           
watermarker.close();                                                                                                                                       

Removing a particular shape

You can also remove a particular shape from a Word document as shown in the below code sample.

advanced_usage.add_watermarks_to_word_processing.WordProcessingRemoveShape

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                        
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"     
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                               
                                                                                                                
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                            
                                                                                                                
// Remove shape by index                                                                                        
content.getSections().get_Item(0).getShapes().removeAt(0);                                                      
                                                                                                                
// Remove shape by reference                                                                                    
content.getSections().get_Item(0).getShapes().remove(content.getSections().get_Item(0).getShapes().get_Item(0));
                                                                                                                
watermarker.save("document.docx");                                                                    
                                                                                                                
watermarker.close();                                                                                            

Removing shapes with particular text formatting

You can also find and remove the shapes with a particular text formatting from a Word document as shown in the below code sample.

advanced_usage.add_watermarks_to_word_processing.WordProcessingRemoveShapesWithParticularTextFormatting

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                              
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"           
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                     
                                                                                                                      
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                  
for (WordProcessingSection section : content.getSections())                                                           
{                                                                                                                     
    for (int i = section.getShapes().getCount() - 1; i >= 0; i--)                                                     
    {                                                                                                                 
        for (FormattedTextFragment fragment : section.getShapes().get_Item(i).getFormattedTextFragments())            
        {                                                                                                             
            if (fragment.getForegroundColor().equals(Color.getRed()) && fragment.getFont().getFamilyName() == "Arial")
            {                                                                                                         
                section.getShapes().removeAt(i);                                                                      
                break;                                                                                                
            }                                                                                                         
        }                                                                                                             
    }                                                                                                                 
}                                                                                                                     
                                                                                                                      
watermarker.save("document.docx");                                                                          
                                                                                                                      
watermarker.close();                                                                                                  

Using GroupDocs.Watermark for Java, you can also remove or replace hyperlink associated with a particular shape inside a Word document. Use following code sample to achieve this functionality.

advanced_usage.add_watermarks_to_word_processing.WordProcessingRemoveHyperlinks

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
// Replace hyperlink                                                                                       
content.getSections().get_Item(0).getShapes().get_Item(0).setHyperlink("https://www.groupdocs.com/");      
                                                                                                           
// Remove hyperlink                                                                                        
content.getSections().get_Item(0).getShapes().get_Item(1).setHyperlink(null);                              
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       

Replacing text for particular shapes

Replacing shape’s text

GroupDocs.Watermark supports replacing text for particular shapes in a Word document. Following code sample shows the usage of this feature.

advanced_usage.add_watermarks_to_word_processing.WordProcessingReplaceTextForParticularShape

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
// Set shape's text                                                                                        
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                            
{                                                                                                          
    if (shape.getText().contains("Some text"))                                                             
    {                                                                                                      
        shape.setText("Another text");                                                                     
    }                                                                                                      
}                                                                                                          
                                                                                                           
// Save document                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       

Replacing shape’s text with formatted text

You can also replace the text of the shapes with formatted text as shown in the following code sample.

advanced_usage.add_watermarks_to_word_processing.WordProcessingReplaceShapeTextWithFormattedText

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                                                
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"                             
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                                       
                                                                                                                                        
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                                    
                                                                                                                                        
// Set shape's text                                                                                                                     
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                                                         
{                                                                                                                                       
    if (shape.getText().contains("Some text"))                                                                                          
    {                                                                                                                                   
        shape.getFormattedTextFragments().clear();                                                                                      
        shape.getFormattedTextFragments().add("Another text", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                                   
}                                                                                                                                       
                                                                                                                                        
// Save document                                                                                                                        
watermarker.save("document.docx");                                                                                            
                                                                                                                                        
watermarker.close();                                                                                                                    

Replacing shape’s image

GroupDocs.Watermark also allows you to replace the image of the particular shapes in a Word document as shown in the following code sample.

advanced_usage.add_watermarks_to_word_processing.WordProcessingReplaceShapeImage

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
File imageFile = new File("test.png");                                                              
byte[] imageBytes = new byte[(int) imageFile.length()];                                                    
InputStream imageInputStream = new FileInputStream(imageFile);                                             
imageInputStream.read(imageBytes);                                                                         
imageInputStream.close();                                                                                  
                                                                                                           
// Set shape image                                                                                         
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                            
{                                                                                                          
    if (shape.getImage() != null)                                                                          
    {                                                                                                      
        shape.setImage(new WordProcessingWatermarkableImage(imageBytes));                                  
    }                                                                                                      
}                                                                                                          
                                                                                                           
// Save document                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       

Modifying shape properties

GroupDocs.Watermark also provides the feature of modifying properties (setAlternativeText(), setRotateAngle(), setX(), setY(), setHeight(), setWidth() or setBehindText()) of particular shapes in a Word document. Following code sample shows how to use this feature.

advanced_usage.add_watermarks_to_word_processing.WordProcessingModifyShapeProperties

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
// Change shape properties                                                                                 
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                            
{                                                                                                          
    if (shape.getText().contains("Some text"))                                                             
    {                                                                                                      
        shape.setAlternativeText("watermark");                                                             
        shape.setRotateAngle(30);                                                                          
        shape.setX(200);                                                                                   
        shape.setY(200);                                                                                   
        shape.setHeight(100);                                                                              
        shape.setWidth(400);                                                                               
        shape.setBehindText(false);                                                                        
    }                                                                                                      
}                                                                                                          
                                                                                                           
// Save document                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();