Jak dodać znak wodny tekstowy do arkuszy Excel przy użyciu GroupDocs.Watermark dla Javy

Kiedy potrzebujesz how to watermark Excel skoroszytów — szczególnie tych zawierających wrażliwe dane — dodanie wyraźnego, profesjonalnego znaku wodnego w formie tekstu jest jednym z najskuteczniejszych sposobów ochrony treści i wzmocnienia tożsamości marki. W tym samouczku przeprowadzimy Cię przez dokładne kroki, aby add text watermark Excel pliki przy użyciu biblioteki GroupDocs.Watermark dla Javy, obejmując wszystko od konfiguracji projektu po zapisanie ostatecznego, zabezpieczonego skoroszytu.

Szybkie odpowiedzi

Jakiej biblioteki powinienem używać? GroupDocs.Watermark for Java.
Czy mogę dodać znak wodny tekstowy do każdego arkusza? Tak – iteruj po każdym arkuszu i zastosuj ten sam znak wodny.
Czy potrzebuję licencji? Bezpłatna wersja próbna działa w ocenie; stała licencja jest wymagana w produkcji.
Jaką wersję Javy obsługuje? JDK 8 lub nowsza.
Czy znak wodny wpływa na dane w komórkach? Nie, nakłada się tylko na obrazy w arkuszu.

Czym jest znakowanie w Excelu?

Znakowanie w Excelu oznacza osadzenie widocznego znacznika — tekstowego lub graficznego — bezpośrednio na elementach wizualnych arkusza (takich jak obrazy), tak aby każdy otwierający plik mógł zobaczyć informację o własności lub poufności. Technika ta pomaga zapobiegać nieautoryzowanemu rozpowszechnianiu i nadaje raportom profesjonalny wygląd.

Dlaczego dodać tekstowy znak wodny w Excelu przy użyciu Javy?

Security – Wyraźnie wskazuje na informacje poufne lub własnościowe.
Brand consistency – Wzmacnia identyfikację korporacyjną we wszystkich udostępnianych arkuszach.
Automation – Java umożliwia osadzanie znaków wodnych programowo, oszczędzając czas na ręcznych edycjach.
Cross‑format support – Działa zarówno z plikami .xlsx, jak i starszymi .xls.

Prerequisites

Java Development Kit (JDK) 8 lub nowszy.
Maven do zarządzania zależnościami.
Podstawowa znajomość składni Javy i koncepcji programowania obiektowego.

Konfiguracja GroupDocs.Watermark dla Javy

Aby rozpocząć, dodaj zależność GroupDocs.Watermark do swojego projektu Maven.

Using Maven

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Bezpośrednie pobranie

Alternatywnie, pobierz najnowszy plik JAR z GroupDocs.Watermark for Java releases.

License Acquisition

Free Trial – Przetestuj wszystkie funkcje bez kosztów.
Temporary License – Użyj do krótkoterminowego testowania.
Purchase – Odblokuj pełne możliwości produkcyjne.

Podstawowa inicjalizacja

import com.groupdocs.watermark.Watermarker;
// Initialize watermarker instance for your document
Watermarker watermarker = new Watermarker("path/to/your/spreadsheet.xlsx");

Przewodnik implementacji

Funkcja 1: Tworzenie tekstowego znaku wodnego i konfigurowanie jego właściwości

Tworzenie i dostosowywanie znaku wodnego obejmuje ustawienie jego tekstu, czcionki, wyrównania, kąta obrotu i skalowania.

Step‑by‑Step Overview

Zdefiniuj swój znak wodny

import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.SizingType;
import com.groupdocs.watermark.watermarks.TextWatermark;

// Create a new TextWatermark object
text watermark = new TextWatermark("Protected image", new Font("Arial", 8));

// Configure the watermark properties
text watermark.setHorizontalAlignment(HorizontalAlignment.Center);
text watermark.setVerticalAlignment(VerticalAlignment.Center);
text watermark.setRotateAngle(45); // Set rotation angle
text watermark.setSizingType(SizingType.ScaleToParentDimensions);
text watermark.setScaleFactor(1); // Maintain original size scale factor

Text and Font – Wybierz wyraźny komunikat i czytelną czcionkę.
Alignment – Wyśrodkowanie sprawdza się w większości obrazów.
Rotation & Scaling – Nachylenie 45° sprawia, że znak wodny jest widoczny, nie zasłaniając obrazu.

Funkcja 2: Ładowanie dokumentu arkusza kalkulacyjnego do znakowania

Załaduj skoroszyt z odpowiednimi opcjami, aby GroupDocs mógł uzyskać dostęp do jego wewnętrznych obrazów.

import com.groupdocs.watermark.options.SpreadsheetLoadOptions;
// Load your Excel spreadsheet
documentLoadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", documentLoadOptions);

Funkcja 3: Dodawanie tekstowego znaku wodnego do obrazów w arkuszu

Iteruj przez obrazy w pierwszym arkuszu i zastosuj skonfigurowany znak wodny.

import com.groupdocs.watermark.contents.SpreadsheetContent;
import com.groupdocs.watermark.contents.WatermarkableImageCollection;

// Access content from your loaded document
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
WatermarkableImageCollection images = content.getWorksheets().get_Item(0).findImages();

for (com.groupdocs.watermark.contents.WatermarkableImage image : images) {
    // Add the configured watermark to each image in the worksheet
    image.add(watermark);
}

Funkcja 4: Zapisywanie i zamykanie dokumentu arkusza z znakiem wodnym

Zapisz zmiany do nowego pliku i zwolnij zasoby.

// Save the changes to a new file
watermarker.save("YOUR_OUTPUT_DIRECTORY/spreadsheet-out.xlsx");
// Close the watermarker instance to free resources
watermarker.close();

Praktyczne zastosowania

Document Security – Chron poufne modele finansowe lub dane HR.
Branding – Wstaw firmowe slogany lub informacje prawne we wszystkich udostępnianych raportach.
Copyright Protection – Zniechęcaj do plagiatu, oznaczając każdy wyeksportowany obraz.

Rozważania dotyczące wydajności

Utrzymuj GroupDocs.Watermark w najnowszej wersji, aby korzystać z najnowszych poprawek wydajności.
Zwolnij instancję Watermarker niezwłocznie (close()), aby zwolnić pamięć.
W przypadku bardzo dużych skoroszytów przetwarzaj arkusze partiami, aby uniknąć wysokiego zużycia pamięci.

Typowe problemy i rozwiązania

Issue	Solution
Watermark not visible	Verify that the worksheet actually contains images; the API only watermarks images, not cells.
Misaligned watermark	Adjust `HorizontalAlignment` / `VerticalAlignment` or change `RotateAngle`.
Out‑of‑memory errors on big files	Increase JVM heap (`-Xmx`) or process each worksheet separately.
License errors	Ensure the trial or permanent license file is correctly referenced in your project.

Najczęściej zadawane pytania

Q: Czy mogę używać tego we wszystkich wersjach Excela?
A: Tak, GroupDocs obsługuje zarówno formaty .xlsx, jak i .xls.

Q: Co zrobić, jeśli mój znak wodny nie pojawia się prawidłowo?
A: Sprawdź ponownie ustawienia wyrównania i upewnij się, że wymiary obrazu są odpowiednie dla wybranego współczynnika skali.

Q: Jak mogę dalej dostosować styl czcionki?
A: Użyj klasy Font, aby ustawić pogrubienie, kursywę, kolor lub inne atrybuty typograficzne.

Q: Czy można dodać znaki wodne do wszystkich arkuszy w skoroszycie?
A: Oczywiście — iteruj przez content.getWorksheets() i zastosuj tę samą logikę image.add(watermark) dla każdego arkusza.

Q: Jak efektywnie obsługiwać duże pliki Excel?
A: Przetwarzaj arkusze stopniowo, zamykaj każdy Watermarker po zapisaniu i rozważ zwiększenie rozmiaru stosu JVM.

Zasoby

Integrując te kroki w swoich projektach Java, możesz java add watermark excel pliki szybko, zapewniając zarówno bezpieczeństwo, jak i spójność marki.

Last Updated: 2026-03-22
Tested With: GroupDocs.Watermark 24.11 for Java
Author: GroupDocs