워터마크 작업

워터마크 작업

이 가이드는 문서 워터마크를 추가, 구성 및 제거하는 방법을 보여줍니다 Aspose.Words FOSS용 .NET 다음(을) 사용하여 Watermark 클래스, 다음을 통해 접근 Document.Watermark. 워터마크는 텍스트 또는 이미지일 수 있으며, 문서당 한 번에 하나의 워터마크만 활성화됩니다 – 새 워터마크를 설정하면 이전에 있던 것이 교체됩니다.


텍스트 워터마크 추가

Watermark.SetText(text)은 기본 서식으로 텍스트 워터마크를 추가합니다. SetText(text, options) 오버로드는 TextWatermarkOptions 인스턴스를 받아 외형을 제어합니다: FontFamily, Color, FontSize는 텍스트 서식을 제어하고, IsSemitrasparent은 워터마크에 일반적인 반투명 효과를 전환하며, Layout ( WatermarkLayout 값 — Horizontal 또는 Diagonal)은 페이지에 대한 방향을 제어합니다.


이미지 워터마크 추가

Watermark.SetImage(image)은 이미 로드된 Image에서 이미지 워터마크를 추가합니다. ImageWatermarkOptions 인스턴스를 받는 오버로드 — SetImage(image, options), 파일 경로에서 로드하는 SetImage(imagePath, options), Stream에서 로드하는 SetImage(imageStream, options) — 를 사용하면 Scale(이미지의 비율로 표시되는 스케일 팩터)과 IsWashout(워터마크 이미지가 페이지 내용을 압도하지 않도록 하는 흐릿한 효과)를 제어할 수 있습니다.


워터마크 확인 및 제거

Watermark.Type는 현재 워터마크 종류를 WatermarkType 값으로 보고합니다 – 워터마크가 설정되지 않은 경우 Text, Image, 또는 None입니다. 현재 워터마크를 문서에서 제거하려면 Watermark.Remove()를 호출하세요.


팁 및 모범 사례

  • 워터마크가 존재한다고 가정하기 전에 Watermark.Type를 확인하세요 – 설정된 적이 없는 문서에서는 WatermarkType.None을 반환합니다.
  • SetText() 또는 SetImage()을 통해 새 워터마크를 설정하면 기존 워터마크가 교체됩니다; 한 번에 둘 이상의 활성 워터마크를 가질 방법은 없습니다.
  • Word의 기본 대각선 워터마크 방향을 재현하려면 WatermarkLayout.Diagonal를 사용하고, 페이지 가장자와 평행하게 흐르는 워터마크는 Horizontal을 사용하세요.
  • 불투명도, 크기 또는 글꼴을 제어해야 할 때는 일반 SetImage(image) / SetText(text) 호출보다 ImageWatermarkOptions/TextWatermarkOptions 오버로드를 선호하세요 – 매개변수가 없는 오버로드는 Word의 기본값을 사용합니다.

일반적인 문제

문제원인수정
새 워터마크가 기존 워터마크와 함께 표시되지 않습니다.SetText()/SetImage()이(가) 기존 워터마크를 대체하며 두 번째 워터마크를 추가하지 않습니다.다른 종류를 설정하기 전에 먼저 Remove()을(를) 호출하여 지워야 할 경우에만 호출하십시오; 그렇지 않으면 교체가 자동으로 이루어집니다.
이미지 워터마크가 페이지 콘텐츠를 압도합니다.ImageWatermarkOptions.IsWashout이(가) 비활성 상태로 남아 있었습니다.ImageWatermarkOptions를 구성할 때 IsWashout을(를) true으로 설정하십시오.
텍스트 워터마크의 글꼴이 의도한 서체와 일치하지 않습니다.TextWatermarkOptions.FontFamily이(가) 설정되지 않았거나(또는) 오타가 있었습니다.FontFamily을(를) 렌더링 환경에서 사용할 수 있는 글꼴 이름으로 설정합니다

FAQ

문서에 이미 워터마크가 있는지 어떻게 확인하나요?

Read Document.Watermark.Type; WatermarkType.Text, WatermarkType.Image, 또는 WatermarkType.None을 반환합니다.

워터마크를 제거하려면 어떻게 해야 하나요?

Document.Watermark.Remove()를 호출하세요.

워터마크 투명도를 제어할 수 있나요?

예 – 텍스트 워터마크의 경우 TextWatermarkOptions.IsSemitrasparent을 설정하고, 이미지 워터마크의 경우 ImageWatermarkOptions.IsWashout을 설정합니다.

인메모리 Image 대신 디스크에서 이미지 워터마크를 로드하려면 어떻게 해야 하나요?

Watermark.SetImage(imagePath, options) 오버로드를 사용하고, 파일 경로를 문자열로 전달하면서 ImageWatermarkOptions 인스턴스를 함께 전달하세요.


API Reference 요약

클래스 / 열거형설명
Watermark문서 워터마크, Document.Watermark을 통해; SetText(), SetImage(), Remove(), Type
WatermarkType현재 워터마크 종류를 식별하는 열거형: Text, Image, None
WatermarkLayout워터마크 방향을 위한 열거형: Horizontal, Diagonal
TextWatermarkOptions텍스트 워터마크 형식: FontFamily, Color, FontSize, IsSemitrasparent, Layout
ImageWatermarkOptions이미지 워터마크 옵션: Scale, IsWashout

참조

 한국어