Adicionar marca d'água à planilha do Excel em Java

Marcas d’água podem ser adicionadas aos documentos para proteger o documento da pirataria ou para mostrar qualquer símbolo ou mensagem. Em outras postagens, discutimos maneiras de marcar diferentes documentos, imagens e apresentações com marca d’água. Neste artigo, você aprenderá como adicionar marca d’água a pastas de trabalho do Excel de diferentes maneiras em Java. Estaremos aplicando marcas d’água separadamente usando cada abordagem.

Os seguintes tópicos são abordados abaixo:

API Java para planilhas Excel com marca d’água

GroupDocs.Watermark for Java é a API para automatizar as marcas d’água para documentos, apresentações, imagens e muitos outros formatos de arquivo. A lista completa de formatos de documentos suportados está disponível na documentação.

Você pode baixar o arquivo JAR da seção de downloads ou usar as configurações mais recentes de repositório e dependência Maven em seus aplicativos Java.

<repository>
	<id>GroupDocsJavaAPI</id>
	<name>GroupDocs Java API</name>
	<url>https://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-watermark</artifactId>
        <version>21.3</version> 
</dependency>

Folhas de Excel de marca d’água usando Java

A API de marca d’água oferece personalização ao inserir a marca d’água nas planilhas como texto. A seguir estão as etapas para adicionar marcas d’água a pastas de trabalho do Excel em Java.

  • Carregue a planilha de origem usando Watermarker e SpreadsheetLoadOptions.
  • Defina o texto da marca d’água e as propriedades de aparência usando TextWatermark.
  • Adicione a marca d’água definida à planilha do Excel usando add() mehtod.
  • Salve a planilha resultante com marca d’água usando o método save().

O exemplo de código Java a seguir adiciona a marca d’água de texto a todas as planilhas da pasta de trabalho do Excel com rotação e opacidade e o alinhamento definido.

/*
 * Adicionar marca d'água a todas as planilhas da pasta de trabalho do Excel em Java
 */
// Carregar a planilha
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// Definir a aparência da marca d'água do texto
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);
watermark.setRotateAngle(-45);
watermark.setSizingType(SizingType.ScaleToParentDimensions);
watermark.setScaleFactor(0.5);
watermark.setOpacity(0.5);

// Adicione marca d'água e salve a planilha com marca d'água
watermarker.add(watermark);
watermarker.save("path/watermark-all-spreadsheet.xlsx");
watermarker.close();

Folha de Excel específica para marca d’água usando Java

Da mesma forma, você também pode inserir marcas d’água em qualquer planilha da pasta de trabalho. As etapas a seguir orientam sobre como aplicar marca d’água de texto à planilha específica da pasta de trabalho do Excel em Java.

  • Carregue a planilha usando o Watermarker.
  • Defina a aparência e o texto da marca d’água usando TextWatermark.
  • Defina o índice da planilha para que a marca d’água seja aplicada apenas na planilha mencionada.
  • Adicione a marca d’água de texto à planilha do Excel usando add() mehtod com opções de marca d’água.
  • Salve a planilha de saída com a marca d’água usando o método save().

O trecho de código Java a seguir aplica a marca d’água de texto apenas à planilha mencionada da pasta de trabalho do Excel.

/*
 * Adicionar marca d'água apenas à planilha mencionada da pasta de trabalho do Excel usando Java
 */
// Carregar a planilha
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// Definir marca d'água de texto e seu índice de planilha
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
SpreadsheetWatermarkModernWordArtOptions options = new SpreadsheetWatermarkModernWordArtOptions();               
options.setWorksheetIndex(0);

// Adicione marca d'água e salve a planilha com marca d'água
watermarker.add(watermark, options);
watermarker.save("path/watermark-single-sheet.xlsx");
watermarker.close();

Folhas de Excel de marca d’água como plano de fundo usando Java

Da mesma forma, também podemos adicionar marcas d’água como plano de fundo da planilha. Haverá alguma modificação na abordagem acima para aplicar marcas d’água. A seguir estão as etapas que inserem marca d’água de texto de plano de fundo na planilha do Excel em Java.

  • Carregue a planilha usando Watermarker.
  • Prepare o texto da marca d’água e sua aparência usando TextWatermark.
  • Defina as configurações de marca d’água para torná-la como plano de fundo usando as opções de marca d’água obtendo conteúdo e definindo dimensões.
  • Adicione a marca d’água às planilhas da pasta de trabalho usando o método add().
  • Por último, salve a planilha com marca d’água usando o método save().

O exemplo de código a seguir pode ser usado para adicionar uma marca d’água de texto de plano de fundo a uma planilha do Excel em Java.

/*
 * Adicionar marca d'água como plano de fundo à pasta de trabalho do Excel em Java
 */
// Carregar a planilha
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// Definir a aparência da marca d'água do texto
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);
watermark.setRotateAngle(-45);
watermark.setSizingType(SizingType.ScaleToParentDimensions);
watermark.setScaleFactor(0.5);
watermark.setOpacity(0.5);

// Adicionar marca d'água ao plano de fundo
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
SpreadsheetBackgroundWatermarkOptions options = new SpreadsheetBackgroundWatermarkOptions();
options.setBackgroundWidth(content.getWorksheets().get_Item(0).getContentAreaWidthPx()); /* set background width */
options.setBackgroundHeight(content.getWorksheets().get_Item(0).getContentAreaHeightPx()); /* set background height */

// Salve a planilha com marca d'água
watermarker.add(watermark, options);
watermarker.save("path/watermark-background-spreadsheet.xlsx");
watermarker.close();
Marca d'água planilhas do Excel programaticamente

Obtenha uma licença de API gratuita

Você pode obter uma licença temporária gratuita para usar a API sem as limitações de avaliação.

Conclusão

Neste artigo, discutimos como podemos adicionar marcas d’água às planilhas do Excel de diferentes maneiras no aplicativo Java. Aprendemos a inserir marca d’água de texto em todas as planilhas da pasta de trabalho do Excel e, em seguida, aplicamos a marca d’água apenas à planilha específica. Mais tarde, aplicamos a marca d’água como plano de fundo. Agora você pode usar esse recurso e criar seu próprio aplicativo para marcar planilhas com marca d’água.

Saiba mais sobre a API na documentação. Para dúvidas, entre em contato conosco através do fórum.

Veja também