Jak dodać znak wodny do arkusza Excel przy użyciu GroupDocs.Watermark Java SDK

Chronienie plików Excel przed nieautoryzowanym rozpowszechnianiem lub po prostu wzmocnienie tożsamości marki może być osiągnięte poprzez dodanie wizualnego znaku, który pozostaje widoczny niezależnie od sposobu wyświetlania pliku. W tym samouczku dowiesz się jak dodać znak wodny — konkretnie znak wodny w postaci obrazu — do nagłówka lub stopki arkusza Excel przy użyciu GroupDocs.Watermark Java SDK. Po zakończeniu przewodnika będziesz mógł osadzić logo, odznakę poufności lub dowolny niestandardowy obraz bezpośrednio w skoroszycie, nie modyfikując danych w komórkach.

Szybkie odpowiedzi

• Czym jest „jak dodać znak wodny”? Dodanie nakładki obrazu (lub tekstu), która pojawia się na każdej drukowanej stronie lub w określonych sekcjach, takich jak nagłówki/stopki.
• Która biblioteka obsługuje to w Javie? GroupDocs.Watermark Java SDK (najnowsza wersja).
• Czy potrzebna jest licencja? Bezpłatna wersja próbna działa w środowisku deweloperskim; licencja komercyjna jest wymagana w produkcji.
• Czy mogę dodać logo do nagłówka? Tak – użyj znaku wodnego obrazu i ustaw opcję nagłówka (add logo to header).
• Czy można przetwarzać wiele arkuszy jednocześnie? Przejdź pętlą po indeksach arkuszy i zastosuj ten sam znak wodny do każdego arkusza.

Wymagania wstępne

Aby podążać za instrukcją, upewnij się, że masz:

• GroupDocs.Watermark for Java SDK (wersja 24.11 lub nowsza).
• Java Development Kit (JDK) 8 lub wyższą.
• Podstawową znajomość Javy i struktury plików Excel.

Konfiguracja GroupDocs.Watermark for Java SDK

Najpierw dodaj wymagane zależności Maven, aby SDK było dostępne w classpath.

Konfiguracja 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

Jeśli nie chcesz używać Maven, pobierz najnowszy plik JAR z oficjalnej strony wydań: GroupDocs releases.

Pozyskanie licencji

• Uzyskaj bezpłatną wersję próbną lub tymczasowy klucz licencyjny, aby ocenić wszystkie funkcje.
• Kup pełną licencję dla wdrożeń komercyjnych.

Inicjalizacja i konfiguracja

Utwórz instancję Watermarker, która załaduje plik Excel i będzie punktem wejścia dla wszystkich operacji znaków wodnych.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

// Initialize Load Options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

// Create Watermarker instance with your spreadsheet file path
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);

Jak dodać znak wodny do nagłówka/stopki arkusza

Poniżej znajduje się krok‑po‑kroku proces demonstrujący java add image watermark oraz pokazujący, jak add logo to header.

Krok 1: Konfiguracja opcji ładowania

Zaczynamy od zdefiniowania opcji ładowania i ponownego utworzenia obiektu Watermarker. Dzięki temu SDK prawidłowo odczyta skoroszyt.

import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

// Load the document with specified load options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);

Krok 2: Utworzenie i konfiguracja obrazu znaku wodnego

Utwórz obiekt ImageWatermark, który wskazuje na obraz, który chcesz osadzić (np. logo lub odznakę „CONFIDENTIAL”). Dostosuj jego wyrównanie i skalowanie, aby dobrze pasował do obszaru nagłówka/stopki.

import com.groupdocs.watermark.watermarks.ImageWatermark;
import com.groupdocs.watermark.watermarks.SizingType;

// Initialize the image watermark with your logo or desired image
ImageWatermark watermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY/logo.png");

// Set alignment and scaling for a proper fit within the header/footer
watermark.setVerticalAlignment(VerticalAlignment.Top);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setSizingType(SizingType.ScaleToParentDimensions); // Scales with parent dimensions
watermark.setScaleFactor(1); // Adjust scale factor as needed

Krok 3: Konfiguracja opcji nagłówka/stopki

Powiedz SDK, który arkusz i która część (nagłówek lub stopka) ma otrzymać znak wodny. To tutaj możesz add logo to header lub wybrać stopkę.

import com.groupdocs.watermark.options.SpreadsheetWatermarkHeaderFooterOptions;

// Set options for applying the watermark
SpreadsheetWatermarkHeaderFooterOptions headerFooterOptions = new SpreadsheetWatermarkHeaderFooterOptions();
headerFooterOptions.setWorksheetIndex(0); // Apply to first worksheet (index 0)

Krok 4: Dodanie znaku wodnego

Teraz dołącz przygotowany obraz znaku wodnego do wybranego miejsca w nagłówku/stopce.

// Add the configured watermark
watermarker.add(watermark, headerFooterOptions);

Krok 5: Zapis i zamknięcie

Zapisz zmiany do nowego pliku, aby oryginalny skoroszyt pozostał nienaruszony, a następnie zwolnij zasoby.

// Save the watermarked document
watermarker.save("YOUR_OUTPUT_DIRECTORY/out_spreadsheet.xlsx");

// Release resources by closing the Watermarker instance
watermarker.close();

Wskazówki rozwiązywania problemów

• Sprawdź dokładnie ścieżkę do obrazu; nieprawidłowa ścieżka powoduje FileNotFoundException.
• Indeksy arkuszy zaczynają się od 0; upewnij się, że ustawiony indeks rzeczywiście istnieje.
• Jeśli znak wodny jest zniekształcony, dostosuj setScaleFactor lub przełącz SizingType na StretchToParentDimensions.

Dlaczego warto używać GroupDocs.Watermark Java SDK?

• Obsługa wielu formatów – działa z Excel, Word, PowerPoint, PDF‑ami i obrazami.
• Edycja bez utraty danych – oryginalne dane komórek pozostają niezmienione.
• Wydajność zoptymalizowana – odpowiednia dla dużych skoroszytów i przetwarzania wsadowego.

Praktyczne przypadki użycia

Względy dotyczące wydajności

• Zużycie pamięci – Monitoruj stertę JVM przy przetwarzaniu bardzo dużych arkuszy.
• Przetwarzanie wsadowe – Przetwarzaj pliki w grupach, aby utrzymać niski poziom zużycia pamięci.
• Ponowne użycie obiektów – Ponowne użycie jednej instancji Watermarker dla wielu plików zmniejsza narzut.

Najczęściej zadawane pytania

P: Czy mogę dodać wiele znaków wodnych do jednego dokumentu?
O: Tak, tworząc dodatkowe instancje ImageWatermark i konfigurując każdą przed wywołaniem watermarker.add().

P: Jak usunąć istniejący znak wodny z arkusza?
O: Obecnie GroupDocs.Watermark koncentruje się na dodawaniu znaków wodnych. Aby usunąć znak, trzeba odtworzyć skoroszyt bez znaku wodnego lub użyć narzędzia obsługującego ekstrakcję znaków wodnych.

P: Jakie formaty obrazów są obsługiwane dla znaków wodnych?
O: Obsługiwane są popularne formaty, takie jak PNG i JPEG, ale pełną listę kompatybilnych formatów znajdziesz w dokumentacji GroupDocs.

P: Czy można znakować arkusze chronione hasłem?
O: Tak, pod warunkiem podania niezbędnego hasła przy otwieraniu pliku.

P: Jak zastosować znaki wodne we wszystkich arkuszach dokumentu?
O: Przejdź pętlą po każdym indeksie arkusza i powtórz kroki znakowania, ustawiając headerFooterOptions.setWorksheetIndex(i) dla każdej iteracji.

Podsumowanie

Masz teraz kompletną, gotową do wdrożenia metodę java add excel watermark — konkretnie znak wodny w postaci obrazu — przy użyciu GroupDocs.Watermark Java SDK. To podejście dodaje branding, informacje o poufności lub dowolny wizualny sygnał bezpośrednio do nagłówka lub stopki plików Excel, pozostawiając dane w komórkach nietknięte. Zachęcamy do eksploracji innych typów znaków wodnych (tekst, kształt) i łączenia ich w celu uzyskania bardziej zaawansowanej ochrony dokumentów.

Ostatnia aktualizacja: 2026-03-20
Testowano z: GroupDocs.Watermark 24.11 for Java
Autor: GroupDocs